@localeguard/template-analyzer 0.3.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work, excluding
+          those notices that do not pertain to any part of the Derivative
+          Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and do
+          not modify the License. You may add Your own attribution notices
+          within Derivative Works that You distribute, alongside or as an
+          addendum to the NOTICE text from the Work, provided that such
+          additional attribution notices cannot be construed as modifying
+          the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 LocaleGuard contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,44 @@
+# @localeguard/template-analyzer
+
+Detect **hardcoded** user-facing text in Vue (`.vue`) and Angular (`.html`)
+templates for [LocaleGuard](https://github.com/isamrish/localeguard). Zero runtime
+dependencies — a small, focused HTML/template scanner (no `@vue/compiler-sfc` or
+Angular compiler required).
+
+Reports the same issue types as the React analyzer:
+
+- **`hardcoded-string`** — static template text, e.g. `<h1>Cluster Manager</h1>`
+- **`hardcoded-attribute`** — literal `aria-label`/`title`/`alt`/`placeholder`
+
+## Design: low false positives
+
+Only **static** content is flagged. Anything dynamic or already marked for
+translation is ignored:
+
+| Template | Flagged? |
+| --- | --- |
+| `<h1>Cluster Manager</h1>` | ✅ |
+| `<p>{{ t('title') }}</p>` | ❌ interpolation |
+| `<p>Hello {{ name }}</p>` | ✅ (only the static `Hello`) |
+| `<img :alt="x" />` / `<img [alt]="x" />` | ❌ bound attribute |
+| `<img alt="Logo" />` | ✅ |
+| `<i18n-t>…</i18n-t>` (Vue) | ❌ translation component |
+| `<p i18n>…</p>` (Angular) | ❌ marked for i18n |
+| `<button translate>KEY</button>` (Angular) | ❌ translate directive |
+| `<code>npm i</code>`, `<span>100%</span>` | ❌ technical / non-text |
+
+## Usage
+
+Composed automatically by the `localeguard` CLI based on the `framework` config
+(`vue-i18n` scans `.vue`; `ngx-translate` scans `.html`). It can also be used
+directly:
+
+```ts
+import { scanVueSfc, scanAngularTemplate } from "@localeguard/template-analyzer";
+
+const issues = scanVueSfc(vueSource, "App.vue", ["i18n-t"]);
+```
+
+## License
+
+[Apache-2.0](https://github.com/isamrish/localeguard/blob/main/LICENSE)

package/dist/src/angular.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Angular component templates (external `.html` files).
+ */
+import type { Issue } from "@localeguard/core";
+export declare function scanAngularTemplate(source: string, fileName: string, translationComponents?: string[]): Issue[];
+//# sourceMappingURL=angular.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"angular.d.ts","sourceRoot":"","sources":["../../src/angular.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAC/B,KAAK,EAAE,CAOT"}

package/dist/src/angular.js

@@ -0,0 +1,16 @@
+"use strict";
+/**
+ * Angular component templates (external `.html` files).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanAngularTemplate = scanAngularTemplate;
+const scanner_1 = require("./scanner");
+function scanAngularTemplate(source, fileName, translationComponents) {
+    return (0, scanner_1.scanTemplate)(source, {
+        mode: "angular",
+        fileName,
+        startLine: 1,
+        translationComponents,
+    });
+}
+//# sourceMappingURL=angular.js.map

package/dist/src/angular.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular.js","sourceRoot":"","sources":["../../src/angular.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAMH,kDAWC;AAbD,uCAAyC;AAEzC,SAAgB,mBAAmB,CACjC,MAAc,EACd,QAAgB,EAChB,qBAAgC;IAEhC,OAAO,IAAA,sBAAY,EAAC,MAAM,EAAE;QAC1B,IAAI,EAAE,SAAS;QACf,QAAQ;QACR,SAAS,EAAE,CAAC;QACZ,qBAAqB;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @localeguard/template-analyzer — detect hardcoded text in Vue (`.vue`) and
+ * Angular (`.html`) templates. Zero runtime dependencies.
+ */
+import type { Framework, Issue } from "@localeguard/core";
+export interface TemplateAnalyzerConfig {
+    include?: string[];
+    ignore?: string[];
+    translationComponents?: string[];
+    framework?: Framework;
+}
+export interface AnalyzeOptions {
+    /** Absolute project root; reported file paths are relative to this. */
+    rootDir: string;
+}
+export declare function analyzeTemplates(config: TemplateAnalyzerConfig, opts: AnalyzeOptions): Issue[];
+export { scanTemplate } from "./scanner";
+export type { ScanOptions, TemplateMode } from "./scanner";
+export { scanVueSfc } from "./vue";
+export { scanAngularTemplate } from "./angular";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAK1D,MAAM,WAAW,sBAAsB;IACrC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;CACjB;AASD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,EAAE,IAAI,EAAE,cAAc,GAAG,KAAK,EAAE,CA6B9F;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * @localeguard/template-analyzer — detect hardcoded text in Vue (`.vue`) and
+ * Angular (`.html`) templates. Zero runtime dependencies.
+ */
+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.scanAngularTemplate = exports.scanVueSfc = exports.scanTemplate = void 0;
+exports.analyzeTemplates = analyzeTemplates;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const core_1 = require("@localeguard/core");
+const angular_1 = require("./angular");
+const vue_1 = require("./vue");
+/** Default globs by framework when `include` is not set. */
+function defaultInclude(framework) {
+    if (framework === "vue-i18n")
+        return ["src/**/*.vue"];
+    if (framework === "ngx-translate")
+        return ["src/**/*.html"];
+    return [];
+}
+function analyzeTemplates(config, opts) {
+    const include = config.include ?? defaultInclude(config.framework);
+    if (include.length === 0)
+        return [];
+    const files = (0, core_1.findFiles)({ rootDir: opts.rootDir, include, ignore: config.ignore });
+    const angular = config.framework === "ngx-translate";
+    const issues = [];
+    for (const absFile of files) {
+        const ext = path.extname(absFile).toLowerCase();
+        // `.vue` is unambiguous; only treat `.html` as a template for Angular, so we
+        // never scan arbitrary HTML pages in other projects.
+        if (ext !== ".vue" && !(ext === ".html" && angular))
+            continue;
+        let text;
+        try {
+            text = fs.readFileSync(absFile, "utf8");
+        }
+        catch {
+            continue;
+        }
+        const rel = path.relative(opts.rootDir, absFile) || absFile;
+        if (ext === ".vue") {
+            issues.push(...(0, vue_1.scanVueSfc)(text, rel, config.translationComponents));
+        }
+        else {
+            issues.push(...(0, angular_1.scanAngularTemplate)(text, rel, config.translationComponents));
+        }
+    }
+    return issues;
+}
+var scanner_1 = require("./scanner");
+Object.defineProperty(exports, "scanTemplate", { enumerable: true, get: function () { return scanner_1.scanTemplate; } });
+var vue_2 = require("./vue");
+Object.defineProperty(exports, "scanVueSfc", { enumerable: true, get: function () { return vue_2.scanVueSfc; } });
+var angular_2 = require("./angular");
+Object.defineProperty(exports, "scanAngularTemplate", { enumerable: true, get: function () { return angular_2.scanAngularTemplate; } });
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BH,4CA6BC;AAzDD,4CAA8B;AAC9B,gDAAkC;AAElC,4CAA8C;AAG9C,uCAAgD;AAChD,+BAAmC;AAcnC,4DAA4D;AAC5D,SAAS,cAAc,CAAC,SAAqB;IAC3C,IAAI,SAAS,KAAK,UAAU;QAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACtD,IAAI,SAAS,KAAK,eAAe;QAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5D,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAgB,gBAAgB,CAAC,MAA8B,EAAE,IAAoB;IACnF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEpC,MAAM,KAAK,GAAG,IAAA,gBAAS,EAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,KAAK,eAAe,CAAC;IACrD,MAAM,MAAM,GAAY,EAAE,CAAC;IAE3B,KAAK,MAAM,OAAO,IAAI,KAAK,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAChD,6EAA6E;QAC7E,qDAAqD;QACrD,IAAI,GAAG,KAAK,MAAM,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO,IAAI,OAAO,CAAC;YAAE,SAAS;QAE9D,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,OAAO,CAAC;QAE5D,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,GAAG,IAAA,gBAAU,EAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC;QACtE,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,GAAG,IAAA,6BAAmB,EAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qCAAyC;AAAhC,uGAAA,YAAY,OAAA;AAErB,6BAAmC;AAA1B,iGAAA,UAAU,OAAA;AACnB,qCAAgD;AAAvC,8GAAA,mBAAmB,OAAA"}

package/dist/src/scanner.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A small, dependency-free scanner for HTML-style templates (Vue `<template>`
+ * blocks and Angular component templates). It flags hardcoded, user-facing text
+ * while staying conservative to keep false positives low:
+ *
+ *   - `{{ … }}` interpolation is dynamic and ignored.
+ *   - Bound attributes (`:title`, `[title]`, `v-bind:title`) are ignored.
+ *   - Text inside translation components (`<i18n-t>`), Angular `i18n`-marked
+ *     elements, `translate`/`v-t` directives, and technical/raw elements
+ *     (`script`, `style`, `code`, `pre`, …) is ignored.
+ *
+ * This is a pragmatic tokenizer, not a spec-complete HTML parser.
+ */
+import type { Issue } from "@localeguard/core";
+export type TemplateMode = "vue" | "angular";
+export interface ScanOptions {
+    mode: TemplateMode;
+    fileName: string;
+    /** 1-based line of the first character of `source` within the real file. */
+    startLine?: number;
+    /** Extra element names whose text should be treated as already-translated. */
+    translationComponents?: string[];
+}
+export declare function scanTemplate(source: string, options: ScanOptions): Issue[];
+//# sourceMappingURL=scanner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../src/scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,SAAS,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;CAClC;AAkCD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,KAAK,EAAE,CAyF1E"}

package/dist/src/scanner.js

@@ -0,0 +1,250 @@
+"use strict";
+/**
+ * A small, dependency-free scanner for HTML-style templates (Vue `<template>`
+ * blocks and Angular component templates). It flags hardcoded, user-facing text
+ * while staying conservative to keep false positives low:
+ *
+ *   - `{{ … }}` interpolation is dynamic and ignored.
+ *   - Bound attributes (`:title`, `[title]`, `v-bind:title`) are ignored.
+ *   - Text inside translation components (`<i18n-t>`), Angular `i18n`-marked
+ *     elements, `translate`/`v-t` directives, and technical/raw elements
+ *     (`script`, `style`, `code`, `pre`, …) is ignored.
+ *
+ * This is a pragmatic tokenizer, not a spec-complete HTML parser.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanTemplate = scanTemplate;
+const core_1 = require("@localeguard/core");
+const LOCALIZABLE_ATTRS = new Set(["aria-label", "title", "alt", "placeholder"]);
+/** Text inside these elements is technical or raw, never prose. */
+const NON_LOCALIZABLE_ELEMENTS = new Set([
+    "script",
+    "style",
+    "code",
+    "pre",
+    "kbd",
+    "samp",
+    "var",
+    "textarea",
+]);
+/** Elements parsed as raw text (their contents are not markup). */
+const RAW_TEXT_ELEMENTS = new Set(["script", "style"]);
+const HAS_LETTER = /\p{L}/u;
+const HTML_ENTITY = /&[a-zA-Z]+;|&#\d+;/g;
+const INTERPOLATION = /\{\{[\s\S]*?\}\}/g;
+function scanTemplate(source, options) {
+    const issues = [];
+    const translationComponents = new Set((options.translationComponents ?? []).map((c) => c.toLowerCase()));
+    const stack = [];
+    let pos = 0;
+    let line = options.startLine ?? 1;
+    const advanceTo = (next) => {
+        for (let i = pos; i < next; i++) {
+            if (source[i] === "\n")
+                line += 1;
+        }
+        pos = next;
+    };
+    const skipping = () => stack.length > 0 && stack[stack.length - 1].skipText;
+    while (pos < source.length) {
+        const lt = source.indexOf("<", pos);
+        // Trailing text after the last tag.
+        if (lt === -1) {
+            maybeText(source.slice(pos), line, skipping(), options, issues);
+            break;
+        }
+        if (lt > pos) {
+            const text = source.slice(pos, lt);
+            maybeText(text, line, skipping(), options, issues);
+            advanceTo(lt);
+        }
+        // Comment.
+        if (source.startsWith("<!--", pos)) {
+            const end = source.indexOf("-->", pos + 4);
+            advanceTo(end === -1 ? source.length : end + 3);
+            continue;
+        }
+        // Closing tag.
+        if (source.startsWith("</", pos)) {
+            const gt = source.indexOf(">", pos);
+            const name = source.slice(pos + 2, gt === -1 ? source.length : gt).trim().toLowerCase();
+            for (let i = stack.length - 1; i >= 0; i--) {
+                if (stack[i].name === name) {
+                    stack.length = i;
+                    break;
+                }
+            }
+            advanceTo(gt === -1 ? source.length : gt + 1);
+            continue;
+        }
+        // Opening tag (or stray '<').
+        const gt = findTagEnd(source, pos);
+        if (gt === -1) {
+            advanceTo(source.length);
+            break;
+        }
+        const raw = source.slice(pos, gt + 1);
+        const tagLine = line;
+        const parsed = parseTag(raw);
+        if (!parsed) {
+            advanceTo(gt + 1);
+            continue;
+        }
+        const { name, attrs, selfClosing } = parsed;
+        emitAttributeIssues(name, attrs, tagLine, options, issues);
+        advanceTo(gt + 1);
+        if (RAW_TEXT_ELEMENTS.has(name) && !selfClosing) {
+            const close = source.toLowerCase().indexOf(`</${name}`, pos);
+            advanceTo(close === -1 ? source.length : close);
+            continue;
+        }
+        if (!selfClosing && !isVoidElement(name)) {
+            const parentSkip = skipping();
+            stack.push({
+                name,
+                skipText: parentSkip || elementSkipsText(name, attrs, translationComponents, options.mode),
+            });
+        }
+    }
+    return issues;
+}
+function maybeText(rawText, textLine, skip, options, issues) {
+    if (skip)
+        return;
+    const withoutInterp = rawText.replace(INTERPOLATION, " ");
+    const collapsed = withoutInterp.replace(/\s+/g, " ").trim();
+    if (collapsed.length === 0)
+        return;
+    if (!HAS_LETTER.test(collapsed.replace(HTML_ENTITY, "")))
+        return;
+    // Line of the first non-whitespace character of the (original) text.
+    const leading = rawText.length - rawText.replace(/^\s+/, "").length;
+    const line = textLine + countNewlines(rawText.slice(0, leading));
+    issues.push({
+        type: "hardcoded-string",
+        severity: core_1.SEVERITY_BY_TYPE["hardcoded-string"],
+        file: options.fileName,
+        line,
+        message: `Hardcoded template text: ${quote(collapsed)}`,
+        suggestion: "Move user-facing text into a translation message.",
+    });
+}
+function emitAttributeIssues(name, attrs, tagLine, options, issues) {
+    const attrNames = new Set(attrs.map((a) => a.name.toLowerCase()));
+    for (const attr of attrs) {
+        const lower = attr.name.toLowerCase();
+        if (isBoundAttr(lower))
+            continue;
+        if (!LOCALIZABLE_ATTRS.has(lower))
+            continue;
+        if (attr.value === undefined || !HAS_LETTER.test(attr.value))
+            continue;
+        // Angular: i18n-<attr> marks the attribute as translatable.
+        if (options.mode === "angular" && attrNames.has(`i18n-${lower}`))
+            continue;
+        issues.push({
+            type: "hardcoded-attribute",
+            severity: core_1.SEVERITY_BY_TYPE["hardcoded-attribute"],
+            file: options.fileName,
+            line: tagLine,
+            message: `Hardcoded ${lower} value: ${quote(attr.value)}`,
+            suggestion: `Localize the ${lower} attribute.`,
+        });
+    }
+}
+function elementSkipsText(name, attrs, translationComponents, mode) {
+    if (NON_LOCALIZABLE_ELEMENTS.has(name))
+        return true;
+    if (translationComponents.has(name))
+        return true;
+    const attrNames = new Set(attrs.map((a) => a.name.toLowerCase()));
+    if (mode === "vue") {
+        if (attrNames.has("v-t") || attrNames.has("v-text") || attrNames.has("v-html"))
+            return true;
+    }
+    else {
+        // Angular: a bare `i18n` attribute marks the element's text as translatable;
+        // `translate` is the ngx-translate directive; innerHTML/textContent bindings
+        // replace the text dynamically.
+        if (attrNames.has("i18n") || attrNames.has("translate"))
+            return true;
+        if (attrNames.has("[innerhtml]") || attrNames.has("[textcontent]"))
+            return true;
+    }
+    return false;
+}
+function isBoundAttr(name) {
+    return (name.startsWith(":") ||
+        name.startsWith("@") ||
+        name.startsWith("[") ||
+        name.startsWith("(") ||
+        name.startsWith("*") ||
+        name.startsWith("#") ||
+        name.startsWith("v-bind:") ||
+        name.startsWith("v-on:") ||
+        name.startsWith("bind-") ||
+        name.startsWith("on-"));
+}
+function parseTag(raw) {
+    // raw includes the surrounding < … >
+    const inner = raw.slice(1, raw.endsWith("/>") ? -2 : -1).trim();
+    const selfClosing = raw.endsWith("/>");
+    const nameMatch = /^[a-zA-Z][\w.-]*/.exec(inner);
+    if (!nameMatch)
+        return null;
+    const name = nameMatch[0].toLowerCase();
+    const attrs = parseAttributes(inner.slice(nameMatch[0].length));
+    return { name, attrs, selfClosing };
+}
+function parseAttributes(text) {
+    const attrs = [];
+    // Attribute names in Vue/Angular can include : @ [ ] ( ) * # . - _ and letters.
+    const re = /([:@#[\]()*.\w-]+)(\s*=\s*("([^"]*)"|'([^']*)'|(\S+)))?/g;
+    let m;
+    while ((m = re.exec(text)) !== null) {
+        if (!m[1])
+            continue;
+        const value = m[4] ?? m[5] ?? m[6];
+        attrs.push({ name: m[1], value });
+    }
+    return attrs;
+}
+function findTagEnd(source, start) {
+    // Find the '>' that closes this tag, skipping any inside quoted attribute values.
+    let quoteCh = null;
+    for (let i = start + 1; i < source.length; i++) {
+        const ch = source[i];
+        if (quoteCh) {
+            if (ch === quoteCh)
+                quoteCh = null;
+        }
+        else if (ch === '"' || ch === "'") {
+            quoteCh = ch;
+        }
+        else if (ch === ">") {
+            return i;
+        }
+    }
+    return -1;
+}
+const VOID_ELEMENTS = new Set([
+    "area", "base", "br", "col", "embed", "hr", "img", "input",
+    "link", "meta", "param", "source", "track", "wbr",
+]);
+function isVoidElement(name) {
+    return VOID_ELEMENTS.has(name);
+}
+function countNewlines(text) {
+    let count = 0;
+    for (let i = 0; i < text.length; i++) {
+        if (text[i] === "\n")
+            count += 1;
+    }
+    return count;
+}
+function quote(value) {
+    const max = 50;
+    const truncated = value.length > max ? `${value.slice(0, max - 1)}…` : value;
+    return JSON.stringify(truncated);
+}
+//# sourceMappingURL=scanner.js.map

package/dist/src/scanner.js.map

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

package/dist/src/vue.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Vue Single File Components: extract the top-level `<template>` block and scan
+ * it. Line numbers are offset back to the position in the `.vue` file.
+ */
+import type { Issue } from "@localeguard/core";
+export declare function scanVueSfc(source: string, fileName: string, translationComponents?: string[]): Issue[];
+//# sourceMappingURL=vue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../src/vue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,qBAAqB,CAAC,EAAE,MAAM,EAAE,GAC/B,KAAK,EAAE,CAST"}

package/dist/src/vue.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Vue Single File Components: extract the top-level `<template>` block and scan
+ * it. Line numbers are offset back to the position in the `.vue` file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanVueSfc = scanVueSfc;
+const scanner_1 = require("./scanner");
+function scanVueSfc(source, fileName, translationComponents) {
+    const block = extractTemplateBlock(source);
+    if (!block)
+        return [];
+    return (0, scanner_1.scanTemplate)(block.content, {
+        mode: "vue",
+        fileName,
+        startLine: block.startLine,
+        translationComponents,
+    });
+}
+function extractTemplateBlock(source) {
+    const open = /<template(\s[^>]*)?>/i.exec(source);
+    if (!open)
+        return null;
+    const contentStart = open.index + open[0].length;
+    // The root <template> closes at the last </template> (later ones may be
+    // nested `<template #slot>` / `<template v-if>` elements).
+    const closeIdx = source.toLowerCase().lastIndexOf("</template>");
+    if (closeIdx === -1 || closeIdx < contentStart)
+        return null;
+    const content = source.slice(contentStart, closeIdx);
+    const startLine = source.slice(0, contentStart).split("\n").length;
+    return { content, startLine };
+}
+//# sourceMappingURL=vue.js.map

package/dist/src/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","sourceRoot":"","sources":["../../src/vue.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAMH,gCAaC;AAfD,uCAAyC;AAEzC,SAAgB,UAAU,CACxB,MAAc,EACd,QAAgB,EAChB,qBAAgC;IAEhC,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,IAAA,sBAAY,EAAC,KAAK,CAAC,OAAO,EAAE;QACjC,IAAI,EAAE,KAAK;QACX,QAAQ;QACR,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,qBAAqB;KACtB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,oBAAoB,CAAC,MAAc;IAC1C,MAAM,IAAI,GAAG,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACjD,wEAAwE;IACxE,2DAA2D;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IACjE,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,QAAQ,GAAG,YAAY;QAAE,OAAO,IAAI,CAAC;IAE5D,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IACnE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AAChC,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@localeguard/template-analyzer",
+  "version": "0.3.0",
+  "description": "Detect hardcoded text in Vue (.vue) and Angular (.html) templates for LocaleGuard.",
+  "license": "Apache-2.0",
+  "author": "isamrish",
+  "homepage": "https://github.com/isamrish/localeguard/tree/main/packages/template-analyzer#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/isamrish/localeguard.git",
+    "directory": "packages/template-analyzer"
+  },
+  "bugs": {
+    "url": "https://github.com/isamrish/localeguard/issues"
+  },
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "files": [
+    "dist/src"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "prepublishOnly": "tsc -b"
+  },
+  "dependencies": {
+    "@localeguard/core": "0.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "localization",
+    "i18n",
+    "vue",
+    "angular",
+    "template",
+    "static-analysis"
+  ]
+}