@gostack-framework/react 0.0.0-stage → 0.1.0

package/dist/line-flow/errors.js

@@ -0,0 +1,91 @@
+/**
+ * Base class for all LineFlow errors.
+ */
+export class LineFlowError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = this.constructor.name;
+        this.code = code;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/**
+ * Thrown when an ID is already registered within a network.
+ */
+export class LineFlowDuplicateIdError extends LineFlowError {
+    id;
+    constructor(id, entity = "line") {
+        super(`LineFlow ${entity} with ID "${id}" is already registered in this network.`, "ERR_LINEFLOW_DUPLICATE_ID");
+        this.id = id;
+    }
+}
+/**
+ * Thrown when an operation is performed on a disposed line, scope, or network.
+ */
+export class LineFlowDisposedError extends LineFlowError {
+    targetId;
+    constructor(message, targetId) {
+        super(message, "ERR_LINEFLOW_DISPOSED");
+        this.targetId = targetId;
+    }
+}
+/**
+ * Thrown when one or more subscribers throw errors during notification dispatch.
+ */
+export class LineFlowSubscriberError extends LineFlowError {
+    errors;
+    constructor(message, errors) {
+        super(`${message} (${errors.length} error${errors.length === 1 ? "" : "s"} occurred).`, "ERR_LINEFLOW_SUBSCRIBER_ERROR");
+        this.errors = Object.freeze([...errors]);
+    }
+}
+/**
+ * Thrown when runtime input validation fails.
+ */
+export class LineFlowValidationError extends LineFlowError {
+    constructor(message) {
+        super(message, "ERR_LINEFLOW_VALIDATION");
+    }
+}
+/**
+ * Thrown when a Taxi request cannot find a registered handler for the task.
+ */
+export class LineFlowMissingHandlerError extends LineFlowError {
+    task;
+    constructor(task) {
+        super(`No handler registered for Taxi task "${task}".`, "ERR_LINEFLOW_MISSING_HANDLER");
+        this.task = task;
+    }
+}
+/**
+ * Thrown when attempting to register a duplicate handler for a Taxi task.
+ */
+export class LineFlowDuplicateHandlerError extends LineFlowError {
+    task;
+    constructor(task) {
+        super(`A handler is already registered for Taxi task "${task}".`, "ERR_LINEFLOW_DUPLICATE_HANDLER");
+        this.task = task;
+    }
+}
+/**
+ * Thrown when a React hook requiring a LineFlowProvider is called outside one.
+ */
+export class LineFlowProviderNotFoundError extends LineFlowError {
+    constructor() {
+        super("LineFlow React hook called outside a LineFlowProvider. Wrap your component tree in <LineFlowProvider network={network}> or pass a network explicitly.", "ERR_LINEFLOW_PROVIDER_NOT_FOUND");
+    }
+}
+/**
+ * Thrown when a circular dependency is detected among derived lines.
+ */
+export class LineFlowCycleError extends LineFlowError {
+    cycle;
+    constructor(cycle) {
+        super(`Circular dependency detected in derived lines: ${cycle.join(" -> ")}`, "ERR_LINEFLOW_CYCLE");
+        this.cycle = Object.freeze([...cycle]);
+    }
+}
+// Backward-compatibility aliases
+export { LineFlowError as LineflowError, LineFlowDuplicateIdError as LineflowDuplicateIdError, LineFlowDisposedError as LineflowDisposedError, LineFlowSubscriberError as LineflowSubscriberError, LineFlowValidationError as LineflowValidationError, LineFlowMissingHandlerError as LineflowMissingHandlerError, LineFlowDuplicateHandlerError as LineflowDuplicateHandlerError, LineFlowProviderNotFoundError as LineflowProviderNotFoundError, LineFlowCycleError as LineflowCycleError, };
+//# sourceMappingURL=errors.js.map

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

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

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

@@ -0,0 +1,16 @@
+import type { EventLine, EventLineOptions, Listener, Unsubscribe } from "./types.js";
+export declare class EventLineImpl<T> implements EventLine<T> {
+    readonly id: string;
+    readonly kind: "event";
+    private readonly _listeners;
+    private _isDisposed;
+    private readonly _onDispose?;
+    private _isDispatching;
+    private readonly _eventQueue;
+    private static readonly MAX_DISPATCH_CYCLES;
+    constructor(options: EventLineOptions<T>, onDispose?: () => void);
+    get isDisposed(): boolean;
+    publish(event: T): void;
+    subscribe(listener: Listener<T>): Unsubscribe;
+    dispose(): void;
+}

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

@@ -0,0 +1,81 @@
+import { LineFlowDisposedError, LineFlowSubscriberError, LineFlowValidationError, } from "./errors.js";
+import { notifyListeners, validateId, validateListener } from "./utils.js";
+export class EventLineImpl {
+    id;
+    kind = "event";
+    _listeners = new Set();
+    _isDisposed = false;
+    _onDispose;
+    _isDispatching = false;
+    _eventQueue = [];
+    static MAX_DISPATCH_CYCLES = 1000;
+    constructor(options, onDispose) {
+        this.id = validateId(options?.id, "event line");
+        this._onDispose = onDispose;
+    }
+    get isDisposed() {
+        return this._isDisposed;
+    }
+    publish(event) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot publish to disposed event line "${this.id}".`, this.id);
+        }
+        this._eventQueue.push(event);
+        if (this._isDispatching) {
+            return;
+        }
+        this._isDispatching = true;
+        const aggregatedErrors = [];
+        let cycles = 0;
+        try {
+            while (this._eventQueue.length > 0 && !this._isDisposed) {
+                cycles++;
+                if (cycles > EventLineImpl.MAX_DISPATCH_CYCLES) {
+                    throw new LineFlowValidationError(`Maximum re-entrant dispatch depth exceeded on event line "${this.id}". Possible infinite event loop.`);
+                }
+                const nextEvent = this._eventQueue.shift();
+                try {
+                    notifyListeners(this._listeners, nextEvent, `event line "${this.id}" dispatch`);
+                }
+                catch (err) {
+                    if (err instanceof LineFlowSubscriberError) {
+                        aggregatedErrors.push(...err.errors);
+                    }
+                    else {
+                        aggregatedErrors.push(err);
+                    }
+                }
+            }
+        }
+        finally {
+            this._isDispatching = false;
+            this._eventQueue.length = 0;
+        }
+        if (aggregatedErrors.length > 0) {
+            throw new LineFlowSubscriberError(`Error(s) encountered in subscriber(s) during event line "${this.id}" dispatch`, aggregatedErrors);
+        }
+    }
+    subscribe(listener) {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`Cannot subscribe to disposed event 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._eventQueue.length = 0;
+        this._listeners.clear();
+        this._onDispose?.();
+    }
+}
+//# sourceMappingURL=event-line.js.map

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

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

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

@@ -0,0 +1,11 @@
+export { createLineFlow, createLineflow } from "./lineflow.js";
+export { LineFlowNetworkImpl, LineflowNetworkImpl } from "./network.js";
+export { StateLineImpl } from "./state-line.js";
+export { EventLineImpl } from "./event-line.js";
+export { DerivedLineImpl } from "./derived-line.js";
+export { InterchangeImpl } from "./interchange.js";
+export { ScopeImpl } from "./scope.js";
+export { BusImpl } from "./bus.js";
+export { TaxiImpl } from "./taxi.js";
+export { LineFlowError, LineFlowDuplicateIdError, LineFlowDisposedError, LineFlowSubscriberError, LineFlowValidationError, LineFlowMissingHandlerError, LineFlowDuplicateHandlerError, LineFlowProviderNotFoundError, LineFlowCycleError, LineflowError, LineflowDuplicateIdError, LineflowDisposedError, LineflowSubscriberError, LineflowValidationError, LineflowMissingHandlerError, LineflowDuplicateHandlerError, LineflowProviderNotFoundError, LineflowCycleError, } from "./errors.js";
+export type { LineKind, EqualityFn, Unsubscribe, Listener, Disposable, ReadableLine, StateLine, EventLine, DerivedLine, AnyLine, AnyStateLine, LineSnapshot, LinesSnapshots, StateLineOptions, EventLineOptions, DeriveLineOptions, InterchangeOptions, Interchange, Bus, BusOptions, Taxi, TaxiOptions, TaxiHandler, TaskContract, TaxiTaskMap, Scope, ScopeOptions, LineFlowOptions, LineFlowNetwork, LineflowOptions, LineflowNetwork, } from "./types.js";

package/dist/line-flow/index.js

@@ -0,0 +1,11 @@
+export { createLineFlow, createLineflow } from "./lineflow.js";
+export { LineFlowNetworkImpl, LineflowNetworkImpl } from "./network.js";
+export { StateLineImpl } from "./state-line.js";
+export { EventLineImpl } from "./event-line.js";
+export { DerivedLineImpl } from "./derived-line.js";
+export { InterchangeImpl } from "./interchange.js";
+export { ScopeImpl } from "./scope.js";
+export { BusImpl } from "./bus.js";
+export { TaxiImpl } from "./taxi.js";
+export { LineFlowError, LineFlowDuplicateIdError, LineFlowDisposedError, LineFlowSubscriberError, LineFlowValidationError, LineFlowMissingHandlerError, LineFlowDuplicateHandlerError, LineFlowProviderNotFoundError, LineFlowCycleError, LineflowError, LineflowDuplicateIdError, LineflowDisposedError, LineflowSubscriberError, LineflowValidationError, LineflowMissingHandlerError, LineflowDuplicateHandlerError, LineflowProviderNotFoundError, LineflowCycleError, } from "./errors.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/line-flow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,6BAA6B,EAC7B,6BAA6B,EAC7B,kBAAkB,EAClB,aAAa,EACb,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,EAC3B,6BAA6B,EAC7B,6BAA6B,EAC7B,kBAAkB,GACnB,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { Interchange, InterchangeOptions } from "./types.js";
+export declare class InterchangeImpl<TSource, TTarget> implements Interchange {
+    readonly id: string;
+    private readonly _from;
+    private readonly _to;
+    private readonly _transform;
+    private readonly _equals;
+    private readonly _unsubscribe;
+    private _isDisposed;
+    private _isSyncing;
+    private readonly _onDispose?;
+    constructor(options: InterchangeOptions<TSource, TTarget>, onDispose?: () => void);
+    get isDisposed(): boolean;
+    private _sync;
+    dispose(): void;
+    private static hasDependency;
+}

package/dist/line-flow/interchange.js

@@ -0,0 +1,86 @@
+import { LineFlowCycleError, LineFlowValidationError } from "./errors.js";
+import { defaultEquals, validateId } from "./utils.js";
+export class InterchangeImpl {
+    id;
+    _from;
+    _to;
+    _transform;
+    _equals;
+    _unsubscribe;
+    _isDisposed = false;
+    _isSyncing = false;
+    _onDispose;
+    constructor(options, onDispose) {
+        if (!options || typeof options !== "object") {
+            throw new LineFlowValidationError("Interchange options must be provided.");
+        }
+        if (!options.from ||
+            typeof options.from !== "object" ||
+            typeof options.from.subscribe !== "function" ||
+            typeof options.from.getSnapshot !== "function") {
+            throw new LineFlowValidationError("Interchange requires a valid source readable line.");
+        }
+        if (!options.to ||
+            typeof options.to !== "object" ||
+            typeof options.to.set !== "function" ||
+            typeof options.to.getSnapshot !== "function") {
+            throw new LineFlowValidationError("Interchange requires a valid target state line.");
+        }
+        if (typeof options.transform !== "function") {
+            throw new LineFlowValidationError("Interchange requires a transform function.");
+        }
+        this.id = options.id ? validateId(options.id, "interchange") : `interchange:${options.from.id}->${options.to.id}`;
+        // Validate cycle prevention: target state line cannot be an upstream source of from line
+        if (InterchangeImpl.hasDependency(options.from, options.to.id)) {
+            throw new LineFlowCycleError([options.to.id, options.from.id, options.to.id]);
+        }
+        this._from = options.from;
+        this._to = options.to;
+        this._transform = options.transform;
+        this._equals = options.equals ?? defaultEquals;
+        this._onDispose = onDispose;
+        // Perform initial synchronization
+        this._sync();
+        // Subscribe to future updates from source
+        this._unsubscribe = this._from.subscribe(() => {
+            this._sync();
+        });
+    }
+    get isDisposed() {
+        return this._isDisposed;
+    }
+    _sync() {
+        if (this._isDisposed || this._to.isDisposed || this._isSyncing)
+            return;
+        this._isSyncing = true;
+        try {
+            const sourceVal = this._from.getSnapshot();
+            const targetVal = this._transform(sourceVal);
+            if (!this._equals(this._to.getSnapshot(), targetVal)) {
+                this._to.set(targetVal);
+            }
+        }
+        finally {
+            this._isSyncing = false;
+        }
+    }
+    dispose() {
+        if (this._isDisposed)
+            return;
+        this._isDisposed = true;
+        this._unsubscribe();
+        this._onDispose?.();
+    }
+    static hasDependency(line, targetId) {
+        if (line.id === targetId)
+            return true;
+        if ("sources" in line && Array.isArray(line.sources)) {
+            for (const upstream of line.sources) {
+                if (InterchangeImpl.hasDependency(upstream, targetId))
+                    return true;
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=interchange.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { LineFlowNetwork, LineFlowOptions } from "./types.js";
+/**
+ * Creates an isolated LineFlow network instance.
+ *
+ * @param options Configuration options including an optional network name.
+ * @returns An isolated LineFlowNetwork instance.
+ */
+export declare function createLineFlow(options?: LineFlowOptions): LineFlowNetwork;
+/**
+ * Backward compatibility alias for createLineFlow.
+ */
+export declare const createLineflow: typeof createLineFlow;

package/dist/line-flow/lineflow.js

@@ -0,0 +1,15 @@
+import { LineFlowNetworkImpl } from "./network.js";
+/**
+ * Creates an isolated LineFlow network instance.
+ *
+ * @param options Configuration options including an optional network name.
+ * @returns An isolated LineFlowNetwork instance.
+ */
+export function createLineFlow(options) {
+    return new LineFlowNetworkImpl(options);
+}
+/**
+ * Backward compatibility alias for createLineFlow.
+ */
+export const createLineflow = createLineFlow;
+//# sourceMappingURL=lineflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lineflow.js","sourceRoot":"","sources":["../../src/line-flow/lineflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,OAAO,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,cAAc,CAAC"}

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

@@ -0,0 +1,28 @@
+import type { AnyLine, AnyStateLine, Bus, BusOptions, DerivedLine, DeriveLineOptions, EventLine, EventLineOptions, Interchange, InterchangeOptions, LineFlowNetwork, LineFlowOptions, Scope, ScopeOptions, StateLine, StateLineOptions, Taxi, TaxiOptions, TaskContract, TaxiTaskMap } from "./types.js";
+export declare class LineFlowNetworkImpl implements LineFlowNetwork {
+    readonly name: string;
+    private readonly _lines;
+    private readonly _scopes;
+    private readonly _interchanges;
+    private readonly _buses;
+    private readonly _taxis;
+    private _isDisposed;
+    constructor(options?: LineFlowOptions);
+    get isDisposed(): boolean;
+    private _assertNotDisposed;
+    private _assertIdUnique;
+    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>;
+    createInterchange<TSource, TTarget>(options: InterchangeOptions<TSource, TTarget>): Interchange;
+    createScope(options?: ScopeOptions): Scope;
+    bus<TMessageMap extends object = Record<string, unknown>>(options?: BusOptions): Bus<TMessageMap>;
+    taxi<TTaskMap extends {
+        [K in keyof TTaskMap]: TaskContract;
+    } = TaxiTaskMap>(options?: TaxiOptions): Taxi<TTaskMap>;
+    getLine(id: string): AnyLine | undefined;
+    hasLine(id: string): boolean;
+    getAllLines(): readonly AnyLine[];
+    dispose(): void;
+}
+export declare const LineflowNetworkImpl: typeof LineFlowNetworkImpl;

package/dist/line-flow/network.js

@@ -0,0 +1,165 @@
+import { BusImpl } from "./bus.js";
+import { DerivedLineImpl } from "./derived-line.js";
+import { LineFlowDisposedError, LineFlowDuplicateIdError } from "./errors.js";
+import { EventLineImpl } from "./event-line.js";
+import { InterchangeImpl } from "./interchange.js";
+import { ScopeImpl } from "./scope.js";
+import { StateLineImpl } from "./state-line.js";
+import { TaxiImpl } from "./taxi.js";
+import { validateId } from "./utils.js";
+export class LineFlowNetworkImpl {
+    name;
+    _lines = new Map();
+    _scopes = new Map();
+    _interchanges = new Map();
+    _buses = new Map();
+    _taxis = new Map();
+    _isDisposed = false;
+    constructor(options) {
+        this.name = options?.name ?? "default";
+    }
+    get isDisposed() {
+        return this._isDisposed;
+    }
+    _assertNotDisposed() {
+        if (this._isDisposed) {
+            throw new LineFlowDisposedError(`LineFlowNetwork "${this.name}" is disposed.`);
+        }
+    }
+    _assertIdUnique(id) {
+        if (this._lines.has(id)) {
+            throw new LineFlowDuplicateIdError(id, "line");
+        }
+    }
+    stateLine(options) {
+        this._assertNotDisposed();
+        validateId(options?.id, "state line");
+        this._assertIdUnique(options.id);
+        const line = new StateLineImpl(options, () => {
+            this._lines.delete(options.id);
+        });
+        this._lines.set(options.id, line);
+        return line;
+    }
+    eventLine(options) {
+        this._assertNotDisposed();
+        validateId(options?.id, "event line");
+        this._assertIdUnique(options.id);
+        const line = new EventLineImpl(options, () => {
+            this._lines.delete(options.id);
+        });
+        this._lines.set(options.id, line);
+        return line;
+    }
+    deriveLine(options) {
+        this._assertNotDisposed();
+        validateId(options?.id, "derived line");
+        this._assertIdUnique(options.id);
+        const line = new DerivedLineImpl(options, () => {
+            this._lines.delete(options.id);
+        });
+        this._lines.set(options.id, line);
+        return line;
+    }
+    createInterchange(options) {
+        this._assertNotDisposed();
+        if (options?.id) {
+            validateId(options.id, "interchange");
+            if (this._interchanges.has(options.id)) {
+                throw new LineFlowDuplicateIdError(options.id, "interchange");
+            }
+        }
+        const interchange = new InterchangeImpl(options, () => {
+            this._interchanges.delete(interchange.id);
+        });
+        if (this._interchanges.has(interchange.id)) {
+            throw new LineFlowDuplicateIdError(interchange.id, "interchange");
+        }
+        this._interchanges.set(interchange.id, interchange);
+        return interchange;
+    }
+    createScope(options) {
+        this._assertNotDisposed();
+        if (options?.id) {
+            validateId(options.id, "scope");
+            if (this._scopes.has(options.id)) {
+                throw new LineFlowDuplicateIdError(options.id, "scope");
+            }
+        }
+        const scope = new ScopeImpl(this, options, () => {
+            this._scopes.delete(scope.id);
+        });
+        this._scopes.set(scope.id, scope);
+        return scope;
+    }
+    bus(options) {
+        this._assertNotDisposed();
+        if (options?.id) {
+            validateId(options.id, "bus");
+            if (this._buses.has(options.id)) {
+                throw new LineFlowDuplicateIdError(options.id, "bus");
+            }
+        }
+        const busInstance = new BusImpl(options, () => {
+            this._buses.delete(busInstance.id);
+        });
+        this._buses.set(busInstance.id, busInstance);
+        return busInstance;
+    }
+    taxi(options) {
+        this._assertNotDisposed();
+        if (options?.id) {
+            validateId(options.id, "taxi");
+            if (this._taxis.has(options.id)) {
+                throw new LineFlowDuplicateIdError(options.id, "taxi");
+            }
+        }
+        const taxiInstance = new TaxiImpl(options, () => {
+            this._taxis.delete(taxiInstance.id);
+        });
+        this._taxis.set(taxiInstance.id, taxiInstance);
+        return taxiInstance;
+    }
+    getLine(id) {
+        return this._lines.get(id);
+    }
+    hasLine(id) {
+        return this._lines.has(id);
+    }
+    getAllLines() {
+        return Array.from(this._lines.values());
+    }
+    dispose() {
+        if (this._isDisposed)
+            return;
+        this._isDisposed = true;
+        // Dispose all active scopes
+        for (const scope of Array.from(this._scopes.values())) {
+            scope.dispose();
+        }
+        this._scopes.clear();
+        // Dispose all active interchanges
+        for (const interchange of Array.from(this._interchanges.values())) {
+            interchange.dispose();
+        }
+        this._interchanges.clear();
+        // Dispose all active buses
+        for (const busInstance of Array.from(this._buses.values())) {
+            busInstance.dispose();
+        }
+        this._buses.clear();
+        // Dispose all active taxis
+        for (const taxiInstance of Array.from(this._taxis.values())) {
+            taxiInstance.dispose();
+        }
+        this._taxis.clear();
+        // Dispose all registered lines
+        for (const line of Array.from(this._lines.values())) {
+            line.dispose();
+        }
+        this._lines.clear();
+    }
+}
+// Backward-compatibility alias
+export const LineflowNetworkImpl = LineFlowNetworkImpl;
+//# sourceMappingURL=network.js.map

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

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

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

@@ -0,0 +1,23 @@
+import { type ReactElement } from "react";
+import type { EqualityFn, StateLine } from "../types.js";
+export interface ProviderBridgeOptions<T> {
+    equals?: EqualityFn<T> | undefined;
+    resetOnUnmount?: T | undefined;
+}
+/**
+ * Directionally bridges a React Context value into a LineFlow StateLine.
+ *
+ * Synchronization occurs in the layout/commit phase to prevent render-phase side-effects.
+ * To prevent synchronization loops and redundant notifications, line.set is only invoked
+ * if the new Context value differs according to the specified equality policy.
+ */
+export declare function useProviderBridge<T>(line: StateLine<T>, value: T, options?: ProviderBridgeOptions<T>): void;
+export interface ProviderBridgeProps<T> extends ProviderBridgeOptions<T> {
+    line: StateLine<T>;
+    value: T;
+}
+/**
+ * Component representation of a Provider Bridge.
+ * Mount this component inside the source Context Provider to synchronize its value to a LineFlow StateLine.
+ */
+export declare function ProviderBridge<T>({ line, value, equals, resetOnUnmount, }: ProviderBridgeProps<T>): ReactElement | null;

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

@@ -0,0 +1,40 @@
+import { useEffect, useLayoutEffect } from "react";
+import { LineFlowValidationError } from "../errors.js";
+import { defaultEquals } from "../utils.js";
+const useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
+/**
+ * Directionally bridges a React Context value into a LineFlow StateLine.
+ *
+ * Synchronization occurs in the layout/commit phase to prevent render-phase side-effects.
+ * To prevent synchronization loops and redundant notifications, line.set is only invoked
+ * if the new Context value differs according to the specified equality policy.
+ */
+export function useProviderBridge(line, value, options) {
+    if (!line || typeof line.set !== "function" || typeof line.getSnapshot !== "function") {
+        throw new LineFlowValidationError("useProviderBridge requires a valid StateLine instance.");
+    }
+    const equals = options?.equals ?? defaultEquals;
+    const hasReset = options && "resetOnUnmount" in options;
+    const resetValue = options?.resetOnUnmount;
+    useIsomorphicLayoutEffect(() => {
+        if (!line.isDisposed && !equals(line.getSnapshot(), value)) {
+            line.set(value);
+        }
+    }, [line, value, equals]);
+    useEffect(() => {
+        return () => {
+            if (hasReset && !line.isDisposed) {
+                line.set(resetValue);
+            }
+        };
+    }, [line, hasReset, resetValue]);
+}
+/**
+ * Component representation of a Provider Bridge.
+ * Mount this component inside the source Context Provider to synchronize its value to a LineFlow StateLine.
+ */
+export function ProviderBridge({ line, value, equals, resetOnUnmount, }) {
+    useProviderBridge(line, value, { equals, resetOnUnmount });
+    return null;
+}
+//# sourceMappingURL=bridge.js.map