@gracile/engine 0.9.0-next.4 → 0.9.0-next.6

package/dist/vite/plugin-serve.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Vite plugin: development server middleware.
+ *
+ * Sets up the Gracile request handler, route watcher, and dev-time
+ * logging for `vite dev`.
+ *
+ * @internal
+ */
+import type { Logger, PluginOption } from 'vite';
+import type { GracileConfig } from '../user-config.js';
+import type { PluginSharedState } from './plugin-shared-state.js';
+export declare function gracileServePlugin({ state, config, logger, resetClientBuiltFlag, }: {
+    state: PluginSharedState;
+    config: GracileConfig | undefined;
+    logger: Logger;
+    resetClientBuiltFlag: () => void;
+}): PluginOption;
+//# sourceMappingURL=plugin-serve.d.ts.map

package/dist/vite/plugin-serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-serve.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-serve.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAIjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,wBAAgB,kBAAkB,CAAC,EAClC,KAAK,EACL,MAAM,EACN,MAAM,EACN,oBAAoB,GACpB,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,oBAAoB,EAAE,MAAM,IAAI,CAAC;CACjC,GAAG,YAAY,CA6Df"}

package/dist/vite/plugin-serve.js

@@ -0,0 +1,62 @@
+/**
+ * Vite plugin: development server middleware.
+ *
+ * Sets up the Gracile request handler, route watcher, and dev-time
+ * logging for `vite dev`.
+ *
+ * @internal
+ */
+import { getVersion } from '@gracile/internal-utils/version';
+import c from 'picocolors';
+import { createDevelopmentHandler } from '../dev/development.js';
+import { nodeAdapter } from '../server/adapters/node.js';
+export function gracileServePlugin({ state, config, logger, resetClientBuiltFlag, }) {
+    return {
+        name: 'vite-plugin-gracile-serve-middleware',
+        apply: 'serve',
+        config(_, environment) {
+            if (environment.isPreview)
+                return null;
+            return {
+                // NOTE: Supresses message: `Could not auto-determine entry point from rollupOptions or html files…`
+                // FIXME: It's not working when reloading the Vite config.
+                // Is user config, putting `optimizeDeps: { include: [] }` solve this.
+                optimizeDeps: { include: [] },
+                // NOTE: Useful? It breaks preview (expected)
+                appType: 'custom',
+            };
+        },
+        async configureServer(server) {
+            // HACK: We know we are in dev here, this will prevent incorrect
+            // vite.config hot reloading. Will be removed when adopting env. API.
+            resetClientBuiltFlag();
+            const version = getVersion();
+            logger.info(`${c.cyan(c.italic(c.underline('🧚 Gracile')))}` +
+                ` ${c.dim(`~`)} ${c.green(`v${version ?? 'X'}`)}`);
+            const { handler } = await createDevelopmentHandler({
+                routes: state.routes,
+                vite: server,
+                gracileConfig: state.gracileConfig,
+            });
+            logger.info(c.dim('Vite development server is starting…'), {
+                timestamp: true,
+            });
+            server.watcher.on('ready', () => {
+                setTimeout(() => {
+                    logger.info('');
+                    logger.info(c.green('Watching for file changes…'), {
+                        timestamp: true,
+                    });
+                    logger.info('');
+                    // NOTE: We want it to show after the Vite intro stuff
+                }, 100);
+            });
+            return () => {
+                server.middlewares.use((request, response, next) => {
+                    const locals = config?.dev?.locals?.({ nodeRequest: request });
+                    Promise.resolve(nodeAdapter(handler, { logger })(request, response, locals)).catch((error) => next(error));
+                });
+            };
+        },
+    };
+}

package/dist/vite/plugin-server-build.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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 { type PluginOption } from 'vite';
+import type { PluginSharedState } from './plugin-shared-state.js';
+/**
+ * Tracks client bundle assets so the server build can reference them
+ * with their hashed filenames.
+ */
+export declare function gracileCollectClientAssetsPlugin({ state, }: {
+    state: PluginSharedState;
+}): PluginOption;
+/**
+ * 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 declare function gracileServerBuildPlugin({ state, virtualRoutesForClient, }: {
+    state: PluginSharedState;
+    virtualRoutesForClient: PluginOption;
+}): PluginOption;
+//# sourceMappingURL=plugin-server-build.d.ts.map

package/dist/vite/plugin-server-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-server-build.d.ts","sourceRoot":"","sources":["../../src/vite/plugin-server-build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,MAAM,CAAC;AAGhD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAIlE;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,EAChD,KAAK,GACL,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;CACzB,GAAG,YAAY,CAYf;AAID;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,EACxC,KAAK,EACL,sBAAsB,GACtB,EAAE;IACF,KAAK,EAAE,iBAAiB,CAAC;IACzB,sBAAsB,EAAE,YAAY,CAAC;CACrC,GAAG,YAAY,CAqEf"}

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.4",
+  "version": "0.9.0-next.6",
   "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.4",
-    "@gracile/internal-utils": "^0.6.0-next.3",
+    "@gracile-labs/better-errors": "^0.2.1-next.0",
+    "@gracile/internal-utils": "^0.6.1-next.0",
     "@whatwg-node/server": "^0.10.18",
     "fdir": "^6.5.0",
     "picocolors": "^1.1.1",
@@ -60,5 +60,5 @@
     "access": "public",
     "provenance": true
   },
-  "gitHead": "a7441bf4d5c390521a9789077568619ca90ae623"
+  "gitHead": "a83e253566cdeb19aa75c7d0a686e3e52e921eed"
 }