@localeguard/react-analyzer 0.1.0 → 0.3.0

package/dist/src/glob.d.ts

@@ -1,20 +1,7 @@
 /**
- * Minimal glob-based file discovery (zero dependencies).
- *
- * Supports the subset of glob syntax LocaleGuard configs use:
- *   - `**`  matches any number of path segments
- *   - `*`   matches anything except a path separator
- *   - `?`   matches a single non-separator character
- *   - `{a,b}` matches any of the comma-separated alternatives
- *
- * Paths are matched in POSIX form relative to the root directory.
+ * Re-exported from `@localeguard/core`, where the shared file-discovery utility
+ * now lives (used by both the React and template analyzers).
  */
-export declare function globToRegExp(glob: string): RegExp;
-export interface FindFilesOptions {
-    rootDir: string;
-    include: string[];
-    ignore?: string[];
-}
-/** Return absolute paths of files under `rootDir` matching the patterns. */
-export declare function findFiles(opts: FindFilesOptions): string[];
+export { findFiles, globToRegExp } from "@localeguard/core";
+export type { FindFilesOptions } from "@localeguard/core";
 //# sourceMappingURL=glob.d.ts.map

package/dist/src/glob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../src/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsCjD;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,EAAE,CA6B1D"}
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../../src/glob.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/glob.js

@@ -1,133 +1,11 @@
 "use strict";
 /**
- * Minimal glob-based file discovery (zero dependencies).
- *
- * Supports the subset of glob syntax LocaleGuard configs use:
- *   - `**`  matches any number of path segments
- *   - `*`   matches anything except a path separator
- *   - `?`   matches a single non-separator character
- *   - `{a,b}` matches any of the comma-separated alternatives
- *
- * Paths are matched in POSIX form relative to the root directory.
+ * Re-exported from `@localeguard/core`, where the shared file-discovery utility
+ * now lives (used by both the React and template analyzers).
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.globToRegExp = globToRegExp;
-exports.findFiles = findFiles;
-const fs = __importStar(require("node:fs"));
-const path = __importStar(require("node:path"));
-const ALWAYS_SKIP = new Set(["node_modules", ".git", "dist", "build", "coverage"]);
-function escapeLiteral(text) {
-    return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function globToRegExp(glob) {
-    let re = "";
-    let i = 0;
-    while (i < glob.length) {
-        const c = glob[i];
-        if (c === "*") {
-            if (glob[i + 1] === "*") {
-                if (glob[i + 2] === "/") {
-                    re += "(?:[^/]+/)*"; // **/ — zero or more segments
-                    i += 3;
-                }
-                else {
-                    re += ".*"; // ** — anything, including separators
-                    i += 2;
-                }
-                continue;
-            }
-            re += "[^/]*";
-            i += 1;
-            continue;
-        }
-        if (c === "?") {
-            re += "[^/]";
-            i += 1;
-            continue;
-        }
-        if (c === "{") {
-            const end = glob.indexOf("}", i);
-            if (end !== -1) {
-                const alts = glob.slice(i + 1, end).split(",").map(escapeLiteral);
-                re += `(?:${alts.join("|")})`;
-                i = end + 1;
-                continue;
-            }
-        }
-        re += escapeLiteral(c);
-        i += 1;
-    }
-    return new RegExp(`^${re}$`);
-}
-/** Return absolute paths of files under `rootDir` matching the patterns. */
-function findFiles(opts) {
-    const includeRe = opts.include.map(globToRegExp);
-    const ignoreRe = (opts.ignore ?? []).map(globToRegExp);
-    const results = [];
-    const walk = (dir) => {
-        let entries;
-        try {
-            entries = fs.readdirSync(dir, { withFileTypes: true });
-        }
-        catch {
-            return;
-        }
-        for (const entry of entries) {
-            const abs = path.join(dir, entry.name);
-            const rel = toPosix(path.relative(opts.rootDir, abs));
-            if (entry.isDirectory()) {
-                if (ALWAYS_SKIP.has(entry.name))
-                    continue;
-                if (ignoreRe.some((re) => re.test(rel)))
-                    continue;
-                walk(abs);
-            }
-            else if (entry.isFile()) {
-                if (ignoreRe.some((re) => re.test(rel)))
-                    continue;
-                if (includeRe.some((re) => re.test(rel)))
-                    results.push(abs);
-            }
-        }
-    };
-    walk(opts.rootDir);
-    results.sort();
-    return results;
-}
-function toPosix(p) {
-    return p.split(path.sep).join("/");
-}
+exports.globToRegExp = exports.findFiles = void 0;
+var core_1 = require("@localeguard/core");
+Object.defineProperty(exports, "findFiles", { enumerable: true, get: function () { return core_1.findFiles; } });
+Object.defineProperty(exports, "globToRegExp", { enumerable: true, get: function () { return core_1.globToRegExp; } });
 //# sourceMappingURL=glob.js.map

package/dist/src/glob.js.map

@@ -1 +1 @@
-{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/glob.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/glob.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,0CAA4D;AAAnD,iGAAA,SAAS,OAAA;AAAE,oGAAA,YAAY,OAAA"}

package/dist/src/index.d.ts

@@ -5,4 +5,6 @@ export { analyzeProject, analyzeSource, DEFAULT_INCLUDE, DEFAULT_TRANSLATION_COM
 export type { AnalyzerConfig, AnalyzeOptions } from "./analyzer";
 export { findFiles, globToRegExp } from "./glob";
 export type { FindFilesOptions } from "./glob";
+export { extractKeyReferences, extractFromSource } from "./key-references";
+export type { KeyReferenceConfig, KeyReferenceResult } from "./key-references";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,cAAc,EACd,aAAa,EACb,eAAe,EACf,8BAA8B,GAC/B,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/src/index.js

@@ -3,7 +3,7 @@
  * @localeguard/react-analyzer — public API.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.globToRegExp = exports.findFiles = exports.DEFAULT_TRANSLATION_COMPONENTS = exports.DEFAULT_INCLUDE = exports.analyzeSource = exports.analyzeProject = void 0;
+exports.extractFromSource = exports.extractKeyReferences = exports.globToRegExp = exports.findFiles = exports.DEFAULT_TRANSLATION_COMPONENTS = exports.DEFAULT_INCLUDE = exports.analyzeSource = exports.analyzeProject = void 0;
 var analyzer_1 = require("./analyzer");
 Object.defineProperty(exports, "analyzeProject", { enumerable: true, get: function () { return analyzer_1.analyzeProject; } });
 Object.defineProperty(exports, "analyzeSource", { enumerable: true, get: function () { return analyzer_1.analyzeSource; } });
@@ -12,4 +12,7 @@ Object.defineProperty(exports, "DEFAULT_TRANSLATION_COMPONENTS", { enumerable: t
 var glob_1 = require("./glob");
 Object.defineProperty(exports, "findFiles", { enumerable: true, get: function () { return glob_1.findFiles; } });
 Object.defineProperty(exports, "globToRegExp", { enumerable: true, get: function () { return glob_1.globToRegExp; } });
+var key_references_1 = require("./key-references");
+Object.defineProperty(exports, "extractKeyReferences", { enumerable: true, get: function () { return key_references_1.extractKeyReferences; } });
+Object.defineProperty(exports, "extractFromSource", { enumerable: true, get: function () { return key_references_1.extractFromSource; } });
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAKoB;AAJlB,0GAAA,cAAc,OAAA;AACd,yGAAA,aAAa,OAAA;AACb,2GAAA,eAAe,OAAA;AACf,0HAAA,8BAA8B,OAAA;AAGhC,+BAAiD;AAAxC,iGAAA,SAAS,OAAA;AAAE,oGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAKoB;AAJlB,0GAAA,cAAc,OAAA;AACd,yGAAA,aAAa,OAAA;AACb,2GAAA,eAAe,OAAA;AACf,0HAAA,8BAA8B,OAAA;AAGhC,+BAAiD;AAAxC,iGAAA,SAAS,OAAA;AAAE,oGAAA,YAAY,OAAA;AAEhC,mDAA2E;AAAlE,sHAAA,oBAAoB,OAAA;AAAE,mHAAA,iBAAiB,OAAA"}

package/dist/src/key-references.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Extract literal translation-key references from React/TypeScript source so
+ * they can be checked against the locale keys (used-but-missing / unused).
+ *
+ * Recognizes:
+ *   - `t('key')`, `i18n.t('key')`, `intl.formatMessage({ id: 'key' })`
+ *   - `<FormattedMessage id="key" />`, `<Trans i18nKey="key" />`
+ *   - `useTranslations('NS')` / `useTranslation('ns')` to resolve a file-level
+ *     namespace applied to bare `t('key')` calls.
+ *
+ * Non-literal keys (`t(name)`, template strings with substitutions) are not
+ * resolvable and are reported via `hasDynamicKeys` so the unused-key check can
+ * stay conservative.
+ */
+import type { KeyReference } from "@localeguard/core";
+export interface KeyReferenceConfig {
+    include?: string[];
+    ignore?: string[];
+    translationFunctions?: string[];
+    translationComponents?: string[];
+}
+export interface AnalyzeOptions {
+    rootDir: string;
+}
+export interface KeyReferenceResult {
+    references: KeyReference[];
+    hasDynamicKeys: boolean;
+}
+export declare function extractKeyReferences(config: KeyReferenceConfig, opts: AnalyzeOptions): KeyReferenceResult;
+export declare function extractFromSource(text: string, fileName: string, functions: Set<string>, components: Set<string>): KeyReferenceResult;
+//# sourceMappingURL=key-references.d.ts.map

package/dist/src/key-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-references.d.ts","sourceRoot":"","sources":["../../src/key-references.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAMtD,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,cAAc,EAAE,OAAO,CAAC;CACzB;AAID,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,cAAc,GACnB,kBAAkB,CAwBpB;AAQD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,EACtB,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GACtB,kBAAkB,CAmDpB"}

package/dist/src/key-references.js

@@ -0,0 +1,206 @@
+"use strict";
+/**
+ * Extract literal translation-key references from React/TypeScript source so
+ * they can be checked against the locale keys (used-but-missing / unused).
+ *
+ * Recognizes:
+ *   - `t('key')`, `i18n.t('key')`, `intl.formatMessage({ id: 'key' })`
+ *   - `<FormattedMessage id="key" />`, `<Trans i18nKey="key" />`
+ *   - `useTranslations('NS')` / `useTranslation('ns')` to resolve a file-level
+ *     namespace applied to bare `t('key')` calls.
+ *
+ * Non-literal keys (`t(name)`, template strings with substitutions) are not
+ * resolvable and are reported via `hasDynamicKeys` so the unused-key check can
+ * stay conservative.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractKeyReferences = extractKeyReferences;
+exports.extractFromSource = extractFromSource;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const typescript_1 = __importDefault(require("typescript"));
+const core_1 = require("@localeguard/core");
+const NAMESPACE_SETTERS = new Set(["useTranslations", "getTranslations", "useTranslation"]);
+const DEFAULT_TRANSLATION_FUNCTIONS = ["t", "i18n.t", "formatMessage", "intl.formatMessage"];
+const DEFAULT_TRANSLATION_COMPONENTS = ["FormattedMessage", "Trans"];
+const SOURCE_EXTENSIONS = new Set([".ts", ".tsx", ".js", ".jsx", ".mts", ".cts"]);
+function extractKeyReferences(config, opts) {
+    const include = config.include ?? ["src/**/*.{ts,tsx}"];
+    const functions = new Set(config.translationFunctions ?? DEFAULT_TRANSLATION_FUNCTIONS);
+    const components = new Set(config.translationComponents ?? DEFAULT_TRANSLATION_COMPONENTS);
+    const files = (0, core_1.findFiles)({ rootDir: opts.rootDir, include, ignore: config.ignore });
+    const references = [];
+    let hasDynamicKeys = false;
+    for (const absFile of files) {
+        if (!SOURCE_EXTENSIONS.has(path.extname(absFile).toLowerCase()))
+            continue;
+        let text;
+        try {
+            text = fs.readFileSync(absFile, "utf8");
+        }
+        catch {
+            continue;
+        }
+        const relPath = path.relative(opts.rootDir, absFile) || absFile;
+        const result = extractFromSource(text, relPath, functions, components);
+        references.push(...result.references);
+        hasDynamicKeys = hasDynamicKeys || result.hasDynamicKeys;
+    }
+    return { references, hasDynamicKeys };
+}
+function extractFromSource(text, fileName, functions, components) {
+    const sf = typescript_1.default.createSourceFile(fileName, text, typescript_1.default.ScriptTarget.Latest, true, scriptKindFor(fileName));
+    const raw = [];
+    let fileNamespace;
+    let hasDynamicKeys = false;
+    const lineOf = (node) => sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+    const visit = (node) => {
+        if (typescript_1.default.isCallExpression(node)) {
+            const callee = calleeName(node.expression, sf);
+            if (callee && NAMESPACE_SETTERS.has(callee.name)) {
+                const ns = stringArg(node.arguments[0]);
+                if (ns && fileNamespace === undefined)
+                    fileNamespace = ns;
+            }
+            else if (callee && (functions.has(callee.name) || functions.has(callee.full))) {
+                const arg = node.arguments[0];
+                if (arg && typescript_1.default.isObjectLiteralExpression(arg)) {
+                    // formatMessage({ id: '...' })
+                    const id = objectStringProp(arg, "id");
+                    if (id !== undefined)
+                        raw.push({ key: id, line: lineOf(node), useFileNamespace: false });
+                    else
+                        hasDynamicKeys = true;
+                }
+                else {
+                    const key = stringArg(arg);
+                    if (key !== undefined)
+                        raw.push({ key, line: lineOf(node), useFileNamespace: true });
+                    else if (arg)
+                        hasDynamicKeys = true;
+                }
+            }
+        }
+        else if (typescript_1.default.isJsxAttribute(node)) {
+            const attrName = node.name.getText(sf);
+            if (attrName === "id" || attrName === "i18nKey") {
+                const tag = enclosingJsxTagName(node);
+                if (tag && components.has(tag)) {
+                    const value = jsxAttrString(node);
+                    if (value !== undefined) {
+                        raw.push({ key: value, line: lineOf(node), useFileNamespace: attrName === "i18nKey" });
+                    }
+                }
+            }
+        }
+        typescript_1.default.forEachChild(node, visit);
+    };
+    visit(sf);
+    const references = raw.map((r) => ({
+        key: r.key,
+        namespace: r.useFileNamespace ? fileNamespace : undefined,
+        file: fileName,
+        line: r.line,
+    }));
+    return { references, hasDynamicKeys };
+}
+function calleeName(expr, sf) {
+    if (typescript_1.default.isIdentifier(expr))
+        return { name: expr.text, full: expr.text };
+    if (typescript_1.default.isPropertyAccessExpression(expr)) {
+        return { name: expr.name.text, full: expr.getText(sf) };
+    }
+    return null;
+}
+function stringArg(arg) {
+    if (!arg)
+        return undefined;
+    if (typescript_1.default.isStringLiteral(arg) || typescript_1.default.isNoSubstitutionTemplateLiteral(arg))
+        return arg.text;
+    return undefined;
+}
+function objectStringProp(obj, name) {
+    for (const prop of obj.properties) {
+        if (typescript_1.default.isPropertyAssignment(prop) && prop.name.getText() === name) {
+            return stringArg(prop.initializer);
+        }
+    }
+    return undefined;
+}
+function jsxAttrString(node) {
+    const init = node.initializer;
+    if (!init)
+        return undefined;
+    if (typescript_1.default.isStringLiteral(init))
+        return init.text;
+    if (typescript_1.default.isJsxExpression(init) && init.expression && typescript_1.default.isStringLiteralLike(init.expression)) {
+        return init.expression.text;
+    }
+    return undefined;
+}
+function enclosingJsxTagName(node) {
+    let current = node.parent;
+    while (current) {
+        if (typescript_1.default.isJsxOpeningElement(current) || typescript_1.default.isJsxSelfClosingElement(current)) {
+            const tag = current.tagName;
+            if (typescript_1.default.isIdentifier(tag))
+                return tag.text;
+            if (typescript_1.default.isPropertyAccessExpression(tag))
+                return tag.name.text;
+            return undefined;
+        }
+        current = current.parent;
+    }
+    return undefined;
+}
+function scriptKindFor(fileName) {
+    switch (path.extname(fileName)) {
+        case ".tsx":
+            return typescript_1.default.ScriptKind.TSX;
+        case ".jsx":
+            return typescript_1.default.ScriptKind.JSX;
+        case ".js":
+            return typescript_1.default.ScriptKind.JS;
+        case ".ts":
+            return typescript_1.default.ScriptKind.TS;
+        default:
+            return typescript_1.default.ScriptKind.TSX;
+    }
+}
+//# sourceMappingURL=key-references.js.map

package/dist/src/key-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-references.js","sourceRoot":"","sources":["../../src/key-references.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localeguard/react-analyzer",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Static analysis for LocaleGuard: detect hardcoded JSX text and unlocalized accessibility attributes in React/TypeScript source.",
   "license": "Apache-2.0",
   "author": "isamrish",
@@ -25,7 +25,7 @@
     "prepublishOnly": "tsc -b"
   },
   "dependencies": {
-    "@localeguard/core": "0.1.0",
+    "@localeguard/core": "0.3.0",
     "typescript": "^5.7.0"
   },
   "publishConfig": {