@solid-tui/vite 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 solid-tui 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.

package/README.md

@@ -0,0 +1,64 @@
+# @solid-tui/vite
+
+Vite plugin for solid-tui: an in-process terminal dev server with HMR, plus a
+production build, for Solid apps that render to the terminal via
+`@solid-tui/runtime`.
+
+## Install
+
+```sh
+npm install -D @solid-tui/vite
+# peer deps: vite ^8, @solid-tui/runtime, solid-js ^1.9
+```
+
+## Usage
+
+```ts
+import { defineConfig } from "vite";
+import { solidTui } from "@solid-tui/vite";
+
+export default defineConfig({
+  plugins: [solidTui()],
+});
+```
+
+- `vite` boots the app in-process through Vite's SSR module runner and renders it
+  to the terminal with HMR.
+- `vite build` bundles a Node entry (`dist/main.js` by default).
+
+### Options
+
+```ts
+solidTui({
+  entry: "src/main.tsx",
+  solid: {
+    // vite-plugin-solid options; generate/moduleName are forced for solid-tui.
+  },
+});
+```
+
+## Build output
+
+By default the production build externalizes bare dependencies, while bundling
+relative, absolute, virtual, and Solid runtime ids required by the terminal
+renderer. To produce a self-contained single file, set your own
+`build.rolldownOptions.external`; the plugin will yield to it.
+
+```ts
+import { isBuiltin } from "node:module";
+
+export default defineConfig({
+  plugins: [solidTui()],
+  build: {
+    rolldownOptions: {
+      external: (id) => isBuiltin(id),
+      platform: "node",
+      output: { inlineDynamicImports: true },
+    },
+  },
+});
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,11 @@
+import solid from "vite-plugin-solid";
+import { Plugin } from "vite";
+
+//#region src/index.d.ts
+interface SolidTuiOptions {
+  solid?: Parameters<typeof solid>[0];
+  entry?: string;
+}
+declare function solidTui(options?: SolidTuiOptions): Plugin[];
+//#endregion
+export { SolidTuiOptions, solidTui as default, solidTui };

package/dist/index.mjs

@@ -0,0 +1,164 @@
+import solid from "vite-plugin-solid";
+import { isRunnableDevEnvironment } from "vite";
+import { posix, win32 } from "node:path";
+//#region src/dev-vmod.ts
+const DEV_VMOD_ID = "virtual:solid-tui/dev";
+const RESOLVED_DEV_VMOD_ID = "\0virtual:solid-tui/dev";
+const SNIPPET = "import { connectDevtools } from \"@solid-tui/runtime/internal\";\nif (import.meta.hot) connectDevtools(import.meta.hot);\n";
+function devVmodPlugin() {
+	return {
+		name: "solid-tui:dev-vmod",
+		apply: "serve",
+		resolveId(id) {
+			if (id === "virtual:solid-tui/dev") return RESOLVED_DEV_VMOD_ID;
+		},
+		load(id) {
+			if (id === "\0virtual:solid-tui/dev") return SNIPPET;
+		}
+	};
+}
+//#endregion
+//#region src/bridge-hmr.ts
+function bridgeHmrEventsToRunner(server) {
+	const ssr = server.environments.ssr;
+	if (!ssr) return;
+	const ws = server.ws;
+	const original = ws.send.bind(ws);
+	ws.send = (...args) => {
+		const payload = typeof args[0] === "string" ? {
+			type: "custom",
+			event: args[0],
+			data: args[1]
+		} : args[0];
+		if (payload.type === "custom" || payload.type === "error") ssr.hot.send(payload);
+		original(...args);
+	};
+}
+//#endregion
+//#region src/dev.ts
+function devPlugin(opts) {
+	const entry = opts.entry ?? "/src/main.tsx";
+	return {
+		name: "solid-tui:dev",
+		apply: "serve",
+		config() {
+			return {
+				clearScreen: false,
+				logLevel: "error",
+				server: { ws: false }
+			};
+		},
+		transform(code, id) {
+			const q = id.indexOf("?");
+			if ((q === -1 ? id : id.slice(0, q)).endsWith(entry)) return {
+				code: `import ${JSON.stringify(DEV_VMOD_ID)};\n` + code,
+				map: null
+			};
+		},
+		configureServer(server) {
+			if (server.config.mode === "test" || process.env.VITEST) return;
+			server.bindCLIShortcuts = () => {};
+			bridgeHmrEventsToRunner(server);
+			server.environments.ssr?.hot.on("solid-tui:exit", () => {
+				server.close();
+			});
+			return () => {
+				const env = server.environments.ssr;
+				if (!isRunnableDevEnvironment(env)) {
+					server.config.logger.error("[solid-tui] the \"ssr\" environment is not runnable");
+					return;
+				}
+				env.runner.import(entry).catch((err) => {
+					server.config.logger.error(`[solid-tui] failed to launch ${entry}`);
+					console.error(err);
+				});
+			};
+		}
+	};
+}
+//#endregion
+//#region src/external.ts
+function isExternalId(id) {
+	if (id.startsWith("\0") || id.startsWith("virtual:")) return false;
+	if (id === "solid-js") return false;
+	if (id === "solid-js/store" || id.startsWith("solid-js/store/")) return false;
+	if (id.startsWith(".")) return false;
+	if (posix.isAbsolute(id) || win32.isAbsolute(id)) return false;
+	return true;
+}
+//#endregion
+//#region src/build.ts
+function buildConfigPlugin(opts) {
+	const entry = opts.entry ?? "src/main.tsx";
+	return {
+		name: "solid-tui:build",
+		apply: "build",
+		config(userConfig) {
+			const userBuild = userConfig?.build;
+			return { build: {
+				target: "esnext",
+				modulePreload: false,
+				rolldownOptions: {
+					input: entry,
+					...userBuild?.rolldownOptions?.external !== void 0 || userBuild?.rollupOptions?.external !== void 0 ? {} : { external: (id) => isExternalId(id) },
+					output: { entryFileNames: "[name].js" }
+				}
+			} };
+		}
+	};
+}
+//#endregion
+//#region src/solid-runtime-config.ts
+const solidClientEntry = "solid-js/dist/solid.js";
+const solidStoreEntry = "solid-js/store/dist/store.js";
+function solidRuntimeConfigPlugin() {
+	return {
+		name: "solid-tui:solid-runtime-config",
+		config() {
+			return {
+				resolve: { alias: [{
+					find: /^solid-js\/store$/,
+					replacement: solidStoreEntry
+				}, {
+					find: /^solid-js$/,
+					replacement: solidClientEntry
+				}] },
+				ssr: { noExternal: ["solid-js", "@solid-tui/runtime"] }
+			};
+		}
+	};
+}
+//#endregion
+//#region src/index.ts
+function solidTui(options = {}) {
+	const { dev, build } = normalizeEntry(options.entry);
+	const solidOptions = {
+		...options.solid,
+		solid: {
+			...options.solid?.solid,
+			generate: "universal",
+			moduleName: "@solid-tui/runtime"
+		}
+	};
+	return [
+		solidRuntimeConfigPlugin(),
+		devPlugin({ entry: dev }),
+		buildConfigPlugin({ entry: build }),
+		devVmodPlugin(),
+		solid(solidOptions)
+	];
+}
+function normalizeEntry(entry) {
+	const e = (entry ?? "src/main.tsx").replace(/\\/g, "/");
+	if (e.startsWith("/") || /^[a-zA-Z]:\//.test(e)) return {
+		dev: e,
+		build: e
+	};
+	const bare = e.replace(/^(?:\.\/)+/, "");
+	return {
+		dev: `/${bare}`,
+		build: bare
+	};
+}
+//#endregion
+export { solidTui as default, solidTui };

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@solid-tui/vite",
+  "version": "0.1.0",
+  "description": "Vite plugin for solid-tui: universal Solid TSX, in-process terminal dev server, and Node builds.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/solidjs-ai/solid-tui.git",
+    "directory": "packages/vite"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "vite-plugin-solid": "^2.11.12"
+  },
+  "devDependencies": {
+    "@types/node": "^24.12.4",
+    "solid-js": "^1.9.14",
+    "typescript": "^5",
+    "vite": "8.1.0",
+    "vite-plus": "^0.1.22",
+    "@solid-tui/runtime": "0.1.0"
+  },
+  "peerDependencies": {
+    "solid-js": "^1.9.0",
+    "vite": "^8",
+    "@solid-tui/runtime": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "vp pack",
+    "dev": "vp pack --watch",
+    "test": "vp test --passWithNoTests",
+    "check:type": "tsc --noEmit"
+  }
+}