@exactjs/core 0.5.0

package/dist/component/task-inspection-history.js

@@ -0,0 +1,103 @@
+/** Default maximum number of completed or active task executions retained per inspection owner. */
+const defaultTaskInspectionHistoryLimit = 200;
+const taskHistories = new WeakMap();
+/**
+ * Retains only immutable, redaction-safe task projections for the current inspection session.
+ *
+ * The global bound applies across every component in the owner. Updating an existing execution
+ * does not consume another slot, and clearing the session releases every retained preview.
+ */
+export class TaskInspectionHistory {
+    #limit;
+    #records = new Map();
+    #order = [];
+    constructor(limit = defaultTaskInspectionHistoryLimit) {
+        this.#limit = normalizeLimit(limit);
+    }
+    /** Adds or replaces one execution without retaining application-owned values. */
+    record(component, snapshot) {
+        const key = taskExecutionKey(snapshot);
+        const existing = this.#records.get(key);
+        if (!existing && this.#records.size >= this.#limit) {
+            const oldestKey = this.#oldestKey();
+            const oldest = oldestKey === undefined ? undefined : this.#records.get(oldestKey);
+            if (oldest && compareTaskRecency(snapshot, oldest.snapshot) <= 0)
+                return;
+            if (oldestKey !== undefined) {
+                this.#records.delete(oldestKey);
+                this.#order.splice(this.#order.indexOf(oldestKey), 1);
+            }
+        }
+        this.#records.set(key, Object.freeze({ key, componentId: component.id, snapshot }));
+        if (!existing)
+            this.#order.push(key);
+    }
+    /** Returns newest-first executions for one live component. */
+    list(component) {
+        const snapshots = [];
+        for (let index = this.#order.length - 1; index >= 0; index--) {
+            const record = this.#records.get(this.#order[index]);
+            if (record?.componentId === component.id)
+                snapshots.push(record.snapshot);
+        }
+        return Object.freeze(snapshots);
+    }
+    /** Releases all execution previews owned by the inspection session. */
+    clear() {
+        this.#records.clear();
+        this.#order.length = 0;
+    }
+    /** Releases execution previews for an unmounted component. */
+    deleteComponent(component) {
+        for (let index = this.#order.length - 1; index >= 0; index--) {
+            const key = this.#order[index];
+            if (this.#records.get(key)?.componentId !== component.id)
+                continue;
+            this.#records.delete(key);
+            this.#order.splice(index, 1);
+        }
+    }
+    /** Selects the least-recent retained start so late settlement cannot displace newer work. */
+    #oldestKey() {
+        let oldestKey;
+        for (const key of this.#order) {
+            const candidate = this.#records.get(key)?.snapshot;
+            const oldest = oldestKey === undefined ? undefined : this.#records.get(oldestKey)?.snapshot;
+            if (candidate && (!oldest || compareTaskRecency(candidate, oldest) < 0))
+                oldestKey = key;
+        }
+        return oldestKey;
+    }
+}
+/** Associates an inspection owner with the session history controlled by its attach lifecycle. */
+export function registerTaskInspectionHistory(owner, history) {
+    taskHistories.set(owner, history);
+}
+/** Releases the task history association when its inspection session detaches. */
+export function releaseTaskInspectionHistory(owner) {
+    taskHistories.delete(owner);
+}
+/** Retains one immutable, preview-only task execution for an attached internal owner. */
+export function recordInspectedTask(owner, component, task) {
+    if (owner.attached)
+        taskHistories.get(owner)?.record(component, task);
+}
+/** Returns bounded newest-first task history without exposing the mutable history store. */
+export function inspectRetainedTaskExecutions(owner, component) {
+    return owner.attached
+        ? (taskHistories.get(owner)?.list(component) ?? Object.freeze([]))
+        : Object.freeze([]);
+}
+function taskExecutionKey(snapshot) {
+    const id = snapshot.id;
+    return `${id.sessionId}\u0000${id.side}\u0000${id.binding ?? ''}\u0000${id.buildKey}\u0000${id.executionRoot}\u0000${id.instanceId}\u0000${id.sourceEntityId ?? ''}\u0000${snapshot.generation}`;
+}
+function normalizeLimit(value) {
+    return Number.isSafeInteger(value) && value > 0
+        ? Math.min(value, 10_000)
+        : defaultTaskInspectionHistoryLimit;
+}
+function compareTaskRecency(left, right) {
+    return (left.startedAt ?? 0) - (right.startedAt ?? 0) || left.generation - right.generation;
+}
+//# sourceMappingURL=task-inspection-history.js.map

package/dist/component/task-inspection-history.js.map

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

package/dist/component/task-instance-construction.d.ts

@@ -0,0 +1,4 @@
+import type { CompiledComponentInstanceConstructor } from './instance-construction.js';
+/** Constructs the compact record selected by a task-only compiled component artifact. */
+export declare const constructTaskComponentInstance: CompiledComponentInstanceConstructor;
+//# sourceMappingURL=task-instance-construction.d.ts.map

package/dist/component/task-instance-construction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-instance-construction.d.ts","sourceRoot":"","sources":["../../src/component/task-instance-construction.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,4BAA4B,CAAC;AAGvF,yFAAyF;AACzF,eAAO,MAAM,8BAA8B,EAAE,oCAiB5C,CAAC"}

package/dist/component/task-instance-construction.js

@@ -0,0 +1,6 @@
+import { TaskComponentInstance } from './task-instance.js';
+/** Constructs the compact record selected by a task-only compiled component artifact. */
+export const constructTaskComponentInstance = function (parent, rawProps, ambientContexts, domain, execution, contract) {
+    return new TaskComponentInstance(this.instantiate, rawProps, parent, ambientContexts, domain, execution, contract);
+};
+//# sourceMappingURL=task-instance-construction.js.map

package/dist/component/task-instance-construction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-instance-construction.js","sourceRoot":"","sources":["../../src/component/task-instance-construction.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,yFAAyF;AACzF,MAAM,CAAC,MAAM,8BAA8B,GAAyC,UACnF,MAAwC,EACxC,QAAiC,EACjC,eAAmD,EACnD,MAAuB,EACvB,SAAiD,EACjD,QAA0C;IAE1C,OAAO,IAAI,qBAAqB,CAC/B,IAAI,CAAC,WAAW,EAChB,QAAQ,EACR,MAAM,EACN,eAAe,EACf,MAAM,EACN,SAAS,EACT,QAAQ,CACR,CAAC;AACH,CAAC,CAAC"}

package/dist/component/task-instance.d.ts

@@ -0,0 +1,14 @@
+import type { ExactExecutableComponentContract } from '../component-contracts.js';
+import type { PreparedComponentExecution } from '../tasks/component-execution-plan.js';
+import type { AnyComponentInstance, ComponentContextValues, ComponentFunction, ComponentInstance } from './contracts.js';
+import { CompactComponentInstance } from './compact-instance.js';
+/** Compact durable record for task-owning artifacts without lifecycle or list machinery. */
+export declare class TaskComponentInstance<State extends object, Props extends Record<string, unknown>> extends CompactComponentInstance<State, Props> {
+    private readonly taskCapability;
+    private taskState;
+    private taskReleased;
+    constructor(type: ComponentFunction<State, Props>, rawProps: Props, parent: AnyComponentInstance | undefined, ambientContexts: ComponentContextValues | undefined, domain: ComponentInstance<State>['domain'], execution: PreparedComponentExecution | undefined, contract: ExactExecutableComponentContract, instantiate?: ComponentFunction<State, Props>);
+    /** Releases task ownership in addition to the compact render scope exactly once. */
+    unmount(reason?: string): void;
+}
+//# sourceMappingURL=task-instance.d.ts.map

package/dist/component/task-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-instance.d.ts","sourceRoot":"","sources":["../../src/component/task-instance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,2BAA2B,CAAC;AAClF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,OAAO,KAAK,EACX,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,iBAAiB,EACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAQjE,4FAA4F;AAC5F,qBAAa,qBAAqB,CACjC,KAAK,SAAS,MAAM,EACpB,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACpC,SAAQ,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsC;IACrE,OAAO,CAAC,SAAS,CAA2C;IAC5D,OAAO,CAAC,YAAY,CAAS;gBAG5B,IAAI,EAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,CAAC,EACrC,QAAQ,EAAE,KAAK,EACf,MAAM,EAAE,oBAAoB,GAAG,SAAS,EACxC,eAAe,EAAE,sBAAsB,GAAG,SAAS,EACnD,MAAM,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAC1C,SAAS,EAAE,0BAA0B,GAAG,SAAS,EACjD,QAAQ,EAAE,gCAAgC,EAC1C,WAAW,GAAE,iBAAiB,CAAC,KAAK,EAAE,KAAK,CACK;IA2CjD,oFAAoF;IAC3E,OAAO,CAAC,MAAM,SAAY,GAAG,IAAI;CAiB1C"}

package/dist/component/task-instance.js

@@ -0,0 +1,61 @@
+import { cleanupFailedComponentConstruction } from './construction.js';
+import { CompactComponentInstance } from './compact-instance.js';
+import { componentTaskCapability } from './task-capability.js';
+import { compiledComponentTasksABI } from './compiled-abi.js';
+/** Compact durable record for task-owning artifacts without lifecycle or list machinery. */
+export class TaskComponentInstance extends CompactComponentInstance {
+    taskCapability;
+    taskState;
+    taskReleased = false;
+    constructor(type, rawProps, parent, ambientContexts, domain, execution, contract, instantiate = contract.artifact
+        .instantiate) {
+        super(type, rawProps, parent, ambientContexts, domain, contract);
+        const capability = this.runtimeABI & compiledComponentTasksABI ? componentTaskCapability() : undefined;
+        if (this.runtimeABI & compiledComponentTasksABI && !capability) {
+            const error = new Error('Task component construction requires the compiler-selected task capability');
+            cleanupFailedComponentConstruction(this, error);
+            throw error;
+        }
+        this.taskCapability = capability;
+        try {
+            this.taskState = capability?.create(this, type, contract, execution, rawProps, Boolean(this.componentResumption));
+            this.initializeComponent(() => {
+                return capability
+                    ? capability.run(this.taskState, () => instantiate.call(this, this.props))
+                    : instantiate.call(this, this.props);
+            });
+            if (capability && this.componentResumption)
+                capability.resume(this.taskState, new Set('componentId' in this.componentResumption
+                    ? this.componentResumption.settledContinuations
+                    : (this.componentResumption[3] ?? [])));
+            capability?.retain(this.taskState, this);
+        }
+        catch (error) {
+            cleanupFailedComponentConstruction(this, error);
+            throw error;
+        }
+    }
+    /** Releases task ownership in addition to the compact render scope exactly once. */
+    unmount(reason = 'unmount') {
+        let primary;
+        try {
+            super.unmount(reason);
+        }
+        catch (error) {
+            primary = error;
+        }
+        if (!this.taskReleased) {
+            this.taskReleased = true;
+            try {
+                this.taskCapability?.release(this.taskState, this);
+            }
+            catch (error) {
+                if (primary === undefined)
+                    primary = error;
+            }
+        }
+        if (primary !== undefined)
+            throw primary;
+    }
+}
+//# sourceMappingURL=task-instance.js.map

package/dist/component/task-instance.js.map

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

package/dist/component/task-observer.d.ts

@@ -0,0 +1,10 @@
+import type { AnyComponentInstance } from './contracts.js';
+/** Coordinates component task settlement with an owning renderer. */
+export type TaskObserver = {
+    register(promise: Promise<unknown>, instance: AnyComponentInstance): void;
+    /** Runs one root task generation under renderer-owned concurrency control. */
+    runTask?<T>(work: () => Promise<T>): Promise<T>;
+    /** Retains a constructed component for the lifetime of an owning renderer. */
+    retain?(instance: AnyComponentInstance): void;
+};
+//# sourceMappingURL=task-observer.d.ts.map

package/dist/component/task-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-observer.d.ts","sourceRoot":"","sources":["../../src/component/task-observer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,qEAAqE;AACrE,MAAM,MAAM,YAAY,GAAG;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1E,8EAA8E;IAC9E,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChD,8EAA8E;IAC9E,MAAM,CAAC,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC9C,CAAC"}

package/dist/component/task-observer.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=task-observer.js.map

package/dist/component/task-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-observer.js","sourceRoot":"","sources":["../../src/component/task-observer.ts"],"names":[],"mappings":""}

package/dist/component/task-owner-integration.d.ts

@@ -0,0 +1,7 @@
+import type { TaskOwnerRecord } from '../tasks/frame-contracts.js';
+import type { AnyComponentInstance } from './contracts.js';
+import type { TaskObserver } from './task-observer.js';
+import type { PreparedComponentExecution } from '../tasks/component-execution-plan.js';
+/** Connects a new component owner to plan execution, readiness, and renderer task observation. */
+export declare function configureComponentTaskOwner(instance: AnyComponentInstance, owner: TaskOwnerRecord, execution: PreparedComponentExecution | undefined, props: Record<string, unknown>): TaskObserver | undefined;
+//# sourceMappingURL=task-owner-integration.d.ts.map

package/dist/component/task-owner-integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-owner-integration.d.ts","sourceRoot":"","sources":["../../src/component/task-owner-integration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAEvF,kGAAkG;AAClG,wBAAgB,2BAA2B,CAC1C,QAAQ,EAAE,oBAAoB,EAC9B,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,0BAA0B,GAAG,SAAS,EACjD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,YAAY,GAAG,SAAS,CAgB1B"}

package/dist/component/task-owner-integration.js

@@ -0,0 +1,20 @@
+import { readPreparedExactExecutableComponentContract } from '../component-contracts.js';
+import { initializeComponentExecutionCapability } from '../tasks/component-execution-capability.js';
+import { taskObserverFor } from '../tasks/observers.js';
+import { registerTaskOwnerHost } from '../tasks/owner-hosts.js';
+import { componentReadinessContext } from './readiness.js';
+/** Connects a new component owner to plan execution, readiness, and renderer task observation. */
+export function configureComponentTaskOwner(instance, owner, execution, props) {
+    registerTaskOwnerHost(instance, owner);
+    initializeComponentExecutionCapability(owner, instance, execution?.plan ?? readPreparedExactExecutableComponentContract(instance.type).execution, props);
+    const readiness = componentReadinessContext(instance);
+    if (readiness)
+        owner.registerReadiness = (taskGeneration, settlement, commit, discard) => readiness.register({ owner: instance, taskGeneration, settlement, commit, discard });
+    const observer = taskObserverFor(instance);
+    if (observer)
+        owner.observeSettlement = (settlement) => observer.register(settlement, instance);
+    if (observer?.runTask)
+        owner.runTask = observer.runTask;
+    return observer;
+}
+//# sourceMappingURL=task-owner-integration.js.map

package/dist/component/task-owner-integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-owner-integration.js","sourceRoot":"","sources":["../../src/component/task-owner-integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4CAA4C,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,sCAAsC,EAAE,MAAM,4CAA4C,CAAC;AAEpG,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAI3D,kGAAkG;AAClG,MAAM,UAAU,2BAA2B,CAC1C,QAA8B,EAC9B,KAAsB,EACtB,SAAiD,EACjD,KAA8B;IAE9B,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvC,sCAAsC,CACrC,KAAK,EACL,QAAQ,EACR,SAAS,EAAE,IAAI,IAAI,4CAA4C,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EACxF,KAAK,CACL,CAAC;IACF,MAAM,SAAS,GAAG,yBAAyB,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,SAAS;QACZ,KAAK,CAAC,iBAAiB,GAAG,CAAC,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CACzE,SAAS,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACvF,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,QAAQ;QAAE,KAAK,CAAC,iBAAiB,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAChG,IAAI,QAAQ,EAAE,OAAO;QAAE,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACxD,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/component/value-contracts.d.ts

@@ -0,0 +1,19 @@
+import type { ReactiveValue } from '@exactjs/reactive/framework/runtime';
+/** Defines the task resource disposal type contract. */
+export type TaskResourceDisposal = string;
+/** Defines the task cleanup type contract. */
+export type TaskCleanup = (reason?: unknown) => void | Promise<void>;
+/** Defines the task idle deadline type contract. */
+export type TaskIdleDeadline = {
+    readonly didTimeout: boolean;
+    timeRemaining(): number;
+};
+/** Configures task idle. */
+export type TaskIdleOptions = {
+    timeout?: number;
+};
+/** Defines the component reactive value type contract. */
+export type ComponentReactiveValue<T> = ReactiveValue<T>;
+/** Defines the iterable item type contract. */
+export type IterableItem<T> = T extends Iterable<infer Item> ? Item : never;
+//# sourceMappingURL=value-contracts.d.ts.map

package/dist/component/value-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-contracts.d.ts","sourceRoot":"","sources":["../../src/component/value-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAC1C,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACrE,oDAAoD;AACpD,MAAM,MAAM,gBAAgB,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAAC,aAAa,IAAI,MAAM,CAAA;CAAE,CAAC;AACzF,4BAA4B;AAC5B,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AACnD,0DAA0D;AAC1D,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;AACzD,+CAA+C;AAC/C,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC"}

package/dist/component/value-contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=value-contracts.js.map

package/dist/component/value-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-contracts.js","sourceRoot":"","sources":["../../src/component/value-contracts.ts"],"names":[],"mappings":""}

package/dist/component-abi/activity-receipt.d.ts

@@ -0,0 +1,24 @@
+import type { Child, ComponentDomain } from '../component/contracts.js';
+declare const exactActivityReceiptBrand: unique symbol;
+/** Opaque compiler-issued operation for one retained Activity boundary. */
+export type ExactActivityReceipt = object & {
+    readonly [exactActivityReceiptBrand]: never;
+};
+/** Private retained-boundary inputs readable only by a selected target renderer. */
+export type ExactActivityReceiptData = Readonly<{
+    props: Readonly<Record<string, unknown>>;
+    children: readonly Child[];
+    domain?: ComponentDomain;
+}>;
+/** Dispatch key implemented by render targets that accept Activity operations. */
+export declare const exactActivityOperation: unique symbol;
+/** Target contract selected by an opaque Activity operation. */
+export type ExactActivityOperationTarget<Result = unknown> = Readonly<{
+    [exactActivityOperation](operation: ExactActivityReceipt, data: ExactActivityReceiptData): Result;
+}>;
+/** Issues a focused retained-boundary operation without exposing its output topology. */
+export declare function createCompiledActivityReceipt(props: Record<string, unknown> | null, ...children: unknown[]): ExactActivityReceipt;
+/** Reads only compiler-issued retained Activity operations. */
+export declare function readCompiledActivityReceipt(value: unknown): ExactActivityReceiptData | undefined;
+export {};
+//# sourceMappingURL=activity-receipt.d.ts.map

package/dist/component-abi/activity-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-receipt.d.ts","sourceRoot":"","sources":["../../src/component-abi/activity-receipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKxE,OAAO,CAAC,MAAM,yBAAyB,EAAE,OAAO,MAAM,CAAC;AAEvD,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG;IAC3C,QAAQ,CAAC,CAAC,yBAAyB,CAAC,EAAE,KAAK,CAAC;CAC5C,CAAC;AAEF,oFAAoF;AACpF,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC/C,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACzC,QAAQ,EAAE,SAAS,KAAK,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,eAAe,CAAC;CACzB,CAAC,CAAC;AAGH,kFAAkF;AAClF,eAAO,MAAM,sBAAsB,eAAmD,CAAC;AACvF,gEAAgE;AAChE,MAAM,MAAM,4BAA4B,CAAC,MAAM,GAAG,OAAO,IAAI,QAAQ,CAAC;IACrE,CAAC,sBAAsB,CAAC,CAAC,SAAS,EAAE,oBAAoB,EAAE,IAAI,EAAE,wBAAwB,GAAG,MAAM,CAAC;CAClG,CAAC,CAAC;AAWH,yFAAyF;AACzF,wBAAgB,6BAA6B,CAC5C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EACrC,GAAG,QAAQ,EAAE,OAAO,EAAE,GACpB,oBAAoB,CAWtB;AAED,+DAA+D;AAC/D,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,GAAG,SAAS,CAEhG"}

package/dist/component-abi/activity-receipt.js

@@ -0,0 +1,30 @@
+import { currentComponentDomain } from '../component/domain.js';
+import { normalizeRenderResult } from '../render-children.js';
+import { createOpaqueOperation, sharedOpaqueOperationStore } from './opaque-operation.js';
+const activityReceipts = sharedOpaqueOperationStore('activity');
+/** Dispatch key implemented by render targets that accept Activity operations. */
+export const exactActivityOperation = Symbol.for('@exactjs/target-operation/activity');
+function executeActivityOperation(target) {
+    const data = activityReceipts.get(this);
+    if (!data)
+        throw new TypeError('Activity operation lost its compiler-issued payload');
+    return target[exactActivityOperation](this, data);
+}
+/** Issues a focused retained-boundary operation without exposing its output topology. */
+export function createCompiledActivityReceipt(props, ...children) {
+    const domain = currentComponentDomain();
+    const receipt = createOpaqueOperation(executeActivityOperation, {
+        ...(domain ? { domain } : {})
+    });
+    activityReceipts.set(receipt, {
+        props: props ?? {},
+        children: normalizeRenderResult(children),
+        ...(domain ? { domain } : {})
+    });
+    return receipt;
+}
+/** Reads only compiler-issued retained Activity operations. */
+export function readCompiledActivityReceipt(value) {
+    return typeof value === 'object' && value !== null ? activityReceipts.get(value) : undefined;
+}
+//# sourceMappingURL=activity-receipt.js.map

package/dist/component-abi/activity-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity-receipt.js","sourceRoot":"","sources":["../../src/component-abi/activity-receipt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAgB1F,MAAM,gBAAgB,GAAG,0BAA0B,CAA2B,UAAU,CAAC,CAAC;AAC1F,kFAAkF;AAClF,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;AAMvF,SAAS,wBAAwB,CAAe,MAAc;IAC7D,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;IACtF,OAAQ,MAAuC,CAAC,sBAAsB,CAAC,CACtE,IAA4B,EAC5B,IAAI,CACJ,CAAC;AACH,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,6BAA6B,CAC5C,KAAqC,EACrC,GAAG,QAAmB;IAEtB,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,qBAAqB,CAAuB,wBAAwB,EAAE;QACrF,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7B,CAAC,CAAC;IACH,gBAAgB,CAAC,GAAG,CAAC,OAAO,EAAE;QAC7B,KAAK,EAAE,KAAK,IAAI,EAAE;QAClB,QAAQ,EAAE,qBAAqB,CAAC,QAAQ,CAAC;QACzC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7B,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACzD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9F,CAAC"}

package/dist/component-abi/artifact.d.ts

@@ -0,0 +1,10 @@
+import type { ExactClientComponentArtifact } from './client.js';
+import type { ExactServerComponentArtifact } from './server.js';
+export type { ExactValueSerializationSchema } from './value-serialization.js';
+/** The single current executable artifact carried by a native target-local component export. */
+export type ExactComponentExecutableArtifact = ExactClientComponentArtifact | ExactServerComponentArtifact;
+/** Narrows a current executable artifact to its client ABI without capability inference. */
+export declare function requireExactClientComponentArtifact(artifact: ExactComponentExecutableArtifact): ExactClientComponentArtifact;
+/** Narrows a current executable artifact to its server ABI without capability inference. */
+export declare function requireExactServerComponentArtifact(artifact: ExactComponentExecutableArtifact): ExactServerComponentArtifact;
+//# sourceMappingURL=artifact.d.ts.map

package/dist/component-abi/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../src/component-abi/artifact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAChE,YAAY,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAE9E,gGAAgG;AAChG,MAAM,MAAM,gCAAgC,GACzC,4BAA4B,GAC5B,4BAA4B,CAAC;AAEhC,4FAA4F;AAC5F,wBAAgB,mCAAmC,CAClD,QAAQ,EAAE,gCAAgC,GACxC,4BAA4B,CAI9B;AAED,4FAA4F;AAC5F,wBAAgB,mCAAmC,CAClD,QAAQ,EAAE,gCAAgC,GACxC,4BAA4B,CAI9B"}

package/dist/component-abi/artifact.js

@@ -0,0 +1,13 @@
+/** Narrows a current executable artifact to its client ABI without capability inference. */
+export function requireExactClientComponentArtifact(artifact) {
+    if (artifact.target !== 'client')
+        throw new TypeError('Client execution requires a current client component artifact');
+    return artifact;
+}
+/** Narrows a current executable artifact to its server ABI without capability inference. */
+export function requireExactServerComponentArtifact(artifact) {
+    if (artifact.target !== 'server')
+        throw new TypeError('Server execution requires a current server component artifact');
+    return artifact;
+}
+//# sourceMappingURL=artifact.js.map

package/dist/component-abi/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../../src/component-abi/artifact.ts"],"names":[],"mappings":"AASA,4FAA4F;AAC5F,MAAM,UAAU,mCAAmC,CAClD,QAA0C;IAE1C,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ;QAC/B,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACtF,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,mCAAmC,CAClD,QAA0C;IAE1C,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ;QAC/B,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACtF,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/dist/component-abi/child-range-receipt.d.ts

@@ -0,0 +1,33 @@
+import type { ComponentDomain, RenderResult } from '../component/contracts.js';
+declare const exactChildRangeReceiptBrand: unique symbol;
+/** Opaque compiler-owned operation for one intentionally dynamic child range. */
+export type ExactChildRangeReceipt = object & {
+    readonly [exactChildRangeReceiptBrand]: never;
+};
+/** Private focused range inputs readable only by a target renderer. */
+export type ExactChildRangeReceiptData = Readonly<{
+    value: unknown;
+    markerId?: string;
+    mayReplaceSubtree: boolean;
+    domain?: ComponentDomain;
+    /** Optional open client-component resolution state owned by this focused range. */
+    dynamicComponent?: Readonly<{
+        inspection: import('../dynamic-component/contracts.js').DynamicComponentInspection;
+        props?: Readonly<Record<string, unknown>>;
+        readiness?: () => PromiseLike<unknown> | undefined;
+    }>;
+}>;
+/** Dispatch key implemented by render targets that accept focused child ranges. */
+export declare const exactChildRangeOperation: unique symbol;
+/** Target contract selected by an opaque focused child-range operation. */
+export type ExactChildRangeOperationTarget<Result = unknown> = Readonly<{
+    [exactChildRangeOperation](operation: ExactChildRangeReceipt, data: ExactChildRangeReceiptData): Result;
+}>;
+/** Issues a focused child-range operation without exposing child topology. */
+export declare function createChildRangeReceipt(value: unknown, markerId?: string, mayReplaceSubtree?: boolean, dynamicComponent?: ExactChildRangeReceiptData['dynamicComponent']): ExactChildRangeReceipt;
+/** Reads only compiler-issued range operations. */
+export declare function readChildRangeReceipt(value: unknown): ExactChildRangeReceiptData | undefined;
+/** Recomputes the authored value owned by one focused dynamic child-range operation. */
+export type ExactChildRangeCompute = () => RenderResult;
+export {};
+//# sourceMappingURL=child-range-receipt.d.ts.map

package/dist/component-abi/child-range-receipt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-range-receipt.d.ts","sourceRoot":"","sources":["../../src/component-abi/child-range-receipt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI/E,OAAO,CAAC,MAAM,2BAA2B,EAAE,OAAO,MAAM,CAAC;AAEzD,iFAAiF;AACjF,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG;IAC7C,QAAQ,CAAC,CAAC,2BAA2B,CAAC,EAAE,KAAK,CAAC;CAC9C,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IACjD,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,QAAQ,CAAC;QAC3B,UAAU,EAAE,OAAO,mCAAmC,EAAE,0BAA0B,CAAC;QACnF,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1C,SAAS,CAAC,EAAE,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;KACnD,CAAC,CAAC;CACH,CAAC,CAAC;AAGH,mFAAmF;AACnF,eAAO,MAAM,wBAAwB,eAAsD,CAAC;AAC5F,2EAA2E;AAC3E,MAAM,MAAM,8BAA8B,CAAC,MAAM,GAAG,OAAO,IAAI,QAAQ,CAAC;IACvE,CAAC,wBAAwB,CAAC,CACzB,SAAS,EAAE,sBAAsB,EACjC,IAAI,EAAE,0BAA0B,GAC9B,MAAM,CAAC;CACV,CAAC,CAAC;AAWH,8EAA8E;AAC9E,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,OAAO,EACd,QAAQ,CAAC,EAAE,MAAM,EACjB,iBAAiB,UAAO,EACxB,gBAAgB,CAAC,EAAE,0BAA0B,CAAC,kBAAkB,CAAC,GAC/D,sBAAsB,CAaxB;AAED,mDAAmD;AACnD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,GAAG,SAAS,CAE5F;AAED,wFAAwF;AACxF,MAAM,MAAM,sBAAsB,GAAG,MAAM,YAAY,CAAC"}

package/dist/component-abi/child-range-receipt.js

@@ -0,0 +1,31 @@
+import { currentComponentDomain } from '../component/domain.js';
+import { createOpaqueOperation, sharedOpaqueOperationStore } from './opaque-operation.js';
+const ranges = sharedOpaqueOperationStore('child-range');
+/** Dispatch key implemented by render targets that accept focused child ranges. */
+export const exactChildRangeOperation = Symbol.for('@exactjs/target-operation/child-range');
+function executeChildRangeOperation(target) {
+    const data = ranges.get(this);
+    if (!data)
+        throw new TypeError('Child-range operation lost its compiler-issued payload');
+    return target[exactChildRangeOperation](this, data);
+}
+/** Issues a focused child-range operation without exposing child topology. */
+export function createChildRangeReceipt(value, markerId, mayReplaceSubtree = true, dynamicComponent) {
+    const domain = currentComponentDomain();
+    const receipt = createOpaqueOperation(executeChildRangeOperation, {
+        ...(domain ? { domain } : {})
+    });
+    ranges.set(receipt, {
+        value,
+        mayReplaceSubtree,
+        ...(markerId ? { markerId } : {}),
+        ...(domain ? { domain } : {}),
+        ...(dynamicComponent ? { dynamicComponent } : {})
+    });
+    return receipt;
+}
+/** Reads only compiler-issued range operations. */
+export function readChildRangeReceipt(value) {
+    return typeof value === 'object' && value !== null ? ranges.get(value) : undefined;
+}
+//# sourceMappingURL=child-range-receipt.js.map

package/dist/component-abi/child-range-receipt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-range-receipt.js","sourceRoot":"","sources":["../../src/component-abi/child-range-receipt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAuB1F,MAAM,MAAM,GAAG,0BAA0B,CAA6B,aAAa,CAAC,CAAC;AACrF,mFAAmF;AACnF,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;AAS5F,SAAS,0BAA0B,CAAe,MAAc;IAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,SAAS,CAAC,wDAAwD,CAAC,CAAC;IACzF,OAAQ,MAAyC,CAAC,wBAAwB,CAAC,CAC1E,IAA8B,EAC9B,IAAI,CACJ,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,uBAAuB,CACtC,KAAc,EACd,QAAiB,EACjB,iBAAiB,GAAG,IAAI,EACxB,gBAAiE;IAEjE,MAAM,MAAM,GAAG,sBAAsB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,qBAAqB,CAAyB,0BAA0B,EAAE;QACzF,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7B,CAAC,CAAC;IACH,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE;QACnB,KAAK;QACL,iBAAiB;QACjB,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjD,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,qBAAqB,CAAC,KAAc;IACnD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACpF,CAAC"}

package/dist/component-abi/client.d.ts

@@ -0,0 +1,54 @@
+import type { ExactCompiledComponentCapability, ExactCompiledComponentInputUpdateContract, ExactCompiledComponentUpdateContract } from '../component-definition-contracts.js';
+import type { AnyExactComponentCallable, ExactComponentReactiveAllocation } from './executable-fields.js';
+import type { CompiledComponentInstanceConstructor } from '../component/instance-construction.js';
+import type { Child } from '../component/contracts.js';
+import type { ExactValueSerializationSchema } from './value-serialization.js';
+/** DOM protocol key used only by compiler-produced one-shot component output attachment. */
+export declare const exactCompiledClientAttachment: unique symbol;
+/** DOM protocol key used by a foreign renderer's fixed compiled island artifact. */
+export declare const exactCompatibilityClientAttachment: unique symbol;
+/** DOM-owned attachment cursor for output already executed by a compiled client artifact. */
+export type ExactCompiledClientAttachmentTarget = Readonly<{
+    [exactCompiledClientAttachment](artifact: ExactClientComponentArtifact, instance: object, children: Child[], mode: ExactClientAttachMode): ExactClientMountedRange;
+}>;
+/** DOM-owned cursor that delegates a fixed compatibility artifact to its renderer owner. */
+export type ExactCompatibilityClientAttachmentTarget = Readonly<{
+    [exactCompatibilityClientAttachment](artifact: ExactClientComponentArtifact, instance: object, mode: ExactClientAttachMode): ExactClientMountedRange;
+}>;
+/** Selects fresh topology creation or same-build DOM adoption. */
+export type ExactClientAttachMode = 'mount' | 'hydrate';
+/** DOM-owned mounted range returned after a client artifact successfully attaches. */
+export type ExactClientMountedRange = object;
+/** Existing parent-owned values consumed directly by one allocation-free receiver receipt. */
+export type ExactClientPropSource = Readonly<Record<string, unknown>>;
+/** Complete executable ABI carried by one compiler-produced client component export. */
+export type ExactClientComponentArtifact = Readonly<{
+    version: 1;
+    target: 'client';
+    id: string;
+    template?: object;
+    construct: CompiledComponentInstanceConstructor;
+    attach: AnyExactComponentCallable;
+    receive: AnyExactComponentCallable;
+    dispose: AnyExactComponentCallable;
+    /** Setup implementation retained until generated construction subsumes authored setup in Phase 2. */
+    instantiate: AnyExactComponentCallable;
+    /** Compact compiler/runtime capability bits selecting instance storage and owned sidecars. */
+    abi: number;
+    updates?: ExactCompiledComponentUpdateContract;
+    /** Immutable receiver-owned plan for exact indexed prop-to-state relationships. */
+    inputs?: ExactCompiledComponentInputUpdateContract;
+    state: readonly string[];
+    props: readonly string[];
+    /** Finite compiler-owned shape used only for compact root-prop publication. */
+    serialization?: ExactValueSerializationSchema;
+    /** Foreign-owned prop values retained by identity without recursive reactive proxying. */
+    opaqueProps?: readonly PropertyKey[];
+    /** Opaque prop identities whose replacement requires a new component-owned range. */
+    identityProps?: readonly PropertyKey[];
+    tasks?: readonly string[];
+    reactive?: readonly ExactComponentReactiveAllocation[];
+    render?: 'returned-function';
+    capabilities: readonly ExactCompiledComponentCapability[];
+}>;
+//# sourceMappingURL=client.d.ts.map

package/dist/component-abi/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/component-abi/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,gCAAgC,EAChC,yCAAyC,EACzC,oCAAoC,EACpC,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EACX,yBAAyB,EACzB,gCAAgC,EAChC,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,oCAAoC,EAAE,MAAM,uCAAuC,CAAC;AAClG,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAE9E,4FAA4F;AAC5F,eAAO,MAAM,6BAA6B,eAEzC,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,kCAAkC,eAE9C,CAAC;AAEF,6FAA6F;AAC7F,MAAM,MAAM,mCAAmC,GAAG,QAAQ,CAAC;IAC1D,CAAC,6BAA6B,CAAC,CAC9B,QAAQ,EAAE,4BAA4B,EACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,KAAK,EAAE,EACjB,IAAI,EAAE,qBAAqB,GACzB,uBAAuB,CAAC;CAC3B,CAAC,CAAC;AAEH,4FAA4F;AAC5F,MAAM,MAAM,wCAAwC,GAAG,QAAQ,CAAC;IAC/D,CAAC,kCAAkC,CAAC,CACnC,QAAQ,EAAE,4BAA4B,EACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,qBAAqB,GACzB,uBAAuB,CAAC;CAC3B,CAAC,CAAC;AAEH,kEAAkE;AAClE,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,SAAS,CAAC;AAExD,sFAAsF;AACtF,MAAM,MAAM,uBAAuB,GAAG,MAAM,CAAC;AAE7C,8FAA8F;AAC9F,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAEtE,wFAAwF;AACxF,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC;IACnD,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,QAAQ,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,oCAAoC,CAAC;IAChD,MAAM,EAAE,yBAAyB,CAAC;IAClC,OAAO,EAAE,yBAAyB,CAAC;IACnC,OAAO,EAAE,yBAAyB,CAAC;IACnC,qGAAqG;IACrG,WAAW,EAAE,yBAAyB,CAAC;IACvC,8FAA8F;IAC9F,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,oCAAoC,CAAC;IAC/C,mFAAmF;IACnF,MAAM,CAAC,EAAE,yCAAyC,CAAC;IACnD,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,6BAA6B,CAAC;IAC9C,0FAA0F;IAC1F,WAAW,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACrC,qFAAqF;IACrF,aAAa,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,EAAE,SAAS,gCAAgC,EAAE,CAAC;IACvD,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,YAAY,EAAE,SAAS,gCAAgC,EAAE,CAAC;CAC1D,CAAC,CAAC"}

package/dist/component-abi/client.js

@@ -0,0 +1,5 @@
+/** DOM protocol key used only by compiler-produced one-shot component output attachment. */
+export const exactCompiledClientAttachment = Symbol.for('@exactjs/compiled-client-component-attachment');
+/** DOM protocol key used by a foreign renderer's fixed compiled island artifact. */
+export const exactCompatibilityClientAttachment = Symbol.for('@exactjs/compatibility-client-component-attachment');
+//# sourceMappingURL=client.js.map

package/dist/component-abi/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/component-abi/client.ts"],"names":[],"mappings":"AAaA,4FAA4F;AAC5F,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC,GAAG,CACtD,+CAA+C,CAC/C,CAAC;AAEF,oFAAoF;AACpF,MAAM,CAAC,MAAM,kCAAkC,GAAG,MAAM,CAAC,GAAG,CAC3D,oDAAoD,CACpD,CAAC"}

package/dist/component-abi/compatibility-contribution.d.ts

@@ -0,0 +1,29 @@
+/** Realm-stable operation key carried only by an opaque foreign-ownership contribution handle. */
+declare const exactCompatibilityContribution: unique symbol;
+declare const exactCompatibilityContributionKey: unique symbol;
+/** Target-owned focused placement surface called by one supplier-generated range operation. */
+export type ExactCompatibilityContributionTarget = Readonly<{
+    place(value: unknown): object;
+}>;
+/** Opaque handle retained, keyed, and cloned by a foreign owner without inspecting native shape. */
+export type ExactCompatibilityContribution = Readonly<{
+    [exactCompatibilityContribution](target: ExactCompatibilityContributionTarget): object;
+    [exactCompatibilityContributionKey]?: string;
+}>;
+/** Supplier-generated operation that places its authored contribution through focused target work. */
+export type ExactCompatibilityContributionOperation = (target: ExactCompatibilityContributionTarget) => object;
+/**
+ * Creates one opaque crossing handle around a compiler-selected child-range operation.
+ *
+ * The operation, rather than the handle or foreign owner, retains native topology and lifecycle
+ * knowledge. The handle exposes no value kind, topology, or materialization operation.
+ */
+export declare function createCompatibilityContribution(operation: ExactCompatibilityContributionOperation, key?: string): ExactCompatibilityContribution;
+/** Reads only the foreign-owner identity attached by the supplying compiled operation. */
+export declare function compatibilityContributionKey(contribution: ExactCompatibilityContribution): string | undefined;
+/** Reports only whether a value carries the opaque crossing protocol, never what it contributes. */
+export declare function isCompatibilityContribution(value: unknown): value is ExactCompatibilityContribution;
+/** Invokes a supplier-owned contribution without exposing its authored value to the foreign owner. */
+export declare function placeCompatibilityContribution(contribution: ExactCompatibilityContribution, target: ExactCompatibilityContributionTarget): object;
+export {};
+//# sourceMappingURL=compatibility-contribution.d.ts.map

package/dist/component-abi/compatibility-contribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility-contribution.d.ts","sourceRoot":"","sources":["../../src/component-abi/compatibility-contribution.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,QAAA,MAAM,8BAA8B,eAAoD,CAAC;AACzF,QAAA,MAAM,iCAAiC,eAAwD,CAAC;AAEhG,+FAA+F;AAC/F,MAAM,MAAM,oCAAoC,GAAG,QAAQ,CAAC;IAC3D,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC;CAC9B,CAAC,CAAC;AAEH,oGAAoG;AACpG,MAAM,MAAM,8BAA8B,GAAG,QAAQ,CAAC;IACrD,CAAC,8BAA8B,CAAC,CAAC,MAAM,EAAE,oCAAoC,GAAG,MAAM,CAAC;IACvF,CAAC,iCAAiC,CAAC,CAAC,EAAE,MAAM,CAAC;CAC7C,CAAC,CAAC;AAEH,sGAAsG;AACtG,MAAM,MAAM,uCAAuC,GAAG,CACrD,MAAM,EAAE,oCAAoC,KACxC,MAAM,CAAC;AAEZ;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC9C,SAAS,EAAE,uCAAuC,EAClD,GAAG,CAAC,EAAE,MAAM,GACV,8BAA8B,CAahC;AAED,0FAA0F;AAC1F,wBAAgB,4BAA4B,CAC3C,YAAY,EAAE,8BAA8B,GAC1C,MAAM,GAAG,SAAS,CAIpB;AAED,oGAAoG;AACpG,wBAAgB,2BAA2B,CAC1C,KAAK,EAAE,OAAO,GACZ,KAAK,IAAI,8BAA8B,CAOzC;AAED,sGAAsG;AACtG,wBAAgB,8BAA8B,CAC7C,YAAY,EAAE,8BAA8B,EAC5C,MAAM,EAAE,oCAAoC,GAC1C,MAAM,CAIR"}