@futdevpro/dynamo-eslint 1.20.29 → 1.20.55

package/build/scripts/lint-strict.d.ts

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview Strict lint entry point — `dynamo-lint-strict` (BFR-WARFACTORY-003)
+ *
+ * Runs ESLint (flat config, the project's own `eslint.config.*`) and sets the process exit code from the
+ * AGGREGATED result counters — never from a wrapper's own success path:
+ *
+ * | exit | meaning |
+ * |---|---|
+ * | `0` | 0 errors (incl. fatal/parsing errors) and the warnings are within the budget |
+ * | `1` | at least one error, OR more warnings than `--max-warnings` |
+ * | `2` | lint could not run (config error, NO file linted, crash) — never reported as a pass |
+ *
+ * **Warning budget:** without `--max-warnings` warnings are reported but do not fail (the budget is unlimited);
+ * `--max-warnings 0` is the zero-warning gate; `--max-warnings <n>` a ratchet for a known backlog.
+ *
+ * **`.eslintignore`:** flat config does NOT read it (ESLint 9) — files listed there ARE linted. If one exists, the
+ * run says so loudly and points at the `ignores` migration; it does not fail on it.
+ *
+ * @usage
+ * ```bash
+ * dynamo-lint-strict [patterns...] [--max-warnings <n>] [--json]
+ * dynamo-lint-strict src --max-warnings 0
+ * dynamo-lint-strict --json          # last stdout line: machine-readable summary (CI)
+ * ```
+ */
+import { ESLint } from 'eslint';
+/** Parsed command-line options of `dynamo-lint-strict`. */
+export interface DyESL_LintStrictOptions_Interface {
+    patterns: string[];
+    /** `undefined` = unlimited warning budget */
+    maxWarnings?: number;
+    json: boolean;
+}
+/** Aggregated result of one strict lint run. */
+export interface DyESL_LintStrictSummary_Interface {
+    errorCount: number;
+    fatalErrorCount: number;
+    warningCount: number;
+    fileCount: number;
+    maxWarnings: number | null;
+    legacyEslintignore: boolean;
+    passed: boolean;
+    exitCode: number;
+}
+/** Strict lint runner — pure helpers (unit-testable) + the CLI `run`. */
+export declare class DyESL_LintStrict_Util {
+    /**
+     * Parses `[patterns...] [--max-warnings <n>] [--json]`.
+     * @throws Error on an invalid / missing `--max-warnings` value or an unknown option
+     */
+    static parseArgs(argv: string[]): DyESL_LintStrictOptions_Interface;
+    /** Aggregates the ESLint results into the summary + the exit code (0 pass / 1 fail). */
+    static summarize(results: ESLint.LintResult[], maxWarnings: number | undefined, legacyEslintignore: boolean): DyESL_LintStrictSummary_Interface;
+    /** Human-readable one-line verdict. */
+    static formatVerdict(summary: DyESL_LintStrictSummary_Interface): string;
+    /**
+     * Runs the strict lint in `cwd` and returns the exit code (0 / 1 / 2). Output goes to stdout/stderr.
+     */
+    static run(argv: string[], cwd?: string): Promise<number>;
+}
+//# sourceMappingURL=lint-strict.d.ts.map

package/build/scripts/lint-strict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-strict.d.ts","sourceRoot":"","sources":["../../src/scripts/lint-strict.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,2DAA2D;AAC3D,MAAM,WAAW,iCAAiC;IAChD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,gDAAgD;AAChD,MAAM,WAAW,iCAAiC;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,yEAAyE;AACzE,qBAAa,qBAAqB;IAEhC;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,iCAAiC;IA6BnE,wFAAwF;IACxF,MAAM,CAAC,SAAS,CACd,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,EAC5B,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,kBAAkB,EAAE,OAAO,GAC1B,iCAAiC;IAsBpC,uCAAuC;IACvC,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,iCAAiC,GAAG,MAAM;IAQxE;;OAEG;WACU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC;CAkD/E"}

package/build/scripts/lint-strict.js

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * @fileoverview Strict lint entry point — `dynamo-lint-strict` (BFR-WARFACTORY-003)
+ *
+ * Runs ESLint (flat config, the project's own `eslint.config.*`) and sets the process exit code from the
+ * AGGREGATED result counters — never from a wrapper's own success path:
+ *
+ * | exit | meaning |
+ * |---|---|
+ * | `0` | 0 errors (incl. fatal/parsing errors) and the warnings are within the budget |
+ * | `1` | at least one error, OR more warnings than `--max-warnings` |
+ * | `2` | lint could not run (config error, NO file linted, crash) — never reported as a pass |
+ *
+ * **Warning budget:** without `--max-warnings` warnings are reported but do not fail (the budget is unlimited);
+ * `--max-warnings 0` is the zero-warning gate; `--max-warnings <n>` a ratchet for a known backlog.
+ *
+ * **`.eslintignore`:** flat config does NOT read it (ESLint 9) — files listed there ARE linted. If one exists, the
+ * run says so loudly and points at the `ignores` migration; it does not fail on it.
+ *
+ * @usage
+ * ```bash
+ * dynamo-lint-strict [patterns...] [--max-warnings <n>] [--json]
+ * dynamo-lint-strict src --max-warnings 0
+ * dynamo-lint-strict --json          # last stdout line: machine-readable summary (CI)
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyESL_LintStrict_Util = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const eslint_1 = require("eslint");
+/** Strict lint runner — pure helpers (unit-testable) + the CLI `run`. */
+class DyESL_LintStrict_Util {
+    /**
+     * Parses `[patterns...] [--max-warnings <n>] [--json]`.
+     * @throws Error on an invalid / missing `--max-warnings` value or an unknown option
+     */
+    static parseArgs(argv) {
+        const options = { patterns: [], json: false };
+        for (let i = 0; i < argv.length; i++) {
+            const arg = argv[i];
+            if (arg === '--json') {
+                options.json = true;
+            }
+            else if (arg === '--max-warnings') {
+                const value = Number(argv[i + 1]);
+                if (argv[i + 1] === undefined || !Number.isInteger(value) || value < 0) {
+                    throw new Error(`--max-warnings needs a non-negative integer (got: ${argv[i + 1] ?? 'nothing'})`);
+                }
+                options.maxWarnings = value;
+                i++;
+            }
+            else if (arg.startsWith('-')) {
+                throw new Error(`unknown option: ${arg}`);
+            }
+            else {
+                options.patterns.push(arg);
+            }
+        }
+        if (!options.patterns.length) {
+            options.patterns.push('.');
+        }
+        return options;
+    }
+    /** Aggregates the ESLint results into the summary + the exit code (0 pass / 1 fail). */
+    static summarize(results, maxWarnings, legacyEslintignore) {
+        const errorCount = results.reduce((sum, r) => sum + r.errorCount, 0);
+        const fatalErrorCount = results
+            .reduce((sum, r) => sum + r.fatalErrorCount, 0);
+        const warningCount = results
+            .reduce((sum, r) => sum + r.warningCount, 0);
+        // a `fatalErrorCount` az `errorCount` RÉSZE (ESLint 9) — külön is számoljuk, hogy a parsing-hiba látsszon
+        const overBudget = maxWarnings !== undefined && warningCount > maxWarnings;
+        const passed = !errorCount && !fatalErrorCount && !overBudget;
+        return {
+            errorCount: errorCount,
+            fatalErrorCount: fatalErrorCount,
+            warningCount: warningCount,
+            fileCount: results.length,
+            maxWarnings: maxWarnings ?? null,
+            legacyEslintignore: legacyEslintignore,
+            passed: passed,
+            exitCode: passed ? 0 : 1,
+        };
+    }
+    /** Human-readable one-line verdict. */
+    static formatVerdict(summary) {
+        const budget = summary.maxWarnings === null ? 'unlimited' : `${summary.maxWarnings}`;
+        return `[dynamo-lint-strict] ${summary.passed ? 'PASS' : 'FAIL'} — errors: ${summary.errorCount}`
+            + ` (fatal: ${summary.fatalErrorCount}) · warnings: ${summary.warningCount} (budget: ${budget})`
+            + ` · files: ${summary.fileCount}`;
+    }
+    /**
+     * Runs the strict lint in `cwd` and returns the exit code (0 / 1 / 2). Output goes to stdout/stderr.
+     */
+    static async run(argv, cwd = process.cwd()) {
+        let options;
+        try {
+            options = DyESL_LintStrict_Util.parseArgs(argv);
+        }
+        catch (error) {
+            console.error(`[dynamo-lint-strict] usage error: ${error instanceof Error ? error.message : String(error)}`);
+            return 2;
+        }
+        const legacyEslintignore = (0, fs_1.existsSync)((0, path_1.join)(cwd, '.eslintignore'));
+        if (legacyEslintignore) {
+            console.error('[dynamo-lint-strict] ⚠️ .eslintignore found — ESLint 9 flat config does NOT read it, the files'
+                + ' listed there ARE linted. Move the patterns into an `ignores` entry of eslint.config.* and delete the file.');
+        }
+        try {
+            const eslint = new eslint_1.ESLint({ cwd: cwd });
+            const results = await eslint.lintFiles(options.patterns);
+            // üres futás ⛔ zöld: az ESLint `errorOnUnmatchedPattern`-je MÉRTEN nem megbízható (nem létező mappára 5/5
+            // futásban 0 fájlt adott vissza, hiba nélkül) — ezért a kapu maga ellenőrzi
+            if (!results.length) {
+                console.error(`[dynamo-lint-strict] no file was linted for: ${options.patterns.join(' ')} (exit 2)`
+                    + ' — an empty run is not a pass. Check the patterns and the `ignores` of eslint.config.*.');
+                return 2;
+            }
+            const summary = DyESL_LintStrict_Util.summarize(results, options.maxWarnings, legacyEslintignore);
+            const formatter = await eslint.loadFormatter('stylish');
+            const formatted = await formatter.format(results);
+            if (formatted) {
+                console.log(formatted);
+            }
+            console.log(DyESL_LintStrict_Util.formatVerdict(summary));
+            if (options.json) {
+                console.log(JSON.stringify(summary));
+            }
+            return summary.exitCode;
+        }
+        catch (error) {
+            // a lint NEM futott le ⇒ ⛔ soha nem „zöld"
+            console.error('[dynamo-lint-strict] lint could not run (exit 2):', error instanceof Error ? error.message : String(error));
+            return 2;
+        }
+    }
+}
+exports.DyESL_LintStrict_Util = DyESL_LintStrict_Util;
+if (require.main === module) {
+    DyESL_LintStrict_Util.run(process.argv.slice(2))
+        .then((code) => {
+        process.exitCode = code;
+    })
+        .catch((error) => {
+        console.error('[dynamo-lint-strict] crashed (exit 2):', error);
+        process.exitCode = 2;
+    });
+}
+//# sourceMappingURL=lint-strict.js.map

package/build/scripts/lint-strict.js.map

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

package/build/scripts/ui-building-blocks-baseline.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview UI-building-blocks baseline generator (BFR-QA-004)
+ *
+ * Writes the committed per-project baseline of the `@futdevpro/dynamo/scroll-container-min-h-0` and
+ * `@futdevpro/dynamo/module-load-failed-branch` rules: the scroll containers that will not scroll (per file) and the
+ * modules that show a loading state without a load-failed state — as they are TODAY. The rules then accept those and
+ * fail only on new ones. The analysis is the rules' own scanner.
+ *
+ * `settings.scrollerTags` (component tags that ARE scroll containers) is kept from the existing baseline; add more
+ * with `--scroller-tag <tag>` (repeatable).
+ *
+ * @usage
+ * ```bash
+ * npx dynamo-ui-building-blocks-baseline                      # run in the folder ESLint runs in (e.g. client/)
+ * npx dynamo-ui-building-blocks-baseline --scroller-tag app-a-pull-to-refresh
+ * npx dynamo-ui-building-blocks-baseline --check              # exit 1 if a new case appeared
+ * ```
+ */
+export {};
+//# sourceMappingURL=ui-building-blocks-baseline.d.ts.map

package/build/scripts/ui-building-blocks-baseline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-building-blocks-baseline.d.ts","sourceRoot":"","sources":["../../src/scripts/ui-building-blocks-baseline.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;GAiBG"}

package/build/scripts/ui-building-blocks-baseline.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * @fileoverview UI-building-blocks baseline generator (BFR-QA-004)
+ *
+ * Writes the committed per-project baseline of the `@futdevpro/dynamo/scroll-container-min-h-0` and
+ * `@futdevpro/dynamo/module-load-failed-branch` rules: the scroll containers that will not scroll (per file) and the
+ * modules that show a loading state without a load-failed state — as they are TODAY. The rules then accept those and
+ * fail only on new ones. The analysis is the rules' own scanner.
+ *
+ * `settings.scrollerTags` (component tags that ARE scroll containers) is kept from the existing baseline; add more
+ * with `--scroller-tag <tag>` (repeatable).
+ *
+ * @usage
+ * ```bash
+ * npx dynamo-ui-building-blocks-baseline                      # run in the folder ESLint runs in (e.g. client/)
+ * npx dynamo-ui-building-blocks-baseline --scroller-tag app-a-pull-to-refresh
+ * npx dynamo-ui-building-blocks-baseline --check              # exit 1 if a new case appeared
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const fast_glob_1 = tslib_1.__importDefault(require("fast-glob"));
+const fs_1 = require("fs");
+const path = tslib_1.__importStar(require("path"));
+const ui_building_blocks_util_1 = require("../plugin/rules/angular/ui-building-blocks.util");
+const empty_state_guard_util_1 = require("../plugin/rules/angular/empty-state-guard.util");
+/** Scans a project folder into baseline form. */
+function scanProject(root, scrollerTags) {
+    const files = fast_glob_1.default.sync(['**/*.html', '**/*.ts'], {
+        cwd: root,
+        ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.angular/**', '**/coverage/**'],
+        dot: false,
+    });
+    const scrollContainers = {};
+    const loadingModules = new Set();
+    const failedModules = new Set();
+    const emptyStatesWithoutGuard = {};
+    files.sort().forEach((rel) => {
+        if (!ui_building_blocks_util_1.UiBuildingBlocks_Util.isInScope(rel)) {
+            return;
+        }
+        const full = path.join(root, rel);
+        const text = (0, fs_1.readFileSync)(full, 'utf8');
+        const findings = ui_building_blocks_util_1.UiBuildingBlocks_Util.scrollFindings(text, rel, scrollerTags).length;
+        if (findings) {
+            scrollContainers[ui_building_blocks_util_1.UiBuildingBlocks_Util.normalize(rel)] = findings;
+        }
+        // BFR-QA-003: unguarded empty-state messages (own ancestor block OR the rendering parent's guard clears them)
+        const unguarded = empty_state_guard_util_1.EmptyStateGuard_Util.findings(text, rel)
+            .filter((f) => !f.ownGuard).length;
+        if (unguarded && !empty_state_guard_util_1.EmptyStateGuard_Util.guardedByParent(full, root)) {
+            emptyStatesWithoutGuard[ui_building_blocks_util_1.UiBuildingBlocks_Util.normalize(rel)] = unguarded;
+        }
+        const moduleDir = ui_building_blocks_util_1.UiBuildingBlocks_Util.moduleDir(full);
+        if (moduleDir) {
+            const key = ui_building_blocks_util_1.UiBuildingBlocks_Util.relativeKey(moduleDir, root);
+            if (ui_building_blocks_util_1.UiBuildingBlocks_Util.loadingOffsets(text, rel).length) {
+                loadingModules.add(key);
+            }
+            if (ui_building_blocks_util_1.UiBuildingBlocks_Util.hasFailedBranch(text, rel)) {
+                failedModules.add(key);
+            }
+        }
+    });
+    return {
+        scrollerTags: scrollerTags,
+        scrollContainers: scrollContainers,
+        modulesWithoutLoadFailedBranch: [...loadingModules].filter((m) => !failedModules.has(m)).sort(),
+        emptyStatesWithoutGuard: emptyStatesWithoutGuard,
+    };
+}
+/** The CLI. */
+function main(args) {
+    const outIndex = args.indexOf('--out');
+    const root = process.cwd();
+    const out = path.resolve(root, outIndex >= 0 ? args[outIndex + 1] : ui_building_blocks_util_1.UiBuildingBlocks_Util.defaultBaselineFile);
+    const committed = ui_building_blocks_util_1.UiBuildingBlocks_Util.readBaseline(out);
+    const extraTags = args
+        .map((arg, index) => (arg === '--scroller-tag' ? args[index + 1] : undefined))
+        .filter((tag) => !!tag);
+    const scrollerTags = [...new Set([...committed.scrollerTags, ...extraTags])].sort();
+    const current = scanProject(root, scrollerTags);
+    const scrollTotal = Object.values(current.scrollContainers).reduce((a, b) => a + b, 0);
+    if (args.includes('--check')) {
+        const grownFiles = Object.entries(current.scrollContainers)
+            .filter(([key, count]) => count > (committed.scrollContainers[key] ?? 0))
+            .map(([key]) => key);
+        const newModules = current.modulesWithoutLoadFailedBranch
+            .filter((m) => !committed.modulesWithoutLoadFailedBranch.includes(m));
+        const grownEmpty = Object.entries(current.emptyStatesWithoutGuard ?? {})
+            .filter(([key, count]) => count > (committed.emptyStatesWithoutGuard?.[key] ?? 0))
+            .map(([key]) => key);
+        grownFiles.forEach((key) => console.log(`NEW scroll container without min-h-0 chain: ${key}`));
+        newModules.forEach((m) => console.log(`NEW module with a loading state but no failed state: ${m}`));
+        grownEmpty.forEach((key) => console.log(`NEW empty-state message without a loading / failed guard: ${key}`));
+        if (!grownFiles.length && !newModules.length && !grownEmpty.length) {
+            console.log('UI building blocks within the baseline.');
+        }
+        process.exitCode = grownFiles.length || newModules.length || grownEmpty.length ? 1 : 0;
+        return;
+    }
+    (0, fs_1.mkdirSync)(path.dirname(out), { recursive: true });
+    (0, fs_1.writeFileSync)(out, JSON.stringify({
+        rules: ui_building_blocks_util_1.UiBuildingBlocks_Util.ruleIds,
+        note: 'Accepted cases that existed when the guard was adopted. New ones fail the rules. Regenerate ONLY after a '
+            + 'reviewed change; lower it when you fix one (BFR-QA-004).',
+        generatedAt: new Date().toISOString(),
+        settings: { scrollerTags: scrollerTags },
+        totals: {
+            scrollContainers: scrollTotal,
+            modulesWithoutLoadFailedBranch: current.modulesWithoutLoadFailedBranch.length,
+            emptyStatesWithoutGuard: Object.values(current.emptyStatesWithoutGuard ?? {}).reduce((a, b) => a + b, 0),
+        },
+        scrollContainers: current.scrollContainers,
+        modulesWithoutLoadFailedBranch: current.modulesWithoutLoadFailedBranch,
+        emptyStatesWithoutGuard: current.emptyStatesWithoutGuard ?? {},
+    }, null, 2) + '\n');
+    console.log(`UI-building-blocks baseline written: ${path.relative(root, out)} — ${scrollTotal} scroll container(s) `
+        + `without a min-h-0 chain, ${current.modulesWithoutLoadFailedBranch.length} module(s) without a load-failed state.`);
+}
+main(process.argv.slice(2));
+//# sourceMappingURL=ui-building-blocks-baseline.js.map

package/build/scripts/ui-building-blocks-baseline.js.map

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

package/build/scripts/unused-components-baseline.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview Unused-components baseline generator (BFR-QA-006)
+ *
+ * Writes the committed per-project baseline of the `@futdevpro/dynamo/no-unused-component` rule: the components that
+ * are built but used nowhere TODAY (`<file>#<Class>`). The rule then accepts those and fails only on new ones. The
+ * scan is the rule's own (`UnusedComponent_Util`). Meant for apps: a library's public components are "unused" inside
+ * the package, so the generator warns when it finds an `ng-package.json`.
+ *
+ * @usage
+ * ```bash
+ * npx dynamo-unused-components-baseline            # run in the folder ESLint runs in (e.g. client/)
+ * npx dynamo-unused-components-baseline --check    # exit 1 if a NEW unused component appeared
+ * ```
+ */
+export {};
+//# sourceMappingURL=unused-components-baseline.d.ts.map

package/build/scripts/unused-components-baseline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-components-baseline.d.ts","sourceRoot":"","sources":["../../src/scripts/unused-components-baseline.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}

package/build/scripts/unused-components-baseline.js

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * @fileoverview Unused-components baseline generator (BFR-QA-006)
+ *
+ * Writes the committed per-project baseline of the `@futdevpro/dynamo/no-unused-component` rule: the components that
+ * are built but used nowhere TODAY (`<file>#<Class>`). The rule then accepts those and fails only on new ones. The
+ * scan is the rule's own (`UnusedComponent_Util`). Meant for apps: a library's public components are "unused" inside
+ * the package, so the generator warns when it finds an `ng-package.json`.
+ *
+ * @usage
+ * ```bash
+ * npx dynamo-unused-components-baseline            # run in the folder ESLint runs in (e.g. client/)
+ * npx dynamo-unused-components-baseline --check    # exit 1 if a NEW unused component appeared
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const fast_glob_1 = tslib_1.__importDefault(require("fast-glob"));
+const fs_1 = require("fs");
+const path = tslib_1.__importStar(require("path"));
+const unused_component_util_1 = require("../plugin/rules/angular/unused-component.util");
+/** The CLI. */
+function main(args) {
+    const outIndex = args.indexOf('--out');
+    const root = process.cwd();
+    const out = path.resolve(root, outIndex >= 0 ? args[outIndex + 1] : unused_component_util_1.UnusedComponent_Util.defaultBaselineFile);
+    const project = unused_component_util_1.UnusedComponent_Util.projectIndex(root);
+    const findings = unused_component_util_1.UnusedComponent_Util.findUnused(project.sources, project.index);
+    const keys = findings.map((f) => unused_component_util_1.UnusedComponent_Util.key(f)).sort();
+    if (fast_glob_1.default.sync(['**/ng-package.json'], { cwd: root, ignore: ['**/node_modules/**'] }).length) {
+        console.warn('⚠️ ng-package.json found: this looks like a LIBRARY — its public components are used by consumers, '
+            + 'not inside the package. The rule is meant for apps.');
+    }
+    if (args.includes('--check')) {
+        const committed = unused_component_util_1.UnusedComponent_Util.readBaseline(out);
+        const fresh = keys.filter((k) => !committed.includes(k));
+        fresh.forEach((k) => console.log(`NEW unused component: ${k}`));
+        if (!fresh.length) {
+            console.log('Unused components within the baseline.');
+        }
+        process.exitCode = fresh.length ? 1 : 0;
+        return;
+    }
+    (0, fs_1.mkdirSync)(path.dirname(out), { recursive: true });
+    (0, fs_1.writeFileSync)(out, JSON.stringify({
+        rule: unused_component_util_1.UnusedComponent_Util.ruleId,
+        note: 'Components that were built but used nowhere when the guard was adopted. New ones fail the rule. Remove an '
+            + 'entry when you wire the component in or delete it (BFR-QA-006).',
+        generatedAt: new Date().toISOString(),
+        totals: {
+            unused: keys.length,
+            commentedOut: findings.filter((f) => f.commentedOut).length,
+        },
+        components: keys,
+        commentedOut: findings.filter((f) => f.commentedOut)
+            .map((f) => unused_component_util_1.UnusedComponent_Util.key(f)).sort(),
+    }, null, 2) + '\n');
+    console.log(`Unused-components baseline written: ${path.relative(root, out)} — ${keys.length} unused component(s).`);
+}
+main(process.argv.slice(2));
+//# sourceMappingURL=unused-components-baseline.js.map

package/build/scripts/unused-components-baseline.js.map

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

package/build/scripts/xss-surface-baseline.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview XSS-surface baseline generator (BFR-QA-005)
+ *
+ * Writes the committed per-project baseline of the `@futdevpro/dynamo/no-unlisted-inner-html` rule: for every
+ * `.html` / `.ts` file (tests excluded) the number of `[innerHTML]` bindings and `bypassSecurityTrust…(…)` calls it has
+ * TODAY. The rule then accepts those and fails only on new ones. The counting is the rule's own scanner.
+ *
+ * @usage
+ * ```bash
+ * npx dynamo-xss-surface-baseline            # run in the folder ESLint runs in (e.g. client/)
+ * npx dynamo-xss-surface-baseline --check    # exit 1 if the surface grew beyond the committed baseline
+ * npx dynamo-xss-surface-baseline --out .dynamo/xss-surface-baseline.json
+ * ```
+ */
+export {};
+//# sourceMappingURL=xss-surface-baseline.d.ts.map

package/build/scripts/xss-surface-baseline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xss-surface-baseline.d.ts","sourceRoot":"","sources":["../../src/scripts/xss-surface-baseline.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}

package/build/scripts/xss-surface-baseline.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * @fileoverview XSS-surface baseline generator (BFR-QA-005)
+ *
+ * Writes the committed per-project baseline of the `@futdevpro/dynamo/no-unlisted-inner-html` rule: for every
+ * `.html` / `.ts` file (tests excluded) the number of `[innerHTML]` bindings and `bypassSecurityTrust…(…)` calls it has
+ * TODAY. The rule then accepts those and fails only on new ones. The counting is the rule's own scanner.
+ *
+ * @usage
+ * ```bash
+ * npx dynamo-xss-surface-baseline            # run in the folder ESLint runs in (e.g. client/)
+ * npx dynamo-xss-surface-baseline --check    # exit 1 if the surface grew beyond the committed baseline
+ * npx dynamo-xss-surface-baseline --out .dynamo/xss-surface-baseline.json
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const fast_glob_1 = tslib_1.__importDefault(require("fast-glob"));
+const fs_1 = require("fs");
+const path = tslib_1.__importStar(require("path"));
+const xss_surface_util_1 = require("../plugin/rules/angular/xss-surface.util");
+/** Scans a project folder into baseline form (only files that HAVE a surface are listed). */
+function scanProject(root) {
+    const files = fast_glob_1.default.sync(['**/*.html', '**/*.ts'], {
+        cwd: root,
+        ignore: ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.angular/**', '**/coverage/**'],
+        dot: false,
+    });
+    const result = {};
+    files.sort().forEach((rel) => {
+        if (!xss_surface_util_1.XssSurface_Util.isInScope(rel)) {
+            return;
+        }
+        const found = xss_surface_util_1.XssSurface_Util.scan((0, fs_1.readFileSync)(path.join(root, rel), 'utf8'), rel);
+        if (found.innerHtml.length || found.bypass.length) {
+            result[xss_surface_util_1.XssSurface_Util.normalize(rel)] = { innerHtml: found.innerHtml.length, bypass: found.bypass.length };
+        }
+    });
+    return result;
+}
+/** The CLI. */
+function main(args) {
+    const outIndex = args.indexOf('--out');
+    const root = process.cwd();
+    const out = path.resolve(root, outIndex >= 0 ? args[outIndex + 1] : xss_surface_util_1.XssSurface_Util.defaultBaselineFile);
+    const current = scanProject(root);
+    const totals = Object.values(current).reduce((sum, entry) => ({
+        files: sum.files + 1, innerHtml: sum.innerHtml + entry.innerHtml, bypass: sum.bypass + entry.bypass,
+    }), { files: 0, innerHtml: 0, bypass: 0 });
+    if (args.includes('--check')) {
+        const committed = xss_surface_util_1.XssSurface_Util.readBaseline(out);
+        const grown = Object.entries(current)
+            .filter(([key, entry]) => entry.innerHtml > (committed[key]?.innerHtml ?? 0) || entry.bypass > (committed[key]?.bypass ?? 0))
+            .map(([key]) => key);
+        console.log(grown.length ? `XSS surface GREW in: ${grown.join(', ')}` : 'XSS surface within the baseline.');
+        process.exitCode = grown.length ? 1 : 0;
+        return;
+    }
+    (0, fs_1.mkdirSync)(path.dirname(out), { recursive: true });
+    (0, fs_1.writeFileSync)(out, JSON.stringify({
+        rule: xss_surface_util_1.XssSurface_Util.ruleId,
+        note: 'Accepted XSS surfaces that existed when the guard was adopted. New ones fail the rule. Regenerate ONLY '
+            + 'after a reviewed change (BFR-QA-005).',
+        generatedAt: new Date().toISOString(),
+        totals: totals,
+        files: current,
+    }, null, 2) + '\n');
+    console.log(`XSS-surface baseline written: ${path.relative(root, out)} — ${totals.files} file(s), `
+        + `${totals.innerHtml} [innerHTML], ${totals.bypass} bypassSecurityTrust.`);
+}
+main(process.argv.slice(2));
+//# sourceMappingURL=xss-surface-baseline.js.map

package/build/scripts/xss-surface-baseline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xss-surface-baseline.js","sourceRoot":"","sources":["../../src/scripts/xss-surface-baseline.ts"],"names":[],"mappings":";;AACA;;;;;;;;;;;;;GAaG;;;AAEH,kEAA2B;AAC3B,2BAA4D;AAC5D,mDAA6B;AAI7B,+EAA2E;AAS3E,6FAA6F;AAC7F,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,KAAK,GAAa,mBAAE,CAAC,IAAI,CAAC,CAAE,WAAW,EAAE,SAAS,CAAE,EAAE;QAC1D,GAAG,EAAE,IAAI;QACT,MAAM,EAAE,CAAE,oBAAoB,EAAE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,CAAE;QACjG,GAAG,EAAE,KAAK;KACX,CAAC,CAAC;IACH,MAAM,MAAM,GAAuC,EAAE,CAAC;IAEtD,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,GAAW,EAAQ,EAAE;QACzC,IAAI,CAAC,kCAAe,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GACT,kCAAe,CAAC,IAAI,CAAC,IAAA,iBAAY,EAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QAExE,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAClD,MAAM,CAAC,kCAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC9G,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,eAAe;AACf,SAAS,IAAI,CAAC,IAAc;IAC1B,MAAM,QAAQ,GAAW,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAW,OAAO,CAAC,GAAG,EAAE,CAAC;IACnC,MAAM,GAAG,GAAW,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,kCAAe,CAAC,mBAAmB,CAAC,CAAC;IACjH,MAAM,OAAO,GAAuC,WAAW,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,MAAM,GAAgC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CACvE,CAAC,GAAgC,EAAE,KAA4C,EAA+B,EAAE,CAAC,CAAC;QAChH,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;KACpG,CAAC,EACF,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CACtC,CAAC;IAEF,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAuC,kCAAe,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACxF,MAAM,KAAK,GAAa,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;aAC5C,MAAM,CAAC,CAAC,CAAE,GAAG,EAAE,KAAK,CAAqD,EAAW,EAAE,CACrF,KAAK,CAAC,SAAS,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;aACpG,GAAG,CAAC,CAAC,CAAE,GAAG,CAAuB,EAAU,EAAE,CAAC,GAAG,CAAC,CAAC;QAEtD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,wBAAwB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC;QAC5G,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAExC,OAAO;IACT,CAAC;IACD,IAAA,cAAS,EAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,IAAA,kBAAa,EAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,EAAE,kCAAe,CAAC,MAAM;QAC5B,IAAI,EAAE,yGAAyG;cAC3G,uCAAuC;QAC3C,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,MAAM,EAAE,MAAM;QACd,KAAK,EAAE,OAAO;KACf,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACpB,OAAO,CAAC,GAAG,CAAC,iCAAiC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,KAAK,YAAY;UAC/F,GAAG,MAAM,CAAC,SAAS,iBAAiB,MAAM,CAAC,MAAM,uBAAuB,CAAC,CAAC;AAChF,CAAC;AAED,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/dynamo-eslint",
-  "version": "1.20.29",
+  "version": "1.20.55",
   "description": "Shared ESLint configs, Dynamo-powered plugin and validators for FutDevPro stacks",
   "author": "Future Development Program Ltd.",
   "license": "MIT",
@@ -68,7 +68,11 @@
     "dynamo-validate-naming": "./build/scripts/validate-naming.js",
     "dynamo-eslintrc-audit": "./build/scripts/eslintrc-audit.js",
     "dynamo-fix": "./build/scripts/dynamo-fix.js",
-    "dynamo-fix-return-types": "./build/scripts/fix-return-types.js"
+    "dynamo-fix-return-types": "./build/scripts/fix-return-types.js",
+    "dynamo-xss-surface-baseline": "./build/scripts/xss-surface-baseline.js",
+    "dynamo-ui-building-blocks-baseline": "./build/scripts/ui-building-blocks-baseline.js",
+    "dynamo-unused-components-baseline": "./build/scripts/unused-components-baseline.js",
+    "dynamo-lint-strict": "./build/scripts/lint-strict.js"
   },
   "keywords": [
     "eslint",
@@ -89,7 +93,7 @@
     }
   },
   "dependencies": {
-    "@futdevpro/fsm-dynamo": "1.20.50",
+    "@futdevpro/fsm-dynamo": "1.20.93",
     "eslint-plugin-max-params-no-constructor": "0.0.4",
     "eslint-plugin-unused-imports": "4.4.1",
     "fast-glob": "3.3.3",