@futdevpro/dynamo-eslint 1.20.18 → 1.20.51

package/build/plugin/rules/angular/scroll-container-min-h-0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-container-min-h-0.js","sourceRoot":"","sources":["../../../../src/plugin/rules/angular/scroll-container-min-h-0.ts"],"names":[],"mappings":";;AAGA,iGAA2F;AAE3F,uEAAkE;AAElE;;;;;;GAMG;AACH,MAAM,IAAI,GAAoB;IAC5B,IAAI,EAAE;QACJ,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,WAAW,EAAE,6FAA6F;kBACtG,UAAU;YACd,WAAW,EAAE,IAAI;SAClB;QACD,MAAM,EAAE,wEAAiC,CAAC,MAAM;QAChD,QAAQ,EAAE;YACR,OAAO,EAAE,wGAAwG;kBAC7G,yGAAyG;kBACzG,8FAA8F;YAClG,kBAAkB,EAAE,wEAAiC,CAAC,yBAAyB;SAChF;KACF;IACD,MAAM,CAAC,OAAyB;QAC9B,MAAM,QAAQ,GAAW,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;QAEhD,IAAI,CAAC,+CAAqB,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO;YACL,OAAO;gBACL,MAAM,IAAI,GAAW,OAAO,CAAC,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC;gBACnD,MAAM,QAAQ,GAAwC,wEAAiC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAC1G,MAAM,GAAG,GAAW,+CAAqB,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;gBAC9F,MAAM,QAAQ,GACZ,+CAAqB,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;gBAC9E,MAAM,QAAQ,GAAW,QAAQ,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAE7D,uFAAuF;gBACvF,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,OAAiD,EAAQ,EAAE;oBAC3F,OAAO,CAAC,MAAM,CAAC;wBACb,GAAG,EAAE,wEAAiC,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC;wBAChE,SAAS,EAAE,SAAS;wBACpB,IAAI,EAAE;4BACJ,GAAG,EAAE,OAAO,CAAC,GAAG;4BAChB,UAAU,EAAE,OAAO,CAAC,UAAU;4BAC9B,WAAW,EAAE,MAAM,CAAC,wEAAiC,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;4BACxF,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;4BAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;yBAC3B;qBACF,CAAC,CAAC;gBACL,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,kBAAe,IAAI,CAAC"}

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

@@ -0,0 +1,10 @@
+/** The committed BFR-QA-004 baseline (`.dynamo/ui-building-blocks-baseline.json`), as the rules read it. */
+export interface UiBuildingBlocks_Baseline_Interface {
+    /** Component tags that ARE scroll containers (their scrolling lives in their own template / CSS). */
+    scrollerTags: string[];
+    /** Accepted scroll containers without a `min-h-0` chain, per file (relative, forward slashes). */
+    scrollContainers: Record<string, number>;
+    /** Accepted modules (relative folder, e.g. `src/app/_modules/tasks`) with a loading state but no failed branch. */
+    modulesWithoutLoadFailedBranch: string[];
+}
+//# sourceMappingURL=ui-building-blocks-baseline.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui-building-blocks-baseline.interface.d.ts","sourceRoot":"","sources":["../../../../src/plugin/rules/angular/ui-building-blocks-baseline.interface.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,MAAM,WAAW,mCAAmC;IAClD,qGAAqG;IACrG,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,kGAAkG;IAClG,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,mHAAmH;IACnH,8BAA8B,EAAE,MAAM,EAAE,CAAC;CAC1C"}

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

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

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

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

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

@@ -0,0 +1,14 @@
+/** One element of a template, as the BFR-QA-004 scanner sees it (enough structure for the scroll-chain check). */
+export interface UiBuildingBlocks_Element_Interface {
+    /** Lower-case tag name. */
+    tag: string;
+    /** Class names: static `class`, `[class.x]` bindings and quoted `[ngClass]` keys (a conditional class counts). */
+    classes: string[];
+    /** A height / max-height is set inline (`style`, `[style.height]`, `[ngStyle]`). */
+    heightStyle: boolean;
+    /** Offset of the `<` in the SOURCE file (inline templates are shifted to their place in the `.ts`). */
+    offset: number;
+    /** The enclosing element inside the same template (`undefined` at the template root). */
+    parent: UiBuildingBlocks_Element_Interface | undefined;
+}
+//# sourceMappingURL=ui-building-blocks-element.interface.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui-building-blocks-element.interface.d.ts","sourceRoot":"","sources":["../../../../src/plugin/rules/angular/ui-building-blocks-element.interface.ts"],"names":[],"mappings":"AAAA,kHAAkH;AAClH,MAAM,WAAW,kCAAkC;IACjD,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,kHAAkH;IAClH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oFAAoF;IACpF,WAAW,EAAE,OAAO,CAAC;IACrB,uGAAuG;IACvG,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,MAAM,EAAE,kCAAkC,GAAG,SAAS,CAAC;CACxD"}

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

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

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

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

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

@@ -0,0 +1,28 @@
+import { Rule } from 'eslint';
+import { UiBuildingBlocks_Baseline_Interface } from './ui-building-blocks-baseline.interface';
+/** An ESLint source range. */
+interface UiBuildingBlocks_Loc_Interface {
+    start: {
+        line: number;
+        column: number;
+    };
+    end: {
+        line: number;
+        column: number;
+    };
+}
+/** Rule plumbing shared by `scroll-container-min-h-0` and `module-load-failed-branch` (one baseline, one reader). */
+export declare class UiBuildingBlocks_RuleContext_Util {
+    /** The JSON schema of the shared options (`baselineFile`, relative to the ESLint working directory). */
+    static readonly schema: Rule.RuleMetaData['schema'];
+    /** The message shown when the baseline cannot be read (never a silent pass). */
+    static readonly baselineUnreadableMessage: string;
+    /** Reads the baseline; a broken one is REPORTED on the file and treated as empty. */
+    static baseline(context: Rule.RuleContext): UiBuildingBlocks_Baseline_Interface;
+    /** Offset → ESLint location (1-based line, 0-based column). */
+    static loc(text: string, offset: number): UiBuildingBlocks_Loc_Interface;
+    /** Offset → 1-based line. */
+    static line(text: string, offset: number): number;
+}
+export {};
+//# sourceMappingURL=ui-building-blocks-rule-context.util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui-building-blocks-rule-context.util.d.ts","sourceRoot":"","sources":["../../../../src/plugin/rules/angular/ui-building-blocks-rule-context.util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAG9B,OAAO,EAAE,mCAAmC,EAAE,MAAM,yCAAyC,CAAC;AAG9F,8BAA8B;AAC9B,UAAU,8BAA8B;IACtC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED,qHAAqH;AACrH,qBAAa,iCAAiC;IAE5C,wGAAwG;IACxG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAMjD;IAEF,gFAAgF;IAChF,MAAM,CAAC,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CACiC;IAElF,qFAAqF;IACrF,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,GAAG,mCAAmC;IAkB/E,+DAA+D;IAC/D,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,8BAA8B;IAQxE,6BAA6B;IAC7B,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;CAGlD"}

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

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UiBuildingBlocks_RuleContext_Util = void 0;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const ui_building_blocks_util_1 = require("./ui-building-blocks.util");
+/** Rule plumbing shared by `scroll-container-min-h-0` and `module-load-failed-branch` (one baseline, one reader). */
+class UiBuildingBlocks_RuleContext_Util {
+    /** The JSON schema of the shared options (`baselineFile`, relative to the ESLint working directory). */
+    static schema = [
+        {
+            type: 'object',
+            properties: { baselineFile: { type: 'string' } },
+            additionalProperties: false,
+        },
+    ];
+    /** The message shown when the baseline cannot be read (never a silent pass). */
+    static baselineUnreadableMessage = 'The UI-building-blocks baseline {{file}} cannot be read '
+        + '({{reason}}) — regenerate it with `npx dynamo-ui-building-blocks-baseline`.';
+    /** Reads the baseline; a broken one is REPORTED on the file and treated as empty. */
+    static baseline(context) {
+        const options = context.options[0] ?? {};
+        const cwd = context.cwd ?? process.cwd();
+        const file = path.resolve(cwd, options.baselineFile ?? ui_building_blocks_util_1.UiBuildingBlocks_Util.defaultBaselineFile);
+        try {
+            return ui_building_blocks_util_1.UiBuildingBlocks_Util.readBaseline(file);
+        }
+        catch (error) {
+            context.report({
+                loc: { start: { line: 1, column: 0 }, end: { line: 1, column: 0 } },
+                messageId: 'baselineUnreadable',
+                data: { file: file, reason: error instanceof Error ? error.message : String(error) },
+            });
+            return { scrollerTags: [], scrollContainers: {}, modulesWithoutLoadFailedBranch: [] };
+        }
+    }
+    /** Offset → ESLint location (1-based line, 0-based column). */
+    static loc(text, offset) {
+        const before = text.slice(0, offset);
+        const line = before.split('\n').length;
+        const column = offset - (before.lastIndexOf('\n') + 1);
+        return { start: { line: line, column: column }, end: { line: line, column: column + 1 } };
+    }
+    /** Offset → 1-based line. */
+    static line(text, offset) {
+        return text.slice(0, offset).split('\n').length;
+    }
+}
+exports.UiBuildingBlocks_RuleContext_Util = UiBuildingBlocks_RuleContext_Util;
+//# sourceMappingURL=ui-building-blocks-rule-context.util.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui-building-blocks-rule-context.util.js","sourceRoot":"","sources":["../../../../src/plugin/rules/angular/ui-building-blocks-rule-context.util.ts"],"names":[],"mappings":";;;;AACA,mDAA6B;AAG7B,uEAAkE;AAQlE,qHAAqH;AACrH,MAAa,iCAAiC;IAE5C,wGAAwG;IACxG,MAAM,CAAU,MAAM,GAAgC;QACpD;YACE,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;YAChD,oBAAoB,EAAE,KAAK;SAC5B;KACF,CAAC;IAEF,gFAAgF;IAChF,MAAM,CAAU,yBAAyB,GAAW,0DAA0D;UAC1G,6EAA6E,CAAC;IAElF,qFAAqF;IACrF,MAAM,CAAC,QAAQ,CAAC,OAAyB;QACvC,MAAM,OAAO,GAA8B,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpE,MAAM,GAAG,GAAW,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACjD,MAAM,IAAI,GAAW,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,IAAI,+CAAqB,CAAC,mBAAmB,CAAC,CAAC;QAE1G,IAAI,CAAC;YACH,OAAO,+CAAqB,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC;gBACb,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE;gBACnE,SAAS,EAAE,oBAAoB;gBAC/B,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aACrF,CAAC,CAAC;YAEH,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,8BAA8B,EAAE,EAAE,EAAE,CAAC;QACxF,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,MAAM,CAAC,GAAG,CAAC,IAAY,EAAE,MAAc;QACrC,MAAM,MAAM,GAAW,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAW,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAC/C,MAAM,MAAM,GAAW,MAAM,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAE/D,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC;IAC5F,CAAC;IAED,6BAA6B;IAC7B,MAAM,CAAC,IAAI,CAAC,IAAY,EAAE,MAAc;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAClD,CAAC;;AA9CH,8EA+CC"}

package/build/plugin/rules/angular/ui-building-blocks-scroll-finding.interface.d.ts

@@ -0,0 +1,12 @@
+/** A scroll container that will not scroll: a column-flex ancestor lets the chain grow to the content height. */
+export interface UiBuildingBlocks_ScrollFinding_Interface {
+    /** Offset of the scroll container's `<` in the source file. */
+    offset: number;
+    /** Tag of the scroll container. */
+    tag: string;
+    /** Offset of the nearest ancestor that is a column-flex item without `min-h-0`. */
+    culpritOffset: number;
+    /** Tag of that ancestor. */
+    culpritTag: string;
+}
+//# sourceMappingURL=ui-building-blocks-scroll-finding.interface.d.ts.map

package/build/plugin/rules/angular/ui-building-blocks-scroll-finding.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-building-blocks-scroll-finding.interface.d.ts","sourceRoot":"","sources":["../../../../src/plugin/rules/angular/ui-building-blocks-scroll-finding.interface.ts"],"names":[],"mappings":"AAAA,iHAAiH;AACjH,MAAM,WAAW,wCAAwC;IACvD,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAC;IACtB,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/build/plugin/rules/angular/ui-building-blocks-scroll-finding.interface.js

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

package/build/plugin/rules/angular/ui-building-blocks-scroll-finding.interface.js.map

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

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

@@ -0,0 +1,102 @@
+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;
+    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[];
+    /** ② 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). */
+    private static blankComments;
+    /** 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,337 @@
+"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',
+    ];
+    /**
+     * 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)');
+    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],
+                    };
+                    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')) {
+                    // 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');
+            let match = regex.exec(code);
+            while (match !== null) {
+                result.push(template.offset + match.index);
+                match = regex.exec(code);
+            }
+        });
+        return result;
+    }
+    /** ② 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: [] };
+        }
+        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');
+        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)),
+        };
+        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