octane 0.2.2 → 0.2.3

package/dist/compiler/slot-hooks.js

@@ -5,15 +5,16 @@
 // byte-for-byte. Production bundlers may additionally select the separate
 // whole-AST memo path, which preserves TypeScript and supplies a source map.
 //
-// This pass parses the module (for byte offsets), finds ONLY octane BASE hook
-// calls, and splices a trailing compiler slot into each — every other byte (all the
-// TS the printer can't handle) passes through verbatim. It does NOT wrap custom
-// hooks in `withSlot` (that's done by the `.tsrx`/`.tsx` CALLER, and wrapping a
-// hand-written binding that already forwards a slot would double-slot it). In
+// This pass parses the module (for byte offsets), slots Octane base hooks and
+// gives imported custom hooks their own withSlot boundary. Imported aliases can
+// point directly at a base hook, so the enclosing component's boundary alone
+// cannot distinguish their call sites. Local helpers retain their authored slot
+// policy; explicitly manual modules opt out of all injected slots. In
 // production it reserves a collision-free runtime range because these arbitrary
 // helpers can execute in a Scope alongside code from any other source module.
 
 import { parseModule } from '@tsrx/core';
+import { parseModule as parseFallbackModule } from '#octane/compiler-parser';
 import { HOOK_NAMES, hookSlotHash } from './compile.js';
 import { NATIVE_SIGNAL_HOOK_NAMES } from './hook-names.js';
 import { METHOD_DEP_IMPORT, annotateHookCalls } from './hook-deps.js';
@@ -21,6 +22,7 @@ import { inlinePlainHookMemos } from './plain-hook-memo.js';
 import { assertStrongMode } from './strong-mode.js';
 import { assertNativeReadDiagnostics, assertNativeReadOptions } from './native-read-diagnostics.js';
 import { nativeReadActivationIndex } from './native-read-codegen.js';
+import { findManualHookProviders, manualHookWrapperParameters } from './manual-hooks.js';
 
 function importsNativeRenderer(ast) {
 	return ast.body.some(
@@ -42,6 +44,7 @@ function octaneHookLocals(ast, nativeReads = false) {
 	const locals = new Map();
 	let importsHook = false;
 	let hasOctaneImport = false;
+	let importsCustomHook = false;
 	for (const node of ast.body || []) {
 		if (
 			(node.type === 'ExportNamedDeclaration' || node.type === 'ExportAllDeclaration') &&
@@ -51,6 +54,15 @@ function octaneHookLocals(ast, nativeReads = false) {
 			continue;
 		}
 		if (node.type !== 'ImportDeclaration') continue;
+		if (node.importKind === 'type') continue;
+		for (const sp of node.specifiers || []) {
+			if (
+				sp.importKind !== 'type' &&
+				(/^use[A-Z]/.test(sp.imported?.name ?? '') || /^use[A-Z]/.test(sp.local?.name ?? ''))
+			) {
+				importsCustomHook = true;
+			}
+		}
 		const native =
 			nativeReads &&
 			(node.source?.value === 'octane/signals/client' ||
@@ -76,7 +88,11 @@ function octaneHookLocals(ast, nativeReads = false) {
 				importsHook = true;
 		}
 	}
-	return { locals, importsHook, hasOctaneImport };
+	return {
+		locals,
+		importsHook: importsHook || (hasOctaneImport && importsCustomHook),
+		hasOctaneImport,
+	};
 }
 
 // Find only the disposable top-level root shape used by production entries:
@@ -158,7 +174,7 @@ function collectVoidRootCandidates(ast) {
 export function findVoidRootImports(source, id) {
 	let ast;
 	try {
-		ast = parseModule(source, id);
+		ast = parseHookSource(source, id).ast;
 	} catch {
 		return [];
 	}
@@ -236,7 +252,7 @@ export function findVoidComponentImports(source, id) {
 		ast = source;
 	} else {
 		try {
-			ast = parseModule(source, id);
+			ast = parseHookSource(source, id).ast;
 		} catch {
 			return [];
 		}
@@ -737,6 +753,19 @@ function collectStateGetterCalls(ast) {
 	return calls;
 }
 
+function collectStateGetterEdit(node, imported, st) {
+	if (!st.getterCalls.has(node) || !STATE_GETTER_HELPERS[imported]) return;
+	let helper = st.getterHelpers.get(imported);
+	if (helper === undefined) {
+		const base = `_$${STATE_GETTER_HELPERS[imported]}`;
+		helper = base;
+		let suffix = 0;
+		while (st.source.includes(helper)) helper = `${base}$${++suffix}`;
+		st.getterHelpers.set(imported, helper);
+	}
+	st.edits.push({ pos: node.callee.start, end: node.callee.end, text: helper });
+}
+
 // DFS in SOURCE ORDER, allocating a hook's slot id BEFORE descending into its args
 // — identical pre-order to rewriteHookCalls, so a base hook nested as an argument
 // (e.g. in a deps array) gets its own stable id. Collects insertion edits + the
@@ -954,6 +983,20 @@ function collectParallelUseEdits(ast, st) {
 	scan(ast.body, hookOwner(null, 'module'));
 }
 
+// Locate the call delimiter after the callee/type arguments without consuming
+// comments or TypeScript syntax. Parenthesized identifier callees are valid too.
+function callOpenParen(node, source) {
+	let pos = node.typeArguments?.end ?? node.callee.end;
+	while (pos < node.end) {
+		if (/\s/.test(source[pos]) || source[pos] === ')') pos++;
+		else if (source.startsWith('/*', pos)) pos = source.indexOf('*/', pos + 2) + 2;
+		else if (source.startsWith('//', pos)) {
+			while (pos < node.end && source[pos] !== '\n' && source[pos] !== '\r') pos++;
+		} else return source[pos] === '(' ? pos : -1;
+	}
+	return -1;
+}
+
 function walk(node, owner, st) {
 	if (!node || typeof node !== 'object') return;
 	if (Array.isArray(node)) {
@@ -976,10 +1019,24 @@ function walk(node, owner, st) {
 		node.type === 'FunctionDeclaration' && node.id ? hookOwner(node, node.id.name) : owner;
 
 	if (node.type === 'CallExpression') {
+		if (!st.manualSlots && node._octaneCustomHookCall) {
+			const open = callOpenParen(node, st.source);
+			if (open !== -1) {
+				const sym = allocHookSymbol(st, owner, node.callee.name, node._octaneCustomHookCall, node);
+				const helper = requireParallelHelper(st, 'withSlot');
+				// The path stack supplies identity without changing the authored
+				// argument list. An alias may point at a foreign hook whose omitted
+				// parameter has a default, rather than at Octane's trailing-slot ABI.
+				st.edits.push({ pos: node.start, text: `${helper}(${sym}, ` });
+				st.edits.push({ pos: open, end: open + 1, text: node.arguments.length ? ', ' : '' });
+			}
+		}
 		const imported =
 			node._octaneImportedHook ??
 			(st.nativeReads ? node._octaneHookRuntimeImportedHook : undefined);
+		collectStateGetterEdit(node, imported, st);
 		if (
+			!st.manualSlots &&
 			imported &&
 			(HOOK_NAMES.has(imported) || (st.nativeReads && NATIVE_SIGNAL_HOOK_NAMES.has(imported)))
 		) {
@@ -996,7 +1053,17 @@ function walk(node, owner, st) {
 					text: requireParallelHelper(st, 'nativePuMemo'),
 				});
 			}
-			if (inferred !== undefined) {
+			if (
+				(imported === 'useState' || imported === 'useRef') &&
+				node.arguments.some((arg) => arg.type === 'SpreadElement')
+			) {
+				const open = callOpenParen(node, st.source);
+				if (open !== -1) {
+					const helper = requireParallelHelper(st, 'withSlot');
+					st.edits.push({ pos: node.start, text: `${helper}(${sym}, ` });
+					st.edits.push({ pos: open, end: open + 1, text: ', ' });
+				}
+			} else if (inferred !== undefined) {
 				// The dependency callback is already the final user argument. Insert
 				// both the generated array and slot in one edit so equal-position edit
 				// ordering cannot reverse them. Dependency nodes retain original source
@@ -1016,11 +1083,11 @@ function walk(node, owner, st) {
 					text: `, [${deps}], ${sym}`,
 				});
 			} else if (node.arguments.length === 0) {
-				// `useId()` → `useId(_h$N)`. Symbols remain self-identifying when
-				// optional user arguments are omitted.
+				// State/ref initializers may themselves be Symbols. Reserve their
+				// authored position even when empty; other hooks keep their ABI.
 				st.edits.push({
 					pos: node.end - 1,
-					text: sym,
+					text: imported === 'useState' || imported === 'useRef' ? `undefined, ${sym}` : sym,
 				});
 			} else {
 				// `useState(0)` → `useState(0, _h$N)` — insert AFTER the last arg's end so
@@ -1030,17 +1097,6 @@ function walk(node, owner, st) {
 					text: ', ' + sym,
 				});
 			}
-			if (st.getterCalls.has(node) && STATE_GETTER_HELPERS[imported]) {
-				let helper = st.getterHelpers.get(imported);
-				if (helper === undefined) {
-					const base = `_$${STATE_GETTER_HELPERS[imported]}`;
-					helper = base;
-					let suffix = 0;
-					while (st.source.includes(helper)) helper = `${base}$${++suffix}`;
-					st.getterHelpers.set(imported, helper);
-				}
-				st.edits.push({ pos: node.callee.start, end: node.callee.end, text: helper });
-			}
 		}
 	}
 
@@ -1051,8 +1107,59 @@ function walk(node, owner, st) {
 	}
 }
 
+function collectManualHookEdits(ast, providers, st) {
+	function visit(node) {
+		if (!node || typeof node !== 'object') return;
+		if (Array.isArray(node)) {
+			for (const item of node) visit(item);
+			return;
+		}
+		if (providers.has(node)) {
+			if (node.type === 'FunctionDeclaration') {
+				const helper = requireParallelHelper(st, 'invokeManualHook');
+				const implementation = allocSlotName(st, `_$manual_${node.id.name}`);
+				const params = manualHookWrapperParameters(node)
+					.map((param) => param.name)
+					.join(', ');
+				st.edits.push({
+					pos: node.start,
+					text: `function ${node.id.name}(${params}) { return ${helper}(${implementation}, this, arguments); } `,
+				});
+				st.edits.push({ pos: node.id.start, end: node.id.end, text: implementation });
+			} else {
+				const helper = requireParallelHelper(st, 'manualHook');
+				st.edits.push({ pos: node.start, text: `/* @__PURE__ */ ${helper}(` });
+				st.edits.push({ pos: node.end, text: `, ${JSON.stringify(providers.get(node))})` });
+			}
+		}
+		for (const key in node) {
+			if (key === 'loc' || key === 'metadata' || key === 'parent' || key.startsWith('_octane'))
+				continue;
+			const value = node[key];
+			if (value && typeof value === 'object') visit(value);
+		}
+	}
+	visit(ast);
+}
+
+function parseHookSource(source, id) {
+	try {
+		return { ast: parseModule(source, id), canPrint: true };
+	} catch (error) {
+		if (!(error instanceof SyntaxError)) throw error;
+		// Some binding signatures (const generics in function types) need the
+		// native parser. Its object-TS dialect retains types and source offsets,
+		// but drops type parentheses required by the Program printer. Keep that
+		// AST on the surgical path so every authored type stays byte-for-byte.
+		return {
+			ast: parseFallbackModule(source, `${id.split(/[?#]/, 1)[0]}.object.ts`),
+			canPrint: false,
+		};
+	}
+}
+
 /**
- * Inject per-call-site hook slots into octane BASE hook calls in a plain
+ * Inject per-call-site hook slots into Octane base and imported/aliased hook calls in a plain
  * `.ts`/`.js` module. Returns `null` (pass through unchanged) when the module
  * imports no octane base hook or calls none.
  *
@@ -1064,8 +1171,8 @@ function walk(node, owner, st) {
  *   runtime-ranged Symbols. Profiling retains short described Symbols because
  *   hook metadata is keyed by Symbol identity.
  *   `inlineHookMemo: true` enables the production-client whole-AST memo path;
- *   the default remains surgical. `manualSlots: true` permits only that memo
- *   rewrite and never injects or changes the module's authored slot policy.
+ *   the default remains surgical. `manualSlots: true` permits memo and observed
+ *   getter rewrites without injecting or changing the authored slot policy.
  * @returns {{ code: string, map: any } | null}
  */
 export function slotHooks(source, id, options) {
@@ -1077,21 +1184,29 @@ export function slotHooks(source, id, options) {
 		);
 	}
 	let ast;
+	let canPrint;
 	try {
-		ast = parseModule(source, id);
+		({ ast, canPrint } = parseHookSource(source, id));
 	} catch {
 		return null; // let the normal pipeline surface the parse error
 	}
 	assertStrongMode(ast, source, id, options);
 	assertNativeReadDiagnostics(ast, source, id, options);
 	const importInfo = octaneHookLocals(ast, options?.nativeReads === true);
+	const manualProviders = options?.manualSlots ? findManualHookProviders(ast) : new Map();
 	const nativeReadActivation = options?.nativeReads === true && importsNativeRenderer(ast);
 	const canSpecializeRoot =
+		!options?.manualSlots &&
 		!options?.hmr &&
 		!options?.profile &&
 		typeof options?.isVoidComponentImport === 'function' &&
 		importInfo.hasOctaneImport;
-	if (!importInfo.importsHook && !canSpecializeRoot && !nativeReadActivation) {
+	if (
+		!importInfo.importsHook &&
+		!canSpecializeRoot &&
+		!nativeReadActivation &&
+		!manualProviders.size
+	) {
 		return null;
 	}
 	// The parsed tree is never mutated: annotateHookCalls returns a COW-rebuilt
@@ -1114,6 +1229,7 @@ export function slotHooks(source, id, options) {
 	}
 	const getterCalls = importInfo.importsHook ? collectStateGetterCalls(ast) : new WeakSet();
 	if (
+		canPrint &&
 		options?.inlineHookMemo === true &&
 		environment === 'client' &&
 		!options?.hmr &&
@@ -1137,9 +1253,8 @@ export function slotHooks(source, id, options) {
 		});
 		if (inlined !== null) return inlined;
 	}
-	if (options?.manualSlots === true && !nativeReadActivation) return null;
-
 	const st = {
+		manualSlots: options?.manualSlots === true,
 		nativeReads: options?.nativeReads === true,
 		locals: importInfo.locals,
 		source,
@@ -1163,10 +1278,13 @@ export function slotHooks(source, id, options) {
 		voidRootName: null,
 	};
 	if (!st.hmr && !st.profile) st.slotBaseName = allocSlotName(st, '_hs$');
-	if (importInfo.importsHook && options?.manualSlots !== true) {
-		collectParallelUseEdits(ast, st);
+	if (importInfo.importsHook) {
+		if (!st.manualSlots) collectParallelUseEdits(ast, st);
 		for (const node of ast.body || []) walk(node, hookOwner(null, 'module'), st);
 	}
+	if (manualProviders.size) {
+		collectManualHookEdits(ast, findManualHookProviders(ast), st);
+	}
 	if (canSpecializeRoot) {
 		collectVoidRootEdits(ast, st, options.isVoidComponentImport);
 	}
@@ -1210,9 +1328,10 @@ export function slotHooks(source, id, options) {
 	const otherHelperImports = [...otherHelpers]
 		.map(([request, specifiers]) => `import { ${specifiers.join(', ')} } from '${request}';\n`)
 		.join('');
-	const profileImport = st.profile
-		? "import { __profileHook as _$__profileHook } from 'octane/profiling';\n"
-		: '';
+	const profileImport =
+		st.profile && !st.manualSlots
+			? "import { __profileHook as _$__profileHook } from 'octane/profiling';\n"
+			: '';
 	const slotBase =
 		!st.hmr && !st.profile && st.nextId > 0
 			? `const ${st.slotBaseName} = /* @__PURE__ */ ${st.hookSlotsName}(${st.nextId});\n`

package/dist/component-flags.d.ts

@@ -1,6 +1,6 @@
 /** The component owns a load-bearing runtime/SSR boundary range. */
 export declare const COMPONENT_FLAG_BOUNDARY: number;
 /** Attach an immutable capability bitmask without retaining concrete component identities. */
-export declare function markComponentFlags<T extends Function>(component: T, flags: number, name: string): T;
+export declare function markComponentFlags<T extends Function>(component: T, flags: number, name: string, kind?: symbol): T;
 /** Test compiler/runtime capability bits on a component from any Octane runtime copy. */
 export declare function hasComponentFlags(component: unknown, flags: number): boolean;

package/dist/component-flags.js

@@ -1,9 +1,16 @@
 import { hasOwnProp } from "./has-own.js";
 const OCTANE_COMPONENT_FLAGS = /* @__PURE__ */ Symbol.for("octane.flags.component");
 const COMPONENT_FLAG_BOUNDARY = 1 << 0;
-function markComponentFlags(component, flags, name) {
+function markComponentFlags(component, flags, name, kind) {
   Object.defineProperty(component, OCTANE_COMPONENT_FLAGS, { value: flags });
   Object.defineProperty(component, "name", { value: name, configurable: true });
+  if (kind !== void 0) {
+    Object.defineProperty(component, kind, {
+      get() {
+        return this === component;
+      }
+    });
+  }
   return component;
 }
 function hasComponentFlags(component, flags) {

package/dist/dom-tables.js

@@ -398,6 +398,7 @@ for (const base of [
   "opacity",
   "order",
   "orphans",
+  "scale",
   "tabSize",
   "widows",
   "zIndex",
@@ -428,6 +429,7 @@ function cssStyleValue(name, value) {
   return typeof value === "string" ? value.trim() : "" + value;
 }
 function hyphenateStyleName(name) {
+  if (name === "cssFloat") return "float";
   if (name.charCodeAt(0) === 45) return name;
   let hasUpper = false;
   for (let i = 0; i < name.length; i++) {

package/dist/error-codes.client.generated.d.ts

@@ -26,7 +26,6 @@ type ClientErrorArguments = {
     25: [];
     26: [unknown];
     27: [];
-    28: [];
     29: [];
     46: [unknown, unknown];
     49: [];
@@ -38,6 +37,9 @@ type ClientErrorArguments = {
     55: [];
     56: [];
     58: [];
+    61: [];
+    62: [];
+    63: [];
 };
 export declare function formatClientError<Code extends keyof ClientErrorArguments>(code: Code, ...args: ClientErrorArguments[Code]): string;
 export {};

package/dist/error-codes.client.generated.js

@@ -129,8 +129,6 @@ function formatClientError(code, ...args) {
           "A hosted foreign-context request escaped its renderer-region owner; the owning bridge is gone or declined it.",
           args
         );
-      case 28:
-        return formatDevErrorMessage("Target container is not a DOM element.", args);
       case 29:
         return formatDevErrorMessage("Cannot update an unmounted root.", args);
       case 46:
@@ -177,6 +175,21 @@ function formatClientError(code, ...args) {
         );
       case 58:
         return formatDevErrorMessage("Unsupported native-read compiler/runtime version.", args);
+      case 61:
+        return formatDevErrorMessage(
+          "Hydration mismatch: the server-rendered text differed from the client; the text was updated to the client value.",
+          args
+        );
+      case 62:
+        return formatDevErrorMessage(
+          "Hydration mismatch: the server rendered extra children in a text element; the stale children were discarded.",
+          args
+        );
+      case 63:
+        return formatDevErrorMessage(
+          "Target container is not a DOM element. Pass an Element, Document, or DocumentFragment. If document.body is null after document hydration, update the existing document root or render a document shell containing <body>.",
+          args
+        );
       default:
         return formatUnknownDevErrorMessage(code);
     }

package/dist/error-codes.server.generated.d.ts

@@ -30,6 +30,7 @@ type ServerErrorArguments = {
     57: [];
     58: [];
     59: [unknown];
+    60: [];
 };
 export declare function formatServerError<Code extends keyof ServerErrorArguments>(code: Code, ...args: ServerErrorArguments[Code]): string;
 export {};

package/dist/error-codes.server.generated.js

@@ -125,6 +125,11 @@ function formatServerError(code, ...args) {
         return formatDevErrorMessage("Unsupported native-read compiler/runtime version.", args);
       case 59:
         return formatDevErrorMessage("%s requires an active server component.", args);
+      case 60:
+        return formatDevErrorMessage(
+          "A component suspended without a Suspense boundary during synchronous server rendering. Use prerender() or a streaming renderer to await it.",
+          args
+        );
       default:
         return formatUnknownDevErrorMessage(code);
     }

package/dist/event-names.d.ts

@@ -0,0 +1 @@
+export function isDelegatedEventProp(name: string): boolean;

package/dist/event-names.js

@@ -0,0 +1,15 @@
+const names = "Abort AnimationEnd AnimationIteration AnimationStart AuxClick BeforeInput BeforeToggle Blur Cancel CanPlay CanPlayThrough Change Click Close CompositionEnd CompositionStart CompositionUpdate ContextMenu Copy Cut DoubleClick Drag DragEnd DragEnter DragExit DragLeave DragOver DragStart Drop DurationChange Emptied Encrypted Ended Error Focus GotPointerCapture Input Invalid KeyDown KeyPress KeyUp Load LoadedData LoadedMetadata LoadStart LostPointerCapture MouseDown MouseEnter MouseLeave MouseMove MouseOut MouseOver MouseUp Paste Pause Play Playing PointerCancel PointerDown PointerEnter PointerLeave PointerMove PointerOut PointerOver PointerUp Progress RateChange Reset Resize Scroll ScrollEnd Seeked Seeking Select Stalled Submit Suspend TimeUpdate Toggle TouchCancel TouchEnd TouchMove TouchStart TransitionCancel TransitionEnd TransitionRun TransitionStart VolumeChange Waiting Wheel";
+let delegatedEventProps;
+function isDelegatedEventProp(name) {
+  if (delegatedEventProps === void 0) {
+    delegatedEventProps = /* @__PURE__ */ new Set();
+    for (const event of names.split(" ")) {
+      delegatedEventProps.add("on" + event);
+      delegatedEventProps.add("on" + event + "Capture");
+    }
+  }
+  return delegatedEventProps.has(name);
+}
+export {
+  isDelegatedEventProp
+};

package/dist/html-tree-validation.d.ts

@@ -1,34 +1,17 @@
-/**
- * HTML parser-repair rules used by DEV client and SSR nesting diagnostics.
- *
- * This is intentionally narrower than the full HTML content model: it only
- * lists placements the browser repairs while parsing serialized HTML, because
- * those repairs can change the DOM before hydration. Adapted from Svelte's
- * html-tree-validation module, which Ripple also uses.
- *
- * Copyright (c) 2016-2025 Svelte Contributors
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
- * SOFTWARE.
- */
-/** Return a diagnostic when `childTag` causes an ancestor to be repaired. */
-export declare function invalidHtmlNestingWithAncestor(childTag: string, ancestors: string[], childLocation?: string, ancestorLocation?: string): string | null;
-/** Return a diagnostic when `childTag` causes its direct parent to be repaired. */
-export declare function invalidHtmlNestingWithParent(childTag: string, parentTag: string, childLocation?: string, parentLocation?: string): string | null;
-/** Return a diagnostic when visible or whitespace text cannot remain under its parent. */
-export declare function invalidHtmlTextNesting(text: string, parentTag: string, parentLocation?: string): string | null;
+export declare function invalidHtmlNestingWithAncestor(
+	childTag: string,
+	ancestors: string[],
+	childLocation?: string,
+	ancestorLocation?: string,
+): string | null;
+export declare function invalidHtmlNestingWithParent(
+	childTag: string,
+	parentTag: string,
+	childLocation?: string,
+	parentLocation?: string,
+): string | null;
+export declare function invalidHtmlTextNesting(
+	text: string,
+	parentTag: string,
+	parentLocation?: string,
+): string | null;

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 export { version } from './version.js';
+export type * from './public-types.js';
+export { StrictMode, unstable_batchedUpdates } from './compatibility.js';
 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, type Root, type RootOptions, useState, useLinkedState, type LinkedStatePrevious, type LinkedStateOptions, useReducer, useEffect, useLayoutEffect, useInsertionEffect, useMemo, useCallback, useRef, useId, useImperativeHandle, useEffectEvent, useSyncExternalStore, useDeferredValue, useTransition, useActionState, 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, Children, type ElementDescriptor, type ComponentBody, type OctaneNode, TsrxErrorBoundary, __useStateWithGetter, __useLinkedStateWithGetter, __useReducerWithGetter, __createVoidRoot, 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, evtN, evtNu, setEventHandler, devEventListener, devHtmlNesting, htext, htextSwap, child, sibling, setText, setScriptText, setHTML, setDangerouslySetInnerHTML, setDangerouslySetInnerHTMLSources, markDangerouslySetInnerHTMLChildren, setAttribute, setStringData, setBooleanAttribute, setAriaAttribute, setClassName, setClassAttr, normalizeClass, setStyle, setStyleProperty, 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, markSingleRoot as __s, markChildrenBlock, descriptorChildren, createScopedValue, createScopedElement, childSlot, positionalChildren, textSlot, textHole, childTextHole, hostComponent, renderBlock, portal, hookSlots, withSlot, useBatch, 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, 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, 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, evtN, evtNu, setEventHandler, devEventListener, devHtmlNesting, htext, htextSwap, child, sibling, setText, setScriptText, setHTML, setDangerouslySetInnerHTML, setDangerouslySetInnerHTMLSources, markDangerouslySetInnerHTMLChildren, setAttribute, setStringData, setBooleanAttribute, setAriaAttribute, setClassName, setClassAttr, normalizeClass, setStyle, setStyleProperty, 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, 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 { __methodDep } from './method-dep.js';

package/dist/index.js

@@ -1,4 +1,5 @@
 import { version } from "./version.js";
+import { StrictMode, unstable_batchedUpdates } from "./compatibility.js";
 import { initializeHydrationEventCapture } from "./hydration/event-capture.js";
 import { attachBehaviorRoot } from "./behavior-root.js";
 import {
@@ -26,6 +27,7 @@ import {
   useDeferredValue,
   useTransition,
   useActionState,
+  useActionState as useActionState2,
   useFormStatus,
   useOptimistic,
   useDebugValue,
@@ -58,6 +60,7 @@ import {
   cloneElement,
   isValidElement,
   isChildrenBlock,
+  descriptorChildren,
   Children,
   TsrxErrorBoundary,
   __useStateWithGetter,
@@ -170,9 +173,9 @@ import {
   compilerCacheContext,
   compilerOwnsContextProvider,
   markSingleRoot,
+  markWarm,
   markSingleRoot as markSingleRoot2,
   markChildrenBlock,
-  descriptorChildren,
   createScopedValue,
   createScopedElement,
   childSlot,
@@ -185,6 +188,8 @@ import {
   portal,
   hookSlots,
   withSlot,
+  manualHook,
+  invokeManualHook,
   useBatch,
   seedOrCreate,
   warmMemo,
@@ -220,6 +225,7 @@ export {
   HMR,
   HYDRATION_RANGE_BOUNDARY,
   Hydrate,
+  StrictMode,
   Suspense,
   TsrxErrorBoundary,
   ViewTransition,
@@ -310,15 +316,18 @@ export {
   ifBlock,
   initializeHydrationEventCapture,
   injectStyle,
+  invokeManualHook,
   isChildrenBlock,
   isValidElement,
   keyedForBlock,
   lazy,
+  manualHook,
   mapSlot,
   markChildrenBlock,
   markDangerouslySetInnerHTMLChildren,
   markNativeChangeDiagnosticStatic,
   markSingleRoot,
+  markWarm,
   memo,
   mountFragmentRef,
   namespaceHead,
@@ -393,6 +402,7 @@ export {
   Activity2 as unstable_Activity,
   ViewTransition2 as unstable_ViewTransition,
   addTransitionType2 as unstable_addTransitionType,
+  unstable_batchedUpdates,
   use,
   useActionState,
   useBatch,
@@ -402,6 +412,7 @@ export {
   useDeferredValue,
   useEffect,
   useEffectEvent,
+  useActionState2 as useFormState,
   useFormStatus,
   useId,
   useImperativeHandle,