octane 0.3.1 → 0.3.2

package/dist/dom-binding-program.js

@@ -5,7 +5,13 @@ import {
   __releaseBinding,
   __writeBinding
 } from "./dom-bindings.js";
-import { encodeBindingKey, parseBindingMarker } from "./dom-binding-protocol.js";
+import {
+  bindingRootMarker,
+  BINDING_OPEN_PREFIX,
+  encodeBindingKey,
+  parseBindingMarker
+} from "./dom-binding-protocol.js";
+import { HYDRATION_FOR_PREFIX } from "./hydration-markers.js";
 import { moveNativeNodeBefore } from "./dom-focused-move.js";
 import { rendererRangeClose } from "./stream-protocol.js";
 import {
@@ -527,7 +533,7 @@ function createFragment(definition, id, document, transaction) {
   const template = document.createElement("template");
   template.innerHTML = definition.ns === 1 ? `<svg>${definition.html}</svg>` : definition.html;
   const content = document.createDocumentFragment();
-  const start = document.createComment(`[b;${id};root`);
+  const start = document.createComment(bindingRootMarker(id));
   const end = document.createComment("]");
   content.appendChild(start);
   if (definition.ns === 1) {
@@ -875,7 +881,8 @@ function commitRegion(plan, id, transaction) {
         transaction
       );
   }
-  if (definition.kind === "if") region.range.start.data = `[b;${id};${region.site};${plan.arm}`;
+  if (definition.kind === "if")
+    region.range.start.data = `${BINDING_OPEN_PREFIX}${id};${region.site};${plan.arm}`;
 }
 function writeText(region, value) {
   if (region.text === null) {
@@ -1469,13 +1476,13 @@ function commitList(plan, id, transaction) {
     }
     let anchor = region.range.end;
     for (const [key, item] of [...plan.items].reverse()) {
-      item.instance.range.start.data = `[b;${id};${region.site};k;${key}`;
+      item.instance.range.start.data = `${BINDING_OPEN_PREFIX}${id};${region.site};k;${key}`;
       moveRange(item.instance.range, region.range.end.parentNode, anchor, transaction);
       if (transaction.disposed) return;
       anchor = item.instance.range.start;
     }
   }
-  region.range.start.data = `[f${plan.arm};b;${id};${region.site}`;
+  region.range.start.data = `${HYDRATION_FOR_PREFIX}${plan.arm};b;${id};${region.site}`;
   return;
 }
 function claimProgramControl(instance, index, node, transaction) {

package/dist/dom-binding-protocol.d.ts

@@ -1,5 +1,12 @@
-/** Compiler-owned DOM presentation markers. This leaf is shared by client and SSR. */
 export type BindingKey = string | number;
+/** Payload prefix opening a presentation-binding range. */
+export declare const BINDING_OPEN_PREFIX: string;
+/**
+ * Comment payload opening an authored presentation view's own component range.
+ * The client runtime and the SSR serializer both stamp this onto the view they
+ * bind, so the two must never spell it separately.
+ */
+export declare function bindingRootMarker(id: string): string;
 export declare function encodeBindingKey(key: BindingKey): string;
 export declare function decodeBindingKey(encoded: string): BindingKey;
 export interface BindingMarker {
@@ -11,3 +18,9 @@ export interface BindingMarker {
 }
 export declare function parseBindingMarker(data: string): BindingMarker | null;
 export declare function isBindingOpenComment(data: string): boolean;
+/**
+ * True when a binding-open payload carries an `@for` outer arm. The prefix test
+ * alone is not a decision: `isBindingOpenComment` still requires the full
+ * receipt, so this only spares callers from spelling the arm prefixes again.
+ */
+export declare function isForBindingOpenComment(data: string): boolean;

package/dist/dom-binding-protocol.js

@@ -1,3 +1,21 @@
+import {
+  HYDRATION_FOR_ARM_INDEX,
+  HYDRATION_FOR_EMPTY,
+  HYDRATION_FOR_ITEMS,
+  HYDRATION_FOR_PREFIX,
+  HYDRATION_START
+} from "./hydration-markers.js";
+const BINDING_OPEN_PREFIX = HYDRATION_START + "b;";
+const BINDING_RECEIPT = ";b;";
+const BINDING_FOR_EMPTY_PREFIX = HYDRATION_FOR_EMPTY + BINDING_RECEIPT;
+const BINDING_FOR_ITEMS_PREFIX = HYDRATION_FOR_ITEMS + BINDING_RECEIPT;
+const BINDING_FOR_ID_START = BINDING_FOR_EMPTY_PREFIX.length;
+const BINDING_ID_START = BINDING_OPEN_PREFIX.length;
+const BINDING_ROOT_SITE = "root";
+const BINDING_ROOT_SUFFIX = ";" + BINDING_ROOT_SITE;
+function bindingRootMarker(id) {
+  return BINDING_OPEN_PREFIX + id + BINDING_ROOT_SUFFIX;
+}
 function encodeBindingKey(key) {
   if (typeof key === "string")
     return "s:" + JSON.stringify(key).replace(/-/g, "\\u002d").replace(/</g, "\\u003c");
@@ -17,21 +35,22 @@ function decodeBindingKey(encoded) {
   throw new TypeError("A DOM presentation key has invalid serialized identity.");
 }
 function parseBindingMarker(data) {
-  if (data.startsWith("[f0;b;") || data.startsWith("[f1;b;")) {
-    const separator = data.indexOf(";", 6);
-    if (separator <= 6 || separator === data.length - 1) return null;
+  if (data.startsWith(BINDING_FOR_EMPTY_PREFIX) || data.startsWith(BINDING_FOR_ITEMS_PREFIX)) {
+    const separator = data.indexOf(";", BINDING_FOR_ID_START);
+    if (separator <= BINDING_FOR_ID_START || separator === data.length - 1) return null;
     return {
-      id: data.slice(6, separator),
+      id: data.slice(BINDING_FOR_ID_START, separator),
       site: data.slice(separator + 1),
       kind: "for",
-      arm: data.charCodeAt(2) - 48
+      arm: data.charCodeAt(HYDRATION_FOR_ARM_INDEX) - 48
     };
   }
-  if (!data.startsWith("[b;")) return null;
-  const idEnd = data.indexOf(";", 3);
-  if (idEnd <= 3 || idEnd === data.length - 1) return null;
-  const id = data.slice(3, idEnd);
-  if (data.slice(idEnd + 1) === "root") return { id, site: "root", kind: "root" };
+  if (!data.startsWith(BINDING_OPEN_PREFIX)) return null;
+  const idEnd = data.indexOf(";", BINDING_ID_START);
+  if (idEnd <= BINDING_ID_START || idEnd === data.length - 1) return null;
+  const id = data.slice(BINDING_ID_START, idEnd);
+  if (data.slice(idEnd + 1) === BINDING_ROOT_SITE)
+    return { id, site: BINDING_ROOT_SITE, kind: "root" };
   const siteEnd = data.indexOf(";", idEnd + 1);
   if (siteEnd <= idEnd + 1 || siteEnd === data.length - 1) return null;
   const site = data.slice(idEnd + 1, siteEnd);
@@ -56,13 +75,14 @@ function parseBindingMarker(data) {
   return null;
 }
 function isBindingOpenComment(data) {
-  const list = data.startsWith("[f0;b;") || data.startsWith("[f1;b;");
-  if (!list && !data.startsWith("[b;")) return false;
-  const idStart = list ? 6 : 3;
+  const list = data.startsWith(BINDING_FOR_EMPTY_PREFIX) || data.startsWith(BINDING_FOR_ITEMS_PREFIX);
+  if (!list && !data.startsWith(BINDING_OPEN_PREFIX)) return false;
+  const idStart = list ? BINDING_FOR_ID_START : BINDING_ID_START;
   const idEnd = data.indexOf(";", idStart);
   if (idEnd <= idStart || idEnd === data.length - 1) return false;
   if (list) return data.indexOf(";", idEnd + 1) === -1;
-  if (data.length - idEnd === 5 && data.endsWith(";root")) return true;
+  if (data.length - idEnd === BINDING_ROOT_SUFFIX.length && data.endsWith(BINDING_ROOT_SUFFIX))
+    return true;
   const siteEnd = data.indexOf(";", idEnd + 1);
   if (siteEnd <= idEnd + 1 || siteEnd === data.length - 1) return false;
   const tail = siteEnd + 1;
@@ -80,9 +100,15 @@ function isBindingOpenComment(data) {
   }
   return true;
 }
+function isForBindingOpenComment(data) {
+  return data.startsWith(HYDRATION_FOR_PREFIX) && isBindingOpenComment(data);
+}
 export {
+  BINDING_OPEN_PREFIX,
+  bindingRootMarker,
   decodeBindingKey,
   encodeBindingKey,
   isBindingOpenComment,
+  isForBindingOpenComment,
   parseBindingMarker
 };

package/dist/hydration/control-capture.d.ts

@@ -45,6 +45,8 @@ export interface HydrationControlCandidateValue {
  * the state changed while ownership was being transferred.
  */
 export declare function snapshotHydrationControl(control: Element): HydrationControlSnapshot | null;
+/** @internal Only unchanged server state may yield to an eventless textarea restore. */
+export declare function isRestoredHydrationTextarea(control: Element, value: unknown): boolean;
 /**
  * Capture the exact DOM/edit authority an async storage read is allowed to replace.
  * A focus, selection, composition, input (including clear), node replacement, or

package/dist/hydration/control-capture.js

@@ -1,4 +1,10 @@
-import { HYDRATE_INDEPENDENT_ATTR, HYDRATE_INPUT_ATTR } from "../hydration-markers.js";
+import {
+  HYDRATE_ID_ATTR,
+  HYDRATE_INDEPENDENT_ATTR,
+  HYDRATE_INPUT_ATTR,
+  HYDRATE_MARKER_SELECTOR,
+  HYDRATE_WHEN_ATTR
+} from "../hydration-markers.js";
 import {
   EARLY_HYDRATION_INTENTS_KEY,
   HYDRATE_INTERACTION_EVENTS_ATTR
@@ -9,10 +15,9 @@ import {
   publishHydrationControlSignalValues,
   readEarlyHydrationControlRevision
 } from "../signals/early-values.js";
-const HYDRATE_MARKER_SELECTOR = "[data-octane-hydrate-id]";
 const HYDRATE_CONTROL_DOCUMENTS = /* @__PURE__ */ new WeakSet();
 function isEarlyHydrationIntentCurrent([event, target, boundary, id, when, events], ownerDocument) {
-  return event.target === target && target.isConnected && boundary.isConnected && target.ownerDocument === ownerDocument && boundary.ownerDocument === ownerDocument && target.closest(`[${HYDRATE_INDEPENDENT_ATTR}]`) === boundary && boundary.getAttribute("data-octane-hydrate-id") === id && boundary.getAttribute("data-octane-hydrate-when") === when && boundary.getAttribute(HYDRATE_INTERACTION_EVENTS_ATTR) === events;
+  return event.target === target && target.isConnected && boundary.isConnected && target.ownerDocument === ownerDocument && boundary.ownerDocument === ownerDocument && target.closest(`[${HYDRATE_INDEPENDENT_ATTR}]`) === boundary && boundary.getAttribute(HYDRATE_ID_ATTR) === id && boundary.getAttribute(HYDRATE_WHEN_ATTR) === when && boundary.getAttribute(HYDRATE_INTERACTION_EVENTS_ATTR) === events;
 }
 function isHydrationElement(target) {
   return target !== null && target.nodeType === 1;
@@ -108,6 +113,13 @@ function snapshotHydrationControl(control) {
     composing: record?.composing ?? false
   };
 }
+function isRestoredHydrationTextarea(control, value) {
+  if (control.localName !== "textarea" || typeof value !== "string" || HYDRATE_CONTROL_RECORDS.get(control)?.composing === true)
+    return false;
+  const textarea = control;
+  const baseline = textarea.defaultValue.replace(/\r\n?/g, "\n");
+  return value.replace(/\r\n?/g, "\n") === baseline && textarea.value !== baseline;
+}
 function captureHydrationControlCandidate(control) {
   const snapshot = snapshotHydrationControl(control);
   if (snapshot === null) return null;
@@ -115,7 +127,7 @@ function captureHydrationControlCandidate(control) {
   return {
     control,
     bindingId: control.getAttribute(HYDRATE_INPUT_ATTR),
-    boundaryId: control.closest(HYDRATE_MARKER_SELECTOR)?.getAttribute("data-octane-hydrate-id") ?? null,
+    boundaryId: control.closest(HYDRATE_MARKER_SELECTOR)?.getAttribute(HYDRATE_ID_ATTR) ?? null,
     snapshot
   };
 }
@@ -130,7 +142,7 @@ function sameHydrationControlValue(left, right) {
 }
 function applyHydrationControlCandidate(candidate, value) {
   const control = candidate.control;
-  if (!control.isConnected || control.getAttribute(HYDRATE_INPUT_ATTR) !== candidate.bindingId || (control.closest(HYDRATE_MARKER_SELECTOR)?.getAttribute("data-octane-hydrate-id") ?? null) !== candidate.boundaryId) {
+  if (!control.isConnected || control.getAttribute(HYDRATE_INPUT_ATTR) !== candidate.bindingId || (control.closest(HYDRATE_MARKER_SELECTOR)?.getAttribute(HYDRATE_ID_ATTR) ?? null) !== candidate.boundaryId) {
     return false;
   }
   const current = snapshotHydrationControl(control);
@@ -219,5 +231,6 @@ export {
   consumeHydrationControl,
   initializeHydrationControlCapture,
   isEarlyHydrationIntentCurrent,
+  isRestoredHydrationTextarea,
   snapshotHydrationControl
 };

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-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/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;
@@ -1477,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 {
@@ -1783,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;
@@ -1884,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
@@ -1939,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;
@@ -1957,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;