@orkestrel/scaffold 0.0.131 → 0.0.133
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.
- package/dist/bin/main.js +13 -13
- package/dist/host/agents/orchestration.md +5 -3
- package/dist/host/claude/agents/orkestrel.md +54 -54
- package/dist/host/claude/rules/tests.md +5 -0
- package/dist/host/configs/helpers.ts +2 -2
- package/dist/host/guides/browser.md +1 -1
- package/dist/host/guides/contract.md +26 -5
- package/dist/host/guides/database.md +43 -37
- package/dist/host/guides/queue.md +3 -1
- package/dist/host/guides/scaffold.md +4 -4
- package/dist/host/guides/test.md +333 -195
- package/dist/host/guides/workflow.md +4 -2
- package/dist/host/manifest.json +14 -14
- package/dist/host/tests/config.test.ts +3 -3
- package/dist/host/tests/policy.test.ts +1 -1
- package/dist/src/core/index.cjs +13 -14
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.js +13 -14
- package/dist/src/core/index.js.map +1 -1
- package/package.json +13 -13
package/dist/host/guides/test.md
CHANGED
|
@@ -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? }`
|
|
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? }`
|
|
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
|
|
348
|
-
| -------------------------- | -------- |
|
|
349
|
-
| `supportsSegmentedFocus` | function | `(element: Element) => boolean`
|
|
350
|
-
| `resolveAccessible` | function | `((name: string) => HTMLElement) & ((role: string, name: string) => HTMLElement)`
|
|
351
|
-
| `resolveAccessibleWithin` | function | `(region: string, role: string, name: string) => HTMLElement`
|
|
352
|
-
| `resolveRendered` | function | `(first: string, second?: string) => HTMLElement`
|
|
353
|
-
| `computeNamePattern` | function | `(name: string) => RegExp`
|
|
354
|
-
| `isOutsideViewport` | function | `(rectangle: DOMRectReadOnly) => boolean`
|
|
355
|
-
| `isRendered` | function | `(element: Element) => boolean`
|
|
356
|
-
| `collectShadowHosts` | function | `(element: Element, root?: Node) => readonly Element[]`
|
|
357
|
-
| `isReachable` | function | `(element: Element) => boolean`
|
|
358
|
-
| `readHit` | function | `(element: Element) => Element \| undefined`
|
|
359
|
-
| `clickAccessible` | function | `((name: string) => Promise<void>) & ((role: string, name: string) => Promise<void>)`
|
|
360
|
-
| `clickAccessibleWithin` | function | `(region: string, role: string, name: string) => Promise<void>`
|
|
361
|
-
| `clickDisclosure` | function | `(name: string) => Promise<void>`
|
|
362
|
-
| `readProtocolSession` | function | `() => readonly [unknown, unknown]`
|
|
363
|
-
| `sendProtocol` | function | `(method: string, params?: Readonly<Record<string, unknown>>) => Promise<unknown>`
|
|
364
|
-
| `readProtocolPoint` | function | `(element: Element, offset?: ProtocolPoint) => ProtocolPoint`
|
|
365
|
-
| `readProtocolNode` | function | `(element: Element) => Promise<number>`
|
|
366
|
-
| `readAccessibilityNode` | function | `(element: Element) => Promise<AccessibilityNode>`
|
|
367
|
-
| `hoverAccessible` | function | `((name: string) => Promise<void>) & ((role: string, name: string) => Promise<void>)`
|
|
368
|
-
| `holdAccessible` | function | `((name: string) => Promise<void>) & ((role: string, name: string) => Promise<void>)`
|
|
369
|
-
| `holdAccessibleWithin` | function | `(region: string, role: string, name: string) => Promise<void>`
|
|
370
|
-
| `driveHold` | function | `(resolve: () => HTMLElement, name: string) => Promise<void>`
|
|
371
|
-
| `parkPointer` | function | `() => Promise<void>`
|
|
372
|
-
| `releasePointer` | function | `() => Promise<void>`
|
|
373
|
-
| `typeAccessible` | function | `(name: string, text: string) => Promise<void>`
|
|
374
|
-
| `fillAccessible` | function | `(name: string, text: string) => Promise<void>`
|
|
375
|
-
| `traverseAccessible` | function | `(name: string) => Promise<HTMLElement>`
|
|
376
|
-
| `traverseAccessibleWithin` | function | `(region: string, role: string, name: string) => Promise<HTMLElement>`
|
|
377
|
-
| `readActiveElement` | function | `(root?: Document \| ShadowRoot) => HTMLElement \| undefined`
|
|
378
|
-
| `countElements` | function | `(root?: Document \| ShadowRoot) => number`
|
|
379
|
-
| `containsNode` | function | `(root: Node, node: Node) => boolean`
|
|
380
|
-
| `stepFocus` | function | `(limit: number) => AsyncGenerator<HTMLElement \| undefined, void, undefined>`
|
|
381
|
-
| `matchesTraversalName` | function | `(element: HTMLElement, name: string, exact?: boolean) => boolean`
|
|
382
|
-
| `driveTraversal` | function | `(resolve: () => HTMLElement, name: string, candidate?: (element: HTMLElement) => boolean) => Promise<HTMLElement>`
|
|
383
|
-
| `walkFocus` | function | `(stop?: (element: HTMLElement) => boolean) => Promise<readonly HTMLElement[]>`
|
|
384
|
-
| `collectTabStops` | function | `(root: Element, start: HTMLElement) => Promise<readonly HTMLElement[]>`
|
|
385
|
-
| `pressKeys` | function | `(keys: string) => Promise<void>`
|
|
386
|
-
| `readPerception` | function | `(name: string) => string`
|
|
387
|
-
| `readPage` | function | `() => string`
|
|
388
|
-
| `readFocus` | function | `() => string \| undefined`
|
|
389
|
-
| `readControlValue` | function | `(role: string, name: string) => string`
|
|
390
|
-
| `readRefusal` | function | `((name: string) => string \| undefined) & ((role: string, name: string) => string \| undefined)`
|
|
391
|
-
| `readText` | function | `(element: Element) => string`
|
|
392
|
-
| `readRole` | function | `(element: Element) => string \| undefined`
|
|
393
|
-
| `readName` | function | `(element: Element) => string`
|
|
394
|
-
| `readStates` | function | `(element: Element) => readonly string[]`
|
|
395
|
-
| `describeTree` | function | `(element: Element) => string`
|
|
396
|
-
| `describeFocus` | function | `(element: Element) => string`
|
|
397
|
-
| `waitForFrame` | function | `() => Promise<void>`
|
|
398
|
-
| `waitForState` | function | `((name: string, state: string, options?: StateOptions) => Promise<readonly string[]>) & ((role: string, name: string, state: string, options?: StateOptions) => Promise<readonly string[]>)`
|
|
399
|
-
| `waitForAnimations` | function | `(element: Element, options?: WaitOptions) => Promise<void>`
|
|
400
|
-
| `readAnimations` | function | `(element: Element) => AnimationResult`
|
|
401
|
-
| `settleCapture` | function | `(options?: SettleOptions) => Promise<() => void>`
|
|
402
|
-
| `collectScrollRegions` | function | `(root: Element, axis?: 'inline' \| 'block') => readonly HTMLElement[]`
|
|
403
|
-
| `describeScrollRegions` | function | `(regions: readonly HTMLElement[]) => string`
|
|
404
|
-
| `build` | function | `<K extends keyof HTMLElementTagNameMap>(tag: K, options?: ElementOptions) => HTMLElementTagNameMap[K]`
|
|
405
|
-
| `mount` | function | `<T extends Element>(element: T) => T`
|
|
406
|
-
| `typeInput` | function | `(element: HTMLInputElement \| HTMLTextAreaElement, text: string) => void`
|
|
407
|
-
| `commitInput` | function | `(element: HTMLInputElement \| HTMLTextAreaElement, text: string) => void`
|
|
408
|
-
| `render` | function | `((markup: string) => HTMLDivElement) & (<K extends keyof HTMLElementTagNameMap>(tag: K, classes: string) => HTMLElementTagNameMap[K])`
|
|
409
|
-
| `clearStorage` | function | `() => void`
|
|
410
|
-
| `removeDatabase` | function | `(name: string) => Promise<void>`
|
|
411
|
-
| `convertSRGB` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA`
|
|
412
|
-
| `convertLinearSRGB` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA`
|
|
413
|
-
| `convertXYZD65` | function | `(x: number, y: number, z: number, alpha?: number) => RGBA`
|
|
414
|
-
| `convertXYZD50` | function | `(x: number, y: number, z: number, alpha?: number) => RGBA`
|
|
415
|
-
| `convertOKLab` | function | `(lightness: number, a: number, b: number, alpha?: number) => RGBA`
|
|
416
|
-
| `convertLab` | function | `(lightness: number, a: number, b: number, alpha?: number) => RGBA`
|
|
417
|
-
| `convertDisplayP3` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA`
|
|
418
|
-
| `convertA98RGB` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA`
|
|
419
|
-
| `convertProPhotoRGB` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA`
|
|
420
|
-
| `convertRec2020` | function | `(red: number, green: number, blue: number, alpha?: number) => RGBA`
|
|
421
|
-
| `parseColor` | function | `(value: string) => RGBA \| undefined`
|
|
422
|
-
| `parseCSSColor` | function | `(value: string, scope?: Element) => RGBA \| undefined`
|
|
423
|
-
| `matchesColor` | function | `(first: string \| RGBA, second: string \| RGBA) => boolean`
|
|
424
|
-
| `blendColor` | function | `(front: RGBA, back: RGBA) => RGBA`
|
|
425
|
-
| `measureLuminance` | function | `(color: RGBA) => number`
|
|
426
|
-
| `measureContrast` | function | `(front: RGBA, back: RGBA) => number`
|
|
427
|
-
| `readLayers` | function | `(element: Element) => readonly RGBA[]`
|
|
428
|
-
| `readBackdrop` | function | `(element: Element, floor: RGBA) => RGBA`
|
|
429
|
-
| `readColorContrast` | function | `(element: Element, color: string, options?: ContrastOptions) => number`
|
|
430
|
-
| `readContrast` | function | `(element: Element, floor?: RGBA) => number`
|
|
431
|
-
| `readRing` | function | `(control: Element, worn?: Element) => number \| undefined`
|
|
432
|
-
| `readClipEdge` | function | `(element: Element) => number \| undefined`
|
|
433
|
-
| `readClipMargin` | function | `(element: Element) => number`
|
|
434
|
-
| `readClippedBlock` | function | `(element: Element) => number`
|
|
435
|
-
| `collectClippingAncestors` | function | `(element: Element) => readonly Element[]`
|
|
436
|
-
| `
|
|
437
|
-
| `
|
|
438
|
-
| `
|
|
439
|
-
| `
|
|
440
|
-
| `
|
|
441
|
-
| `
|
|
442
|
-
| `
|
|
443
|
-
| `
|
|
444
|
-
| `
|
|
445
|
-
| `
|
|
446
|
-
| `
|
|
447
|
-
| `
|
|
448
|
-
| `
|
|
449
|
-
| `
|
|
450
|
-
| `
|
|
451
|
-
| `
|
|
452
|
-
| `
|
|
453
|
-
| `
|
|
454
|
-
| `
|
|
455
|
-
| `
|
|
456
|
-
| `
|
|
457
|
-
| `
|
|
458
|
-
| `
|
|
459
|
-
| `
|
|
460
|
-
| `
|
|
461
|
-
| `
|
|
462
|
-
| `
|
|
463
|
-
| `
|
|
464
|
-
| `
|
|
465
|
-
| `
|
|
466
|
-
| `
|
|
467
|
-
| `
|
|
468
|
-
| `
|
|
469
|
-
| `
|
|
470
|
-
| `
|
|
471
|
-
| `
|
|
472
|
-
| `
|
|
473
|
-
| `
|
|
474
|
-
| `
|
|
475
|
-
| `
|
|
476
|
-
| `
|
|
477
|
-
| `
|
|
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
|
-
|
|
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.
|
|
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.
|
|
@@ -1314,64 +1404,65 @@ what the link reaches, not on what it stores.
|
|
|
1314
1404
|
Every message `src/browser` throws. Keep them distinct: a journey asserts the one it means, and
|
|
1315
1405
|
absent, present-but-gated, and ambiguous are different findings about an interface.
|
|
1316
1406
|
|
|
1317
|
-
| Voice
|
|
1318
|
-
|
|
|
1319
|
-
| `No interactive element has the accessible name "<name>"`
|
|
1320
|
-
| `Interactive target "<name>" is not visible and focus-reachable`
|
|
1321
|
-
| `Interactive target "<name>" is ambiguous across <n> elements`
|
|
1322
|
-
| `Interactive target "<name>" could not be resolved`
|
|
1323
|
-
| `Interactive target "<name>" is unreachable after scrolling`
|
|
1324
|
-
| `Interactive target "<name>" is not reachable inside "<region>"`
|
|
1325
|
-
| `Interactive target "<name>" is ambiguous across <n> elements inside "<region>"`
|
|
1326
|
-
| `Interactive target "<name>" could not be resolved inside "<region>"`
|
|
1327
|
-
| `Native disclosure "<name>" is not visible and focus-reachable`
|
|
1328
|
-
| `Native disclosure "<name>" is ambiguous across <n> elements`
|
|
1329
|
-
| `Native disclosure "<name>" could not be resolved`
|
|
1330
|
-
| `The element is not connected to a document, so it has no point to read`
|
|
1331
|
-
| `Interactive target "<name>" is not reachable through forward Tab traversal: <trail>`
|
|
1332
|
-
| `Named region "<name>" is not visible`
|
|
1333
|
-
| `Named region "<name>" is ambiguous across <n> elements`
|
|
1334
|
-
| `Named region "<name>" could not be resolved`
|
|
1335
|
-
| `Interactive target "<name>" does not carry a value`
|
|
1336
|
-
| `Computed foreground color is unavailable`
|
|
1337
|
-
| `Computed background color is unavailable`
|
|
1338
|
-
| `Color "<value>" is unreadable`
|
|
1339
|
-
| `Contrast opacity must be between 0 and 1`
|
|
1340
|
-
| `The element is not connected to a document, so it has no clipping ancestors to read`
|
|
1341
|
-
| `Tester pane is unavailable for a capture`
|
|
1342
|
-
| `Tester pane rendered <w>x<h> for a <w>x<h> viewport`
|
|
1343
|
-
| `Capture frame at <path> never settled after <n> restagings: <h> over a <h> pane`
|
|
1344
|
-
| `Capture frame
|
|
1345
|
-
| `Capture frame
|
|
1346
|
-
| `Capture path
|
|
1347
|
-
| `Capture
|
|
1348
|
-
| `Capture frame at <path>
|
|
1349
|
-
| `Capture frame at <path> is not an image this browser decodes
|
|
1350
|
-
| `Capture frame at <path>
|
|
1351
|
-
| `
|
|
1352
|
-
| `Shot
|
|
1353
|
-
| `Shot
|
|
1354
|
-
| `
|
|
1355
|
-
| `Capture
|
|
1356
|
-
| `Capture state "<state>" is
|
|
1357
|
-
| `
|
|
1358
|
-
| `IndexedDB database "<name>"
|
|
1359
|
-
| `
|
|
1360
|
-
| `
|
|
1361
|
-
| `Focus
|
|
1362
|
-
| `
|
|
1363
|
-
| `
|
|
1364
|
-
| `
|
|
1365
|
-
| `Condition "<
|
|
1366
|
-
| `
|
|
1367
|
-
| `Animation
|
|
1368
|
-
| `
|
|
1369
|
-
| `
|
|
1370
|
-
| `
|
|
1371
|
-
| `
|
|
1372
|
-
| `
|
|
1373
|
-
| `
|
|
1374
|
-
| `Statechart harness
|
|
1407
|
+
| Voice | Thrown by |
|
|
1408
|
+
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
|
|
1409
|
+
| `No interactive element has the accessible name "<name>"` | `resolveRendered` |
|
|
1410
|
+
| `Interactive target "<name>" is not visible and focus-reachable` | `resolveRendered` |
|
|
1411
|
+
| `Interactive target "<name>" is ambiguous across <n> elements` | `resolveRendered` |
|
|
1412
|
+
| `Interactive target "<name>" could not be resolved` | `resolveRendered` |
|
|
1413
|
+
| `Interactive target "<name>" is unreachable after scrolling` | `resolveAccessible` |
|
|
1414
|
+
| `Interactive target "<name>" is not reachable inside "<region>"` | `resolveAccessibleWithin` |
|
|
1415
|
+
| `Interactive target "<name>" is ambiguous across <n> elements inside "<region>"` | `resolveAccessibleWithin` |
|
|
1416
|
+
| `Interactive target "<name>" could not be resolved inside "<region>"` | `resolveAccessibleWithin` |
|
|
1417
|
+
| `Native disclosure "<name>" is not visible and focus-reachable` | `clickDisclosure` |
|
|
1418
|
+
| `Native disclosure "<name>" is ambiguous across <n> elements` | `clickDisclosure` |
|
|
1419
|
+
| `Native disclosure "<name>" could not be resolved` | `clickDisclosure` |
|
|
1420
|
+
| `The element is not connected to a document, so it has no point to read` | `readProtocolPoint` |
|
|
1421
|
+
| `Interactive target "<name>" is not reachable through forward Tab traversal: <trail>` | `driveTraversal` |
|
|
1422
|
+
| `Named region "<name>" is not visible` | `readPerception` |
|
|
1423
|
+
| `Named region "<name>" is ambiguous across <n> elements` | `readPerception` |
|
|
1424
|
+
| `Named region "<name>" could not be resolved` | `readPerception` |
|
|
1425
|
+
| `Interactive target "<name>" does not carry a value` | `readControlValue` |
|
|
1426
|
+
| `Computed foreground color is unavailable` | `readContrast` |
|
|
1427
|
+
| `Computed background color is unavailable` | `readColorContrast` |
|
|
1428
|
+
| `Color "<value>" is unreadable` | `readColorContrast` |
|
|
1429
|
+
| `Contrast opacity must be between 0 and 1` | `readColorContrast` |
|
|
1430
|
+
| `The element is not connected to a document, so it has no clipping ancestors to read` | `collectClippingAncestors`, `readClippedBlock` |
|
|
1431
|
+
| `Tester pane is unavailable for a capture` | `stagePane` |
|
|
1432
|
+
| `Tester pane rendered <w>x<h> for a <w>x<h> viewport` | `stagePane` |
|
|
1433
|
+
| `Capture frame at <path> never settled after <n> restagings: <h> over a <h> pane[; scroll regions still hiding rows: <region> hides <n> px, …]` | `captureFrame` |
|
|
1434
|
+
| `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` |
|
|
1435
|
+
| `Capture frame was written to <path> where <path> was asked for` | `captureFrame`, `verifyFrame` |
|
|
1436
|
+
| `Capture frame at <path> is not the one this run shot` | `captureFrame`, `verifyFrame` |
|
|
1437
|
+
| `Capture path must be absolute: <path>` | `readCapture` |
|
|
1438
|
+
| `Capture frame at <path> could not be read` | `readFrame` |
|
|
1439
|
+
| `Capture frame at <path> is not an image this browser decodes` | `readFrame` |
|
|
1440
|
+
| `Capture frame at <path> is not an image this browser decodes: <w>x<h> device pixels` | `readFrame` |
|
|
1441
|
+
| `Capture frame at <path> cannot be measured without a 2D canvas` | `readFrame` |
|
|
1442
|
+
| `Shot is not an image this browser decodes` | `readShotPixel` |
|
|
1443
|
+
| `Shot cannot be measured without a 2D canvas` | `readShotPixel` |
|
|
1444
|
+
| `Shot pixel position must be a fraction from 0 to 1` | `readShotPixel` |
|
|
1445
|
+
| `Capture variant "<name>" is not registered` | `createPortfolio` |
|
|
1446
|
+
| `Capture state "<state>" is not registered` | `place` |
|
|
1447
|
+
| `Capture state "<state>" is already placed` | `place` |
|
|
1448
|
+
| `IndexedDB database "<name>" could not be deleted` | `removeDatabase` |
|
|
1449
|
+
| `IndexedDB database "<name>" is blocked by an open connection` | `removeDatabase` |
|
|
1450
|
+
| `Key sequence "<keys>" was sent with nothing focused` | `pressKeys` |
|
|
1451
|
+
| `Focus sits in a frame from another origin, which cannot be read` | `readActiveElement` |
|
|
1452
|
+
| `Focus traversal did not end` | `walkFocus` |
|
|
1453
|
+
| `The start element cannot take focus` | `collectTabStops` |
|
|
1454
|
+
| `Stability frames must be a positive integer` | `waitForStability` |
|
|
1455
|
+
| `Condition "<description>" did not hold within <n>ms (waited <n>ms)` | `waitForStability` |
|
|
1456
|
+
| `Condition "<subject>" did not hold within <n>ms (waited <n>ms) (last states: <states>)` | `waitForState` |
|
|
1457
|
+
| `Animation subject is not connected` | `waitForAnimations` |
|
|
1458
|
+
| `Animation "<subject>" did not settle within <n>ms (waited <n>ms): <animations>` | `waitForAnimations` |
|
|
1459
|
+
| `Class census walked no element` | `readCensus` |
|
|
1460
|
+
| `Contrast control cannot straddle the bar <bar>` | `buildContrast` |
|
|
1461
|
+
| `Access is denied for <operation> "<key>"` | `buildDenial` |
|
|
1462
|
+
| `No room is left for <key>` | `createStorage` |
|
|
1463
|
+
| `Storage quota must be a non-negative integer` | `createStorage` |
|
|
1464
|
+
| `Statechart harness mounted no transition` | `createHarness` |
|
|
1465
|
+
| `Statechart harness carries no status` | `status` |
|
|
1375
1466
|
|
|
1376
1467
|
`readContrast` measures through `readColorContrast`, so its background refusal is that row's voice,
|
|
1377
1468
|
and `readRing` never raises it, because it names `CANVAS_COLOR` as the floor on every reading.
|
|
@@ -4215,7 +4306,54 @@ Each entry names the contracts its file proves. The test names carry the cases.
|
|
|
4215
4306
|
a fixed element beyond a padded viewport that keeps its declared viewport height;
|
|
4216
4307
|
an element that outgrows every pane, refused with the
|
|
4217
4308
|
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.
|
|
4309
|
+
carrying no `style` attribute, handed back without one. An unrolled frame takes a viewport-height
|
|
4310
|
+
shell whose frame is its 60-row header over its 2000 rows on the last row's color, beside a plain
|
|
4311
|
+
frame of the same shell at the declared height; a `50vh` region nested in the shell's column,
|
|
4312
|
+
both measured hiding rows at the declared viewport first, whose frame lands on the 2520-row fixed
|
|
4313
|
+
point written out, with the last row on the floor rather than an empty band; a wrapper that
|
|
4314
|
+
scrolls only across, collected by nothing and shot at the plain frame's size; a region and a
|
|
4315
|
+
window the page had scrolled, shot with the region's first row at the frame's top and both handed
|
|
4316
|
+
back; a region of fixed height, refused with the region and its hidden rows named and the
|
|
4317
|
+
pane handed back; a sidebar beside a taller main pane, whose frame is the header over the main
|
|
4318
|
+
pane's rows with the main pane's last row on the bottom row; a fixed navigation a transform moves
|
|
4319
|
+
off the page, which leaves the shell's frame at its header over its rows; a text area scrolling
|
|
4320
|
+
its own text, shot at the plain frame's size rather than refused; a refused region with no id,
|
|
4321
|
+
named by its path from the nearest ancestor carrying one; and a region the staging grew and
|
|
4322
|
+
clamped to its first row, handed back its scroll when a fixed region refuses the capture. The
|
|
4323
|
+
side-by-side panes take a fixed bottom bar, a fixed bar 16 rows above the bottom, and a fixed
|
|
4324
|
+
inset overlay inside the main pane, and a main pane hosted in a shadow root with its rows in that
|
|
4325
|
+
root and with slotted rows under a shadow scroller, each at 1660 rows with the main pane's last
|
|
4326
|
+
row on the bottom row. A fixed `#log` in the shell's column is refused as keeping a fixed height,
|
|
4327
|
+
a lone `50vh` region of 1000 rows as growing by less than the pane, a `50vh` region of 600 rows
|
|
4328
|
+
as hiding rows the declared viewport has room for, and six fixed regions each named. An
|
|
4329
|
+
unrolled frame that never settles names the fixed region still hiding rows. A plain
|
|
4330
|
+
element frame under root scroll padding hands back the container that native alignment scrolled.
|
|
4331
|
+
The `createPortfolio` function takes `unrolled` through `place`, beside a plain
|
|
4332
|
+
portfolio over the same shell. The `collectScrollContainers` function takes every scroll
|
|
4333
|
+
container on either axis in document order, an open shadow root's included and a closed one's and
|
|
4334
|
+
a `clip` and a `visible` overflow left out, and the body and the root element left out under a
|
|
4335
|
+
scrolling overflow. The `collectUnrolledRegions` function takes the `auto` and `scroll` regions
|
|
4336
|
+
that hide rows and the open shadow root's, and leaves out a region whose rows fit, a `hidden` and a
|
|
4337
|
+
`clip` overflow, a wrapper that scrolls only across, a closed shadow root's region measured
|
|
4338
|
+
hiding rows, a text area and a list box measured hiding rows, a `visibility: hidden` region, a
|
|
4339
|
+
fixed navigation moved wholly off the page, and, for an element frame, a region positioned
|
|
4340
|
+
outside the element's box that a page frame counts. The `measureRegion` function takes an
|
|
4341
|
+
overflowing padded region at its scroll height, scrolled and unscrolled, a fitting region below
|
|
4342
|
+
the box its scroll height reads, with a trailing margin counted, and a descendant capped at an
|
|
4343
|
+
inner frame's clip edge, and leaves out a fixed box and an absolute box laid out against a block
|
|
4344
|
+
outside the region until the region is positioned; it reads the rows a host scrolls in its own
|
|
4345
|
+
shadow root and the slotted rows a shadow scroller holds. The `collectRegionRows` function
|
|
4346
|
+
takes the flat tree through an open shadow root and its slot, an absolute box under a positioned
|
|
4347
|
+
ancestor and a fixed box under a transformed one, and leaves out an absolute box and a fixed box
|
|
4348
|
+
with their subtrees where no ancestor at or under the region contains them. The `containsFixed`
|
|
4349
|
+
function takes a transform, a translate, a rotate, a scale, a perspective, a filter, a backdrop
|
|
4350
|
+
filter, layout, paint, strict, and content containment, a `size` and an `inline-size` container
|
|
4351
|
+
type, `content-visibility: auto`, `transform-style: preserve-3d`, and a `will-change` naming a
|
|
4352
|
+
transform, a perspective, or a filter, and leaves out a positioned element, an `opacity`
|
|
4353
|
+
`will-change`, and an unstyled element. The `settleFrame` function, called at a 2460-row pane
|
|
4354
|
+
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
|
|
4355
|
+
ancestor with an id, an escaped id, the body and the root element, and a step out of an open
|
|
4356
|
+
shadow tree. After the `releasePointer` function, an
|
|
4219
4357
|
element frame takes no `mouseover` event for an element inside the window, which also takes no `scroll` event;
|
|
4220
4358
|
for a flush-left element the scroll brings to the top, one the offset brings to the left edge, and
|
|
4221
4359
|
one too large for the window; for an element past both window edges, whose frame has the
|