@variance-authority/presentation 0.1.0

package/dist/findings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.js","sourceRoot":"","sources":["../src/findings.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BuiltGraph } from './graph.js';\nimport type { Measurements } from './measure.js';\nimport type {\n  PresentationFinding,\n  PresentationNode,\n  RepeatedPattern,\n} from './model.js';\nimport { codeUnitCompare, median, round } from './math.js';\n\ntype DetectedFinding = Omit<PresentationFinding, 'id'>;\n\n/** Thresholds are pinned by the acceptance fixtures, never user-facing targets. */\nconst CALIBRATION = {\n  relationshipRatio: 1.15,\n  weakBoundary: 0.28,\n  surfaceDelta: 8,\n  axisDeviationPx: 2,\n  baselineDeviationPx: 2,\n} as const;\n\nexport function detectFindings(\n  graph: BuiltGraph,\n  measured: Measurements,\n  patterns: readonly RepeatedPattern[],\n): PresentationFinding[] {\n  const findings: DetectedFinding[] = [];\n  for (const pattern of patterns) {\n    findings.push(...relationshipFindings(pattern, measured));\n    findings.push(...hierarchySpacingFindings(pattern, measured));\n    findings.push(...slotFindings(pattern, graph));\n    const unexplained = pattern.outliers.filter((outlier) => !outlier.explainedByState);\n    if (\n      pattern.instances.length >= 3 &&\n      pattern.dominantInstances.length * 2 >= pattern.instances.length &&\n      unexplained.length > 0\n    ) {\n      findings.push({\n        rule: 'PRESENTATION_GRAMMAR_DRIFT',\n        owner: pattern.parent,\n        nodes: unexplained.map((outlier) => outlier.node),\n        pattern: pattern.id,\n        measurements: {\n          dominantInstances: pattern.dominantInstances.length,\n          peerInstances: pattern.instances.length,\n          maxDeviation: round(Math.max(...unexplained.map((outlier) => outlier.deviation))),\n        },\n      });\n    }\n  }\n  findings.push(...surfaceFindings(measured.nodes));\n  findings.push(...prominenceFindings(measured));\n  return findings.sort((left, right) =>\n    codeUnitCompare(left.rule, right.rule) ||\n    codeUnitCompare(left.owner, right.owner) ||\n    codeUnitCompare(left.nodes.join('\\0'), right.nodes.join('\\0')) ||\n    codeUnitCompare(left.pattern ?? '', right.pattern ?? ''),\n  ).map((finding, index) => ({ id: `F${index + 1}`, ...finding }));\n}\n\n/** A leading structural label and the body peers it introduces need distinct spacing relations. */\nfunction hierarchySpacingFindings(\n  pattern: RepeatedPattern,\n  measured: Measurements,\n): DetectedFinding[] {\n  const byId = new Map(measured.nodes.map((node) => [node.id, node]));\n  const separations = new Map(measured.relations\n    .filter((relation) => relation.kind === 'separates')\n    .map((relation) => [`${relation.from}\\0${relation.to}`, relation]));\n  const collisions = pattern.instances.flatMap((instanceId) => {\n    const instance = byId.get(instanceId);\n    if (instance === undefined || instance.children.length < 3) return [];\n    const leader = byId.get(instance.children[0]!);\n    const body = instance.children.slice(1).map((id) => byId.get(id));\n    if (leader === undefined || body.some((node) => node === undefined)) return [];\n    const bodyNodes = body as PresentationNode[];\n    if (\n      bodyNodes.length < 2 ||\n      bodyNodes.some((node) => node.semanticClass !== bodyNodes[0]!.semanticClass) ||\n      leader.semanticClass === bodyNodes[0]!.semanticClass\n    ) return [];\n    const leading = separations.get(`${leader.id}\\0${bodyNodes[0]!.id}`);\n    const peer = bodyNodes.slice(0, -1).flatMap((node, index) =>\n      separations.get(`${node.id}\\0${bodyNodes[index + 1]!.id}`) ?? []);\n    const leadingGap = leading?.distancePx;\n    const peerGap = median(peer.flatMap((relation) => relation.distancePx ?? []));\n    if (leadingGap === undefined || peerGap === undefined) return [];\n    const leadingClusters = new Set(leading?.spacingCluster === undefined ? [] : [leading.spacingCluster]);\n    const peerClusters = new Set(peer.flatMap((relation) => relation.spacingCluster ?? []));\n    const sharedCluster = [...leadingClusters].some((cluster) => peerClusters.has(cluster));\n    const smaller = Math.min(leadingGap, peerGap);\n    const larger = Math.max(leadingGap, peerGap);\n    const ratio = smaller === 0 ? (larger === 0 ? 1 : Number.POSITIVE_INFINITY) : larger / smaller;\n    if (!sharedCluster && ratio > CALIBRATION.relationshipRatio) return [];\n    return [{\n      instance: instance.id,\n      leader: leader.id,\n      body: bodyNodes.map((node) => node.id),\n      leadingGap,\n      peerGap,\n      ratio,\n      sharedCluster,\n    }];\n  });\n  if (collisions.length < 2) return [];\n  return [{\n    rule: 'SPACING_HIERARCHY_COLLISION',\n    owner: pattern.parent,\n    nodes: collisions.map((collision) => collision.instance),\n    pattern: pattern.id,\n    measurements: {\n      instances: collisions.length,\n      leadingToBodyGapMedianPx: round(median(collisions.map((collision) => collision.leadingGap))!, 2),\n      bodyToBodyGapMedianPx: round(median(collisions.map((collision) => collision.peerGap))!, 2),\n      ratio: round(median(collisions.map((collision) => collision.ratio))!),\n      sharedSpacingClusterInstances: collisions.filter((collision) => collision.sharedCluster).length,\n    },\n  }];\n}\n\nfunction relationshipFindings(\n  pattern: RepeatedPattern,\n  measured: Measurements,\n): DetectedFinding[] {\n  const members = new Set(pattern.instances);\n  const between = measured.relations.filter(\n    (relation) => relation.kind === 'separates' && members.has(relation.from) && members.has(relation.to),\n  );\n  const within = pattern.instances.flatMap((instance) => {\n    const node = measured.nodes.find((candidate) => candidate.id === instance);\n    if (node === undefined) return [];\n    const children = new Set(node.children);\n    return measured.relations.filter(\n      (relation) => relation.kind === 'separates' && children.has(relation.from) && children.has(relation.to),\n    );\n  });\n  const betweenBoundary = median(between.flatMap((relation) => relation.boundaryStrength ?? []));\n  const withinBoundary = median(within.flatMap((relation) => relation.boundaryStrength ?? []));\n  const betweenGap = median(between.flatMap((relation) => relation.distancePx ?? []));\n  const withinGap = median(within.flatMap((relation) => relation.distancePx ?? []));\n  const results: DetectedFinding[] = [];\n  if (betweenBoundary !== undefined && withinBoundary !== undefined) {\n    const ratio = withinBoundary === 0 ? (betweenBoundary === 0 ? 1 : Number.POSITIVE_INFINITY) : betweenBoundary / withinBoundary;\n    if (ratio <= CALIBRATION.relationshipRatio) {\n      results.push({\n        rule: 'SEPARATION_COLLISION',\n        owner: pattern.parent,\n        nodes: pattern.instances,\n        pattern: pattern.id,\n        measurements: {\n          withinBoundaryMedian: round(withinBoundary),\n          betweenBoundaryMedian: round(betweenBoundary),\n          ratio: round(ratio),\n        },\n      });\n    }\n    if (pattern.instances.length >= 3 && betweenBoundary <= CALIBRATION.weakBoundary) {\n      results.push({\n        rule: 'REPETITION_GRAMMAR_COLLAPSE',\n        owner: pattern.parent,\n        nodes: pattern.instances,\n        pattern: pattern.id,\n        measurements: {\n          instances: pattern.instances.length,\n          betweenBoundaryMedian: round(betweenBoundary),\n          presentationSimilarity: pattern.presentationSimilarity,\n        },\n      });\n    }\n  }\n  if (betweenGap !== undefined && withinGap !== undefined) {\n    const ratio = withinGap === 0 ? (betweenGap === 0 ? 1 : Number.POSITIVE_INFINITY) : betweenGap / withinGap;\n    const betweenClusters = new Set(between.flatMap((relation) => relation.spacingCluster ?? []));\n    const withinClusters = new Set(within.flatMap((relation) => relation.spacingCluster ?? []));\n    const overlap = [...betweenClusters].some((cluster) => withinClusters.has(cluster));\n    if (overlap || ratio <= CALIBRATION.relationshipRatio) {\n      results.push({\n        rule: 'SPACING_RELATION_COLLISION',\n        owner: pattern.parent,\n        nodes: pattern.instances,\n        pattern: pattern.id,\n        measurements: {\n          withinGapMedianPx: round(withinGap, 2),\n          betweenGapMedianPx: round(betweenGap, 2),\n          ratio: round(ratio),\n        },\n      });\n    }\n  }\n  return results;\n}\n\nfunction slotFindings(pattern: RepeatedPattern, graph: BuiltGraph): DetectedFinding[] {\n  if (pattern.instances.length < 4) return [];\n  const slots = new Map<string, Array<{ readonly node: PresentationNode; readonly instance: PresentationNode }>>();\n  for (const instanceId of pattern.instances) {\n    const instance = graph.byId.get(instanceId);\n    if (instance === undefined) continue;\n    const occurrence = new Map<string, number>();\n    for (const childId of instance.children) {\n      const child = graph.byId.get(childId);\n      if (child === undefined) continue;\n      const count = occurrence.get(child.semanticClass) ?? 0;\n      occurrence.set(child.semanticClass, count + 1);\n      const key = `${child.semanticClass}:${count}`;\n      const members = slots.get(key) ?? [];\n      members.push({ node: child, instance });\n      slots.set(key, members);\n    }\n  }\n  const findings: DetectedFinding[] = [];\n  for (const [slot, members] of slots) {\n    if (members.length !== pattern.instances.length) continue;\n    const left = median(members.map((member) => member.node.rect.x))!;\n    const aligned = members.filter((member) => Math.abs(member.node.rect.x - left) <= 1);\n    const alignmentOutliers = members.filter(\n      (member) => Math.abs(member.node.rect.x - left) > CALIBRATION.axisDeviationPx,\n    );\n    if (aligned.length * 3 >= members.length * 2 && alignmentOutliers.length > 0) {\n      findings.push({\n        rule: 'ALIGNMENT_OUTLIER',\n        owner: pattern.parent,\n        nodes: alignmentOutliers.map((member) => member.node.id),\n        pattern: pattern.id,\n        measurements: {\n          slot,\n          dominantLeftPx: round(left, 2),\n          maxDeviationPx: round(Math.max(...alignmentOutliers.map((member) => Math.abs(member.node.rect.x - left))), 2),\n        },\n      });\n    }\n\n    const baselines = members.flatMap(({ node, instance }) => {\n      const size = node.typography.sizePx;\n      const lineHeight = node.typography.lineHeightPx;\n      if (size === undefined || lineHeight === undefined || (node.text === undefined && node.name === undefined)) return [];\n      return [{\n        node,\n        coordinate:\n          node.rect.y - instance.rect.y + Math.max(0, (node.rect.height - lineHeight) / 2) + size * 0.8,\n      }];\n    });\n    if (baselines.length !== members.length) continue;\n    const baseline = median(baselines.map((candidate) => candidate.coordinate))!;\n    const baselineAligned = baselines.filter((candidate) => Math.abs(candidate.coordinate - baseline) <= 1);\n    const baselineOutliers = baselines.filter(\n      (candidate) => Math.abs(candidate.coordinate - baseline) > CALIBRATION.baselineDeviationPx,\n    );\n    if (baselineAligned.length * 3 >= baselines.length * 2 && baselineOutliers.length > 0) {\n      findings.push({\n        rule: 'BASELINE_DRIFT',\n        owner: pattern.parent,\n        nodes: baselineOutliers.map((candidate) => candidate.node.id),\n        pattern: pattern.id,\n        measurements: {\n          slot,\n          dominantBaselinePx: round(baseline, 2),\n          maxDeviationPx: round(Math.max(...baselineOutliers.map((candidate) => Math.abs(candidate.coordinate - baseline))), 2),\n          confidence: 'inferred',\n        },\n      });\n    }\n  }\n  return findings;\n}\n\nfunction surfaceFindings(nodes: readonly PresentationNode[]): DetectedFinding[] {\n  const surfaceTags = new Set(['button', 'input', 'select', 'textarea', 'article', 'section', 'aside', 'dialog']);\n  return nodes.flatMap((node) => {\n    const difference = node.surface.perceptualDifference;\n    const meaningful = node.role !== undefined || surfaceTags.has(node.tag);\n    if (\n      node.parent === undefined ||\n      !meaningful ||\n      node.surface.fill === undefined ||\n      difference === undefined ||\n      difference >= CALIBRATION.surfaceDelta ||\n      node.surface.borderWidthPx > 0 ||\n      node.surface.shadow\n    ) return [];\n    return [{\n      rule: 'SURFACE_COLLISION' as const,\n      owner: node.parent,\n      nodes: [node.id],\n      measurements: {\n        perceptualDifference: difference,\n        borderWidthPx: node.surface.borderWidthPx,\n        shadow: node.surface.shadow ? 1 : 0,\n      },\n    }];\n  });\n}\n\nfunction prominenceFindings(measured: Measurements): DetectedFinding[] {\n  const byId = new Map(measured.nodes.map((node) => [node.id, node]));\n  return measured.nodes.flatMap((owner) => measured.prominence.flatMap((cluster) => {\n    const members = owner.children.flatMap((id) => {\n      const node = byId.get(id);\n      return node !== undefined && node.prominence.cluster === cluster.id ? [node] : [];\n    });\n    const headings = members.filter((node) => node.semanticClass.startsWith('heading'));\n    const ordinary = members.filter((node) =>\n      ['label', 'paragraph', 'text', 'generic', 'span'].includes(node.semanticClass),\n    );\n    if (headings.length === 0 || ordinary.length === 0) return [];\n    return [{\n      rule: 'PROMINENCE_COLLAPSE' as const,\n      owner: owner.id,\n      nodes: [...headings, ...ordinary].map((node) => node.id),\n      measurements: {\n        prominenceCluster: cluster.id,\n        semanticClasses: [...new Set([...headings, ...ordinary].map((node) => node.semanticClass))].join(','),\n        magnitude: cluster.magnitude,\n      },\n    }];\n  }));\n}\n"]}

package/dist/focus.d.ts

@@ -0,0 +1,17 @@
+import type { PaintLayer, PresentationFocus, PresentationFocusDepth, PresentationReport } from './model.js';
+export interface FocusPresentationOptions {
+    /** `owner` keeps nested boxes separate; `subtree` reads the composition holistically. */
+    readonly depth?: PresentationFocusDepth;
+    /** Omit to retain every paint layer owned by the selected structural depth. */
+    readonly paint?: readonly PaintLayer[];
+    /** Omit to read every owned finding; provide ids to isolate one or more questions. */
+    readonly findings?: readonly string[];
+}
+/**
+ * Read one structural level from an existing report without acquiring the page again.
+ *
+ * An owner focus contains only relationships owned by that node. Nested evidence is
+ * counted but not folded into the result. A subtree focus deliberately includes it.
+ */
+export declare function focusPresentation(report: PresentationReport, ownerId: string, options?: FocusPresentationOptions): PresentationFocus;
+//# sourceMappingURL=focus.d.ts.map

package/dist/focus.js

@@ -0,0 +1,84 @@
+/**
+ * Read one structural level from an existing report without acquiring the page again.
+ *
+ * An owner focus contains only relationships owned by that node. Nested evidence is
+ * counted but not folded into the result. A subtree focus deliberately includes it.
+ */
+export function focusPresentation(report, ownerId, options = {}) {
+    const byId = new Map(report.graph.nodes.map((node) => [node.id, node]));
+    const owner = byId.get(ownerId);
+    if (owner === undefined)
+        throw new Error(`presentation owner ${ownerId} is not in report ${report.digest}`);
+    const depth = options.depth ?? 'owner';
+    const descendants = descendantIds(owner, byId);
+    const selectedOwners = depth === 'subtree' ? new Set([ownerId, ...descendants]) : new Set([ownerId]);
+    const ownedFindings = (report.findings ?? []).filter((finding) => selectedOwners.has(finding.owner));
+    const requestedFindings = options.findings === undefined ? undefined : new Set(options.findings);
+    if (requestedFindings !== undefined) {
+        for (const id of requestedFindings) {
+            if (!ownedFindings.some((finding) => finding.id === id)) {
+                throw new Error(`presentation finding ${id} is not owned by ${ownerId} at ${depth} depth`);
+            }
+        }
+    }
+    const findings = requestedFindings === undefined
+        ? ownedFindings
+        : ownedFindings.filter((finding) => requestedFindings.has(finding.id));
+    const selectedPatterns = requestedFindings === undefined
+        ? undefined
+        : new Set(findings.flatMap((finding) => finding.pattern ?? []));
+    const patterns = (report.patterns ?? []).filter((pattern) => selectedOwners.has(pattern.parent) && (selectedPatterns?.has(pattern.id) ?? true));
+    const selectedNodeIds = depth === 'subtree'
+        ? [ownerId, ...descendants]
+        : [
+            ownerId,
+            ...owner.children,
+            ...findings.flatMap((finding) => finding.nodes),
+            ...patterns.flatMap((pattern) => pattern.instances),
+        ];
+    const selectedNodes = [...new Set(selectedNodeIds)].flatMap((id) => byId.get(id) ?? []);
+    const layers = options.paint === undefined ? undefined : new Set(options.paint);
+    const relevantNodes = new Set([
+        ...findings.flatMap((finding) => finding.nodes),
+        ...patterns.flatMap((pattern) => pattern.instances),
+    ]);
+    const paint = (report.paint ?? []).filter((instruction) => selectedOwners.has(instruction.owner) &&
+        (layers?.has(instruction.layer) ?? true) &&
+        (requestedFindings === undefined || selectedPaint(instruction, requestedFindings, selectedPatterns, relevantNodes)));
+    const nestedOwners = new Set(descendants);
+    const nestedPatterns = (report.patterns ?? []).filter((pattern) => nestedOwners.has(pattern.parent));
+    const nestedFindings = (report.findings ?? []).filter((finding) => nestedOwners.has(finding.owner));
+    return {
+        formatVersion: 1,
+        report: report.digest,
+        depth,
+        owner,
+        nodes: selectedNodes,
+        patterns,
+        findings,
+        paint,
+        nested: {
+            owners: new Set([...nestedPatterns.map((pattern) => pattern.parent), ...nestedFindings.map((finding) => finding.owner)]).size,
+            patterns: nestedPatterns.length,
+            findings: nestedFindings.length,
+        },
+    };
+}
+function selectedPaint(instruction, findings, patterns, nodes) {
+    if (instruction.finding !== undefined)
+        return findings.has(instruction.finding);
+    if (instruction.pattern !== undefined)
+        return patterns.has(instruction.pattern);
+    return instruction.nodes.some((node) => nodes.has(node));
+}
+function descendantIds(owner, byId) {
+    const result = [];
+    for (const id of owner.children) {
+        const child = byId.get(id);
+        if (child === undefined)
+            continue;
+        result.push(id, ...descendantIds(child, byId));
+    }
+    return result;
+}
+//# sourceMappingURL=focus.js.map

package/dist/focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.js","sourceRoot":"","sources":["../src/focus.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  PaintInstruction,\n  PaintLayer,\n  PresentationFocus,\n  PresentationFocusDepth,\n  PresentationNode,\n  PresentationReport,\n} from './model.js';\n\nexport interface FocusPresentationOptions {\n  /** `owner` keeps nested boxes separate; `subtree` reads the composition holistically. */\n  readonly depth?: PresentationFocusDepth;\n  /** Omit to retain every paint layer owned by the selected structural depth. */\n  readonly paint?: readonly PaintLayer[];\n  /** Omit to read every owned finding; provide ids to isolate one or more questions. */\n  readonly findings?: readonly string[];\n}\n\n/**\n * Read one structural level from an existing report without acquiring the page again.\n *\n * An owner focus contains only relationships owned by that node. Nested evidence is\n * counted but not folded into the result. A subtree focus deliberately includes it.\n */\nexport function focusPresentation(\n  report: PresentationReport,\n  ownerId: string,\n  options: FocusPresentationOptions = {},\n): PresentationFocus {\n  const byId = new Map(report.graph.nodes.map((node) => [node.id, node]));\n  const owner = byId.get(ownerId);\n  if (owner === undefined) throw new Error(`presentation owner ${ownerId} is not in report ${report.digest}`);\n  const depth = options.depth ?? 'owner';\n  const descendants = descendantIds(owner, byId);\n  const selectedOwners = depth === 'subtree' ? new Set([ownerId, ...descendants]) : new Set([ownerId]);\n  const ownedFindings = (report.findings ?? []).filter((finding) => selectedOwners.has(finding.owner));\n  const requestedFindings = options.findings === undefined ? undefined : new Set(options.findings);\n  if (requestedFindings !== undefined) {\n    for (const id of requestedFindings) {\n      if (!ownedFindings.some((finding) => finding.id === id)) {\n        throw new Error(`presentation finding ${id} is not owned by ${ownerId} at ${depth} depth`);\n      }\n    }\n  }\n  const findings = requestedFindings === undefined\n    ? ownedFindings\n    : ownedFindings.filter((finding) => requestedFindings.has(finding.id));\n  const selectedPatterns = requestedFindings === undefined\n    ? undefined\n    : new Set(findings.flatMap((finding) => finding.pattern ?? []));\n  const patterns = (report.patterns ?? []).filter(\n    (pattern) => selectedOwners.has(pattern.parent) && (selectedPatterns?.has(pattern.id) ?? true),\n  );\n  const selectedNodeIds = depth === 'subtree'\n    ? [ownerId, ...descendants]\n    : [\n        ownerId,\n        ...owner.children,\n        ...findings.flatMap((finding) => finding.nodes),\n        ...patterns.flatMap((pattern) => pattern.instances),\n      ];\n  const selectedNodes = [...new Set(selectedNodeIds)].flatMap((id) => byId.get(id) ?? []);\n  const layers = options.paint === undefined ? undefined : new Set(options.paint);\n  const relevantNodes = new Set([\n    ...findings.flatMap((finding) => finding.nodes),\n    ...patterns.flatMap((pattern) => pattern.instances),\n  ]);\n  const paint = (report.paint ?? []).filter(\n    (instruction) =>\n      selectedOwners.has(instruction.owner) &&\n      (layers?.has(instruction.layer) ?? true) &&\n      (requestedFindings === undefined || selectedPaint(instruction, requestedFindings, selectedPatterns!, relevantNodes)),\n  );\n  const nestedOwners = new Set(descendants);\n  const nestedPatterns = (report.patterns ?? []).filter((pattern) => nestedOwners.has(pattern.parent));\n  const nestedFindings = (report.findings ?? []).filter((finding) => nestedOwners.has(finding.owner));\n  return {\n    formatVersion: 1,\n    report: report.digest,\n    depth,\n    owner,\n    nodes: selectedNodes,\n    patterns,\n    findings,\n    paint,\n    nested: {\n      owners: new Set([...nestedPatterns.map((pattern) => pattern.parent), ...nestedFindings.map((finding) => finding.owner)]).size,\n      patterns: nestedPatterns.length,\n      findings: nestedFindings.length,\n    },\n  };\n}\n\nfunction selectedPaint(\n  instruction: PaintInstruction,\n  findings: ReadonlySet<string>,\n  patterns: ReadonlySet<string>,\n  nodes: ReadonlySet<string>,\n): boolean {\n  if (instruction.finding !== undefined) return findings.has(instruction.finding);\n  if (instruction.pattern !== undefined) return patterns.has(instruction.pattern);\n  return instruction.nodes.some((node) => nodes.has(node));\n}\n\nfunction descendantIds(owner: PresentationNode, byId: ReadonlyMap<string, PresentationNode>): string[] {\n  const result: string[] = [];\n  for (const id of owner.children) {\n    const child = byId.get(id);\n    if (child === undefined) continue;\n    result.push(id, ...descendantIds(child, byId));\n  }\n  return result;\n}\n"]}

package/dist/graph.d.ts

@@ -0,0 +1,11 @@
+import type { RawCapture, RawNode, Rect } from '@variance-authority/core';
+import type { PresentationNode, PresentationRelation } from './model.js';
+export interface BuiltGraph {
+    readonly nodes: PresentationNode[];
+    readonly relations: PresentationRelation[];
+    readonly byId: Map<string, PresentationNode>;
+    readonly rawById: Map<string, RawNode>;
+}
+export declare function buildGraph(capture: RawCapture): BuiltGraph;
+export declare function center(rect: Rect): readonly [number, number];
+//# sourceMappingURL=graph.d.ts.map

package/dist/graph.js

@@ -0,0 +1,145 @@
+import { colorOf, luminance, numeric, opaque, perceptualDifference, round, stableEntries, } from './math.js';
+export function buildGraph(capture) {
+    const nodes = [];
+    const relations = [];
+    const byId = new Map();
+    const rawById = new Map();
+    const roots = [capture.root, ...(capture.portals ?? [])];
+    roots.forEach((root, rootIndex) => walk(root, rootIndex, '0', undefined, '#ffffff'));
+    return { nodes, relations, byId, rawById };
+    function walk(raw, root, path, parent, containingFill) {
+        if (raw.tag === '#text')
+            return undefined;
+        const rect = raw.rect;
+        const style = raw.computedStyle ?? raw.inlineStyle ?? {};
+        const fill = opaque(style['background-color']);
+        const effectiveFill = fill ?? containingFill;
+        const id = `r${root}:${path}`;
+        const childIds = [];
+        raw.children.forEach((child, index) => {
+            const childId = walk(child, root, `${path}/${index}`, id, effectiveFill);
+            if (childId !== undefined)
+                childIds.push(childId);
+        });
+        raw.shadowChildren?.forEach((child, index) => {
+            const childId = walk(child, root, `${path}/shadow:${index}`, id, effectiveFill);
+            if (childId !== undefined)
+                childIds.push(childId);
+        });
+        if (rect === undefined || rect.width <= 0 || rect.height <= 0)
+            return undefined;
+        const typography = typographyOf(style);
+        const surface = surfaceOf(style, fill, containingFill);
+        const text = textOf(raw);
+        const semanticClass = semanticClassOf(raw);
+        const state = raw.aria?.state ?? {};
+        const area = Math.max(1, rect.width * rect.height);
+        const magnitude = prominenceMagnitude(typography, surface, area);
+        const node = {
+            id,
+            ref: { root, path },
+            ...(parent === undefined ? {} : { parent }),
+            children: childIds,
+            tag: raw.tag,
+            semanticClass,
+            ...(raw.aria?.role ? { role: raw.aria.role } : {}),
+            ...(raw.aria?.name ? { name: raw.aria.name } : {}),
+            ...(text.length > 0 ? { text } : {}),
+            state,
+            stateSignature: stableEntries(state),
+            rect,
+            typography,
+            surface,
+            prominence: { magnitude },
+        };
+        nodes.push(node);
+        byId.set(id, node);
+        rawById.set(id, raw);
+        if (parent !== undefined) {
+            relations.push({ id: `contains:${parent}:${id}`, kind: 'contains', from: parent, to: id });
+        }
+        return id;
+    }
+}
+function typographyOf(style) {
+    const sizePx = numeric(style['font-size']);
+    const lineHeight = numeric(style['line-height']);
+    const weightText = style['font-weight'];
+    const namedWeight = weightText === 'bold' ? 700 : weightText === 'normal' ? 400 : undefined;
+    const weight = namedWeight ?? numeric(weightText);
+    return {
+        ...(style['font-family'] === undefined ? {} : { family: style['font-family'] }),
+        ...(sizePx === undefined ? {} : { sizePx }),
+        ...(weight === undefined ? {} : { weight }),
+        ...(style['font-style'] === undefined ? {} : { style: style['font-style'] }),
+        ...(sizePx === undefined ? {} : { lineHeightPx: lineHeight ?? round(sizePx * 1.2, 2) }),
+        ...(style.color === undefined ? {} : { foreground: style.color }),
+    };
+}
+function surfaceOf(style, fill, containingFill) {
+    const borderWidthPx = Math.max(...['top', 'right', 'bottom', 'left'].map((side) => {
+        const width = numeric(style[`border-${side}-width`]) ?? 0;
+        const kind = style[`border-${side}-style`];
+        const color = colorOf(style[`border-${side}-color`]);
+        return kind !== undefined && kind !== 'none' && color !== undefined && color.alpha > 0.01
+            ? width
+            : 0;
+    }));
+    const shadow = style['box-shadow'] !== undefined && style['box-shadow'] !== 'none';
+    const difference = fill === undefined ? undefined : perceptualDifference(fill, containingFill);
+    return {
+        ...(fill === undefined ? {} : { fill }),
+        containingFill,
+        ...(difference === undefined ? {} : { perceptualDifference: difference }),
+        borderWidthPx,
+        shadow,
+    };
+}
+function prominenceMagnitude(typography, surface, area) {
+    const size = typography.sizePx ?? 16;
+    const weight = typography.weight ?? 400;
+    const darkness = 1 - (luminance(typography.foreground) ?? 0.5);
+    const surfaceLift = surface.fill === undefined ? 0 : 0.25;
+    const borderLift = surface.borderWidthPx > 0 || surface.shadow ? 0.15 : 0;
+    return round(Math.log2(Math.max(1, size)) + weight / 1000 + darkness * 0.25 + Math.log10(area) * 0.05 + surfaceLift + borderLift);
+}
+function textOf(node) {
+    const parts = [];
+    collect(node);
+    return parts.join(' ').replace(/\s+/g, ' ').trim();
+    function collect(current) {
+        if (current.tag === '#text') {
+            if (current.text !== undefined)
+                parts.push(current.text);
+            return;
+        }
+        for (const child of current.children)
+            collect(child);
+        for (const child of current.shadowChildren ?? [])
+            collect(child);
+    }
+}
+function semanticClassOf(node) {
+    const role = node.aria?.role;
+    if (role === 'heading') {
+        const level = node.attributes['aria-level'] ?? /^h([1-6])$/.exec(node.tag)?.[1];
+        return level === undefined ? 'heading' : `heading:${level}`;
+    }
+    if (role !== null && role !== undefined)
+        return role;
+    if (node.tag === 'label')
+        return 'label';
+    if (/^h[1-6]$/.test(node.tag))
+        return `heading:${node.tag.slice(1)}`;
+    if (node.tag === 'p')
+        return 'paragraph';
+    if (node.tag === 'li')
+        return 'listitem';
+    if (node.tag === 'section' || node.tag === 'article')
+        return 'region';
+    return node.tag;
+}
+export function center(rect) {
+    return [rect.x + rect.width / 2, rect.y + rect.height / 2];
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"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","sourcesContent":["import type { RawCapture, RawNode, Rect } from '@variance-authority/core';\nimport type {\n  PresentationNode,\n  PresentationRelation,\n  SurfaceEvidence,\n  TypographyEvidence,\n} from './model.js';\nimport {\n  colorOf,\n  luminance,\n  numeric,\n  opaque,\n  perceptualDifference,\n  round,\n  stableEntries,\n} from './math.js';\n\nexport interface BuiltGraph {\n  readonly nodes: PresentationNode[];\n  readonly relations: PresentationRelation[];\n  readonly byId: Map<string, PresentationNode>;\n  readonly rawById: Map<string, RawNode>;\n}\n\nexport function buildGraph(capture: RawCapture): BuiltGraph {\n  const nodes: PresentationNode[] = [];\n  const relations: PresentationRelation[] = [];\n  const byId = new Map<string, PresentationNode>();\n  const rawById = new Map<string, RawNode>();\n  const roots = [capture.root, ...(capture.portals ?? [])];\n\n  roots.forEach((root, rootIndex) => walk(root, rootIndex, '0', undefined, '#ffffff'));\n  return { nodes, relations, byId, rawById };\n\n  function walk(\n    raw: RawNode,\n    root: number,\n    path: string,\n    parent: string | undefined,\n    containingFill: string,\n  ): string | undefined {\n    if (raw.tag === '#text') return undefined;\n    const rect = raw.rect;\n    const style = raw.computedStyle ?? raw.inlineStyle ?? {};\n    const fill = opaque(style['background-color']);\n    const effectiveFill = fill ?? containingFill;\n    const id = `r${root}:${path}`;\n    const childIds: string[] = [];\n    raw.children.forEach((child, index) => {\n      const childId = walk(child, root, `${path}/${index}`, id, effectiveFill);\n      if (childId !== undefined) childIds.push(childId);\n    });\n    raw.shadowChildren?.forEach((child, index) => {\n      const childId = walk(child, root, `${path}/shadow:${index}`, id, effectiveFill);\n      if (childId !== undefined) childIds.push(childId);\n    });\n    if (rect === undefined || rect.width <= 0 || rect.height <= 0) return undefined;\n\n    const typography = typographyOf(style);\n    const surface = surfaceOf(style, fill, containingFill);\n    const text = textOf(raw);\n    const semanticClass = semanticClassOf(raw);\n    const state = raw.aria?.state ?? {};\n    const area = Math.max(1, rect.width * rect.height);\n    const magnitude = prominenceMagnitude(typography, surface, area);\n    const node: PresentationNode = {\n      id,\n      ref: { root, path },\n      ...(parent === undefined ? {} : { parent }),\n      children: childIds,\n      tag: raw.tag,\n      semanticClass,\n      ...(raw.aria?.role ? { role: raw.aria.role } : {}),\n      ...(raw.aria?.name ? { name: raw.aria.name } : {}),\n      ...(text.length > 0 ? { text } : {}),\n      state,\n      stateSignature: stableEntries(state),\n      rect,\n      typography,\n      surface,\n      prominence: { magnitude },\n    };\n    nodes.push(node);\n    byId.set(id, node);\n    rawById.set(id, raw);\n    if (parent !== undefined) {\n      relations.push({ id: `contains:${parent}:${id}`, kind: 'contains', from: parent, to: id });\n    }\n    return id;\n  }\n}\n\nfunction typographyOf(style: Readonly<Record<string, string>>): TypographyEvidence {\n  const sizePx = numeric(style['font-size']);\n  const lineHeight = numeric(style['line-height']);\n  const weightText = style['font-weight'];\n  const namedWeight = weightText === 'bold' ? 700 : weightText === 'normal' ? 400 : undefined;\n  const weight = namedWeight ?? numeric(weightText);\n  return {\n    ...(style['font-family'] === undefined ? {} : { family: style['font-family'] }),\n    ...(sizePx === undefined ? {} : { sizePx }),\n    ...(weight === undefined ? {} : { weight }),\n    ...(style['font-style'] === undefined ? {} : { style: style['font-style'] }),\n    ...(sizePx === undefined ? {} : { lineHeightPx: lineHeight ?? round(sizePx * 1.2, 2) }),\n    ...(style.color === undefined ? {} : { foreground: style.color }),\n  };\n}\n\nfunction surfaceOf(\n  style: Readonly<Record<string, string>>,\n  fill: string | undefined,\n  containingFill: string,\n): SurfaceEvidence {\n  const borderWidthPx = Math.max(\n    ...['top', 'right', 'bottom', 'left'].map((side) => {\n      const width = numeric(style[`border-${side}-width`]) ?? 0;\n      const kind = style[`border-${side}-style`];\n      const color = colorOf(style[`border-${side}-color`]);\n      return kind !== undefined && kind !== 'none' && color !== undefined && color.alpha > 0.01\n        ? width\n        : 0;\n    }),\n  );\n  const shadow = style['box-shadow'] !== undefined && style['box-shadow'] !== 'none';\n  const difference = fill === undefined ? undefined : perceptualDifference(fill, containingFill);\n  return {\n    ...(fill === undefined ? {} : { fill }),\n    containingFill,\n    ...(difference === undefined ? {} : { perceptualDifference: difference }),\n    borderWidthPx,\n    shadow,\n  };\n}\n\nfunction prominenceMagnitude(\n  typography: TypographyEvidence,\n  surface: SurfaceEvidence,\n  area: number,\n): number {\n  const size = typography.sizePx ?? 16;\n  const weight = typography.weight ?? 400;\n  const darkness = 1 - (luminance(typography.foreground) ?? 0.5);\n  const surfaceLift = surface.fill === undefined ? 0 : 0.25;\n  const borderLift = surface.borderWidthPx > 0 || surface.shadow ? 0.15 : 0;\n  return round(Math.log2(Math.max(1, size)) + weight / 1000 + darkness * 0.25 + Math.log10(area) * 0.05 + surfaceLift + borderLift);\n}\n\nfunction textOf(node: RawNode): string {\n  const parts: string[] = [];\n  collect(node);\n  return parts.join(' ').replace(/\\s+/g, ' ').trim();\n\n  function collect(current: RawNode): void {\n    if (current.tag === '#text') {\n      if (current.text !== undefined) parts.push(current.text);\n      return;\n    }\n    for (const child of current.children) collect(child);\n    for (const child of current.shadowChildren ?? []) collect(child);\n  }\n}\n\nfunction semanticClassOf(node: RawNode): string {\n  const role = node.aria?.role;\n  if (role === 'heading') {\n    const level = node.attributes['aria-level'] ?? /^h([1-6])$/.exec(node.tag)?.[1];\n    return level === undefined ? 'heading' : `heading:${level}`;\n  }\n  if (role !== null && role !== undefined) return role;\n  if (node.tag === 'label') return 'label';\n  if (/^h[1-6]$/.test(node.tag)) return `heading:${node.tag.slice(1)}`;\n  if (node.tag === 'p') return 'paragraph';\n  if (node.tag === 'li') return 'listitem';\n  if (node.tag === 'section' || node.tag === 'article') return 'region';\n  return node.tag;\n}\n\nexport function center(rect: Rect): readonly [number, number] {\n  return [rect.x + rect.width / 2, rect.y + rect.height / 2];\n}\n"]}

package/dist/hierarchy.d.ts

@@ -0,0 +1,4 @@
+import type { PresentationHierarchyContract, PresentationHierarchyReading, PresentationReport } from './model.js';
+/** Evaluate product-declared hierarchy roles without treating token use as authorization. */
+export declare function inspectPresentationHierarchy(report: PresentationReport, contract: PresentationHierarchyContract): PresentationHierarchyReading;
+//# sourceMappingURL=hierarchy.d.ts.map

package/dist/hierarchy.js

@@ -0,0 +1,171 @@
+import { codeUnitCompare, median, round } from './math.js';
+const ROLE_ORDER = {
+    'owner-boundary': 0,
+    'leading-to-body': 1,
+    'body-peer': 2,
+    'content-internal': 3,
+};
+const RELATIONSHIP_RATIO = 1.15;
+const COLORS = ['#00d4ff', '#ff2bd6', '#ffe600', '#70ff70'];
+/** Evaluate product-declared hierarchy roles without treating token use as authorization. */
+export function inspectPresentationHierarchy(report, contract) {
+    if (contract.id.trim().length === 0)
+        throw new Error('presentation hierarchy contract needs an id');
+    if (contract.levels.length < 2)
+        throw new Error('presentation hierarchy needs at least two relationship levels');
+    const byId = new Map(report.graph.nodes.map((node) => [node.id, node]));
+    const owner = byId.get(contract.owner);
+    if (owner === undefined) {
+        throw new Error(`presentation hierarchy owner ${contract.owner} is not in report ${report.digest}`);
+    }
+    const roles = contract.levels.map((level) => level.role);
+    if (new Set(roles).size !== roles.length)
+        throw new Error('presentation hierarchy roles must be distinct');
+    if (!roles.every((role, index) => index === 0 || ROLE_ORDER[role] > ROLE_ORDER[roles[index - 1]])) {
+        throw new Error('presentation hierarchy roles must be ordered outside-in');
+    }
+    const descendants = new Set([owner.id, ...descendantIds(owner, byId)]);
+    const relationByPair = new Map(report.graph.relations
+        .filter((relation) => relation.kind === 'separates')
+        .map((relation) => [`${relation.from}\0${relation.to}`, relation]));
+    const seenPairs = new Set();
+    const levels = contract.levels.map((level) => {
+        if (level.relations.length === 0) {
+            throw new Error(`presentation hierarchy role ${level.role} needs at least one relationship`);
+        }
+        const separations = level.relations.map(({ from, to }) => {
+            const key = `${from}\0${to}`;
+            if (seenPairs.has(key))
+                throw new Error(`presentation hierarchy relationship ${from} → ${to} has two roles`);
+            seenPairs.add(key);
+            const fromNode = byId.get(from);
+            const toNode = byId.get(to);
+            if (fromNode === undefined || toNode === undefined) {
+                throw new Error(`presentation hierarchy relationship ${from} → ${to} is not in report ${report.digest}`);
+            }
+            if (!descendants.has(from) || !descendants.has(to)) {
+                throw new Error(`presentation hierarchy relationship ${from} → ${to} is outside owner ${owner.id}`);
+            }
+            const relation = relationByPair.get(key);
+            if (relation === undefined)
+                throw new Error(`presentation hierarchy has no separation ${from} → ${to}`);
+            assertAxis(contract, relation, fromNode, toNode);
+            if (relation.distancePx === undefined || relation.boundaryStrength === undefined) {
+                throw new Error(`presentation hierarchy separation ${from} → ${to} is incomplete`);
+            }
+            return {
+                from: fromNode,
+                to: toNode,
+                distancePx: relation.distancePx,
+                boundaryStrength: relation.boundaryStrength,
+                ...(relation.spacingCluster === undefined ? {} : { spacingCluster: relation.spacingCluster }),
+            };
+        });
+        const clusters = [...new Set(separations.flatMap((separation) => separation.spacingCluster ?? []))]
+            .sort(codeUnitCompare);
+        return {
+            role: level.role,
+            separations,
+            distanceMedianPx: round(median(separations.map((separation) => separation.distancePx)), 2),
+            boundaryMedian: round(median(separations.map((separation) => separation.boundaryStrength))),
+            spacingClusters: clusters,
+        };
+    });
+    const collisions = levels.slice(0, -1).flatMap((outer, index) => {
+        const inner = levels[index + 1];
+        const sharedSpacingClusters = outer.spacingClusters.filter((cluster) => inner.spacingClusters.includes(cluster));
+        const smaller = Math.min(outer.distanceMedianPx, inner.distanceMedianPx);
+        const larger = Math.max(outer.distanceMedianPx, inner.distanceMedianPx);
+        const ratio = smaller === 0 ? (larger === 0 ? 1 : Number.POSITIVE_INFINITY) : larger / smaller;
+        if (sharedSpacingClusters.length === 0 && ratio > RELATIONSHIP_RATIO)
+            return [];
+        return [{
+                outer: outer.role,
+                inner: inner.role,
+                outerMedianPx: outer.distanceMedianPx,
+                innerMedianPx: inner.distanceMedianPx,
+                ratio: round(ratio),
+                sharedSpacingClusters,
+            }];
+    });
+    const findings = collisions.map((collision, index) => ({
+        id: `H${index + 1}`,
+        rule: 'SPACING_HIERARCHY_COLLISION',
+        owner: owner.id,
+        nodes: nodesForCollision(levels, collision.outer, collision.inner),
+        contract: contract.id,
+        measurements: {
+            outerRole: collision.outer,
+            innerRole: collision.inner,
+            outerMedianPx: collision.outerMedianPx,
+            innerMedianPx: collision.innerMedianPx,
+            ratio: collision.ratio,
+            sharedSpacingClusters: collision.sharedSpacingClusters.join(','),
+        },
+    }));
+    return {
+        formatVersion: 1,
+        report: report.digest,
+        contract,
+        owner,
+        levels,
+        collisions,
+        findings,
+        paint: paint(contract, levels, collisions),
+    };
+}
+function assertAxis(contract, relation, from, to) {
+    const orderedOverlap = relation.axis === 'overlap' && (contract.axis === 'vertical' ? to.rect.y >= from.rect.y : to.rect.x >= from.rect.x);
+    if (relation.axis !== contract.axis && !orderedOverlap) {
+        throw new Error(`presentation hierarchy separation ${from.id} → ${to.id} is ${relation.axis}, not ${contract.axis}`);
+    }
+}
+function nodesForCollision(levels, outer, inner) {
+    return [...new Set(levels
+            .filter((level) => level.role === outer || level.role === inner)
+            .flatMap((level) => level.separations.flatMap((separation) => [separation.from.id, separation.to.id])))]
+        .sort(codeUnitCompare);
+}
+function paint(contract, levels, collisions) {
+    const collided = new Set(collisions.flatMap((collision) => [collision.outer, collision.inner]));
+    return levels.flatMap((level, levelIndex) => level.separations.map((separation, relationIndex) => {
+        const horizontal = contract.axis === 'vertical';
+        const coordinate = horizontal
+            ? round((separation.from.rect.y + separation.from.rect.height + separation.to.rect.y) / 2, 2)
+            : round((separation.from.rect.x + separation.from.rect.width + separation.to.rect.x) / 2, 2);
+        return {
+            id: `hierarchy:${contract.id}:${level.role}:${relationIndex + 1}`,
+            owner: contract.owner,
+            nodes: [separation.from.id, separation.to.id],
+            contract: contract.id,
+            layer: 'findings',
+            shape: 'line',
+            color: collided.has(level.role) ? '#ff1744' : COLORS[levelIndex],
+            label: `${level.role} ${separation.distancePx}px`,
+            line: horizontal
+                ? {
+                    x1: Math.min(separation.from.rect.x, separation.to.rect.x),
+                    y1: coordinate,
+                    x2: Math.max(separation.from.rect.x + separation.from.rect.width, separation.to.rect.x + separation.to.rect.width),
+                    y2: coordinate,
+                }
+                : {
+                    x1: coordinate,
+                    y1: Math.min(separation.from.rect.y, separation.to.rect.y),
+                    x2: coordinate,
+                    y2: Math.max(separation.from.rect.y + separation.from.rect.height, separation.to.rect.y + separation.to.rect.height),
+                },
+        };
+    }));
+}
+function descendantIds(owner, byId) {
+    const result = [];
+    for (const id of owner.children) {
+        const child = byId.get(id);
+        if (child === undefined)
+            continue;
+        result.push(id, ...descendantIds(child, byId));
+    }
+    return result;
+}
+//# sourceMappingURL=hierarchy.js.map

package/dist/hierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.js","sourceRoot":"","sources":["../src/hierarchy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAY3D,MAAM,UAAU,GAAwD;IACtE,gBAAgB,EAAE,CAAC;IACnB,iBAAiB,EAAE,CAAC;IACpB,WAAW,EAAE,CAAC;IACd,kBAAkB,EAAE,CAAC;CACtB,CAAC;AACF,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAU,CAAC;AAErE,6FAA6F;AAC7F,MAAM,UAAU,4BAA4B,CAC1C,MAA0B,EAC1B,QAAuC;IAEvC,IAAI,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACpG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACjH,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,gCAAgC,QAAQ,CAAC,KAAK,qBAAqB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACtG,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzD,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IAC3G,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAE,CAAE,CAAC,EAAE,CAAC;QACpG,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS;SAClD,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,WAAW,CAAC;SACnD,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3C,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,CAAC,IAAI,kCAAkC,CAAC,CAAC;QAC/F,CAAC;QACD,MAAM,WAAW,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE;YACvD,MAAM,GAAG,GAAG,GAAG,IAAI,KAAK,EAAE,EAAE,CAAC;YAC7B,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,MAAM,EAAE,gBAAgB,CAAC,CAAC;YAC7G,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5B,IAAI,QAAQ,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACnD,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,MAAM,EAAE,qBAAqB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3G,CAAC;YACD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACnD,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,MAAM,EAAE,qBAAqB,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YACtG,CAAC;YACD,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,QAAQ,KAAK,SAAS;gBAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;YACxG,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,IAAI,QAAQ,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;gBACjF,MAAM,IAAI,KAAK,CAAC,qCAAqC,IAAI,MAAM,EAAE,gBAAgB,CAAC,CAAC;YACrF,CAAC;YACD,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,EAAE,EAAE,MAAM;gBACV,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;gBAC3C,GAAG,CAAC,QAAQ,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE,CAAC;aAC9F,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC;aAChG,IAAI,CAAC,eAAe,CAAC,CAAC;QACzB,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW;YACX,gBAAgB,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAE,EAAE,CAAC,CAAC;YAC3F,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAE,CAAC;YAC5F,eAAe,EAAE,QAAQ;SAC1B,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC;QACjC,MAAM,qBAAqB,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACjH,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,OAAO,CAAC;QAC/F,IAAI,qBAAqB,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,GAAG,kBAAkB;YAAE,OAAO,EAAE,CAAC;QAChF,OAAO,CAAC;gBACN,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,aAAa,EAAE,KAAK,CAAC,gBAAgB;gBACrC,aAAa,EAAE,KAAK,CAAC,gBAAgB;gBACrC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;gBACnB,qBAAqB;aACtB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAA0B,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5E,EAAE,EAAE,IAAI,KAAK,GAAG,CAAC,EAAE;QACnB,IAAI,EAAE,6BAA6B;QACnC,KAAK,EAAE,KAAK,CAAC,EAAE;QACf,KAAK,EAAE,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC;QAClE,QAAQ,EAAE,QAAQ,CAAC,EAAE;QACrB,YAAY,EAAE;YACZ,SAAS,EAAE,SAAS,CAAC,KAAK;YAC1B,SAAS,EAAE,SAAS,CAAC,KAAK;YAC1B,aAAa,EAAE,SAAS,CAAC,aAAa;YACtC,aAAa,EAAE,SAAS,CAAC,aAAa;YACtC,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,qBAAqB,EAAE,SAAS,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC;SACjE;KACF,CAAC,CAAC,CAAC;IACJ,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ;QACR,KAAK;QACL,MAAM;QACN,UAAU;QACV,QAAQ;QACR,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,QAAuC,EACvC,QAA8B,EAC9B,IAAsB,EACtB,EAAoB;IAEpB,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,CACpD,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CACnF,CAAC;IACF,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,qCAAqC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,QAAQ,CAAC,IAAI,SAAS,QAAQ,CAAC,IAAI,EAAE,CACpG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,MAA8C,EAC9C,KAAgC,EAChC,KAAgC;IAEhC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM;aACtB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;aAC/D,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;SACvG,IAAI,CAAC,eAAe,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,KAAK,CACZ,QAAuC,EACvC,MAA8C,EAC9C,UAAsD;IAEtD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAChG,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,aAAa,EAAE,EAAE;QAC/F,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,KAAK,UAAU,CAAC;QAChD,MAAM,UAAU,GAAG,UAAU;YAC3B,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7F,CAAC,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/F,OAAO;YACL,EAAE,EAAE,aAAa,QAAQ,CAAC,EAAE,IAAI,KAAK,CAAC,IAAI,IAAI,aAAa,GAAG,CAAC,EAAE;YACjE,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,KAAK,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7C,QAAQ,EAAE,QAAQ,CAAC,EAAE;YACrB,KAAK,EAAE,UAAmB;YAC1B,KAAK,EAAE,MAAe;YACtB,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAE;YACjE,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,UAAU,CAAC,UAAU,IAAI;YACjD,IAAI,EAAE,UAAU;gBACd,CAAC,CAAC;oBACE,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;oBAC1D,EAAE,EAAE,UAAU;oBACd,EAAE,EAAE,IAAI,CAAC,GAAG,CACV,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EACnD,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAChD;oBACD,EAAE,EAAE,UAAU;iBACf;gBACH,CAAC,CAAC;oBACE,EAAE,EAAE,UAAU;oBACd,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;oBAC1D,EAAE,EAAE,UAAU;oBACd,EAAE,EAAE,IAAI,CAAC,GAAG,CACV,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EACpD,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CACjD;iBACF;SACN,CAAC;IACJ,CAAC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,aAAa,CAAC,KAAuB,EAAE,IAA2C;IACzF,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3B,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { codeUnitCompare, median, round } from './math.js';\nimport type {\n  PaintInstruction,\n  PresentationFinding,\n  PresentationHierarchyContract,\n  PresentationHierarchyReading,\n  PresentationHierarchyRole,\n  PresentationNode,\n  PresentationRelation,\n  PresentationReport,\n} from './model.js';\n\nconst ROLE_ORDER: Readonly<Record<PresentationHierarchyRole, number>> = {\n  'owner-boundary': 0,\n  'leading-to-body': 1,\n  'body-peer': 2,\n  'content-internal': 3,\n};\nconst RELATIONSHIP_RATIO = 1.15;\nconst COLORS = ['#00d4ff', '#ff2bd6', '#ffe600', '#70ff70'] as const;\n\n/** Evaluate product-declared hierarchy roles without treating token use as authorization. */\nexport function inspectPresentationHierarchy(\n  report: PresentationReport,\n  contract: PresentationHierarchyContract,\n): PresentationHierarchyReading {\n  if (contract.id.trim().length === 0) throw new Error('presentation hierarchy contract needs an id');\n  if (contract.levels.length < 2) throw new Error('presentation hierarchy needs at least two relationship levels');\n  const byId = new Map(report.graph.nodes.map((node) => [node.id, node]));\n  const owner = byId.get(contract.owner);\n  if (owner === undefined) {\n    throw new Error(`presentation hierarchy owner ${contract.owner} is not in report ${report.digest}`);\n  }\n  const roles = contract.levels.map((level) => level.role);\n  if (new Set(roles).size !== roles.length) throw new Error('presentation hierarchy roles must be distinct');\n  if (!roles.every((role, index) => index === 0 || ROLE_ORDER[role] > ROLE_ORDER[roles[index - 1]!]!)) {\n    throw new Error('presentation hierarchy roles must be ordered outside-in');\n  }\n  const descendants = new Set([owner.id, ...descendantIds(owner, byId)]);\n  const relationByPair = new Map(report.graph.relations\n    .filter((relation) => relation.kind === 'separates')\n    .map((relation) => [`${relation.from}\\0${relation.to}`, relation]));\n  const seenPairs = new Set<string>();\n  const levels = contract.levels.map((level) => {\n    if (level.relations.length === 0) {\n      throw new Error(`presentation hierarchy role ${level.role} needs at least one relationship`);\n    }\n    const separations = level.relations.map(({ from, to }) => {\n      const key = `${from}\\0${to}`;\n      if (seenPairs.has(key)) throw new Error(`presentation hierarchy relationship ${from} → ${to} has two roles`);\n      seenPairs.add(key);\n      const fromNode = byId.get(from);\n      const toNode = byId.get(to);\n      if (fromNode === undefined || toNode === undefined) {\n        throw new Error(`presentation hierarchy relationship ${from} → ${to} is not in report ${report.digest}`);\n      }\n      if (!descendants.has(from) || !descendants.has(to)) {\n        throw new Error(`presentation hierarchy relationship ${from} → ${to} is outside owner ${owner.id}`);\n      }\n      const relation = relationByPair.get(key);\n      if (relation === undefined) throw new Error(`presentation hierarchy has no separation ${from} → ${to}`);\n      assertAxis(contract, relation, fromNode, toNode);\n      if (relation.distancePx === undefined || relation.boundaryStrength === undefined) {\n        throw new Error(`presentation hierarchy separation ${from} → ${to} is incomplete`);\n      }\n      return {\n        from: fromNode,\n        to: toNode,\n        distancePx: relation.distancePx,\n        boundaryStrength: relation.boundaryStrength,\n        ...(relation.spacingCluster === undefined ? {} : { spacingCluster: relation.spacingCluster }),\n      };\n    });\n    const clusters = [...new Set(separations.flatMap((separation) => separation.spacingCluster ?? []))]\n      .sort(codeUnitCompare);\n    return {\n      role: level.role,\n      separations,\n      distanceMedianPx: round(median(separations.map((separation) => separation.distancePx))!, 2),\n      boundaryMedian: round(median(separations.map((separation) => separation.boundaryStrength))!),\n      spacingClusters: clusters,\n    };\n  });\n  const collisions = levels.slice(0, -1).flatMap((outer, index) => {\n    const inner = levels[index + 1]!;\n    const sharedSpacingClusters = outer.spacingClusters.filter((cluster) => inner.spacingClusters.includes(cluster));\n    const smaller = Math.min(outer.distanceMedianPx, inner.distanceMedianPx);\n    const larger = Math.max(outer.distanceMedianPx, inner.distanceMedianPx);\n    const ratio = smaller === 0 ? (larger === 0 ? 1 : Number.POSITIVE_INFINITY) : larger / smaller;\n    if (sharedSpacingClusters.length === 0 && ratio > RELATIONSHIP_RATIO) return [];\n    return [{\n      outer: outer.role,\n      inner: inner.role,\n      outerMedianPx: outer.distanceMedianPx,\n      innerMedianPx: inner.distanceMedianPx,\n      ratio: round(ratio),\n      sharedSpacingClusters,\n    }];\n  });\n  const findings: PresentationFinding[] = collisions.map((collision, index) => ({\n    id: `H${index + 1}`,\n    rule: 'SPACING_HIERARCHY_COLLISION',\n    owner: owner.id,\n    nodes: nodesForCollision(levels, collision.outer, collision.inner),\n    contract: contract.id,\n    measurements: {\n      outerRole: collision.outer,\n      innerRole: collision.inner,\n      outerMedianPx: collision.outerMedianPx,\n      innerMedianPx: collision.innerMedianPx,\n      ratio: collision.ratio,\n      sharedSpacingClusters: collision.sharedSpacingClusters.join(','),\n    },\n  }));\n  return {\n    formatVersion: 1,\n    report: report.digest,\n    contract,\n    owner,\n    levels,\n    collisions,\n    findings,\n    paint: paint(contract, levels, collisions),\n  };\n}\n\nfunction assertAxis(\n  contract: PresentationHierarchyContract,\n  relation: PresentationRelation,\n  from: PresentationNode,\n  to: PresentationNode,\n): void {\n  const orderedOverlap = relation.axis === 'overlap' && (\n    contract.axis === 'vertical' ? to.rect.y >= from.rect.y : to.rect.x >= from.rect.x\n  );\n  if (relation.axis !== contract.axis && !orderedOverlap) {\n    throw new Error(\n      `presentation hierarchy separation ${from.id} → ${to.id} is ${relation.axis}, not ${contract.axis}`,\n    );\n  }\n}\n\nfunction nodesForCollision(\n  levels: PresentationHierarchyReading['levels'],\n  outer: PresentationHierarchyRole,\n  inner: PresentationHierarchyRole,\n): string[] {\n  return [...new Set(levels\n    .filter((level) => level.role === outer || level.role === inner)\n    .flatMap((level) => level.separations.flatMap((separation) => [separation.from.id, separation.to.id])))]\n    .sort(codeUnitCompare);\n}\n\nfunction paint(\n  contract: PresentationHierarchyContract,\n  levels: PresentationHierarchyReading['levels'],\n  collisions: PresentationHierarchyReading['collisions'],\n): PaintInstruction[] {\n  const collided = new Set(collisions.flatMap((collision) => [collision.outer, collision.inner]));\n  return levels.flatMap((level, levelIndex) => level.separations.map((separation, relationIndex) => {\n    const horizontal = contract.axis === 'vertical';\n    const coordinate = horizontal\n      ? round((separation.from.rect.y + separation.from.rect.height + separation.to.rect.y) / 2, 2)\n      : round((separation.from.rect.x + separation.from.rect.width + separation.to.rect.x) / 2, 2);\n    return {\n      id: `hierarchy:${contract.id}:${level.role}:${relationIndex + 1}`,\n      owner: contract.owner,\n      nodes: [separation.from.id, separation.to.id],\n      contract: contract.id,\n      layer: 'findings' as const,\n      shape: 'line' as const,\n      color: collided.has(level.role) ? '#ff1744' : COLORS[levelIndex]!,\n      label: `${level.role} ${separation.distancePx}px`,\n      line: horizontal\n        ? {\n            x1: Math.min(separation.from.rect.x, separation.to.rect.x),\n            y1: coordinate,\n            x2: Math.max(\n              separation.from.rect.x + separation.from.rect.width,\n              separation.to.rect.x + separation.to.rect.width,\n            ),\n            y2: coordinate,\n          }\n        : {\n            x1: coordinate,\n            y1: Math.min(separation.from.rect.y, separation.to.rect.y),\n            x2: coordinate,\n            y2: Math.max(\n              separation.from.rect.y + separation.from.rect.height,\n              separation.to.rect.y + separation.to.rect.height,\n            ),\n          },\n    };\n  }));\n}\n\nfunction descendantIds(owner: PresentationNode, byId: ReadonlyMap<string, PresentationNode>): string[] {\n  const result: string[] = [];\n  for (const id of owner.children) {\n    const child = byId.get(id);\n    if (child === undefined) continue;\n    result.push(id, ...descendantIds(child, byId));\n  }\n  return result;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { analyzePresentation } from './analyze.js';
+export type { AnalyzePresentationOptions } from './analyze.js';
+export { inspectPresentationAlignment } from './alignment.js';
+export { inspectPresentationSpacing } from './spacing.js';
+export { inspectPresentationHierarchy } from './hierarchy.js';
+export { presentationSignal } from './report.js';
+export type { PresentationSignalOptions } from './report.js';
+export { comparePresentation } from './compare.js';
+export { focusPresentation } from './focus.js';
+export type { FocusPresentationOptions } from './focus.js';
+export type { AlignmentAxis, BaselineCluster, ElementReference, PaintInstruction, PaintLayer, PresentationComparison, PresentationAlignmentKind, PresentationAlignmentReading, PresentationFinding, PresentationFindingRule, PresentationHierarchyContract, PresentationHierarchyReading, PresentationHierarchyRole, PresentationFocus, PresentationFocusDepth, PresentationNode, PresentationRelation, PresentationReport, PresentationSpacingAxis, PresentationSpacingReading, PresentationSignature, PresentationTelemetry, ProminenceCluster, RepeatedPattern, SpacingCluster, SurfaceGroup, } from './model.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,8 @@
+export { analyzePresentation } from './analyze.js';
+export { inspectPresentationAlignment } from './alignment.js';
+export { inspectPresentationSpacing } from './spacing.js';
+export { inspectPresentationHierarchy } from './hierarchy.js';
+export { presentationSignal } from './report.js';
+export { comparePresentation } from './compare.js';
+export { focusPresentation } from './focus.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { analyzePresentation } from './analyze.js';\nexport type { AnalyzePresentationOptions } from './analyze.js';\nexport { inspectPresentationAlignment } from './alignment.js';\nexport { inspectPresentationSpacing } from './spacing.js';\nexport { inspectPresentationHierarchy } from './hierarchy.js';\nexport { presentationSignal } from './report.js';\nexport type { PresentationSignalOptions } from './report.js';\nexport { comparePresentation } from './compare.js';\nexport { focusPresentation } from './focus.js';\nexport type { FocusPresentationOptions } from './focus.js';\nexport type {\n  AlignmentAxis,\n  BaselineCluster,\n  ElementReference,\n  PaintInstruction,\n  PaintLayer,\n  PresentationComparison,\n  PresentationAlignmentKind,\n  PresentationAlignmentReading,\n  PresentationFinding,\n  PresentationFindingRule,\n  PresentationHierarchyContract,\n  PresentationHierarchyReading,\n  PresentationHierarchyRole,\n  PresentationFocus,\n  PresentationFocusDepth,\n  PresentationNode,\n  PresentationRelation,\n  PresentationReport,\n  PresentationSpacingAxis,\n  PresentationSpacingReading,\n  PresentationSignature,\n  PresentationTelemetry,\n  ProminenceCluster,\n  RepeatedPattern,\n  SpacingCluster,\n  SurfaceGroup,\n} from './model.js';\n"]}