@variance-authority/presentation 0.1.0

package/dist/browser-agent.d.ts

@@ -0,0 +1,37 @@
+import type { Digest, RawCapture, SubjectRef, Viewport } from '@variance-authority/core';
+import type { PaintInstruction, PaintLayer } from './model.js';
+export declare const PRESENTATION_AGENT = "__variance_authority_presentation__";
+export declare const PRESENTATION_AGENT_VERSION = "presentation@0";
+export declare const PRESENTATION_ROOT_ATTRIBUTE = "data-variance-authority-presentation-root";
+export declare const PRESENTATION_OVERLAY_ATTRIBUTE = "data-variance-authority-presentation-overlay";
+export interface PresentationAcquireRequest {
+    readonly subject: SubjectRef;
+    readonly viewport: Viewport;
+    readonly engine: string;
+    readonly fonts?: readonly string[];
+    readonly stabilize?: readonly string[];
+    readonly suspense?: {
+        readonly timeoutMs?: number;
+    };
+}
+export interface PresentationAcquired {
+    readonly capture: RawCapture;
+    readonly stabilization: {
+        readonly ids: readonly string[];
+        readonly digest?: Digest;
+    };
+    readonly portals: readonly {
+        readonly marker: string;
+        readonly previous?: string;
+    }[];
+}
+export interface InstalledPresentationAgent {
+    readonly acquire: (root: Element, request: PresentationAcquireRequest) => Promise<string>;
+    readonly paint: (instructions: readonly PaintInstruction[], layers?: readonly PaintLayer[]) => number;
+    readonly clear: () => void;
+    readonly version: string;
+}
+export declare function acquirePresentation(root: Element, request: PresentationAcquireRequest): Promise<string>;
+export declare function paintPresentation(instructions: readonly PaintInstruction[], layers?: readonly PaintLayer[]): number;
+export declare function clearPresentationPaint(): void;
+//# sourceMappingURL=browser-agent.d.ts.map

package/dist/browser-agent.js

@@ -0,0 +1,130 @@
+import { COLLECT_RECIPE, recipeOf, } from '@variance-authority/core';
+import { collect, stabilizeForObservation } from '@variance-authority/dom';
+import { awaitSuspense, portalContentOf } from '@variance-authority/react';
+export const PRESENTATION_AGENT = '__variance_authority_presentation__';
+export const PRESENTATION_AGENT_VERSION = 'presentation@0';
+export const PRESENTATION_ROOT_ATTRIBUTE = 'data-variance-authority-presentation-root';
+export const PRESENTATION_OVERLAY_ATTRIBUTE = 'data-variance-authority-presentation-overlay';
+let sequence = 0;
+export async function acquirePresentation(root, request) {
+    clearPresentationPaint();
+    await awaitSuspense(root, request.suspense ?? {});
+    const portalRoots = portalContentOf(root);
+    const held = await stabilizeForObservation(root.ownerDocument, {
+        recipe: request.stabilize === undefined
+            ? presentationRecipe([root, ...portalRoots])
+            : recipeOf(request.stabilize),
+    });
+    const capture = collect(root, {
+        subject: request.subject,
+        viewport: request.viewport,
+        engine: request.engine,
+        portalsOf: () => portalRoots,
+        ...(request.fonts === undefined ? {} : { fonts: request.fonts }),
+        ...(held.digest === undefined ? {} : { stabilization: held.digest }),
+    });
+    const current = ++sequence;
+    const portals = portalRoots.map((portal, index) => {
+        const previous = portal.getAttribute(PRESENTATION_ROOT_ATTRIBUTE);
+        const marker = `${current}-${index}`;
+        portal.setAttribute(PRESENTATION_ROOT_ATTRIBUTE, marker);
+        return { marker, ...(previous === null ? {} : { previous }) };
+    });
+    return JSON.stringify({
+        capture,
+        stabilization: {
+            ids: held.ids,
+            ...(held.digest === undefined ? {} : { digest: held.digest }),
+        },
+        portals,
+    });
+}
+function presentationRecipe(roots) {
+    const waitForSubjectImages = {
+        id: 'wait-for-subject-images',
+        trick: 'wait',
+        needs: 'layout',
+        governs: 'images',
+        because: 'waited only for images inside the presentation subject and its portals',
+        settle: async () => {
+            const images = roots.flatMap((root) => [
+                ...(root.tagName.toLowerCase() === 'img' ? [root] : []),
+                ...Array.from(root.querySelectorAll('img')),
+            ]);
+            await Promise.all(images.filter((image) => !image.complete).map((image) => new Promise((resolve) => {
+                image.addEventListener('load', () => resolve(), { once: true });
+                image.addEventListener('error', () => resolve(), { once: true });
+            })));
+        },
+    };
+    return [
+        ...COLLECT_RECIPE.filter((intervention) => intervention.id !== 'wait-for-images'),
+        waitForSubjectImages,
+    ];
+}
+export function paintPresentation(instructions, layers) {
+    clearPresentationPaint();
+    const selected = layers === undefined ? undefined : new Set(layers);
+    const visible = instructions.filter((instruction) => selected?.has(instruction.layer) ?? true);
+    if (visible.length === 0)
+        return 0;
+    const document = globalThis.document;
+    const namespace = 'http://www.w3.org/2000/svg';
+    const svg = document.createElementNS(namespace, 'svg');
+    svg.setAttribute(PRESENTATION_OVERLAY_ATTRIBUTE, '');
+    svg.setAttribute('aria-hidden', 'true');
+    svg.setAttribute('width', String(Math.max(document.documentElement.scrollWidth, innerWidth)));
+    svg.setAttribute('height', String(Math.max(document.documentElement.scrollHeight, innerHeight)));
+    Object.assign(svg.style, {
+        position: 'absolute', left: '0', top: '0', pointerEvents: 'none',
+        overflow: 'visible', zIndex: '2147483647',
+    });
+    for (const instruction of visible) {
+        const group = document.createElementNS(namespace, 'g');
+        group.setAttribute('data-layer', instruction.layer);
+        group.setAttribute('data-measurement', instruction.id);
+        if (instruction.shape === 'rect' && instruction.rect !== undefined) {
+            const rectangle = document.createElementNS(namespace, 'rect');
+            rectangle.setAttribute('x', String(instruction.rect.x + scrollX));
+            rectangle.setAttribute('y', String(instruction.rect.y + scrollY));
+            rectangle.setAttribute('width', String(instruction.rect.width));
+            rectangle.setAttribute('height', String(instruction.rect.height));
+            rectangle.setAttribute('fill', 'none');
+            rectangle.setAttribute('stroke', instruction.color);
+            rectangle.setAttribute('stroke-width', instruction.layer === 'findings' ? '3' : '1');
+            rectangle.setAttribute('stroke-dasharray', instruction.layer === 'semantic' ? '3 2' : 'none');
+            group.append(rectangle);
+            group.append(paintLabel(instruction.label, instruction.rect.x + scrollX + 2, instruction.rect.y + scrollY + 11));
+        }
+        else if (instruction.shape === 'line' && instruction.line !== undefined) {
+            const line = document.createElementNS(namespace, 'line');
+            line.setAttribute('x1', String(instruction.line.x1 + scrollX));
+            line.setAttribute('y1', String(instruction.line.y1 + scrollY));
+            line.setAttribute('x2', String(instruction.line.x2 + scrollX));
+            line.setAttribute('y2', String(instruction.line.y2 + scrollY));
+            line.setAttribute('stroke', instruction.color);
+            group.append(line);
+            group.append(paintLabel(instruction.label, (instruction.line.x1 + instruction.line.x2) / 2 + scrollX, (instruction.line.y1 + instruction.line.y2) / 2 + scrollY));
+        }
+        svg.append(group);
+    }
+    document.documentElement.append(svg);
+    return visible.length;
+}
+export function clearPresentationPaint() {
+    globalThis.document?.querySelector(`[${PRESENTATION_OVERLAY_ATTRIBUTE}]`)?.remove();
+}
+function paintLabel(text, x, y) {
+    const value = document.createElementNS('http://www.w3.org/2000/svg', 'text');
+    value.setAttribute('x', String(x));
+    value.setAttribute('y', String(y));
+    value.setAttribute('fill', '#111');
+    value.setAttribute('stroke', '#fff');
+    value.setAttribute('stroke-width', '3');
+    value.setAttribute('paint-order', 'stroke');
+    value.setAttribute('font-family', 'ui-monospace, monospace');
+    value.setAttribute('font-size', '10');
+    value.textContent = text;
+    return value;
+}
+//# sourceMappingURL=browser-agent.js.map

package/dist/browser-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-agent.js","sourceRoot":"","sources":["../src/browser-agent.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  COLLECT_RECIPE,\n  recipeOf,\n} from '@variance-authority/core';\nimport type {\n  Digest,\n  RawCapture,\n  SubjectRef,\n  Viewport,\n} from '@variance-authority/core';\nimport { collect, stabilizeForObservation } from '@variance-authority/dom';\nimport { awaitSuspense, portalContentOf } from '@variance-authority/react';\nimport type { PaintInstruction, PaintLayer } from './model.js';\n\nexport const PRESENTATION_AGENT = '__variance_authority_presentation__';\nexport const PRESENTATION_AGENT_VERSION = 'presentation@0';\nexport const PRESENTATION_ROOT_ATTRIBUTE = 'data-variance-authority-presentation-root';\nexport const PRESENTATION_OVERLAY_ATTRIBUTE = 'data-variance-authority-presentation-overlay';\nlet sequence = 0;\n\nexport interface PresentationAcquireRequest {\n  readonly subject: SubjectRef;\n  readonly viewport: Viewport;\n  readonly engine: string;\n  readonly fonts?: readonly string[];\n  readonly stabilize?: readonly string[];\n  readonly suspense?: { readonly timeoutMs?: number };\n}\n\nexport interface PresentationAcquired {\n  readonly capture: RawCapture;\n  readonly stabilization: { readonly ids: readonly string[]; readonly digest?: Digest };\n  readonly portals: readonly { readonly marker: string; readonly previous?: string }[];\n}\n\nexport interface InstalledPresentationAgent {\n  readonly acquire: (root: Element, request: PresentationAcquireRequest) => Promise<string>;\n  readonly paint: (instructions: readonly PaintInstruction[], layers?: readonly PaintLayer[]) => number;\n  readonly clear: () => void;\n  readonly version: string;\n}\n\nexport async function acquirePresentation(\n  root: Element,\n  request: PresentationAcquireRequest,\n): Promise<string> {\n  clearPresentationPaint();\n  await awaitSuspense(root, request.suspense ?? {});\n  const portalRoots = portalContentOf(root);\n  const held = await stabilizeForObservation(\n    root.ownerDocument,\n    {\n      recipe: request.stabilize === undefined\n        ? presentationRecipe([root, ...portalRoots])\n        : recipeOf(request.stabilize),\n    },\n  );\n  const capture = collect(root, {\n    subject: request.subject,\n    viewport: request.viewport,\n    engine: request.engine,\n    portalsOf: () => portalRoots,\n    ...(request.fonts === undefined ? {} : { fonts: request.fonts }),\n    ...(held.digest === undefined ? {} : { stabilization: held.digest }),\n  });\n  const current = ++sequence;\n  const portals = portalRoots.map((portal, index) => {\n    const previous = portal.getAttribute(PRESENTATION_ROOT_ATTRIBUTE);\n    const marker = `${current}-${index}`;\n    portal.setAttribute(PRESENTATION_ROOT_ATTRIBUTE, marker);\n    return { marker, ...(previous === null ? {} : { previous }) };\n  });\n  return JSON.stringify({\n    capture,\n    stabilization: {\n      ids: held.ids,\n      ...(held.digest === undefined ? {} : { digest: held.digest }),\n    },\n    portals,\n  });\n}\n\nfunction presentationRecipe(roots: readonly Element[]) {\n  const waitForSubjectImages = {\n    id: 'wait-for-subject-images',\n    trick: 'wait',\n    needs: 'layout',\n    governs: 'images',\n    because: 'waited only for images inside the presentation subject and its portals',\n    settle: async () => {\n      const images = roots.flatMap((root) => [\n        ...(root.tagName.toLowerCase() === 'img' ? [root as HTMLImageElement] : []),\n        ...Array.from(root.querySelectorAll('img')),\n      ]);\n      await Promise.all(images.filter((image) => !image.complete).map((image) => new Promise<void>((resolve) => {\n        image.addEventListener('load', () => resolve(), { once: true });\n        image.addEventListener('error', () => resolve(), { once: true });\n      })));\n    },\n  } as const;\n  return [\n    ...COLLECT_RECIPE.filter((intervention) => intervention.id !== 'wait-for-images'),\n    waitForSubjectImages,\n  ];\n}\n\nexport function paintPresentation(\n  instructions: readonly PaintInstruction[],\n  layers?: readonly PaintLayer[],\n): number {\n  clearPresentationPaint();\n  const selected = layers === undefined ? undefined : new Set(layers);\n  const visible = instructions.filter((instruction) => selected?.has(instruction.layer) ?? true);\n  if (visible.length === 0) return 0;\n  const document = globalThis.document;\n  const namespace = 'http://www.w3.org/2000/svg';\n  const svg = document.createElementNS(namespace, 'svg');\n  svg.setAttribute(PRESENTATION_OVERLAY_ATTRIBUTE, '');\n  svg.setAttribute('aria-hidden', 'true');\n  svg.setAttribute('width', String(Math.max(document.documentElement.scrollWidth, innerWidth)));\n  svg.setAttribute('height', String(Math.max(document.documentElement.scrollHeight, innerHeight)));\n  Object.assign(svg.style, {\n    position: 'absolute', left: '0', top: '0', pointerEvents: 'none',\n    overflow: 'visible', zIndex: '2147483647',\n  });\n\n  for (const instruction of visible) {\n    const group = document.createElementNS(namespace, 'g');\n    group.setAttribute('data-layer', instruction.layer);\n    group.setAttribute('data-measurement', instruction.id);\n    if (instruction.shape === 'rect' && instruction.rect !== undefined) {\n      const rectangle = document.createElementNS(namespace, 'rect');\n      rectangle.setAttribute('x', String(instruction.rect.x + scrollX));\n      rectangle.setAttribute('y', String(instruction.rect.y + scrollY));\n      rectangle.setAttribute('width', String(instruction.rect.width));\n      rectangle.setAttribute('height', String(instruction.rect.height));\n      rectangle.setAttribute('fill', 'none');\n      rectangle.setAttribute('stroke', instruction.color);\n      rectangle.setAttribute('stroke-width', instruction.layer === 'findings' ? '3' : '1');\n      rectangle.setAttribute('stroke-dasharray', instruction.layer === 'semantic' ? '3 2' : 'none');\n      group.append(rectangle);\n      group.append(paintLabel(instruction.label, instruction.rect.x + scrollX + 2, instruction.rect.y + scrollY + 11));\n    } else if (instruction.shape === 'line' && instruction.line !== undefined) {\n      const line = document.createElementNS(namespace, 'line');\n      line.setAttribute('x1', String(instruction.line.x1 + scrollX));\n      line.setAttribute('y1', String(instruction.line.y1 + scrollY));\n      line.setAttribute('x2', String(instruction.line.x2 + scrollX));\n      line.setAttribute('y2', String(instruction.line.y2 + scrollY));\n      line.setAttribute('stroke', instruction.color);\n      group.append(line);\n      group.append(paintLabel(\n        instruction.label,\n        (instruction.line.x1 + instruction.line.x2) / 2 + scrollX,\n        (instruction.line.y1 + instruction.line.y2) / 2 + scrollY,\n      ));\n    }\n    svg.append(group);\n  }\n  document.documentElement.append(svg);\n  return visible.length;\n}\n\nexport function clearPresentationPaint(): void {\n  globalThis.document?.querySelector(`[${PRESENTATION_OVERLAY_ATTRIBUTE}]`)?.remove();\n}\n\nfunction paintLabel(text: string, x: number, y: number): SVGTextElement {\n  const value = document.createElementNS('http://www.w3.org/2000/svg', 'text');\n  value.setAttribute('x', String(x));\n  value.setAttribute('y', String(y));\n  value.setAttribute('fill', '#111');\n  value.setAttribute('stroke', '#fff');\n  value.setAttribute('stroke-width', '3');\n  value.setAttribute('paint-order', 'stroke');\n  value.setAttribute('font-family', 'ui-monospace, monospace');\n  value.setAttribute('font-size', '10');\n  value.textContent = text;\n  return value;\n}\n"]}

package/dist/bundle.d.ts

@@ -0,0 +1,3 @@
+/** Read the prebuilt sensing agent installed into the inspected page. */
+export declare function bundlePresentationAgent(): Promise<string>;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/bundle.js

@@ -0,0 +1,20 @@
+import { readFile } from 'node:fs/promises';
+import { fileURLToPath } from 'node:url';
+/** Read the prebuilt sensing agent installed into the inspected page. */
+export async function bundlePresentationAgent() {
+    const candidates = [
+        new URL('./browser-agent.bundle.js', import.meta.url),
+        new URL('../dist/browser-agent.bundle.js', import.meta.url),
+    ];
+    for (const path of candidates) {
+        try {
+            return await readFile(path, 'utf8');
+        }
+        catch {
+            // Source tests and installed consumers reach different emitted locations.
+        }
+    }
+    throw new Error(`the presentation sensing agent bundle is missing (looked in ` +
+        `${candidates.map((path) => fileURLToPath(path)).join(' and ')}); run the package build first`);
+}
+//# sourceMappingURL=bundle.js.map

package/dist/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../src/bundle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,MAAM,UAAU,GAAG;QACjB,IAAI,GAAG,CAAC,2BAA2B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC;QACrD,IAAI,GAAG,CAAC,iCAAiC,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC;KAC5D,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,0EAA0E;QAC5E,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CACb,8DAA8D;QAC5D,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,gCAAgC,CACjG,CAAC;AACJ,CAAC","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { fileURLToPath } from 'node:url';\n\n/** Read the prebuilt sensing agent installed into the inspected page. */\nexport async function bundlePresentationAgent(): Promise<string> {\n  const candidates = [\n    new URL('./browser-agent.bundle.js', import.meta.url),\n    new URL('../dist/browser-agent.bundle.js', import.meta.url),\n  ];\n  for (const path of candidates) {\n    try {\n      return await readFile(path, 'utf8');\n    } catch {\n      // Source tests and installed consumers reach different emitted locations.\n    }\n  }\n  throw new Error(\n    `the presentation sensing agent bundle is missing (looked in ` +\n      `${candidates.map((path) => fileURLToPath(path)).join(' and ')}); run the package build first`,\n  );\n}\n"]}

package/dist/compare.d.ts

@@ -0,0 +1,4 @@
+import type { PresentationComparison, PresentationReport } from './model.js';
+/** Compare independent presentation dimensions without collapsing them into a score or verdict. */
+export declare function comparePresentation(before: PresentationReport, after: PresentationReport): PresentationComparison;
+//# sourceMappingURL=compare.d.ts.map

package/dist/compare.js

@@ -0,0 +1,49 @@
+import { digestValue } from '@variance-authority/core';
+/** Compare independent presentation dimensions without collapsing them into a score or verdict. */
+export function comparePresentation(before, after) {
+    const beforeContent = contentIdentity(before);
+    const afterContent = contentIdentity(after);
+    const findings = before.findings === undefined || after.findings === undefined
+        ? undefined
+        : findingRules(before, after).map((rule) => {
+            const left = before.findings.filter((finding) => finding.rule === rule).length;
+            const right = after.findings.filter((finding) => finding.rule === rule).length;
+            return { rule, before: left, after: right, delta: right - left };
+        });
+    return {
+        formatVersion: 1,
+        before: before.digest,
+        after: after.digest,
+        ...(findings === undefined ? {} : { findings }),
+        information: {
+            content: {
+                before: beforeContent,
+                after: afterContent,
+                preserved: beforeContent === afterContent,
+            },
+            characters: {
+                before: before.telemetry.content.characters,
+                after: after.telemetry.content.characters,
+            },
+            elements: {
+                before: before.telemetry.content.elements,
+                after: after.telemetry.content.elements,
+            },
+            repeatedObjects: {
+                before: before.telemetry.content.repeatedObjects,
+                after: after.telemetry.content.repeatedObjects,
+            },
+        },
+    };
+}
+function contentIdentity(report) {
+    return digestValue({
+        content: report.contentDigest,
+        browserAccessibility: report.semantic.browserAccessibility,
+    });
+}
+function findingRules(before, after) {
+    return [...new Set([...(before.findings ?? []), ...(after.findings ?? [])].map((finding) => finding.rule))]
+        .sort((left, right) => (left < right ? -1 : left > right ? 1 : 0));
+}
+//# sourceMappingURL=compare.js.map

package/dist/compare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../src/compare.ts"],"names":[],"mappings":"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","sourcesContent":["import { digestValue } from '@variance-authority/core';\nimport type { PresentationComparison, PresentationFindingRule, PresentationReport } from './model.js';\n\n/** Compare independent presentation dimensions without collapsing them into a score or verdict. */\nexport function comparePresentation(\n  before: PresentationReport,\n  after: PresentationReport,\n): PresentationComparison {\n  const beforeContent = contentIdentity(before);\n  const afterContent = contentIdentity(after);\n  const findings =\n    before.findings === undefined || after.findings === undefined\n      ? undefined\n      : findingRules(before, after).map((rule) => {\n          const left = before.findings!.filter((finding) => finding.rule === rule).length;\n          const right = after.findings!.filter((finding) => finding.rule === rule).length;\n          return { rule, before: left, after: right, delta: right - left };\n        });\n  return {\n    formatVersion: 1,\n    before: before.digest,\n    after: after.digest,\n    ...(findings === undefined ? {} : { findings }),\n    information: {\n      content: {\n        before: beforeContent,\n        after: afterContent,\n        preserved: beforeContent === afterContent,\n      },\n      characters: {\n        before: before.telemetry.content.characters,\n        after: after.telemetry.content.characters,\n      },\n      elements: {\n        before: before.telemetry.content.elements,\n        after: after.telemetry.content.elements,\n      },\n      repeatedObjects: {\n        before: before.telemetry.content.repeatedObjects,\n        after: after.telemetry.content.repeatedObjects,\n      },\n    },\n  };\n}\n\nfunction contentIdentity(report: PresentationReport): ReturnType<typeof digestValue> {\n  return digestValue({\n    content: report.contentDigest,\n    browserAccessibility: report.semantic.browserAccessibility,\n  } as never);\n}\n\nfunction findingRules(\n  before: PresentationReport,\n  after: PresentationReport,\n): PresentationFindingRule[] {\n  return [...new Set([...(before.findings ?? []), ...(after.findings ?? [])].map((finding) => finding.rule))]\n    .sort((left, right) => (left < right ? -1 : left > right ? 1 : 0));\n}\n"]}

package/dist/findings.d.ts

@@ -0,0 +1,5 @@
+import type { BuiltGraph } from './graph.js';
+import type { Measurements } from './measure.js';
+import type { PresentationFinding, RepeatedPattern } from './model.js';
+export declare function detectFindings(graph: BuiltGraph, measured: Measurements, patterns: readonly RepeatedPattern[]): PresentationFinding[];
+//# sourceMappingURL=findings.d.ts.map

package/dist/findings.js

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