i18next-cli 1.55.0 → 1.56.0

package/dist/esm/utils/nesting.js

@@ -0,0 +1,98 @@
+/**
+ * Shared parser for i18next-style nested translation references of the form
+ * `$t(key, { options })`.
+ *
+ * Used in two places:
+ * 1. The extractor's AST pass scans source-code keys and default values for
+ *    nested references and registers the referenced keys (so they show up in
+ *    output translation files).
+ * 2. The translation-manager uses it during `removeUnusedKeys` cleanup so
+ *    keys that are only referenced from inside a translation value (and thus
+ *    invisible to the AST pass) are preserved instead of being deleted.
+ */
+const naturalLanguageChars = /[ ,?!;]/;
+const looksLikeNaturalLanguage = (s) => naturalLanguageChars.test(s);
+const escapeRegex = (str) => str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+/**
+ * Scans a string for `$t(...)` references and returns metadata about each one.
+ * The implementation mirrors the behaviour of i18next's Interpolator so that
+ * the extractor and translation manager agree on what counts as a reference.
+ */
+function parseNestedReferences(text, config) {
+    if (!text || typeof text !== 'string')
+        return [];
+    const prefix = config.nestingPrefix ?? '$t(';
+    const suffix = config.nestingSuffix ?? ')';
+    const separator = config.nestingOptionsSeparator ?? ',';
+    const nsSeparator = config.nsSeparator ?? ':';
+    const escapedPrefix = escapeRegex(prefix);
+    const escapedSuffix = escapeRegex(suffix);
+    // Regex adapted from i18next Interpolator.js — matches `$t(key)` or
+    // `$t(key, { options })` with (limited) support for balanced parens and
+    // quoted strings.
+    const nestingRegexp = new RegExp(`${escapedPrefix}((?:[^()"']+|"[^"]*"|'[^']*'|\\((?:[^()]|"[^"]*"|'[^']*')*\\))*?)${escapedSuffix}`, 'g');
+    const results = [];
+    let match;
+    while ((match = nestingRegexp.exec(text)) !== null) {
+        const content = match[1];
+        if (!content)
+            continue;
+        let key = content;
+        let optionsString = '';
+        if (content.indexOf(separator) < 0) {
+            key = content.trim();
+        }
+        else {
+            // i18next does: const c = key.split(new RegExp(`${sep}[ ]*{`));
+            // This assumes options start with `{`.
+            const sepRegex = new RegExp(`${escapeRegex(separator)}[ ]*{`);
+            const parts = content.split(sepRegex);
+            if (parts.length > 1) {
+                key = parts[0].trim();
+                optionsString = `{${parts.slice(1).join(separator + ' {')}`;
+            }
+            else {
+                const sepIdx = content.indexOf(separator);
+                key = content.substring(0, sepIdx).trim();
+                optionsString = content.substring(sepIdx + 1).trim();
+            }
+        }
+        if ((key.startsWith("'") && key.endsWith("'")) || (key.startsWith('"') && key.endsWith('"'))) {
+            key = key.slice(1, -1);
+        }
+        if (!key)
+            continue;
+        let ns;
+        if (nsSeparator && typeof nsSeparator === 'string' && key.includes(nsSeparator)) {
+            const parts = key.split(nsSeparator);
+            const candidateNs = parts[0];
+            if (!looksLikeNaturalLanguage(candidateNs)) {
+                ns = parts.shift();
+                key = parts.join(nsSeparator);
+                if (!key || key.trim() === '')
+                    continue;
+            }
+            else {
+                ns = config.defaultNS;
+            }
+        }
+        else {
+            ns = config.defaultNS;
+        }
+        let hasCount = false;
+        let context;
+        if (optionsString) {
+            if (/['"]?count['"]?\s*:/.test(optionsString)) {
+                hasCount = true;
+            }
+            const contextMatch = /['"]?context['"]?\s*:\s*(['"])(.*?)\1/.exec(optionsString);
+            if (contextMatch) {
+                context = contextMatch[2];
+            }
+        }
+        results.push({ key, ns, hasCount, context });
+    }
+    return results;
+}
+
+export { parseNestedReferences };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "i18next-cli",
-  "version": "1.55.0",
+  "version": "1.56.0",
   "description": "A unified, high-performance i18next CLI.",
   "type": "module",
   "bin": {

package/types/extractor/core/translation-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translation-manager.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/translation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AA88B9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAC/B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,MAAM,EAAE,oBAAoB,EAC5B,EACE,uBAA+B,EAC/B,OAAe,EACf,oBAA4B,EAC5B,MAA4B,EAC7B,GAAE;IACD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAiK9B"}
+{"version":3,"file":"translation-manager.d.ts","sourceRoot":"","sources":["../../../src/extractor/core/translation-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAohC9F;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EAC/B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,EACvB,MAAM,EAAE,oBAAoB,EAC5B,EACE,uBAA+B,EAC/B,OAAe,EACf,oBAA4B,EAC5B,MAA4B,EAC7B,GAAE;IACD,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;CACX,GACL,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAiK9B"}

package/types/extractor/parsers/call-expression-handler.d.ts

@@ -35,10 +35,11 @@ export declare class CallExpressionHandler {
      */
     handleCallExpression(node: CallExpression, getScopeInfo: (name: string) => ScopeInfo | undefined): void;
     /**
-     * Scans a string for nested translations like $t(key, options) and extracts them.
+     * Scans a string for nested translations like $t(key, options) and registers
+     * the referenced keys (plus their plural / context variants) on the current
+     * plugin context.
      */
     private extractNestedKeys;
-    private processNestedContent;
     private generateNestedPluralKeys;
     /**
      * Processed a call expression to extract keys from the specified argument.

package/types/extractor/parsers/call-expression-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"call-expression-handler.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/call-expression-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA6C,MAAM,WAAW,CAAA;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,EAAgB,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1G,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAY7D,qBAAa,qBAAqB;IAChC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,kBAAkB,CAAoB;IACvC,UAAU,cAAoB;IACrC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,iBAAiB,CAAsC;gBAG7D,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,kBAAkB,EACtC,cAAc,EAAE,MAAM,MAAM,EAC5B,cAAc,EAAE,MAAM,MAAM,EAC5B,iBAAiB,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAA2B;IAW3E;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;;;;;;;;;;;;;OAcG;IACH,oBAAoB,CAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,GAAG,IAAI;IA0ZxG;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,oBAAoB;IAkF5B,OAAO,CAAC,wBAAwB;IAyEhC;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IA8BpC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,uBAAuB;IAgE/B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;IAyMxB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;CA2BxB"}
+{"version":3,"file":"call-expression-handler.d.ts","sourceRoot":"","sources":["../../../src/extractor/parsers/call-expression-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAA6C,MAAM,WAAW,CAAA;AAC1F,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,EAAgB,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1G,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAa7D,qBAAa,qBAAqB;IAChC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,kBAAkB,CAAoB;IACvC,UAAU,cAAoB;IACrC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,cAAc,CAAc;IACpC,OAAO,CAAC,iBAAiB,CAAsC;gBAG7D,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,EAC7C,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,MAAM,EACd,kBAAkB,EAAE,kBAAkB,EACtC,cAAc,EAAE,MAAM,MAAM,EAC5B,cAAc,EAAE,MAAM,MAAM,EAC5B,iBAAiB,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAA2B;IAW3E;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;;;;;;;;;;;;;OAcG;IACH,oBAAoB,CAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,GAAG,SAAS,GAAG,IAAI;IA0ZxG;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAmBzB,OAAO,CAAC,wBAAwB;IAyEhC;;;;;;OAMG;IACH,OAAO,CAAC,4BAA4B;IA8BpC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,CAAC,uBAAuB;IAgE/B;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;IAyMxB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;CA2BxB"}

package/types/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAgB,MAAM,YAAY,CAAA;AAKpE;;GAEG;AACH,UAAU,aAAa;IACrB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAqDD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,aAAkB,iBAuBzF"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,oBAAoB,EAAgB,MAAM,YAAY,CAAA;AAMpE;;GAEG;AACH,UAAU,aAAa;IACrB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAqDD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,SAAS,CAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAE,aAAkB,iBAuBzF"}

package/types/utils/context-variants.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Helpers for reasoning about context variants of translation keys.
+ *
+ * A "key accepting context" is a base key that was called with a `context`
+ * option in source code (e.g. `t('friend', { context: gender })`). Its
+ * variants in the translation file look like `<base><contextSeparator><ctx>`
+ * (optionally suffixed with a CLDR plural form).
+ */
+/**
+ * Checks if an existing key is a context variant of a base key that accepts context.
+ * Handles:
+ * - Keys suffixed with a CLDR plural form (e.g. `friend_male_one`).
+ * - Context values that contain the separator (e.g. `mc_laren`).
+ *
+ * @param existingKey - The key from the translation file to check
+ * @param keysAcceptingContext - Set of base keys that were used with context in source code
+ * @param pluralSeparator - The separator used for plural forms (default: '_')
+ * @param contextSeparator - The separator used for context variants (default: '_')
+ * @returns true if the existing key is a context variant of a key accepting context
+ */
+export declare function isContextVariantOfAcceptingKey(existingKey: string, keysAcceptingContext: ReadonlySet<string>, pluralSeparator: string, contextSeparator: string): boolean;
+//# sourceMappingURL=context-variants.d.ts.map

package/types/utils/context-variants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-variants.d.ts","sourceRoot":"","sources":["../../src/utils/context-variants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,MAAM,EACnB,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAAC,EACzC,eAAe,EAAE,MAAM,EACvB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAsCT"}

package/types/utils/nesting.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Shared parser for i18next-style nested translation references of the form
+ * `$t(key, { options })`.
+ *
+ * Used in two places:
+ * 1. The extractor's AST pass scans source-code keys and default values for
+ *    nested references and registers the referenced keys (so they show up in
+ *    output translation files).
+ * 2. The translation-manager uses it during `removeUnusedKeys` cleanup so
+ *    keys that are only referenced from inside a translation value (and thus
+ *    invisible to the AST pass) are preserved instead of being deleted.
+ */
+export interface NestingConfig {
+    nestingPrefix?: string;
+    nestingSuffix?: string;
+    nestingOptionsSeparator?: string;
+    nsSeparator?: string | false | null;
+    defaultNS?: string | false;
+}
+export interface NestedReference {
+    /** The referenced key (namespace-stripped when a namespace was resolved). */
+    key: string;
+    /** Resolved namespace for the reference (or defaultNS / undefined). */
+    ns: string | false | undefined;
+    /** True when the nested options object contains a `count` property. */
+    hasCount: boolean;
+    /** Static context string, if the nested options contain `context: 'foo'`. */
+    context?: string;
+}
+/**
+ * Scans a string for `$t(...)` references and returns metadata about each one.
+ * The implementation mirrors the behaviour of i18next's Interpolator so that
+ * the extractor and translation manager agree on what counts as a reference.
+ */
+export declare function parseNestedReferences(text: string, config: NestingConfig): NestedReference[];
+//# sourceMappingURL=nesting.d.ts.map

package/types/utils/nesting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nesting.d.ts","sourceRoot":"","sources":["../../src/utils/nesting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,MAAM,WAAW,aAAa;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAA;IACnC,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAA;IACX,uEAAuE;IACvE,EAAE,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;IAC9B,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAA;IACjB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,eAAe,EAAE,CAoF7F"}