@shivaedev/test-story 0.19.0 → 0.20.0
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/CHANGELOG.md +12 -0
- package/README.md +4 -2
- package/dist/server/screenDriver.d.ts +19 -4
- package/dist/server/screenDriver.d.ts.map +1 -1
- package/dist/server/screenDriver.js +11 -2
- package/dist/server/screenDriver.js.map +1 -1
- package/package.json +3 -3
- package/src/server/screenDriver.ts +20 -4
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.20.0 - 2026-10-25
|
|
4
|
+
|
|
5
|
+
### Added
|
|
6
|
+
|
|
7
|
+
- Screen drivers can act on and read screens without a `pending` option. Only `settle()` requires the signal; without it, settlement fails immediately with the typed `MissingScreenPending` error. Drivers that supply `pending` keep `settle()` typed as `Effect<void>`.
|
|
8
|
+
|
|
9
|
+
## 0.19.1 - 2026-10-25
|
|
10
|
+
|
|
11
|
+
### Changed
|
|
12
|
+
|
|
13
|
+
- Release with updated workspace dependencies.
|
|
14
|
+
|
|
3
15
|
## 0.19.0 - 2026-10-25
|
|
4
16
|
|
|
5
17
|
### Added
|
package/README.md
CHANGED
|
@@ -599,7 +599,9 @@ socialApp.it("a social sign-in returns with a cookie session", [], function* ({
|
|
|
599
599
|
|
|
600
600
|
### Driving a screen
|
|
601
601
|
|
|
602
|
-
`screenDriver(options)` supplies DOM verbs and readouts for a kit's `verbs` hook. Give it the mounted `root` (or a getter for a root that navigation replaces)
|
|
602
|
+
`screenDriver(options)` supplies DOM verbs and readouts for a kit's `verbs` hook. Give it the mounted `root` (or a getter for a root that navigation replaces) and the story's `tell`. The `pending` option is needed only for `settle()`; actions, lookups and readouts work without it. Without `pending`, `settle()` fails immediately in its error channel with `MissingScreenPending`, exported from `server/screenDriver.ts`, even when the screen is idle.
|
|
603
|
+
|
|
604
|
+
To use `settle()`, supply a `pending()` function that reads the application's own request or atom state. Settlement then keeps its `Effect<void>` type with no typed errors and waits until that signal is false; repeated identical renders never count as completion. The application must keep the signal true until its resulting screen work is ready to render.
|
|
603
605
|
|
|
604
606
|
```ts
|
|
605
607
|
import { screenDriver } from "@shivaedev/test-story/server/screenDriver.ts";
|
|
@@ -637,7 +639,7 @@ Import each module with the prefix `@shivaedev/test-story/`; there is no root en
|
|
|
637
639
|
| `server/domFetch.ts` | `domFetch(baseUrl)` |
|
|
638
640
|
| `server/seedCookies.ts` | `seedCookies(cookies)`, `DomCookie` |
|
|
639
641
|
| `server/routeOutbound.ts` | `routeOutbound(routes)` |
|
|
640
|
-
| `server/screenDriver.ts` | `screenDriver(options)`, `ScreenDriverOptions`, `ScreenDriver`, `ScreenTarget` |
|
|
642
|
+
| `server/screenDriver.ts` | `screenDriver(options)`, `ScreenDriverOptions`, `ScreenDriver`, `ScreenTarget`, `MissingScreenPending` |
|
|
641
643
|
| `server/domNavigate.ts` | `domNavigate(url?)` |
|
|
642
644
|
| `server/genreTags.ts` | `genreTags(...kitNames)`, `GenreTag` |
|
|
643
645
|
| `server/domEnvironment.config.ts` | Default Vitest environment preserving Node host globals and happy-dom document transport |
|
|
@@ -5,13 +5,27 @@ export type ScreenTarget = string | {
|
|
|
5
5
|
};
|
|
6
6
|
export interface ScreenDriverOptions {
|
|
7
7
|
readonly act?: (action: () => Promise<void>) => PromiseLike<void>;
|
|
8
|
-
readonly pending
|
|
8
|
+
readonly pending?: () => boolean;
|
|
9
9
|
readonly root: HTMLElement | (() => HTMLElement);
|
|
10
10
|
readonly tell: (line: string) => void;
|
|
11
11
|
readonly timeoutMs?: number;
|
|
12
12
|
}
|
|
13
|
-
|
|
14
|
-
|
|
13
|
+
declare const MissingScreenPending_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
|
|
14
|
+
readonly _tag: "MissingScreenPending";
|
|
15
|
+
} & Readonly<A>;
|
|
16
|
+
export declare class MissingScreenPending extends MissingScreenPending_base {
|
|
17
|
+
readonly message = "Cannot settle the screen without the pending option.\nhelp: Supply pending: () => boolean that reads the application's pending work and stays true until its resulting screen work is ready to render.";
|
|
18
|
+
}
|
|
19
|
+
export type ScreenDriver<E = never> = Omit<ReturnType<typeof makeScreenDriver>, "settle"> & {
|
|
20
|
+
settle: (options?: {
|
|
21
|
+
readonly timeoutMs?: number;
|
|
22
|
+
}) => Effect.Effect<void, E>;
|
|
23
|
+
};
|
|
24
|
+
export declare function screenDriver(options: ScreenDriverOptions & {
|
|
25
|
+
readonly pending: () => boolean;
|
|
26
|
+
}): ScreenDriver;
|
|
27
|
+
export declare function screenDriver(options: ScreenDriverOptions): ScreenDriver<MissingScreenPending>;
|
|
28
|
+
declare function makeScreenDriver({ root, pending, tell, act, timeoutMs }: ScreenDriverOptions): {
|
|
15
29
|
accessible: (selector: string | Element) => {
|
|
16
30
|
name: string;
|
|
17
31
|
role: string | null;
|
|
@@ -23,9 +37,10 @@ export declare function screenDriver({ root, pending, tell, act, timeoutMs }: Sc
|
|
|
23
37
|
}) => Effect.Effect<HTMLElement, import("effect/Cause").UnknownError, never>;
|
|
24
38
|
settle: (options?: {
|
|
25
39
|
readonly timeoutMs?: number;
|
|
26
|
-
}) => Effect.Effect<void, never, never>;
|
|
40
|
+
}) => Effect.Effect<void, never, never> | Effect.Effect<never, MissingScreenPending, never>;
|
|
27
41
|
submit: (selector?: ScreenTarget) => Effect.Effect<void, never, never>;
|
|
28
42
|
text: (selector?: ScreenTarget) => string;
|
|
29
43
|
value: (selector: ScreenTarget) => string;
|
|
30
44
|
};
|
|
45
|
+
export {};
|
|
31
46
|
//# sourceMappingURL=screenDriver.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"screenDriver.d.ts","sourceRoot":"","sources":["../../src/server/screenDriver.ts"],"names":[],"mappings":"AAAA,OAAO,
|
|
1
|
+
{"version":3,"file":"screenDriver.d.ts","sourceRoot":"","sources":["../../src/server/screenDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,MAAM,EAAY,MAAM,QAAQ,CAAC;AAKhD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAE9F,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,CAAC;IAClE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,CAAC,MAAM,WAAW,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC5B;;;;AAED,qBAAa,oBAAqB,SAAQ,yBAAwC;IACjF,SAAkB,OAAO,4MACiL;CAC1M;AAED,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAAE,QAAQ,CAAC,GAAG;IAC3F,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;CAC9E,CAAC;AAEF,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG;IAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAA;CAAE,GAAG,YAAY,CAAC;AAC/G,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;AAK/F,iBAAS,gBAAgB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAA0B,EAAE,SAAgB,EAAE,EAAE,mBAAmB;2BAoD3F,MAAM,GAAG,OAAO;;;;sBASrB,YAAY;sBAOZ,YAAY,SAAS,MAAM;mBAlCxB,YAAY,YAAW;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;uBAzBjD;QAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;wBA8DpC,YAAY;sBACb,YAAY;sBAKZ,YAAY;EAM/B"}
|
|
@@ -1,8 +1,14 @@
|
|
|
1
|
-
import { Effect, Schedule } from "effect";
|
|
1
|
+
import { Data, Effect, Schedule } from "effect";
|
|
2
2
|
import { withLive } from "@shivaedev/effect-test/withLive.ts";
|
|
3
3
|
import { accessibility, targetName } from "#internal/screenAccessibility.ts";
|
|
4
4
|
import { screenElements } from "#internal/screenElements.ts";
|
|
5
|
-
export
|
|
5
|
+
export class MissingScreenPending extends Data.TaggedError("MissingScreenPending") {
|
|
6
|
+
message = "Cannot settle the screen without the pending option.\nhelp: Supply pending: () => boolean that reads the application's pending work and stays true until its resulting screen work is ready to render.";
|
|
7
|
+
}
|
|
8
|
+
export function screenDriver(options) {
|
|
9
|
+
return makeScreenDriver(options);
|
|
10
|
+
}
|
|
11
|
+
function makeScreenDriver({ root, pending, tell, act = (action) => action(), timeoutMs = 3000 }) {
|
|
6
12
|
const currentRoot = typeof root === "function" ? root : () => root;
|
|
7
13
|
const elements = screenElements(currentRoot);
|
|
8
14
|
function perform(line, action) {
|
|
@@ -12,6 +18,9 @@ export function screenDriver({ root, pending, tell, act = (action) => action(),
|
|
|
12
18
|
});
|
|
13
19
|
}
|
|
14
20
|
function settle(options = {}) {
|
|
21
|
+
if (pending === undefined) {
|
|
22
|
+
return Effect.fail(new MissingScreenPending());
|
|
23
|
+
}
|
|
15
24
|
const limit = options.timeoutMs ?? timeoutMs;
|
|
16
25
|
const wait = Effect.gen(function* () {
|
|
17
26
|
tell("wait for the screen's pending work");
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"screenDriver.js","sourceRoot":"","sources":["../../src/server/screenDriver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;
|
|
1
|
+
{"version":3,"file":"screenDriver.js","sourceRoot":"","sources":["../../src/server/screenDriver.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@shivaedev/test-story",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.20.0",
|
|
4
4
|
"description": "Tests that read like stories over the real engine: a story kit per engine with its own it, traits per feature, and a failure that prints the story, where it stopped and the engine's state",
|
|
5
5
|
"homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/test-story#readme",
|
|
6
6
|
"bugs": {
|
|
@@ -41,12 +41,12 @@
|
|
|
41
41
|
"README.md"
|
|
42
42
|
],
|
|
43
43
|
"dependencies": {
|
|
44
|
-
"@shivaedev/effect-test": "0.
|
|
44
|
+
"@shivaedev/effect-test": "0.9.0",
|
|
45
45
|
"dom-accessibility-api": "0.7.1"
|
|
46
46
|
},
|
|
47
47
|
"devDependencies": {
|
|
48
48
|
"@effect/vitest": "4.0.5",
|
|
49
|
-
"@shivaedev/quality": "0.
|
|
49
|
+
"@shivaedev/quality": "0.39.2",
|
|
50
50
|
"@types/node": "24.19.2",
|
|
51
51
|
"effect": "4.0.5",
|
|
52
52
|
"happy-dom": "21.0.3",
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { Effect, Schedule } from "effect";
|
|
1
|
+
import { Data, Effect, Schedule } from "effect";
|
|
2
2
|
import { withLive } from "@shivaedev/effect-test/withLive.ts";
|
|
3
3
|
import { accessibility, targetName } from "#internal/screenAccessibility.ts";
|
|
4
4
|
import { screenElements } from "#internal/screenElements.ts";
|
|
@@ -7,15 +7,28 @@ export type ScreenTarget = string | { readonly role: string; readonly name: stri
|
|
|
7
7
|
|
|
8
8
|
export interface ScreenDriverOptions {
|
|
9
9
|
readonly act?: (action: () => Promise<void>) => PromiseLike<void>;
|
|
10
|
-
readonly pending
|
|
10
|
+
readonly pending?: () => boolean;
|
|
11
11
|
readonly root: HTMLElement | (() => HTMLElement);
|
|
12
12
|
readonly tell: (line: string) => void;
|
|
13
13
|
readonly timeoutMs?: number;
|
|
14
14
|
}
|
|
15
15
|
|
|
16
|
-
export
|
|
16
|
+
export class MissingScreenPending extends Data.TaggedError("MissingScreenPending") {
|
|
17
|
+
override readonly message =
|
|
18
|
+
"Cannot settle the screen without the pending option.\nhelp: Supply pending: () => boolean that reads the application's pending work and stays true until its resulting screen work is ready to render.";
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export type ScreenDriver<E = never> = Omit<ReturnType<typeof makeScreenDriver>, "settle"> & {
|
|
22
|
+
settle: (options?: { readonly timeoutMs?: number }) => Effect.Effect<void, E>;
|
|
23
|
+
};
|
|
17
24
|
|
|
18
|
-
export function screenDriver(
|
|
25
|
+
export function screenDriver(options: ScreenDriverOptions & { readonly pending: () => boolean }): ScreenDriver;
|
|
26
|
+
export function screenDriver(options: ScreenDriverOptions): ScreenDriver<MissingScreenPending>;
|
|
27
|
+
export function screenDriver(options: ScreenDriverOptions) {
|
|
28
|
+
return makeScreenDriver(options);
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
function makeScreenDriver({ root, pending, tell, act = (action) => action(), timeoutMs = 3000 }: ScreenDriverOptions) {
|
|
19
32
|
const currentRoot = typeof root === "function" ? root : () => root;
|
|
20
33
|
const elements = screenElements(currentRoot);
|
|
21
34
|
function perform(line: string, action: () => void) {
|
|
@@ -25,6 +38,9 @@ export function screenDriver({ root, pending, tell, act = (action) => action(),
|
|
|
25
38
|
});
|
|
26
39
|
}
|
|
27
40
|
function settle(options: { readonly timeoutMs?: number } = {}) {
|
|
41
|
+
if (pending === undefined) {
|
|
42
|
+
return Effect.fail(new MissingScreenPending());
|
|
43
|
+
}
|
|
28
44
|
const limit = options.timeoutMs ?? timeoutMs;
|
|
29
45
|
const wait = Effect.gen(function* () {
|
|
30
46
|
tell("wait for the screen's pending work");
|