mattebox 0.1.0

package/dist/kernel/append-queue.js

@@ -0,0 +1,180 @@
+function isQuotaError(err) {
+    return err instanceof DOMException && err.name === 'QuotaExceededError';
+}
+function isInvalidState(err) {
+    return err instanceof DOMException && err.name === 'InvalidStateError';
+}
+export function createAppendQueue(sbId, sb, cb) {
+    const ops = [];
+    let quotaAttempts = 0;
+    let destroyed = false;
+    let pumping = false;
+    function execute(op) {
+        // Returns true when the operation started async work (updating went
+        // true) and the pump must wait for updateend.
+        try {
+            switch (op.op) {
+                case 'append':
+                    sb.appendBuffer(op.data);
+                    quotaAttempts = 0;
+                    return true;
+                case 'remove': {
+                    // remove() throws while the duration is NaN, which it is until
+                    // the first append or the owner's deferred duration assignment,
+                    // and on a start past the buffered end. Both mean there is
+                    // nothing in range: a no-op, not a fatal error.
+                    const { buffered } = sb;
+                    if (buffered.length === 0 || op.start >= buffered.end(buffered.length - 1)) {
+                        return false;
+                    }
+                    sb.remove(op.start, op.end);
+                    return true;
+                }
+                case 'changeType':
+                    // Synchronous; no updateend follows.
+                    sb.changeType(op.type);
+                    return false;
+                case 'setTimestampOffset':
+                    sb.timestampOffset = op.offset;
+                    return false;
+            }
+        }
+        catch (err) {
+            if (op.op === 'append' && isQuotaError(err)) {
+                // Back to the front: order among appends is preserved, and the
+                // owner's eviction removes are enqueuedFront ahead of it.
+                ops.unshift(op);
+                quotaAttempts += 1;
+                cb.onQuota(sbId, quotaAttempts);
+                return false;
+            }
+            if (isInvalidState(err)) {
+                // The buffer was removed by a concurrent detach or the MediaSource
+                // closed. The queue's world is gone: drop everything silently.
+                destroy();
+                return false;
+            }
+            cb.absorb({
+                type: 'SOURCEBUFFER_ERROR',
+                sbId,
+                error: {
+                    category: 'media',
+                    code: 'MEDIA_APPEND_FAILED',
+                    fatal: true,
+                    recoverable: false,
+                    context: { operation: op.op, message: String(err) },
+                },
+            });
+            return false;
+        }
+        return false;
+    }
+    function pump() {
+        if (destroyed || pumping)
+            return;
+        // The guard stops onQuota reentry (it enqueues from inside execute)
+        // from starting a second pump over the same queue.
+        pumping = true;
+        try {
+            while (!sb.updating && !destroyed) {
+                const op = ops.shift();
+                if (op === undefined) {
+                    cb.onIdle(sbId);
+                    return;
+                }
+                if (execute(op))
+                    return;
+                if (op.op === 'append' && ops[0] === op) {
+                    // The append failed on quota and is back at the front; stop until
+                    // an eviction remove is enqueued or an updateend arrives, or this
+                    // loop would spin on the same failing append.
+                    return;
+                }
+            }
+        }
+        finally {
+            pumping = false;
+        }
+    }
+    function snapshotRanges() {
+        try {
+            const out = [];
+            const { buffered } = sb;
+            for (let i = 0; i < buffered.length; i += 1) {
+                out.push({ start: buffered.start(i), end: buffered.end(i) });
+            }
+            return out;
+        }
+        catch {
+            // The buffer detached between the event and the read.
+            return undefined;
+        }
+    }
+    function onUpdateEnd() {
+        if (destroyed)
+            return;
+        const ranges = snapshotRanges();
+        cb.absorb({
+            type: 'SOURCEBUFFER_UPDATEEND',
+            sbId,
+            ...(ranges !== undefined ? { ranges } : {}),
+        });
+        pump();
+    }
+    function onError() {
+        if (destroyed)
+            return;
+        // The segment parser rejected the bytes. updateend follows per spec;
+        // the pump resumes there.
+        cb.absorb({
+            type: 'SOURCEBUFFER_ERROR',
+            sbId,
+            error: {
+                category: 'media',
+                code: 'MEDIA_APPEND_FAILED',
+                fatal: false,
+                recoverable: true,
+            },
+        });
+    }
+    function destroy() {
+        if (destroyed)
+            return;
+        destroyed = true;
+        ops.length = 0;
+        sb.removeEventListener('updateend', onUpdateEnd);
+        sb.removeEventListener('error', onError);
+    }
+    sb.addEventListener('updateend', onUpdateEnd);
+    sb.addEventListener('error', onError);
+    return {
+        enqueue(op) {
+            if (destroyed)
+                return;
+            ops.push(op);
+            pump();
+        },
+        enqueueFront(op) {
+            if (destroyed)
+                return;
+            ops.unshift(op);
+            pump();
+        },
+        abort() {
+            if (destroyed)
+                return;
+            ops.length = 0;
+            quotaAttempts = 0;
+            try {
+                sb.abort();
+            }
+            catch {
+                // InvalidStateError when the parent MediaSource is not open; the
+                // queue is being torn down anyway.
+            }
+        },
+        destroy,
+        idle: () => !destroyed && ops.length === 0 && !sb.updating,
+    };
+}
+//# sourceMappingURL=append-queue.js.map

package/dist/kernel/append-queue.js.map

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

package/dist/kernel/bus.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The message loop. One queue serializes the five concurrent writers; every
+ * classic player bug is an interleaving bug, and this is the fix.
+ *
+ * Reentrancy: a listener dispatching from inside the flush enqueues; it
+ * never recurses. Messages are processed strictly in arrival order.
+ */
+import type { ContentType } from '../types/ir.js';
+import type { Bus, KernelState, Reducer, TraceEntry } from '../types/kernel.js';
+import type { Effect, Message } from '../types/messages.js';
+import type { Capability, Listener, ParserFn, SinkFactory, TransformStep, Unsubscribe } from '../types/stage.js';
+export interface CreateBusOptions {
+    readonly reducer: Reducer;
+    readonly initial: KernelState;
+    /** Clock for trace timestamps. The reducer itself never sees it. */
+    readonly now?: () => number;
+    readonly traceCapacity?: number;
+}
+/** Receives the effects of each reduction, in order. Injected, so tests fake it. */
+export type EffectSink = (effects: readonly Effect[]) => void;
+export interface KernelBus extends Bus {
+    /** Routes a message to dispatch or absorb by its type literal. */
+    route(msg: Message): void;
+    getState(): KernelState;
+    trace(): readonly TraceEntry[];
+    setEffectSink(sink: EffectSink): void;
+    /**
+     * Swaps the reducer. Attach composes stage slices into a fresh reducer;
+     * the swap happens between messages, never inside a flush.
+     */
+    setReducer(reducer: Reducer): void;
+    on(event: string, fn: Listener): Unsubscribe;
+    emitEvent(event: string, payload: unknown): void;
+    registerCapability(capability: Capability): void;
+    capabilities(): readonly Capability[];
+    registerSink(contentType: ContentType, factory: SinkFactory): void;
+    unregisterSink(contentType: ContentType): void;
+    sinkFor(contentType: ContentType): SinkFactory | undefined;
+    registerParser(mimeType: string, parse: ParserFn): void;
+    unregisterParser(mimeType: string): void;
+    parserFor(mimeType: string): ParserFn | undefined;
+    registerTransform(step: TransformStep): void;
+    unregisterTransform(step: TransformStep): void;
+    transforms(): readonly TransformStep[];
+    registerNamespace(name: string, api: object): void;
+    unregisterNamespace(name: string): void;
+    namespaces(): ReadonlyMap<string, object>;
+}
+export declare function createBus(options: CreateBusOptions): KernelBus;
+//# sourceMappingURL=bus.d.ts.map

package/dist/kernel/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/kernel/bus.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EAAW,MAAM,EAAQ,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,aAAa,EACb,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,oFAAoF;AACpF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;AAE9D,MAAM,WAAW,SAAU,SAAQ,GAAG;IACpC,kEAAkE;IAClE,KAAK,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,QAAQ,IAAI,WAAW,CAAC;IACxB,KAAK,IAAI,SAAS,UAAU,EAAE,CAAC;IAC/B,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACtC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAEnC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC7C,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAEjD,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACjD,YAAY,IAAI,SAAS,UAAU,EAAE,CAAC;IAEtC,YAAY,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IACnE,cAAc,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAC/C,OAAO,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;IAC3D,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAClD,iBAAiB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7C,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/C,UAAU,IAAI,SAAS,aAAa,EAAE,CAAC;IACvC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,UAAU,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,CAqJ9D"}

package/dist/kernel/bus.js

@@ -0,0 +1,147 @@
+import { createTraceBuffer, DEFAULT_TRACE_CAPACITY, digest } from './trace.js';
+export function createBus(options) {
+    let reducer = options.reducer;
+    const now = options.now ?? (() => globalThis.performance.now());
+    const traceBuffer = createTraceBuffer(options.traceCapacity ?? DEFAULT_TRACE_CAPACITY);
+    let state = options.initial;
+    let effectSink = () => undefined;
+    const queue = [];
+    let processing = false;
+    const listeners = new Map();
+    const capabilities = [];
+    const sinks = new Map();
+    const parsers = new Map();
+    const transformSteps = [];
+    const namespaceMap = new Map();
+    function flush() {
+        if (processing)
+            return;
+        processing = true;
+        try {
+            let msg = queue.shift();
+            while (msg !== undefined) {
+                const [next, effects] = reducer(state, msg);
+                state = next;
+                traceBuffer.push({ t: now(), msg, effects, digest: digest(state) });
+                // The sink may re-enter dispatch or absorb; those enqueue and are
+                // handled by this same loop, in order.
+                effectSink(effects);
+                msg = queue.shift();
+            }
+        }
+        finally {
+            processing = false;
+        }
+    }
+    function enqueue(msg) {
+        queue.push(msg);
+        flush();
+    }
+    function emitEvent(event, payload) {
+        const set = listeners.get(event);
+        if (set === undefined)
+            return;
+        for (const fn of [...set]) {
+            try {
+                fn(payload);
+            }
+            catch {
+                // A throwing listener must not break the loop or its siblings.
+                // Contained here; the listener's stage owns its own errors.
+            }
+        }
+    }
+    return {
+        dispatch(cmd) {
+            enqueue(cmd);
+        },
+        absorb(fact) {
+            enqueue(fact);
+        },
+        route(msg) {
+            // Commands and facts share the queue; the reducer discriminates by
+            // type literal. This exists for callers holding a Message, such as
+            // the schedule effect handler delivering its `then` payload.
+            enqueue(msg);
+        },
+        getState() {
+            return state;
+        },
+        trace() {
+            return traceBuffer.snapshot();
+        },
+        setEffectSink(sink) {
+            effectSink = sink;
+        },
+        setReducer(next) {
+            reducer = next;
+        },
+        on(event, fn) {
+            let set = listeners.get(event);
+            if (set === undefined) {
+                set = new Set();
+                listeners.set(event, set);
+            }
+            set.add(fn);
+            return () => {
+                set.delete(fn);
+            };
+        },
+        emitEvent,
+        registerCapability(capability) {
+            capabilities.push(capability);
+        },
+        capabilities() {
+            return [...capabilities];
+        },
+        registerSink(contentType, factory) {
+            if (sinks.has(contentType)) {
+                throw new Error(`duplicate sink for '${contentType}'`);
+            }
+            sinks.set(contentType, factory);
+        },
+        unregisterSink(contentType) {
+            sinks.delete(contentType);
+        },
+        sinkFor(contentType) {
+            return sinks.get(contentType);
+        },
+        registerParser(mimeType, parse) {
+            if (parsers.has(mimeType)) {
+                throw new Error(`duplicate parser for '${mimeType}'`);
+            }
+            parsers.set(mimeType, parse);
+        },
+        unregisterParser(mimeType) {
+            parsers.delete(mimeType);
+        },
+        parserFor(mimeType) {
+            return parsers.get(mimeType);
+        },
+        registerTransform(step) {
+            transformSteps.push(step);
+            transformSteps.sort((a, b) => a.order - b.order);
+        },
+        unregisterTransform(step) {
+            const index = transformSteps.indexOf(step);
+            if (index >= 0)
+                transformSteps.splice(index, 1);
+        },
+        transforms() {
+            return [...transformSteps];
+        },
+        registerNamespace(name, api) {
+            if (namespaceMap.has(name)) {
+                throw new Error(`duplicate namespace '${name}'`);
+            }
+            namespaceMap.set(name, api);
+        },
+        unregisterNamespace(name) {
+            namespaceMap.delete(name);
+        },
+        namespaces() {
+            return namespaceMap;
+        },
+    };
+}
+//# sourceMappingURL=bus.js.map

package/dist/kernel/bus.js.map

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

package/dist/kernel/context.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The StageContext implementation: everything a stage does to the engine
+ * goes through this. Registrations land in the bus registries; namespaces
+ * land on the facade object so an absent stage leaves no property behind,
+ * not a stub that throws.
+ */
+import type { SliceReducer } from '../types/kernel.js';
+import type { AbrChooser, SwitchPolicy } from '../types/quality.js';
+import type { StageContext, Teardown, TransportRequestDraftView, TypeProbe } from '../types/stage.js';
+import type { KernelBus } from './bus.js';
+/** The mutable hook registry the reducer reads through; shared across contexts. */
+export interface HookRegistry {
+    abr?: AbrChooser | null;
+    switchPolicy?: SwitchPolicy | null;
+    /** Reads a SourceBuffer type from init bytes, for renditions the manifest left codec-less. */
+    typeProbe?: TypeProbe | null;
+    /** The composition's manifest MIME types; static, set by the composition root. */
+    readonly manifestTypes?: ReadonlySet<string>;
+}
+export interface ContextDeps {
+    readonly bus: KernelBus;
+    readonly element: HTMLMediaElement;
+    /** The facade object namespaces attach to. */
+    readonly facade: Record<string, unknown>;
+    /** Live slice list; the reducer reads it through the bus after install. */
+    readonly slices: Array<readonly [string, SliceReducer]>;
+    readonly hooks: HookRegistry;
+    /** Registers a transport request hook; returns the unsubscribe. */
+    readonly addRequestHook: (hook: (req: TransportRequestDraftView) => void) => () => void;
+    /** A one-off request through the transport. */
+    readonly request: (url: string, init: {
+        method?: string;
+        headers?: Record<string, string>;
+        body?: ArrayBuffer | Uint8Array | string;
+    }) => Promise<Response>;
+}
+/**
+ * Builds one stage's context and returns the registrations' own teardown,
+ * combined by the caller with whatever the stage's install returns.
+ */
+export declare function createStageContext(deps: ContextDeps): {
+    ctx: StageContext;
+    teardown: Teardown;
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/kernel/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/kernel/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EACV,YAAY,EACZ,QAAQ,EAER,yBAAyB,EACzB,SAAS,EACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,8FAA8F;IAC9F,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACxD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,yBAAyB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC;IACxF,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,CAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;QACJ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;KAC1C,KACE,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG;IAAE,GAAG,EAAE,YAAY,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAmG/F"}

package/dist/kernel/context.js

@@ -0,0 +1,116 @@
+/**
+ * The StageContext implementation: everything a stage does to the engine
+ * goes through this. Registrations land in the bus registries; namespaces
+ * land on the facade object so an absent stage leaves no property behind,
+ * not a stub that throws.
+ */
+/**
+ * Builds one stage's context and returns the registrations' own teardown,
+ * combined by the caller with whatever the stage's install returns.
+ */
+export function createStageContext(deps) {
+    const unsubscribes = [];
+    const namespaceNames = [];
+    // Every registry entry this stage made, undone at teardown so that a
+    // detach followed by an attach (a media-error rebuild, an element swap)
+    // installs the stage afresh instead of tripping the duplicate guards or
+    // running a transform twice.
+    const sinkTypes = [];
+    const parserTypes = [];
+    const transformSteps = [];
+    let registeredChooser = false;
+    let registeredPolicy = false;
+    let registeredProbe = false;
+    const ctx = {
+        element: deps.element,
+        registerSink(contentType, factory) {
+            deps.bus.registerSink(contentType, factory);
+            sinkTypes.push(contentType);
+        },
+        registerParser(mimeType, parse) {
+            deps.bus.registerParser(mimeType, parse);
+            parserTypes.push(mimeType);
+        },
+        registerTransform(step) {
+            // Ordering is declared on the step, not emergent from registration
+            // order; the bus keeps the pipeline sorted by `order`.
+            deps.bus.registerTransform(step);
+            transformSteps.push(step);
+        },
+        getState() {
+            return deps.bus.getState();
+        },
+        addRequestHook(hook) {
+            const off = deps.addRequestHook(hook);
+            unsubscribes.push(off);
+            return off;
+        },
+        request(url, init) {
+            return deps.request(url, init);
+        },
+        registerNamespace(name, api) {
+            deps.bus.registerNamespace(name, api);
+            deps.facade[name] = api;
+            namespaceNames.push(name);
+        },
+        registerChooser(chooser) {
+            if (deps.hooks.abr != null) {
+                throw new Error('an abr chooser is already registered');
+            }
+            deps.hooks.abr = chooser;
+            registeredChooser = true;
+        },
+        registerSwitchPolicy(policy) {
+            if (deps.hooks.switchPolicy != null) {
+                throw new Error('a switch policy is already registered');
+            }
+            deps.hooks.switchPolicy = policy;
+            registeredPolicy = true;
+        },
+        registerTypeProbe(probe) {
+            if (deps.hooks.typeProbe != null) {
+                throw new Error('a type probe is already registered');
+            }
+            deps.hooks.typeProbe = probe;
+            registeredProbe = true;
+        },
+        reduce(slice, reducer) {
+            deps.slices.push([slice, reducer]);
+        },
+        dispatch(cmd) {
+            deps.bus.dispatch(cmd);
+        },
+        emit(event, payload) {
+            deps.bus.emitEvent(event, payload);
+        },
+        on(event, fn) {
+            const off = deps.bus.on(event, fn);
+            unsubscribes.push(off);
+            return off;
+        },
+    };
+    return {
+        ctx,
+        teardown() {
+            for (const off of unsubscribes)
+                off();
+            for (const name of namespaceNames) {
+                delete deps.facade[name];
+                deps.bus.unregisterNamespace(name);
+            }
+            for (const contentType of sinkTypes)
+                deps.bus.unregisterSink(contentType);
+            for (const mimeType of parserTypes)
+                deps.bus.unregisterParser(mimeType);
+            for (const step of transformSteps)
+                deps.bus.unregisterTransform(step);
+            if (registeredChooser)
+                deps.hooks.abr = null;
+            if (registeredPolicy)
+                deps.hooks.switchPolicy = null;
+            if (registeredProbe)
+                deps.hooks.typeProbe = null;
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/kernel/context.js.map

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

package/dist/kernel/effects.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The effect runner. Takes inert effect descriptors, hands each to a
+ * registered handler, and lets results re-enter the loop as facts.
+ *
+ * Handlers are injected, never imported. That is what keeps this module
+ * node-testable: tests register fakes that record calls. An asynchronous
+ * handler may return a cancel function; it is stored under the effect's
+ * token, and an abort effect (or an explicit cancel call) invokes it.
+ */
+import type { Effect, Serializable } from '../types/messages.js';
+export type EffectOf<K extends Effect['kind']> = Extract<Effect, {
+    kind: K;
+}>;
+/** Handles one effect kind. A returned function cancels the started work. */
+export type EffectHandler<K extends Effect['kind'] = Effect['kind']> = (effect: EffectOf<K>) => undefined | (() => void);
+export interface CreateEffectRunnerOptions {
+    /** Receives runner-internal events: unhandled kinds and throwing handlers. */
+    readonly onEvent?: (event: string, payload: Serializable) => void;
+}
+export interface EffectRunner {
+    register<K extends Effect['kind']>(kind: K, handler: EffectHandler<K>): void;
+    run(effects: readonly Effect[]): void;
+    /** Invokes and forgets the cancel function stored under the token, if any. */
+    cancel(token: string): void;
+    /** Drops the stored cancel without invoking it: the work under the token completed on its own. */
+    forget(token: string): void;
+    /** Cancels every pending token. The detach path: nothing started before it may fire after. */
+    cancelAll(): void;
+    /** Tokens with a live cancel function. For diagnostics and tests. */
+    pending(): readonly string[];
+}
+export declare function createEffectRunner(options?: CreateEffectRunnerOptions): EffectRunner;
+//# sourceMappingURL=effects.d.ts.map

package/dist/kernel/effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effects.d.ts","sourceRoot":"","sources":["../../src/kernel/effects.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEjE,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAE9E,6EAA6E;AAC7E,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CACrE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,KAChB,SAAS,GAAG,CAAC,MAAM,IAAI,CAAC,CAAC;AAE9B,MAAM,WAAW,yBAAyB;IACxC,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CACnE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC7E,GAAG,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACtC,8EAA8E;IAC9E,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kGAAkG;IAClG,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,8FAA8F;IAC9F,SAAS,IAAI,IAAI,CAAC;IAClB,qEAAqE;IACrE,OAAO,IAAI,SAAS,MAAM,EAAE,CAAC;CAC9B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,yBAA8B,GAAG,YAAY,CA6DxF"}