@octanejs/vite-plugin 0.1.52 → 0.1.54

package/README.md

@@ -0,0 +1,40 @@
+# `@octanejs/vite-plugin`
+
+Vite integration for Octane: `.tsrx` and eligible `.tsx` compilation for a
+client-only SPA, plus optional routing, streaming SSR, hydration, production
+client/server builds, and preview when an `octane.config.ts` declares routes.
+
+## Install
+
+```sh
+pnpm add octane @octanejs/vite-plugin
+pnpm add -D vite
+```
+
+```ts
+// vite.config.ts
+import { defineConfig } from 'vite';
+import { octane } from '@octanejs/vite-plugin';
+
+export default defineConfig({
+	plugins: [octane()],
+});
+```
+
+Without `octane.config.ts`, the plugin compiles Octane source and leaves Vite's
+normal client-only SPA behavior intact, including its `import.meta.hot` HMR
+dialect. Add an Octane config with routes to activate the full app layer. See
+the [build tools guide](https://octanejs.dev/docs/build-tools) for the app
+layer, adapters, and options.
+
+## Scoped CSS
+
+Scoped `<style>` blocks compile to `injectStyle(hash, css)` calls — one per
+style scope, in lexical order — emitted as module-level statements on the
+client and inside the component body per request on the server, where the
+render collects them into the response's `<style data-octane>` tags. A theme
+(`export const theme = <style>…</style>`) is an ordinary module value, so
+importing it injects its sheet ahead of the importer's own scopes. There is no
+virtual CSS module and no CSS HMR path: editing a block re-evaluates the module
+like any other source change. The plugin needs no CSS loader or extra
+configuration for this.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@octanejs/vite-plugin",
-  "version": "0.1.52",
+  "version": "0.1.54",
   "license": "MIT",
   "type": "module",
   "engines": {
@@ -47,7 +47,7 @@
   },
   "dependencies": {
     "@ripple-ts/adapter": "^0.3.125",
-    "@octanejs/app-core": "0.0.48"
+    "@octanejs/app-core": "0.0.50"
   },
   "peerDependencies": {
     "octane": "^0.1.51 || ^0.2.0",
@@ -56,8 +56,7 @@
   "devDependencies": {
     "@types/node": "^24.13.3",
     "playwright": "^1.61.1",
-    "type-fest": "^5.8.0",
     "vite": "^8.1.5",
-    "octane": "0.2.0"
+    "octane": "0.2.7"
   }
 }

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, nativeReads?: 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, textTypes?: import('octane/compiler/vite').OctaneVitePluginOptions['textTypes'], 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,7 +881,7 @@ export function octane(inlineOptions = {}) {
 	 *   hmr?: boolean,
 	 *   profile?: boolean | 'auto',
 	 *   strong?: boolean,
-	 *   nativeReads?: boolean,
+	 *   textTypes?: import('octane/compiler/vite').OctaneVitePluginOptions['textTypes'],
 	 *   exclude?: string[],
 	 *   requireDirective?: boolean,
 	 *   renderers?: import('@octanejs/app-core').ExperimentalRendererConfigOptions,
@@ -895,8 +895,7 @@ 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.textTypes !== undefined) compilerOptions.textTypes = inlineOptions.textTypes;
 	if (inlineOptions.exclude !== undefined) compilerOptions.exclude = inlineOptions.exclude;
 	if (inlineOptions.requireDirective !== undefined) {
 		compilerOptions.requireDirective = inlineOptions.requireDirective;
@@ -912,11 +911,7 @@ 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 &&
-				inlineOptions.nativeReads !== undefined
-			) {
+			if (inlineOptions.renderers !== undefined && inlineOptions.strong !== undefined) {
 				compilerConfigWatchFiles.clear();
 				return compilerConfigHook.call(this, userConfig, env);
 			}
@@ -925,7 +920,6 @@ 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));
@@ -940,9 +934,6 @@ 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/src/load-config.js

@@ -133,7 +133,8 @@ function viteConfigModuleRunner(vite) {
 			function visit(module) {
 				if (seen.has(module)) return;
 				seen.add(module);
-				if (module.file) dependencies.add(module.file);
+				// Virtual module IDs are not filesystem paths and cannot be watched.
+				if (module.file && !module.file.includes('\0')) dependencies.add(module.file);
 				for (const imported of module.importedModules) visit(imported);
 			}
 			for (const root of roots) visit(root);

package/types/index.d.ts

@@ -17,8 +17,8 @@ export interface OctanePluginOptions {
 	profile?: boolean;
 	/** 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;
+	/** TypeScript-backed child-text inference in one-shot production builds. */
+	textTypes?: OctaneVitePluginOptions['textTypes'];
 	/**
 	 * Path fragments the compiler's plain `.ts`/`.js` hook-slotting pass must
 	 * skip. Prefer package manifest `octane.hookSlots.manual` declarations.