@orkestrel/test 0.0.30 → 0.0.31

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/README.md CHANGED
@@ -109,8 +109,8 @@ const root = resolveRoot(import.meta)
109
109
  const sources = readInventory(root, ['src/core', 'src/server'], { extensions: ['.ts'] })
110
110
 
111
111
  Object.keys(sources)
112
- // ['src/core/constants.ts', 'src/core/factories.ts', 'src/core/helpers.ts', 'src/core/index.ts',
113
- // 'src/core/types.ts', 'src/core/validators.ts', 'src/server/constants.ts',
112
+ // ['src/core/Production.ts', 'src/core/Teardown.ts', 'src/core/constants.ts', 'src/core/factories.ts', 'src/core/helpers.ts', 'src/core/index.ts',
113
+ // 'src/core/types.ts', 'src/core/validators.ts', 'src/server/Loopback.ts', 'src/server/constants.ts',
114
114
  // 'src/server/factories.ts', 'src/server/helpers.ts', 'src/server/index.ts',
115
115
  // 'src/server/types.ts']
116
116
 
@@ -121,21 +121,21 @@ sources['src/core/index.ts']
121
121
 
122
122
  // A target is a file or a directory. A named file is read whatever the extension filter says.
123
123
  Object.keys(readInventory(root, ['package.json', 'src/core'], { extensions: ['.ts'] }))
124
- // ['package.json', 'src/core/constants.ts', 'src/core/factories.ts', 'src/core/helpers.ts',
124
+ // ['package.json', 'src/core/Production.ts', 'src/core/Teardown.ts', 'src/core/constants.ts', 'src/core/factories.ts', 'src/core/helpers.ts',
125
125
  // 'src/core/index.ts', 'src/core/types.ts', 'src/core/validators.ts']
126
126
 
127
127
  // An `exclude` entry matches whole key segments. A file key drops that file.
128
128
  Object.keys(
129
129
  readInventory(root, ['src/core'], { extensions: ['.ts'], exclude: ['src/core/index.ts'] }),
130
130
  )
131
- // ['src/core/constants.ts', 'src/core/factories.ts', 'src/core/helpers.ts', 'src/core/types.ts',
131
+ // ['src/core/Production.ts', 'src/core/Teardown.ts', 'src/core/constants.ts', 'src/core/factories.ts', 'src/core/helpers.ts', 'src/core/types.ts',
132
132
  // 'src/core/validators.ts']
133
133
 
134
134
  // A directory key prunes its whole subtree.
135
135
  Object.keys(
136
136
  readInventory(root, ['src'], { extensions: ['.ts'], exclude: ['src/server', 'src/browser'] }),
137
137
  )
138
- // ['src/core/constants.ts', 'src/core/factories.ts', 'src/core/helpers.ts', 'src/core/index.ts',
138
+ // ['src/core/Production.ts', 'src/core/Teardown.ts', 'src/core/constants.ts', 'src/core/factories.ts', 'src/core/helpers.ts', 'src/core/index.ts',
139
139
  // 'src/core/types.ts', 'src/core/validators.ts']
140
140
  ```
141
141
 
@@ -603,6 +603,18 @@ export declare function collectClippingAncestors(element: Element): readonly Ele
603
603
  */
604
604
  export declare function collectScrollRegions(root: Element, axis?: 'inline' | 'block'): readonly HTMLElement[];
605
605
 
606
+ /**
607
+ * Collects an element and the successive hosts of its containing shadow roots.
608
+ *
609
+ * @param element - The element that opens the collected chain.
610
+ * @param root - The root already read by an outer traversal step, or the element's current root.
611
+ * @example
612
+ * ```ts
613
+ * collectShadowHosts(document.body) // [document.body]
614
+ * ```
615
+ */
616
+ export declare function collectShadowHosts(element: Element, root?: Node): readonly Element[];
617
+
606
618
  /**
607
619
  * Collects the elements of a region that a forward Tab walk reaches from a starting element.
608
620
  *
@@ -2796,6 +2808,16 @@ export declare function readFocus(): string | undefined;
2796
2808
  */
2797
2809
  export declare function readFrame(path: string): Promise<FrameResult>;
2798
2810
 
2811
+ /**
2812
+ * Reads a capture subject's height after applying its native scroll clearance.
2813
+ *
2814
+ * @example
2815
+ * ```ts
2816
+ * readFrameHeight({ path: 'frame.png', width: 390, height: 844 }, undefined, 844)
2817
+ * ```
2818
+ */
2819
+ export declare function readFrameHeight(options: FrameOptions, element: Element | undefined, pane: number): number | undefined;
2820
+
2799
2821
  /**
2800
2822
  * Reads the topmost element at one element's bounding-box centre.
2801
2823
  *
@@ -3055,6 +3077,17 @@ export declare function readProtocolNode(element: Element): Promise<number>;
3055
3077
  */
3056
3078
  export declare function readProtocolPoint(element: Element, offset?: ProtocolPoint): ProtocolPoint;
3057
3079
 
3080
+ /**
3081
+ * Reads the browser provider's DevTools session and its send member.
3082
+ *
3083
+ * @throws Thrown when the provider or member read fails.
3084
+ * @example
3085
+ * ```ts
3086
+ * const [session, send] = readProtocolSession()
3087
+ * ```
3088
+ */
3089
+ export declare function readProtocolSession(): readonly [unknown, unknown];
3090
+
3058
3091
  /**
3059
3092
  * Reads the refusal one named target answers with, or nothing when it resolves.
3060
3093
  *
@@ -3591,10 +3624,10 @@ export declare function resolveAccessible(role: string, name: string): HTMLEleme
3591
3624
  * @throws When the named control is absent, unreachable, or ambiguous inside the region.
3592
3625
  *
3593
3626
  * @remarks
3594
- * The region's name is matched exactly and the control's name loosely, over a computed name that
3595
- * includes hidden subtrees, so a glyph joins the text rather than displacing it. One pass answers
3596
- * this: a control the region cannot reach is refused whether it is absent or hidden. This is the
3597
- * resolver the region-scoped verbs share.
3627
+ * The region's name is matched exactly. The control first matches the case-sensitive pattern
3628
+ * from `computeNamePattern`, with hidden subtrees included. Any exact candidates own the result,
3629
+ * including unreachable or ambiguous candidates. Only an empty exact tier selects the loose query.
3630
+ * Both tiers refuse zero reachable candidates and several reachable candidates.
3598
3631
  *
3599
3632
  * @example
3600
3633
  * ```ts
@@ -3745,6 +3778,17 @@ export declare function sendTouch(type: 'touchStart' | 'touchMove' | 'touchEnd'
3745
3778
  */
3746
3779
  export declare function settleCapture(options?: SettleOptions): Promise<() => void>;
3747
3780
 
3781
+ /**
3782
+ * Restages a capture until its content extent equals the pane height.
3783
+ *
3784
+ * @remarks The stage limit bounds the recursion; a prepared pane is staged before accepting it.
3785
+ * @example
3786
+ * ```ts
3787
+ * await settleFrame({ path: 'frame.png', width: 390, height: 844 }, undefined, false)
3788
+ * ```
3789
+ */
3790
+ export declare function settleFrame(options: FrameOptions, element: Element | undefined, prepared: boolean, pane?: number, covered?: number, stage?: number): Promise<void>;
3791
+
3748
3792
  /**
3749
3793
  * Configures one capture settle: the time bounds of {@link WaitOptions} and whether the pointer
3750
3794
  * parks first.
@@ -3951,6 +3995,16 @@ export declare interface StorageOptions {
3951
3995
  */
3952
3996
  export declare function supportsSegmentedFocus(element: Element): boolean;
3953
3997
 
3998
+ /**
3999
+ * Takes a screenshot while temporarily positioning the runner frame around its subject.
4000
+ *
4001
+ * @example
4002
+ * ```ts
4003
+ * const shot = await takeFrameShot({ path: 'frame.png', width: 390, height: 844 }, undefined)
4004
+ * ```
4005
+ */
4006
+ export declare function takeFrameShot(options: FrameOptions, element: Element | undefined): Promise<FrameShot>;
4007
+
3954
4008
  /**
3955
4009
  * Taps an element's centre with emulated touch after its box settles.
3956
4010
  *
@@ -4263,6 +4317,16 @@ export declare function walkFocus(stop?: (element: HTMLElement) => boolean): Pro
4263
4317
  export declare interface WebStorageInterface extends Storage {
4264
4318
  /** Grants the reads and the writes the host withheld, and replenishes no quota. */
4265
4319
  permit(): void;
4320
+ /** Removes every stored entry when the host permits writes. */
4321
+ clear(): void;
4322
+ /** Reads a stored value when the host permits reads, or returns `null` for an absent key. */
4323
+ getItem(key: string): string | null;
4324
+ /** Reads the key at an insertion-order index when permitted, or returns `null` beyond the store. */
4325
+ key(index: number): string | null;
4326
+ /** Removes a stored entry when the host permits writes, consuming no quota. */
4327
+ removeItem(key: string): void;
4328
+ /** Stores a value when writes are permitted and consumes an accepted write from the quota. */
4329
+ setItem(key: string, value: string): void;
4266
4330
  }
4267
4331
 
4268
4332
  export { }