@variance-authority/core 0.14.0 → 0.17.1

package/dist/format/shape.js

@@ -0,0 +1,269 @@
+import { FORMAT_VERSION } from './packed.js';
+/**
+ * Whether a value read back from a file or a store is the format it claims.
+ *
+ * Read, not believed: a value parsed from JSON is `unknown` until one of these
+ * says otherwise, and each checks every field its type declares, so that there
+ * is one answer to what a snapshot, a document or a subject is. What a reader
+ * can re-derive, a digest against the bytes it names, is the reader's to check.
+ */
+/**
+ * Whether a value is a `SemanticSnapshot`, every node down to the leaves.
+ *
+ * The readers walk all of it: the matcher pairs every child, and a node that is
+ * not one throws there instead of reading as a snapshot that is not recorded.
+ * A capture file and a packed snapshot are the two places one is read back.
+ * Whose snapshot it is, against the subject it was filed under, is the
+ * reader's question.
+ */
+export function isSemanticSnapshot(value) {
+    const snapshot = record(value);
+    const profile = snapshot === null ? null : record(snapshot.profile);
+    const environment = snapshot === null ? null : record(snapshot.environment);
+    const root = snapshot === null ? null : record(snapshot.root);
+    return (snapshot !== null &&
+        snapshot.formatVersion === FORMAT_VERSION &&
+        isSubjectRef(snapshot.subject) &&
+        profile !== null &&
+        (profile.id === 'jsdom' || profile.id === 'chromium') &&
+        ['ariaTree', 'declaredStyle', 'computedStyle', 'layout', 'raster'].every((field) => typeof profile[field] === 'boolean') &&
+        environment !== null &&
+        typeof environment.digest === 'string' &&
+        typeof environment.semanticDigest === 'string' &&
+        environmentInputsShape(environment.inputs) &&
+        typeof snapshot.renderHash === 'string' &&
+        typeof snapshot.structureHash === 'string' &&
+        typeof snapshot.styleHash === 'string' &&
+        root !== null &&
+        semanticNodeShape(root) &&
+        Array.isArray(snapshot.styleProvenance) &&
+        snapshot.styleProvenance.every(styleProvenanceShape) &&
+        (snapshot.ignoreSites === undefined ||
+            (Array.isArray(snapshot.ignoreSites) && snapshot.ignoreSites.every(ignoreSiteShape))) &&
+        diagnosticArray(snapshot.diagnostics));
+}
+/**
+ * Whether a value is a `RenderDocument`, its resources' shape included.
+ *
+ * Shape only: that a resource's bytes are base64 and hash to its digest, and
+ * that a document is resource-closed, are what a reader that needs them checks.
+ */
+export function isRenderDocument(value) {
+    const document = record(value);
+    const frame = document === null ? null : record(document.frame);
+    const viewport = document === null ? null : record(document.viewport);
+    return (document !== null &&
+        document.documentVersion === 1 &&
+        isSubjectRef(document.subject) &&
+        typeof document.html === 'string' &&
+        frame !== null &&
+        stringRecord(frame.html) &&
+        stringRecord(frame.body) &&
+        Array.isArray(frame.ancestors) &&
+        frame.ancestors.every(frameElementShape) &&
+        (frame.containerWidth === undefined || finiteNumber(frame.containerWidth)) &&
+        stringArray(document.css) &&
+        viewport !== null &&
+        finiteNumber(viewport.width) &&
+        finiteNumber(viewport.height) &&
+        finiteNumber(viewport.deviceScaleFactor) &&
+        (viewport.colorScheme === 'light' || viewport.colorScheme === 'dark') &&
+        stringRecord(document.inherited) &&
+        stringArray(document.fonts) &&
+        (document.assets === undefined || stringRecord(document.assets)) &&
+        optionalString(document.baseUrl) &&
+        (document.resources === undefined ||
+            (record(document.resources) !== null && Object.values(document.resources).every(resourceShape))) &&
+        diagnosticArray(document.diagnostics));
+}
+/** Whether a value is a `SubjectRef`: an id, one of the four kinds, and an optional title. */
+export function isSubjectRef(value) {
+    const subject = record(value);
+    return subject !== null &&
+        typeof subject.id === 'string' &&
+        ['story', 'route', 'fixture', 'value'].includes(String(subject.kind)) &&
+        optionalString(subject.title);
+}
+function frameElementShape(value) {
+    const element = record(value);
+    return element !== null && typeof element.tag === 'string' && stringRecord(element.attributes);
+}
+function resourceShape(value) {
+    const resource = record(value);
+    return resource !== null &&
+        typeof resource.contentType === 'string' &&
+        typeof resource.bytes === 'string' &&
+        typeof resource.digest === 'string' &&
+        (resource.status === undefined || finiteNumber(resource.status));
+}
+function environmentInputsShape(value) {
+    const inputs = record(value);
+    const viewport = inputs === null ? null : record(inputs.viewport);
+    return inputs !== null &&
+        (inputs.profile === 'jsdom' || inputs.profile === 'chromium') &&
+        typeof inputs.engine === 'string' &&
+        typeof inputs.ruleset === 'string' &&
+        typeof inputs.allowlist === 'string' &&
+        viewport !== null &&
+        finiteNumber(viewport.width) &&
+        finiteNumber(viewport.height) &&
+        finiteNumber(viewport.deviceScaleFactor) &&
+        (viewport.colorScheme === 'light' || viewport.colorScheme === 'dark') &&
+        stringArray(inputs.fonts) &&
+        scalarRecord(inputs.conditions) &&
+        stringRecord(inputs.assets) &&
+        optionalString(inputs.stabilization) &&
+        optionalString(inputs.timezoneId) &&
+        optionalString(inputs.locale);
+}
+function styleProvenanceShape(value) {
+    const entry = record(value);
+    if (entry === null ||
+        typeof entry.path !== 'string' ||
+        typeof entry.property !== 'string' ||
+        typeof entry.sheet !== 'string' ||
+        typeof entry.selector !== 'string' ||
+        !optionalString(entry.tokenName))
+        return false;
+    if (entry.source === undefined)
+        return true;
+    const source = record(entry.source);
+    return source !== null && typeof source.file === 'string' && finiteNumber(source.line);
+}
+function semanticNodeShape(node) {
+    return (typeof node.path === 'string' &&
+        typeof node.tag === 'string' &&
+        optionalString(node.alias) &&
+        optionalString(node.role) &&
+        optionalString(node.name) &&
+        optionalString(node.description) &&
+        (node.state === undefined || scalarRecord(node.state)) &&
+        stringRecord(node.attributes) &&
+        stringRecord(node.style) &&
+        (node.tokens === undefined || stringRecord(node.tokens)) &&
+        (node.styleTokens === undefined || stringRecord(node.styleTokens)) &&
+        (node.rect === undefined || rectShape(node.rect)) &&
+        optionalString(node.text) &&
+        (node.provenance === undefined || provenanceShape(node.provenance)) &&
+        (node.wiring === undefined || wiringShape(node.wiring)) &&
+        (node.holding === undefined || holdingShape(node.holding)) &&
+        (node.portalled === undefined || typeof node.portalled === 'boolean') &&
+        (node.ignoredBy === undefined || stringArray(node.ignoredBy)) &&
+        optionalString(node.unread) &&
+        Array.isArray(node.children) &&
+        node.children.every((child) => {
+            const parsed = record(child);
+            return parsed !== null && semanticNodeShape(parsed);
+        }));
+}
+function ignoreSiteShape(value) {
+    const site = record(value);
+    return site !== null &&
+        typeof site.path === 'string' &&
+        typeof site.rule === 'string' &&
+        (site.rect === undefined || rectShape(site.rect));
+}
+function rectShape(value) {
+    const rect = record(value);
+    return rect !== null &&
+        finiteNumber(rect.x) &&
+        finiteNumber(rect.y) &&
+        finiteNumber(rect.width) &&
+        finiteNumber(rect.height);
+}
+function provenanceShape(value) {
+    const provenance = record(value);
+    return provenance !== null &&
+        Array.isArray(provenance.owners) &&
+        provenance.owners.every(ownerShape) &&
+        optionalString(provenance.createdBy) &&
+        (provenance.source === undefined || sourceLocationShape(provenance.source)) &&
+        (provenance.stack === undefined ||
+            (Array.isArray(provenance.stack) && provenance.stack.every(stackFrameShape)));
+}
+function ownerShape(value) {
+    const owner = record(value);
+    return owner !== null &&
+        typeof owner.name === 'string' &&
+        typeof owner.propsDigest === 'string' &&
+        optionalString(owner.createdBy);
+}
+function sourceLocationShape(value) {
+    const source = record(value);
+    return source !== null &&
+        typeof source.file === 'string' &&
+        finiteNumber(source.line) &&
+        finiteNumber(source.column);
+}
+function stackFrameShape(value) {
+    const frame = record(value);
+    return frame !== null &&
+        typeof frame.url === 'string' &&
+        finiteNumber(frame.line) &&
+        finiteNumber(frame.column) &&
+        optionalString(frame.function);
+}
+function wiringShape(value) {
+    const wiring = record(value);
+    return wiring !== null &&
+        (wiring.hooks === undefined || stringArray(wiring.hooks)) &&
+        (wiring.wrappers === undefined ||
+            (Array.isArray(wiring.wrappers) &&
+                wiring.wrappers.every((entry) => entry === 'memo' || entry === 'forwardRef'))) &&
+        (wiring.contexts === undefined || stringArray(wiring.contexts)) &&
+        optionalString(wiring.key);
+}
+function holdingShape(value) {
+    const holding = record(value);
+    return holding !== null &&
+        (holding.cells === undefined || (Array.isArray(holding.cells) && holding.cells.every((value) => {
+            const cell = record(value);
+            return cell !== null && finiteNumber(cell.index) && typeof cell.hook === 'string' && typeof cell.digest === 'string';
+        }))) &&
+        (holding.contexts === undefined || heldValues(holding.contexts)) &&
+        (holding.props === undefined || heldValues(holding.props)) &&
+        optionalString(holding.unread);
+}
+function heldValues(value) {
+    return Array.isArray(value) && value.every((entry) => {
+        const held = record(entry);
+        return held !== null && typeof held.name === 'string' && typeof held.digest === 'string';
+    });
+}
+function diagnosticArray(value) {
+    return Array.isArray(value) && value.every((entry) => {
+        const diagnostic = record(entry);
+        return diagnostic !== null &&
+            (diagnostic.severity === 'warn' || diagnostic.severity === 'error') &&
+            typeof diagnostic.code === 'string' &&
+            typeof diagnostic.message === 'string' &&
+            optionalString(diagnostic.nodePath);
+    });
+}
+// A plain object. `@variance-authority/unit-test`'s capture-file reader keeps
+// the same guard privately: it is re-typed in several packages and has no
+// exported owner, and exporting it from here would make it part of the format.
+function record(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+function stringRecord(value) {
+    const parsed = record(value);
+    return parsed !== null && Object.values(parsed).every((entry) => typeof entry === 'string');
+}
+function scalarRecord(value) {
+    const parsed = record(value);
+    return parsed !== null && Object.values(parsed).every((entry) => ['string', 'boolean', 'number'].includes(typeof entry) &&
+        (typeof entry !== 'number' || Number.isFinite(entry)));
+}
+function stringArray(value) {
+    return Array.isArray(value) && value.every((entry) => typeof entry === 'string');
+}
+function optionalString(value) {
+    return value === undefined || typeof value === 'string';
+}
+function finiteNumber(value) {
+    return typeof value === 'number' && Number.isFinite(value);
+}
+//# sourceMappingURL=shape.js.map

package/dist/format/shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.js","sourceRoot":"","sources":["../../src/format/shape.ts"],"names":[],"mappings":"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","sourcesContent":["import type { SubjectRef } from './capture.js';\nimport type { RenderDocument } from './document.js';\nimport { FORMAT_VERSION } from './packed.js';\nimport type { SemanticSnapshot } from './snapshot.js';\n\n/**\n * Whether a value read back from a file or a store is the format it claims.\n *\n * Read, not believed: a value parsed from JSON is `unknown` until one of these\n * says otherwise, and each checks every field its type declares, so that there\n * is one answer to what a snapshot, a document or a subject is. What a reader\n * can re-derive, a digest against the bytes it names, is the reader's to check.\n */\n\n/**\n * Whether a value is a `SemanticSnapshot`, every node down to the leaves.\n *\n * The readers walk all of it: the matcher pairs every child, and a node that is\n * not one throws there instead of reading as a snapshot that is not recorded.\n * A capture file and a packed snapshot are the two places one is read back.\n * Whose snapshot it is, against the subject it was filed under, is the\n * reader's question.\n */\nexport function isSemanticSnapshot(value: unknown): value is SemanticSnapshot {\n  const snapshot = record(value);\n  const profile = snapshot === null ? null : record(snapshot.profile);\n  const environment = snapshot === null ? null : record(snapshot.environment);\n  const root = snapshot === null ? null : record(snapshot.root);\n  return (\n    snapshot !== null &&\n    snapshot.formatVersion === FORMAT_VERSION &&\n    isSubjectRef(snapshot.subject) &&\n    profile !== null &&\n    (profile.id === 'jsdom' || profile.id === 'chromium') &&\n    ['ariaTree', 'declaredStyle', 'computedStyle', 'layout', 'raster'].every(\n      (field) => typeof profile[field] === 'boolean',\n    ) &&\n    environment !== null &&\n    typeof environment.digest === 'string' &&\n    typeof environment.semanticDigest === 'string' &&\n    environmentInputsShape(environment.inputs) &&\n    typeof snapshot.renderHash === 'string' &&\n    typeof snapshot.structureHash === 'string' &&\n    typeof snapshot.styleHash === 'string' &&\n    root !== null &&\n    semanticNodeShape(root) &&\n    Array.isArray(snapshot.styleProvenance) &&\n    snapshot.styleProvenance.every(styleProvenanceShape) &&\n    (snapshot.ignoreSites === undefined ||\n      (Array.isArray(snapshot.ignoreSites) && snapshot.ignoreSites.every(ignoreSiteShape))) &&\n    diagnosticArray(snapshot.diagnostics)\n  );\n}\n\n/**\n * Whether a value is a `RenderDocument`, its resources' shape included.\n *\n * Shape only: that a resource's bytes are base64 and hash to its digest, and\n * that a document is resource-closed, are what a reader that needs them checks.\n */\nexport function isRenderDocument(value: unknown): value is RenderDocument {\n  const document = record(value);\n  const frame = document === null ? null : record(document.frame);\n  const viewport = document === null ? null : record(document.viewport);\n  return (\n    document !== null &&\n    document.documentVersion === 1 &&\n    isSubjectRef(document.subject) &&\n    typeof document.html === 'string' &&\n    frame !== null &&\n    stringRecord(frame.html) &&\n    stringRecord(frame.body) &&\n    Array.isArray(frame.ancestors) &&\n    frame.ancestors.every(frameElementShape) &&\n    (frame.containerWidth === undefined || finiteNumber(frame.containerWidth)) &&\n    stringArray(document.css) &&\n    viewport !== null &&\n    finiteNumber(viewport.width) &&\n    finiteNumber(viewport.height) &&\n    finiteNumber(viewport.deviceScaleFactor) &&\n    (viewport.colorScheme === 'light' || viewport.colorScheme === 'dark') &&\n    stringRecord(document.inherited) &&\n    stringArray(document.fonts) &&\n    (document.assets === undefined || stringRecord(document.assets)) &&\n    optionalString(document.baseUrl) &&\n    (document.resources === undefined ||\n      (record(document.resources) !== null && Object.values(document.resources as object).every(resourceShape))) &&\n    diagnosticArray(document.diagnostics)\n  );\n}\n\n/** Whether a value is a `SubjectRef`: an id, one of the four kinds, and an optional title. */\nexport function isSubjectRef(value: unknown): value is SubjectRef {\n  const subject = record(value);\n  return subject !== null &&\n    typeof subject.id === 'string' &&\n    ['story', 'route', 'fixture', 'value'].includes(String(subject.kind)) &&\n    optionalString(subject.title);\n}\n\nfunction frameElementShape(value: unknown): boolean {\n  const element = record(value);\n  return element !== null && typeof element.tag === 'string' && stringRecord(element.attributes);\n}\n\nfunction resourceShape(value: unknown): boolean {\n  const resource = record(value);\n  return resource !== null &&\n    typeof resource.contentType === 'string' &&\n    typeof resource.bytes === 'string' &&\n    typeof resource.digest === 'string' &&\n    (resource.status === undefined || finiteNumber(resource.status));\n}\n\nfunction environmentInputsShape(value: unknown): boolean {\n  const inputs = record(value);\n  const viewport = inputs === null ? null : record(inputs.viewport);\n  return inputs !== null &&\n    (inputs.profile === 'jsdom' || inputs.profile === 'chromium') &&\n    typeof inputs.engine === 'string' &&\n    typeof inputs.ruleset === 'string' &&\n    typeof inputs.allowlist === 'string' &&\n    viewport !== null &&\n    finiteNumber(viewport.width) &&\n    finiteNumber(viewport.height) &&\n    finiteNumber(viewport.deviceScaleFactor) &&\n    (viewport.colorScheme === 'light' || viewport.colorScheme === 'dark') &&\n    stringArray(inputs.fonts) &&\n    scalarRecord(inputs.conditions) &&\n    stringRecord(inputs.assets) &&\n    optionalString(inputs.stabilization) &&\n    optionalString(inputs.timezoneId) &&\n    optionalString(inputs.locale);\n}\n\nfunction styleProvenanceShape(value: unknown): boolean {\n  const entry = record(value);\n  if (entry === null ||\n    typeof entry.path !== 'string' ||\n    typeof entry.property !== 'string' ||\n    typeof entry.sheet !== 'string' ||\n    typeof entry.selector !== 'string' ||\n    !optionalString(entry.tokenName)) return false;\n  if (entry.source === undefined) return true;\n  const source = record(entry.source);\n  return source !== null && typeof source.file === 'string' && finiteNumber(source.line);\n}\n\nfunction semanticNodeShape(node: Record<string, unknown>): boolean {\n  return (\n    typeof node.path === 'string' &&\n    typeof node.tag === 'string' &&\n    optionalString(node.alias) &&\n    optionalString(node.role) &&\n    optionalString(node.name) &&\n    optionalString(node.description) &&\n    (node.state === undefined || scalarRecord(node.state)) &&\n    stringRecord(node.attributes) &&\n    stringRecord(node.style) &&\n    (node.tokens === undefined || stringRecord(node.tokens)) &&\n    (node.styleTokens === undefined || stringRecord(node.styleTokens)) &&\n    (node.rect === undefined || rectShape(node.rect)) &&\n    optionalString(node.text) &&\n    (node.provenance === undefined || provenanceShape(node.provenance)) &&\n    (node.wiring === undefined || wiringShape(node.wiring)) &&\n    (node.holding === undefined || holdingShape(node.holding)) &&\n    (node.portalled === undefined || typeof node.portalled === 'boolean') &&\n    (node.ignoredBy === undefined || stringArray(node.ignoredBy)) &&\n    optionalString(node.unread) &&\n    Array.isArray(node.children) &&\n    node.children.every((child) => {\n      const parsed = record(child);\n      return parsed !== null && semanticNodeShape(parsed);\n    })\n  );\n}\n\nfunction ignoreSiteShape(value: unknown): boolean {\n  const site = record(value);\n  return site !== null &&\n    typeof site.path === 'string' &&\n    typeof site.rule === 'string' &&\n    (site.rect === undefined || rectShape(site.rect));\n}\n\nfunction rectShape(value: unknown): boolean {\n  const rect = record(value);\n  return rect !== null &&\n    finiteNumber(rect.x) &&\n    finiteNumber(rect.y) &&\n    finiteNumber(rect.width) &&\n    finiteNumber(rect.height);\n}\n\nfunction provenanceShape(value: unknown): boolean {\n  const provenance = record(value);\n  return provenance !== null &&\n    Array.isArray(provenance.owners) &&\n    provenance.owners.every(ownerShape) &&\n    optionalString(provenance.createdBy) &&\n    (provenance.source === undefined || sourceLocationShape(provenance.source)) &&\n    (provenance.stack === undefined ||\n      (Array.isArray(provenance.stack) && provenance.stack.every(stackFrameShape)));\n}\n\nfunction ownerShape(value: unknown): boolean {\n  const owner = record(value);\n  return owner !== null &&\n    typeof owner.name === 'string' &&\n    typeof owner.propsDigest === 'string' &&\n    optionalString(owner.createdBy);\n}\n\nfunction sourceLocationShape(value: unknown): boolean {\n  const source = record(value);\n  return source !== null &&\n    typeof source.file === 'string' &&\n    finiteNumber(source.line) &&\n    finiteNumber(source.column);\n}\n\nfunction stackFrameShape(value: unknown): boolean {\n  const frame = record(value);\n  return frame !== null &&\n    typeof frame.url === 'string' &&\n    finiteNumber(frame.line) &&\n    finiteNumber(frame.column) &&\n    optionalString(frame.function);\n}\n\nfunction wiringShape(value: unknown): boolean {\n  const wiring = record(value);\n  return wiring !== null &&\n    (wiring.hooks === undefined || stringArray(wiring.hooks)) &&\n    (wiring.wrappers === undefined ||\n      (Array.isArray(wiring.wrappers) &&\n        wiring.wrappers.every((entry) => entry === 'memo' || entry === 'forwardRef'))) &&\n    (wiring.contexts === undefined || stringArray(wiring.contexts)) &&\n    optionalString(wiring.key);\n}\n\nfunction holdingShape(value: unknown): boolean {\n  const holding = record(value);\n  return holding !== null &&\n    (holding.cells === undefined || (Array.isArray(holding.cells) && holding.cells.every((value) => {\n      const cell = record(value);\n      return cell !== null && finiteNumber(cell.index) && typeof cell.hook === 'string' && typeof cell.digest === 'string';\n    }))) &&\n    (holding.contexts === undefined || heldValues(holding.contexts)) &&\n    (holding.props === undefined || heldValues(holding.props)) &&\n    optionalString(holding.unread);\n}\n\nfunction heldValues(value: unknown): boolean {\n  return Array.isArray(value) && value.every((entry) => {\n    const held = record(entry);\n    return held !== null && typeof held.name === 'string' && typeof held.digest === 'string';\n  });\n}\n\nfunction diagnosticArray(value: unknown): boolean {\n  return Array.isArray(value) && value.every((entry) => {\n    const diagnostic = record(entry);\n    return diagnostic !== null &&\n      (diagnostic.severity === 'warn' || diagnostic.severity === 'error') &&\n      typeof diagnostic.code === 'string' &&\n      typeof diagnostic.message === 'string' &&\n      optionalString(diagnostic.nodePath);\n  });\n}\n\n// A plain object. `@variance-authority/unit-test`'s capture-file reader keeps\n// the same guard privately: it is re-typed in several packages and has no\n// exported owner, and exporting it from here would make it part of the format.\nfunction record(value: unknown): Record<string, unknown> | null {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\nfunction stringRecord(value: unknown): boolean {\n  const parsed = record(value);\n  return parsed !== null && Object.values(parsed).every((entry) => typeof entry === 'string');\n}\n\nfunction scalarRecord(value: unknown): boolean {\n  const parsed = record(value);\n  return parsed !== null && Object.values(parsed).every(\n    (entry) => ['string', 'boolean', 'number'].includes(typeof entry) &&\n      (typeof entry !== 'number' || Number.isFinite(entry)),\n  );\n}\n\nfunction stringArray(value: unknown): boolean {\n  return Array.isArray(value) && value.every((entry) => typeof entry === 'string');\n}\n\nfunction optionalString(value: unknown): boolean {\n  return value === undefined || typeof value === 'string';\n}\n\nfunction finiteNumber(value: unknown): boolean {\n  return typeof value === 'number' && Number.isFinite(value);\n}\n"]}

package/dist/format/snapshot.d.ts

@@ -162,6 +162,8 @@ export interface SemanticNode {
      * on `RawNode`. See {@link SemanticSnapshot.ignoreSites}.
      */
     readonly ignoredBy?: readonly string[];
+    /** What was not read about this node, carried from `RawNode.unread`. Outside every hash. */
+    readonly unread?: string;
     readonly children: readonly SemanticNode[];
 }
 /**

package/dist/format/snapshot.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/format/snapshot.ts"],"names":[],"mappings":"","sourcesContent":["import type { SubjectRef, Rect, Diagnostic } from './capture.js';\nimport type { EnvironmentKey } from './environment.js';\nimport type { Digest } from './hash.js';\nimport type { ObservationProfile } from './profile.js';\nimport type { Provenance } from './provenance.js';\nimport type { Wiring } from './wiring.js';\nimport type { Holding } from './holding.js';\n\n/**\n * The normalized semantic snapshot: the verdict's input, and the thing a render\n * hash addresses.\n *\n * Everything volatile is gone by this point. Ids have become structural aliases,\n * class attributes have been dropped entirely, inapplicable CSS has been pruned,\n * and the cascade has been resolved to winning values (ADR-0003). What remains is\n * meant to be *read*: a snapshot a reviewer refuses to open is a snapshot that\n * gets rubber-stamped.\n */\nexport interface SemanticSnapshot {\n  readonly formatVersion: 1;\n  readonly subject: SubjectRef;\n  readonly profile: ObservationProfile;\n  readonly environment: EnvironmentKey;\n\n  /** Content hash of `root` under `environment`. The identity of this state. */\n  readonly renderHash: Digest;\n\n  /**\n   * Structure and applicable style, hashed separately.\n   *\n   * These back the tier below full semantic comparison (ADR-0003): matching both\n   * settles a subject without resolving layout or taking a screenshot. Split\n   * rather than combined because the docket wants to say *which* held — \"the DOM\n   * is identical, only styling moved\" is the sentence that turns a diff into a\n   * token-band root.\n   */\n  readonly structureHash: Digest;\n  readonly styleHash: Digest;\n\n  readonly root: SemanticNode;\n\n  /**\n   * Where each winning declaration came from. Deliberately outside the hash.\n   *\n   * Pruning discards exactly what attribution needs — *which rule set this?* — so\n   * it is preserved here instead. Keeping it out of the hash is the point: moving\n   * a rule between files renames a source without changing a render, and must not\n   * invalidate a baseline.\n   */\n  readonly styleProvenance: readonly StyleProvenanceEntry[];\n\n  /**\n   * Subtrees the operator declared out of scope, resolved against *this* tree.\n   *\n   * Deliberately outside the hash, for the reason `styleProvenance` is: an ignore\n   * changes what a run says about a render, never the render. Folding it into the\n   * identity would invalidate every baseline in the repository the first time\n   * somebody masked a clock, which is the surest way to make a safety feature the\n   * thing people turn off.\n   *\n   * Present only when something was excluded, so a snapshot from a run with no\n   * ignores is byte-identical to one produced before this field existed.\n   */\n  readonly ignoreSites?: readonly IgnoreSite[];\n\n  /**\n   * What the collector or the normalizer could not do, carried forward.\n   *\n   * Outside the hash: a diagnostic describes the *observation*, not the render,\n   * and a snapshot that hashed its own warnings would invalidate whenever the\n   * warning text was reworded. But it must survive to the verdict — a subject\n   * whose capture half-failed is not a subject that legitimately `unchanged`,\n   * and silently discarding that fact is how a broken collector reads as a clean\n   * build.\n   */\n  readonly diagnostics: readonly Diagnostic[];\n}\n\n/**\n * A node's stable address: child indices from the root, e.g. `0/2/1`.\n *\n * Positional because nothing else survives. Ids are volatile (that is why they\n * were aliased away), and class names have been dropped. Position is honest about\n * what it costs: inserting a sibling renumbers everything after it, so the differ\n * matches nodes by shape and provenance before falling back to path (see\n * `diff.ts`), and treats a path change alone as evidence of nothing.\n */\nexport type NodePath = string;\n\nexport interface SemanticNode {\n  readonly path: NodePath;\n  readonly tag: string;\n\n  /** Structural alias, e.g. `#a0`. Absent when the node carried no id. */\n  readonly alias?: string;\n\n  readonly role?: string;\n  readonly name?: string;\n\n  /**\n   * Accessible description, resolved. See `RawAria.description` for why this is\n   * a field of its own rather than an attribute.\n   */\n  readonly description?: string;\n\n  readonly state?: Readonly<Record<string, string | boolean | number>>;\n\n  /** Semantic attributes surviving normalization. `class` is never among them. */\n  readonly attributes: Readonly<Record<string, string>>;\n\n  /** Winning values for allowlisted properties, canonicalized. */\n  readonly style: Readonly<Record<string, string>>;\n\n  /**\n   * Custom properties this node's winning declarations resolved through, as\n   * name → resolved value.\n   *\n   * Recording the name alongside the value is what lets a design-token change\n   * surface as one root with counted collateral instead of hundreds of unrelated\n   * colour diffs (spec §5, `token` band).\n   */\n  readonly tokens?: Readonly<Record<string, string>>;\n\n  /**\n   * Which token each styled property resolved through, including by inheritance.\n   *\n   * Outside the hash, like `styleProvenance` and for the same reason: swapping a\n   * literal for a token of the same value renames a source without changing a\n   * render. It exists so the differ can tell *which* property a token edit\n   * explains — `tokens` alone says a node uses tokens, not which of its values\n   * one drove.\n   */\n  readonly styleTokens?: Readonly<Record<string, string>>;\n\n  /** Present only under a profile with layout. Absent, never zeroed (ADR-0002). */\n  readonly rect?: Rect;\n\n  /** Text content, or its digest when policy declares the region volatile. */\n  readonly text?: string;\n\n  readonly provenance?: Provenance;\n\n  /**\n   * How the framework holds this node's component, when a framework adapter\n   * supplied it. See {@link Wiring}.\n   *\n   * On the node rather than on `Provenance`, though both come from the same\n   * adapter and the same fiber, because they answer to different readers.\n   * Provenance exists so a diff arrives carrying a name; wiring is a *dimension\n   * of the subject*, hashed into a band of its own, and a band's inputs belong\n   * beside the other bands' inputs — next to `style` and `attributes`, which is\n   * where `shapeOf` goes looking.\n   */\n  readonly wiring?: Wiring;\n\n  /**\n   * What that component was holding. **Outside every hash**, always.\n   *\n   * The field beside it is the contrast worth reading: `wiring` is a band and\n   * this is evidence. `Wiring` refuses state values because a hook's value is\n   * exactly what may legitimately differ between two readings of one page, and\n   * that refusal is right and is not softened here — a `holding` reaches the\n   * snapshot and reaches no digest, so a subject whose clock ticked has the same\n   * `renderHash` it had before this field existed.\n   *\n   * It rides outside on the same terms as `styleProvenance`, `styleTokens` and\n   * `ignoredBy`, by the same mechanism: `structureOf`, `styleOf` and `shapeOf`\n   * project the fields they hash **by name**, so a field none of them names\n   * cannot reach an identity. `holding.hash.test.ts` asserts that rather than\n   * trusting it, because the cost of being wrong is every baseline in a\n   * repository invalidating the first time a component held a timestamp.\n   */\n  readonly holding?: Holding;\n\n  /**\n   * `true` on the root of a subtree rendered through a portal.\n   *\n   * Recorded in the structure hash so that \"the dialog moved from inline to\n   * portalled\" is a change rather than a coincidence of identical content, and\n   * so the docket can say *where* something rendered, not only that it exists.\n   */\n  readonly portalled?: boolean;\n\n  /**\n   * Ignore rules this node was found under. Outside every hash, like its origin\n   * on `RawNode`. See {@link SemanticSnapshot.ignoreSites}.\n   */\n  readonly ignoredBy?: readonly string[];\n\n  readonly children: readonly SemanticNode[];\n}\n\n/**\n * A subtree the operator excluded, resolved to a path and a box (spec 0024).\n *\n * Lives in `format` rather than beside the rules that consume it, because it is\n * part of what a snapshot *is*: the collector produced it, it travels with the\n * document over every wire this project has, and `core/judge` is only its first\n * reader. A type the wire format needs cannot live in the policy layer.\n */\nexport interface IgnoreSite {\n  /** Root of the excluded subtree, in this snapshot's own path space. */\n  readonly path: NodePath;\n\n  /** Which rule put it here, matched exactly against `IgnoreRule.id`. */\n  readonly rule: string;\n\n  /**\n   * The box it occupied, for the raster tier.\n   *\n   * Absent under a profile with no layout — which is ADR-0002 rather than a\n   * failure: a profile that cannot measure a box cannot decide pixels either, so\n   * there is nothing for the box to subtract from.\n   */\n  readonly rect?: Rect;\n}\n\n/**\n * A component's own content, hashed per band (ADR-0018).\n *\n * In `format` rather than beside `hashComponents`, which computes it, because a\n * baseline carries these: a stored image plus the component hashes of the\n * document that painted it is what lets a later run tell the component that\n * *caused* a change from the components the change merely moved. That makes this\n * part of the wire format every store and every transport has to preserve, and a\n * type the wire needs cannot live in the layer that derives it.\n */\nexport interface ComponentHash {\n  readonly component: string;\n\n  /** Boundaries of this component in the subject, counted in document order. */\n  readonly instances: number;\n\n  /**\n   * Tree shape: tags, structural aliases, portalling, allowlisted attributes,\n   * and which child boundaries sit where. The `geometry` band's structural half.\n   *\n   * **Split out of a single `structure` digest on 2026-08-06.** It used to carry\n   * the accessible semantics and the text too, and the fusion was invisible\n   * until something needed to ask *which band moved* — at which point a baseline\n   * could say \"this component changed\" and never say whether a heading was\n   * renamed, a paragraph reworded, or a node inserted. Those are three different\n   * bands, three different readers, and one of them is the band a route-level\n   * test exists to ignore.\n   */\n  readonly structure: Digest;\n\n  /**\n   * Role, accessible name, and ARIA state. The `a11y` band.\n   *\n   * Its own digest because it is the band that must never be absorbed. Every\n   * sensitivity level asserts on it, including the ones that ignore everything\n   * else — and a level cannot assert on a band that is fused into another one.\n   */\n  readonly semantics: Digest;\n\n  /** Text runs, in document order. The `content` band. */\n  readonly text: Digest;\n\n  readonly style: Digest;\n\n  /**\n   * Absent under a profile without layout — absent, never empty (ADR-0002).\n   *\n   * An empty geometry digest would compare equal between a run that observed no\n   * movement and a run that could not observe movement at all, which is the\n   * false `unchanged` this system must never produce.\n   */\n  readonly geometry?: Digest;\n\n  /**\n   * The box each instance occupies, in document order. Never hashed.\n   *\n   * A digest can say a component is not what it was and can never say by how\n   * much. That is the gap a reviewer falls into: `Button — geometry, token` is\n   * true of a control that lost a shadow and of one that grew eight pixels and\n   * pushed the page down, and only the second explains why the subject is a\n   * different height. Four numbers per instance close it.\n   *\n   * Absent for a baseline written before this existed and for a profile with no\n   * layout — the same absence, and both mean *nobody measured*, never *it did\n   * not move*. A `null` entry is a boundary the browser laid out nothing for,\n   * kept in place so the list stays parallel to the instances it counts.\n   */\n  readonly boxes?: readonly (Rect | null)[];\n\n  /**\n   * Every distinct value the component's own nodes declared, per property, in\n   * code-unit order; a custom property appears under its `--name` with the\n   * values it resolved to. Never hashed.\n   *\n   * `boxes` answers *by how much*; this answers *which declaration*. `style`\n   * moved says a `Button` is not styled as it was, and a reviewer holding only\n   * that opens the file and diffs by eye. With both revisions' values the run\n   * says `padding-left 8px → 14px`, which is the line somebody edited.\n   *\n   * Absent for a baseline written before this existed. That means *nobody\n   * recorded it*, and the comparison says nothing about properties rather than\n   * reporting every one of them as new.\n   */\n  readonly values?: Readonly<Record<string, readonly string[]>>;\n}\n\nexport interface StyleProvenanceEntry {\n  readonly path: NodePath;\n  readonly property: string;\n  readonly sheet: string;\n  /** Generated segments replaced by placeholders, so it can name a root safely. */\n  readonly selector: string;\n  readonly tokenName?: string;\n  readonly source?: { readonly file: string; readonly line: number };\n}\n"]}
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/format/snapshot.ts"],"names":[],"mappings":"","sourcesContent":["import type { SubjectRef, Rect, Diagnostic } from './capture.js';\nimport type { EnvironmentKey } from './environment.js';\nimport type { Digest } from './hash.js';\nimport type { ObservationProfile } from './profile.js';\nimport type { Provenance } from './provenance.js';\nimport type { Wiring } from './wiring.js';\nimport type { Holding } from './holding.js';\n\n/**\n * The normalized semantic snapshot: the verdict's input, and the thing a render\n * hash addresses.\n *\n * Everything volatile is gone by this point. Ids have become structural aliases,\n * class attributes have been dropped entirely, inapplicable CSS has been pruned,\n * and the cascade has been resolved to winning values (ADR-0003). What remains is\n * meant to be *read*: a snapshot a reviewer refuses to open is a snapshot that\n * gets rubber-stamped.\n */\nexport interface SemanticSnapshot {\n  readonly formatVersion: 1;\n  readonly subject: SubjectRef;\n  readonly profile: ObservationProfile;\n  readonly environment: EnvironmentKey;\n\n  /** Content hash of `root` under `environment`. The identity of this state. */\n  readonly renderHash: Digest;\n\n  /**\n   * Structure and applicable style, hashed separately.\n   *\n   * These back the tier below full semantic comparison (ADR-0003): matching both\n   * settles a subject without resolving layout or taking a screenshot. Split\n   * rather than combined because the docket wants to say *which* held — \"the DOM\n   * is identical, only styling moved\" is the sentence that turns a diff into a\n   * token-band root.\n   */\n  readonly structureHash: Digest;\n  readonly styleHash: Digest;\n\n  readonly root: SemanticNode;\n\n  /**\n   * Where each winning declaration came from. Deliberately outside the hash.\n   *\n   * Pruning discards exactly what attribution needs — *which rule set this?* — so\n   * it is preserved here instead. Keeping it out of the hash is the point: moving\n   * a rule between files renames a source without changing a render, and must not\n   * invalidate a baseline.\n   */\n  readonly styleProvenance: readonly StyleProvenanceEntry[];\n\n  /**\n   * Subtrees the operator declared out of scope, resolved against *this* tree.\n   *\n   * Deliberately outside the hash, for the reason `styleProvenance` is: an ignore\n   * changes what a run says about a render, never the render. Folding it into the\n   * identity would invalidate every baseline in the repository the first time\n   * somebody masked a clock, which is the surest way to make a safety feature the\n   * thing people turn off.\n   *\n   * Present only when something was excluded, so a snapshot from a run with no\n   * ignores is byte-identical to one produced before this field existed.\n   */\n  readonly ignoreSites?: readonly IgnoreSite[];\n\n  /**\n   * What the collector or the normalizer could not do, carried forward.\n   *\n   * Outside the hash: a diagnostic describes the *observation*, not the render,\n   * and a snapshot that hashed its own warnings would invalidate whenever the\n   * warning text was reworded. But it must survive to the verdict — a subject\n   * whose capture half-failed is not a subject that legitimately `unchanged`,\n   * and silently discarding that fact is how a broken collector reads as a clean\n   * build.\n   */\n  readonly diagnostics: readonly Diagnostic[];\n}\n\n/**\n * A node's stable address: child indices from the root, e.g. `0/2/1`.\n *\n * Positional because nothing else survives. Ids are volatile (that is why they\n * were aliased away), and class names have been dropped. Position is honest about\n * what it costs: inserting a sibling renumbers everything after it, so the differ\n * matches nodes by shape and provenance before falling back to path (see\n * `diff.ts`), and treats a path change alone as evidence of nothing.\n */\nexport type NodePath = string;\n\nexport interface SemanticNode {\n  readonly path: NodePath;\n  readonly tag: string;\n\n  /** Structural alias, e.g. `#a0`. Absent when the node carried no id. */\n  readonly alias?: string;\n\n  readonly role?: string;\n  readonly name?: string;\n\n  /**\n   * Accessible description, resolved. See `RawAria.description` for why this is\n   * a field of its own rather than an attribute.\n   */\n  readonly description?: string;\n\n  readonly state?: Readonly<Record<string, string | boolean | number>>;\n\n  /** Semantic attributes surviving normalization. `class` is never among them. */\n  readonly attributes: Readonly<Record<string, string>>;\n\n  /** Winning values for allowlisted properties, canonicalized. */\n  readonly style: Readonly<Record<string, string>>;\n\n  /**\n   * Custom properties this node's winning declarations resolved through, as\n   * name → resolved value.\n   *\n   * Recording the name alongside the value is what lets a design-token change\n   * surface as one root with counted collateral instead of hundreds of unrelated\n   * colour diffs (spec §5, `token` band).\n   */\n  readonly tokens?: Readonly<Record<string, string>>;\n\n  /**\n   * Which token each styled property resolved through, including by inheritance.\n   *\n   * Outside the hash, like `styleProvenance` and for the same reason: swapping a\n   * literal for a token of the same value renames a source without changing a\n   * render. It exists so the differ can tell *which* property a token edit\n   * explains — `tokens` alone says a node uses tokens, not which of its values\n   * one drove.\n   */\n  readonly styleTokens?: Readonly<Record<string, string>>;\n\n  /** Present only under a profile with layout. Absent, never zeroed (ADR-0002). */\n  readonly rect?: Rect;\n\n  /** Text content, or its digest when policy declares the region volatile. */\n  readonly text?: string;\n\n  readonly provenance?: Provenance;\n\n  /**\n   * How the framework holds this node's component, when a framework adapter\n   * supplied it. See {@link Wiring}.\n   *\n   * On the node rather than on `Provenance`, though both come from the same\n   * adapter and the same fiber, because they answer to different readers.\n   * Provenance exists so a diff arrives carrying a name; wiring is a *dimension\n   * of the subject*, hashed into a band of its own, and a band's inputs belong\n   * beside the other bands' inputs — next to `style` and `attributes`, which is\n   * where `shapeOf` goes looking.\n   */\n  readonly wiring?: Wiring;\n\n  /**\n   * What that component was holding. **Outside every hash**, always.\n   *\n   * The field beside it is the contrast worth reading: `wiring` is a band and\n   * this is evidence. `Wiring` refuses state values because a hook's value is\n   * exactly what may legitimately differ between two readings of one page, and\n   * that refusal is right and is not softened here — a `holding` reaches the\n   * snapshot and reaches no digest, so a subject whose clock ticked has the same\n   * `renderHash` it had before this field existed.\n   *\n   * It rides outside on the same terms as `styleProvenance`, `styleTokens` and\n   * `ignoredBy`, by the same mechanism: `structureOf`, `styleOf` and `shapeOf`\n   * project the fields they hash **by name**, so a field none of them names\n   * cannot reach an identity. `holding.hash.test.ts` asserts that rather than\n   * trusting it, because the cost of being wrong is every baseline in a\n   * repository invalidating the first time a component held a timestamp.\n   */\n  readonly holding?: Holding;\n\n  /**\n   * `true` on the root of a subtree rendered through a portal.\n   *\n   * Recorded in the structure hash so that \"the dialog moved from inline to\n   * portalled\" is a change rather than a coincidence of identical content, and\n   * so the docket can say *where* something rendered, not only that it exists.\n   */\n  readonly portalled?: boolean;\n\n  /**\n   * Ignore rules this node was found under. Outside every hash, like its origin\n   * on `RawNode`. See {@link SemanticSnapshot.ignoreSites}.\n   */\n  readonly ignoredBy?: readonly string[];\n\n  /** What was not read about this node, carried from `RawNode.unread`. Outside every hash. */\n  readonly unread?: string;\n\n  readonly children: readonly SemanticNode[];\n}\n\n/**\n * A subtree the operator excluded, resolved to a path and a box (spec 0024).\n *\n * Lives in `format` rather than beside the rules that consume it, because it is\n * part of what a snapshot *is*: the collector produced it, it travels with the\n * document over every wire this project has, and `core/judge` is only its first\n * reader. A type the wire format needs cannot live in the policy layer.\n */\nexport interface IgnoreSite {\n  /** Root of the excluded subtree, in this snapshot's own path space. */\n  readonly path: NodePath;\n\n  /** Which rule put it here, matched exactly against `IgnoreRule.id`. */\n  readonly rule: string;\n\n  /**\n   * The box it occupied, for the raster tier.\n   *\n   * Absent under a profile with no layout — which is ADR-0002 rather than a\n   * failure: a profile that cannot measure a box cannot decide pixels either, so\n   * there is nothing for the box to subtract from.\n   */\n  readonly rect?: Rect;\n}\n\n/**\n * A component's own content, hashed per band (ADR-0018).\n *\n * In `format` rather than beside `hashComponents`, which computes it, because a\n * baseline carries these: a stored image plus the component hashes of the\n * document that painted it is what lets a later run tell the component that\n * *caused* a change from the components the change merely moved. That makes this\n * part of the wire format every store and every transport has to preserve, and a\n * type the wire needs cannot live in the layer that derives it.\n */\nexport interface ComponentHash {\n  readonly component: string;\n\n  /** Boundaries of this component in the subject, counted in document order. */\n  readonly instances: number;\n\n  /**\n   * Tree shape: tags, structural aliases, portalling, allowlisted attributes,\n   * and which child boundaries sit where. The `geometry` band's structural half.\n   *\n   * **Split out of a single `structure` digest on 2026-08-06.** It used to carry\n   * the accessible semantics and the text too, and the fusion was invisible\n   * until something needed to ask *which band moved* — at which point a baseline\n   * could say \"this component changed\" and never say whether a heading was\n   * renamed, a paragraph reworded, or a node inserted. Those are three different\n   * bands, three different readers, and one of them is the band a route-level\n   * test exists to ignore.\n   */\n  readonly structure: Digest;\n\n  /**\n   * Role, accessible name, and ARIA state. The `a11y` band.\n   *\n   * Its own digest because it is the band that must never be absorbed. Every\n   * sensitivity level asserts on it, including the ones that ignore everything\n   * else — and a level cannot assert on a band that is fused into another one.\n   */\n  readonly semantics: Digest;\n\n  /** Text runs, in document order. The `content` band. */\n  readonly text: Digest;\n\n  readonly style: Digest;\n\n  /**\n   * Absent under a profile without layout — absent, never empty (ADR-0002).\n   *\n   * An empty geometry digest would compare equal between a run that observed no\n   * movement and a run that could not observe movement at all, which is the\n   * false `unchanged` this system must never produce.\n   */\n  readonly geometry?: Digest;\n\n  /**\n   * The box each instance occupies, in document order. Never hashed.\n   *\n   * A digest can say a component is not what it was and can never say by how\n   * much. That is the gap a reviewer falls into: `Button — geometry, token` is\n   * true of a control that lost a shadow and of one that grew eight pixels and\n   * pushed the page down, and only the second explains why the subject is a\n   * different height. Four numbers per instance close it.\n   *\n   * Absent for a baseline written before this existed and for a profile with no\n   * layout — the same absence, and both mean *nobody measured*, never *it did\n   * not move*. A `null` entry is a boundary the browser laid out nothing for,\n   * kept in place so the list stays parallel to the instances it counts.\n   */\n  readonly boxes?: readonly (Rect | null)[];\n\n  /**\n   * Every distinct value the component's own nodes declared, per property, in\n   * code-unit order; a custom property appears under its `--name` with the\n   * values it resolved to. Never hashed.\n   *\n   * `boxes` answers *by how much*; this answers *which declaration*. `style`\n   * moved says a `Button` is not styled as it was, and a reviewer holding only\n   * that opens the file and diffs by eye. With both revisions' values the run\n   * says `padding-left 8px → 14px`, which is the line somebody edited.\n   *\n   * Absent for a baseline written before this existed. That means *nobody\n   * recorded it*, and the comparison says nothing about properties rather than\n   * reporting every one of them as new.\n   */\n  readonly values?: Readonly<Record<string, readonly string[]>>;\n}\n\nexport interface StyleProvenanceEntry {\n  readonly path: NodePath;\n  readonly property: string;\n  readonly sheet: string;\n  /** Generated segments replaced by placeholders, so it can name a root safely. */\n  readonly selector: string;\n  readonly tokenName?: string;\n  readonly source?: { readonly file: string; readonly line: number };\n}\n"]}

package/dist/format/stabilize.d.ts

@@ -1,6 +1,7 @@
 import { type Digest } from './hash.js';
 import { type Tier } from './tier.js';
 import type { Intervention, ScreenshotOptions, SettleTarget } from './intervention.js';
+import type { StepClock } from './steps.js';
 /**
  * Interventions as separate, nameable tricks — not a fixed set of switches.
  *
@@ -20,8 +21,8 @@ import type { Intervention, ScreenshotOptions, SettleTarget } from './interventi
  *
  * A recipe can be filtered by tier, so the structure-and-style rung waits for
  * nothing; composed from another project's tricks alongside these; digested, so
- * a baseline made under one recipe is `incomparable` with a run made under
- * another rather than `changed`; and checked for tricks that fight each other.
+ * a run under another recipe than its baseline names the recipe as the cause;
+ * and checked for tricks that fight each other.
  *
  * ## Where the damage lands
  *
@@ -52,6 +53,7 @@ import type { Intervention, ScreenshotOptions, SettleTarget } from './interventi
  * digest, and the vocabulary belongs beside the key it is part of.
  */
 export type { Intervention, ScreenshotOptions, SettleTarget, Trick } from './intervention.js';
+export { waitForFonts, waitForImages } from './waits.js';
 /**
  * Hand animations to the browser rather than emulating the hold in CSS.
  *
@@ -111,8 +113,6 @@ export declare const hideScrollbars: Intervention;
  * `alt=""` image would hide real regressions under a green run.
  */
 export declare const hidePresentationalImages: Intervention;
-export declare const waitForFonts: Intervention;
-export declare const waitForImages: Intervention;
 export declare const INTERVENTIONS: readonly Intervention[];
 export type Recipe = readonly Intervention[];
 /**
@@ -124,6 +124,13 @@ export type Recipe = readonly Intervention[];
  * rung the tier ladder exists to make cheap.
  */
 export declare const SEMANTIC_RECIPE: Recipe;
+/**
+ * What a document is painted under, and of {@link UNTOUCHED} only `no-focus`: a
+ * collected `autofocus` takes focus again. The other three have nothing but a
+ * carried script to act on: the printed date and the animation's place are in
+ * the document already, its `@media` rules were resolved when it was read, and
+ * nothing moves the pointer over it.
+ */
 export declare const LAYOUT_RECIPE: Recipe;
 export declare const RASTER_RECIPE: Recipe;
 /**
@@ -153,6 +160,12 @@ export declare const RASTER_RECIPE: Recipe;
  * the trade {@link SEMANTIC_RECIPE} refuses.
  */
 export declare const COLLECT_RECIPE: Recipe;
+/**
+ * The ids of {@link COLLECT_RECIPE}, as an absent `stabilize` means them. A list
+ * replaces the recipe, so one trick is turned off with this list without it:
+ * `stabilize: DEFAULT_STABILIZE.filter((id) => id !== 'freeze-clock')`.
+ */
+export declare const DEFAULT_STABILIZE: readonly string[];
 /**
  * Resolve a trick by the name a caller wrote down.
  *
@@ -174,6 +187,17 @@ export declare function interventionById(id: string): Intervention | undefined;
  * of the message.
  */
 export declare function recipeOf(ids: readonly string[]): Recipe;
+/**
+ * The recipe a host that drives the browser applies, checked before it opens one:
+ * `stabilize` by id, or {@link COLLECT_RECIPE} when it is absent, with its clock
+ * fixed at `now`, which travels in the clock's id and lands in the digest. Throws
+ * on an unknown id, an instant with no zone, or a `now` with no clock to fix, so
+ * the operator hears about it before a page is loaded, not at the first subject.
+ */
+export declare function recipeToDrive(options: {
+    readonly stabilize?: readonly string[];
+    readonly now?: string;
+}): Recipe;
 /** Only the tricks a tier can observe the effect of. */
 export declare function forTier(recipe: Recipe, tier: Tier): Recipe;
 /**
@@ -190,13 +214,18 @@ export declare function conflicts(recipe: Recipe): readonly {
 }[];
 export declare function recipeCss(recipe: Recipe): string;
 export declare function recipeScreenshot(recipe: Recipe): ScreenshotOptions;
-export declare function settleRecipe(recipe: Recipe, target: SettleTarget): Promise<void>;
+/**
+ * Every wait the recipe holds, in order. Each is one step on `steps`, named by
+ * the intervention's id, so a run can say which wait a slow subject spent its
+ * time in.
+ */
+export declare function settleRecipe(recipe: Recipe, target: SettleTarget, steps?: StepClock): Promise<void>;
 /**
  * The identity of a recipe.
  *
  * Sorted, so the order tricks were composed in does not change the identity —
  * only which ones are present. Folded into `RenderIdentity`, which is what makes
- * a cross-recipe comparison report `incomparable` instead of inventing a
+ * a cross-recipe comparison name the recipe as its cause instead of inventing a
  * component to blame.
  */
 export declare function recipeDigest(recipe: Recipe): Digest;