@vesk/adapter 0.2.61 → 0.2.63

package/dist/client-bundle.d.ts

@@ -118,6 +118,15 @@ export declare function stripAndDemoteInOnePass(code: string): string;
  */
 export declare function buildHmrEvalSnippet(code: string): string;
 export declare function removeCompiledNodes(code: string, isTarget: (node: CompiledNode) => boolean): string;
+/** Name of the cross-route shared chunk. Route chunks import from it. */
+export declare const SHARED_CHUNK_NAME = "shared.js";
+/**
+ * The chunk file stem for a route: its directory under `app/`, with dynamic
+ * segment brackets neutralised. Exported so the dev server can map an incoming
+ * chunk request back to its route (see routeFullPathForChunk) without
+ * duplicating the naming rule.
+ */
+export declare function buildChunkName(appDir: string, node: RouteNode): string;
 export declare function generateClientBundle(routeTree: RouteNode[], appDir: string, componentMap?: Map<string, string>, options?: ClientBundleOptions): Promise<ClientBundleResult>;
 export declare function buildRuntimeCode(runtimeDir: string): string;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"client-bundle.d.ts","sourceRoot":"","sources":["../src/client-bundle.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,kBAAkB,EAAmF,MAAM,yBAAyB,CAAC;AAoCnL;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA4BhE;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;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA+B7D;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyBlD;AAuQD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA+B5D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASxD;AA4CD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,GAAG,MAAM,CAoBnG;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,CA0nB7B;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;AAoCD;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAI/F"}
+{"version":3,"file":"client-bundle.d.ts","sourceRoot":"","sources":["../src/client-bundle.ts"],"names":[],"mappings":"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"}

package/dist/client-bundle.js

@@ -12,6 +12,42 @@ import { resolveComponentName } from '@vesk/compiler/src/server-codegen';
 import { collectVskImportPaths, vskImportLines } from '@vesk/compiler/src/vsk-imports';
 import { inlineMdContentAttrs, guessProjectRoots } from '@vesk/compiler/src/md-inline';
 import { resolveImportPath, findTsconfigPath } from '@vesk/compiler/src/module-imports';
+import { availableParallelism } from 'node:os';
+/**
+ * Run `fn` over `items` with at most `limit` in flight, preserving input
+ * order in the result array. The first rejection propagates once the in-flight
+ * work settles, so a `--strict` chunk failure still fails the build rather than
+ * being swallowed by a sibling's success.
+ */
+async function mapWithConcurrency(items, limit, fn) {
+    const out = new Array(items.length);
+    let next = 0;
+    let firstError = null;
+    const worker = async () => {
+        for (;;) {
+            const i = next++;
+            if (i >= items.length)
+                return;
+            if (firstError !== null)
+                return;
+            try {
+                out[i] = await fn(items[i], i);
+            }
+            catch (e) {
+                if (firstError === null)
+                    firstError = e;
+                return;
+            }
+        }
+    };
+    const workers = [];
+    for (let i = 0; i < Math.min(limit, items.length); i++)
+        workers.push(worker());
+    await Promise.all(workers);
+    if (firstError !== null)
+        throw firstError;
+    return out;
+}
 const __dirname = dirname(fileURLToPath(import.meta.url));
 function fileUnchanged(filePath, cached) {
     try {
@@ -674,6 +710,20 @@ export function removeCompiledNodes(code, isTarget) {
     }
     return code;
 }
+/** Name of the cross-route shared chunk. Route chunks import from it. */
+export const SHARED_CHUNK_NAME = 'shared.js';
+/**
+ * The chunk file stem for a route: its directory under `app/`, with dynamic
+ * segment brackets neutralised. Exported so the dev server can map an incoming
+ * chunk request back to its route (see routeFullPathForChunk) without
+ * duplicating the naming rule.
+ */
+export function buildChunkName(appDir, node) {
+    const dir = relative(appDir, node.sourceDir || '');
+    const parts = dir.split(sep).filter(Boolean);
+    const slug = parts.length > 0 ? parts.join('-') : 'index';
+    return slug.replace(/[\[\]]/g, '_');
+}
 export async function generateClientBundle(routeTree, appDir, componentMap, options) {
     const runtimeDir = findRuntimeSrc(appDir);
     let seen = new Set();
@@ -682,6 +732,7 @@ export async function generateClientBundle(routeTree, appDir, componentMap, opti
     const runtimeImportNames = new Set();
     const cache = options?.cache;
     const only = options?.only && options.only.length > 0 ? new Set(options.only) : null;
+    const onlyRoutes = options?.onlyRoutes && options.onlyRoutes.length > 0 ? new Set(options.onlyRoutes) : null;
     const returnEdited = !!options?.returnEditedSources && !!only;
     const editedSources = returnEdited ? new Map() : undefined;
     const editedNames = returnEdited ? new Map() : undefined;
@@ -880,12 +931,6 @@ export async function generateClientBundle(routeTree, appDir, componentMap, opti
             });
         }
     }
-    function buildChunkName(node) {
-        const dir = relative(appDir, node.sourceDir || '');
-        const parts = dir.split(sep).filter(Boolean);
-        const slug = parts.length > 0 ? parts.join('-') : 'index';
-        return slug.replace(/[\[\]]/g, '_');
-    }
     const codeSplit = !!(options?.codeSplit);
     const transformPlugins = options?.plugins || [];
     // Every `.vsk` component in the bundle shares ONE registry keyed by declared
@@ -950,16 +995,21 @@ export async function generateClientBundle(routeTree, appDir, componentMap, opti
                     compileFile(loadingPath, node.loading, chunkCode, chunkImports);
                 }
                 if (chunkCode.length > 0) {
-                    const chunkName = `page-${buildChunkName(node)}.js`;
-                    // Prepend this chunk's deduped imports (one statement per source, no
-                    // duplicate bindings) so the classic script exposes the bare
-                    // identifiers its file bodies reference, and esbuild can parse and
-                    // inline them.
-                    if (!chunkImports.ok)
-                        console.error('[vesk] chunk import merge aborted for', chunkName + ':', chunkImports.reason);
-                    const head = chunkImports.render();
-                    const code = (head ? head + '\n\n' : '') + chunkCode.join('\n\n');
-                    chunkEntries.push({ name: chunkName, code, node, importsTable: chunkImports, imports: chunkHasImports(head.length, !chunkImports.ok) });
+                    const chunkName = `page-${buildChunkName(appDir, node)}.js`;
+                    // Route-level filter for on-demand dev builds. `only` is FILE-level:
+                    // it keeps a recompile cheap but still walks every route, so it
+                    // cannot make a COLD build lazy.
+                    if (!onlyRoutes || onlyRoutes.has(node.fullPath)) {
+                        // Prepend this chunk's deduped imports (one statement per source, no
+                        // duplicate bindings) so the classic script exposes the bare
+                        // identifiers its file bodies reference, and esbuild can parse and
+                        // inline them.
+                        if (!chunkImports.ok)
+                            console.error('[vesk] chunk import merge aborted for', chunkName + ':', chunkImports.reason);
+                        const head = chunkImports.render();
+                        const code = (head ? head + '\n\n' : '') + chunkCode.join('\n\n');
+                        chunkEntries.push({ name: chunkName, code, node, importsTable: chunkImports, imports: chunkHasImports(head.length, !chunkImports.ok) });
+                    }
                 }
                 walkSplit(node.children || [], [..._chain, node]);
             }
@@ -977,7 +1027,7 @@ export async function generateClientBundle(routeTree, appDir, componentMap, opti
                 console.error('[vesk] chunk import merge aborted for shared.js:', sharedImports.reason);
             const head = sharedImports.render();
             const code = (head ? head + '\n\n' : '') + sharedCode.join('\n\n');
-            chunkEntries.push({ name: 'shared.js', code, node: null, importsTable: sharedImports, imports: chunkHasImports(head.length, !sharedImports.ok) });
+            chunkEntries.push({ name: SHARED_CHUNK_NAME, code, node: null, importsTable: sharedImports, imports: chunkHasImports(head.length, !sharedImports.ok) });
         }
         const chunkIIFE = (body) => `(()=>{\nconst __components = globalThis.__components || (globalThis.__components = {});\nconst __hydrators = globalThis.__hydrators || (globalThis.__hydrators = {});\n${body}\n})();\n`;
         /**
@@ -1115,9 +1165,15 @@ export async function generateClientBundle(routeTree, appDir, componentMap, opti
                 },
             }
             : null;
-        for (const entry of chunkEntries) {
+        // Each chunk is bundled through its own esbuild pass. Those passes are
+        // independent, so they run CONCURRENTLY: one esbuild round-trip per chunk
+        // was the single largest slice of `vesk dev` startup (37 chunks on a
+        // 37-route app, strictly serial, with every core but one idle). Results are
+        // written back in the original order so chunk load order — which the
+        // preload/annotation passes below depend on — is unchanged.
+        const buildChunkEntry = async (entry) => {
             if (!entry.code.trim())
-                continue;
+                return null;
             let finalCode;
             if (entry.imports) {
                 // Bundle the chunk through esbuild so every remaining import (npm
@@ -1200,11 +1256,27 @@ export async function generateClientBundle(routeTree, appDir, componentMap, opti
                 // via the __components / __hydrators registries, matching the mono path).
                 finalCode = chunkIIFE(demoteExports(entry.code));
             }
-            chunks.push({ name: entry.name, code: finalCode });
+            return { name: entry.name, code: finalCode };
+        };
+        // Dev may defer route chunk BODIES (see ClientBundleOptions.skipRouteChunks).
+        // The shared chunk is still built — route chunks import from it — and
+        // `main` is assembled separately below, so the entry bundle is unaffected.
+        // Chunk URLs are published for every route regardless; see annotate().
+        const effectiveChunkEntries = options?.skipRouteChunks
+            ? chunkEntries.filter((e) => e.name === SHARED_CHUNK_NAME)
+            : chunkEntries;
+        // Concurrency is capped below the core count: esbuild's own service is
+        // already multi-process, so oversubscribing every chunk at once trades
+        // throughput for memory on the constrained machines this runs on.
+        const CHUNK_CONCURRENCY = Math.max(1, Math.min(6, (availableParallelism?.() ?? 4) - 1));
+        const built = await mapWithConcurrency(effectiveChunkEntries, CHUNK_CONCURRENCY, buildChunkEntry);
+        for (const c of built) {
+            if (c !== null)
+                chunks.push(c);
         }
         function annotate(nodes) {
             for (const node of nodes) {
-                const chunkName = `page-${buildChunkName(node)}.js`;
+                const chunkName = `page-${buildChunkName(appDir, node)}.js`;
                 // Production chunk names are content-hashed, and the ROUTER asks for
                 // chunks by the URL baked here — so the hash has to be applied to this
                 // reference, not just to the file on disk. Getting it wrong is silent
@@ -1216,6 +1288,17 @@ export async function generateClientBundle(routeTree, appDir, componentMap, opti
                     const fileName = options?.hmr ? chunkName : hashedName(chunkName, emitted.code);
                     node.chunk = `/_vesk/static/${fileName}`;
                 }
+                else if (options?.skipRouteChunks) {
+                    // The body is deferred, but the URL must still be published now.
+                    // The route tree — chunk URLs included — is baked into the ENTRY
+                    // bundle and the client router fetches `node.chunk` with no server
+                    // round-trip in between, so leaving it undefined means the chunk is
+                    // never requested and the page hydrates with nothing registered.
+                    // Dev chunk URLs are unhashed, so they depend only on the route and
+                    // are identical whether or not the body has been built — which also
+                    // keeps the entry bundle's cache key stable across lazy builds.
+                    node.chunk = `/_vesk/static/${chunkName}`;
+                }
                 annotate(node.children || []);
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vesk/adapter",
-  "version": "0.2.61",
+  "version": "0.2.63",
   "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.61",
-    "@vesk/runtime": "^0.2.61",
-    "@vesk/types": "^0.2.61"
+    "@vesk/compiler": "^0.2.63",
+    "@vesk/runtime": "^0.2.63",
+    "@vesk/types": "^0.2.63"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",