@exactjs/core 0.6.2 → 0.6.4

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

@@ -1 +1 @@
-{"version":3,"file":"component-contracts.js","sourceRoot":"","sources":["../../src/component-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAG5E,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACpF,OAAO,EACN,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACb,MAAM,6CAA6C,CAAC;AAgBrD,OAAO,EACN,0BAA0B,EAE1B,MAAM,wCAAwC,CAAC;AAEhD,wFAAwF;AACxF,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;AAEhF,gGAAgG;AAChG,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AA6MnE,kFAAkF;AAClF,MAAM,UAAU,gBAAgB,CAAC,SAAkB;IAClD,IAAI,OAAO,SAAS,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,QAAQ,GAAI,SAA+B,CAAC,kBAAkB,CAAC,CAAC;IACtE,OAAO,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,0BAA0B,CACzC,SAAoC;IAEpC,MAAM,QAAQ,GAAI,SAA+B,CAAC,sBAAsB,CAAC,CAAC;IAC1E,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,WAAW,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;IACtD,OAAO,0BAA0B,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;AACrE,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,oCAAoC,CACnD,SAAoC;IAEpC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,QAAQ,EAAE,QAAQ;QACtB,MAAM,IAAI,SAAS,CAAC,yEAAyE,CAAC,CAAC;IAChG,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,0CAA0C,CACzD,SAAoC;IAEpC,MAAM,QAAQ,GAAG,oCAAoC,CAAC,SAAS,CAAC,CAAC;IACjE,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,QAAQ;QACxC,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACtF,OAAO,QAAkD,CAAC;AAC3D,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,0CAA0C,CACzD,SAAoC;IAEpC,MAAM,QAAQ,GAAG,oCAAoC,CAAC,SAAS,CAAC,CAAC;IACjE,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,QAAQ;QACxC,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACtF,OAAO,QAAkD,CAAC;AAC3D,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,kCAAkC,CACjD,SAAoC;IAEpC,MAAM,QAAQ,GAAI,SAA+B,CAAC,sBAAsB,CAAC,CAAC;IAC1E,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,EAAE,OAAO,KAAK,wBAAwB;QACtE,MAAM,IAAI,SAAS,CAClB,gDAAgD,QAAQ,CAAC,QAAQ,EAAE,OAAO,cAAc,wBAAwB,+CAA+C,CAC/J,CAAC;IACH,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,4CAA4C,CAC3D,SAAoC;IAEpC,MAAM,QAAQ,GAAG,kCAAkC,CAAC,SAAS,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ,EAAE,QAAQ;QACtB,MAAM,IAAI,SAAS,CAClB,4EAA4E,SAAS,CAAC,IAAI,IAAI,aAAa,EAAE,CAC7G,CAAC;IACH,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,kDAAkD,CACjE,SAAoC;IAEpC,MAAM,QAAQ,GAAG,4CAA4C,CAAC,SAAS,CAAC,CAAC;IACzE,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,QAAQ;QACxC,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACtF,OAAO,QAC8C,CAAC;AACvD,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,kDAAkD,CACjE,SAAoC;IAEpC,MAAM,QAAQ,GAAG,4CAA4C,CAAC,SAAS,CAAC,CAAC;IACzE,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,QAAQ;QACxC,MAAM,IAAI,SAAS,CAAC,+DAA+D,CAAC,CAAC;IACtF,OAAO,QAAkD,CAAC;AAC3D,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,sBAAsB,CAAC,SAAoC;IAC1E,MAAM,QAAQ,GAAI,SAA+B,CAAC,kBAAkB,CAAC,CAAC;IACtE,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9D,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;AAC5E,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,8BAA8B,CAC7C,UAAgD,EAChD,IAAoC;IAEpC,OAAO,yBAAyB,CAAC,UAAU,EAAE,IAAI,EAAE,0BAA0B,CAAC,CAAC;AAChF,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,sCAAsC,CACrD,UAAgD,EAChD,IAAoC;IAEpC,OAAO,yBAAyB,CAAC,UAAU,EAAE,IAAI,EAAE,kCAAkC,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,yBAAyB,CACjC,UAAgD,EAChD,IAAoC,EACpC,YAAkG;IAElG,MAAM,eAAe,GAA8C,EAAE,CAAC;IACtE,MAAM,mBAAmB,GAA8C,EAAE,CAAC;IAC1E,MAAM,aAAa,GAAuD,EAAE,CAAC;IAC7E,MAAM,SAAS,GAA+D,EAAE,CAAC;IACjF,MAAM,UAAU,GAAmD,EAAE,CAAC;IACtE,MAAM,WAAW,GAAqD,EAAE,CAAC;IACzE,MAAM,UAAU,GAAoD,EAAE,CAAC;IACvE,MAAM,SAAS,GAAqD,EAAE,CAAC;IAEvE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,MAAM,WAAW,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,aAAa,GAClB,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QAChF,IAAI,aAAa,KAAK,IAAI;YACzB,MAAM,IAAI,KAAK,CACd,kBAAkB,IAAI,2BAA2B,WAAW,cAAc,aAAa,EAAE,CACzF,CAAC;QACH,MAAM,wBAAwB,GAAG,QAAQ,CAAC,eAAe,IAAI;YAC5D;gBACC,EAAE,EAAE,WAAW;gBACf,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,IAAI,EAAE,MAAe;gBACrB,cAAc,EAAE,SAAS;aACzB;SACD,CAAC;QACF,KAAK,MAAM,cAAc,IAAI,wBAAwB,EAAE,CAAC;YACvD,uBAAuB,CACtB,mBAAmB,EACnB,cAAc,CAAC,EAAE,EACjB,cAAc,CAAC,cAAc,CAC7B,CAAC;YACF,uBAAuB,CAAC,eAAe,EAAE,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;QAC9F,CAAC;QACD,KAAK,MAAM,YAAY,IAAI,QAAQ,CAAC,aAAa,IAAI,EAAE;YACtD,aAAa,CAAC,aAAa,EAAE,YAAY,CAAC,EAAE,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;QAC7E,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,IAAI,EAAE;YAAE,iBAAiB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxF,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,UAAU,IAAI,EAAE;YAC/C,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAC9D,IAAI,QAAQ,CAAC,UAAU;YACtB,aAAa,CACZ,WAAW,EACX,QAAQ,CAAC,UAAU,CAAC,WAAW,EAC/B,QAAQ,CAAC,UAAU,EACnB,YAAY,CACZ,CAAC;QACH,IAAI,QAAQ,CAAC,SAAS;YACrB,aAAa,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC;QAC9E,SAAS,CAAC,WAAW,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC5C,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACpB,eAAe;QACf,mBAAmB;QACnB,aAAa;QACb,SAAS;QACT,UAAU;QACV,WAAW;QACX,UAAU;QACV,SAAS;KACT,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { componentContractVersion } from './component/contract-versions.js';\nimport type { ContextToken } from './component/contracts.js';\nimport type { TaskContext } from './tasks/contracts.js';\nimport { validatedComponentContract } from './component-contract/contract-cache.js';\nimport {\n\taddUniqueExecutor,\n\taddUniqueImplementation,\n\taddUniqueJson\n} from './component-contract/composition-support.js';\nimport type { ExactComponentExecutableArtifact } from './component-abi/artifact.js';\nimport type { ExactClientComponentArtifact } from './component-abi/client.js';\nimport type { ExactServerComponentArtifact } from './component-abi/server.js';\nimport type {\n\tAnyExactComponentCallable,\n\tExactComponentReactiveAllocation\n} from './component-abi/executable-fields.js';\n\nexport type { ExactComponentExecutableArtifact } from './component-abi/artifact.js';\nexport type { ExactClientComponentArtifact } from './component-abi/client.js';\nexport type {\n\tExactServerComponentArtifact,\n\tExactServerComponentExecution\n} from './component-abi/server.js';\nexport type { AnyExactComponentCallable } from './component-abi/executable-fields.js';\nexport {\n\tdecodeExactValueWithSchema,\n\ttype ExactValueSerializationSchema\n} from './component-abi/value-serialization.js';\n\n/** Global property under which compiled artifacts carry their target-local contract. */\nexport const exactComponentContract = Symbol.for('@exactjs/component-contract');\n\n/** Global marker distinguishing a native eXact component from compatibility-owned functions. */\nexport const exactComponentType = Symbol.for('@exactjs/component');\n\n/** One executable implementation owned by a compiled component artifact. */\nexport type ExactComponentImplementationContract = Readonly<{\n\tid: string;\n\tname: string;\n\trole: 'root' | 'client-island' | 'server-part';\n\timplementation: AnyExactComponentCallable;\n}>;\n\n/** Runtime-neutral state path used by a generated continuation contract. */\nexport type ExactContinuationStatePathContract = Readonly<{\n\tpath: string;\n\tkind: 'read' | 'write';\n\tconfidence: 'exact' | 'broad' | 'unknown';\n\toperation?: 'value' | 'map' | 'set';\n}>;\n\n/** One ordered Map or Set mutation returned by a server continuation. */\nexport type ExactCollectionMutation =\n\t| Readonly<{ path: string; operation: 'map-set'; key: unknown; value: unknown }>\n\t| Readonly<{ path: string; operation: 'map-delete'; key: unknown }>\n\t| Readonly<{ path: string; operation: 'map-clear' }>\n\t| Readonly<{ path: string; operation: 'set-add'; value: unknown }>\n\t| Readonly<{ path: string; operation: 'set-delete'; value: unknown }>\n\t| Readonly<{ path: string; operation: 'set-clear' }>;\n\n/** Private operation contract attached to the component artifact that owns it. */\nexport type ExactComponentContinuationContract = Readonly<{\n\tid: string;\n\tkind: 'task';\n\tcomponentId: string;\n\treadiness: 'blocking' | 'nonblocking';\n\tconcurrency?: 'parallel' | 'latest' | 'queue';\n\tdependencies: readonly Readonly<{\n\t\tindex?: number;\n\t\tsource: 'state' | 'props' | 'derived' | 'argument';\n\t\tpath?: string;\n\t}>[];\n\tinvocation?: Readonly<{\n\t\targuments: readonly Readonly<{ index?: number; source: 'argument'; path?: string }>[];\n\t\tconcurrency: 'parallel' | 'latest' | 'queue';\n\t}>;\n\tstateReads: readonly ExactContinuationStatePathContract[];\n\tstateWrites: readonly ExactContinuationStatePathContract[];\n\tpublicContexts: readonly string[];\n\tserverContexts: readonly string[];\n\tcontextWrites: readonly string[];\n\t/** Server-owned context mutations which never enter the client response. */\n\tserverContextWrites?: readonly string[];\n\tboundaries: readonly string[];\n}>;\n\n/** Serializable activation record accepted by one generated server continuation. */\nexport type ExactComponentContinuationActivation = Readonly<{\n\tstate: Record<string, unknown>;\n\tdependencies: readonly unknown[];\n\tpublicContext: Readonly<Record<string, unknown>>;\n\tgeneration?: number;\n}>;\n\n/** Trusted invocation resources available only while a server continuation executes. */\nexport type ExactComponentContinuationExecution = Readonly<{\n\ttask: TaskContext;\n\tsignal: AbortSignal;\n\tgetContext<T>(token: ContextToken<T>, authoredName?: string): T;\n\tsetContext<T>(token: ContextToken<T>, value: T, authoredName?: string): void;\n}>;\n\n/** State accumulated by a generated continuation before write-contract projection. */\nexport type ExactComponentContinuationExecutionResult = Readonly<{\n\tstate: Record<string, unknown>;\n\tcontexts?: Readonly<Record<string, unknown>>;\n\tvalue?: unknown;\n}>;\n\n/** Executable server half paired with one inert continuation descriptor. */\nexport type ExactComponentContinuationExecutorContract = Readonly<{\n\tid: string;\n\tcomponentId: string;\n\texecute(\n\t\tactivation: ExactComponentContinuationActivation,\n\t\texecution: ExactComponentContinuationExecution\n\t): ExactComponentContinuationExecutionResult | Promise<ExactComponentContinuationExecutionResult>;\n}>;\n\n/** One compiler-owned DOM boundary and its component ownership. */\nexport type ExactComponentBoundaryContract = Readonly<{\n\tid: string;\n\tcomponentId: string;\n\townerComponentId: string;\n\tkind: string;\n\tplanVersion?: number;\n\tbuildKey?: string;\n\tplanEdgeId?: string;\n\tparentPlanId?: string;\n\tfallbackPlanId?: string;\n\tpatchTargets?: readonly string[];\n\tdiscriminatorKind?: 'single' | 'branch' | 'keyed';\n\tdiscriminatorValues?: readonly string[];\n\tgeneration?: number;\n}>;\n\n/** Minimum browser-visible values required to resume one SSR component. */\nexport type ExactComponentResumptionContract = Readonly<{\n\tcomponentId: string;\n\tstatePaths: readonly string[];\n\t/** State path and root-prop path pairs that client setup can reconstruct. */\n\tstateInputs: readonly (readonly [statePath: string, propPath: string])[];\n\t/** Compact completion allowlist when a hydration artifact omits its execution catalog. */\n\tcontinuations?: readonly string[];\n\t/** Server-only primitive setup values that sparse capture may omit. */\n\tstateDefaults?: readonly (readonly [\n\t\tstatePath: string,\n\t\tvalue: string | number | boolean | null\n\t])[];\n\tvalueCaptures: readonly string[];\n\tcontexts: readonly string[];\n\tboundaries: readonly string[];\n}>;\n\n/** Compact target-local execution wiring emitted for one semantic component. */\nexport type ExactComponentExecutionContract = Readonly<{\n\tversion: 1;\n\t/** Port tuple: kind, authored path, direction. Its array position is its index. */\n\tports: readonly (readonly [\n\t\tkind: 'state' | 'props' | 'context' | 'derived' | 'argument',\n\t\tpath: string,\n\t\tdirection: 'input' | 'output' | 'inout'\n\t])[];\n\t/** Transition tuple: identity, task, activation, placement, readiness, concurrency, inputs, outputs. */\n\ttransitions: readonly (readonly [\n\t\tid: string,\n\t\ttaskId: string,\n\t\tactivation: 'setup' | 'interaction',\n\t\tplacement: 'client' | 'server' | 'isomorphic',\n\t\treadiness: 'blocking' | 'nonblocking',\n\t\tconcurrency: 'parallel' | 'latest' | 'queue',\n\t\tinputs: readonly number[],\n\t\toutputs: readonly number[]\n\t])[];\n\t/** Build-inspection inventory omitted from render-mode-projected runtime bundles. */\n\treactive?: readonly ExactComponentReactiveAllocation[];\n}>;\n\n/** One component-owned direct DOM update program shared by every instance of its definition. */\nexport type {\n\tExactCompiledComponentCapability,\n\tExactCompiledComponentInputUpdateContract,\n\tExactCompiledComponentUpdateContract,\n\tExactNarrowComponentUpdateContract,\n\tExactWideComponentUpdateContract\n} from './component-definition-contracts.js';\n\n/** Target-local executable contract attached to a public component root. */\nexport type ExactComponentContract = Readonly<{\n\t/** Target-discriminated component contract for this compiler/runtime generation. */\n\tversion: typeof componentContractVersion;\n\tplacement: 'client' | 'server' | 'isomorphic' | 'unknown';\n\trole: 'client' | 'render' | 'executor';\n\timplementations: readonly ExactComponentImplementationContract[];\n\tcontinuations: readonly ExactComponentContinuationContract[];\n\texecutors: readonly ExactComponentContinuationExecutorContract[];\n\tboundaries: readonly ExactComponentBoundaryContract[];\n\tresumption?: ExactComponentResumptionContract;\n\texecution?: ExactComponentExecutionContract;\n\tartifact: ExactComponentExecutableArtifact;\n}>;\n\n/** Build-projected runtime attachment after adapter-owned composition facts are erased. */\nexport type ExactPreparedComponentContract = Readonly<\n\tPick<ExactComponentContract, 'artifact'> & Partial<Omit<ExactComponentContract, 'artifact'>>\n>;\n\n/** Runtime attachment whose single executable artifact is guaranteed by the current target ABI. */\nexport type ExactExecutableComponentContract = ExactPreparedComponentContract;\n\n/** Prepared attachment whose target-local artifact is always executable. */\nexport type ExactPreparedExecutableComponentContract = ExactExecutableComponentContract;\n\n/** Current executable contract proven to carry the client target ABI. */\nexport type ExactClientExecutableComponentContract = ExactExecutableComponentContract &\n\tReadonly<{ artifact: ExactClientComponentArtifact }>;\n\n/** Current executable contract proven to carry the server target ABI. */\nexport type ExactServerExecutableComponentContract = ExactComponentContract &\n\tReadonly<{ artifact: ExactServerComponentArtifact }>;\n\n/** Composed target-local contracts indexed for runtime use. */\nexport type ExactComposedComponentContracts = Readonly<{\n\timplementations: Record<string, AnyExactComponentCallable>;\n\timplementationsById: Record<string, AnyExactComponentCallable>;\n\tcontinuations: Record<string, ExactComponentContinuationContract>;\n\texecutors: Record<string, ExactComponentContinuationExecutorContract>;\n\tboundaries: Record<string, ExactComponentBoundaryContract>;\n\tresumptions: Record<string, ExactComponentResumptionContract>;\n\texecutions: Record<string, ExactComponentExecutionContract>;\n\tartifacts: Record<string, ExactComponentExecutableArtifact>;\n}>;\n\ntype ContractComponent = AnyExactComponentCallable & {\n\t[exactComponentContract]?: ExactComponentContract;\n\t[exactComponentType]?: string;\n};\n\n/** Returns whether a callable carries a valid native eXact component identity. */\nexport function isExactComponent(component: unknown): component is AnyExactComponentCallable {\n\tif (typeof component !== 'function') return false;\n\tconst identity = (component as ContractComponent)[exactComponentType];\n\treturn typeof identity === 'string' && identity.length > 0;\n}\n\n/** Reads and validates compiler-attached metadata from one target-local component export. */\nexport function readExactComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactComponentContract | undefined {\n\tconst contract = (component as ContractComponent)[exactComponentContract];\n\tif (!contract) return undefined;\n\tconst componentId = exactComponentIdentity(component);\n\treturn validatedComponentContract(component, contract, componentId);\n}\n\n/** Reads one current executable target artifact and rejects obsolete or identity-only values. */\nexport function readExactExecutableComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactExecutableComponentContract {\n\tconst contract = readExactComponentContract(component);\n\tif (!contract?.artifact)\n\t\tthrow new TypeError('Native eXact component execution requires a compiled component artifact');\n\treturn contract;\n}\n\n/** Reads and validates one client-target executable component contract. */\nexport function readExactClientExecutableComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactClientExecutableComponentContract {\n\tconst contract = readExactExecutableComponentContract(component);\n\tif (contract.artifact.target !== 'client')\n\t\tthrow new TypeError('Client execution requires a current client component artifact');\n\treturn contract as ExactClientExecutableComponentContract;\n}\n\n/** Reads and validates one server-target executable component contract. */\nexport function readExactServerExecutableComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactServerExecutableComponentContract {\n\tconst contract = readExactExecutableComponentContract(component);\n\tif (contract.artifact.target !== 'server')\n\t\tthrow new TypeError('Server execution requires a current server component artifact');\n\treturn contract as ExactServerExecutableComponentContract;\n}\n\n/** Reads build-validated compiler metadata without repeating recursive runtime validation. */\nexport function readPreparedExactComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactPreparedComponentContract | undefined {\n\tconst contract = (component as ContractComponent)[exactComponentContract];\n\tif (contract && contract.artifact?.version !== componentContractVersion)\n\t\tthrow new TypeError(\n\t\t\t`Unsupported eXact component artifact version ${contract.artifact?.version}; expected ${componentContractVersion}. Recompile with the matching eXact compiler.`\n\t\t);\n\treturn contract;\n}\n\n/** Reads a build-validated current executable target artifact. */\nexport function readPreparedExactExecutableComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactPreparedExecutableComponentContract {\n\tconst contract = readPreparedExactComponentContract(component);\n\tif (!contract?.artifact)\n\t\tthrow new TypeError(\n\t\t\t`Native eXact component execution requires a compiled component artifact: ${component.name || '<anonymous>'}`\n\t\t);\n\treturn contract;\n}\n\n/** Reads one build-validated client-target executable component contract. */\nexport function readPreparedExactClientExecutableComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactPreparedComponentContract & Readonly<{ artifact: ExactClientComponentArtifact }> {\n\tconst contract = readPreparedExactExecutableComponentContract(component);\n\tif (contract.artifact.target !== 'client')\n\t\tthrow new TypeError('Client execution requires a current client component artifact');\n\treturn contract as ExactPreparedComponentContract &\n\t\tReadonly<{ artifact: ExactClientComponentArtifact }>;\n}\n\n/** Reads one build-validated server-target executable component contract. */\nexport function readPreparedExactServerExecutableComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactServerExecutableComponentContract {\n\tconst contract = readPreparedExactExecutableComponentContract(component);\n\tif (contract.artifact.target !== 'server')\n\t\tthrow new TypeError('Server execution requires a current server component artifact');\n\treturn contract as ExactServerExecutableComponentContract;\n}\n\n/** Returns the stable compiler identity used to pair SSR and client component boundaries. */\nexport function exactComponentIdentity(component: AnyExactComponentCallable): string {\n\tconst identity = (component as ContractComponent)[exactComponentType];\n\tif (typeof identity === 'string' && identity) return identity;\n\tthrow new Error('Native eXact components require compiler-owned identity');\n}\n\n/** Composes reachable imported component contracts into duplicate-checked runtime indexes. */\nexport function composeExactComponentContracts(\n\tcomponents: readonly AnyExactComponentCallable[],\n\trole: ExactComponentContract['role']\n): ExactComposedComponentContracts {\n\treturn composeComponentContracts(components, role, readExactComponentContract);\n}\n\n/** Composes build-validated compiler metadata without repeating recursive validation. */\nexport function composePreparedExactComponentContracts(\n\tcomponents: readonly AnyExactComponentCallable[],\n\trole: ExactComponentContract['role']\n): ExactComposedComponentContracts {\n\treturn composeComponentContracts(components, role, readPreparedExactComponentContract);\n}\n\nfunction composeComponentContracts(\n\tcomponents: readonly AnyExactComponentCallable[],\n\trole: ExactComponentContract['role'],\n\treadContract: (component: AnyExactComponentCallable) => ExactPreparedComponentContract | undefined\n): ExactComposedComponentContracts {\n\tconst implementations: Record<string, AnyExactComponentCallable> = {};\n\tconst implementationsById: Record<string, AnyExactComponentCallable> = {};\n\tconst continuations: Record<string, ExactComponentContinuationContract> = {};\n\tconst executors: Record<string, ExactComponentContinuationExecutorContract> = {};\n\tconst boundaries: Record<string, ExactComponentBoundaryContract> = {};\n\tconst resumptions: Record<string, ExactComponentResumptionContract> = {};\n\tconst executions: Record<string, ExactComponentExecutionContract> = {};\n\tconst artifacts: Record<string, ExactComponentExecutableArtifact> = {};\n\n\tfor (const component of components) {\n\t\tconst contract = readContract(component);\n\t\tif (!contract) continue;\n\t\tconst componentId = exactComponentIdentity(component);\n\t\tconst projectedRole =\n\t\t\tcontract.role ?? (contract.artifact.target === 'client' ? 'client' : 'render');\n\t\tif (projectedRole !== role)\n\t\t\tthrow new Error(\n\t\t\t\t`Expected eXact ${role} component contract for ${componentId}, received ${projectedRole}`\n\t\t\t);\n\t\tconst projectedImplementations = contract.implementations ?? [\n\t\t\t{\n\t\t\t\tid: componentId,\n\t\t\t\tname: component.name,\n\t\t\t\trole: 'root' as const,\n\t\t\t\timplementation: component\n\t\t\t}\n\t\t];\n\t\tfor (const implementation of projectedImplementations) {\n\t\t\taddUniqueImplementation(\n\t\t\t\timplementationsById,\n\t\t\t\timplementation.id,\n\t\t\t\timplementation.implementation\n\t\t\t);\n\t\t\taddUniqueImplementation(implementations, implementation.name, implementation.implementation);\n\t\t}\n\t\tfor (const continuation of contract.continuations ?? [])\n\t\t\taddUniqueJson(continuations, continuation.id, continuation, 'continuation');\n\t\tfor (const executor of contract.executors ?? []) addUniqueExecutor(executors, executor);\n\t\tfor (const boundary of contract.boundaries ?? [])\n\t\t\taddUniqueJson(boundaries, boundary.id, boundary, 'boundary');\n\t\tif (contract.resumption)\n\t\t\taddUniqueJson(\n\t\t\t\tresumptions,\n\t\t\t\tcontract.resumption.componentId,\n\t\t\t\tcontract.resumption,\n\t\t\t\t'resumption'\n\t\t\t);\n\t\tif (contract.execution)\n\t\t\taddUniqueJson(executions, componentId, contract.execution, 'execution plan');\n\t\tartifacts[componentId] = contract.artifact;\n\t}\n\n\treturn Object.freeze({\n\t\timplementations,\n\t\timplementationsById,\n\t\tcontinuations,\n\t\texecutors,\n\t\tboundaries,\n\t\tresumptions,\n\t\texecutions,\n\t\tartifacts\n\t});\n}\n"]}
+{"version":3,"file":"component-contracts.js","sourceRoot":"","sources":["../../src/component-contracts.ts"],"names":[],"mappings":"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","sourcesContent":["import { componentContractVersion } from './component/contract-versions.js';\nimport type { ContextToken } from './component/contracts.js';\nimport type { TaskContext } from './tasks/contracts.js';\nimport { validatedComponentContract } from './component-contract/contract-cache.js';\nimport {\n\taddUniqueExecutor,\n\taddUniqueImplementation,\n\taddUniqueJson\n} from './component-contract/composition-support.js';\nimport type { ExactComponentExecutableArtifact } from './component-abi/artifact.js';\nimport type { ExactClientComponentArtifact } from './component-abi/client.js';\nimport type { ExactServerComponentArtifact } from './component-abi/server.js';\nimport type {\n\tAnyExactComponentCallable,\n\tExactComponentReactiveAllocation\n} from './component-abi/executable-fields.js';\n\nexport type { ExactComponentExecutableArtifact } from './component-abi/artifact.js';\nexport type { ExactClientComponentArtifact } from './component-abi/client.js';\nexport type {\n\tExactServerComponentArtifact,\n\tExactServerComponentExecution\n} from './component-abi/server.js';\nexport type { AnyExactComponentCallable } from './component-abi/executable-fields.js';\nexport {\n\tdecodeExactValueWithSchema,\n\ttype ExactValueSerializationSchema\n} from './component-abi/value-serialization.js';\n\n/** Global property under which compiled artifacts carry their target-local contract. */\nexport const exactComponentContract = Symbol.for('@exactjs/component-contract');\n\n/** Global marker distinguishing a native eXact component from compatibility-owned functions. */\nexport const exactComponentType = Symbol.for('@exactjs/component');\n\n/** One executable implementation owned by a compiled component artifact. */\nexport type ExactComponentImplementationContract = Readonly<{\n\tid: string;\n\tname: string;\n\trole: 'root' | 'client-island' | 'server-part';\n\timplementation: AnyExactComponentCallable;\n}>;\n\n/** Runtime-neutral state path used by a generated continuation contract. */\nexport type ExactContinuationStatePathContract = Readonly<{\n\tpath: string;\n\tkind: 'read' | 'write';\n\tconfidence: 'exact' | 'broad' | 'unknown';\n\toperation?: 'value' | 'map' | 'set';\n}>;\n\n/** One ordered Map or Set mutation returned by a server continuation. */\nexport type ExactCollectionMutation =\n\t| Readonly<{ path: string; operation: 'map-set'; key: unknown; value: unknown }>\n\t| Readonly<{ path: string; operation: 'map-delete'; key: unknown }>\n\t| Readonly<{ path: string; operation: 'map-clear' }>\n\t| Readonly<{ path: string; operation: 'set-add'; value: unknown }>\n\t| Readonly<{ path: string; operation: 'set-delete'; value: unknown }>\n\t| Readonly<{ path: string; operation: 'set-clear' }>;\n\n/** Private operation contract attached to the component artifact that owns it. */\nexport type ExactComponentContinuationContract = Readonly<{\n\tid: string;\n\tkind: 'task';\n\tcomponentId: string;\n\treadiness: 'blocking' | 'nonblocking';\n\tconcurrency?: 'parallel' | 'latest' | 'queue';\n\t/** Compiler-owned progress receivers allowed for this operation. */\n\tprogress?: readonly Readonly<{ id: string; label: string }>[];\n\tdependencies: readonly Readonly<{\n\t\tindex?: number;\n\t\tsource: 'state' | 'props' | 'derived' | 'argument';\n\t\tpath?: string;\n\t}>[];\n\tinvocation?: Readonly<{\n\t\targuments: readonly Readonly<{ index?: number; source: 'argument'; path?: string }>[];\n\t\tconcurrency: 'parallel' | 'latest' | 'queue';\n\t}>;\n\tstateReads: readonly ExactContinuationStatePathContract[];\n\tstateWrites: readonly ExactContinuationStatePathContract[];\n\tpublicContexts: readonly string[];\n\tserverContexts: readonly string[];\n\tcontextWrites: readonly string[];\n\t/** Server-owned context mutations which never enter the client response. */\n\tserverContextWrites?: readonly string[];\n\tboundaries: readonly string[];\n}>;\n\n/** Serializable activation record accepted by one generated server continuation. */\nexport type ExactComponentContinuationActivation = Readonly<{\n\tstate: Record<string, unknown>;\n\tdependencies: readonly unknown[];\n\tpublicContext: Readonly<Record<string, unknown>>;\n\tgeneration?: number;\n}>;\n\n/** Trusted invocation resources available only while a server continuation executes. */\nexport type ExactComponentContinuationExecution = Readonly<{\n\ttask: TaskContext;\n\tsignal: AbortSignal;\n\tgetContext<T>(token: ContextToken<T>, authoredName?: string): T;\n\tsetContext<T>(token: ContextToken<T>, value: T, authoredName?: string): void;\n}>;\n\n/** State accumulated by a generated continuation before write-contract projection. */\nexport type ExactComponentContinuationExecutionResult = Readonly<{\n\tstate: Record<string, unknown>;\n\tcontexts?: Readonly<Record<string, unknown>>;\n\tvalue?: unknown;\n}>;\n\n/** Executable server half paired with one inert continuation descriptor. */\nexport type ExactComponentContinuationExecutorContract = Readonly<{\n\tid: string;\n\tcomponentId: string;\n\texecute(\n\t\tactivation: ExactComponentContinuationActivation,\n\t\texecution: ExactComponentContinuationExecution\n\t): ExactComponentContinuationExecutionResult | Promise<ExactComponentContinuationExecutionResult>;\n}>;\n\n/** One compiler-owned DOM boundary and its component ownership. */\nexport type ExactComponentBoundaryContract = Readonly<{\n\tid: string;\n\tcomponentId: string;\n\townerComponentId: string;\n\tkind: string;\n\tplanVersion?: number;\n\tbuildKey?: string;\n\tplanEdgeId?: string;\n\tparentPlanId?: string;\n\tfallbackPlanId?: string;\n\tpatchTargets?: readonly string[];\n\tdiscriminatorKind?: 'single' | 'branch' | 'keyed';\n\tdiscriminatorValues?: readonly string[];\n\tgeneration?: number;\n}>;\n\n/** Minimum browser-visible values required to resume one SSR component. */\nexport type ExactComponentResumptionContract = Readonly<{\n\tcomponentId: string;\n\tstatePaths: readonly string[];\n\t/** State path and root-prop path pairs that client setup can reconstruct. */\n\tstateInputs: readonly (readonly [statePath: string, propPath: string])[];\n\t/** Compact completion allowlist when a hydration artifact omits its execution catalog. */\n\tcontinuations?: readonly string[];\n\t/** Server-only primitive setup values that sparse capture may omit. */\n\tstateDefaults?: readonly (readonly [\n\t\tstatePath: string,\n\t\tvalue: string | number | boolean | null\n\t])[];\n\tvalueCaptures: readonly string[];\n\tcontexts: readonly string[];\n\tboundaries: readonly string[];\n}>;\n\n/** Compact target-local execution wiring emitted for one semantic component. */\nexport type ExactComponentExecutionContract = Readonly<{\n\tversion: 1;\n\t/** Port tuple: kind, authored path, direction. Its array position is its index. */\n\tports: readonly (readonly [\n\t\tkind: 'state' | 'props' | 'context' | 'derived' | 'argument',\n\t\tpath: string,\n\t\tdirection: 'input' | 'output' | 'inout'\n\t])[];\n\t/** Transition tuple: identity, task, activation, placement, readiness, concurrency, inputs, outputs. */\n\ttransitions: readonly (readonly [\n\t\tid: string,\n\t\ttaskId: string,\n\t\tactivation: 'setup' | 'interaction',\n\t\tplacement: 'client' | 'server' | 'isomorphic',\n\t\treadiness: 'blocking' | 'nonblocking',\n\t\tconcurrency: 'parallel' | 'latest' | 'queue',\n\t\tinputs: readonly number[],\n\t\toutputs: readonly number[]\n\t])[];\n\t/** Build-inspection inventory omitted from render-mode-projected runtime bundles. */\n\treactive?: readonly ExactComponentReactiveAllocation[];\n}>;\n\n/** One component-owned direct DOM update program shared by every instance of its definition. */\nexport type {\n\tExactCompiledComponentCapability,\n\tExactCompiledComponentInputUpdateContract,\n\tExactCompiledComponentUpdateContract,\n\tExactNarrowComponentUpdateContract,\n\tExactWideComponentUpdateContract\n} from './component-definition-contracts.js';\n\n/** Target-local executable contract attached to a public component root. */\nexport type ExactComponentContract = Readonly<{\n\t/** Target-discriminated component contract for this compiler/runtime generation. */\n\tversion: typeof componentContractVersion;\n\tplacement: 'client' | 'server' | 'isomorphic' | 'unknown';\n\trole: 'client' | 'render' | 'executor';\n\timplementations: readonly ExactComponentImplementationContract[];\n\tcontinuations: readonly ExactComponentContinuationContract[];\n\texecutors: readonly ExactComponentContinuationExecutorContract[];\n\tboundaries: readonly ExactComponentBoundaryContract[];\n\tresumption?: ExactComponentResumptionContract;\n\texecution?: ExactComponentExecutionContract;\n\tartifact: ExactComponentExecutableArtifact;\n}>;\n\n/** Build-projected runtime attachment after adapter-owned composition facts are erased. */\nexport type ExactPreparedComponentContract = Readonly<\n\tPick<ExactComponentContract, 'artifact'> & Partial<Omit<ExactComponentContract, 'artifact'>>\n>;\n\n/** Runtime attachment whose single executable artifact is guaranteed by the current target ABI. */\nexport type ExactExecutableComponentContract = ExactPreparedComponentContract;\n\n/** Prepared attachment whose target-local artifact is always executable. */\nexport type ExactPreparedExecutableComponentContract = ExactExecutableComponentContract;\n\n/** Current executable contract proven to carry the client target ABI. */\nexport type ExactClientExecutableComponentContract = ExactExecutableComponentContract &\n\tReadonly<{ artifact: ExactClientComponentArtifact }>;\n\n/** Current executable contract proven to carry the server target ABI. */\nexport type ExactServerExecutableComponentContract = ExactComponentContract &\n\tReadonly<{ artifact: ExactServerComponentArtifact }>;\n\n/** Composed target-local contracts indexed for runtime use. */\nexport type ExactComposedComponentContracts = Readonly<{\n\timplementations: Record<string, AnyExactComponentCallable>;\n\timplementationsById: Record<string, AnyExactComponentCallable>;\n\tcontinuations: Record<string, ExactComponentContinuationContract>;\n\texecutors: Record<string, ExactComponentContinuationExecutorContract>;\n\tboundaries: Record<string, ExactComponentBoundaryContract>;\n\tresumptions: Record<string, ExactComponentResumptionContract>;\n\texecutions: Record<string, ExactComponentExecutionContract>;\n\tartifacts: Record<string, ExactComponentExecutableArtifact>;\n}>;\n\ntype ContractComponent = AnyExactComponentCallable & {\n\t[exactComponentContract]?: ExactComponentContract;\n\t[exactComponentType]?: string;\n};\n\n/** Returns whether a callable carries a valid native eXact component identity. */\nexport function isExactComponent(component: unknown): component is AnyExactComponentCallable {\n\tif (typeof component !== 'function') return false;\n\tconst identity = (component as ContractComponent)[exactComponentType];\n\treturn typeof identity === 'string' && identity.length > 0;\n}\n\n/** Reads and validates compiler-attached metadata from one target-local component export. */\nexport function readExactComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactComponentContract | undefined {\n\tconst contract = (component as ContractComponent)[exactComponentContract];\n\tif (!contract) return undefined;\n\tconst componentId = exactComponentIdentity(component);\n\treturn validatedComponentContract(component, contract, componentId);\n}\n\n/** Reads one current executable target artifact and rejects obsolete or identity-only values. */\nexport function readExactExecutableComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactExecutableComponentContract {\n\tconst contract = readExactComponentContract(component);\n\tif (!contract?.artifact)\n\t\tthrow new TypeError('Native eXact component execution requires a compiled component artifact');\n\treturn contract;\n}\n\n/** Reads and validates one client-target executable component contract. */\nexport function readExactClientExecutableComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactClientExecutableComponentContract {\n\tconst contract = readExactExecutableComponentContract(component);\n\tif (contract.artifact.target !== 'client')\n\t\tthrow new TypeError('Client execution requires a current client component artifact');\n\treturn contract as ExactClientExecutableComponentContract;\n}\n\n/** Reads and validates one server-target executable component contract. */\nexport function readExactServerExecutableComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactServerExecutableComponentContract {\n\tconst contract = readExactExecutableComponentContract(component);\n\tif (contract.artifact.target !== 'server')\n\t\tthrow new TypeError('Server execution requires a current server component artifact');\n\treturn contract as ExactServerExecutableComponentContract;\n}\n\n/** Reads build-validated compiler metadata without repeating recursive runtime validation. */\nexport function readPreparedExactComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactPreparedComponentContract | undefined {\n\tconst contract = (component as ContractComponent)[exactComponentContract];\n\tif (contract && contract.artifact?.version !== componentContractVersion)\n\t\tthrow new TypeError(\n\t\t\t`Unsupported eXact component artifact version ${contract.artifact?.version}; expected ${componentContractVersion}. Recompile with the matching eXact compiler.`\n\t\t);\n\treturn contract;\n}\n\n/** Reads a build-validated current executable target artifact. */\nexport function readPreparedExactExecutableComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactPreparedExecutableComponentContract {\n\tconst contract = readPreparedExactComponentContract(component);\n\tif (!contract?.artifact)\n\t\tthrow new TypeError(\n\t\t\t`Native eXact component execution requires a compiled component artifact: ${component.name || '<anonymous>'}`\n\t\t);\n\treturn contract;\n}\n\n/** Reads one build-validated client-target executable component contract. */\nexport function readPreparedExactClientExecutableComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactPreparedComponentContract & Readonly<{ artifact: ExactClientComponentArtifact }> {\n\tconst contract = readPreparedExactExecutableComponentContract(component);\n\tif (contract.artifact.target !== 'client')\n\t\tthrow new TypeError('Client execution requires a current client component artifact');\n\treturn contract as ExactPreparedComponentContract &\n\t\tReadonly<{ artifact: ExactClientComponentArtifact }>;\n}\n\n/** Reads one build-validated server-target executable component contract. */\nexport function readPreparedExactServerExecutableComponentContract(\n\tcomponent: AnyExactComponentCallable\n): ExactServerExecutableComponentContract {\n\tconst contract = readPreparedExactExecutableComponentContract(component);\n\tif (contract.artifact.target !== 'server')\n\t\tthrow new TypeError('Server execution requires a current server component artifact');\n\treturn contract as ExactServerExecutableComponentContract;\n}\n\n/** Returns the stable compiler identity used to pair SSR and client component boundaries. */\nexport function exactComponentIdentity(component: AnyExactComponentCallable): string {\n\tconst identity = (component as ContractComponent)[exactComponentType];\n\tif (typeof identity === 'string' && identity) return identity;\n\tthrow new Error('Native eXact components require compiler-owned identity');\n}\n\n/** Composes reachable imported component contracts into duplicate-checked runtime indexes. */\nexport function composeExactComponentContracts(\n\tcomponents: readonly AnyExactComponentCallable[],\n\trole: ExactComponentContract['role']\n): ExactComposedComponentContracts {\n\treturn composeComponentContracts(components, role, readExactComponentContract);\n}\n\n/** Composes build-validated compiler metadata without repeating recursive validation. */\nexport function composePreparedExactComponentContracts(\n\tcomponents: readonly AnyExactComponentCallable[],\n\trole: ExactComponentContract['role']\n): ExactComposedComponentContracts {\n\treturn composeComponentContracts(components, role, readPreparedExactComponentContract);\n}\n\nfunction composeComponentContracts(\n\tcomponents: readonly AnyExactComponentCallable[],\n\trole: ExactComponentContract['role'],\n\treadContract: (component: AnyExactComponentCallable) => ExactPreparedComponentContract | undefined\n): ExactComposedComponentContracts {\n\tconst implementations: Record<string, AnyExactComponentCallable> = {};\n\tconst implementationsById: Record<string, AnyExactComponentCallable> = {};\n\tconst continuations: Record<string, ExactComponentContinuationContract> = {};\n\tconst executors: Record<string, ExactComponentContinuationExecutorContract> = {};\n\tconst boundaries: Record<string, ExactComponentBoundaryContract> = {};\n\tconst resumptions: Record<string, ExactComponentResumptionContract> = {};\n\tconst executions: Record<string, ExactComponentExecutionContract> = {};\n\tconst artifacts: Record<string, ExactComponentExecutableArtifact> = {};\n\n\tfor (const component of components) {\n\t\tconst contract = readContract(component);\n\t\tif (!contract) continue;\n\t\tconst componentId = exactComponentIdentity(component);\n\t\tconst projectedRole =\n\t\t\tcontract.role ?? (contract.artifact.target === 'client' ? 'client' : 'render');\n\t\tif (projectedRole !== role)\n\t\t\tthrow new Error(\n\t\t\t\t`Expected eXact ${role} component contract for ${componentId}, received ${projectedRole}`\n\t\t\t);\n\t\tconst projectedImplementations = contract.implementations ?? [\n\t\t\t{\n\t\t\t\tid: componentId,\n\t\t\t\tname: component.name,\n\t\t\t\trole: 'root' as const,\n\t\t\t\timplementation: component\n\t\t\t}\n\t\t];\n\t\tfor (const implementation of projectedImplementations) {\n\t\t\taddUniqueImplementation(\n\t\t\t\timplementationsById,\n\t\t\t\timplementation.id,\n\t\t\t\timplementation.implementation\n\t\t\t);\n\t\t\taddUniqueImplementation(implementations, implementation.name, implementation.implementation);\n\t\t}\n\t\tfor (const continuation of contract.continuations ?? [])\n\t\t\taddUniqueJson(continuations, continuation.id, continuation, 'continuation');\n\t\tfor (const executor of contract.executors ?? []) addUniqueExecutor(executors, executor);\n\t\tfor (const boundary of contract.boundaries ?? [])\n\t\t\taddUniqueJson(boundaries, boundary.id, boundary, 'boundary');\n\t\tif (contract.resumption)\n\t\t\taddUniqueJson(\n\t\t\t\tresumptions,\n\t\t\t\tcontract.resumption.componentId,\n\t\t\t\tcontract.resumption,\n\t\t\t\t'resumption'\n\t\t\t);\n\t\tif (contract.execution)\n\t\t\taddUniqueJson(executions, componentId, contract.execution, 'execution plan');\n\t\tartifacts[componentId] = contract.artifact;\n\t}\n\n\treturn Object.freeze({\n\t\timplementations,\n\t\timplementationsById,\n\t\tcontinuations,\n\t\texecutors,\n\t\tboundaries,\n\t\tresumptions,\n\t\texecutions,\n\t\tartifacts\n\t});\n}\n"]}

package/dist/server/framework/component-contract-validation.d.ts

@@ -1,2 +1,2 @@
-export { isExactContinuationDependency, isExactContinuationInvocation, isExactContinuationStatePath } from '../component-contract/continuation-validation.js';
+export { isExactProgressReceiver, isExactContinuationDependency, isExactContinuationInvocation, isExactContinuationStatePath } from '../component-contract/continuation-validation.js';
 //# sourceMappingURL=component-contract-validation.d.ts.map

package/dist/server/framework/component-contract-validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-contract-validation.d.ts","sourceRoot":"","sources":["../../../src/framework/component-contract-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,MAAM,kDAAkD,CAAC"}
+{"version":3,"file":"component-contract-validation.d.ts","sourceRoot":"","sources":["../../../src/framework/component-contract-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,uBAAuB,EACvB,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,MAAM,kDAAkD,CAAC"}

package/dist/server/framework/component-contract-validation.js

@@ -1,2 +1,2 @@
-export { isExactContinuationDependency, isExactContinuationInvocation, isExactContinuationStatePath } from '../component-contract/continuation-validation.js';
+export { isExactProgressReceiver, isExactContinuationDependency, isExactContinuationInvocation, isExactContinuationStatePath } from '../component-contract/continuation-validation.js';
 //# sourceMappingURL=component-contract-validation.js.map

package/dist/server/framework/component-contract-validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"component-contract-validation.js","sourceRoot":"","sources":["../../../src/framework/component-contract-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,MAAM,kDAAkD,CAAC","sourcesContent":["export {\n\tisExactContinuationDependency,\n\tisExactContinuationInvocation,\n\tisExactContinuationStatePath\n} from '../component-contract/continuation-validation.js';\n"]}
+{"version":3,"file":"component-contract-validation.js","sourceRoot":"","sources":["../../../src/framework/component-contract-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,uBAAuB,EACvB,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,MAAM,kDAAkD,CAAC","sourcesContent":["export {\n\tisExactProgressReceiver,\n\tisExactContinuationDependency,\n\tisExactContinuationInvocation,\n\tisExactContinuationStatePath\n} from '../component-contract/continuation-validation.js';\n"]}

package/dist/server/framework/fragment-target-projection-plan.d.ts

@@ -0,0 +1,9 @@
+import type { AnyComponentInstance, Child } from '../component/contracts.js';
+/**
+ * Projects only one enhancement owner's supplied placement, preserving its authored structure.
+ * Nested component implementations stay opaque. Each owner is a host-coalescing barrier; transparent
+ * consecutive owners are grouped before this path. The caller supplies range evaluation: clients
+ * retain invalidation, while servers resolve the current render attempt without subscriptions.
+ */
+export declare function createFragmentTargetProjectionWithRanges(supplied: Child | (() => Child), tag: string, owner: AnyComponentInstance | undefined, projectRange: (read: () => Child, markerId?: string, mayReplaceSubtree?: boolean) => Child): (children: readonly Child[]) => Child[];
+//# sourceMappingURL=fragment-target-projection-plan.d.ts.map

package/dist/server/framework/fragment-target-projection-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment-target-projection-plan.d.ts","sourceRoot":"","sources":["../../../src/framework/fragment-target-projection-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AA6B7E;;;;;GAKG;AACH,wBAAgB,wCAAwC,CACvD,QAAQ,EAAE,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,oBAAoB,GAAG,SAAS,EACvC,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,OAAO,KAAK,KAAK,GACxF,CAAC,QAAQ,EAAE,SAAS,KAAK,EAAE,KAAK,KAAK,EAAE,CAmGzC"}

package/dist/server/framework/fragment-target-projection-plan.js

@@ -0,0 +1,99 @@
+import { unwrap } from '@exactjs/reactive/framework/values';
+import { readCompiledTargetReceipt, createCompiledTargetReceipt } from '../component-abi/target-receipt.js';
+import { readCompiledIntrinsicReceipt, withIntrinsicReceiptChildren } from '../component-abi/intrinsic-receipt.js';
+import { readCompiledFragmentReceipt, createCompiledFragmentReceipt, createCompiledFragmentPresentation } from '../component-abi/fragment-receipt.js';
+import { readChildRangeReceipt } from '../component-abi/child-range-receipt.js';
+import { readPreparedServerChildRange, createPreparedServerChildRange } from '../component-abi/server-child-range.js';
+import { readPreparedServerRenderProgram } from '../server-render-program.js';
+import { readRenderProgramReceipt, createPreparedRenderProgram, readRenderProgramSlot } from '../render-program.js';
+import { readPreparedTargetOutput } from './prepared-target-output.js';
+import { FragmentPresentationHosts } from './fragment-hosts.js';
+/**
+ * Projects only one enhancement owner's supplied placement, preserving its authored structure.
+ * Nested component implementations stay opaque. Each owner is a host-coalescing barrier; transparent
+ * consecutive owners are grouped before this path. The caller supplies range evaluation: clients
+ * retain invalidation, while servers resolve the current render attempt without subscriptions.
+ */
+export function createFragmentTargetProjectionWithRanges(supplied, tag, owner, projectRange) {
+    const identity = Symbol('fragment contribution');
+    const hosts = new FragmentPresentationHosts();
+    const cache = new WeakMap();
+    const map = (raw) => {
+        const selected = typeof supplied === 'function' ? supplied() : supplied;
+        if (raw === selected)
+            return raw;
+        const value = unwrap(raw);
+        if (value === selected)
+            return value;
+        if (Array.isArray(value))
+            return value.map(map);
+        if (typeof value !== 'object' || value === null)
+            return value;
+        const retained = cache.get(value);
+        if (retained !== undefined)
+            return retained;
+        const target = readCompiledTargetReceipt(value);
+        let result = value;
+        if (target) {
+            const contribution = readPreparedTargetOutput([value], selected);
+            const presentation = createCompiledFragmentPresentation(selected, hosts
+                .reconcile([
+                {
+                    owner: identity,
+                    tag,
+                    props: contribution.props,
+                    declaredHostProps: contribution.declaredHostProps
+                }
+            ])
+                .map((host) => ({
+                identity: host.identity,
+                tag: host.tag,
+                contributions: [{ identity, props: contribution.props, owner }]
+            })));
+            result = createCompiledTargetReceipt(null, presentation);
+        }
+        else {
+            const intrinsic = readCompiledIntrinsicReceipt(value);
+            const fragment = readCompiledFragmentReceipt(value);
+            const range = readChildRangeReceipt(value);
+            const serverRange = readPreparedServerChildRange(value);
+            const program = readRenderProgramReceipt(value);
+            const serverProgram = readPreparedServerRenderProgram(value);
+            if (intrinsic)
+                result = withIntrinsicReceiptChildren(value, intrinsic.children.map((child) => map(child)));
+            else if (fragment)
+                result = createCompiledFragmentReceipt({ ...fragment.props, key: fragment.key, __exactEnhancements: fragment.enhancement }, ...fragment.children.map(map));
+            else if (range && !range.dynamicComponent)
+                result = projectRange(() => map(range.value), range.markerId, range.mayReplaceSubtree);
+            else if (serverRange)
+                result = createPreparedServerChildRange(map(serverRange.value), serverRange.markerId, serverRange.mayReplaceSubtree);
+            else if (program) {
+                const invocation = program.invocation;
+                const slots = new Set(invocation.program.targetSlots ?? []);
+                result = createPreparedRenderProgram(invocation.program, (index) => slots.has(index)
+                    ? map(readRenderProgramSlot(invocation, index))
+                    : readRenderProgramSlot(invocation, index), invocation.owner, invocation.propertyWriter, program.enhancement);
+            }
+            else if (serverProgram) {
+                const slots = new Set(serverProgram.program.targetSlots ?? []);
+                const values = (input) => input.map((entry, index) => (slots.has(index) ? map(entry) : entry));
+                result = {
+                    ...serverProgram,
+                    eagerValues: values(serverProgram.eagerValues),
+                    ...(serverProgram.deferredValues
+                        ? {
+                            deferredValues: {
+                                ...serverProgram.deferredValues,
+                                read: () => values(serverProgram.deferredValues.read())
+                            }
+                        }
+                        : {})
+                };
+            }
+        }
+        cache.set(value, result);
+        return result;
+    };
+    return (children) => children.map((child) => map(child));
+}
+//# sourceMappingURL=fragment-target-projection-plan.js.map

package/dist/server/framework/fragment-target-projection-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragment-target-projection-plan.js","sourceRoot":"","sources":["../../../src/framework/fragment-target-projection-plan.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnyComponentInstance, Child } from '../component/contracts.js';\nimport { unwrap } from '@exactjs/reactive/framework/values';\nimport {\n\treadCompiledTargetReceipt,\n\tcreateCompiledTargetReceipt\n} from '../component-abi/target-receipt.js';\nimport {\n\treadCompiledIntrinsicReceipt,\n\twithIntrinsicReceiptChildren\n} from '../component-abi/intrinsic-receipt.js';\nimport {\n\treadCompiledFragmentReceipt,\n\tcreateCompiledFragmentReceipt,\n\tcreateCompiledFragmentPresentation\n} from '../component-abi/fragment-receipt.js';\nimport { readChildRangeReceipt } from '../component-abi/child-range-receipt.js';\nimport {\n\treadPreparedServerChildRange,\n\tcreatePreparedServerChildRange\n} from '../component-abi/server-child-range.js';\nimport { readPreparedServerRenderProgram } from '../server-render-program.js';\nimport {\n\treadRenderProgramReceipt,\n\tcreatePreparedRenderProgram,\n\treadRenderProgramSlot\n} from '../render-program.js';\nimport { readPreparedTargetOutput } from './prepared-target-output.js';\nimport { FragmentPresentationHosts } from './fragment-hosts.js';\n\n/**\n * Projects only one enhancement owner's supplied placement, preserving its authored structure.\n * Nested component implementations stay opaque. Each owner is a host-coalescing barrier; transparent\n * consecutive owners are grouped before this path. The caller supplies range evaluation: clients\n * retain invalidation, while servers resolve the current render attempt without subscriptions.\n */\nexport function createFragmentTargetProjectionWithRanges(\n\tsupplied: Child | (() => Child),\n\ttag: string,\n\towner: AnyComponentInstance | undefined,\n\tprojectRange: (read: () => Child, markerId?: string, mayReplaceSubtree?: boolean) => Child\n): (children: readonly Child[]) => Child[] {\n\tconst identity = Symbol('fragment contribution');\n\tconst hosts = new FragmentPresentationHosts();\n\tconst cache = new WeakMap<object, Child>();\n\tconst map = (raw: unknown): unknown => {\n\t\tconst selected = typeof supplied === 'function' ? supplied() : supplied;\n\t\tif (raw === selected) return raw;\n\t\tconst value = unwrap(raw);\n\t\tif (value === selected) return value;\n\t\tif (Array.isArray(value)) return value.map(map);\n\t\tif (typeof value !== 'object' || value === null) return value;\n\t\tconst retained = cache.get(value);\n\t\tif (retained !== undefined) return retained;\n\t\tconst target = readCompiledTargetReceipt(value);\n\t\tlet result: unknown = value;\n\t\tif (target) {\n\t\t\tconst contribution = readPreparedTargetOutput([value as Child], selected)!;\n\t\t\tconst presentation = createCompiledFragmentPresentation(\n\t\t\t\tselected,\n\t\t\t\thosts\n\t\t\t\t\t.reconcile([\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\towner: identity,\n\t\t\t\t\t\t\ttag,\n\t\t\t\t\t\t\tprops: contribution.props,\n\t\t\t\t\t\t\tdeclaredHostProps: contribution.declaredHostProps\n\t\t\t\t\t\t}\n\t\t\t\t\t])\n\t\t\t\t\t.map((host) => ({\n\t\t\t\t\t\tidentity: host.identity,\n\t\t\t\t\t\ttag: host.tag,\n\t\t\t\t\t\tcontributions: [{ identity, props: contribution.props, owner }]\n\t\t\t\t\t}))\n\t\t\t);\n\t\t\tresult = createCompiledTargetReceipt(null, presentation);\n\t\t} else {\n\t\t\tconst intrinsic = readCompiledIntrinsicReceipt(value);\n\t\t\tconst fragment = readCompiledFragmentReceipt(value);\n\t\t\tconst range = readChildRangeReceipt(value);\n\t\t\tconst serverRange = readPreparedServerChildRange(value);\n\t\t\tconst program = readRenderProgramReceipt(value);\n\t\t\tconst serverProgram = readPreparedServerRenderProgram(value);\n\t\t\tif (intrinsic)\n\t\t\t\tresult = withIntrinsicReceiptChildren(\n\t\t\t\t\tvalue,\n\t\t\t\t\tintrinsic.children.map((child) => map(child) as Child)\n\t\t\t\t);\n\t\t\telse if (fragment)\n\t\t\t\tresult = createCompiledFragmentReceipt(\n\t\t\t\t\t{ ...fragment.props, key: fragment.key, __exactEnhancements: fragment.enhancement },\n\t\t\t\t\t...fragment.children.map(map)\n\t\t\t\t);\n\t\t\telse if (range && !range.dynamicComponent)\n\t\t\t\tresult = projectRange(\n\t\t\t\t\t() => map(range.value) as Child,\n\t\t\t\t\trange.markerId,\n\t\t\t\t\trange.mayReplaceSubtree\n\t\t\t\t);\n\t\t\telse if (serverRange)\n\t\t\t\tresult = createPreparedServerChildRange(\n\t\t\t\t\tmap(serverRange.value) as Child,\n\t\t\t\t\tserverRange.markerId,\n\t\t\t\t\tserverRange.mayReplaceSubtree\n\t\t\t\t);\n\t\t\telse if (program) {\n\t\t\t\tconst invocation = program.invocation;\n\t\t\t\tconst slots = new Set(invocation.program.targetSlots ?? []);\n\t\t\t\tresult = createPreparedRenderProgram(\n\t\t\t\t\tinvocation.program,\n\t\t\t\t\t(index) =>\n\t\t\t\t\t\tslots.has(index)\n\t\t\t\t\t\t\t? map(readRenderProgramSlot(invocation, index))\n\t\t\t\t\t\t\t: readRenderProgramSlot(invocation, index),\n\t\t\t\t\tinvocation.owner,\n\t\t\t\t\tinvocation.propertyWriter,\n\t\t\t\t\tprogram.enhancement\n\t\t\t\t);\n\t\t\t} else if (serverProgram) {\n\t\t\t\tconst slots = new Set(serverProgram.program.targetSlots ?? []);\n\t\t\t\tconst values = (input: readonly unknown[]) =>\n\t\t\t\t\tinput.map((entry, index) => (slots.has(index) ? map(entry) : entry));\n\t\t\t\tresult = {\n\t\t\t\t\t...serverProgram,\n\t\t\t\t\teagerValues: values(serverProgram.eagerValues),\n\t\t\t\t\t...(serverProgram.deferredValues\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\tdeferredValues: {\n\t\t\t\t\t\t\t\t\t...serverProgram.deferredValues,\n\t\t\t\t\t\t\t\t\tread: () => values(serverProgram.deferredValues!.read())\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: {})\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\t\tcache.set(value, result as Child);\n\t\treturn result;\n\t};\n\treturn (children) => children.map((child) => map(child) as Child);\n}\n"]}

package/dist/server/framework/fragment-target-projection.d.ts

@@ -1,8 +1,4 @@
 import type { AnyComponentInstance, Child } from '../component/contracts.js';
-/**
- * Projects only one enhancement owner's supplied placement, preserving its authored structure.
- * Nested component implementations stay opaque. Each owner is a host-coalescing barrier; transparent
- * consecutive owners are grouped before this path. Reactive ranges retain their existing invalidation.
- */
+/** Projects fragment targets while retaining client range subscriptions and ownership. */
 export declare function createFragmentTargetProjection(supplied: Child | (() => Child), tag: string, owner?: AnyComponentInstance): (children: readonly Child[]) => Child[];
 //# sourceMappingURL=fragment-target-projection.d.ts.map

package/dist/server/framework/fragment-target-projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fragment-target-projection.d.ts","sourceRoot":"","sources":["../../../src/framework/fragment-target-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAgC7E;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC7C,QAAQ,EAAE,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,oBAAoB,GAC1B,CAAC,QAAQ,EAAE,SAAS,KAAK,EAAE,KAAK,KAAK,EAAE,CAmGzC"}
+{"version":3,"file":"fragment-target-projection.d.ts","sourceRoot":"","sources":["../../../src/framework/fragment-target-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAK7E,0FAA0F;AAC1F,wBAAgB,8BAA8B,CAC7C,QAAQ,EAAE,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,oBAAoB,GAC1B,CAAC,QAAQ,EAAE,SAAS,KAAK,EAAE,KAAK,KAAK,EAAE,CAQzC"}

package/dist/server/framework/fragment-target-projection.js

@@ -1,98 +1,8 @@
-import { computed, unwrap } from '@exactjs/reactive/framework/runtime';
-import { readCompiledTargetReceipt, createCompiledTargetReceipt } from '../component-abi/target-receipt.js';
-import { readCompiledIntrinsicReceipt, withIntrinsicReceiptChildren } from '../component-abi/intrinsic-receipt.js';
-import { readCompiledFragmentReceipt, createCompiledFragmentReceipt, createCompiledFragmentPresentation } from '../component-abi/fragment-receipt.js';
-import { readChildRangeReceipt, createChildRangeReceipt } from '../component-abi/child-range-receipt.js';
-import { readPreparedServerChildRange, createPreparedServerChildRange } from '../component-abi/server-child-range.js';
-import { readPreparedServerRenderProgram } from '../server-render-program.js';
-import { readRenderProgramReceipt, createPreparedRenderProgram, readRenderProgramSlot } from '../render-program.js';
-import { readPreparedTargetOutput } from './prepared-target-output.js';
-import { FragmentPresentationHosts } from './fragment-hosts.js';
-/**
- * Projects only one enhancement owner's supplied placement, preserving its authored structure.
- * Nested component implementations stay opaque. Each owner is a host-coalescing barrier; transparent
- * consecutive owners are grouped before this path. Reactive ranges retain their existing invalidation.
- */
+import { computed } from '@exactjs/reactive/framework/runtime';
+import { createChildRangeReceipt } from '../component-abi/child-range-receipt.js';
+import { createFragmentTargetProjectionWithRanges } from './fragment-target-projection-plan.js';
+/** Projects fragment targets while retaining client range subscriptions and ownership. */
 export function createFragmentTargetProjection(supplied, tag, owner) {
-    const identity = Symbol('fragment contribution');
-    const hosts = new FragmentPresentationHosts();
-    const cache = new WeakMap();
-    const map = (raw) => {
-        const selected = typeof supplied === 'function' ? supplied() : supplied;
-        if (raw === selected)
-            return raw;
-        const value = unwrap(raw);
-        if (value === selected)
-            return value;
-        if (Array.isArray(value))
-            return value.map(map);
-        if (typeof value !== 'object' || value === null)
-            return value;
-        const retained = cache.get(value);
-        if (retained !== undefined)
-            return retained;
-        const target = readCompiledTargetReceipt(value);
-        let result = value;
-        if (target) {
-            const contribution = readPreparedTargetOutput([value], selected);
-            const presentation = createCompiledFragmentPresentation(selected, hosts
-                .reconcile([
-                {
-                    owner: identity,
-                    tag,
-                    props: contribution.props,
-                    declaredHostProps: contribution.declaredHostProps
-                }
-            ])
-                .map((host) => ({
-                identity: host.identity,
-                tag: host.tag,
-                contributions: [{ identity, props: contribution.props, owner }]
-            })));
-            result = createCompiledTargetReceipt(null, presentation);
-        }
-        else {
-            const intrinsic = readCompiledIntrinsicReceipt(value);
-            const fragment = readCompiledFragmentReceipt(value);
-            const range = readChildRangeReceipt(value);
-            const serverRange = readPreparedServerChildRange(value);
-            const program = readRenderProgramReceipt(value);
-            const serverProgram = readPreparedServerRenderProgram(value);
-            if (intrinsic)
-                result = withIntrinsicReceiptChildren(value, intrinsic.children.map((child) => map(child)));
-            else if (fragment)
-                result = createCompiledFragmentReceipt({ ...fragment.props, key: fragment.key, __exactEnhancements: fragment.enhancement }, ...fragment.children.map(map));
-            else if (range && !range.dynamicComponent)
-                result = createChildRangeReceipt(computed(() => map(range.value)), range.markerId, range.mayReplaceSubtree);
-            else if (serverRange)
-                result = createPreparedServerChildRange(map(serverRange.value), serverRange.markerId, serverRange.mayReplaceSubtree);
-            else if (program) {
-                const invocation = program.invocation;
-                const slots = new Set(invocation.program.targetSlots ?? []);
-                result = createPreparedRenderProgram(invocation.program, (index) => slots.has(index)
-                    ? map(readRenderProgramSlot(invocation, index))
-                    : readRenderProgramSlot(invocation, index), invocation.owner, invocation.propertyWriter, program.enhancement);
-            }
-            else if (serverProgram) {
-                const slots = new Set(serverProgram.program.targetSlots ?? []);
-                const values = (input) => input.map((entry, index) => (slots.has(index) ? map(entry) : entry));
-                result = {
-                    ...serverProgram,
-                    eagerValues: values(serverProgram.eagerValues),
-                    ...(serverProgram.deferredValues
-                        ? {
-                            deferredValues: {
-                                ...serverProgram.deferredValues,
-                                read: () => values(serverProgram.deferredValues.read())
-                            }
-                        }
-                        : {})
-                };
-            }
-        }
-        cache.set(value, result);
-        return result;
-    };
-    return (children) => children.map((child) => map(child));
+    return createFragmentTargetProjectionWithRanges(supplied, tag, owner, (read, markerId, mayReplaceSubtree) => createChildRangeReceipt(computed(read), markerId, mayReplaceSubtree));
 }
 //# sourceMappingURL=fragment-target-projection.js.map

package/dist/server/framework/fragment-target-projection.js.map

@@ -1 +1 @@
-{"version":3,"file":"fragment-target-projection.js","sourceRoot":"","sources":["../../../src/framework/fragment-target-projection.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnyComponentInstance, Child } from '../component/contracts.js';\nimport { computed, unwrap } from '@exactjs/reactive/framework/runtime';\nimport {\n\treadCompiledTargetReceipt,\n\tcreateCompiledTargetReceipt\n} from '../component-abi/target-receipt.js';\nimport {\n\treadCompiledIntrinsicReceipt,\n\twithIntrinsicReceiptChildren\n} from '../component-abi/intrinsic-receipt.js';\nimport {\n\treadCompiledFragmentReceipt,\n\tcreateCompiledFragmentReceipt,\n\tcreateCompiledFragmentPresentation\n} from '../component-abi/fragment-receipt.js';\nimport {\n\treadChildRangeReceipt,\n\tcreateChildRangeReceipt\n} from '../component-abi/child-range-receipt.js';\nimport {\n\treadPreparedServerChildRange,\n\tcreatePreparedServerChildRange\n} from '../component-abi/server-child-range.js';\nimport { readPreparedServerRenderProgram } from '../server-render-program.js';\nimport {\n\treadRenderProgramReceipt,\n\tcreatePreparedRenderProgram,\n\treadRenderProgramSlot\n} from '../render-program.js';\nimport { readPreparedTargetOutput } from './prepared-target-output.js';\nimport { FragmentPresentationHosts } from './fragment-hosts.js';\n\n/**\n * Projects only one enhancement owner's supplied placement, preserving its authored structure.\n * Nested component implementations stay opaque. Each owner is a host-coalescing barrier; transparent\n * consecutive owners are grouped before this path. Reactive ranges retain their existing invalidation.\n */\nexport function createFragmentTargetProjection(\n\tsupplied: Child | (() => Child),\n\ttag: string,\n\towner?: AnyComponentInstance\n): (children: readonly Child[]) => Child[] {\n\tconst identity = Symbol('fragment contribution');\n\tconst hosts = new FragmentPresentationHosts();\n\tconst cache = new WeakMap<object, Child>();\n\tconst map = (raw: unknown): unknown => {\n\t\tconst selected = typeof supplied === 'function' ? supplied() : supplied;\n\t\tif (raw === selected) return raw;\n\t\tconst value = unwrap(raw);\n\t\tif (value === selected) return value;\n\t\tif (Array.isArray(value)) return value.map(map);\n\t\tif (typeof value !== 'object' || value === null) return value;\n\t\tconst retained = cache.get(value);\n\t\tif (retained !== undefined) return retained;\n\t\tconst target = readCompiledTargetReceipt(value);\n\t\tlet result: unknown = value;\n\t\tif (target) {\n\t\t\tconst contribution = readPreparedTargetOutput([value as Child], selected)!;\n\t\t\tconst presentation = createCompiledFragmentPresentation(\n\t\t\t\tselected,\n\t\t\t\thosts\n\t\t\t\t\t.reconcile([\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\towner: identity,\n\t\t\t\t\t\t\ttag,\n\t\t\t\t\t\t\tprops: contribution.props,\n\t\t\t\t\t\t\tdeclaredHostProps: contribution.declaredHostProps\n\t\t\t\t\t\t}\n\t\t\t\t\t])\n\t\t\t\t\t.map((host) => ({\n\t\t\t\t\t\tidentity: host.identity,\n\t\t\t\t\t\ttag: host.tag,\n\t\t\t\t\t\tcontributions: [{ identity, props: contribution.props, owner }]\n\t\t\t\t\t}))\n\t\t\t);\n\t\t\tresult = createCompiledTargetReceipt(null, presentation);\n\t\t} else {\n\t\t\tconst intrinsic = readCompiledIntrinsicReceipt(value);\n\t\t\tconst fragment = readCompiledFragmentReceipt(value);\n\t\t\tconst range = readChildRangeReceipt(value);\n\t\t\tconst serverRange = readPreparedServerChildRange(value);\n\t\t\tconst program = readRenderProgramReceipt(value);\n\t\t\tconst serverProgram = readPreparedServerRenderProgram(value);\n\t\t\tif (intrinsic)\n\t\t\t\tresult = withIntrinsicReceiptChildren(\n\t\t\t\t\tvalue,\n\t\t\t\t\tintrinsic.children.map((child) => map(child) as Child)\n\t\t\t\t);\n\t\t\telse if (fragment)\n\t\t\t\tresult = createCompiledFragmentReceipt(\n\t\t\t\t\t{ ...fragment.props, key: fragment.key, __exactEnhancements: fragment.enhancement },\n\t\t\t\t\t...fragment.children.map(map)\n\t\t\t\t);\n\t\t\telse if (range && !range.dynamicComponent)\n\t\t\t\tresult = createChildRangeReceipt(\n\t\t\t\t\tcomputed(() => map(range.value)),\n\t\t\t\t\trange.markerId,\n\t\t\t\t\trange.mayReplaceSubtree\n\t\t\t\t);\n\t\t\telse if (serverRange)\n\t\t\t\tresult = createPreparedServerChildRange(\n\t\t\t\t\tmap(serverRange.value) as Child,\n\t\t\t\t\tserverRange.markerId,\n\t\t\t\t\tserverRange.mayReplaceSubtree\n\t\t\t\t);\n\t\t\telse if (program) {\n\t\t\t\tconst invocation = program.invocation;\n\t\t\t\tconst slots = new Set(invocation.program.targetSlots ?? []);\n\t\t\t\tresult = createPreparedRenderProgram(\n\t\t\t\t\tinvocation.program,\n\t\t\t\t\t(index) =>\n\t\t\t\t\t\tslots.has(index)\n\t\t\t\t\t\t\t? map(readRenderProgramSlot(invocation, index))\n\t\t\t\t\t\t\t: readRenderProgramSlot(invocation, index),\n\t\t\t\t\tinvocation.owner,\n\t\t\t\t\tinvocation.propertyWriter,\n\t\t\t\t\tprogram.enhancement\n\t\t\t\t);\n\t\t\t} else if (serverProgram) {\n\t\t\t\tconst slots = new Set(serverProgram.program.targetSlots ?? []);\n\t\t\t\tconst values = (input: readonly unknown[]) =>\n\t\t\t\t\tinput.map((entry, index) => (slots.has(index) ? map(entry) : entry));\n\t\t\t\tresult = {\n\t\t\t\t\t...serverProgram,\n\t\t\t\t\teagerValues: values(serverProgram.eagerValues),\n\t\t\t\t\t...(serverProgram.deferredValues\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\tdeferredValues: {\n\t\t\t\t\t\t\t\t\t...serverProgram.deferredValues,\n\t\t\t\t\t\t\t\t\tread: () => values(serverProgram.deferredValues!.read())\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: {})\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\t\tcache.set(value, result as Child);\n\t\treturn result;\n\t};\n\treturn (children) => children.map((child) => map(child) as Child);\n}\n"]}
+{"version":3,"file":"fragment-target-projection.js","sourceRoot":"","sources":["../../../src/framework/fragment-target-projection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,EAAE,wCAAwC,EAAE,MAAM,sCAAsC,CAAC;AAEhG,0FAA0F;AAC1F,MAAM,UAAU,8BAA8B,CAC7C,QAA+B,EAC/B,GAAW,EACX,KAA4B;IAE5B,OAAO,wCAAwC,CAC9C,QAAQ,EACR,GAAG,EACH,KAAK,EACL,CAAC,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,EAAE,CACrC,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CACrE,CAAC;AACH,CAAC","sourcesContent":["import type { AnyComponentInstance, Child } from '../component/contracts.js';\nimport { computed } from '@exactjs/reactive/framework/runtime';\nimport { createChildRangeReceipt } from '../component-abi/child-range-receipt.js';\nimport { createFragmentTargetProjectionWithRanges } from './fragment-target-projection-plan.js';\n\n/** Projects fragment targets while retaining client range subscriptions and ownership. */\nexport function createFragmentTargetProjection(\n\tsupplied: Child | (() => Child),\n\ttag: string,\n\towner?: AnyComponentInstance\n): (children: readonly Child[]) => Child[] {\n\treturn createFragmentTargetProjectionWithRanges(\n\t\tsupplied,\n\t\ttag,\n\t\towner,\n\t\t(read, markerId, mayReplaceSubtree) =>\n\t\t\tcreateChildRangeReceipt(computed(read), markerId, mayReplaceSubtree)\n\t);\n}\n"]}

package/dist/server/framework/operation-protocol.d.ts

@@ -83,6 +83,15 @@ export type ExactBatchResult = {
 };
 /** Reports one event in an incremental operation response. */
 export type ExactStreamEvent = {
+    event: 'progress';
+    version: 1;
+    index: number;
+    type: ExactInvocationKind;
+    id: string;
+    opId?: string;
+    receiver: string;
+    snapshot: unknown;
+} | {
     event: 'start';
     version: 1;
     operations: number;

package/dist/server/framework/operation-protocol.d.ts.map

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

package/dist/server/framework/operation-protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"operation-protocol.js","sourceRoot":"","sources":["../../../src/framework/operation-protocol.ts"],"names":[],"mappings":"AAoJA,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC;IAC3C,WAAW;IACX,aAAa;IACb,yBAAyB;IACzB,WAAW;IACX,WAAW;IACX,WAAW;IACX,WAAW;IACX,WAAW;IACX,QAAQ;IACR,aAAa;CACb,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,CACN,CAAC,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAAC,UAAU,CAAC,CAC5F,CAAC;AACH,CAAC","sourcesContent":["import type { ExactCollectionMutation } from '../component-contracts.js';\nimport type { ExactRuntimeInspectionEvent } from '@exactjs/devtools-protocol';\n\n/** Identifies the operation represented by a framework protocol request. */\nexport type ExactInvocationKind = 'invoke' | 'refresh';\n\n/** Selects one concrete compiler-planned partition instance. */\nexport type ExactPartitionDiscriminator =\n\t| Readonly<{ kind: 'single' }>\n\t| Readonly<{ kind: 'branch'; branch: string }>\n\t| Readonly<{ kind: 'keyed'; list: string; keyToken: string }>;\n\n/** Carries generation-fenced authority for a compiler-planned partition. */\nexport type ExactPartitionAuthority = Readonly<{\n\tversion: 1;\n\tbuildKey: string;\n\texecutionRoot: string;\n\tplanEdgeId: string;\n\townerComponentId: string;\n\tdiscriminator: ExactPartitionDiscriminator;\n\tgeneration: number;\n}>;\n\n/** Maps compiler-owned operation identities to configured endpoint routes. */\nexport type ExactEndpointRoutes = {\n\tinvocations?: Record<string, string>;\n\tboundaries?: Record<string, string>;\n};\n\n/** Describes one invocation or refresh request on the framework wire protocol. */\nexport type ExactInvocationRequest = {\n\ttype: ExactInvocationKind;\n\troot?: string;\n\tid: string;\n\tpartition?: ExactPartitionAuthority;\n\topId?: string;\n\tdependsOn?: string[];\n\tpayload?: unknown;\n\tstate?: unknown;\n\tpublicContext?: Record<string, unknown>;\n\tboundaryHtml?: string;\n\tboundaryHtmls?: Record<string, string>;\n};\n\n/** Groups invocation requests for bounded concurrent execution. */\nexport type ExactBatchRequest = {\n\ttype: 'batch';\n\tversion?: 1;\n\toperations: ExactInvocationRequest[];\n};\n\n/** Describes the transport-safe result of one invocation. */\nexport type ExactInvocationResult = {\n\tpatches?: ExactPatch[];\n\tstate?: unknown;\n\tmutations?: ExactCollectionMutation[];\n\tcontexts?: Record<string, unknown>;\n\tvalue?: unknown;\n\thtml?: string;\n};\n\n/** Describes a successful operation response. */\nexport type ExactOperationSuccess = {\n\tok: true;\n\ttype: ExactInvocationKind;\n\tid: string;\n\topId?: string;\n} & ExactInvocationResult;\n\n/** Describes a rejected or failed operation response. */\nexport type ExactOperationError = {\n\tok: false;\n\ttype: ExactInvocationKind;\n\tid: string;\n\topId?: string;\n\tstatus: number;\n\terror: 'bad_request' | 'not_found' | 'forbidden' | 'internal_error' | 'dependency_failed';\n};\n\n/** Describes the result of one operation. */\nexport type ExactOperationResult = ExactOperationSuccess | ExactOperationError;\n\n/** Describes a completed batch response. */\nexport type ExactBatchResult = {\n\tok: true;\n\tversion: 1;\n\tresults: ExactOperationResult[];\n};\n\n/** Reports one event in an incremental operation response. */\nexport type ExactStreamEvent =\n\t| { event: 'start'; version: 1; operations: number }\n\t| {\n\t\t\tevent: 'patch';\n\t\t\tversion: 1;\n\t\t\tindex: number;\n\t\t\ttype: ExactInvocationKind;\n\t\t\tid: string;\n\t\t\topId?: string;\n\t\t\tpatch: ExactPatch;\n\t  }\n\t| {\n\t\t\tevent: 'state';\n\t\t\tversion: 1;\n\t\t\tindex: number;\n\t\t\ttype: ExactInvocationKind;\n\t\t\tid: string;\n\t\t\topId?: string;\n\t\t\tvalue: unknown;\n\t  }\n\t| {\n\t\t\tevent: 'mutations';\n\t\t\tversion: 1;\n\t\t\tindex: number;\n\t\t\ttype: ExactInvocationKind;\n\t\t\tid: string;\n\t\t\topId?: string;\n\t\t\tmutations: ExactCollectionMutation[];\n\t  }\n\t| {\n\t\t\tevent: 'html';\n\t\t\tversion: 1;\n\t\t\tindex: number;\n\t\t\ttype: ExactInvocationKind;\n\t\t\tid: string;\n\t\t\topId?: string;\n\t\t\thtml: string;\n\t  }\n\t| { event: 'result'; version: 1; index: number; result: ExactOperationResult }\n\t| { event: 'observations'; version: 1; observations: readonly ExactRuntimeInspectionEvent[] }\n\t| { event: 'complete'; version: 1 };\n\n/** Describes one client-applied operation patch. */\nexport type ExactPatch =\n\t| { type: 'text'; id: string; value: string }\n\t| { type: 'prop'; id: string; name: string; value: unknown }\n\t| { type: 'style'; id: string; name: string; value: string | null }\n\t| {\n\t\t\ttype: 'list';\n\t\t\tid: string;\n\t\t\top: 'insert' | 'move' | 'remove';\n\t\t\tkey: string;\n\t\t\tbefore?: string;\n\t\t\thtml?: string;\n\t  }\n\t| { type: 'state'; id: string; value: unknown }\n\t| { type: 'replace'; id: string; html: string };\n\nconst forbiddenDomPatchProperties = new Set([\n\t'__proto__',\n\t'constructor',\n\t'dangerouslysetinnerhtml',\n\t'innerhtml',\n\t'innertext',\n\t'outerhtml',\n\t'outertext',\n\t'prototype',\n\t'srcdoc',\n\t'textcontent'\n]);\n\n/**\n * Reports whether a server property patch may cross the operation boundary.\n * Structural HTML/text setters, inline event handlers, iframe documents, and\n * JavaScript prototype controls require dedicated framework-owned operations.\n */\nexport function isSafeDomPatchProperty(name: string): boolean {\n\tconst normalized = name.toLowerCase();\n\treturn (\n\t\t!!normalized && !normalized.startsWith('on') && !forbiddenDomPatchProperties.has(normalized)\n\t);\n}\n\nexport type { ExactCollectionMutation } from '../component-contracts.js';\n"]}
+{"version":3,"file":"operation-protocol.js","sourceRoot":"","sources":["../../../src/framework/operation-protocol.ts"],"names":[],"mappings":"AA8JA,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC;IAC3C,WAAW;IACX,aAAa;IACb,yBAAyB;IACzB,WAAW;IACX,WAAW;IACX,WAAW;IACX,WAAW;IACX,WAAW;IACX,QAAQ;IACR,aAAa;CACb,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,OAAO,CACN,CAAC,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,2BAA2B,CAAC,GAAG,CAAC,UAAU,CAAC,CAC5F,CAAC;AACH,CAAC","sourcesContent":["import type { ExactCollectionMutation } from '../component-contracts.js';\nimport type { ExactRuntimeInspectionEvent } from '@exactjs/devtools-protocol';\n\n/** Identifies the operation represented by a framework protocol request. */\nexport type ExactInvocationKind = 'invoke' | 'refresh';\n\n/** Selects one concrete compiler-planned partition instance. */\nexport type ExactPartitionDiscriminator =\n\t| Readonly<{ kind: 'single' }>\n\t| Readonly<{ kind: 'branch'; branch: string }>\n\t| Readonly<{ kind: 'keyed'; list: string; keyToken: string }>;\n\n/** Carries generation-fenced authority for a compiler-planned partition. */\nexport type ExactPartitionAuthority = Readonly<{\n\tversion: 1;\n\tbuildKey: string;\n\texecutionRoot: string;\n\tplanEdgeId: string;\n\townerComponentId: string;\n\tdiscriminator: ExactPartitionDiscriminator;\n\tgeneration: number;\n}>;\n\n/** Maps compiler-owned operation identities to configured endpoint routes. */\nexport type ExactEndpointRoutes = {\n\tinvocations?: Record<string, string>;\n\tboundaries?: Record<string, string>;\n};\n\n/** Describes one invocation or refresh request on the framework wire protocol. */\nexport type ExactInvocationRequest = {\n\ttype: ExactInvocationKind;\n\troot?: string;\n\tid: string;\n\tpartition?: ExactPartitionAuthority;\n\topId?: string;\n\tdependsOn?: string[];\n\tpayload?: unknown;\n\tstate?: unknown;\n\tpublicContext?: Record<string, unknown>;\n\tboundaryHtml?: string;\n\tboundaryHtmls?: Record<string, string>;\n};\n\n/** Groups invocation requests for bounded concurrent execution. */\nexport type ExactBatchRequest = {\n\ttype: 'batch';\n\tversion?: 1;\n\toperations: ExactInvocationRequest[];\n};\n\n/** Describes the transport-safe result of one invocation. */\nexport type ExactInvocationResult = {\n\tpatches?: ExactPatch[];\n\tstate?: unknown;\n\tmutations?: ExactCollectionMutation[];\n\tcontexts?: Record<string, unknown>;\n\tvalue?: unknown;\n\thtml?: string;\n};\n\n/** Describes a successful operation response. */\nexport type ExactOperationSuccess = {\n\tok: true;\n\ttype: ExactInvocationKind;\n\tid: string;\n\topId?: string;\n} & ExactInvocationResult;\n\n/** Describes a rejected or failed operation response. */\nexport type ExactOperationError = {\n\tok: false;\n\ttype: ExactInvocationKind;\n\tid: string;\n\topId?: string;\n\tstatus: number;\n\terror: 'bad_request' | 'not_found' | 'forbidden' | 'internal_error' | 'dependency_failed';\n};\n\n/** Describes the result of one operation. */\nexport type ExactOperationResult = ExactOperationSuccess | ExactOperationError;\n\n/** Describes a completed batch response. */\nexport type ExactBatchResult = {\n\tok: true;\n\tversion: 1;\n\tresults: ExactOperationResult[];\n};\n\n/** Reports one event in an incremental operation response. */\nexport type ExactStreamEvent =\n\t| {\n\t\t\tevent: 'progress';\n\t\t\tversion: 1;\n\t\t\tindex: number;\n\t\t\ttype: ExactInvocationKind;\n\t\t\tid: string;\n\t\t\topId?: string;\n\t\t\treceiver: string;\n\t\t\tsnapshot: unknown;\n\t  }\n\t| { event: 'start'; version: 1; operations: number }\n\t| {\n\t\t\tevent: 'patch';\n\t\t\tversion: 1;\n\t\t\tindex: number;\n\t\t\ttype: ExactInvocationKind;\n\t\t\tid: string;\n\t\t\topId?: string;\n\t\t\tpatch: ExactPatch;\n\t  }\n\t| {\n\t\t\tevent: 'state';\n\t\t\tversion: 1;\n\t\t\tindex: number;\n\t\t\ttype: ExactInvocationKind;\n\t\t\tid: string;\n\t\t\topId?: string;\n\t\t\tvalue: unknown;\n\t  }\n\t| {\n\t\t\tevent: 'mutations';\n\t\t\tversion: 1;\n\t\t\tindex: number;\n\t\t\ttype: ExactInvocationKind;\n\t\t\tid: string;\n\t\t\topId?: string;\n\t\t\tmutations: ExactCollectionMutation[];\n\t  }\n\t| {\n\t\t\tevent: 'html';\n\t\t\tversion: 1;\n\t\t\tindex: number;\n\t\t\ttype: ExactInvocationKind;\n\t\t\tid: string;\n\t\t\topId?: string;\n\t\t\thtml: string;\n\t  }\n\t| { event: 'result'; version: 1; index: number; result: ExactOperationResult }\n\t| { event: 'observations'; version: 1; observations: readonly ExactRuntimeInspectionEvent[] }\n\t| { event: 'complete'; version: 1 };\n\n/** Describes one client-applied operation patch. */\nexport type ExactPatch =\n\t| { type: 'text'; id: string; value: string }\n\t| { type: 'prop'; id: string; name: string; value: unknown }\n\t| { type: 'style'; id: string; name: string; value: string | null }\n\t| {\n\t\t\ttype: 'list';\n\t\t\tid: string;\n\t\t\top: 'insert' | 'move' | 'remove';\n\t\t\tkey: string;\n\t\t\tbefore?: string;\n\t\t\thtml?: string;\n\t  }\n\t| { type: 'state'; id: string; value: unknown }\n\t| { type: 'replace'; id: string; html: string };\n\nconst forbiddenDomPatchProperties = new Set([\n\t'__proto__',\n\t'constructor',\n\t'dangerouslysetinnerhtml',\n\t'innerhtml',\n\t'innertext',\n\t'outerhtml',\n\t'outertext',\n\t'prototype',\n\t'srcdoc',\n\t'textcontent'\n]);\n\n/**\n * Reports whether a server property patch may cross the operation boundary.\n * Structural HTML/text setters, inline event handlers, iframe documents, and\n * JavaScript prototype controls require dedicated framework-owned operations.\n */\nexport function isSafeDomPatchProperty(name: string): boolean {\n\tconst normalized = name.toLowerCase();\n\treturn (\n\t\t!!normalized && !normalized.startsWith('on') && !forbiddenDomPatchProperties.has(normalized)\n\t);\n}\n\nexport type { ExactCollectionMutation } from '../component-contracts.js';\n"]}

package/dist/server/framework/server-fragment-target-projection.d.ts

@@ -0,0 +1,4 @@
+import type { AnyComponentInstance, Child } from '../component/contracts.js';
+/** Projects one server render attempt without creating client subscriptions or effect scopes. */
+export declare function createServerFragmentTargetProjection(supplied: Child | (() => Child), tag: string, owner?: AnyComponentInstance): (children: readonly Child[]) => Child[];
+//# sourceMappingURL=server-fragment-target-projection.d.ts.map

package/dist/server/framework/server-fragment-target-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-fragment-target-projection.d.ts","sourceRoot":"","sources":["../../../src/framework/server-fragment-target-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAI7E,iGAAiG;AACjG,wBAAgB,oCAAoC,CACnD,QAAQ,EAAE,KAAK,GAAG,CAAC,MAAM,KAAK,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,oBAAoB,GAC1B,CAAC,QAAQ,EAAE,SAAS,KAAK,EAAE,KAAK,KAAK,EAAE,CAQzC"}

package/dist/server/framework/server-fragment-target-projection.js

@@ -0,0 +1,7 @@
+import { createPreparedServerChildRange } from '../component-abi/server-child-range.js';
+import { createFragmentTargetProjectionWithRanges } from './fragment-target-projection-plan.js';
+/** Projects one server render attempt without creating client subscriptions or effect scopes. */
+export function createServerFragmentTargetProjection(supplied, tag, owner) {
+    return createFragmentTargetProjectionWithRanges(supplied, tag, owner, (read, markerId, mayReplaceSubtree) => createPreparedServerChildRange(read(), markerId, mayReplaceSubtree));
+}
+//# sourceMappingURL=server-fragment-target-projection.js.map

package/dist/server/framework/server-fragment-target-projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-fragment-target-projection.js","sourceRoot":"","sources":["../../../src/framework/server-fragment-target-projection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,wCAAwC,EAAE,MAAM,sCAAsC,CAAC;AAEhG,iGAAiG;AACjG,MAAM,UAAU,oCAAoC,CACnD,QAA+B,EAC/B,GAAW,EACX,KAA4B;IAE5B,OAAO,wCAAwC,CAC9C,QAAQ,EACR,GAAG,EACH,KAAK,EACL,CAAC,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE,EAAE,CACrC,8BAA8B,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CACpE,CAAC;AACH,CAAC","sourcesContent":["import type { AnyComponentInstance, Child } from '../component/contracts.js';\nimport { createPreparedServerChildRange } from '../component-abi/server-child-range.js';\nimport { createFragmentTargetProjectionWithRanges } from './fragment-target-projection-plan.js';\n\n/** Projects one server render attempt without creating client subscriptions or effect scopes. */\nexport function createServerFragmentTargetProjection(\n\tsupplied: Child | (() => Child),\n\ttag: string,\n\towner?: AnyComponentInstance\n): (children: readonly Child[]) => Child[] {\n\treturn createFragmentTargetProjectionWithRanges(\n\t\tsupplied,\n\t\ttag,\n\t\towner,\n\t\t(read, markerId, mayReplaceSubtree) =>\n\t\t\tcreatePreparedServerChildRange(read(), markerId, mayReplaceSubtree)\n\t);\n}\n"]}

package/dist/server/framework/server-render-structure.d.ts

@@ -16,4 +16,5 @@ export declare function createForwardedExpression<T>(compute: () => T): T;
 export declare function createDynamicChild(compute: () => RenderResult, markerId?: string, mayReplaceSubtree?: boolean): ExactPreparedServerChildRange;
 /** Creates the eager server operation for one compiler-owned dynamic child range. */
 export declare function createCompiledChildRangeReceipt(compute: () => RenderResult, markerId?: string, mayReplaceSubtree?: boolean): ExactPreparedServerChildRange;
+export { createServerFragmentTargetProjection } from './server-fragment-target-projection.js';
 //# sourceMappingURL=server-render-structure.d.ts.map

package/dist/server/framework/server-render-structure.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-render-structure.d.ts","sourceRoot":"","sources":["../../../src/framework/server-render-structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAEN,KAAK,6BAA6B,EAClC,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EACN,2BAA2B,EAC3B,iCAAiC,EACjC,4BAA4B,EAC5B,+BAA+B,EAC/B,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,EAClC,KAAK,gCAAgC,EACrC,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,sCAAsC,EACtC,oDAAoD,EACpD,oCAAoC,EACpC,KAAK,qCAAqC,EAC1C,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACN,4BAA4B,EAC5B,KAAK,6BAA6B,EAClC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACN,8BAA8B,EAC9B,4BAA4B,EAC5B,KAAK,6BAA6B,EAClC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,MAAM,+CAA+C,CAAC;AAEvD,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAEvD;AAED,2FAA2F;AAC3F,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAEhE;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,MAAM,YAAY,EAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,iBAAiB,UAAO,GACtB,6BAA6B,CAE/B;AAED,qFAAqF;AACrF,wBAAgB,+BAA+B,CAC9C,OAAO,EAAE,MAAM,YAAY,EAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,iBAAiB,UAAO,GACtB,6BAA6B,CAE/B"}
+{"version":3,"file":"server-render-structure.d.ts","sourceRoot":"","sources":["../../../src/framework/server-render-structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAEN,KAAK,6BAA6B,EAClC,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EACN,2BAA2B,EAC3B,iCAAiC,EACjC,4BAA4B,EAC5B,+BAA+B,EAC/B,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,+BAA+B,EACpC,KAAK,4BAA4B,EACjC,KAAK,yBAAyB,EAC9B,KAAK,6BAA6B,EAClC,KAAK,gCAAgC,EACrC,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,+BAA+B,EACpC,KAAK,2BAA2B,EAChC,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,sCAAsC,EACtC,oDAAoD,EACpD,oCAAoC,EACpC,KAAK,qCAAqC,EAC1C,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACN,4BAA4B,EAC5B,KAAK,6BAA6B,EAClC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACN,8BAA8B,EAC9B,4BAA4B,EAC5B,KAAK,6BAA6B,EAClC,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,MAAM,+CAA+C,CAAC;AAEvD,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAEvD;AAED,2FAA2F;AAC3F,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAEhE;AAED,6FAA6F;AAC7F,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,MAAM,YAAY,EAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,iBAAiB,UAAO,GACtB,6BAA6B,CAE/B;AAED,qFAAqF;AACrF,wBAAgB,+BAA+B,CAC9C,OAAO,EAAE,MAAM,YAAY,EAC3B,QAAQ,CAAC,EAAE,MAAM,EACjB,iBAAiB,UAAO,GACtB,6BAA6B,CAE/B;AAED,OAAO,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/server/framework/server-render-structure.js

@@ -23,4 +23,5 @@ export function createDynamicChild(compute, markerId, mayReplaceSubtree = true)
 export function createCompiledChildRangeReceipt(compute, markerId, mayReplaceSubtree = true) {
     return createPreparedServerChildRange(compute(), markerId, mayReplaceSubtree);
 }
+export { createServerFragmentTargetProjection } from './server-fragment-target-projection.js';
 //# sourceMappingURL=server-render-structure.js.map

package/dist/server/framework/server-render-structure.js.map

@@ -1 +1 @@
-{"version":3,"file":"server-render-structure.js","sourceRoot":"","sources":["../../../src/framework/server-render-structure.ts"],"names":[],"mappings":"AACA,OAAO,EACN,8BAA8B,EAE9B,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EACN,2BAA2B,EAC3B,iCAAiC,EACjC,4BAA4B,EAC5B,+BAA+B,EAC/B,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EAmBrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,sCAAsC,EACtC,oDAAoD,EACpD,oCAAoC,EAEpC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACN,4BAA4B,EAE5B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACN,8BAA8B,EAC9B,4BAA4B,EAE5B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,MAAM,+CAA+C,CAAC;AAEvD,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAAI,OAAgB;IACnD,OAAO,OAAO,EAAE,CAAC;AAClB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,yBAAyB,CAAI,OAAgB;IAC5D,OAAO,OAAO,EAAE,CAAC;AAClB,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,kBAAkB,CACjC,OAA2B,EAC3B,QAAiB,EACjB,iBAAiB,GAAG,IAAI;IAExB,OAAO,8BAA8B,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAC/E,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,+BAA+B,CAC9C,OAA2B,EAC3B,QAAiB,EACjB,iBAAiB,GAAG,IAAI;IAExB,OAAO,8BAA8B,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAC/E,CAAC","sourcesContent":["import type { RenderResult } from '../component/contracts.js';\nimport {\n\tcreatePreparedServerChildRange,\n\ttype ExactPreparedServerChildRange\n} from '../component-abi/server-child-range.js';\n\nexport { isFiniteClientBoundary, markFiniteClientBoundary } from '../hydration-boundary.js';\nexport { hasIndependentAsyncSiblings, markIndependentAsyncSiblings } from '../ssr-independence.js';\nexport { RenderProgram, ServerBoundary, ServerSlot } from '../symbols.js';\nexport {\n\tcreatePreparedRenderProgram,\n\tcreatePreparedServerRenderProgram,\n\tprepareCompiledRenderProgram,\n\treadPreparedServerRenderProgram,\n\treadRenderProgram,\n\treadRenderProgramReceipt,\n\treadRenderProgramSlot,\n\ttype ExactRenderProgram,\n\ttype ExactDirectRenderProgram,\n\ttype ExactDomRenderProgram,\n\ttype ExactRenderProgramBinding,\n\ttype ExactRenderProgramBinder,\n\ttype ExactRenderProgramBindingTarget,\n\ttype ExactRenderProgramInvocation,\n\ttype ExactRenderProgramReceipt,\n\ttype ExactRenderProgramReceiptData,\n\ttype ExactPreparedServerRenderProgram,\n\ttype ExactRenderProgramNode,\n\ttype ExactRenderProgramSlot,\n\ttype ExactRenderProgramSsrOperations,\n\ttype ExactRenderProgramSsrOutput,\n\ttype ExactRenderProgramSsrInvocation,\n\ttype ExactRenderProgramSsrWriter,\n\ttype ExactSsrRenderProgram,\n\ttype ExactTableRenderProgram\n} from '../render-program.js';\nexport {\n\tcreatePreparedServerComponentReference,\n\tcreatePreparedServerComponentReferenceFromPlainProps,\n\treadPreparedServerComponentReference,\n\ttype ExactPreparedServerComponentReference\n} from '../component-abi/receipt.js';\nexport {\n\treadPreparedServerChildRange,\n\ttype ExactPreparedServerChildRange\n} from '../component-abi/server-child-range.js';\nexport {\n\tcreatePreparedServerKeyedChild,\n\treadPreparedServerKeyedChild,\n\ttype ExactPreparedServerKeyedChild\n} from '../component-abi/server-keyed-child.js';\nexport {\n\tcreateKeyedServerSlot,\n\tcreateServerBoundary,\n\tcreateServerSlot\n} from '../component-abi/server-structure-receipts.js';\n\n/** Evaluates a compiler-known expression directly in a compiler-closed server component. */\nexport function createExpression<T>(compute: () => T): T {\n\treturn compute();\n}\n\n/** Evaluates a compiler-forwarded input directly in a compiler-closed server component. */\nexport function createForwardedExpression<T>(compute: () => T): T {\n\treturn compute();\n}\n\n/** Creates an eager focused child range for a direct server render or its local fallback. */\nexport function createDynamicChild(\n\tcompute: () => RenderResult,\n\tmarkerId?: string,\n\tmayReplaceSubtree = true\n): ExactPreparedServerChildRange {\n\treturn createPreparedServerChildRange(compute(), markerId, mayReplaceSubtree);\n}\n\n/** Creates the eager server operation for one compiler-owned dynamic child range. */\nexport function createCompiledChildRangeReceipt(\n\tcompute: () => RenderResult,\n\tmarkerId?: string,\n\tmayReplaceSubtree = true\n): ExactPreparedServerChildRange {\n\treturn createPreparedServerChildRange(compute(), markerId, mayReplaceSubtree);\n}\n"]}
+{"version":3,"file":"server-render-structure.js","sourceRoot":"","sources":["../../../src/framework/server-render-structure.ts"],"names":[],"mappings":"AACA,OAAO,EACN,8BAA8B,EAE9B,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AACnG,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1E,OAAO,EACN,2BAA2B,EAC3B,iCAAiC,EACjC,4BAA4B,EAC5B,+BAA+B,EAC/B,iBAAiB,EACjB,wBAAwB,EACxB,qBAAqB,EAmBrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,sCAAsC,EACtC,oDAAoD,EACpD,oCAAoC,EAEpC,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACN,4BAA4B,EAE5B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACN,8BAA8B,EAC9B,4BAA4B,EAE5B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACN,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,MAAM,+CAA+C,CAAC;AAEvD,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAAI,OAAgB;IACnD,OAAO,OAAO,EAAE,CAAC;AAClB,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,yBAAyB,CAAI,OAAgB;IAC5D,OAAO,OAAO,EAAE,CAAC;AAClB,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,kBAAkB,CACjC,OAA2B,EAC3B,QAAiB,EACjB,iBAAiB,GAAG,IAAI;IAExB,OAAO,8BAA8B,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAC/E,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,+BAA+B,CAC9C,OAA2B,EAC3B,QAAiB,EACjB,iBAAiB,GAAG,IAAI;IAExB,OAAO,8BAA8B,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,iBAAiB,CAAC,CAAC;AAC/E,CAAC;AAED,OAAO,EAAE,oCAAoC,EAAE,MAAM,wCAAwC,CAAC","sourcesContent":["import type { RenderResult } from '../component/contracts.js';\nimport {\n\tcreatePreparedServerChildRange,\n\ttype ExactPreparedServerChildRange\n} from '../component-abi/server-child-range.js';\n\nexport { isFiniteClientBoundary, markFiniteClientBoundary } from '../hydration-boundary.js';\nexport { hasIndependentAsyncSiblings, markIndependentAsyncSiblings } from '../ssr-independence.js';\nexport { RenderProgram, ServerBoundary, ServerSlot } from '../symbols.js';\nexport {\n\tcreatePreparedRenderProgram,\n\tcreatePreparedServerRenderProgram,\n\tprepareCompiledRenderProgram,\n\treadPreparedServerRenderProgram,\n\treadRenderProgram,\n\treadRenderProgramReceipt,\n\treadRenderProgramSlot,\n\ttype ExactRenderProgram,\n\ttype ExactDirectRenderProgram,\n\ttype ExactDomRenderProgram,\n\ttype ExactRenderProgramBinding,\n\ttype ExactRenderProgramBinder,\n\ttype ExactRenderProgramBindingTarget,\n\ttype ExactRenderProgramInvocation,\n\ttype ExactRenderProgramReceipt,\n\ttype ExactRenderProgramReceiptData,\n\ttype ExactPreparedServerRenderProgram,\n\ttype ExactRenderProgramNode,\n\ttype ExactRenderProgramSlot,\n\ttype ExactRenderProgramSsrOperations,\n\ttype ExactRenderProgramSsrOutput,\n\ttype ExactRenderProgramSsrInvocation,\n\ttype ExactRenderProgramSsrWriter,\n\ttype ExactSsrRenderProgram,\n\ttype ExactTableRenderProgram\n} from '../render-program.js';\nexport {\n\tcreatePreparedServerComponentReference,\n\tcreatePreparedServerComponentReferenceFromPlainProps,\n\treadPreparedServerComponentReference,\n\ttype ExactPreparedServerComponentReference\n} from '../component-abi/receipt.js';\nexport {\n\treadPreparedServerChildRange,\n\ttype ExactPreparedServerChildRange\n} from '../component-abi/server-child-range.js';\nexport {\n\tcreatePreparedServerKeyedChild,\n\treadPreparedServerKeyedChild,\n\ttype ExactPreparedServerKeyedChild\n} from '../component-abi/server-keyed-child.js';\nexport {\n\tcreateKeyedServerSlot,\n\tcreateServerBoundary,\n\tcreateServerSlot\n} from '../component-abi/server-structure-receipts.js';\n\n/** Evaluates a compiler-known expression directly in a compiler-closed server component. */\nexport function createExpression<T>(compute: () => T): T {\n\treturn compute();\n}\n\n/** Evaluates a compiler-forwarded input directly in a compiler-closed server component. */\nexport function createForwardedExpression<T>(compute: () => T): T {\n\treturn compute();\n}\n\n/** Creates an eager focused child range for a direct server render or its local fallback. */\nexport function createDynamicChild(\n\tcompute: () => RenderResult,\n\tmarkerId?: string,\n\tmayReplaceSubtree = true\n): ExactPreparedServerChildRange {\n\treturn createPreparedServerChildRange(compute(), markerId, mayReplaceSubtree);\n}\n\n/** Creates the eager server operation for one compiler-owned dynamic child range. */\nexport function createCompiledChildRangeReceipt(\n\tcompute: () => RenderResult,\n\tmarkerId?: string,\n\tmayReplaceSubtree = true\n): ExactPreparedServerChildRange {\n\treturn createPreparedServerChildRange(compute(), markerId, mayReplaceSubtree);\n}\n\nexport { createServerFragmentTargetProjection } from './server-fragment-target-projection.js';\n"]}

package/dist/server/framework/server-task-helpers.d.ts

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