@webpieces/nx-webpieces-rules 0.4.870 → 0.4.872

package/src/lib/graph-filter.client.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph-filter.client.js","sourceRoot":"","sources":["../../../../../../packages/tooling/nx-webpieces-rules/src/lib/graph-filter.client.ts"],"names":[],"mappings":"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","sourcesContent":["/** Plain browser helpers shared by architecture and runtime; no CommonJS imports. */\nclass WpGraphChain {\n    readonly inNodes = new Map<string, Set<string>>();\n    readonly outNodes = new Map<string, Set<string>>();\n\n    constructor(private readonly model: RenderModelJson) {\n        const ids = new Set(model.nodes.map((node) => node.id));\n        for (const edge of model.edges) {\n            if (!ids.has(edge.from) || !ids.has(edge.to)) continue;\n            this.add(this.outNodes, edge.from, edge.to);\n            this.add(this.inNodes, edge.to, edge.from);\n        }\n    }\n\n    private add(map: Map<string, Set<string>>, from: string, to: string): void {\n        if (!map.has(from)) map.set(from, new Set());\n        map.get(from)?.add(to);\n    }\n\n    nodes(anchor: string): Set<string> {\n        const retained = new Set<string>();\n        if (!this.model.nodes.some((node) => node.id === anchor)) return retained;\n        for (const direction of [this.inNodes, this.outNodes]) {\n            const visited = new Set([anchor]);\n            const stack = [anchor];\n            while (stack.length > 0) {\n                const id = stack.pop() as string;\n                retained.add(id);\n                for (const next of direction.get(id) ?? []) {\n                    if (visited.has(next)) continue;\n                    visited.add(next);\n                    stack.push(next);\n                }\n            }\n        }\n        return retained;\n    }\n}\n\nclass WpRenderBand {\n    constructor(\n        readonly level: number,\n        readonly nodeNames: string[],\n    ) {}\n}\n\n/** Original records plus fresh ranks: removed nodes cannot reappear via a rank/edge. */\nclass WpFilteredDot {\n    constructor(private readonly model: RenderModelJson) {}\n\n    render(retained: Set<string>): string {\n        const nodes = this.model.nodes.filter((node) => retained.has(node.id));\n        const edges = this.model.edges.filter(\n            (edge) => retained.has(edge.from) && retained.has(edge.to),\n        );\n        const bands = this.model.bands\n            .map(\n                (band) =>\n                    new WpRenderBand(\n                        band.level,\n                        band.nodeNames.filter((id) => retained.has(id)),\n                    ),\n            )\n            .filter((band) => band.nodeNames.length > 0);\n        return (\n            this.model.header +\n            nodes.map((node) => node.dot).join('') +\n            this.bandDot(bands) +\n            edges.map((edge) => edge.dot).join('') +\n            this.model.footer\n        );\n    }\n\n    private bandDot(bands: WpRenderBand[]): string {\n        const nodeAttrs =\n            '[style=invis, shape=point, width=0.01, height=0.01, label=\"\", class=\"wp-layout\"]';\n        const edgeAttrs = '[style=invis, class=\"wp-layout\"]';\n        let dot = '';\n        for (const band of bands) {\n            const anchor = `__wp_layout_L${band.level}`;\n            dot += `  \"${anchor}\" ${nodeAttrs};\\n  { rank=same; \"${anchor}\"; `;\n            dot += band.nodeNames.map((id) => `${JSON.stringify(id)}; `).join('') + '}\\n';\n        }\n        for (let i = 0; i + 1 < bands.length; i++) {\n            const upper = bands[i];\n            const lower = bands[i + 1];\n            const from = `__wp_layout_L${upper.level}`;\n            const to = `__wp_layout_L${lower.level}`;\n            if (upper.nodeNames.length <= 10 && lower.nodeNames.length <= 10) {\n                dot += `  \"${from}\" -> \"${to}\" ${edgeAttrs};\\n`;\n                continue;\n            }\n            const spacer = `__wp_layout_spacer_L${upper.level}_L${lower.level}`;\n            dot += `  \"${spacer}\" ${nodeAttrs};\\n  { rank=same; \"${spacer}\"; }\\n`;\n            dot += `  \"${from}\" -> \"${spacer}\" ${edgeAttrs};\\n  \"${spacer}\" -> \"${to}\" ${edgeAttrs};\\n`;\n        }\n        return dot;\n    }\n}\n\n/** Page-owned state survives replacements; rendering failures leave the usable SVG intact. */\nabstract class WpFilterPage {\n    protected readonly chain: WpGraphChain;\n    protected locked: string | null = null;\n    protected anchor: string | null = null;\n    protected retained: Set<string>;\n    private viz: VizInstance | null = null;\n\n    constructor(protected readonly model: RenderModelJson) {\n        this.chain = new WpGraphChain(model);\n        this.retained = new Set(model.nodes.map((node) => node.id));\n    }\n\n    render(): void {\n        document\n            .getElementById('wp-filter-off')\n            ?.addEventListener('click', () => this.filter(null));\n        this.wireControls();\n        Viz.instance()\n            .then((viz) => {\n                this.viz = viz;\n                this.filter(null);\n            })\n            // webpieces-disable no-any-unknown -- promise rejections may carry any JavaScript value\n            .catch((err: unknown): void =>\n                this.error(err instanceof Error ? err : new Error(String(err))),\n            );\n    }\n\n    protected captureBinding(_svg: SVGSVGElement | null): () => void {\n        return (): void => {};\n    }\n    protected wireControls(): void {}\n    protected abstract wireSvg(svg: SVGSVGElement): void;\n    protected prepareSvg(_svg: SVGSVGElement): void {}\n\n    filterItem(name: string): WpNodeMenuItem {\n        return new WpNodeMenuItem(\n            this.anchor === null ? 'Filter Unconnected' : 'Turn off Filter',\n            () => this.filter(this.anchor === null ? name : null),\n        );\n    }\n\n    filter(anchor: string | null): void {\n        if (this.viz === null) return;\n        const host = document.getElementById('graph');\n        if (host === null) return;\n        const retained =\n            anchor === null\n                ? new Set(this.model.nodes.map((node) => node.id))\n                : this.chain.nodes(anchor);\n        const previousAnchor = this.anchor;\n        const previousRetained = this.retained;\n        const previousSvg = host.querySelector('svg');\n        const focusName = WpNodeMenu.focusedName(previousSvg);\n        const rollback = this.captureBinding(previousSvg);\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- browser transaction restores the previous usable graph on failure\n        try {\n            const dot =\n                anchor === null\n                    ? this.model.fullDot\n                    : new WpFilteredDot(this.model).render(retained);\n            const svg = this.viz.renderSVGElement(dot);\n            this.prepareSvg(svg);\n            WpNodeMenu.close();\n            this.anchor = anchor;\n            this.retained = retained;\n            host.replaceChildren(svg);\n            this.wireSvg(svg);\n            this.indicator();\n            WpNodeMenu.restoreFocus(svg, focusName);\n            this.error(null);\n            // webpieces-disable no-any-unknown -- JavaScript may throw any value at this browser boundary\n        } catch (err: unknown) {\n            //const error = toError(err);\n            this.anchor = previousAnchor;\n            this.retained = previousRetained;\n            if (previousSvg !== null) host.replaceChildren(previousSvg);\n            else host.replaceChildren();\n            rollback();\n            if (previousSvg !== null) WpNodeMenu.restoreFocus(previousSvg, focusName);\n            this.error(err instanceof Error ? err : new Error(String(err)));\n        }\n    }\n\n    private indicator(): void {\n        const status = document.getElementById('wp-filter-status');\n        const label = document.getElementById('wp-filter-anchor');\n        if (status !== null) status.hidden = this.anchor === null;\n        if (label !== null) label.textContent = this.anchor;\n        if (this.anchor !== null) document.getElementById('wp-filter-off')?.focus();\n        else document.querySelector<SVGGElement>('#graph g.wp-node-clickable')?.focus();\n    }\n\n    private error(err: Error | null): void {\n        const el = document.getElementById('wp-graph-error');\n        if (el === null) return;\n        el.hidden = err === null;\n        el.textContent =\n            err === null\n                ? ''\n                : `Graph rendering failed: ${err.message}. Try Turn off Filter or reload the page.`;\n    }\n}\n"]}
+{"version":3,"file":"graph-filter.client.js","sourceRoot":"","sources":["../../../../../../packages/tooling/nx-webpieces-rules/src/lib/graph-filter.client.ts"],"names":[],"mappings":"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","sourcesContent":["/** Plain browser helpers shared by architecture and runtime; no CommonJS imports. */\nclass WpGraphChain {\n    readonly inNodes = new Map<string, Set<string>>();\n    readonly outNodes = new Map<string, Set<string>>();\n\n    constructor(private readonly model: RenderModelJson) {\n        const ids = new Set(model.nodes.map((node) => node.id));\n        for (const edge of model.edges) {\n            if (!ids.has(edge.from) || !ids.has(edge.to)) continue;\n            this.add(this.outNodes, edge.from, edge.to);\n            this.add(this.inNodes, edge.to, edge.from);\n        }\n    }\n\n    private add(map: Map<string, Set<string>>, from: string, to: string): void {\n        if (!map.has(from)) map.set(from, new Set());\n        map.get(from)?.add(to);\n    }\n\n    nodes(anchor: string): Set<string> {\n        const retained = new Set<string>();\n        if (!this.model.nodes.some((node) => node.id === anchor)) return retained;\n        for (const direction of [this.inNodes, this.outNodes]) {\n            const visited = new Set([anchor]);\n            const stack = [anchor];\n            while (stack.length > 0) {\n                const id = stack.pop() as string;\n                retained.add(id);\n                for (const next of direction.get(id) ?? []) {\n                    if (visited.has(next)) continue;\n                    visited.add(next);\n                    stack.push(next);\n                }\n            }\n        }\n        return retained;\n    }\n}\n\nclass WpRenderBand {\n    constructor(\n        readonly level: number,\n        readonly nodeNames: string[],\n    ) {}\n}\n\n/** Original records plus fresh ranks: removed nodes cannot reappear via a rank/edge. */\nclass WpFilteredDot {\n    constructor(private readonly model: RenderModelJson) {}\n\n    /** `nodeDot` picks each box's statement — the architecture page passes its current color mode's. */\n    render(\n        retained: Set<string>,\n        nodeDot: (node: RenderNodeJson) => string = (node: RenderNodeJson): string => node.dot,\n    ): string {\n        const nodes = this.model.nodes.filter((node: RenderNodeJson): boolean => retained.has(node.id));\n        const edges = this.model.edges.filter(\n            (edge) => retained.has(edge.from) && retained.has(edge.to),\n        );\n        const bands = this.model.bands\n            .map(\n                (band) =>\n                    new WpRenderBand(\n                        band.level,\n                        band.nodeNames.filter((id) => retained.has(id)),\n                    ),\n            )\n            .filter((band) => band.nodeNames.length > 0);\n        return (\n            this.model.header +\n            nodes.map((node: RenderNodeJson): string => nodeDot(node)).join('') +\n            this.bandDot(bands) +\n            edges.map((edge) => edge.dot).join('') +\n            this.model.footer\n        );\n    }\n\n    private bandDot(bands: WpRenderBand[]): string {\n        const nodeAttrs =\n            '[style=invis, shape=point, width=0.01, height=0.01, label=\"\", class=\"wp-layout\"]';\n        const edgeAttrs = '[style=invis, class=\"wp-layout\"]';\n        let dot = '';\n        for (const band of bands) {\n            const anchor = `__wp_layout_L${band.level}`;\n            dot += `  \"${anchor}\" ${nodeAttrs};\\n  { rank=same; \"${anchor}\"; `;\n            dot += band.nodeNames.map((id) => `${JSON.stringify(id)}; `).join('') + '}\\n';\n        }\n        for (let i = 0; i + 1 < bands.length; i++) {\n            const upper = bands[i];\n            const lower = bands[i + 1];\n            const from = `__wp_layout_L${upper.level}`;\n            const to = `__wp_layout_L${lower.level}`;\n            if (upper.nodeNames.length <= 10 && lower.nodeNames.length <= 10) {\n                dot += `  \"${from}\" -> \"${to}\" ${edgeAttrs};\\n`;\n                continue;\n            }\n            const spacer = `__wp_layout_spacer_L${upper.level}_L${lower.level}`;\n            dot += `  \"${spacer}\" ${nodeAttrs};\\n  { rank=same; \"${spacer}\"; }\\n`;\n            dot += `  \"${from}\" -> \"${spacer}\" ${edgeAttrs};\\n  \"${spacer}\" -> \"${to}\" ${edgeAttrs};\\n`;\n        }\n        return dot;\n    }\n}\n\n/** Page-owned state survives replacements; rendering failures leave the usable SVG intact. */\nabstract class WpFilterPage {\n    protected readonly chain: WpGraphChain;\n    protected locked: string | null = null;\n    protected anchor: string | null = null;\n    protected retained: Set<string>;\n    private viz: VizInstance | null = null;\n\n    constructor(protected readonly model: RenderModelJson) {\n        this.chain = new WpGraphChain(model);\n        this.retained = new Set(model.nodes.map((node) => node.id));\n    }\n\n    render(): void {\n        document\n            .getElementById('wp-filter-off')\n            ?.addEventListener('click', () => this.filter(null));\n        this.wireControls();\n        Viz.instance()\n            .then((viz) => {\n                this.viz = viz;\n                this.filter(null);\n            })\n            // webpieces-disable no-any-unknown -- promise rejections may carry any JavaScript value\n            .catch((err: unknown): void =>\n                this.error(err instanceof Error ? err : new Error(String(err))),\n            );\n    }\n\n    protected captureBinding(_svg: SVGSVGElement | null): () => void {\n        return (): void => {};\n    }\n    protected wireControls(): void {}\n    protected abstract wireSvg(svg: SVGSVGElement): void;\n    protected prepareSvg(_svg: SVGSVGElement): void {}\n    /** The statement drawn for one box. The architecture page answers with its color mode's. */\n    protected nodeDot(node: RenderNodeJson): string {\n        return node.dot;\n    }\n    /** Whether an unfiltered draw may use the model's precomputed `fullDot` verbatim. */\n    protected usesFullDot(): boolean {\n        return true;\n    }\n\n    /**\n     * Draw again with the current filter — after a color-mode switch. A control outside the graph\n     * (a drawer button) keeps keyboard focus; the redraw would otherwise move it into the graph.\n     */\n    redraw(): void {\n        const active = document.activeElement;\n        const host = document.getElementById('graph');\n        const outside = active instanceof HTMLElement && host !== null && !host.contains(active);\n        this.filter(this.anchor);\n        if (outside && active.isConnected) active.focus({ preventScroll: true });\n    }\n\n    filterItem(name: string): WpNodeMenuItem {\n        return new WpNodeMenuItem(\n            this.anchor === null ? 'Filter Unconnected' : 'Turn off Filter',\n            () => this.filter(this.anchor === null ? name : null),\n        );\n    }\n\n    filter(anchor: string | null): void {\n        if (this.viz === null) return;\n        const host = document.getElementById('graph');\n        if (host === null) return;\n        const retained =\n            anchor === null\n                ? new Set(this.model.nodes.map((node) => node.id))\n                : this.chain.nodes(anchor);\n        const previousAnchor = this.anchor;\n        const previousRetained = this.retained;\n        const previousSvg = host.querySelector('svg');\n        const focusName = WpNodeMenu.focusedName(previousSvg);\n        const rollback = this.captureBinding(previousSvg);\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- browser transaction restores the previous usable graph on failure\n        try {\n            const dot =\n                anchor === null && this.usesFullDot()\n                    ? this.model.fullDot\n                    : new WpFilteredDot(this.model).render(retained, (node: RenderNodeJson): string =>\n                          this.nodeDot(node),\n                      );\n            const svg = this.viz.renderSVGElement(dot);\n            this.prepareSvg(svg);\n            WpNodeMenu.close();\n            this.anchor = anchor;\n            this.retained = retained;\n            host.replaceChildren(svg);\n            this.wireSvg(svg);\n            this.indicator();\n            WpNodeMenu.restoreFocus(svg, focusName);\n            this.error(null);\n            // webpieces-disable no-any-unknown -- JavaScript may throw any value at this browser boundary\n        } catch (err: unknown) {\n            //const error = toError(err);\n            this.anchor = previousAnchor;\n            this.retained = previousRetained;\n            if (previousSvg !== null) host.replaceChildren(previousSvg);\n            else host.replaceChildren();\n            rollback();\n            if (previousSvg !== null) WpNodeMenu.restoreFocus(previousSvg, focusName);\n            this.error(err instanceof Error ? err : new Error(String(err)));\n        }\n    }\n\n    private indicator(): void {\n        const status = document.getElementById('wp-filter-status');\n        const label = document.getElementById('wp-filter-anchor');\n        if (status !== null) status.hidden = this.anchor === null;\n        if (label !== null) label.textContent = this.anchor;\n        if (this.anchor !== null) document.getElementById('wp-filter-off')?.focus();\n        else document.querySelector<SVGGElement>('#graph g.wp-node-clickable')?.focus();\n    }\n\n    private error(err: Error | null): void {\n        const el = document.getElementById('wp-graph-error');\n        if (el === null) return;\n        el.hidden = err === null;\n        el.textContent =\n            err === null\n                ? ''\n                : `Graph rendering failed: ${err.message}. Try Turn off Filter or reload the page.`;\n    }\n}\n"]}

package/src/lib/graph-impact.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Impact mode's data: what THIS BRANCH's build looks like, in three shades (plus untouched grey).
+ *
+ *  - BUILD INPUT is every transitive dependency of the affected set that is not itself affected:
+ *    `ci` dependsOn `^build`, so they must exist as build output though their inputs did not change.
+ *    nx restores them from cache when it has them and compiles them otherwise — which one happens is
+ *    not knowable here, so nothing claims it. A pure downward walk over the graph's own edges.
+ *
+ *  - AFFECTED is `nx show projects --affected --base=<fork point> --json`, with NO `--head`, so
+ *    uncommitted and untracked work counts. nx already gets right everything a hand-rolled diff gets
+ *    wrong: lockfile and package.json changes resolved per project, root/global inputs, namedInputs,
+ *    implicitDependencies, nested roots and deleted files. This uses its public CLI surface only, never
+ *    nx internals.
+ *  - TOUCHED is the subset of that set which OWNS a changed file, by nx's own file-to-project
+ *    ownership (the project file map from `createProjectFileMapUsingProjectGraph`, public devkit API)
+ *    — never a path-prefix guess. A project whose only change is a DELETED file is not in that map
+ *    (the file is gone), so it shows as affected rather than touched.
+ *
+ * The base is the repo's existing merge-base computation (`DiffScope.detectBase` in rules-config:
+ * `git merge-base HEAD origin/main`, falling back to `main`) — never NX_BASE/NX_HEAD, whose value
+ * depends on whoever launched the process. The changed-file list is `DiffScope.getChangedFiles`, the
+ * same base→working-tree diff (with untracked files) every code rule uses.
+ *
+ * The answer changes per branch, so it never goes into the committed dependencies.html or
+ * dependencies.json (both stay byte-stable across branches). It goes into a SIDECAR,
+ * `architecture/.impact/dependencies.impact.js`: a plain script setting one window global, loaded
+ * with `<script src>` — the one way a page opened straight from disk (file://) can read a
+ * neighbouring file. The directory carries its own `.gitignore` containing `*`, which ignores the
+ * directory and everything in it, so a consumer repo needs no gitignore edit and the PR gate's
+ * "build left nothing uncommitted" check never sees it.
+ *
+ * Impact is a convenience. When nx or git cannot answer, NO sidecar is written (a stale one is
+ * removed) and the page disables Impact with a one-line reason. It never fails generation.
+ */
+import { DiffScope } from '@webpieces/rules-config';
+import type { EnhancedGraph } from './graph-sorter';
+/** Relative to the architecture/ directory the page lives in; the page's `<script src>`. */
+export declare const IMPACT_SIDECAR_DIR = ".impact";
+export declare const IMPACT_SIDECAR_FILE = "dependencies.impact.js";
+export declare const IMPACT_SIDECAR_SRC = ".impact/dependencies.impact.js";
+/** What the sidecar carries; the page reads it as `window.__WP_IMPACT__`. */
+export declare class ImpactReport {
+    readonly available: boolean;
+    readonly reason: string;
+    readonly base: string;
+    /** Affected AND owning a changed file (node ids). */
+    readonly touched: string[];
+    /** Affected but owning no changed file (node ids): their ci re-runs. */
+    readonly affected: string[];
+    /**
+     * Transitive dependencies of the affected set that are NOT affected (node ids). `ci` dependsOn
+     * `^build`, so they must exist as build output although their inputs did not change: nx
+     * restores them from cache when it has them and compiles them otherwise. Which of the two
+     * happens is not knowable here, so the page claims neither.
+     */
+    readonly buildInputs: string[];
+    readonly changedFiles: number;
+    constructor(available: boolean, reason: string, base: string, 
+    /** Affected AND owning a changed file (node ids). */
+    touched: string[], 
+    /** Affected but owning no changed file (node ids): their ci re-runs. */
+    affected: string[], 
+    /**
+     * Transitive dependencies of the affected set that are NOT affected (node ids). `ci` dependsOn
+     * `^build`, so they must exist as build output although their inputs did not change: nx
+     * restores them from cache when it has them and compiles them otherwise. Which of the two
+     * happens is not knowable here, so the page claims neither.
+     */
+    buildInputs: string[], changedFiles: number);
+}
+/** A scan that could not produce an answer: no sidecar is written, only this reason printed. */
+export declare class ImpactUnavailable {
+    readonly reason: string;
+    constructor(reason: string);
+}
+/** Runs the workspace's own nx CLI. Injected so specs never spawn nx. */
+export declare class NxCli {
+    /** stdout, or null when nx cannot be found, exits non-zero or exceeds the timeout. */
+    run(workspaceRoot: string, args: string[], timeoutMs: number): string | null;
+    /** Resolved the way node would from the workspace, so a linked worktree finds its main tree's nx. */
+    private binary;
+}
+/** nx's own file → project ownership, from the public devkit file map. Injected for specs. */
+export declare class ProjectFileOwners {
+    owners(): Promise<Map<string, string>>;
+}
+export declare class NxImpactScanner {
+    private readonly diffScope;
+    private readonly nx;
+    private readonly ownership;
+    private readonly names;
+    constructor(diffScope?: DiffScope, nx?: NxCli, ownership?: ProjectFileOwners);
+    scan(workspaceRoot: string, graph: EnhancedGraph): Promise<ImpactReport | ImpactUnavailable>;
+    /** A pure downward walk over the graph's own dependsOn edges: no nx call. */
+    buildInputs(affected: string[], graph: EnhancedGraph): string[];
+    /** Affected projects that own one of the changed files, by nx's own ownership. */
+    touched(affected: string[], files: string[], owners: Map<string, string>): string[];
+    /** The JSON list, narrowed to projects the graph draws; null when it is not a list of names. */
+    parse(json: string, graph: EnhancedGraph): string[] | null;
+    /** Ownership failing is not fatal: the set then shows in one shade, all "affected". */
+    private owners;
+    private ids;
+}
+/** Writes (or removes) the sidecar, self-ignored, beside architecture/dependencies.html. */
+export declare class ImpactSidecar {
+    /** Never throws: a sidecar that cannot be written just leaves Impact disabled on the page. */
+    write(architectureDir: string, report: ImpactReport): string | null;
+    /** A stale sidecar from an earlier branch must never be shown as this branch's impact. */
+    remove(architectureDir: string): void;
+    script(report: ImpactReport): string;
+}
+/** The generator's one call: scan, write, and report the result and its cost in one line. */
+export declare class ImpactRefresh {
+    private readonly scanner;
+    private readonly sidecar;
+    constructor(scanner?: NxImpactScanner, sidecar?: ImpactSidecar);
+    /** Never throws — Impact is optional, generation is not. */
+    run(architectureDir: string, workspaceRoot: string, graph: EnhancedGraph): Promise<string>;
+}

package/src/lib/graph-impact.js

@@ -0,0 +1,295 @@
+"use strict";
+/**
+ * Impact mode's data: what THIS BRANCH's build looks like, in three shades (plus untouched grey).
+ *
+ *  - BUILD INPUT is every transitive dependency of the affected set that is not itself affected:
+ *    `ci` dependsOn `^build`, so they must exist as build output though their inputs did not change.
+ *    nx restores them from cache when it has them and compiles them otherwise — which one happens is
+ *    not knowable here, so nothing claims it. A pure downward walk over the graph's own edges.
+ *
+ *  - AFFECTED is `nx show projects --affected --base=<fork point> --json`, with NO `--head`, so
+ *    uncommitted and untracked work counts. nx already gets right everything a hand-rolled diff gets
+ *    wrong: lockfile and package.json changes resolved per project, root/global inputs, namedInputs,
+ *    implicitDependencies, nested roots and deleted files. This uses its public CLI surface only, never
+ *    nx internals.
+ *  - TOUCHED is the subset of that set which OWNS a changed file, by nx's own file-to-project
+ *    ownership (the project file map from `createProjectFileMapUsingProjectGraph`, public devkit API)
+ *    — never a path-prefix guess. A project whose only change is a DELETED file is not in that map
+ *    (the file is gone), so it shows as affected rather than touched.
+ *
+ * The base is the repo's existing merge-base computation (`DiffScope.detectBase` in rules-config:
+ * `git merge-base HEAD origin/main`, falling back to `main`) — never NX_BASE/NX_HEAD, whose value
+ * depends on whoever launched the process. The changed-file list is `DiffScope.getChangedFiles`, the
+ * same base→working-tree diff (with untracked files) every code rule uses.
+ *
+ * The answer changes per branch, so it never goes into the committed dependencies.html or
+ * dependencies.json (both stay byte-stable across branches). It goes into a SIDECAR,
+ * `architecture/.impact/dependencies.impact.js`: a plain script setting one window global, loaded
+ * with `<script src>` — the one way a page opened straight from disk (file://) can read a
+ * neighbouring file. The directory carries its own `.gitignore` containing `*`, which ignores the
+ * directory and everything in it, so a consumer repo needs no gitignore edit and the PR gate's
+ * "build left nothing uncommitted" check never sees it.
+ *
+ * Impact is a convenience. When nx or git cannot answer, NO sidecar is written (a stale one is
+ * removed) and the page disables Impact with a one-line reason. It never fails generation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImpactRefresh = exports.ImpactSidecar = exports.NxImpactScanner = exports.ProjectFileOwners = exports.NxCli = exports.ImpactUnavailable = exports.ImpactReport = exports.IMPACT_SIDECAR_SRC = exports.IMPACT_SIDECAR_FILE = exports.IMPACT_SIDECAR_DIR = void 0;
+const tslib_1 = require("tslib");
+const child_process_1 = require("child_process");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const devkit_1 = require("@nx/devkit");
+const rules_config_1 = require("@webpieces/rules-config");
+const graph_names_1 = require("./graph-names");
+const toError_1 = require("../toError");
+/** Relative to the architecture/ directory the page lives in; the page's `<script src>`. */
+exports.IMPACT_SIDECAR_DIR = '.impact';
+exports.IMPACT_SIDECAR_FILE = 'dependencies.impact.js';
+exports.IMPACT_SIDECAR_SRC = `${exports.IMPACT_SIDECAR_DIR}/${exports.IMPACT_SIDECAR_FILE}`;
+/** The nx call is capped; a slow or wedged nx disables Impact instead of stalling generation. */
+const NX_TIMEOUT_MS = 15000;
+/** What the sidecar carries; the page reads it as `window.__WP_IMPACT__`. */
+class ImpactReport {
+    available;
+    reason;
+    base;
+    touched;
+    affected;
+    buildInputs;
+    changedFiles;
+    constructor(available, reason, base, 
+    /** Affected AND owning a changed file (node ids). */
+    touched, 
+    /** Affected but owning no changed file (node ids): their ci re-runs. */
+    affected, 
+    /**
+     * Transitive dependencies of the affected set that are NOT affected (node ids). `ci` dependsOn
+     * `^build`, so they must exist as build output although their inputs did not change: nx
+     * restores them from cache when it has them and compiles them otherwise. Which of the two
+     * happens is not knowable here, so the page claims neither.
+     */
+    buildInputs, changedFiles) {
+        this.available = available;
+        this.reason = reason;
+        this.base = base;
+        this.touched = touched;
+        this.affected = affected;
+        this.buildInputs = buildInputs;
+        this.changedFiles = changedFiles;
+    }
+}
+exports.ImpactReport = ImpactReport;
+/** A scan that could not produce an answer: no sidecar is written, only this reason printed. */
+class ImpactUnavailable {
+    reason;
+    constructor(reason) {
+        this.reason = reason;
+    }
+}
+exports.ImpactUnavailable = ImpactUnavailable;
+/** Runs the workspace's own nx CLI. Injected so specs never spawn nx. */
+class NxCli {
+    /** stdout, or null when nx cannot be found, exits non-zero or exceeds the timeout. */
+    run(workspaceRoot, args, timeoutMs) {
+        const bin = this.binary(workspaceRoot);
+        if (bin === null)
+            return null;
+        const result = (0, child_process_1.spawnSync)(process.execPath, [bin, ...args], {
+            cwd: workspaceRoot,
+            encoding: 'utf8',
+            timeout: timeoutMs,
+            stdio: 'pipe',
+            maxBuffer: 16 * 1024 * 1024,
+        });
+        if (result.error !== undefined || result.status !== 0)
+            return null;
+        return result.stdout;
+    }
+    /** Resolved the way node would from the workspace, so a linked worktree finds its main tree's nx. */
+    binary(workspaceRoot) {
+        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- a workspace without nx resolves nothing; that is an answer, not an error
+        try {
+            return require.resolve('nx/bin/nx.js', { paths: [workspaceRoot] });
+        }
+        catch (err) {
+            const error = (0, toError_1.toError)(err);
+            void error; // no nx installed here — Impact is simply unavailable
+            return null;
+        }
+    }
+}
+exports.NxCli = NxCli;
+/** nx's own file → project ownership, from the public devkit file map. Injected for specs. */
+class ProjectFileOwners {
+    async owners() {
+        const fileMap = await (0, devkit_1.createProjectFileMapUsingProjectGraph)(await (0, devkit_1.createProjectGraphAsync)());
+        const owners = new Map();
+        for (const project of Object.keys(fileMap)) {
+            for (const data of fileMap[project])
+                owners.set(data.file, project);
+        }
+        return owners;
+    }
+}
+exports.ProjectFileOwners = ProjectFileOwners;
+class NxImpactScanner {
+    diffScope;
+    nx;
+    ownership;
+    names = new graph_names_1.GraphNames();
+    constructor(diffScope = new rules_config_1.DiffScope(), nx = new NxCli(), ownership = new ProjectFileOwners()) {
+        this.diffScope = diffScope;
+        this.nx = nx;
+        this.ownership = ownership;
+    }
+    async scan(workspaceRoot, graph) {
+        const base = this.diffScope.detectBase(workspaceRoot);
+        if (base === null)
+            return new ImpactUnavailable('no fork point: neither origin/main nor main resolves (or git is unavailable)');
+        const json = this.nx.run(workspaceRoot, ['show', 'projects', '--affected', `--base=${base}`, '--json'], NX_TIMEOUT_MS);
+        if (json === null)
+            return new ImpactUnavailable(`nx show projects --affected failed or took over ${NX_TIMEOUT_MS / 1000}s`);
+        const affectedSet = this.parse(json, graph);
+        if (affectedSet === null)
+            return new ImpactUnavailable('nx show projects --affected printed something other than a JSON list');
+        const options = new rules_config_1.ChangedFilesOptions();
+        options.tsOnly = false;
+        options.includeDeletions = true;
+        const files = this.diffScope.getChangedFiles(workspaceRoot, base, undefined, options);
+        const short = base.slice(0, 7);
+        if (affectedSet.length === 0)
+            return new ImpactReport(false, `nothing affected since the fork point ${short}`, short, [], [], [], files.length);
+        const touched = this.touched(affectedSet, files, await this.owners());
+        const rest = affectedSet.filter((project) => !touched.includes(project));
+        const inputs = this.buildInputs(affectedSet, graph);
+        return new ImpactReport(true, '', short, this.ids(touched), this.ids(rest), this.ids(inputs), files.length);
+    }
+    /** A pure downward walk over the graph's own dependsOn edges: no nx call. */
+    buildInputs(affected, graph) {
+        const inSet = new Set(affected);
+        const seen = new Set(affected);
+        const stack = [...affected];
+        const inputs = [];
+        while (stack.length > 0) {
+            const project = stack.pop();
+            for (const dep of graph[project]?.dependsOn ?? []) {
+                if (seen.has(dep))
+                    continue;
+                seen.add(dep);
+                stack.push(dep);
+                if (!inSet.has(dep) && graph[dep] !== undefined)
+                    inputs.push(dep);
+            }
+        }
+        return inputs.sort();
+    }
+    /** Affected projects that own one of the changed files, by nx's own ownership. */
+    touched(affected, files, owners) {
+        const owning = new Set();
+        for (const file of files) {
+            const owner = owners.get(file);
+            if (owner !== undefined)
+                owning.add(owner);
+        }
+        return affected.filter((project) => owning.has(project));
+    }
+    /** The JSON list, narrowed to projects the graph draws; null when it is not a list of names. */
+    parse(json, graph) {
+        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- untrusted CLI output; anything unparseable is reported as a reason
+        try {
+            // webpieces-disable no-any-unknown -- CLI JSON is untrusted until narrowed below
+            const parsed = JSON.parse(json);
+            if (!Array.isArray(parsed))
+                return null;
+            return parsed
+                .filter((name) => typeof name === 'string' && graph[name] !== undefined)
+                .sort();
+        }
+        catch (err) {
+            const error = (0, toError_1.toError)(err);
+            void error; // not JSON — the caller reports it
+            return null;
+        }
+    }
+    /** Ownership failing is not fatal: the set then shows in one shade, all "affected". */
+    async owners() {
+        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- the second shade is optional
+        try {
+            return await this.ownership.owners();
+        }
+        catch (err) {
+            const error = (0, toError_1.toError)(err);
+            console.warn(`⚠️  Impact: nx file ownership unavailable (${error.message}); showing one shade`);
+            return new Map();
+        }
+    }
+    ids(projects) {
+        return projects.map((project) => this.names.getNodeId(project));
+    }
+}
+exports.NxImpactScanner = NxImpactScanner;
+/** Writes (or removes) the sidecar, self-ignored, beside architecture/dependencies.html. */
+class ImpactSidecar {
+    /** Never throws: a sidecar that cannot be written just leaves Impact disabled on the page. */
+    write(architectureDir, report) {
+        const dir = path.join(architectureDir, exports.IMPACT_SIDECAR_DIR);
+        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- impact is optional; a write failure must never fail generation
+        try {
+            fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(path.join(dir, '.gitignore'), '# Written by architecture:generate. Per-branch data: never commit it.\n*\n', 'utf-8');
+            const file = path.join(dir, exports.IMPACT_SIDECAR_FILE);
+            fs.writeFileSync(file, this.script(report), 'utf-8');
+            return file;
+        }
+        catch (err) {
+            const error = (0, toError_1.toError)(err);
+            console.warn(`⚠️  Could not write the impact sidecar: ${error.message}`);
+            return null;
+        }
+    }
+    /** A stale sidecar from an earlier branch must never be shown as this branch's impact. */
+    remove(architectureDir) {
+        fs.rmSync(path.join(architectureDir, exports.IMPACT_SIDECAR_DIR, exports.IMPACT_SIDECAR_FILE), { force: true });
+    }
+    script(report) {
+        const json = JSON.stringify(report).replace(/</g, '\\u003c');
+        return `// Generated by architecture:generate for one branch. Gitignored; do not commit.\nwindow.__WP_IMPACT__ = ${json};\n`;
+    }
+}
+exports.ImpactSidecar = ImpactSidecar;
+/** The generator's one call: scan, write, and report the result and its cost in one line. */
+class ImpactRefresh {
+    scanner;
+    sidecar;
+    constructor(scanner = new NxImpactScanner(), sidecar = new ImpactSidecar()) {
+        this.scanner = scanner;
+        this.sidecar = sidecar;
+    }
+    /** Never throws — Impact is optional, generation is not. */
+    async run(architectureDir, workspaceRoot, graph) {
+        const started = Date.now();
+        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- impact is optional; any failure becomes a reason, never a failed generation
+        try {
+            const report = await this.scanner.scan(workspaceRoot, graph);
+            const cost = `${Date.now() - started} ms`;
+            if (report instanceof ImpactUnavailable) {
+                this.sidecar.remove(architectureDir);
+                return `ℹ️  Impact disabled, no sidecar written: ${report.reason} (${cost})`;
+            }
+            const file = this.sidecar.write(architectureDir, report);
+            if (file === null)
+                return `⚠️  Impact sidecar not written (${cost})`;
+            if (!report.available)
+                return `ℹ️  Impact disabled on the page: ${report.reason} (${cost})`;
+            return (`✅ Impact vs ${report.base}: ${report.touched.length} touched · ${report.affected.length} affected · ` +
+                `${report.buildInputs.length} build inputs, from ${report.changedFiles} changed file(s) (${cost}) → ${file}`);
+        }
+        catch (err) {
+            const error = (0, toError_1.toError)(err);
+            return `⚠️  Impact skipped: ${error.message}`;
+        }
+    }
+}
+exports.ImpactRefresh = ImpactRefresh;
+//# sourceMappingURL=graph-impact.js.map

package/src/lib/graph-impact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-impact.js","sourceRoot":"","sources":["../../../../../../packages/tooling/nx-webpieces-rules/src/lib/graph-impact.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Impact mode's data: what THIS BRANCH's build looks like, in three shades (plus untouched grey).\n *\n *  - BUILD INPUT is every transitive dependency of the affected set that is not itself affected:\n *    `ci` dependsOn `^build`, so they must exist as build output though their inputs did not change.\n *    nx restores them from cache when it has them and compiles them otherwise — which one happens is\n *    not knowable here, so nothing claims it. A pure downward walk over the graph's own edges.\n *\n *  - AFFECTED is `nx show projects --affected --base=<fork point> --json`, with NO `--head`, so\n *    uncommitted and untracked work counts. nx already gets right everything a hand-rolled diff gets\n *    wrong: lockfile and package.json changes resolved per project, root/global inputs, namedInputs,\n *    implicitDependencies, nested roots and deleted files. This uses its public CLI surface only, never\n *    nx internals.\n *  - TOUCHED is the subset of that set which OWNS a changed file, by nx's own file-to-project\n *    ownership (the project file map from `createProjectFileMapUsingProjectGraph`, public devkit API)\n *    — never a path-prefix guess. A project whose only change is a DELETED file is not in that map\n *    (the file is gone), so it shows as affected rather than touched.\n *\n * The base is the repo's existing merge-base computation (`DiffScope.detectBase` in rules-config:\n * `git merge-base HEAD origin/main`, falling back to `main`) — never NX_BASE/NX_HEAD, whose value\n * depends on whoever launched the process. The changed-file list is `DiffScope.getChangedFiles`, the\n * same base→working-tree diff (with untracked files) every code rule uses.\n *\n * The answer changes per branch, so it never goes into the committed dependencies.html or\n * dependencies.json (both stay byte-stable across branches). It goes into a SIDECAR,\n * `architecture/.impact/dependencies.impact.js`: a plain script setting one window global, loaded\n * with `<script src>` — the one way a page opened straight from disk (file://) can read a\n * neighbouring file. The directory carries its own `.gitignore` containing `*`, which ignores the\n * directory and everything in it, so a consumer repo needs no gitignore edit and the PR gate's\n * \"build left nothing uncommitted\" check never sees it.\n *\n * Impact is a convenience. When nx or git cannot answer, NO sidecar is written (a stale one is\n * removed) and the page disables Impact with a one-line reason. It never fails generation.\n */\n\nimport { spawnSync } from 'child_process';\nimport * as fs from 'fs';\nimport * as path from 'path';\nimport { createProjectFileMapUsingProjectGraph, createProjectGraphAsync } from '@nx/devkit';\nimport { DiffScope, ChangedFilesOptions } from '@webpieces/rules-config';\nimport type { EnhancedGraph } from './graph-sorter';\nimport { GraphNames } from './graph-names';\nimport { toError } from '../toError';\n\n/** Relative to the architecture/ directory the page lives in; the page's `<script src>`. */\nexport const IMPACT_SIDECAR_DIR = '.impact';\nexport const IMPACT_SIDECAR_FILE = 'dependencies.impact.js';\nexport const IMPACT_SIDECAR_SRC = `${IMPACT_SIDECAR_DIR}/${IMPACT_SIDECAR_FILE}`;\n/** The nx call is capped; a slow or wedged nx disables Impact instead of stalling generation. */\nconst NX_TIMEOUT_MS = 15000;\n\n/** What the sidecar carries; the page reads it as `window.__WP_IMPACT__`. */\nexport class ImpactReport {\n    constructor(\n        public readonly available: boolean,\n        public readonly reason: string,\n        public readonly base: string,\n        /** Affected AND owning a changed file (node ids). */\n        public readonly touched: string[],\n        /** Affected but owning no changed file (node ids): their ci re-runs. */\n        public readonly affected: string[],\n        /**\n         * Transitive dependencies of the affected set that are NOT affected (node ids). `ci` dependsOn\n         * `^build`, so they must exist as build output although their inputs did not change: nx\n         * restores them from cache when it has them and compiles them otherwise. Which of the two\n         * happens is not knowable here, so the page claims neither.\n         */\n        public readonly buildInputs: string[],\n        public readonly changedFiles: number,\n    ) {}\n}\n\n/** A scan that could not produce an answer: no sidecar is written, only this reason printed. */\nexport class ImpactUnavailable {\n    constructor(public readonly reason: string) {}\n}\n\n/** Runs the workspace's own nx CLI. Injected so specs never spawn nx. */\nexport class NxCli {\n    /** stdout, or null when nx cannot be found, exits non-zero or exceeds the timeout. */\n    run(workspaceRoot: string, args: string[], timeoutMs: number): string | null {\n        const bin = this.binary(workspaceRoot);\n        if (bin === null) return null;\n        const result = spawnSync(process.execPath, [bin, ...args], {\n            cwd: workspaceRoot,\n            encoding: 'utf8',\n            timeout: timeoutMs,\n            stdio: 'pipe',\n            maxBuffer: 16 * 1024 * 1024,\n        });\n        if (result.error !== undefined || result.status !== 0) return null;\n        return result.stdout;\n    }\n\n    /** Resolved the way node would from the workspace, so a linked worktree finds its main tree's nx. */\n    private binary(workspaceRoot: string): string | null {\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- a workspace without nx resolves nothing; that is an answer, not an error\n        try {\n            return require.resolve('nx/bin/nx.js', { paths: [workspaceRoot] });\n        } catch (err: unknown) {\n            const error = toError(err);\n            void error; // no nx installed here — Impact is simply unavailable\n            return null;\n        }\n    }\n}\n\n/** nx's own file → project ownership, from the public devkit file map. Injected for specs. */\nexport class ProjectFileOwners {\n    async owners(): Promise<Map<string, string>> {\n        const fileMap = await createProjectFileMapUsingProjectGraph(await createProjectGraphAsync());\n        const owners = new Map<string, string>();\n        for (const project of Object.keys(fileMap)) {\n            for (const data of fileMap[project]) owners.set(data.file, project);\n        }\n        return owners;\n    }\n}\n\nexport class NxImpactScanner {\n    private readonly names = new GraphNames();\n\n    constructor(\n        private readonly diffScope: DiffScope = new DiffScope(),\n        private readonly nx: NxCli = new NxCli(),\n        private readonly ownership: ProjectFileOwners = new ProjectFileOwners(),\n    ) {}\n\n    async scan(workspaceRoot: string, graph: EnhancedGraph): Promise<ImpactReport | ImpactUnavailable> {\n        const base = this.diffScope.detectBase(workspaceRoot);\n        if (base === null) return new ImpactUnavailable('no fork point: neither origin/main nor main resolves (or git is unavailable)');\n        const json = this.nx.run(workspaceRoot, ['show', 'projects', '--affected', `--base=${base}`, '--json'], NX_TIMEOUT_MS);\n        if (json === null) return new ImpactUnavailable(`nx show projects --affected failed or took over ${NX_TIMEOUT_MS / 1000}s`);\n        const affectedSet = this.parse(json, graph);\n        if (affectedSet === null) return new ImpactUnavailable('nx show projects --affected printed something other than a JSON list');\n        const options = new ChangedFilesOptions();\n        options.tsOnly = false;\n        options.includeDeletions = true;\n        const files = this.diffScope.getChangedFiles(workspaceRoot, base, undefined, options);\n        const short = base.slice(0, 7);\n        if (affectedSet.length === 0)\n            return new ImpactReport(false, `nothing affected since the fork point ${short}`, short, [], [], [], files.length);\n        const touched = this.touched(affectedSet, files, await this.owners());\n        const rest = affectedSet.filter((project: string): boolean => !touched.includes(project));\n        const inputs = this.buildInputs(affectedSet, graph);\n        return new ImpactReport(true, '', short, this.ids(touched), this.ids(rest), this.ids(inputs), files.length);\n    }\n\n    /** A pure downward walk over the graph's own dependsOn edges: no nx call. */\n    buildInputs(affected: string[], graph: EnhancedGraph): string[] {\n        const inSet = new Set<string>(affected);\n        const seen = new Set<string>(affected);\n        const stack = [...affected];\n        const inputs: string[] = [];\n        while (stack.length > 0) {\n            const project = stack.pop() as string;\n            for (const dep of graph[project]?.dependsOn ?? []) {\n                if (seen.has(dep)) continue;\n                seen.add(dep);\n                stack.push(dep);\n                if (!inSet.has(dep) && graph[dep] !== undefined) inputs.push(dep);\n            }\n        }\n        return inputs.sort();\n    }\n\n    /** Affected projects that own one of the changed files, by nx's own ownership. */\n    touched(affected: string[], files: string[], owners: Map<string, string>): string[] {\n        const owning = new Set<string>();\n        for (const file of files) {\n            const owner = owners.get(file);\n            if (owner !== undefined) owning.add(owner);\n        }\n        return affected.filter((project: string): boolean => owning.has(project));\n    }\n\n    /** The JSON list, narrowed to projects the graph draws; null when it is not a list of names. */\n    parse(json: string, graph: EnhancedGraph): string[] | null {\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- untrusted CLI output; anything unparseable is reported as a reason\n        try {\n            // webpieces-disable no-any-unknown -- CLI JSON is untrusted until narrowed below\n            const parsed: unknown = JSON.parse(json);\n            if (!Array.isArray(parsed)) return null;\n            return parsed\n                .filter((name: unknown): name is string => typeof name === 'string' && graph[name] !== undefined)\n                .sort();\n        } catch (err: unknown) {\n            const error = toError(err);\n            void error; // not JSON — the caller reports it\n            return null;\n        }\n    }\n\n    /** Ownership failing is not fatal: the set then shows in one shade, all \"affected\". */\n    private async owners(): Promise<Map<string, string>> {\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- the second shade is optional\n        try {\n            return await this.ownership.owners();\n        } catch (err: unknown) {\n            const error = toError(err);\n            console.warn(`⚠️  Impact: nx file ownership unavailable (${error.message}); showing one shade`);\n            return new Map<string, string>();\n        }\n    }\n\n    private ids(projects: string[]): string[] {\n        return projects.map((project: string): string => this.names.getNodeId(project));\n    }\n}\n\n/** Writes (or removes) the sidecar, self-ignored, beside architecture/dependencies.html. */\nexport class ImpactSidecar {\n    /** Never throws: a sidecar that cannot be written just leaves Impact disabled on the page. */\n    write(architectureDir: string, report: ImpactReport): string | null {\n        const dir = path.join(architectureDir, IMPACT_SIDECAR_DIR);\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- impact is optional; a write failure must never fail generation\n        try {\n            fs.mkdirSync(dir, { recursive: true });\n            fs.writeFileSync(\n                path.join(dir, '.gitignore'),\n                '# Written by architecture:generate. Per-branch data: never commit it.\\n*\\n',\n                'utf-8',\n            );\n            const file = path.join(dir, IMPACT_SIDECAR_FILE);\n            fs.writeFileSync(file, this.script(report), 'utf-8');\n            return file;\n        } catch (err: unknown) {\n            const error = toError(err);\n            console.warn(`⚠️  Could not write the impact sidecar: ${error.message}`);\n            return null;\n        }\n    }\n\n    /** A stale sidecar from an earlier branch must never be shown as this branch's impact. */\n    remove(architectureDir: string): void {\n        fs.rmSync(path.join(architectureDir, IMPACT_SIDECAR_DIR, IMPACT_SIDECAR_FILE), { force: true });\n    }\n\n    script(report: ImpactReport): string {\n        const json = JSON.stringify(report).replace(/</g, '\\\\u003c');\n        return `// Generated by architecture:generate for one branch. Gitignored; do not commit.\\nwindow.__WP_IMPACT__ = ${json};\\n`;\n    }\n}\n\n/** The generator's one call: scan, write, and report the result and its cost in one line. */\nexport class ImpactRefresh {\n    constructor(\n        private readonly scanner: NxImpactScanner = new NxImpactScanner(),\n        private readonly sidecar: ImpactSidecar = new ImpactSidecar(),\n    ) {}\n\n    /** Never throws — Impact is optional, generation is not. */\n    async run(architectureDir: string, workspaceRoot: string, graph: EnhancedGraph): Promise<string> {\n        const started = Date.now();\n        // eslint-disable-next-line @webpieces/no-unmanaged-exceptions -- impact is optional; any failure becomes a reason, never a failed generation\n        try {\n            const report = await this.scanner.scan(workspaceRoot, graph);\n            const cost = `${Date.now() - started} ms`;\n            if (report instanceof ImpactUnavailable) {\n                this.sidecar.remove(architectureDir);\n                return `ℹ️  Impact disabled, no sidecar written: ${report.reason} (${cost})`;\n            }\n            const file = this.sidecar.write(architectureDir, report);\n            if (file === null) return `⚠️  Impact sidecar not written (${cost})`;\n            if (!report.available) return `ℹ️  Impact disabled on the page: ${report.reason} (${cost})`;\n            return (\n                `✅ Impact vs ${report.base}: ${report.touched.length} touched · ${report.affected.length} affected · ` +\n                `${report.buildInputs.length} build inputs, from ${report.changedFiles} changed file(s) (${cost}) → ${file}`\n            );\n        } catch (err: unknown) {\n            const error = toError(err);\n            return `⚠️  Impact skipped: ${error.message}`;\n        }\n    }\n}\n"]}

package/src/lib/graph-legend.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The architecture graph's legend, generated per color mode FROM THE PROJECTS ACTUALLY DRAWN.
+ *
+ * The hand-written legend this replaces listed five frameworks when six existed and never mentioned
+ * the `app` and `bundle` borders the renderer drew (#1155). Generating the rows from the same tables
+ * the renderer colors with (graph-color-modes.ts) means a color in use always has a row, and a color
+ * nothing uses never does.
+ *
+ * Swatches are inline SVG drawn with presentation attributes, never `style=`, so the page carries
+ * no inline CSS.
+ */
+import { LegendFacts } from './graph-color-modes';
+export declare class GraphLegend {
+    /** One section per mode; the page shows the section of the current mode and hides the rest. */
+    sections(facts: LegendFacts): string;
+    /** The edge key: why a line exists. Static — every graph can carry every edge kind. */
+    edgeKey(): string;
+    private section;
+    /** Base runtimes first (stripe order), then specializations, in the shared vocabulary's order. */
+    runtimeRows(facts: LegendFacts): string;
+    architectureRows(facts: LegendFacts): string;
+    /** Which box is which is only known from the branch's sidecar, so all four rows always show. */
+    private impactRows;
+    private row;
+    private open;
+    private frame;
+    /** A base runtime is solid; a specialization is its inset on the base color. */
+    private envSwatch;
+    private stripesSwatch;
+    private roleSwatch;
+    /** A filled swatch, optionally with an inner ring (dashed when `dash` is set). */
+    private solid;
+    private edgeRow;
+}