@exactjs/core 0.5.0

package/dist/tasks/server-component-execution.js

@@ -0,0 +1,384 @@
+import { unwrap } from '@exactjs/reactive/framework/runtime';
+import { ServerTaskReadiness } from './server-task-readiness.js';
+/**
+ * Realm-stable protocol identities shared by separately evaluated copies of the core package.
+ * The frame remains owned by its request-local host and is removed when that request is disposed;
+ * dependency tokens carry only request-owned output slots.
+ */
+const serverExecutionFrame = Symbol.for('@exactjs/server-component-execution-frame');
+const serverDependencyBrand = Symbol.for('@exactjs/server-component-dependency');
+let activeComponentIssuer;
+/**
+ * Installs the request renderer's synchronous child-issuance callback while compiled render code
+ * materializes its compiler-issued child operations. JavaScript cannot interleave another request during this synchronous
+ * extent, and nested renderers restore the preceding issuer in stack order.
+ */
+export function withServerComponentIssuer(issuer, render) {
+    const previous = activeComponentIssuer;
+    activeComponentIssuer = issuer;
+    try {
+        return render();
+    }
+    finally {
+        activeComponentIssuer = previous;
+    }
+}
+/**
+ * Returns a compiler-created component receipt after issuing its request-local server work. Outside
+ * SSR this is deliberately a zero-allocation pass-through.
+ */
+export function issueServerComponentReceipt(component) {
+    activeComponentIssuer?.(component);
+    return component;
+}
+/** Returns the request-local output source carried by a compiler-forwarded server value. */
+export function serverComponentDependencyForValue(value) {
+    const slot = serverDependencySlot(value);
+    if (!slot)
+        return undefined;
+    return {
+        read() {
+            switch (slot.status) {
+                case 'available':
+                    return { status: 'available', generation: 1, version: 1, value: slot.value };
+                case 'failed':
+                    return { status: 'failed', generation: 1, version: 1, error: slot.error };
+                default:
+                    return { status: 'pending', generation: 1, version: 0 };
+            }
+        },
+        subscribe(notify) {
+            const subscribers = (slot.subscribers ??= new Set());
+            subscribers.add(notify);
+            return { [Symbol.dispose]: () => subscribers.delete(notify) };
+        }
+    };
+}
+function serverDependencySlot(value) {
+    return value && typeof value === 'object' && serverDependencyBrand in value
+        ? value[serverDependencyBrand]
+        : undefined;
+}
+export function serverComponentExecutionValueForHost(host, path, value) {
+    const frame = executionFrameForHost(host);
+    if (!frame)
+        return resolveServerExecutionValue(value);
+    const paths = typeof path === 'string' ? [path] : path;
+    const sources = [];
+    for (const candidate of paths) {
+        const normalized = candidate.replace(/^this\.state\./, '');
+        for (const [registered, port] of frame.paths)
+            if (registered === normalized) {
+                const source = outputSlot(frame, port);
+                if (!sources.includes(source))
+                    sources.push(source);
+            }
+    }
+    if (!sources.length)
+        return resolveServerExecutionValue(value);
+    return Object.freeze({
+        [serverDependencyBrand]: typeof path === 'string' && typeof value !== 'function'
+            ? sources[0]
+            : projectServerExecutionValue(sources, value)
+    });
+}
+/** Projects an aggregate expression only after every compiler-selected output path settles. */
+function projectServerExecutionValue(sources, value) {
+    const projected = { status: 'pending' };
+    const refresh = () => {
+        let unavailable;
+        for (const source of sources) {
+            if (source.status === 'failed') {
+                unavailable = source;
+                break;
+            }
+            if (source.status === 'pending')
+                unavailable ??= source;
+        }
+        if (unavailable?.status === 'failed') {
+            projected.status = 'failed';
+            projected.error = unavailable.error;
+            delete projected.value;
+        }
+        else if (unavailable) {
+            projected.status = 'pending';
+            delete projected.value;
+            delete projected.error;
+        }
+        else {
+            projected.status = 'available';
+            projected.value = resolveServerExecutionValue(value);
+            delete projected.error;
+        }
+        for (const subscriber of projected.subscribers ?? [])
+            subscriber();
+    };
+    for (const source of sources)
+        (source.subscribers ??= new Set()).add(refresh);
+    refresh();
+    return projected;
+}
+function resolveServerExecutionValue(value) {
+    return (typeof value === 'function' ? value() : unwrap(value));
+}
+/**
+ * Creates only the cancellation and port storage required by compiler-emitted task slices. It does
+ * not construct a task owner, prepare a component graph, subscribe reactive watchers, or allocate
+ * universal task lanes.
+ */
+export function createServerComponentExecutionFrame(host, options) {
+    const frame = {
+        host,
+        options,
+        controller: new AbortController(),
+        ports: [],
+        paths: [],
+        active: [],
+        readiness: new ServerTaskReadiness(options.trackTaskIdentities),
+        continuationContexts: new Map(),
+        settledContinuations: new Set(),
+        disposed: false
+    };
+    Object.defineProperty(host, serverExecutionFrame, {
+        configurable: true,
+        value: frame
+    });
+    return Object.freeze({
+        get blockingVersion() {
+            return frame.readiness.version;
+        },
+        blockingWork(transitions) {
+            return frame.readiness.wait(transitions);
+        },
+        blockingVersionFor(transitions) {
+            return frame.readiness.versionFor(transitions);
+        },
+        run(work) {
+            if (frame.disposed)
+                throw new Error('Server component execution frame has been disposed');
+            return work();
+        },
+        async [Symbol.asyncDispose]() {
+            if (frame.disposed)
+                return;
+            frame.disposed = true;
+            const reason = new DOMException('Server component execution disposed', 'AbortError');
+            frame.controller.abort(reason);
+            for (let port = 0; port < frame.ports.length; port++)
+                if (frame.ports[port]?.status === 'pending')
+                    failPort(frame, port, reason);
+            await Promise.allSettled(frame.active);
+            // A stale disposer must not detach a newer frame installed on the same request host.
+            if (host[serverExecutionFrame] === frame)
+                delete host[serverExecutionFrame];
+            frame.ports.length = 0;
+            frame.paths.length = 0;
+            frame.active.length = 0;
+            frame.continuationContexts.clear();
+            frame.settledContinuations.clear();
+        }
+    });
+}
+/** Activates one compiler-wired setup transition without materializing the universal task ABI. */
+export function activateServerComponentTaskForHost(host, slice, transitionId, work, ...authored) {
+    const frame = executionFrameForHost(host);
+    if (!frame || frame.disposed)
+        throw new Error('Compiled server task requires an active server component execution frame');
+    for (const [port, path] of slice[1]) {
+        outputSlot(frame, port);
+        registerOutputPath(frame, path.join('.'), port);
+    }
+    const settlement = executeSlice(frame, slice, work, authored).then((result) => {
+        frame.settledContinuations.add(transitionId);
+        return result;
+    });
+    frame.active.push(settlement);
+    void settlement.catch(() => undefined);
+    if (slice[2] === 'blocking' || frame.options.publicationDependencies?.has(transitionId)) {
+        frame.readiness.observe(settlement, transitionId);
+        frame.options.observe?.(settlement);
+    }
+}
+/** Registers compiler-approved public context names against one request-local server frame. */
+export function registerServerComponentContinuationContextsForHost(host, bindings) {
+    const frame = executionFrameForHost(host);
+    if (!frame || frame.disposed)
+        throw new Error('Compiled server context registration requires an active execution frame');
+    for (const binding of bindings) {
+        if (!safeContextName(binding.name) || typeof binding.token?.id !== 'symbol')
+            throw new Error('Malformed eXact server continuation context binding');
+        const previous = frame.continuationContexts.get(binding.name);
+        if (previous && previous.id !== binding.token.id)
+            throw new Error(`Conflicting eXact server continuation context binding ${binding.name}`);
+        frame.continuationContexts.set(binding.name, binding.token);
+    }
+}
+/** Projects compiler-selected shared context values from one direct request-local frame. */
+export function serverComponentContinuationContextValuesForHost(host, names) {
+    if (names.length === 0)
+        return {};
+    const frame = executionFrameForHost(host);
+    if (!frame || frame.disposed)
+        throw new Error('Compiled server context publication requires an active execution frame');
+    const values = {};
+    for (const name of names) {
+        const token = frame.continuationContexts.get(name);
+        if (!token)
+            throw new Error(`Missing eXact server continuation context binding ${name}`);
+        if (!frame.host.contexts?.has(token.id))
+            continue;
+        const value = frame.host.contexts.get(token.id);
+        if (value !== undefined)
+            values[name] = value;
+    }
+    return values;
+}
+/** Lists direct server continuation generations that settled successfully in this request. */
+export function settledServerComponentContinuationIdsForHost(host) {
+    const frame = executionFrameForHost(host);
+    return frame && !frame.disposed ? [...frame.settledContinuations] : [];
+}
+function safeContextName(name) {
+    return name.length > 0 && name !== '__proto__' && name !== 'prototype' && name !== 'constructor';
+}
+/** Reads the request-owned frame without retaining the host outside its request lifetime. */
+function executionFrameForHost(host) {
+    return host[serverExecutionFrame];
+}
+/** Runs a deferred compiler output read through its existing live request owner. */
+export function readServerComponentOutputForHost(host, read) {
+    const frame = executionFrameForHost(host);
+    if (!frame || frame.disposed || !frame.options.prepareOutput)
+        throw new TypeError('Deferred server output requires its live task owner');
+    return frame.options.prepareOutput(read);
+}
+function executeSlice(frame, slice, work, authored) {
+    const inputs = authored.slice();
+    const pending = [];
+    for (let index = 0; index < inputs.length; index++) {
+        const port = slice[0][index] ?? -1;
+        const slot = port < 0 ? serverDependencySlot(inputs[index]) : outputSlot(frame, port);
+        if (!slot)
+            continue;
+        if (slot.status === 'available')
+            inputs[index] = slot.value;
+        else if (slot.status === 'failed')
+            return Promise.reject(slot.error);
+        else
+            pending.push(waitForSlot(slot).then((value) => {
+                inputs[index] = value;
+            }));
+    }
+    return pending.length
+        ? Promise.all(pending).then(() => invokeSlice(frame, slice, work, inputs))
+        : invokeSlice(frame, slice, work, inputs);
+}
+async function invokeSlice(frame, slice, work, inputs) {
+    if (frame.controller.signal.aborted)
+        throw frame.controller.signal.reason;
+    const cleanups = [];
+    const context = {
+        signal: frame.controller.signal,
+        generation: 1,
+        activation: 'initialization',
+        peek: (read) => read(),
+        optimistic: (update) => update(),
+        cleanup(cleanup) {
+            cleanups.push(cleanup);
+        },
+        own(resource) {
+            cleanups.push(() => {
+                if (Symbol.asyncDispose in resource)
+                    return Promise.resolve(resource[Symbol.asyncDispose]());
+                resource[Symbol.dispose]();
+            });
+            return resource;
+        }
+    };
+    let result;
+    let failure;
+    try {
+        const invoke = async () => Promise.resolve(work(...inputs, context));
+        result = frame.options.runTask ? await frame.options.runTask(invoke) : await invoke();
+        for (const [port, path] of slice[1])
+            publishPort(frame, port, readPath(frame.host.state, path));
+    }
+    catch (error) {
+        failure = error;
+        for (const [port] of slice[1])
+            failPort(frame, port, error);
+    }
+    finally {
+        for (let index = cleanups.length - 1; index >= 0; index--) {
+            try {
+                await cleanups[index]();
+            }
+            catch (cleanupError) {
+                if (failure && typeof failure === 'object')
+                    Object.defineProperty(failure, 'suppressed', {
+                        configurable: true,
+                        value: cleanupError
+                    });
+                else
+                    failure = cleanupError;
+            }
+        }
+    }
+    if (failure !== undefined)
+        throw failure;
+    return result;
+}
+function outputSlot(frame, port) {
+    let slot = frame.ports[port];
+    if (!slot) {
+        slot = { status: 'pending' };
+        frame.ports[port] = slot;
+    }
+    return slot;
+}
+function registerOutputPath(frame, path, port) {
+    for (let index = 0; index < frame.paths.length; index++) {
+        if (frame.paths[index][0] !== path)
+            continue;
+        frame.paths[index] = [path, port];
+        return;
+    }
+    frame.paths.push([path, port]);
+}
+function waitForSlot(slot) {
+    if (slot.status === 'available')
+        return Promise.resolve(slot.value);
+    if (slot.status === 'failed')
+        return Promise.reject(slot.error);
+    return new Promise((resolve, reject) => (slot.waiters ??= new Set()).add({ resolve, reject }));
+}
+function publishPort(frame, port, value) {
+    const slot = outputSlot(frame, port);
+    slot.status = 'available';
+    slot.value = value;
+    for (const waiter of slot.waiters ?? [])
+        waiter.resolve(value);
+    slot.waiters?.clear();
+    for (const subscriber of slot.subscribers ?? [])
+        subscriber();
+}
+function failPort(frame, port, error) {
+    const slot = outputSlot(frame, port);
+    slot.status = 'failed';
+    slot.error = error;
+    for (const waiter of slot.waiters ?? [])
+        waiter.reject(error);
+    slot.waiters?.clear();
+    for (const subscriber of slot.subscribers ?? [])
+        subscriber();
+}
+function readPath(source, path) {
+    let value = source;
+    for (const segment of path) {
+        if (!value || typeof value !== 'object')
+            return undefined;
+        value = value[segment];
+    }
+    return value;
+}
+//# sourceMappingURL=server-component-execution.js.map

package/dist/tasks/server-component-execution.js.map

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

package/dist/tasks/server-component-resources.d.ts

@@ -0,0 +1,5 @@
+/** Awaits compiler-closed server work with request cancellation and no durable task frame. */
+export declare function awaitServerComponentTask<T>(signal: AbortSignal, value: T | PromiseLike<T>): Promise<T>;
+/** Owns a timeout directly by the request-local server execution signal. */
+export declare function serverComponentTaskTimeout<Args extends unknown[]>(signal: AbortSignal, handler: (...args: Args) => void, delay?: number, ...args: Args): ReturnType<typeof setTimeout>;
+//# sourceMappingURL=server-component-resources.d.ts.map

package/dist/tasks/server-component-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-component-resources.d.ts","sourceRoot":"","sources":["../../src/tasks/server-component-resources.ts"],"names":[],"mappings":"AAEA,8FAA8F;AAC9F,wBAAgB,wBAAwB,CAAC,CAAC,EACzC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAEZ;AAED,4EAA4E;AAC5E,wBAAgB,0BAA0B,CAAC,IAAI,SAAS,OAAO,EAAE,EAChE,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,EAChC,KAAK,CAAC,EAAE,MAAM,EACd,GAAG,IAAI,EAAE,IAAI,GACX,UAAU,CAAC,OAAO,UAAU,CAAC,CAa/B"}

package/dist/tasks/server-component-resources.js

@@ -0,0 +1,20 @@
+import { raceTaskCancellation } from './cancellation.js';
+/** Awaits compiler-closed server work with request cancellation and no durable task frame. */
+export function awaitServerComponentTask(signal, value) {
+    return raceTaskCancellation(signal, value);
+}
+/** Owns a timeout directly by the request-local server execution signal. */
+export function serverComponentTaskTimeout(signal, handler, delay, ...args) {
+    const abort = () => clearTimeout(timeout);
+    const timeout = setTimeout((...values) => {
+        signal.removeEventListener('abort', abort);
+        if (!signal.aborted)
+            handler(...values);
+    }, delay, ...args);
+    if (signal.aborted)
+        abort();
+    else
+        signal.addEventListener('abort', abort, { once: true });
+    return timeout;
+}
+//# sourceMappingURL=server-component-resources.js.map

package/dist/tasks/server-component-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-component-resources.js","sourceRoot":"","sources":["../../src/tasks/server-component-resources.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,8FAA8F;AAC9F,MAAM,UAAU,wBAAwB,CACvC,MAAmB,EACnB,KAAyB;IAEzB,OAAO,oBAAoB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,0BAA0B,CACzC,MAAmB,EACnB,OAAgC,EAChC,KAAc,EACd,GAAG,IAAU;IAEb,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,UAAU,CACzB,CAAC,GAAG,MAAY,EAAE,EAAE;QACnB,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IACzC,CAAC,EACD,KAAK,EACL,GAAG,IAAI,CACP,CAAC;IACF,IAAI,MAAM,CAAC,OAAO;QAAE,KAAK,EAAE,CAAC;;QACvB,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,OAAO,OAAO,CAAC;AAChB,CAAC"}

package/dist/tasks/server-task-readiness.d.ts

@@ -0,0 +1,29 @@
+/** Task-system-owned settlement state read by consumers without awaiting completed work. */
+export declare class ServerTaskReadiness {
+    private readonly pending;
+    private readonly identities?;
+    private failure?;
+    private failures?;
+    private selectedRevisions?;
+    private revision;
+    /** Allocates identity lookup only for compiler plans that issue selected readiness queries. */
+    constructor(trackIdentities?: boolean);
+    /** Counts completed blocking activations so consumers can detect changes during publication. */
+    get version(): number;
+    /** Observes already-started work; this boundary never invokes or schedules a task. */
+    observe(settlement: Promise<unknown>, transitionId?: string): void;
+    /**
+     * Returns no wait for settled work, or waits for the currently pending selected activations.
+     * Omitted selection includes all work. Unidentified work always participates because no caller
+     * can prove it unrelated. Callers recheck after settlement to include subsequently issued work.
+     */
+    wait(transitions?: ReadonlySet<string>): Promise<void> | undefined;
+    /**
+     * Snapshots completion changes for compiler-selected identities. Tracking starts lazily on first
+     * use; the number is a request-local change token, not an absolute activation count. Unknown
+     * identities participate in every selection. Unrelated task completions do not change the token.
+     */
+    versionFor(transitions: ReadonlySet<string>): number;
+    private advanceSelectedRevision;
+}
+//# sourceMappingURL=server-task-readiness.d.ts.map

package/dist/tasks/server-task-readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-task-readiness.d.ts","sourceRoot":"","sources":["../../src/tasks/server-task-readiness.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,qBAAa,mBAAmB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAgD;IAC5E,OAAO,CAAC,OAAO,CAAC,CAAqB;IACrC,OAAO,CAAC,QAAQ,CAAC,CAA8C;IAC/D,OAAO,CAAC,iBAAiB,CAAC,CAAkC;IAC5D,OAAO,CAAC,QAAQ,CAAK;IAErB,+FAA+F;gBACnF,eAAe,UAAQ;IAInC,gGAAgG;IAChG,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,sFAAsF;IACtF,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAsBlE;;;;OAIG;IACH,IAAI,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS;IAiBlE;;;;OAIG;IACH,UAAU,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,MAAM;IAQpD,OAAO,CAAC,uBAAuB;CAI/B"}

package/dist/tasks/server-task-readiness.js

@@ -0,0 +1,84 @@
+/** Task-system-owned settlement state read by consumers without awaiting completed work. */
+export class ServerTaskReadiness {
+    pending = new Set();
+    identities;
+    failure;
+    failures;
+    selectedRevisions;
+    revision = 0;
+    /** Allocates identity lookup only for compiler plans that issue selected readiness queries. */
+    constructor(trackIdentities = false) {
+        if (trackIdentities)
+            this.identities = new WeakMap();
+    }
+    /** Counts completed blocking activations so consumers can detect changes during publication. */
+    get version() {
+        return this.revision;
+    }
+    /** Observes already-started work; this boundary never invokes or schedules a task. */
+    observe(settlement, transitionId) {
+        this.pending.add(settlement);
+        this.identities?.set(settlement, transitionId);
+        void settlement.then(() => {
+            this.pending.delete(settlement);
+            this.revision++;
+            this.advanceSelectedRevision(transitionId);
+        }, (error) => {
+            this.pending.delete(settlement);
+            this.revision++;
+            this.advanceSelectedRevision(transitionId);
+            this.failure ??= { error };
+            if (this.identities) {
+                const failures = (this.failures ??= new Map());
+                if (!failures.has(transitionId))
+                    failures.set(transitionId, { error });
+            }
+        });
+    }
+    /**
+     * Returns no wait for settled work, or waits for the currently pending selected activations.
+     * Omitted selection includes all work. Unidentified work always participates because no caller
+     * can prove it unrelated. Callers recheck after settlement to include subsequently issued work.
+     */
+    wait(transitions) {
+        if (!transitions) {
+            if (this.failure)
+                throw this.failure.error;
+            if (!this.pending.size)
+                return undefined;
+            return Promise.all(this.pending).then(() => undefined);
+        }
+        if (!this.identities)
+            throw new Error('Selected task readiness requires identity tracking');
+        for (const [identity, failure] of this.failures ?? [])
+            if (identity === undefined || transitions.has(identity))
+                throw failure.error;
+        let selected;
+        for (const settlement of this.pending) {
+            const identity = this.identities.get(settlement);
+            if (identity === undefined || transitions.has(identity))
+                (selected ??= []).push(settlement);
+        }
+        return selected ? Promise.all(selected).then(() => undefined) : undefined;
+    }
+    /**
+     * Snapshots completion changes for compiler-selected identities. Tracking starts lazily on first
+     * use; the number is a request-local change token, not an absolute activation count. Unknown
+     * identities participate in every selection. Unrelated task completions do not change the token.
+     */
+    versionFor(transitions) {
+        if (!this.identities)
+            throw new Error('Selected task readiness requires identity tracking');
+        const revisions = (this.selectedRevisions ??= new Map());
+        let version = revisions.get(undefined) ?? 0;
+        for (const identity of transitions)
+            version += revisions.get(identity) ?? 0;
+        return version;
+    }
+    advanceSelectedRevision(identity) {
+        const revisions = this.selectedRevisions;
+        if (revisions)
+            revisions.set(identity, (revisions.get(identity) ?? 0) + 1);
+    }
+}
+//# sourceMappingURL=server-task-readiness.js.map

package/dist/tasks/server-task-readiness.js.map

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

package/dist/tasks/signals.d.ts

@@ -0,0 +1,29 @@
+/** Event-listener options augmented with framework-owned cancellation. */
+export type ManagedEventListenerOptions = EventListenerOptions & {
+    once?: boolean;
+    passive?: boolean;
+    signal?: AbortSignal;
+};
+/** Returns whether an unknown value implements the AbortSignal contract. */
+export declare function isAbortSignal(value: unknown): value is AbortSignal;
+/**
+ * Combines two abort signals while preserving the reason from the first abort.
+ */
+export declare function combineAbortSignals(left: AbortSignal, right: AbortSignal): AbortSignal;
+/**
+ * Combines two signals and returns explicit listener ownership for finite operations.
+ * Callers must dispose the handle when their operation settles before either input aborts.
+ */
+export declare function createDisposableAbortSignal(left: AbortSignal, right: AbortSignal): Readonly<{
+    signal: AbortSignal;
+    dispose(): void;
+}>;
+/** Combines an author signal with the signal that owns a task generation. */
+export declare function combineTaskSignal(owner: AbortSignal, existing?: AbortSignal): AbortSignal;
+/** Attaches framework ownership without discarding author event options. */
+export declare function withAbortSignal(options: boolean | ManagedEventListenerOptions | undefined, owner: AbortSignal): ManagedEventListenerOptions;
+/** Adds task cancellation to an arbitrary API options object. */
+export declare function withTaskSignal<T extends object | undefined>(options: T, owner: AbortSignal): T & {
+    signal: AbortSignal;
+};
+//# sourceMappingURL=signals.d.ts.map

package/dist/tasks/signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/tasks/signals.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,MAAM,2BAA2B,GAAG,oBAAoB,GAAG;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAOlE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,GAAG,WAAW,CAqBtF;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAC1C,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,WAAW,GAChB,QAAQ,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,IAAI,IAAI,CAAA;CAAE,CAAC,CAwBpD;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,WAAW,CAGzF;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAC9B,OAAO,EAAE,OAAO,GAAG,2BAA2B,GAAG,SAAS,EAC1D,KAAK,EAAE,WAAW,GAChB,2BAA2B,CAM7B;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAC1D,OAAO,EAAE,CAAC,EACV,KAAK,EAAE,WAAW,GAChB,CAAC,GAAG;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,CAQ7B"}