@exactjs/core 0.5.0

package/dist/tasks/frame-context.js

@@ -0,0 +1,39 @@
+import { peek } from '@exactjs/reactive/framework/runtime';
+const contextFrames = new WeakMap();
+/** Creates and retains the public context owned by one task frame. */
+export function createTaskFrameContext(frame, options) {
+    const context = {
+        signal: frame.controller.signal,
+        generation: options.generation ?? 1,
+        activation: options.activation ?? 'invoked',
+        peek,
+        optimistic: options.optimistic ??
+            (() => {
+                throw new Error('Optimistic state is not available for this task activation');
+            }),
+        cleanup(cleanup) {
+            if (frame.settled || !frame.producerOpen)
+                throw new Error('Cannot register cleanup after the task producer has closed');
+            (frame.cleanups ??= []).push(cleanup);
+        },
+        own(resource) {
+            context.cleanup(async () => {
+                if (Symbol.asyncDispose in resource)
+                    await resource[Symbol.asyncDispose]();
+                else
+                    resource[Symbol.dispose]();
+            });
+            return resource;
+        }
+    };
+    contextFrames.set(context, frame);
+    return context;
+}
+/** Resolves the opaque frame retained by a task context. */
+export function frameForTaskContext(context) {
+    const frame = contextFrames.get(context);
+    if (!frame || frame.settled)
+        throw new Error('Task context belongs to a settled or unknown frame');
+    return frame;
+}
+//# sourceMappingURL=frame-context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frame-context.js","sourceRoot":"","sources":["../../src/tasks/frame-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qCAAqC,CAAC;AAI3D,MAAM,aAAa,GAAG,IAAI,OAAO,EAAgC,CAAC;AAElE,sEAAsE;AACtE,MAAM,UAAU,sBAAsB,CACrC,KAAsB,EACtB,OAAiC;IAEjC,MAAM,OAAO,GAAgB;QAC5B,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,MAAM;QAC/B,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,CAAC;QACnC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,SAAS;QAC3C,IAAI;QACJ,UAAU,EACT,OAAO,CAAC,UAAU;YAClB,CAAC,GAAG,EAAE;gBACL,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAC/E,CAAC,CAAC;QACH,OAAO,CAAC,OAAO;YACd,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY;gBACvC,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;YAC/E,CAAC,KAAK,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QACD,GAAG,CAAC,QAAQ;YACX,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;gBAC1B,IAAI,MAAM,CAAC,YAAY,IAAI,QAAQ;oBAAE,MAAM,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;;oBACtE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACjC,CAAC,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QACjB,CAAC;KACD,CAAC;IACF,aAAa,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,OAAoB;IACvD,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO;QAC1B,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { TaskFrameRecord } from './frame-contracts.js';
+/** Associates a frame signal with the frame restored after compiler-lowered awaits. */
+export declare function registerTaskFrameSignal(signal: AbortSignal, frame: TaskFrameRecord): void;
+/** Releases continuation restoration state when its frame settles. */
+export declare function releaseTaskFrameSignal(signal: AbortSignal): void;
+/** Queues one serialized continuation resumption for the frame owning a task signal. */
+export declare function resumeTaskFrameContinuation(signal: AbortSignal, resume: () => void, enter: (frame: TaskFrameRecord) => () => void): void;
+//# sourceMappingURL=frame-continuation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frame-continuation.d.ts","sourceRoot":"","sources":["../../src/tasks/frame-continuation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAU5D,uFAAuF;AACvF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAEzF;AAED,sEAAsE;AACtE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAEhE;AAED,wFAAwF;AACxF,wBAAgB,2BAA2B,CAC1C,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,MAAM,IAAI,EAClB,KAAK,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,MAAM,IAAI,GAC3C,IAAI,CAYN"}

package/dist/tasks/frame-continuation.js

@@ -0,0 +1,45 @@
+const framesBySignal = new WeakMap();
+const pendingResumptions = [];
+let resumptionScheduled = false;
+/** Associates a frame signal with the frame restored after compiler-lowered awaits. */
+export function registerTaskFrameSignal(signal, frame) {
+    framesBySignal.set(signal, frame);
+}
+/** Releases continuation restoration state when its frame settles. */
+export function releaseTaskFrameSignal(signal) {
+    framesBySignal.delete(signal);
+}
+/** Queues one serialized continuation resumption for the frame owning a task signal. */
+export function resumeTaskFrameContinuation(signal, resume, enter) {
+    const frame = framesBySignal.get(signal);
+    if (!frame || frame.settled) {
+        resume();
+        return;
+    }
+    pendingResumptions.push({ frame, resume, enter });
+    if (resumptionScheduled)
+        return;
+    resumptionScheduled = true;
+    // The promise-resolution job is already an asynchronous boundary. Enter the uncontended first
+    // continuation there and retain the queue only for resolutions that overlap its authored job.
+    runNextTaskResumption();
+}
+/** Serializes restoration so concurrent promise resolutions cannot exchange task ownership. */
+function runNextTaskResumption() {
+    const next = pendingResumptions.shift();
+    if (!next) {
+        resumptionScheduled = false;
+        return;
+    }
+    const leave = next.enter(next.frame);
+    next.resume();
+    // Promise resolution queues the authored continuation before the next restoration job.
+    queueMicrotask(() => {
+        leave();
+        if (pendingResumptions.length)
+            queueMicrotask(runNextTaskResumption);
+        else
+            resumptionScheduled = false;
+    });
+}
+//# sourceMappingURL=frame-continuation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frame-continuation.js","sourceRoot":"","sources":["../../src/tasks/frame-continuation.ts"],"names":[],"mappings":"AAEA,MAAM,cAAc,GAAG,IAAI,OAAO,EAAgC,CAAC;AACnE,MAAM,kBAAkB,GAInB,EAAE,CAAC;AACR,IAAI,mBAAmB,GAAG,KAAK,CAAC;AAEhC,uFAAuF;AACvF,MAAM,UAAU,uBAAuB,CAAC,MAAmB,EAAE,KAAsB;IAClF,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AACnC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,sBAAsB,CAAC,MAAmB;IACzD,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,2BAA2B,CAC1C,MAAmB,EACnB,MAAkB,EAClB,KAA6C;IAE7C,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,EAAE,CAAC;QACT,OAAO;IACR,CAAC;IACD,kBAAkB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,IAAI,mBAAmB;QAAE,OAAO;IAChC,mBAAmB,GAAG,IAAI,CAAC;IAC3B,8FAA8F;IAC9F,8FAA8F;IAC9F,qBAAqB,EAAE,CAAC;AACzB,CAAC;AAED,+FAA+F;AAC/F,SAAS,qBAAqB;IAC7B,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,EAAE,CAAC;IACxC,IAAI,CAAC,IAAI,EAAE,CAAC;QACX,mBAAmB,GAAG,KAAK,CAAC;QAC5B,OAAO;IACR,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,CAAC,MAAM,EAAE,CAAC;IACd,uFAAuF;IACvF,cAAc,CAAC,GAAG,EAAE;QACnB,KAAK,EAAE,CAAC;QACR,IAAI,kBAAkB,CAAC,MAAM;YAAE,cAAc,CAAC,qBAAqB,CAAC,CAAC;;YAChE,mBAAmB,GAAG,KAAK,CAAC;IAClC,CAAC,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,80 @@
+import type { AnyTaskFunction, TaskActivation, TaskContext, TaskOwner } from './contracts.js';
+/** Brands internal task frame records without exposing their representation publicly. */
+export declare const taskFrameTokenBrand: unique symbol;
+/** Brands durable task owners shared by compiler-authored and explicit runtime tasks. */
+export declare const taskOwnerBrand: unique symbol;
+/** Releases one resource owned by a task frame, synchronously or asynchronously. */
+export type TaskFrameCleanup = () => void | Promise<void>;
+/** Deferred setup activation held while a durable host restores SSR state. */
+export type TaskActivationRegistration = {
+    readonly task: AnyTaskFunction;
+    settled: boolean;
+    start(skipInitial: boolean): void;
+};
+/** Internal durable owner representation shared by the task ABI and framework SPI. */
+export type TaskOwnerRecord = TaskOwner & {
+    readonly [taskOwnerBrand]: true;
+    readonly label?: string;
+    readonly frames: Set<TaskFrameRecord>;
+    readonly settlements: Set<PromiseLike<unknown>>;
+    readonly ownerCleanups: Set<TaskFrameCleanup>;
+    readonly activationRegistrations: Set<TaskActivationRegistration>;
+    readonly controller: AbortController;
+    host?: object;
+    observeSettlement?: (settlement: Promise<unknown>) => void;
+    runTask?: <T>(work: () => Promise<T>) => Promise<T>;
+    registerReadiness?: (taskGeneration: number, settlement: PromiseLike<unknown>, commit: () => void, discard: () => void) => {
+        cancel(): void;
+    };
+    activationsDeferred: boolean;
+    disposed: boolean;
+};
+/** Internal opaque frame token implementation. */
+export type TaskFrameRecord = {
+    readonly [taskFrameTokenBrand]: true;
+    readonly id: number;
+    readonly owner: TaskOwnerRecord;
+    readonly parent?: TaskFrameRecord;
+    readonly controller: AbortController;
+    children?: Set<Promise<void>>;
+    cleanups?: TaskFrameCleanup[];
+    readonly context?: TaskContext;
+    readonly kind: string;
+    readonly label?: string;
+    readonly sourceEntityId?: string;
+    readonly activation: TaskActivation;
+    readonly generation: number;
+    readonly placement: 'current' | 'client' | 'server';
+    readonly concurrency: 'parallel' | 'latest' | 'queue';
+    readonly priority: 'immediate' | 'normal' | 'deferred';
+    readonly readiness: 'blocking' | 'nonblocking';
+    readonly startedAt: number;
+    producerOpen: boolean;
+    settled: boolean;
+};
+/** Internal options used to create a task frame. */
+export type InternalTaskFrameOptions = {
+    readonly parent?: TaskFrameRecord;
+    readonly owner?: TaskOwnerRecord;
+    readonly controller?: AbortController;
+    readonly generation?: number;
+    readonly activation?: TaskActivation;
+    readonly detached?: boolean;
+    readonly priority?: 'immediate' | 'normal' | 'deferred';
+    readonly readiness?: 'blocking' | 'nonblocking';
+    readonly optimistic?: (work: () => void) => void;
+    readonly kind?: string;
+    readonly label?: string;
+    readonly sourceEntityId?: string;
+    readonly placement?: 'current' | 'client' | 'server';
+    readonly concurrency?: 'parallel' | 'latest' | 'queue';
+    /** Invocation arguments exposed only as a bounded preview while inspection is attached. */
+    readonly inspectionArguments?: readonly unknown[];
+    /** Whether a failed child contributes structural failure to its parent. */
+    readonly propagateFailure?: () => boolean;
+    /** Confirms that the caller atomically reserved this parent before scheduling. */
+    readonly parentReserved?: boolean;
+    /** Omits the public TaskContext for internal hosts whose callback cannot observe it. */
+    readonly publicContext?: false;
+};
+//# sourceMappingURL=frame-contracts.d.ts.map

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

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

package/dist/tasks/frame-contracts.js

@@ -0,0 +1,5 @@
+/** Brands internal task frame records without exposing their representation publicly. */
+export const taskFrameTokenBrand = Symbol('exact.task-frame-token');
+/** Brands durable task owners shared by compiler-authored and explicit runtime tasks. */
+export const taskOwnerBrand = Symbol.for('@exactjs/task-owner');
+//# sourceMappingURL=frame-contracts.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frame-contracts.js","sourceRoot":"","sources":["../../src/tasks/frame-contracts.ts"],"names":[],"mappings":"AAEA,yFAAyF;AACzF,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AACpE,yFAAyF;AACzF,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC"}

package/dist/tasks/frame-inspection-capability.d.ts

@@ -0,0 +1,23 @@
+import type { ExactRuntimeInspectionEventKind } from '@exactjs/devtools-protocol';
+import type { TaskFrameRecord } from './frame-contracts.js';
+/** Optional observation retained only by inspection-enabled task-frame transitions. */
+export type TaskFrameEventObservation = Readonly<{
+    kind: 'start';
+    arguments?: readonly unknown[];
+}> | Readonly<{
+    kind: 'outcome';
+    status: 'settled' | 'failed' | 'cancelled';
+    value: unknown;
+}>;
+type TaskFrameInspectionCapability = Readonly<{
+    publish(frame: TaskFrameRecord, kind: ExactRuntimeInspectionEventKind, reason?: unknown, observation?: TaskFrameEventObservation): void;
+    attached(frame: TaskFrameRecord): boolean;
+}>;
+/** Installs task-frame diagnostics when an inspection owner is actually constructed. */
+export declare function installTaskFrameInspectionCapability(next: TaskFrameInspectionCapability): void;
+/** Publishes through the optional diagnostic capability without retaining its implementation. */
+export declare function publishTaskFrameEvent(frame: TaskFrameRecord, kind: ExactRuntimeInspectionEventKind, reason?: unknown, observation?: TaskFrameEventObservation): void;
+/** Reports attachment without loading task snapshot and preview machinery in production builds. */
+export declare function taskFrameInspectionAttached(frame: TaskFrameRecord): boolean;
+export {};
+//# sourceMappingURL=frame-inspection-capability.d.ts.map

package/dist/tasks/frame-inspection-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-inspection-capability.d.ts","sourceRoot":"","sources":["../../src/tasks/frame-inspection-capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,uFAAuF;AACvF,MAAM,MAAM,yBAAyB,GAClC,QAAQ,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,CAAC,GAC3D,QAAQ,CAAC;IACT,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC3C,KAAK,EAAE,OAAO,CAAC;CACd,CAAC,CAAC;AAEN,KAAK,6BAA6B,GAAG,QAAQ,CAAC;IAC7C,OAAO,CACN,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,+BAA+B,EACrC,MAAM,CAAC,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,yBAAyB,GACrC,IAAI,CAAC;IACR,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC;CAC1C,CAAC,CAAC;AAIH,wFAAwF;AACxF,wBAAgB,oCAAoC,CAAC,IAAI,EAAE,6BAA6B,GAAG,IAAI,CAE9F;AAED,iGAAiG;AACjG,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,+BAA+B,EACrC,MAAM,CAAC,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,yBAAyB,GACrC,IAAI,CAEN;AAED,mGAAmG;AACnG,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE3E"}

package/dist/tasks/frame-inspection-capability.js

@@ -0,0 +1,14 @@
+let capability;
+/** Installs task-frame diagnostics when an inspection owner is actually constructed. */
+export function installTaskFrameInspectionCapability(next) {
+    capability ??= next;
+}
+/** Publishes through the optional diagnostic capability without retaining its implementation. */
+export function publishTaskFrameEvent(frame, kind, reason, observation) {
+    capability?.publish(frame, kind, reason, observation);
+}
+/** Reports attachment without loading task snapshot and preview machinery in production builds. */
+export function taskFrameInspectionAttached(frame) {
+    return capability?.attached(frame) ?? false;
+}
+//# sourceMappingURL=frame-inspection-capability.js.map

package/dist/tasks/frame-inspection-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-inspection-capability.js","sourceRoot":"","sources":["../../src/tasks/frame-inspection-capability.ts"],"names":[],"mappings":"AAsBA,IAAI,UAAqD,CAAC;AAE1D,wFAAwF;AACxF,MAAM,UAAU,oCAAoC,CAAC,IAAmC;IACvF,UAAU,KAAK,IAAI,CAAC;AACrB,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,qBAAqB,CACpC,KAAsB,EACtB,IAAqC,EACrC,MAAgB,EAChB,WAAuC;IAEvC,UAAU,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACvD,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,2BAA2B,CAAC,KAAsB;IACjE,OAAO,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,35 @@
+import type { ExactRuntimeInspectionEventKind, ExactTaskRuntimeSnapshot } from '@exactjs/devtools-protocol';
+import type { AnyComponentInstance } from '../component/contracts.js';
+import type { ExactRuntimeInspectionOwner } from '../component/inspection.js';
+import type { TaskFrameRecord } from './frame-runtime.js';
+import { type TaskFrameEventObservation } from './frame-inspection-capability.js';
+/** Immutable task-frame projection used by authorized runtime inspection. */
+export type TaskFrameInspection = Readonly<{
+    id: number;
+    parentId?: number;
+    parentGeneration?: number;
+    parentSourceEntityId?: string;
+    kind: string;
+    label?: string;
+    sourceEntityId?: string;
+    activation: 'initialization' | 'reactive' | 'interaction' | 'invoked' | 'lifecycle';
+    generation: number;
+    placement: 'current' | 'client' | 'server';
+    concurrency: 'parallel' | 'latest' | 'queue';
+    priority: 'immediate' | 'normal' | 'deferred';
+    readiness: 'blocking' | 'nonblocking';
+    foreground: boolean;
+    structuralPending: boolean;
+    startedAt: number;
+}>;
+/** Returns active frame metadata without exposing mutable frame or owner internals. */
+export declare function inspectTaskFramesForHost(host: object): readonly TaskFrameInspection[];
+/** Returns active task snapshots for a component under an attached inspection owner. */
+export declare function inspectTaskFrameSnapshotsForHost(host: AnyComponentInstance, inspection: ExactRuntimeInspectionOwner): readonly ExactTaskRuntimeSnapshot[];
+/** Publishes one frame transition when its durable host has inspection enabled. */
+export declare function publishTaskFrameEvent(frame: TaskFrameRecord, kind: ExactRuntimeInspectionEventKind, reason?: unknown, observation?: TaskFrameEventObservation): void;
+/** Returns whether this frame's component domain currently has an attached inspection session. */
+export declare function taskFrameInspectionAttached(frame: TaskFrameRecord): boolean;
+/** Activates the full task diagnostic path only for builds that construct an inspection owner. */
+export declare function activateTaskFrameInspection(): void;
+//# sourceMappingURL=frame-inspection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frame-inspection.d.ts","sourceRoot":"","sources":["../../src/tasks/frame-inspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,+BAA+B,EAC/B,wBAAwB,EAExB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAK9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAEN,KAAK,yBAAyB,EAC9B,MAAM,kCAAkC,CAAC;AAG1C,6EAA6E;AAC7E,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,gBAAgB,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,GAAG,WAAW,CAAC;IACpF,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC3C,WAAW,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC7C,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC9C,SAAS,EAAE,UAAU,GAAG,aAAa,CAAC;IACtC,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,uFAAuF;AACvF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,mBAAmB,EAAE,CAGrF;AAED,wFAAwF;AACxF,wBAAgB,gCAAgC,CAC/C,IAAI,EAAE,oBAAoB,EAC1B,UAAU,EAAE,2BAA2B,GACrC,SAAS,wBAAwB,EAAE,CAMrC;AAiDD,mFAAmF;AACnF,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,+BAA+B,EACrC,MAAM,CAAC,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,yBAAyB,GACrC,IAAI,CAaN;AAED,kGAAkG;AAClG,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE3E;AA0GD,kGAAkG;AAClG,wBAAgB,2BAA2B,IAAI,IAAI,CAKlD"}

package/dist/tasks/frame-inspection.js

@@ -0,0 +1,139 @@
+import { componentDomainInspection } from '../component/domain.js';
+import { inspectRetainedTaskExecutions, recordInspectedTask } from '../component/task-inspection-history.js';
+import { installTaskFrameInspectionCapability } from './frame-inspection-capability.js';
+import { taskOwnerForHost } from './owner-hosts.js';
+/** Returns active frame metadata without exposing mutable frame or owner internals. */
+export function inspectTaskFramesForHost(host) {
+    const owner = taskOwnerForHost(host);
+    return owner ? Object.freeze([...owner.frames].map(inspectFrame)) : Object.freeze([]);
+}
+/** Returns active task snapshots for a component under an attached inspection owner. */
+export function inspectTaskFrameSnapshotsForHost(host, inspection) {
+    return Object.freeze(inspectTaskFramesForHost(host).map((frame) => taskFrameSnapshot(inspection, host, frame, 'running')));
+}
+/** Captures arguments at frame entry only when an inspection session is attached. */
+function recordTaskFrameStart(target, frame, invocationArguments) {
+    recordInspectedTask(target.inspection, target.host, taskFrameSnapshot(target.inspection, target.host, inspectFrame(frame), 'running', invocationArguments === undefined
+        ? undefined
+        : {
+            arguments: target.inspection.preview(invocationArguments, taskPath(frame, 'arguments'))
+        }));
+}
+/** Replaces a live execution with its bounded result or failure preview at structural settlement. */
+function recordTaskFrameOutcome(target, frame, status, value) {
+    const previous = inspectRetainedTaskExecutions(target.inspection, target.host).find((task) => taskSnapshotMatchesFrame(task, frame));
+    const outcome = status === 'settled'
+        ? { result: target.inspection.preview(value, taskPath(frame, 'result')) }
+        : { error: target.inspection.preview(value, taskPath(frame, 'error')) };
+    recordInspectedTask(target.inspection, target.host, taskFrameSnapshot(target.inspection, target.host, inspectFrame(frame), status, {
+        ...(previous?.arguments ? { arguments: previous.arguments } : {}),
+        ...outcome
+    }));
+}
+/** Publishes one frame transition when its durable host has inspection enabled. */
+export function publishTaskFrameEvent(frame, kind, reason, observation) {
+    const target = inspectedFrameTarget(frame);
+    if (!target)
+        return;
+    if (observation?.kind === 'start')
+        recordTaskFrameStart(target, frame, observation.arguments);
+    else if (observation?.kind === 'outcome')
+        recordTaskFrameOutcome(target, frame, observation.status, observation.value);
+    target.inspection.publish({
+        kind,
+        component: target.host,
+        sourceEntityId: frameSourceEntityId(frame),
+        generation: frame.generation,
+        ...(reason === undefined ? {} : { reason: String(reason) })
+    });
+}
+/** Returns whether this frame's component domain currently has an attached inspection session. */
+export function taskFrameInspectionAttached(frame) {
+    return inspectedFrameTarget(frame) !== undefined;
+}
+function taskFrameSnapshot(owner, component, frame, status, outcome = {}) {
+    const settled = status !== 'running';
+    return Object.freeze({
+        id: owner.identity(component, {
+            sourceEntityId: frame.sourceEntityId ?? `runtime-task-frame:${frame.id}`,
+            generation: frame.generation
+        }),
+        ...(frame.parentId === undefined
+            ? {}
+            : {
+                parent: owner.identity(component, {
+                    sourceEntityId: frame.parentSourceEntityId ?? `runtime-task-frame:${frame.parentId}`,
+                    generation: frame.parentGeneration
+                })
+            }),
+        ...(frame.label === undefined ? {} : { name: frame.label }),
+        kind: frame.kind,
+        activation: frame.activation,
+        placement: frame.placement === 'current' ? 'isomorphic' : frame.placement,
+        readiness: frame.readiness,
+        priority: frame.priority,
+        concurrency: frame.concurrency,
+        status,
+        generation: frame.generation,
+        pending: settled ? 0 : frame.foreground ? 1 : 0,
+        foreground: settled ? false : frame.foreground,
+        structuralPending: settled ? false : frame.structuralPending,
+        optimistic: false,
+        ...(status === 'settled' ? { completedGeneration: frame.generation } : {}),
+        ...(status === 'failed' ? { failedGeneration: frame.generation } : {}),
+        startedAt: frame.startedAt,
+        ...(settled ? { settledAt: monotonicTimestamp() } : {}),
+        ...outcome
+    });
+}
+function inspectFrame(frame) {
+    return Object.freeze({
+        id: frame.id,
+        ...(frame.parent
+            ? {
+                parentId: frame.parent.id,
+                parentGeneration: frame.parent.generation,
+                ...(frame.parent.sourceEntityId
+                    ? { parentSourceEntityId: frame.parent.sourceEntityId }
+                    : {})
+            }
+            : {}),
+        kind: frame.kind,
+        ...(frame.label === undefined ? {} : { label: frame.label }),
+        ...(frame.sourceEntityId === undefined ? {} : { sourceEntityId: frame.sourceEntityId }),
+        activation: frame.activation,
+        generation: frame.generation,
+        placement: frame.placement,
+        concurrency: frame.concurrency,
+        priority: frame.priority,
+        readiness: frame.readiness,
+        foreground: frame.readiness === 'blocking' && frame.priority !== 'deferred',
+        structuralPending: !frame.settled,
+        startedAt: frame.startedAt
+    });
+}
+function inspectedFrameTarget(frame) {
+    const host = frame.owner.host;
+    const inspection = host?.domain ? componentDomainInspection(host.domain) : undefined;
+    return host && inspection?.attached ? { host, inspection } : undefined;
+}
+function taskSnapshotMatchesFrame(task, frame) {
+    return (task.generation === frame.generation && task.id.sourceEntityId === frameSourceEntityId(frame));
+}
+function frameSourceEntityId(frame) {
+    return frame.sourceEntityId ?? `runtime-task-frame:${frame.id}`;
+}
+function taskPath(frame, field) {
+    return ['task', frameSourceEntityId(frame), String(frame.generation), field];
+}
+function monotonicTimestamp() {
+    return globalThis.performance?.now() ?? Date.now();
+}
+/** Activates the full task diagnostic path only for builds that construct an inspection owner. */
+export function activateTaskFrameInspection() {
+    installTaskFrameInspectionCapability({
+        publish: publishTaskFrameEvent,
+        attached: taskFrameInspectionAttached
+    });
+}
+//# sourceMappingURL=frame-inspection.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { TaskContext, TaskOwner } from './contracts.js';
+import { frameForTaskContext } from './frame-context.js';
+import { type InternalTaskFrameOptions, type TaskFrameCleanup, type TaskFrameRecord, type TaskOwnerRecord } from './frame-contracts.js';
+export type { InternalTaskFrameOptions, TaskActivationRegistration, TaskFrameRecord, TaskOwnerRecord } from './frame-contracts.js';
+/** Creates a durable task owner and its cancellation lifetime. */
+export declare function createTaskOwnerRecord(label?: string): TaskOwnerRecord;
+/** Retains setup-owned cleanup until its durable task owner is disposed. */
+export declare function registerTaskOwnerCleanup(owner: TaskOwnerRecord, cleanup: TaskFrameCleanup): void;
+/** Validates and returns the internal representation of a public owner. */
+export declare function taskOwnerRecord(owner: TaskOwner): TaskOwnerRecord;
+/** Returns the frame active for the current synchronous execution segment. */
+export declare function currentTaskFrameRecord(): TaskFrameRecord | undefined;
+/** Materializes an interaction frame only when synchronous work requests structural ownership. */
+export declare function materializeDeferredTaskFrame(): TaskFrameRecord | undefined;
+/** Installs the lazy structural parent available to task and navigation operations during work. */
+export declare function withDeferredTaskFrame<T>(materialize: () => TaskFrameRecord, work: () => T): T;
+/** Returns the durable owner supplied by the current framework host. */
+export declare function currentTaskOwnerRecord(): TaskOwnerRecord | undefined;
+/** Establishes a durable host owner during component state-machine construction or adapter setup. */
+export declare function withTaskOwnerRecord<T>(owner: TaskOwnerRecord, work: () => T): T;
+/** Runs a synchronous segment with one frame as ambient context. */
+export declare function withTaskFrameRecord<T>(frame: TaskFrameRecord, work: () => T): T;
+/**
+ * Runs work in a frame, then waits for dynamically attached descendants and
+ * executes cleanup in last-in-first-out order.
+ */
+export declare function executeTaskFrame<T>(options: InternalTaskFrameOptions, work: (context: TaskContext) => T | PromiseLike<T>): Promise<T>;
+/** Returns an error thrown before a task frame's producer yielded to asynchronous work. */
+export declare function taskFrameSynchronousError(execution: PromiseLike<unknown>): {
+    readonly error: unknown;
+} | undefined;
+/** Adds a structural contribution to a frame before its producer closes. */
+export declare function attachTaskFrameSettlement(frame: TaskFrameRecord, settlement: PromiseLike<unknown>): void;
+/** Adds structural work to the synchronously active task frame, when present. */
+export declare function joinTask(settlement: PromiseLike<unknown>): void;
+/** Publishes a task-owned mutation only while its generation remains current. */
+export declare function taskMutation<Result>(signal: AbortSignal, mutation: () => Result): Result;
+/** Restores the owning task frame around one compiler-lowered async continuation. */
+export declare function resumeTaskFrame(signal: AbortSignal, resume: () => void): void;
+export { frameForTaskContext };
+/** Allocates one process-local frame identity for internal consequence frames. */
+export declare function allocateTaskFrameId(): number;
+//# sourceMappingURL=frame-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frame-runtime.d.ts","sourceRoot":"","sources":["../../src/tasks/frame-runtime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAO7D,OAAO,EAA0B,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAajF,OAAO,EAGN,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACX,wBAAwB,EACxB,0BAA0B,EAC1B,eAAe,EACf,eAAe,EACf,MAAM,sBAAsB,CAAC;AAQ9B,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAErE;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAGhG;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,eAAe,CAGjE;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,IAAI,eAAe,GAAG,SAAS,CAEpE;AAED,kGAAkG;AAClG,wBAAgB,4BAA4B,IAAI,eAAe,GAAG,SAAS,CAE1E;AAED,mGAAmG;AACnG,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAQ7F;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,IAAI,eAAe,GAAG,SAAS,CAEpE;AAED,qGAAqG;AACrG,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAQ/E;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAU/E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EACjC,OAAO,EAAE,wBAAwB,EACjC,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAChD,OAAO,CAAC,CAAC,CAAC,CAiLZ;AAED,2FAA2F;AAC3F,wBAAgB,yBAAyB,CACxC,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,GAC7B;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAEzC;AAED,4EAA4E;AAC5E,wBAAgB,yBAAyB,CACxC,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAC9B,IAAI,CAMN;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAG/D;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,MAAM,GAAG,MAAM,CAGxF;AAED,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI,CAS7E;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAgB/B,kFAAkF;AAClF,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}