i18next-cli 1.34.0 → 1.35.0

package/dist/esm/extractor/parsers/comment-parser.js

@@ -1 +1,373 @@
-function e(e,u,i,f){const d=new RegExp("\\bt\\s*\\(\\s*(['\"`])(.*?)\\1","g"),p=i.extract.preservePatterns||[],y=p.map(c),$=i.extract.nsSeparator??":",x=(e,t)=>{if(y.some(t=>t.test(e)))return!0;for(const e of p)if("string"==typeof e&&e.endsWith(`${$}*`)){const n="string"==typeof $&&$.length>0?e.slice(0,-($.length+1)):e.slice(0,-1);if("*"===n||t&&n===t)return!0}return!1},h=function(e){const t=[],n=new Set,s=/\/\/(.*)|\/\*([\s\S]*?)\*\//g;let r;for(;null!==(r=s.exec(e));){const e=(r[1]??r[2]).trim();e&&!n.has(e)&&(n.add(e),t.push(e))}return t}(e);for(const e of h){let c;for(;null!==(c=d.exec(e));){let d,p=c[2];if(!p||""===p.trim())continue;const y=e.slice(c.index+c[0].length),$=s(y),h=a(y),g=o(y),V=l(y);let k=!1;const m=i.extract.pluralSeparator??"_";if(p.endsWith(`${m}ordinal`)){if(k=!0,p=p.slice(0,-(m.length+7)),!p||""===p.trim())continue;if(x(p,d))continue}const K=!0===V||k;d=r(y);const S=i.extract.nsSeparator??":";if(!d&&S&&p.includes(S)){const e=p.split(S);if(d=e.shift(),p=e.join(S),!p||""===p.trim())continue;if(x(p,d))continue}if(!d&&f){const e=f("t");e?.defaultNs&&(d=e.defaultNs)}if(!x(p,d))if(d||(d=i.extract.defaultNS),i.extract.disablePlurals)h?u.addKey({key:`${p}_${h}`,ns:d,defaultValue:$??p}):u.addKey({key:p,ns:d,defaultValue:$??p});else if(h&&g){n(p,$??p,d,h,u,i,K);!1!==i.extract?.generateBasePluralForms&&t(p,$??p,d,u,i,K)}else h?(u.addKey({key:p,ns:d,defaultValue:$??p}),u.addKey({key:`${p}_${h}`,ns:d,defaultValue:$??p})):g?t(p,$??p,d,u,i,K):u.addKey({key:p,ns:d,defaultValue:$??p})}}}function t(e,t,n,s,r,a=!1){try{const o=a?"ordinal":"cardinal",l=new Set;for(const e of r.locales)try{const t=new Intl.PluralRules(e,{type:o});t.resolvedOptions().pluralCategories.forEach(e=>l.add(e))}catch(e){const t=new Intl.PluralRules("en",{type:o});t.resolvedOptions().pluralCategories.forEach(e=>l.add(e))}const c=Array.from(l).sort(),u=r.extract.pluralSeparator??"_";if(1===c.length&&"other"===c[0])return void s.addKey({key:e,ns:n,defaultValue:t,hasCount:!0});for(const r of c){const o=a?`${e}${u}ordinal${u}${r}`:`${e}${u}${r}`;s.addKey({key:o,ns:n,defaultValue:t,hasCount:!0,isOrdinal:a})}}catch(r){s.addKey({key:e,ns:n,defaultValue:t})}}function n(e,t,n,s,r,a,o=!1){try{const l=o?"ordinal":"cardinal",c=new Set;for(const e of a.locales)try{const t=new Intl.PluralRules(e,{type:l});t.resolvedOptions().pluralCategories.forEach(e=>c.add(e))}catch(e){const t=new Intl.PluralRules(a.extract.primaryLanguage||"en",{type:l});t.resolvedOptions().pluralCategories.forEach(e=>c.add(e))}const u=Array.from(c).sort(),i=a.extract.pluralSeparator??"_";for(const a of u){const l=o?`${e}_${s}${i}ordinal${i}${a}`:`${e}_${s}${i}${a}`;r.addKey({key:l,ns:n,defaultValue:t,hasCount:!0,isOrdinal:o})}}catch(a){r.addKey({key:`${e}_${s}`,ns:n,defaultValue:t})}}function s(e){const t=/^\s*,\s*(['"])(.*?)\1/.exec(e);if(t)return t[2];const n=/^\s*,\s*\{[^}]*defaultValue\s*:\s*(['"])(.*?)\1/.exec(e);return n?n[2]:void 0}function r(e){const t=/^\s*,\s*\{[^}]*ns\s*:\s*(['"])(.*?)\1/.exec(e);if(t)return t[2]}function a(e){const t=/^\s*,\s*\{[^}]*context\s*:\s*(['"])(.*?)\1/.exec(e);if(t)return t[2]}function o(e){const t=/^\s*,\s*\{[^}]*count\s*:\s*(\d+)/.exec(e);if(t)return parseInt(t[1],10)}function l(e){const t=/^\s*,\s*\{[^}]*ordinal\s*:\s*(true|false)/.exec(e);if(t)return"true"===t[1]}function c(e){const t=`^${e.replace(/[.+?^${}()|[\]\\]/g,"\\$&").replace(/\*/g,".*")}$`;return new RegExp(t)}export{e as extractKeysFromComments};
+/**
+ * Extracts translation keys from comments in source code using regex patterns.
+ * Supports extraction from single-line (//) and multi-line comments.
+ *
+ * @param code - The source code to analyze
+ * @param pluginContext - Context object with helper methods to add found keys
+ * @param config - Configuration object containing extraction settings
+ * @param scopeResolver - Function to resolve scope information for variables (optional)
+ *
+ * @example
+ * ```typescript
+ * const code = `
+ *   // t('user.name', 'User Name')
+ *   /* t('app.title', { defaultValue: 'My App', ns: 'common' }) *\/
+ * `
+ *
+ * const context = createPluginContext(allKeys)
+ * extractKeysFromComments(code, context, config, scopeResolver)
+ * // Extracts: user.name and app.title with their respective settings
+ * ```
+ */
+function extractKeysFromComments(code, pluginContext, config, scopeResolver) {
+    // Hardcode the function name to 't' to prevent parsing other functions like 'test()'.
+    const functionNameToFind = 't';
+    // Use a reliable word boundary (\b) to match 't(...)' but not 'http.get(...)'.
+    const keyRegex = new RegExp(`\\b${functionNameToFind}\\s*\\(\\s*(['"\`])(.*?)\\1`, 'g');
+    // Prepare preservePatterns for filtering
+    const rawPreservePatterns = config.extract.preservePatterns || [];
+    const preservePatterns = rawPreservePatterns.map(globToRegex);
+    const nsSeparator = config.extract.nsSeparator ?? ':';
+    const matchesPreserve = (key, ns) => {
+        // 1) regex-style matches (existing behavior)
+        if (preservePatterns.some(re => re.test(key)))
+            return true;
+        // 2) namespace:* style patterns => preserve entire namespace
+        for (const rp of rawPreservePatterns) {
+            if (typeof rp !== 'string')
+                continue;
+            if (rp.endsWith(`${nsSeparator}*`)) {
+                const nsPrefix = (typeof nsSeparator === 'string' && nsSeparator.length > 0)
+                    ? rp.slice(0, -(nsSeparator.length + 1))
+                    : rp.slice(0, -1);
+                // support '*' as a wildcard namespace
+                if (nsPrefix === '*' || (ns && nsPrefix === ns))
+                    return true;
+            }
+        }
+        return false;
+    };
+    const commentTexts = collectCommentTexts(code);
+    for (const text of commentTexts) {
+        let match;
+        while ((match = keyRegex.exec(text)) !== null) {
+            let key = match[2];
+            // Validate that the key is not empty or whitespace-only
+            if (!key || key.trim() === '') {
+                continue; // Skip empty keys
+            }
+            // We'll check preservePatterns after namespace resolution below
+            let ns;
+            const remainder = text.slice(match.index + match[0].length);
+            const defaultValue = parseDefaultValueFromComment(remainder);
+            const context = parseContextFromComment(remainder);
+            const count = parseCountFromComment(remainder);
+            const ordinal = parseOrdinalFromComment(remainder);
+            // Check if key ends with _ordinal suffix (like in ast-visitors)
+            let isOrdinalByKey = false;
+            const pluralSeparator = config.extract.pluralSeparator ?? '_';
+            if (key.endsWith(`${pluralSeparator}ordinal`)) {
+                isOrdinalByKey = true;
+                // Normalize the key by stripping the suffix
+                key = key.slice(0, -(pluralSeparator.length + 7)); // Remove "_ordinal"
+                // Validate that the key is still not empty after normalization
+                if (!key || key.trim() === '') {
+                    continue; // Skip keys that become empty after normalization
+                }
+                // Re-check preservePatterns after key normalization (will check namespace-aware helper)
+                if (matchesPreserve(key, ns)) {
+                    continue; // Skip normalized keys that match preserve patterns
+                }
+            }
+            const isOrdinal = ordinal === true || isOrdinalByKey;
+            // 1. Check for namespace in options object first (e.g., { ns: 'common' })
+            ns = parseNsFromComment(remainder);
+            // 2. If not in options, check for separator in key (e.g., 'common:button.save')
+            const nsSeparator = config.extract.nsSeparator ?? ':';
+            if (!ns && nsSeparator && key.includes(nsSeparator)) {
+                const parts = key.split(nsSeparator);
+                ns = parts.shift();
+                key = parts.join(nsSeparator);
+                // Validate that the key didn't become empty after namespace removal
+                if (!key || key.trim() === '') {
+                    continue; // Skip keys that become empty after namespace removal
+                }
+                // Re-check preservePatterns after namespace processing (namespace-aware)
+                if (matchesPreserve(key, ns)) {
+                    continue; // Skip processed keys that match preserve patterns
+                }
+            }
+            // 3. If no explicit namespace found, try to resolve from scope
+            // This allows commented t() calls to inherit namespace from useTranslation scope
+            if (!ns && scopeResolver) {
+                const scopeInfo = scopeResolver('t');
+                if (scopeInfo?.defaultNs) {
+                    ns = scopeInfo.defaultNs;
+                }
+            }
+            // Final preserve check for keys without prior namespace normalization
+            if (matchesPreserve(key, ns)) {
+                continue;
+            }
+            // 4. Final fallback to configured default namespace
+            if (!ns)
+                ns = config.extract.defaultNS;
+            // 5. Handle context and count combinations based on disablePlurals setting
+            if (config.extract.disablePlurals) {
+                // When plurals are disabled, ignore count for key generation
+                if (context) {
+                    // Only generate context variants (no base key when context is static)
+                    pluginContext.addKey({ key: `${key}_${context}`, ns, defaultValue: defaultValue ?? key });
+                }
+                else {
+                    // Simple key (ignore count)
+                    pluginContext.addKey({ key, ns, defaultValue: defaultValue ?? key });
+                }
+            }
+            else {
+                // Original plural handling logic when plurals are enabled
+                if (context && count) {
+                    // Generate context+plural combinations
+                    generateContextPluralKeys(key, defaultValue ?? key, ns, context, pluginContext, config, isOrdinal);
+                    // Only generate base plural forms if generateBasePluralForms is not disabled
+                    const shouldGenerateBaseForms = config.extract?.generateBasePluralForms !== false;
+                    if (shouldGenerateBaseForms) {
+                        generatePluralKeys(key, defaultValue ?? key, ns, pluginContext, config, isOrdinal);
+                    }
+                }
+                else if (context) {
+                    // Just context variants
+                    pluginContext.addKey({ key, ns, defaultValue: defaultValue ?? key });
+                    pluginContext.addKey({ key: `${key}_${context}`, ns, defaultValue: defaultValue ?? key });
+                }
+                else if (count) {
+                    // Just plural variants
+                    generatePluralKeys(key, defaultValue ?? key, ns, pluginContext, config, isOrdinal);
+                }
+                else {
+                    // Simple key
+                    pluginContext.addKey({ key, ns, defaultValue: defaultValue ?? key });
+                }
+            }
+        }
+    }
+}
+/**
+ * Generates plural keys for a given base key
+ */
+function generatePluralKeys(key, defaultValue, ns, pluginContext, config, isOrdinal = false) {
+    try {
+        const type = isOrdinal ? 'ordinal' : 'cardinal';
+        // Generate plural forms for ALL target languages to ensure we have all necessary keys
+        const allPluralCategories = new Set();
+        for (const locale of config.locales) {
+            try {
+                const pluralRules = new Intl.PluralRules(locale, { type });
+                const categories = pluralRules.resolvedOptions().pluralCategories;
+                categories.forEach(cat => allPluralCategories.add(cat));
+            }
+            catch (e) {
+                // If a locale is invalid, fall back to English rules
+                const englishRules = new Intl.PluralRules('en', { type });
+                const categories = englishRules.resolvedOptions().pluralCategories;
+                categories.forEach(cat => allPluralCategories.add(cat));
+            }
+        }
+        const pluralCategories = Array.from(allPluralCategories).sort();
+        const pluralSeparator = config.extract.pluralSeparator ?? '_';
+        // If the only plural category is "other", prefer emitting the base key instead of "key_other"
+        if (pluralCategories.length === 1 && pluralCategories[0] === 'other') {
+            // Emit base key only
+            pluginContext.addKey({
+                key,
+                ns,
+                defaultValue,
+                hasCount: true
+            });
+            return;
+        }
+        // Generate keys for each plural category
+        for (const category of pluralCategories) {
+            const finalKey = isOrdinal
+                ? `${key}${pluralSeparator}ordinal${pluralSeparator}${category}`
+                : `${key}${pluralSeparator}${category}`;
+            pluginContext.addKey({
+                key: finalKey,
+                ns,
+                defaultValue,
+                hasCount: true,
+                isOrdinal
+            });
+        }
+    }
+    catch (e) {
+        // Fallback if Intl API fails
+        pluginContext.addKey({ key, ns, defaultValue });
+    }
+}
+/**
+ * Generates context + plural combination keys
+ */
+function generateContextPluralKeys(key, defaultValue, ns, context, pluginContext, config, isOrdinal = false) {
+    try {
+        const type = isOrdinal ? 'ordinal' : 'cardinal';
+        // Generate plural forms for ALL target languages to ensure we have all necessary keys
+        const allPluralCategories = new Set();
+        for (const locale of config.locales) {
+            try {
+                const pluralRules = new Intl.PluralRules(locale, { type });
+                const categories = pluralRules.resolvedOptions().pluralCategories;
+                categories.forEach(cat => allPluralCategories.add(cat));
+            }
+            catch (e) {
+                // If a locale is invalid, fall back to English rules
+                const englishRules = new Intl.PluralRules(config.extract.primaryLanguage || 'en', { type });
+                const categories = englishRules.resolvedOptions().pluralCategories;
+                categories.forEach(cat => allPluralCategories.add(cat));
+            }
+        }
+        const pluralCategories = Array.from(allPluralCategories).sort();
+        const pluralSeparator = config.extract.pluralSeparator ?? '_';
+        // Generate keys for each context + plural combination
+        for (const category of pluralCategories) {
+            const finalKey = isOrdinal
+                ? `${key}_${context}${pluralSeparator}ordinal${pluralSeparator}${category}`
+                : `${key}_${context}${pluralSeparator}${category}`;
+            pluginContext.addKey({
+                key: finalKey,
+                ns,
+                defaultValue,
+                hasCount: true,
+                isOrdinal
+            });
+        }
+    }
+    catch (e) {
+        // Fallback if Intl API fails
+        pluginContext.addKey({ key: `${key}_${context}`, ns, defaultValue });
+    }
+}
+/**
+ * Parses default value from the remainder of a comment after a translation function call.
+ * Supports both string literals and object syntax with defaultValue property.
+ *
+ * @param remainder - The remaining text after the translation key
+ * @returns The parsed default value or undefined if none found
+ *
+ * @internal
+ */
+function parseDefaultValueFromComment(remainder) {
+    // Simple string default: , 'VALUE' or , "VALUE"
+    const dvString = /^\s*,\s*(['"])(.*?)\1/.exec(remainder);
+    if (dvString)
+        return dvString[2];
+    // Object with defaultValue: , { defaultValue: 'VALUE', ... }
+    const dvObj = /^\s*,\s*\{[^}]*defaultValue\s*:\s*(['"])(.*?)\1/.exec(remainder);
+    if (dvObj)
+        return dvObj[2];
+    return undefined;
+}
+/**
+ * Parses namespace from the remainder of a comment after a translation function call.
+ * Looks for namespace specified in options object syntax.
+ *
+ * @param remainder - The remaining text after the translation key
+ * @returns The parsed namespace or undefined if none found
+ *
+ * @internal
+ */
+function parseNsFromComment(remainder) {
+    // Look for ns in an options object, e.g., { ns: 'common' }
+    const nsObj = /^\s*,\s*\{[^}]*ns\s*:\s*(['"])(.*?)\1/.exec(remainder);
+    if (nsObj)
+        return nsObj[2];
+    return undefined;
+}
+/**
+ * Collects all comment texts from source code, both single-line and multi-line.
+ * Deduplicates comments to avoid processing the same text multiple times.
+ *
+ * @param src - The source code to extract comments from
+ * @returns Array of unique comment text content
+ *
+ * @internal
+ */
+function collectCommentTexts(src) {
+    const texts = [];
+    const seen = new Set();
+    const commentRegex = /\/\/(.*)|\/\*([\s\S]*?)\*\//g;
+    let cmatch;
+    while ((cmatch = commentRegex.exec(src)) !== null) {
+        const content = cmatch[1] ?? cmatch[2];
+        const s = content.trim();
+        if (s && !seen.has(s)) {
+            seen.add(s);
+            texts.push(s);
+        }
+    }
+    return texts;
+}
+/**
+ * Parses context from the remainder of a comment after a translation function call.
+ * Looks for context specified in options object syntax.
+ *
+ * @param remainder - The remaining text after the translation key
+ * @returns The parsed context value or undefined if none found
+ *
+ * @internal
+ */
+function parseContextFromComment(remainder) {
+    // Look for context in an options object, e.g., { context: 'male' }
+    const contextObj = /^\s*,\s*\{[^}]*context\s*:\s*(['"])(.*?)\1/.exec(remainder);
+    if (contextObj)
+        return contextObj[2];
+    return undefined;
+}
+/**
+ * Parses count from the remainder of a comment after a translation function call.
+ * Looks for count specified in options object syntax.
+ *
+ * @param remainder - The remaining text after the translation key
+ * @returns The parsed count value or undefined if none found
+ *
+ * @internal
+ */
+function parseCountFromComment(remainder) {
+    // Look for count in an options object, e.g., { count: 1 }
+    const countObj = /^\s*,\s*\{[^}]*count\s*:\s*(\d+)/.exec(remainder);
+    if (countObj)
+        return parseInt(countObj[1], 10);
+    return undefined;
+}
+/**
+ * Parses ordinal flag from the remainder of a comment after a translation function call.
+ * Looks for ordinal specified in options object syntax.
+ *
+ * @param remainder - The remaining text after the translation key
+ * @returns The parsed ordinal value or undefined if none found
+ *
+ * @internal
+ */
+function parseOrdinalFromComment(remainder) {
+    // Look for ordinal in an options object, e.g., { ordinal: true }
+    const ordinalObj = /^\s*,\s*\{[^}]*ordinal\s*:\s*(true|false)/.exec(remainder);
+    if (ordinalObj)
+        return ordinalObj[1] === 'true';
+    return undefined;
+}
+/**
+ * Converts a glob pattern to a regular expression.
+ * Supports basic glob patterns with * wildcards.
+ *
+ * @param glob - The glob pattern to convert
+ * @returns A RegExp that matches the glob pattern
+ *
+ * @internal
+ */
+function globToRegex(glob) {
+    const escaped = glob.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
+    const regexString = `^${escaped.replace(/\*/g, '.*')}$`;
+    return new RegExp(regexString);
+}
+
+export { extractKeysFromComments };