archprint 0.1.0

package/dist/generator/feature-slice-emitters.d.ts

@@ -0,0 +1,19 @@
+import type { GenerationStatus } from '../detector/confidence-gate.js';
+import type { FeatureSliceGroup } from '../detector/feature-slice-detector.js';
+export interface CrossSliceRule {
+    name: string;
+    comment: string;
+    severity: 'error' | 'warn' | 'info';
+    from: {
+        path: string;
+    };
+    to: {
+        path: string;
+        pathNot: string;
+    };
+}
+export interface CrossSliceConfig {
+    forbidden: CrossSliceRule[];
+}
+export declare function toDependencyCruiserFeatureSlice(groups: readonly FeatureSliceGroup[], include?: readonly GenerationStatus[]): CrossSliceConfig;
+//# sourceMappingURL=feature-slice-emitters.d.ts.map

package/dist/generator/feature-slice-emitters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-slice-emitters.d.ts","sourceRoot":"","sources":["../../src/generator/feature-slice-emitters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAU/E,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvB,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,SAAS,iBAAiB,EAAE,EACpC,OAAO,GAAE,SAAS,gBAAgB,EAAa,GAC9C,gBAAgB,CAclB"}

package/dist/generator/feature-slice-emitters.js

@@ -0,0 +1,19 @@
+const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const slug = (container) => container.replace(/[^a-zA-Z0-9]+/g, '-').replace(/^-|-$/g, '');
+const confidencePct = (group) => `${(group.gate.conditions.confidence.value * 100).toFixed(0)}%`;
+export function toDependencyCruiserFeatureSlice(groups, include = ['AUTO']) {
+    const forbidden = groups
+        .filter((group) => include.includes(group.gate.status))
+        .map((group) => {
+        const container = escapeRegExp(group.container);
+        return {
+            name: `no-cross-slice-${slug(group.container)}`,
+            comment: `Archprint inferred slice isolation: the ${group.sliceCount} slices under "${group.container}" do not import each other (${group.sliceFileCount - group.crossImporterCount}/${group.sliceFileCount} slice files conform); cross-slice imports are forbidden (confidence ${confidencePct(group)}).`,
+            severity: 'error',
+            from: { path: `^${container}/([^/]+)/` },
+            to: { path: `^${container}/([^/]+)/`, pathNot: `^${container}/$1/` },
+        };
+    });
+    return { forbidden };
+}
+//# sourceMappingURL=feature-slice-emitters.js.map

package/dist/generator/feature-slice-emitters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-slice-emitters.js","sourceRoot":"","sources":["../../src/generator/feature-slice-emitters.ts"],"names":[],"mappings":"AAGA,MAAM,YAAY,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAE7F,MAAM,IAAI,GAAG,CAAC,SAAiB,EAAU,EAAE,CACzC,SAAS,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAEjE,MAAM,aAAa,GAAG,CAAC,KAAwB,EAAU,EAAE,CACzD,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAclE,MAAM,UAAU,+BAA+B,CAC7C,MAAoC,EACpC,UAAuC,CAAC,MAAM,CAAC;IAE/C,MAAM,SAAS,GAAG,MAAM;SACrB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SACtD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChD,OAAO;YACL,IAAI,EAAE,kBAAkB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;YAC/C,OAAO,EAAE,2CAA2C,KAAK,CAAC,UAAU,kBAAkB,KAAK,CAAC,SAAS,+BAA+B,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,kBAAkB,IAAI,KAAK,CAAC,cAAc,wEAAwE,aAAa,CAAC,KAAK,CAAC,IAAI;YAC3S,QAAQ,EAAE,OAAgB;YAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,SAAS,WAAW,EAAE;YACxC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,SAAS,WAAW,EAAE,OAAO,EAAE,IAAI,SAAS,MAAM,EAAE;SACrE,CAAC;IACJ,CAAC,CAAC,CAAC;IACL,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC"}

package/dist/generator/graph-emitters.d.ts

@@ -0,0 +1,11 @@
+import type { LayerBoundary } from '../detector/layer-detector.js';
+export interface LayerGraphEdge {
+    from: string;
+    to: string;
+    weight: number;
+    leak: boolean;
+}
+export declare function layerGraphEdges(boundaries: readonly LayerBoundary[]): LayerGraphEdge[];
+export declare function toMermaid(boundaries: readonly LayerBoundary[]): string;
+export declare function toGraphviz(boundaries: readonly LayerBoundary[]): string;
+//# sourceMappingURL=graph-emitters.d.ts.map

package/dist/generator/graph-emitters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-emitters.d.ts","sourceRoot":"","sources":["../../src/generator/graph-emitters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,GAAG,cAAc,EAAE,CAwBtF;AAKD,wBAAgB,SAAS,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAiBtE;AAID,wBAAgB,UAAU,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAcvE"}

package/dist/generator/graph-emitters.js

@@ -0,0 +1,56 @@
+export function layerGraphEdges(boundaries) {
+    const edges = [];
+    for (const boundary of boundaries) {
+        if (boundary.reverseFlow > 0) {
+            edges.push({
+                from: boundary.to,
+                to: boundary.from,
+                weight: boundary.reverseFlow,
+                leak: false,
+            });
+        }
+        if (boundary.stats.violatingFileCount > 0) {
+            edges.push({
+                from: boundary.from,
+                to: boundary.to,
+                weight: boundary.stats.violatingFileCount,
+                leak: true,
+            });
+        }
+    }
+    return edges.sort((a, b) => a.from.localeCompare(b.from) || a.to.localeCompare(b.to) || Number(a.leak) - Number(b.leak));
+}
+const graphNodes = (edges) => [...new Set(edges.flatMap((edge) => [edge.from, edge.to]))].sort();
+export function toMermaid(boundaries) {
+    const edges = layerGraphEdges(boundaries);
+    const nodes = graphNodes(edges);
+    const id = new Map(nodes.map((node, index) => [node, `n${index}`]));
+    const lines = ['graph LR'];
+    for (const node of nodes)
+        lines.push(`  ${id.get(node)}["${node}"]`);
+    edges.forEach((edge) => {
+        const from = id.get(edge.from);
+        const to = id.get(edge.to);
+        lines.push(edge.leak
+            ? `  ${from} -. "${edge.weight} ⚠" .-> ${to}`
+            : `  ${from} -->|${edge.weight}| ${to}`);
+    });
+    return lines.join('\n');
+}
+const dotId = (layer) => `"${layer.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+export function toGraphviz(boundaries) {
+    const edges = layerGraphEdges(boundaries);
+    const nodes = graphNodes(edges);
+    const lines = ['digraph archprint {', '  rankdir=LR;', '  node [shape=box];'];
+    for (const node of nodes)
+        lines.push(`  ${dotId(node)};`);
+    for (const edge of edges) {
+        const attrs = edge.leak
+            ? `[label="${edge.weight}", style=dashed, color=red]`
+            : `[label="${edge.weight}"]`;
+        lines.push(`  ${dotId(edge.from)} -> ${dotId(edge.to)} ${attrs};`);
+    }
+    lines.push('}');
+    return lines.join('\n');
+}
+//# sourceMappingURL=graph-emitters.js.map

package/dist/generator/graph-emitters.js.map

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

package/dist/generator/layer-emitters.d.ts

@@ -0,0 +1,39 @@
+import type { GenerationStatus } from '../detector/confidence-gate.js';
+import type { LayerBoundary } from '../detector/layer-detector.js';
+export interface DependencyCruiserRule {
+    name: string;
+    comment: string;
+    severity: 'error' | 'warn' | 'info';
+    from: {
+        path: string;
+    };
+    to: {
+        path: string;
+    };
+}
+export interface DependencyCruiserConfig {
+    forbidden: DependencyCruiserRule[];
+}
+export declare function toDependencyCruiser(boundaries: readonly LayerBoundary[], include?: readonly GenerationStatus[]): DependencyCruiserConfig;
+export interface EslintBoundariesElement {
+    type: string;
+    pattern: string;
+}
+export interface EslintBoundariesRule {
+    from: string[];
+    disallow: string[];
+    message: string;
+}
+export interface EslintBoundariesConfig {
+    settings: {
+        'boundaries/elements': EslintBoundariesElement[];
+    };
+    rules: {
+        'boundaries/element-types': ['error', {
+            default: 'allow';
+            rules: EslintBoundariesRule[];
+        }];
+    };
+}
+export declare function toEslintBoundaries(boundaries: readonly LayerBoundary[], include?: readonly GenerationStatus[]): EslintBoundariesConfig;
+//# sourceMappingURL=layer-emitters.d.ts.map

package/dist/generator/layer-emitters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-emitters.d.ts","sourceRoot":"","sources":["../../src/generator/layer-emitters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAcnE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvB,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,qBAAqB,EAAE,CAAC;CACpC;AAED,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,SAAS,aAAa,EAAE,EACpC,OAAO,GAAE,SAAS,gBAAgB,EAAa,GAC9C,uBAAuB,CASzB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE;QAAE,qBAAqB,EAAE,uBAAuB,EAAE,CAAA;KAAE,CAAC;IAC/D,KAAK,EAAE;QACL,0BAA0B,EAAE,CAAC,OAAO,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,oBAAoB,EAAE,CAAA;SAAE,CAAC,CAAC;KAC5F,CAAC;CACH;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,SAAS,aAAa,EAAE,EACpC,OAAO,GAAE,SAAS,gBAAgB,EAAa,GAC9C,sBAAsB,CA6BxB"}

package/dist/generator/layer-emitters.js

@@ -0,0 +1,43 @@
+const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const layerPath = (layer) => `(^|/)${escapeRegExp(layer)}/`;
+const confidencePct = (boundary) => `${(boundary.gate.conditions.confidence.value * 100).toFixed(0)}%`;
+const selected = (boundaries, include) => boundaries.filter((boundary) => include.includes(boundary.gate.status));
+export function toDependencyCruiser(boundaries, include = ['AUTO']) {
+    const forbidden = selected(boundaries, include).map((boundary) => ({
+        name: `no-${boundary.from}-to-${boundary.to}`,
+        comment: `Archprint inferred boundary: the "${boundary.to}" layer depends on "${boundary.from}" across ${boundary.reverseFlow} file(s); the reverse is forbidden (confidence ${confidencePct(boundary)}).`,
+        severity: 'error',
+        from: { path: layerPath(boundary.from) },
+        to: { path: layerPath(boundary.to) },
+    }));
+    return { forbidden };
+}
+export function toEslintBoundaries(boundaries, include = ['AUTO']) {
+    const chosen = selected(boundaries, include);
+    const layers = [...new Set(chosen.flatMap((boundary) => [boundary.from, boundary.to]))].sort();
+    const elements = layers.map((layer) => ({ type: layer, pattern: `**/${layer}/**` }));
+    const disallowByFrom = new Map();
+    for (const boundary of chosen) {
+        let targets = disallowByFrom.get(boundary.from);
+        if (targets === undefined) {
+            targets = new Set();
+            disallowByFrom.set(boundary.from, targets);
+        }
+        targets.add(boundary.to);
+    }
+    const rules = [...disallowByFrom.entries()]
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([from, targets]) => {
+        const disallow = [...targets].sort();
+        return {
+            from: [from],
+            disallow,
+            message: `The "${from}" layer must not import: ${disallow.join(', ')} (inferred by Archprint from the observed import direction).`,
+        };
+    });
+    return {
+        settings: { 'boundaries/elements': elements },
+        rules: { 'boundaries/element-types': ['error', { default: 'allow', rules }] },
+    };
+}
+//# sourceMappingURL=layer-emitters.js.map

package/dist/generator/layer-emitters.js.map

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

package/dist/generator/phantom-dependency-emitters.d.ts

@@ -0,0 +1,17 @@
+import type { PhantomDependencyAnalysis } from '../detector/phantom-dependency-detector.js';
+export interface PhantomDependencyRule {
+    name: string;
+    comment: string;
+    severity: 'error' | 'warn' | 'info';
+    from: {
+        pathNot: string;
+    };
+    to: {
+        dependencyTypes: string[];
+    };
+}
+export interface PhantomDependencyConfig {
+    forbidden: PhantomDependencyRule[];
+}
+export declare function toDependencyCruiserPhantomDependencies(analysis: PhantomDependencyAnalysis): PhantomDependencyConfig;
+//# sourceMappingURL=phantom-dependency-emitters.d.ts.map

package/dist/generator/phantom-dependency-emitters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phantom-dependency-emitters.d.ts","sourceRoot":"","sources":["../../src/generator/phantom-dependency-emitters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAE5F,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,EAAE,EAAE;QAAE,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,qBAAqB,EAAE,CAAC;CACpC;AAED,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,yBAAyB,GAClC,uBAAuB,CAiBzB"}

package/dist/generator/phantom-dependency-emitters.js

@@ -0,0 +1,19 @@
+export function toDependencyCruiserPhantomDependencies(analysis) {
+    if (analysis.externalImporterCount === 0 || analysis.gate.status !== 'AUTO') {
+        return { forbidden: [] };
+    }
+    const conform = analysis.externalImporterCount - analysis.offenderCount;
+    const floor = `${(analysis.gate.conditions.confidence.value * 100).toFixed(0)}%`;
+    return {
+        forbidden: [
+            {
+                name: 'no-phantom-dependencies',
+                comment: `Archprint inferred dependency declaration: ${conform}/${analysis.externalImporterCount} files import only packages declared in package.json; importing an undeclared (phantom/transitive) dependency is forbidden (confidence ${floor}).`,
+                severity: 'error',
+                from: { pathNot: 'node_modules' },
+                to: { dependencyTypes: ['npm-no-pkg', 'npm-unknown'] },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=phantom-dependency-emitters.js.map

package/dist/generator/phantom-dependency-emitters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phantom-dependency-emitters.js","sourceRoot":"","sources":["../../src/generator/phantom-dependency-emitters.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,sCAAsC,CACpD,QAAmC;IAEnC,IAAI,QAAQ,CAAC,qBAAqB,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC5E,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC3B,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,qBAAqB,GAAG,QAAQ,CAAC,aAAa,CAAC;IACxE,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACjF,OAAO;QACL,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,yBAAyB;gBAC/B,OAAO,EAAE,8CAA8C,OAAO,IAAI,QAAQ,CAAC,qBAAqB,0IAA0I,KAAK,IAAI;gBACnP,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE;gBACjC,EAAE,EAAE,EAAE,eAAe,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC,EAAE;aACvD;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/generator/public-api-emitters.d.ts

@@ -0,0 +1,19 @@
+import type { GenerationStatus } from '../detector/confidence-gate.js';
+import type { PublicApiGroup } from '../detector/public-api-detector.js';
+export interface DeepImportRule {
+    name: string;
+    comment: string;
+    severity: 'error' | 'warn' | 'info';
+    from: {
+        pathNot: string;
+    };
+    to: {
+        path: string;
+        pathNot: string;
+    };
+}
+export interface DeepImportConfig {
+    forbidden: DeepImportRule[];
+}
+export declare function toDependencyCruiserPublicApi(groups: readonly PublicApiGroup[], include?: readonly GenerationStatus[]): DeepImportConfig;
+//# sourceMappingURL=public-api-emitters.d.ts.map

package/dist/generator/public-api-emitters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-emitters.d.ts","sourceRoot":"","sources":["../../src/generator/public-api-emitters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AASzE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,OAAO,GAAE,SAAS,gBAAgB,EAAa,GAC9C,gBAAgB,CAclB"}

package/dist/generator/public-api-emitters.js

@@ -0,0 +1,19 @@
+const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const slug = (dir) => dir.replace(/[^a-zA-Z0-9]+/g, '-').replace(/^-|-$/g, '');
+const confidencePct = (group) => `${(group.gate.conditions.confidence.value * 100).toFixed(0)}%`;
+export function toDependencyCruiserPublicApi(groups, include = ['AUTO']) {
+    const forbidden = groups
+        .filter((group) => include.includes(group.gate.status))
+        .map((group) => {
+        const dir = escapeRegExp(group.dir);
+        return {
+            name: `no-deep-import-${slug(group.dir)}`,
+            comment: `Archprint inferred public API: files outside "${group.dir}" import it through its barrel (${group.consumerCount - group.deepImporterCount}/${group.consumerCount} consumers); deep imports into its internals are forbidden (confidence ${confidencePct(group)}).`,
+            severity: 'error',
+            from: { pathNot: `^${dir}/` },
+            to: { path: `^${dir}/`, pathNot: `^${dir}/index\\.(ts|tsx)$` },
+        };
+    });
+    return { forbidden };
+}
+//# sourceMappingURL=public-api-emitters.js.map

package/dist/generator/public-api-emitters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-emitters.js","sourceRoot":"","sources":["../../src/generator/public-api-emitters.ts"],"names":[],"mappings":"AAGA,MAAM,YAAY,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAE7F,MAAM,IAAI,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAE/F,MAAM,aAAa,GAAG,CAAC,KAAqB,EAAU,EAAE,CACtD,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAclE,MAAM,UAAU,4BAA4B,CAC1C,MAAiC,EACjC,UAAuC,CAAC,MAAM,CAAC;IAE/C,MAAM,SAAS,GAAG,MAAM;SACrB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SACtD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,OAAO;YACL,IAAI,EAAE,kBAAkB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;YACzC,OAAO,EAAE,iDAAiD,KAAK,CAAC,GAAG,mCAAmC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,aAAa,0EAA0E,aAAa,CAAC,KAAK,CAAC,IAAI;YAC5Q,QAAQ,EAAE,OAAgB;YAC1B,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,GAAG,GAAG,EAAE;YAC7B,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,GAAG,EAAE,OAAO,EAAE,IAAI,GAAG,oBAAoB,EAAE;SAC/D,CAAC;IACJ,CAAC,CAAC,CAAC;IACL,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC"}

package/dist/generator/role-layering-emitters.d.ts

@@ -0,0 +1,18 @@
+import type { GenerationStatus } from '../detector/confidence-gate.js';
+import type { RoleBoundary } from '../detector/role-layering-detector.js';
+export interface RoleLayeringRule {
+    name: string;
+    comment: string;
+    severity: 'error' | 'warn' | 'info';
+    from: {
+        path: string;
+    };
+    to: {
+        path: string;
+    };
+}
+export interface RoleLayeringConfig {
+    forbidden: RoleLayeringRule[];
+}
+export declare function toDependencyCruiserRoleLayering(boundaries: readonly RoleBoundary[], include?: readonly GenerationStatus[]): RoleLayeringConfig;
+//# sourceMappingURL=role-layering-emitters.d.ts.map

package/dist/generator/role-layering-emitters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-layering-emitters.d.ts","sourceRoot":"","sources":["../../src/generator/role-layering-emitters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAY1E,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvB,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,SAAS,YAAY,EAAE,EACnC,OAAO,GAAE,SAAS,gBAAgB,EAAa,GAC9C,kBAAkB,CAWpB"}

package/dist/generator/role-layering-emitters.js

@@ -0,0 +1,19 @@
+import { ROLE_PATTERNS } from '../scanner/role-classifier.js';
+const rolePath = (role) => {
+    const sources = (ROLE_PATTERNS.get(role) ?? []).map((pattern) => pattern.source);
+    return sources.length === 1 ? sources[0] : `(${sources.join('|')})`;
+};
+const confidencePct = (boundary) => `${(boundary.gate.conditions.confidence.value * 100).toFixed(0)}%`;
+export function toDependencyCruiserRoleLayering(boundaries, include = ['AUTO']) {
+    const forbidden = boundaries
+        .filter((boundary) => include.includes(boundary.gate.status))
+        .map((boundary) => ({
+        name: `no-${boundary.from.toLowerCase()}-to-${boundary.to.toLowerCase()}`,
+        comment: `Archprint inferred role layering: ${boundary.reverseFlow} ${boundary.to} file(s) depend on ${boundary.from}, not the reverse; a ${boundary.from} must not import a ${boundary.to} (confidence ${confidencePct(boundary)}).`,
+        severity: 'error',
+        from: { path: rolePath(boundary.from) },
+        to: { path: rolePath(boundary.to) },
+    }));
+    return { forbidden };
+}
+//# sourceMappingURL=role-layering-emitters.js.map

package/dist/generator/role-layering-emitters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-layering-emitters.js","sourceRoot":"","sources":["../../src/generator/role-layering-emitters.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAG9D,MAAM,QAAQ,GAAG,CAAC,IAAU,EAAU,EAAE;IACtC,MAAM,OAAO,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjF,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AACvE,CAAC,CAAC;AAEF,MAAM,aAAa,GAAG,CAAC,QAAsB,EAAU,EAAE,CACvD,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAcrE,MAAM,UAAU,+BAA+B,CAC7C,UAAmC,EACnC,UAAuC,CAAC,MAAM,CAAC;IAE/C,MAAM,SAAS,GAAG,UAAU;SACzB,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SAC5D,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClB,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE;QACzE,OAAO,EAAE,qCAAqC,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,EAAE,sBAAsB,QAAQ,CAAC,IAAI,wBAAwB,QAAQ,CAAC,IAAI,sBAAsB,QAAQ,CAAC,EAAE,gBAAgB,aAAa,CAAC,QAAQ,CAAC,IAAI;QACrO,QAAQ,EAAE,OAAgB;QAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;QACvC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE;KACpC,CAAC,CAAC,CAAC;IACN,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC"}

package/dist/generator/rule-generator.d.ts

@@ -0,0 +1,14 @@
+import type { DetectedPattern } from '../detector/pattern-detector.js';
+import type { PatternConfig } from '../detector/pattern-detector.js';
+export interface RuleArtifacts {
+    ruleName: string;
+    files: {
+        rule: string;
+        card: string;
+        passingFixture: string;
+        failingFixture: string;
+    };
+}
+export declare function generateRuleArtifacts(config: PatternConfig, result: DetectedPattern, provenance?: string): RuleArtifacts;
+export declare function emitRuleArtifacts(config: PatternConfig, result: DetectedPattern, outDir: string, provenance?: string): string;
+//# sourceMappingURL=rule-generator.d.ts.map

package/dist/generator/rule-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-generator.d.ts","sourceRoot":"","sources":["../../src/generator/rule-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;CACvF;AAmKD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,eAAe,EACvB,UAAU,SAAK,GACd,aAAa,CAUf;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,EACd,UAAU,SAAK,GACd,MAAM,CASR"}

package/dist/generator/rule-generator.js

@@ -0,0 +1,174 @@
+import { mkdirSync, writeFileSync } from 'node:fs';
+import * as path from 'node:path';
+import { ROLE_PATTERNS } from '../scanner/role-classifier.js';
+const asRegexArray = (sources) => `[${sources.map((source) => `/${source}/`).join(', ')}]`;
+function renderRule(config, result) {
+    const entryPatterns = config.roles
+        .flatMap((role) => ROLE_PATTERNS.get(role) ?? [])
+        .map((pattern) => pattern.source);
+    const nonEntryPatterns = [...ROLE_PATTERNS]
+        .filter(([role]) => !config.roles.includes(role) && role !== 'COMPONENT')
+        .flatMap(([, patterns]) => patterns.map((pattern) => pattern.source));
+    const forbidden = config.forbidden.map((marker) => marker.source);
+    const includesServerAction = config.roles.includes('SERVER_ACTION');
+    const { ratio, roleFileCount, violatingFileCount } = result.stats;
+    const conform = (ratio * 100).toFixed(1);
+    return `/**
+ * @fileoverview ${config.id} ${config.name}: GENERATED BY ARCHPRINT. Do not edit by hand.
+ * Inferred from the real import graph: ${roleFileCount - violatingFileCount}/${roleFileCount} server-entry files (${conform}%) already follow this.
+ * Evidence and provenance: ./${config.name}.md
+ */
+import type { Rule } from 'eslint';
+
+const SERVER_ENTRY_PATTERNS: readonly RegExp[] = ${asRegexArray(entryPatterns)};
+const NAMED_NON_ENTRY: readonly RegExp[] = ${asRegexArray(nonEntryPatterns)};
+const FORBIDDEN: readonly RegExp[] = ${asRegexArray(forbidden)};
+
+const normalize = (filePath: string): string => filePath.replace(/\\\\/g, '/');
+
+function hasUseServerDirective(context: Rule.RuleContext): boolean {
+  for (const statement of context.sourceCode.ast.body) {
+    if (statement.type !== 'ExpressionStatement') break;
+    const expression = statement.expression;
+    if (expression.type !== 'Literal' || typeof expression.value !== 'string') break;
+    if (expression.value === 'use server') return true;
+  }
+  return false;
+}
+
+function isServerEntry(filename: string, context: Rule.RuleContext): boolean {
+  const file = normalize(filename);
+  if (SERVER_ENTRY_PATTERNS.some((pattern) => pattern.test(file))) return true;
+  ${includesServerAction
+        ? `if (!file.endsWith('.tsx') && !NAMED_NON_ENTRY.some((pattern) => pattern.test(file))) {
+    return hasUseServerDirective(context);
+  }`
+        : `void NAMED_NON_ENTRY;
+  void hasUseServerDirective;`}
+  return false;
+}
+
+const rule: Rule.RuleModule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: ${JSON.stringify(config.description)},
+      recommended: false,
+    },
+    schema: [],
+    messages: {
+      forbidden:
+        '${config.id}: a server-entry file must not import the UI components/ layer (imported "{{specifier}}"). Move shared logic into a non-UI module.',
+    },
+  },
+  create(context) {
+    const filename = context.filename;
+    if (!isServerEntry(filename, context)) return {};
+    return {
+      ImportDeclaration(node) {
+        const specifier = String(node.source.value);
+        if (FORBIDDEN.some((pattern) => pattern.test(specifier))) {
+          context.report({ node: node.source, messageId: 'forbidden', data: { specifier } });
+        }
+      },
+    };
+  },
+};
+
+export default rule;
+`;
+}
+function renderCard(config, result, provenance) {
+    const { roleFileCount, violatingFileCount, ratio, roleConfidence } = result.stats;
+    const example = result.violations[0];
+    const gate = result.gate.conditions;
+    const pass = (ok) => (ok ? 'PASS' : 'FAIL');
+    return `# ${config.id} \`${config.name}\`
+
+> Generated by Archprint from the repository's real import graph. ${provenance}
+
+## Rule
+
+${config.description}
+
+**Scope (server-entry roles):** ${config.roles.join(', ')}. Semantics: **direct import**. A violation
+is a server-entry file that directly imports the \`components/\` layer. Transitive reach (importing a
+module that itself imports a component) is out of scope.
+
+## Evidence (why Archprint generated this)
+
+| gate condition | value | threshold | result |
+|---|---|---|---|
+| conformance (95% lower bound) | ${(gate.confidence.value * 100).toFixed(1)}% floor, ${(ratio * 100).toFixed(1)}% observed (${roleFileCount - violatingFileCount}/${roleFileCount}) | >= 90% | ${pass(gate.confidence.pass)} |
+| exceptions | ${violatingFileCount} | <= 3 | ${pass(gate.exceptions.pass)} |
+| role confidence | ${roleConfidence.toFixed(2)} | >= 0.80 | ${pass(gate.roleConfidence.pass)} |
+
+Status: **${result.gate.status}** (all conditions must pass to auto-generate; the conformance floor is the
+Wilson 95% lower bound over ${roleFileCount} observations, so a thin sample cannot auto-generate).
+${example
+        ? `\n## The one exception in the source repo\n\n\`${example.file}\` imports \`${example.specifier}\`. Review whether it is a genuine violation or a legitimate exception before enforcing.`
+        : ''}
+
+## Enforcement scope and limitations (honest boundaries)
+
+This is a lightweight, self-contained ESLint rule. It enforces at the **import-specifier** level, which
+is narrower than the graph-based inference that generated it:
+
+- **Alias/barrel false negative:** an import whose specifier does not contain \`components\` but resolves
+  to the UI layer (e.g. \`@/lib/shared-ui\` aliased to a component) is **not** caught. The detector
+  resolves such imports to their leaf; the rule does not. A future alias-aware or dependency-cruiser
+  emission would close this.
+- **External false positive:** a specifier literally containing \`components\` that resolves inside
+  \`node_modules\` would be flagged. Not relevant to this repo, but disclosed.
+- **Server-entry scope:** mirrors the classifier. A file with a \`"use server"\` directive is treated as
+  server-entry only when it is otherwise unclassified; named roles (service, repository, worker, db /
+  data-access, shared, test) keep their role and are out of scope.
+
+## Fixtures
+
+- \`fixtures/passing.ts\`: a server-entry file that does not import the UI layer (rule stays silent).
+- \`fixtures/failing.ts\`: a server-entry file that imports the UI layer (rule reports).
+`;
+}
+function renderPassingFixture() {
+    return `// app/api/example/route.ts (PASSING): a route handler with no UI-layer import.
+import { NextResponse } from 'next/server';
+import { getUser } from '@/utils/user';
+
+export async function GET(): Promise<Response> {
+  return NextResponse.json(await getUser());
+}
+`;
+}
+function renderFailingFixture() {
+    return `// app/api/chat/route.ts (FAILING): a route handler importing the components/ (UI) layer.
+import { NextResponse } from 'next/server';
+import { convertToUIMessages } from '@/components/assistant-chat/helpers';
+
+export async function POST(): Promise<Response> {
+  return NextResponse.json(convertToUIMessages([]));
+}
+`;
+}
+export function generateRuleArtifacts(config, result, provenance = '') {
+    return {
+        ruleName: config.name,
+        files: {
+            rule: renderRule(config, result),
+            card: renderCard(config, result, provenance),
+            passingFixture: renderPassingFixture(),
+            failingFixture: renderFailingFixture(),
+        },
+    };
+}
+export function emitRuleArtifacts(config, result, outDir, provenance = '') {
+    const artifacts = generateRuleArtifacts(config, result, provenance);
+    const ruleDir = path.join(outDir, artifacts.ruleName);
+    mkdirSync(path.join(ruleDir, 'fixtures'), { recursive: true });
+    writeFileSync(path.join(ruleDir, `${artifacts.ruleName}.ts`), artifacts.files.rule);
+    writeFileSync(path.join(ruleDir, `${artifacts.ruleName}.md`), artifacts.files.card);
+    writeFileSync(path.join(ruleDir, 'fixtures', 'passing.ts'), artifacts.files.passingFixture);
+    writeFileSync(path.join(ruleDir, 'fixtures', 'failing.ts'), artifacts.files.failingFixture);
+    return ruleDir;
+}
+//# sourceMappingURL=rule-generator.js.map

package/dist/generator/rule-generator.js.map

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

package/dist/generator/server-client-emitters.d.ts

@@ -0,0 +1,17 @@
+import type { ServerClientAnalysis } from '../detector/server-client-detector.js';
+export interface ServerClientRule {
+    name: string;
+    comment: string;
+    severity: 'error' | 'warn' | 'info';
+    from: {
+        path: string;
+    };
+    to: {
+        path: string;
+    };
+}
+export interface ServerClientConfig {
+    forbidden: ServerClientRule[];
+}
+export declare function toDependencyCruiserServerClient(analysis: ServerClientAnalysis): ServerClientConfig;
+//# sourceMappingURL=server-client-emitters.d.ts.map

package/dist/generator/server-client-emitters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-client-emitters.d.ts","sourceRoot":"","sources":["../../src/generator/server-client-emitters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAElF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvB,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,oBAAoB,GAC7B,kBAAkB,CAepB"}

package/dist/generator/server-client-emitters.js

@@ -0,0 +1,18 @@
+export function toDependencyCruiserServerClient(analysis) {
+    if (analysis.clientCount === 0 || analysis.gate.status !== 'AUTO')
+        return { forbidden: [] };
+    const conform = analysis.clientCount - analysis.offenderCount;
+    const floor = `${(analysis.gate.conditions.confidence.value * 100).toFixed(0)}%`;
+    return {
+        forbidden: [
+            {
+                name: 'no-server-only-in-client',
+                comment: `Archprint inferred server/client boundary: ${conform}/${analysis.clientCount} "use client" modules import no server-only code; a client component importing a server-only module is forbidden (confidence ${floor}).`,
+                severity: 'error',
+                from: { path: '\\.(ts|tsx)$' },
+                to: { path: 'node_modules/server-only' },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=server-client-emitters.js.map

package/dist/generator/server-client-emitters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-client-emitters.js","sourceRoot":"","sources":["../../src/generator/server-client-emitters.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,+BAA+B,CAC7C,QAA8B;IAE9B,IAAI,QAAQ,CAAC,WAAW,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC;IAC5F,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,GAAG,QAAQ,CAAC,aAAa,CAAC;IAC9D,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACjF,OAAO;QACL,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,0BAA0B;gBAChC,OAAO,EAAE,8CAA8C,OAAO,IAAI,QAAQ,CAAC,WAAW,gIAAgI,KAAK,IAAI;gBAC/N,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE;gBAC9B,EAAE,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE;aACzC;SACF;KACF,CAAC;AACJ,CAAC"}