@orkestrel/scaffold 0.0.132 → 0.0.134

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/dist/agents/skills/orkestrel-dispatch/scripts/bench.js +61 -96
  2. package/dist/agents/skills/orkestrel-dispatch/scripts/brief.js +48 -76
  3. package/dist/agents/skills/orkestrel-dispatch/scripts/chain.js +27 -66
  4. package/dist/agents/skills/orkestrel-dispatch/scripts/cite.js +31 -64
  5. package/dist/agents/skills/orkestrel-dispatch/scripts/launch.js +43 -57
  6. package/dist/agents/skills/orkestrel-dispatch/scripts/login.js +43 -86
  7. package/dist/agents/skills/orkestrel-dispatch/scripts/patch.js +68 -104
  8. package/dist/agents/skills/orkestrel-dispatch/scripts/result.js +35 -69
  9. package/dist/agents/skills/orkestrel-dispatch/scripts/sweep.js +47 -84
  10. package/dist/agents/skills/orkestrel-falsify/scripts/mutate.js +134 -116
  11. package/dist/agents/skills/orkestrel-harden/scripts/discovery.js +38 -90
  12. package/dist/agents/skills/orkestrel-harden/scripts/interleave.js +39 -103
  13. package/dist/agents/skills/orkestrel-harden/scripts/measure.js +40 -89
  14. package/dist/agents/skills/orkestrel-harden/scripts/titles.js +41 -87
  15. package/dist/agents/skills/orkestrel-parallel/scripts/cases.js +43 -88
  16. package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +1018 -194
  17. package/dist/agents/skills/orkestrel-publish/scripts/compare.js +40 -60
  18. package/dist/agents/skills/orkestrel-publish/scripts/pins.js +47 -81
  19. package/dist/agents/skills/orkestrel-publish/scripts/steps.js +66 -104
  20. package/dist/agents/skills/orkestrel-publish/scripts/swap.js +74 -88
  21. package/dist/agents/skills/orkestrel-publish/scripts/wave.js +95 -108
  22. package/dist/agents/skills/orkestrel-publish/scripts/window.js +55 -96
  23. package/dist/agents/skills/orkestrel-scout/scripts/map.js +54 -101
  24. package/dist/bin/main.js +30 -6
  25. package/dist/bin/main.js.map +1 -1
  26. package/dist/host/agents/orchestration.md +1 -0
  27. package/dist/host/agents/skills/orkestrel-dispatch/scripts/bench.ts +81 -97
  28. package/dist/host/agents/skills/orkestrel-dispatch/scripts/brief.ts +64 -72
  29. package/dist/host/agents/skills/orkestrel-dispatch/scripts/chain.ts +41 -63
  30. package/dist/host/agents/skills/orkestrel-dispatch/scripts/cite.ts +56 -79
  31. package/dist/host/agents/skills/orkestrel-dispatch/scripts/launch.ts +61 -74
  32. package/dist/host/agents/skills/orkestrel-dispatch/scripts/login.ts +59 -89
  33. package/dist/host/agents/skills/orkestrel-dispatch/scripts/patch.ts +87 -106
  34. package/dist/host/agents/skills/orkestrel-dispatch/scripts/result.ts +57 -76
  35. package/dist/host/agents/skills/orkestrel-dispatch/scripts/sweep.ts +73 -88
  36. package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +2 -2
  37. package/dist/host/agents/skills/orkestrel-falsify/scripts/mutate.ts +167 -119
  38. package/dist/host/agents/skills/orkestrel-harden/references/methods.md +1 -1
  39. package/dist/host/agents/skills/orkestrel-harden/scripts/discovery.ts +58 -75
  40. package/dist/host/agents/skills/orkestrel-harden/scripts/interleave.ts +55 -99
  41. package/dist/host/agents/skills/orkestrel-harden/scripts/measure.ts +59 -90
  42. package/dist/host/agents/skills/orkestrel-harden/scripts/titles.ts +60 -80
  43. package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +4 -4
  44. package/dist/host/agents/skills/orkestrel-parallel/scripts/cases.ts +71 -108
  45. package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +1288 -239
  46. package/dist/host/agents/skills/orkestrel-publish/references/wave.md +10 -6
  47. package/dist/host/agents/skills/orkestrel-publish/scripts/compare.ts +58 -79
  48. package/dist/host/agents/skills/orkestrel-publish/scripts/pins.ts +66 -87
  49. package/dist/host/agents/skills/orkestrel-publish/scripts/steps.ts +84 -102
  50. package/dist/host/agents/skills/orkestrel-publish/scripts/swap.ts +92 -99
  51. package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +130 -126
  52. package/dist/host/agents/skills/orkestrel-publish/scripts/window.ts +82 -120
  53. package/dist/host/agents/skills/orkestrel-scout/SKILL.md +3 -3
  54. package/dist/host/agents/skills/orkestrel-scout/scripts/map.ts +85 -112
  55. package/dist/host/claude/agents/orkestrel.md +54 -54
  56. package/dist/host/claude/rules/documentation.md +1 -1
  57. package/dist/host/claude/rules/patterns.md +5 -4
  58. package/dist/host/claude/rules/styles.md +1 -1
  59. package/dist/host/claude/rules/tests.md +8 -3
  60. package/dist/host/claude/rules/workspace.md +47 -35
  61. package/dist/host/configs/helpers.ts +40 -15
  62. package/dist/host/dotfiles/oxlintrc.json +62 -0
  63. package/dist/host/guides/browser.md +1 -1
  64. package/dist/host/guides/form.md +79 -4
  65. package/dist/host/guides/queue.md +3 -1
  66. package/dist/host/guides/scaffold.md +95 -67
  67. package/dist/host/guides/table.md +20 -6
  68. package/dist/host/guides/test.md +342 -202
  69. package/dist/host/guides/workflow.md +4 -2
  70. package/dist/host/manifest.json +48 -48
  71. package/dist/host/tests/config.test.ts +201 -11
  72. package/dist/host/tests/policy.test.ts +15 -22
  73. package/dist/host/tests/setupPolicy.ts +43 -36
  74. package/dist/src/core/index.cjs +194 -97
  75. package/dist/src/core/index.cjs.map +1 -1
  76. package/dist/src/core/index.d.cts +27 -13
  77. package/dist/src/core/index.d.ts +27 -13
  78. package/dist/src/core/index.js +192 -97
  79. package/dist/src/core/index.js.map +1 -1
  80. package/dist/src/server/index.cjs +8 -9
  81. package/dist/src/server/index.cjs.map +1 -1
  82. package/dist/src/server/index.d.cts +1 -1
  83. package/dist/src/server/index.d.ts +1 -1
  84. package/dist/src/server/index.js +8 -9
  85. package/dist/src/server/index.js.map +1 -1
  86. package/package.json +5 -5
@@ -299,11 +299,11 @@ they name no target either, and neither does `stepFocus`, which takes a limit an
299
299
  | `RGBA` | type | `readonly [red: number, green: number, blue: number, alpha: number]` | Represents one rendered color as straight sRGB channels and its alpha. |
300
300
  | `ContrastOptions` | interface | `{ floor?, opacity? }` | Configures one color contrast reading: the surface the backdrop walk ends on, and the opacity the painted color is shown at. |
301
301
  | `ElementOptions` | interface | `{ classes?, text?, attributes? }` | Configures one built element: its class list, its text, and its attributes. |
302
- | `FrameOptions` | interface | `{ path, width, height, element? }` | Configures one captured frame: where it is written, the viewport it is shot at, and what it shoots. |
302
+ | `FrameOptions` | interface | `{ path, width, height, element?, unrolled? }` | Configures one captured frame: where it is written, the viewport it is shot at, and what it shoots. |
303
303
  | `FrameOffset` | interface | `{ top, left }` | Represents how far an element frame moves the tester frame from the runner window's origin for the shot, in CSS pixels. |
304
304
  | `FrameResult` | interface | `{ width, height, floor }` | Represents one written frame read back from the file a capture produced: its size in device pixels, and the single color its bottom row paints. |
305
305
  | `CaptureVariant` | interface | `{ apply? }` | Adds to a journey variant the document change a capture run applies before resizing. |
306
- | `PortfolioOptions` | interface | `{ states, variants, variant, directory, enabled? }` | Configures a capture portfolio: the state registry, the variant matrix, this run's variant, where it writes, and whether it writes at all. |
306
+ | `PortfolioOptions` | interface | `{ states, variants, variant, directory, enabled?, unrolled? }` | Configures a capture portfolio: the state registry, the variant matrix, this run's variant, where it writes, and whether it writes at all. |
307
307
  | `PortfolioInterface` | interface | `{ variant, placements, paths, files, place() }` | Holds the registry of capture states one run places, and the files it wrote placing them. |
308
308
  | `JournalStep` | interface | `{ action, trigger, result }` | Represents one scripted step a journal recorded, and what the surface did about it. |
309
309
  | `JournalInterface` | interface | `{ steps, output, start(), stop(), record() }` | Records one scenario: every step it took and everything the page said while it ran. |
@@ -330,6 +330,8 @@ they name no target either, and neither does `stepFocus`, which takes a limit an
330
330
  | ----------------------- | ----- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
331
331
  | `ACCESSIBLE_ROLES` | const | `readonly string[]` | Names the interactive ARIA roles a bare accessible name is searched across. |
332
332
  | `CANVAS_COLOR` | const | `RGBA` | Names the color a browser paints an unstyled document with: opaque white. |
333
+ | `CAPTURE_CONTROLS` | const | `readonly string[]` | Lists the form controls an unrolled frame leaves scrolled. |
334
+ | `CAPTURE_LABEL_LIMIT` | const | `120` | Bounds the characters of the region locator a capture refusal names. |
333
335
  | `CAPTURE_PANE` | const | `"data-capture-pane"` | Names the attribute marking the runner's tester pane, and the rule that sizes it, while a frame is staged. |
334
336
  | `CAPTURE_STAGE_LIMIT` | const | `4` | Bounds the restagings one capture takes before it refuses a document whose height never settles. |
335
337
  | `CONTENT_ROLES` | const | `readonly string[]` | Names the roles whose accessible name is the text a reader can see inside them. |
@@ -344,137 +346,146 @@ they name no target either, and neither does `stepFocus`, which takes a limit an
344
346
 
345
347
  #### Helpers
346
348
 
347
- | Name | Kind | Signature | Summary |
348
- | -------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
349
- | `supportsSegmentedFocus` | function | `(element: Element) => boolean` | Determines whether a native input exposes separately editable segments under one focused element. |
350
- | `resolveAccessible` | function | `((name: string) => HTMLElement) & ((role: string, name: string) => HTMLElement)` | Resolves one visible, focus-reachable interactive element by its exact accessible name. A wholly-off-viewport target is scrolled into view before reachability is measured. |
351
- | `resolveAccessibleWithin` | function | `(region: string, role: string, name: string) => HTMLElement` | Resolves one human-reachable control by role and accessible-name text inside a named region. |
352
- | `resolveRendered` | function | `(first: string, second?: string) => HTMLElement` | Resolves one rendered, focus-reachable interactive element without requiring it to intersect the viewport yet. |
353
- | `computeNamePattern` | function | `(name: string) => RegExp` | Computes the pattern that matches one accessible name a decorative glyph may sit beside. |
354
- | `isOutsideViewport` | function | `(rectangle: DOMRectReadOnly) => boolean` | Determines whether a rectangle lies wholly outside the browser viewport. |
355
- | `isRendered` | function | `(element: Element) => boolean` | Determines whether the accessibility tree presents one element at all. |
356
- | `collectShadowHosts` | function | `(element: Element, root?: Node) => readonly Element[]` | Collects an element and the successive hosts of its containing shadow roots. |
357
- | `isReachable` | function | `(element: Element) => boolean` | Determines whether a person can click one element where it sits. |
358
- | `readHit` | function | `(element: Element) => Element \| undefined` | Reads the topmost element at one element's bounding-box centre. |
359
- | `clickAccessible` | function | `((name: string) => Promise<void>) & ((role: string, name: string) => Promise<void>)` | Clicks one visible, focus-reachable control by its accessible name through the browser provider. |
360
- | `clickAccessibleWithin` | function | `(region: string, role: string, name: string) => Promise<void>` | Clicks one human-reachable control by role and accessible-name text inside a named region. |
361
- | `clickDisclosure` | function | `(name: string) => Promise<void>` | Opens or closes one native details disclosure by its rendered summary. |
362
- | `readProtocolSession` | function | `() => readonly [unknown, unknown]` | Reads the browser provider's DevTools session and its send member. |
363
- | `sendProtocol` | function | `(method: string, params?: Readonly<Record<string, unknown>>) => Promise<unknown>` | Sends one DevTools protocol command through the browser provider. |
364
- | `readProtocolPoint` | function | `(element: Element, offset?: ProtocolPoint) => ProtocolPoint` | Projects a point of one element through every frame that holds it into the browser's top-level viewport. |
365
- | `readProtocolNode` | function | `(element: Element) => Promise<number>` | Resolves one element to the node the browser's DOM tree holds for it. |
366
- | `readAccessibilityNode` | function | `(element: Element) => Promise<AccessibilityNode>` | Reads the accessibility node the browser computed for one element. |
367
- | `hoverAccessible` | function | `((name: string) => Promise<void>) & ((role: string, name: string) => Promise<void>)` | Hovers one visible, focus-reachable control by its accessible name through the browser provider. |
368
- | `holdAccessible` | function | `((name: string) => Promise<void>) & ((role: string, name: string) => Promise<void>)` | Holds the primary pointer button on one visible, focus-reachable control by its accessible name. |
369
- | `holdAccessibleWithin` | function | `(region: string, role: string, name: string) => Promise<void>` | Holds the primary pointer button on one control by role and accessible-name text inside a named region. |
370
- | `driveHold` | function | `(resolve: () => HTMLElement, name: string) => Promise<void>` | Holds the primary pointer button on the control a resolver returns, through the browser provider. |
371
- | `parkPointer` | function | `() => Promise<void>` | Parks the pointer outside the page and waits for the parked pointer's frame to paint. |
372
- | `releasePointer` | function | `() => Promise<void>` | Releases a held pointer and parks it outside the page, clearing hover. |
373
- | `typeAccessible` | function | `(name: string, text: string) => Promise<void>` | Replaces a named field's value through focus, select-all, deletion, and real keystrokes. |
374
- | `fillAccessible` | function | `(name: string, text: string) => Promise<void>` | Replaces a named field's value in one operation, for text too long to type key by key. |
375
- | `traverseAccessible` | function | `(name: string) => Promise<HTMLElement>` | Reaches a named control only through natural forward Tab traversal from the current focus. |
376
- | `traverseAccessibleWithin` | function | `(region: string, role: string, name: string) => Promise<HTMLElement>` | Reaches a control by role and accessible-name text inside a named region, only through natural forward Tab traversal from the current focus. |
377
- | `readActiveElement` | function | `(root?: Document \| ShadowRoot) => HTMLElement \| undefined` | Reads the HTML element that holds focus, following it into open shadow roots and same-origin frames. |
378
- | `countElements` | function | `(root?: Document \| ShadowRoot) => number` | Counts the elements a tree holds, descending into open shadow roots and same-origin frames. |
379
- | `containsNode` | function | `(root: Node, node: Node) => boolean` | Determines whether a node sits inside a root, through open shadow roots and frames. |
380
- | `stepFocus` | function | `(limit: number) => AsyncGenerator<HTMLElement \| undefined, void, undefined>` | Presses Tab and yields the element focus lands on, once per press, up to a limit. |
381
- | `matchesTraversalName` | function | `(element: HTMLElement, name: string, exact?: boolean) => boolean` | Checks whether a landing can carry a requested accessible name without resolving the document. |
382
- | `driveTraversal` | function | `(resolve: () => HTMLElement, name: string, candidate?: (element: HTMLElement) => boolean) => Promise<HTMLElement>` | Reaches the control a resolver returns, only through natural forward Tab traversal from the current focus. |
383
- | `walkFocus` | function | `(stop?: (element: HTMLElement) => boolean) => Promise<readonly HTMLElement[]>` | Walks forward by real Tab presses from the focused element until a predicate accepts a stop or the Tab order ends. |
384
- | `collectTabStops` | function | `(root: Element, start: HTMLElement) => Promise<readonly HTMLElement[]>` | Collects the elements of a region that a forward Tab walk reaches from a starting element. |
385
- | `pressKeys` | function | `(keys: string) => Promise<void>` | Sends a key sequence to whatever holds focus, and refuses to send it to nothing. |
386
- | `readPerception` | function | `(name: string) => string` | Reads the normalized visible text of one named region, dialog, table, tab panel, or alert. |
387
- | `readPage` | function | `() => string` | Reads the normalized visible text of the whole page. |
388
- | `readFocus` | function | `() => string \| undefined` | Reads the rendered text of the element that holds focus. |
389
- | `readControlValue` | function | `(role: string, name: string) => string` | Reads the value a resolved control renders. |
390
- | `readRefusal` | function | `((name: string) => string \| undefined) & ((role: string, name: string) => string \| undefined)` | Reads the refusal one named target answers with, or nothing when it resolves. |
391
- | `readText` | function | `(element: Element) => string` | Reads one element's rendered text the way a name computation reads it. |
392
- | `readRole` | function | `(element: Element) => string \| undefined` | Reads the role one element carries in the accessibility tree. |
393
- | `readName` | function | `(element: Element) => string` | Reads the accessible name one element is announced under. |
394
- | `readStates` | function | `(element: Element) => readonly string[]` | Reads the states one element is announced in. |
395
- | `describeTree` | function | `(element: Element) => string` | Describes the accessible tree one rendered element presents. |
396
- | `describeFocus` | function | `(element: Element) => string` | Describes the order sequential keyboard navigation visits one element's controls in. |
397
- | `waitForFrame` | function | `() => Promise<void>` | Waits for one animation frame to settle pending browser paint work. |
398
- | `waitForState` | function | `((name: string, state: string, options?: StateOptions) => Promise<readonly string[]>) & ((role: string, name: string, state: string, options?: StateOptions) => Promise<readonly string[]>)` | Waits until one named control announces a state, or stops announcing it. |
399
- | `waitForAnimations` | function | `(element: Element, options?: WaitOptions) => Promise<void>` | Waits until every finite animation on one element and its subtree has stopped moving. |
400
- | `readAnimations` | function | `(element: Element) => AnimationResult` | Reads the animations running on one element and its subtree, split by whether each one ends. |
401
- | `settleCapture` | function | `(options?: SettleOptions) => Promise<() => void>` | Settles the page for one capture: parks the pointer, waits out every finite animation, and holds each endless animation at its first frame. |
402
- | `collectScrollRegions` | function | `(root: Element, axis?: 'inline' \| 'block') => readonly HTMLElement[]` | Collects the rendered boxes a person can scroll. |
403
- | `describeScrollRegions` | function | `(regions: readonly HTMLElement[]) => string` | Describes the window's scroll position and each scroll region's offsets and extents. |
404
- | `build` | function | `<K extends keyof HTMLElementTagNameMap>(tag: K, options?: ElementOptions) => HTMLElementTagNameMap[K]` | Builds one unmounted element of a known tag, wearing the classes, text, and attributes asked for. |
405
- | `mount` | function | `<T extends Element>(element: T) => T` | Puts one element into the document and hands it straight back. |
406
- | `typeInput` | function | `(element: HTMLInputElement \| HTMLTextAreaElement, text: string) => void` | Sets one field's value and announces it the way typing into the field does. |
407
- | `commitInput` | function | `(element: HTMLInputElement \| HTMLTextAreaElement, text: string) => void` | Sets one field's value and commits it, the way typing and then leaving the field does. |
408
- | `render` | function | `((markup: string) => HTMLDivElement) & (<K extends keyof HTMLElementTagNameMap>(tag: K, classes: string) => HTMLElementTagNameMap[K])` | Renders one fixture into the document from trusted markup. |
409
- | `clearStorage` | function | `() => void` | Clears both browser storage surfaces. |
410
- | `removeDatabase` | function | `(name: string) => Promise<void>` | Deletes one IndexedDB database and reports what the request actually did. |
411
- | `convertSRGB` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA` | Converts normalized encoded sRGB channels to the clipped paint scale. |
412
- | `convertLinearSRGB` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA` | Converts linear sRGB channels to encoded, clipped paint channels. |
413
- | `convertXYZD65` | function | `(x: number, y: number, z: number, alpha?: number) => RGBA` | Converts D65 XYZ coordinates to clipped sRGB paint channels. |
414
- | `convertXYZD50` | function | `(x: number, y: number, z: number, alpha?: number) => RGBA` | Converts D50 XYZ coordinates to clipped sRGB paint channels. |
415
- | `convertOKLab` | function | `(lightness: number, a: number, b: number, alpha?: number) => RGBA` | Converts OKLab coordinates to clipped sRGB paint channels. |
416
- | `convertLab` | function | `(lightness: number, a: number, b: number, alpha?: number) => RGBA` | Converts CIE Lab coordinates relative to D50 to clipped sRGB paint channels. |
417
- | `convertDisplayP3` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA` | Converts encoded Display P3 channels to clipped sRGB paint channels. |
418
- | `convertA98RGB` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA` | Converts encoded A98 RGB channels to clipped sRGB paint channels. |
419
- | `convertProPhotoRGB` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA` | Converts encoded ProPhoto RGB channels to clipped sRGB paint channels. |
420
- | `convertRec2020` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA` | Converts encoded Rec. 2020 channels to clipped sRGB paint channels. |
421
- | `parseColor` | function | `(value: string) => RGBA \| undefined` | Parses computed CSS Color 4 values into clipped straight sRGB channels. |
422
- | `parseCSSColor` | function | `(value: string, scope?: Element) => RGBA \| undefined` | Resolves any CSS color expression to straight sRGB channels, by asking the browser. |
423
- | `matchesColor` | function | `(first: string \| RGBA, second: string \| RGBA) => boolean` | Determines whether two colors render the same, within the rounding a browser does. |
424
- | `blendColor` | function | `(front: RGBA, back: RGBA) => RGBA` | Composites one color over another. |
425
- | `measureLuminance` | function | `(color: RGBA) => number` | Measures one opaque color's WCAG relative luminance. |
426
- | `measureContrast` | function | `(front: RGBA, back: RGBA) => number` | Measures the WCAG 2.x contrast ratio between two opaque colors. |
427
- | `readLayers` | function | `(element: Element) => readonly RGBA[]` | Collects readable background color layers and refuses an unreadable painted layer. |
428
- | `readBackdrop` | function | `(element: Element, floor: RGBA) => RGBA` | Resolves the opaque color standing behind one element. |
429
- | `readColorContrast` | function | `(element: Element, color: string, options?: ContrastOptions) => number` | Measures the WCAG 2.x contrast ratio one color reaches when painted over an element's backdrop. |
430
- | `readContrast` | function | `(element: Element, floor?: RGBA) => number` | Measures the WCAG 2.x contrast ratio between an element's computed text and background colors. |
431
- | `readRing` | function | `(control: Element, worn?: Element) => number \| undefined` | Measures the contrast the focus chrome painted on one control reaches against its own backdrop. |
432
- | `readClipEdge` | function | `(element: Element) => number \| undefined` | Measures the row a clipping element cuts its content off at, in document coordinates. |
433
- | `readClipMargin` | function | `(element: Element) => number` | Measures how far past its own box a clipping element lets its content show. |
434
- | `readClippedBlock` | function | `(element: Element) => number` | Measures the block size an element shows after every clipping ancestor cuts it. |
435
- | `collectClippingAncestors` | function | `(element: Element) => readonly Element[]` | Collects the ancestors of an element that clip their descendants' overflow. |
436
- | `clipsOverflow` | function | `(element: Element) => boolean` | Reports whether an element clips its descendants' overflow. |
437
- | `measureContent` | function | `() => number` | Measures the row the document's own content ends on, in document coordinates. |
438
- | `stagePane` | function | `(width: number, height: number) => Promise<void>` | Sets the tester's viewport and renders the runner's pane at the size that viewport claims. |
439
- | `releasePane` | function | `() => Promise<void>` | Hands the tester pane back to the runner's own layout, at the viewport it had before staging. |
440
- | `computeOffset` | function | `(box: DOMRectReadOnly, width: number, height: number) => FrameOffset` | Computes how far an element frame moves the tester frame so the element is shot inside the runner's window. |
441
- | `stageMedia` | function | `(options: MediaOptions) => Promise<void>` | Stages the tester's print medium, motion preference, forced colours, and pointer precision through the browser provider. |
442
- | `releaseMedia` | function | `() => Promise<void>` | Restores the media readings observed before the first stage as explicit emulation. With nothing staged, clears every override and waits for a stable reading, not a proved engine baseline. Checks the budget between polls, so a frame that never paints is not bounded by it. |
443
- | `waitForStability` | function | `(description: string, read: () => string, options?: StabilityOptions) => Promise<void>` | Waits for a reading to hold across its last `frames + 1` reads, each later read taken after a painted frame, with the interval slept between polls. Checks the budget between reads, so a frame that never paints is not bounded by it. |
444
- | `settleFrame` | function | `(options: FrameOptions, element: Element \| undefined, prepared: boolean, pane?: number, covered?: number, stage?: number) => Promise<void>` | Restages a capture until its content extent equals the pane height. |
445
- | `readFrameHeight` | function | `(options: FrameOptions, element: Element \| undefined, pane: number) => number \| undefined` | Reads a capture subject's height after applying its native scroll clearance. |
446
- | `takeFrameShot` | function | `(options: FrameOptions, element: Element \| undefined) => Promise<FrameShot>` | Takes a screenshot while temporarily positioning the runner frame around its subject. |
447
- | `captureFrame` | function | `(options: FrameOptions) => Promise<string>` | Shoots one frame at one viewport size and proves the file on disk holds this run's bytes. |
448
- | `readCaptureReader` | function | `() => CaptureReader \| undefined` | Reads the optional disk-digest command the tester page registered. |
449
- | `verifyFrame` | function | `(shot: FrameShot, path: string, reader?: CaptureReader) => Promise<void>` | Verifies a screenshot's destination and compares its returned bytes with the written file. |
450
- | `paintImage` | function | `(encoded: string) => Promise<OffscreenCanvasRenderingContext2D \| undefined>` | Decodes a base64 PNG and paints it, unscaled, onto a fresh offscreen 2D canvas. |
451
- | `readFrame` | function | `(path: string) => Promise<FrameResult>` | Reads one written frame back and reports its size and the color its bottom row paints. |
452
- | `readShotPixel` | function | `(element: Element, x: number, y: number) => Promise<RGBA>` | Reads one painted pixel of an element's screenshot. |
453
- | `readCascade` | function | `() => ReadonlySet<string>` | Collects every class token the stylesheets loaded into this document actually define. |
454
- | `readClasses` | function | `(root: ParentNode) => ReadonlySet<string>` | Collects every class token the markup under one root carries. |
455
- | `readCensus` | function | `(root: ParentNode) => CensusResult` | Takes the authored-class census of one subtree against the cascade this document loaded. |
456
- | `sendTouch` | function | `(type: 'touchStart' \| 'touchMove' \| 'touchEnd' \| 'touchCancel', element?: Element, point?: ProtocolPoint) => Promise<void>` | Sends one emulated touch event through the browser protocol. |
457
- | `tapTouch` | function | `(element: Element, options?: StabilityOptions) => Promise<void>` | Taps an element's centre with emulated touch after its box settles. |
458
- | `releaseTouch` | function | `() => Promise<void>` | Cancels emulated touch input, disables touch emulation, and parks the pointer. |
459
- | `sendFileDrag` | function | `(type: 'dragEnter' \| 'dragOver' \| 'dragCancel', role: string, name: string, names: readonly string[]) => Promise<void>` | Carries files from outside the page over a rendered target named by role and accessible name. |
460
- | `recordConsole` | function | `(name: string, output: string[], forward: (...data: unknown[]) => void) => (...data: unknown[]) => void` | Records every call one console channel receives and hands that call on unchanged. |
461
- | `adoptSheet` | function | `(text: string) => SheetAdoption` | Adopts CSS text into the document with an idempotent release operation. |
462
- | `readLayerNames` | function | `(source: CSSStyleSheet \| CSSGroupingRule \| CSSStyleRule, layer?: string) => readonly string[]` | Reads layer statements and blocks in declaration order, including repeated names. |
463
- | `readRules` | function | `() => readonly CSSRule[]` | Collects every rule the stylesheets loaded into this document hold, nested grouping rules included. |
464
- | `findStyleRule` | function | `(selector: string) => CSSStyleRule \| undefined` | Finds the first style rule in the cascade whose selector carries a fragment. |
465
- | `findKeyframes` | function | `(name: string) => CSSKeyframesRule \| undefined` | Finds the animation the cascade declares under one name. |
466
- | `readRows` | function | `(root: ParentNode, selector: string) => readonly string[]` | Reads the normalized visible text of every element a selector matches, in document order. |
467
- | `extractOrphans` | function | `(root: ParentNode, child: string, parent: string) => readonly string[]` | Collects every element carrying a component class rendered outside the container it belongs to. |
468
- | `extractStyles` | function | `(root: ParentNode) => readonly string[]` | Collects the markup of every element carrying a non-empty `style` attribute and of every `<style>` element, in document order, `root` included in both populations when it is an `Element`. |
469
- | `readStyle` | function | `(element: Element, property: string, pseudo?: string) => string` | Reads one resolved CSS property from a real browser element or a named pseudo-element. |
470
- | `readToken` | function | `(element: Element, name: string) => string` | Reads one custom property from an element's resolved style. |
471
- | `readRootToken` | function | `(name: string) => string` | Reads one custom property from the document element. |
472
- | `readPixels` | function | `(element: Element, property: string, pseudo?: string) => number` | Reads one resolved CSS length as a number of pixels. |
473
- | `expandCaptures` | function | `(states: readonly string[], variants: readonly CaptureVariant[]) => readonly string[]` | Expands a capture registry across every variant into the filenames a complete portfolio holds. |
474
- | `buildDenial` | function | `(operation: string, key?: string) => DOMException` | Builds the refusal a host withholding a storage operation raises. |
475
- | `buildContrast` | function | `(bar: number) => ContrastFixture` | Builds a detached translucent stack whose composited and flat contrast readings straddle one bar. |
476
- | `buildEscapes` | function | `(permitted: string) => EscapeFixture` | Builds detached markup carrying one style escape of each kind, plus the sheet a project allows. |
477
- | `buildCensus` | function | `() => CensusFixture` | Builds detached markup carrying one undeclared class token on HTML and another on SVG. |
349
+ | Name | Kind | Signature | Summary |
350
+ | -------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
351
+ | `supportsSegmentedFocus` | function | `(element: Element) => boolean` | Determines whether a native input exposes separately editable segments under one focused element. |
352
+ | `resolveAccessible` | function | `((name: string) => HTMLElement) & ((role: string, name: string) => HTMLElement)` | Resolves one visible, focus-reachable interactive element by its exact accessible name. A wholly-off-viewport target is scrolled into view before reachability is measured. |
353
+ | `resolveAccessibleWithin` | function | `(region: string, role: string, name: string) => HTMLElement` | Resolves one human-reachable control by role and accessible-name text inside a named region. |
354
+ | `resolveRendered` | function | `(first: string, second?: string) => HTMLElement` | Resolves one rendered, focus-reachable interactive element without requiring it to intersect the viewport yet. |
355
+ | `computeNamePattern` | function | `(name: string) => RegExp` | Computes the pattern that matches one accessible name a decorative glyph may sit beside. |
356
+ | `isOutsideViewport` | function | `(rectangle: DOMRectReadOnly) => boolean` | Determines whether a rectangle lies wholly outside the browser viewport. |
357
+ | `isRendered` | function | `(element: Element) => boolean` | Determines whether the accessibility tree presents one element at all. |
358
+ | `collectShadowHosts` | function | `(element: Element, root?: Node) => readonly Element[]` | Collects an element and the successive hosts of its containing shadow roots. |
359
+ | `isReachable` | function | `(element: Element) => boolean` | Determines whether a person can click one element where it sits. |
360
+ | `readHit` | function | `(element: Element) => Element \| undefined` | Reads the topmost element at one element's bounding-box centre. |
361
+ | `clickAccessible` | function | `((name: string) => Promise<void>) & ((role: string, name: string) => Promise<void>)` | Clicks one visible, focus-reachable control by its accessible name through the browser provider. |
362
+ | `clickAccessibleWithin` | function | `(region: string, role: string, name: string) => Promise<void>` | Clicks one human-reachable control by role and accessible-name text inside a named region. |
363
+ | `clickDisclosure` | function | `(name: string) => Promise<void>` | Opens or closes one native details disclosure by its rendered summary. |
364
+ | `readProtocolSession` | function | `() => readonly [unknown, unknown]` | Reads the browser provider's DevTools session and its send member. |
365
+ | `sendProtocol` | function | `(method: string, params?: Readonly<Record<string, unknown>>) => Promise<unknown>` | Sends one DevTools protocol command through the browser provider. |
366
+ | `readProtocolPoint` | function | `(element: Element, offset?: ProtocolPoint) => ProtocolPoint` | Projects a point of one element through every frame that holds it into the browser's top-level viewport. |
367
+ | `readProtocolNode` | function | `(element: Element) => Promise<number>` | Resolves one element to the node the browser's DOM tree holds for it. |
368
+ | `readAccessibilityNode` | function | `(element: Element) => Promise<AccessibilityNode>` | Reads the accessibility node the browser computed for one element. |
369
+ | `hoverAccessible` | function | `((name: string) => Promise<void>) & ((role: string, name: string) => Promise<void>)` | Hovers one visible, focus-reachable control by its accessible name through the browser provider. |
370
+ | `holdAccessible` | function | `((name: string) => Promise<void>) & ((role: string, name: string) => Promise<void>)` | Holds the primary pointer button on one visible, focus-reachable control by its accessible name. |
371
+ | `holdAccessibleWithin` | function | `(region: string, role: string, name: string) => Promise<void>` | Holds the primary pointer button on one control by role and accessible-name text inside a named region. |
372
+ | `driveHold` | function | `(resolve: () => HTMLElement, name: string) => Promise<void>` | Holds the primary pointer button on the control a resolver returns, through the browser provider. |
373
+ | `parkPointer` | function | `() => Promise<void>` | Parks the pointer outside the page and waits for the parked pointer's frame to paint. |
374
+ | `releasePointer` | function | `() => Promise<void>` | Releases a held pointer and parks it outside the page, clearing hover. |
375
+ | `typeAccessible` | function | `(name: string, text: string) => Promise<void>` | Replaces a named field's value through focus, select-all, deletion, and real keystrokes. |
376
+ | `fillAccessible` | function | `(name: string, text: string) => Promise<void>` | Replaces a named field's value in one operation, for text too long to type key by key. |
377
+ | `traverseAccessible` | function | `(name: string) => Promise<HTMLElement>` | Reaches a named control only through natural forward Tab traversal from the current focus. |
378
+ | `traverseAccessibleWithin` | function | `(region: string, role: string, name: string) => Promise<HTMLElement>` | Reaches a control by role and accessible-name text inside a named region, only through natural forward Tab traversal from the current focus. |
379
+ | `readActiveElement` | function | `(root?: Document \| ShadowRoot) => HTMLElement \| undefined` | Reads the HTML element that holds focus, following it into open shadow roots and same-origin frames. |
380
+ | `countElements` | function | `(root?: Document \| ShadowRoot) => number` | Counts the elements a tree holds, descending into open shadow roots and same-origin frames. |
381
+ | `containsNode` | function | `(root: Node, node: Node) => boolean` | Determines whether a node sits inside a root, through open shadow roots and frames. |
382
+ | `stepFocus` | function | `(limit: number) => AsyncGenerator<HTMLElement \| undefined, void, undefined>` | Presses Tab and yields the element focus lands on, once per press, up to a limit. |
383
+ | `matchesTraversalName` | function | `(element: HTMLElement, name: string, exact?: boolean) => boolean` | Checks whether a landing can carry a requested accessible name without resolving the document. |
384
+ | `driveTraversal` | function | `(resolve: () => HTMLElement, name: string, candidate?: (element: HTMLElement) => boolean) => Promise<HTMLElement>` | Reaches the control a resolver returns, only through natural forward Tab traversal from the current focus. |
385
+ | `walkFocus` | function | `(stop?: (element: HTMLElement) => boolean) => Promise<readonly HTMLElement[]>` | Walks forward by real Tab presses from the focused element until a predicate accepts a stop or the Tab order ends. |
386
+ | `collectTabStops` | function | `(root: Element, start: HTMLElement) => Promise<readonly HTMLElement[]>` | Collects the elements of a region that a forward Tab walk reaches from a starting element. |
387
+ | `pressKeys` | function | `(keys: string) => Promise<void>` | Sends a key sequence to whatever holds focus, and refuses to send it to nothing. |
388
+ | `readPerception` | function | `(name: string) => string` | Reads the normalized visible text of one named region, dialog, table, tab panel, or alert. |
389
+ | `readPage` | function | `() => string` | Reads the normalized visible text of the whole page. |
390
+ | `readFocus` | function | `() => string \| undefined` | Reads the rendered text of the element that holds focus. |
391
+ | `readControlValue` | function | `(role: string, name: string) => string` | Reads the value a resolved control renders. |
392
+ | `readRefusal` | function | `((name: string) => string \| undefined) & ((role: string, name: string) => string \| undefined)` | Reads the refusal one named target answers with, or nothing when it resolves. |
393
+ | `readText` | function | `(element: Element) => string` | Reads one element's rendered text the way a name computation reads it. |
394
+ | `readRole` | function | `(element: Element) => string \| undefined` | Reads the role one element carries in the accessibility tree. |
395
+ | `readName` | function | `(element: Element) => string` | Reads the accessible name one element is announced under. |
396
+ | `readStates` | function | `(element: Element) => readonly string[]` | Reads the states one element is announced in. |
397
+ | `describeTree` | function | `(element: Element) => string` | Describes the accessible tree one rendered element presents. |
398
+ | `describeFocus` | function | `(element: Element) => string` | Describes the order sequential keyboard navigation visits one element's controls in. |
399
+ | `waitForFrame` | function | `() => Promise<void>` | Waits for one animation frame to settle pending browser paint work. |
400
+ | `waitForState` | function | `((name: string, state: string, options?: StateOptions) => Promise<readonly string[]>) & ((role: string, name: string, state: string, options?: StateOptions) => Promise<readonly string[]>)` | Waits until one named control announces a state, or stops announcing it. |
401
+ | `waitForAnimations` | function | `(element: Element, options?: WaitOptions) => Promise<void>` | Waits until every finite animation on one element and its subtree has stopped moving. |
402
+ | `readAnimations` | function | `(element: Element) => AnimationResult` | Reads the animations running on one element and its subtree, split by whether each one ends. |
403
+ | `settleCapture` | function | `(options?: SettleOptions) => Promise<() => void>` | Settles the page for one capture: parks the pointer, waits out every finite animation, and holds each endless animation at its first frame. |
404
+ | `collectScrollRegions` | function | `(root: Element, axis?: 'inline' \| 'block') => readonly HTMLElement[]` | Collects the rendered boxes a person can scroll. |
405
+ | `describeScrollRegions` | function | `(regions: readonly HTMLElement[]) => string` | Describes the window's scroll position and each scroll region's offsets and extents. |
406
+ | `build` | function | `<K extends keyof HTMLElementTagNameMap>(tag: K, options?: ElementOptions) => HTMLElementTagNameMap[K]` | Builds one unmounted element of a known tag, wearing the classes, text, and attributes asked for. |
407
+ | `mount` | function | `<T extends Element>(element: T) => T` | Puts one element into the document and hands it straight back. |
408
+ | `typeInput` | function | `(element: HTMLInputElement \| HTMLTextAreaElement, text: string) => void` | Sets one field's value and announces it the way typing into the field does. |
409
+ | `commitInput` | function | `(element: HTMLInputElement \| HTMLTextAreaElement, text: string) => void` | Sets one field's value and commits it, the way typing and then leaving the field does. |
410
+ | `render` | function | `((markup: string) => HTMLDivElement) & (<K extends keyof HTMLElementTagNameMap>(tag: K, classes: string) => HTMLElementTagNameMap[K])` | Renders one fixture into the document from trusted markup. |
411
+ | `clearStorage` | function | `() => void` | Clears both browser storage surfaces. |
412
+ | `removeDatabase` | function | `(name: string) => Promise<void>` | Deletes one IndexedDB database and reports what the request actually did. |
413
+ | `convertSRGB` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA` | Converts normalized encoded sRGB channels to the clipped paint scale. |
414
+ | `convertLinearSRGB` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA` | Converts linear sRGB channels to encoded, clipped paint channels. |
415
+ | `convertXYZD65` | function | `(x: number, y: number, z: number, alpha?: number) => RGBA` | Converts D65 XYZ coordinates to clipped sRGB paint channels. |
416
+ | `convertXYZD50` | function | `(x: number, y: number, z: number, alpha?: number) => RGBA` | Converts D50 XYZ coordinates to clipped sRGB paint channels. |
417
+ | `convertOKLab` | function | `(lightness: number, a: number, b: number, alpha?: number) => RGBA` | Converts OKLab coordinates to clipped sRGB paint channels. |
418
+ | `convertLab` | function | `(lightness: number, a: number, b: number, alpha?: number) => RGBA` | Converts CIE Lab coordinates relative to D50 to clipped sRGB paint channels. |
419
+ | `convertDisplayP3` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA` | Converts encoded Display P3 channels to clipped sRGB paint channels. |
420
+ | `convertA98RGB` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA` | Converts encoded A98 RGB channels to clipped sRGB paint channels. |
421
+ | `convertProPhotoRGB` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA` | Converts encoded ProPhoto RGB channels to clipped sRGB paint channels. |
422
+ | `convertRec2020` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA` | Converts encoded Rec. 2020 channels to clipped sRGB paint channels. |
423
+ | `parseColor` | function | `(value: string) => RGBA \| undefined` | Parses computed CSS Color 4 values into clipped straight sRGB channels. |
424
+ | `parseCSSColor` | function | `(value: string, scope?: Element) => RGBA \| undefined` | Resolves any CSS color expression to straight sRGB channels, by asking the browser. |
425
+ | `matchesColor` | function | `(first: string \| RGBA, second: string \| RGBA) => boolean` | Determines whether two colors render the same, within the rounding a browser does. |
426
+ | `blendColor` | function | `(front: RGBA, back: RGBA) => RGBA` | Composites one color over another. |
427
+ | `measureLuminance` | function | `(color: RGBA) => number` | Measures one opaque color's WCAG relative luminance. |
428
+ | `measureContrast` | function | `(front: RGBA, back: RGBA) => number` | Measures the WCAG 2.x contrast ratio between two opaque colors. |
429
+ | `readLayers` | function | `(element: Element) => readonly RGBA[]` | Collects readable background color layers and refuses an unreadable painted layer. |
430
+ | `readBackdrop` | function | `(element: Element, floor: RGBA) => RGBA` | Resolves the opaque color standing behind one element. |
431
+ | `readColorContrast` | function | `(element: Element, color: string, options?: ContrastOptions) => number` | Measures the WCAG 2.x contrast ratio one color reaches when painted over an element's backdrop. |
432
+ | `readContrast` | function | `(element: Element, floor?: RGBA) => number` | Measures the WCAG 2.x contrast ratio between an element's computed text and background colors. |
433
+ | `readRing` | function | `(control: Element, worn?: Element) => number \| undefined` | Measures the contrast the focus chrome painted on one control reaches against its own backdrop. |
434
+ | `readClipEdge` | function | `(element: Element) => number \| undefined` | Measures the row a clipping element cuts its content off at, in document coordinates. |
435
+ | `readClipMargin` | function | `(element: Element) => number` | Measures how far past its own box a clipping element lets its content show. |
436
+ | `readClippedBlock` | function | `(element: Element) => number` | Measures the block size an element shows after every clipping ancestor cuts it. |
437
+ | `collectClippingAncestors` | function | `(element: Element) => readonly Element[]` | Collects the ancestors of an element that clip their descendants' overflow. |
438
+ | `collectScrollContainers` | function | `(element?: Element) => readonly Element[]` | Collects the scroll containers in an element's subtree, the element included unless it is the body or the root element. |
439
+ | `collectUnrolledRegions` | function | `(element?: Element) => readonly Element[]` | Collects the vertical scroll regions an unrolled frame releases in an element's subtree, the element included unless it is the body or the root element. |
440
+ | `clipsOverflow` | function | `(element: Element) => boolean` | Reports whether an element clips its descendants' overflow. |
441
+ | `measureContent` | function | `() => number` | Measures the row the document's own content ends on, in document coordinates. |
442
+ | `containsFixed` | function | `(element: Element) => boolean` | Reports whether an element is the containing block of the fixed-position boxes inside it. |
443
+ | `collectFlatDescendants` | function | `(element: Element) => readonly Element[]` | Collects the elements under an element in the flat tree, in the order a browser paints them. |
444
+ | `collectFlatAncestors` | function | `(element: Element, region: Element) => readonly Element[]` | Collects an element's ancestors in the flat tree, nearest first, up to and including a region. |
445
+ | `collectRegionRows` | function | `(region: Element) => readonly Element[]` | Collects the elements under a scroll region whose boxes lay out in its scrollable area, walking the flat tree. |
446
+ | `measureRegion` | function | `(region: Element) => number` | Measures the rows a scroll region's content lays out, whether or not its box shows them all. |
447
+ | `renderSelector` | function | `(element: Element) => string` | Renders a selector path that locates an element from its nearest ancestor carrying an id. |
448
+ | `renderLabel` | function | `(element: Element) => string` | Renders the locator a capture refusal names an element by. |
449
+ | `stagePane` | function | `(width: number, height: number) => Promise<void>` | Sets the tester's viewport and renders the runner's pane at the size that viewport claims. |
450
+ | `releasePane` | function | `() => Promise<void>` | Hands the tester pane back to the runner's own layout, at the viewport it had before staging. |
451
+ | `computeOffset` | function | `(box: DOMRectReadOnly, width: number, height: number) => FrameOffset` | Computes how far an element frame moves the tester frame so the element is shot inside the runner's window. |
452
+ | `stageMedia` | function | `(options: MediaOptions) => Promise<void>` | Stages the tester's print medium, motion preference, forced colours, and pointer precision through the browser provider. |
453
+ | `releaseMedia` | function | `() => Promise<void>` | Restores the media readings observed before the first stage as explicit emulation. With nothing staged, clears every override and waits for a stable reading, not a proved engine baseline. Checks the budget between polls, so a frame that never paints is not bounded by it. |
454
+ | `waitForStability` | function | `(description: string, read: () => string, options?: StabilityOptions) => Promise<void>` | Waits for a reading to hold across its last `frames + 1` reads, each later read taken after a painted frame, with the interval slept between polls. Checks the budget between reads, so a frame that never paints is not bounded by it. |
455
+ | `settleFrame` | function | `(options: FrameOptions, element: Element \| undefined, prepared: boolean, pane?: number, covered?: number, stage?: number, regions?: ReadonlyMap<Element, number>) => Promise<readonly Element[]>` | Restages a capture until its content extent equals the pane height. |
456
+ | `readFrameHeight` | function | `(options: FrameOptions, element: Element \| undefined, pane: number) => number \| undefined` | Reads a capture subject's height after applying its native scroll clearance. |
457
+ | `takeFrameShot` | function | `(options: FrameOptions, element: Element \| undefined) => Promise<FrameShot>` | Takes a screenshot while temporarily positioning the runner frame around its subject. |
458
+ | `captureFrame` | function | `(options: FrameOptions) => Promise<string>` | Shoots one frame at one viewport size and proves the file on disk holds this run's bytes. |
459
+ | `readCaptureReader` | function | `() => CaptureReader \| undefined` | Reads the optional disk-digest command the tester page registered. |
460
+ | `verifyFrame` | function | `(shot: FrameShot, path: string, reader?: CaptureReader) => Promise<void>` | Verifies a screenshot's destination and compares its returned bytes with the written file. |
461
+ | `paintImage` | function | `(encoded: string) => Promise<OffscreenCanvasRenderingContext2D \| undefined>` | Decodes a base64 PNG and paints it, unscaled, onto a fresh offscreen 2D canvas. |
462
+ | `readFrame` | function | `(path: string) => Promise<FrameResult>` | Reads one written frame back and reports its size and the color its bottom row paints. |
463
+ | `readShotPixel` | function | `(element: Element, x: number, y: number) => Promise<RGBA>` | Reads one painted pixel of an element's screenshot. |
464
+ | `readCascade` | function | `() => ReadonlySet<string>` | Collects every class token the stylesheets loaded into this document actually define. |
465
+ | `readClasses` | function | `(root: ParentNode) => ReadonlySet<string>` | Collects every class token the markup under one root carries. |
466
+ | `readCensus` | function | `(root: ParentNode) => CensusResult` | Takes the authored-class census of one subtree against the cascade this document loaded. |
467
+ | `sendTouch` | function | `(type: 'touchStart' \| 'touchMove' \| 'touchEnd' \| 'touchCancel', element?: Element, point?: ProtocolPoint) => Promise<void>` | Sends one emulated touch event through the browser protocol. |
468
+ | `tapTouch` | function | `(element: Element, options?: StabilityOptions) => Promise<void>` | Taps an element's centre with emulated touch after its box settles. |
469
+ | `releaseTouch` | function | `() => Promise<void>` | Cancels emulated touch input, disables touch emulation, and parks the pointer. |
470
+ | `sendFileDrag` | function | `(type: 'dragEnter' \| 'dragOver' \| 'dragCancel', role: string, name: string, names: readonly string[]) => Promise<void>` | Carries files from outside the page over a rendered target named by role and accessible name. |
471
+ | `recordConsole` | function | `(name: string, output: string[], forward: (...data: unknown[]) => void) => (...data: unknown[]) => void` | Records every call one console channel receives and hands that call on unchanged. |
472
+ | `adoptSheet` | function | `(text: string) => SheetAdoption` | Adopts CSS text into the document with an idempotent release operation. |
473
+ | `readLayerNames` | function | `(source: CSSStyleSheet \| CSSGroupingRule \| CSSStyleRule, layer?: string) => readonly string[]` | Reads layer statements and blocks in declaration order, including repeated names. |
474
+ | `readRules` | function | `() => readonly CSSRule[]` | Collects every rule the stylesheets loaded into this document hold, nested grouping rules included. |
475
+ | `findStyleRule` | function | `(selector: string) => CSSStyleRule \| undefined` | Finds the first style rule in the cascade whose selector carries a fragment. |
476
+ | `findKeyframes` | function | `(name: string) => CSSKeyframesRule \| undefined` | Finds the animation the cascade declares under one name. |
477
+ | `readRows` | function | `(root: ParentNode, selector: string) => readonly string[]` | Reads the normalized visible text of every element a selector matches, in document order. |
478
+ | `extractOrphans` | function | `(root: ParentNode, child: string, parent: string) => readonly string[]` | Collects every element carrying a component class rendered outside the container it belongs to. |
479
+ | `extractStyles` | function | `(root: ParentNode) => readonly string[]` | Collects the markup of every element carrying a non-empty `style` attribute and of every `<style>` element, in document order, `root` included in both populations when it is an `Element`. |
480
+ | `readStyle` | function | `(element: Element, property: string, pseudo?: string) => string` | Reads one resolved CSS property from a real browser element or a named pseudo-element. |
481
+ | `readToken` | function | `(element: Element, name: string) => string` | Reads one custom property from an element's resolved style. |
482
+ | `readRootToken` | function | `(name: string) => string` | Reads one custom property from the document element. |
483
+ | `readPixels` | function | `(element: Element, property: string, pseudo?: string) => number` | Reads one resolved CSS length as a number of pixels. |
484
+ | `expandCaptures` | function | `(states: readonly string[], variants: readonly CaptureVariant[]) => readonly string[]` | Expands a capture registry across every variant into the filenames a complete portfolio holds. |
485
+ | `buildDenial` | function | `(operation: string, key?: string) => DOMException` | Builds the refusal a host withholding a storage operation raises. |
486
+ | `buildContrast` | function | `(bar: number) => ContrastFixture` | Builds a detached translucent stack whose composited and flat contrast readings straddle one bar. |
487
+ | `buildEscapes` | function | `(permitted: string) => EscapeFixture` | Builds detached markup carrying one style escape of each kind, plus the sheet a project allows. |
488
+ | `buildCensus` | function | `() => CensusFixture` | Builds detached markup carrying one undeclared class token on HTML and another on SVG. |
478
489
 
479
490
  #### Factories
480
491
 
@@ -718,8 +729,10 @@ deliberate differences from 0.0.8. A class declared inside a grouping rule count
718
729
  because a class the cascade defines under a condition is still one the cascade defines; 0.0.8 read
719
730
  the top-level rules alone. Insertion order is breadth-first, so a top-level class lands before a
720
731
  class declared inside an earlier grouping rule; 0.0.8 popped a stack and inserted the deepest rule
721
- first. Iterate the set where the order is the subject and read `has` where membership is. A
722
- `@keyframes` rule's own children are outside the walk, so an animation's stops define no token here.
732
+ first. Iterate the set where the order is the subject and read `has` where membership is. A class
733
+ named only in an `@scope` prelude counts as defined, so `@scope (.panel) to (.footer)` defines
734
+ `panel` and `footer`. A `@keyframes` rule's own children are outside the walk, so an animation's
735
+ stops define no token here.
723
736
 
724
737
  Each rule's selector text is read by `collectSelectorClasses`, and that reading differs from 0.0.26,
725
738
  which matched a pattern over the text. An escaped name decodes, so `.sm\:flex` defines `sm:flex`
@@ -845,6 +858,82 @@ written at a height that is already wrong. That bound is 4: a document holding h
845
858
  fixed block settles in two restagings, one whose growth is capped part way settles in three, and
846
859
  the fourth is headroom.
847
860
 
861
+ To cover the rows a vertical scroll region hides, set `unrolled`. A page whose shell scrolls an inner
862
+ pane, a viewport-height layout with an `overflow: auto` column, ends for `measureContent` at the
863
+ column's clip edge, so a plain frame of it stops at the declared height. An unrolled frame adds
864
+ each region's hidden rows, its `scrollHeight` minus its `clientHeight`, to that edge before every
865
+ staging, and the page's own layout grows the column with the pane; the capture writes nothing to
866
+ the page's styles. The `collectUnrolledRegions` helper finds those regions: an `overflow-y` value of
867
+ the `auto` keyword or the `scroll` keyword with rows to hide, found through open shadow roots. It
868
+ leaves out the body and the root element, whose rows are the document's own; a `hidden` or `clip`
869
+ overflow, which hides rows by design; a text area, a list box, or an input, whose rows are the
870
+ control's value; a region `checkVisibility` reports the page does not show, its `visibility` read
871
+ included; and a region that lies wholly outside the frame, such as a navigation drawer a transform
872
+ moves off the page. An `overflow-x: auto` wrapper computes an `overflow-y` of `auto` too, so it
873
+ drops out only because its rows fit. An element frame counts the regions that overlap the
874
+ element's box. The journey reader `isRendered` is not the test here, because a region marked
875
+ `aria-hidden` still paints. A region inside a closed shadow root is unreachable, so its rows stay
876
+ hidden without a refusal.
877
+
878
+ Hidden rows add up, which is right for a region nested in another and too much for panes side by
879
+ side: a sidebar and a main pane that both hide rows sum to a pane taller than either needs, and a
880
+ viewport-height shell shows the difference as an empty band. The regions that hid rows at the
881
+ first reading are therefore kept, and after none of them hides rows, each staging moves down by
882
+ the smallest slack among them: the rows between a region's last row and its bottom edge, which the
883
+ `measureRegion` helper reads, because `scrollHeight` never reads less than the box. It reads the
884
+ elements the `collectRegionRows` helper reaches through the flat tree, so rows in a host's shadow
885
+ root and rows assigned to a slot count. A fixed bar or an absolute overlay laid out against a block
886
+ outside the region does not count, because it adds nothing to the region's scroll height. The
887
+ containment is decided by climbing from each fixed or absolute box to the region through the
888
+ `collectFlatAncestors` helper, looking for a positioned ancestor or one the `containsFixed` helper
889
+ reports: a `transform`, `translate`, `rotate`, `scale`, `perspective`, `filter`, or
890
+ `backdrop-filter` other than `none`, layout or paint containment, a `size` or `inline-size`
891
+ container type, `content-visibility: auto`, `transform-style: preserve-3d`, or a `will-change`
892
+ naming one of those properties. A region
893
+ whose height did not change across a staging keeps a fixed height, so its hidden rows stop
894
+ counting and the staging settles without it.
895
+
896
+ A shell of a 60-row header over a column of 2000 rows unrolls to a 2060-row frame. A sidebar of
897
+ 1200 rows beside a main pane of 1600 rows unrolls to 1660 rows, with the main pane's last row on
898
+ the floor, whether the main pane holds a fixed bar or an inset overlay, scrolls rows in its own
899
+ shadow root, or scrolls slotted rows under a shadow scroller. A `50vh` region nested in a column
900
+ settles on the layout's fixed point of 2520 rows. A staging that the carried growth would land
901
+ back on the current pane stages at the extent instead, because a repeated pane reads every
902
+ height unchanged and would settle on a band. A layout that needs more restagings than
903
+ `CAPTURE_STAGE_LIMIT` allows is refused rather than written with a band, and the refusal names
904
+ every region still hiding rows with its locator and its hidden pixels.
905
+
906
+ Three cases stay outside what an unrolled frame reads. A containing block that `containsFixed`
907
+ does not read counts a fixed or absolute box as a row, which ends in that never-settled refusal
908
+ naming the regions. A `:modal` dialog or a `:popover-open` element under a transformed ancestor is
909
+ counted as a row, though the top layer lays it out. A region inside a closed shadow root is
910
+ unreachable, so its rows stay hidden without a refusal.
911
+
912
+ A region that still hides rows after the settling refuses the capture with
913
+ `Capture frame at <path> leaves rows hidden in scroll regions: <region> <cause> and hides <n> px, so <correction>. Shoot the frame without unrolled to keep them scrolled`.
914
+ The refusal names every such region, and the cause and the correction come from what was
915
+ measured:
916
+
917
+ - A region that kept its height across a staging, or kept the height it had at the declared
918
+ viewport, `keeps a fixed height`, so bound its height to the viewport.
919
+ - A region whose height changed as the pane grew `grows by less than the pane`, so let it take all
920
+ the height the pane adds.
921
+ - A region that hid no rows at the declared viewport hides them `at the final reading`, so let its
922
+ height follow the viewport.
923
+ - A region at a pane that never grew past the declared height hides its rows `though the declared
924
+ viewport has room for them`, so let it fill the viewport's remaining height.
925
+
926
+ A fixed `#log` in a viewport-height column is refused as `keeps a fixed height` rather than as a
927
+ document that never settles, and a lone `50vh` region of 1000 rows settles at 1000 with 500 hidden
928
+ and is refused as `grows by less than the pane`. The `renderLabel` helper names each region by
929
+ the path the `renderSelector` helper renders from its nearest ancestor carrying an id, such as
930
+ `div#stage > section > div`, cut to its last `CAPTURE_LABEL_LIMIT` characters and JSON-encoded.
931
+
932
+ Growing a region to its full height clamps its scroll position to its first row, and an element
933
+ frame's alignment can scroll a container too. Before the first staging, `captureFrame` records the
934
+ scroll position of the window and of every scroll container the `collectScrollContainers` helper
935
+ finds, and restores each after the pane is released, on every path.
936
+
848
937
  An element that fits with its native scroll clearance is shot in the declared pane, so its viewport
849
938
  lengths resolve against the declared viewport: a `50vh` element under a 900-row block reads back 422
850
939
  rows in an 844-row pane. A short fixed panel that native alignment cannot move keeps that pane too.
@@ -899,7 +988,8 @@ still refuses an unregistered state and a second placement of one state, so a jo
899
988
  state wrongly fails the ordinary run rather than the first capture run; `placements` and `paths`
900
989
  stay empty, because they answer for what was captured. An enabled `place` applies the variant and writes `<directory>/<state>--<variant>.png` through
901
990
  `captureFrame`, so it stages the pane at the variant's size, covers the whole document, verifies the
902
- written bytes, and records only a path that read back as this run's own frame. The tester comes back
991
+ written bytes, and records only a path that read back as this run's own frame. A portfolio created
992
+ with `unrolled` passes it to every frame `place` writes. The tester comes back
903
993
  at the viewport it had before the placement, so a journey that places a state carries on at its own
904
994
  size rather than at the variant's. `placements` and `paths` hand out snapshots, so a list read
905
995
  before a placement stays what it was.
@@ -961,7 +1051,7 @@ The provider command consumes the browser journey's resolved selector inside Vit
961
1051
  | `requireContained` | function | `(root: string, target: string) => string` | Resolves a target that stays below a root directory, refusing a path outside it. |
962
1052
  | `hasScratchPath` | function | `(root: string, target: string) => boolean` | Reports whether a contained entry exists under a scratch directory without following its final link. |
963
1053
  | `isExcluded` | function | `(key: string, exclusions: readonly string[]) => boolean` | Reports whether a root-relative key matches an exclusion. |
964
- | `readIdentity` | function | `(status: Stats) => ScratchIdentity` | Reads the identity of one allocated directory off a host status. |
1054
+ | `readIdentity` | function | `(status: BigIntStats) => ScratchIdentity` | Reads the identity of one allocated directory off a host status. |
965
1055
  | `matchesIdentity` | function | `(current: ScratchIdentity, allocation: ScratchIdentity) => boolean` | Reports whether two directory identities name the same allocation. |
966
1056
  | `readErrorCode` | function | `(error: unknown) => string \| undefined` | Reads the `code` an unknown thrown value carries. |
967
1057
  | `createLink` | function | `(path: string, source: string) => void` | Creates a symbolic link with a directory-junction fallback for hosts that refuse symbolic links. |
@@ -1016,7 +1106,9 @@ All three fields are compared because none of them alone identifies an allocatio
1016
1106
  shared by every directory on one filesystem, an index node is reused after its directory is removed,
1017
1107
  and a creation time repeats within the host's timestamp resolution. It is exported so a fixture that
1018
1108
  manages its own directory can make the same check rather than trusting a path. `readIdentity` reads
1019
- that triple off a `node:fs` `Stats`, and it is the one reading `createScratch` takes at allocation,
1109
+ that triple off a `node:fs` `BigIntStats` taken with `{ bigint: true }`, with the creation time in
1110
+ nanoseconds as `birthtimeNs`. A number `Stats` rounds a file identifier past 2^53, and two distinct
1111
+ entries then compare equal. `readIdentity` is the one reading `createScratch` takes at allocation,
1020
1112
  before a `remove`, and before a `destroy`, so the three sites cannot drift on which fields name an
1021
1113
  allocation.
1022
1114
 
@@ -1314,64 +1406,65 @@ what the link reaches, not on what it stores.
1314
1406
  Every message `src/browser` throws. Keep them distinct: a journey asserts the one it means, and
1315
1407
  absent, present-but-gated, and ambiguous are different findings about an interface.
1316
1408
 
1317
- | Voice | Thrown by |
1318
- | ---------------------------------------------------------------------------------------- | ---------------------------------------------- |
1319
- | `No interactive element has the accessible name "<name>"` | `resolveRendered` |
1320
- | `Interactive target "<name>" is not visible and focus-reachable` | `resolveRendered` |
1321
- | `Interactive target "<name>" is ambiguous across <n> elements` | `resolveRendered` |
1322
- | `Interactive target "<name>" could not be resolved` | `resolveRendered` |
1323
- | `Interactive target "<name>" is unreachable after scrolling` | `resolveAccessible` |
1324
- | `Interactive target "<name>" is not reachable inside "<region>"` | `resolveAccessibleWithin` |
1325
- | `Interactive target "<name>" is ambiguous across <n> elements inside "<region>"` | `resolveAccessibleWithin` |
1326
- | `Interactive target "<name>" could not be resolved inside "<region>"` | `resolveAccessibleWithin` |
1327
- | `Native disclosure "<name>" is not visible and focus-reachable` | `clickDisclosure` |
1328
- | `Native disclosure "<name>" is ambiguous across <n> elements` | `clickDisclosure` |
1329
- | `Native disclosure "<name>" could not be resolved` | `clickDisclosure` |
1330
- | `The element is not connected to a document, so it has no point to read` | `readProtocolPoint` |
1331
- | `Interactive target "<name>" is not reachable through forward Tab traversal: <trail>` | `driveTraversal` |
1332
- | `Named region "<name>" is not visible` | `readPerception` |
1333
- | `Named region "<name>" is ambiguous across <n> elements` | `readPerception` |
1334
- | `Named region "<name>" could not be resolved` | `readPerception` |
1335
- | `Interactive target "<name>" does not carry a value` | `readControlValue` |
1336
- | `Computed foreground color is unavailable` | `readContrast` |
1337
- | `Computed background color is unavailable` | `readColorContrast` |
1338
- | `Color "<value>" is unreadable` | `readColorContrast` |
1339
- | `Contrast opacity must be between 0 and 1` | `readColorContrast` |
1340
- | `The element is not connected to a document, so it has no clipping ancestors to read` | `collectClippingAncestors`, `readClippedBlock` |
1341
- | `Tester pane is unavailable for a capture` | `stagePane` |
1342
- | `Tester pane rendered <w>x<h> for a <w>x<h> viewport` | `stagePane` |
1343
- | `Capture frame at <path> never settled after <n> restagings: <h> over a <h> pane` | `captureFrame` |
1344
- | `Capture frame was written to <path> where <path> was asked for` | `captureFrame`, `verifyFrame` |
1345
- | `Capture frame at <path> is not the one this run shot` | `captureFrame`, `verifyFrame` |
1346
- | `Capture path must be absolute: <path>` | `readCapture` |
1347
- | `Capture frame at <path> could not be read` | `readFrame` |
1348
- | `Capture frame at <path> is not an image this browser decodes` | `readFrame` |
1349
- | `Capture frame at <path> is not an image this browser decodes: <w>x<h> device pixels` | `readFrame` |
1350
- | `Capture frame at <path> cannot be measured without a 2D canvas` | `readFrame` |
1351
- | `Shot is not an image this browser decodes` | `readShotPixel` |
1352
- | `Shot cannot be measured without a 2D canvas` | `readShotPixel` |
1353
- | `Shot pixel position must be a fraction from 0 to 1` | `readShotPixel` |
1354
- | `Capture variant "<name>" is not registered` | `createPortfolio` |
1355
- | `Capture state "<state>" is not registered` | `place` |
1356
- | `Capture state "<state>" is already placed` | `place` |
1357
- | `IndexedDB database "<name>" could not be deleted` | `removeDatabase` |
1358
- | `IndexedDB database "<name>" is blocked by an open connection` | `removeDatabase` |
1359
- | `Key sequence "<keys>" was sent with nothing focused` | `pressKeys` |
1360
- | `Focus sits in a frame from another origin, which cannot be read` | `readActiveElement` |
1361
- | `Focus traversal did not end` | `walkFocus` |
1362
- | `The start element cannot take focus` | `collectTabStops` |
1363
- | `Stability frames must be a positive integer` | `waitForStability` |
1364
- | `Condition "<description>" did not hold within <n>ms (waited <n>ms)` | `waitForStability` |
1365
- | `Condition "<subject>" did not hold within <n>ms (waited <n>ms) (last states: <states>)` | `waitForState` |
1366
- | `Animation subject is not connected` | `waitForAnimations` |
1367
- | `Animation "<subject>" did not settle within <n>ms (waited <n>ms): <animations>` | `waitForAnimations` |
1368
- | `Class census walked no element` | `readCensus` |
1369
- | `Contrast control cannot straddle the bar <bar>` | `buildContrast` |
1370
- | `Access is denied for <operation> "<key>"` | `buildDenial` |
1371
- | `No room is left for <key>` | `createStorage` |
1372
- | `Storage quota must be a non-negative integer` | `createStorage` |
1373
- | `Statechart harness mounted no transition` | `createHarness` |
1374
- | `Statechart harness carries no status` | `status` |
1409
+ | Voice | Thrown by |
1410
+ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
1411
+ | `No interactive element has the accessible name "<name>"` | `resolveRendered` |
1412
+ | `Interactive target "<name>" is not visible and focus-reachable` | `resolveRendered` |
1413
+ | `Interactive target "<name>" is ambiguous across <n> elements` | `resolveRendered` |
1414
+ | `Interactive target "<name>" could not be resolved` | `resolveRendered` |
1415
+ | `Interactive target "<name>" is unreachable after scrolling` | `resolveAccessible` |
1416
+ | `Interactive target "<name>" is not reachable inside "<region>"` | `resolveAccessibleWithin` |
1417
+ | `Interactive target "<name>" is ambiguous across <n> elements inside "<region>"` | `resolveAccessibleWithin` |
1418
+ | `Interactive target "<name>" could not be resolved inside "<region>"` | `resolveAccessibleWithin` |
1419
+ | `Native disclosure "<name>" is not visible and focus-reachable` | `clickDisclosure` |
1420
+ | `Native disclosure "<name>" is ambiguous across <n> elements` | `clickDisclosure` |
1421
+ | `Native disclosure "<name>" could not be resolved` | `clickDisclosure` |
1422
+ | `The element is not connected to a document, so it has no point to read` | `readProtocolPoint` |
1423
+ | `Interactive target "<name>" is not reachable through forward Tab traversal: <trail>` | `driveTraversal` |
1424
+ | `Named region "<name>" is not visible` | `readPerception` |
1425
+ | `Named region "<name>" is ambiguous across <n> elements` | `readPerception` |
1426
+ | `Named region "<name>" could not be resolved` | `readPerception` |
1427
+ | `Interactive target "<name>" does not carry a value` | `readControlValue` |
1428
+ | `Computed foreground color is unavailable` | `readContrast` |
1429
+ | `Computed background color is unavailable` | `readColorContrast` |
1430
+ | `Color "<value>" is unreadable` | `readColorContrast` |
1431
+ | `Contrast opacity must be between 0 and 1` | `readColorContrast` |
1432
+ | `The element is not connected to a document, so it has no clipping ancestors to read` | `collectClippingAncestors`, `readClippedBlock` |
1433
+ | `Tester pane is unavailable for a capture` | `stagePane` |
1434
+ | `Tester pane rendered <w>x<h> for a <w>x<h> viewport` | `stagePane` |
1435
+ | `Capture frame at <path> never settled after <n> restagings: <h> over a <h> pane[; scroll regions still hiding rows: <region> hides <n> px, …]` | `captureFrame` |
1436
+ | `Capture frame at <path> leaves rows hidden in scroll regions: <region> <cause> and hides <n> px, so <correction>. Shoot the frame without unrolled to keep them scrolled` | `captureFrame` |
1437
+ | `Capture frame was written to <path> where <path> was asked for` | `captureFrame`, `verifyFrame` |
1438
+ | `Capture frame at <path> is not the one this run shot` | `captureFrame`, `verifyFrame` |
1439
+ | `Capture path must be absolute: <path>` | `readCapture` |
1440
+ | `Capture frame at <path> could not be read` | `readFrame` |
1441
+ | `Capture frame at <path> is not an image this browser decodes` | `readFrame` |
1442
+ | `Capture frame at <path> is not an image this browser decodes: <w>x<h> device pixels` | `readFrame` |
1443
+ | `Capture frame at <path> cannot be measured without a 2D canvas` | `readFrame` |
1444
+ | `Shot is not an image this browser decodes` | `readShotPixel` |
1445
+ | `Shot cannot be measured without a 2D canvas` | `readShotPixel` |
1446
+ | `Shot pixel position must be a fraction from 0 to 1` | `readShotPixel` |
1447
+ | `Capture variant "<name>" is not registered` | `createPortfolio` |
1448
+ | `Capture state "<state>" is not registered` | `place` |
1449
+ | `Capture state "<state>" is already placed` | `place` |
1450
+ | `IndexedDB database "<name>" could not be deleted` | `removeDatabase` |
1451
+ | `IndexedDB database "<name>" is blocked by an open connection` | `removeDatabase` |
1452
+ | `Key sequence "<keys>" was sent with nothing focused` | `pressKeys` |
1453
+ | `Focus sits in a frame from another origin, which cannot be read` | `readActiveElement` |
1454
+ | `Focus traversal did not end` | `walkFocus` |
1455
+ | `The start element cannot take focus` | `collectTabStops` |
1456
+ | `Stability frames must be a positive integer` | `waitForStability` |
1457
+ | `Condition "<description>" did not hold within <n>ms (waited <n>ms)` | `waitForStability` |
1458
+ | `Condition "<subject>" did not hold within <n>ms (waited <n>ms) (last states: <states>)` | `waitForState` |
1459
+ | `Animation subject is not connected` | `waitForAnimations` |
1460
+ | `Animation "<subject>" did not settle within <n>ms (waited <n>ms): <animations>` | `waitForAnimations` |
1461
+ | `Class census walked no element` | `readCensus` |
1462
+ | `Contrast control cannot straddle the bar <bar>` | `buildContrast` |
1463
+ | `Access is denied for <operation> "<key>"` | `buildDenial` |
1464
+ | `No room is left for <key>` | `createStorage` |
1465
+ | `Storage quota must be a non-negative integer` | `createStorage` |
1466
+ | `Statechart harness mounted no transition` | `createHarness` |
1467
+ | `Statechart harness carries no status` | `status` |
1375
1468
 
1376
1469
  `readContrast` measures through `readColorContrast`, so its background refusal is that row's voice,
1377
1470
  and `readRing` never raises it, because it names `CANVAS_COLOR` as the floor on every reading.
@@ -1587,8 +1680,8 @@ These hold across `src/core`, `src/browser`, `src/server`, and this guide.
1587
1680
  reads the entry and then removes the path as separate steps, so an allocation swapped between
1588
1681
  them is removed anyway; whoever swaps it runs as the same uid, which is the population the threat
1589
1682
  model already declines to defend against. And birth time is the host's to supply. This host
1590
- supplies a real one — the allocation's `birthtimeMs` does not move when files are written into
1591
- it, while its `ctimeMs` does — so `destroy()` is sound here. Where a host has none, libuv reports
1683
+ supplies a real one — the allocation's `birthtimeNs` does not move when files are written into
1684
+ it, while its `ctimeNs` does — so `destroy()` is sound here. Where a host has none, libuv reports
1592
1685
  `ctime` in its place, the first seeded write moves it, and `destroy()` takes its early return. It
1593
1686
  returns `void`, so that refusal is indistinguishable from success and the allocation leaks
1594
1687
  silently.
@@ -4215,7 +4308,54 @@ Each entry names the contracts its file proves. The test names carry the cases.
4215
4308
  a fixed element beyond a padded viewport that keeps its declared viewport height;
4216
4309
  an element that outgrows every pane, refused with the
4217
4310
  pane and the scroll handed back; a second tester frame the offset leaves in place; and a frame
4218
- carrying no `style` attribute, handed back without one. After the `releasePointer` function, an
4311
+ carrying no `style` attribute, handed back without one. An unrolled frame takes a viewport-height
4312
+ shell whose frame is its 60-row header over its 2000 rows on the last row's color, beside a plain
4313
+ frame of the same shell at the declared height; a `50vh` region nested in the shell's column,
4314
+ both measured hiding rows at the declared viewport first, whose frame lands on the 2520-row fixed
4315
+ point written out, with the last row on the floor rather than an empty band; a wrapper that
4316
+ scrolls only across, collected by nothing and shot at the plain frame's size; a region and a
4317
+ window the page had scrolled, shot with the region's first row at the frame's top and both handed
4318
+ back; a region of fixed height, refused with the region and its hidden rows named and the
4319
+ pane handed back; a sidebar beside a taller main pane, whose frame is the header over the main
4320
+ pane's rows with the main pane's last row on the bottom row; a fixed navigation a transform moves
4321
+ off the page, which leaves the shell's frame at its header over its rows; a text area scrolling
4322
+ its own text, shot at the plain frame's size rather than refused; a refused region with no id,
4323
+ named by its path from the nearest ancestor carrying one; and a region the staging grew and
4324
+ clamped to its first row, handed back its scroll when a fixed region refuses the capture. The
4325
+ side-by-side panes take a fixed bottom bar, a fixed bar 16 rows above the bottom, and a fixed
4326
+ inset overlay inside the main pane, and a main pane hosted in a shadow root with its rows in that
4327
+ root and with slotted rows under a shadow scroller, each at 1660 rows with the main pane's last
4328
+ row on the bottom row. A fixed `#log` in the shell's column is refused as keeping a fixed height,
4329
+ a lone `50vh` region of 1000 rows as growing by less than the pane, a `50vh` region of 600 rows
4330
+ as hiding rows the declared viewport has room for, and six fixed regions each named. An
4331
+ unrolled frame that never settles names the fixed region still hiding rows. A plain
4332
+ element frame under root scroll padding hands back the container that native alignment scrolled.
4333
+ The `createPortfolio` function takes `unrolled` through `place`, beside a plain
4334
+ portfolio over the same shell. The `collectScrollContainers` function takes every scroll
4335
+ container on either axis in document order, an open shadow root's included and a closed one's and
4336
+ a `clip` and a `visible` overflow left out, and the body and the root element left out under a
4337
+ scrolling overflow. The `collectUnrolledRegions` function takes the `auto` and `scroll` regions
4338
+ that hide rows and the open shadow root's, and leaves out a region whose rows fit, a `hidden` and a
4339
+ `clip` overflow, a wrapper that scrolls only across, a closed shadow root's region measured
4340
+ hiding rows, a text area and a list box measured hiding rows, a `visibility: hidden` region, a
4341
+ fixed navigation moved wholly off the page, and, for an element frame, a region positioned
4342
+ outside the element's box that a page frame counts. The `measureRegion` function takes an
4343
+ overflowing padded region at its scroll height, scrolled and unscrolled, a fitting region below
4344
+ the box its scroll height reads, with a trailing margin counted, and a descendant capped at an
4345
+ inner frame's clip edge, and leaves out a fixed box and an absolute box laid out against a block
4346
+ outside the region until the region is positioned; it reads the rows a host scrolls in its own
4347
+ shadow root and the slotted rows a shadow scroller holds. The `collectRegionRows` function
4348
+ takes the flat tree through an open shadow root and its slot, an absolute box under a positioned
4349
+ ancestor and a fixed box under a transformed one, and leaves out an absolute box and a fixed box
4350
+ with their subtrees where no ancestor at or under the region contains them. The `containsFixed`
4351
+ function takes a transform, a translate, a rotate, a scale, a perspective, a filter, a backdrop
4352
+ filter, layout, paint, strict, and content containment, a `size` and an `inline-size` container
4353
+ type, `content-visibility: auto`, `transform-style: preserve-3d`, and a `will-change` naming a
4354
+ transform, a perspective, or a filter, and leaves out a positioned element, an `opacity`
4355
+ `will-change`, and an unstyled element. The `settleFrame` function, called at a 2460-row pane
4356
+ whose carried growth lands back on that pane, stages at the 2060-row extent instead. The `renderSelector` function takes a path by position from the nearest
4357
+ ancestor with an id, an escaped id, the body and the root element, and a step out of an open
4358
+ shadow tree. After the `releasePointer` function, an
4219
4359
  element frame takes no `mouseover` event for an element inside the window, which also takes no `scroll` event;
4220
4360
  for a flush-left element the scroll brings to the top, one the offset brings to the left edge, and
4221
4361
  one too large for the window; for an element past both window edges, whose frame has the
@@ -4301,11 +4441,11 @@ Each entry names the contracts its file proves. The test names carry the cases.
4301
4441
  contained relative and absolute targets and both spellings of a path outside the root, and `requireContained`
4302
4442
  takes the same contained pair and each path outside the root refused with the message naming the target it was
4303
4443
  given. `readIdentity` takes a real
4304
- allocation's three fields, that allocation matching itself across a `stat` and an `lstat`, and a
4444
+ allocation's three bigint fields, that allocation matching itself across a `stat` and an `lstat`, and a
4305
4445
  second allocation reading as a different identity. `readErrorCode` takes a real `ENOENT` off the
4306
4446
  host, a plain object, an `Error` carrying a non-string `code` and one carrying none, a
4307
4447
  null-prototype record, and the values that are not objects at all. `matchesIdentity` takes a triple
4308
- matching in every field and one differing in each. `isExcluded` takes a key, an ancestor, the root, and a sibling that only
4448
+ matching in every field, one differing in each, and two index nodes that differ only past 2^53. `isExcluded` takes a key, an ancestor, the root, and a sibling that only
4309
4449
  looks like a match. `readInventory` takes key order, extension filtering, exclusion at the named
4310
4450
  door and at the walked one with its spellings normalized to one rule, each of its link refusals
4311
4451
  with a contained intermediate link as the control on the intermediate-link one, a root-level
@@ -4345,7 +4485,7 @@ Each entry names the contracts its file proves. The test names carry the cases.
4345
4485
  `ensure` takes an empty directory, every missing parent, and a repeated call. `link` takes
4346
4486
  traversal through a planted link, the final segment `has` reports rather than follows, and the
4347
4487
  `EEXIST` an occupied final segment throws. `remove` takes a file beside a kept
4348
- sibling, an empty directory, a populated subtree, a missing target, an ancestor link back to the
4488
+ sibling, a file written immediately after allocation, an empty directory, a populated subtree, a missing target, an ancestor link back to the
4349
4489
  allocation with every seeded file read back afterwards, a final link whose destination is read back
4350
4490
  afterwards, a sibling directory reached through that same ancestor link, a target outside the root with
4351
4491
  the file outside left intact, the root refused as `''`, as `'.'`, and as its absolute path, a