@octanejs/app-core 0.1.6 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octanejs/app-core",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -79,10 +79,10 @@
     "esbuild": "^0.28.1"
   },
   "peerDependencies": {
-    "octane": "^0.13.0"
+    "octane": "^0.14.0"
   },
   "devDependencies": {
     "@types/node": "^24.13.3",
-    "octane": "0.13.0"
+    "octane": "0.14.0"
   }
 }

package/src/client-entry-runtime.js

@@ -0,0 +1,15 @@
+// @ts-check
+export { hydrateRoot, initializeHydrationEventCapture, Suspense, ErrorBoundary } from 'octane';
+import { createElementFromConfig } from 'octane/internal/client';
+
+/**
+ * The generated entry resolves fallback exports to functions and supplies only
+ * `{ error, reset }` or `{}`. Their descriptors cannot select host form actions
+ * or Fragment refs; each fallback's own output installs the capabilities it uses.
+ * @template P
+ * @param {import('octane').ComponentBody<P>} component
+ * @param {P} props
+ */
+export function createElement(component, props) {
+	return createElementFromConfig(undefined, component, props);
+}

package/src/codegen.js

@@ -1,6 +1,7 @@
 // @ts-check
 import fs from 'node:fs';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 
 export { generateServerEntry, generateServerManifestEntry } from './server/server-entry.js';
 
@@ -329,7 +330,8 @@ async function bootstrapDocumentLifecycle() {
  * octane specifics:
  *   - `initializeHydrationEventCapture()` runs before any async route work so
  *     interaction boundaries can preserve intent that precedes `hydrateRoot()`.
- *   - `import { hydrateRoot } from 'octane'` (NO `mount`).
+ *   - The default entry runtime uses hydrateRoot and classified component
+ *     descriptors for pending/catch fallbacks (NO `mount`).
  *   - `hydrateRoot(container, body, props)` signature (container FIRST, React-18
  *     shape) — no `{ target, props }` wrapper.
  *   - The layout `children` is a props-first ComponentBody whose closure calls
@@ -361,7 +363,8 @@ async function bootstrapDocumentLifecycle() {
  * @returns {string}
  */
 export function create_client_entry_source(options = {}) {
-	const runtimeModuleId = options.runtimeModuleId ?? 'octane';
+	const runtimeModuleId =
+		options.runtimeModuleId ?? fileURLToPath(new URL('./client-entry-runtime.js', import.meta.url));
 	return (
 		client_entry_prelude(
 			options,

package/src/server/component-wrappers.js

@@ -69,10 +69,10 @@ export function createLayoutWrapper(Layout, Page, pageProps) {
 export function createRootBoundaryWrapper(Content, boundary, runtime) {
 	let body = Content;
 
-	// Compose the catch boundary closest to the route. A Suspense boundary is
-	// allowed to retain its pending shell when an unhandled server render error
-	// reaches it, so putting Suspense inside ErrorBoundary would prevent the
-	// configured catch component from observing ordinary route errors.
+	// Compose the catch boundary closest to the route. As in React, the server
+	// never renders it: a server route error reaches the Suspense boundary, which
+	// ships the pending shell for the browser to render the route, where the
+	// catch component observes a repeated error before Suspense would.
 	if (boundary.catch) {
 		const child = body;
 		const Catch = boundary.catch;