@vielzeug/clockwork 1.0.2

package/dist/types.d.ts

@@ -0,0 +1,277 @@
+import type { Readable } from '@vielzeug/ripple';
+export type MachineEvent = {
+    type: string;
+};
+export type EventType<Ev extends MachineEvent> = Ev['type'] & string;
+export type EventByType<Ev extends MachineEvent, Type extends EventType<Ev>> = Extract<Ev, {
+    type: Type;
+}>;
+type InitEvent = {
+    readonly type: '$init';
+};
+type HydrateEvent = {
+    readonly type: '$hydrate';
+};
+export type AfterEvent = {
+    readonly delay: number;
+    readonly type: '$after';
+};
+export type LifecycleEvent = AfterEvent | HydrateEvent | InitEvent;
+export type ActionArgs<Ctx extends object, Ev extends MachineEvent = MachineEvent> = {
+    context: Ctx;
+    readonly event: Ev;
+};
+export type ActionFn<Ctx extends object, Ev extends MachineEvent = MachineEvent> = (args: ActionArgs<Ctx, Ev>) => void;
+/** Convenience alias for action functions used in `after` delayed transitions. */
+export type AfterActionFn<Ctx extends object> = ActionFn<Ctx, AfterEvent>;
+/**
+ * Pure predicate that decides whether a transition is taken.
+ * Context is **readonly** — mutating it inside a guard corrupts live state and is never valid.
+ */
+export type GuardFn<Ctx extends object, Ev extends MachineEvent = MachineEvent> = (args: {
+    readonly context: Readonly<Ctx>;
+    readonly event: Readonly<Ev>;
+}) => boolean;
+export type LifecycleFn<Ctx extends object, Ev extends MachineEvent = MachineEvent> = (args: {
+    context: Ctx;
+    readonly event: Ev | LifecycleEvent;
+}) => void;
+export type TransitionDef<State extends string, Ctx extends object, Ev extends MachineEvent, Type extends EventType<Ev> = EventType<Ev>> = {
+    actions?: Array<ActionFn<Ctx, EventByType<Ev, Type>>>;
+    guard?: GuardFn<Ctx, EventByType<Ev, Type>>;
+    target: NoInfer<State>;
+};
+/** Single transition or array of conditional alternatives (for the `on` map). */
+export type TransitionInput<State extends string, Ctx extends object, Ev extends MachineEvent, Type extends EventType<Ev> = EventType<Ev>> = Array<TransitionDef<State, Ctx, Ev, Type>> | TransitionDef<State, Ctx, Ev, Type>;
+export type AfterDef<State extends string, Ctx extends object> = {
+    actions?: Array<AfterActionFn<Ctx>>;
+    delay: number;
+    /** Guard evaluated at timer fire time. Same signature as all other guards. */
+    guard?: GuardFn<Ctx, AfterEvent>;
+    target: NoInfer<State>;
+};
+export type InvokeArgs<Ctx extends object, Ev extends MachineEvent> = {
+    readonly context: Readonly<Ctx>;
+    readonly entryEvent: Ev | LifecycleEvent;
+    readonly signal: AbortSignal;
+};
+export type InvokeDef<Ctx extends object, Ev extends MachineEvent, Result = unknown> = {
+    /** Optional label surfaced in DebugEvent for traceability. Defaults to an auto-incremented id. */
+    id?: string;
+    onDone?: (result: Result, context: Readonly<Ctx>) => Ev;
+    onError?: (error: unknown, context: Readonly<Ctx>) => Ev;
+    src: (args: InvokeArgs<Ctx, Ev>) => Promise<Result>;
+};
+export type StateNode<State extends string, Ctx extends object, Ev extends MachineEvent> = {
+    after?: Array<AfterDef<State, Ctx>>;
+    entry?: LifecycleFn<Ctx, Ev>;
+    exit?: LifecycleFn<Ctx, Ev>;
+    /** Initial substate for compound states. */
+    initial?: string;
+    invoke?: Array<InvokeDef<Ctx, Ev, any>>;
+    on?: Partial<{
+        [Type in EventType<Ev>]: TransitionInput<State, Ctx, Ev, Type>;
+    }>;
+    /** Nested substates — makes this a compound state. */
+    states?: Record<string, StateNode<string, Ctx, Ev>>;
+};
+/**
+ * Validates context during a transition or at init.
+ * - Return `true` for valid context.
+ * - Return a non-empty string describing the failure (surfaced in `ClockworkError.details.reason`).
+ */
+export type ContextValidator<Ctx extends object> = (context: Ctx) => string | true;
+type ContextField<Ctx extends object> = Record<string, never> extends Ctx ? {
+    context?: Ctx;
+} : {
+    context: Ctx;
+};
+export type MachineConfig<State extends string, Ctx extends object, Ev extends MachineEvent> = ContextField<Ctx> & {
+    initial: NoInfer<State>;
+    states: Record<State, StateNode<NoInfer<State>, Ctx, Ev>>;
+    validateContext?: ContextValidator<Ctx>;
+};
+export type MachineSnapshot<State extends string, Ctx extends object> = {
+    readonly context: Readonly<Ctx>;
+    readonly state: State;
+};
+export type PersistenceAdapter<State extends string, Ctx extends object> = {
+    load: () => MachineSnapshot<State, Ctx> | undefined;
+    save: (snapshot: MachineSnapshot<State, Ctx>) => void;
+};
+export type DebugEvent<State extends string, Ctx extends object, Ev extends MachineEvent> = {
+    context: Readonly<Ctx>;
+    event: Ev;
+    from: State;
+    passed: boolean;
+    target: State;
+    type: 'guard';
+} | {
+    event: Ev;
+    from: State;
+    type: 'transition-skipped';
+} | {
+    event: Ev | LifecycleEvent;
+    from: State;
+    to: State;
+    type: 'transition';
+} | {
+    context: Readonly<Ctx>;
+    event: Ev | LifecycleEvent;
+    invokeId: string;
+    state: State;
+    type: 'invoke-start';
+} | {
+    context: Readonly<Ctx>;
+    event: Ev | LifecycleEvent;
+    invokeId: string;
+    result: unknown;
+    state: State;
+    type: 'invoke-done';
+} | {
+    context: Readonly<Ctx>;
+    error: unknown;
+    event: Ev | LifecycleEvent;
+    invokeId: string;
+    state: State;
+    type: 'invoke-error';
+} | {
+    context: Readonly<Ctx>;
+    event: Ev | LifecycleEvent;
+    invokeId: string;
+    state: State;
+    type: 'invoke-abort';
+};
+/**
+ * Pure event interceptor. Return the event (possibly transformed) to allow it,
+ * or `null` to block it. Runs in order; first `null` wins.
+ */
+export type InterceptorFn<State extends string, Ctx extends object, Ev extends MachineEvent> = (event: Ev, snapshot: {
+    readonly context: Readonly<Ctx>;
+    readonly state: State;
+}) => Ev | null;
+export type TransitionTraceEntry<State extends string, Ev extends MachineEvent> = {
+    readonly event: Ev | LifecycleEvent;
+    readonly from: State;
+    readonly timestamp: number;
+    readonly to: State;
+};
+/**
+ * Result of `send()`.
+ * - `status` — `'transitioned'` | `'queued'` | `'rejected'`
+ *
+ * Use `result.status !== 'rejected'` to check for success,
+ * and `result.status === 'queued'` to detect re-entrant sends inside actions.
+ */
+export type SendResult = {
+    readonly status: 'queued' | 'rejected' | 'transitioned';
+};
+export type InterpretOptions<State extends string, Ctx extends object, Ev extends MachineEvent> = {
+    /** Custom deep-clone function. Must return a structurally equivalent object with a safe prototype. Defaults to `structuredClone`. */
+    clone?: <T>(value: T) => T;
+    /** Array of pure interceptors. Each receives the event and current snapshot. Return the event (possibly transformed) to allow it, or `null` to block. Runs left-to-right; first `null` stops the chain. */
+    interceptors?: Array<InterceptorFn<State, Ctx, Ev>>;
+    /**
+     * Maximum number of transitions processed in a single synchronous flush.
+     * Defaults to `1_000`. Increase only if your machine has intentionally deep
+     * guard-only transition chains; reaching this limit throws
+     * `MACHINE_TRANSITION_LOOP_GUARD` to prevent infinite loops.
+     */
+    maxTransitionsPerFlush?: number;
+    /** Callback for all debug events (guards, transitions, invokes, skips). Auto-enables a 50-entry trace buffer unless `traceLimit` is set. */
+    onDebug?: (event: DebugEvent<State, Ctx, Ev>) => void;
+    persistence?: PersistenceAdapter<State, Ctx>;
+    snapshot?: MachineSnapshot<State, Ctx>;
+    /**
+     * Ring buffer capacity for `getTrace()`.
+     * Defaults to `50` when `onDebug` is set; `0` (disabled) otherwise.
+     * Set explicitly to override.
+     */
+    traceLimit?: number;
+};
+export interface MachineDefinition<State extends string, Ctx extends object, Ev extends MachineEvent> {
+    /**
+     * Resolves the transition that would be taken for a given state, context, and event.
+     * Pure — no side effects, no debug events.
+     *
+     * @param options.onGuard — called for every guard evaluation (passed and failed).
+     */
+    resolve(input: {
+        context: Readonly<Ctx>;
+        event: Ev;
+        state: State;
+    }, options?: {
+        onGuard?: (info: {
+            context: Readonly<Ctx>;
+            event: Ev;
+            from: State;
+            passed: boolean;
+            target: State;
+        }) => void;
+    }): TransitionDef<State, Ctx, Ev> | undefined;
+    /** Creates a running machine instance from this definition. */
+    start(options?: InterpretOptions<State, Ctx, Ev>): MachineInstance<State, Ctx, Ev>;
+}
+export interface MachineInstance<State extends string, Ctx extends object, Ev extends MachineEvent> {
+    readonly context: Readable<Ctx>;
+    /** Fires when the machine is disposed. Use to tie external lifecycles to the machine's lifetime. */
+    readonly disposalSignal: AbortSignal;
+    /** Whether the machine has been permanently disposed. */
+    readonly disposed: boolean;
+    readonly state: Readable<State>;
+    /**
+     * Returns `true` if a valid transition exists for `event` in the current state.
+     * Evaluates guards but fires no side effects or debug hooks.
+     * Returns `false` when the machine is disposed.
+     */
+    can(event: Ev): boolean;
+    /** Terminates the machine: aborts all active invokes, clears timers, and disposes internal signals. Idempotent. */
+    dispose(): void;
+    getSnapshot(): MachineSnapshot<State, Ctx>;
+    getTrace(): readonly TransitionTraceEntry<State, Ev>[];
+    /**
+     * Returns `true` if the current state equals one of the given values or is a
+     * descendant of any (e.g. `matches('loading')` matches `'loading.pending'`).
+     * Returns `false` when the machine is disposed.
+     */
+    matches(...states: string[]): boolean;
+    /**
+     * Dispatches the event and returns a `SendResult`.
+     * Check `.status` for `'transitioned'`, `'queued'`, or `'rejected'`.
+     */
+    send(event: Ev): SendResult;
+    /**
+     * Subscribes to state/context changes. Fires only when state or context
+     * reference changes — **not** on the initial state. Returns an unsubscribe
+     * function. Use `getSnapshot()` to read the current state immediately.
+     */
+    subscribe(fn: (snapshot: MachineSnapshot<State, Ctx>) => void): () => void;
+    [Symbol.dispose](): void;
+}
+/**
+ * Opaque schema bundle. Captures the three generics in a single type for
+ * ergonomic machine typing.
+ *
+ * @example
+ * ```ts
+ * type Auth = MachineSchema<'idle' | 'loading', { user: User | null }, AuthEvent>;
+ *
+ * const guard: MachineGuard<Auth> = ({ context }) => !!context.user;
+ * const action: MachineAction<Auth, { type: 'DONE'; user: User }> = ({ context, event }) => {
+ *   context.user = event.user;
+ * };
+ * ```
+ */
+export type MachineSchema<S extends string, C extends object, E extends MachineEvent> = {
+    readonly _c: C;
+    readonly _e: E;
+    readonly _s: S;
+};
+export type MachineTypeConfig<T extends MachineSchema<any, any, any>> = MachineConfig<T['_s'], T['_c'], T['_e']>;
+export type MachineTypeDefinition<T extends MachineSchema<any, any, any>> = MachineDefinition<T['_s'], T['_c'], T['_e']>;
+export type MachineTypeInstance<T extends MachineSchema<any, any, any>> = MachineInstance<T['_s'], T['_c'], T['_e']>;
+export type MachineTypeOptions<T extends MachineSchema<any, any, any>> = InterpretOptions<T['_s'], T['_c'], T['_e']>;
+export type MachineAction<T extends MachineSchema<any, any, any>, E extends T['_e'] = T['_e']> = ActionFn<T['_c'], E>;
+export type MachineGuard<T extends MachineSchema<any, any, any>, E extends T['_e'] = T['_e']> = GuardFn<T['_c'], E>;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@vielzeug/clockwork",
+  "version": "1.0.2",
+  "description": "Zero-dependency typed finite state machine — guards, async invokes, nested states, and signal integration",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./devtools": {
+      "source": "./src/devtools.ts",
+      "types": "./dist/devtools.d.ts",
+      "import": "./dist/devtools.js",
+      "require": "./dist/devtools.cjs"
+    }
+  },
+  "scripts": {
+    "build": "vite build && pnpm run build:bundle && pnpm run build:types",
+    "build:types": "tsc -p tsconfig.declarations.json",
+    "fix": "eslint --fix src",
+    "lint": "eslint src",
+    "prepublishOnly": "pnpm run build",
+    "test": "vitest",
+    "build:bundle": "vite build --config vite.bundle.config.ts"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@vielzeug/ripple": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.0",
+    "typescript": "~6.0.3",
+    "vite": "^8.1.3",
+    "vitest": "^4.1.9"
+  }
+}