@xmachines/docs 1.0.0-beta.9 → 1.0.0

package/api/@xmachines/play-router/interfaces/WindowLike.md

@@ -0,0 +1,65 @@
+[API](../../../README.md) / [@xmachines/play-router](../README.md) / WindowLike
+
+# Interface: WindowLike
+
+Defined in: [types.ts:394](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-router/src/types.ts#L394)
+
+Minimal window interface required by adapters that subscribe to DOM events
+(e.g. `hashchange`). Injectable for SSR and testing — pass a mock instead of
+the global `window` when the DOM is unavailable.
+
+Defined structurally (no `Window` reference) so this package compiles without
+the DOM lib.
+
+## Example
+
+```typescript
+// Normal usage — global window (default)
+connectRouter({ actor, routeMap });
+
+// SSR / test — injected mock
+const mockWin: WindowLike = { addEventListener: vi.fn(), removeEventListener: vi.fn() };
+connectRouter({ actor, routeMap, window: mockWin });
+```
+
+## Methods
+
+### addEventListener()
+
+```ts
+addEventListener(type, listener): void;
+```
+
+Defined in: [types.ts:395](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-router/src/types.ts#L395)
+
+#### Parameters
+
+| Parameter  | Type                |
+| ---------- | ------------------- |
+| `type`     | `string`            |
+| `listener` | (`event`) => `void` |
+
+#### Returns
+
+`void`
+
+---
+
+### removeEventListener()
+
+```ts
+removeEventListener(type, listener): void;
+```
+
+Defined in: [types.ts:396](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-router/src/types.ts#L396)
+
+#### Parameters
+
+| Parameter  | Type                |
+| ---------- | ------------------- |
+| `type`     | `string`            |
+| `listener` | (`event`) => `void` |
+
+#### Returns
+
+`void`

package/api/@xmachines/play-router/type-aliases/MachineGraph.md

@@ -0,0 +1,20 @@
+[API](../../../README.md) / [@xmachines/play-router](../README.md) / MachineGraph
+
+# Type Alias: MachineGraph
+
+```ts
+type MachineGraph = Graph<MachineNodeData, MachineEdgeData>;
+```
+
+Defined in: [machine-to-graph.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-router/src/machine-to-graph.ts#L18)
+
+Typed @statelyai/graph Graph representing a state machine.
+Provides hierarchy queries, traversal algorithms, and reachability checks.
+
+## Example
+
+```typescript
+import { getChildren, getSuccessors, hasPath } from "@statelyai/graph";
+const graph: MachineGraph = machineToGraph(machine);
+const children = getChildren(graph, "myMachine");
+```

package/api/@xmachines/play-router/type-aliases/RouteMetadata.md

@@ -1,4 +1,4 @@
-[Documentation](../../../README.md) / [@xmachines/play-router](../README.md) / RouteMetadata
+[API](../../../README.md) / [@xmachines/play-router](../README.md) / RouteMetadata
 
 # Type Alias: RouteMetadata
 
@@ -6,6 +6,6 @@
 type RouteMetadata = string | RouteObject;
 ```
 
-Defined in: [types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-router/src/types.ts#L23)
+Defined in: [types.ts:51](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-router/src/types.ts#L51)
 
 Route metadata from state machine `meta.route` field.

package/api/@xmachines/play-signals/README.md

@@ -1,31 +1,81 @@
-[Documentation](../../README.md) / @xmachines/play-signals
+[API](../../README.md) / @xmachines/play-signals
+
+<!-- generated-by: gsd-doc-writer -->
 
 # @xmachines/play-signals
 
-**Canonical Signals substrate for XMachines with Stage 1 API isolation**
+TC39 Signals polyfill for XMachines — fine-grained reactive state primitives that enable glitch-free, subscription-free state propagation in the Play Architecture.
 
-`@xmachines/play-signals` re-exports `Signal` from `signal-polyfill` as the single import boundary for XMachines packages.
+Part of the [xmachines-js monorepo](../../README.md).
 
-## Why This Package Exists
+## Installation
 
-- Keep the raw `Signal` API as the canonical substrate surface.
-- Isolate Stage 1 proposal churn behind one package boundary.
-- Preserve Play invariants: Signal-only reactivity, passive infrastructure, and event-only mutation paths.
+```bash
+pnpm add @xmachines/play-signals
+```
 
-This package does not add business behavior to signals. Adapters and renderers observe signals and forward events; they do not mutate business state directly.
+## Overview
 
-## Installation
+This package wraps the [`signal-polyfill`](https://github.com/nicolo-ribaudo/tc39-proposal-signals-polyfill) reference implementation of the [TC39 Signals proposal](https://github.com/tc39/proposal-signals) (Stage 1). It re-exports the full `Signal` namespace and adds a memory-safe `watchSignal` utility, isolating the rest of the codebase from potential Stage 1 API churn.
 
-```bash
-npm install @xmachines/play-signals
+**All signal imports in the XMachines ecosystem should come from this package**, not directly from `signal-polyfill`, so that polyfill version bumps or API adaptations can be made in one place.
+
+## Usage
+
+### `Signal.State` — writable reactive state
+
+```typescript
+import { Signal } from "@xmachines/play-signals";
+
+const count = new Signal.State(0);
+
+console.log(count.get()); // 0
+count.set(5);
+console.log(count.get()); // 5
+```
+
+### `Signal.Computed` — lazy memoized derived values
+
+```typescript
+import { Signal } from "@xmachines/play-signals";
+
+const count = new Signal.State(0);
+const doubled = new Signal.Computed(() => count.get() * 2);
+
+console.log(doubled.get()); // 0  (computed on first access)
+count.set(5);
+console.log(doubled.get()); // 10 (recomputed because dependency changed)
+console.log(doubled.get()); // 10 (memoized — no recomputation)
+```
+
+Computations automatically track every signal accessed inside them. Dynamic branching is fully supported — only signals read in the _current_ execution path are tracked as dependencies.
+
+### `watchSignal` — memory-safe one-shot effect
+
+Use `watchSignal` to subscribe to a `Signal.State` or `Signal.Computed` and receive its value after each change. Updates are coalesced into a single microtask per synchronous batch.
+
+```typescript
+import { Signal, watchSignal } from "@xmachines/play-signals";
+
+const count = new Signal.State(0);
+
+const cleanup = watchSignal(count, (value) => {
+	console.log("count changed:", value);
+});
+
+count.set(1); // → logs "count changed: 1" (via microtask)
+count.set(2); // coalesced with any rapid synchronous changes
+count.set(3); // → logs "count changed: 3" once
+
+// Stop watching
+cleanup();
 ```
 
-## Current Exports
+The returned cleanup function is idempotent — calling it multiple times is safe and will not throw.
 
-- `Signal` (re-export from `signal-polyfill`)
-- Type exports from `src/types.ts`: `SignalState`, `SignalComputed`, `SignalWatcher`, `SignalOptions`, `ComputedOptions`, `WatcherNotify`
+### `Signal.subtle.Watcher` — low-level multi-signal observation
 
-## Quick Start
+For advanced use cases such as framework integrations, the full `Signal.subtle.Watcher` API is available:
 
 ```typescript
 import { Signal } from "@xmachines/play-signals";
@@ -36,80 +86,77 @@ const doubled = new Signal.Computed(() => count.get() * 2);
 const watcher = new Signal.subtle.Watcher(() => {
 	queueMicrotask(() => {
 		const pending = watcher.getPending();
-		for (const signal of pending) {
-			signal.get();
-		}
-		watcher.watch(...pending);
+		console.log("signals changed:", pending.length);
+		watcher.watch(...pending); // re-arm for future changes
 	});
 });
 
+watcher.watch(count);
 watcher.watch(doubled);
-doubled.get();
-
-count.set(2);
-
-const dispose = () => {
-	watcher.unwatch(doubled);
-};
 
-void dispose;
+count.set(5); // schedules microtask notification
 ```
 
-## Canonical Watcher Lifecycle
+### Custom equality
 
-Use one lifecycle pattern everywhere (React, Vue, Solid, router bridges, helper wrappers):
+Both `Signal.State` and `Signal.Computed` accept an `equals` option to control when dependents are notified:
 
-1. `notify` callback runs.
-2. Schedule work with `queueMicrotask`.
-3. Drain `watcher.getPending()`.
-4. Perform reads/effects.
-5. Re-arm watcher with `watch()` or `watch(...signals)`.
-
-Watcher notifications are one-shot. If you do not re-arm, you will miss future updates.
+```typescript
+import { Signal } from "@xmachines/play-signals";
+import type { SignalOptions } from "@xmachines/play-signals";
 
-## Cleanup Contract
+const options: SignalOptions<{ name: string; age: number }> = {
+	equals: (a, b) => a.name === b.name && a.age === b.age,
+};
 
-Always dispose explicitly. Do not rely on GC-only cleanup guidance.
+const person = new Signal.State({ name: "Alice", age: 30 }, options);
+// Setting structurally identical value will not notify dependents
+person.set({ name: "Alice", age: 30 });
+```
 
-- If you called `watch(...)`, call `unwatch(...)` in teardown.
-- Framework lifecycles (`useEffect` cleanup, `onUnmounted`, `onCleanup`) must unwatch.
-- Bridge lifecycles (`disconnect`, `dispose`) must unwatch and unsubscribe.
+## API Summary
 
-## Optional Helper Direction
+| Export                         | Kind      | Description                                                                                            |
+| ------------------------------ | --------- | ------------------------------------------------------------------------------------------------------ |
+| `Signal`                       | namespace | Full TC39 Signals namespace (`State`, `Computed`, `subtle.Watcher`) re-exported from `signal-polyfill` |
+| `watchSignal(signal, onValue)` | function  | Memory-safe subscription helper; returns a cleanup function                                            |
+| `SignalState<T>`               | interface | Shape of `Signal.State<T>` (`.get()`, `.set()`)                                                        |
+| `SignalComputed<T>`            | interface | Shape of `Signal.Computed<T>` (`.get()`)                                                               |
+| `SignalWatcher`                | interface | Shape of `Signal.subtle.Watcher` (`.watch()`, `.unwatch()`, `.getPending()`)                           |
+| `SignalOptions<T>`             | interface | Options bag for `Signal.State` constructor (`equals?`)                                                 |
+| `ComputedOptions<T>`           | interface | Options bag for `Signal.Computed` constructor (`equals?`)                                              |
+| `WatcherNotify`                | type      | Callback signature for `Signal.subtle.Watcher` notify function                                         |
 
-Raw `Signal` remains canonical. Helper APIs are optional, additive guidance for consistency:
+## Testing
 
-- `watchSignals(signals, onChange, options)`
-- `createSignalEffect(effect, options)`
-- `toSubscribable(signal, options)`
+Run tests for this package in isolation:
 
-These helpers are intended to codify lifecycle-safe watcher scheduling and deterministic teardown. They do not replace direct `Signal` usage.
+```bash
+# From this package directory
+pnpm test
 
-## API Surface
+# Watch mode
+pnpm test -- --watch
+```
 
-- `Signal.State<T>`: writable signal state (`get`, `set`)
-- `Signal.Computed<T>`: lazy memoized derivations
-- `Signal.subtle.Watcher`: low-level watcher (`watch`, `unwatch`, `getPending`)
+From the monorepo root:
 
-## Architecture Notes
+```bash
+# Run tests for this package
+pnpm --filter @xmachines/play-signals test
 
-- **Signal-Only Reactivity (INV-05):** Signals are the reactive substrate.
-- **Passive Infrastructure (INV-04):** Adapters and frameworks only observe/forward.
-- **Actor Authority (INV-01):** Business validity and transitions stay in actors.
-- **Event-only mutation path:** Signals are not a business mutation channel.
+# Run with coverage (lines ≥ 90 %, functions ≥ 90 %, branches ≥ 85 %, statements ≥ 90 %)
+pnpm run test:coverage
+```
 
-## Resources
+## Requirements
 
-- [TC39 Signals Proposal](https://github.com/tc39/proposal-signals)
-- [signal-polyfill](https://github.com/proposal-signals/signal-polyfill)
-- [RFC Play v1](https://gitlab.com/xmachin-es/rfc/-/blob/main/src/play-v1.md)
+- **Node.js** `>= 22.0.0`
+- **TypeScript** `5.7+` (for consumers using TypeScript)
 
 ## License
 
-Copyright (c) 2016 [Mikael Karon](mailto:mikael@karon.se). All rights reserved.
-
-This work is licensed under the terms of the MIT license.  
-For a copy, see <https://opensource.org/licenses/MIT>.
+MIT — see [LICENSE](LICENSE).
 
 TC39 Signals Polyfill for XMachines Play Architecture
 
@@ -145,7 +192,7 @@ count.set(5); // Logs: Count: 5 Doubled: 10
 
 ## See
 
-- [RFC Play v1 - Invariant INV-05](https://gitlab.com/xmachin-es/rfc/-/blob/main/src/play-v1.md)
+- [Play RFC](../../../rfc/play.md) - Invariant INV-05
 - [TC39 Signals Proposal](https://github.com/tc39/proposal-signals)
 
 ## Remarks
@@ -174,3 +221,7 @@ consuming packages. This architectural decision protects against Stage 1 API chu
 ## Type Aliases
 
 - [WatcherNotify](type-aliases/WatcherNotify.md)
+
+## Functions
+
+- [watchSignal](functions/watchSignal.md)

package/api/@xmachines/play-signals/functions/watchSignal.md

@@ -0,0 +1,42 @@
+[API](../../../README.md) / [@xmachines/play-signals](../README.md) / watchSignal
+
+# Function: watchSignal()
+
+```ts
+function watchSignal<T>(signal, onValue): () => void;
+```
+
+Defined in: [packages/play-signals/src/watch-signal.ts:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/watch-signal.ts#L21)
+
+Subscribe to a single signal using the canonical one-shot watcher lifecycle.
+
+The callback runs from a queued microtask after pending notifications are
+drained, then the watcher re-arms itself so future updates are not missed.
+The returned cleanup keeps teardown idempotent by tolerating already-detached
+watchers.
+
+**Memory safety (Phase 29):**
+
+- `disposed` flag prevents post-cleanup callback execution: if cleanup is
+  called before a pending microtask fires, the microtask returns early.
+- `needsEnqueue` guard dedups rapid synchronous signal changes: only one
+  microtask is ever queued per batch of synchronous mutations.
+
+## Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `T`            |
+
+## Parameters
+
+| Parameter | Type                                                                                                                        | Description                                             |
+| --------- | --------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
+| `signal`  | \| [`State`](../namespaces/Signal/classes/State.md)\<`T`\> \| [`Computed`](../namespaces/Signal/classes/Computed.md)\<`T`\> | A `Signal.State` or `Signal.Computed` to subscribe to.  |
+| `onValue` | (`value`) => `void`                                                                                                         | Called with the current signal value after each change. |
+
+## Returns
+
+A cleanup function that unregisters the watcher.
+
+() => `void`

package/api/@xmachines/play-signals/interfaces/ComputedOptions.md

@@ -1,13 +1,15 @@
-[Documentation](../../../README.md) / [@xmachines/play-signals](../README.md) / ComputedOptions
+[API](../../../README.md) / [@xmachines/play-signals](../README.md) / ComputedOptions
 
 # Interface: ComputedOptions\<T\>
 
-Defined in: [packages/play-signals/src/types.ts:84](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-signals/src/types.ts#L84)
+Defined in: [packages/play-signals/src/types.ts:84](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/types.ts#L84)
 
 Options for creating Signal.Computed
 
 ## Param
 
+**equals**
+
 Optional custom equality function for memoization
 
 ## Example
@@ -29,6 +31,6 @@ const options: ComputedOptions<string> = {
 
 ## Properties
 
-| Property                               | Type                    | Description                              | Defined in                                                                                                                                                                 |
-| -------------------------------------- | ----------------------- | ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-equals"></a> `equals?` | (`a`, `b`) => `boolean` | Custom equality function for memoization | [packages/play-signals/src/types.ts:88](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-signals/src/types.ts#L88) |
+| Property                               | Type                    | Description                              | Defined in                                                                                                                               |
+| -------------------------------------- | ----------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-equals"></a> `equals?` | (`a`, `b`) => `boolean` | Custom equality function for memoization | [packages/play-signals/src/types.ts:88](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/types.ts#L88) |

package/api/@xmachines/play-signals/interfaces/SignalComputed.md

@@ -1,8 +1,8 @@
-[Documentation](../../../README.md) / [@xmachines/play-signals](../README.md) / SignalComputed
+[API](../../../README.md) / [@xmachines/play-signals](../README.md) / SignalComputed
 
 # Interface: SignalComputed\<T\>
 
-Defined in: [packages/play-signals/src/types.ts:111](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-signals/src/types.ts#L111)
+Defined in: [packages/play-signals/src/types.ts:111](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/types.ts#L111)
 
 Lazily-evaluated, memoized computed signal
 
@@ -38,7 +38,7 @@ console.log(doubled.get()); // 10 (memoized, not recomputed)
 get(): T;
 ```
 
-Defined in: [packages/play-signals/src/types.ts:117](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-signals/src/types.ts#L117)
+Defined in: [packages/play-signals/src/types.ts:117](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/types.ts#L117)
 
 Read computed value (recalculates only if dependencies changed)
 

package/api/@xmachines/play-signals/interfaces/SignalOptions.md

@@ -1,13 +1,15 @@
-[Documentation](../../../README.md) / [@xmachines/play-signals](../README.md) / SignalOptions
+[API](../../../README.md) / [@xmachines/play-signals](../README.md) / SignalOptions
 
 # Interface: SignalOptions\<T\>
 
-Defined in: [packages/play-signals/src/types.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-signals/src/types.ts#L26)
+Defined in: [packages/play-signals/src/types.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/types.ts#L26)
 
 Options for creating Signal.State
 
 ## Param
 
+**equals**
+
 Optional custom equality function for determining if value changed
 
 ## Example
@@ -30,6 +32,6 @@ const count = new Signal.State(0, options);
 
 ## Properties
 
-| Property                               | Type                    | Description                                               | Defined in                                                                                                                                                                 |
-| -------------------------------------- | ----------------------- | --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-equals"></a> `equals?` | (`a`, `b`) => `boolean` | Custom equality function for determining if value changed | [packages/play-signals/src/types.ts:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-signals/src/types.ts#L33) |
+| Property                               | Type                    | Description                                               | Defined in                                                                                                                               |
+| -------------------------------------- | ----------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-equals"></a> `equals?` | (`a`, `b`) => `boolean` | Custom equality function for determining if value changed | [packages/play-signals/src/types.ts:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/types.ts#L33) |

package/api/@xmachines/play-signals/interfaces/SignalState.md

@@ -1,8 +1,8 @@
-[Documentation](../../../README.md) / [@xmachines/play-signals](../README.md) / SignalState
+[API](../../../README.md) / [@xmachines/play-signals](../README.md) / SignalState
 
 # Interface: SignalState\<T\>
 
-Defined in: [packages/play-signals/src/types.ts:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-signals/src/types.ts#L53)
+Defined in: [packages/play-signals/src/types.ts:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/types.ts#L53)
 
 Writable state signal holding a single reactive value
 
@@ -35,7 +35,7 @@ console.log(name.get()); // 'Bob'
 get(): T;
 ```
 
-Defined in: [packages/play-signals/src/types.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-signals/src/types.ts#L59)
+Defined in: [packages/play-signals/src/types.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/types.ts#L59)
 
 Read current value and track as dependency
 
@@ -53,7 +53,7 @@ Current value of the signal
 set(value): void;
 ```
 
-Defined in: [packages/play-signals/src/types.ts:66](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-signals/src/types.ts#L66)
+Defined in: [packages/play-signals/src/types.ts:66](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/types.ts#L66)
 
 Write new value and notify watchers if changed
 

package/api/@xmachines/play-signals/interfaces/SignalWatcher.md

@@ -1,8 +1,8 @@
-[Documentation](../../../README.md) / [@xmachines/play-signals](../README.md) / SignalWatcher
+[API](../../../README.md) / [@xmachines/play-signals](../README.md) / SignalWatcher
 
 # Interface: SignalWatcher
 
-Defined in: [packages/play-signals/src/types.ts:167](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-signals/src/types.ts#L167)
+Defined in: [packages/play-signals/src/types.ts:167](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/types.ts#L167)
 
 Watcher for observing signal changes and scheduling effects
 
@@ -40,7 +40,7 @@ getPending(): (
   | SignalComputed<unknown>)[];
 ```
 
-Defined in: [packages/play-signals/src/types.ts:187](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-signals/src/types.ts#L187)
+Defined in: [packages/play-signals/src/types.ts:187](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/types.ts#L187)
 
 Get signals that changed since last check
 
@@ -60,7 +60,7 @@ Array of signals that have pending updates
 unwatch(signal): void;
 ```
 
-Defined in: [packages/play-signals/src/types.ts:180](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-signals/src/types.ts#L180)
+Defined in: [packages/play-signals/src/types.ts:180](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/types.ts#L180)
 
 Stop watching a signal
 
@@ -82,7 +82,7 @@ Stop watching a signal
 watch(signal): void;
 ```
 
-Defined in: [packages/play-signals/src/types.ts:173](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-signals/src/types.ts#L173)
+Defined in: [packages/play-signals/src/types.ts:173](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-signals/src/types.ts#L173)
 
 Start watching a signal for changes
 

package/api/@xmachines/play-signals/namespaces/Signal/README.md

@@ -1,4 +1,4 @@
-[Documentation](../../../../README.md) / [@xmachines/play-signals](../../README.md) / Signal
+[API](../../../../README.md) / [@xmachines/play-signals](../../README.md) / Signal
 
 # Signal
 

package/api/@xmachines/play-signals/namespaces/Signal/classes/Computed.md

@@ -1,8 +1,8 @@
-[Documentation](../../../../../README.md) / [@xmachines/play-signals](../../../README.md) / [Signal](../README.md) / Computed
+[API](../../../../../README.md) / [@xmachines/play-signals](../../../README.md) / [Signal](../README.md) / Computed
 
 # Class: Computed\<T\>
 
-Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:15
+Defined in: `signal-polyfill`
 
 ## Type Parameters
 
@@ -18,7 +18,7 @@ Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:15
 new Computed<T>(computation, options?): Computed<T>;
 ```
 
-Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:18
+Defined in: `signal-polyfill`
 
 #### Parameters
 
@@ -33,9 +33,9 @@ Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:18
 
 ## Properties
 
-| Property                            | Modifier   | Type                  | Defined in                                        |
-| ----------------------------------- | ---------- | --------------------- | ------------------------------------------------- |
-| <a id="property-node"></a> `[NODE]` | `readonly` | `ComputedNode`\<`T`\> | node_modules/signal-polyfill/dist/wrapper.d.ts:17 |
+| Property                            | Modifier   | Type                  | Defined in |
+| ----------------------------------- | ---------- | --------------------- | ---------- |
+| <a id="property-node"></a> `[NODE]` | `readonly` | `ComputedNode`\<`T`\> | -          |
 
 ## Methods
 
@@ -45,7 +45,7 @@ Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:18
 get(): T;
 ```
 
-Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:19
+Defined in: `signal-polyfill`
 
 #### Returns
 

package/api/@xmachines/play-signals/namespaces/Signal/classes/State.md

@@ -1,8 +1,8 @@
-[Documentation](../../../../../README.md) / [@xmachines/play-signals](../../../README.md) / [Signal](../README.md) / State
+[API](../../../../../README.md) / [@xmachines/play-signals](../../../README.md) / [Signal](../README.md) / State
 
 # Class: State\<T\>
 
-Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:8
+Defined in: `signal-polyfill`
 
 ## Type Parameters
 
@@ -18,7 +18,7 @@ Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:8
 new State<T>(initialValue, options?): State<T>;
 ```
 
-Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:11
+Defined in: `signal-polyfill`
 
 #### Parameters
 
@@ -33,9 +33,9 @@ Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:11
 
 ## Properties
 
-| Property                            | Modifier   | Type                | Defined in                                        |
-| ----------------------------------- | ---------- | ------------------- | ------------------------------------------------- |
-| <a id="property-node"></a> `[NODE]` | `readonly` | `SignalNode`\<`T`\> | node_modules/signal-polyfill/dist/wrapper.d.ts:10 |
+| Property                            | Modifier   | Type                | Defined in |
+| ----------------------------------- | ---------- | ------------------- | ---------- |
+| <a id="property-node"></a> `[NODE]` | `readonly` | `SignalNode`\<`T`\> | -          |
 
 ## Methods
 
@@ -45,7 +45,7 @@ Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:11
 get(): T;
 ```
 
-Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:12
+Defined in: `signal-polyfill`
 
 #### Returns
 
@@ -59,7 +59,7 @@ Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:12
 set(newValue): void;
 ```
 
-Defined in: node_modules/signal-polyfill/dist/wrapper.d.ts:13
+Defined in: `signal-polyfill`
 
 #### Parameters