@exactjs/core 0.5.0

package/dist/client/tasks/contracts.d.ts

@@ -0,0 +1,82 @@
+/** Describes why a task generation began. */
+export type TaskActivation = 'initialization' | 'reactive' | 'interaction' | 'invoked' | 'lifecycle';
+/** Capabilities scoped to one task frame. */
+export interface TaskContext {
+    readonly signal: AbortSignal;
+    readonly generation: number;
+    readonly activation: TaskActivation;
+    peek<T>(read: () => T): T;
+    optimistic(work: () => void): void;
+    cleanup(cleanup: () => void | Promise<void>): void;
+    own<T extends Disposable | AsyncDisposable>(resource: T): T;
+}
+/**
+ * Declarative task policy accepted only as the default value of a final
+ * {@link TaskContext} parameter in compiler-authored source.
+ */
+export interface TaskContextPolicy extends TaskContext {
+    client(): TaskContextPolicy;
+    server(): TaskContextPolicy;
+    parallel(): TaskContextPolicy;
+    latest(): TaskContextPolicy;
+    queue(): TaskContextPolicy;
+    key<T>(value: T): TaskContextPolicy;
+    immediate(): TaskContextPolicy;
+    normal(): TaskContextPolicy;
+    deferred(): TaskContextPolicy;
+    blocking(): TaskContextPolicy;
+    nonblocking(): TaskContextPolicy;
+    detached(): TaskContextPolicy;
+}
+/** Durable cancellation and concurrency ownership for task generations. */
+export interface TaskOwner extends AsyncDisposable {
+    readonly signal: AbortSignal;
+}
+/** Owner-bound observable state for one task definition. */
+export interface TaskStatus<Result> {
+    readonly pending: boolean;
+    readonly pendingCount: number;
+    readonly generation: number;
+    readonly result: Result | undefined;
+    readonly error: unknown;
+    cancel(reason?: unknown): void;
+}
+/** A thenable whose result settles only after its attached task subtree. */
+export interface TaskInvocation<Result> extends PromiseLike<Result> {
+    then<TResult1 = Result, TResult2 = never>(onFulfilled?: ((value: Result) => TResult1 | PromiseLike<TResult1>) | null, onRejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): TaskInvocation<TResult1 | TResult2>;
+    catch<TResult = never>(onRejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): TaskInvocation<Result | TResult>;
+    finally(onFinally?: (() => void) | null): TaskInvocation<Result>;
+    readonly [Symbol.toStringTag]: 'TaskInvocation';
+}
+/** Callable runtime task definition. */
+export interface TaskFunction<Args extends unknown[], Result> {
+    (...args: Args): TaskInvocation<Result>;
+}
+/** Existential task function retained where authored argument tuples are not inspected. */
+export type AnyTaskFunction<Result = unknown> = TaskFunction<any[], Result>;
+/** Owner-bound task callable with aggregate status. */
+export interface BoundTaskFunction<Args extends unknown[], Result> extends TaskFunction<Args, Result>, TaskStatus<Result> {
+}
+/** Runtime policy required when an integration defines a task outside compiled component source. */
+export interface RuntimeTaskOptions<Args extends unknown[]> {
+    readonly label?: string;
+    readonly placement?: 'current' | 'client' | 'server';
+    readonly priority?: 'immediate' | 'normal' | 'deferred';
+    readonly concurrency?: 'parallel' | 'latest' | 'queue';
+    readonly concurrencyKey?: (...args: Args) => unknown;
+    /**
+     * Compiler-generated resolver for defaulted task parameters. It evaluates
+     * omitted defaults once per generation without subscribing the task to
+     * reactive reads performed while resolving them.
+     */
+    readonly captureArguments?: (args: unknown[]) => readonly unknown[];
+    readonly readiness?: 'blocking' | 'nonblocking';
+    readonly detached?: boolean;
+    readonly owner?: TaskOwner;
+}
+/** Reserved callback that must run or be explicitly released exactly once. */
+export interface ReservedTaskCallback<Args extends unknown[], Result> extends Disposable {
+    (...args: Args): Result;
+    cancel(reason?: unknown): void;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/client/tasks/contracts.d.ts.map

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

package/dist/client/tasks/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/client/tasks/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/tasks/contracts.ts"],"names":[],"mappings":""}

package/dist/client/tasks/definition-record.d.ts

@@ -0,0 +1,14 @@
+import type { RuntimeTaskOptions, TaskContext } from './contracts.js';
+import type { TaskOwnerRecord } from './frame-contracts.js';
+import type { InternalTaskOwnerState } from './runtime-types.js';
+/** Private property key connecting a callable task facade to its stable definition. */
+export declare const taskDefinitionBrand: unique symbol;
+/** Stable task definition shared by every owner-specific runtime state. */
+export type TaskDefinition<Args extends unknown[], Result> = {
+    readonly [taskDefinitionBrand]: true;
+    readonly options: RuntimeTaskOptions<Args>;
+    readonly implementation: (...args: [...Args, TaskContext]) => Result | Promise<Result>;
+    readonly sourceEntityId?: string;
+    readonly owners: WeakMap<TaskOwnerRecord, InternalTaskOwnerState<Result>>;
+};
+//# sourceMappingURL=definition-record.d.ts.map

package/dist/client/tasks/definition-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-record.d.ts","sourceRoot":"","sources":["../../../src/tasks/definition-record.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,uFAAuF;AACvF,eAAO,MAAM,mBAAmB,eAAkC,CAAC;AAEnE,2EAA2E;AAC3E,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,IAAI;IAC5D,QAAQ,CAAC,CAAC,mBAAmB,CAAC,EAAE,IAAI,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;CAC1E,CAAC"}

package/dist/client/tasks/definition-record.js

@@ -0,0 +1,3 @@
+/** Private property key connecting a callable task facade to its stable definition. */
+export const taskDefinitionBrand = Symbol('exact.task-definition');
+//# sourceMappingURL=definition-record.js.map

package/dist/client/tasks/definition-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-record.js","sourceRoot":"","sources":["../../../src/tasks/definition-record.ts"],"names":[],"mappings":"AAIA,uFAAuF;AACvF,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC"}

package/dist/client/tasks/dependency-provenance.d.ts

@@ -0,0 +1,6 @@
+import type { ContinuationDependencySource } from './dependency-source.js';
+/** Associates one compiler-created reactive value with its unresolved execution source. */
+export declare function markContinuationDependencyValue<T>(value: T, source: ContinuationDependencySource): T;
+/** Returns the unresolved execution source propagated with a compiler-created value. */
+export declare function continuationDependencyForValue(value: unknown): ContinuationDependencySource | undefined;
+//# sourceMappingURL=dependency-provenance.d.ts.map

package/dist/client/tasks/dependency-provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-provenance.d.ts","sourceRoot":"","sources":["../../../src/tasks/dependency-provenance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAI3E,2FAA2F;AAC3F,wBAAgB,+BAA+B,CAAC,CAAC,EAChD,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,4BAA4B,GAClC,CAAC,CAIH;AAED,wFAAwF;AACxF,wBAAgB,8BAA8B,CAC7C,KAAK,EAAE,OAAO,GACZ,4BAA4B,GAAG,SAAS,CAI1C"}

package/dist/client/tasks/dependency-provenance.js

@@ -0,0 +1,14 @@
+const sources = new WeakMap();
+/** Associates one compiler-created reactive value with its unresolved execution source. */
+export function markContinuationDependencyValue(value, source) {
+    if ((typeof value === 'object' && value !== null) || typeof value === 'function')
+        sources.set(value, source);
+    return value;
+}
+/** Returns the unresolved execution source propagated with a compiler-created value. */
+export function continuationDependencyForValue(value) {
+    if (!((typeof value === 'object' && value !== null) || typeof value === 'function'))
+        return undefined;
+    return sources.get(value);
+}
+//# sourceMappingURL=dependency-provenance.js.map

package/dist/client/tasks/dependency-provenance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-provenance.js","sourceRoot":"","sources":["../../../src/tasks/dependency-provenance.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAG,IAAI,OAAO,EAAwC,CAAC;AAEpE,2FAA2F;AAC3F,MAAM,UAAU,+BAA+B,CAC9C,KAAQ,EACR,MAAoC;IAEpC,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,OAAO,KAAK,KAAK,UAAU;QAC/E,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5B,OAAO,KAAK,CAAC;AACd,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,8BAA8B,CAC7C,KAAc;IAEd,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;QAClF,OAAO,SAAS,CAAC;IAClB,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/client/tasks/dependency-source.d.ts

@@ -0,0 +1,68 @@
+import { type ReactiveValue } from '@exactjs/reactive/framework/runtime';
+/** A dependency value together with the generation and publication version that produced it. */
+export type ContinuationDependencySnapshot<T> = Readonly<{
+    status: 'pending';
+    generation: number;
+    version: number;
+}> | Readonly<{
+    status: 'available';
+    generation: number;
+    version: number;
+    value: T;
+}> | Readonly<{
+    status: 'failed';
+    generation: number;
+    version: number;
+    error: unknown;
+}> | Readonly<{
+    status: 'cancelled';
+    generation: number;
+    version: number;
+    reason?: unknown;
+}>;
+/**
+ * Supplies one compiler-identified continuation dependency.
+ *
+ * Implementations notify after their snapshot changes. Consumers must read a complete snapshot
+ * after notification instead of treating the notification itself as a value publication.
+ */
+export interface ContinuationDependencySource<T = unknown> {
+    read(): ContinuationDependencySnapshot<T>;
+    subscribe(notify: () => void): Disposable;
+}
+/** A writable dependency source used to connect one continuation's output to its consumers. */
+export interface ContinuationDependencySlot<T> extends ContinuationDependencySource<T> {
+    /** Starts a generation whose value is not yet available and invalidates the prior generation. */
+    beginGeneration(): number;
+    /** Publishes a value only when the supplied generation is still current. */
+    publish(generation: number, value: T): boolean;
+    /** Terminates a generation with failure only when it is still current. */
+    fail(generation: number, error: unknown): boolean;
+    /** Terminates a generation through cancellation only when it is still current. */
+    cancel(generation: number, reason?: unknown): boolean;
+}
+/** Creates an immutable dependency that is available from construction. */
+export declare function constantContinuationDependency<T>(value: T): ContinuationDependencySource<T>;
+/**
+ * Adapts an authored activation input to the dependency protocol.
+ *
+ * Reactive values and reactive objects remain available while their publication version advances;
+ * constants retain the same snapshot for the lifetime of the activation.
+ */
+export declare function activationInputDependency<T>(input: T | ReactiveValue<T> | ContinuationDependencySource<T>): ContinuationDependencySource<T>;
+/**
+ * Creates the compiler-owned dependency source for one statically placed activation input.
+ *
+ * The source reuses ordinary reactive dependency tracking and publishes only when the projected
+ * value changes. Unlike a public computed value, it has no downstream computation graph, value
+ * facade, inspection record, or settlement traversal; its sole owner is the activation watcher
+ * that disposes the subscription with the component.
+ */
+export declare function createTrackedContinuationDependency<T>(compute: () => T): ContinuationDependencySource<T>;
+/** Creates a compiler-owned dependency source for one exact indexed state or prop slot. */
+export declare function createIndexedContinuationDependency<T = never>(input: object, index: number): ContinuationDependencySource<T>;
+/** Returns only a compiler-propagated dependency source without evaluating an ordinary value. */
+export declare function plannedContinuationDependency<T>(input: T): ContinuationDependencySource<unknown> | undefined;
+/** Creates a pending output slot whose generations are explicitly published by a producer. */
+export declare function createContinuationDependencySlot<T>(): ContinuationDependencySlot<T>;
+//# sourceMappingURL=dependency-source.d.ts.map

package/dist/client/tasks/dependency-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-source.d.ts","sourceRoot":"","sources":["../../../src/tasks/dependency-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAWN,KAAK,aAAa,EAClB,MAAM,qCAAqC,CAAC;AAG7C,gGAAgG;AAChG,MAAM,MAAM,8BAA8B,CAAC,CAAC,IACzC,QAAQ,CAAC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACpE,QAAQ,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC,GAChF,QAAQ,CAAC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,GACnF,QAAQ,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAE5F;;;;;GAKG;AACH,MAAM,WAAW,4BAA4B,CAAC,CAAC,GAAG,OAAO;IACxD,IAAI,IAAI,8BAA8B,CAAC,CAAC,CAAC,CAAC;IAC1C,SAAS,CAAC,MAAM,EAAE,MAAM,IAAI,GAAG,UAAU,CAAC;CAC1C;AAED,+FAA+F;AAC/F,MAAM,WAAW,0BAA0B,CAAC,CAAC,CAAE,SAAQ,4BAA4B,CAAC,CAAC,CAAC;IACrF,iGAAiG;IACjG,eAAe,IAAI,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC;IAC/C,0EAA0E;IAC1E,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAClD,kFAAkF;IAClF,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CACtD;AAED,2EAA2E;AAC3E,wBAAgB,8BAA8B,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,4BAA4B,CAAC,CAAC,CAAC,CAW3F;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAC1C,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,4BAA4B,CAAC,CAAC,CAAC,GAC3D,4BAA4B,CAAC,CAAC,CAAC,CASjC;AAED;;;;;;;GAOG;AACH,wBAAgB,mCAAmC,CAAC,CAAC,EACpD,OAAO,EAAE,MAAM,CAAC,GACd,4BAA4B,CAAC,CAAC,CAAC,CAIjC;AAED,2FAA2F;AAC3F,wBAAgB,mCAAmC,CAAC,CAAC,GAAG,KAAK,EAC5D,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACX,4BAA4B,CAAC,CAAC,CAAC,CAIjC;AAED,iGAAiG;AACjG,wBAAgB,6BAA6B,CAAC,CAAC,EAC9C,KAAK,EAAE,CAAC,GACN,4BAA4B,CAAC,OAAO,CAAC,GAAG,SAAS,CAEnD;AAED,8FAA8F;AAC9F,wBAAgB,gCAAgC,CAAC,CAAC,KAAK,0BAA0B,CAAC,CAAC,CAAC,CAqCnF"}

package/dist/client/tasks/dependency-source.js

@@ -0,0 +1,283 @@
+import { isReactiveValue, peekIndexedReactiveSlot, readIndexedReactiveSource, reactiveIndexedDependencies, ref as reactiveRef, subscribe, subscribeKeys, unwrap, watch } from '@exactjs/reactive/framework/runtime';
+import { continuationDependencyForValue } from './dependency-provenance.js';
+/** Creates an immutable dependency that is available from construction. */
+export function constantContinuationDependency(value) {
+    const snapshot = {
+        status: 'available',
+        generation: 0,
+        version: 0,
+        value
+    };
+    return {
+        read: () => snapshot,
+        subscribe: () => inertDisposable
+    };
+}
+/**
+ * Adapts an authored activation input to the dependency protocol.
+ *
+ * Reactive values and reactive objects remain available while their publication version advances;
+ * constants retain the same snapshot for the lifetime of the activation.
+ */
+export function activationInputDependency(input) {
+    if (compilerContinuationDependencies.has(input))
+        return input;
+    const value = input;
+    const planned = continuationDependencyForValue(value);
+    if (planned)
+        return planned;
+    const source = reactiveRef(value);
+    if (!source)
+        return constantContinuationDependency(value);
+    return reactiveContinuationDependency(value, source);
+}
+/**
+ * Creates the compiler-owned dependency source for one statically placed activation input.
+ *
+ * The source reuses ordinary reactive dependency tracking and publishes only when the projected
+ * value changes. Unlike a public computed value, it has no downstream computation graph, value
+ * facade, inspection record, or settlement traversal; its sole owner is the activation watcher
+ * that disposes the subscription with the component.
+ */
+export function createTrackedContinuationDependency(compute) {
+    const dependency = new TrackedContinuationDependency(compute);
+    compilerContinuationDependencies.add(dependency);
+    return dependency;
+}
+/** Creates a compiler-owned dependency source for one exact indexed state or prop slot. */
+export function createIndexedContinuationDependency(input, index) {
+    const dependency = new IndexedContinuationDependency(input, index);
+    compilerContinuationDependencies.add(dependency);
+    return dependency;
+}
+/** Returns only a compiler-propagated dependency source without evaluating an ordinary value. */
+export function plannedContinuationDependency(input) {
+    return continuationDependencyForValue(input);
+}
+/** Creates a pending output slot whose generations are explicitly published by a producer. */
+export function createContinuationDependencySlot() {
+    let generation = 0;
+    let version = 0;
+    let snapshot = { status: 'pending', generation, version };
+    const subscribers = new DependencySubscribers();
+    const publishSnapshot = (next) => {
+        snapshot = next;
+        subscribers.notify();
+    };
+    return {
+        read: () => snapshot,
+        subscribe(notify) {
+            return subscribers.subscribe(notify);
+        },
+        beginGeneration() {
+            generation++;
+            version = 0;
+            publishSnapshot({ status: 'pending', generation, version });
+            return generation;
+        },
+        publish(candidateGeneration, value) {
+            if (candidateGeneration !== generation)
+                return false;
+            if (snapshot.status === 'available' && Object.is(snapshot.value, value))
+                return false;
+            publishSnapshot({ status: 'available', generation, version: ++version, value });
+            return true;
+        },
+        fail(candidateGeneration, error) {
+            if (candidateGeneration !== generation)
+                return false;
+            publishSnapshot({ status: 'failed', generation, version: ++version, error });
+            return true;
+        },
+        cancel(candidateGeneration, reason) {
+            if (candidateGeneration !== generation)
+                return false;
+            publishSnapshot({ status: 'cancelled', generation, version: ++version, reason });
+            return true;
+        }
+    };
+}
+function reactiveContinuationDependency(input, source) {
+    let version = 0;
+    let dirty = true;
+    let snapshot;
+    return {
+        read() {
+            if (dirty) {
+                snapshot = {
+                    status: 'available',
+                    generation: 0,
+                    version,
+                    value: (isReactiveValue(input) ? unwrap(input) : input)
+                };
+                dirty = false;
+            }
+            return snapshot;
+        },
+        subscribe(notify) {
+            return disposable(subscribe(source, () => {
+                version++;
+                dirty = true;
+                notify();
+            }));
+        }
+    };
+}
+const inertDisposable = { [Symbol.dispose]() { } };
+const compilerContinuationDependencies = new WeakSet();
+class TrackedContinuationDependency {
+    compute;
+    initialized = false;
+    notify;
+    value;
+    version = 0;
+    stop;
+    evaluate = () => {
+        const next = unwrap(this.compute());
+        if (this.initialized && Object.is(this.value, next))
+            return;
+        const publish = this.initialized;
+        this.initialized = true;
+        this.value = next;
+        if (publish) {
+            this.version++;
+            this.notify?.();
+        }
+    };
+    constructor(compute) {
+        this.compute = compute;
+    }
+    read() {
+        if (!this.initialized)
+            this.evaluate();
+        return { status: 'available', generation: 0, version: this.version, value: this.value };
+    }
+    subscribe(notify) {
+        if (this.notify)
+            throw new Error('Compiler-owned continuation dependencies support one active owner');
+        this.notify = notify;
+        try {
+            this.stop = watch(this.evaluate);
+        }
+        catch (error) {
+            this.notify = undefined;
+            throw error;
+        }
+        let active = true;
+        return disposable(() => {
+            if (!active)
+                return;
+            active = false;
+            this.stop?.();
+            this.stop = undefined;
+            this.notify = undefined;
+        });
+    }
+}
+class IndexedContinuationDependency {
+    input;
+    index;
+    target;
+    key;
+    version = 0;
+    constructor(input, index) {
+        this.input = input;
+        this.index = index;
+        const dependency = reactiveIndexedDependencies(input, [index]);
+        if (!dependency)
+            throw new TypeError('Indexed continuation dependency referenced an invalid reactive slot');
+        this.target = dependency.target;
+        this.key = dependency.keys[0];
+    }
+    read() {
+        return {
+            status: 'available',
+            generation: 0,
+            version: this.version,
+            value: peekIndexedReactiveSlot(this.input, this.index)
+        };
+    }
+    subscribe(notify) {
+        let stopValue;
+        const publish = () => {
+            this.version++;
+            notify();
+        };
+        // Props can retain a parent-owned reactive expression inside an unchanged indexed slot.
+        // Observe that source as well as slot replacement, retaining the direct primitive path.
+        const bindValue = () => {
+            stopValue?.();
+            stopValue = undefined;
+            const source = readIndexedReactiveSource(this.input, this.index);
+            if (source.present && isReactiveValue(source.value)) {
+                const ref = reactiveRef(source.value);
+                if (ref)
+                    stopValue = subscribe(ref, publish);
+            }
+        };
+        const stopSlot = subscribeKeys(this.target, [this.key], () => {
+            bindValue();
+            publish();
+        });
+        try {
+            bindValue();
+        }
+        catch (error) {
+            stopSlot();
+            throw error;
+        }
+        return disposable(() => {
+            stopSlot();
+            stopValue?.();
+        });
+    }
+}
+function disposable(dispose) {
+    return { [Symbol.dispose]: dispose };
+}
+class DependencySubscribers {
+    #first;
+    #last;
+    get empty() {
+        return this.#first === undefined;
+    }
+    subscribe(notify) {
+        const subscriber = {
+            notify,
+            active: true,
+            previous: this.#last
+        };
+        if (this.#last)
+            this.#last.next = subscriber;
+        else
+            this.#first = subscriber;
+        this.#last = subscriber;
+        return disposable(() => this.#remove(subscriber));
+    }
+    notify() {
+        const last = this.#last;
+        let subscriber = this.#first;
+        while (subscriber) {
+            const next = subscriber.next;
+            if (subscriber.active)
+                subscriber.notify();
+            if (subscriber === last)
+                return;
+            subscriber = next;
+        }
+    }
+    #remove(subscriber) {
+        if (!subscriber.active)
+            return;
+        subscriber.active = false;
+        if (subscriber.previous)
+            subscriber.previous.next = subscriber.next;
+        else
+            this.#first = subscriber.next;
+        if (subscriber.next)
+            subscriber.next.previous = subscriber.previous;
+        else
+            this.#last = subscriber.previous;
+    }
+}
+//# sourceMappingURL=dependency-source.js.map

package/dist/client/tasks/dependency-source.js.map

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

package/dist/client/tasks/dependency-watcher.d.ts

@@ -0,0 +1,21 @@
+import type { ContinuationDependencySnapshot, ContinuationDependencySource } from './dependency-source.js';
+/** Values and publication identities captured atomically for one continuation issue. */
+export type ContinuationDependencyVector = Readonly<{
+    values: readonly unknown[];
+}>;
+/** Observes all dependencies for one authored continuation invocation. */
+export type ContinuationDependencyWatcher = Disposable & {
+    /** Reads and evaluates dependencies synchronously, primarily for initial host setup. */
+    evaluate(): void;
+};
+/**
+ * Watches one continuation invocation and issues it only when every dependency is available.
+ *
+ * Notifications within one turn are coalesced. A pending or terminal dependency invalidates active
+ * work immediately; failure and cancellation are reported without leaving downstream work pending.
+ */
+export declare function watchContinuationDependencies(sources: readonly ContinuationDependencySource[], callbacks: Readonly<{
+    onReady(vector: ContinuationDependencyVector): void;
+    onUnavailable(state: Exclude<ContinuationDependencySnapshot<unknown>['status'], 'available'>, snapshot: ContinuationDependencySnapshot<unknown>): void;
+}>): ContinuationDependencyWatcher;
+//# sourceMappingURL=dependency-watcher.d.ts.map

package/dist/client/tasks/dependency-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-watcher.d.ts","sourceRoot":"","sources":["../../../src/tasks/dependency-watcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,8BAA8B,EAC9B,4BAA4B,EAC5B,MAAM,wBAAwB,CAAC;AAIhC,wFAAwF;AACxF,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC;IACnD,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CAC3B,CAAC,CAAC;AAEH,0EAA0E;AAC1E,MAAM,MAAM,6BAA6B,GAAG,UAAU,GAAG;IACxD,wFAAwF;IACxF,QAAQ,IAAI,IAAI,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE,SAAS,4BAA4B,EAAE,EAChD,SAAS,EAAE,QAAQ,CAAC;IACnB,OAAO,CAAC,MAAM,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACpD,aAAa,CACZ,KAAK,EAAE,OAAO,CAAC,8BAA8B,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,EAC9E,QAAQ,EAAE,8BAA8B,CAAC,OAAO,CAAC,GAC/C,IAAI,CAAC;CACR,CAAC,GACA,6BAA6B,CAuD/B"}

package/dist/client/tasks/dependency-watcher.js

@@ -0,0 +1,70 @@
+import { scheduleWork } from '@exactjs/reactive/framework/runtime';
+const noDependencyValues = Object.freeze([]);
+/**
+ * Watches one continuation invocation and issues it only when every dependency is available.
+ *
+ * Notifications within one turn are coalesced. A pending or terminal dependency invalidates active
+ * work immediately; failure and cancellation are reported without leaving downstream work pending.
+ */
+export function watchContinuationDependencies(sources, callbacks) {
+    let disposed = false;
+    let scheduled = false;
+    let ready = false;
+    const generations = Array(sources.length).fill(-1);
+    const versions = Array(sources.length).fill(-1);
+    const nextGenerations = Array(sources.length);
+    const nextVersions = Array(sources.length);
+    const nextValues = Array(sources.length);
+    const evaluate = () => {
+        scheduled = false;
+        if (disposed)
+            return;
+        let changed = !ready;
+        for (let index = 0; index < sources.length; index++) {
+            const snapshot = sources[index].read();
+            if (snapshot.status !== 'available') {
+                ready = false;
+                callbacks.onUnavailable(snapshot.status, snapshot);
+                return;
+            }
+            nextGenerations[index] = snapshot.generation;
+            nextVersions[index] = snapshot.version;
+            nextValues[index] = snapshot.value;
+            if (snapshot.generation !== generations[index] || snapshot.version !== versions[index])
+                changed = true;
+        }
+        if (!changed)
+            return;
+        ready = true;
+        const values = sources.length ? new Array(sources.length) : undefined;
+        for (let index = 0; index < sources.length; index++) {
+            generations[index] = nextGenerations[index];
+            versions[index] = nextVersions[index];
+            values[index] = nextValues[index];
+        }
+        callbacks.onReady({ values: values ?? noDependencyValues });
+    };
+    const schedule = () => {
+        if (disposed || scheduled)
+            return;
+        scheduled = true;
+        // The reactive scheduler deduplicates this computation and runs it after every dependency
+        // notification in the current invalidation wave has published its new version.
+        scheduleWork(evaluate);
+    };
+    // Subscribe before the first read so a source cannot publish between observation and ownership.
+    const subscriptions = new Array(sources.length);
+    for (let index = 0; index < sources.length; index++)
+        subscriptions[index] = sources[index].subscribe(schedule);
+    return {
+        evaluate,
+        [Symbol.dispose]() {
+            if (disposed)
+                return;
+            disposed = true;
+            for (const subscription of subscriptions)
+                subscription[Symbol.dispose]();
+        }
+    };
+}
+//# sourceMappingURL=dependency-watcher.js.map

package/dist/client/tasks/dependency-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-watcher.js","sourceRoot":"","sources":["../../../src/tasks/dependency-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAOnE,MAAM,kBAAkB,GAAuB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAajE;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAC5C,OAAgD,EAChD,SAME;IAEF,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,MAAM,WAAW,GAAG,KAAK,CAAS,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAS,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,eAAe,GAAG,KAAK,CAAS,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,KAAK,CAAS,OAAO,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,KAAK,CAAU,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC3B,SAAS,GAAG,KAAK,CAAC;QAClB,IAAI,QAAQ;YAAE,OAAO;QACrB,IAAI,OAAO,GAAG,CAAC,KAAK,CAAC;QACrB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAE,CAAC,IAAI,EAAE,CAAC;YACxC,IAAI,QAAQ,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;gBACrC,KAAK,GAAG,KAAK,CAAC;gBACd,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACnD,OAAO;YACR,CAAC;YACD,eAAe,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC;YAC7C,YAAY,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;YACvC,UAAU,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;YACnC,IAAI,QAAQ,CAAC,UAAU,KAAK,WAAW,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,KAAK,CAAC;gBACrF,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,KAAK,GAAG,IAAI,CAAC;QACb,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAU,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YACrD,WAAW,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,KAAK,CAAE,CAAC;YAC7C,QAAQ,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,CAAE,CAAC;YACvC,MAAO,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,IAAI,kBAAkB,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC;IACF,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC3B,IAAI,QAAQ,IAAI,SAAS;YAAE,OAAO;QAClC,SAAS,GAAG,IAAI,CAAC;QACjB,0FAA0F;QAC1F,+EAA+E;QAC/E,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC,CAAC;IACF,gGAAgG;IAChG,MAAM,aAAa,GAAG,IAAI,KAAK,CAAa,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE;QAClD,aAAa,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5D,OAAO;QACN,QAAQ;QACR,CAAC,MAAM,CAAC,OAAO,CAAC;YACf,IAAI,QAAQ;gBAAE,OAAO;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,KAAK,MAAM,YAAY,IAAI,aAAa;gBAAE,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1E,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/client/tasks/frame-context.d.ts

@@ -0,0 +1,7 @@
+import type { TaskContext } from './contracts.js';
+import type { InternalTaskFrameOptions, TaskFrameRecord } from './frame-contracts.js';
+/** Creates and retains the public context owned by one task frame. */
+export declare function createTaskFrameContext(frame: TaskFrameRecord, options: InternalTaskFrameOptions): TaskContext;
+/** Resolves the opaque frame retained by a task context. */
+export declare function frameForTaskContext(context: TaskContext): TaskFrameRecord;
+//# sourceMappingURL=frame-context.d.ts.map

package/dist/client/tasks/frame-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-context.d.ts","sourceRoot":"","sources":["../../../src/tasks/frame-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAItF,sEAAsE;AACtE,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,wBAAwB,GAC/B,WAAW,CA0Bb;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe,CAKzE"}