@czap/core 0.1.0

package/dist/video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video.js","sourceRoot":"","sources":["../src/video.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAI5D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAgChC,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,SAAS,KAAK,CACZ,MAAmB,EACnB,UAA4B,EAC5B,MAAoC;IAEpC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAEtD,OAAO;QACL,MAAM;QACN,WAAW;QACX,SAAS;QACT,KAAK,CAAC,CAAC,MAAM;YACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrC,SAAS,CAAC,IAAI,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC;gBAC1C,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;gBACzC,CAAC;gBACD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;gBACnD,MAAM;oBACJ,KAAK,EAAE,CAAC;oBACR,SAAS;oBACT,QAAQ,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBACrD,KAAK;iBACN,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,yFAAyF;IACzF,IAAI,EAAE,KAAK;CACZ,CAAC"}

package/dist/wasm-dispatch.d.ts

@@ -0,0 +1,52 @@
+/**
+ * WASM escape hatch -- capability detection, module loading, and dispatch.
+ *
+ * Detects WebAssembly availability, loads the czap-compute WASM module,
+ * and provides a unified kernel interface that transparently falls back
+ * to pure TypeScript implementations when WASM is unavailable.
+ *
+ * Usage:
+ *   const kernels = WASMDispatch.kernels();        // TS fallbacks
+ *   await WASMDispatch.load(wasmUrl);               // upgrade to WASM
+ *   const kernels2 = WASMDispatch.kernels();        // now WASM-backed
+ *
+ * @module
+ */
+/** Kernel functions available from both WASM and TS fallback. */
+export interface WASMKernels {
+    /**
+     * Sample a spring easing at `samples` evenly-spaced points in [0, 1].
+     * Returns Float32Array of length `samples + 1`.
+     */
+    springCurve(stiffness: number, damping: number, mass: number, samples: number): Float32Array;
+    /**
+     * Batch boundary evaluation. For each value, returns the index of the
+     * highest threshold where `value >= threshold`.
+     * Thresholds must be sorted ascending.
+     */
+    batchBoundaryEval(thresholds: Float64Array, values: Float64Array): Uint32Array;
+    /**
+     * Normalize weights in-place so positive values sum to 1.0.
+     * Negative weights clamped to 0. Returns the (modified) input array.
+     */
+    blendNormalize(weights: Float32Array): Float32Array;
+}
+/**
+ * Public API of the {@link WASMDispatch} singleton: probe for WebAssembly,
+ * asynchronously load the Rust compute module, and hand back either WASM or
+ * {@link fallbackKernels} via {@link WASMDispatchAPI.kernels}.
+ */
+export interface WASMDispatchAPI {
+    detect(): boolean;
+    load(wasmUrl: string | ArrayBuffer): Promise<WASMKernels>;
+    kernels(): WASMKernels;
+    isLoaded(): boolean;
+    unload(): void;
+}
+/**
+ * WASMDispatch — singleton that wires the Rust compute crate (spring, boundary,
+ * blend kernels) into the runtime, falling back to {@link fallbackKernels}
+ * when WebAssembly is unavailable or the module fails to load.
+ */
+export declare const WASMDispatch: WASMDispatchAPI;
+//# sourceMappingURL=wasm-dispatch.d.ts.map

package/dist/wasm-dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-dispatch.d.ts","sourceRoot":"","sources":["../src/wasm-dispatch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAAC;IAE7F;;;;OAIG;IACH,iBAAiB,CAAC,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,WAAW,CAAC;IAE/E;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,YAAY,CAAC;CACrD;AAgKD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,IAAI,OAAO,CAAC;IAClB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1D,OAAO,IAAI,WAAW,CAAC;IACvB,QAAQ,IAAI,OAAO,CAAC;IACpB,MAAM,IAAI,IAAI,CAAC;CAChB;AAOD;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,eA0E1B,CAAC"}

package/dist/wasm-dispatch.js

@@ -0,0 +1,204 @@
+/**
+ * WASM escape hatch -- capability detection, module loading, and dispatch.
+ *
+ * Detects WebAssembly availability, loads the czap-compute WASM module,
+ * and provides a unified kernel interface that transparently falls back
+ * to pure TypeScript implementations when WASM is unavailable.
+ *
+ * Usage:
+ *   const kernels = WASMDispatch.kernels();        // TS fallbacks
+ *   await WASMDispatch.load(wasmUrl);               // upgrade to WASM
+ *   const kernels2 = WASMDispatch.kernels();        // now WASM-backed
+ *
+ * @module
+ */
+import { fallbackKernels } from './wasm-fallback.js';
+import { WASM_SCRATCH_BASE } from './defaults.js';
+/**
+ * Runtime-verified cast from WebAssembly's opaque exports to the typed interface.
+ *
+ * `WebAssembly.Instance.exports` is structurally `Record<string, unknown>` — functions,
+ * memories, tables, and globals are all opaque at the type level. This helper
+ * asserts the expected functions are present as callable values and that the
+ * memory export is a WebAssembly.Memory instance, then narrows. If any required
+ * export is missing or the wrong shape, it throws — making the cast runtime-safe.
+ *
+ * This is a sanctioned cast containment point (cf. tuple.ts, cell.ts, boundary.ts,
+ * typed-ref.ts).
+ */
+const validateWASMExports = (exports) => {
+    const requiredFunctions = ['spring_curve', 'batch_boundary_eval', 'blend_normalize'];
+    for (const name of requiredFunctions) {
+        if (typeof exports[name] !== 'function') {
+            throw new Error(`WASM module missing required export: "${name}". Available exports: [${Object.keys(exports).join(', ')}]`);
+        }
+    }
+    const mem = exports['memory'];
+    const isMemoryShape = mem !== null &&
+        typeof mem === 'object' &&
+        'buffer' in mem &&
+        Reflect.get(mem, 'buffer') instanceof ArrayBuffer;
+    /* v8 ignore next 5 — sanctioned cast containment: the czap-compute WASM module always
+       exports `memory` as a WebAssembly.Memory (whose `.buffer` is an ArrayBuffer); this
+       guard exists only so the cast to WASMExports stays runtime-safe if a caller ever
+       supplies a drift/tampered module. Cannot be reached by valid instantiate output. */
+    if (!isMemoryShape) {
+        throw new Error(`WASM module missing required memory export. Available exports: [${Object.keys(exports).join(', ')}]`);
+    }
+    return exports;
+};
+/** Loaded WASM module state. */
+let wasmInstance = null;
+function wasmAvailable(available) {
+    return { status: 'ok', available };
+}
+function wasmUnavailable() {
+    return { status: 'unavailable' };
+}
+function wasmProbeError(error) {
+    return { status: 'error', error };
+}
+function probeWASMAvailability() {
+    try {
+        if (typeof WebAssembly === 'undefined') {
+            return wasmUnavailable();
+        }
+        return wasmAvailable(typeof WebAssembly.instantiate === 'function' && typeof WebAssembly.Module === 'function');
+    }
+    catch (error) {
+        return wasmProbeError(error);
+    }
+}
+function isWASMAvailable(probe) {
+    return probe.status === 'ok' ? probe.available : false;
+}
+// ---------------------------------------------------------------------------
+// WASM-backed kernel wrappers
+// ---------------------------------------------------------------------------
+function createWASMKernels(wasm) {
+    return {
+        springCurve(stiffness, damping, mass, samples) {
+            const count = Math.min(Math.max(0, samples | 0), 255);
+            const ptr = wasm.spring_curve(stiffness, damping, mass, count);
+            const view = new Float32Array(wasm.memory.buffer, ptr, count + 1);
+            return new Float32Array(view);
+        },
+        batchBoundaryEval(thresholds, values) {
+            const tLen = thresholds.length;
+            const vLen = values.length;
+            const SCRATCH_BASE = WASM_SCRATCH_BASE;
+            const thresholdsOffset = SCRATCH_BASE;
+            const valuesOffset = thresholdsOffset + tLen * 4;
+            const needed = valuesOffset + vLen * 4;
+            const currentSize = wasm.memory.buffer.byteLength;
+            if (needed > currentSize) {
+                const pages = Math.ceil((needed - currentSize) / 65536);
+                wasm.memory.grow(pages);
+            }
+            const threshF32 = new Float32Array(wasm.memory.buffer, thresholdsOffset, tLen);
+            for (let i = 0; i < tLen; i++) {
+                threshF32[i] = thresholds[i];
+            }
+            const valF32 = new Float32Array(wasm.memory.buffer, valuesOffset, vLen);
+            for (let i = 0; i < vLen; i++) {
+                valF32[i] = values[i];
+            }
+            const resultPtr = wasm.batch_boundary_eval(thresholdsOffset, tLen, valuesOffset, vLen);
+            const view = new Uint32Array(wasm.memory.buffer, resultPtr, vLen);
+            return new Uint32Array(view);
+        },
+        blendNormalize(weights) {
+            const len = weights.length;
+            if (len === 0)
+                return weights;
+            const SCRATCH_BASE = WASM_SCRATCH_BASE;
+            const needed = SCRATCH_BASE + len * 4;
+            const currentSize = wasm.memory.buffer.byteLength;
+            if (needed > currentSize) {
+                const pages = Math.ceil((needed - currentSize) / 65536);
+                wasm.memory.grow(pages);
+            }
+            const wasmWeights = new Float32Array(wasm.memory.buffer, SCRATCH_BASE, len);
+            wasmWeights.set(weights);
+            wasm.blend_normalize(SCRATCH_BASE, len);
+            const result = new Float32Array(wasm.memory.buffer, SCRATCH_BASE, len);
+            weights.set(result);
+            return weights;
+        },
+    };
+}
+let wasmKernels = null;
+let loadingPromise = null;
+let loadingToken = null;
+let loadSession = 0;
+/**
+ * WASMDispatch — singleton that wires the Rust compute crate (spring, boundary,
+ * blend kernels) into the runtime, falling back to {@link fallbackKernels}
+ * when WebAssembly is unavailable or the module fails to load.
+ */
+export const WASMDispatch = {
+    detect() {
+        return isWASMAvailable(probeWASMAvailability());
+    },
+    load(wasmUrl) {
+        if (!WASMDispatch.detect()) {
+            return Promise.reject(new Error('WebAssembly is not available in this environment'));
+        }
+        if (loadingPromise !== null) {
+            return loadingPromise;
+        }
+        const currentSession = ++loadSession;
+        const currentToken = {};
+        loadingToken = currentToken;
+        const promise = (async () => {
+            try {
+                let source;
+                if (typeof wasmUrl === 'string') {
+                    const response = await fetch(wasmUrl);
+                    if (!response.ok) {
+                        throw new Error(`Failed to fetch WASM module: ${response.status} ${response.statusText}`);
+                    }
+                    source = await response.arrayBuffer();
+                }
+                else {
+                    source = wasmUrl;
+                }
+                const { instance } = await WebAssembly.instantiate(source, {
+                    env: {},
+                });
+                wasmInstance = validateWASMExports(instance.exports);
+                wasmKernels = createWASMKernels(wasmInstance);
+                // If unload() ran while we were awaiting fetch/instantiate, it will
+                // bump the session and clear the just-installed WASM state.
+                if (loadSession !== currentSession) {
+                    wasmInstance = null;
+                    wasmKernels = null;
+                    return fallbackKernels;
+                }
+                return wasmKernels;
+            }
+            finally {
+                if (loadingToken === currentToken) {
+                    loadingPromise = null;
+                    loadingToken = null;
+                }
+            }
+        })();
+        loadingPromise = promise;
+        return promise;
+    },
+    kernels() {
+        return wasmKernels ?? fallbackKernels;
+    },
+    isLoaded() {
+        return wasmKernels !== null;
+    },
+    unload() {
+        loadSession += 1;
+        wasmInstance = null;
+        wasmKernels = null;
+        loadingPromise = null;
+        loadingToken = null;
+    },
+};
+//# sourceMappingURL=wasm-dispatch.js.map

package/dist/wasm-dispatch.js.map

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

package/dist/wasm-fallback.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Pure TypeScript fallback kernels for WASM compute functions.
+ *
+ * These produce bit-identical results (within float precision) to the
+ * Rust WASM kernels. When WASM is unavailable, these are used automatically.
+ *
+ * @module
+ */
+import type { WASMKernels } from './wasm-dispatch.js';
+/**
+ * Pure-JS implementation of the {@link WASMKernels} contract.
+ *
+ * Selected automatically by {@link WASMDispatch} when the Rust compute crate
+ * cannot be instantiated (e.g. missing `WebAssembly`, CSP restrictions, or
+ * startup failure). Produces results bit-identical to the WASM build within
+ * IEEE-754 precision limits.
+ */
+export declare const fallbackKernels: WASMKernels;
+//# sourceMappingURL=wasm-fallback.d.ts.map

package/dist/wasm-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasm-fallback.d.ts","sourceRoot":"","sources":["../src/wasm-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAgFtD;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,EAAE,WAI7B,CAAC"}

package/dist/wasm-fallback.js

@@ -0,0 +1,93 @@
+/**
+ * Pure TypeScript fallback kernels for WASM compute functions.
+ *
+ * These produce bit-identical results (within float precision) to the
+ * Rust WASM kernels. When WASM is unavailable, these are used automatically.
+ *
+ * @module
+ */
+function springCurve(stiffness, damping, mass, samples) {
+    const m = mass <= 0 ? 1 : mass;
+    const count = Math.min(Math.max(0, samples | 0), 255);
+    const omega = Math.sqrt(stiffness / m);
+    const zeta = damping / (2 * Math.sqrt(stiffness * m));
+    const out = new Float32Array(count + 1);
+    for (let i = 0; i <= count; i++) {
+        const t = i / count;
+        if (t <= 0) {
+            out[i] = 0;
+        }
+        else if (t >= 1) {
+            out[i] = 1;
+        }
+        else if (zeta < 1) {
+            const omegaD = omega * Math.sqrt(1 - zeta * zeta);
+            out[i] =
+                1 - Math.exp(-zeta * omega * t) * (Math.cos(omegaD * t) + ((zeta * omega) / omegaD) * Math.sin(omegaD * t));
+        }
+        else if (zeta === 1) {
+            out[i] = 1 - (1 + omega * t) * Math.exp(-omega * t);
+        }
+        else {
+            const s = Math.sqrt(zeta * zeta - 1);
+            const r1 = -omega * (zeta + s);
+            const r2 = -omega * (zeta - s);
+            const c1 = r2 / (r2 - r1);
+            const c2 = -r1 / (r2 - r1);
+            out[i] = 1 - (c1 * Math.exp(r1 * t) + c2 * Math.exp(r2 * t));
+        }
+    }
+    return out;
+}
+function batchBoundaryEval(thresholds, values) {
+    const tLen = thresholds.length;
+    const vLen = values.length;
+    const out = new Uint32Array(vLen);
+    for (let vi = 0; vi < vLen; vi++) {
+        const value = values[vi];
+        let stateIdx = 0;
+        for (let ti = tLen - 1; ti >= 0; ti--) {
+            if (value >= thresholds[ti]) {
+                stateIdx = ti;
+                break;
+            }
+        }
+        out[vi] = stateIdx;
+    }
+    return out;
+}
+function blendNormalize(weights) {
+    const len = weights.length;
+    if (len === 0)
+        return weights;
+    let total = 0;
+    for (let i = 0; i < len; i++) {
+        let w = weights[i];
+        if (w < 0) {
+            w = 0;
+            weights[i] = 0;
+        }
+        total += w;
+    }
+    if (total > 0) {
+        const inv = 1 / total;
+        for (let i = 0; i < len; i++) {
+            weights[i] = weights[i] * inv;
+        }
+    }
+    return weights;
+}
+/**
+ * Pure-JS implementation of the {@link WASMKernels} contract.
+ *
+ * Selected automatically by {@link WASMDispatch} when the Rust compute crate
+ * cannot be instantiated (e.g. missing `WebAssembly`, CSP restrictions, or
+ * startup failure). Produces results bit-identical to the WASM build within
+ * IEEE-754 precision limits.
+ */
+export const fallbackKernels = {
+    springCurve,
+    batchBoundaryEval,
+    blendNormalize,
+};
+//# sourceMappingURL=wasm-fallback.js.map

package/dist/wasm-fallback.js.map

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

package/dist/wire.d.ts

@@ -0,0 +1,49 @@
+/**
+ * `Wire<T, E>` — fluent stream wrapper.
+ *
+ * @module
+ */
+import { Effect, Stream } from 'effect';
+import type { Millis } from './brands.js';
+interface WireShape<T, E = never> {
+    readonly _tag: 'Wire';
+    readonly stream: Stream.Stream<T, E>;
+    map<B>(f: (a: T) => B): WireShape<B, E>;
+    filter(f: (a: T) => boolean): WireShape<T, E>;
+    take(n: number): WireShape<T, E>;
+    takeUntil(predicate: (a: T) => boolean): WireShape<T, E>;
+    debounce(ms: Millis): WireShape<T, E>;
+    throttle(ms: Millis): WireShape<T, E>;
+    scan<B>(initial: B, f: (acc: B, value: T) => B): WireShape<B, E>;
+    flatMap<B, E2>(f: (a: T) => WireShape<B, E2>): WireShape<B, E | E2>;
+    merge<B, E2>(other: WireShape<B, E2>): WireShape<T | B, E | E2>;
+    run(): Effect.Effect<void, E>;
+    runCollect(): Effect.Effect<T[], E>;
+}
+/**
+ * Wire -- fluent stream wrapper with chainable operators for map, filter,
+ * scan, debounce, throttle, merge, and more. Wraps Effect Streams.
+ *
+ * @example
+ * ```ts
+ * const wire = Wire.from(Stream.make(1, 2, 3, 4, 5));
+ * const result = wire.filter(n => n > 2).map(n => n * 10);
+ * const values = Effect.runSync(result.runCollect()); // [30, 40, 50]
+ * ```
+ */
+export declare const Wire: {
+    from: <T, E = never>(stream: Stream.Stream<T, E>) => WireShape<T, E>;
+    fromSSE: (url: string, options?: EventSourceInit) => WireShape<MessageEvent, Error>;
+    fromWebSocket: (url: string, protocols?: string | string[]) => WireShape<MessageEvent, Error>;
+    fromAsyncIterable: <T>(iterable: AsyncIterable<T>) => WireShape<T, Error>;
+    zip: <A, B>(a: WireShape<A>, b: WireShape<B>) => WireShape<readonly [A, B]>;
+    merge: <T, E>(streams: ReadonlyArray<WireShape<T, E>>) => WireShape<T, E>;
+    runCollect: <T, E>(stream: WireShape<T, E>) => Effect.Effect<ReadonlyArray<T>, E>;
+    runForEach: <T, SE, E, R>(stream: WireShape<T, SE>, fn: (t: T) => Effect.Effect<void, E, R>) => Effect.Effect<void, SE | E, R>;
+};
+export declare namespace Wire {
+    /** Structural shape of a {@link Wire}: a fluent wrapper over `Stream.Stream<T, E>`. */
+    type Shape<T, E = never> = WireShape<T, E>;
+}
+export {};
+//# sourceMappingURL=wire.d.ts.map

package/dist/wire.d.ts.map

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

package/dist/wire.js

@@ -0,0 +1,201 @@
+/**
+ * `Wire<T, E>` — fluent stream wrapper.
+ *
+ * @module
+ */
+import { Effect, Stream, Queue } from 'effect';
+function wrap(stream) {
+    const wireStream = {
+        _tag: 'Wire',
+        stream,
+        map: (f) => wrap(Stream.map(stream, f)),
+        filter: (f) => wrap(Stream.filter(stream, f)),
+        take: (n) => wrap(Stream.take(stream, n)),
+        takeUntil: (predicate) => wrap(Stream.takeUntil(stream, predicate)),
+        debounce: (ms) => wrap(Stream.debounce(stream, ms)),
+        throttle: (ms) => wrap(Stream.throttle(stream, {
+            cost: () => 1,
+            units: 1,
+            duration: ms,
+            strategy: 'enforce',
+        })),
+        scan: (initial, f) => wrap(Stream.scan(stream, initial, f)),
+        flatMap: (f) => wrap(Stream.flatMap(stream, (a) => f(a).stream)),
+        merge: (other) => wrap(Stream.merge(stream, other.stream)),
+        run: () => Stream.runDrain(stream),
+        runCollect: () => Effect.map(Stream.runCollect(stream), (chunk) => Array.from(chunk)),
+    };
+    return wireStream;
+}
+/**
+ * Wraps an Effect Stream into a fluent Wire with chainable operators.
+ *
+ * @example
+ * ```ts
+ * const wire = Wire.from(Stream.make(1, 2, 3));
+ * const doubled = wire.map(n => n * 2).filter(n => n > 2);
+ * const results = Effect.runSync(doubled.runCollect()); // [4, 6]
+ * ```
+ */
+const _from = (stream) => wrap(stream);
+/**
+ * Creates a Wire from a Server-Sent Events endpoint.
+ * The EventSource is cleaned up when the stream finalizes.
+ *
+ * @example
+ * ```ts
+ * const wire = Wire.fromSSE('/api/events');
+ * const parsed = wire.map(evt => JSON.parse(evt.data));
+ * await Effect.runPromise(Wire.runForEach(parsed, msg => Effect.log(msg)));
+ * ```
+ */
+const _fromSSE = (url, options) => {
+    const stream = Stream.callback((queue) => Effect.gen(function* () {
+        const eventSource = new EventSource(url, options);
+        let closed = false;
+        const shutdown = () => {
+            if (closed)
+                return;
+            closed = true;
+            Queue.shutdown(queue).pipe(Effect.runSync);
+        };
+        eventSource.onmessage = (event) => {
+            Queue.offerUnsafe(queue, event);
+        };
+        eventSource.onerror = () => {
+            eventSource.close();
+            shutdown();
+        };
+        yield* Effect.addFinalizer(() => Effect.sync(() => {
+            eventSource.close();
+            shutdown();
+        }));
+        yield* Effect.never;
+    }));
+    return wrap(stream);
+};
+/**
+ * Creates a Wire from a WebSocket connection.
+ * The socket is closed when the stream finalizes.
+ *
+ * @example
+ * ```ts
+ * const wire = Wire.fromWebSocket('wss://example.com/ws');
+ * const messages = wire.map(evt => evt.data as string);
+ * await Effect.runPromise(Wire.runForEach(messages, m => Effect.log(m)));
+ * ```
+ */
+const _fromWebSocket = (url, protocols) => {
+    const stream = Stream.callback((queue) => Effect.gen(function* () {
+        const ws = new WebSocket(url, protocols);
+        let closed = false;
+        const shutdown = () => {
+            if (closed)
+                return;
+            closed = true;
+            Queue.shutdown(queue).pipe(Effect.runSync);
+        };
+        ws.onmessage = (event) => {
+            Queue.offerUnsafe(queue, event);
+        };
+        ws.onerror = () => {
+            shutdown();
+        };
+        ws.onclose = () => {
+            shutdown();
+        };
+        yield* Effect.addFinalizer(() => Effect.sync(() => {
+            if (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING) {
+                ws.close();
+            }
+            shutdown();
+        }));
+        yield* Effect.never;
+    }));
+    return wrap(stream);
+};
+/**
+ * Creates a Wire from any AsyncIterable source.
+ *
+ * @example
+ * ```ts
+ * async function* gen() { yield 1; yield 2; yield 3; }
+ * const wire = Wire.fromAsyncIterable(gen());
+ * const results = await Effect.runPromise(wire.runCollect()); // [1, 2, 3]
+ * ```
+ */
+const _fromAsyncIterable = (iterable) => {
+    const stream = Stream.fromAsyncIterable(iterable, (e) => (e instanceof Error ? e : new Error(String(e))));
+    return wrap(stream);
+};
+/**
+ * Zips two Wires into a Wire of tuples, pairing elements pairwise.
+ *
+ * @example
+ * ```ts
+ * const a = Wire.from(Stream.make(1, 2));
+ * const b = Wire.from(Stream.make('a', 'b'));
+ * const zipped = Wire.zip(a, b);
+ * const results = Effect.runSync(zipped.runCollect()); // [[1,'a'], [2,'b']]
+ * ```
+ */
+const _zip = (a, b) => wrap(Stream.zip(a.stream, b.stream));
+/**
+ * Merges multiple Wires into a single Wire, interleaving their emissions.
+ *
+ * @example
+ * ```ts
+ * const a = Wire.from(Stream.make(1, 2));
+ * const b = Wire.from(Stream.make(3, 4));
+ * const merged = Wire.merge([a, b]);
+ * const results = Effect.runSync(merged.runCollect()); // [1, 2, 3, 4] (order varies)
+ * ```
+ */
+const _merge = (streams) => {
+    const effectStreams = streams.map((s) => s.stream);
+    const merged = Stream.mergeAll(effectStreams, { concurrency: 'unbounded' });
+    return wrap(merged);
+};
+/**
+ * Collects all values from a Wire into an array.
+ *
+ * @example
+ * ```ts
+ * const wire = Wire.from(Stream.make(10, 20, 30));
+ * const values = Effect.runSync(Wire.runCollect(wire)); // [10, 20, 30]
+ * ```
+ */
+const _runCollect = (stream) => Effect.map(Stream.runCollect(stream.stream), (chunk) => Array.from(chunk));
+/**
+ * Runs an effectful function for each value emitted by the Wire.
+ *
+ * @example
+ * ```ts
+ * const wire = Wire.from(Stream.make('hello', 'world'));
+ * await Effect.runPromise(Wire.runForEach(wire, s => Effect.log(s)));
+ * // Logs: hello, world
+ * ```
+ */
+const _runForEach = (stream, fn) => Stream.runForEach(stream.stream, fn);
+/**
+ * Wire -- fluent stream wrapper with chainable operators for map, filter,
+ * scan, debounce, throttle, merge, and more. Wraps Effect Streams.
+ *
+ * @example
+ * ```ts
+ * const wire = Wire.from(Stream.make(1, 2, 3, 4, 5));
+ * const result = wire.filter(n => n > 2).map(n => n * 10);
+ * const values = Effect.runSync(result.runCollect()); // [30, 40, 50]
+ * ```
+ */
+export const Wire = {
+    from: _from,
+    fromSSE: _fromSSE,
+    fromWebSocket: _fromWebSocket,
+    fromAsyncIterable: _fromAsyncIterable,
+    zip: _zip,
+    merge: _merge,
+    runCollect: _runCollect,
+    runForEach: _runForEach,
+};
+//# sourceMappingURL=wire.js.map