@octanejs/vite-plugin 0.1.47 → 0.1.49

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octanejs/vite-plugin",
-  "version": "0.1.47",
+  "version": "0.1.49",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -47,17 +47,17 @@
   },
   "dependencies": {
     "@ripple-ts/adapter": "^0.3.125",
-    "@octanejs/app-core": "0.0.43"
+    "@octanejs/app-core": "0.0.45"
   },
   "peerDependencies": {
     "vite": "^8.0.16",
-    "octane": "0.1.47"
+    "octane": "0.1.49"
   },
   "devDependencies": {
     "@types/node": "^24.13.3",
     "playwright": "^1.61.1",
     "type-fest": "^5.8.0",
     "vite": "^8.1.5",
-    "octane": "0.1.47"
+    "octane": "0.1.49"
   }
 }

package/src/client-assets.js

@@ -39,6 +39,14 @@ export function createClientAssetMap(manifest, moduleIds, entryFiles = {}) {
 	const manifestKeysByFile = new Map(
 		Object.entries(manifest).map(([key, entry]) => [entry.file, key]),
 	);
+	// Route entries usually converge on the same shared chunks. Cache only small,
+	// complete transitive CSS results for this immutable manifest build so a large
+	// shared JavaScript graph is walked once without retaining quadratic CSS lists.
+	const MAX_CACHED_CSS_FILES = 64;
+	/** @type {Map<string, string[]>} */
+	const cssCache = new Map();
+	let traversalVersion = 0;
+	let traversalDepth = 0;
 
 	/**
 	 * @param {string} key
@@ -48,11 +56,22 @@ export function createClientAssetMap(manifest, moduleIds, entryFiles = {}) {
 	 */
 	function collectCss(key, deferredHydrationBranch, visited) {
 		const visitKey = `${deferredHydrationBranch ? 'deferred' : 'eager'}:${key}`;
-		if (visited.has(visitKey)) return [];
+		if (visited.has(visitKey)) {
+			// This result is complete for the current route because the earlier path
+			// already supplied the subtree. It is not safe to reuse as a standalone
+			// result for another route; the version change prevents its active callers
+			// from caching their now-context-dependent results.
+			traversalVersion++;
+			return [];
+		}
 		visited.add(visitKey);
+		const cached = cssCache.get(visitKey);
+		if (cached !== undefined) return cached;
 		const entry = manifest[key];
 		if (!entry) return [];
 
+		const version = traversalVersion;
+		traversalDepth++;
 		const css = [...(entry.css || [])];
 		for (const imported of entry.imports || []) {
 			css.push(...collectCss(imported, deferredHydrationBranch, visited));
@@ -67,6 +86,11 @@ export function createClientAssetMap(manifest, moduleIds, entryFiles = {}) {
 				css.push(...collectCss(imported, true, visited));
 			}
 		}
+		traversalDepth--;
+		// Top-level route entries are consumed once; caching them only grows the map.
+		if (traversalDepth > 0 && traversalVersion === version && css.length <= MAX_CACHED_CSS_FILES) {
+			cssCache.set(visitKey, css);
+		}
 		return css;
 	}
 
@@ -83,9 +107,11 @@ export function createClientAssetMap(manifest, moduleIds, entryFiles = {}) {
 			: manifestKeysByFile.get(entryFiles[moduleId]);
 		if (!manifestKey) continue;
 		const entry = manifest[manifestKey];
+		const visited = new Set();
+		traversalVersion = 0;
 		assets[moduleId] = {
 			js: entry.file,
-			css: [...new Set(collectCss(manifestKey, false, new Set()))],
+			css: [...new Set(collectCss(manifestKey, false, visited))],
 		};
 	}
 	return assets;

package/src/index.js

@@ -221,7 +221,7 @@ function collect_hydrate_module_paths(config) {
  * it). An explicit `profile` (true or false) always takes precedence over
  * `devtools`.
  *
- * @param {{ hmr?: boolean, profile?: boolean, devtools?: boolean, strong?: boolean, exclude?: string[], requireDirective?: boolean, renderers?: import('@octanejs/app-core').ExperimentalRendererConfigOptions, cssModuleConstants?: import('octane/compiler/vite').OctaneVitePluginOptions['cssModuleConstants'] }} [inlineOptions]
+ * @param {{ hmr?: boolean, profile?: boolean, devtools?: boolean, strong?: boolean, nativeReads?: boolean, exclude?: string[], requireDirective?: boolean, renderers?: import('@octanejs/app-core').ExperimentalRendererConfigOptions, cssModuleConstants?: import('octane/compiler/vite').OctaneVitePluginOptions['cssModuleConstants'] }} [inlineOptions]
  * @returns {Plugin[]}
  */
 export function octane(inlineOptions = {}) {
@@ -881,6 +881,7 @@ export function octane(inlineOptions = {}) {
 	 *   hmr?: boolean,
 	 *   profile?: boolean | 'auto',
 	 *   strong?: boolean,
+	 *   nativeReads?: boolean,
 	 *   exclude?: string[],
 	 *   requireDirective?: boolean,
 	 *   renderers?: import('@octanejs/app-core').ExperimentalRendererConfigOptions,
@@ -894,6 +895,8 @@ export function octane(inlineOptions = {}) {
 	if (inlineOptions.profile !== undefined) compilerOptions.profile = inlineOptions.profile;
 	else if (inlineOptions.devtools === true) compilerOptions.profile = 'auto';
 	if (inlineOptions.strong !== undefined) compilerOptions.strong = inlineOptions.strong;
+	if (inlineOptions.nativeReads !== undefined)
+		compilerOptions.nativeReads = inlineOptions.nativeReads;
 	if (inlineOptions.exclude !== undefined) compilerOptions.exclude = inlineOptions.exclude;
 	if (inlineOptions.requireDirective !== undefined) {
 		compilerOptions.requireDirective = inlineOptions.requireDirective;
@@ -909,7 +912,11 @@ export function octane(inlineOptions = {}) {
 			const projectRoot = userConfig.root ? path.resolve(userConfig.root) : process.cwd();
 			// Both inline compiler options override app config independently. Preserve
 			// the synchronous path when neither needs to read octane.config.ts.
-			if (inlineOptions.renderers !== undefined && inlineOptions.strong !== undefined) {
+			if (
+				inlineOptions.renderers !== undefined &&
+				inlineOptions.strong !== undefined &&
+				inlineOptions.nativeReads !== undefined
+			) {
 				compilerConfigWatchFiles.clear();
 				return compilerConfigHook.call(this, userConfig, env);
 			}
@@ -918,6 +925,7 @@ export function octane(inlineOptions = {}) {
 			if (!octaneConfigExists(projectRoot)) {
 				if (inlineOptions.renderers === undefined) delete compilerOptions.renderers;
 				if (inlineOptions.strong === undefined) delete compilerOptions.strong;
+				if (inlineOptions.nativeReads === undefined) delete compilerOptions.nativeReads;
 				compilerConfigWatchFiles.clear();
 				// A new app config can introduce Strong mode or renderer rules.
 				compilerConfigWatchFiles.add(path.resolve(configPath));
@@ -932,6 +940,9 @@ export function octane(inlineOptions = {}) {
 				if (inlineOptions.strong === undefined) {
 					compilerOptions.strong = config.config.compiler.strong;
 				}
+				if (inlineOptions.nativeReads === undefined) {
+					compilerOptions.nativeReads = config.config.compiler.nativeReads;
+				}
 				compilerConfigWatchFiles.clear();
 				for (const file of [...config.dependencies, ...config.missingDependencies]) {
 					compilerConfigWatchFiles.add(path.resolve(file));

package/types/index.d.ts

@@ -15,8 +15,10 @@ export interface OctanePluginOptions {
 	hmr?: boolean;
 	/** Enable component profiling in client transforms. */
 	profile?: boolean;
-	/** Enable Strong mode for app code, overriding `compiler.strong` in `octane.config.ts`. */
+	/** Assert Strong mode's pure immutable-snapshot render contract for app code. */
 	strong?: boolean;
+	/** Experimental native signal reads in DOM client/server render scopes. */
+	nativeReads?: boolean;
 	/**
 	 * Path fragments the compiler's plain `.ts`/`.js` hook-slotting pass must
 	 * skip. Prefer package manifest `octane.hookSlots.manual` declarations.