@variance-authority/presentation 0.1.0

package/dist/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../src/analyze.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  digestValue,\n  type AccessibilitySnapshot,\n  type RawCapture,\n  type RawNode,\n} from '@variance-authority/core';\nimport { detectFindings } from './findings.js';\nimport { buildGraph } from './graph.js';\nimport { measureGraph } from './measure.js';\nimport type { PresentationReport } from './model.js';\nimport { paintInstructions } from './paint.js';\nimport { inferPatterns } from './patterns.js';\nimport { telemetryOf } from './telemetry.js';\n\nexport interface AnalyzePresentationOptions {\n  /**\n   * Browser-computed ARIA evidence observed beside this capture.\n   *\n   * Omit only when it was not observed. `roots: ['']` and partial roots are\n   * readings and remain byte-for-byte present in the report.\n   */\n  readonly accessibility?: AccessibilitySnapshot;\n}\n\n/**\n * Derive machine-readable presentation relationships from one browser capture.\n *\n * Telemetry is descriptive and never creates a finding by itself. Findings are\n * limited to measured relationships; this function does not recommend a layout,\n * remove information, or produce an overall quality score.\n */\nexport function analyzePresentation(\n  capture: RawCapture,\n  options: AnalyzePresentationOptions = {},\n): PresentationReport {\n  const anchors = semanticAnchors(capture);\n  const contentDigest = digestValue(contentEvidence(capture) as never);\n  if (!capture.profile.layout) {\n    const body = {\n      formatVersion: 1 as const,\n      contentDigest,\n      subject: capture.subject,\n      ...fontsOf(capture),\n      semantic: {\n        anchors,\n        ...(options.accessibility === undefined ? {} : { browserAccessibility: options.accessibility }),\n      },\n      telemetry: telemetryOf(capture, [], undefined),\n      graph: { nodes: [], relations: [] },\n    };\n    return { ...body, digest: digestValue(body as never) };\n  }\n  assertLayout(capture);\n  const graph = buildGraph(capture);\n  const measured = measureGraph(graph);\n  const inferred = inferPatterns(graph, measured);\n  const findings = detectFindings(graph, measured, inferred.patterns);\n  const relations = [...measured.relations, ...inferred.peerRelations];\n  const paint = paintInstructions({\n    nodes: measured.nodes,\n    relations,\n    axes: measured.axes,\n    baselines: measured.baselines,\n    prominence: measured.prominence,\n    surfaces: measured.surfaces,\n    patterns: inferred.patterns,\n    findings,\n  });\n  const body = {\n    formatVersion: 1 as const,\n    contentDigest,\n    subject: capture.subject,\n    ...fontsOf(capture),\n    semantic: {\n      anchors,\n      ...(options.accessibility === undefined ? {} : { browserAccessibility: options.accessibility }),\n    },\n    telemetry: telemetryOf(capture, measured.nodes, inferred.patterns),\n    graph: { nodes: measured.nodes, relations },\n    spacing: measured.spacing,\n    axes: measured.axes,\n    baselines: measured.baselines,\n    prominence: measured.prominence,\n    surfaces: measured.surfaces,\n    patterns: inferred.patterns,\n    findings,\n    paint,\n  };\n  return { ...body, digest: digestValue(body as never) };\n}\n\n/**\n * Carry the caller-established font identities onto the report.\n *\n * The live entry accepts a `fonts` option and threads it into the capture, and\n * the capture is then analyzed and dropped — so through that door the option\n * had no observable consequence at all. It has one here. Fonts are a render\n * input of the more consequential kind: a substitution moves every metric on\n * the page without changing a byte of code, so a reading taken under different\n * pinned identities is a different reading and the digest says so.\n *\n * Sorted, because the order a caller happened to list them in is not part of\n * their identity — the same position `normalize` takes on the environment key.\n * Absent rather than empty when none were established, matching the capture,\n * which says the same thing a second way with its `unverified-fonts` caveat.\n * The content digest is deliberately untouched: font identity is presentation,\n * and content identity is what has to survive presentation moving.\n */\nfunction fontsOf(capture: RawCapture): { fonts?: readonly string[] } {\n  const fonts = capture.environment.fonts;\n  return fonts.length === 0 ? {} : { fonts: [...fonts].sort() };\n}\n\nfunction contentEvidence(capture: RawCapture): unknown {\n  const read = (node: RawNode): unknown => ({\n    tag: node.tag,\n    ...(node.aria === undefined ? {} : { aria: node.aria }),\n    ...(node.text === undefined ? {} : { text: node.text }),\n    children: node.children.map(read),\n    ...(node.shadowChildren === undefined ? {} : { shadowChildren: node.shadowChildren.map(read) }),\n  });\n  return {\n    root: read(capture.root),\n    ...(capture.portals === undefined ? {} : { portals: capture.portals.map(read) }),\n  };\n}\n\nfunction semanticAnchors(capture: RawCapture): string[] {\n  const anchors: string[] = [];\n  [capture.root, ...(capture.portals ?? [])].forEach((root, rootIndex) => walk(root, rootIndex, '0'));\n  return anchors;\n\n  function walk(node: RawNode, root: number, path: string): void {\n    if (\n      node.tag !== '#text' &&\n      node.aria !== undefined &&\n      (node.aria.role !== null || node.aria.name !== null)\n    ) {\n      const role = node.aria?.role ?? node.tag;\n      const name = node.aria?.name ?? '';\n      anchors.push(`r${root}:${path} ${role}${name.length > 0 ? ` \"${name}\"` : ''}`);\n    }\n    node.children.forEach((child, index) => walk(child, root, `${path}/${index}`));\n    node.shadowChildren?.forEach((child, index) => walk(child, root, `${path}/shadow:${index}`));\n  }\n}\n\nfunction assertLayout(capture: RawCapture): void {\n  [capture.root, ...(capture.portals ?? [])].forEach((root, rootIndex) => walk(root, `r${rootIndex}:0`));\n\n  function walk(node: RawNode, path: string): void {\n    if (node.tag !== '#text' && node.rect === undefined) {\n      throw new Error(\n        `the ${capture.profile.id} capture claims layout is observable but ${path} has no rect; ` +\n          'an absent measurement cannot be analyzed as an empty box',\n      );\n    }\n    node.children.forEach((child, index) => walk(child, `${path}/${index}`));\n    node.shadowChildren?.forEach((child, index) => walk(child, `${path}/shadow:${index}`));\n  }\n}\n"]}

package/dist/browser-agent-entry.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser-agent-entry.d.ts.map

package/dist/browser-agent-entry.js

@@ -0,0 +1,8 @@
+import { acquirePresentation, clearPresentationPaint, paintPresentation, PRESENTATION_AGENT, PRESENTATION_AGENT_VERSION, } from './browser-agent.js';
+globalThis[PRESENTATION_AGENT] = {
+    acquire: acquirePresentation,
+    paint: paintPresentation,
+    clear: clearPresentationPaint,
+    version: PRESENTATION_AGENT_VERSION,
+};
+//# sourceMappingURL=browser-agent-entry.js.map

package/dist/browser-agent-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-agent-entry.js","sourceRoot":"","sources":["../src/browser-agent-entry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,GAE3B,MAAM,oBAAoB,CAAC;AAE3B,UAAoE,CAAC,kBAAkB,CAAC,GAAG;IAC1F,OAAO,EAAE,mBAAmB;IAC5B,KAAK,EAAE,iBAAiB;IACxB,KAAK,EAAE,sBAAsB;IAC7B,OAAO,EAAE,0BAA0B;CACpC,CAAC","sourcesContent":["import {\n  acquirePresentation,\n  clearPresentationPaint,\n  paintPresentation,\n  PRESENTATION_AGENT,\n  PRESENTATION_AGENT_VERSION,\n  type InstalledPresentationAgent,\n} from './browser-agent.js';\n\n(globalThis as unknown as Record<string, InstalledPresentationAgent>)[PRESENTATION_AGENT] = {\n  acquire: acquirePresentation,\n  paint: paintPresentation,\n  clear: clearPresentationPaint,\n  version: PRESENTATION_AGENT_VERSION,\n};\n"]}