@exactjs/core 0.5.0

package/dist/tasks/frame-runtime.js

@@ -0,0 +1,342 @@
+import { setScheduledWorkContextCapture } from '@exactjs/reactive/framework/runtime';
+import { raceTaskCancellation, TaskCancellation } from './cancellation.js';
+import { registerTaskFrameSignal, releaseTaskFrameSignal, resumeTaskFrameContinuation } from './frame-continuation.js';
+import { createTaskFrameContext, frameForTaskContext } from './frame-context.js';
+import { publishTaskFrameEvent, taskFrameInspectionAttached } from './frame-inspection-capability.js';
+import { registerTaskFrameSettlement, runTaskFrameCleanups, settleTaskFrameChildren } from './frame-settlement.js';
+import { createLazyTaskOwnerRecord } from './owner-record.js';
+import { acquireScheduledReactionBatch } from './scheduled-reactions.js';
+import { taskFrameTokenBrand, taskOwnerBrand } from './frame-contracts.js';
+let nextFrameId = 1;
+let currentFrame;
+let currentOwner;
+let deferredFrameMaterializer;
+let scheduledWorkCaptureInstalled = false;
+const synchronousFrameErrors = new WeakMap();
+/** Creates a durable task owner and its cancellation lifetime. */
+export function createTaskOwnerRecord(label) {
+    return createLazyTaskOwnerRecord(label);
+}
+/** Retains setup-owned cleanup until its durable task owner is disposed. */
+export function registerTaskOwnerCleanup(owner, cleanup) {
+    if (owner.disposed)
+        throw new Error('Task owner has been disposed');
+    owner.ownerCleanups.add(cleanup);
+}
+/** Validates and returns the internal representation of a public owner. */
+export function taskOwnerRecord(owner) {
+    if (!(taskOwnerBrand in owner))
+        throw new TypeError('Task owner was not created by eXact');
+    return owner;
+}
+/** Returns the frame active for the current synchronous execution segment. */
+export function currentTaskFrameRecord() {
+    return currentFrame;
+}
+/** Materializes an interaction frame only when synchronous work requests structural ownership. */
+export function materializeDeferredTaskFrame() {
+    return deferredFrameMaterializer?.();
+}
+/** Installs the lazy structural parent available to task and navigation operations during work. */
+export function withDeferredTaskFrame(materialize, work) {
+    const previous = deferredFrameMaterializer;
+    deferredFrameMaterializer = materialize;
+    try {
+        return work();
+    }
+    finally {
+        deferredFrameMaterializer = previous;
+    }
+}
+/** Returns the durable owner supplied by the current framework host. */
+export function currentTaskOwnerRecord() {
+    return currentFrame?.owner ?? currentOwner;
+}
+/** Establishes a durable host owner during component state-machine construction or adapter setup. */
+export function withTaskOwnerRecord(owner, work) {
+    const previous = currentOwner;
+    currentOwner = owner;
+    try {
+        return work();
+    }
+    finally {
+        currentOwner = previous;
+    }
+}
+/** Runs a synchronous segment with one frame as ambient context. */
+export function withTaskFrameRecord(frame, work) {
+    if (frame.settled)
+        throw new Error('Cannot resume a settled task frame');
+    ensureScheduledWorkContextCapture();
+    const previous = currentFrame;
+    currentFrame = frame;
+    try {
+        return work();
+    }
+    finally {
+        currentFrame = previous;
+    }
+}
+/**
+ * Runs work in a frame, then waits for dynamically attached descendants and
+ * executes cleanup in last-in-first-out order.
+ */
+export function executeTaskFrame(options, work) {
+    const structuralParent = options.detached ? undefined : (options.parent ?? currentFrame);
+    if (structuralParent &&
+        !options.parentReserved &&
+        (!structuralParent.producerOpen || structuralParent.settled))
+        return Promise.reject(new Error('Cannot attach work after the parent task producer has closed'));
+    const owner = options.owner ?? structuralParent?.owner ?? createTaskOwnerRecord('implicit task invocation');
+    if (owner.disposed)
+        return Promise.reject(new Error('Task owner has been disposed'));
+    const controller = options.controller ?? new AbortController();
+    // The owner cancels its active frame controllers directly during disposal. Subscribing every
+    // frame to its durable signal would retain settled controllers until the owner itself is released.
+    if (structuralParent)
+        linkAbort(structuralParent.controller.signal, controller);
+    let resolveSettlement;
+    let rejectSettlement;
+    const settlement = new Promise((resolve, reject) => {
+        resolveSettlement = resolve;
+        rejectSettlement = reject;
+    });
+    const frame = {
+        [taskFrameTokenBrand]: true,
+        id: nextFrameId++,
+        owner,
+        parent: structuralParent,
+        controller,
+        ...(options.label === undefined ? {} : { label: options.label }),
+        ...(options.sourceEntityId === undefined ? {} : { sourceEntityId: options.sourceEntityId }),
+        activation: options.activation ?? 'invoked',
+        generation: options.generation ?? 1,
+        placement: options.placement ?? 'current',
+        concurrency: options.concurrency ?? 'parallel',
+        priority: options.priority ?? structuralParent?.priority ?? 'normal',
+        readiness: options.readiness ??
+            (options.priority === 'deferred'
+                ? 'nonblocking'
+                : (structuralParent?.readiness ?? 'blocking')),
+        kind: options.kind ?? 'task',
+        producerOpen: true,
+        settled: false,
+        startedAt: monotonicTimestamp()
+    };
+    if (options.publicContext !== false)
+        frame.context = createTaskFrameContext(frame, options);
+    registerTaskFrameSignal(controller.signal, frame);
+    registerTaskFrameSettlement(frame, settlement);
+    owner.frames.add(frame);
+    const inspectedAtStart = taskFrameInspectionAttached(frame);
+    if (inspectedAtStart) {
+        publishTaskFrameEvent(frame, 'task.frame.enter');
+        publishTaskFrameEvent(frame, 'task.start', undefined, {
+            kind: 'start',
+            arguments: options.inspectionArguments
+        });
+    }
+    else
+        uninspectedSynchronousFrames.add(frame);
+    if (structuralParent) {
+        (structuralParent.children ??= new Set()).add(settlement);
+        void settlement
+            .finally(() => structuralParent.children?.delete(settlement))
+            .catch(() => undefined);
+    }
+    else {
+        // Root settlement is observed through executeTaskFrame's returned
+        // promise; the internal structural signal has no parent consumer.
+        void settlement.catch(() => undefined);
+    }
+    let directResult;
+    let synchronousError;
+    try {
+        if (controller.signal.aborted)
+            throw new TaskCancellation(controller.signal.reason);
+        directResult = withTaskFrameRecord(frame, () => work(frame.context));
+    }
+    catch (error) {
+        synchronousError = error;
+        directResult = Promise.reject(error);
+    }
+    finally {
+        uninspectedSynchronousFrames.delete(frame);
+    }
+    const execution = raceTaskCancellation(controller.signal, directResult);
+    const result = execution.then(async (value) => {
+        frame.producerOpen = false;
+        publishTaskFrameEvent(frame, 'task.foreground-settle');
+        let structuralError;
+        let structuralFailed = false;
+        try {
+            await settleTaskFrameChildren(frame);
+        }
+        catch (error) {
+            structuralError = error;
+            structuralFailed = true;
+        }
+        try {
+            await runTaskFrameCleanups(frame);
+        }
+        catch (cleanupError) {
+            if (!structuralFailed)
+                throw cleanupError;
+            if (structuralError && typeof structuralError === 'object')
+                Object.defineProperty(structuralError, 'suppressed', {
+                    configurable: true,
+                    value: [cleanupError]
+                });
+        }
+        if (controller.signal.aborted)
+            throw new TaskCancellation(controller.signal.reason);
+        if (structuralFailed)
+            throw structuralError;
+        return value;
+    }, async (error) => {
+        const outcomeError = controller.signal.aborted && !(error instanceof TaskCancellation)
+            ? new TaskCancellation(controller.signal.reason)
+            : error;
+        frame.producerOpen = false;
+        publishTaskFrameEvent(frame, 'task.foreground-settle');
+        controller.abort(error);
+        let childError;
+        let childFailed = false;
+        try {
+            await settleTaskFrameChildren(frame);
+        }
+        catch (error) {
+            childError = error;
+            childFailed = true;
+        }
+        try {
+            await runTaskFrameCleanups(frame);
+        }
+        catch (cleanupError) {
+            if (outcomeError && typeof outcomeError === 'object')
+                Object.defineProperty(outcomeError, 'suppressed', {
+                    configurable: true,
+                    value: [cleanupError]
+                });
+        }
+        if (outcomeError === undefined && childFailed)
+            throw childError;
+        throw outcomeError;
+    });
+    const output = result.then((value) => {
+        frame.settled = true;
+        releaseTaskFrameSignal(controller.signal);
+        owner.frames.delete(frame);
+        resolveSettlement();
+        publishTaskFrameEvent(frame, 'task.frame.exit');
+        publishTaskFrameEvent(frame, 'task.structural-settle');
+        publishTaskFrameEvent(frame, 'task.settle', undefined, {
+            kind: 'outcome',
+            status: 'settled',
+            value
+        });
+        return value;
+    }, (error) => {
+        frame.settled = true;
+        releaseTaskFrameSignal(controller.signal);
+        owner.frames.delete(frame);
+        if (options.propagateFailure?.() === false)
+            resolveSettlement();
+        else
+            rejectSettlement(error);
+        publishTaskFrameEvent(frame, 'task.frame.exit');
+        const cancelled = error instanceof TaskCancellation;
+        publishTaskFrameEvent(frame, cancelled ? 'task.cancel' : 'task.fail', error, {
+            kind: 'outcome',
+            status: cancelled ? 'cancelled' : 'failed',
+            value: error
+        });
+        throw error;
+    });
+    if (synchronousError !== undefined) {
+        synchronousFrameErrors.set(output, { error: synchronousError });
+        // Callers that preserve a synchronous host contract rethrow this error
+        // immediately. The frame still settles asynchronously to release ownership.
+        void output.catch(() => undefined);
+    }
+    return output;
+}
+/** Returns an error thrown before a task frame's producer yielded to asynchronous work. */
+export function taskFrameSynchronousError(execution) {
+    return execution instanceof Promise ? synchronousFrameErrors.get(execution) : undefined;
+}
+/** Adds a structural contribution to a frame before its producer closes. */
+export function attachTaskFrameSettlement(frame, settlement) {
+    if (frame.settled || !frame.producerOpen)
+        throw new Error('Cannot attach work after the task frame producer has closed');
+    const normalized = Promise.resolve(settlement).then(() => undefined);
+    (frame.children ??= new Set()).add(normalized);
+    void normalized.finally(() => frame.children?.delete(normalized)).catch(() => undefined);
+}
+/** Adds structural work to the synchronously active task frame, when present. */
+export function joinTask(settlement) {
+    const frame = currentTaskFrameRecord() ?? materializeDeferredTaskFrame();
+    if (frame)
+        attachTaskFrameSettlement(frame, settlement);
+}
+/** Publishes a task-owned mutation only while its generation remains current. */
+export function taskMutation(signal, mutation) {
+    if (signal.aborted)
+        throw new TaskCancellation(signal.reason);
+    return mutation();
+}
+/** Restores the owning task frame around one compiler-lowered async continuation. */
+export function resumeTaskFrame(signal, resume) {
+    resumeTaskFrameContinuation(signal, resume, (frame) => {
+        if (frame.settled)
+            throw new Error('Cannot resume a settled task frame');
+        const previous = currentFrame;
+        currentFrame = frame;
+        return () => {
+            currentFrame = previous;
+        };
+    });
+}
+export { frameForTaskContext };
+const interactiveReactionContexts = new WeakMap();
+const uninspectedSynchronousFrames = new WeakSet();
+function linkAbort(signal, target) {
+    if (signal.aborted) {
+        target.abort(signal.reason);
+        return;
+    }
+    signal.addEventListener('abort', () => target.abort(signal.reason), { once: true });
+}
+function monotonicTimestamp() {
+    return globalThis.performance?.now() ?? Date.now();
+}
+/** Allocates one process-local frame identity for internal consequence frames. */
+export function allocateTaskFrameId() {
+    return nextFrameId++;
+}
+function ensureScheduledWorkContextCapture() {
+    if (scheduledWorkCaptureInstalled)
+        return;
+    scheduledWorkCaptureInstalled = true;
+    setScheduledWorkContextCapture((priority) => {
+        const parent = currentTaskFrameRecord();
+        if (!parent || !parent.producerOpen || parent.settled)
+            return undefined;
+        if (priority === 'interactive' && uninspectedSynchronousFrames.has(parent))
+            return interactiveReactionContext(parent);
+        return acquireScheduledReactionBatch(parent);
+    });
+}
+/** Reuses an open interaction producer for consequences drained inside the same DOM callback. */
+function interactiveReactionContext(parent) {
+    let context = interactiveReactionContexts.get(parent);
+    if (context)
+        return context;
+    context = {
+        run: (work) => withTaskFrameRecord(parent, work),
+        cancel() { }
+    };
+    interactiveReactionContexts.set(parent, context);
+    return context;
+}
+//# sourceMappingURL=frame-runtime.js.map

package/dist/tasks/frame-runtime.js.map

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

package/dist/tasks/frame-settlement.d.ts

@@ -0,0 +1,13 @@
+import type { TaskFrameRecord } from './frame-runtime.js';
+/** Associates a task frame with the promise representing its structural settlement. */
+export declare function registerTaskFrameSettlement(frame: TaskFrameRecord, settlement: Promise<void>): void;
+/** Returns the structural settlement promise retained for a task frame. */
+export declare function waitForTaskFrameSettlement(frame: TaskFrameRecord): Promise<void>;
+/**
+ * Waits for every attached descendant, including children transferred from an
+ * atomic reservation, then reports the first structural failure.
+ */
+export declare function settleTaskFrameChildren(frame: TaskFrameRecord): Promise<void>;
+/** Runs frame-owned cleanup in last-in-first-out order and reports its first failure. */
+export declare function runTaskFrameCleanups(frame: TaskFrameRecord): Promise<void>;
+//# sourceMappingURL=frame-settlement.d.ts.map

package/dist/tasks/frame-settlement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-settlement.d.ts","sourceRoot":"","sources":["../../src/tasks/frame-settlement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D,uFAAuF;AACvF,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,GACvB,IAAI,CAEN;AAED,2EAA2E;AAC3E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhF;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAYnF;AAED,yFAAyF;AACzF,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhF"}

package/dist/tasks/frame-settlement.js

@@ -0,0 +1,43 @@
+const frameSettlements = new WeakMap();
+/** Associates a task frame with the promise representing its structural settlement. */
+export function registerTaskFrameSettlement(frame, settlement) {
+    frameSettlements.set(frame, settlement);
+}
+/** Returns the structural settlement promise retained for a task frame. */
+export function waitForTaskFrameSettlement(frame) {
+    return frameSettlements.get(frame) ?? Promise.resolve();
+}
+/**
+ * Waits for every attached descendant, including children transferred from an
+ * atomic reservation, then reports the first structural failure.
+ */
+export async function settleTaskFrameChildren(frame) {
+    let primary;
+    let failed = false;
+    while (frame.children?.size) {
+        const results = await Promise.allSettled([...frame.children]);
+        for (const result of results) {
+            if (result.status === 'fulfilled' || failed)
+                continue;
+            primary = result.reason;
+            failed = true;
+        }
+    }
+    if (failed)
+        throw primary;
+}
+/** Runs frame-owned cleanup in last-in-first-out order and reports its first failure. */
+export async function runTaskFrameCleanups(frame) {
+    let primary;
+    for (const cleanup of frame.cleanups?.reverse() ?? []) {
+        try {
+            await cleanup();
+        }
+        catch (error) {
+            primary ??= error;
+        }
+    }
+    if (primary !== undefined)
+        throw primary;
+}
+//# sourceMappingURL=frame-settlement.js.map

package/dist/tasks/frame-settlement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-settlement.js","sourceRoot":"","sources":["../../src/tasks/frame-settlement.ts"],"names":[],"mappings":"AAEA,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAkC,CAAC;AAEvE,uFAAuF;AACvF,MAAM,UAAU,2BAA2B,CAC1C,KAAsB,EACtB,UAAyB;IAEzB,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AACzC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,0BAA0B,CAAC,KAAsB;IAChE,OAAO,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAAsB;IACnE,IAAI,OAAgB,CAAC;IACrB,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,OAAO,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM;gBAAE,SAAS;YACtD,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;YACxB,MAAM,GAAG,IAAI,CAAC;QACf,CAAC;IACF,CAAC;IACD,IAAI,MAAM;QAAE,MAAM,OAAO,CAAC;AAC3B,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAsB;IAChE,IAAI,OAAgB,CAAC;IACrB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC;YACJ,MAAM,OAAO,EAAE,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,KAAK,KAAK,CAAC;QACnB,CAAC;IACF,CAAC;IACD,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,OAAO,CAAC;AAC1C,CAAC"}

package/dist/tasks/generation-execution.d.ts

@@ -0,0 +1,6 @@
+import type { RuntimeTaskOptions, TaskContext } from './contracts.js';
+import type { TaskOwnerRecord } from './frame-contracts.js';
+import type { InternalTaskGeneration } from './runtime-types.js';
+/** Executes one scheduled generation inside its structural frame and optional renderer permit. */
+export declare function executeScheduledTaskGeneration<Args extends unknown[], Result>(owner: TaskOwnerRecord, record: InternalTaskGeneration<Result>, options: RuntimeTaskOptions<Args>, sourceEntityId: string | undefined, implementation: (...args: [...Args, TaskContext]) => Result | Promise<Result>): Promise<Result>;
+//# sourceMappingURL=generation-execution.d.ts.map

package/dist/tasks/generation-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-execution.d.ts","sourceRoot":"","sources":["../../src/tasks/generation-execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,kGAAkG;AAClG,wBAAgB,8BAA8B,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,EAC5E,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC,EACtC,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,EACjC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,cAAc,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,WAAW,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAC3E,OAAO,CAAC,MAAM,CAAC,CA2BjB"}

package/dist/tasks/generation-execution.js

@@ -0,0 +1,27 @@
+import { executeTaskFrame } from './frame-runtime.js';
+import { applyTaskOptimistic } from './optimism.js';
+/** Executes one scheduled generation inside its structural frame and optional renderer permit. */
+export function executeScheduledTaskGeneration(owner, record, options, sourceEntityId, implementation) {
+    const execute = () => executeTaskFrame({
+        parent: record.parent,
+        parentReserved: record.releaseReservation !== undefined,
+        owner,
+        controller: record.controller,
+        generation: record.generation,
+        activation: record.activation,
+        label: options.label,
+        sourceEntityId,
+        placement: options.placement,
+        concurrency: options.concurrency,
+        inspectionArguments: record.args,
+        // Setup activations are durable-owner roots even if their scheduled computation runs
+        // while an earlier task continuation is temporarily restored.
+        detached: record.activation !== 'invoked' || options.detached,
+        priority: record.priority,
+        readiness: record.readiness,
+        optimistic: (work) => applyTaskOptimistic(record, options.concurrency, work),
+        propagateFailure: () => !record.observed
+    }, (context) => implementation(...[...record.args, context]));
+    return owner.runTask && !record.parent ? owner.runTask(execute) : execute();
+}
+//# sourceMappingURL=generation-execution.js.map

package/dist/tasks/generation-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-execution.js","sourceRoot":"","sources":["../../src/tasks/generation-execution.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,kGAAkG;AAClG,MAAM,UAAU,8BAA8B,CAC7C,KAAsB,EACtB,MAAsC,EACtC,OAAiC,EACjC,cAAkC,EAClC,cAA6E;IAE7E,MAAM,OAAO,GAAG,GAAG,EAAE,CACpB,gBAAgB,CACf;QACC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,cAAc,EAAE,MAAM,CAAC,kBAAkB,KAAK,SAAS;QACvD,KAAK;QACL,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,cAAc;QACd,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,mBAAmB,EAAE,MAAM,CAAC,IAAI;QAChC,qFAAqF;QACrF,8DAA8D;QAC9D,QAAQ,EAAE,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ;QAC7D,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC;QAC5E,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ;KACxC,EACD,CAAC,OAAO,EAAE,EAAE,CACX,cAAc,CAAC,GAAI,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,OAAO,CAAuC,CAAC,CACpF,CAAC;IACH,OAAO,KAAK,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC7E,CAAC"}

package/dist/tasks/invocation.d.ts

@@ -0,0 +1,15 @@
+import type { TaskInvocation } from './contracts.js';
+/** Thenable task result that records when application code observes its result edge. */
+export declare class TaskInvocationValue<Result> implements TaskInvocation<Result> {
+    private readonly promise;
+    private readonly observe;
+    readonly [Symbol.toStringTag]: "TaskInvocation";
+    constructor(promise: Promise<Result>, observe?: () => void);
+    /** Observes the result edge and chains fulfillment or rejection handlers. */
+    then<TResult1 = Result, TResult2 = never>(onFulfilled?: ((value: Result) => TResult1 | PromiseLike<TResult1>) | null, onRejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): TaskInvocation<TResult1 | TResult2>;
+    /** Observes the result edge and chains a rejection handler. */
+    catch<TResult = never>(onRejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): TaskInvocation<Result | TResult>;
+    /** Observes the result edge and runs a handler after settlement. */
+    finally(onFinally?: (() => void) | null): TaskInvocation<Result>;
+}
+//# sourceMappingURL=invocation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.d.ts","sourceRoot":"","sources":["../../src/tasks/invocation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,wFAAwF;AACxF,qBAAa,mBAAmB,CAAC,MAAM,CAAE,YAAW,cAAc,CAAC,MAAM,CAAC;IAIxE,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJzB,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAG,gBAAgB,CAAU;gBAGxC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EACxB,OAAO,GAAE,MAAM,IAAsB;IAGvD,6EAA6E;IAC7E,IAAI,CAAC,QAAQ,GAAG,MAAM,EAAE,QAAQ,GAAG,KAAK,EACvC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EAC1E,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GACzE,cAAc,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAKtC,+DAA+D;IAC/D,KAAK,CAAC,OAAO,GAAG,KAAK,EACpB,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GACvE,cAAc,CAAC,MAAM,GAAG,OAAO,CAAC;IAKnC,oEAAoE;IACpE,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC;CAIhE"}

package/dist/tasks/invocation.js

@@ -0,0 +1,26 @@
+/** Thenable task result that records when application code observes its result edge. */
+export class TaskInvocationValue {
+    promise;
+    observe;
+    [Symbol.toStringTag] = 'TaskInvocation';
+    constructor(promise, observe = () => undefined) {
+        this.promise = promise;
+        this.observe = observe;
+    }
+    /** Observes the result edge and chains fulfillment or rejection handlers. */
+    then(onFulfilled, onRejected) {
+        this.observe();
+        return new TaskInvocationValue(this.promise.then(onFulfilled, onRejected));
+    }
+    /** Observes the result edge and chains a rejection handler. */
+    catch(onRejected) {
+        this.observe();
+        return new TaskInvocationValue(this.promise.catch(onRejected));
+    }
+    /** Observes the result edge and runs a handler after settlement. */
+    finally(onFinally) {
+        this.observe();
+        return new TaskInvocationValue(this.promise.finally(onFinally ?? undefined));
+    }
+}
+//# sourceMappingURL=invocation.js.map

package/dist/tasks/invocation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invocation.js","sourceRoot":"","sources":["../../src/tasks/invocation.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,MAAM,OAAO,mBAAmB;IAIb;IACA;IAJT,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,gBAAyB,CAAC;IAE1D,YACkB,OAAwB,EACxB,UAAsB,GAAG,EAAE,CAAC,SAAS;QADrC,YAAO,GAAP,OAAO,CAAiB;QACxB,YAAO,GAAP,OAAO,CAA8B;IACpD,CAAC;IAEJ,6EAA6E;IAC7E,IAAI,CACH,WAA0E,EAC1E,UAA2E;QAE3E,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,+DAA+D;IAC/D,KAAK,CACJ,UAAyE;QAEzE,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,oEAAoE;IACpE,OAAO,CAAC,SAA+B;QACtC,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC,CAAC,CAAC;IAC9E,CAAC;CACD"}

package/dist/tasks/observers.d.ts

@@ -0,0 +1,12 @@
+import type { AnyComponentInstance, TaskObserver } from '../component/contracts.js';
+/** Returns the observer that currently owns work for a component. */
+export declare function taskObserverFor(instance: AnyComponentInstance): TaskObserver | undefined;
+/** Retains an observer for renderer-owned component work. */
+export declare function retainTaskObserver(instance: AnyComponentInstance, observer: TaskObserver): void;
+/** Releases renderer-owned observation when a component unmounts. */
+export declare function releaseTaskObserver(instance: AnyComponentInstance): void;
+/** Registers promise settlement with the current component observer. */
+export declare function observeTaskPromise(promise: Promise<unknown>, instance: AnyComponentInstance): void;
+/** Runs work with a task observer installed for nested component construction. */
+export declare function withTaskObserver<T>(observer: TaskObserver | undefined, fn: () => T): T;
+//# sourceMappingURL=observers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"observers.d.ts","sourceRoot":"","sources":["../../src/tasks/observers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAKpF,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,QAAQ,EAAE,oBAAoB,GAAG,YAAY,GAAG,SAAS,CAExF;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAE/F;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAExE;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EACzB,QAAQ,EAAE,oBAAoB,GAC5B,IAAI,CAEN;AAED,kFAAkF;AAClF,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAQtF"}

package/dist/tasks/observers.js

@@ -0,0 +1,31 @@
+const taskObserverStack = [];
+const retainedTaskObservers = new WeakMap();
+/** Returns the observer that currently owns work for a component. */
+export function taskObserverFor(instance) {
+    return taskObserverStack[taskObserverStack.length - 1] ?? retainedTaskObservers.get(instance);
+}
+/** Retains an observer for renderer-owned component work. */
+export function retainTaskObserver(instance, observer) {
+    retainedTaskObservers.set(instance, observer);
+}
+/** Releases renderer-owned observation when a component unmounts. */
+export function releaseTaskObserver(instance) {
+    retainedTaskObservers.delete(instance);
+}
+/** Registers promise settlement with the current component observer. */
+export function observeTaskPromise(promise, instance) {
+    taskObserverFor(instance)?.register(promise, instance);
+}
+/** Runs work with a task observer installed for nested component construction. */
+export function withTaskObserver(observer, fn) {
+    if (!observer)
+        return fn();
+    taskObserverStack.push(observer);
+    try {
+        return fn();
+    }
+    finally {
+        taskObserverStack.pop();
+    }
+}
+//# sourceMappingURL=observers.js.map

package/dist/tasks/observers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observers.js","sourceRoot":"","sources":["../../src/tasks/observers.ts"],"names":[],"mappings":"AAEA,MAAM,iBAAiB,GAAmB,EAAE,CAAC;AAC7C,MAAM,qBAAqB,GAAG,IAAI,OAAO,EAAsC,CAAC;AAEhF,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,QAA8B;IAC7D,OAAO,iBAAiB,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,qBAAqB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC/F,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,kBAAkB,CAAC,QAA8B,EAAE,QAAsB;IACxF,qBAAqB,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/C,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,mBAAmB,CAAC,QAA8B;IACjE,qBAAqB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACxC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,kBAAkB,CACjC,OAAyB,EACzB,QAA8B;IAE9B,eAAe,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAI,QAAkC,EAAE,EAAW;IAClF,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,EAAE,CAAC;IAC3B,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,CAAC;QACJ,OAAO,EAAE,EAAE,CAAC;IACb,CAAC;YAAS,CAAC;QACV,iBAAiB,CAAC,GAAG,EAAE,CAAC;IACzB,CAAC;AACF,CAAC"}

package/dist/tasks/optimism.d.ts

@@ -0,0 +1,5 @@
+import type { RuntimeTaskOptions } from './contracts.js';
+import type { InternalTaskGeneration } from './runtime-types.js';
+/** Captures one synchronous optimistic transition for commit or rollback by its task generation. */
+export declare function applyTaskOptimistic<Result>(record: InternalTaskGeneration<Result>, concurrency: RuntimeTaskOptions<unknown[]>['concurrency'], work: () => void): void;
+//# sourceMappingURL=optimism.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"optimism.d.ts","sourceRoot":"","sources":["../../src/tasks/optimism.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAGjE,oGAAoG;AACpG,wBAAgB,mBAAmB,CAAC,MAAM,EACzC,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC,EACtC,WAAW,EAAE,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC,aAAa,CAAC,EACzD,IAAI,EAAE,MAAM,IAAI,GACd,IAAI,CAaN"}

package/dist/tasks/optimism.js

@@ -0,0 +1,19 @@
+import { captureReactiveMutations } from '@exactjs/reactive/framework/runtime';
+import { isPromiseLike } from '../component/async-value.js';
+import { markTaskPerformanceTrace } from './performance-trace.js';
+/** Captures one synchronous optimistic transition for commit or rollback by its task generation. */
+export function applyTaskOptimistic(record, concurrency, work) {
+    if ((concurrency ?? 'parallel') === 'parallel')
+        throw new Error('Optimistic state requires a latest or queue task');
+    let returned;
+    const journal = captureReactiveMutations(() => {
+        returned = work();
+    });
+    if (isPromiseLike(returned)) {
+        journal.rollback();
+        throw new TypeError('TaskContext.optimistic() requires a synchronous callback');
+    }
+    record.journals.push(journal);
+    markTaskPerformanceTrace(record, 'optimistic-applied');
+}
+//# sourceMappingURL=optimism.js.map

package/dist/tasks/optimism.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimism.js","sourceRoot":"","sources":["../../src/tasks/optimism.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAE/E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAElE,oGAAoG;AACpG,MAAM,UAAU,mBAAmB,CAClC,MAAsC,EACtC,WAAyD,EACzD,IAAgB;IAEhB,IAAI,CAAC,WAAW,IAAI,UAAU,CAAC,KAAK,UAAU;QAC7C,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACrE,IAAI,QAAiB,CAAC;IACtB,MAAM,OAAO,GAAG,wBAAwB,CAAC,GAAG,EAAE;QAC7C,QAAQ,GAAG,IAAI,EAAE,CAAC;IACnB,CAAC,CAAC,CAAC;IACH,IAAI,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,QAAQ,EAAE,CAAC;QACnB,MAAM,IAAI,SAAS,CAAC,0DAA0D,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AACxD,CAAC"}

package/dist/tasks/options.d.ts

@@ -0,0 +1,4 @@
+import type { RuntimeTaskOptions } from './contracts.js';
+/** Validates policy values supplied by explicit runtime task definitions. */
+export declare function validateTaskOptions<Args extends unknown[]>(options: RuntimeTaskOptions<Args>): void;
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/tasks/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,IAAI,SAAS,OAAO,EAAE,EACzD,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,GAC/B,IAAI,CAiBN"}