@futdevpro/dynamo-eslint 1.20.29 → 1.20.55

package/build/plugin/rules/angular/ui-building-blocks.util.d.ts

@@ -0,0 +1,111 @@
+import { UiBuildingBlocks_Baseline_Interface } from './ui-building-blocks-baseline.interface';
+import { UiBuildingBlocks_Element_Interface } from './ui-building-blocks-element.interface';
+import { UiBuildingBlocks_ScrollFinding_Interface } from './ui-building-blocks-scroll-finding.interface';
+/** A template inside a source file: its text and where it starts in the file. */
+interface UiBuildingBlocks_Template_Interface {
+    text: string;
+    offset: number;
+}
+/**
+ * BFR-QA-004 — the ONE scanner behind the `scroll-container-min-h-0` and `module-load-failed-branch` rules AND the
+ * `dynamo-ui-building-blocks-baseline` generator, so the baseline counts exactly what the rules count.
+ *
+ * ① Scroll container that will not scroll: a flex item's default `min-height: auto` keeps it at least as tall as its
+ *   content. A scroll container (`overflow-(y-)auto|scroll`) under a COLUMN-flex item without `min-h-0` therefore sits
+ *   in a chain that grows to the content height — `scrollHeight ≈ clientHeight`, it never scrolls (organizer
+ *   BUG-QA-ORG-029). The check walks the scroll container's ancestors inside the template up to the element that
+ *   gives the chain its height (`h-full`, a fixed height); a column-flex item on the way without `min-h-0` /
+ *   `overflow-*` is the culprit. NOT a finding: a scroll container with its own fixed height (`h-64`, `max-h-96`,
+ *   `h-screen`, inline height); an outer scroll container on the way (that one scrolls); an `absolute` / `fixed`
+ *   ancestor (out of the flex flow); a component host without classes in the template (its `host` / `:host` styles
+ *   are not visible here — mirrored: `<app-list class="flex-1">` IS checked, its flex role is written here); no
+ *   height source in the template at all (then the host's parents decide).
+ *   Static limit: the chain is followed inside ONE template (a component host's parents live in another one).
+ * ② Module without a load-failed branch: a module (`…/_modules/<name>/`) whose templates show a LOADING state but none
+ *   of which shows a FAILED / error state — "empty", "loading" and "failed" are three different states
+ *   (BUG-QA-ORG-032/-034); without the third the screen looks empty when loading failed.
+ *
+ * Templates = `.html` files and inline `template:` literals of `.ts` files; comments and interpolations are ignored.
+ */
+export declare class UiBuildingBlocks_Util {
+    /** The default location of the committed per-project baseline (relative to the ESLint working directory). */
+    static readonly defaultBaselineFile: string;
+    /** The rule ids the baseline belongs to. */
+    static readonly ruleIds: string[];
+    /**
+     * A loading state in a template. Deliberately NOT a bare spinner / progress bar (status indicators, determinate
+     * progress) nor `pending` (counters) — both measured as false positives on the fleet.
+     */
+    static readonly loadingPattern: RegExp;
+    /** A failed / error state in a template (`errors` — a list OF errors — is not one). */
+    static readonly failedPattern: RegExp;
+    /** BFR-MASTERPROMPTER-075 ⓐ: the `[dynamo-overlay]` directive attribute (runtime `position: absolute`). */
+    private static readonly outOfFlowAttribute;
+    /** BFR-MASTERPROMPTER-075 ⓒ: a loading match whose condition is the bare `loading` flag (`@if (loading)`). */
+    private static readonly subFrameLoadingCondition;
+    private static readonly voidTags;
+    private static readonly scrollClasses;
+    /** Classes that stop a flex item from growing with its content (min-height 0 or a non-visible overflow). */
+    private static readonly shrinkClasses;
+    /** Classes that give an element its own height (not relative to a growing parent). */
+    private static readonly fixedHeightClasses;
+    /** Baseline cache: path → { stamp (mtime + size: two writes in one mtime tick still differ), baseline }. */
+    private static readonly baselineCache;
+    /** Module cache: folder → { fingerprint, has a failed branch }. */
+    private static readonly moduleCache;
+    /** Whether a file is in scope (templates and component sources; tests and declarations excluded). */
+    static isInScope(filename: string): boolean;
+    /**
+     * The templates of a source file (`.html` = the whole file; `.ts` = its inline `template:` literals — backtick AND
+     * single / double quoted: a one-line `template: '<app-x />'` is a real template, measured on the fleet).
+     */
+    static templates(text: string, filename: string): UiBuildingBlocks_Template_Interface[];
+    /** The elements of every template of a file, each with its in-template parent. */
+    static elements(text: string, filename: string): UiBuildingBlocks_Element_Interface[];
+    /** ① The scroll containers of a file that sit in a chain growing to the content height. */
+    static scrollFindings(text: string, filename: string, scrollerTags: string[]): UiBuildingBlocks_ScrollFinding_Interface[];
+    /** ② Offsets of the loading states in a file's templates (comments / interpolations ignored). */
+    static loadingOffsets(text: string, filename: string): number[];
+    /**
+     * BFR-MASTERPROMPTER-075 ⓒ: the component (inline template: this file; external template: its sibling `.ts`)
+     * extends `DyNX_SubFrame_Component`. An unreadable sibling ⇒ `false` (measure, never silence).
+     */
+    static isSubFrameComponent(text: string, filename: string): boolean;
+    /** ② Whether a file's templates show a failed / error state. */
+    static hasFailedBranch(text: string, filename: string): boolean;
+    /** ② The module folder of a file: the path up to the FIRST `_modules/<name>` segment (`undefined` = not in one). */
+    static moduleDir(filename: string): string | undefined;
+    /**
+     * ② Whether any template of a module shows a failed state. `current` = the file being linted with its IN-EDITOR
+     * text (it may differ from the disk). Cached per module until a file of it changes.
+     */
+    static moduleHasFailedBranch(moduleDir: string, current: {
+        filename: string;
+        text: string;
+    }): boolean;
+    /** ② The template-bearing files of a module folder (recursive, tests excluded). */
+    static moduleFiles(moduleDir: string): string[];
+    /** A path in baseline form: forward slashes, relative to `cwd` when inside it. */
+    static relativeKey(filename: string, cwd: string): string;
+    /** Reads the committed baseline (missing file = empty baseline; a broken file THROWS — never a silent pass). */
+    static readBaseline(baselinePath: string): UiBuildingBlocks_Baseline_Interface;
+    /** Forward slashes. */
+    static normalize(value: string): string;
+    /** A change stamp of a file: mtime AND size (a rewrite inside one mtime tick still changes the size). */
+    private static stamp;
+    /** Class names without variant prefixes (`md:overflow-auto` → `overflow-auto`). */
+    private static bases;
+    private static isScroller;
+    /** The element that bounds the chain: its own height, or `h-full` / `max-h-full` (the height of its parent). */
+    private static givesHeight;
+    private static hasFixedHeight;
+    private static isColumnFlex;
+    /** Static `class`, `[class.x]` bindings and the quoted keys of `[ngClass]`. */
+    private static classesOf;
+    /** Comments → spaces (offsets and line breaks preserved). */
+    static blankComments(text: string): string;
+    /** Comments AND `{{ … }}` interpolations → spaces, so a `<` in an expression is never read as a tag. */
+    private static blankNonMarkup;
+}
+export {};
+//# sourceMappingURL=ui-building-blocks.util.d.ts.map

package/build/plugin/rules/angular/ui-building-blocks.util.d.ts.map

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

package/build/plugin/rules/angular/ui-building-blocks.util.js

@@ -0,0 +1,377 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UiBuildingBlocks_Util = void 0;
+const tslib_1 = require("tslib");
+const fs_1 = require("fs");
+const path = tslib_1.__importStar(require("path"));
+/**
+ * BFR-QA-004 — the ONE scanner behind the `scroll-container-min-h-0` and `module-load-failed-branch` rules AND the
+ * `dynamo-ui-building-blocks-baseline` generator, so the baseline counts exactly what the rules count.
+ *
+ * ① Scroll container that will not scroll: a flex item's default `min-height: auto` keeps it at least as tall as its
+ *   content. A scroll container (`overflow-(y-)auto|scroll`) under a COLUMN-flex item without `min-h-0` therefore sits
+ *   in a chain that grows to the content height — `scrollHeight ≈ clientHeight`, it never scrolls (organizer
+ *   BUG-QA-ORG-029). The check walks the scroll container's ancestors inside the template up to the element that
+ *   gives the chain its height (`h-full`, a fixed height); a column-flex item on the way without `min-h-0` /
+ *   `overflow-*` is the culprit. NOT a finding: a scroll container with its own fixed height (`h-64`, `max-h-96`,
+ *   `h-screen`, inline height); an outer scroll container on the way (that one scrolls); an `absolute` / `fixed`
+ *   ancestor (out of the flex flow); a component host without classes in the template (its `host` / `:host` styles
+ *   are not visible here — mirrored: `<app-list class="flex-1">` IS checked, its flex role is written here); no
+ *   height source in the template at all (then the host's parents decide).
+ *   Static limit: the chain is followed inside ONE template (a component host's parents live in another one).
+ * ② Module without a load-failed branch: a module (`…/_modules/<name>/`) whose templates show a LOADING state but none
+ *   of which shows a FAILED / error state — "empty", "loading" and "failed" are three different states
+ *   (BUG-QA-ORG-032/-034); without the third the screen looks empty when loading failed.
+ *
+ * Templates = `.html` files and inline `template:` literals of `.ts` files; comments and interpolations are ignored.
+ */
+class UiBuildingBlocks_Util {
+    /** The default location of the committed per-project baseline (relative to the ESLint working directory). */
+    static defaultBaselineFile = '.dynamo/ui-building-blocks-baseline.json';
+    /** The rule ids the baseline belongs to. */
+    static ruleIds = [
+        '@futdevpro/dynamo/scroll-container-min-h-0',
+        '@futdevpro/dynamo/module-load-failed-branch',
+        '@futdevpro/dynamo/empty-state-requires-guard',
+    ];
+    /**
+     * A loading state in a template. Deliberately NOT a bare spinner / progress bar (status indicators, determinate
+     * progress) nor `pending` (counters) — both measured as false positives on the fleet.
+     */
+    static loadingPattern = new RegExp('inProgress_\\$|loading-skeleton|'
+        + '@(?:if|else if)\\s*\\([^)]*(?:[lL]oading|inProgress)|'
+        + '\\*ngIf\\s*=\\s*"[^"]*(?:[lL]oading|inProgress)');
+    /** A failed / error state in a template (`errors` — a list OF errors — is not one). */
+    static failedPattern = new RegExp('@(?:if|else if)\\s*\\([^)]*(?:[eE]rror|[fF]ail)(?!s\\b)|'
+        + '\\*ngIf\\s*=\\s*"[^"]*(?:[eE]rror|[fF]ail)(?!s\\b)|'
+        + '<[a-z][\\w-]*(?:load-?failed|load-error|error-state)\\b|'
+        + 'data-testid="[^"]*load[a-z-]*(?:error|failed)|'
+        // BFR-MASTERPROMPTER-075 ⓑ: the three-state idiom `@if (loading) {…} @else if (data) {…} @else { …-error }` —
+        // the closing `@else` branch (⛔ `@else if`) carrying an error / failed test-id, before the next control-flow block
+        + '@else\\s*\\{[^@]*?data-testid="[^"]*-(?:error|failed)"');
+    /** BFR-MASTERPROMPTER-075 ⓐ: the `[dynamo-overlay]` directive attribute (runtime `position: absolute`). */
+    static outOfFlowAttribute = /(?:^|\s)dynamo-overlay(?=[\s=/]|$)/;
+    /** BFR-MASTERPROMPTER-075 ⓒ: a loading match whose condition is the bare `loading` flag (`@if (loading)`). */
+    static subFrameLoadingCondition = /\(\s*!?\s*loading\s*$/;
+    static voidTags = new Set([
+        'area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'source', 'track', 'wbr',
+    ]);
+    static scrollClasses = new Set([
+        'overflow-auto', 'overflow-y-auto', 'overflow-scroll', 'overflow-y-scroll',
+    ]);
+    /** Classes that stop a flex item from growing with its content (min-height 0 or a non-visible overflow). */
+    static shrinkClasses = /^(?:min-h-0|min-h-\[0(?:px)?\]|overflow-(?:y-)?(?:auto|scroll|hidden|clip))$/;
+    /** Classes that give an element its own height (not relative to a growing parent). */
+    static fixedHeightClasses = /^(?:h|max-h)-(?!full$|auto$|fit$|min$|max$|0$)[\w.[\]()%/-]+$/;
+    /** Baseline cache: path → { stamp (mtime + size: two writes in one mtime tick still differ), baseline }. */
+    static baselineCache = new Map();
+    /** Module cache: folder → { fingerprint, has a failed branch }. */
+    static moduleCache = new Map();
+    /** Whether a file is in scope (templates and component sources; tests and declarations excluded). */
+    static isInScope(filename) {
+        const normalized = UiBuildingBlocks_Util.normalize(filename);
+        return (normalized.endsWith('.html') || normalized.endsWith('.ts'))
+            && !normalized.endsWith('.spec.ts')
+            && !normalized.endsWith('.d.ts');
+    }
+    /**
+     * The templates of a source file (`.html` = the whole file; `.ts` = its inline `template:` literals — backtick AND
+     * single / double quoted: a one-line `template: '<app-x />'` is a real template, measured on the fleet).
+     */
+    static templates(text, filename) {
+        if (filename.endsWith('.html')) {
+            return [{ text: text, offset: 0 }];
+        }
+        const result = [];
+        const regex = /\btemplate\s*:\s*(?:`((?:\\[\s\S]|[^`\\])*)`|'((?:\\.|[^'\\\n])*)'|"((?:\\.|[^"\\\n])*)")/g;
+        let match = regex.exec(text);
+        while (match !== null) {
+            const body = match[1] ?? match[2] ?? match[3] ?? '';
+            result.push({ text: body, offset: match.index + match[0].length - body.length - 1 });
+            match = regex.exec(text);
+        }
+        return result;
+    }
+    /** The elements of every template of a file, each with its in-template parent. */
+    static elements(text, filename) {
+        const result = [];
+        UiBuildingBlocks_Util.templates(text, filename).forEach((template) => {
+            const code = UiBuildingBlocks_Util.blankNonMarkup(template.text);
+            const stack = [];
+            const tagRegex = /<(\/?)([a-zA-Z][\w.:-]*)((?:[^>"']|"[^"]*"|'[^']*')*)>/g;
+            let match = tagRegex.exec(code);
+            while (match !== null) {
+                const tag = match[2].toLowerCase();
+                if (match[1]) {
+                    // closing tag: pop to the matching open element (tolerant of unclosed children)
+                    const index = stack.map((e) => e.tag).lastIndexOf(tag);
+                    if (index >= 0) {
+                        stack.length = index;
+                    }
+                }
+                else {
+                    const attributes = match[3];
+                    const element = {
+                        tag: tag,
+                        classes: UiBuildingBlocks_Util.classesOf(attributes),
+                        heightStyle: /(?:^|\s)style\s*=\s*["'][^"']*\bheight\s*:|\[style\.(?:max-)?height|\[ngStyle\][^>]*height/i
+                            .test(attributes),
+                        offset: template.offset + match.index,
+                        parent: stack[stack.length - 1],
+                        outOfFlow: UiBuildingBlocks_Util.outOfFlowAttribute.test(attributes),
+                    };
+                    result.push(element);
+                    if (!attributes.trim().endsWith('/') && !UiBuildingBlocks_Util.voidTags.has(tag)) {
+                        stack.push(element);
+                    }
+                }
+                match = tagRegex.exec(code);
+            }
+        });
+        return result;
+    }
+    /** ① The scroll containers of a file that sit in a chain growing to the content height. */
+    static scrollFindings(text, filename, scrollerTags) {
+        const tags = new Set(scrollerTags.map((t) => t.toLowerCase()));
+        const findings = [];
+        UiBuildingBlocks_Util.elements(text, filename).forEach((element) => {
+            if (!UiBuildingBlocks_Util.isScroller(element, tags) || UiBuildingBlocks_Util.hasFixedHeight(element)) {
+                return;
+            }
+            // walk up to the element that gives the chain its height; a column-flex item on the way must be able to shrink
+            let culprit;
+            let ancestor = element.parent;
+            while (ancestor) {
+                if (UiBuildingBlocks_Util.isScroller(ancestor, tags)) {
+                    // an outer scroll container takes over: the page still scrolls, just not in the inner one
+                    return;
+                }
+                if (UiBuildingBlocks_Util.givesHeight(ancestor)) {
+                    if (culprit) {
+                        findings.push({
+                            offset: element.offset, tag: element.tag, culpritOffset: culprit.offset, culpritTag: culprit.tag,
+                        });
+                    }
+                    return;
+                }
+                const bases = UiBuildingBlocks_Util.bases(ancestor);
+                if (bases.includes('absolute') || bases.includes('fixed') || ancestor.outOfFlow) {
+                    // out of the flex flow: its height comes from the containing block, not from this chain
+                    return;
+                }
+                const isColumnFlexItem = !!ancestor.parent && UiBuildingBlocks_Util.isColumnFlex(ancestor.parent);
+                const canShrink = bases.some((c) => UiBuildingBlocks_Util.shrinkClasses.test(c));
+                // a component host without classes in this template is sized by its own `host` / `:host` — not visible here
+                const sizedHere = !ancestor.tag.includes('-') || ancestor.classes.length > 0;
+                if (isColumnFlexItem && !canShrink && sizedHere && !culprit) {
+                    culprit = ancestor;
+                }
+                ancestor = ancestor.parent;
+            }
+            // no height source inside the template: the chain is decided by the host's parents — not decidable here
+        });
+        return findings;
+    }
+    /** ② Offsets of the loading states in a file's templates (comments / interpolations ignored). */
+    static loadingOffsets(text, filename) {
+        const result = [];
+        UiBuildingBlocks_Util.templates(text, filename).forEach((template) => {
+            const code = UiBuildingBlocks_Util.blankComments(template.text);
+            const regex = new RegExp(UiBuildingBlocks_Util.loadingPattern.source, 'g');
+            const subFrame = UiBuildingBlocks_Util.isSubFrameComponent(text, filename);
+            let match = regex.exec(code);
+            while (match !== null) {
+                // BFR-MASTERPROMPTER-075 ⓒ: a `DyNX_SubFrame` component's bare `loading` is its ROUTE-CHANGE flag
+                // (`updateState(url, loading)`), ⛔ a data load — a failed branch cannot belong to it
+                if (!(subFrame && UiBuildingBlocks_Util.subFrameLoadingCondition.test(match[0]))) {
+                    result.push(template.offset + match.index);
+                }
+                match = regex.exec(code);
+            }
+        });
+        return result;
+    }
+    /**
+     * BFR-MASTERPROMPTER-075 ⓒ: the component (inline template: this file; external template: its sibling `.ts`)
+     * extends `DyNX_SubFrame_Component`. An unreadable sibling ⇒ `false` (measure, never silence).
+     */
+    static isSubFrameComponent(text, filename) {
+        const extendsSubFrame = /\bextends\s+DyNX_SubFrame_Component\b/;
+        if (filename.endsWith('.ts')) {
+            return extendsSubFrame.test(text);
+        }
+        const sibling = filename.replace(/\.html$/, '.ts');
+        try {
+            return sibling !== filename && (0, fs_1.existsSync)(sibling) && extendsSubFrame.test((0, fs_1.readFileSync)(sibling, 'utf8'));
+        }
+        catch {
+            return false;
+        }
+    }
+    /** ② Whether a file's templates show a failed / error state. */
+    static hasFailedBranch(text, filename) {
+        return UiBuildingBlocks_Util.templates(text, filename).some((template) => UiBuildingBlocks_Util.failedPattern.test(UiBuildingBlocks_Util.blankComments(template.text)));
+    }
+    /** ② The module folder of a file: the path up to the FIRST `_modules/<name>` segment (`undefined` = not in one). */
+    static moduleDir(filename) {
+        const normalized = UiBuildingBlocks_Util.normalize(filename);
+        const match = /^(.*?\/_modules\/[^/]+)\//.exec(normalized);
+        return match ? match[1] : undefined;
+    }
+    /**
+     * ② Whether any template of a module shows a failed state. `current` = the file being linted with its IN-EDITOR
+     * text (it may differ from the disk). Cached per module until a file of it changes.
+     */
+    static moduleHasFailedBranch(moduleDir, current) {
+        if (UiBuildingBlocks_Util.hasFailedBranch(current.text, current.filename)) {
+            return true;
+        }
+        const currentFile = UiBuildingBlocks_Util.normalize(current.filename).toLowerCase();
+        const files = UiBuildingBlocks_Util.moduleFiles(moduleDir)
+            .filter((f) => UiBuildingBlocks_Util.normalize(f).toLowerCase() !== currentFile);
+        const fingerprint = files.map((f) => f + ':' + UiBuildingBlocks_Util.stamp(f)).join('|');
+        const cached = UiBuildingBlocks_Util.moduleCache.get(moduleDir + '|' + currentFile);
+        if (cached?.fingerprint === fingerprint) {
+            return cached.hasFailedBranch;
+        }
+        const hasFailedBranch = files.some((f) => UiBuildingBlocks_Util.hasFailedBranch((0, fs_1.readFileSync)(f, 'utf8'), f));
+        UiBuildingBlocks_Util.moduleCache.set(moduleDir + '|' + currentFile, { fingerprint: fingerprint, hasFailedBranch: hasFailedBranch });
+        return hasFailedBranch;
+    }
+    /** ② The template-bearing files of a module folder (recursive, tests excluded). */
+    static moduleFiles(moduleDir) {
+        const result = [];
+        const walk = (dir) => {
+            (0, fs_1.readdirSync)(dir, { withFileTypes: true }).forEach((entry) => {
+                const full = path.join(dir, entry.name);
+                if (entry.isDirectory()) {
+                    if (entry.name !== 'node_modules') {
+                        walk(full);
+                    }
+                }
+                else if (UiBuildingBlocks_Util.isInScope(full)) {
+                    result.push(full);
+                }
+            });
+        };
+        if ((0, fs_1.existsSync)(moduleDir)) {
+            walk(moduleDir);
+        }
+        return result.sort();
+    }
+    /** A path in baseline form: forward slashes, relative to `cwd` when inside it. */
+    static relativeKey(filename, cwd) {
+        const file = UiBuildingBlocks_Util.normalize(filename);
+        const root = UiBuildingBlocks_Util.normalize(cwd).replace(/\/$/, '');
+        return file.toLowerCase().startsWith(root.toLowerCase() + '/') ? file.slice(root.length + 1) : file;
+    }
+    /** Reads the committed baseline (missing file = empty baseline; a broken file THROWS — never a silent pass). */
+    static readBaseline(baselinePath) {
+        if (!(0, fs_1.existsSync)(baselinePath)) {
+            return { scrollerTags: [], scrollContainers: {}, modulesWithoutLoadFailedBranch: [], emptyStatesWithoutGuard: {} };
+        }
+        const stamp = UiBuildingBlocks_Util.stamp(baselinePath);
+        const cached = UiBuildingBlocks_Util.baselineCache.get(baselinePath);
+        if (cached?.stamp === stamp) {
+            return cached.baseline;
+        }
+        const parsed = JSON.parse((0, fs_1.readFileSync)(baselinePath, 'utf8'));
+        const field = (name) => (typeof parsed === 'object' && parsed !== null ? Reflect.get(parsed, name) : undefined);
+        const settings = field('settings');
+        const scrollContainers = field('scrollContainers');
+        const modules = field('modulesWithoutLoadFailedBranch');
+        const emptyStates = field('emptyStatesWithoutGuard');
+        if (!scrollContainers || typeof scrollContainers !== 'object' || !Array.isArray(modules)) {
+            throw new Error(`UI-building-blocks baseline ${baselinePath} has no "scrollContainers" object / `
+                + '"modulesWithoutLoadFailedBranch" array — regenerate it with `npx dynamo-ui-building-blocks-baseline`.');
+        }
+        const tags = settings && typeof settings === 'object' ? Reflect.get(settings, 'scrollerTags') : undefined;
+        const baseline = {
+            scrollerTags: Array.isArray(tags) ? tags.filter((t) => typeof t === 'string') : [],
+            scrollContainers: {},
+            modulesWithoutLoadFailedBranch: modules.filter((m) => typeof m === 'string')
+                .map((m) => UiBuildingBlocks_Util.normalize(m)),
+        };
+        // BFR-QA-003: optional — a baseline generated before the rule existed simply has none (the preset keeps the rule off)
+        if (emptyStates && typeof emptyStates === 'object') {
+            baseline.emptyStatesWithoutGuard = {};
+            Object.entries(emptyStates).forEach(([key, value]) => {
+                baseline.emptyStatesWithoutGuard[UiBuildingBlocks_Util.normalize(key)] =
+                    typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : 0;
+            });
+        }
+        Object.entries(scrollContainers).forEach(([key, value]) => {
+            baseline.scrollContainers[UiBuildingBlocks_Util.normalize(key)] =
+                typeof value === 'number' && Number.isInteger(value) && value > 0 ? value : 0;
+        });
+        UiBuildingBlocks_Util.baselineCache.set(baselinePath, { stamp: stamp, baseline: baseline });
+        return baseline;
+    }
+    /** Forward slashes. */
+    static normalize(value) {
+        return value.replace(/\\/g, '/');
+    }
+    /** A change stamp of a file: mtime AND size (a rewrite inside one mtime tick still changes the size). */
+    static stamp(file) {
+        const stat = (0, fs_1.statSync)(file);
+        return stat.mtimeMs + ':' + stat.size;
+    }
+    /** Class names without variant prefixes (`md:overflow-auto` → `overflow-auto`). */
+    static bases(element) {
+        return element.classes.map((c) => c.slice(c.lastIndexOf(':') + 1));
+    }
+    static isScroller(element, tags) {
+        return tags.has(element.tag)
+            || UiBuildingBlocks_Util.bases(element).some((c) => UiBuildingBlocks_Util.scrollClasses.has(c));
+    }
+    /** The element that bounds the chain: its own height, or `h-full` / `max-h-full` (the height of its parent). */
+    static givesHeight(element) {
+        return UiBuildingBlocks_Util.hasFixedHeight(element)
+            || UiBuildingBlocks_Util.bases(element).some((c) => c === 'h-full' || c === 'max-h-full' || c === 'inset-0' || c === 'inset-y-0');
+    }
+    static hasFixedHeight(element) {
+        return element.heightStyle
+            || UiBuildingBlocks_Util.bases(element).some((c) => UiBuildingBlocks_Util.fixedHeightClasses.test(c));
+    }
+    static isColumnFlex(element) {
+        const bases = UiBuildingBlocks_Util.bases(element);
+        return (bases.includes('flex') || bases.includes('inline-flex'))
+            && (bases.includes('flex-col') || bases.includes('flex-col-reverse'));
+    }
+    /** Static `class`, `[class.x]` bindings and the quoted keys of `[ngClass]`. */
+    static classesOf(attributes) {
+        const result = [];
+        const staticClass = /(?:^|\s)class\s*=\s*(?:"([^"]*)"|'([^']*)')/.exec(attributes);
+        if (staticClass) {
+            result.push(...(staticClass[1] ?? staticClass[2]).split(/\s+/).filter(Boolean));
+        }
+        const bindingRegex = /\[class\.([^\]=\s]+)\]/g;
+        let binding = bindingRegex.exec(attributes);
+        while (binding !== null) {
+            result.push(binding[1]);
+            binding = bindingRegex.exec(attributes);
+        }
+        const ngClass = /\[ngClass\]\s*=\s*"([^"]*)"/.exec(attributes);
+        if (ngClass) {
+            (ngClass[1].match(/'[^']*'/g) ?? []).forEach((quoted) => {
+                result.push(...quoted.slice(1, -1).split(/\s+/).filter(Boolean));
+            });
+        }
+        return result;
+    }
+    /** Comments → spaces (offsets and line breaks preserved). */
+    static blankComments(text) {
+        return text.replace(/<!--[\s\S]*?-->/g, (match) => match.replace(/[^\n]/g, ' '));
+    }
+    /** Comments AND `{{ … }}` interpolations → spaces, so a `<` in an expression is never read as a tag. */
+    static blankNonMarkup(text) {
+        /** An expression becomes spaces — offsets and line breaks stay where they were. */
+        const blank = (match) => match.replace(/[^\n]/g, ' ');
+        return UiBuildingBlocks_Util.blankComments(text)
+            .replace(/\{\{[\s\S]*?\}\}/g, blank)
+            // control-flow conditions (`@if (count<limit) {`), one level of nested parentheses
+            .replace(/@\w+(?:\s+if)?\s*\((?:[^()]|\([^()]*\))*\)/g, blank);
+    }
+}
+exports.UiBuildingBlocks_Util = UiBuildingBlocks_Util;
+//# sourceMappingURL=ui-building-blocks.util.js.map

package/build/plugin/rules/angular/ui-building-blocks.util.js.map

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

package/build/plugin/rules/angular/unused-component-finding.interface.d.ts

@@ -0,0 +1,14 @@
+/** A component that is built but used nowhere (BFR-QA-006). */
+export interface UnusedComponent_Finding_Interface {
+    /** The source file (forward slashes, as it was given to the scanner). */
+    file: string;
+    /** The component class. */
+    className: string;
+    /** Its selectors (empty = selector-less; then only a class reference can use it). */
+    selectors: string[];
+    /** Offset of the class name in the file. */
+    offset: number;
+    /** A reference to it exists, but ONLY inside a comment (`// T_Search_Component,`, `<!-- <app-x> -->`). */
+    commentedOut: boolean;
+}
+//# sourceMappingURL=unused-component-finding.interface.d.ts.map

package/build/plugin/rules/angular/unused-component-finding.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-component-finding.interface.d.ts","sourceRoot":"","sources":["../../../../src/plugin/rules/angular/unused-component-finding.interface.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,WAAW,iCAAiC;IAChD,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,0GAA0G;IAC1G,YAAY,EAAE,OAAO,CAAC;CACvB"}

package/build/plugin/rules/angular/unused-component-finding.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=unused-component-finding.interface.js.map

package/build/plugin/rules/angular/unused-component-finding.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unused-component-finding.interface.js","sourceRoot":"","sources":["../../../../src/plugin/rules/angular/unused-component-finding.interface.ts"],"names":[],"mappings":""}

package/build/plugin/rules/angular/unused-component.util.d.ts

@@ -0,0 +1,86 @@
+import { UnusedComponent_Finding_Interface } from './unused-component-finding.interface';
+/** A source file of the project. */
+interface UnusedComponent_Source_Interface {
+    file: string;
+    text: string;
+}
+/** What the project uses: template tags, template text (attribute selectors), class references per identifier. */
+interface UnusedComponent_Index_Interface {
+    /** Element names used in (comment-free) templates. */
+    tags: Set<string>;
+    /** All comment-free template text (for attribute selectors). */
+    templates: string;
+    /** identifier → the files that reference it in a USAGE position. */
+    references: Map<string, Set<string>>;
+    /** identifier / tag → the files that mention it inside a COMMENT (`// X,`, `<!-- <app-x> -->`). */
+    commented: Map<string, Set<string>>;
+}
+/**
+ * BFR-QA-006 — the ONE scanner behind the `no-unused-component` rule AND the `dynamo-unused-components-baseline`
+ * generator: an Angular `@Component` that is built but used NOWHERE — its selector is in no (comment-free) template
+ * and its class is referenced in no other source in a usage position.
+ *
+ * Usage positions: routes (`component: X`, `loadComponent: … m.X`), dialogs (`dialog.open(X`), bootstrap,
+ * `createComponent(X)`, an assignment… — any reference EXCEPT:
+ *  - `import … from` / `export … from` statements (a route can disappear while its import stays — measured on the
+ *    credit client: `Ad_Page_Component` imported by a routing module and routed nowhere);
+ *  - `imports` / `declarations` / `exports` arrays (registering a component is not using it — the organizer's
+ *    `T_Search_Component` was one uncommented line away from being "registered but never rendered");
+ *  - its own file, `*.spec.ts` (a component only its own test uses is exactly the case) and `*.stories.ts`.
+ * A reference that exists only inside a comment is flagged separately (`commentedOut`).
+ */
+export declare class UnusedComponent_Util {
+    /** The default location of the committed per-project baseline (relative to the ESLint working directory). */
+    static readonly defaultBaselineFile: string;
+    /** The rule id the baseline belongs to. */
+    static readonly ruleId: string;
+    /** The project files the scan reads (relative globs, run in the ESLint working directory). */
+    static readonly globs: string[];
+    /** Never part of the scan: generated / vendored folders, tests, stories, declarations. */
+    static readonly ignore: string[];
+    /** How long a project scan is trusted before its files are re-stamped (editor lint-on-save). */
+    private static readonly recheckMs;
+    private static readonly projectCache;
+    private static readonly baselineCache;
+    /** The unused components declared in `sources`, measured against the whole project index. */
+    static findUnused(sources: UnusedComponent_Source_Interface[], index: UnusedComponent_Index_Interface): UnusedComponent_Finding_Interface[];
+    /** The `@Component`s of a TypeScript source: class name, selectors, class-name offset. */
+    static componentsOf(text: string): {
+        className: string;
+        selectors: string[];
+        offset: number;
+    }[];
+    /** Builds the usage index of a project's sources. */
+    static buildIndex(sources: UnusedComponent_Source_Interface[]): UnusedComponent_Index_Interface;
+    /**
+     * The index of the project in `root` (cached; re-stamped at most every few seconds, rebuilt only when a file
+     * changed).
+     */
+    static projectIndex(root: string): {
+        sources: UnusedComponent_Source_Interface[];
+        index: UnusedComponent_Index_Interface;
+    };
+    /** Reads the committed baseline: the accepted component keys (`<file>#<Class>`). Broken file THROWS. */
+    static readBaseline(baselinePath: string): string[];
+    /** Forgets every cached project scan and baseline (tests; a long-lived process after a bulk change). */
+    static clearCache(): void;
+    /** The baseline key of a finding. */
+    static key(finding: {
+        file: string;
+        className: string;
+    }): string;
+    /** Forward slashes. */
+    static normalize(value: string): string;
+    /** Whether one selector (`app-x`, `button[app-btn]`, `[appX]`) is used in the templates. */
+    private static selectorUsed;
+    /** The element part of a selector (`app-x` of `app-x[y]:not(z)`), lower-case; empty for attribute-only. */
+    private static elementOf;
+    /** Element names opened in a template text. */
+    private static tagsIn;
+    /** Identifiers of a code text. */
+    private static identifiersIn;
+    /** Removes `import`/`export … from` statements and `imports`/`declarations`/`exports` arrays (not usages). */
+    private static stripRegistrations;
+}
+export {};
+//# sourceMappingURL=unused-component.util.d.ts.map