@vesk/adapter 0.2.13 → 0.2.16

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

@@ -1 +1 @@
-{"version":3,"file":"client-bundle.d.ts","sourceRoot":"","sources":["../src/client-bundle.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAqC,MAAM,yBAAyB,CAAC;AAoCrI;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA8BhE;AAoLD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkBxD;AAmCD,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,SAAS,EAAE,EACtB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CA0S7B;AAMD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA+B3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAUlE;AAYD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuCrG"}
+{"version":3,"file":"client-bundle.d.ts","sourceRoot":"","sources":["../src/client-bundle.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAqC,MAAM,yBAAyB,CAAC;AAoCrI;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA8BhE;AAoLD;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAkBxD;AAmCD,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,SAAS,EAAE,EACtB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CA4T7B;AAMD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CA+B3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAUlE;AAYD;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuCrG"}

package/dist/client-bundle.js

@@ -459,6 +459,21 @@ export async function generateClientBundle(routeTree, appDir, componentMap, opti
         return slug.replace(/[\[\]]/g, '_');
     }
     const codeSplit = !!(options?.codeSplit);
+    const transformPlugins = options?.plugins || [];
+    /** Run every active plugin's `onTransformJS` over an emitted bundle/chunk source. */
+    async function applyTransformPlugins(code, filePath) {
+        if (transformPlugins.length === 0)
+            return code;
+        let out = code;
+        for (const plugin of transformPlugins) {
+            if (typeof plugin.onTransformJS === 'function') {
+                const result = await plugin.onTransformJS(out, filePath);
+                if (typeof result === 'string')
+                    out = result;
+            }
+        }
+        return out;
+    }
     if (codeSplit) {
         const chunkEntries = [];
         function walkSplit(nodes, _chain) {
@@ -537,7 +552,11 @@ export async function generateClientBundle(routeTree, appDir, componentMap, opti
             if (cache)
                 cache.mainBundle = { key: mainKey, code: main };
         }
-        return { main, chunks, cachedFileHits, compiledFiles, mainFromCache, editedSources, editedNames };
+        const transformedChunks = [];
+        for (const chunk of chunks) {
+            transformedChunks.push({ ...chunk, code: await applyTransformPlugins(chunk.code, chunk.name) });
+        }
+        return { main: await applyTransformPlugins(main, 'client.js'), chunks: transformedChunks, cachedFileHits, compiledFiles, mainFromCache, editedSources, editedNames };
     }
     else {
         let componentLines = [];
@@ -603,7 +622,7 @@ export async function generateClientBundle(routeTree, appDir, componentMap, opti
             componentLines, hydratorLines, aliasLines, hydratorAliasLines,
         }, !!options?.hmr, !!options?.importRuntime, runtimeImportNames, options?.routeDataCache);
         // Mono (non-codeSplit) builds are the production path — no incremental cache.
-        return { main, chunks: [] };
+        return { main: await applyTransformPlugins(main, 'client.js'), chunks: [] };
     }
 }
 function stripTypes(code) {

package/dist/css.d.ts

@@ -0,0 +1,26 @@
+export declare const TAILWIND_CSS_URL = "/_vesk/static/_tailwind.css";
+export declare const GLOBAL_CSS_URL = "/_vesk/static/global.css";
+/** Resolve the project's user stylesheet source (`src/global.css`, then `src/app.css`). */
+export declare function resolveUserCssPath(appDir: string): string | null;
+/** True when the project has a user stylesheet source (`src/global.css` or `src/app.css`). */
+export declare function hasUserCss(appDir: string): boolean;
+/** True when a non-empty `_tailwind.css` was produced for the build (prod disk output). */
+export declare function hasBuiltTailwindCss(outDir: string): boolean;
+/** True when the active plugin pipeline includes the tailwind plugin. */
+export declare function isTailwindPlugin(plugins: Array<{
+    name?: string;
+}> | undefined | null): boolean;
+/**
+ * Single source of truth for the `/_vesk/static/*.css` link list. Callers
+ * supply environment facts — `tailwind`: tailwind output is available
+ * (built-file present + non-empty in prod, active plugin in dev);
+ * `userCss`: a user stylesheet exists — so build, request, dev, and prod
+ * paths share one ordering.
+ */
+export declare function resolveCssUrls(opts: {
+    tailwind?: boolean;
+    userCss?: boolean;
+}): string[];
+/** Drop tailwind framework directives from user CSS, keeping hand-written rules. */
+export declare function stripTailwindDirectives(css: string): string;
+//# sourceMappingURL=css.d.ts.map

package/dist/css.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../src/css.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAC9D,eAAO,MAAM,cAAc,6BAA6B,CAAC;AAEzD,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMhE;AAED,8FAA8F;AAC9F,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAE9F;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,EAAE,CAKxF;AAED,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAkB3D"}

package/dist/css.js

@@ -0,0 +1,70 @@
+/**
+ * Shared stylesheet resolution for the adapter build, prod server, generated
+ * SSR functions, dev server, and action handler. Each environment feeds its
+ * facts (`tailwind` output available, user stylesheet present) into
+ * `resolveCssUrls`, so the `/_vesk/static/*.css` link list and its ordering
+ * come from one place instead of six ad-hoc copies.
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { cssBlockEnd } from '@vesk/compiler/src/scan';
+export const TAILWIND_CSS_URL = '/_vesk/static/_tailwind.css';
+export const GLOBAL_CSS_URL = '/_vesk/static/global.css';
+/** Resolve the project's user stylesheet source (`src/global.css`, then `src/app.css`). */
+export function resolveUserCssPath(appDir) {
+    const cssSrc = resolve(appDir, '..', 'src', 'global.css');
+    if (existsSync(cssSrc))
+        return cssSrc;
+    const altCssSrc = resolve(appDir, '..', 'src', 'app.css');
+    if (existsSync(altCssSrc))
+        return altCssSrc;
+    return null;
+}
+/** True when the project has a user stylesheet source (`src/global.css` or `src/app.css`). */
+export function hasUserCss(appDir) {
+    return resolveUserCssPath(appDir) !== null;
+}
+/** True when a non-empty `_tailwind.css` was produced for the build (prod disk output). */
+export function hasBuiltTailwindCss(outDir) {
+    const p = resolve(outDir, 'static', '_tailwind.css');
+    return existsSync(p) && readFileSync(p, 'utf-8').trim().length > 0;
+}
+/** True when the active plugin pipeline includes the tailwind plugin. */
+export function isTailwindPlugin(plugins) {
+    return (plugins || []).some((p) => String(p && p.name).toLowerCase().includes('tailwind'));
+}
+/**
+ * Single source of truth for the `/_vesk/static/*.css` link list. Callers
+ * supply environment facts — `tailwind`: tailwind output is available
+ * (built-file present + non-empty in prod, active plugin in dev);
+ * `userCss`: a user stylesheet exists — so build, request, dev, and prod
+ * paths share one ordering.
+ */
+export function resolveCssUrls(opts) {
+    const urls = [];
+    if (opts.tailwind)
+        urls.push(TAILWIND_CSS_URL);
+    if (opts.userCss)
+        urls.push(GLOBAL_CSS_URL);
+    return urls;
+}
+/** Drop tailwind framework directives from user CSS, keeping hand-written rules. */
+export 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();
+}

package/dist/dev-server.d.ts

@@ -1,4 +1,5 @@
 import { type Server } from 'node:http';
+import type { HmrErrorPayload } from './hmr';
 import type { DevServerOptions } from '@vesk/adapter/src/types';
 /**
  * Shape returned by the dev HMR state endpoint. Mirrors what the parallel
@@ -9,7 +10,7 @@ import type { DevServerOptions } from '@vesk/adapter/src/types';
 export interface DevHmrState {
     status: 'up' | 'compiling' | 'error' | 'down';
     lastCompileMs: number | null;
-    error: Record<string, unknown> | null;
+    error: HmrErrorPayload | Record<string, unknown> | null;
     hasError: boolean;
     componentCount: number;
     /** Whether the @vesk/agentic plugin is installed and active (mirrors the

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

@@ -1 +1 @@
-{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../src/dev-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,MAAM,EAA6C,MAAM,WAAW,CAAC;AAUjG,OAAO,KAAK,EAAa,gBAAgB,EAAwB,MAAM,yBAAyB,CAAC;AAgBjG;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,IAAI,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACtC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB;+EAC2E;IAC3E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,IAAI,WAAW,CAEhD;AAuCD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAIzE;AAkBD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,mHAAmH;IACnH,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B;;8BAE0B;IAC1B,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,WAAW,CAAC;IAChC,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,wBAAwB,GAAG;IACvE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CAChH,CAUA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAa3C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AA6CD,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuevG"}
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../src/dev-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,MAAM,EAA6C,MAAM,WAAW,CAAC;AAOjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAI7C,OAAO,KAAK,EAAa,gBAAgB,EAAwB,MAAM,yBAAyB,CAAC;AAgBjG;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,IAAI,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB;+EAC2E;IAC3E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,IAAI,WAAW,CAEhD;AAuCD,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAIzE;AAkBD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,mHAAmH;IACnH,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC7B;;8BAE0B;IAC1B,MAAM,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,WAAW,CAAC;IAChC,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,wBAAwB,GAAG;IACvE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;CAChH,CAUA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAa3C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIrD;AA8CD,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA8hBvG"}

package/dist/dev-server.js

@@ -192,6 +192,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 startDevServer(appDir, options) {
@@ -354,6 +355,20 @@ export async function startDevServer(appDir, options) {
     let ssrVersion = Date.now();
     let routeTree = [];
     let runtimeBundle = '';
+    let eventsMod = null;
+    async function reloadEventsMod() {
+        const eventsPath = resolve(devDir, 'server', 'events.js');
+        if (existsSync(eventsPath)) {
+            try {
+                eventsMod = await import(`${eventsPath}?t=${Date.now()}`);
+                return;
+            }
+            catch {
+                // ignore — events file present but failed to load
+            }
+        }
+        eventsMod = null;
+    }
     async function doBuild() {
         const start = Date.now();
         try {
@@ -367,6 +382,7 @@ export async function startDevServer(appDir, options) {
             const monorepoRoot = resolve(__dirname, '..', '..', '..');
             const runtimeDir = resolve(monorepoRoot, 'packages', 'runtime', 'dist');
             runtimeBundle = buildRuntimeCode(runtimeDir);
+            await reloadEventsMod();
             lastBuild = Date.now();
             console.error(`vesk dev: rebuilt in ${Date.now() - start}ms`);
         }
@@ -504,6 +520,24 @@ export async function startDevServer(appDir, options) {
                 return;
             }
         }
+        if (eventsMod) {
+            const serverStore = globalThis.__vesk_server_ctx || {};
+            const webRequest = makeWebRequest(req, url.href, maxBodyBytes);
+            const evtCtx = {
+                request: webRequest,
+                params: {},
+                url,
+                locals: Object.assign({}, serverStore),
+                cookies: {},
+            };
+            globalThis.__vesk_request = evtCtx;
+            try {
+                await eventsMod.executeRequest?.(evtCtx);
+            }
+            catch (e) {
+                console.error('vesk request: onRequest error:', e instanceof Error ? e.message : e);
+            }
+        }
         if (config && url.pathname.startsWith('/_vesk/action/')) {
             const actionId = url.pathname.replace('/_vesk/action/', '');
             const actionEntry = config.actions && config.actions.find(a => a.id === actionId);
@@ -675,6 +709,24 @@ export async function startDevServer(appDir, options) {
     catch (e) {
         console.error('vesk dev: file watching unavailable');
     }
+    const bootEventsMod = eventsMod;
+    try {
+        await bootEventsMod?.executeStart?.({ server, port, host });
+    }
+    catch (e) {
+        console.error('vesk dev: onStart error:', e instanceof Error ? e.message : e);
+    }
+    server.on('close', () => {
+        void (async () => {
+            const stopEventsMod = eventsMod;
+            try {
+                await stopEventsMod?.executeStop?.({ server, port, host });
+            }
+            catch (e) {
+                console.error('vesk dev: onStop error:', e instanceof Error ? e.message : e);
+            }
+        })();
+    });
     await new Promise(resolve => {
         server.listen(port, host, () => {
             console.error(`vesk dev server at http://localhost:${port} (listening on ${host})`);

package/dist/events.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Compile the app's `_events.ts` (if present) into a self-contained
+ * `server/events.js` next to the server runtime. Returns true when an events
+ * file existed and was compiled. Relative imports inside `_events.ts` are
+ * bundled by esbuild; node builtins stay external so node (prod-server) and
+ * edge (platform handler) can both resolve them.
+ */
+export declare function compileEvents(appDir: string, outDir: string): Promise<boolean>;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAqEA;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiCpF"}

package/dist/events.js

@@ -0,0 +1,109 @@
+import { writeFileSync, unlinkSync, mkdirSync } from 'node:fs';
+import { resolve } from 'node:path';
+import * as esbuild from './esbuild-fallback.js';
+import { collectEventsFile } from '@vesk/compiler/src/events';
+let buildId = 0;
+/**
+ * Wrapper module bundled into `server/events.js`. It lifts the user's
+ * `_events.ts` exports into `executeStart` / `executeRequest` / `executeStop`
+ * entry points with a context that routes `set`/`get` into the process-wide
+ * server context (`globalThis.__vesk_server_ctx`).
+ *
+ * The `__vesk_events_started` guard is global (not module-local) so lazy edge
+ * isolates and the Node prod server share one lifetime; `onStop` clears it so
+ * dev HMR reloads can boot a fresh module.
+ */
+function buildEntry(sourcePath) {
+    return [
+        `import * as __events from ${JSON.stringify(sourcePath)};`,
+        '',
+        'const __store = () => (globalThis.__vesk_server_ctx ||= {});',
+        '',
+        'const __handlers = {};',
+        "for (const __name of ['onStart', 'onRequest', 'onStop']) {",
+        '  const __fn = __events[__name];',
+        "  if (typeof __fn === 'function') __handlers[__name] = __fn;",
+        '}',
+        '',
+        'function __makeCtx(base) {',
+        '  const store = __store();',
+        '  const start = base && typeof base === \'object\' ? base : {};',
+        '  return Object.assign({}, start, {',
+        '    server: start.server !== undefined ? start.server : null,',
+        '    port: start.port !== undefined ? start.port : 0,',
+        '    host: start.host,',
+        '    serverLocals: store,',
+        '    set(key, value) { store[key] = value; return value; },',
+        '    get(key) { return store[key]; },',
+        '  });',
+        '}',
+        '',
+        'export async function executeStart(base) {',
+        '  if (globalThis.__vesk_events_started) return;',
+        '  globalThis.__vesk_events_started = true;',
+        '  if (typeof __handlers.onStart === \'function\') await __handlers.onStart(__makeCtx(base));',
+        '}',
+        '',
+        'export async function executeRequest(base) {',
+        '  if (typeof __handlers.onRequest !== \'function\') return;',
+        '  await __handlers.onRequest(__makeCtx(base));',
+        '}',
+        '',
+        'export async function executeStop(base) {',
+        '  if (typeof __handlers.onStop !== \'function\') return;',
+        '  try {',
+        '    await __handlers.onStop(__makeCtx(base));',
+        '  } finally {',
+        '    globalThis.__vesk_events_started = false;',
+        '  }',
+        '}',
+        '',
+        'export const onStart = __handlers.onStart;',
+        'export const onRequest = __handlers.onRequest;',
+        'export const onStop = __handlers.onStop;',
+        '',
+    ].join('\n');
+}
+/**
+ * Compile the app's `_events.ts` (if present) into a self-contained
+ * `server/events.js` next to the server runtime. Returns true when an events
+ * file existed and was compiled. Relative imports inside `_events.ts` are
+ * bundled by esbuild; node builtins stay external so node (prod-server) and
+ * edge (platform handler) can both resolve them.
+ */
+export async function compileEvents(appDir, outDir) {
+    const sourcePath = collectEventsFile(appDir);
+    if (!sourcePath)
+        return false;
+    const serverDir = resolve(outDir, 'server');
+    mkdirSync(serverDir, { recursive: true });
+    const entryFile = resolve(serverDir, `.events-entry-${buildId++}.mjs`);
+    writeFileSync(entryFile, buildEntry(sourcePath), 'utf-8');
+    try {
+        const result = await esbuild.build({
+            entryPoints: [entryFile],
+            bundle: true,
+            platform: 'neutral',
+            format: 'esm',
+            minify: true,
+            outfile: resolve(serverDir, 'events.js'),
+            external: ['fs', 'node:fs', 'path', 'node:path', 'module', 'node:module', 'node:async_hooks'],
+            target: ['es2022'],
+            treeShaking: true,
+        });
+        if (result.errors.length > 0) {
+            throw new Error(`esbuild errors: ${result.errors.map((e) => e.text).join(', ')}`);
+        }
+        if (result.warnings.length > 0) {
+            for (const w of result.warnings)
+                console.error('vesk build warning:', w.text);
+        }
+        return true;
+    }
+    finally {
+        try {
+            unlinkSync(entryFile);
+        }
+        catch { /* ignore */ }
+    }
+}

package/dist/hmr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../src/hmr.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AASxC,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEvG,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,yBAAyB,CAAC;AAIzE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD,wBAAgB,WAAW,IAAI;IAC7B,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAQA;AAED,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,wBAA6B,GAClC,eAAe,CA4DjB;AA2RD,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC;IACD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAClE,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvH,WAAW,EAAE,MAAM,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;CACnD,CAyJA"}
+{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../src/hmr.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAUxC,OAAO,EAAsC,KAAK,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAEvG,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,yBAAyB,CAAC;AAIzE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD,wBAAgB,WAAW,IAAI;IAC7B,MAAM,EAAE,IAAI,GAAG,QAAQ,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAQA;AAED,MAAM,WAAW,wBAAwB;IACvC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,wBAA6B,GAClC,eAAe,CAsEjB;AA0RD,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACjC;IACD,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAClE,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvH,WAAW,EAAE,MAAM,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;CACnD,CAyJA"}

package/dist/hmr.js

@@ -6,6 +6,7 @@ import { compileClient } from '@vesk/compiler/src/client-codegen';
 import { buildHmrEvalSnippet } from './client-bundle';
 import { resolveComponentName, randomToken } from '@vesk/compiler/src/server-codegen';
 import { resolveErrorFile } from '@vesk/adapter/src/ssr-function';
+import { resolveCssUrls, hasUserCss, hasBuiltTailwindCss } from '@vesk/adapter/src/css';
 import { isAllowedWsUpgrade } from '@vesk/adapter/src/paths';
 import { parseCompilerError, buildCodeframe } from '@vesk/adapter/src/error-codeframe';
 import { suggestFor } from '@vesk/adapter/src/error-tips';
@@ -78,11 +79,19 @@ export function buildErrorPayload(error, filename, opts = {}) {
     const filePath = typeof opts.appDir === 'string'
         ? resolve(opts.appDir, file)
         : undefined;
+    // The file header already shows the location; strip the redundant
+    // " in <file>" suffix compilers append to messages (e.g. acorn's
+    // "Unexpected token in /abs/app/page.vsk").
+    const cleanMessage = filePath && message.endsWith(` in ${filePath}`)
+        ? message.slice(0, -` in ${filePath}`.length).trim()
+        : message.endsWith(` in ${file}`)
+            ? message.slice(0, -` in ${file}`.length).trim()
+            : message;
     const payload = {
         file,
         line,
         column,
-        message,
+        message: cleanMessage,
     };
     if (filePath)
         payload.filePath = filePath;
@@ -232,19 +241,16 @@ function buildParamExtraction(node, urlParts) {
 }
 function regenerateSsrFunction(routeNode, appDir, outDir, componentMap, options) {
     const ancestorLayouts = options?.ancestorLayouts || [];
+    const headExtra = options?.headExtra || null;
     const pagePath = resolve(appDir, routeNode.sourceDir, 'page.vsk');
     const layoutPath = resolve(appDir, routeNode.sourceDir, 'layout.vsk');
-    const tailwindPath = resolve(outDir, 'static', '_tailwind.css');
-    const globalCssPath = resolve(appDir, '..', 'src', 'global.css');
-    const altCssPath = resolve(appDir, '..', 'src', 'app.css');
-    const hasGlobalCss = existsSync(globalCssPath) || existsSync(altCssPath);
-    const hasTailwind = existsSync(tailwindPath) && readFileSync(tailwindPath, 'utf-8').trim().length > 0;
-    const cssUrls = [];
-    if (hasTailwind)
-        cssUrls.push('/_vesk/static/_tailwind.css');
-    if (hasGlobalCss)
-        cssUrls.push('/_vesk/static/global.css');
+    const cssUrls = resolveCssUrls({
+        tailwind: hasBuiltTailwindCss(outDir),
+        userCss: hasUserCss(appDir),
+    });
     const cssOption = cssUrls.length > 0 ? `, cssUrls: ${JSON.stringify(cssUrls)}` : '';
+    const headExtraOption = headExtra ? `, headExtra: ${JSON.stringify(headExtra)}` : '';
+    const bakedOptions = cssOption + headExtraOption;
     const parts = routeNode.fullPath.split('/').filter(Boolean);
     const name = routeName(parts);
     const funcDir = resolve(outDir, 'server', 'functions');
@@ -323,7 +329,7 @@ function regenerateSsrFunction(routeNode, appDir, outDir, componentMap, options)
             "    const stack = err && typeof err === 'object' && 'stack' in err ? String(err.stack) : '';",
             "    page = { body: await __renderErrorBody({ params, statusCode: 500, error: message, stack, url: url.href }), head: '' };",
             '  }',
-            '  const html = await renderFullPage(_layoutSrc, _layoutComp, { params, children: (caughtError ? \'<!--vesk-ssr-error:\' + (caughtError && typeof caughtError === \'object\' && \'message\' in caughtError ? encodeURIComponent(String(caughtError.message)) : \'\') + \'-->\' : \'\') + page.body }, __componentRegistry, { hydrate: true, cached: _layoutCompiled' + cssOption + clientScriptOption + dataScriptOption + ', pageHead: page.head, sourcePath: _layoutPath });',
+            '  const html = await renderFullPage(_layoutSrc, _layoutComp, { params, children: (caughtError ? \'<!--vesk-ssr-error:\' + (caughtError && typeof caughtError === \'object\' && \'message\' in caughtError ? encodeURIComponent(String(caughtError.message)) : \'\') + \'-->\' : \'\') + page.body }, __componentRegistry, { hydrate: true, cached: _layoutCompiled' + bakedOptions + clientScriptOption + dataScriptOption + ', pageHead: page.head, sourcePath: _layoutPath });',
             "  return new Response(html, { headers: { 'Content-Type': 'text/html' }, status: caughtError ? 500 : 200 });",
         ].join('\n');
     }
@@ -340,7 +346,7 @@ function regenerateSsrFunction(routeNode, appDir, outDir, componentMap, options)
             "    const stack = err && typeof err === 'object' && 'stack' in err ? String(err.stack) : '';",
             "    page = { body: await __renderErrorBody({ params, statusCode: 500, error: message, stack, url: url.href }), head: '' };",
             '  }',
-            '  const html = await renderFullPage(_layoutSrc, _layoutComp, { params, children: (caughtError ? \'<!--vesk-ssr-error:\' + (caughtError && typeof caughtError === \'object\' && \'message\' in caughtError ? encodeURIComponent(String(caughtError.message)) : \'\') + \'-->\' : \'\') + page.body }, __componentRegistry, { hydrate: true, cached: _layoutCompiled' + cssOption + clientScriptOption + dataScriptOption + ', pageHead: page.head, sourcePath: _layoutPath });',
+            '  const html = await renderFullPage(_layoutSrc, _layoutComp, { params, children: (caughtError ? \'<!--vesk-ssr-error:\' + (caughtError && typeof caughtError === \'object\' && \'message\' in caughtError ? encodeURIComponent(String(caughtError.message)) : \'\') + \'-->\' : \'\') + page.body }, __componentRegistry, { hydrate: true, cached: _layoutCompiled' + bakedOptions + clientScriptOption + dataScriptOption + ', pageHead: page.head, sourcePath: _layoutPath });',
             "  return new Response(html, { headers: { 'Content-Type': 'text/html' }, status: caughtError ? 500 : 200 });",
         ].join('\n');
     }
@@ -348,13 +354,13 @@ function regenerateSsrFunction(routeNode, appDir, outDir, componentMap, options)
         renderCode = [
             '  let stream;',
             '  try {',
-            '    stream = renderPageStream(_src, _comp, { params }, __componentRegistry, { hydrate: true, cached: _srcCompiled' + cssOption + clientScriptOption + dataScriptOption + ", sourcePath: _srcPath });",
+            '    stream = renderPageStream(_src, _comp, { params }, __componentRegistry, { hydrate: true, cached: _srcCompiled' + bakedOptions + clientScriptOption + dataScriptOption + ", sourcePath: _srcPath });",
             '  } catch (err) {',
             '    if (err && (err.name === \'NotFoundError\' || err.name === \'Redirect\')) throw err;',
             '    if (!_errorSrc) throw err;',
             "    const message = err && typeof err === 'object' && 'message' in err ? String(err.message) : String(err);",
             "    const stack = err && typeof err === 'object' && 'stack' in err ? String(err.stack) : '';",
-            "    const html = await renderFullPage(_errorSrc, _errorComp, { params, statusCode: 500, error: message, stack, url: url.href }, __componentRegistry, { hydrate: true, cached: _errorCompiled" + cssOption + clientScriptOption + dataScriptOption + ', sourcePath: _errorPath });',
+            "    const html = await renderFullPage(_errorSrc, _errorComp, { params, statusCode: 500, error: message, stack, url: url.href }, __componentRegistry, { hydrate: true, cached: _errorCompiled" + bakedOptions + clientScriptOption + dataScriptOption + ', sourcePath: _errorPath });',
             "    return new Response(html, { headers: { 'Content-Type': 'text/html' }, status: 500 });",
             '  }',
             '  return new Response(new ReadableStream({',

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACe,YAAY,EAAE,WAAW,EAC7B,UAAU,EAChC,MAAM,yBAAyB,CAAC;AAiBjC;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AACD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,GAC9C,UAAU,EAAE,CAQd;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EAAE,EACrB,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACxC,UAAU,EAAE,CAGd;AAWD,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAyVpG;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIhE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACe,YAAY,EAAE,WAAW,EAC7B,UAAU,EAChC,MAAM,yBAAyB,CAAC;AAiBjC;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;CACjB;AACD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,UAAU,EAAE,EACrB,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI,GAAG,SAAS,GAC9C,UAAU,EAAE,CAQd;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,UAAU,EAAE,EACrB,KAAK,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,GACxC,UAAU,EAAE,CAGd;AA+BD,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAyUpG;AAED,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIhE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,EACzB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,2BAA2B,CAAC"}