@exactjs/core 0.5.0

package/dist/client/tasks/options.js

@@ -0,0 +1,16 @@
+/** Validates policy values supplied by explicit runtime task definitions. */
+export function validateTaskOptions(options) {
+    if (options.captureArguments !== undefined && typeof options.captureArguments !== 'function')
+        throw new TypeError('Task argument capture must be a function');
+    if (options.concurrency !== undefined &&
+        options.concurrency !== 'parallel' &&
+        options.concurrency !== 'latest' &&
+        options.concurrency !== 'queue')
+        throw new TypeError(`Unsupported task concurrency "${String(options.concurrency)}"`);
+    if (options.priority !== undefined &&
+        options.priority !== 'immediate' &&
+        options.priority !== 'normal' &&
+        options.priority !== 'deferred')
+        throw new TypeError(`Unsupported task priority "${String(options.priority)}"`);
+}
+//# sourceMappingURL=options.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../../src/tasks/options.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,MAAM,UAAU,mBAAmB,CAClC,OAAiC;IAEjC,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,gBAAgB,KAAK,UAAU;QAC3F,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IACjE,IACC,OAAO,CAAC,WAAW,KAAK,SAAS;QACjC,OAAO,CAAC,WAAW,KAAK,UAAU;QAClC,OAAO,CAAC,WAAW,KAAK,QAAQ;QAChC,OAAO,CAAC,WAAW,KAAK,OAAO;QAE/B,MAAM,IAAI,SAAS,CAAC,iCAAiC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACtF,IACC,OAAO,CAAC,QAAQ,KAAK,SAAS;QAC9B,OAAO,CAAC,QAAQ,KAAK,WAAW;QAChC,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAC7B,OAAO,CAAC,QAAQ,KAAK,UAAU;QAE/B,MAAM,IAAI,SAAS,CAAC,8BAA8B,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACjF,CAAC"}

package/dist/client/tasks/owner-activations.d.ts

@@ -0,0 +1,10 @@
+import type { AnyTaskFunction } from './contracts.js';
+import type { TaskOwnerRecord } from './frame-contracts.js';
+/** Defers compiler-owned setup activations until a framework host restores resumable state. */
+export declare function deferTaskOwnerActivations(owner: TaskOwnerRecord): void;
+/**
+ * Arms deferred setup activations after resumption, optionally suppressing the first generation
+ * when SSR already settled the compiler-owned continuation.
+ */
+export declare function releaseTaskOwnerActivations(owner: TaskOwnerRecord, skipInitial: (task: AnyTaskFunction) => boolean): void;
+//# sourceMappingURL=owner-activations.d.ts.map

package/dist/client/tasks/owner-activations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-activations.d.ts","sourceRoot":"","sources":["../../../src/tasks/owner-activations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,+FAA+F;AAC/F,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAEtE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,eAAe,EACtB,WAAW,EAAE,CAAC,IAAI,EAAE,eAAe,KAAK,OAAO,GAC7C,IAAI,CAKN"}

package/dist/client/tasks/owner-activations.js

@@ -0,0 +1,15 @@
+/** Defers compiler-owned setup activations until a framework host restores resumable state. */
+export function deferTaskOwnerActivations(owner) {
+    owner.activationsDeferred = true;
+}
+/**
+ * Arms deferred setup activations after resumption, optionally suppressing the first generation
+ * when SSR already settled the compiler-owned continuation.
+ */
+export function releaseTaskOwnerActivations(owner, skipInitial) {
+    owner.activationsDeferred = false;
+    for (const registration of owner.activationRegistrations) {
+        registration.start(skipInitial(registration.task));
+    }
+}
+//# sourceMappingURL=owner-activations.js.map

package/dist/client/tasks/owner-activations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-activations.js","sourceRoot":"","sources":["../../../src/tasks/owner-activations.ts"],"names":[],"mappings":"AAGA,+FAA+F;AAC/F,MAAM,UAAU,yBAAyB,CAAC,KAAsB;IAC/D,KAAK,CAAC,mBAAmB,GAAG,IAAI,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAC1C,KAAsB,EACtB,WAA+C;IAE/C,KAAK,CAAC,mBAAmB,GAAG,KAAK,CAAC;IAClC,KAAK,MAAM,YAAY,IAAI,KAAK,CAAC,uBAAuB,EAAE,CAAC;QAC1D,YAAY,CAAC,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;AACF,CAAC"}

package/dist/client/tasks/owner-hosts.d.ts

@@ -0,0 +1,6 @@
+import type { TaskOwnerRecord } from './frame-runtime.js';
+/** Associates a durable framework host with its task owner. */
+export declare function registerTaskOwnerHost(host: object, owner: TaskOwnerRecord): void;
+/** Returns the durable task owner registered for a framework host. */
+export declare function taskOwnerForHost(host: object): TaskOwnerRecord | undefined;
+//# sourceMappingURL=owner-hosts.d.ts.map

package/dist/client/tasks/owner-hosts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-hosts.d.ts","sourceRoot":"","sources":["../../../src/tasks/owner-hosts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D,+DAA+D;AAC/D,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAQhF;AAED,sEAAsE;AACtE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAE1E"}

package/dist/client/tasks/owner-hosts.js

@@ -0,0 +1,16 @@
+const taskOwnerHost = Symbol.for('@exactjs/task-owner-host');
+/** Associates a durable framework host with its task owner. */
+export function registerTaskOwnerHost(host, owner) {
+    Object.defineProperty(host, taskOwnerHost, {
+        value: owner,
+        configurable: true,
+        enumerable: false,
+        writable: false
+    });
+    owner.host = host;
+}
+/** Returns the durable task owner registered for a framework host. */
+export function taskOwnerForHost(host) {
+    return host[taskOwnerHost];
+}
+//# sourceMappingURL=owner-hosts.js.map

package/dist/client/tasks/owner-hosts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner-hosts.js","sourceRoot":"","sources":["../../../src/tasks/owner-hosts.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;AAE7D,+DAA+D;AAC/D,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,KAAsB;IACzE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE;QAC1C,KAAK,EAAE,KAAK;QACZ,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,KAAK;QACjB,QAAQ,EAAE,KAAK;KACf,CAAC,CAAC;IACH,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;AACnB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC5C,OAAQ,IAAuD,CAAC,aAAa,CAAC,CAAC;AAChF,CAAC"}

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

@@ -0,0 +1,4 @@
+import { type TaskOwnerRecord } from './frame-contracts.js';
+/** Creates a task owner whose cancellation and collection storage is materialized on first use. */
+export declare function createLazyTaskOwnerRecord(label?: string): TaskOwnerRecord;
+//# sourceMappingURL=owner-record.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"owner-record.d.ts","sourceRoot":"","sources":["../../../src/tasks/owner-record.ts"],"names":[],"mappings":"AAAA,OAAO,EAKN,KAAK,eAAe,EACpB,MAAM,sBAAsB,CAAC;AA+D9B,mGAAmG;AACnG,wBAAgB,yBAAyB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAEzE"}

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

@@ -0,0 +1,62 @@
+import { taskOwnerBrand } from './frame-contracts.js';
+import { waitForTaskFrameSettlement } from './frame-settlement.js';
+class TaskOwnerRecordImpl {
+    [taskOwnerBrand] = true;
+    label;
+    host;
+    observeSettlement;
+    registerReadiness;
+    activationsDeferred = false;
+    disposed = false;
+    controllerValue;
+    framesValue;
+    settlementsValue;
+    ownerCleanupsValue;
+    activationRegistrationsValue;
+    constructor(label) {
+        this.label = label;
+    }
+    get controller() {
+        if (!this.controllerValue) {
+            this.controllerValue = new AbortController();
+            if (this.disposed)
+                this.controllerValue.abort('task-owner-disposed');
+        }
+        return this.controllerValue;
+    }
+    get signal() {
+        return this.controller.signal;
+    }
+    get frames() {
+        return (this.framesValue ??= new Set());
+    }
+    get settlements() {
+        return (this.settlementsValue ??= new Set());
+    }
+    get ownerCleanups() {
+        return (this.ownerCleanupsValue ??= new Set());
+    }
+    get activationRegistrations() {
+        return (this.activationRegistrationsValue ??= new Set());
+    }
+    async [Symbol.asyncDispose]() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.controllerValue?.abort('task-owner-disposed');
+        for (const frame of this.framesValue ?? [])
+            frame.controller.abort('task-owner-disposed');
+        for (const cleanup of [...(this.ownerCleanupsValue ?? [])].reverse())
+            await cleanup();
+        this.ownerCleanupsValue?.clear();
+        await Promise.allSettled([
+            ...[...(this.framesValue ?? [])].map(waitForTaskFrameSettlement),
+            ...(this.settlementsValue ?? [])
+        ]);
+    }
+}
+/** Creates a task owner whose cancellation and collection storage is materialized on first use. */
+export function createLazyTaskOwnerRecord(label) {
+    return new TaskOwnerRecordImpl(label);
+}
+//# sourceMappingURL=owner-record.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"owner-record.js","sourceRoot":"","sources":["../../../src/tasks/owner-record.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,cAAc,EAKd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,mBAAmB;IACf,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IACxB,KAAK,CAAU;IACxB,IAAI,CAAU;IACd,iBAAiB,CAA0C;IAC3D,iBAAiB,CAAwC;IACzD,mBAAmB,GAAG,KAAK,CAAC;IAC5B,QAAQ,GAAG,KAAK,CAAC;IACT,eAAe,CAAmB;IAClC,WAAW,CAAwB;IACnC,gBAAgB,CAA6B;IAC7C,kBAAkB,CAAyB;IAC3C,4BAA4B,CAAmC;IAEvE,YAAY,KAAc;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,IAAI,UAAU;QACb,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC;YAC3B,IAAI,CAAC,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;YAC7C,IAAI,IAAI,CAAC,QAAQ;gBAAE,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CAAC;IAC7B,CAAC;IAED,IAAI,MAAM;QACT,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAC/B,CAAC;IAED,IAAI,MAAM;QACT,OAAO,CAAC,IAAI,CAAC,WAAW,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,IAAI,WAAW;QACd,OAAO,CAAC,IAAI,CAAC,gBAAgB,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,aAAa;QAChB,OAAO,CAAC,IAAI,CAAC,kBAAkB,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,uBAAuB;QAC1B,OAAO,CAAC,IAAI,CAAC,4BAA4B,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QAC1B,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACnD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE;YAAE,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAC1F,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE;YAAE,MAAM,OAAO,EAAE,CAAC;QACtF,IAAI,CAAC,kBAAkB,EAAE,KAAK,EAAE,CAAC;QACjC,MAAM,OAAO,CAAC,UAAU,CAAC;YACxB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,0BAA0B,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC;SAChC,CAAC,CAAC;IACJ,CAAC;CACD;AAED,mGAAmG;AACnG,MAAM,UAAU,yBAAyB,CAAC,KAAc;IACvD,OAAO,IAAI,mBAAmB,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { TaskOwner } from './contracts.js';
+/** Creates an explicit durable owner for cross-root task concurrency and cancellation. */
+export declare function createTaskOwner(options?: {
+    readonly label?: string;
+}): TaskOwner;
+//# sourceMappingURL=owners.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"owners.d.ts","sourceRoot":"","sources":["../../../src/tasks/owners.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAEhF"}

package/dist/client/tasks/owners.js

@@ -0,0 +1,6 @@
+import { createTaskOwnerRecord } from './frame-runtime.js';
+/** Creates an explicit durable owner for cross-root task concurrency and cancellation. */
+export function createTaskOwner(options) {
+    return createTaskOwnerRecord(options?.label);
+}
+//# sourceMappingURL=owners.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"owners.js","sourceRoot":"","sources":["../../../src/tasks/owners.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,OAAqC;IACpE,OAAO,qBAAqB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC"}

package/dist/client/tasks/performance-trace.d.ts

@@ -0,0 +1,17 @@
+import type { TaskOwnerRecord } from './frame-contracts.js';
+import type { InternalTaskGeneration } from './runtime-types.js';
+/** Trace token retained only while task-level component logging is enabled. */
+export type TaskPerformanceTrace = NonNullable<InternalTaskGeneration<unknown>['trace']>;
+/** Begins trace-only timing for one scheduled component-owned task generation. */
+export declare function startTaskPerformanceTrace<Result>(owner: TaskOwnerRecord, record: InternalTaskGeneration<Result>, sourceEntityId: string | undefined, label: string | undefined): void;
+/** Begins timing for a compact compiler-selected task generation. */
+export declare function startCompiledTaskPerformanceTrace(owner: TaskOwnerRecord, details: Readonly<{
+    activation: InternalTaskGeneration<unknown>['activation'];
+    generation: number;
+    priority: InternalTaskGeneration<unknown>['priority'];
+}>, sourceEntityId: string | undefined, label: string | undefined): TaskPerformanceTrace | undefined;
+/** Emits one correlated timing phase when tracing began for the task generation. */
+export declare function markTaskPerformanceTrace<Result>(record: InternalTaskGeneration<Result>, phase: string, attributes?: Readonly<Record<string, string | number | boolean | null>>): void;
+/** Completes one compact compiler-selected task trace without a generic generation record. */
+export declare function markCompiledTaskPerformanceTrace(trace: TaskPerformanceTrace | undefined, attributes: Readonly<Record<string, string | number | boolean | null>>): void;
+//# sourceMappingURL=performance-trace.d.ts.map

package/dist/client/tasks/performance-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-trace.d.ts","sourceRoot":"","sources":["../../../src/tasks/performance-trace.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,+EAA+E;AAC/E,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC,sBAAsB,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAEzF,kFAAkF;AAClF,wBAAgB,yBAAyB,CAAC,MAAM,EAC/C,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC,EACtC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,IAAI,CAGN;AAED,qEAAqE;AACrE,wBAAgB,iCAAiC,CAChD,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,QAAQ,CAAC;IACjB,UAAU,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC,UAAU,CAAC,CAAC;CACtD,CAAC,EACF,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,oBAAoB,GAAG,SAAS,CAElC;AA4BD,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,MAAM,EAC9C,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC,EACtC,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,GACrE,IAAI,CAIN;AAED,8FAA8F;AAC9F,wBAAgB,gCAAgC,CAC/C,KAAK,EAAE,oBAAoB,GAAG,SAAS,EACvC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,GACpE,IAAI,CAEN"}

package/dist/client/tasks/performance-trace.js

@@ -0,0 +1,52 @@
+import { componentTraceStarter, markComponentTrace } from '../component/performance-trace.js';
+import { currentInteraction } from '../interaction/execution.js';
+/** Begins trace-only timing for one scheduled component-owned task generation. */
+export function startTaskPerformanceTrace(owner, record, sourceEntityId, label) {
+    const trace = startTaskTrace(owner, record, sourceEntityId, label);
+    if (trace)
+        record.trace = trace;
+}
+/** Begins timing for a compact compiler-selected task generation. */
+export function startCompiledTaskPerformanceTrace(owner, details, sourceEntityId, label) {
+    return startTaskTrace(owner, details, sourceEntityId, label);
+}
+function startTaskTrace(owner, details, sourceEntityId, label) {
+    const traceOwner = componentTraceOwner(owner);
+    if (!traceOwner)
+        return undefined;
+    const interaction = currentInteraction();
+    const span = componentTraceStarter(traceOwner)?.('task', `task:${sourceEntityId ?? label ?? 'anonymous'}:${details.generation}`, {
+        activation: details.activation,
+        generation: details.generation,
+        priority: details.priority,
+        ...(interaction ? { interactionId: interaction.id } : {})
+    });
+    return span ? { owner: traceOwner, span } : undefined;
+}
+/** Emits one correlated timing phase when tracing began for the task generation. */
+export function markTaskPerformanceTrace(record, phase, attributes) {
+    if (!record.trace)
+        return;
+    markComponentTrace(record.trace.owner, record.trace.span, phase, attributes);
+    if (phase === 'settled')
+        delete record.trace;
+}
+/** Completes one compact compiler-selected task trace without a generic generation record. */
+export function markCompiledTaskPerformanceTrace(trace, attributes) {
+    if (trace)
+        markComponentTrace(trace.owner, trace.span, 'settled', attributes);
+}
+function componentTraceOwner(owner) {
+    const host = owner.host;
+    if (!host ||
+        typeof host !== 'object' ||
+        !('id' in host) ||
+        typeof host.id !== 'string' ||
+        !('domain' in host) ||
+        !('scope' in host) ||
+        !('unmount' in host) ||
+        typeof host.unmount !== 'function')
+        return undefined;
+    return host;
+}
+//# sourceMappingURL=performance-trace.js.map

package/dist/client/tasks/performance-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance-trace.js","sourceRoot":"","sources":["../../../src/tasks/performance-trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAE9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAOjE,kFAAkF;AAClF,MAAM,UAAU,yBAAyB,CACxC,KAAsB,EACtB,MAAsC,EACtC,cAAkC,EAClC,KAAyB;IAEzB,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;IACnE,IAAI,KAAK;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;AACjC,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,iCAAiC,CAChD,KAAsB,EACtB,OAIE,EACF,cAAkC,EAClC,KAAyB;IAEzB,OAAO,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,cAAc,CACtB,KAAsB,EACtB,OAIE,EACF,cAAkC,EAClC,KAAyB;IAEzB,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAClC,MAAM,WAAW,GAAG,kBAAkB,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,qBAAqB,CAAC,UAAU,CAAC,EAAE,CAC/C,MAAM,EACN,QAAQ,cAAc,IAAI,KAAK,IAAI,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,EACtE;QACC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CACD,CAAC;IACF,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,wBAAwB,CACvC,MAAsC,EACtC,KAAa,EACb,UAAuE;IAEvE,IAAI,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO;IAC1B,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC7E,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC;AAC9C,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,gCAAgC,CAC/C,KAAuC,EACvC,UAAsE;IAEtE,IAAI,KAAK;QAAE,kBAAkB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAsB;IAClD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,IACC,CAAC,IAAI;QACL,OAAO,IAAI,KAAK,QAAQ;QACxB,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC;QACf,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ;QAC3B,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC;QACnB,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;QAClB,CAAC,CAAC,SAAS,IAAI,IAAI,CAAC;QACpB,OAAO,IAAI,CAAC,OAAO,KAAK,UAAU;QAElC,OAAO,SAAS,CAAC;IAClB,OAAO,IAA4B,CAAC;AACrC,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { TaskContextPolicy } from './contracts.js';
+/**
+ * Compiler-recognized task policy marker.
+ *
+ * Production compilation erases calls rooted at this value. Executing a
+ * builder in uncompiled code fails with a focused diagnostic.
+ */
+export declare const TaskContext: TaskContextPolicy;
+//# sourceMappingURL=policy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../src/tasks/policy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAQxD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,iBAKJ,CAAC"}

package/dist/client/tasks/policy.js

@@ -0,0 +1,13 @@
+function uncompiledPolicy() {
+    throw new Error('TaskContext policy builders are compiler syntax and cannot execute without eXact compilation');
+}
+/**
+ * Compiler-recognized task policy marker.
+ *
+ * Production compilation erases calls rooted at this value. Executing a
+ * builder in uncompiled code fails with a focused diagnostic.
+ */
+export const TaskContext = new Proxy({}, {
+    get: () => uncompiledPolicy
+});
+//# sourceMappingURL=policy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy.js","sourceRoot":"","sources":["../../../src/tasks/policy.ts"],"names":[],"mappings":"AAEA,SAAS,gBAAgB;IACxB,MAAM,IAAI,KAAK,CACd,8FAA8F,CAC9F,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAsB,IAAI,KAAK,CACtD,EAAE,EACF;IACC,GAAG,EAAE,GAAG,EAAE,CAAC,gBAAgB;CAC3B,CACoB,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { InternalTaskGeneration } from './runtime-types.js';
+/** Raises queued task work to a more urgent inherited priority when possible. */
+export declare function donateTaskPriority<Result>(record: InternalTaskGeneration<Result>, donated: 'immediate' | 'normal' | 'deferred'): void;
+/** Maps authored task priority onto the reactive scheduler's work classes. */
+export declare function taskWorkPriority(priority: 'immediate' | 'normal' | 'deferred'): 'interactive' | 'normal' | 'deferred';
+//# sourceMappingURL=priority.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"priority.d.ts","sourceRoot":"","sources":["../../../src/tasks/priority.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,MAAM,EACxC,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC,EACtC,OAAO,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAC1C,IAAI,CAIN;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,WAAW,GAAG,QAAQ,GAAG,UAAU,GAC3C,aAAa,GAAG,QAAQ,GAAG,UAAU,CAEvC"}

package/dist/client/tasks/priority.js

@@ -0,0 +1,17 @@
+import { scheduleWork } from '@exactjs/reactive/framework/runtime';
+/** Raises queued task work to a more urgent inherited priority when possible. */
+export function donateTaskPriority(record, donated) {
+    if (record.executing || priorityRank(donated) >= priorityRank(record.priority))
+        return;
+    record.priority = donated;
+    if (record.scheduledWork)
+        scheduleWork(record.scheduledWork, taskWorkPriority(donated));
+}
+/** Maps authored task priority onto the reactive scheduler's work classes. */
+export function taskWorkPriority(priority) {
+    return priority === 'immediate' ? 'interactive' : priority;
+}
+function priorityRank(priority) {
+    return priority === 'immediate' ? 0 : priority === 'normal' ? 1 : 2;
+}
+//# sourceMappingURL=priority.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"priority.js","sourceRoot":"","sources":["../../../src/tasks/priority.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAInE,iFAAiF;AACjF,MAAM,UAAU,kBAAkB,CACjC,MAAsC,EACtC,OAA4C;IAE5C,IAAI,MAAM,CAAC,SAAS,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,OAAO;IACvF,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,IAAI,MAAM,CAAC,aAAa;QAAE,YAAY,CAAC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAC/B,QAA6C;IAE7C,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC5D,CAAC;AAED,SAAS,YAAY,CAAC,QAA6C;IAClE,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { TaskContext as TaskContextContract } from './contracts.js';
+/** Compiler-recognized task policy builder value. */
+export declare const TaskContext: import("./contracts.js").TaskContextPolicy;
+/** Capabilities scoped to one runtime task frame. */
+export type TaskContext = TaskContextContract;
+//# sourceMappingURL=public.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../src/tasks/public.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,IAAI,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAEzE,qDAAqD;AACrD,eAAO,MAAM,WAAW,4CAAoB,CAAC;AAC7C,qDAAqD;AACrD,MAAM,MAAM,WAAW,GAAG,mBAAmB,CAAC"}

package/dist/client/tasks/public.js

@@ -0,0 +1,4 @@
+import { TaskContext as taskContextPolicy } from './policy.js';
+/** Compiler-recognized task policy builder value. */
+export const TaskContext = taskContextPolicy;
+//# sourceMappingURL=public.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","sourceRoot":"","sources":["../../../src/tasks/public.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG/D,qDAAqD;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC"}

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

@@ -0,0 +1,45 @@
+import type { AnyComponentInstance, TaskCleanup, TaskIdleDeadline, TaskIdleOptions, TaskResourceDisposal } from '../component/contracts.js';
+import type { ExactCollectionMutation } from '../component-contracts.js';
+/** Associates a task generation signal with its component owner. */
+export declare function trackTaskOwner(signal: AbortSignal, owner: AnyComponentInstance): void;
+/** Stages a compiler-generated mutation until its blocking task generation commits. */
+export declare function stageTaskMutation(signal: AbortSignal, mutation: () => void): void;
+/** Publishes staged mutations for a successful task generation as one reactive batch. */
+export declare function publishTaskMutations(signal: AbortSignal): void;
+/** Discards every unpublished mutation owned by a task generation. */
+export declare function discardTaskMutations(signal: AbortSignal): void;
+/**
+ * Applies a server-task collection mutation and records the smallest ordered
+ * response delta that can reproduce the successful change in the browser.
+ */
+export declare function mutateTaskCollection(signal: AbortSignal, target: object, path: readonly PropertyKey[], kind: 'map' | 'set', method: 'set' | 'add' | 'delete' | 'clear', args: unknown[] | (() => unknown[])): unknown;
+/** Takes the ordered collection deltas produced by one successful task generation. */
+export declare function takeTaskCollectionMutations(signal: AbortSignal): readonly ExactCollectionMutation[] | undefined;
+/** Registers once-only task cleanup and reports asynchronous disposal failures. */
+export declare function registerTaskCleanup(signal: AbortSignal, cleanup: TaskCleanup): void;
+/** Waits for registered task cleanup promises and preserves failures for aggregate reporting. */
+export declare function drainTaskCleanupPromises(signal: AbortSignal | undefined): Promise<void> | undefined;
+/** Owns a disposable value while preserving the value and expression result. */
+export declare function ownTaskResource<T>(signal: AbortSignal, resource: T, disposal?: TaskResourceDisposal | ((resource: T, reason?: unknown) => void | Promise<void>)): T;
+/** Compiler helper for idle callbacks owned by one task generation. */
+export declare function taskIdleCallback(signal: AbortSignal, callback: (deadline: TaskIdleDeadline) => void, options?: TaskIdleOptions): number;
+/** Compiler helpers for resources whose lifetime is owned by a task generation. */
+export declare function taskTimeout<Args extends unknown[]>(signal: AbortSignal, handler: (...args: Args) => void, delay?: number, ...args: Args): ReturnType<typeof setTimeout>;
+/** Starts an interval whose timer is cleared automatically when the task signal aborts. */
+export declare function taskInterval<Args extends unknown[]>(signal: AbortSignal, handler: (...args: Args) => void, delay?: number, ...args: Args): ReturnType<typeof setInterval>;
+/** Requests an animation frame that is cancelled automatically with the owning task. */
+export declare function taskAnimationFrame(signal: AbortSignal, handler: (time: number) => void): number;
+/** Owns an observer instance and disconnects it when the task is cancelled. */
+export declare function taskObserver<T extends {
+    disconnect(): void;
+}>(signal: AbortSignal, observer: T): T;
+/** Runs fetch with the task signal combined with any caller-provided cancellation signal. */
+export declare function taskFetch<T>(signal: AbortSignal, fetcher: (input: unknown, init?: Record<string, unknown>) => T, input: unknown, init?: Record<string, unknown>): T;
+/**
+ * Awaits a value while retaining task cancellation and Activity parking semantics.
+ *
+ * The source promise continues while its component scope is paused. Its authored continuation
+ * remains parked until the scope resumes, and cancellation can still reject during that wait.
+ */
+export declare function taskAwait<T>(signal: AbortSignal, value: T | PromiseLike<T>): Promise<T>;
+//# sourceMappingURL=resources.d.ts.map

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

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