@gracile/engine 0.9.0-next.3 → 0.9.0-next.5

package/dist/vite/plugin-server-build.js

@@ -0,0 +1,157 @@
+/**
+ * Vite plugins: server-side build pipeline.
+ *
+ * After the client build completes, these plugins run a nested
+ * `vite build` in SSR mode to produce the server entrypoint.
+ *
+ * Includes:
+ * - Client asset filename collector (from the client writeBundle)
+ * - Server build trigger (closeBundle)
+ * - Virtual entrypoint codegen
+ * - Server-to-client asset mover
+ *
+ * @internal
+ */
+import { join } from 'node:path';
+import { rename, rm } from 'node:fs/promises';
+import { build } from 'vite';
+import { virtualRoutes } from './virtual-routes.js';
+// ── Client asset collector ───────────────────────────────────────────
+/**
+ * Tracks client bundle assets so the server build can reference them
+ * with their hashed filenames.
+ */
+export function gracileCollectClientAssetsPlugin({ state, }) {
+    return {
+        name: 'vite-plugin-gracile-collect-client-assets-for-server',
+        writeBundle(_, bundle) {
+            if (state.outputMode === 'static')
+                return;
+            for (const file of Object.values(bundle))
+                if (file.type === 'asset' && file.name)
+                    state.clientAssets[file.name] = file.fileName;
+        },
+    };
+}
+// ── Server build trigger ─────────────────────────────────────────────
+/**
+ * After the client build finishes (`closeBundle`), run a nested SSR
+ * build that produces the server entrypoint and moves assets back into
+ * the client output directory.
+ */
+export function gracileServerBuildPlugin({ state, virtualRoutesForClient, }) {
+    return {
+        name: 'vite-plugin-gracile-server-build',
+        apply: 'build',
+        config(viteConfig) {
+            state.root = viteConfig.root || null;
+        },
+        async closeBundle() {
+            if (state.outputMode === 'static' ||
+                !state.routes ||
+                !state.renderedRoutes)
+                return;
+            const root = state.root || process.cwd();
+            await build({
+                root,
+                ssr: { external: ['@gracile/gracile'] },
+                build: {
+                    target: 'esnext',
+                    ssr: true,
+                    copyPublicDir: false,
+                    outDir: 'dist/server',
+                    ssrEmitAssets: true,
+                    cssMinify: true,
+                    cssCodeSplit: true,
+                    rollupOptions: {
+                        input: 'entrypoint.js',
+                        output: {
+                            entryFileNames: '[name].js',
+                            assetFileNames: (chunkInfo) => {
+                                if (chunkInfo.name) {
+                                    const fileName = state.clientAssets[chunkInfo.name];
+                                    if (fileName)
+                                        return fileName;
+                                    // NOTE: When not imported at all from client
+                                    return `assets/${chunkInfo.name.replace(/\.(.*)$/, '')}-[hash].[ext]`;
+                                }
+                                return 'assets/[name]-[hash].[ext]';
+                            },
+                            chunkFileNames: 'chunk/[name].js',
+                        },
+                    },
+                },
+                plugins: [
+                    virtualRoutesForClient,
+                    virtualRoutes({
+                        routes: state.routes,
+                        renderedRoutes: state.renderedRoutes,
+                    }),
+                    gracileEntrypointPlugin(state),
+                    gracileMoveServerAssetsPlugin(state),
+                ],
+            });
+        },
+    };
+}
+// ── Virtual entrypoint ───────────────────────────────────────────────
+/**
+ * Generates the virtual `entrypoint.js` module for the server build.
+ * This is the server's main entry: it imports routes and creates the
+ * Gracile handler.
+ */
+function gracileEntrypointPlugin(state) {
+    return {
+        name: 'vite-plugin-gracile-entry',
+        resolveId(id) {
+            if (id === 'entrypoint.js') {
+                return id;
+            }
+            return null;
+        },
+        load(id) {
+            if (id === 'entrypoint.js' && state.routes && state.renderedRoutes) {
+                return `
+import { routeAssets, routeImports, routes } from 'gracile:routes';
+import { createGracileHandler } from '@gracile/gracile/_internals/server-runtime';
+import { createLogger } from '@gracile/gracile/_internals/logger';
+
+createLogger();
+
+export const handler = createGracileHandler({
+	root: process.cwd(),
+	routes,
+	routeImports,
+	routeAssets,
+	serverMode: true,
+	gracileConfig: ${JSON.stringify(state.gracileConfig, null, 2)}
+});
+`;
+            }
+            return null;
+        },
+    };
+}
+// ── Server asset mover ───────────────────────────────────────────────
+/**
+ * After the server build writes its bundle, move any assets from
+ * `dist/server/assets/` into `dist/client/assets/` so the client
+ * can serve them.
+ */
+function gracileMoveServerAssetsPlugin(state) {
+    return {
+        name: 'gracile-move-server-assets',
+        async writeBundle(_, bundle) {
+            const cwd = state.root || process.cwd();
+            await Promise.all(Object.entries(bundle).map(async ([file]) => {
+                if (file.startsWith('assets/') === false)
+                    return;
+                await rename(join(cwd, `/dist/server/${file}`), join(cwd, `/dist/client/${file}`));
+            }));
+            // NOTE: Disabled for now, because it conflict with test's folder comparer
+            await rm(join(cwd, `/dist/server/assets`), {
+                recursive: true,
+            }).catch(() => null);
+        },
+    };
+}

package/dist/vite/plugin-shared-state.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Shared mutable state passed between the Gracile Vite plugin phases.
+ *
+ * This exists because Vite plugins in the same array share data through
+ * closures. Making the shared state explicit (instead of ad-hoc `let`
+ * variables) makes the data flow between plugins visible and auditable.
+ *
+ * @internal
+ */
+import type { RenderedRouteDefinition } from '../routes/render.js';
+import type { RoutesManifest } from '../routes/route.js';
+import type { GracileConfig } from '../user-config.js';
+export interface PluginSharedState {
+    /** Collected file-system routes (populated during dev and build). */
+    routes: RoutesManifest;
+    /** Rendered route definitions from the client build phase. */
+    renderedRoutes: RenderedRouteDefinition[] | null;
+    /** Maps original asset names → hashed filenames from the client bundle. */
+    clientAssets: Record<string, string>;
+    /** Vite `root` captured during build config. */
+    root: string | null;
+    /** The resolved Gracile configuration. */
+    gracileConfig: GracileConfig;
+    /** The output mode: 'static' or 'server'. */
+    outputMode: 'static' | 'server';
+}
+/**
+ * Create a fresh shared state object.
+ */
+export declare function createPluginSharedState(config: GracileConfig | undefined): PluginSharedState;
+//# sourceMappingURL=plugin-shared-state.d.ts.map

package/dist/vite/plugin-shared-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-shared-state.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-shared-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,WAAW,iBAAiB;IACjC,qEAAqE;IACrE,MAAM,EAAE,cAAc,CAAC;IAEvB,8DAA8D;IAC9D,cAAc,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAAC;IAEjD,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC,gDAAgD;IAChD,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB,0CAA0C;IAC1C,aAAa,EAAE,aAAa,CAAC;IAE7B,6CAA6C;IAC7C,UAAU,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,MAAM,EAAE,aAAa,GAAG,SAAS,GAC/B,iBAAiB,CASnB"}

package/dist/vite/plugin-shared-state.js

@@ -0,0 +1,22 @@
+/**
+ * Shared mutable state passed between the Gracile Vite plugin phases.
+ *
+ * This exists because Vite plugins in the same array share data through
+ * closures. Making the shared state explicit (instead of ad-hoc `let`
+ * variables) makes the data flow between plugins visible and auditable.
+ *
+ * @internal
+ */
+/**
+ * Create a fresh shared state object.
+ */
+export function createPluginSharedState(config) {
+    return {
+        routes: new Map(),
+        renderedRoutes: null,
+        clientAssets: {},
+        root: null,
+        gracileConfig: config || {},
+        outputMode: config?.output || 'static',
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gracile/engine",
-  "version": "0.9.0-next.3",
+  "version": "0.9.0-next.5",
   "description": "A thin, full-stack, web framework",
   "keywords": [
     "custom-elements",
@@ -43,8 +43,8 @@
     "!/dist/typedoc-entrypoint.*"
   ],
   "dependencies": {
-    "@gracile-labs/better-errors": "^0.2.0-next.3",
-    "@gracile/internal-utils": "^0.6.0-next.2",
+    "@gracile-labs/better-errors": "^0.2.0-next.4",
+    "@gracile/internal-utils": "^0.6.0-next.3",
     "@whatwg-node/server": "^0.10.18",
     "fdir": "^6.5.0",
     "picocolors": "^1.1.1",
@@ -60,5 +60,5 @@
     "access": "public",
     "provenance": true
   },
-  "gitHead": "7feaac994b36092525582a57ea7b4cb811ac9e1e"
+  "gitHead": "534579e0c18fd2a9fbfaa7d9cb180187447fb193"
 }