@exactjs/core 0.5.0

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

@@ -0,0 +1,31 @@
+import { type ReactiveValue } from '@exactjs/reactive/framework/runtime';
+import type { TaskFunction } from './contracts.js';
+import { type ContinuationDependencySource } from './dependency-source.js';
+type ActivationInput<T> = T | ReactiveValue<T> | ContinuationDependencySource<T>;
+/**
+ * Activates a task during durable host setup and reruns it when one of its
+ * compiler-supplied reactive argument values changes.
+ */
+export declare function activateTask<Args extends unknown[], Result>(task: TaskFunction<Args, Result>, ...inputs: {
+    [Index in keyof Args]: ActivationInput<Args[Index]>;
+}): Disposable;
+/**
+ * Activates compiler-generated setup work against an explicit durable host.
+ *
+ * The explicit host preserves ownership when development module graphs contain
+ * more than one physical copy of the core runtime.
+ */
+export declare function activateTaskForHost<Args extends unknown[], Result>(host: object, task: TaskFunction<Args, Result>, ...inputs: {
+    [Index in keyof Args]: ActivationInput<Args[Index]>;
+}): Disposable;
+/**
+ * Activates compiler-generated continuation work from availability-aware dependency sources.
+ *
+ * This is a framework ABI: application code should use {@link activateTask}. The returned watcher
+ * and all issued task generations are owned by the supplied durable host.
+ */
+export declare function activateTaskFromDependenciesForHost<Args extends unknown[], Result>(host: object, task: TaskFunction<Args, Result>, dependencies: {
+    [Index in keyof Args]: ContinuationDependencySource<Args[Index]>;
+}): Disposable;
+export {};
+//# sourceMappingURL=activation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"activation.d.ts","sourceRoot":"","sources":["../../../src/tasks/activation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAE/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAanD,OAAO,EAEN,KAAK,4BAA4B,EACjC,MAAM,wBAAwB,CAAC;AAOhC,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,4BAA4B,CAAC,CAAC,CAAC,CAAC;AAEjF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EAC1D,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAChC,GAAG,MAAM,EAAE;KAAG,KAAK,IAAI,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;CAAE,GAChE,UAAU,CAKZ;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACjE,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAChC,GAAG,MAAM,EAAE;KAAG,KAAK,IAAI,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;CAAE,GAChE,UAAU,CAIZ;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACjF,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EAChC,YAAY,EAAE;KAAG,KAAK,IAAI,MAAM,IAAI,GAAG,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;CAAE,GAChF,UAAU,CAOZ"}

package/dist/client/tasks/activation.js

@@ -0,0 +1,130 @@
+import { peek } from '@exactjs/reactive/framework/runtime';
+import { currentTaskOwnerRecord, registerTaskOwnerCleanup } from './frame-runtime.js';
+import { taskOwnerForHost } from './owner-hosts.js';
+import { bindTask, invokeTaskForActivation } from './runtime.js';
+import { componentExecutionDependencies, componentExecutionOutputs } from './component-execution-capability.js';
+import { activationInputDependency } from './dependency-source.js';
+import { watchContinuationDependencies } from './dependency-watcher.js';
+import { componentExecutionSliceAllows } from './component-execution-slice.js';
+/**
+ * Activates a task during durable host setup and reruns it when one of its
+ * compiler-supplied reactive argument values changes.
+ */
+export function activateTask(task, ...inputs) {
+    const owner = currentTaskOwnerRecord();
+    if (!owner)
+        throw new Error('activateTask() requires a durable task host during component initialization');
+    return activateOwnedTask(owner, task, inputs);
+}
+/**
+ * Activates compiler-generated setup work against an explicit durable host.
+ *
+ * The explicit host preserves ownership when development module graphs contain
+ * more than one physical copy of the core runtime.
+ */
+export function activateTaskForHost(host, task, ...inputs) {
+    const owner = taskOwnerForHost(host);
+    if (!owner)
+        throw new Error('activateTaskForHost() requires a registered durable task host');
+    return activateOwnedTask(owner, task, inputs);
+}
+/**
+ * Activates compiler-generated continuation work from availability-aware dependency sources.
+ *
+ * This is a framework ABI: application code should use {@link activateTask}. The returned watcher
+ * and all issued task generations are owned by the supplied durable host.
+ */
+export function activateTaskFromDependenciesForHost(host, task, dependencies) {
+    const owner = taskOwnerForHost(host);
+    if (!owner)
+        throw new Error('activateTaskFromDependenciesForHost() requires a registered durable task host');
+    return activateOwnedTaskFromDependencies(owner, task, dependencies);
+}
+function activateOwnedTask(owner, task, inputs) {
+    const dependencies = inputs.map(activationInputDependency);
+    return activateOwnedTaskFromDependencies(owner, task, dependencies);
+}
+function activateOwnedTaskFromDependencies(owner, task, dependencies) {
+    if (!componentExecutionSliceAllows(owner, task))
+        return inertActivation;
+    const bound = bindTask(task, { owner });
+    const activationSite = {};
+    dependencies = componentExecutionDependencies(owner, task, dependencies);
+    let watcher;
+    let releaseDependencyWait;
+    const registration = {
+        task,
+        settled: false,
+        start(skipInitial) {
+            if (watcher)
+                return;
+            let initial = true;
+            const settleDependencyWait = () => {
+                releaseDependencyWait?.();
+                releaseDependencyWait = undefined;
+            };
+            const retainDependencyWait = () => {
+                if (releaseDependencyWait || !owner.observeSettlement)
+                    return;
+                let release;
+                const settlement = new Promise((resolve) => (release = resolve));
+                releaseDependencyWait = release;
+                owner.observeSettlement(settlement);
+            };
+            watcher = watchContinuationDependencies(dependencies, {
+                onReady(vector) {
+                    settleDependencyWait();
+                    if (skipInitial && initial) {
+                        initial = false;
+                        registration.settled = true;
+                        return;
+                    }
+                    const activation = initial ? 'initialization' : 'reactive';
+                    initial = false;
+                    const args = vector.values;
+                    registration.settled = false;
+                    const outputs = componentExecutionOutputs(owner, task);
+                    const invocation = peek(() => invokeTaskForActivation(task, owner, activationSite, activation, args));
+                    void Promise.resolve(invocation).then(() => {
+                        outputs?.publish();
+                        registration.settled = true;
+                    }, (error) => {
+                        outputs?.settleFailure(error);
+                        registration.settled = false;
+                    });
+                },
+                onUnavailable(state) {
+                    registration.settled = false;
+                    bound.cancel('task-activation-dependency-unavailable');
+                    if (state === 'pending')
+                        retainDependencyWait();
+                    else
+                        settleDependencyWait();
+                }
+            });
+            watcher.evaluate();
+        }
+    };
+    owner.activationRegistrations.add(registration);
+    if (!owner.activationsDeferred)
+        registration.start(false);
+    let disposed = false;
+    const activation = {
+        [Symbol.dispose]() {
+            if (disposed)
+                return;
+            disposed = true;
+            watcher?.[Symbol.dispose]();
+            releaseDependencyWait?.();
+            releaseDependencyWait = undefined;
+            bound.cancel('task-activation-disposed');
+            owner.activationRegistrations.delete(registration);
+            owner.ownerCleanups.delete(cleanup);
+        }
+    };
+    const cleanup = activation[Symbol.dispose].bind(activation);
+    registerTaskOwnerCleanup(owner, cleanup);
+    return activation;
+}
+const inertActivation = Object.freeze({ [Symbol.dispose]() { } });
+//# sourceMappingURL=activation.js.map

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

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

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

@@ -0,0 +1,11 @@
+/** Framework cancellation raised when a task generation loses ownership. */
+export declare class TaskCancellation extends Error {
+    readonly reason: unknown;
+    /** Creates a cancellation result that is excluded from application task error state. */
+    constructor(reason?: unknown);
+}
+/** Reports whether a rejected value represents framework task cancellation. */
+export declare function isTaskCancellation(error: unknown): error is TaskCancellation;
+/** Rejects promptly when task ownership is cancelled without cancelling the source promise. */
+export declare function raceTaskCancellation<T>(signal: AbortSignal, settlement: T | PromiseLike<T>): Promise<T>;
+//# sourceMappingURL=cancellation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cancellation.d.ts","sourceRoot":"","sources":["../../../src/tasks/cancellation.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,qBAAa,gBAAiB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,wFAAwF;gBAC5E,MAAM,CAAC,EAAE,OAAO;CAK5B;AAED,+EAA+E;AAC/E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED,+FAA+F;AAC/F,wBAAgB,oBAAoB,CAAC,CAAC,EACrC,MAAM,EAAE,WAAW,EACnB,UAAU,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC,CAmBZ"}

package/dist/client/tasks/cancellation.js

@@ -0,0 +1,33 @@
+/** Framework cancellation raised when a task generation loses ownership. */
+export class TaskCancellation extends Error {
+    reason;
+    /** Creates a cancellation result that is excluded from application task error state. */
+    constructor(reason) {
+        super(reason === undefined ? 'Component task was cancelled' : String(reason));
+        this.name = 'AbortError';
+        this.reason = reason;
+    }
+}
+/** Reports whether a rejected value represents framework task cancellation. */
+export function isTaskCancellation(error) {
+    return error instanceof TaskCancellation;
+}
+/** Rejects promptly when task ownership is cancelled without cancelling the source promise. */
+export function raceTaskCancellation(signal, settlement) {
+    if (signal.aborted) {
+        void Promise.resolve(settlement).catch(() => undefined);
+        return Promise.reject(new TaskCancellation(signal.reason));
+    }
+    return new Promise((resolve, reject) => {
+        const cancel = () => reject(new TaskCancellation(signal.reason));
+        signal.addEventListener('abort', cancel, { once: true });
+        Promise.resolve(settlement).then((value) => {
+            signal.removeEventListener('abort', cancel);
+            resolve(value);
+        }, (error) => {
+            signal.removeEventListener('abort', cancel);
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=cancellation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cancellation.js","sourceRoot":"","sources":["../../../src/tasks/cancellation.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACjC,MAAM,CAAU;IAEzB,wFAAwF;IACxF,YAAY,MAAgB;QAC3B,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;CACD;AAED,+EAA+E;AAC/E,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAChD,OAAO,KAAK,YAAY,gBAAgB,CAAC;AAC1C,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,oBAAoB,CACnC,MAAmB,EACnB,UAA8B;IAE9B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACzC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAC/B,CAAC,KAAK,EAAE,EAAE;YACT,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5C,OAAO,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACT,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM,CAAC,KAAK,CAAC,CAAC;QACf,CAAC,CACD,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/client/tasks/compiled-latest.d.ts

@@ -0,0 +1,17 @@
+import { type ReactiveValue } from '@exactjs/reactive/framework/runtime';
+import type { TaskContext, TaskFunction } from './contracts.js';
+type ActivationInput<T> = T | ReactiveValue<T>;
+/**
+ * Binds the compact runtime lane selected for a compiler-proven, call-only
+ * `TaskContext.client().latest()` task with the default scheduling policy.
+ */
+export declare function bindCompiledClientLatestTaskForHost<Args extends unknown[], Result>(host: object, label: string, implementation: (...args: [...Args, TaskContext]) => Result | Promise<Result>): TaskFunction<Args, Awaited<Result>>;
+/**
+ * Activates the compact default client/latest lane for compiler-owned setup work.
+ * Dependency observation and SSR deferral remain identical to the universal activation ABI.
+ */
+export declare function activateCompiledClientLatestTaskForHost<Args extends unknown[], Result>(host: object, label: string, implementation: (...args: [...Args, TaskContext]) => Result | Promise<Result>, ...inputs: {
+    [Index in keyof Args]: ActivationInput<Args[Index]>;
+}): Disposable;
+export {};
+//# sourceMappingURL=compiled-latest.d.ts.map

package/dist/client/tasks/compiled-latest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-latest.d.ts","sourceRoot":"","sources":["../../../src/tasks/compiled-latest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAG7F,OAAO,KAAK,EAAkB,WAAW,EAAE,YAAY,EAAkB,MAAM,gBAAgB,CAAC;AA2BhG,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;AAW/C;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACjF,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAC3E,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAMrC;AAED;;;GAGG;AACH,wBAAgB,uCAAuC,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EACrF,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,EAC7E,GAAG,MAAM,EAAE;KAAG,KAAK,IAAI,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;CAAE,GAChE,UAAU,CA4EZ"}

package/dist/client/tasks/compiled-latest.js

@@ -0,0 +1,190 @@
+import { peek, scheduleWork } from '@exactjs/reactive/framework/runtime';
+import { readExactInspectionSource } from '../component/inspection-source.js';
+import { attachTaskFrameSettlement, currentTaskFrameRecord, executeTaskFrame, materializeDeferredTaskFrame, registerTaskOwnerCleanup } from './frame-runtime.js';
+import { TaskInvocationValue } from './invocation.js';
+import { taskOwnerForHost } from './owner-hosts.js';
+import { activationInputDependency } from './dependency-source.js';
+import { watchContinuationDependencies } from './dependency-watcher.js';
+import { componentExecutionDependencies, componentExecutionOutputs } from './component-execution-capability.js';
+import { componentExecutionSliceAllows } from './component-execution-slice.js';
+import { markCompiledTaskPerformanceTrace, startCompiledTaskPerformanceTrace } from './performance-trace.js';
+/**
+ * Binds the compact runtime lane selected for a compiler-proven, call-only
+ * `TaskContext.client().latest()` task with the default scheduling policy.
+ */
+export function bindCompiledClientLatestTaskForHost(host, label, implementation) {
+    const state = createLatestTaskState(host, label, implementation);
+    return ((...args) => invokeLatestTask(state, args, 'invoked'));
+}
+/**
+ * Activates the compact default client/latest lane for compiler-owned setup work.
+ * Dependency observation and SSR deferral remain identical to the universal activation ABI.
+ */
+export function activateCompiledClientLatestTaskForHost(host, label, implementation, ...inputs) {
+    const state = createLatestTaskState(host, label, implementation);
+    const taskIdentity = implementation;
+    if (!componentExecutionSliceAllows(state.owner, taskIdentity))
+        return inertActivation;
+    let dependencies = inputs.map(activationInputDependency);
+    dependencies = componentExecutionDependencies(state.owner, taskIdentity, dependencies);
+    let watcher;
+    let releaseDependencyWait;
+    const registration = {
+        task: taskIdentity,
+        settled: false,
+        start(skipInitial) {
+            if (watcher)
+                return;
+            let initial = true;
+            const settleDependencyWait = () => {
+                releaseDependencyWait?.();
+                releaseDependencyWait = undefined;
+            };
+            watcher = watchContinuationDependencies(dependencies, {
+                onReady(vector) {
+                    settleDependencyWait();
+                    if (skipInitial && initial) {
+                        initial = false;
+                        registration.settled = true;
+                        return;
+                    }
+                    const activation = initial ? 'initialization' : 'reactive';
+                    initial = false;
+                    registration.settled = false;
+                    const outputs = componentExecutionOutputs(state.owner, taskIdentity);
+                    const invocation = peek(() => invokeLatestTask(state, vector.values, activation));
+                    void Promise.resolve(invocation).then(() => {
+                        outputs?.publish();
+                        registration.settled = true;
+                    }, (error) => {
+                        outputs?.settleFailure(error);
+                        registration.settled = false;
+                    });
+                },
+                onUnavailable(unavailable) {
+                    registration.settled = false;
+                    state.active?.abort('task-activation-dependency-unavailable');
+                    if (unavailable !== 'pending' || releaseDependencyWait || !state.owner.observeSettlement)
+                        return;
+                    let release;
+                    const settlement = new Promise((resolve) => (release = resolve));
+                    releaseDependencyWait = release;
+                    state.owner.observeSettlement(settlement);
+                }
+            });
+            watcher.evaluate();
+        }
+    };
+    state.owner.activationRegistrations.add(registration);
+    if (!state.owner.activationsDeferred)
+        registration.start(false);
+    let disposed = false;
+    const activation = {
+        [Symbol.dispose]() {
+            if (disposed)
+                return;
+            disposed = true;
+            watcher?.[Symbol.dispose]();
+            releaseDependencyWait?.();
+            releaseDependencyWait = undefined;
+            state.active?.abort('task-activation-disposed');
+            state.owner.activationRegistrations.delete(registration);
+            state.owner.ownerCleanups.delete(cleanup);
+        }
+    };
+    const cleanup = activation[Symbol.dispose].bind(activation);
+    registerTaskOwnerCleanup(state.owner, cleanup);
+    return activation;
+}
+function createLatestTaskState(host, label, implementation) {
+    const owner = taskOwnerForHost(host);
+    if (!owner)
+        throw new Error('A compiled client/latest task requires a registered durable task host');
+    const sourceEntityId = readExactInspectionSource(implementation);
+    return {
+        owner,
+        label,
+        implementation: implementation,
+        ...(sourceEntityId ? { sourceEntityId } : {}),
+        generation: 0
+    };
+}
+function invokeLatestTask(state, args, activation) {
+    state.active?.abort('superseded');
+    const controller = new AbortController();
+    state.active = controller;
+    const generation = ++state.generation;
+    const parent = activation === 'invoked'
+        ? (currentTaskFrameRecord() ?? materializeDeferredTaskFrame())
+        : undefined;
+    let releaseReservation;
+    if (parent) {
+        const reservation = new Promise((resolve) => (releaseReservation = resolve));
+        attachTaskFrameSettlement(parent, reservation);
+    }
+    let resolve;
+    let reject;
+    const settlement = new Promise((accept, fail) => {
+        resolve = accept;
+        reject = fail;
+    });
+    void settlement.catch(() => undefined);
+    let observed = false;
+    state.owner.settlements.add(settlement);
+    state.owner.observeSettlement?.(settlement);
+    void settlement
+        .finally(() => {
+        state.owner.settlements.delete(settlement);
+        if (state.active === controller)
+            state.active = undefined;
+    })
+        .catch(() => undefined);
+    scheduleWork(() => {
+        const trace = startCompiledTaskPerformanceTrace(state.owner, { activation, generation, priority: 'normal' }, state.sourceEntityId, state.label);
+        const execute = () => executeTaskFrame({
+            parent,
+            parentReserved: releaseReservation !== undefined,
+            owner: state.owner,
+            controller,
+            generation,
+            activation,
+            label: state.label,
+            sourceEntityId: state.sourceEntityId,
+            placement: 'client',
+            concurrency: 'latest',
+            priority: 'normal',
+            readiness: 'nonblocking',
+            inspectionArguments: args,
+            detached: activation !== 'invoked',
+            propagateFailure: () => !observed
+        }, (context) => state.implementation(...args, context));
+        let execution;
+        try {
+            execution = state.owner.runTask && !parent ? state.owner.runTask(execute) : execute();
+        }
+        catch (error) {
+            releaseReservation?.();
+            markCompiledTaskPerformanceTrace(trace, { outcome: 'error' });
+            reject(error);
+            return;
+        }
+        releaseReservation?.();
+        void execution.then((value) => {
+            markCompiledTaskPerformanceTrace(trace, { outcome: 'success' });
+            resolve(value);
+        }, (error) => {
+            markCompiledTaskPerformanceTrace(trace, {
+                outcome: controller.signal.aborted ? 'cancelled' : 'error'
+            });
+            reject(error);
+        });
+    }, 'normal', (error) => {
+        releaseReservation?.();
+        reject(error);
+    });
+    return new TaskInvocationValue(settlement, () => {
+        observed = true;
+    });
+}
+const inertActivation = Object.freeze({ [Symbol.dispose]() { } });
+//# sourceMappingURL=compiled-latest.js.map

package/dist/client/tasks/compiled-latest.js.map

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

package/dist/client/tasks/component-continuation.d.ts

@@ -0,0 +1,13 @@
+import type { AnyComponentInstance } from '../component/contracts.js';
+/** Existential continuation callable whose concrete signature is retained by branding helpers. */
+type AnyContinuationCallable = (...args: any[]) => unknown;
+/** Tags compiler-generated task work with its opaque cross-runtime continuation identity. */
+export declare function markComponentContinuationTask<T extends AnyContinuationCallable>(id: string, work: T): T;
+/** Returns the private continuation identity attached by compiler output. */
+export declare function componentContinuationTaskId(work: AnyContinuationCallable): string | undefined;
+/** Copies compiler-owned continuation identity through a runtime callable wrapper. */
+export declare function inheritComponentContinuationIdentity(source: AnyContinuationCallable, target: AnyContinuationCallable): void;
+/** Lists continuation generations that completed successfully on one component instance. */
+export declare function settledComponentContinuationIds(instance: AnyComponentInstance): readonly string[];
+export {};
+//# sourceMappingURL=component-continuation.d.ts.map

package/dist/client/tasks/component-continuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-continuation.d.ts","sourceRoot":"","sources":["../../../src/tasks/component-continuation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAKtE,kGAAkG;AAElG,KAAK,uBAAuB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;AAM3D,6FAA6F;AAC7F,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,uBAAuB,EAC9E,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,CAAC,GACL,CAAC,CAEH;AAcD,6EAA6E;AAC7E,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,uBAAuB,GAAG,MAAM,GAAG,SAAS,CAE7F;AAED,sFAAsF;AACtF,wBAAgB,oCAAoC,CACnD,MAAM,EAAE,uBAAuB,EAC/B,MAAM,EAAE,uBAAuB,GAC7B,IAAI,CAGN;AAED,4FAA4F;AAC5F,wBAAgB,+BAA+B,CAAC,QAAQ,EAAE,oBAAoB,GAAG,SAAS,MAAM,EAAE,CAQjG"}

package/dist/client/tasks/component-continuation.js

@@ -0,0 +1,40 @@
+import { taskOwnerForHost } from './owner-hosts.js';
+const exactContinuationTask = Symbol.for('@exactjs/continuation-task');
+/** Tags compiler-generated task work with its opaque cross-runtime continuation identity. */
+export function markComponentContinuationTask(id, work) {
+    return markContinuationWork(id, work);
+}
+/** Applies the shared non-enumerable continuation identity without changing callable behavior. */
+function markContinuationWork(id, work) {
+    if (!id)
+        throw new Error('eXact continuation id must be non-empty');
+    Object.defineProperty(work, exactContinuationTask, {
+        value: id,
+        configurable: false,
+        enumerable: false,
+        writable: false
+    });
+    return work;
+}
+/** Returns the private continuation identity attached by compiler output. */
+export function componentContinuationTaskId(work) {
+    return work[exactContinuationTask];
+}
+/** Copies compiler-owned continuation identity through a runtime callable wrapper. */
+export function inheritComponentContinuationIdentity(source, target) {
+    const id = componentContinuationTaskId(source);
+    if (id)
+        markContinuationWork(id, target);
+}
+/** Lists continuation generations that completed successfully on one component instance. */
+export function settledComponentContinuationIds(instance) {
+    const owner = taskOwnerForHost(instance);
+    if (!owner)
+        return [];
+    const taskIds = [...owner.activationRegistrations]
+        .filter((registration) => registration.settled)
+        .map((registration) => componentContinuationTaskId(registration.task))
+        .filter((id) => id !== undefined);
+    return [...new Set(taskIds)];
+}
+//# sourceMappingURL=component-continuation.js.map

package/dist/client/tasks/component-continuation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-continuation.js","sourceRoot":"","sources":["../../../src/tasks/component-continuation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,qBAAqB,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAUvE,6FAA6F;AAC7F,MAAM,UAAU,6BAA6B,CAC5C,EAAU,EACV,IAAO;IAEP,OAAO,oBAAoB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,kGAAkG;AAClG,SAAS,oBAAoB,CAAoC,EAAU,EAAE,IAAO;IACnF,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IACpE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,qBAAqB,EAAE;QAClD,KAAK,EAAE,EAAE;QACT,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;KACf,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACb,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,2BAA2B,CAAC,IAA6B;IACxE,OAAQ,IAA+B,CAAC,qBAAqB,CAAC,CAAC;AAChE,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,oCAAoC,CACnD,MAA+B,EAC/B,MAA+B;IAE/B,MAAM,EAAE,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,EAAE;QAAE,oBAAoB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,+BAA+B,CAAC,QAA8B;IAC7E,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,uBAAuB,CAAC;SAChD,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC;SAC9C,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,2BAA2B,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;SACrE,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC;IACjD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9B,CAAC"}

package/dist/client/tasks/component-execution-capability.d.ts

@@ -0,0 +1,31 @@
+import type { AnyComponentInstance } from '../component/contracts.js';
+import type { ExactComponentExecutionContract } from '../component-contracts.js';
+import type { TaskFunction } from './contracts.js';
+import type { ComponentContinuationOutputs } from './component-execution.js';
+import type { ContinuationDependencySource } from './dependency-source.js';
+import type { TaskOwnerRecord } from './frame-contracts.js';
+type ComponentExecutionCapability = Readonly<{
+    initialize(owner: TaskOwnerRecord, host: {
+        readonly state?: object;
+    }, plan: ExactComponentExecutionContract | undefined, props: Record<string, unknown>): void;
+    dependencies<Args extends unknown[]>(owner: TaskOwnerRecord, task: TaskFunction<Args, unknown>, authored: {
+        [Index in keyof Args]: ContinuationDependencySource<Args[Index]>;
+    }): {
+        [Index in keyof Args]: ContinuationDependencySource<Args[Index]>;
+    };
+    outputs<Args extends unknown[]>(owner: TaskOwnerRecord, task: TaskFunction<Args, unknown>): ComponentContinuationOutputs | undefined;
+}>;
+/** Installs the execution-plan runtime selected by a compiler-generated runtime entry. */
+export declare function registerComponentExecutionCapability(next: ComponentExecutionCapability): void;
+/** Initializes execution slots when the selected artifact retained an execution plan. */
+export declare function initializeComponentExecutionCapability(owner: TaskOwnerRecord, instance: AnyComponentInstance, execution: ExactComponentExecutionContract | undefined, props: Record<string, unknown>): void;
+/** Resolves compiler-planned inputs or preserves the authored dependency sources. */
+export declare function componentExecutionDependencies<Args extends unknown[]>(owner: TaskOwnerRecord, task: TaskFunction<Args, unknown>, authored: {
+    [Index in keyof Args]: ContinuationDependencySource<Args[Index]>;
+}): {
+    [Index in keyof Args]: ContinuationDependencySource<Args[Index]>;
+};
+/** Begins compiler-planned output publication when an execution plan is installed. */
+export declare function componentExecutionOutputs<Args extends unknown[]>(owner: TaskOwnerRecord, task: TaskFunction<Args, unknown>): ComponentContinuationOutputs | undefined;
+export {};
+//# sourceMappingURL=component-execution-capability.d.ts.map

package/dist/client/tasks/component-execution-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-execution-capability.d.ts","sourceRoot":"","sources":["../../../src/tasks/component-execution-capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,KAAK,4BAA4B,GAAG,QAAQ,CAAC;IAC5C,UAAU,CACT,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EACjC,IAAI,EAAE,+BAA+B,GAAG,SAAS,EACjD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAAC;IACR,YAAY,CAAC,IAAI,SAAS,OAAO,EAAE,EAClC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE;SAAG,KAAK,IAAI,MAAM,IAAI,GAAG,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;KAAE,GAC5E;SAAG,KAAK,IAAI,MAAM,IAAI,GAAG,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;KAAE,CAAC;IACxE,OAAO,CAAC,IAAI,SAAS,OAAO,EAAE,EAC7B,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,GAC/B,4BAA4B,GAAG,SAAS,CAAC;CAC5C,CAAC,CAAC;AAIH,0FAA0F;AAC1F,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,4BAA4B,GAAG,IAAI,CAE7F;AAED,yFAAyF;AACzF,wBAAgB,sCAAsC,CACrD,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,EAAE,+BAA+B,GAAG,SAAS,EACtD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,IAAI,CAEN;AAED,qFAAqF;AACrF,wBAAgB,8BAA8B,CAAC,IAAI,SAAS,OAAO,EAAE,EACpE,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE;KAAG,KAAK,IAAI,MAAM,IAAI,GAAG,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;CAAE,GAC5E;KAAG,KAAK,IAAI,MAAM,IAAI,GAAG,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;CAAE,CAEtE;AAED,sFAAsF;AACtF,wBAAgB,yBAAyB,CAAC,IAAI,SAAS,OAAO,EAAE,EAC/D,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,GAC/B,4BAA4B,GAAG,SAAS,CAE1C"}

package/dist/client/tasks/component-execution-capability.js

@@ -0,0 +1,18 @@
+let capability;
+/** Installs the execution-plan runtime selected by a compiler-generated runtime entry. */
+export function registerComponentExecutionCapability(next) {
+    capability = next;
+}
+/** Initializes execution slots when the selected artifact retained an execution plan. */
+export function initializeComponentExecutionCapability(owner, instance, execution, props) {
+    capability?.initialize(owner, instance, execution, props);
+}
+/** Resolves compiler-planned inputs or preserves the authored dependency sources. */
+export function componentExecutionDependencies(owner, task, authored) {
+    return capability?.dependencies(owner, task, authored) ?? authored;
+}
+/** Begins compiler-planned output publication when an execution plan is installed. */
+export function componentExecutionOutputs(owner, task) {
+    return capability?.outputs(owner, task);
+}
+//# sourceMappingURL=component-execution-capability.js.map

package/dist/client/tasks/component-execution-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-execution-capability.js","sourceRoot":"","sources":["../../../src/tasks/component-execution-capability.ts"],"names":[],"mappings":"AAyBA,IAAI,UAAoD,CAAC;AAEzD,0FAA0F;AAC1F,MAAM,UAAU,oCAAoC,CAAC,IAAkC;IACtF,UAAU,GAAG,IAAI,CAAC;AACnB,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,sCAAsC,CACrD,KAAsB,EACtB,QAA8B,EAC9B,SAAsD,EACtD,KAA8B;IAE9B,UAAU,EAAE,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,8BAA8B,CAC7C,KAAsB,EACtB,IAAiC,EACjC,QAA8E;IAE9E,OAAO,UAAU,EAAE,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,QAAQ,CAAC;AACpE,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,yBAAyB,CACxC,KAAsB,EACtB,IAAiC;IAEjC,OAAO,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/client/tasks/component-execution-plan.d.ts

@@ -0,0 +1,32 @@
+import type { ExactComponentExecutionContract } from '../component-contracts.js';
+type ExecutionTransition = ExactComponentExecutionContract['transitions'][number];
+/** Precomputed state output descriptor shared by every instance of one component plan. */
+export type PreparedComponentOutput = Readonly<{
+    portIndex: number;
+    path: readonly string[];
+}>;
+/** Precomputed prop dependency descriptor shared by every instance of one component plan. */
+export type PreparedComponentProp = Readonly<{
+    portIndex: number;
+    path: readonly string[];
+}>;
+/** Precomputed transition wiring shared by every instance of one component plan. */
+export type PreparedComponentTransition = Readonly<{
+    contract: ExecutionTransition;
+    dependencyPorts: readonly number[];
+    outputs: readonly PreparedComponentOutput[];
+}>;
+/** Immutable execution indexes prepared once for a compiler-emitted component plan. */
+export type PreparedComponentExecution = Readonly<{
+    plan: ExactComponentExecutionContract;
+    statePortsByPath: ReadonlyMap<string, number>;
+    transitionsById: ReadonlyMap<string, PreparedComponentTransition>;
+    outputPortIndexes: readonly number[];
+    propPorts: readonly PreparedComponentProp[];
+    setupOutputs: readonly boolean[];
+    setupPropNames: ReadonlySet<string>;
+}>;
+/** Returns allocation-free lookup indexes after preparing an immutable plan once. */
+export declare function prepareComponentExecution(plan: ExactComponentExecutionContract): PreparedComponentExecution;
+export {};
+//# sourceMappingURL=component-execution-plan.d.ts.map

package/dist/client/tasks/component-execution-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-execution-plan.d.ts","sourceRoot":"","sources":["../../../src/tasks/component-execution-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AAEjF,KAAK,mBAAmB,GAAG,+BAA+B,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAElF,0FAA0F;AAC1F,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACxB,CAAC,CAAC;AAEH,6FAA6F;AAC7F,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CACxB,CAAC,CAAC;AAEH,oFAAoF;AACpF,MAAM,MAAM,2BAA2B,GAAG,QAAQ,CAAC;IAClD,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC5C,CAAC,CAAC;AAEH,uFAAuF;AACvF,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IACjD,IAAI,EAAE,+BAA+B,CAAC;IACtC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;IAClE,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,SAAS,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC5C,YAAY,EAAE,SAAS,OAAO,EAAE,CAAC;IACjC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACpC,CAAC,CAAC;AAIH,qFAAqF;AACrF,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,+BAA+B,GACnC,0BAA0B,CA4D5B"}