npm - @exactjs/core - Versions diffs - 0.6.1 → 0.6.3 - Mend

@exactjs/core 0.6.1 → 0.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (167) hide show

package/dist/server/framework/task-frames.js CHANGED Viewed

@@ -156,4 +156,5 @@ function rejectedTaskFrameExecution(error) {
 export function runWithTaskFrame(frame, work) {
     return withTaskFrameRecord(frame, work);
 }
+export { attachTaskProgressReporter, taskProgressReceiverForHost } from '../tasks/progress-bindings.js';
 //# sourceMappingURL=task-frames.js.map

package/dist/server/framework/task-frames.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"task-frames.js","sourceRoot":"","sources":["../../../src/framework/task-frames.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TaskContext } from '../tasks/contracts.js';\nimport { TaskCancellation } from '../tasks/cancellation.js';\nimport {\n\tattachTaskFrameSettlement,\n\tcurrentTaskFrameRecord,\n\texecuteTaskFrame,\n\twithTaskFrameRecord,\n\ttype TaskFrameRecord\n} from '../tasks/frame-runtime.js';\n\ndeclare const taskFrameTokenBrand: unique symbol;\n\n/** Opaque authority identifying a live task frame. /\nexport interface TaskFrameToken {\n\treadonly [taskFrameTokenBrand]: true;\n}\n\n/* Framework-owned child frame policy. /\nexport interface RunTaskFrameOptions {\n\treadonly parent?: TaskFrameToken;\n\treadonly kind: string;\n\treadonly label?: string;\n\treadonly generation?: number;\n\treadonly detached?: boolean;\n\treadonly priority?: 'immediate' \| 'normal' \| 'deferred';\n\treadonly readiness?: 'blocking' \| 'nonblocking';\n}\n\n/* Terminal structural outcome reported to framework coordinators. /\nexport type TaskFrameOutcome<T> =\n\t\| { readonly status: 'fulfilled'; readonly value: T }\n\t\| { readonly status: 'rejected'; readonly error: unknown }\n\t\| { readonly status: 'cancelled'; readonly reason: unknown };\n\n/* Foreground readiness outcome reported exactly once. /\nexport type TaskForegroundOutcome =\n\t\| { readonly status: 'ready' }\n\t\| { readonly status: 'rejected'; readonly error: unknown }\n\t\| { readonly status: 'cancelled'; readonly reason: unknown };\n\n/\n Structurally settled framework work with cooperative cancellation.\n \n Cancelling aborts the frame and every attached descendant. The promise does\n * not settle until foreground work, descendants, and cleanup have responded.\n /\nexport interface TaskFrameExecution<T> extends Promise<T> {\n\t/* Signal inherited by the frame's context and attached descendants. /\n\treadonly signal: AbortSignal;\n\n\t/* Requests cooperative cancellation while preserving structural settlement. /\n\tcancel(reason?: unknown): void;\n}\n\n/* Work and settlement hooks for a framework-created task frame. /\nexport interface RunTaskFrameHooks<T> {\n\twork(context: TaskContext): T \| Promise<T>;\n\tafterForeground?(outcome: TaskForegroundOutcome): void \| Promise<void>;\n\tafterChildren?(outcome: TaskFrameOutcome<T>): void \| Promise<void>;\n}\n\n/* Atomically reserved frame that must be run or released exactly once. /\nexport interface TaskFrameReservation extends Disposable {\n\trun<T>(work: (context: TaskContext) => T \| Promise<T>): TaskFrameExecution<T>;\n\tcancel(reason?: unknown): void;\n}\n\n/* Captures the synchronously active opaque task frame. /\nexport function captureTaskFrame(): TaskFrameToken \| undefined {\n\treturn currentTaskFrameRecord() as TaskFrameToken \| undefined;\n}\n\n/\n Runs framework work in a structurally attached, cooperatively cancelable\n * task frame.\n /\nexport function runTaskFrame<T>(\n\toptions: RunTaskFrameOptions,\n\thooks: RunTaskFrameHooks<T>\n): TaskFrameExecution<T> {\n\treturn createTaskFrameExecution(options, hooks, false);\n}\n\n/* Creates the cancelable public execution around one internal frame. /\nfunction createTaskFrameExecution<T>(\n\toptions: RunTaskFrameOptions,\n\thooks: RunTaskFrameHooks<T>,\n\tparentReserved: boolean\n): TaskFrameExecution<T> {\n\tconst controller = new AbortController();\n\tconst execution = runTaskFrameInternal(options, hooks, parentReserved, controller);\n\tconst parent = options.detached\n\t\t? undefined\n\t\t: ((options.parent as TaskFrameRecord \| undefined) ?? currentTaskFrameRecord());\n\tif (parent && !parentReserved && parent.producerOpen && !parent.settled)\n\t\tattachTaskFrameSettlement(parent, execution);\n\treturn exposeTaskFrameExecution(execution, controller);\n}\n\n/* Adds framework cancellation authority to a native settlement promise. /\nfunction exposeTaskFrameExecution<T>(\n\texecution: Promise<T>,\n\tcontroller: AbortController\n): TaskFrameExecution<T> {\n\tlet settled = false;\n\tvoid execution.then(\n\t\t() => {\n\t\t\tsettled = true;\n\t\t},\n\t\t() => {\n\t\t\tsettled = true;\n\t\t}\n\t);\n\treturn Object.defineProperties(execution, {\n\t\tsignal: {\n\t\t\tconfigurable: false,\n\t\t\tenumerable: true,\n\t\t\tvalue: controller.signal,\n\t\t\twritable: false\n\t\t},\n\t\tcancel: {\n\t\t\tconfigurable: false,\n\t\t\tenumerable: false,\n\t\t\tvalue(reason?: unknown) {\n\t\t\t\tif (!settled) controller.abort(reason);\n\t\t\t},\n\t\t\twritable: false\n\t\t}\n\t}) as TaskFrameExecution<T>;\n}\n\nasync function runTaskFrameInternal<T>(\n\toptions: RunTaskFrameOptions,\n\thooks: RunTaskFrameHooks<T>,\n\tparentReserved: boolean,\n\tcontroller: AbortController\n): Promise<T> {\n\tlet foregroundReported = false;\n\tlet childrenReported = false;\n\ttry {\n\t\tconst value = await executeTaskFrame(\n\t\t\t{\n\t\t\t\tparent: options.parent as TaskFrameRecord \| undefined,\n\t\t\t\tparentReserved,\n\t\t\t\tcontroller,\n\t\t\t\tgeneration: options.generation,\n\t\t\t\tdetached: options.detached,\n\t\t\t\tkind: options.kind,\n\t\t\t\tlabel: options.label,\n\t\t\t\tpriority: options.priority,\n\t\t\t\treadiness: options.readiness\n\t\t\t},\n\t\t\tasync (context) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await hooks.work(context);\n\t\t\t\t\tforegroundReported = true;\n\t\t\t\t\tawait hooks.afterForeground?.({ status: 'ready' });\n\t\t\t\t\treturn result;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (!foregroundReported) {\n\t\t\t\t\t\tforegroundReported = true;\n\t\t\t\t\t\tawait hooks.afterForeground?.(foregroundOutcome(controller.signal, error));\n\t\t\t\t\t}\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t}\n\t\t);\n\t\tchildrenReported = true;\n\t\tawait hooks.afterChildren?.({ status: 'fulfilled', value });\n\t\treturn value;\n\t} catch (error) {\n\t\tif (!foregroundReported) {\n\t\t\tforegroundReported = true;\n\t\t\tawait hooks.afterForeground?.(foregroundOutcome(controller.signal, error));\n\t\t}\n\t\tif (!childrenReported) {\n\t\t\tchildrenReported = true;\n\t\t\tawait hooks.afterChildren?.(structuralOutcome(controller.signal, error));\n\t\t}\n\t\tthrow error;\n\t}\n}\n\n/* Classifies foreground failure using the frame's cancellation authority. /\nfunction foregroundOutcome(signal: AbortSignal, error: unknown): TaskForegroundOutcome {\n\treturn signal.aborted \|\| error instanceof TaskCancellation\n\t\t? { status: 'cancelled', reason: cancellationReason(signal, error) }\n\t\t: { status: 'rejected', error };\n}\n\n/* Classifies structural failure using the frame's cancellation authority. /\nfunction structuralOutcome<T>(signal: AbortSignal, error: unknown): TaskFrameOutcome<T> {\n\treturn error instanceof TaskCancellation\n\t\t? { status: 'cancelled', reason: cancellationReason(signal, error) }\n\t\t: { status: 'rejected', error };\n}\n\n/* Preserves the originating abort reason after runtime cancellation wrapping. /\nfunction cancellationReason(signal: AbortSignal, error: unknown): unknown {\n\tif (error instanceof TaskCancellation) return error.reason;\n\treturn signal.aborted ? signal.reason : error;\n}\n\n/* Reserves an attached child before handing work to an external scheduler. /\nexport function reserveTaskFrame(options: RunTaskFrameOptions): TaskFrameReservation {\n\tconst parent = (options.parent as TaskFrameRecord \| undefined) ?? currentTaskFrameRecord();\n\tif (!parent) throw new Error('A task frame reservation requires an active or explicit parent');\n\tlet used = false;\n\tlet release!: () => void;\n\tconst placeholder = new Promise<void>((resolve) => {\n\t\trelease = resolve;\n\t});\n\tattachTaskFrameSettlement(parent, placeholder);\n\treturn {\n\t\trun<T>(work: (context: TaskContext) => T \| Promise<T>): TaskFrameExecution<T> {\n\t\t\tif (used)\n\t\t\t\treturn rejectedTaskFrameExecution(new Error('Task frame reservation was already released'));\n\t\t\tused = true;\n\t\t\tconst execution = createTaskFrameExecution(\n\t\t\t\t{ ...options, parent: parent as unknown as TaskFrameToken },\n\t\t\t\t{ work },\n\t\t\t\ttrue\n\t\t\t);\n\t\t\t// Keep the atomic placeholder until the public execution, including\n\t\t\t// its structural finalizer, has settled.\n\t\t\tvoid execution.then(release, release);\n\t\t\treturn execution;\n\t\t},\n\t\tcancel() {\n\t\t\tif (used) return;\n\t\t\tused = true;\n\t\t\trelease();\n\t\t},\n\t\t[Symbol.dispose]() {\n\t\t\tif (used) return;\n\t\t\tused = true;\n\t\t\trelease();\n\t\t}\n\t};\n}\n\n/* Creates a settled execution for invalid reservation reuse. /\nfunction rejectedTaskFrameExecution<T>(error: unknown): TaskFrameExecution<T> {\n\tconst controller = new AbortController();\n\treturn exposeTaskFrameExecution(Promise.reject<T>(error), controller);\n}\n\n/* Restores a captured frame for one synchronous callback segment. */\nexport function runWithTaskFrame<T>(frame: TaskFrameToken, work: () => T): T {\n\treturn withTaskFrameRecord(frame as unknown as TaskFrameRecord, work);\n}\n"]}
1	+ {"version":3,"file":"task-frames.js","sourceRoot":"","sources":["../../../src/framework/task-frames.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TaskContext } from '../tasks/contracts.js';\nimport { TaskCancellation } from '../tasks/cancellation.js';\nimport {\n\tattachTaskFrameSettlement,\n\tcurrentTaskFrameRecord,\n\texecuteTaskFrame,\n\twithTaskFrameRecord,\n\ttype TaskFrameRecord\n} from '../tasks/frame-runtime.js';\n\ndeclare const taskFrameTokenBrand: unique symbol;\n\n/** Opaque authority identifying a live task frame. /\nexport interface TaskFrameToken {\n\treadonly [taskFrameTokenBrand]: true;\n}\n\n/* Framework-owned child frame policy. /\nexport interface RunTaskFrameOptions {\n\treadonly parent?: TaskFrameToken;\n\treadonly kind: string;\n\treadonly label?: string;\n\treadonly generation?: number;\n\treadonly detached?: boolean;\n\treadonly priority?: 'immediate' \| 'normal' \| 'deferred';\n\treadonly readiness?: 'blocking' \| 'nonblocking';\n}\n\n/* Terminal structural outcome reported to framework coordinators. /\nexport type TaskFrameOutcome<T> =\n\t\| { readonly status: 'fulfilled'; readonly value: T }\n\t\| { readonly status: 'rejected'; readonly error: unknown }\n\t\| { readonly status: 'cancelled'; readonly reason: unknown };\n\n/* Foreground readiness outcome reported exactly once. /\nexport type TaskForegroundOutcome =\n\t\| { readonly status: 'ready' }\n\t\| { readonly status: 'rejected'; readonly error: unknown }\n\t\| { readonly status: 'cancelled'; readonly reason: unknown };\n\n/\n Structurally settled framework work with cooperative cancellation.\n \n Cancelling aborts the frame and every attached descendant. The promise does\n * not settle until foreground work, descendants, and cleanup have responded.\n /\nexport interface TaskFrameExecution<T> extends Promise<T> {\n\t/* Signal inherited by the frame's context and attached descendants. /\n\treadonly signal: AbortSignal;\n\n\t/* Requests cooperative cancellation while preserving structural settlement. /\n\tcancel(reason?: unknown): void;\n}\n\n/* Work and settlement hooks for a framework-created task frame. /\nexport interface RunTaskFrameHooks<T> {\n\twork(context: TaskContext): T \| Promise<T>;\n\tafterForeground?(outcome: TaskForegroundOutcome): void \| Promise<void>;\n\tafterChildren?(outcome: TaskFrameOutcome<T>): void \| Promise<void>;\n}\n\n/* Atomically reserved frame that must be run or released exactly once. /\nexport interface TaskFrameReservation extends Disposable {\n\trun<T>(work: (context: TaskContext) => T \| Promise<T>): TaskFrameExecution<T>;\n\tcancel(reason?: unknown): void;\n}\n\n/* Captures the synchronously active opaque task frame. /\nexport function captureTaskFrame(): TaskFrameToken \| undefined {\n\treturn currentTaskFrameRecord() as TaskFrameToken \| undefined;\n}\n\n/\n Runs framework work in a structurally attached, cooperatively cancelable\n * task frame.\n /\nexport function runTaskFrame<T>(\n\toptions: RunTaskFrameOptions,\n\thooks: RunTaskFrameHooks<T>\n): TaskFrameExecution<T> {\n\treturn createTaskFrameExecution(options, hooks, false);\n}\n\n/* Creates the cancelable public execution around one internal frame. /\nfunction createTaskFrameExecution<T>(\n\toptions: RunTaskFrameOptions,\n\thooks: RunTaskFrameHooks<T>,\n\tparentReserved: boolean\n): TaskFrameExecution<T> {\n\tconst controller = new AbortController();\n\tconst execution = runTaskFrameInternal(options, hooks, parentReserved, controller);\n\tconst parent = options.detached\n\t\t? undefined\n\t\t: ((options.parent as TaskFrameRecord \| undefined) ?? currentTaskFrameRecord());\n\tif (parent && !parentReserved && parent.producerOpen && !parent.settled)\n\t\tattachTaskFrameSettlement(parent, execution);\n\treturn exposeTaskFrameExecution(execution, controller);\n}\n\n/* Adds framework cancellation authority to a native settlement promise. /\nfunction exposeTaskFrameExecution<T>(\n\texecution: Promise<T>,\n\tcontroller: AbortController\n): TaskFrameExecution<T> {\n\tlet settled = false;\n\tvoid execution.then(\n\t\t() => {\n\t\t\tsettled = true;\n\t\t},\n\t\t() => {\n\t\t\tsettled = true;\n\t\t}\n\t);\n\treturn Object.defineProperties(execution, {\n\t\tsignal: {\n\t\t\tconfigurable: false,\n\t\t\tenumerable: true,\n\t\t\tvalue: controller.signal,\n\t\t\twritable: false\n\t\t},\n\t\tcancel: {\n\t\t\tconfigurable: false,\n\t\t\tenumerable: false,\n\t\t\tvalue(reason?: unknown) {\n\t\t\t\tif (!settled) controller.abort(reason);\n\t\t\t},\n\t\t\twritable: false\n\t\t}\n\t}) as TaskFrameExecution<T>;\n}\n\nasync function runTaskFrameInternal<T>(\n\toptions: RunTaskFrameOptions,\n\thooks: RunTaskFrameHooks<T>,\n\tparentReserved: boolean,\n\tcontroller: AbortController\n): Promise<T> {\n\tlet foregroundReported = false;\n\tlet childrenReported = false;\n\ttry {\n\t\tconst value = await executeTaskFrame(\n\t\t\t{\n\t\t\t\tparent: options.parent as TaskFrameRecord \| undefined,\n\t\t\t\tparentReserved,\n\t\t\t\tcontroller,\n\t\t\t\tgeneration: options.generation,\n\t\t\t\tdetached: options.detached,\n\t\t\t\tkind: options.kind,\n\t\t\t\tlabel: options.label,\n\t\t\t\tpriority: options.priority,\n\t\t\t\treadiness: options.readiness\n\t\t\t},\n\t\t\tasync (context) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst result = await hooks.work(context);\n\t\t\t\t\tforegroundReported = true;\n\t\t\t\t\tawait hooks.afterForeground?.({ status: 'ready' });\n\t\t\t\t\treturn result;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (!foregroundReported) {\n\t\t\t\t\t\tforegroundReported = true;\n\t\t\t\t\t\tawait hooks.afterForeground?.(foregroundOutcome(controller.signal, error));\n\t\t\t\t\t}\n\t\t\t\t\tthrow error;\n\t\t\t\t}\n\t\t\t}\n\t\t);\n\t\tchildrenReported = true;\n\t\tawait hooks.afterChildren?.({ status: 'fulfilled', value });\n\t\treturn value;\n\t} catch (error) {\n\t\tif (!foregroundReported) {\n\t\t\tforegroundReported = true;\n\t\t\tawait hooks.afterForeground?.(foregroundOutcome(controller.signal, error));\n\t\t}\n\t\tif (!childrenReported) {\n\t\t\tchildrenReported = true;\n\t\t\tawait hooks.afterChildren?.(structuralOutcome(controller.signal, error));\n\t\t}\n\t\tthrow error;\n\t}\n}\n\n/* Classifies foreground failure using the frame's cancellation authority. /\nfunction foregroundOutcome(signal: AbortSignal, error: unknown): TaskForegroundOutcome {\n\treturn signal.aborted \|\| error instanceof TaskCancellation\n\t\t? { status: 'cancelled', reason: cancellationReason(signal, error) }\n\t\t: { status: 'rejected', error };\n}\n\n/* Classifies structural failure using the frame's cancellation authority. /\nfunction structuralOutcome<T>(signal: AbortSignal, error: unknown): TaskFrameOutcome<T> {\n\treturn error instanceof TaskCancellation\n\t\t? { status: 'cancelled', reason: cancellationReason(signal, error) }\n\t\t: { status: 'rejected', error };\n}\n\n/* Preserves the originating abort reason after runtime cancellation wrapping. /\nfunction cancellationReason(signal: AbortSignal, error: unknown): unknown {\n\tif (error instanceof TaskCancellation) return error.reason;\n\treturn signal.aborted ? signal.reason : error;\n}\n\n/* Reserves an attached child before handing work to an external scheduler. /\nexport function reserveTaskFrame(options: RunTaskFrameOptions): TaskFrameReservation {\n\tconst parent = (options.parent as TaskFrameRecord \| undefined) ?? currentTaskFrameRecord();\n\tif (!parent) throw new Error('A task frame reservation requires an active or explicit parent');\n\tlet used = false;\n\tlet release!: () => void;\n\tconst placeholder = new Promise<void>((resolve) => {\n\t\trelease = resolve;\n\t});\n\tattachTaskFrameSettlement(parent, placeholder);\n\treturn {\n\t\trun<T>(work: (context: TaskContext) => T \| Promise<T>): TaskFrameExecution<T> {\n\t\t\tif (used)\n\t\t\t\treturn rejectedTaskFrameExecution(new Error('Task frame reservation was already released'));\n\t\t\tused = true;\n\t\t\tconst execution = createTaskFrameExecution(\n\t\t\t\t{ ...options, parent: parent as unknown as TaskFrameToken },\n\t\t\t\t{ work },\n\t\t\t\ttrue\n\t\t\t);\n\t\t\t// Keep the atomic placeholder until the public execution, including\n\t\t\t// its structural finalizer, has settled.\n\t\t\tvoid execution.then(release, release);\n\t\t\treturn execution;\n\t\t},\n\t\tcancel() {\n\t\t\tif (used) return;\n\t\t\tused = true;\n\t\t\trelease();\n\t\t},\n\t\t[Symbol.dispose]() {\n\t\t\tif (used) return;\n\t\t\tused = true;\n\t\t\trelease();\n\t\t}\n\t};\n}\n\n/* Creates a settled execution for invalid reservation reuse. /\nfunction rejectedTaskFrameExecution<T>(error: unknown): TaskFrameExecution<T> {\n\tconst controller = new AbortController();\n\treturn exposeTaskFrameExecution(Promise.reject<T>(error), controller);\n}\n\n/* Restores a captured frame for one synchronous callback segment. */\nexport function runWithTaskFrame<T>(frame: TaskFrameToken, work: () => T): T {\n\treturn withTaskFrameRecord(frame as unknown as TaskFrameRecord, work);\n}\n\nexport {\n\tattachTaskProgressReporter,\n\ttaskProgressReceiverForHost\n} from '../tasks/progress-bindings.js';\nexport type { TaskProgressReceiver } from '../tasks/progress-receiver.js';\n"]}

package/dist/server/runtime/tasks.d.ts CHANGED Viewed

@@ -10,4 +10,5 @@ export { taskMutation } from '../tasks/frame-runtime.js';
 export { bindTaskForHost, defineTask, invokeTask } from '../tasks/runtime.js';
 export { mutateTaskCollection, ownTaskResource, stageTaskMutation, taskAnimationFrame, taskAwait, taskFetch, taskIdleCallback, taskInterval, taskObserver, taskTimeout } from '../tasks/resources.js';
 export { combineTaskSignal, withAbortSignal, withTaskSignal } from '../tasks/signals.js';
+export { createTaskProgressReporter, registerTaskProgressReceiver } from '../tasks/progress-bindings.js';
 //# sourceMappingURL=tasks.d.ts.map

package/dist/server/runtime/tasks.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/runtime/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAE9B,OAAO,EAAE,qCAAqC,EAAE,MAAM,oCAAoC,CAAC;AAC3F,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EACN,mCAAmC,EACnC,mCAAmC,EACnC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACN,uCAAuC,EACvC,mCAAmC,EACnC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACN,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}
1	+ {"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../../src/runtime/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAE9B,OAAO,EAAE,qCAAqC,EAAE,MAAM,oCAAoC,CAAC;AAC3F,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EACN,mCAAmC,EACnC,mCAAmC,EACnC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACN,uCAAuC,EACvC,mCAAmC,EACnC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACN,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEzF,OAAO,EACN,0BAA0B,EAC1B,4BAA4B,EAC5B,MAAM,+BAA+B,CAAC"}

package/dist/server/runtime/tasks.js CHANGED Viewed

@@ -10,4 +10,5 @@ export { taskMutation } from '../tasks/frame-runtime.js';
 export { bindTaskForHost, defineTask, invokeTask } from '../tasks/runtime.js';
 export { mutateTaskCollection, ownTaskResource, stageTaskMutation, taskAnimationFrame, taskAwait, taskFetch, taskIdleCallback, taskInterval, taskObserver, taskTimeout } from '../tasks/resources.js';
 export { combineTaskSignal, withAbortSignal, withTaskSignal } from '../tasks/signals.js';
+export { createTaskProgressReporter, registerTaskProgressReceiver } from '../tasks/progress-bindings.js';
 //# sourceMappingURL=tasks.js.map

package/dist/server/runtime/tasks.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../src/runtime/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAE9B,OAAO,EAAE,qCAAqC,EAAE,MAAM,oCAAoC,CAAC;AAC3F,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EACN,mCAAmC,EACnC,mCAAmC,EACnC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACN,uCAAuC,EACvC,mCAAmC,EACnC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACN,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["import './component-tasks.js';\n\nexport { registerComponentContinuationContexts } from '../component/context-resumption.js';\nexport { dispatchComponentContinuation } from '../component/domain.js';\nexport { activateTaskForHost } from '../tasks/activation.js';\nexport { activateComputationForHost } from '../tasks/computation-activation.js';\nexport {\n\tcreateIndexedContinuationDependency,\n\tcreateTrackedContinuationDependency\n} from '../tasks/dependency-source.js';\nexport {\n\tactivateCompiledClientLatestTaskForHost,\n\tbindCompiledClientLatestTaskForHost\n} from '../tasks/compiled-latest.js';\nexport { markComponentContinuationTask } from '../tasks/component-continuation.js';\nexport { taskMutation } from '../tasks/frame-runtime.js';\nexport { bindTaskForHost, defineTask, invokeTask } from '../tasks/runtime.js';\nexport {\n\tmutateTaskCollection,\n\townTaskResource,\n\tstageTaskMutation,\n\ttaskAnimationFrame,\n\ttaskAwait,\n\ttaskFetch,\n\ttaskIdleCallback,\n\ttaskInterval,\n\ttaskObserver,\n\ttaskTimeout\n} from '../tasks/resources.js';\nexport { combineTaskSignal, withAbortSignal, withTaskSignal } from '../tasks/signals.js';\n"]}
1	+ {"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../../src/runtime/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,CAAC;AAE9B,OAAO,EAAE,qCAAqC,EAAE,MAAM,oCAAoC,CAAC;AAC3F,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EACN,mCAAmC,EACnC,mCAAmC,EACnC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACN,uCAAuC,EACvC,mCAAmC,EACnC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EACN,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAEzF,OAAO,EACN,0BAA0B,EAC1B,4BAA4B,EAC5B,MAAM,+BAA+B,CAAC","sourcesContent":["import './component-tasks.js';\n\nexport { registerComponentContinuationContexts } from '../component/context-resumption.js';\nexport { dispatchComponentContinuation } from '../component/domain.js';\nexport { activateTaskForHost } from '../tasks/activation.js';\nexport { activateComputationForHost } from '../tasks/computation-activation.js';\nexport {\n\tcreateIndexedContinuationDependency,\n\tcreateTrackedContinuationDependency\n} from '../tasks/dependency-source.js';\nexport {\n\tactivateCompiledClientLatestTaskForHost,\n\tbindCompiledClientLatestTaskForHost\n} from '../tasks/compiled-latest.js';\nexport { markComponentContinuationTask } from '../tasks/component-continuation.js';\nexport { taskMutation } from '../tasks/frame-runtime.js';\nexport { bindTaskForHost, defineTask, invokeTask } from '../tasks/runtime.js';\nexport {\n\tmutateTaskCollection,\n\townTaskResource,\n\tstageTaskMutation,\n\ttaskAnimationFrame,\n\ttaskAwait,\n\ttaskFetch,\n\ttaskIdleCallback,\n\ttaskInterval,\n\ttaskObserver,\n\ttaskTimeout\n} from '../tasks/resources.js';\nexport { combineTaskSignal, withAbortSignal, withTaskSignal } from '../tasks/signals.js';\n\nexport {\n\tcreateTaskProgressReporter,\n\tregisterTaskProgressReceiver\n} from '../tasks/progress-bindings.js';\n"]}

package/dist/server/tasks/contracts.d.ts CHANGED Viewed

@@ -17,6 +17,8 @@ export interface TaskContext {
 export interface TaskContextPolicy extends TaskContext {
     client(): TaskContextPolicy;
     server(): TaskContextPolicy;
+    /** Declares a missable snapshot receiver for browser-initiated server work. */
+    progress(): TaskContextPolicy;
     parallel(): TaskContextPolicy;
     latest(): TaskContextPolicy;
     queue(): TaskContextPolicy;

package/dist/server/tasks/contracts.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/tasks/contracts.ts"],"names":[],"mappings":"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"}
1	+ {"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../src/tasks/contracts.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GACvB,gBAAgB,GAChB,UAAU,GACV,aAAa,GACb,SAAS,GACT,WAAW,CAAC;AAEf,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,UAAU,CAAC,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACnC,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACnD,GAAG,CAAC,CAAC,SAAS,UAAU,GAAG,eAAe,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;CAC5D;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACrD,MAAM,IAAI,iBAAiB,CAAC;IAC5B,MAAM,IAAI,iBAAiB,CAAC;IAC5B,+EAA+E;IAC/E,QAAQ,IAAI,iBAAiB,CAAC;IAC9B,QAAQ,IAAI,iBAAiB,CAAC;IAC9B,MAAM,IAAI,iBAAiB,CAAC;IAC5B,KAAK,IAAI,iBAAiB,CAAC;IAC3B,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,iBAAiB,CAAC;IACpC,SAAS,IAAI,iBAAiB,CAAC;IAC/B,MAAM,IAAI,iBAAiB,CAAC;IAC5B,QAAQ,IAAI,iBAAiB,CAAC;IAC9B,QAAQ,IAAI,iBAAiB,CAAC;IAC9B,WAAW,IAAI,iBAAiB,CAAC;IACjC,QAAQ,IAAI,iBAAiB,CAAC;CAC9B;AAED,2EAA2E;AAC3E,MAAM,WAAW,SAAU,SAAQ,eAAe;IACjD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;CAC7B;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU,CAAC,MAAM;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc,CAAC,MAAM,CAAE,SAAQ,WAAW,CAAC,MAAM,CAAC;IAClE,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,CAAC;IACvC,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,CAAC;IACpC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACjE,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAChD;AAED,wCAAwC;AACxC,MAAM,WAAW,YAAY,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM;IAC3D,CAAC,GAAG,IAAI,EAAE,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,2FAA2F;AAE3F,MAAM,MAAM,eAAe,CAAC,MAAM,GAAG,OAAO,IAAI,YAAY,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;AAE5E,uDAAuD;AACvD,MAAM,WAAW,iBAAiB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,CAChE,SAAQ,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,EACjC,UAAU,CAAC,MAAM,CAAC;CAAG;AAEvB,oGAAoG;AACpG,MAAM,WAAW,kBAAkB,CAAC,IAAI,SAAS,OAAO,EAAE;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACvD,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;IACrD;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,SAAS,OAAO,EAAE,CAAC;IACpE,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC;CAC3B;AAED,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,MAAM,CAAE,SAAQ,UAAU;IACvF,CAAC,GAAG,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;IACxB,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC/B"}

package/dist/server/tasks/contracts.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/tasks/contracts.ts"],"names":[],"mappings":"","sourcesContent":["/** Describes why a task generation began. /\nexport type TaskActivation =\n\t\| 'initialization'\n\t\| 'reactive'\n\t\| 'interaction'\n\t\| 'invoked'\n\t\| 'lifecycle';\n\n/* Capabilities scoped to one task frame. /\nexport interface TaskContext {\n\treadonly signal: AbortSignal;\n\treadonly generation: number;\n\treadonly activation: TaskActivation;\n\tpeek<T>(read: () => T): T;\n\toptimistic(work: () => void): void;\n\tcleanup(cleanup: () => void \| Promise<void>): void;\n\town<T extends Disposable \| AsyncDisposable>(resource: T): T;\n}\n\n/\n Declarative task policy accepted only as the default value of a final\n * {@link TaskContext} parameter in compiler-authored source.\n /\nexport interface TaskContextPolicy extends TaskContext {\n\tclient(): TaskContextPolicy;\n\tserver(): TaskContextPolicy;\n\tparallel(): TaskContextPolicy;\n\tlatest(): TaskContextPolicy;\n\tqueue(): TaskContextPolicy;\n\tkey<T>(value: T): TaskContextPolicy;\n\timmediate(): TaskContextPolicy;\n\tnormal(): TaskContextPolicy;\n\tdeferred(): TaskContextPolicy;\n\tblocking(): TaskContextPolicy;\n\tnonblocking(): TaskContextPolicy;\n\tdetached(): TaskContextPolicy;\n}\n\n/* Durable cancellation and concurrency ownership for task generations. /\nexport interface TaskOwner extends AsyncDisposable {\n\treadonly signal: AbortSignal;\n}\n\n/* Owner-bound observable state for one task definition. /\nexport interface TaskStatus<Result> {\n\treadonly pending: boolean;\n\treadonly pendingCount: number;\n\treadonly generation: number;\n\treadonly result: Result \| undefined;\n\treadonly error: unknown;\n\tcancel(reason?: unknown): void;\n}\n\n/* A thenable whose result settles only after its attached task subtree. /\nexport interface TaskInvocation<Result> extends PromiseLike<Result> {\n\tthen<TResult1 = Result, TResult2 = never>(\n\t\tonFulfilled?: ((value: Result) => TResult1 \| PromiseLike<TResult1>) \| null,\n\t\tonRejected?: ((reason: unknown) => TResult2 \| PromiseLike<TResult2>) \| null\n\t): TaskInvocation<TResult1 \| TResult2>;\n\tcatch<TResult = never>(\n\t\tonRejected?: ((reason: unknown) => TResult \| PromiseLike<TResult>) \| null\n\t): TaskInvocation<Result \| TResult>;\n\tfinally(onFinally?: (() => void) \| null): TaskInvocation<Result>;\n\treadonly [Symbol.toStringTag]: 'TaskInvocation';\n}\n\n/* Callable runtime task definition. /\nexport interface TaskFunction<Args extends unknown[], Result> {\n\t(...args: Args): TaskInvocation<Result>;\n}\n\n/* Existential task function retained where authored argument tuples are not inspected. /\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Runtime task registries preserve arbitrary authored argument tuples through callable identity.\nexport type AnyTaskFunction<Result = unknown> = TaskFunction<any[], Result>;\n\n/* Owner-bound task callable with aggregate status. /\nexport interface BoundTaskFunction<Args extends unknown[], Result>\n\textends TaskFunction<Args, Result>,\n\t\tTaskStatus<Result> {}\n\n/* Runtime policy required when an integration defines a task outside compiled component source. /\nexport interface RuntimeTaskOptions<Args extends unknown[]> {\n\treadonly label?: string;\n\treadonly placement?: 'current' \| 'client' \| 'server';\n\treadonly priority?: 'immediate' \| 'normal' \| 'deferred';\n\treadonly concurrency?: 'parallel' \| 'latest' \| 'queue';\n\treadonly concurrencyKey?: (...args: Args) => unknown;\n\t/\n\t Compiler-generated resolver for defaulted task parameters. It evaluates\n\t * omitted defaults once per generation without subscribing the task to\n\t * reactive reads performed while resolving them.\n\t /\n\treadonly captureArguments?: (args: unknown[]) => readonly unknown[];\n\treadonly readiness?: 'blocking' \| 'nonblocking';\n\treadonly detached?: boolean;\n\treadonly owner?: TaskOwner;\n}\n\n/* Reserved callback that must run or be explicitly released exactly once. */\nexport interface ReservedTaskCallback<Args extends unknown[], Result> extends Disposable {\n\t(...args: Args): Result;\n\tcancel(reason?: unknown): void;\n}\n"]}
1	+ {"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../src/tasks/contracts.ts"],"names":[],"mappings":"","sourcesContent":["/** Describes why a task generation began. /\nexport type TaskActivation =\n\t\| 'initialization'\n\t\| 'reactive'\n\t\| 'interaction'\n\t\| 'invoked'\n\t\| 'lifecycle';\n\n/* Capabilities scoped to one task frame. /\nexport interface TaskContext {\n\treadonly signal: AbortSignal;\n\treadonly generation: number;\n\treadonly activation: TaskActivation;\n\tpeek<T>(read: () => T): T;\n\toptimistic(work: () => void): void;\n\tcleanup(cleanup: () => void \| Promise<void>): void;\n\town<T extends Disposable \| AsyncDisposable>(resource: T): T;\n}\n\n/\n Declarative task policy accepted only as the default value of a final\n * {@link TaskContext} parameter in compiler-authored source.\n /\nexport interface TaskContextPolicy extends TaskContext {\n\tclient(): TaskContextPolicy;\n\tserver(): TaskContextPolicy;\n\t/* Declares a missable snapshot receiver for browser-initiated server work. /\n\tprogress(): TaskContextPolicy;\n\tparallel(): TaskContextPolicy;\n\tlatest(): TaskContextPolicy;\n\tqueue(): TaskContextPolicy;\n\tkey<T>(value: T): TaskContextPolicy;\n\timmediate(): TaskContextPolicy;\n\tnormal(): TaskContextPolicy;\n\tdeferred(): TaskContextPolicy;\n\tblocking(): TaskContextPolicy;\n\tnonblocking(): TaskContextPolicy;\n\tdetached(): TaskContextPolicy;\n}\n\n/* Durable cancellation and concurrency ownership for task generations. /\nexport interface TaskOwner extends AsyncDisposable {\n\treadonly signal: AbortSignal;\n}\n\n/* Owner-bound observable state for one task definition. /\nexport interface TaskStatus<Result> {\n\treadonly pending: boolean;\n\treadonly pendingCount: number;\n\treadonly generation: number;\n\treadonly result: Result \| undefined;\n\treadonly error: unknown;\n\tcancel(reason?: unknown): void;\n}\n\n/* A thenable whose result settles only after its attached task subtree. /\nexport interface TaskInvocation<Result> extends PromiseLike<Result> {\n\tthen<TResult1 = Result, TResult2 = never>(\n\t\tonFulfilled?: ((value: Result) => TResult1 \| PromiseLike<TResult1>) \| null,\n\t\tonRejected?: ((reason: unknown) => TResult2 \| PromiseLike<TResult2>) \| null\n\t): TaskInvocation<TResult1 \| TResult2>;\n\tcatch<TResult = never>(\n\t\tonRejected?: ((reason: unknown) => TResult \| PromiseLike<TResult>) \| null\n\t): TaskInvocation<Result \| TResult>;\n\tfinally(onFinally?: (() => void) \| null): TaskInvocation<Result>;\n\treadonly [Symbol.toStringTag]: 'TaskInvocation';\n}\n\n/* Callable runtime task definition. /\nexport interface TaskFunction<Args extends unknown[], Result> {\n\t(...args: Args): TaskInvocation<Result>;\n}\n\n/* Existential task function retained where authored argument tuples are not inspected. /\n// eslint-disable-next-line @typescript-eslint/no-explicit-any -- Runtime task registries preserve arbitrary authored argument tuples through callable identity.\nexport type AnyTaskFunction<Result = unknown> = TaskFunction<any[], Result>;\n\n/* Owner-bound task callable with aggregate status. /\nexport interface BoundTaskFunction<Args extends unknown[], Result>\n\textends TaskFunction<Args, Result>,\n\t\tTaskStatus<Result> {}\n\n/* Runtime policy required when an integration defines a task outside compiled component source. /\nexport interface RuntimeTaskOptions<Args extends unknown[]> {\n\treadonly label?: string;\n\treadonly placement?: 'current' \| 'client' \| 'server';\n\treadonly priority?: 'immediate' \| 'normal' \| 'deferred';\n\treadonly concurrency?: 'parallel' \| 'latest' \| 'queue';\n\treadonly concurrencyKey?: (...args: Args) => unknown;\n\t/\n\t Compiler-generated resolver for defaulted task parameters. It evaluates\n\t * omitted defaults once per generation without subscribing the task to\n\t * reactive reads performed while resolving them.\n\t /\n\treadonly captureArguments?: (args: unknown[]) => readonly unknown[];\n\treadonly readiness?: 'blocking' \| 'nonblocking';\n\treadonly detached?: boolean;\n\treadonly owner?: TaskOwner;\n}\n\n/* Reserved callback that must run or be explicitly released exactly once. */\nexport interface ReservedTaskCallback<Args extends unknown[], Result> extends Disposable {\n\t(...args: Args): Result;\n\tcancel(reason?: unknown): void;\n}\n"]}

package/dist/server/tasks/frame-continuation.d.ts CHANGED Viewed

@@ -4,5 +4,5 @@ export declare function registerTaskFrameSignal(signal: AbortSignal, frame: Task
 /** 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;
+export declare function resumeTaskFrameContinuation(signal: AbortSignal, resume: () => void, enter: (frame: TaskFrameRecord | undefined) => () => void): void;
 //# sourceMappingURL=frame-continuation.d.ts.map

package/dist/server/tasks/frame-continuation.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
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"}
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,GAAG,SAAS,KAAK,MAAM,IAAI,GACvD,IAAI,CAYN"}

package/dist/server/tasks/frame-continuation.js CHANGED Viewed

@@ -31,15 +31,26 @@ function runNextTaskResumption() {
         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;
-    });
+    let leave;
+    try {
+        // Cancellation may settle a frame while an earlier resumption owns the queue.
+        // Deliver the pending promise settlement without reviving that frame.
+        leave = next.enter(next.frame.settled ? undefined : next.frame);
+        next.resume();
+    }
+    finally {
+        // Promise resolution queues the authored continuation before the restoration job.
+        queueMicrotask(() => {
+            try {
+                leave?.();
+            }
+            finally {
+                if (pendingResumptions.length)
+                    queueMicrotask(runNextTaskResumption);
+                else
+                    resumptionScheduled = false;
+            }
+        });
+    }
 }
 //# sourceMappingURL=frame-continuation.js.map

package/dist/server/tasks/frame-continuation.js.map CHANGED Viewed

	@@ -1 +1 @@
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","sourcesContent":["import type { TaskFrameRecord } from './frame-contracts.js';\n\nconst framesBySignal = new WeakMap<AbortSignal, TaskFrameRecord>();\nconst pendingResumptions: Array<{\n\treadonly frame: TaskFrameRecord;\n\treadonly resume: () => void;\n\treadonly enter: (frame: TaskFrameRecord) => () => void;\n}> = [];\nlet resumptionScheduled = false;\n\n/** Associates a frame signal with the frame restored after compiler-lowered awaits. /\nexport function registerTaskFrameSignal(signal: AbortSignal, frame: TaskFrameRecord): void {\n\tframesBySignal.set(signal, frame);\n}\n\n/* Releases continuation restoration state when its frame settles. /\nexport function releaseTaskFrameSignal(signal: AbortSignal): void {\n\tframesBySignal.delete(signal);\n}\n\n/* Queues one serialized continuation resumption for the frame owning a task signal. /\nexport function resumeTaskFrameContinuation(\n\tsignal: AbortSignal,\n\tresume: () => void,\n\tenter: (frame: TaskFrameRecord) => () => void\n): void {\n\tconst frame = framesBySignal.get(signal);\n\tif (!frame \|\| frame.settled) {\n\t\tresume();\n\t\treturn;\n\t}\n\tpendingResumptions.push({ frame, resume, enter });\n\tif (resumptionScheduled) return;\n\tresumptionScheduled = true;\n\t// The promise-resolution job is already an asynchronous boundary. Enter the uncontended first\n\t// continuation there and retain the queue only for resolutions that overlap its authored job.\n\trunNextTaskResumption();\n}\n\n/* Serializes restoration so concurrent promise resolutions cannot exchange task ownership. */\nfunction runNextTaskResumption(): void {\n\tconst next = pendingResumptions.shift();\n\tif (!next) {\n\t\tresumptionScheduled = false;\n\t\treturn;\n\t}\n\~~tconst~~ leave = next.enter(next.frame);\n\tnext.resume();\n\t// Promise resolution queues the authored continuation before the ~~next~~ restoration job.\n\tqueueMicrotask(() => {\n\t\tleave();\n\t\tif (pendingResumptions.length) queueMicrotask(runNextTaskResumption);\n\t\telse resumptionScheduled = false;\n\t});\n}\n"]}
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,KAAyD;IAEzD,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,IAAI,KAA+B,CAAC;IACpC,IAAI,CAAC;QACJ,8EAA8E;QAC9E,sEAAsE;QACtE,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,EAAE,CAAC;IACf,CAAC;YAAS,CAAC;QACV,kFAAkF;QAClF,cAAc,CAAC,GAAG,EAAE;YACnB,IAAI,CAAC;gBACJ,KAAK,EAAE,EAAE,CAAC;YACX,CAAC;oBAAS,CAAC;gBACV,IAAI,kBAAkB,CAAC,MAAM;oBAAE,cAAc,CAAC,qBAAqB,CAAC,CAAC;;oBAChE,mBAAmB,GAAG,KAAK,CAAC;YAClC,CAAC;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;AACF,CAAC","sourcesContent":["import type { TaskFrameRecord } from './frame-contracts.js';\n\nconst framesBySignal = new WeakMap<AbortSignal, TaskFrameRecord>();\nconst pendingResumptions: Array<{\n\treadonly frame: TaskFrameRecord;\n\treadonly resume: () => void;\n\treadonly enter: (frame: TaskFrameRecord \| undefined) => () => void;\n}> = [];\nlet resumptionScheduled = false;\n\n/** Associates a frame signal with the frame restored after compiler-lowered awaits. /\nexport function registerTaskFrameSignal(signal: AbortSignal, frame: TaskFrameRecord): void {\n\tframesBySignal.set(signal, frame);\n}\n\n/* Releases continuation restoration state when its frame settles. /\nexport function releaseTaskFrameSignal(signal: AbortSignal): void {\n\tframesBySignal.delete(signal);\n}\n\n/* Queues one serialized continuation resumption for the frame owning a task signal. /\nexport function resumeTaskFrameContinuation(\n\tsignal: AbortSignal,\n\tresume: () => void,\n\tenter: (frame: TaskFrameRecord \| undefined) => () => void\n): void {\n\tconst frame = framesBySignal.get(signal);\n\tif (!frame \|\| frame.settled) {\n\t\tresume();\n\t\treturn;\n\t}\n\tpendingResumptions.push({ frame, resume, enter });\n\tif (resumptionScheduled) return;\n\tresumptionScheduled = true;\n\t// The promise-resolution job is already an asynchronous boundary. Enter the uncontended first\n\t// continuation there and retain the queue only for resolutions that overlap its authored job.\n\trunNextTaskResumption();\n}\n\n/* Serializes restoration so concurrent promise resolutions cannot exchange task ownership. */\nfunction runNextTaskResumption(): void {\n\tconst next = pendingResumptions.shift();\n\tif (!next) {\n\t\tresumptionScheduled = false;\n\t\treturn;\n\t}\n\tlet leave: (() => void) \| undefined;\n\ttry {\n\t\t// Cancellation may settle a frame while an earlier resumption owns the queue.\n\t\t// Deliver the pending promise settlement without reviving that frame.\n\t\tleave = next.enter(next.frame.settled ? undefined : next.frame);\n\t\tnext.resume();\n\t} finally {\n\t\t// Promise resolution queues the authored continuation before the restoration job.\n\t\tqueueMicrotask(() => {\n\t\t\ttry {\n\t\t\t\tleave?.();\n\t\t\t} finally {\n\t\t\t\tif (pendingResumptions.length) queueMicrotask(runNextTaskResumption);\n\t\t\t\telse resumptionScheduled = false;\n\t\t\t}\n\t\t});\n\t}\n}\n"]}

package/dist/server/tasks/frame-runtime.d.ts CHANGED Viewed

@@ -18,8 +18,8 @@ export declare function withDeferredTaskFrame<T>(materialize: () => TaskFrameRec
 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 a synchronous segment with the supplied frame, or clears ambient frame ownership. */
+export declare function withTaskFrameRecord<T>(frame: TaskFrameRecord | undefined, work: () => T): T;
 /**
  * Runs work in a frame, then waits for dynamically attached descendants and
  * executes cleanup in last-in-first-out order.

package/dist/server/tasks/frame-runtime.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
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"}
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,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,CAa3F;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,CAsLZ;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,CAW7E;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAgB/B,kFAAkF;AAClF,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}

package/dist/server/tasks/frame-runtime.js CHANGED Viewed

@@ -63,18 +63,22 @@ export function withTaskOwnerRecord(owner, work) {
         currentOwner = previous;
     }
 }
-/** Runs a synchronous segment with one frame as ambient context. */
+/** Runs a synchronous segment with the supplied frame, or clears ambient frame ownership. */
 export function withTaskFrameRecord(frame, work) {
-    if (frame.settled)
+    if (frame?.settled)
         throw new Error('Cannot resume a settled task frame');
     ensureScheduledWorkContextCapture();
     const previous = currentFrame;
+    const previousMaterializer = deferredFrameMaterializer;
     currentFrame = frame;
+    if (!frame)
+        deferredFrameMaterializer = undefined;
     try {
         return work();
     }
     finally {
         currentFrame = previous;
+        deferredFrameMaterializer = previousMaterializer;
     }
 }
 /**
@@ -88,8 +92,10 @@ export function executeTaskFrame(options, work) {
         (!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'));
+    if (owner.disposed) {
+        options.controller?.abort('task-owner-disposed');
+        return Promise.reject(new TaskCancellation(options.controller?.signal.reason ?? 'task-owner-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.
@@ -288,12 +294,14 @@ export function taskMutation(signal, 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;
+        const previousMaterializer = deferredFrameMaterializer;
         currentFrame = frame;
+        if (!frame)
+            deferredFrameMaterializer = undefined;
         return () => {
             currentFrame = previous;
+            deferredFrameMaterializer = previousMaterializer;
         };
     });
 }

package/dist/server/tasks/frame-runtime.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"frame-runtime.js","sourceRoot":"","sources":["../../../src/tasks/frame-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tsetScheduledWorkContextCapture,\n\ttype ScheduledWorkContext\n} from '@exactjs/reactive/framework/runtime';\nimport type { TaskContext, TaskOwner } from './contracts.js';\nimport { raceTaskCancellation, TaskCancellation } from './cancellation.js';\nimport {\n\tregisterTaskFrameSignal,\n\treleaseTaskFrameSignal,\n\tresumeTaskFrameContinuation\n} from './frame-continuation.js';\nimport { createTaskFrameContext, frameForTaskContext } from './frame-context.js';\nimport {\n\tpublishTaskFrameEvent,\n\ttaskFrameInspectionAttached\n} from './frame-inspection-capability.js';\nimport {\n\tregisterTaskFrameSettlement,\n\trunTaskFrameCleanups,\n\tsettleTaskFrameChildren\n} from './frame-settlement.js';\nimport { createLazyTaskOwnerRecord } from './owner-record.js';\nimport { acquireScheduledReactionBatch } from './scheduled-reactions.js';\n\nimport {\n\ttaskFrameTokenBrand,\n\ttaskOwnerBrand,\n\ttype InternalTaskFrameOptions,\n\ttype TaskFrameCleanup,\n\ttype TaskFrameRecord,\n\ttype TaskOwnerRecord\n} from './frame-contracts.js';\nexport type {\n\tInternalTaskFrameOptions,\n\tTaskActivationRegistration,\n\tTaskFrameRecord,\n\tTaskOwnerRecord\n} from './frame-contracts.js';\nlet nextFrameId = 1;\nlet currentFrame: TaskFrameRecord \| undefined;\nlet currentOwner: TaskOwnerRecord \| undefined;\nlet deferredFrameMaterializer: (() => TaskFrameRecord) \| undefined;\nlet scheduledWorkCaptureInstalled = false;\nconst synchronousFrameErrors = new WeakMap<Promise<unknown>, { readonly error: unknown }>();\n\n/** Creates a durable task owner and its cancellation lifetime. /\nexport function createTaskOwnerRecord(label?: string): TaskOwnerRecord {\n\treturn createLazyTaskOwnerRecord(label);\n}\n\n/* Retains setup-owned cleanup until its durable task owner is disposed. /\nexport function registerTaskOwnerCleanup(owner: TaskOwnerRecord, cleanup: TaskFrameCleanup): void {\n\tif (owner.disposed) throw new Error('Task owner has been disposed');\n\towner.ownerCleanups.add(cleanup);\n}\n\n/* Validates and returns the internal representation of a public owner. /\nexport function taskOwnerRecord(owner: TaskOwner): TaskOwnerRecord {\n\tif (!(taskOwnerBrand in owner)) throw new TypeError('Task owner was not created by eXact');\n\treturn owner as TaskOwnerRecord;\n}\n\n/* Returns the frame active for the current synchronous execution segment. /\nexport function currentTaskFrameRecord(): TaskFrameRecord \| undefined {\n\treturn currentFrame;\n}\n\n/* Materializes an interaction frame only when synchronous work requests structural ownership. /\nexport function materializeDeferredTaskFrame(): TaskFrameRecord \| undefined {\n\treturn deferredFrameMaterializer?.();\n}\n\n/* Installs the lazy structural parent available to task and navigation operations during work. /\nexport function withDeferredTaskFrame<T>(materialize: () => TaskFrameRecord, work: () => T): T {\n\tconst previous = deferredFrameMaterializer;\n\tdeferredFrameMaterializer = materialize;\n\ttry {\n\t\treturn work();\n\t} finally {\n\t\tdeferredFrameMaterializer = previous;\n\t}\n}\n\n/* Returns the durable owner supplied by the current framework host. /\nexport function currentTaskOwnerRecord(): TaskOwnerRecord \| undefined {\n\treturn currentFrame?.owner ?? currentOwner;\n}\n\n/* Establishes a durable host owner during component state-machine construction or adapter setup. /\nexport function withTaskOwnerRecord<T>(owner: TaskOwnerRecord, work: () => T): T {\n\tconst previous = currentOwner;\n\tcurrentOwner = owner;\n\ttry {\n\t\treturn work();\n\t} finally {\n\t\tcurrentOwner = previous;\n\t}\n}\n\n/* Runs a synchronous segment with one frame as ambient context. /\nexport function withTaskFrameRecord<T>(frame: TaskFrameRecord, work: () => T): T {\n\tif (frame.settled) throw new Error('Cannot resume a settled task frame');\n\tensureScheduledWorkContextCapture();\n\tconst previous = currentFrame;\n\tcurrentFrame = frame;\n\ttry {\n\t\treturn work();\n\t} finally {\n\t\tcurrentFrame = previous;\n\t}\n}\n\n/\n Runs work in a frame, then waits for dynamically attached descendants and\n * executes cleanup in last-in-first-out order.\n /\nexport function executeTaskFrame<T>(\n\toptions: InternalTaskFrameOptions,\n\twork: (context: TaskContext) => T \| PromiseLike<T>\n): Promise<T> {\n\tconst structuralParent = options.detached ? undefined : (options.parent ?? currentFrame);\n\tif (\n\t\tstructuralParent &&\n\t\t!options.parentReserved &&\n\t\t(!structuralParent.producerOpen \|\| structuralParent.settled)\n\t)\n\t\treturn Promise.reject(\n\t\t\tnew Error('Cannot attach work after the parent task producer has closed')\n\t\t);\n\tconst owner =\n\t\toptions.owner ?? structuralParent?.owner ?? createTaskOwnerRecord('implicit task invocation');\n\tif (owner.disposed) return Promise.reject(new Error('Task owner has been disposed'));\n\tconst controller = options.controller ?? new AbortController();\n\t// The owner cancels its active frame controllers directly during disposal. Subscribing every\n\t// frame to its durable signal would retain settled controllers until the owner itself is released.\n\tif (structuralParent) linkAbort(structuralParent.controller.signal, controller);\n\n\tlet resolveSettlement!: () => void;\n\tlet rejectSettlement!: (error: unknown) => void;\n\tconst settlement = new Promise<void>((resolve, reject) => {\n\t\tresolveSettlement = resolve;\n\t\trejectSettlement = reject;\n\t});\n\tconst frame: TaskFrameRecord = {\n\t\t[taskFrameTokenBrand]: true as const,\n\t\tid: nextFrameId++,\n\t\towner,\n\t\tparent: structuralParent,\n\t\tcontroller,\n\t\t...(options.label === undefined ? {} : { label: options.label }),\n\t\t...(options.sourceEntityId === undefined ? {} : { sourceEntityId: options.sourceEntityId }),\n\t\tactivation: options.activation ?? 'invoked',\n\t\tgeneration: options.generation ?? 1,\n\t\tplacement: options.placement ?? 'current',\n\t\tconcurrency: options.concurrency ?? 'parallel',\n\t\tpriority: options.priority ?? structuralParent?.priority ?? 'normal',\n\t\treadiness:\n\t\t\toptions.readiness ??\n\t\t\t(options.priority === 'deferred'\n\t\t\t\t? 'nonblocking'\n\t\t\t\t: (structuralParent?.readiness ?? 'blocking')),\n\t\tkind: options.kind ?? 'task',\n\t\tproducerOpen: true,\n\t\tsettled: false,\n\t\tstartedAt: monotonicTimestamp()\n\t};\n\tif (options.publicContext !== false)\n\t\t(frame as { context: TaskContext }).context = createTaskFrameContext(frame, options);\n\tregisterTaskFrameSignal(controller.signal, frame);\n\tregisterTaskFrameSettlement(frame, settlement);\n\towner.frames.add(frame);\n\tconst inspectedAtStart = taskFrameInspectionAttached(frame);\n\tif (inspectedAtStart) {\n\t\tpublishTaskFrameEvent(frame, 'task.frame.enter');\n\t\tpublishTaskFrameEvent(frame, 'task.start', undefined, {\n\t\t\tkind: 'start',\n\t\t\targuments: options.inspectionArguments\n\t\t});\n\t} else uninspectedSynchronousFrames.add(frame);\n\tif (structuralParent) {\n\t\t(structuralParent.children ??= new Set()).add(settlement);\n\t\tvoid settlement\n\t\t\t.finally(() => structuralParent.children?.delete(settlement))\n\t\t\t.catch(() => undefined);\n\t} else {\n\t\t// Root settlement is observed through executeTaskFrame's returned\n\t\t// promise; the internal structural signal has no parent consumer.\n\t\tvoid settlement.catch(() => undefined);\n\t}\n\n\tlet directResult: T \| PromiseLike<T>;\n\tlet synchronousError: unknown;\n\ttry {\n\t\tif (controller.signal.aborted) throw new TaskCancellation(controller.signal.reason);\n\t\tdirectResult = withTaskFrameRecord(frame, () => work(frame.context!));\n\t} catch (error) {\n\t\tsynchronousError = error;\n\t\tdirectResult = Promise.reject(error);\n\t} finally {\n\t\tuninspectedSynchronousFrames.delete(frame);\n\t}\n\tconst execution = raceTaskCancellation(controller.signal, directResult);\n\n\tconst result = execution.then(\n\t\tasync (value) => {\n\t\t\tframe.producerOpen = false;\n\t\t\tpublishTaskFrameEvent(frame, 'task.foreground-settle');\n\t\t\tlet structuralError: unknown;\n\t\t\tlet structuralFailed = false;\n\t\t\ttry {\n\t\t\t\tawait settleTaskFrameChildren(frame);\n\t\t\t} catch (error) {\n\t\t\t\tstructuralError = error;\n\t\t\t\tstructuralFailed = true;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tawait runTaskFrameCleanups(frame);\n\t\t\t} catch (cleanupError) {\n\t\t\t\tif (!structuralFailed) throw cleanupError;\n\t\t\t\tif (structuralError && typeof structuralError === 'object')\n\t\t\t\t\tObject.defineProperty(structuralError, 'suppressed', {\n\t\t\t\t\t\tconfigurable: true,\n\t\t\t\t\t\tvalue: [cleanupError]\n\t\t\t\t\t});\n\t\t\t}\n\t\t\tif (controller.signal.aborted) throw new TaskCancellation(controller.signal.reason);\n\t\t\tif (structuralFailed) throw structuralError;\n\t\t\treturn value;\n\t\t},\n\t\tasync (error) => {\n\t\t\tconst outcomeError =\n\t\t\t\tcontroller.signal.aborted && !(error instanceof TaskCancellation)\n\t\t\t\t\t? new TaskCancellation(controller.signal.reason)\n\t\t\t\t\t: error;\n\t\t\tframe.producerOpen = false;\n\t\t\tpublishTaskFrameEvent(frame, 'task.foreground-settle');\n\t\t\tcontroller.abort(error);\n\t\t\tlet childError: unknown;\n\t\t\tlet childFailed = false;\n\t\t\ttry {\n\t\t\t\tawait settleTaskFrameChildren(frame);\n\t\t\t} catch (error) {\n\t\t\t\tchildError = error;\n\t\t\t\tchildFailed = true;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tawait runTaskFrameCleanups(frame);\n\t\t\t} catch (cleanupError) {\n\t\t\t\tif (outcomeError && typeof outcomeError === 'object')\n\t\t\t\t\tObject.defineProperty(outcomeError, 'suppressed', {\n\t\t\t\t\t\tconfigurable: true,\n\t\t\t\t\t\tvalue: [cleanupError]\n\t\t\t\t\t});\n\t\t\t}\n\t\t\tif (outcomeError === undefined && childFailed) throw childError;\n\t\t\tthrow outcomeError;\n\t\t}\n\t);\n\tconst output = result.then(\n\t\t(value) => {\n\t\t\tframe.settled = true;\n\t\t\treleaseTaskFrameSignal(controller.signal);\n\t\t\towner.frames.delete(frame);\n\t\t\tresolveSettlement();\n\t\t\tpublishTaskFrameEvent(frame, 'task.frame.exit');\n\t\t\tpublishTaskFrameEvent(frame, 'task.structural-settle');\n\t\t\tpublishTaskFrameEvent(frame, 'task.settle', undefined, {\n\t\t\t\tkind: 'outcome',\n\t\t\t\tstatus: 'settled',\n\t\t\t\tvalue\n\t\t\t});\n\t\t\treturn value;\n\t\t},\n\t\t(error) => {\n\t\t\tframe.settled = true;\n\t\t\treleaseTaskFrameSignal(controller.signal);\n\t\t\towner.frames.delete(frame);\n\t\t\tif (options.propagateFailure?.() === false) resolveSettlement();\n\t\t\telse rejectSettlement(error);\n\t\t\tpublishTaskFrameEvent(frame, 'task.frame.exit');\n\t\t\tconst cancelled = error instanceof TaskCancellation;\n\t\t\tpublishTaskFrameEvent(frame, cancelled ? 'task.cancel' : 'task.fail', error, {\n\t\t\t\tkind: 'outcome',\n\t\t\t\tstatus: cancelled ? 'cancelled' : 'failed',\n\t\t\t\tvalue: error\n\t\t\t});\n\t\t\tthrow error;\n\t\t}\n\t);\n\tif (synchronousError !== undefined) {\n\t\tsynchronousFrameErrors.set(output, { error: synchronousError });\n\t\t// Callers that preserve a synchronous host contract rethrow this error\n\t\t// immediately. The frame still settles asynchronously to release ownership.\n\t\tvoid output.catch(() => undefined);\n\t}\n\treturn output;\n}\n\n/* Returns an error thrown before a task frame's producer yielded to asynchronous work. /\nexport function taskFrameSynchronousError(\n\texecution: PromiseLike<unknown>\n): { readonly error: unknown } \| undefined {\n\treturn execution instanceof Promise ? synchronousFrameErrors.get(execution) : undefined;\n}\n\n/* Adds a structural contribution to a frame before its producer closes. /\nexport function attachTaskFrameSettlement(\n\tframe: TaskFrameRecord,\n\tsettlement: PromiseLike<unknown>\n): void {\n\tif (frame.settled \|\| !frame.producerOpen)\n\t\tthrow new Error('Cannot attach work after the task frame producer has closed');\n\tconst normalized = Promise.resolve(settlement).then(() => undefined);\n\t(frame.children ??= new Set()).add(normalized);\n\tvoid normalized.finally(() => frame.children?.delete(normalized)).catch(() => undefined);\n}\n\n/* Adds structural work to the synchronously active task frame, when present. /\nexport function joinTask(settlement: PromiseLike<unknown>): void {\n\tconst frame = currentTaskFrameRecord() ?? materializeDeferredTaskFrame();\n\tif (frame) attachTaskFrameSettlement(frame, settlement);\n}\n\n/* Publishes a task-owned mutation only while its generation remains current. /\nexport function taskMutation<Result>(signal: AbortSignal, mutation: () => Result): Result {\n\tif (signal.aborted) throw new TaskCancellation(signal.reason);\n\treturn mutation();\n}\n\n/* Restores the owning task frame around one compiler-lowered async continuation. /\nexport function resumeTaskFrame(signal: AbortSignal, resume: () => void): void {\n\tresumeTaskFrameContinuation(signal, resume, (frame) => {\n\t\tif (frame.settled) throw new Error('Cannot resume a settled task frame');\n\t\tconst previous = currentFrame;\n\t\tcurrentFrame = frame;\n\t\treturn () => {\n\t\t\tcurrentFrame = previous;\n\t\t};\n\t});\n}\n\nexport { frameForTaskContext };\nconst interactiveReactionContexts = new WeakMap<TaskFrameRecord, ScheduledWorkContext>();\nconst uninspectedSynchronousFrames = new WeakSet<TaskFrameRecord>();\n\nfunction linkAbort(signal: AbortSignal, target: AbortController): void {\n\tif (signal.aborted) {\n\t\ttarget.abort(signal.reason);\n\t\treturn;\n\t}\n\tsignal.addEventListener('abort', () => target.abort(signal.reason), { once: true });\n}\n\nfunction monotonicTimestamp(): number {\n\treturn globalThis.performance?.now() ?? Date.now();\n}\n\n/* Allocates one process-local frame identity for internal consequence frames. /\nexport function allocateTaskFrameId(): number {\n\treturn nextFrameId++;\n}\n\nfunction ensureScheduledWorkContextCapture(): void {\n\tif (scheduledWorkCaptureInstalled) return;\n\tscheduledWorkCaptureInstalled = true;\n\tsetScheduledWorkContextCapture((priority) => {\n\t\tconst parent = currentTaskFrameRecord();\n\t\tif (!parent \|\| !parent.producerOpen \|\| parent.settled) return undefined;\n\t\tif (priority === 'interactive' && uninspectedSynchronousFrames.has(parent))\n\t\t\treturn interactiveReactionContext(parent);\n\t\treturn acquireScheduledReactionBatch(parent);\n\t});\n}\n\n/* Reuses an open interaction producer for consequences drained inside the same DOM callback. */\nfunction interactiveReactionContext(parent: TaskFrameRecord): ScheduledWorkContext {\n\tlet context = interactiveReactionContexts.get(parent);\n\tif (context) return context;\n\tcontext = {\n\t\trun: (work) => withTaskFrameRecord(parent, work),\n\t\tcancel() {}\n\t};\n\tinteractiveReactionContexts.set(parent, context);\n\treturn context;\n}\n"]}
1	+ {"version":3,"file":"frame-runtime.js","sourceRoot":"","sources":["../../../src/tasks/frame-runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n\tsetScheduledWorkContextCapture,\n\ttype ScheduledWorkContext\n} from '@exactjs/reactive/framework/runtime';\nimport type { TaskContext, TaskOwner } from './contracts.js';\nimport { raceTaskCancellation, TaskCancellation } from './cancellation.js';\nimport {\n\tregisterTaskFrameSignal,\n\treleaseTaskFrameSignal,\n\tresumeTaskFrameContinuation\n} from './frame-continuation.js';\nimport { createTaskFrameContext, frameForTaskContext } from './frame-context.js';\nimport {\n\tpublishTaskFrameEvent,\n\ttaskFrameInspectionAttached\n} from './frame-inspection-capability.js';\nimport {\n\tregisterTaskFrameSettlement,\n\trunTaskFrameCleanups,\n\tsettleTaskFrameChildren\n} from './frame-settlement.js';\nimport { createLazyTaskOwnerRecord } from './owner-record.js';\nimport { acquireScheduledReactionBatch } from './scheduled-reactions.js';\n\nimport {\n\ttaskFrameTokenBrand,\n\ttaskOwnerBrand,\n\ttype InternalTaskFrameOptions,\n\ttype TaskFrameCleanup,\n\ttype TaskFrameRecord,\n\ttype TaskOwnerRecord\n} from './frame-contracts.js';\nexport type {\n\tInternalTaskFrameOptions,\n\tTaskActivationRegistration,\n\tTaskFrameRecord,\n\tTaskOwnerRecord\n} from './frame-contracts.js';\nlet nextFrameId = 1;\nlet currentFrame: TaskFrameRecord \| undefined;\nlet currentOwner: TaskOwnerRecord \| undefined;\nlet deferredFrameMaterializer: (() => TaskFrameRecord) \| undefined;\nlet scheduledWorkCaptureInstalled = false;\nconst synchronousFrameErrors = new WeakMap<Promise<unknown>, { readonly error: unknown }>();\n\n/** Creates a durable task owner and its cancellation lifetime. /\nexport function createTaskOwnerRecord(label?: string): TaskOwnerRecord {\n\treturn createLazyTaskOwnerRecord(label);\n}\n\n/* Retains setup-owned cleanup until its durable task owner is disposed. /\nexport function registerTaskOwnerCleanup(owner: TaskOwnerRecord, cleanup: TaskFrameCleanup): void {\n\tif (owner.disposed) throw new Error('Task owner has been disposed');\n\towner.ownerCleanups.add(cleanup);\n}\n\n/* Validates and returns the internal representation of a public owner. /\nexport function taskOwnerRecord(owner: TaskOwner): TaskOwnerRecord {\n\tif (!(taskOwnerBrand in owner)) throw new TypeError('Task owner was not created by eXact');\n\treturn owner as TaskOwnerRecord;\n}\n\n/* Returns the frame active for the current synchronous execution segment. /\nexport function currentTaskFrameRecord(): TaskFrameRecord \| undefined {\n\treturn currentFrame;\n}\n\n/* Materializes an interaction frame only when synchronous work requests structural ownership. /\nexport function materializeDeferredTaskFrame(): TaskFrameRecord \| undefined {\n\treturn deferredFrameMaterializer?.();\n}\n\n/* Installs the lazy structural parent available to task and navigation operations during work. /\nexport function withDeferredTaskFrame<T>(materialize: () => TaskFrameRecord, work: () => T): T {\n\tconst previous = deferredFrameMaterializer;\n\tdeferredFrameMaterializer = materialize;\n\ttry {\n\t\treturn work();\n\t} finally {\n\t\tdeferredFrameMaterializer = previous;\n\t}\n}\n\n/* Returns the durable owner supplied by the current framework host. /\nexport function currentTaskOwnerRecord(): TaskOwnerRecord \| undefined {\n\treturn currentFrame?.owner ?? currentOwner;\n}\n\n/* Establishes a durable host owner during component state-machine construction or adapter setup. /\nexport function withTaskOwnerRecord<T>(owner: TaskOwnerRecord, work: () => T): T {\n\tconst previous = currentOwner;\n\tcurrentOwner = owner;\n\ttry {\n\t\treturn work();\n\t} finally {\n\t\tcurrentOwner = previous;\n\t}\n}\n\n/* Runs a synchronous segment with the supplied frame, or clears ambient frame ownership. /\nexport function withTaskFrameRecord<T>(frame: TaskFrameRecord \| undefined, work: () => T): T {\n\tif (frame?.settled) throw new Error('Cannot resume a settled task frame');\n\tensureScheduledWorkContextCapture();\n\tconst previous = currentFrame;\n\tconst previousMaterializer = deferredFrameMaterializer;\n\tcurrentFrame = frame;\n\tif (!frame) deferredFrameMaterializer = undefined;\n\ttry {\n\t\treturn work();\n\t} finally {\n\t\tcurrentFrame = previous;\n\t\tdeferredFrameMaterializer = previousMaterializer;\n\t}\n}\n\n/\n Runs work in a frame, then waits for dynamically attached descendants and\n * executes cleanup in last-in-first-out order.\n /\nexport function executeTaskFrame<T>(\n\toptions: InternalTaskFrameOptions,\n\twork: (context: TaskContext) => T \| PromiseLike<T>\n): Promise<T> {\n\tconst structuralParent = options.detached ? undefined : (options.parent ?? currentFrame);\n\tif (\n\t\tstructuralParent &&\n\t\t!options.parentReserved &&\n\t\t(!structuralParent.producerOpen \|\| structuralParent.settled)\n\t)\n\t\treturn Promise.reject(\n\t\t\tnew Error('Cannot attach work after the parent task producer has closed')\n\t\t);\n\tconst owner =\n\t\toptions.owner ?? structuralParent?.owner ?? createTaskOwnerRecord('implicit task invocation');\n\tif (owner.disposed) {\n\t\toptions.controller?.abort('task-owner-disposed');\n\t\treturn Promise.reject(\n\t\t\tnew TaskCancellation(options.controller?.signal.reason ?? 'task-owner-disposed')\n\t\t);\n\t}\n\tconst controller = options.controller ?? new AbortController();\n\t// The owner cancels its active frame controllers directly during disposal. Subscribing every\n\t// frame to its durable signal would retain settled controllers until the owner itself is released.\n\tif (structuralParent) linkAbort(structuralParent.controller.signal, controller);\n\n\tlet resolveSettlement!: () => void;\n\tlet rejectSettlement!: (error: unknown) => void;\n\tconst settlement = new Promise<void>((resolve, reject) => {\n\t\tresolveSettlement = resolve;\n\t\trejectSettlement = reject;\n\t});\n\tconst frame: TaskFrameRecord = {\n\t\t[taskFrameTokenBrand]: true as const,\n\t\tid: nextFrameId++,\n\t\towner,\n\t\tparent: structuralParent,\n\t\tcontroller,\n\t\t...(options.label === undefined ? {} : { label: options.label }),\n\t\t...(options.sourceEntityId === undefined ? {} : { sourceEntityId: options.sourceEntityId }),\n\t\tactivation: options.activation ?? 'invoked',\n\t\tgeneration: options.generation ?? 1,\n\t\tplacement: options.placement ?? 'current',\n\t\tconcurrency: options.concurrency ?? 'parallel',\n\t\tpriority: options.priority ?? structuralParent?.priority ?? 'normal',\n\t\treadiness:\n\t\t\toptions.readiness ??\n\t\t\t(options.priority === 'deferred'\n\t\t\t\t? 'nonblocking'\n\t\t\t\t: (structuralParent?.readiness ?? 'blocking')),\n\t\tkind: options.kind ?? 'task',\n\t\tproducerOpen: true,\n\t\tsettled: false,\n\t\tstartedAt: monotonicTimestamp()\n\t};\n\tif (options.publicContext !== false)\n\t\t(frame as { context: TaskContext }).context = createTaskFrameContext(frame, options);\n\tregisterTaskFrameSignal(controller.signal, frame);\n\tregisterTaskFrameSettlement(frame, settlement);\n\towner.frames.add(frame);\n\tconst inspectedAtStart = taskFrameInspectionAttached(frame);\n\tif (inspectedAtStart) {\n\t\tpublishTaskFrameEvent(frame, 'task.frame.enter');\n\t\tpublishTaskFrameEvent(frame, 'task.start', undefined, {\n\t\t\tkind: 'start',\n\t\t\targuments: options.inspectionArguments\n\t\t});\n\t} else uninspectedSynchronousFrames.add(frame);\n\tif (structuralParent) {\n\t\t(structuralParent.children ??= new Set()).add(settlement);\n\t\tvoid settlement\n\t\t\t.finally(() => structuralParent.children?.delete(settlement))\n\t\t\t.catch(() => undefined);\n\t} else {\n\t\t// Root settlement is observed through executeTaskFrame's returned\n\t\t// promise; the internal structural signal has no parent consumer.\n\t\tvoid settlement.catch(() => undefined);\n\t}\n\n\tlet directResult: T \| PromiseLike<T>;\n\tlet synchronousError: unknown;\n\ttry {\n\t\tif (controller.signal.aborted) throw new TaskCancellation(controller.signal.reason);\n\t\tdirectResult = withTaskFrameRecord(frame, () => work(frame.context!));\n\t} catch (error) {\n\t\tsynchronousError = error;\n\t\tdirectResult = Promise.reject(error);\n\t} finally {\n\t\tuninspectedSynchronousFrames.delete(frame);\n\t}\n\tconst execution = raceTaskCancellation(controller.signal, directResult);\n\n\tconst result = execution.then(\n\t\tasync (value) => {\n\t\t\tframe.producerOpen = false;\n\t\t\tpublishTaskFrameEvent(frame, 'task.foreground-settle');\n\t\t\tlet structuralError: unknown;\n\t\t\tlet structuralFailed = false;\n\t\t\ttry {\n\t\t\t\tawait settleTaskFrameChildren(frame);\n\t\t\t} catch (error) {\n\t\t\t\tstructuralError = error;\n\t\t\t\tstructuralFailed = true;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tawait runTaskFrameCleanups(frame);\n\t\t\t} catch (cleanupError) {\n\t\t\t\tif (!structuralFailed) throw cleanupError;\n\t\t\t\tif (structuralError && typeof structuralError === 'object')\n\t\t\t\t\tObject.defineProperty(structuralError, 'suppressed', {\n\t\t\t\t\t\tconfigurable: true,\n\t\t\t\t\t\tvalue: [cleanupError]\n\t\t\t\t\t});\n\t\t\t}\n\t\t\tif (controller.signal.aborted) throw new TaskCancellation(controller.signal.reason);\n\t\t\tif (structuralFailed) throw structuralError;\n\t\t\treturn value;\n\t\t},\n\t\tasync (error) => {\n\t\t\tconst outcomeError =\n\t\t\t\tcontroller.signal.aborted && !(error instanceof TaskCancellation)\n\t\t\t\t\t? new TaskCancellation(controller.signal.reason)\n\t\t\t\t\t: error;\n\t\t\tframe.producerOpen = false;\n\t\t\tpublishTaskFrameEvent(frame, 'task.foreground-settle');\n\t\t\tcontroller.abort(error);\n\t\t\tlet childError: unknown;\n\t\t\tlet childFailed = false;\n\t\t\ttry {\n\t\t\t\tawait settleTaskFrameChildren(frame);\n\t\t\t} catch (error) {\n\t\t\t\tchildError = error;\n\t\t\t\tchildFailed = true;\n\t\t\t}\n\t\t\ttry {\n\t\t\t\tawait runTaskFrameCleanups(frame);\n\t\t\t} catch (cleanupError) {\n\t\t\t\tif (outcomeError && typeof outcomeError === 'object')\n\t\t\t\t\tObject.defineProperty(outcomeError, 'suppressed', {\n\t\t\t\t\t\tconfigurable: true,\n\t\t\t\t\t\tvalue: [cleanupError]\n\t\t\t\t\t});\n\t\t\t}\n\t\t\tif (outcomeError === undefined && childFailed) throw childError;\n\t\t\tthrow outcomeError;\n\t\t}\n\t);\n\tconst output = result.then(\n\t\t(value) => {\n\t\t\tframe.settled = true;\n\t\t\treleaseTaskFrameSignal(controller.signal);\n\t\t\towner.frames.delete(frame);\n\t\t\tresolveSettlement();\n\t\t\tpublishTaskFrameEvent(frame, 'task.frame.exit');\n\t\t\tpublishTaskFrameEvent(frame, 'task.structural-settle');\n\t\t\tpublishTaskFrameEvent(frame, 'task.settle', undefined, {\n\t\t\t\tkind: 'outcome',\n\t\t\t\tstatus: 'settled',\n\t\t\t\tvalue\n\t\t\t});\n\t\t\treturn value;\n\t\t},\n\t\t(error) => {\n\t\t\tframe.settled = true;\n\t\t\treleaseTaskFrameSignal(controller.signal);\n\t\t\towner.frames.delete(frame);\n\t\t\tif (options.propagateFailure?.() === false) resolveSettlement();\n\t\t\telse rejectSettlement(error);\n\t\t\tpublishTaskFrameEvent(frame, 'task.frame.exit');\n\t\t\tconst cancelled = error instanceof TaskCancellation;\n\t\t\tpublishTaskFrameEvent(frame, cancelled ? 'task.cancel' : 'task.fail', error, {\n\t\t\t\tkind: 'outcome',\n\t\t\t\tstatus: cancelled ? 'cancelled' : 'failed',\n\t\t\t\tvalue: error\n\t\t\t});\n\t\t\tthrow error;\n\t\t}\n\t);\n\tif (synchronousError !== undefined) {\n\t\tsynchronousFrameErrors.set(output, { error: synchronousError });\n\t\t// Callers that preserve a synchronous host contract rethrow this error\n\t\t// immediately. The frame still settles asynchronously to release ownership.\n\t\tvoid output.catch(() => undefined);\n\t}\n\treturn output;\n}\n\n/* Returns an error thrown before a task frame's producer yielded to asynchronous work. /\nexport function taskFrameSynchronousError(\n\texecution: PromiseLike<unknown>\n): { readonly error: unknown } \| undefined {\n\treturn execution instanceof Promise ? synchronousFrameErrors.get(execution) : undefined;\n}\n\n/* Adds a structural contribution to a frame before its producer closes. /\nexport function attachTaskFrameSettlement(\n\tframe: TaskFrameRecord,\n\tsettlement: PromiseLike<unknown>\n): void {\n\tif (frame.settled \|\| !frame.producerOpen)\n\t\tthrow new Error('Cannot attach work after the task frame producer has closed');\n\tconst normalized = Promise.resolve(settlement).then(() => undefined);\n\t(frame.children ??= new Set()).add(normalized);\n\tvoid normalized.finally(() => frame.children?.delete(normalized)).catch(() => undefined);\n}\n\n/* Adds structural work to the synchronously active task frame, when present. /\nexport function joinTask(settlement: PromiseLike<unknown>): void {\n\tconst frame = currentTaskFrameRecord() ?? materializeDeferredTaskFrame();\n\tif (frame) attachTaskFrameSettlement(frame, settlement);\n}\n\n/* Publishes a task-owned mutation only while its generation remains current. /\nexport function taskMutation<Result>(signal: AbortSignal, mutation: () => Result): Result {\n\tif (signal.aborted) throw new TaskCancellation(signal.reason);\n\treturn mutation();\n}\n\n/* Restores the owning task frame around one compiler-lowered async continuation. /\nexport function resumeTaskFrame(signal: AbortSignal, resume: () => void): void {\n\tresumeTaskFrameContinuation(signal, resume, (frame) => {\n\t\tconst previous = currentFrame;\n\t\tconst previousMaterializer = deferredFrameMaterializer;\n\t\tcurrentFrame = frame;\n\t\tif (!frame) deferredFrameMaterializer = undefined;\n\t\treturn () => {\n\t\t\tcurrentFrame = previous;\n\t\t\tdeferredFrameMaterializer = previousMaterializer;\n\t\t};\n\t});\n}\n\nexport { frameForTaskContext };\nconst interactiveReactionContexts = new WeakMap<TaskFrameRecord, ScheduledWorkContext>();\nconst uninspectedSynchronousFrames = new WeakSet<TaskFrameRecord>();\n\nfunction linkAbort(signal: AbortSignal, target: AbortController): void {\n\tif (signal.aborted) {\n\t\ttarget.abort(signal.reason);\n\t\treturn;\n\t}\n\tsignal.addEventListener('abort', () => target.abort(signal.reason), { once: true });\n}\n\nfunction monotonicTimestamp(): number {\n\treturn globalThis.performance?.now() ?? Date.now();\n}\n\n/* Allocates one process-local frame identity for internal consequence frames. /\nexport function allocateTaskFrameId(): number {\n\treturn nextFrameId++;\n}\n\nfunction ensureScheduledWorkContextCapture(): void {\n\tif (scheduledWorkCaptureInstalled) return;\n\tscheduledWorkCaptureInstalled = true;\n\tsetScheduledWorkContextCapture((priority) => {\n\t\tconst parent = currentTaskFrameRecord();\n\t\tif (!parent \|\| !parent.producerOpen \|\| parent.settled) return undefined;\n\t\tif (priority === 'interactive' && uninspectedSynchronousFrames.has(parent))\n\t\t\treturn interactiveReactionContext(parent);\n\t\treturn acquireScheduledReactionBatch(parent);\n\t});\n}\n\n/* Reuses an open interaction producer for consequences drained inside the same DOM callback. */\nfunction interactiveReactionContext(parent: TaskFrameRecord): ScheduledWorkContext {\n\tlet context = interactiveReactionContexts.get(parent);\n\tif (context) return context;\n\tcontext = {\n\t\trun: (work) => withTaskFrameRecord(parent, work),\n\t\tcancel() {}\n\t};\n\tinteractiveReactionContexts.set(parent, context);\n\treturn context;\n}\n"]}

package/dist/server/tasks/progress-bindings.d.ts ADDED Viewed

@@ -0,0 +1,20 @@
+import type { RuntimeTaskOptions, TaskContext } from './contracts.js';
+import type { AnyComponentInstance } from '../component/contracts.js';
+import { type TaskProgressReceiver } from './progress-receiver.js';
+/** Compiler-owned receiver work. Only validated snapshot arguments reach this boundary. */
+export type TaskProgressWork = (snapshot: unknown, task: TaskContext) => void | Promise<void>;
+type ProgressReceiverOptions = Pick<RuntimeTaskOptions<[unknown]>, 'label' | 'priority' | 'readiness'>;
+/** Registers one compiled receiver against its durable component, without activating it. */
+export declare function registerTaskProgressReceiver<Snapshot>(host: object, id: string, work: (snapshot: Snapshot, task: TaskContext) => void | Promise<void>, options: ProgressReceiverOptions): (snapshot: Snapshot) => void;
+/** Binds a server frame to its trusted, invocation-local progress transport. */
+export declare function attachTaskProgressReporter(task: TaskContext, report: (id: string, snapshot: unknown) => void): void;
+/**
+ * Captures explicit server progress authority while an executor establishes its lexical tasks.
+ * SSR has no transport and therefore creates a no-op. Retained callbacks stop at cancellation
+ * or settlement even if application code invokes them after the originating frame has closed.
+ */
+export declare function createTaskProgressReporter(id: string, task?: TaskContext): (snapshot: unknown) => void;
+/** Creates an isolated receiver lane for a validated operation and live component instance. */
+export declare function taskProgressReceiverForHost(host: AnyComponentInstance, id: string, signal: AbortSignal): TaskProgressReceiver<unknown>;
+export {};
+//# sourceMappingURL=progress-bindings.d.ts.map

package/dist/server/tasks/progress-bindings.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"progress-bindings.d.ts","sourceRoot":"","sources":["../../../src/tasks/progress-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAKtE,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE/F,2FAA2F;AAC3F,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9F,KAAK,uBAAuB,GAAG,IAAI,CAClC,kBAAkB,CAAC,CAAC,OAAO,CAAC,CAAC,EAC7B,OAAO,GAAG,UAAU,GAAG,WAAW,CAClC,CAAC;AAOF,4FAA4F;AAC5F,wBAAgB,4BAA4B,CAAC,QAAQ,EACpD,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACrE,OAAO,EAAE,uBAAuB,GAC9B,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAQ9B;AAED,gFAAgF;AAChF,wBAAgB,0BAA0B,CACzC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,GAC7C,IAAI,CAEN;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACzC,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE,WAAW,GAChB,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAO7B;AAED,+FAA+F;AAC/F,wBAAgB,2BAA2B,CAC1C,IAAI,EAAE,oBAAoB,EAC1B,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,WAAW,GACjB,oBAAoB,CAAC,OAAO,CAAC,CAgB/B"}

package/dist/server/tasks/progress-bindings.js ADDED Viewed

@@ -0,0 +1,51 @@
+import { componentLogMethod } from '../component/log.js';
+import { frameForTaskContext } from './frame-runtime.js';
+import { taskOwnerForHost } from './owner-hosts.js';
+import { createTaskProgressReceiver } from './progress-receiver.js';
+const receivers = new WeakMap();
+const reporters = new WeakMap();
+/** Registers one compiled receiver against its durable component, without activating it. */
+export function registerTaskProgressReceiver(host, id, work, options) {
+    let registry = receivers.get(host);
+    if (!registry)
+        receivers.set(host, (registry = new Map()));
+    if (registry.has(id))
+        throw new Error(`Duplicate task progress receiver ${id}`);
+    registry.set(id, { work: work, options });
+    return () => {
+        throw new Error('Progress receivers are invoked by server continuation progress');
+    };
+}
+/** Binds a server frame to its trusted, invocation-local progress transport. */
+export function attachTaskProgressReporter(task, report) {
+    reporters.set(frameForTaskContext(task), report);
+}
+/**
+ * Captures explicit server progress authority while an executor establishes its lexical tasks.
+ * SSR has no transport and therefore creates a no-op. Retained callbacks stop at cancellation
+ * or settlement even if application code invokes them after the originating frame has closed.
+ */
+export function createTaskProgressReporter(id, task) {
+    const ownedFrame = task && frameForTaskContext(task);
+    const report = ownedFrame && reporters.get(ownedFrame);
+    return (snapshot) => {
+        if (ownedFrame && !ownedFrame.settled && !ownedFrame.controller.signal.aborted)
+            report?.(id, snapshot);
+    };
+}
+/** Creates an isolated receiver lane for a validated operation and live component instance. */
+export function taskProgressReceiverForHost(host, id, signal) {
+    const owner = taskOwnerForHost(host);
+    const receiver = receivers.get(host)?.get(id);
+    if (!owner || !receiver)
+        throw new Error(`Unknown component task progress receiver ${id}`);
+    return createTaskProgressReceiver({
+        owner,
+        signal,
+        ...receiver.options,
+        label: receiver.options.label ?? id,
+        receive: receiver.work,
+        onError: (error) => componentLogMethod(host, 'error')?.(() => ['Task progress receiver failed', error, { receiver: id }])
+    });
+}
+//# sourceMappingURL=progress-bindings.js.map

package/dist/server/tasks/progress-bindings.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"progress-bindings.js","sourceRoot":"","sources":["../../../src/tasks/progress-bindings.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,0BAA0B,EAA6B,MAAM,wBAAwB,CAAC;AAS/F,MAAM,SAAS,GAAG,IAAI,OAAO,EAG1B,CAAC;AACJ,MAAM,SAAS,GAAG,IAAI,OAAO,EAA4D,CAAC;AAE1F,4FAA4F;AAC5F,MAAM,UAAU,4BAA4B,CAC3C,IAAY,EACZ,EAAU,EACV,IAAqE,EACrE,OAAgC;IAEhC,IAAI,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,QAAQ;QAAE,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;IAC3D,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,EAAE,EAAE,CAAC,CAAC;IAChF,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAwB,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9D,OAAO,GAAG,EAAE;QACX,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACnF,CAAC,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,0BAA0B,CACzC,IAAiB,EACjB,MAA+C;IAE/C,SAAS,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AAClD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACzC,EAAU,EACV,IAAkB;IAElB,MAAM,UAAU,GAAG,IAAI,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,UAAU,IAAI,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvD,OAAO,CAAC,QAAQ,EAAE,EAAE;QACnB,IAAI,UAAU,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO;YAC7E,MAAM,EAAE,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IACzB,CAAC,CAAC;AACH,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,2BAA2B,CAC1C,IAA0B,EAC1B,EAAU,EACV,MAAmB;IAEnB,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,EAAE,EAAE,CAAC,CAAC;IAC3F,OAAO,0BAA0B,CAAC;QACjC,KAAK;QACL,MAAM;QACN,GAAG,QAAQ,CAAC,OAAO;QACnB,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE;QACnC,OAAO,EAAE,QAAQ,CAAC,IAAI;QACtB,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAClB,kBAAkB,CACjB,IAAI,EACJ,OAAO,CACP,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,+BAA+B,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;KACtE,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import type { RuntimeTaskOptions, TaskContext } from './contracts.js';\nimport type { AnyComponentInstance } from '../component/contracts.js';\nimport { componentLogMethod } from '../component/log.js';\nimport { frameForTaskContext } from './frame-runtime.js';\nimport type { TaskFrameRecord } from './frame-contracts.js';\nimport { taskOwnerForHost } from './owner-hosts.js';\nimport { createTaskProgressReceiver, type TaskProgressReceiver } from './progress-receiver.js';\n\n/** Compiler-owned receiver work. Only validated snapshot arguments reach this boundary. */\nexport type TaskProgressWork = (snapshot: unknown, task: TaskContext) => void | Promise<void>;\n\ntype ProgressReceiverOptions = Pick<\n\tRuntimeTaskOptions<[unknown]>,\n\t'label' | 'priority' | 'readiness'\n>;\nconst receivers = new WeakMap<\n\tobject,\n\tMap<string, { work: TaskProgressWork; options: ProgressReceiverOptions }>\n>();\nconst reporters = new WeakMap<TaskFrameRecord, (id: string, snapshot: unknown) => void>();\n\n/** Registers one compiled receiver against its durable component, without activating it. */\nexport function registerTaskProgressReceiver<Snapshot>(\n\thost: object,\n\tid: string,\n\twork: (snapshot: Snapshot, task: TaskContext) => void | Promise<void>,\n\toptions: ProgressReceiverOptions\n): (snapshot: Snapshot) => void {\n\tlet registry = receivers.get(host);\n\tif (!registry) receivers.set(host, (registry = new Map()));\n\tif (registry.has(id)) throw new Error(`Duplicate task progress receiver ${id}`);\n\tregistry.set(id, { work: work as TaskProgressWork, options });\n\treturn () => {\n\t\tthrow new Error('Progress receivers are invoked by server continuation progress');\n\t};\n}\n\n/** Binds a server frame to its trusted, invocation-local progress transport. */\nexport function attachTaskProgressReporter(\n\ttask: TaskContext,\n\treport: (id: string, snapshot: unknown) => void\n): void {\n\treporters.set(frameForTaskContext(task), report);\n}\n\n/**\n * Captures explicit server progress authority while an executor establishes its lexical tasks.\n * SSR has no transport and therefore creates a no-op. Retained callbacks stop at cancellation\n * or settlement even if application code invokes them after the originating frame has closed.\n */\nexport function createTaskProgressReporter(\n\tid: string,\n\ttask?: TaskContext\n): (snapshot: unknown) => void {\n\tconst ownedFrame = task && frameForTaskContext(task);\n\tconst report = ownedFrame && reporters.get(ownedFrame);\n\treturn (snapshot) => {\n\t\tif (ownedFrame && !ownedFrame.settled && !ownedFrame.controller.signal.aborted)\n\t\t\treport?.(id, snapshot);\n\t};\n}\n\n/** Creates an isolated receiver lane for a validated operation and live component instance. */\nexport function taskProgressReceiverForHost(\n\thost: AnyComponentInstance,\n\tid: string,\n\tsignal: AbortSignal\n): TaskProgressReceiver<unknown> {\n\tconst owner = taskOwnerForHost(host);\n\tconst receiver = receivers.get(host)?.get(id);\n\tif (!owner || !receiver) throw new Error(`Unknown component task progress receiver ${id}`);\n\treturn createTaskProgressReceiver({\n\t\towner,\n\t\tsignal,\n\t\t...receiver.options,\n\t\tlabel: receiver.options.label ?? id,\n\t\treceive: receiver.work,\n\t\tonError: (error) =>\n\t\t\tcomponentLogMethod(\n\t\t\t\thost,\n\t\t\t\t'error'\n\t\t\t)?.(() => ['Task progress receiver failed', error, { receiver: id }])\n\t});\n}\n"]}

package/dist/server/tasks/progress-receiver.d.ts ADDED Viewed

@@ -0,0 +1,24 @@
+import type { TaskContext, TaskOwner } from './contracts.js';
+/** One replaceable observation lane, owned by an originating invocation. */
+export interface TaskProgressReceiver<Snapshot> {
+    /** Offers a captured snapshot, replacing any snapshot which has not started. */
+    report(snapshot: Snapshot): void;
+    /** Fences publication immediately; asynchronous cleanup does not delay the caller. */
+    close(reason?: unknown): void;
+}
+/**
+ * Serializes asynchronous progress activations while retaining only the latest pending value.
+ * Each activation is an ordinary task with independent staged publication and structural children.
+ * It belongs to the durable component owner, but never extends the originating invocation.
+ * Callers must capture/validate snapshots before offering them and route errors to diagnostics.
+ */
+export declare function createTaskProgressReceiver<Snapshot>(options: {
+    readonly owner: TaskOwner;
+    readonly signal: AbortSignal;
+    readonly label: string;
+    readonly priority?: 'immediate' | 'normal' | 'deferred';
+    readonly readiness?: 'blocking' | 'nonblocking';
+    readonly receive: (snapshot: Snapshot, task: TaskContext) => void | Promise<void>;
+    readonly onError: (error: unknown) => void;
+}): TaskProgressReceiver<Snapshot>;
+//# sourceMappingURL=progress-receiver.d.ts.map

package/dist/server/tasks/progress-receiver.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"progress-receiver.d.ts","sourceRoot":"","sources":["../../../src/tasks/progress-receiver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAK7D,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB,CAAC,QAAQ;IAC7C,gFAAgF;IAChF,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IACjC,sFAAsF;IACtF,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,OAAO,EAAE;IAC7D,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAC;IACxD,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,aAAa,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3C,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAoEjC"}