@gostack-framework/react 0.0.0-stage → 0.1.0

package/dist/line-flow/react/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../src/line-flow/react/bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAqB,MAAM,OAAO,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,yBAAyB,GAC7B,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC;AAO9D;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAkB,EAClB,KAAQ,EACR,OAAkC;IAElC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,UAAU,IAAI,OAAO,IAAI,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QACtF,MAAM,IAAI,uBAAuB,CAAC,wDAAwD,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,aAAa,CAAC;IAChD,MAAM,QAAQ,GAAG,OAAO,IAAI,gBAAgB,IAAI,OAAO,CAAC;IACxD,MAAM,UAAU,GAAG,OAAO,EAAE,cAAc,CAAC;IAE3C,yBAAyB,CAAC,GAAG,EAAE;QAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAE1B,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,QAAQ,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACjC,IAAI,CAAC,GAAG,CAAC,UAAe,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AACnC,CAAC;AAOD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAI,EAChC,IAAI,EACJ,KAAK,EACL,MAAM,EACN,cAAc,GACS;IACvB,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/line-flow/react/hooks.d.ts

@@ -0,0 +1,29 @@
+import type { EqualityFn, EventLine, Listener, ReadableLine, StateLine } from "../types.js";
+/**
+ * Subscribes to a LineFlow readable line (StateLine or DerivedLine) and returns its current snapshot.
+ * Synchronizes with React's concurrent renderer using useSyncExternalStore.
+ */
+export declare function useLineFlowValue<T>(line: ReadableLine<T>): T;
+/**
+ * Subscribes to a slice of state from a readable line using a selector function.
+ * Prevents unnecessary re-renders when the selected value is unchanged according to the equality function.
+ *
+ * Implements the canonical closure-based memoization pattern to guarantee stability across
+ * concurrent renders, StrictMode checks, and inline selector re-creations without render-phase ref mutations.
+ */
+export declare function useLineFlowSelector<T, S>(line: ReadableLine<T>, selector: (state: T) => S, equals?: EqualityFn<S>): S;
+/**
+ * Returns stable updater functions { set, update } for a StateLine.
+ * Unlike useLineFlowValue, using this hook does NOT subscribe the component to state changes,
+ * preventing re-renders when the line value updates.
+ */
+export declare function useLineFlowSet<T>(line: StateLine<T>): {
+    set: (value: T) => void;
+    update: (updater: (prev: T) => T) => void;
+};
+/**
+ * Subscribes to events published on an EventLine.
+ * Automatically cleans up the subscription on unmount or when the line changes.
+ * Preserves fresh listener callback identity without causing resubscription.
+ */
+export declare function useLineFlowEvent<T>(line: EventLine<T>, listener: Listener<T>): void;

package/dist/line-flow/react/hooks.js

@@ -0,0 +1,117 @@
+import { useCallback, useEffect, useMemo, useRef, useSyncExternalStore } from "react";
+import { LineFlowValidationError } from "../errors.js";
+import { defaultEquals, validateListener } from "../utils.js";
+/**
+ * Subscribes to a LineFlow readable line (StateLine or DerivedLine) and returns its current snapshot.
+ * Synchronizes with React's concurrent renderer using useSyncExternalStore.
+ */
+export function useLineFlowValue(line) {
+    if (!line || typeof line.getSnapshot !== "function" || typeof line.subscribe !== "function") {
+        throw new LineFlowValidationError("useLineFlowValue requires a valid readable line.");
+    }
+    const subscribe = useCallback((onStoreChange) => line.subscribe(onStoreChange), [line]);
+    const getSnapshot = useCallback(() => line.getSnapshot(), [line]);
+    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+/**
+ * Subscribes to a slice of state from a readable line using a selector function.
+ * Prevents unnecessary re-renders when the selected value is unchanged according to the equality function.
+ *
+ * Implements the canonical closure-based memoization pattern to guarantee stability across
+ * concurrent renders, StrictMode checks, and inline selector re-creations without render-phase ref mutations.
+ */
+export function useLineFlowSelector(line, selector, equals = defaultEquals) {
+    if (!line || typeof line.getSnapshot !== "function" || typeof line.subscribe !== "function") {
+        throw new LineFlowValidationError("useLineFlowSelector requires a valid readable line.");
+    }
+    if (typeof selector !== "function") {
+        throw new LineFlowValidationError("useLineFlowSelector requires a selector function.");
+    }
+    const instRef = useRef(null);
+    let inst;
+    if (instRef.current === null) {
+        inst = {
+            hasValue: false,
+            value: null,
+        };
+        instRef.current = inst;
+    }
+    else {
+        inst = instRef.current;
+    }
+    const [getSelection, getServerSelection] = useMemo(() => {
+        let hasMemo = false;
+        let memoizedSnapshot;
+        let memoizedSelection;
+        const memoizedSelector = (nextSnapshot) => {
+            if (!hasMemo) {
+                hasMemo = true;
+                memoizedSnapshot = nextSnapshot;
+                const nextSelection = selector(nextSnapshot);
+                if (equals !== undefined && inst.hasValue) {
+                    const currentSelection = inst.value;
+                    if (equals(currentSelection, nextSelection)) {
+                        memoizedSelection = currentSelection;
+                        return currentSelection;
+                    }
+                }
+                memoizedSelection = nextSelection;
+                return nextSelection;
+            }
+            const prevSnapshot = memoizedSnapshot;
+            const prevSelection = memoizedSelection;
+            if (Object.is(prevSnapshot, nextSnapshot)) {
+                return prevSelection;
+            }
+            const nextSelection = selector(nextSnapshot);
+            if (equals !== undefined && equals(prevSelection, nextSelection)) {
+                memoizedSnapshot = nextSnapshot;
+                return prevSelection;
+            }
+            memoizedSnapshot = nextSnapshot;
+            memoizedSelection = nextSelection;
+            return nextSelection;
+        };
+        const getSnapshotWithSelector = () => memoizedSelector(line.getSnapshot());
+        return [getSnapshotWithSelector, getSnapshotWithSelector];
+    }, [line, selector, equals]);
+    const subscribe = useCallback((onStoreChange) => line.subscribe(onStoreChange), [line]);
+    const value = useSyncExternalStore(subscribe, getSelection, getServerSelection);
+    useEffect(() => {
+        inst.hasValue = true;
+        inst.value = value;
+    }, [value]);
+    return value;
+}
+/**
+ * Returns stable updater functions { set, update } for a StateLine.
+ * Unlike useLineFlowValue, using this hook does NOT subscribe the component to state changes,
+ * preventing re-renders when the line value updates.
+ */
+export function useLineFlowSet(line) {
+    if (!line || typeof line.set !== "function") {
+        throw new LineFlowValidationError("useLineFlowSet requires a valid StateLine.");
+    }
+    const set = useCallback((value) => line.set(value), [line]);
+    const update = useCallback((updater) => line.update(updater), [line]);
+    return useMemo(() => ({ set, update }), [set, update]);
+}
+/**
+ * Subscribes to events published on an EventLine.
+ * Automatically cleans up the subscription on unmount or when the line changes.
+ * Preserves fresh listener callback identity without causing resubscription.
+ */
+export function useLineFlowEvent(line, listener) {
+    if (!line || typeof line.subscribe !== "function") {
+        throw new LineFlowValidationError("useLineFlowEvent requires a valid EventLine.");
+    }
+    validateListener(listener);
+    const listenerRef = useRef(listener);
+    listenerRef.current = listener;
+    useEffect(() => {
+        return line.subscribe((event) => {
+            listenerRef.current(event);
+        });
+    }, [line]);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/line-flow/react/hooks.js.map

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

package/dist/line-flow/react/index.d.ts

@@ -0,0 +1,3 @@
+export { LineFlowProvider, LineFlowProvider as LineflowProvider, useLineFlowNetwork, useLineFlowNetwork as useLineflowNetwork, type LineFlowProviderProps, type LineFlowProviderProps as LineflowProviderProps, } from "./provider.js";
+export { useLineFlowValue, useLineFlowValue as useLineflowValue, useLineFlowSelector, useLineFlowSelector as useLineflowSelector, useLineFlowSet, useLineFlowSet as useLineflowSet, useLineFlowEvent, useLineFlowEvent as useLineflowEvent, } from "./hooks.js";
+export { useProviderBridge, ProviderBridge, type ProviderBridgeOptions, type ProviderBridgeProps, } from "./bridge.js";

package/dist/line-flow/react/index.js

@@ -0,0 +1,4 @@
+export { LineFlowProvider, LineFlowProvider as LineflowProvider, useLineFlowNetwork, useLineFlowNetwork as useLineflowNetwork, } from "./provider.js";
+export { useLineFlowValue, useLineFlowValue as useLineflowValue, useLineFlowSelector, useLineFlowSelector as useLineflowSelector, useLineFlowSet, useLineFlowSet as useLineflowSet, useLineFlowEvent, useLineFlowEvent as useLineflowEvent, } from "./hooks.js";
+export { useProviderBridge, ProviderBridge, } from "./bridge.js";
+//# sourceMappingURL=index.js.map

package/dist/line-flow/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/line-flow/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,gBAAgB,IAAI,gBAAgB,EACpC,kBAAkB,EAClB,kBAAkB,IAAI,kBAAkB,GAGzC,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,IAAI,gBAAgB,EACpC,mBAAmB,EACnB,mBAAmB,IAAI,mBAAmB,EAC1C,cAAc,EACd,cAAc,IAAI,cAAc,EAChC,gBAAgB,EAChB,gBAAgB,IAAI,gBAAgB,GACrC,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,cAAc,GAGf,MAAM,aAAa,CAAC"}

package/dist/line-flow/react/provider.d.ts

@@ -0,0 +1,15 @@
+import React, { type ReactNode } from "react";
+import type { LineFlowNetwork } from "../types.js";
+export interface LineFlowProviderProps {
+    network: LineFlowNetwork;
+    children: ReactNode;
+}
+/**
+ * LineFlowProvider makes a LineFlowNetwork instance available to all descendant components.
+ */
+export declare function LineFlowProvider({ network, children, }: LineFlowProviderProps): React.JSX.Element;
+/**
+ * Hook to access the current LineFlowNetwork from context.
+ * Throws LineFlowProviderNotFoundError if called outside a LineFlowProvider.
+ */
+export declare function useLineFlowNetwork(): LineFlowNetwork;

package/dist/line-flow/react/provider.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+import { LineFlowProviderNotFoundError, LineFlowValidationError } from "../errors.js";
+const LineFlowContext = createContext(null);
+/**
+ * LineFlowProvider makes a LineFlowNetwork instance available to all descendant components.
+ */
+export function LineFlowProvider({ network, children, }) {
+    if (!network || typeof network.stateLine !== "function") {
+        throw new LineFlowValidationError("LineFlowProvider requires a valid LineFlowNetwork instance passed via the 'network' prop.");
+    }
+    return (_jsx(LineFlowContext.Provider, { value: network, children: children }));
+}
+/**
+ * Hook to access the current LineFlowNetwork from context.
+ * Throws LineFlowProviderNotFoundError if called outside a LineFlowProvider.
+ */
+export function useLineFlowNetwork() {
+    const network = useContext(LineFlowContext);
+    if (!network) {
+        throw new LineFlowProviderNotFoundError();
+    }
+    return network;
+}
+//# sourceMappingURL=provider.js.map

package/dist/line-flow/react/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/line-flow/react/provider.tsx"],"names":[],"mappings":";AAAA,OAAc,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,OAAO,CAAC;AACzE,OAAO,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAGtF,MAAM,eAAe,GAAG,aAAa,CAAyB,IAAI,CAAC,CAAC;AAOpE;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,OAAO,EACP,QAAQ,GACc;IACtB,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QACxD,MAAM,IAAI,uBAAuB,CAC/B,2FAA2F,CAC5F,CAAC;IACJ,CAAC;IAED,OAAO,CACL,KAAC,eAAe,CAAC,QAAQ,IAAC,KAAK,EAAE,OAAO,YACrC,QAAQ,GACgB,CAC5B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,6BAA6B,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/line-flow/scope.d.ts

@@ -0,0 +1,21 @@
+import type { AnyStateLine, Bus, BusOptions, DerivedLine, DeriveLineOptions, Disposable, EventLine, EventLineOptions, LineFlowNetwork, Scope, ScopeOptions, StateLine, StateLineOptions, Taxi, TaxiOptions, TaskContract, TaxiTaskMap, Unsubscribe } from "./types.js";
+export declare class ScopeImpl implements Scope {
+    readonly id: string;
+    private readonly _network;
+    private readonly _disposables;
+    private readonly _childScopes;
+    private _isDisposed;
+    private readonly _onDispose?;
+    constructor(network: LineFlowNetwork, options?: ScopeOptions, onDispose?: () => void);
+    get isDisposed(): boolean;
+    registerDisposable(disposable: Disposable): Unsubscribe;
+    stateLine<T>(options: StateLineOptions<T>): StateLine<T>;
+    eventLine<T = void>(options: EventLineOptions<T>): EventLine<T>;
+    deriveLine<T, const TDeps extends readonly AnyStateLine[]>(options: DeriveLineOptions<T, TDeps>): DerivedLine<T>;
+    bus<TMessageMap extends object = Record<string, unknown>>(options?: BusOptions): Bus<TMessageMap>;
+    taxi<TTaskMap extends {
+        [K in keyof TTaskMap]: TaskContract;
+    } = TaxiTaskMap>(options?: TaxiOptions): Taxi<TTaskMap>;
+    createChildScope(id: string): Scope;
+    dispose(): void;
+}

package/dist/line-flow/scope.js

@@ -0,0 +1,157 @@
+import { LineFlowDisposedError, LineFlowDuplicateIdError, LineFlowValidationError } from "./errors.js";
+import { validateId } from "./utils.js";
+export class ScopeImpl {
+    id;
+    _network;
+    _disposables = new Set();
+    _childScopes = new Map();
+    _isDisposed = false;
+    _onDispose;
+    constructor(network, options, onDispose) {
+        this._network = network;
+        this.id = options?.id ? validateId(options.id, "scope") : `scope:${Math.random().toString(36).slice(2, 9)}`;
+        this._onDispose = onDispose;
+    }
+    get isDisposed() {
+        return this._isDisposed;
+    }
+    registerDisposable(disposable) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot register disposable on disposed scope "${this.id}".`, this.id);
+        }
+        if (!disposable) {
+            throw new LineFlowValidationError("Disposable must be defined.");
+        }
+        let disposeFn;
+        if (typeof disposable === "function") {
+            disposeFn = disposable;
+        }
+        else if (typeof disposable === "object" && typeof disposable.dispose === "function") {
+            disposeFn = () => disposable.dispose();
+        }
+        else {
+            throw new LineFlowValidationError("Disposable must be a function or an object with a dispose() method.");
+        }
+        this._disposables.add(disposeFn);
+        let removed = false;
+        return () => {
+            if (removed)
+                return;
+            removed = true;
+            this._disposables.delete(disposeFn);
+        };
+    }
+    stateLine(options) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot create state line in disposed scope "${this.id}".`, this.id);
+        }
+        const line = this._network.stateLine(options);
+        const unregister = this.registerDisposable(() => {
+            line.dispose();
+        });
+        // If the line is independently disposed, remove from scope disposables
+        const origDispose = line.dispose.bind(line);
+        line.dispose = () => {
+            unregister();
+            origDispose();
+        };
+        return line;
+    }
+    eventLine(options) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot create event line in disposed scope "${this.id}".`, this.id);
+        }
+        const line = this._network.eventLine(options);
+        const unregister = this.registerDisposable(() => {
+            line.dispose();
+        });
+        const origDispose = line.dispose.bind(line);
+        line.dispose = () => {
+            unregister();
+            origDispose();
+        };
+        return line;
+    }
+    deriveLine(options) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot create derived line in disposed scope "${this.id}".`, this.id);
+        }
+        const line = this._network.deriveLine(options);
+        const unregister = this.registerDisposable(() => {
+            line.dispose();
+        });
+        const origDispose = line.dispose.bind(line);
+        line.dispose = () => {
+            unregister();
+            origDispose();
+        };
+        return line;
+    }
+    bus(options) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot create bus in disposed scope "${this.id}".`, this.id);
+        }
+        const busInstance = this._network.bus(options);
+        const unregister = this.registerDisposable(() => {
+            busInstance.dispose();
+        });
+        const origDispose = busInstance.dispose.bind(busInstance);
+        busInstance.dispose = () => {
+            unregister();
+            origDispose();
+        };
+        return busInstance;
+    }
+    taxi(options) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot create taxi in disposed scope "${this.id}".`, this.id);
+        }
+        const taxiInstance = this._network.taxi(options);
+        const unregister = this.registerDisposable(() => {
+            taxiInstance.dispose();
+        });
+        const origDispose = taxiInstance.dispose.bind(taxiInstance);
+        taxiInstance.dispose = () => {
+            unregister();
+            origDispose();
+        };
+        return taxiInstance;
+    }
+    createChildScope(id) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot create child scope in disposed parent scope "${this.id}".`, this.id);
+        }
+        validateId(id, "child scope");
+        if (this._childScopes.has(id)) {
+            throw new LineFlowDuplicateIdError(id, "child scope");
+        }
+        const child = new ScopeImpl(this._network, { id }, () => {
+            this._childScopes.delete(id);
+        });
+        this._childScopes.set(id, child);
+        return child;
+    }
+    dispose() {
+        if (this._isDisposed)
+            return;
+        this._isDisposed = true;
+        // Dispose all child scopes first
+        for (const child of Array.from(this._childScopes.values())) {
+            child.dispose();
+        }
+        this._childScopes.clear();
+        // Dispose all registered resources
+        const list = Array.from(this._disposables);
+        this._disposables.clear();
+        for (const disposeFn of list) {
+            try {
+                disposeFn();
+            }
+            catch {
+                // Continue disposing remaining resources
+            }
+        }
+        this._onDispose?.();
+    }
+}
+//# sourceMappingURL=scope.js.map

package/dist/line-flow/scope.js.map

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

package/dist/line-flow/state-line.d.ts

@@ -0,0 +1,21 @@
+import type { Listener, StateLine, StateLineOptions, Unsubscribe } from "./types.js";
+export declare class StateLineImpl<T> implements StateLine<T> {
+    readonly id: string;
+    readonly kind: "state";
+    private _snapshot;
+    private readonly _equals;
+    private readonly _listeners;
+    private _isDisposed;
+    private readonly _onDispose?;
+    private _isDispatching;
+    private readonly _pendingSnapshots;
+    private static readonly MAX_DISPATCH_CYCLES;
+    constructor(options: StateLineOptions<T>, onDispose?: () => void);
+    get isDisposed(): boolean;
+    getSnapshot(): T;
+    private _commitAndNotify;
+    set(value: T): void;
+    update(updater: (prev: T) => T): void;
+    subscribe(listener: Listener<T>): Unsubscribe;
+    dispose(): void;
+}

package/dist/line-flow/state-line.js

@@ -0,0 +1,106 @@
+import { LineFlowDisposedError, LineFlowSubscriberError, LineFlowValidationError, } from "./errors.js";
+import { defaultEquals, notifyListeners, validateId, validateListener } from "./utils.js";
+export class StateLineImpl {
+    id;
+    kind = "state";
+    _snapshot;
+    _equals;
+    _listeners = new Set();
+    _isDisposed = false;
+    _onDispose;
+    _isDispatching = false;
+    _pendingSnapshots = [];
+    static MAX_DISPATCH_CYCLES = 1000;
+    constructor(options, onDispose) {
+        this.id = validateId(options?.id, "state line");
+        this._snapshot = options.initialValue;
+        this._equals = options.equals ?? defaultEquals;
+        this._onDispose = onDispose;
+    }
+    get isDisposed() {
+        return this._isDisposed;
+    }
+    getSnapshot() {
+        return this._snapshot;
+    }
+    _commitAndNotify(next) {
+        if (this._equals(this._snapshot, next)) {
+            return;
+        }
+        // Commit snapshot before notifying
+        this._snapshot = next;
+        this._pendingSnapshots.push(next);
+        if (this._isDispatching) {
+            return;
+        }
+        this._isDispatching = true;
+        const aggregatedErrors = [];
+        let cycles = 0;
+        try {
+            while (this._pendingSnapshots.length > 0 && !this._isDisposed) {
+                cycles++;
+                if (cycles > StateLineImpl.MAX_DISPATCH_CYCLES) {
+                    throw new LineFlowValidationError(`Maximum re-entrant dispatch depth exceeded on state line "${this.id}". Possible infinite update loop.`);
+                }
+                const snapshotToDispatch = this._pendingSnapshots.shift();
+                try {
+                    notifyListeners(this._listeners, snapshotToDispatch, `state line "${this.id}" update`);
+                }
+                catch (err) {
+                    if (err instanceof LineFlowSubscriberError) {
+                        aggregatedErrors.push(...err.errors);
+                    }
+                    else {
+                        aggregatedErrors.push(err);
+                    }
+                }
+            }
+        }
+        finally {
+            this._isDispatching = false;
+            this._pendingSnapshots.length = 0;
+        }
+        if (aggregatedErrors.length > 0) {
+            throw new LineFlowSubscriberError(`Error(s) encountered in subscriber(s) during state line "${this.id}" update`, aggregatedErrors);
+        }
+    }
+    set(value) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot call set() on disposed state line "${this.id}".`, this.id);
+        }
+        this._commitAndNotify(value);
+    }
+    update(updater) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot call update() on disposed state line "${this.id}".`, this.id);
+        }
+        if (typeof updater !== "function") {
+            throw new LineFlowValidationError(`update() on state line "${this.id}" requires an updater function.`);
+        }
+        const next = updater(this._snapshot);
+        this._commitAndNotify(next);
+    }
+    subscribe(listener) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot subscribe to disposed state line "${this.id}".`, this.id);
+        }
+        validateListener(listener);
+        this._listeners.add(listener);
+        let unsubscribed = false;
+        return () => {
+            if (unsubscribed)
+                return;
+            unsubscribed = true;
+            this._listeners.delete(listener);
+        };
+    }
+    dispose() {
+        if (this._isDisposed)
+            return;
+        this._isDisposed = true;
+        this._pendingSnapshots.length = 0;
+        this._listeners.clear();
+        this._onDispose?.();
+    }
+}
+//# sourceMappingURL=state-line.js.map

package/dist/line-flow/state-line.js.map

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

package/dist/line-flow/taxi.d.ts

@@ -0,0 +1,15 @@
+import type { Taxi, TaxiHandler, TaxiOptions, TaxiTaskMap, Unsubscribe } from "./types.js";
+export declare class TaxiImpl<TTaskMap extends TaxiTaskMap = TaxiTaskMap> implements Taxi<TTaskMap> {
+    readonly id: string;
+    private readonly _handlers;
+    private _isDisposed;
+    private readonly _onDispose?;
+    constructor(options?: TaxiOptions, onDispose?: () => void);
+    get isDisposed(): boolean;
+    register<K extends keyof TTaskMap & string>(task: K, handler: TaxiHandler<TTaskMap[K]["request"], TTaskMap[K]["response"]>): Unsubscribe;
+    request<K extends keyof TTaskMap & string>(task: K, req: TTaskMap[K]["request"], options?: {
+        signal?: AbortSignal;
+    }): Promise<TTaskMap[K]["response"]>;
+    hasHandler<K extends keyof TTaskMap & string>(task: K): boolean;
+    dispose(): void;
+}

package/dist/line-flow/taxi.js

@@ -0,0 +1,81 @@
+import { LineFlowDisposedError, LineFlowDuplicateHandlerError, LineFlowMissingHandlerError, LineFlowValidationError, } from "./errors.js";
+import { validateId } from "./utils.js";
+export class TaxiImpl {
+    id;
+    _handlers = new Map();
+    _isDisposed = false;
+    _onDispose;
+    constructor(options, onDispose) {
+        this.id = options?.id ? validateId(options.id, "taxi") : `taxi:${Math.random().toString(36).slice(2, 9)}`;
+        this._onDispose = onDispose;
+    }
+    get isDisposed() {
+        return this._isDisposed;
+    }
+    register(task, handler) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot register handler on disposed Taxi "${this.id}".`, this.id);
+        }
+        validateId(task, "task");
+        if (typeof handler !== "function") {
+            throw new LineFlowValidationError(`Handler for Taxi task "${task}" must be a function.`);
+        }
+        if (this._handlers.has(task)) {
+            throw new LineFlowDuplicateHandlerError(task);
+        }
+        this._handlers.set(task, handler);
+        let unregistered = false;
+        return () => {
+            if (unregistered)
+                return;
+            unregistered = true;
+            if (this._handlers.get(task) === handler) {
+                this._handlers.delete(task);
+            }
+        };
+    }
+    async request(task, req, options) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot request task from disposed Taxi "${this.id}".`, this.id);
+        }
+        validateId(task, "task");
+        const signal = options?.signal;
+        if (signal?.aborted) {
+            throw signal.reason ?? new Error("The operation was aborted.");
+        }
+        const handler = this._handlers.get(task);
+        if (!handler) {
+            throw new LineFlowMissingHandlerError(task);
+        }
+        if (!signal) {
+            return handler(req);
+        }
+        // Handle AbortSignal race
+        return new Promise((resolve, reject) => {
+            const onAbort = () => {
+                reject(signal.reason ?? new Error("The operation was aborted."));
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+            Promise.resolve()
+                .then(() => handler(req, signal))
+                .then((result) => {
+                signal.removeEventListener("abort", onAbort);
+                resolve(result);
+            }, (err) => {
+                signal.removeEventListener("abort", onAbort);
+                reject(err);
+            });
+        });
+    }
+    hasHandler(task) {
+        return this._handlers.has(task);
+    }
+    dispose() {
+        if (this._isDisposed)
+            return;
+        this._isDisposed = true;
+        this._handlers.clear();
+        this._onDispose?.();
+    }
+}
+//# sourceMappingURL=taxi.js.map