@generaltranslation/react-core 1.8.15 → 1.8.16

package/dist/variables/Derive.d.ts

@@ -1,8 +1,18 @@
 import React from 'react';
 /**
- * `<Derive>` is a powerful but dangerous component which marks its children as statically analyzable for the compiler and CLI tool.
+ * Marks JSX children as derivable by the GT compiler and CLI.
  *
- * This component is dangerous because it can cause the compiler and CLI tool to throw an error if children are not statically analyzable.
+ * Use `<Derive>` inside translated JSX when child content is computed from
+ * source code, but should still be discovered during extraction instead of
+ * treated as a runtime interpolation variable. The CLI attempts to resolve the
+ * derivable children into every possible static value and includes those values
+ * in the source content that gets translated.
+ *
+ * `<Derive>` renders its children unchanged at runtime.
+ *
+ * Run `gt validate` after adding or changing `<Derive>` usage to verify that
+ * each derivable expression can be resolved by the CLI before translating or
+ * building.
  *
  * @example
  * ```jsx
@@ -18,8 +28,8 @@ import React from 'react';
  * </T>
  * ```
  *
- * @param {T extends React.ReactNode} children - Derived content to render.
- * @returns {T} The result of the function invocation.
+ * @param {T extends React.ReactNode} children - JSX content to derive for translation extraction.
+ * @returns {T} The same children, unchanged at runtime.
  */
 declare function Derive<T extends React.ReactNode>({ children }: {
     children: T;
@@ -30,9 +40,14 @@ declare namespace Derive {
 /**
  * @deprecated Use `<Derive>` instead.
  *
- * `<Static>` is a powerful but dangerous component which marks its children as statically analyzable for the compiler and CLI tool.
+ * Marks JSX children as derivable by the GT compiler and CLI.
+ *
+ * Use `<Derive>` instead of `<Static>` for new code. This alias is kept for
+ * backwards compatibility and renders its children unchanged at runtime.
  *
- * This component is dangerous because it can cause the compiler and CLI tool to throw an error if children are not statically analyzable.
+ * Run `gt validate` after adding or changing derived JSX content to verify that
+ * each derivable expression can be resolved by the CLI before translating or
+ * building.
  *
  * @example
  * ```jsx
@@ -48,8 +63,8 @@ declare namespace Derive {
  * </T>
  * ```
  *
- * @param {T extends React.ReactNode} children - Derived content to render.
- * @returns {T} The result of the function invocation.
+ * @param {T extends React.ReactNode} children - JSX content to derive for translation extraction.
+ * @returns {T} The same children, unchanged at runtime.
  */
 declare function Static<T extends React.ReactNode>(props: {
     children: T;

package/dist/variables/Derive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Derive.d.ts","sourceRoot":"","sources":["../../src/variables/Derive.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,iBAAS,MAAM,CAAC,CAAC,SAAS,KAAK,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,CAAC,CAAA;CAAE,GAAG,CAAC,CAE3E;kBAFQ,MAAM;;;AAIf;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,MAAM,CAAC,CAAC,SAAS,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE;IAAE,QAAQ,EAAE,CAAC,CAAA;CAAE,GAAG,CAAC,CAEpE;kBAFQ,MAAM;;;AAQf,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"Derive.d.ts","sourceRoot":"","sources":["../../src/variables/Derive.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,iBAAS,MAAM,CAAC,CAAC,SAAS,KAAK,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,CAAC,CAAA;CAAE,GAAG,CAAC,CAE3E;kBAFQ,MAAM;;;AAIf;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,iBAAS,MAAM,CAAC,CAAC,SAAS,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE;IAAE,QAAQ,EAAE,CAAC,CAAA;CAAE,GAAG,CAAC,CAEpE;kBAFQ,MAAM;;;AAQf,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@generaltranslation/react-core",
-  "version": "1.8.15",
+  "version": "1.8.16",
   "description": "A pure React library for internationalization",
   "main": "./dist/index.cjs.min.cjs",
   "module": "./dist/index.esm.min.mjs",
@@ -14,9 +14,9 @@
     "react": ">=16.8.0"
   },
   "dependencies": {
-    "@generaltranslation/supported-locales": "2.0.69",
-    "generaltranslation": "8.2.11",
-    "gt-i18n": "0.8.14"
+    "generaltranslation": "8.2.12",
+    "gt-i18n": "0.9.0",
+    "@generaltranslation/supported-locales": "2.0.70"
   },
   "repository": {
     "type": "git",
@@ -111,6 +111,7 @@
     "release:beta": "pnpm run build:clean && pnpm publish --tag beta",
     "release:latest": "pnpm run build:clean && pnpm publish --tag latest",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
   }
 }