@vesk/adapter 0.2.13 → 0.2.16

package/dist/index.js

@@ -1,12 +1,13 @@
 import { mkdirSync, writeFileSync, existsSync, readFileSync } from 'node:fs';
 import { resolve, dirname, relative, basename } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { cssBlockEnd } from '@vesk/compiler/src/scan';
 import { bundleRuntime } from '@vesk/adapter/src/runtime-bundle';
 import { generateSsrFunction } from '@vesk/adapter/src/ssr-function';
+import { resolveUserCssPath, stripTailwindDirectives, isTailwindPlugin, resolveCssUrls, hasUserCss, hasBuiltTailwindCss } from '@vesk/adapter/src/css';
 import { collectActionIds } from '@vesk/compiler/src/actions';
 import { generateApiFunction } from '@vesk/adapter/src/api-function';
 import { compileMiddleware, compileMiddlewareCode } from '@vesk/adapter/src/middleware';
+import { compileEvents } from '@vesk/adapter/src/events';
 import { generateClientBundle } from '@vesk/adapter/src/client-bundle';
 import { generateManifest } from '@vesk/adapter/src/manifest';
 import { copyStaticAssets } from '@vesk/adapter/src/static';
@@ -61,6 +62,28 @@ function veskDirFromOutDir(outDir) {
         return dirname(outDir);
     return outDir;
 }
+/**
+ * Invoke every active plugin's `onHead` once with an empty head to capture its
+ * static head contribution. The result is baked into generated SSR functions
+ * and `config.json` (`headExtra`) for the prod path, where plugin objects are
+ * not available at request time.
+ */
+async function collectPluginHeadExtra(pluginsPipelines) {
+    const parts = [];
+    for (const plugin of pluginsPipelines) {
+        if (typeof plugin.onHead !== 'function')
+            continue;
+        try {
+            const result = await plugin.onHead('', { sourcePath: 'build' });
+            if (typeof result === 'string' && result.trim())
+                parts.push(result);
+        }
+        catch {
+            // a failing onHead at bake time must not break the build
+        }
+    }
+    return parts.join('\n');
+}
 export async function build(appDir, options) {
     appDir = resolve(appDir);
     const outDir = resolve(options?.outDir || resolve(appDir, '..', '.vesk'));
@@ -111,6 +134,13 @@ export async function build(appDir, options) {
             await plugin.onBuildStart();
         }
     }
+    // Bake the active `onHead` plugins' static head contribution for the prod
+    // SSR path (generated SSR functions + prod-server not-found/error pages have
+    // no in-process plugin objects, so their head snippets ship build-time).
+    // Live hooks still run in dev / build / SSG where plugin objects exist.
+    const pluginHeadExtra = await collectPluginHeadExtra(pluginsPipelines);
+    if (pluginHeadExtra)
+        console.error('vesk build: baked plugin head → config.json + SSR functions');
     console.error(`vesk build: output → ${outDir}`);
     const dirs = [
         resolve(outDir, 'server', 'functions'),
@@ -120,6 +150,48 @@ export async function build(appDir, options) {
     ];
     for (const d of dirs)
         mkdirSync(d, { recursive: true });
+    const cssSourcePath = resolveUserCssPath(appDir);
+    if (cssSourcePath !== null) {
+        const cssContent = readFileSync(cssSourcePath, 'utf-8');
+        const userCss = stripTailwindDirectives(cssContent);
+        const userCssTarget = resolve(outDir, 'static', 'global.css');
+        writeFileSync(userCssTarget, userCss, 'utf-8');
+        console.error(`vesk build: css  → static/global.css  (${userCss.length} bytes)`);
+        const twCssTarget = resolve(outDir, 'static', '_tailwind.css');
+        const tailwindActive = isTailwindPlugin(pluginsPipelines);
+        if (!tailwindActive) {
+            writeFileSync(twCssTarget, '', 'utf-8');
+            console.error('vesk build: css  → static/_tailwind.css  (empty, tailwind plugin inactive)');
+        }
+        else {
+            let twCss = cssContent;
+            for (const plugin of pluginsPipelines) {
+                if (typeof plugin.onCSS === 'function') {
+                    const result = await plugin.onCSS(twCss, cssSourcePath);
+                    if (result !== null && typeof result === 'string') {
+                        twCss = result;
+                    }
+                }
+            }
+            const hasUnresolvedTailwindImport = /@import\s+['"]tailwindcss['"]/.test(twCss);
+            if (hasUnresolvedTailwindImport) {
+                const lines = twCss.split('\n').filter(l => !/^\s*@import\s+['"]tailwindcss['"]/.test(l));
+                twCss = lines.join('\n').trim();
+                if (twCss.length === 0) {
+                    writeFileSync(twCssTarget, '', 'utf-8');
+                    console.error('vesk build: css  → static/_tailwind.css  (empty, tailwind unresolved)');
+                }
+                else {
+                    writeFileSync(twCssTarget, twCss, 'utf-8');
+                    console.error(`vesk build: css  → static/_tailwind.css  (${twCss.length} bytes, tailwind partially unresolved)`);
+                }
+            }
+            else {
+                writeFileSync(twCssTarget, twCss, 'utf-8');
+                console.error(`vesk build: css  → static/_tailwind.css  (${twCss.length} bytes)`);
+            }
+        }
+    }
     const { scanRoutes, scanComponents } = await resolveCompilerApi('router.js');
     const { scanApiRoutes } = await resolveCompilerApi('api-routes.js');
     const { collectMiddlewareChain } = await resolveCompilerApi('middleware.js');
@@ -153,7 +225,7 @@ export async function build(appDir, options) {
                     const mwSources = mwChain.map((m) => readFileSync(m.sourcePath, 'utf-8'));
                     mwCode = compileMiddlewareCode(mwSources);
                 }
-                const { funcPath, funcCode, name } = generateSsrFunction(node, appDir, outDir, componentMap, { ancestorLayouts, middlewareCode: mwCode });
+                const { funcPath, funcCode, name } = generateSsrFunction(node, appDir, outDir, componentMap, { ancestorLayouts, middlewareCode: mwCode, headExtra: pluginHeadExtra });
                 writeFileSync(funcPath, funcCode, 'utf-8');
                 const pagePath = resolve(appDir, node.sourceDir, 'page.vsk');
                 if (existsSync(pagePath)) {
@@ -209,6 +281,9 @@ export async function build(appDir, options) {
             console.error(`vesk build: mw   → server/middleware.js  (${mwChain.length} middlewares)`);
         }
     }
+    const hasEvents = await compileEvents(appDir, outDir);
+    if (hasEvents)
+        console.error('vesk build: evt  → server/events.js (onStart/onRequest/onStop)');
     console.error('vesk build: bundling client runtime...');
     const bundleOpts = {};
     if (options?.codeSplit)
@@ -217,6 +292,8 @@ export async function build(appDir, options) {
         bundleOpts.hmr = true;
     if (options?.routeDataCache !== undefined)
         bundleOpts.routeDataCache = options.routeDataCache;
+    if (pluginsPipelines.length > 0)
+        bundleOpts.plugins = pluginsPipelines;
     const { main, chunks } = await generateClientBundle(routeTree, appDir, componentMap, bundleOpts);
     writeFileSync(resolve(outDir, 'static', 'client.js'), main, 'utf-8');
     const mode = chunks.length > 0 ? 'code-split' : 'monolithic';
@@ -230,82 +307,14 @@ export async function build(appDir, options) {
     }
     copyStaticAssets(publicDir, outDir);
     console.error('vesk build: static → static/public/');
-    const srcDir = resolve(appDir, '..', 'src');
-    const cssSrc = resolve(srcDir, 'global.css');
-    const altCssSrc = resolve(srcDir, 'app.css');
-    let cssContent = null;
-    let cssSourcePath = null;
-    if (existsSync(cssSrc)) {
-        cssContent = readFileSync(cssSrc, 'utf-8');
-        cssSourcePath = cssSrc;
-    }
-    else if (existsSync(altCssSrc)) {
-        cssContent = readFileSync(altCssSrc, 'utf-8');
-        cssSourcePath = altCssSrc;
-    }
-    function stripTailwindDirectives(css) {
-        const blockStart = /^\s*@(theme\s*\{|layer\s+(components|utilities)\s*\{|utility\s+\w+\s*\{)/;
-        let result = css.replace(/^\s*@import\s+['"]tailwindcss['"]\s*;?\s*$/gm, '');
-        result = result.replace(/^\s*@source\s+['"][^'"]+['"]\s*;?\s*$/gm, '');
-        const output = [];
-        let pos = 0;
-        while (pos < result.length) {
-            const lineEnd = result.indexOf('\n', pos) === -1 ? result.length : result.indexOf('\n', pos) + 1;
-            const line = result.slice(pos, lineEnd);
-            if (blockStart.test(line.trim())) {
-                const end = cssBlockEnd(result, pos);
-                pos = end;
-                continue;
-            }
-            output.push(line);
-            pos = lineEnd;
-        }
-        return output.join('').trim();
-    }
-    if (cssContent !== null) {
-        const userCss = stripTailwindDirectives(cssContent);
-        const userCssTarget = resolve(outDir, 'static', 'global.css');
-        writeFileSync(userCssTarget, userCss, 'utf-8');
-        console.error(`vesk build: css  → static/global.css  (${userCss.length} bytes)`);
-        const twCssTarget = resolve(outDir, 'static', '_tailwind.css');
-        const isTailwindActive = pluginsPipelines.some((p) => String(p.name).toLowerCase().includes('tailwind'));
-        if (!isTailwindActive) {
-            writeFileSync(twCssTarget, '', 'utf-8');
-            console.error('vesk build: css  → static/_tailwind.css  (empty, tailwind plugin inactive)');
-        }
-        else {
-            let twCss = cssContent;
-            for (const plugin of pluginsPipelines) {
-                if (typeof plugin.onCSS === 'function') {
-                    const result = await plugin.onCSS(twCss, cssSourcePath);
-                    if (result !== null && typeof result === 'string') {
-                        twCss = result;
-                    }
-                }
-            }
-            const hasUnresolvedTailwindImport = /@import\s+['"]tailwindcss['"]/.test(twCss);
-            if (hasUnresolvedTailwindImport) {
-                const lines = twCss.split('\n').filter(l => !/^\s*@import\s+['"]tailwindcss['"]/.test(l));
-                twCss = lines.join('\n').trim();
-                if (twCss.length === 0) {
-                    writeFileSync(twCssTarget, '', 'utf-8');
-                    console.error('vesk build: css  → static/_tailwind.css  (empty, tailwind unresolved)');
-                }
-                else {
-                    writeFileSync(twCssTarget, twCss, 'utf-8');
-                    console.error(`vesk build: css  → static/_tailwind.css  (${twCss.length} bytes, tailwind partially unresolved)`);
-                }
-            }
-            else {
-                writeFileSync(twCssTarget, twCss, 'utf-8');
-                console.error(`vesk build: css  → static/_tailwind.css  (${twCss.length} bytes)`);
-            }
-        }
-    }
     let prerenderedRoutes = [];
     if (options?.ssg) {
         const { generateSsgRoutes } = await import('./static.js');
-        prerenderedRoutes = await generateSsgRoutes(routeTree, appDir, outDir);
+        const cssUrls = resolveCssUrls({
+            tailwind: hasBuiltTailwindCss(outDir),
+            userCss: hasUserCss(appDir),
+        });
+        prerenderedRoutes = await generateSsgRoutes(routeTree, appDir, outDir, pluginsPipelines, pluginHeadExtra, cssUrls);
         console.error(`vesk build: ssg   → prerendered/  (${prerenderedRoutes.length} pages)`);
     }
     {
@@ -340,7 +349,7 @@ export async function build(appDir, options) {
             console.error(`vesk build: seo   → static/public/robots.txt (${robots.length} bytes)`);
         }
     }
-    const manifest = generateManifest(routeTree, ssrRoutes, apiRoutes, prerenderedRoutes, middlewareEnabled, actionMap);
+    const manifest = generateManifest(routeTree, ssrRoutes, apiRoutes, prerenderedRoutes, middlewareEnabled, actionMap, pluginHeadExtra, hasEvents);
     writeFileSync(resolve(outDir, 'config.json'), JSON.stringify(manifest, null, 2) + '\n', 'utf-8');
     console.error('vesk build: config → config.json');
     {
@@ -357,6 +366,7 @@ export async function build(appDir, options) {
                 prerenderedPaths: prerenderedRoutes.map(r => r.path),
                 prerenderedRoutes,
                 hasMiddleware: middlewareEnabled,
+                hasEvents,
             });
             if (outRoot) {
                 console.error(`vesk build: ${platform} → ${relative(projectRoot, outRoot)}`);

package/dist/manifest.d.ts

@@ -1,3 +1,3 @@
 import type { RouteNode, ApiRouteNode, Manifest, SsgRouteResult } from '@vesk/adapter/src/types';
-export declare function generateManifest(routes: RouteNode[], ssrRoutes: RouteNode[], apiRoutes: ApiRouteNode[], staticRoutes: SsgRouteResult[], middlewareEnabled: boolean, actionMap?: Record<string, string>): Manifest;
+export declare function generateManifest(routes: RouteNode[], ssrRoutes: RouteNode[], apiRoutes: ApiRouteNode[], staticRoutes: SsgRouteResult[], middlewareEnabled: boolean, actionMap?: Record<string, string>, headExtra?: string, eventsEnabled?: boolean): Manifest;
 //# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAqE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEpK,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EAAE,EACnB,SAAS,EAAE,SAAS,EAAE,EACtB,SAAS,EAAE,YAAY,EAAE,EACzB,YAAY,EAAE,cAAc,EAAE,EAC9B,iBAAiB,EAAE,OAAO,EAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC,QAAQ,CAiDV"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAqE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEpK,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,EAAE,EACnB,SAAS,EAAE,SAAS,EAAE,EACtB,SAAS,EAAE,YAAY,EAAE,EACzB,YAAY,EAAE,cAAc,EAAE,EAC9B,iBAAiB,EAAE,OAAO,EAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,SAAS,CAAC,EAAE,MAAM,EAClB,aAAa,UAAQ,GACpB,QAAQ,CAmDV"}

package/dist/manifest.js

@@ -1,4 +1,4 @@
-export function generateManifest(routes, ssrRoutes, apiRoutes, staticRoutes, middlewareEnabled, actionMap) {
+export function generateManifest(routes, ssrRoutes, apiRoutes, staticRoutes, middlewareEnabled, actionMap, headExtra, eventsEnabled = false) {
     const routeEntries = [];
     for (const r of ssrRoutes) {
         const urlParts = r.fullPath.split('/').filter(Boolean);
@@ -43,5 +43,7 @@ export function generateManifest(routes, ssrRoutes, apiRoutes, staticRoutes, mid
             dir: 'static',
         },
         ...(actionEntries.length > 0 ? { actions: actionEntries } : {}),
+        ...(headExtra ? { headExtra } : {}),
+        ...(eventsEnabled ? { events: true } : {}),
     };
 }

package/dist/platform-deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-deploy.d.ts","sourceRoot":"","sources":["../src/platform-deploy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwD,KAAK,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAErI,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,iBAAiB,EAAE,cAAc,EAAE,CAAC;CACrC;AA0BD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyEvG"}
+{"version":3,"file":"platform-deploy.d.ts","sourceRoot":"","sources":["../src/platform-deploy.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwD,KAAK,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAErI,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,iBAAiB,EAAE,cAAc,EAAE,CAAC;CACrC;AA0BD;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0EvG"}

package/dist/platform-deploy.js

@@ -21,6 +21,7 @@ export async function emitPlatformOutput(platform, ctx) {
         apiRoutes: ctx.apiRoutes,
         prerenderedPaths,
         hasMiddleware: ctx.hasMiddleware,
+        hasEvents: ctx.hasEvents,
     });
     const shell = shellFor(platform);
     const projectRoot = resolve(ctx.outDir, '..');

package/dist/platform-handler.d.ts

@@ -4,6 +4,7 @@ export interface PlatformHandlerInput {
     apiRoutes: ApiRouteNode[];
     prerenderedPaths: string[];
     hasMiddleware: boolean;
+    hasEvents?: boolean;
 }
 export declare function routeName(segments: string[]): string;
 export declare function apiRouteName(fullPath: string): string;
@@ -28,5 +29,6 @@ export interface PlatformBuildContext {
     apiRoutes: ApiRouteNode[];
     prerenderedPaths: string[];
     hasMiddleware: boolean;
+    hasEvents?: boolean;
 }
 //# sourceMappingURL=platform-handler.d.ts.map

package/dist/platform-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-handler.d.ts","sourceRoot":"","sources":["../src/platform-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAIvE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAMpD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtC;AAQD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAiIjF;AAED,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFzF;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;CACxB"}
+{"version":3,"file":"platform-handler.d.ts","sourceRoot":"","sources":["../src/platform-handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAIvE,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAMpD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtC;AAQD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CA8IjF;AAED,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsFzF;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,EAAE,CAAC;IACvB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/dist/platform-handler.js

@@ -31,6 +31,7 @@ function findCompilerSrc() {
  */
 export function generatePlatformHandlerSource(input) {
     const { ssrRoutes, apiRoutes, prerenderedPaths, hasMiddleware } = input;
+    const hasEvents = !!input.hasEvents;
     let imports = '';
     const routeEntries = [];
     for (const r of ssrRoutes) {
@@ -51,10 +52,15 @@ export function generatePlatformHandlerSource(input) {
     }
     const mwImport = hasMiddleware ? "import { execute as __executeMw } from './server/middleware.js';" : '';
     const hasMwLiteral = hasMiddleware ? 'true' : 'false';
+    const eventsImport = hasEvents ? "import { executeStart as __eventsStart, executeRequest as __eventsRequest } from './server/events.js';" : '';
     const prerenderedList = prerenderedPaths.length > 0
         ? `const __prerendered = new Set(${JSON.stringify(prerenderedPaths)});\n`
         : 'const __prerendered = new Set();\n';
     const isrCache = 'const __isrCache = new Map();';
+    const serverStoreLine = hasEvents ? 'const __serverStore = globalThis.__vesk_server_ctx || {};' : '';
+    const eventsStartLine = hasEvents ? '  await __eventsStart({ server: null });' : '';
+    const eventsRequestLine = hasEvents ? '  await __eventsRequest(mwCtx);' : '';
+    const localsSeed = hasEvents ? 'Object.assign({}, __serverStore)' : '{}';
     const compilerSrc = findCompilerSrc();
     const parseCookiesImport = hasMiddleware
         ? `import { parseCookies } from ${JSON.stringify(resolve(compilerSrc, 'server-cookies.js'))};`
@@ -63,6 +69,7 @@ export function generatePlatformHandlerSource(input) {
 ${imports}
 ${parseCookiesImport}
 ${mwImport}
+${eventsImport}
 ${prerenderedList}
 ${isrCache}
 const __routes = [${routeEntries.join(',\n')}];
@@ -91,23 +98,28 @@ export async function handleRequest(request) {
   const url = new URL(request.url);
   const pathname = url.pathname;
   const isDataRequest = request.headers.get('x-vesk-data') === '1';
+${serverStoreLine}
 
   if (__prerendered.has(pathname) && !isDataRequest) {
     return new Response(null, { status: 308, headers: { Location: '/_vesk/static/public' + (pathname.endsWith('/') ? pathname + 'index.html' : pathname + '.html') } });
   }
 
-  let mwCtx = { params: {}, url, locals: {}, cookies: {}, request, resolveUrl(u) { return new URL(u, request.url).href; }, set() {}, get() { return undefined; } };
+${eventsStartLine}
+  let mwCtx = { params: {}, url, locals: ${localsSeed}, cookies: {}, request, resolveUrl(u) { return new URL(u, request.url).href; }, set() {}, get() { return undefined; } };
   if (${hasMwLiteral}) {
     mwCtx = {
       request,
       params: {},
       url,
-      locals: {},
+      locals: ${localsSeed},
       cookies: typeof parseCookies !== 'undefined' ? parseCookies(request.headers.get('cookie') || '') : {},
       resolveUrl(u) { return new URL(u, request.url).href; },
       set(key, value) { this.locals[key] = value; },
       get(key) { return this.locals[key]; },
     };
+  }
+${eventsRequestLine}
+  if (${hasMwLiteral}) {
     const mwResult = await __executeMw(mwCtx);
     if (mwResult.response) return mwResult.response;
     if (mwResult.rewriteUrl) url.pathname = mwResult.rewriteUrl;

package/dist/prod-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prod-server.d.ts","sourceRoot":"","sources":["../src/prod-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2D,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AA8CjG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAIzE;AA4FD,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAiZxI"}
+{"version":3,"file":"prod-server.d.ts","sourceRoot":"","sources":["../src/prod-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2D,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AA+CjG,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAIzE;AA+FD,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmcxI"}

package/dist/prod-server.js

@@ -6,6 +6,7 @@ import { fileURLToPath } from 'node:url';
 import { createRateLimiter, resolveComponentName, safeJsonForScript, getClientProtocol, DEFAULT_MAX_BODY_BYTES } from '@vesk/compiler/src/server-codegen';
 import { securityHeaders } from '@vesk/compiler/src/server-utils';
 import { resolveWithin, installMdReadHook } from '@vesk/adapter/src/paths';
+import { resolveCssUrls, hasUserCss, hasBuiltTailwindCss } from '@vesk/adapter/src/css';
 const _require = createRequire(import.meta.url);
 const __dirname = dirname(fileURLToPath(import.meta.url));
 async function readBody(req, maxBytes = DEFAULT_MAX_BODY_BYTES) {
@@ -111,6 +112,7 @@ const MIME = {
     '.svg': 'image/svg+xml', '.css': 'text/css', '.js': 'application/javascript',
     '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg',
     '.ico': 'image/x-icon', '.html': 'text/html', '.json': 'application/json',
+    '.webmanifest': 'application/manifest+json',
     '.woff': 'font/woff', '.woff2': 'font/woff2', '.wasm': 'application/wasm',
 };
 export async function startProdServer(outDir, options) {
@@ -129,6 +131,10 @@ export async function startProdServer(outDir, options) {
         process.exit(1);
     }
     const buildConfig = JSON.parse(readFileSync(configPath, 'utf-8'));
+    // Baked onHead-plugin head snippet (config.json `headExtra`) — applied to
+    // pages that render directly here (not-found / error) where no SSR function
+    // and no in-process plugin objects exist.
+    const bakedHeadExtra = buildConfig.headExtra || '';
     console.error(`vesk start: serving from ${outDir}`);
     const projectDir = resolve(outDir, '..');
     let securityConfig = {};
@@ -186,6 +192,16 @@ export async function startProdServer(outDir, options) {
             // ignore
         }
     }
+    let eventsMod = null;
+    const eventsPath = resolve(outDir, 'server', 'events.js');
+    if (existsSync(eventsPath)) {
+        try {
+            eventsMod = await import(`${eventsPath}?t=${Date.now()}`);
+        }
+        catch {
+            // ignore
+        }
+    }
     const functionCache = new Map();
     async function loadFunction(funcPath) {
         if (functionCache.has(funcPath))
@@ -319,38 +335,49 @@ export async function startProdServer(outDir, options) {
             }
         }
         let mwCtx;
+        const serverStore = globalThis.__vesk_server_ctx;
         if (middlewareMod) {
             mwCtx = {
                 request: new Request(url.href, { headers: req.headers, method: req.method || 'GET' }),
                 params: {},
                 url,
-                locals: {},
+                locals: Object.assign({}, serverStore || {}),
                 cookies: {},
                 set(key, value) { this.locals[key] = value; },
                 get(key) { return this.locals[key]; },
             };
-            const mwResult = await middlewareMod.execute(mwCtx);
-            if (mwResult.response) {
-                const body = await mwResult.response.text();
-                res.writeHead(mwResult.response.status, Object.fromEntries(mwResult.response.headers));
-                res.end(body);
-                return;
-            }
-            if (mwResult.rewriteUrl) {
-                url.pathname = mwResult.rewriteUrl;
-            }
         }
         else {
             mwCtx = {
                 params: {},
                 url,
-                locals: {},
+                locals: Object.assign({}, serverStore || {}),
                 cookies: {},
                 request: null,
                 set() { },
                 get() { return undefined; },
             };
         }
+        if (eventsMod) {
+            try {
+                await eventsMod.executeRequest?.(mwCtx);
+            }
+            catch (e) {
+                console.error('vesk request: onRequest error:', e instanceof Error ? e.message : e);
+            }
+        }
+        if (middlewareMod) {
+            const mwResult = await middlewareMod.execute(mwCtx);
+            if (mwResult.response) {
+                const body = await mwResult.response.text();
+                res.writeHead(mwResult.response.status, Object.fromEntries(mwResult.response.headers));
+                res.end(body);
+                return;
+            }
+            if (mwResult.rewriteUrl) {
+                url.pathname = mwResult.rewriteUrl;
+            }
+        }
         // Expose root middleware locals to API/SSR handlers (which seed their own
         // ctx.locals from this before running route-level middleware).
         globalThis.__vesk_request = mwCtx;
@@ -408,6 +435,10 @@ export async function startProdServer(outDir, options) {
             }
         }
         const appDir = resolve(projectDir, 'app');
+        const pageCssUrls = resolveCssUrls({
+            tailwind: hasBuiltTailwindCss(outDir),
+            userCss: hasUserCss(appDir),
+        });
         const nfPath = resolve(appDir, 'not-found.vsk');
         let notFoundHtml = null;
         if (existsSync(nfPath)) {
@@ -416,13 +447,7 @@ export async function startProdServer(outDir, options) {
                 const { renderFullPage, storeDataScriptGlobal } = await import(runtimePath);
                 const src = readFileSync(nfPath, 'utf-8');
                 const compName = resolveComponentName(src) || 'NotFound';
-                const tailwindPathNF = resolve(outDir, 'static', '_tailwind.css');
-                const hasTailwindNF = existsSync(tailwindPathNF) && readFileSync(tailwindPathNF, 'utf-8').trim().length > 0;
-                const cssUrlsNF = [];
-                if (hasTailwindNF)
-                    cssUrlsNF.push('/_vesk/static/_tailwind.css');
-                cssUrlsNF.push('/_vesk/static/global.css');
-                notFoundHtml = await renderFullPage(src, compName, { params: {}, url: url.pathname }, new Map(), { hydrate: true, cssUrls: cssUrlsNF, security: securityConfig?.security || {}, externalDataScript: storeDataScriptGlobal, sourcePath: nfPath });
+                notFoundHtml = await renderFullPage(src, compName, { params: {}, url: url.pathname }, new Map(), { hydrate: true, cssUrls: pageCssUrls, security: securityConfig?.security || {}, externalDataScript: storeDataScriptGlobal, sourcePath: nfPath, headExtra: bakedHeadExtra });
             }
             catch { }
         }
@@ -491,13 +516,7 @@ export async function startProdServer(outDir, options) {
                                     const compName = resolveComponentName(src) || 'Error';
                                     // never leak stack traces / internal messages to prod error pages
                                     const expose = process.env.NODE_ENV !== 'production';
-                                    const tailwindPathErr = resolve(outDir, 'static', '_tailwind.css');
-                                    const hasTailwindErr = existsSync(tailwindPathErr) && readFileSync(tailwindPathErr, 'utf-8').trim().length > 0;
-                                    const cssUrlsErr = [];
-                                    if (hasTailwindErr)
-                                        cssUrlsErr.push('/_vesk/static/_tailwind.css');
-                                    cssUrlsErr.push('/_vesk/static/global.css');
-                                    errorHtml = await renderFullPage(src, compName, { error: expose ? err.message : 'Internal Server Error', stack: expose ? err.stack : '', statusCode: 500, url: url.pathname }, new Map(), { hydrate: true, cssUrls: cssUrlsErr, clientScriptUrl: '/_vesk/static/client.js', security: securityConfig?.security || {}, externalDataScript: storeDataScriptGlobal, sourcePath: errPath });
+                                    errorHtml = await renderFullPage(src, compName, { error: expose ? err.message : 'Internal Server Error', stack: expose ? err.stack : '', statusCode: 500, url: url.pathname }, new Map(), { hydrate: true, cssUrls: pageCssUrls, clientScriptUrl: '/_vesk/static/client.js', security: securityConfig?.security || {}, externalDataScript: storeDataScriptGlobal, sourcePath: errPath, headExtra: bakedHeadExtra });
                                 }
                                 catch { }
                             }
@@ -512,6 +531,33 @@ export async function startProdServer(outDir, options) {
         res.writeHead(404, { 'Content-Type': 'text/html' });
         res.end(notFoundHtml || '<!DOCTYPE html><html><body><h1>404</h1><p>Not Found</p></body></html>');
     });
+    try {
+        await eventsMod?.executeStart?.({ server, port, host });
+    }
+    catch (e) {
+        console.error('vesk start: onStart error:', e instanceof Error ? e.message : e);
+    }
+    server.on('close', () => {
+        void (async () => {
+            try {
+                await eventsMod?.executeStop?.({ server, port, host });
+            }
+            catch (e) {
+                console.error('vesk stop: onStop error:', e instanceof Error ? e.message : e);
+            }
+        })();
+    });
+    let shuttingDown = false;
+    function shutdown(signal) {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        console.error(`vesk stop: received ${signal}, closing…`);
+        server.close(() => process.exit(0));
+        setTimeout(() => process.exit(0), 3000).unref();
+    }
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
     server.listen(port, host, () => {
         console.error(`vesk production server at http://localhost:${port} (listening on ${host})`);
     });

package/dist/runtime-bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-bundle.d.ts","sourceRoot":"","sources":["../src/runtime-bundle.ts"],"names":[],"mappings":"AAuCA,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA2GnF"}
+{"version":3,"file":"runtime-bundle.d.ts","sourceRoot":"","sources":["../src/runtime-bundle.ts"],"names":[],"mappings":"AAuCA,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqHnF"}

package/dist/runtime-bundle.js

@@ -113,6 +113,16 @@ export async function bundleRuntime(appDir, outDir) {
         'export const clearActions = __veskRuntime.clearActions;',
         'export const validateActionInput = __veskRuntime.validateActionInput;',
         'export const issuesToFieldMap = __veskRuntime.issuesToFieldMap;',
+        '',
+        '// Server-wide context store (server events)',
+        'export const serverLocals = __veskRuntime.serverLocals;',
+        'export const getServerContext = __veskRuntime.getServerContext;',
+        'export const setServerContext = __veskRuntime.setServerContext;',
+        'export const clearServerContext = __veskRuntime.clearServerContext;',
+        'export const server_locals = __veskRuntime.server_locals;',
+        'export const get_server_context = __veskRuntime.get_server_context;',
+        'export const set_server_context = __veskRuntime.set_server_context;',
+        'export const clear_server_context = __veskRuntime.clear_server_context;',
     ].join('\n');
     writeFileSync(entryFile, entryContent, 'utf-8');
     try {

package/dist/ssr-function.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssr-function.d.ts","sourceRoot":"","sources":["../src/ssr-function.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAkB,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAW7F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQjF;AAiDD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAqXtD"}
+{"version":3,"file":"ssr-function.d.ts","sourceRoot":"","sources":["../src/ssr-function.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAkB,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAW7F,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQjF;AAiDD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,OAAO,CAAC,EAAE,kBAAkB,GAC3B;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAsXtD"}