@variance-authority/presentation 0.1.0

package/dist/model.d.ts

@@ -0,0 +1,346 @@
+import type { AccessibilitySnapshot, Digest, Rect, SubjectRef } from '@variance-authority/core';
+export type PresentationFindingRule = 'SEPARATION_COLLISION' | 'SPACING_RELATION_COLLISION' | 'SPACING_HIERARCHY_COLLISION' | 'ALIGNMENT_OUTLIER' | 'BASELINE_DRIFT' | 'PROMINENCE_COLLAPSE' | 'SURFACE_COLLISION' | 'REPETITION_GRAMMAR_COLLAPSE' | 'PRESENTATION_GRAMMAR_DRIFT';
+export type PresentationRelationKind = 'contains' | 'separates' | 'aligns' | 'shares-baseline' | 'semantic-peer';
+export interface ElementReference {
+    /** Zero is the subject root; later roots are portal content in capture order. */
+    readonly root: number;
+    /** Child-node indices from that root. Text nodes occupy an index but are not graph nodes. */
+    readonly path: string;
+}
+export interface TypographyEvidence {
+    readonly family?: string;
+    readonly sizePx?: number;
+    readonly weight?: number;
+    readonly style?: string;
+    readonly lineHeightPx?: number;
+    readonly foreground?: string;
+}
+export interface SurfaceEvidence {
+    readonly fill?: string;
+    readonly containingFill?: string;
+    readonly perceptualDifference?: number;
+    readonly borderWidthPx: number;
+    readonly shadow: boolean;
+}
+export interface ProminenceEvidence {
+    /** Relative visual magnitude, not a quality or severity score. */
+    readonly magnitude: number;
+    readonly cluster?: string;
+}
+export interface PresentationNode {
+    readonly id: string;
+    readonly ref: ElementReference;
+    readonly parent?: string;
+    readonly children: readonly string[];
+    readonly tag: string;
+    readonly semanticClass: string;
+    readonly role?: string;
+    readonly name?: string;
+    readonly text?: string;
+    readonly state: Readonly<Record<string, string | boolean | number>>;
+    readonly stateSignature: string;
+    readonly rect: Rect;
+    readonly typography: TypographyEvidence;
+    readonly surface: SurfaceEvidence;
+    readonly prominence: ProminenceEvidence;
+}
+export interface PresentationRelation {
+    readonly id: string;
+    readonly kind: PresentationRelationKind;
+    readonly from: string;
+    readonly to: string;
+    readonly axis?: 'horizontal' | 'vertical' | 'overlap';
+    readonly distancePx?: number;
+    readonly spacingCluster?: string;
+    readonly boundaryStrength?: number;
+    readonly alignment?: 'left' | 'right' | 'horizontal-center' | 'top' | 'bottom' | 'vertical-center';
+}
+export interface SpacingCluster {
+    readonly id: string;
+    readonly centerPx: number;
+    readonly minPx: number;
+    readonly maxPx: number;
+    readonly samples: number;
+}
+export interface AlignmentAxis {
+    readonly id: string;
+    readonly kind: NonNullable<PresentationRelation['alignment']>;
+    readonly coordinate: number;
+    readonly members: readonly string[];
+}
+export type PresentationAlignmentKind = AlignmentAxis['kind'];
+export interface PresentationAlignmentReading {
+    readonly formatVersion: 1;
+    readonly report: Digest;
+    /** The box or composition in which the caller says these nodes form one visual flow. */
+    readonly owner: PresentationNode;
+    readonly kind: PresentationAlignmentKind;
+    readonly coordinatePx: number;
+    readonly spreadPx: number;
+    readonly members: readonly {
+        readonly node: PresentationNode;
+        readonly coordinatePx: number;
+        readonly deviationPx: number;
+    }[];
+    /** Axis and member marks derived from this reading; painting does not acquire the page. */
+    readonly paint: readonly PaintInstruction[];
+}
+export type PresentationSpacingAxis = 'horizontal' | 'vertical';
+export interface PresentationSpacingReading {
+    readonly formatVersion: 1;
+    readonly report: Digest;
+    /** The box or composition whose immediate children own these separations. */
+    readonly owner: PresentationNode;
+    readonly axis: PresentationSpacingAxis;
+    /** Consecutive immediate children in structural order. */
+    readonly members: readonly PresentationNode[];
+    readonly separations: readonly {
+        readonly from: PresentationNode;
+        readonly to: PresentationNode;
+        readonly distancePx: number;
+        readonly boundaryStrength: number;
+        readonly spacingCluster?: string;
+    }[];
+    readonly distance: {
+        readonly minPx: number;
+        readonly medianPx: number;
+        readonly maxPx: number;
+    };
+    readonly boundary: {
+        readonly min: number;
+        readonly median: number;
+        readonly max: number;
+    };
+    /** Boundary marks derived from this reading; painting does not acquire the page. */
+    readonly paint: readonly PaintInstruction[];
+}
+/** Product-owned relationship roles, ordered from the outside of a structure inward. */
+export type PresentationHierarchyRole = 'owner-boundary' | 'leading-to-body' | 'body-peer' | 'content-internal';
+export interface PresentationHierarchyContract {
+    readonly id: string;
+    /** The smallest graph node that contains every declared relationship. */
+    readonly owner: string;
+    readonly axis: PresentationSpacingAxis;
+    /** Ordered outside-in. A role is intent; it is not inferred from a design token. */
+    readonly levels: readonly {
+        readonly role: PresentationHierarchyRole;
+        readonly relations: readonly {
+            readonly from: string;
+            readonly to: string;
+        }[];
+    }[];
+}
+export interface PresentationHierarchyReading {
+    readonly formatVersion: 1;
+    readonly report: Digest;
+    readonly contract: PresentationHierarchyContract;
+    readonly owner: PresentationNode;
+    readonly levels: readonly {
+        readonly role: PresentationHierarchyRole;
+        readonly separations: readonly {
+            readonly from: PresentationNode;
+            readonly to: PresentationNode;
+            readonly distancePx: number;
+            readonly boundaryStrength: number;
+            readonly spacingCluster?: string;
+        }[];
+        readonly distanceMedianPx: number;
+        readonly boundaryMedian: number;
+        readonly spacingClusters: readonly string[];
+    }[];
+    readonly collisions: readonly {
+        readonly outer: PresentationHierarchyRole;
+        readonly inner: PresentationHierarchyRole;
+        readonly outerMedianPx: number;
+        readonly innerMedianPx: number;
+        readonly ratio: number;
+        readonly sharedSpacingClusters: readonly string[];
+    }[];
+    readonly findings: readonly PresentationFinding[];
+    readonly paint: readonly PaintInstruction[];
+}
+export interface BaselineCluster {
+    readonly id: string;
+    readonly coordinate: number;
+    readonly confidence: 'inferred';
+    readonly members: readonly {
+        readonly node: string;
+        readonly deviationPx: number;
+    }[];
+}
+export interface ProminenceCluster {
+    readonly id: string;
+    readonly magnitude: number;
+    readonly members: readonly string[];
+    readonly semanticClasses: readonly string[];
+}
+export interface SurfaceGroup {
+    readonly id: string;
+    readonly fill: string;
+    readonly members: readonly string[];
+}
+export interface PresentationSignature {
+    readonly widthPx: number;
+    readonly heightPx: number;
+    readonly leftPx: number;
+    readonly internalGapPx?: number;
+    readonly boundaryStrength?: number;
+    readonly prominenceCluster?: string;
+    readonly surfaceGroup?: string;
+}
+export interface RepeatedPattern {
+    readonly id: string;
+    readonly parent: string;
+    readonly semanticShape: string;
+    readonly instances: readonly string[];
+    readonly recurringLabels: readonly string[];
+    readonly presentationSimilarity: number;
+    readonly dominant: PresentationSignature;
+    readonly dominantInstances: readonly string[];
+    readonly outliers: readonly {
+        readonly node: string;
+        readonly deviation: number;
+        readonly explainedByState: boolean;
+    }[];
+}
+export interface PresentationFinding {
+    /** Stable within one deterministic report. */
+    readonly id: string;
+    readonly rule: PresentationFindingRule;
+    /** The graph node whose immediate structural relationship produced this finding. */
+    readonly owner: string;
+    readonly nodes: readonly string[];
+    readonly pattern?: string;
+    readonly contract?: string;
+    readonly measurements: Readonly<Record<string, number | string>>;
+}
+export interface PresentationTelemetry {
+    readonly content: {
+        readonly elements: number;
+        readonly characters: number;
+        readonly estimatedLines: number;
+        readonly controls: number;
+        readonly repeatedObjects: number;
+    };
+    readonly dimensions?: {
+        readonly regionWidthPx: number;
+        readonly regionHeightPx: number;
+        readonly viewportWidthPx: number;
+        readonly viewportHeightPx: number;
+        readonly viewportHeights: number;
+    };
+    readonly utilization?: {
+        readonly horizontal: number;
+        readonly occupiedArea: number;
+    };
+    readonly density?: {
+        readonly charactersPer1000Px2: number;
+        readonly linesPerViewport: number;
+        readonly controlsPerViewport: number;
+        readonly repeatedObjectsPerViewport: number;
+    };
+}
+export type PaintLayer = 'semantic' | 'spacing' | 'axes' | 'baselines' | 'surfaces' | 'prominence' | 'repetition' | 'findings';
+export interface PaintInstruction {
+    readonly id: string;
+    /** The graph node that owns the painted relationship. */
+    readonly owner: string;
+    /** Graph nodes touched by this measurement. */
+    readonly nodes: readonly string[];
+    readonly finding?: string;
+    readonly pattern?: string;
+    readonly contract?: string;
+    readonly layer: PaintLayer;
+    readonly shape: 'rect' | 'line' | 'label';
+    readonly color: string;
+    readonly label: string;
+    readonly rect?: Rect;
+    readonly line?: {
+        readonly x1: number;
+        readonly y1: number;
+        readonly x2: number;
+        readonly y2: number;
+    };
+}
+export type PresentationFocusDepth = 'owner' | 'subtree';
+export interface PresentationFocus {
+    readonly formatVersion: 1;
+    readonly report: Digest;
+    readonly depth: PresentationFocusDepth;
+    readonly owner: PresentationNode;
+    /** Owner, immediate children, and owned evidence nodes; or the complete subtree at `subtree` depth. */
+    readonly nodes: readonly PresentationNode[];
+    readonly patterns: readonly RepeatedPattern[];
+    readonly findings: readonly PresentationFinding[];
+    readonly paint: readonly PaintInstruction[];
+    /** Evidence below an owner focus, kept separate rather than folded into its findings. */
+    readonly nested: {
+        readonly owners: number;
+        readonly patterns: number;
+        readonly findings: number;
+    };
+}
+/** One deterministic presentation graph and the evidence derived from its live subject. */
+export interface PresentationReport {
+    readonly formatVersion: 1;
+    readonly digest: Digest;
+    /** Presentation-independent structure, text, DOM-correlated semantics, and state. */
+    readonly contentDigest: Digest;
+    readonly subject: SubjectRef;
+    /**
+     * Font identities the caller established for the capture, as the capture
+     * spells them. Absence means none were established.
+     */
+    readonly fonts?: readonly string[];
+    readonly semantic: {
+        /** An empty array means semantic anchoring ran and found no anchors. */
+        readonly anchors: readonly string[];
+        /** Absence means browser ARIA was not observed; empty or partial roots remain present. */
+        readonly browserAccessibility?: AccessibilitySnapshot;
+    };
+    readonly telemetry: PresentationTelemetry;
+    readonly graph: {
+        readonly nodes: readonly PresentationNode[];
+        readonly relations: readonly PresentationRelation[];
+    };
+    readonly spacing?: readonly SpacingCluster[];
+    readonly axes?: readonly AlignmentAxis[];
+    readonly baselines?: readonly BaselineCluster[];
+    readonly prominence?: readonly ProminenceCluster[];
+    readonly surfaces?: readonly SurfaceGroup[];
+    readonly patterns?: readonly RepeatedPattern[];
+    /** Absence means the capture had no layout evidence; empty means it was measured and clean. */
+    readonly findings?: readonly PresentationFinding[];
+    readonly paint?: readonly PaintInstruction[];
+}
+export interface PresentationComparison {
+    readonly formatVersion: 1;
+    readonly before: Digest;
+    readonly after: Digest;
+    readonly findings?: readonly {
+        readonly rule: PresentationFindingRule;
+        readonly before: number;
+        readonly after: number;
+        readonly delta: number;
+    }[];
+    readonly information: {
+        readonly content: {
+            readonly before: Digest;
+            readonly after: Digest;
+            readonly preserved: boolean;
+        };
+        readonly characters: {
+            readonly before: number;
+            readonly after: number;
+        };
+        readonly elements: {
+            readonly before: number;
+            readonly after: number;
+        };
+        readonly repeatedObjects: {
+            readonly before: number;
+            readonly after: number;
+        };
+    };
+}
+//# sourceMappingURL=model.d.ts.map

package/dist/model.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model.js.map

package/dist/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","sourceRoot":"","sources":["../src/model.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  AccessibilitySnapshot,\n  Digest,\n  Rect,\n  SubjectRef,\n} from '@variance-authority/core';\n\nexport type PresentationFindingRule =\n  | 'SEPARATION_COLLISION'\n  | 'SPACING_RELATION_COLLISION'\n  | 'SPACING_HIERARCHY_COLLISION'\n  | 'ALIGNMENT_OUTLIER'\n  | 'BASELINE_DRIFT'\n  | 'PROMINENCE_COLLAPSE'\n  | 'SURFACE_COLLISION'\n  | 'REPETITION_GRAMMAR_COLLAPSE'\n  | 'PRESENTATION_GRAMMAR_DRIFT';\n\nexport type PresentationRelationKind =\n  | 'contains'\n  | 'separates'\n  | 'aligns'\n  | 'shares-baseline'\n  | 'semantic-peer';\n\nexport interface ElementReference {\n  /** Zero is the subject root; later roots are portal content in capture order. */\n  readonly root: number;\n  /** Child-node indices from that root. Text nodes occupy an index but are not graph nodes. */\n  readonly path: string;\n}\n\nexport interface TypographyEvidence {\n  readonly family?: string;\n  readonly sizePx?: number;\n  readonly weight?: number;\n  readonly style?: string;\n  readonly lineHeightPx?: number;\n  readonly foreground?: string;\n}\n\nexport interface SurfaceEvidence {\n  readonly fill?: string;\n  readonly containingFill?: string;\n  readonly perceptualDifference?: number;\n  readonly borderWidthPx: number;\n  readonly shadow: boolean;\n}\n\nexport interface ProminenceEvidence {\n  /** Relative visual magnitude, not a quality or severity score. */\n  readonly magnitude: number;\n  readonly cluster?: string;\n}\n\nexport interface PresentationNode {\n  readonly id: string;\n  readonly ref: ElementReference;\n  readonly parent?: string;\n  readonly children: readonly string[];\n  readonly tag: string;\n  readonly semanticClass: string;\n  readonly role?: string;\n  readonly name?: string;\n  readonly text?: string;\n  readonly state: Readonly<Record<string, string | boolean | number>>;\n  readonly stateSignature: string;\n  readonly rect: Rect;\n  readonly typography: TypographyEvidence;\n  readonly surface: SurfaceEvidence;\n  readonly prominence: ProminenceEvidence;\n}\n\nexport interface PresentationRelation {\n  readonly id: string;\n  readonly kind: PresentationRelationKind;\n  readonly from: string;\n  readonly to: string;\n  readonly axis?: 'horizontal' | 'vertical' | 'overlap';\n  readonly distancePx?: number;\n  readonly spacingCluster?: string;\n  readonly boundaryStrength?: number;\n  readonly alignment?: 'left' | 'right' | 'horizontal-center' | 'top' | 'bottom' | 'vertical-center';\n}\n\nexport interface SpacingCluster {\n  readonly id: string;\n  readonly centerPx: number;\n  readonly minPx: number;\n  readonly maxPx: number;\n  readonly samples: number;\n}\n\nexport interface AlignmentAxis {\n  readonly id: string;\n  readonly kind: NonNullable<PresentationRelation['alignment']>;\n  readonly coordinate: number;\n  readonly members: readonly string[];\n}\n\nexport type PresentationAlignmentKind = AlignmentAxis['kind'];\n\nexport interface PresentationAlignmentReading {\n  readonly formatVersion: 1;\n  readonly report: Digest;\n  /** The box or composition in which the caller says these nodes form one visual flow. */\n  readonly owner: PresentationNode;\n  readonly kind: PresentationAlignmentKind;\n  readonly coordinatePx: number;\n  readonly spreadPx: number;\n  readonly members: readonly {\n    readonly node: PresentationNode;\n    readonly coordinatePx: number;\n    readonly deviationPx: number;\n  }[];\n  /** Axis and member marks derived from this reading; painting does not acquire the page. */\n  readonly paint: readonly PaintInstruction[];\n}\n\nexport type PresentationSpacingAxis = 'horizontal' | 'vertical';\n\nexport interface PresentationSpacingReading {\n  readonly formatVersion: 1;\n  readonly report: Digest;\n  /** The box or composition whose immediate children own these separations. */\n  readonly owner: PresentationNode;\n  readonly axis: PresentationSpacingAxis;\n  /** Consecutive immediate children in structural order. */\n  readonly members: readonly PresentationNode[];\n  readonly separations: readonly {\n    readonly from: PresentationNode;\n    readonly to: PresentationNode;\n    readonly distancePx: number;\n    readonly boundaryStrength: number;\n    readonly spacingCluster?: string;\n  }[];\n  readonly distance: {\n    readonly minPx: number;\n    readonly medianPx: number;\n    readonly maxPx: number;\n  };\n  readonly boundary: {\n    readonly min: number;\n    readonly median: number;\n    readonly max: number;\n  };\n  /** Boundary marks derived from this reading; painting does not acquire the page. */\n  readonly paint: readonly PaintInstruction[];\n}\n\n/** Product-owned relationship roles, ordered from the outside of a structure inward. */\nexport type PresentationHierarchyRole =\n  | 'owner-boundary'\n  | 'leading-to-body'\n  | 'body-peer'\n  | 'content-internal';\n\nexport interface PresentationHierarchyContract {\n  readonly id: string;\n  /** The smallest graph node that contains every declared relationship. */\n  readonly owner: string;\n  readonly axis: PresentationSpacingAxis;\n  /** Ordered outside-in. A role is intent; it is not inferred from a design token. */\n  readonly levels: readonly {\n    readonly role: PresentationHierarchyRole;\n    readonly relations: readonly {\n      readonly from: string;\n      readonly to: string;\n    }[];\n  }[];\n}\n\nexport interface PresentationHierarchyReading {\n  readonly formatVersion: 1;\n  readonly report: Digest;\n  readonly contract: PresentationHierarchyContract;\n  readonly owner: PresentationNode;\n  readonly levels: readonly {\n    readonly role: PresentationHierarchyRole;\n    readonly separations: readonly {\n      readonly from: PresentationNode;\n      readonly to: PresentationNode;\n      readonly distancePx: number;\n      readonly boundaryStrength: number;\n      readonly spacingCluster?: string;\n    }[];\n    readonly distanceMedianPx: number;\n    readonly boundaryMedian: number;\n    readonly spacingClusters: readonly string[];\n  }[];\n  readonly collisions: readonly {\n    readonly outer: PresentationHierarchyRole;\n    readonly inner: PresentationHierarchyRole;\n    readonly outerMedianPx: number;\n    readonly innerMedianPx: number;\n    readonly ratio: number;\n    readonly sharedSpacingClusters: readonly string[];\n  }[];\n  readonly findings: readonly PresentationFinding[];\n  readonly paint: readonly PaintInstruction[];\n}\n\nexport interface BaselineCluster {\n  readonly id: string;\n  readonly coordinate: number;\n  readonly confidence: 'inferred';\n  readonly members: readonly { readonly node: string; readonly deviationPx: number }[];\n}\n\nexport interface ProminenceCluster {\n  readonly id: string;\n  readonly magnitude: number;\n  readonly members: readonly string[];\n  readonly semanticClasses: readonly string[];\n}\n\nexport interface SurfaceGroup {\n  readonly id: string;\n  readonly fill: string;\n  readonly members: readonly string[];\n}\n\nexport interface PresentationSignature {\n  readonly widthPx: number;\n  readonly heightPx: number;\n  readonly leftPx: number;\n  readonly internalGapPx?: number;\n  readonly boundaryStrength?: number;\n  readonly prominenceCluster?: string;\n  readonly surfaceGroup?: string;\n}\n\nexport interface RepeatedPattern {\n  readonly id: string;\n  readonly parent: string;\n  readonly semanticShape: string;\n  readonly instances: readonly string[];\n  readonly recurringLabels: readonly string[];\n  readonly presentationSimilarity: number;\n  readonly dominant: PresentationSignature;\n  readonly dominantInstances: readonly string[];\n  readonly outliers: readonly {\n    readonly node: string;\n    readonly deviation: number;\n    readonly explainedByState: boolean;\n  }[];\n}\n\nexport interface PresentationFinding {\n  /** Stable within one deterministic report. */\n  readonly id: string;\n  readonly rule: PresentationFindingRule;\n  /** The graph node whose immediate structural relationship produced this finding. */\n  readonly owner: string;\n  readonly nodes: readonly string[];\n  readonly pattern?: string;\n  readonly contract?: string;\n  readonly measurements: Readonly<Record<string, number | string>>;\n}\n\nexport interface PresentationTelemetry {\n  readonly content: {\n    readonly elements: number;\n    readonly characters: number;\n    readonly estimatedLines: number;\n    readonly controls: number;\n    readonly repeatedObjects: number;\n  };\n  readonly dimensions?: {\n    readonly regionWidthPx: number;\n    readonly regionHeightPx: number;\n    readonly viewportWidthPx: number;\n    readonly viewportHeightPx: number;\n    readonly viewportHeights: number;\n  };\n  readonly utilization?: {\n    readonly horizontal: number;\n    readonly occupiedArea: number;\n  };\n  readonly density?: {\n    readonly charactersPer1000Px2: number;\n    readonly linesPerViewport: number;\n    readonly controlsPerViewport: number;\n    readonly repeatedObjectsPerViewport: number;\n  };\n}\n\nexport type PaintLayer =\n  | 'semantic'\n  | 'spacing'\n  | 'axes'\n  | 'baselines'\n  | 'surfaces'\n  | 'prominence'\n  | 'repetition'\n  | 'findings';\n\nexport interface PaintInstruction {\n  readonly id: string;\n  /** The graph node that owns the painted relationship. */\n  readonly owner: string;\n  /** Graph nodes touched by this measurement. */\n  readonly nodes: readonly string[];\n  readonly finding?: string;\n  readonly pattern?: string;\n  readonly contract?: string;\n  readonly layer: PaintLayer;\n  readonly shape: 'rect' | 'line' | 'label';\n  readonly color: string;\n  readonly label: string;\n  readonly rect?: Rect;\n  readonly line?: { readonly x1: number; readonly y1: number; readonly x2: number; readonly y2: number };\n}\n\nexport type PresentationFocusDepth = 'owner' | 'subtree';\n\nexport interface PresentationFocus {\n  readonly formatVersion: 1;\n  readonly report: Digest;\n  readonly depth: PresentationFocusDepth;\n  readonly owner: PresentationNode;\n  /** Owner, immediate children, and owned evidence nodes; or the complete subtree at `subtree` depth. */\n  readonly nodes: readonly PresentationNode[];\n  readonly patterns: readonly RepeatedPattern[];\n  readonly findings: readonly PresentationFinding[];\n  readonly paint: readonly PaintInstruction[];\n  /** Evidence below an owner focus, kept separate rather than folded into its findings. */\n  readonly nested: {\n    readonly owners: number;\n    readonly patterns: number;\n    readonly findings: number;\n  };\n}\n\n/** One deterministic presentation graph and the evidence derived from its live subject. */\nexport interface PresentationReport {\n  readonly formatVersion: 1;\n  readonly digest: Digest;\n  /** Presentation-independent structure, text, DOM-correlated semantics, and state. */\n  readonly contentDigest: Digest;\n  readonly subject: SubjectRef;\n  /**\n   * Font identities the caller established for the capture, as the capture\n   * spells them. Absence means none were established.\n   */\n  readonly fonts?: readonly string[];\n  readonly semantic: {\n    /** An empty array means semantic anchoring ran and found no anchors. */\n    readonly anchors: readonly string[];\n    /** Absence means browser ARIA was not observed; empty or partial roots remain present. */\n    readonly browserAccessibility?: AccessibilitySnapshot;\n  };\n  readonly telemetry: PresentationTelemetry;\n  readonly graph: {\n    readonly nodes: readonly PresentationNode[];\n    readonly relations: readonly PresentationRelation[];\n  };\n  readonly spacing?: readonly SpacingCluster[];\n  readonly axes?: readonly AlignmentAxis[];\n  readonly baselines?: readonly BaselineCluster[];\n  readonly prominence?: readonly ProminenceCluster[];\n  readonly surfaces?: readonly SurfaceGroup[];\n  readonly patterns?: readonly RepeatedPattern[];\n  /** Absence means the capture had no layout evidence; empty means it was measured and clean. */\n  readonly findings?: readonly PresentationFinding[];\n  readonly paint?: readonly PaintInstruction[];\n}\n\nexport interface PresentationComparison {\n  readonly formatVersion: 1;\n  readonly before: Digest;\n  readonly after: Digest;\n  readonly findings?: readonly {\n    readonly rule: PresentationFindingRule;\n    readonly before: number;\n    readonly after: number;\n    readonly delta: number;\n  }[];\n  readonly information: {\n    readonly content: {\n      readonly before: Digest;\n      readonly after: Digest;\n      readonly preserved: boolean;\n    };\n    readonly characters: { readonly before: number; readonly after: number };\n    readonly elements: { readonly before: number; readonly after: number };\n    readonly repeatedObjects: { readonly before: number; readonly after: number };\n  };\n}\n"]}

package/dist/paint.d.ts

@@ -0,0 +1,12 @@
+import type { AlignmentAxis, BaselineCluster, PaintInstruction, PresentationFinding, PresentationNode, PresentationRelation, ProminenceCluster, RepeatedPattern, SurfaceGroup } from './model.js';
+export declare function paintInstructions(input: {
+    readonly nodes: readonly PresentationNode[];
+    readonly relations: readonly PresentationRelation[];
+    readonly axes: readonly AlignmentAxis[];
+    readonly baselines: readonly BaselineCluster[];
+    readonly prominence: readonly ProminenceCluster[];
+    readonly surfaces: readonly SurfaceGroup[];
+    readonly patterns: readonly RepeatedPattern[];
+    readonly findings: readonly PresentationFinding[];
+}): PaintInstruction[];
+//# sourceMappingURL=paint.d.ts.map

package/dist/paint.js

@@ -0,0 +1,192 @@
+import { center } from './graph.js';
+const COLORS = ['#00d4ff', '#ff2bd6', '#ffe600', '#70ff70', '#ff6b35', '#a78bfa'];
+export function paintInstructions(input) {
+    const byId = new Map(input.nodes.map((node) => [node.id, node]));
+    const instructions = [];
+    for (const node of input.nodes) {
+        instructions.push({
+            id: `semantic:${node.id}`,
+            owner: node.parent ?? node.id,
+            nodes: [node.id],
+            layer: 'semantic',
+            shape: 'rect',
+            color: COLORS[0],
+            label: `${node.semanticClass} ${node.name ?? node.text ?? ''}`.trim(),
+            rect: node.rect,
+        });
+    }
+    for (const relation of input.relations.filter((candidate) => candidate.kind === 'separates')) {
+        const from = byId.get(relation.from);
+        const to = byId.get(relation.to);
+        if (from === undefined || to === undefined)
+            continue;
+        const [x1, y1] = center(from.rect);
+        const [x2, y2] = center(to.rect);
+        instructions.push({
+            id: `spacing:${relation.id}`,
+            owner: commonOwner([relation.from, relation.to], byId) ?? relation.from,
+            nodes: [relation.from, relation.to],
+            layer: 'spacing',
+            shape: 'line',
+            color: COLORS[2],
+            label: `${relation.spacingCluster ?? 'gap'} ${relation.distancePx ?? 0}px`,
+            line: { x1, y1, x2, y2 },
+        });
+    }
+    for (const axis of input.axes) {
+        const members = axis.members.flatMap((id) => byId.get(id) ?? []);
+        if (members.length === 0)
+            continue;
+        const vertical = ['left', 'right', 'horizontal-center'].includes(axis.kind);
+        instructions.push({
+            id: `axis:${axis.id}`,
+            owner: commonOwner(axis.members, byId) ?? firstMember(members),
+            nodes: axis.members,
+            layer: 'axes',
+            shape: 'line',
+            color: COLORS[3],
+            label: `${axis.id} ${axis.coordinate}px`,
+            line: vertical
+                ? {
+                    x1: axis.coordinate,
+                    y1: Math.min(...members.map((node) => node.rect.y)),
+                    x2: axis.coordinate,
+                    y2: Math.max(...members.map((node) => node.rect.y + node.rect.height)),
+                }
+                : {
+                    x1: Math.min(...members.map((node) => node.rect.x)),
+                    y1: axis.coordinate,
+                    x2: Math.max(...members.map((node) => node.rect.x + node.rect.width)),
+                    y2: axis.coordinate,
+                },
+        });
+    }
+    for (const baseline of input.baselines) {
+        const members = baseline.members.flatMap((member) => byId.get(member.node) ?? []);
+        if (members.length === 0)
+            continue;
+        instructions.push({
+            id: `baseline:${baseline.id}`,
+            owner: commonOwner(baseline.members.map((member) => member.node), byId) ?? firstMember(members),
+            nodes: baseline.members.map((member) => member.node),
+            layer: 'baselines',
+            shape: 'line',
+            color: COLORS[4],
+            label: `${baseline.id} inferred`,
+            line: {
+                x1: Math.min(...members.map((node) => node.rect.x)),
+                y1: baseline.coordinate,
+                x2: Math.max(...members.map((node) => node.rect.x + node.rect.width)),
+                y2: baseline.coordinate,
+            },
+        });
+    }
+    groupedRects(input.surfaces, 'surfaces', input.nodes, instructions);
+    groupedRects(input.prominence, 'prominence', input.nodes, instructions);
+    input.patterns.forEach((pattern, index) => {
+        for (const id of pattern.instances) {
+            const node = byId.get(id);
+            if (node === undefined)
+                continue;
+            instructions.push({
+                id: `pattern:${pattern.id}:${id}`,
+                owner: pattern.parent,
+                nodes: [id],
+                pattern: pattern.id,
+                layer: 'repetition',
+                shape: 'rect',
+                color: COLORS[index % COLORS.length],
+                label: `${pattern.id} #${pattern.instances.indexOf(id) + 1}`,
+                rect: node.rect,
+            });
+        }
+    });
+    for (const finding of input.findings) {
+        if (finding.rule === 'SPACING_HIERARCHY_COLLISION') {
+            for (const instanceId of finding.nodes) {
+                const instance = byId.get(instanceId);
+                const members = instance?.children.slice(0, 3).flatMap((id) => byId.get(id) ?? []) ?? [];
+                if (members.length !== 3)
+                    continue;
+                for (let index = 0; index < 2; index += 1) {
+                    const from = members[index];
+                    const to = members[index + 1];
+                    const relation = input.relations.find((candidate) => candidate.kind === 'separates' && candidate.from === from.id && candidate.to === to.id);
+                    const [x1, y1] = center(from.rect);
+                    const [x2, y2] = center(to.rect);
+                    instructions.push({
+                        id: `finding:${finding.id}:${from.id}:${to.id}`,
+                        owner: finding.owner,
+                        nodes: [from.id, to.id],
+                        finding: finding.id,
+                        ...(finding.pattern === undefined ? {} : { pattern: finding.pattern }),
+                        layer: 'findings',
+                        shape: 'line',
+                        color: '#ff1744',
+                        label: `${index === 0 ? 'leading→body' : 'body→body'} ${relation?.distancePx ?? 0}px`,
+                        line: { x1, y1, x2, y2 },
+                    });
+                }
+            }
+            continue;
+        }
+        for (const id of finding.nodes) {
+            const node = byId.get(id);
+            if (node === undefined)
+                continue;
+            instructions.push({
+                id: `finding:${finding.id}:${id}`,
+                owner: finding.owner,
+                nodes: [id],
+                finding: finding.id,
+                ...(finding.pattern === undefined ? {} : { pattern: finding.pattern }),
+                layer: 'findings',
+                shape: 'rect',
+                color: '#ff1744',
+                label: finding.rule,
+                rect: node.rect,
+            });
+        }
+    }
+    return instructions;
+}
+function groupedRects(groups, layer, nodes, sink) {
+    const byId = new Map(nodes.map((node) => [node.id, node]));
+    groups.forEach((group, index) => {
+        for (const member of group.members) {
+            const node = byId.get(member);
+            if (node === undefined)
+                continue;
+            sink.push({
+                id: `${layer}:${group.id}:${member}`,
+                owner: node.parent ?? node.id,
+                nodes: [member],
+                layer,
+                shape: 'rect',
+                color: COLORS[index % COLORS.length],
+                label: group.id,
+                rect: node.rect,
+            });
+        }
+    });
+}
+function firstMember(nodes) {
+    return nodes[0]?.parent ?? nodes[0]?.id ?? 'presentation';
+}
+function commonOwner(ids, byId) {
+    const chains = ids.map((id) => ancestorChain(id, byId));
+    const first = chains[0];
+    if (first === undefined)
+        return undefined;
+    return first.find((candidate) => chains.every((chain) => chain.includes(candidate)));
+}
+function ancestorChain(id, byId) {
+    const chain = [];
+    let current = byId.get(id)?.parent;
+    while (current !== undefined) {
+        chain.push(current);
+        current = byId.get(current)?.parent;
+    }
+    return chain;
+}
+//# sourceMappingURL=paint.js.map

package/dist/paint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint.js","sourceRoot":"","sources":["../src/paint.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AlignmentAxis,\n  BaselineCluster,\n  PaintInstruction,\n  PresentationFinding,\n  PresentationNode,\n  PresentationRelation,\n  ProminenceCluster,\n  RepeatedPattern,\n  SurfaceGroup,\n} from './model.js';\nimport { center } from './graph.js';\n\nconst COLORS = ['#00d4ff', '#ff2bd6', '#ffe600', '#70ff70', '#ff6b35', '#a78bfa'];\n\nexport function paintInstructions(input: {\n  readonly nodes: readonly PresentationNode[];\n  readonly relations: readonly PresentationRelation[];\n  readonly axes: readonly AlignmentAxis[];\n  readonly baselines: readonly BaselineCluster[];\n  readonly prominence: readonly ProminenceCluster[];\n  readonly surfaces: readonly SurfaceGroup[];\n  readonly patterns: readonly RepeatedPattern[];\n  readonly findings: readonly PresentationFinding[];\n}): PaintInstruction[] {\n  const byId = new Map(input.nodes.map((node) => [node.id, node]));\n  const instructions: PaintInstruction[] = [];\n  for (const node of input.nodes) {\n    instructions.push({\n      id: `semantic:${node.id}`,\n      owner: node.parent ?? node.id,\n      nodes: [node.id],\n      layer: 'semantic',\n      shape: 'rect',\n      color: COLORS[0]!,\n      label: `${node.semanticClass} ${node.name ?? node.text ?? ''}`.trim(),\n      rect: node.rect,\n    });\n  }\n  for (const relation of input.relations.filter((candidate) => candidate.kind === 'separates')) {\n    const from = byId.get(relation.from);\n    const to = byId.get(relation.to);\n    if (from === undefined || to === undefined) continue;\n    const [x1, y1] = center(from.rect);\n    const [x2, y2] = center(to.rect);\n    instructions.push({\n      id: `spacing:${relation.id}`,\n      owner: commonOwner([relation.from, relation.to], byId) ?? relation.from,\n      nodes: [relation.from, relation.to],\n      layer: 'spacing',\n      shape: 'line',\n      color: COLORS[2]!,\n      label: `${relation.spacingCluster ?? 'gap'} ${relation.distancePx ?? 0}px`,\n      line: { x1, y1, x2, y2 },\n    });\n  }\n  for (const axis of input.axes) {\n    const members = axis.members.flatMap((id) => byId.get(id) ?? []);\n    if (members.length === 0) continue;\n    const vertical = ['left', 'right', 'horizontal-center'].includes(axis.kind);\n    instructions.push({\n      id: `axis:${axis.id}`,\n      owner: commonOwner(axis.members, byId) ?? firstMember(members),\n      nodes: axis.members,\n      layer: 'axes',\n      shape: 'line',\n      color: COLORS[3]!,\n      label: `${axis.id} ${axis.coordinate}px`,\n      line: vertical\n        ? {\n            x1: axis.coordinate,\n            y1: Math.min(...members.map((node) => node.rect.y)),\n            x2: axis.coordinate,\n            y2: Math.max(...members.map((node) => node.rect.y + node.rect.height)),\n          }\n        : {\n            x1: Math.min(...members.map((node) => node.rect.x)),\n            y1: axis.coordinate,\n            x2: Math.max(...members.map((node) => node.rect.x + node.rect.width)),\n            y2: axis.coordinate,\n          },\n    });\n  }\n  for (const baseline of input.baselines) {\n    const members = baseline.members.flatMap((member) => byId.get(member.node) ?? []);\n    if (members.length === 0) continue;\n    instructions.push({\n      id: `baseline:${baseline.id}`,\n      owner: commonOwner(baseline.members.map((member) => member.node), byId) ?? firstMember(members),\n      nodes: baseline.members.map((member) => member.node),\n      layer: 'baselines',\n      shape: 'line',\n      color: COLORS[4]!,\n      label: `${baseline.id} inferred`,\n      line: {\n        x1: Math.min(...members.map((node) => node.rect.x)),\n        y1: baseline.coordinate,\n        x2: Math.max(...members.map((node) => node.rect.x + node.rect.width)),\n        y2: baseline.coordinate,\n      },\n    });\n  }\n  groupedRects(input.surfaces, 'surfaces', input.nodes, instructions);\n  groupedRects(input.prominence, 'prominence', input.nodes, instructions);\n  input.patterns.forEach((pattern, index) => {\n    for (const id of pattern.instances) {\n      const node = byId.get(id);\n      if (node === undefined) continue;\n      instructions.push({\n        id: `pattern:${pattern.id}:${id}`,\n        owner: pattern.parent,\n        nodes: [id],\n        pattern: pattern.id,\n        layer: 'repetition',\n        shape: 'rect',\n        color: COLORS[index % COLORS.length]!,\n        label: `${pattern.id} #${pattern.instances.indexOf(id) + 1}`,\n        rect: node.rect,\n      });\n    }\n  });\n  for (const finding of input.findings) {\n    if (finding.rule === 'SPACING_HIERARCHY_COLLISION') {\n      for (const instanceId of finding.nodes) {\n        const instance = byId.get(instanceId);\n        const members = instance?.children.slice(0, 3).flatMap((id) => byId.get(id) ?? []) ?? [];\n        if (members.length !== 3) continue;\n        for (let index = 0; index < 2; index += 1) {\n          const from = members[index]!;\n          const to = members[index + 1]!;\n          const relation = input.relations.find((candidate) =>\n            candidate.kind === 'separates' && candidate.from === from.id && candidate.to === to.id);\n          const [x1, y1] = center(from.rect);\n          const [x2, y2] = center(to.rect);\n          instructions.push({\n            id: `finding:${finding.id}:${from.id}:${to.id}`,\n            owner: finding.owner,\n            nodes: [from.id, to.id],\n            finding: finding.id,\n            ...(finding.pattern === undefined ? {} : { pattern: finding.pattern }),\n            layer: 'findings',\n            shape: 'line',\n            color: '#ff1744',\n            label: `${index === 0 ? 'leading→body' : 'body→body'} ${relation?.distancePx ?? 0}px`,\n            line: { x1, y1, x2, y2 },\n          });\n        }\n      }\n      continue;\n    }\n    for (const id of finding.nodes) {\n      const node = byId.get(id);\n      if (node === undefined) continue;\n      instructions.push({\n        id: `finding:${finding.id}:${id}`,\n        owner: finding.owner,\n        nodes: [id],\n        finding: finding.id,\n        ...(finding.pattern === undefined ? {} : { pattern: finding.pattern }),\n        layer: 'findings',\n        shape: 'rect',\n        color: '#ff1744',\n        label: finding.rule,\n        rect: node.rect,\n      });\n    }\n  }\n  return instructions;\n}\n\nfunction groupedRects(\n  groups: readonly { readonly id: string; readonly members: readonly string[] }[],\n  layer: 'surfaces' | 'prominence',\n  nodes: readonly PresentationNode[],\n  sink: PaintInstruction[],\n): void {\n  const byId = new Map(nodes.map((node) => [node.id, node]));\n  groups.forEach((group, index) => {\n    for (const member of group.members) {\n      const node = byId.get(member);\n      if (node === undefined) continue;\n      sink.push({\n        id: `${layer}:${group.id}:${member}`,\n        owner: node.parent ?? node.id,\n        nodes: [member],\n        layer,\n        shape: 'rect',\n        color: COLORS[index % COLORS.length]!,\n        label: group.id,\n        rect: node.rect,\n      });\n    }\n  });\n}\n\nfunction firstMember(nodes: readonly PresentationNode[]): string {\n  return nodes[0]?.parent ?? nodes[0]?.id ?? 'presentation';\n}\n\nfunction commonOwner(\n  ids: readonly string[],\n  byId: ReadonlyMap<string, PresentationNode>,\n): string | undefined {\n  const chains = ids.map((id) => ancestorChain(id, byId));\n  const first = chains[0];\n  if (first === undefined) return undefined;\n  return first.find((candidate) => chains.every((chain) => chain.includes(candidate)));\n}\n\nfunction ancestorChain(id: string, byId: ReadonlyMap<string, PresentationNode>): string[] {\n  const chain: string[] = [];\n  let current = byId.get(id)?.parent;\n  while (current !== undefined) {\n    chain.push(current);\n    current = byId.get(current)?.parent;\n  }\n  return chain;\n}\n"]}

package/dist/patterns.d.ts

@@ -0,0 +1,10 @@
+import type { BuiltGraph } from './graph.js';
+import type { Measurements } from './measure.js';
+import type { PresentationNode, PresentationRelation, RepeatedPattern } from './model.js';
+export interface PatternResult {
+    readonly patterns: RepeatedPattern[];
+    readonly peerRelations: PresentationRelation[];
+}
+export declare function inferPatterns(graph: BuiltGraph, measured: Measurements): PatternResult;
+export declare function descendants(node: PresentationNode, graph: BuiltGraph): PresentationNode[];
+//# sourceMappingURL=patterns.d.ts.map