refactor: rename declare_static() to derive(), deprecate old name

packages/generaltranslation/src/generaltranslation/__init__.py

@@ -51,6 +51,7 @@
     condense_vars,
     declare_static,
     declare_var,
+    derive,
     decode_vars,
     extract_vars,
     index_vars,
@@ -106,11 +107,12 @@
     "is_superset_locale",
     "requires_translation",
     "get_plural_form",
-    # Static
+    # Derive / variable helpers
     "VAR_IDENTIFIER",
     "VAR_NAME_IDENTIFIER",
     "sanitize_var",
     "declare_var",
+    "derive",
     "declare_static",
     "decode_vars",
     "extract_vars",

packages/generaltranslation/src/generaltranslation/static/__init__.py

@@ -1,6 +1,6 @@
 from generaltranslation.static._condense_vars import condense_vars
 from generaltranslation.static._constants import VAR_IDENTIFIER, VAR_NAME_IDENTIFIER
-from generaltranslation.static._declare_static import declare_static
+from generaltranslation.static._derive import declare_static, derive
 from generaltranslation.static._declare_var import declare_var
 from generaltranslation.static._decode_vars import decode_vars
 from generaltranslation.static._extract_vars import extract_vars
@@ -12,6 +12,7 @@
     "VAR_NAME_IDENTIFIER",
     "sanitize_var",
     "declare_var",
+    "derive",
     "declare_static",
     "decode_vars",
     "extract_vars",

packages/generaltranslation/src/generaltranslation/static/_derive.py

@@ -0,0 +1,26 @@
+from __future__ import annotations
+
+import warnings
+
+
+def derive(content: object) -> object:
+    """Mark *content* as derivable (statically analyzable).
+
+    This is an identity function used as a marker for the CLI tool's
+    static analysis.
+    """
+    return content
+
+
+def declare_static(content: object) -> object:
+    """Mark *content* as derivable (statically analyzable).
+
+    .. deprecated::
+        Use :func:`derive` instead.
+    """
+    warnings.warn(
+        "declare_static() is deprecated, use derive() instead.",
+        DeprecationWarning,
+        stacklevel=2,
+    )
+    return derive(content)

packages/gt-fastapi/src/gt_fastapi/__init__.py

@@ -1,13 +1,14 @@
 """FastAPI integration for General Translation."""
 
-from gt_i18n import declare_static, declare_var, decode_vars, get_default_locale, get_locale, get_locales, t
+from gt_i18n import declare_static, declare_var, decode_vars, derive, get_default_locale, get_locale, get_locales, t
 
 from gt_fastapi._setup import initialize_gt
 
 __all__ = [
     "initialize_gt",
     "t",
     "declare_var",
+    "derive",
     "declare_static",
     "decode_vars",
     "get_locale",

packages/gt-flask/src/gt_flask/__init__.py

@@ -1,13 +1,14 @@
 """Flask integration for General Translation."""
 
-from gt_i18n import declare_static, declare_var, decode_vars, get_default_locale, get_locale, get_locales, t
+from gt_i18n import declare_static, declare_var, decode_vars, derive, get_default_locale, get_locale, get_locales, t
 
 from gt_flask._setup import initialize_gt
 
 __all__ = [
     "initialize_gt",
     "t",
     "declare_var",
+    "derive",
     "declare_static",
     "decode_vars",
     "get_locale",

packages/gt-i18n/src/gt_i18n/__init__.py

@@ -1,6 +1,6 @@
 """Python i18n library for General Translation."""
 
-from generaltranslation.static import declare_static, declare_var, decode_vars
+from generaltranslation.static import declare_static, declare_var, decode_vars, derive
 
 from gt_i18n.helpers._locales import (
     get_default_locale,
@@ -49,8 +49,9 @@
     "get_locale",
     "get_locales",
     "get_default_locale",
-    # Static variable helpers
+    # Derive / variable helpers
     "declare_var",
+    "derive",
     "declare_static",
     "decode_vars",
 ]