@vesk/adapter 0.2.28 → 0.2.29

package/dist/client-bundle.d.ts

@@ -14,6 +14,78 @@ import type { RouteNode, ClientBundleOptions, ClientBundleResult } from '@vesk/a
  * than guess.
  */
 export declare function extractRuntimeImportNames(code: string): string[];
+/**
+ * Minimal structural view of a compiled client module's top-level statements.
+ * Everything here is read from the compiler's AST — no text scanning — so
+ * import-shaped doc samples inside template literals are never treated as real
+ * statements (see `removeCompiledNodes`).
+ */
+interface CompiledNode {
+    type?: string;
+    importKind?: string;
+    source?: {
+        value?: unknown;
+    };
+    id?: {
+        name?: string;
+    };
+    declarations?: Array<{
+        id?: {
+            name?: string;
+        };
+        init?: {
+            type?: string;
+            object?: {
+                type?: string;
+                name?: string;
+            };
+        };
+    }>;
+    declaration?: {
+        type?: string;
+        object?: {
+            type?: string;
+            name?: string;
+        };
+        declarations?: Array<{
+            init?: {
+                type?: string;
+                object?: {
+                    type?: string;
+                    name?: string;
+                };
+            };
+        }>;
+    };
+    start?: number;
+    end?: number;
+}
+/**
+ * Top-level statements an HMR eval snippet must never carry: imports,
+ * re-exports and the registry preamble (`const __components = …`,
+ * `const __hydrators = …`) plus the `__cleanup` / `__place` helpers. The
+ * eval runs against a live chunk scope where those already exist.
+ */
+export declare function isSnippetDrop(node: CompiledNode): boolean;
+/**
+ * Demotes surviving value exports to plain declarations (`export const x`
+ * becomes `const x`) and drops bare re-export lists (`export { x }`,
+ * `export default …`). Code-split chunks execute as classic scripts inside
+ * an IIFE, so any `export` statement is a SyntaxError — and the chunk-local
+ * binding is all cross-file references need (components resolve through the
+ * `__components` / `__hydrators` registries). Offset-based on the parser AST.
+ */
+export declare function demoteExports(code: string): string;
+/**
+ * Single-parse composition of `demoteExports(removeCompiledNodes(code,
+ * isSnippetDrop))`: drop matches and demote surviving exports in ONE acorn
+ * pass over the original offsets. The two operations never overlap (dropped
+ * statements are imports/preamble/component-re-exports; demoted ones are
+ * other export declarations), so composing their edits yields byte-identical
+ * output — at roughly half the parse cost of the two-pass chain the HMR
+ * hot path used to run on every edit.
+ */
+export declare function stripAndDemoteInOnePass(code: string): string;
 /**
  * Builds the eval-safe HMR update snippet for one compiled file: drops
  * imports, re-exports and the registry preamble (`const __components = …`,
@@ -26,8 +98,20 @@ export declare function extractRuntimeImportNames(code: string): string[];
  * scope, an updated component renders against missing bindings and the
  * swap fails with a ReferenceError that surfaces nowhere the tests assert
  * (no reload, stale DOM, zero page errors).
+ *
+ * Single-parse strip+demote (see `stripAndDemoteInOnePass`) — this sits on
+ * the dev-server's per-edit hot path, where the old two-pass chain cost a
+ * second full acorn parse on every file save.
  */
 export declare function buildHmrEvalSnippet(code: string): string;
+/**
+ * Removes matched top-level statements from a compiled client module using the
+ * parser's exact `start`/`end` offsets — never a text scan, so a doc sample
+ * stored inside a template literal can never be mistaken for a real statement.
+ * If the module cannot be parsed it is returned untouched (the compiler's own
+ * output is always valid ESM, so that branch is unreachable in practice).
+ */
+export declare function removeCompiledNodes(code: string, isTarget: (node: CompiledNode) => boolean): string;
 export declare function generateClientBundle(routeTree: RouteNode[], appDir: string, componentMap?: Map<string, string>, options?: ClientBundleOptions): Promise<ClientBundleResult>;
 export declare function buildRuntimeCode(runtimeDir: string): string;
 /**
@@ -45,4 +129,5 @@ export declare function runtimeExportNames(runtimeDir: string): Set<string>;
  * leaked runtime module-scope names into the page scope.
  */
 export declare function buildTreeShakenRuntime(runtimeDir: string, usedNames: string[]): Promise<string>;
+export {};
 //# sourceMappingURL=client-bundle.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"client-bundle.d.ts","sourceRoot":"","sources":["../src/client-bundle.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAmF,MAAM,yBAAyB,CAAC;AAoCnL;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA8BhE;AAqVD;;;;;;;;;;;;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,CAma7B;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":"AAYA,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAmF,MAAM,yBAAyB,CAAC;AAoCnL;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA8BhE;AAED;;;;;GAKG;AACH,UAAU,YAAY;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC7B,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvB,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,IAAI,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE;gBAAE,IAAI,CAAC,EAAE,MAAM,CAAC;gBAAC,IAAI,CAAC,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IACtH,WAAW,CAAC,EAAE;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC1C,YAAY,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,CAAC,EAAE;gBAAE,IAAI,CAAC,EAAE,MAAM,CAAC;gBAAC,MAAM,CAAC,EAAE;oBAAE,IAAI,CAAC,EAAE,MAAM,CAAC;oBAAC,IAAI,CAAC,EAAE,MAAM,CAAA;iBAAE,CAAA;aAAE,CAAA;SAAE,CAAC,CAAC;KAC/F,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAmDD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAKzD;AAkCD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBlD;AA4MD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmC5D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAYxD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,GAAG,MAAM,CAwBnG;AAED,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,CAma7B;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

@@ -128,6 +128,19 @@ function isComponentExport(node) {
     }
     return false;
 }
+/**
+ * Top-level statements an HMR eval snippet must never carry: imports,
+ * re-exports and the registry preamble (`const __components = …`,
+ * `const __hydrators = …`) plus the `__cleanup` / `__place` helpers. The
+ * eval runs against a live chunk scope where those already exist.
+ */
+export function isSnippetDrop(node) {
+    if (isAnyImport(node) || isComponentExport(node) || isRuntimePreamble(node))
+        return true;
+    return node.type === 'VariableDeclaration'
+        && (node.declarations?.[0]?.id?.name === '__components'
+            || node.declarations?.[0]?.id?.name === '__hydrators');
+}
 /**
  * Extracts matched top-level statements from a compiled client module using
  * the parser's exact `start`/`end` offsets — the complement of
@@ -168,7 +181,7 @@ function isModuleLevel(node) {
  * binding is all cross-file references need (components resolve through the
  * `__components` / `__hydrators` registries). Offset-based on the parser AST.
  */
-function demoteExports(code) {
+export function demoteExports(code) {
     let ast;
     try {
         ast = parse(code);
@@ -411,6 +424,59 @@ function scopeFileContribution(code) {
         return code;
     }
 }
+/**
+ * Single-parse composition of `demoteExports(removeCompiledNodes(code,
+ * isSnippetDrop))`: drop matches and demote surviving exports in ONE acorn
+ * pass over the original offsets. The two operations never overlap (dropped
+ * statements are imports/preamble/component-re-exports; demoted ones are
+ * other export declarations), so composing their edits yields byte-identical
+ * output — at roughly half the parse cost of the two-pass chain the HMR
+ * hot path used to run on every edit.
+ */
+export function stripAndDemoteInOnePass(code) {
+    let ast;
+    try {
+        ast = parse(code);
+    }
+    catch {
+        return code;
+    }
+    const body = ast.body ?? [];
+    const edits = [];
+    for (const raw of body) {
+        const node = raw;
+        if (typeof node.start !== 'number' || typeof node.end !== 'number')
+            continue;
+        const isExport = node.type === 'ExportNamedDeclaration' || node.type === 'ExportDefaultDeclaration';
+        if (isSnippetDrop(node)) {
+            let cut = node.end;
+            if (code[cut] === ';')
+                cut++;
+            if (code.startsWith('\r\n', cut))
+                cut += 2;
+            else if (code[cut] === '\n' || code[cut] === '\r')
+                cut++;
+            edits.push({ start: node.start, end: cut });
+        }
+        else if (isExport && node.type === 'ExportNamedDeclaration' && node.declaration
+            && typeof node.declaration.start === 'number' && typeof node.declaration.end === 'number') {
+            edits.push({ start: node.start, end: node.end, text: code.slice(node.declaration.start, node.declaration.end) });
+        }
+        else if (isExport) {
+            let cut = node.end;
+            if (code[cut] === ';')
+                cut++;
+            edits.push({ start: node.start, end: cut });
+        }
+    }
+    if (edits.length === 0)
+        return code;
+    edits.sort((a, b) => b.start - a.start);
+    for (const e of edits) {
+        code = code.slice(0, e.start) + (e.text ?? '') + code.slice(e.end);
+    }
+    return code;
+}
 /**
  * Builds the eval-safe HMR update snippet for one compiled file: drops
  * imports, re-exports and the registry preamble (`const __components = …`,
@@ -423,16 +489,13 @@ function scopeFileContribution(code) {
  * scope, an updated component renders against missing bindings and the
  * swap fails with a ReferenceError that surfaces nowhere the tests assert
  * (no reload, stale DOM, zero page errors).
+ *
+ * Single-parse strip+demote (see `stripAndDemoteInOnePass`) — this sits on
+ * the dev-server's per-edit hot path, where the old two-pass chain cost a
+ * second full acorn parse on every file save.
  */
 export function buildHmrEvalSnippet(code) {
-    const isSnippetDrop = (node) => {
-        if (isAnyImport(node) || isComponentExport(node) || isRuntimePreamble(node))
-            return true;
-        return node.type === 'VariableDeclaration'
-            && (node.declarations?.[0]?.id?.name === '__components'
-                || node.declarations?.[0]?.id?.name === '__hydrators');
-    };
-    const body = demoteExports(removeCompiledNodes(code, isSnippetDrop)).trim();
+    const body = stripAndDemoteInOnePass(code).trim();
     if (!body)
         return '';
     const scoped = `{\n${body}\n}`;
@@ -453,7 +516,7 @@ export function buildHmrEvalSnippet(code) {
  * If the module cannot be parsed it is returned untouched (the compiler's own
  * output is always valid ESM, so that branch is unreachable in practice).
  */
-function removeCompiledNodes(code, isTarget) {
+export function removeCompiledNodes(code, isTarget) {
     let ast;
     try {
         ast = parse(code);

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;AAOjG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AAK7C,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,CA2oBvG"}
+{"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;AAK7C,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,CAoqBvG"}

package/dist/dev-server.js

@@ -440,6 +440,12 @@ export async function startDevServer(appDir, options) {
     await doBuild().catch(() => { });
     const server = createServer(async (req, res) => {
         const url = new URL(req.url || '/', `http://localhost:${port}`);
+        // SSR fetches may run while concurrent sub-requests (e.g. the page's own
+        // API fetches) have clobbered globalThis.__vesk_request with their own
+        // request context, so resolveFetchUrl cannot rely on ctx.resolveUrl alone.
+        // Set the per-request base so relative useFetch URLs resolve to this
+        // server regardless (mirrors packages/cli/src/dev-server.ts:1308).
+        globalThis.__vesk_ssr_base_url = `http://127.0.0.1:${port}`;
         // Dev panel endpoints (/__vesk/...): HMR state, plugin list, activate/
         // deactivate/install/uninstall. Routed through the pure injectable router.
         // Chain: agent router (CheckpointManager + AgentCapabilityTable + Provider
@@ -673,6 +679,8 @@ export async function startDevServer(appDir, options) {
                         const t0 = process.hrtime.bigint();
                         const tImport0 = process.hrtime.bigint();
                         const mod = await import(`${handlerPath}?t=${ssrVersion}`);
+                        const _origFetch = globalThis.fetch;
+                        globalThis.fetch = function _fetchDebug(u, init) { console.error('FETCH-DEBUG', typeof u === 'string' ? u : String(u), (new Error()).stack); return _origFetch(u, init); };
                         const tImport1 = process.hrtime.bigint();
                         const webRequest = makeWebRequest(req, url.href, maxBodyBytes);
                         const response = await mod.handle(webRequest);
@@ -690,6 +698,7 @@ export async function startDevServer(appDir, options) {
                         console.error(`[vdtime] ${url.pathname} ssrVersion=${ssrVersion} total=${Number(tHandle1 - t0) / 1e6 | 0}ms import=${Number(tImport1 - tImport0) / 1e6 | 0}ms handle=${Number(tHandle1 - tImport1) / 1e6 | 0}ms text=${Number(tText1 - tHandle1) / 1e6 | 0}ms`);
                     }
                     catch (e) {
+                        console.error('[nbsp-debug] DEV-SSR-ERROR', e instanceof Error ? (e.stack || e.message) : String(e));
                         res.writeHead(500, { 'Content-Type': 'text/html' });
                         res.end(renderSsrErrorPage(e, url.pathname));
                     }
@@ -768,56 +777,72 @@ export async function startDevServer(appDir, options) {
             }
         }
     }
-    const srcDir = resolve(appDir, '..', 'src');
-    try {
-        if (existsSync(srcDir)) {
-            watch(srcDir, { recursive: true }, (_eventType, filename) => {
-                if (!filename)
-                    return;
-                if (filename.endsWith('.css')) {
-                    doBuild();
-                }
-            });
-        }
-    }
-    catch {
-        // src/ dir not available
-    }
+    const projectDir = resolve(appDir, '..');
+    // The legacy adapter dev server watches the whole project (not just app/):
+    // every `.vsk`/`.md`, `.css`, config and `.ts`/`.js` file anywhere in the
+    // project is covered by HMR — only node_modules, build outputs and VCS
+    // internals are excluded. `handleFileChange` reboots or reloads per kind;
+    // anything else (non-API helpers, root scripts) falls through to a full
+    // rebuild + reload.
+    const adapterSkipDirs = new Set(['node_modules', '.vesk', 'tarballs', '.git']);
+    const adapterSkipMarkers = ['node_modules/', '.vesk/', 'tmp-vesk-chunk-'];
+    const adapterScriptExts = ['.mts', '.ts', '.tsx', '.mjs', '.js', '.cjs'];
+    const adapterConfigNames = new Set([
+        'vesk.config.ts', 'vesk.config.js', 'vesk.config.mjs', 'vesk.config.mts',
+        'postcss.config.js', 'postcss.config.ts', 'tailwind.config.js', 'tailwind.config.ts',
+        'tsconfig.json', 'package.json',
+    ]);
     let debounceTimer = null;
     let pendingFiles = new Set();
     try {
-        watch(appDir, { recursive: true }, (_eventType, filename) => {
+        watch(projectDir, { recursive: true }, (_eventType, filename) => {
             if (!filename)
                 return;
+            if (adapterSkipDirs.has(filename.split('/')[0]) || adapterSkipMarkers.some((m) => filename.includes(m)))
+                return;
+            const name = filename.slice(filename.lastIndexOf('/') + 1);
+            const isVsk = filename.endsWith('.vsk') || filename.endsWith('.md') || filename.endsWith('.markdown');
+            const isCss = filename.endsWith('.css');
+            const isScript = adapterScriptExts.some((ext) => filename.endsWith(ext));
+            if (!isVsk && !isCss && !isScript && !adapterConfigNames.has(name))
+                return;
+            if (isCss) {
+                doBuild();
+                return;
+            }
             if (debounceTimer)
                 clearTimeout(debounceTimer);
             pendingFiles.add(filename);
             debounceTimer = setTimeout(() => {
                 const files = [...pendingFiles];
                 pendingFiles = new Set();
-                const configFiles = files.filter(f => f === 'vesk.config.ts' || f === 'vesk.config.js' ||
-                    f === 'tsconfig.json' || f === 'package.json' ||
-                    f.endsWith('/vesk.config.ts') || f.endsWith('/vesk.config.js') ||
-                    f.endsWith('/tsconfig.json') || f.endsWith('/package.json'));
+                if (files.length === 0)
+                    return;
+                // Watch root is the project dir (projectDir = app/..) so fs.watch
+                // filenames are project-relative (e.g. `app/page.vsk`), but
+                // `handleFileChange` resolves them against `appDir` and `extractSourceDir`
+                // expects app-relative names — normalize before handing off.
+                const toAppRelative = (f) => f.startsWith('app/') ? f.slice(4) : f;
+                const configFiles = files.filter(f => adapterConfigNames.has(f.slice(f.lastIndexOf('/') + 1)));
                 const apiMiddlewareFiles = files.filter(f => (f.includes('/api/') || f === 'middleware.ts' || f.endsWith('/middleware.ts')) &&
-                    (f.endsWith('.ts') || f.endsWith('.js')));
+                    adapterScriptExts.some(ext => f.endsWith(ext)));
                 const vskFiles = files.filter(f => f.endsWith('.vsk'));
                 if (configFiles.length > 0) {
-                    hmr.handleFileChange(configFiles[0], doBuild, routeTree);
+                    hmr.handleFileChange(toAppRelative(configFiles[0]), doBuild, routeTree);
                 }
                 else if (apiMiddlewareFiles.length > 0) {
-                    hmr.handleFileChange(apiMiddlewareFiles[0], doBuild, routeTree);
+                    hmr.handleFileChange(toAppRelative(apiMiddlewareFiles[0]), doBuild, routeTree);
                 }
                 else if (vskFiles.length > 0) {
                     (async () => {
                         for (const f of vskFiles) {
-                            await hmr.handleFileChange(f, doBuild, routeTree);
+                            await hmr.handleFileChange(toAppRelative(f), doBuild, routeTree);
                         }
                         ssrVersion = Date.now();
                     })();
                 }
                 else if (files.length > 0) {
-                    hmr.handleFileChange(files[0], doBuild, routeTree);
+                    hmr.handleFileChange(toAppRelative(files[0]), doBuild, routeTree);
                 }
             }, 40);
         });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vesk/adapter",
-  "version": "0.2.28",
+  "version": "0.2.29",
   "type": "module",
   "description": "Vesk adapter — builds deployable .vesk/ output for Deno and Node serverless",
   "main": "./dist/index.js",
@@ -23,9 +23,9 @@
     "sharp": "^0.35.3"
   },
   "dependencies": {
-    "@vesk/compiler": "^0.2.28",
-    "@vesk/runtime": "^0.2.28",
-    "@vesk/types": "^0.2.28"
+    "@vesk/compiler": "^0.2.29",
+    "@vesk/runtime": "^0.2.29",
+    "@vesk/types": "^0.2.29"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",