octane 0.3.0 → 0.3.2

package/dist/hydration/event-capture.js

@@ -19,8 +19,7 @@ import {
   snapshotHydrationControl
 } from "./control-capture.js";
 import { HYDRATE_STREAM_TOKEN_ATTR, isRendererStreamBoundaryTemplate } from "../stream-protocol.js";
-const HYDRATE_MARKER_SELECTOR = "[data-octane-hydrate-id]";
-const HYDRATE_WHEN_ATTR = "data-octane-hydrate-when";
+import { HYDRATE_MARKER_SELECTOR, HYDRATE_WHEN_ATTR } from "../hydration-markers.js";
 function isHydrationNode(target) {
   return target !== null && typeof target.nodeType === "number";
 }

package/dist/hydration/independent-island.js

@@ -1,5 +1,7 @@
 import { decodeSignalValue } from "../data-encoding.js";
 import {
+  HYDRATE_ID_ATTR,
+  HYDRATE_WHEN_ATTR,
   HYDRATE_INDEPENDENT_ATTR,
   INDEPENDENT_HYDRATE_MANIFEST_ATTR
 } from "../hydration-markers.js";
@@ -19,7 +21,7 @@ function registerIndependentHydrationIsland(element, manifest, registration) {
   if (!isIndependentHydrateManifest(manifest)) {
     throw new TypeError("Invalid independent Hydrate manifest.");
   }
-  if (element.getAttribute("data-octane-hydrate-id") !== manifest.boundaryId) {
+  if (element.getAttribute(HYDRATE_ID_ATTR) !== manifest.boundaryId) {
     throw new Error("Independent Hydrate boundary identity mismatch.");
   }
   element.setAttribute(HYDRATE_INDEPENDENT_ATTR, "");
@@ -85,8 +87,7 @@ function registerIndependentHydrationIsland(element, manifest, registration) {
     return status;
   };
   registerHydrationIntentBoundary(element, boundary);
-  if (intents.length !== 0 || element.getAttribute("data-octane-hydrate-when") === "load")
-    activate();
+  if (intents.length !== 0 || element.getAttribute(HYDRATE_WHEN_ATTR) === "load") activate();
   return Object.assign(
     () => {
       if (disposed) return;
@@ -107,8 +108,7 @@ function registerIndependentHydrationIsland(element, manifest, registration) {
       resume() {
         if (disposed || !paused) return;
         paused = false;
-        if (intents.length || element.getAttribute("data-octane-hydrate-when") === "load")
-          activate();
+        if (intents.length || element.getAttribute(HYDRATE_WHEN_ATTR) === "load") activate();
       }
     }
   );

package/dist/hydration/stream-delivery.d.ts

@@ -10,7 +10,7 @@ export interface StreamedRendererDeliveryOptions {
     /** Includes style/composition waits; also caps unfinished inline result channels. */
     readonly maxPendingFrames?: number;
     readonly maxPendingBytes?: number;
-    /** Maximum queue/placement and inline result lifetime; readers also bound the response. */
+    /** Maximum queue/placement wait and result inactivity; readers also bound each pending read. */
     readonly timeoutMs?: number;
 }
 export interface StreamedRendererReadOptions extends StreamedRendererDeliveryOptions {

package/dist/hydration/stream-delivery.js

@@ -145,8 +145,11 @@ function installStreamedRendererGlobal(receiver, target = globalThis, options =
     if (disposition === "stale" || frame.channel !== "result") return;
     if (frame.kind === "complete" || frame.kind === "error") {
       forgetResult(frame.identity);
-    } else if (frame.kind === "open") {
-      if (openResults.size >= maxOpenResults)
+    } else {
+      const key = streamFrameIdentityKey(frame.identity);
+      const previous2 = openResults.get(key);
+      if (previous2 !== void 0) clearTimeout(previous2.timer);
+      else if (openResults.size >= maxOpenResults)
         throw new StreamedReceiverError(
           "overflow",
           "Streamed renderer exceeded its open result budget."
@@ -161,7 +164,7 @@ function installStreamedRendererGlobal(receiver, target = globalThis, options =
         } catch {
         }
       }, resultTimeoutMs);
-      openResults.set(streamFrameIdentityKey(frame.identity), { identity: frame.identity, timer });
+      openResults.set(key, { identity: frame.identity, timer });
     }
   });
   let removed = false;
@@ -259,17 +262,22 @@ async function readStreamedRendererResponse(response, receiver, options = {}) {
     void reader.cancel(options.signal?.reason).catch(() => {
     });
   };
-  const timer = setTimeout(() => {
-    failure ??= new StreamedReceiverError("timeout", "Streamed renderer response timed out.");
-    abort();
-  }, timeoutMs);
   options.signal?.addEventListener("abort", abort, { once: true });
   if (options.signal?.aborted) abort();
   try {
     for (; ; ) {
       if (failure !== void 0 && options.signal?.aborted) throw failure;
       options.signal?.throwIfAborted();
-      const next = await reader.read();
+      const timer = setTimeout(() => {
+        failure ??= new StreamedReceiverError("timeout", "Streamed renderer response timed out.");
+        abort();
+      }, timeoutMs);
+      let next;
+      try {
+        next = await reader.read();
+      } finally {
+        clearTimeout(timer);
+      }
       if (next.done) break;
       totalBytes += next.value.byteLength;
       if (totalBytes > maxTotalBytes) {
@@ -314,7 +322,6 @@ async function readStreamedRendererResponse(response, receiver, options = {}) {
     failOpenResults(error);
     throw error;
   } finally {
-    clearTimeout(timer);
     options.signal?.removeEventListener("abort", abort);
     if (!finished) {
       try {

package/dist/hydration/stream-result-receiver.d.ts

@@ -13,6 +13,7 @@ export interface StreamedResultReceiverOptions {
     readonly ownerKey: string;
     readonly maxPendingFrames?: number;
     readonly maxPendingBytes?: number;
+    /** Maximum inactivity before the first result frame or between accepted result frames. */
     readonly pendingTimeoutMs?: number;
     readonly onError?: (error: StreamedReceiverError) => void;
 }

package/dist/hydration/stream-result-receiver.js

@@ -69,6 +69,12 @@ function createStreamedResultReceiverState(options, commitPlacement) {
     return state !== void 0 && sameStreamFrameIdentity(state.identity, identity) ? state : void 0;
   };
   const isCurrent = (state, identity) => !disposed && state.failure === void 0 && current(identity) === state;
+  const renewResultTimeout = (state) => {
+    if (state.result.timer !== void 0) clearTimeout(state.result.timer);
+    state.result.timer = setTimeout(() => {
+      report(new StreamedReceiverError("timeout", "Streamed result timed out."), state);
+    }, timeoutMs);
+  };
   const registerSelection = (identity, contentRevision = 0) => {
     if (!isStreamedRendererFrame({
       identity,
@@ -95,9 +101,7 @@ function createStreamedResultReceiverState(options, commitPlacement) {
       contentRevision
     };
     selections.set(key, state);
-    state.result.timer = setTimeout(() => {
-      report(new StreamedReceiverError("timeout", "Streamed result timed out."), state);
-    }, timeoutMs);
+    renewResultTimeout(state);
   };
   const attachResult = (identity, consumer) => {
     const state = current(identity);
@@ -175,7 +179,7 @@ function createStreamedResultReceiverState(options, commitPlacement) {
     if (frame.kind === "complete" || frame.kind === "error") {
       result.terminal = true;
       if (result.timer !== void 0) clearTimeout(result.timer);
-    }
+    } else if (!result.terminal && isCurrent(state, frame.identity)) renewResultTimeout(state);
     if (frame.kind === "complete") retainCompletedResult(result);
     return "accepted";
   };

package/dist/hydration-markers.d.ts

@@ -5,3 +5,33 @@ export declare const HYDRATE_INDEPENDENT_ATTR = "data-octane-hydrate-independent
 export declare const HYDRATE_INPUT_ATTR = "data-octane-input";
 /** Server-only writable-signal identity joined to a compiler control site. */
 export declare const SIGNAL_CONTROL_ATTR = "data-octane-signal-control";
+/** Stable id of a server-rendered deferred hydration boundary. */
+export declare const HYDRATE_ID_ATTR = "data-octane-hydrate-id";
+/** Serialized strategy kind (`visible`, `idle`, `dynamic`, …). */
+export declare const HYDRATE_WHEN_ATTR = "data-octane-hydrate-when";
+/** Number of `useId()` slots consumed while rendering the deferred child. */
+export declare const HYDRATE_ID_COUNT_ATTR = "data-octane-hydrate-id-count";
+/** Direct-child JSON script carrying this boundary's `use()` seed slice. */
+export declare const HYDRATE_SEED_ATTR = "data-octane-hydrate-seed";
+/** Matches any server-rendered deferred hydration boundary wrapper. */
+export declare const HYDRATE_MARKER_SELECTOR = "[data-octane-hydrate-id]";
+/** Single-character payload of a block-open comment. */
+export declare const HYDRATION_START = "[";
+/** Single-character payload of a block-close comment. */
+export declare const HYDRATION_END = "]";
+/** Leading payload shared by both `@for` outer-open markers. */
+export declare const HYDRATION_FOR_PREFIX = "[f";
+/** @for outer-open payload: the server rendered its @empty arm. */
+export declare const HYDRATION_FOR_EMPTY = "[f0";
+/** @for outer-open payload: the server rendered one or more direct-host items. */
+export declare const HYDRATION_FOR_ITEMS = "[f1";
+/** Index of the arm digit ('0' or '1') inside either @for outer-open payload. */
+export declare const HYDRATION_FOR_ARM_INDEX: number;
+/**
+ * Serialize one `useId()` value. The client regenerates the id the server
+ * already wrote, so the namespace prefix, the `in-` infix, the base-36 ordinal,
+ * and both colons must be produced in exactly one place: a divergence here
+ * survives every test that only checks one side and then mismatches every
+ * `useId` consumer at hydration.
+ */
+export declare function formatUseId(prefix: string, ordinal: number): string;

package/dist/hydration-markers.js

@@ -2,9 +2,35 @@ const INDEPENDENT_HYDRATE_MANIFEST_ATTR = "data-octane-independent";
 const HYDRATE_INDEPENDENT_ATTR = "data-octane-hydrate-independent";
 const HYDRATE_INPUT_ATTR = "data-octane-input";
 const SIGNAL_CONTROL_ATTR = "data-octane-signal-control";
+const HYDRATE_ID_ATTR = "data-octane-hydrate-id";
+const HYDRATE_WHEN_ATTR = "data-octane-hydrate-when";
+const HYDRATE_ID_COUNT_ATTR = "data-octane-hydrate-id-count";
+const HYDRATE_SEED_ATTR = "data-octane-hydrate-seed";
+const HYDRATE_MARKER_SELECTOR = "[data-octane-hydrate-id]";
+const HYDRATION_START = "[";
+const HYDRATION_END = "]";
+const HYDRATION_FOR_PREFIX = "[f";
+const HYDRATION_FOR_EMPTY = "[f0";
+const HYDRATION_FOR_ITEMS = "[f1";
+const HYDRATION_FOR_ARM_INDEX = HYDRATION_FOR_PREFIX.length;
+function formatUseId(prefix, ordinal) {
+  return ":" + prefix + "in-" + ordinal.toString(36) + ":";
+}
 export {
+  HYDRATE_ID_ATTR,
+  HYDRATE_ID_COUNT_ATTR,
   HYDRATE_INDEPENDENT_ATTR,
   HYDRATE_INPUT_ATTR,
+  HYDRATE_MARKER_SELECTOR,
+  HYDRATE_SEED_ATTR,
+  HYDRATE_WHEN_ATTR,
+  HYDRATION_END,
+  HYDRATION_FOR_ARM_INDEX,
+  HYDRATION_FOR_EMPTY,
+  HYDRATION_FOR_ITEMS,
+  HYDRATION_FOR_PREFIX,
+  HYDRATION_START,
   INDEPENDENT_HYDRATE_MANIFEST_ATTR,
-  SIGNAL_CONTROL_ATTR
+  SIGNAL_CONTROL_ATTR,
+  formatUseId
 };

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export { initializeHydrationEventCapture } from './hydration/event-capture.js';
 export { attachBehaviorRoot } from './behavior-root.js';
 export type * from './behavior-root.js';
 export { createSubSlot, subSlot, type SubSlot, type SlotlessSubSlot, type SubSlotOptions, } from './sub-slot.js';
-export { createRoot, hydrateRoot, flushSync, act, isInActScope, type Root, type RootContainer, type RootOptions, useState, useLinkedState, type LinkedStatePrevious, type LinkedStateOptions, useReducer, useEffect, useLayoutEffect, useInsertionEffect, useMemo, useCallback, useRef, useId, useImperativeHandle, useEffectEvent, useSyncExternalStore, useDeferredValue, useTransition, useActionState, useActionState as useFormState, useFormStatus, useOptimistic, useDebugValue, type FormStatus, startTransition, requestFormReset, memo, lazy, preload, preinit, preloadModule, preinitModule, preconnect, prefetchDNS, createContext, use, useContext, type Context, type ForeignHostContext, Suspense, ErrorBoundary, Hydrate, Activity, Activity as unstable_Activity, ViewTransition, addTransitionType, ViewTransition as unstable_ViewTransition, addTransitionType as unstable_addTransitionType, ViewTransitionPseudoElement, type ViewTransitionProps, type ViewTransitionInstance, Fragment, createPortal, type PortalDescriptor, createElement, cloneElement, isValidElement, isChildrenBlock, descriptorChildren, Children, type ElementDescriptor, type ComponentBody, type OctaneNode, TsrxErrorBoundary, __useStateWithGetter, __useLinkedStateWithGetter, __useReducerWithGetter, __createVoidRoot, __hydrateVoidRoot, bindRendererRegionOwner, EXTERNAL_HYDRATION_PROMISE, HYDRATION_RANGE_BOUNDARY, createHostContextRequest, __vtSeen, template, clone, drainFrag, bag0, bag1, bag2, bag3, bag4, bag5, bag6, bag7, bag8, bag9, bag10, bag11, bag12, bag13, bag14, bag15, bag16, bagOf, evt0, evt0u, evt1, evt1u, evt2, evt2u, evt1e, evt2e, evtN, evtNu, setEventHandler, devEventListener, devHtmlNesting, htext, htextSwap, child, sibling, setText, setScriptText, setHTML, setDangerouslySetInnerHTML, setDangerouslySetInnerHTMLSources, markDangerouslySetInnerHTMLChildren, setAttribute, setStringData, setBooleanAttribute, setAriaAttribute, setClassName, setClassAttr, normalizeClass, isHydratingStyle, setStyle, setStyleProperty, setStyleProperties, setSpread, snapshotSpread, setHostPropSources, queueNativeChangeDiagnostic, queueFormAuthoringDiagnostic, markNativeChangeDiagnosticStatic, setFormAction, setValue, setFormControlSources, setChecked, setCheckedCheckable, setSelectValue, setDefaultValue, setDefaultValueUncontrolled, setDefaultChecked, setAutoFocus, attachRef, queueRefAttach, queueRefDetach, replaceRef, queueOwnRefDetach, injectStyle, headBlock, stylesheetResource, styleResource, scriptResource, namespaceHead, namespaceHeadElement, delegateEvents, delegateCaptureEvents, fastForBlock, fastKeyedForBlock, fastMapSlot, forBlock, keyedForBlock, mapSlot, ifBlock, errorBlock, tryBlock, switchBlock, activityBlock, componentSlot, componentSlotVoid, componentSlotLite, compilerCacheArray, compilerCacheImmutableArrayFilter, compilerCacheMappedArray, compilerCacheContext, compilerOwnsContextProvider, markSingleRoot, markWarm, markSingleRoot as __s, markChildrenBlock, createScopedValue, createScopedElement, childSlot, positionalChildren, textSlot, textHole, childTextHole, hostComponent, renderBlock, portal, hookSlots, withSlot, manualHook, invokeManualHook, useBatch, registerWarmPlan, seedOrCreate, warmMemo, warmChild, puMiss, puTake0, puTake1, puTake2, puTake3, puTake4, puPub, provideContext, mountFragmentRef, FragmentInstance, hmr, HMR, hasPendingWork, type Scope, type Block, drainPassiveEffects, setIsOctaneActEnvironment, resetFloatResourceState, setTransitionFallbackTimeout, getTransitionFallbackTimeout, } from './runtime.js';
+export { createRoot, hydrateRoot, flushSync, act, isInActScope, type Root, type RootContainer, type RootOptions, useState, useLinkedState, type LinkedStatePrevious, type LinkedStateOptions, useReducer, useEffect, useLayoutEffect, useInsertionEffect, useMemo, useCallback, useRef, useId, useImperativeHandle, useEffectEvent, useSyncExternalStore, useDeferredValue, useTransition, useActionState, useActionState as useFormState, useFormStatus, useOptimistic, useDebugValue, type FormStatus, startTransition, requestFormReset, memo, lazy, preload, preinit, preloadModule, preinitModule, preconnect, prefetchDNS, createContext, use, useContext, type Context, type ForeignHostContext, Suspense, ErrorBoundary, Hydrate, __HydrateCompiled, Activity, Activity as unstable_Activity, ViewTransition, addTransitionType, ViewTransition as unstable_ViewTransition, addTransitionType as unstable_addTransitionType, ViewTransitionPseudoElement, type ViewTransitionProps, type ViewTransitionInstance, Fragment, createPortal, type PortalDescriptor, createElement, cloneElement, isValidElement, isChildrenBlock, descriptorChildren, Children, type ElementDescriptor, type ComponentBody, type OctaneNode, TsrxErrorBoundary, __useStateWithGetter, __useLinkedStateWithGetter, __useReducerWithGetter, __createVoidRoot, __hydrateVoidRoot, bindRendererRegionOwner, EXTERNAL_HYDRATION_PROMISE, HYDRATION_RANGE_BOUNDARY, createHostContextRequest, __vtSeen, template, clone, drainFrag, bag0, bag1, bag2, bag3, bag4, bag5, bag6, bag7, bag8, bag9, bag10, bag11, bag12, bag13, bag14, bag15, bag16, bagOf, evt0, evt0u, evt1, evt1u, evt2, evt2u, evt1e, evt2e, evtN, evtNu, setEventHandler, devEventListener, devHtmlNesting, htext, htextSwap, child, sibling, setText, setScriptText, setHTML, setDangerouslySetInnerHTML, setDangerouslySetInnerHTMLSources, markDangerouslySetInnerHTMLChildren, setAttribute, setStringData, setBooleanAttribute, setAriaAttribute, setClassName, setClassAttr, normalizeClass, isHydratingStyle, setStyle, setStyleProperty, setStyleProperties, setSpread, snapshotSpread, setHostPropSources, queueNativeChangeDiagnostic, queueFormAuthoringDiagnostic, markNativeChangeDiagnosticStatic, setFormAction, setValue, setFormControlSources, setChecked, setCheckedCheckable, setSelectValue, setDefaultValue, setDefaultValueUncontrolled, setDefaultChecked, setAutoFocus, attachRef, queueRefAttach, queueRefDetach, replaceRef, queueOwnRefDetach, injectStyle, headBlock, stylesheetResource, styleResource, scriptResource, namespaceHead, namespaceHeadElement, delegateEvents, delegateCaptureEvents, fastForBlock, fastKeyedForBlock, fastMapSlot, forBlock, keyedForBlock, mapSlot, ifBlock, errorBlock, tryBlock, switchBlock, activityBlock, componentSlot, componentSlotVoid, componentSlotLite, compilerCacheArray, compilerCacheImmutableArrayFilter, compilerCacheMappedArray, compilerCacheContext, compilerOwnsContextProvider, markSingleRoot, markWarm, markSingleRoot as __s, markChildrenBlock, createScopedValue, createScopedElement, childSlot, positionalChildren, textSlot, textHole, childTextHole, hostComponent, renderBlock, portal, hookSlots, withSlot, manualHook, invokeManualHook, useBatch, registerWarmPlan, seedOrCreate, warmMemo, warmChild, puMiss, puTake0, puTake1, puTake2, puTake3, puTake4, puPub, provideContext, mountFragmentRef, FragmentInstance, hmr, HMR, hasPendingWork, type Scope, type Block, drainPassiveEffects, setIsOctaneActEnvironment, resetFloatResourceState, setTransitionFallbackTimeout, getTransitionFallbackTimeout, } from './runtime.js';
 export type { HydrateOptions, HydrateProps, HydrateWhen, HydrationInteractionEvent, HydrationInteractionEvents, HydrationPrefetchContext, HydrationPrefetchFunction, HydrationPrefetchStrategy, HydrationPrefetchWaitReason, HydrationStrategy, HydrationWhen, } from './hydration/types.js';
 export { __serverRpc } from './server-rpc-client.js';
 export { ServerCallUncertainError } from './server-rpc-protocol.js';

package/dist/index.js

@@ -49,6 +49,7 @@ import {
   Suspense,
   ErrorBoundary,
   Hydrate,
+  __HydrateCompiled,
   Activity,
   Activity as Activity2,
   ViewTransition,
@@ -241,6 +242,7 @@ export {
   TsrxErrorBoundary,
   ViewTransition,
   ViewTransitionPseudoElement,
+  __HydrateCompiled,
   __createVoidRoot,
   __hydrateVoidRoot,
   __methodDep,

package/dist/react/index.js

@@ -1,4 +1,5 @@
 "use client";
+import { RENDERER_REGION_OWNER_TAG as RENDERER_REGION_OWNER } from "../runtime-tags.js";
 import { ReactCompat } from "./react-compat.js";
 import { bridgeReactContext } from "./react-compat-shared.js";
 import * as React from "react";
@@ -21,7 +22,6 @@ import {
 import { drainPassiveEffects } from "../runtime.js";
 import { readNearestProviderValue } from "./fiber-adapter.js";
 import { __hostContextFiberWalks } from "./fiber-adapter.js";
-const RENDERER_REGION_OWNER = /* @__PURE__ */ Symbol.for("octane.renderer-region.owner");
 const EMPTY_SNAPSHOT = { entries: [], values: [] };
 function hostedRootEnvelope(props) {
   bindRendererRegionOwner(props);

package/dist/react/react-compat-shared.js

@@ -1,7 +1,9 @@
 import * as React from "react";
-const OCTANE_ELEMENT_TAG = /* @__PURE__ */ Symbol.for("octane.element");
-const OCTANE_CONTEXT_TAG = /* @__PURE__ */ Symbol.for("octane.context");
-const REACT_CONTEXT_TAG = /* @__PURE__ */ Symbol.for("react.context");
+import {
+  CONTEXT_TAG as OCTANE_CONTEXT_TAG,
+  ELEMENT_TAG as OCTANE_ELEMENT_TAG,
+  REACT_CONTEXT_TAG
+} from "../runtime-tags.js";
 const REACT_MEMO_TAG = /* @__PURE__ */ Symbol.for("react.memo");
 const REACT_LAZY_TAG = /* @__PURE__ */ Symbol.for("react.lazy");
 const REACT_FORWARD_REF_TAG = /* @__PURE__ */ Symbol.for("react.forward_ref");

package/dist/react/shared.d.ts

@@ -64,8 +64,7 @@ export type OctaneRenderedNode = React.ReactElement & {
  * `ComponentBody<P>` so one declaration can serve both hosts.
  */
 export type OctaneReactComponent<P = Record<string, never>> = (props: P) => OctaneRenderedNode;
-/** React 19 context objects carry $$typeof: Symbol.for('react.context'). */
-export declare const REACT_CONTEXT_TAG: unique symbol;
+export { REACT_CONTEXT_TAG } from '../runtime-tags.js';
 /** The client's stable opaque-host sentinel; the server writes real island HTML. */
 export declare const OPAQUE_HOST_SENTINEL_COMMENT = "octane-compat-island";
 export declare const OPAQUE_HOST_SENTINEL: Readonly<{
@@ -86,4 +85,3 @@ export declare function validateIslandChild(children: React.ReactNode): Transpor
  * itself, which React resolves by remounting the wrapper.
  */
 export declare function resolveHostedIsland(props: OctaneCompatProps | OctaneCompatComponentProps<unknown>): TransportedChild;
-export {};

package/dist/react/shared.js

@@ -1,5 +1,5 @@
 import * as React from "react";
-const REACT_CONTEXT_TAG = /* @__PURE__ */ Symbol.for("react.context");
+import { REACT_CONTEXT_TAG } from "../runtime-tags.js";
 const OPAQUE_HOST_SENTINEL_COMMENT = "octane-compat-island";
 const OPAQUE_HOST_SENTINEL = Object.freeze({
   __html: `<!--${OPAQUE_HOST_SENTINEL_COMMENT}-->`

package/dist/runtime-tags.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Cross-realm value-kind tags. Every one of these is a `Symbol.for` registry
+ * key, which makes the STRING the contract: the client runtime, the SSR
+ * serializer, the universal core, and the React compat layers all recognize a
+ * value by looking its tag up in the same global registry. A typo in any one of
+ * them mints a different symbol and silently fails every `$$kind` identity
+ * check that module performs, so each key is spelled exactly once, here.
+ *
+ * This leaf has no imports on purpose: a consumer that needs one tag must not
+ * pull in the DOM tables or the renderer graph to get it.
+ */
+/** `createElement` descriptor marker. */
+export declare const ELEMENT_TAG: unique symbol;
+/** `createPortal` descriptor marker. */
+export declare const PORTAL_TAG: unique symbol;
+/** React-compatible Fragment sentinel. */
+export declare const FRAGMENT_TAG: unique symbol;
+/** React-19 `<Activity>` sentinel. */
+export declare const ACTIVITY_TAG: unique symbol;
+/** Native Octane context object marker. */
+export declare const CONTEXT_TAG: unique symbol;
+/** `lazy()` wrapper marker. */
+export declare const LAZY_COMPONENT_TAG: unique symbol;
+/** Suspense boundary component type. */
+export declare const SUSPENSE_TAG: unique symbol;
+/** Lexical children body marker. */
+export declare const CHILDREN_BLOCK_TAG: unique symbol;
+/** Owner stamp for a renderer region's host boundary. */
+export declare const RENDERER_REGION_OWNER_TAG: unique symbol;
+/**
+ * React 19 context objects carry this `$$typeof`. Octane only ever READS it to
+ * recognize a foreign React context, but it is the same registry contract.
+ */
+export declare const REACT_CONTEXT_TAG: unique symbol;

package/dist/runtime-tags.js

@@ -0,0 +1,22 @@
+const ELEMENT_TAG = /* @__PURE__ */ Symbol.for("octane.element");
+const PORTAL_TAG = /* @__PURE__ */ Symbol.for("octane.portal");
+const FRAGMENT_TAG = /* @__PURE__ */ Symbol.for("octane.Fragment");
+const ACTIVITY_TAG = /* @__PURE__ */ Symbol.for("octane.Activity");
+const CONTEXT_TAG = /* @__PURE__ */ Symbol.for("octane.context");
+const LAZY_COMPONENT_TAG = /* @__PURE__ */ Symbol.for("octane.lazy");
+const SUSPENSE_TAG = /* @__PURE__ */ Symbol.for("octane.suspense");
+const CHILDREN_BLOCK_TAG = /* @__PURE__ */ Symbol.for("octane.childrenBlock");
+const RENDERER_REGION_OWNER_TAG = /* @__PURE__ */ Symbol.for("octane.renderer-region.owner");
+const REACT_CONTEXT_TAG = /* @__PURE__ */ Symbol.for("react.context");
+export {
+  ACTIVITY_TAG,
+  CHILDREN_BLOCK_TAG,
+  CONTEXT_TAG,
+  ELEMENT_TAG,
+  FRAGMENT_TAG,
+  LAZY_COMPONENT_TAG,
+  PORTAL_TAG,
+  REACT_CONTEXT_TAG,
+  RENDERER_REGION_OWNER_TAG,
+  SUSPENSE_TAG
+};

package/dist/runtime.d.ts

@@ -19,6 +19,7 @@ import { EXTERNAL_HYDRATION_PROMISE, HYDRATION_RANGE_BOUNDARY } from './constant
 import type { HydrateProps } from './hydration/types.js';
 import type { IndependentHydrateActivator } from './hydration/independent-island.js';
 import { snapshotHydrationControl } from './hydration/event-capture.js';
+import { CONTEXT_TAG, ELEMENT_TAG, PORTAL_TAG } from './runtime-tags.js';
 import { validateNativeReadWitness, type NativeReadWitness } from './signals/native-read-collector.js';
 import { type NativeReadRetry } from './signals/native-read-retry.js';
 import type { SignalActionFrame } from './signals/transition-action.js';
@@ -935,7 +936,6 @@ export declare function useSyncExternalStore<T>(subscribe: (onStoreChange: () =>
  * suspended or failed render from leaking an uncommitted closure.
  */
 export declare function useEffectEvent<F extends (...args: any[]) => any>(fn: F, slot?: symbol): F;
-declare const CONTEXT_TAG: unique symbol;
 export interface Context<T> {
     (props: {
         value: T;
@@ -961,6 +961,8 @@ export interface Context<T> {
  * walks the Block parent chain to find the nearest Provider for that context.
  */
 export declare function createContext<T>(defaultValue: T): Context<T>;
+/** Compiler-owned private Context whose children are always compiled bodies. */
+export declare function __createCompiledContext<T>(defaultValue: T): Context<T>;
 /**
  * Identify the Context already provided by this deferred child's own scope
  * without observing userland Provider accessors or Proxy traps.
@@ -1008,6 +1010,8 @@ export declare function descriptorChildren<T>(component: T): T;
  */
 export declare function isChildrenBlock(value: unknown): boolean;
 export declare const Hydrate: ComponentBody<HydrateProps>;
+/** Compiler-owned template children with no authored fallback; never a descriptor entry point. */
+export declare const __HydrateCompiled: ComponentBody<HydrateProps>;
 /**
  * `<Suspense fallback={…}>…</Suspense>` — the JSX component form of
  * `@try { … } @pending { fallback }`, for authors writing JSX rather than the
@@ -1473,6 +1477,8 @@ export declare function child<T extends Node>(node: T): Node | null;
 export declare function sibling(node: Node, n?: number): Node | null;
 export declare function setText(node: Text, value: any): void;
 declare const DIRECT_SIGNAL_BINDING: unique symbol;
+/** @internal Invalidate scalar-view caches when hydration retained a claimed publication. */
+export declare function hydrateClaimedBindingCaches(scope: Scope, fields: readonly (string | number)[]): void;
 type DirectSignalBindingKind = 'text' | 'textOnlyChild' | 'attribute' | 'value' | 'checked';
 type DirectSignalAttributeKind = 'attr' | 'class' | 'booleanAttr' | 'ariaAttr' | 'stringData';
 interface DirectSignalBindingPolicy {
@@ -1779,7 +1785,7 @@ type HostPropSource = readonly [
     value?: unknown,
     merge?: boolean
 ];
-export declare function setHostPropSources(el: Element, sources: readonly HostPropSource[], prev: Record<string, unknown> | undefined, scope: Scope, hasNestedChildren?: boolean, readStyle?: (value: unknown) => unknown, deferControl?: boolean, writableTextareaValue?: boolean): Record<string, unknown>;
+export declare function setHostPropSources(el: Element, sources: readonly HostPropSource[], prev: Record<string, unknown> | undefined, scope: Scope, hasNestedChildren?: boolean, readStyle?: (value: unknown) => unknown, deferControl?: boolean): Record<string, unknown>;
 /** @internal Compiler target for spread-bearing hosts containing direct signals. */
 export declare function bindSignalHostPropSources(scope: Scope, previous: unknown, element: Element, sources: readonly HostPropSource[], site: string, hasNestedChildren?: boolean, readStyle?: (value: unknown) => unknown): unknown;
 export declare function setSpread(el: Element, value: any, prev: any, mountScope?: Scope, skipDangerouslySetInnerHTML?: boolean, skipFormControls?: boolean): void;
@@ -1880,7 +1886,7 @@ export declare function markNativeChangeDiagnosticStatic(el: Element): void;
  * attribute write never clobbers what the user typed, and it keeps SSR
  * output, form.reset() baselines, and differential byte-compares aligned.
  */
-export declare function setValue(el: Element, value: unknown, writableTextareaEcho?: boolean): void;
+export declare function setValue(el: Element, value: unknown): void;
 export declare function setChecked(el: Element, value: unknown): void;
 /**
  * Compiler-only checked binding for a statically-known checkbox/radio whose
@@ -1935,16 +1941,6 @@ interface PortalSlot {
  * down and removes its DOM from `target`.
  */
 export declare function portal(parentScope: Scope, slotKey: number, target: Element | DocumentFragment, body: ComponentBody, props: any, host?: Node, env?: any[], fragmentOwners?: FragmentInstance | readonly FragmentInstance[], fragmentAnchor?: Node): void;
-/**
- * `createPortal(children, target, keyOrProps?)`. A string/number third argument
- * is a reconciliation key. An object remains Octane's optional props for a
- * function portal body. The
- * compiler recognises `{createPortal(...)}` at JSX child position and lowers it to a
- * direct `portal(...)` runtime call — no descriptor allocation on the hot path. This
- * function exists so non-JSX call sites (storing in a variable, passing through props,
- * etc.) still produce something the runtime can dispatch on.
- */
-declare const PORTAL_TAG: unique symbol;
 export interface PortalDescriptor {
     $$kind: typeof PORTAL_TAG;
     key: string | null;
@@ -1953,7 +1949,6 @@ export interface PortalDescriptor {
     props: any;
 }
 export declare function createPortal(body: ComponentBody | ElementDescriptor | unknown, target: Element | DocumentFragment, props?: any): PortalDescriptor;
-declare const ELEMENT_TAG: unique symbol;
 export interface ElementDescriptor<P = any> {
     $$kind: typeof ELEMENT_TAG;
     type: ComponentBody<P> | string | typeof Fragment;