@exactjs/core 0.5.0

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

@@ -0,0 +1,58 @@
+import type { Child, CompiledEnhancementNode, ComponentDomain } from '../component/contracts.js';
+import { type ExactExecutableComponentContract } from '../component-contracts.js';
+import type { AnyExactComponentCallable } from './executable-fields.js';
+import type { ExactNarrowComponentUpdateContract, ExactWideComponentUpdateContract } from '../component-contracts.js';
+declare const exactComponentReceiptBrand: unique symbol;
+/** Opaque compiler-owned request to invoke one already-selected target component artifact. */
+export type ExactComponentReceipt = object & {
+    readonly [exactComponentReceiptBrand]: never;
+};
+/** Private receipt contents readable only by the selected target renderer. */
+export type ExactComponentReceiptData = Readonly<{
+    contract: ExactExecutableComponentContract;
+    props: Readonly<Record<string, unknown>>;
+    children: readonly Child[];
+    key?: string;
+    domain?: ComponentDomain;
+    enhancement?: CompiledEnhancementNode;
+    update?: ExactComponentReceiptUpdate;
+    /** Renderer-injected provider whose descendants retain the authored update owner. */
+    transparentUpdateOwner?: true;
+}>;
+/** Direct target-local component reference emitted only into compiler-closed server artifacts. */
+export type ExactPreparedServerComponentReference = ExactComponentReceiptData & Readonly<Record<never, never>>;
+/** Compiler-owned parent update target carried opaquely to the selected target renderer. */
+export type ExactComponentReceiptUpdate = Readonly<{
+    target: number;
+    contract: ExactNarrowComponentUpdateContract | ExactWideComponentUpdateContract;
+}>;
+/** Dispatch key implemented by render targets that accept component operations. */
+export declare const exactComponentOperation: unique symbol;
+/** Target-owned component invocation selected by the operation rather than by caller inspection. */
+export type ExactComponentOperationTarget<Result = unknown> = Readonly<{
+    [exactComponentOperation](operation: ExactComponentReceipt, data: ExactComponentReceiptData): Result;
+}>;
+/**
+ * Publishes a direct component-ABI operation without exposing component shape.
+ * The compiler selects this operation only after resolving the target artifact at build time.
+ */
+export declare function createCompiledComponentReceipt(type: AnyExactComponentCallable, props: Record<string, unknown> | null, ...children: unknown[]): ExactComponentReceipt;
+export declare function createPreparedServerComponentReference(type: AnyExactComponentCallable, props: Record<string, unknown> | null, ...children: unknown[]): ExactPreparedServerComponentReference;
+/**
+ * Issues a reference for a compiler-proven fresh private data bag without reserved metadata.
+ * The caller must exclude own and inherited key/enhancement metadata and previous exposure.
+ * The bag is retained directly; ordinary reference construction handles all other inputs.
+ */
+export declare function createPreparedServerComponentReferenceFromPlainProps(type: AnyExactComponentCallable, props: Record<string, unknown>): ExactPreparedServerComponentReference;
+/** Reads only the direct reference representation issued by a compiler-closed server artifact. */
+export declare function readPreparedServerComponentReference(value: unknown): ExactPreparedServerComponentReference | undefined;
+/** Reads a compiler-issued receipt; arbitrary objects never become component candidates. */
+export declare function readCompiledComponentReceipt(value: unknown): ExactComponentReceiptData | undefined;
+/** Attaches one compiler-indexed parent-to-child prop receipt operation. */
+export declare function withCompiledComponentReceiptUpdate(value: ExactComponentReceipt, target: number, contract: ExactNarrowComponentUpdateContract | ExactWideComponentUpdateContract): ExactComponentReceipt;
+/** Marks a renderer-injected provider without changing its semantic component parentage. */
+export declare function withTransparentComponentUpdateOwner(value: ExactComponentReceipt): ExactComponentReceipt;
+/** Removes declaration metadata while preserving one compiler-issued component operation. */
+export declare function withoutCompiledComponentReceiptEnhancement(value: unknown): ExactComponentReceipt | undefined;
+export {};
+//# sourceMappingURL=receipt.d.ts.map

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

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

package/dist/component-abi/receipt.js

@@ -0,0 +1,134 @@
+import { unwrap } from '@exactjs/reactive/framework/values';
+import { currentComponentDomain } from '../component/domain.js';
+import { readPreparedExactExecutableComponentContract } from '../component-contracts.js';
+import { normalizeRenderResult } from '../render-children.js';
+import { createOpaqueOperation, sharedOpaqueOperationStore } from './opaque-operation.js';
+const PreparedServerComponentReference = Symbol.for('@exactjs/prepared-server-component-reference');
+const emptyServerComponentChildren = Object.freeze([]);
+const receipts = sharedOpaqueOperationStore('component');
+/** Dispatch key implemented by render targets that accept component operations. */
+export const exactComponentOperation = Symbol.for('@exactjs/target-operation/component');
+function executeComponentOperation(target) {
+    const data = receipts.get(this);
+    if (!data)
+        throw new TypeError('Component operation lost its compiler-issued payload');
+    return target[exactComponentOperation](this, data);
+}
+/**
+ * Publishes a direct component-ABI operation without exposing component shape.
+ * The compiler selects this operation only after resolving the target artifact at build time.
+ */
+export function createCompiledComponentReceipt(type, props, ...children) {
+    const { key: authoredKey, __exactEnhancements: enhancement, ...componentProps } = props ?? {};
+    const rawKey = unwrap(authoredKey);
+    const domain = currentComponentDomain();
+    const key = rawKey === null || rawKey === undefined ? undefined : String(rawKey);
+    const receipt = createOpaqueOperation(executeComponentOperation, {
+        ...(key === undefined ? {} : { key }),
+        ...(domain ? { domain } : {})
+    });
+    receipts.set(receipt, {
+        contract: readPreparedExactExecutableComponentContract(type),
+        props: componentProps,
+        children: normalizeRenderResult(children),
+        ...(key === undefined ? {} : { key }),
+        ...(domain ? { domain } : {}),
+        ...(enhancement ? { enhancement: enhancement } : {})
+    });
+    return receipt;
+}
+/**
+ * Creates one direct server component reference without an opaque operation or WeakMap payload.
+ *
+ * The compiler emits this function only into server-target artifacts. The returned object remains
+ * request-local and is consumed directly by the server renderer; it must never cross a client or
+ * compatibility boundary.
+ */
+export function createPreparedServerComponentReference(type, props, ...authoredChildren) {
+    const source = props ?? {};
+    const authoredKey = source.key;
+    const enhancement = source.__exactEnhancements;
+    const rawKey = unwrap(authoredKey);
+    const key = rawKey === null || rawKey === undefined ? undefined : String(rawKey);
+    const domain = currentComponentDomain();
+    let componentProps = source;
+    if (Object.hasOwn(source, 'key') || Object.hasOwn(source, '__exactEnhancements')) {
+        componentProps = { ...source };
+        delete componentProps.key;
+        delete componentProps.__exactEnhancements;
+    }
+    let children = emptyServerComponentChildren;
+    if (authoredChildren.length > 0)
+        children = normalizeRenderResult(authoredChildren);
+    const reference = {
+        [PreparedServerComponentReference]: true,
+        contract: readPreparedExactExecutableComponentContract(type),
+        props: componentProps,
+        children
+    };
+    if (key !== undefined)
+        reference.key = key;
+    if (domain)
+        reference.domain = domain;
+    if (enhancement)
+        reference.enhancement = enhancement;
+    return reference;
+}
+/**
+ * Issues a reference for a compiler-proven fresh private data bag without reserved metadata.
+ * The caller must exclude own and inherited key/enhancement metadata and previous exposure.
+ * The bag is retained directly; ordinary reference construction handles all other inputs.
+ */
+export function createPreparedServerComponentReferenceFromPlainProps(type, props) {
+    const domain = currentComponentDomain();
+    const reference = {
+        [PreparedServerComponentReference]: true,
+        contract: readPreparedExactExecutableComponentContract(type),
+        props,
+        children: emptyServerComponentChildren
+    };
+    if (domain)
+        reference.domain = domain;
+    return reference;
+}
+/** Reads only the direct reference representation issued by a compiler-closed server artifact. */
+export function readPreparedServerComponentReference(value) {
+    return typeof value === 'object' && value !== null && PreparedServerComponentReference in value
+        ? value
+        : undefined;
+}
+/** Reads a compiler-issued receipt; arbitrary objects never become component candidates. */
+export function readCompiledComponentReceipt(value) {
+    return typeof value === 'object' && value !== null ? receipts.get(value) : undefined;
+}
+/** Attaches one compiler-indexed parent-to-child prop receipt operation. */
+export function withCompiledComponentReceiptUpdate(value, target, contract) {
+    const data = receipts.get(value);
+    if (!data)
+        throw new TypeError('Component update metadata requires a compiled component receipt');
+    const receipt = createOpaqueOperation(executeComponentOperation, data);
+    receipts.set(receipt, { ...data, update: { target, contract } });
+    return receipt;
+}
+/** Marks a renderer-injected provider without changing its semantic component parentage. */
+export function withTransparentComponentUpdateOwner(value) {
+    const data = receipts.get(value);
+    if (!data)
+        throw new TypeError('Transparent update ownership requires a compiled component receipt');
+    const receipt = createOpaqueOperation(executeComponentOperation, data);
+    receipts.set(receipt, { ...data, transparentUpdateOwner: true });
+    return receipt;
+}
+/** Removes declaration metadata while preserving one compiler-issued component operation. */
+export function withoutCompiledComponentReceiptEnhancement(value) {
+    const data = readCompiledComponentReceipt(value);
+    if (!data)
+        return undefined;
+    if (!data.enhancement)
+        return value;
+    const receipt = createOpaqueOperation(executeComponentOperation, data);
+    const { enhancement: _enhancement, ...plain } = data;
+    receipts.set(receipt, plain);
+    return receipt;
+}
+//# sourceMappingURL=receipt.js.map

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

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

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

@@ -0,0 +1,16 @@
+import type { AnyComponentInstance } from '../component/contracts.js';
+import { type ExactClientAttachMode, type ExactClientComponentArtifact, type ExactCompatibilityClientAttachmentTarget, type ExactClientMountedRange } from './client.js';
+/** Delegates a fixed foreign-renderer island without projecting its output into native children. */
+export declare function attachExactCompatibilityClientComponent(this: ExactClientComponentArtifact, instance: object, target: ExactCompatibilityClientAttachmentTarget, mode: ExactClientAttachMode): ExactClientMountedRange;
+import { type ExactHtmlWriter, type ExactRequestExecution, type ExactServerComponentArtifact, type ExactServerFrame } from './server.js';
+/** Executes compatibility-owned output without asserting a native child representation. */
+export declare function executeExactCompatibilityComponentOutput(instance: AnyComponentInstance, onInvalidate: () => void): unknown;
+/** Releases a client component instance through its idempotent instance-owned finalizer. */
+export declare function disposeExactClientComponent(instance: AnyComponentInstance, reason: unknown): void;
+/** Establishes request ownership through the request execution protocol. */
+export declare function issueExactServerComponent(this: ExactServerComponentArtifact, request: ExactRequestExecution, parent: object | undefined, props: Record<string, unknown>): object | Promise<object>;
+/** Publishes an issued frame through the writer protocol in authored order. */
+export declare function writeExactServerComponent(this: ExactServerComponentArtifact, frame: object, output: ExactHtmlWriter): void | Promise<void>;
+/** Releases request-local frame ownership without storing request state on the artifact. */
+export declare function disposeExactServerComponent(this: ExactServerComponentArtifact, frame: ExactServerFrame, reason: unknown): void | Promise<void>;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/component-abi/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,OAAO,EAEN,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,wCAAwC,EAC7C,KAAK,uBAAuB,EAC5B,MAAM,aAAa,CAAC;AAErB,oGAAoG;AACpG,wBAAgB,uCAAuC,CACtD,IAAI,EAAE,4BAA4B,EAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,wCAAwC,EAChD,IAAI,EAAE,qBAAqB,GACzB,uBAAuB,CAEzB;AACD,OAAO,EAIN,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACrB,MAAM,aAAa,CAAC;AAErB,2FAA2F;AAC3F,wBAAgB,wCAAwC,CACvD,QAAQ,EAAE,oBAAoB,EAC9B,YAAY,EAAE,MAAM,IAAI,GACtB,OAAO,CAET;AAED,4FAA4F;AAC5F,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,oBAAoB,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAEjG;AAED,4EAA4E;AAC5E,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,4BAA4B,EAClC,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1B;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,4BAA4B,EAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,eAAe,GACrB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtB;AAED,4FAA4F;AAC5F,wBAAgB,2BAA2B,CAC1C,IAAI,EAAE,4BAA4B,EAClC,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,OAAO,GACb,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtB"}

package/dist/component-abi/runtime.js

@@ -0,0 +1,28 @@
+import { executePreparedComponentOutput } from '../component/render.js';
+import { exactCompatibilityClientAttachment } from './client.js';
+/** Delegates a fixed foreign-renderer island without projecting its output into native children. */
+export function attachExactCompatibilityClientComponent(instance, target, mode) {
+    return target[exactCompatibilityClientAttachment](this, instance, mode);
+}
+import { exactServerDispose, exactServerIssue, exactServerWrite } from './server.js';
+/** Executes compatibility-owned output without asserting a native child representation. */
+export function executeExactCompatibilityComponentOutput(instance, onInvalidate) {
+    return executePreparedComponentOutput(instance, onInvalidate);
+}
+/** Releases a client component instance through its idempotent instance-owned finalizer. */
+export function disposeExactClientComponent(instance, reason) {
+    instance.unmount(typeof reason === 'string' ? reason : 'artifact-dispose');
+}
+/** Establishes request ownership through the request execution protocol. */
+export function issueExactServerComponent(request, parent, props) {
+    return request[exactServerIssue](this, parent, props);
+}
+/** Publishes an issued frame through the writer protocol in authored order. */
+export function writeExactServerComponent(frame, output) {
+    return output[exactServerWrite](this, frame);
+}
+/** Releases request-local frame ownership without storing request state on the artifact. */
+export function disposeExactServerComponent(frame, reason) {
+    return frame[exactServerDispose](this, reason);
+}
+//# sourceMappingURL=runtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/component-abi/runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EACN,kCAAkC,EAKlC,MAAM,aAAa,CAAC;AAErB,oGAAoG;AACpG,MAAM,UAAU,uCAAuC,CAEtD,QAAgB,EAChB,MAAgD,EAChD,IAA2B;IAE3B,OAAO,MAAM,CAAC,kCAAkC,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;AACzE,CAAC;AACD,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAKhB,MAAM,aAAa,CAAC;AAErB,2FAA2F;AAC3F,MAAM,UAAU,wCAAwC,CACvD,QAA8B,EAC9B,YAAwB;IAExB,OAAO,8BAA8B,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;AAC/D,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,2BAA2B,CAAC,QAA8B,EAAE,MAAe;IAC1F,QAAQ,CAAC,OAAO,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAC5E,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,yBAAyB,CAExC,OAA8B,EAC9B,MAA0B,EAC1B,KAA8B;IAE9B,OAAO,OAAO,CAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,yBAAyB,CAExC,KAAa,EACb,MAAuB;IAEvB,OAAO,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,2BAA2B,CAE1C,KAAuB,EACvB,MAAe;IAEf,OAAO,KAAK,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAChD,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { RenderResult } from '../component/contracts.js';
+/** Direct request-local child range emitted only by compiler-closed server artifacts. */
+export type ExactPreparedServerChildRange = Readonly<{
+    readonly value: RenderResult;
+    readonly markerId?: string;
+    readonly mayReplaceSubtree: boolean;
+}>;
+/** Creates a direct server range without allocating an opaque operation or private payload. */
+export declare function createPreparedServerChildRange(value: RenderResult, markerId?: string, mayReplaceSubtree?: boolean): ExactPreparedServerChildRange;
+/** Reads only direct child ranges issued by compiler-closed server artifacts. */
+export declare function readPreparedServerChildRange(value: unknown): ExactPreparedServerChildRange | undefined;
+//# sourceMappingURL=server-child-range.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server-child-range.d.ts","sourceRoot":"","sources":["../../src/component-abi/server-child-range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,yFAAyF;AACzF,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACpC,CAAC,CAAC;AAEH,+FAA+F;AAC/F,wBAAgB,8BAA8B,CAC7C,KAAK,EAAE,YAAY,EACnB,QAAQ,CAAC,EAAE,MAAM,EACjB,iBAAiB,UAAO,GACtB,6BAA6B,CAQ/B;AAED,iFAAiF;AACjF,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,OAAO,GACZ,6BAA6B,GAAG,SAAS,CAI3C"}

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

@@ -0,0 +1,18 @@
+const PreparedServerChildRange = Symbol.for('@exactjs/server/prepared-child-range');
+/** Creates a direct server range without allocating an opaque operation or private payload. */
+export function createPreparedServerChildRange(value, markerId, mayReplaceSubtree = true) {
+    const range = {
+        [PreparedServerChildRange]: true,
+        value,
+        ...(markerId === undefined ? {} : { markerId }),
+        mayReplaceSubtree
+    };
+    return range;
+}
+/** Reads only direct child ranges issued by compiler-closed server artifacts. */
+export function readPreparedServerChildRange(value) {
+    return typeof value === 'object' && value !== null && PreparedServerChildRange in value
+        ? value
+        : undefined;
+}
+//# sourceMappingURL=server-child-range.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server-child-range.js","sourceRoot":"","sources":["../../src/component-abi/server-child-range.ts"],"names":[],"mappings":"AAEA,MAAM,wBAAwB,GAAG,MAAM,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;AASpF,+FAA+F;AAC/F,MAAM,UAAU,8BAA8B,CAC7C,KAAmB,EACnB,QAAiB,EACjB,iBAAiB,GAAG,IAAI;IAExB,MAAM,KAAK,GAAG;QACb,CAAC,wBAAwB,CAAC,EAAE,IAAI;QAChC,KAAK;QACL,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC/C,iBAAiB;KACjB,CAAC;IACF,OAAO,KAAK,CAAC;AACd,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,4BAA4B,CAC3C,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,wBAAwB,IAAI,KAAK;QACtF,CAAC,CAAE,KAAkD;QACrD,CAAC,CAAC,SAAS,CAAC;AACd,CAAC"}

package/dist/component-abi/server-keyed-child.d.ts

@@ -0,0 +1,13 @@
+import type { ExactPreparedServerRenderProgram } from '../render-program.js';
+/** Direct request-local keyed child emitted only by compiler-closed server artifacts. */
+export type ExactPreparedServerKeyedChild = Readonly<{
+    readonly value: unknown;
+    readonly key: string;
+}>;
+/** Validates a list key while reusing the compiler-proven program's existing item boundary. */
+export declare function createPreparedServerKeyedChild(value: ExactPreparedServerRenderProgram, authoredKey: unknown, program: true): ExactPreparedServerRenderProgram;
+/** Retains server-local list identity for values requiring a separate keyed boundary. */
+export declare function createPreparedServerKeyedChild(value: unknown, authoredKey: unknown): ExactPreparedServerKeyedChild;
+/** Reads only direct keyed children issued by compiler-closed server artifacts. */
+export declare function readPreparedServerKeyedChild(value: unknown): ExactPreparedServerKeyedChild | undefined;
+//# sourceMappingURL=server-keyed-child.d.ts.map

package/dist/component-abi/server-keyed-child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-keyed-child.d.ts","sourceRoot":"","sources":["../../src/component-abi/server-keyed-child.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sBAAsB,CAAC;AAI7E,yFAAyF;AACzF,MAAM,MAAM,6BAA6B,GAAG,QAAQ,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACrB,CAAC,CAAC;AAEH,+FAA+F;AAC/F,wBAAgB,8BAA8B,CAC7C,KAAK,EAAE,gCAAgC,EACvC,WAAW,EAAE,OAAO,EACpB,OAAO,EAAE,IAAI,GACX,gCAAgC,CAAC;AACpC,yFAAyF;AACzF,wBAAgB,8BAA8B,CAC7C,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,OAAO,GAClB,6BAA6B,CAAC;AAejC,mFAAmF;AACnF,wBAAgB,4BAA4B,CAC3C,KAAK,EAAE,OAAO,GACZ,6BAA6B,GAAG,SAAS,CAI3C"}

package/dist/component-abi/server-keyed-child.js

@@ -0,0 +1,20 @@
+import { unwrap } from '@exactjs/reactive/framework/values';
+const PreparedServerKeyedChild = Symbol.for('@exactjs/server/prepared-keyed-child');
+/** Only compiler-proven program children may omit the wrapper; key validation and coercion remain. */
+export function createPreparedServerKeyedChild(value, authoredKey, program = false) {
+    const key = unwrap(authoredKey);
+    if (key === null || key === undefined)
+        throw new Error('Compiled keyed lists require a key');
+    const normalizedKey = String(key);
+    if (program)
+        return value;
+    const child = { [PreparedServerKeyedChild]: true, value, key: normalizedKey };
+    return child;
+}
+/** Reads only direct keyed children issued by compiler-closed server artifacts. */
+export function readPreparedServerKeyedChild(value) {
+    return typeof value === 'object' && value !== null && PreparedServerKeyedChild in value
+        ? value
+        : undefined;
+}
+//# sourceMappingURL=server-keyed-child.js.map

package/dist/component-abi/server-keyed-child.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-keyed-child.js","sourceRoot":"","sources":["../../src/component-abi/server-keyed-child.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAG5D,MAAM,wBAAwB,GAAG,MAAM,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;AAmBpF,sGAAsG;AACtG,MAAM,UAAU,8BAA8B,CAC7C,KAAc,EACd,WAAoB,EACpB,OAAO,GAAG,KAAK;IAEf,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;IAChC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC7F,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,OAAO;QAAE,OAAO,KAAyC,CAAC;IAC9D,MAAM,KAAK,GAAG,EAAE,CAAC,wBAAwB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC;IAC9E,OAAO,KAAK,CAAC;AACd,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,4BAA4B,CAC3C,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,wBAAwB,IAAI,KAAK;QACtF,CAAC,CAAE,KAAkD;QACrD,CAAC,CAAC,SAAS,CAAC;AACd,CAAC"}

package/dist/component-abi/server-runtime.d.ts

@@ -0,0 +1,8 @@
+import { type ExactHtmlWriter, type ExactRequestExecution, type ExactServerComponentArtifact, type ExactServerFrame } from './server.js';
+/** Establishes request ownership through the request execution protocol. */
+export declare function issueExactServerComponent(this: ExactServerComponentArtifact, request: ExactRequestExecution, parent: object | undefined, props: Record<string, unknown>): object | Promise<object>;
+/** Publishes an issued frame through the writer protocol in authored order. */
+export declare function writeExactServerComponent(this: ExactServerComponentArtifact, frame: object, output: ExactHtmlWriter): void | Promise<void>;
+/** Releases request-local frame ownership without storing request state on the artifact. */
+export declare function disposeExactServerComponent(this: ExactServerComponentArtifact, frame: ExactServerFrame, reason: unknown): void | Promise<void>;
+//# sourceMappingURL=server-runtime.d.ts.map

package/dist/component-abi/server-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-runtime.d.ts","sourceRoot":"","sources":["../../src/component-abi/server-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACrB,MAAM,aAAa,CAAC;AAErB,4EAA4E;AAC5E,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,4BAA4B,EAClC,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1B;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,4BAA4B,EAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,eAAe,GACrB,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtB;AAED,4FAA4F;AAC5F,wBAAgB,2BAA2B,CAC1C,IAAI,EAAE,4BAA4B,EAClC,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,OAAO,GACb,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtB"}

package/dist/component-abi/server-runtime.js

@@ -0,0 +1,14 @@
+import { exactServerDispose, exactServerIssue, exactServerWrite } from './server.js';
+/** Establishes request ownership through the request execution protocol. */
+export function issueExactServerComponent(request, parent, props) {
+    return request[exactServerIssue](this, parent, props);
+}
+/** Publishes an issued frame through the writer protocol in authored order. */
+export function writeExactServerComponent(frame, output) {
+    return output[exactServerWrite](this, frame);
+}
+/** Releases request-local frame ownership without storing request state on the artifact. */
+export function disposeExactServerComponent(frame, reason) {
+    return frame[exactServerDispose](this, reason);
+}
+//# sourceMappingURL=server-runtime.js.map

package/dist/component-abi/server-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-runtime.js","sourceRoot":"","sources":["../../src/component-abi/server-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,EAKhB,MAAM,aAAa,CAAC;AAErB,4EAA4E;AAC5E,MAAM,UAAU,yBAAyB,CAExC,OAA8B,EAC9B,MAA0B,EAC1B,KAA8B;IAE9B,OAAO,OAAO,CAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,yBAAyB,CAExC,KAAa,EACb,MAAuB;IAEvB,OAAO,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,2BAA2B,CAE1C,KAAuB,EACvB,MAAe;IAEf,OAAO,KAAK,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAChD,CAAC"}

package/dist/component-abi/server-structure-receipts.d.ts

@@ -0,0 +1,64 @@
+import type { Child } from '../component/contracts.js';
+declare const exactServerBoundaryReceiptBrand: unique symbol;
+declare const exactServerSlotReceiptBrand: unique symbol;
+/** Opaque compiler-owned client-island publication operation. */
+export type ExactServerBoundaryReceipt = object & {
+    readonly [exactServerBoundaryReceiptBrand]: never;
+};
+/** Opaque compiler-owned retained server-range operation. */
+export type ExactServerSlotReceipt = object & {
+    readonly [exactServerSlotReceiptBrand]: never;
+};
+/** Private compiler-selected client-island publication inputs consumed by SSR. */
+export type ExactServerBoundaryReceiptData = Readonly<{
+    id: string;
+    name: string;
+    props: Readonly<Record<string, unknown>>;
+    children: readonly Child[];
+}>;
+/** Private retained server-range inputs and compiler-owned protocol authority. */
+export type ExactServerSlotReceiptData = Readonly<{
+    id: string;
+    children: readonly Child[];
+    key?: string;
+    planVersion?: unknown;
+    buildKey?: unknown;
+    planEdgeId?: unknown;
+    ownerComponentId?: unknown;
+    discriminator?: unknown;
+    generation?: unknown;
+}>;
+/** Dispatch key implemented by SSR targets that publish a client island. */
+export declare const exactServerBoundaryOperation: unique symbol;
+/** Dispatch key implemented by SSR targets that retain a server-owned range. */
+export declare const exactServerSlotOperation: unique symbol;
+/** Target contract selected by an opaque client-island publication. */
+export type ExactServerBoundaryOperationTarget<Result = unknown> = Readonly<{
+    [exactServerBoundaryOperation](operation: ExactServerBoundaryReceipt, data: ExactServerBoundaryReceiptData): Result;
+}>;
+/** Target contract selected by an opaque retained server range. */
+export type ExactServerSlotOperationTarget<Result = unknown> = Readonly<{
+    [exactServerSlotOperation](operation: ExactServerSlotReceipt, data: ExactServerSlotReceiptData): Result;
+}>;
+/** Issues one compiler-owned client-island publication operation. */
+export declare function createServerBoundaryReceipt(id: string, name: string, props?: Record<string, unknown>, ...children: unknown[]): ExactServerBoundaryReceipt;
+/** Creates a compiler-owned client-island publication operation. */
+export declare const createServerBoundary: typeof createServerBoundaryReceipt;
+/** Issues a client boundary from compiler-lowered JSX props. */
+export declare function createCompiledServerBoundaryReceipt(input: Record<string, unknown> | null, ...children: unknown[]): ExactServerBoundaryReceipt;
+/** Issues one compiler-owned retained server-range operation. */
+export declare function createServerSlotReceipt(id: string, authority?: Record<string, unknown>, ...children: unknown[]): ExactServerSlotReceipt;
+/** Creates or adopts one compiler-owned retained server range. */
+export declare const createServerSlot: typeof createServerSlotReceipt;
+/** Issues a retained server range from compiler-lowered JSX props. */
+export declare function createCompiledServerSlotReceipt(input: Record<string, unknown> | null, ...children: unknown[]): ExactServerSlotReceipt;
+/** Issues one canonically keyed retained server range. */
+export declare function createKeyedServerSlotReceipt(id: string, list: string, key: unknown, authority?: Record<string, unknown>, ...children: unknown[]): ExactServerSlotReceipt;
+/** Creates one canonical keyed server range. */
+export declare const createKeyedServerSlot: typeof createKeyedServerSlotReceipt;
+/** Reads a compiler-issued client-island publication operation without accepting arbitrary objects. */
+export declare function readServerBoundaryReceipt(value: unknown): ExactServerBoundaryReceiptData | undefined;
+/** Reads a compiler-issued retained server-range operation without accepting arbitrary objects. */
+export declare function readServerSlotReceipt(value: unknown): ExactServerSlotReceiptData | undefined;
+export {};
+//# sourceMappingURL=server-structure-receipts.d.ts.map

package/dist/component-abi/server-structure-receipts.d.ts.map

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

package/dist/component-abi/server-structure-receipts.js

@@ -0,0 +1,81 @@
+import { unwrap } from '@exactjs/reactive/framework/values';
+import { encodeExactMarkerPart } from '../protocol.js';
+import { normalizeRenderResult } from '../render-children.js';
+import { createOpaqueOperation, sharedOpaqueOperationStore } from './opaque-operation.js';
+const boundaries = sharedOpaqueOperationStore('server-boundary');
+const slots = sharedOpaqueOperationStore('server-slot');
+/** Dispatch key implemented by SSR targets that publish a client island. */
+export const exactServerBoundaryOperation = Symbol.for('@exactjs/target-operation/server-boundary');
+/** Dispatch key implemented by SSR targets that retain a server-owned range. */
+export const exactServerSlotOperation = Symbol.for('@exactjs/target-operation/server-slot');
+function executeServerBoundaryOperation(target) {
+    const data = boundaries.get(this);
+    if (!data)
+        throw new TypeError('Server-boundary operation lost its compiler-issued payload');
+    return target[exactServerBoundaryOperation](this, data);
+}
+function executeServerSlotOperation(target) {
+    const data = slots.get(this);
+    if (!data)
+        throw new TypeError('Server-slot operation lost its compiler-issued payload');
+    return target[exactServerSlotOperation](this, data);
+}
+/** Issues one compiler-owned client-island publication operation. */
+export function createServerBoundaryReceipt(id, name, props = {}, ...children) {
+    const receipt = createOpaqueOperation(executeServerBoundaryOperation);
+    boundaries.set(receipt, {
+        id: String(unwrap(id) ?? ''),
+        name: String(unwrap(name) ?? ''),
+        props,
+        children: normalizeRenderResult(children)
+    });
+    return receipt;
+}
+/** Creates a compiler-owned client-island publication operation. */
+export const createServerBoundary = createServerBoundaryReceipt;
+/** Issues a client boundary from compiler-lowered JSX props. */
+export function createCompiledServerBoundaryReceipt(input, ...children) {
+    const props = input ?? {};
+    return createServerBoundaryReceipt(String(unwrap(props.id) ?? ''), String(unwrap(props.name) ?? ''), (unwrap(props.props) ?? {}), ...children);
+}
+/** Issues one compiler-owned retained server-range operation. */
+export function createServerSlotReceipt(id, authority = {}, ...children) {
+    return issueServerSlotReceipt(String(unwrap(id) ?? ''), authority, children);
+}
+/** Creates or adopts one compiler-owned retained server range. */
+export const createServerSlot = createServerSlotReceipt;
+/** Issues a retained server range from compiler-lowered JSX props. */
+export function createCompiledServerSlotReceipt(input, ...children) {
+    const { id, ...authority } = input ?? {};
+    return createServerSlotReceipt(String(unwrap(id) ?? ''), authority, ...children);
+}
+/** Issues one canonically keyed retained server range. */
+export function createKeyedServerSlotReceipt(id, list, key, authority = {}, ...children) {
+    const rawKey = unwrap(key);
+    if (rawKey === null || rawKey === undefined)
+        throw new Error('Keyed server ranges require a canonical key');
+    const keyToken = String(rawKey);
+    return issueServerSlotReceipt(`${id}:key:${encodeExactMarkerPart(keyToken)}`, { ...authority, key: keyToken, discriminator: { kind: 'keyed', list, keyToken } }, children);
+}
+/** Creates one canonical keyed server range. */
+export const createKeyedServerSlot = createKeyedServerSlotReceipt;
+function issueServerSlotReceipt(id, authority, children) {
+    const { key, ...protocolAuthority } = authority;
+    const receipt = createOpaqueOperation(executeServerSlotOperation);
+    slots.set(receipt, {
+        id,
+        children: normalizeRenderResult(children),
+        ...(key === null || key === undefined ? {} : { key: String(unwrap(key)) }),
+        ...protocolAuthority
+    });
+    return receipt;
+}
+/** Reads a compiler-issued client-island publication operation without accepting arbitrary objects. */
+export function readServerBoundaryReceipt(value) {
+    return typeof value === 'object' && value !== null ? boundaries.get(value) : undefined;
+}
+/** Reads a compiler-issued retained server-range operation without accepting arbitrary objects. */
+export function readServerSlotReceipt(value) {
+    return typeof value === 'object' && value !== null ? slots.get(value) : undefined;
+}
+//# sourceMappingURL=server-structure-receipts.js.map

package/dist/component-abi/server-structure-receipts.js.map

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