@vesk/adapter 0.2.45 → 0.2.47

package/dist/client-bundle.d.ts

@@ -117,13 +117,6 @@ export declare function stripAndDemoteInOnePass(code: string): string;
  * 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;

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

@@ -1 +1 @@
-{"version":3,"file":"client-bundle.d.ts","sourceRoot":"","sources":["../src/client-bundle.ts"],"names":[],"mappings":"AAaA,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;;;;;;;;;;;GAWG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA+B7D;AAED;;;;;;;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,CA+b7B;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":"AAaA,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;AA4MD;;;;;;;;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,CAoc7B;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"}

package/dist/client-bundle.js

@@ -4,7 +4,7 @@ import { fileURLToPath } from 'node:url';
 import { tmpdir } from 'node:os';
 import { build } from './esbuild-fallback.js';
 import { stripCodeTypes } from '@vesk/compiler/src/strip-ts';
-import { parse } from '@vesk/compiler/src/parser';
+import { parse, parseGeneratedJs } from '@vesk/compiler/src/parser';
 import { compileClient, compileClientBoth, nameAllocFor, vskComponentNames } from '@vesk/compiler/src/client-codegen';
 import { VskComponentOwners } from '@vesk/compiler/src/vsk-collision';
 import { resolveComponentName } from '@vesk/compiler/src/server-codegen';
@@ -59,13 +59,11 @@ function findRuntimeSrc(appDir) {
  */
 export function extractRuntimeImportNames(code) {
     const names = [];
-    let ast;
-    try {
-        ast = parse(code);
-    }
-    catch {
+    // Shares the parse with the strip passes (same generated string, read-only
+    // AST) — see parseForStrip.
+    const ast = parseForStrip(code);
+    if (!ast)
         return names;
-    }
     const body = ast.body ?? [];
     for (const raw of body) {
         const node = raw;
@@ -482,13 +480,9 @@ function scopeFileContribution(code) {
  * hot path used to run on every edit.
  */
 export function stripAndDemoteInOnePass(code) {
-    let ast;
-    try {
-        ast = parse(code);
-    }
-    catch {
+    const ast = parseForStrip(code);
+    if (!ast)
         return code;
-    }
     const body = ast.body ?? [];
     const edits = [];
     for (const raw of body) {
@@ -548,14 +542,10 @@ export function buildHmrEvalSnippet(code) {
         return '';
     const scoped = `{\n${body}\n}`;
     // Never trade a potential duplicate-binding error for a certain syntax
-    // error: if the scoped form does not parse, keep the unscoped body.
-    try {
-        parse(scoped);
-        return scoped;
-    }
-    catch {
-        return body;
-    }
+    // error: if the scoped form does not parse, keep the unscoped body. The body
+    // is generated JS, so plain acorn is the right tool (parseGeneratedJs) and
+    // it must not go through the cache: this string is unique per call.
+    return parseGeneratedJs(scoped) !== null ? scoped : body;
 }
 /**
  * Removes matched top-level statements from a compiled client module using the
@@ -564,14 +554,46 @@ 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).
  */
-export function removeCompiledNodes(code, isTarget) {
-    let ast;
-    try {
-        ast = parse(code);
+/**
+ * Parsed-AST cache for the strip passes over GENERATED code.
+ *
+ * Every compiled file goes through several `removeCompiledNodes` passes with
+ * different predicates (`isVskImport`, `isRuntimeImport`, `isComponentExport`,
+ * ...) and each one used to re-parse the same string with the full `.vsk`
+ * pipeline. On a CPU profile of a 28-route build, parsing was ~70% of the
+ * whole build and the generated-code strips were the bulk of it. The ASTs are
+ * only read here (node.start/end plus the caller's predicate), so one parse can
+ * serve every pass over the same string.
+ *
+ * Bounded: cleared wholesale past the cap, because a watch session keeps
+ * calling this with new strings forever.
+ */
+const stripAstCache = new Map();
+const STRIP_AST_CACHE_MAX = 512;
+function parseForStrip(code) {
+    const hit = stripAstCache.get(code);
+    if (hit !== undefined)
+        return hit;
+    // Plain acorn for generated JS (see parseGeneratedJs); the `.vsk` pipeline
+    // only for the rare module it cannot read.
+    let ast = parseGeneratedJs(code);
+    if (!ast) {
+        try {
+            ast = parse(code);
+        }
+        catch {
+            ast = null;
+        }
     }
-    catch {
+    if (stripAstCache.size >= STRIP_AST_CACHE_MAX)
+        stripAstCache.clear();
+    stripAstCache.set(code, ast);
+    return ast;
+}
+export function removeCompiledNodes(code, isTarget) {
+    const ast = parseForStrip(code);
+    if (!ast)
         return code;
-    }
     const ranges = [];
     for (const raw of ast.body ?? []) {
         const node = raw;
@@ -597,6 +619,7 @@ export function removeCompiledNodes(code, isTarget) {
 export async function generateClientBundle(routeTree, appDir, componentMap, options) {
     const runtimeDir = findRuntimeSrc(appDir);
     let seen = new Set();
+    const __stats = { chunks: 0, compiled: 0, distinct: new Set(), parseMs: 0 };
     const chunks = [];
     const runtimeImportNames = new Set();
     const cache = options?.cache;
@@ -720,6 +743,8 @@ export async function generateClientBundle(routeTree, appDir, componentMap, opti
             return;
         }
         compiledFiles++;
+        __stats.compiled++;
+        __stats.distinct.add(filePath);
         let src = readFileSync(filePath, 'utf-8');
         if (/content=["'][^"']*\.md["']/i.test(src)) {
             src = inlineMdContentAttrs(src, dirname(filePath), guessProjectRoots(appDir));
@@ -729,7 +754,9 @@ export async function generateClientBundle(routeTree, appDir, componentMap, opti
         // One parse/IR pass feeds both client modes AND the component-name
         // lookup — the dev hot path pays the acorn+TS parse once per edit
         // instead of three times.
+        const __p0 = performance.now();
         const { comp: rawComp, hyd: rawHyd, name: actualName, aliases, reexportPaths, componentNames } = compileClientBoth(src, null, filePath);
+        __stats.parseMs += performance.now() - __p0;
         for (const cn of componentNames || [])
             componentOwners.claim(cn, filePath);
         // Cache keeps the import-carrying codes so a warm build can re-fold them
@@ -978,6 +1005,8 @@ export async function generateClientBundle(routeTree, appDir, componentMap, opti
             transformedChunks.push({ ...chunk, code: await applyTransformPlugins(chunk.code, chunk.name) });
         }
         componentOwners.report('client bundle');
+        if (process.env.VESK_BUILD_PROFILE)
+            console.error(`  [client] chunks=${chunks.length} compiled=${__stats.compiled} distinct=${__stats.distinct.size} parseMs=${__stats.parseMs.toFixed(0)}`);
         return { main: await applyTransformPlugins(main, 'client.js'), chunks: transformedChunks, cachedFileHits, compiledFiles, mainFromCache, editedSources, editedNames };
     }
     else {

package/dist/image-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-pipeline.d.ts","sourceRoot":"","sources":["../src/image-pipeline.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAsGrE,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAgD3F"}
+{"version":3,"file":"image-pipeline.d.ts","sourceRoot":"","sources":["../src/image-pipeline.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAyKrE,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAwD3F"}

package/dist/image-pipeline.js

@@ -1,29 +1,100 @@
 import { mkdirSync, writeFileSync, readFileSync, existsSync, readdirSync, statSync } from 'node:fs';
 import { spawnSync } from 'node:child_process';
-import { resolve, extname, dirname } from 'node:path';
+import { resolve, extname, dirname, join } from 'node:path';
+import { createRequire } from 'node:module';
+import { tmpdir } from 'node:os';
 const SUPPORTED = new Set(['.jpg', '.jpeg', '.png', '.webp', '.avif', '.tiff']);
 const OUTPUT_WIDTHS = [640, 768, 1024, 1280, 1536];
 const FORMATS = ['webp', 'avif'];
 let sharpFn = null;
-try {
-    // Probe in a child before importing sharp in this process. On older CPUs,
-    // importing the native module itself can terminate Node with SIGILL; an
-    // in-process try/catch cannot catch that signal.
-    const probe = spawnSync(process.execPath, [
-        '--input-type=module',
-        '-e',
-        "import sharp from 'sharp'; await sharp({ create: { width: 2, height: 2, channels: 3, background: 'red' } }).png().toBuffer();",
-    ], { stdio: 'ignore' });
-    if (probe.status === 0) {
-        const mod = await import('sharp');
-        sharpFn = mod.default;
+let sharpProbed = false;
+/**
+ * Remember a failed probe on disk.
+ *
+ * The probe's answer is a property of the MACHINE (CPU instruction set, the
+ * installed sharp binary) and not of the project, but it costs a child process
+ * that dies with SIGILL — and the kernel writes a core dump on the way out, so
+ * the "no" case is the expensive one: measured at 25-100s per build on a
+ * loaded 2-core box. Without this, every build of an app that has images pays
+ * it again. The key folds in the resolved sharp entry's mtime, so installing or
+ * upgrading sharp invalidates the memo and the next build probes for real.
+ */
+function probeMemoPath() {
+    try {
+        const req = createRequire(import.meta.url);
+        // `sharp/package.json` is NOT an exported subpath (sharp's exports map
+        // rejects it with ERR_PACKAGE_PATH_NOT_EXPORTED), so key on the resolved
+        // ENTRY file: its mtime changes on install/upgrade, which is exactly when
+        // the answer has to be re-measured.
+        const entry = req.resolve('sharp');
+        const stamp = Math.round(statSync(entry).mtimeMs);
+        return join(tmpdir(), `vesk-sharp-probe-${process.platform}-${process.arch}-${stamp}.json`);
     }
-    else {
-        console.warn('vesk images: sharp native probe failed; using copy-only image pipeline');
+    catch {
+        // sharp not installed: the answer is "unavailable" and cannot change
+        // without an install.
+        return null;
+    }
+}
+function readProbeMemo() {
+    const path = probeMemoPath();
+    if (path === null)
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'))?.usable === true;
+    }
+    catch {
+        return null;
+    }
+}
+function writeProbeMemo(usable) {
+    const path = probeMemoPath();
+    if (path === null)
+        return;
+    try {
+        writeFileSync(path, JSON.stringify({ usable, at: Date.now() }), 'utf-8');
     }
+    catch { /* a read-only tmpdir just means we probe again next build */ }
 }
-catch {
-    // sharp not available — fall through to copy-only
+/**
+ * Load sharp, or decide we cannot. LAZY on purpose: the probe spawns a child
+ * Node that imports the native module, and on a CPU without the instructions
+ * sharp's binary needs that child dies with SIGILL after tens of seconds. Doing
+ * it at module scope charged every build — including builds of apps with no
+ * `<Image>` at all — for a capability the build may never use. Callers reach
+ * this only after finding image refs, and the answer is memoized per machine.
+ */
+async function ensureSharp() {
+    if (sharpProbed)
+        return;
+    sharpProbed = true;
+    const memo = readProbeMemo();
+    if (memo === false) {
+        console.warn('vesk images: sharp unusable on this machine (cached); using copy-only image pipeline');
+        return;
+    }
+    try {
+        // Probe in a child before importing sharp in this process. On older CPUs,
+        // importing the native module itself can terminate Node with SIGILL; an
+        // in-process try/catch cannot catch that signal.
+        const probe = spawnSync(process.execPath, [
+            '--input-type=module',
+            '-e',
+            "import sharp from 'sharp'; await sharp({ create: { width: 2, height: 2, channels: 3, background: 'red' } }).png().toBuffer();",
+        ], { stdio: 'ignore' });
+        if (probe.status === 0) {
+            const mod = await import('sharp');
+            sharpFn = mod.default;
+            writeProbeMemo(true);
+        }
+        else {
+            console.warn('vesk images: sharp native probe failed; using copy-only image pipeline');
+            writeProbeMemo(false);
+        }
+    }
+    catch {
+        // sharp not available — fall through to copy-only
+    }
 }
 async function processImage(srcPath, outDir, baseName) {
     const image = sharpFn ? sharpFn(srcPath) : null;
@@ -95,13 +166,20 @@ export async function optimizeImages(appDir, outDir) {
         console.error('vesk images: no <Image> refs found');
         return [];
     }
+    await ensureSharp();
     const results = [];
     for (const ref of refs) {
+        // `src` is site-root-relative in every documented form (`<Image
+        // src="/hero.png" />`), and `path.resolve` treats a leading-slash argument
+        // as an ABSOLUTE path — so `resolve(appDir, '/hero.png')` asks the filesystem
+        // for `/hero.png` and every image reference in the app is reported missing.
+        // Strip the leading slash for every candidate base.
+        const rel = ref.src.replace(/^\//, '');
         const possiblePaths = [
-            resolve(appDir, ref.src),
-            resolve(appDir, '..', 'public', ref.src.replace(/^\//, '')),
-            resolve(appDir, '..', 'src', ref.src.replace(/^\//, '')),
-            resolve(outDir, 'static', 'public', ref.src.replace(/^\//, '')),
+            resolve(appDir, rel),
+            resolve(appDir, '..', 'public', rel),
+            resolve(appDir, '..', 'src', rel),
+            resolve(outDir, 'static', 'public', rel),
         ];
         let srcPath = null;
         for (const p of possiblePaths) {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"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,CA8TpG;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;AAkDD,wBAAsB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA6UpG;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"}

package/dist/index.js

@@ -84,7 +84,32 @@ async function collectPluginHeadExtra(pluginsPipelines) {
     }
     return parts.join('\n');
 }
+/**
+ * `VESK_BUILD_PROFILE=1 vesk build` prints a per-phase millisecond breakdown.
+ *
+ * Builds are parse-bound and used to be hard to reason about: a 28-route app
+ * spent its time in a sharp capability probe, in per-route recompiles of the
+ * same shared files, and in re-parsing generated JS through the `.vsk` parser,
+ * and none of that is visible in the phase log lines. This makes it visible.
+ */
+const profileEnabled = () => process.env.VESK_BUILD_PROFILE === '1';
+let phaseMarks = [];
+let phaseStarted = 0;
+let buildStarted = 0;
+function markPhase(name) {
+    if (!profileEnabled())
+        return;
+    const now = performance.now();
+    if (phaseStarted > 0)
+        phaseMarks.push([name, now - phaseStarted]);
+    phaseStarted = now;
+}
 export async function build(appDir, options) {
+    if (profileEnabled()) {
+        buildStarted = Date.now();
+        phaseMarks = [];
+        phaseStarted = performance.now();
+    }
     appDir = resolve(appDir);
     const outDir = resolve(options?.outDir || resolve(appDir, '..', '.vesk'));
     const publicDir = options?.publicDir || resolve(appDir, '..', 'public');
@@ -150,6 +175,7 @@ export async function build(appDir, options) {
     ];
     for (const d of dirs)
         mkdirSync(d, { recursive: true });
+    markPhase('config+dirs');
     const cssSourcePath = resolveUserCssPath(appDir);
     if (cssSourcePath !== null) {
         const cssContent = readFileSync(cssSourcePath, 'utf-8');
@@ -174,6 +200,7 @@ export async function build(appDir, options) {
             console.error(`vesk build: css  → static/global.css  (${finalCss.length} bytes, tailwind plugin inactive)`);
         }
     }
+    markPhase('css/tailwind');
     const { scanRoutes, scanComponents } = await resolveCompilerApi('router.js');
     const { scanApiRoutes } = await resolveCompilerApi('api-routes.js');
     const { collectMiddlewareChain } = await resolveCompilerApi('middleware.js');
@@ -191,6 +218,7 @@ export async function build(appDir, options) {
     const apiDir = resolve(appDir, 'api');
     const apiTree = existsSync(apiDir) ? scanApiRoutes(apiDir) : [];
     console.error(`vesk build: ${routeTree.length} root routes, ${apiTree.length} API routes`);
+    markPhase('scan routes');
     console.error('vesk build: bundling server runtime...');
     await bundleRuntime(appDir, outDir);
     const ssrRoutes = [];
@@ -247,6 +275,7 @@ export async function build(appDir, options) {
         }
     }
     walk(routeTree);
+    markPhase('server runtime + ssr functions');
     const apiRoutes = [];
     function walkApi(nodes) {
         for (const node of nodes) {
@@ -273,6 +302,7 @@ export async function build(appDir, options) {
     const hasEvents = await compileEvents(appDir, outDir);
     if (hasEvents)
         console.error('vesk build: evt  → server/events.js (onStart/onRequest/onStop)');
+    markPhase('api functions');
     console.error('vesk build: bundling client runtime...');
     const bundleOpts = {};
     if (options?.codeSplit)
@@ -295,6 +325,7 @@ export async function build(appDir, options) {
         }
     }
     copyStaticAssets(publicDir, outDir);
+    markPhase('client runtime + chunks');
     console.error('vesk build: static → static/public/');
     let prerenderedRoutes = [];
     if (options?.ssg) {
@@ -316,10 +347,6 @@ export async function build(appDir, options) {
             throw new Error(`SEO audit failed with ${audit.errors} error(s) — fix them before deploying`);
         }
     }
-    {
-        const { optimizeImages } = await import('./image-pipeline.js');
-        await optimizeImages(appDir, outDir);
-    }
     {
         const { generateSitemap, generateRobotsTxt } = await import('./static.js');
         const publicDirResolved = resolve(outDir, 'static', 'public');
@@ -337,6 +364,7 @@ export async function build(appDir, options) {
             console.error(`vesk build: seo   → static/public/robots.txt (${robots.length} bytes)`);
         }
     }
+    markPhase('ssg+images+seo');
     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');
@@ -369,6 +397,14 @@ export async function build(appDir, options) {
             await plugin.onBuildEnd();
         }
     }
+    markPhase('manifest+platform');
+    markPhase('tail');
+    if (profileEnabled()) {
+        for (const [name, ms] of phaseMarks) {
+            console.error(`  phase ${name.padEnd(30)} ${ms.toFixed(0).padStart(6)}ms`);
+        }
+        console.error(`  TOTAL ${(Date.now() - buildStarted).toFixed(0)}ms`);
+    }
     console.error(`\nvesk build: done (${outDir})`);
     return { routeTree, apiTree, ssrRoutes, apiRoutes, manifest };
 }

package/package.json

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