@moltn/vite 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,27 @@
-# Temporary Holding Version
+# @moltn/vite
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Vite plugin for [moltn](https://crates.io/crates/moltn-cli): builds an Inertia v3 server-side rendering bundle that runs **inside a Rust binary** (embedded JavaScript engine, no Node server).
+
+```ts
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import inertia from '@inertiajs/vite'
+import moltn from '@moltn/vite'
+
+export default defineConfig({
+  plugins: [vue(), inertia(), moltn()],
+})
+```
+
+- One self-contained `dist/ssr/ssr.js`, no imports; Inertia's `createServer` is swapped automatically, no `ssr.ts` to write.
+- A static import of a Node module in a page fails the build with the file or package to blame.
+- Works the same with React and Svelte.
+
+## Part of moltn
+
+Rust + Inertia v3 (Vue, React, Svelte) with server-side rendering inside the binary.
+Guide (English and French): <https://docs.moltn.eu>. Source: <https://github.com/moltn-dev/moltn-libs>.
+
+## License
+
+MIT OR Apache-2.0.

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import type { Plugin } from 'vite';
+/** Options of `moltn()`. */
+export interface MoltnOptions {
+    /** Application entry, shared by the client and SSR builds. Default: `src/app.ts`. */
+    entry?: string;
+    /** Prefix under which the Rust application serves the assets (`asset_base` of `ViteRootView`). Default: `/build/`. */
+    assetBase?: string;
+}
+/**
+ * Complements `@inertiajs/vite` so that the SSR bundle runs in moltn's embedded
+ * JavaScript engine: a single `dist/ssr/ssr.js` file, with no imports and no Node modules.
+ *
+ * ```ts
+ * plugins: [vue(), inertia(), moltn()]
+ * ```
+ */
+export default function moltn(options?: MoltnOptions): Plugin;

package/dist/index.js

@@ -0,0 +1,113 @@
+import { builtinModules } from 'node:module';
+import { posix } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const INERTIA_SERVER_MODULES = ['@inertiajs/vue3/server', '@inertiajs/react/server', '@inertiajs/svelte/server'];
+const SERVER_SHIM = fileURLToPath(new URL('./server.js', import.meta.url));
+const SSR_CONDITIONS = ['worker', 'production'];
+const NODE_BUILTINS = new Set(builtinModules.flatMap((m) => [m, `node:${m}`]));
+const UNAVAILABLE_NODE_MODULE = '\0moltn-node-unavailable:';
+/**
+ * Complements `@inertiajs/vite` so that the SSR bundle runs in moltn's embedded
+ * JavaScript engine: a single `dist/ssr/ssr.js` file, with no imports and no Node modules.
+ *
+ * ```ts
+ * plugins: [vue(), inertia(), moltn()]
+ * ```
+ */
+export default function moltn(options = {}) {
+    const entry = options.entry ?? 'src/app.ts';
+    const assetBase = options.assetBase ?? '/build/';
+    let ssrBuild = false;
+    let root = process.cwd();
+    return {
+        name: '@moltn/vite',
+        config(config, env) {
+            ssrBuild = Boolean(env.isSsrBuild);
+            const input = config.build?.rolldownOptions?.input ?? config.build?.rollupOptions?.input;
+            if (!ssrBuild) {
+                return {
+                    // Seulement au build : le serveur de dev sert à la racine.
+                    base: env.command === 'build' ? (config.base ?? assetBase) : undefined,
+                    // En dev, la page vient de l'application Rust : les URL d'assets (CSS, images)
+                    // doivent viser le serveur Vite, pas l'origine de la page.
+                    server: env.command === 'serve'
+                        ? { origin: config.server?.origin ?? `http://localhost:${config.server?.port ?? 5173}` }
+                        : undefined,
+                    build: {
+                        outDir: config.build?.outDir ?? 'dist/client',
+                        manifest: config.build?.manifest ?? true,
+                        rolldownOptions: input ? undefined : { input: entry },
+                    },
+                };
+            }
+            return {
+                resolve: { alias: INERTIA_SERVER_MODULES.map((find) => ({ find, replacement: SERVER_SHIM })) },
+                ssr: {
+                    noExternal: true,
+                    target: 'webworker',
+                    // « worker » et non « browser » : Svelte y sert son runtime serveur.
+                    resolve: { conditions: SSR_CONDITIONS, externalConditions: SSR_CONDITIONS },
+                },
+                define: { 'process.env.NODE_ENV': '"production"' },
+                build: {
+                    outDir: config.build?.outDir ?? 'dist/ssr',
+                    sourcemap: false,
+                    rolldownOptions: { output: { entryFileNames: 'ssr.js', codeSplitting: false } },
+                },
+            };
+        },
+        configResolved(config) {
+            root = config.root;
+        },
+        // Avant tout autre résolveur : un module Node ne doit jamais être remplacé en silence.
+        resolveId: {
+            order: 'pre',
+            handler(source, importer, options) {
+                if (!ssrBuild || !NODE_BUILTINS.has(source))
+                    return null;
+                // `import()` dynamique : dépendance optionnelle (ex. Svelte et node:async_hooks).
+                // Le module de remplacement fait échouer l'import, comme dans un navigateur.
+                if (options.kind === 'dynamic-import') {
+                    this.info(`optional import of Node module "${source}" by ${importer ? describe(importer, root) : 'a module'}: it will fail in the embedded SSR engine.`);
+                    return UNAVAILABLE_NODE_MODULE + source;
+                }
+                this.error(nodeModuleMessage(source, importer, root));
+            },
+        },
+        load(id) {
+            if (!id.startsWith(UNAVAILABLE_NODE_MODULE))
+                return null;
+            const source = id.slice(UNAVAILABLE_NODE_MODULE.length);
+            return `throw new Error(${JSON.stringify(`Node module "${source}" is not available in the embedded SSR engine`)})`;
+        },
+        generateBundle(_, bundle) {
+            if (!ssrBuild)
+                return;
+            const chunks = Object.values(bundle).filter((file) => file.type === 'chunk');
+            if (chunks.length !== 1) {
+                this.error(`SSR bundle split into ${chunks.length} files; moltn expects a single file (${chunks.map((c) => c.fileName).join(', ')}).`);
+            }
+            // Les imports dynamiques inlinés (pages chargées à la demande) pointent vers le fichier lui-même.
+            const imports = chunks.flatMap((c) => [...c.imports, ...c.dynamicImports].filter((i) => i !== c.fileName));
+            if (imports.length > 0) {
+                this.error(`the SSR bundle still imports modules (${imports.join(', ')}); the embedded engine loads none.`);
+            }
+        },
+    };
+}
+function nodeModuleMessage(source, importer, root) {
+    return [
+        `Node module "${source}" is imported by ${importer ? describe(importer, root) : 'an unknown module'}.`,
+        'moltn renders on the server in an embedded JavaScript engine, without Node: pages and their dependencies',
+        'must not use any Node module (fs, path, stream, crypto…). Replace this package, or import it',
+        'in the browser only (onMounted / useEffect / onMount).',
+    ].join('\n');
+}
+/** "package x (path)" for a dependency, "file src/…" for the project. */
+function describe(id, root) {
+    const path = id.split('?')[0].replace(/\\/g, '/');
+    const pkg = path.match(/.*node_modules\/((?:@[^/]+\/)?[^/]+)/)?.[1];
+    if (pkg)
+        return `package ${pkg}\n  (${path})`;
+    return `file ${posix.relative(root.replace(/\\/g, '/'), path)}`;
+}

package/dist/server.d.ts

@@ -0,0 +1,12 @@
+import 'core-js/actual/url';
+import 'core-js/actual/url-search-params';
+/** Render function passed by Inertia: page object → `{ head, body }`. */
+export type Render = (page: unknown) => Promise<{
+    head: string[];
+    body: string;
+}>;
+declare global {
+    var __moltnRender: Render | undefined;
+}
+/** Same signature as Inertia's `createServer`; options (port, cluster…) are ignored. */
+export default function createServer(render: Render, _options?: unknown): Render;

package/dist/server.js

@@ -0,0 +1,10 @@
+// Remplace `@inertiajs/<framework>/server` dans le build SSR : au lieu d'ouvrir un serveur
+// HTTP Node, la fonction de rendu est exposée au moteur JS embarqué côté Rust (moltn-ssr).
+// URL / URLSearchParams : absents du moteur, utilisés par <Link> d'Inertia pendant le rendu.
+import 'core-js/actual/url';
+import 'core-js/actual/url-search-params';
+/** Same signature as Inertia's `createServer`; options (port, cluster…) are ignored. */
+export default function createServer(render, _options) {
+    globalThis.__moltnRender = render;
+    return render;
+}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@moltn/vite",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Vite plugin for moltn: an SSR bundle that runs in the JavaScript engine embedded in a Rust binary.",
+  "license": "MIT OR Apache-2.0",
+  "homepage": "https://docs.moltn.eu",
+  "repository": { "type": "git", "url": "git+https://github.com/moltn-dev/moltn-libs.git", "directory": "packages/vite" },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p .",
+    "typecheck": "tsc -p . --noEmit",
+    "test": "node --test test/*.test.mjs",
+    "prepack": "tsc -p ."
+  },
+  "dependencies": {
+    "core-js": "^3.51.0"
+  },
+  "peerDependencies": {
+    "@inertiajs/vite": "^3.11.0",
+    "vite": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^7.0.2",
+    "vite": "^8.3.8"
+  },
+  "keywords": [
+    "vite",
+    "inertia",
+    "ssr",
+    "rust",
+    "quickjs"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}