@jterrazz/test 16.1.1 → 17.0.0

package/docs/reference/type-aliases/RenderSubject.md

@@ -1,12 +0,0 @@
-<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
-# Type Alias: RenderSubject
-
-```ts
-type RenderSubject = ComponentUi | DomMount;
-```
-
-Defined in: [src/facets/component/component.types.ts:31](https://github.com/jterrazz/package-test/blob/main/src/facets/component/component.types.ts#L31)
-
-What `.render()` mounts. A React tree is an element (`<PostTable />`); a
-vanilla DOM subject is the FUNCTION that fills a container, which is how a
-DOM-only module is called in production too.

package/docs/reference/type-aliases/ScreenNode.md

@@ -1,67 +0,0 @@
-<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
-# Type Alias: ScreenNode
-
-```ts
-type ScreenNode = object;
-```
-
-Defined in: [src/model/ports/device.port.ts:68](https://github.com/jterrazz/package-test/blob/main/src/model/ports/device.port.ts#L68)
-
-One node of the projected accessibility tree — the XCUITest page source
-with its noise collapsed: unlabeled, identifier-less, valueless wrapper
-nodes are dropped and their children hoisted, so the projection stays
-stable and golden-friendly. Type names lose the `XCUIElementType` prefix.
-
-## Properties
-
-### children?
-
-```ts
-optional children?: ScreenNode[];
-```
-
-Defined in: [src/model/ports/device.port.ts:69](https://github.com/jterrazz/package-test/blob/main/src/model/ports/device.port.ts#L69)
-
-***
-
-### identifier?
-
-```ts
-optional identifier?: string;
-```
-
-Defined in: [src/model/ports/device.port.ts:71](https://github.com/jterrazz/package-test/blob/main/src/model/ports/device.port.ts#L71)
-
-The accessibility identifier, only when it differs from the label.
-
-***
-
-### label?
-
-```ts
-optional label?: string;
-```
-
-Defined in: [src/model/ports/device.port.ts:72](https://github.com/jterrazz/package-test/blob/main/src/model/ports/device.port.ts#L72)
-
-***
-
-### type
-
-```ts
-type: string;
-```
-
-Defined in: [src/model/ports/device.port.ts:74](https://github.com/jterrazz/package-test/blob/main/src/model/ports/device.port.ts#L74)
-
-Element type without the `XCUIElementType` prefix — `Button`, `StaticText`.
-
-***
-
-### value?
-
-```ts
-optional value?: string;
-```
-
-Defined in: [src/model/ports/device.port.ts:75](https://github.com/jterrazz/package-test/blob/main/src/model/ports/device.port.ts#L75)

package/docs/reference/type-aliases/ServerPort.md

@@ -1,36 +0,0 @@
-<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
-# Type Alias: ServerPort
-
-```ts
-type ServerPort = object;
-```
-
-Defined in: [src/model/ports/server.port.ts:17](https://github.com/jterrazz/package-test/blob/main/src/model/ports/server.port.ts#L17)
-
-Abstract server interface for specification runners.
-Integration mode uses an in-process Hono app; E2E mode uses real HTTP via fetch.
-
-## Properties
-
-### request
-
-```ts
-request: (method, path, body?, headers?) => Promise<ServerResponse>;
-```
-
-Defined in: [src/model/ports/server.port.ts:19](https://github.com/jterrazz/package-test/blob/main/src/model/ports/server.port.ts#L19)
-
-Send an HTTP request and return the parsed response.
-
-#### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `method` | `string` |
-| `path` | `string` |
-| `body?` | `unknown` |
-| `headers?` | `Record`\<`string`, `string`\> |
-
-#### Returns
-
-`Promise`\<[`ServerResponse`](ServerResponse.md)\>

package/docs/reference/type-aliases/ServerResponse.md

@@ -1,46 +0,0 @@
-<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
-# Type Alias: ServerResponse
-
-```ts
-type ServerResponse = object;
-```
-
-Defined in: [src/model/ports/server.port.ts:4](https://github.com/jterrazz/package-test/blob/main/src/model/ports/server.port.ts#L4)
-
-HTTP response returned by a server port, with parsed JSON body.
-
-## Properties
-
-### body
-
-```ts
-body: unknown;
-```
-
-Defined in: [src/model/ports/server.port.ts:8](https://github.com/jterrazz/package-test/blob/main/src/model/ports/server.port.ts#L8)
-
-Parsed JSON response body, or null if parsing failed.
-
-***
-
-### headers
-
-```ts
-headers: Record<string, string>;
-```
-
-Defined in: [src/model/ports/server.port.ts:10](https://github.com/jterrazz/package-test/blob/main/src/model/ports/server.port.ts#L10)
-
-Response headers as a flat key-value map.
-
-***
-
-### status
-
-```ts
-status: number;
-```
-
-Defined in: [src/model/ports/server.port.ts:6](https://github.com/jterrazz/package-test/blob/main/src/model/ports/server.port.ts#L6)
-
-HTTP status code.

package/docs/reference/type-aliases/ServerSpec.md

@@ -1,21 +0,0 @@
-<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
-# Type Alias: ServerSpec\<Services\>
-
-```ts
-type ServerSpec<Services> = 
-  | ((services) => 
-  | ProcessHandle
-  | ProcessOptions)
-  | ProcessHandle
-  | ProcessOptions;
-```
-
-Defined in: [src/facets/website/website.specification.ts:32](https://github.com/jterrazz/package-test/blob/main/src/facets/website/website.specification.ts#L32)
-
-What `server` may be handed as, and what it resolves to.
-
-## Type Parameters
-
-| Type Parameter |
-| ------ |
-| `Services` *extends* [`ServiceRecord`](ServiceRecord.md) |

package/docs/reference/type-aliases/ServiceHandle.md

@@ -1,216 +0,0 @@
-<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
-# Type Alias: ServiceHandle
-
-```ts
-type ServiceHandle = object;
-```
-
-Defined in: [src/model/ports/service.port.ts:8](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L8)
-
-A service handle — returned by factory functions like postgres(), redis().
-Mutable: connectionString is populated after the orchestrator starts containers.
-
-## Properties
-
-### buildConnectionString
-
-```ts
-buildConnectionString: (host, port) => string;
-```
-
-Defined in: [src/model/ports/service.port.ts:37](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L37)
-
-Build the connection string from host and port.
-
-#### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `host` | `string` |
-| `port` | `number` |
-
-#### Returns
-
-`string`
-
-***
-
-### connectionString
-
-```ts
-connectionString: string;
-```
-
-Defined in: [src/model/ports/service.port.ts:31](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L31)
-
-Connection string — populated after start.
-
-***
-
-### createDatabaseAdapter
-
-```ts
-createDatabaseAdapter: () => DatabasePort | null;
-```
-
-Defined in: [src/model/ports/service.port.ts:40](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L40)
-
-Create a DatabasePort adapter (if this is a database). Returns null otherwise.
-
-#### Returns
-
-[`DatabasePort`](DatabasePort.md) \| `null`
-
-***
-
-### defaultImage
-
-```ts
-readonly defaultImage: string;
-```
-
-Defined in: [src/model/ports/service.port.ts:25](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L25)
-
-Default Docker image for this service type.
-
-***
-
-### defaultPort
-
-```ts
-readonly defaultPort: number;
-```
-
-Defined in: [src/model/ports/service.port.ts:22](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L22)
-
-Default container port for this service type.
-
-***
-
-### environment
-
-```ts
-readonly environment: Record<string, string>;
-```
-
-Defined in: [src/model/ports/service.port.ts:28](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L28)
-
-Environment variables to pass to the container.
-
-***
-
-### healthcheck
-
-```ts
-healthcheck: () => Promise<void>;
-```
-
-Defined in: [src/model/ports/service.port.ts:43](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L43)
-
-Verify the service is ready and accepting connections. Throws with context if not.
-
-#### Returns
-
-`Promise`\<`void`\>
-
-***
-
-### initialize
-
-```ts
-initialize: (dockerDir, root) => Promise<void>;
-```
-
-Defined in: [src/model/ports/service.port.ts:55](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L55)
-
-Run initialization scripts (e.g., init.sql). Throws with SQL error
-context if it fails.
-
-`dockerDir` is `<root>/docker` — where a service reads its `init.sql`
-from, under its own name. `root` is the project root the specification resolved
-(A9), handed down so a service that CACHES something writes it under the
-project's own `.artifacts/`, never in a machine-global directory two
-checkouts would share.
-
-#### Parameters
-
-| Parameter | Type |
-| ------ | ------ |
-| `dockerDir` | `string` |
-| `root` | `string` |
-
-#### Returns
-
-`Promise`\<`void`\>
-
-***
-
-### isolation
-
-```ts
-isolation: () => IsolationStrategy;
-```
-
-Defined in: [src/model/ports/service.port.ts:61](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L61)
-
-Get the isolation strategy for parallel test execution.
-
-#### Returns
-
-[`IsolationStrategy`](IsolationStrategy.md)
-
-***
-
-### reset
-
-```ts
-reset: () => Promise<void>;
-```
-
-Defined in: [src/model/ports/service.port.ts:58](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L58)
-
-Reset state between tests (truncate tables, flush cache, etc.)
-
-#### Returns
-
-`Promise`\<`void`\>
-
-***
-
-### serviceName
-
-```ts
-serviceName: null | string;
-```
-
-Defined in: [src/model/ports/service.port.ts:19](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L19)
-
-The name this handle is known by. Left `null` until the orchestrator
-assigns it at start time: it is the kebab-case form of the RECORD KEY,
-so `{ analyticsDb: postgres() }` reports as `analytics-db` and reads its
-init script from `docker/analytics-db/`. The key is the only name a
-specification writes; a handle carries no second one of its own.
-
-***
-
-### started
-
-```ts
-started: boolean;
-```
-
-Defined in: [src/model/ports/service.port.ts:34](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L34)
-
-Whether this service has been started.
-
-***
-
-### type
-
-```ts
-readonly type: string;
-```
-
-Defined in: [src/model/ports/service.port.ts:10](https://github.com/jterrazz/package-test/blob/main/src/model/ports/service.port.ts#L10)
-
-Service type identifier.

package/docs/reference/type-aliases/ServiceRecord.md

@@ -1,12 +0,0 @@
-<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
-# Type Alias: ServiceRecord
-
-```ts
-type ServiceRecord = Record<string, ServiceHandle>;
-```
-
-Defined in: [src/model/chain/services.ts:16](https://github.com/jterrazz/package-test/blob/main/src/model/chain/services.ts#L16)
-
-Infrastructure services declared as a named record. Keys become the typed
-vocabulary of the whole spec: the server factory receives the same record,
-and `.seed()` / `.table()` target databases by key.

package/docs/reference/type-aliases/SpecDocument.md

@@ -1,84 +0,0 @@
-<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
-# Type Alias: SpecDocument
-
-```ts
-type SpecDocument = object;
-```
-
-Defined in: [src/model/literate/spec-document.ts:134](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L134)
-
-A parsed `<case>.spec.yaml`.
-
-## Properties
-
-### description
-
-```ts
-description: string;
-```
-
-Defined in: [src/model/literate/spec-document.ts:136](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L136)
-
-The vitest test title.
-
-***
-
-### descriptionLine
-
-```ts
-descriptionLine: number;
-```
-
-Defined in: [src/model/literate/spec-document.ts:138](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L138)
-
-1-based line of the `description:` key.
-
-***
-
-### env
-
-```ts
-env: SpecEnvToken[];
-```
-
-Defined in: [src/model/literate/spec-document.ts:139](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L139)
-
-***
-
-### fixtures
-
-```ts
-fixtures: SpecFixture[];
-```
-
-Defined in: [src/model/literate/spec-document.ts:140](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L140)
-
-***
-
-### kind
-
-```ts
-kind: SpecKind;
-```
-
-Defined in: [src/model/literate/spec-document.ts:141](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L141)
-
-***
-
-### runs
-
-```ts
-runs: SpecRun[];
-```
-
-Defined in: [src/model/literate/spec-document.ts:142](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L142)
-
-***
-
-### serve
-
-```ts
-serve: SpecServeEntry[];
-```
-
-Defined in: [src/model/literate/spec-document.ts:143](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L143)

package/docs/reference/type-aliases/SpecEnvToken.md

@@ -1,21 +0,0 @@
-<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
-# Type Alias: SpecEnvToken
-
-```ts
-type SpecEnvToken = 
-  | {
-  key: string;
-  kind: "pair";
-  line: number;
-  value: string;
-}
-  | {
-  kind: "set";
-  line: number;
-  name: string;
-};
-```
-
-Defined in: [src/model/literate/spec-document.ts:80](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L80)
-
-One `env:` entry — a bare word naming a registered set, or a `KEY=value` pair.

package/docs/reference/type-aliases/SpecFileAssertion.md

@@ -1,27 +0,0 @@
-<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
-# Type Alias: SpecFileAssertion
-
-```ts
-type SpecFileAssertion = 
-  | {
-  contains: SpecStream[];
-  equals: null | SpecStream;
-  kind: "content";
-  line: number;
-  path: string;
-}
-  | {
-  kind: "absent";
-  line: number;
-  path: string;
-}
-  | {
-  kind: "exists";
-  line: number;
-  path: string;
-};
-```
-
-Defined in: [src/model/literate/spec-document.ts:105](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L105)
-
-One `files:` assertion, keyed by a workdir-relative path.

package/docs/reference/type-aliases/SpecFixture.md

@@ -1,30 +0,0 @@
-<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
-# Type Alias: SpecFixture
-
-```ts
-type SpecFixture = object;
-```
-
-Defined in: [src/model/literate/spec-document.ts:92](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L92)
-
-One `fixture:` entry — a path with the line it was declared on.
-
-## Properties
-
-### line
-
-```ts
-line: number;
-```
-
-Defined in: [src/model/literate/spec-document.ts:93](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L93)
-
-***
-
-### path
-
-```ts
-path: string;
-```
-
-Defined in: [src/model/literate/spec-document.ts:94](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L94)

package/docs/reference/type-aliases/SpecKind.md

@@ -1,8 +0,0 @@
-<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
-# Type Alias: SpecKind
-
-```ts
-type SpecKind = typeof SPEC_KINDS[number];
-```
-
-Defined in: [src/model/literate/spec-document.ts:77](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L77)

package/docs/reference/type-aliases/SpecRun.md

@@ -1,108 +0,0 @@
-<!-- GENERATED by `typescript docs` — DO NOT EDIT -->
-# Type Alias: SpecRun
-
-```ts
-type SpecRun = object;
-```
-
-Defined in: [src/model/literate/spec-document.ts:117](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L117)
-
-One run: a command, what it must exit with, and what it must have produced.
-
-## Properties
-
-### command
-
-```ts
-command: string;
-```
-
-Defined in: [src/model/literate/spec-document.ts:118](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L118)
-
-***
-
-### commandLine
-
-```ts
-commandLine: number;
-```
-
-Defined in: [src/model/literate/spec-document.ts:120](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L120)
-
-1-based line of the `command:` key — the frame a failure points at.
-
-***
-
-### exitCode
-
-```ts
-exitCode: number;
-```
-
-Defined in: [src/model/literate/spec-document.ts:121](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L121)
-
-***
-
-### files
-
-```ts
-files: SpecFileAssertion[];
-```
-
-Defined in: [src/model/literate/spec-document.ts:122](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L122)
-
-***
-
-### stderr
-
-```ts
-stderr: null | SpecStream;
-```
-
-Defined in: [src/model/literate/spec-document.ts:124](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L124)
-
-`null` when the key is absent, which asserts an empty stream.
-
-***
-
-### stdin
-
-```ts
-stdin: null | string;
-```
-
-Defined in: [src/model/literate/spec-document.ts:126](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L126)
-
-Written to the child then closed; `null` keeps the empty-pipe EOF.
-
-***
-
-### stdout
-
-```ts
-stdout: null | SpecStream;
-```
-
-Defined in: [src/model/literate/spec-document.ts:127](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L127)
-
-***
-
-### timeout
-
-```ts
-timeout: null | number;
-```
-
-Defined in: [src/model/literate/spec-document.ts:128](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L128)
-
-***
-
-### waitFor
-
-```ts
-waitFor: null | string;
-```
-
-Defined in: [src/model/literate/spec-document.ts:130](https://github.com/jterrazz/package-test/blob/main/src/model/literate/spec-document.ts#L130)
-
-Only ever on the LAST run — a long-running command ends the session.