@vesk/compiler 0.2.22 → 0.2.23

package/dist/precompile-runtime.d.ts

@@ -0,0 +1,46 @@
+import type { CompileFileResult } from '@vesk/compiler/src/types';
+import type { BundledModuleData, ModuleBindingData } from '@vesk/compiler/src/module-imports';
+export interface PrecompiledComponentEntry {
+    name: string;
+    /** Compiled component body source (`buildComponentMap`-style function code). */
+    source: string;
+    isAsync: boolean;
+}
+export type PrecompileBundledModule = BundledModuleData;
+export type PrecompileBinding = ModuleBindingData;
+export interface PrecompileSubFilePlan {
+    importPath: string;
+    plan: PrecompileFilePlan;
+}
+export interface PrecompileFilePlan {
+    /** Class-tagged JSON of this file's IRRoot. `null` on non-rendered sub files. */
+    ir: unknown | null;
+    /** The file's own import lines (for `loadRuntimeImports`). */
+    runtimeImports: string[];
+    /** This file's own compiled components. */
+    components: PrecompiledComponentEntry[];
+    /** The module bundle backing this file's local value imports. */
+    modules: PrecompileBundledModule[];
+    /** local name -> bundled module export. */
+    bindings: PrecompileBinding[];
+    /** Top-level statements, already `defineAction`-transformed for `server`. */
+    topLevelCode: string[];
+    /** The file's `.vsk` imports, precompiled recursively. */
+    subFiles: PrecompileSubFilePlan[];
+}
+/**
+ * Recursively JSON-serializes an IR root. IR class instances are tagged with
+ * their class name so `irFromJSON` can revive them with their prototypes;
+ * `Set` values (IRRoot.importedNames) are tagged too. ESTree node subtrees
+ * (Expression.ast / RuntimeStatement.ast) are plain objects and serialize
+ * generically — `start`/`end` and `loc` arrays are plain JSON.
+ */
+export declare function irToJSON(value: unknown): unknown;
+export declare function irFromJSON(value: unknown): unknown;
+/**
+ * Rebuilds a `CompileFileResult` (ir + componentMap + __vesk) from a
+ * `precompile.ts` plan at SSR function load time. No source, no disk, no
+ * syntax analysis — the plan is fully compiled at build time.
+ */
+export declare function hydratePrecompile(plan: PrecompileFilePlan): CompileFileResult;
+//# sourceMappingURL=precompile-runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"precompile-runtime.d.ts","sourceRoot":"","sources":["../src/precompile-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAyBlE,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAe9F,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AAExD,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,iFAAiF;IACjF,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IACnB,8DAA8D;IAC9D,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,2CAA2C;IAC3C,UAAU,EAAE,yBAAyB,EAAE,CAAC;IACxC,iEAAiE;IACjE,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,2CAA2C;IAC3C,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,6EAA6E;IAC7E,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,EAAE,qBAAqB,EAAE,CAAC;CACnC;AAqCD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAiBhD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA0BlD;AA4GD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,CAE7E"}

package/dist/precompile-runtime.js

@@ -0,0 +1,211 @@
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { Expression, IRRoot, ComponentIR, StaticNode, TextNode, DynamicBinding, OpaqueDynamicRegion, MapRegion, ComponentRef, ComponentCall, SlotNode, WhileLoop, SwitchCase, SwitchBlock, TryCatch, TrackDecl, RuntimeStatement, ForLoop, ServerBlock, ClientBlock, HeadBlock, } from '@vesk/compiler/src/ir';
+import { loadRuntimeImports, evalTopLevelCode } from '@vesk/compiler/src/server-utils';
+// ---------------------------------------------------------------------------
+// IR serialization.
+// ---------------------------------------------------------------------------
+const IR_CLASSES = [
+    ['Expression', Expression.prototype],
+    ['IRRoot', IRRoot.prototype],
+    ['ComponentIR', ComponentIR.prototype],
+    ['StaticNode', StaticNode.prototype],
+    ['TextNode', TextNode.prototype],
+    ['DynamicBinding', DynamicBinding.prototype],
+    ['OpaqueDynamicRegion', OpaqueDynamicRegion.prototype],
+    ['MapRegion', MapRegion.prototype],
+    ['ComponentRef', ComponentRef.prototype],
+    ['ComponentCall', ComponentCall.prototype],
+    ['SlotNode', SlotNode.prototype],
+    ['WhileLoop', WhileLoop.prototype],
+    ['SwitchCase', SwitchCase.prototype],
+    ['SwitchBlock', SwitchBlock.prototype],
+    ['TryCatch', TryCatch.prototype],
+    ['TrackDecl', TrackDecl.prototype],
+    ['RuntimeStatement', RuntimeStatement.prototype],
+    ['ForLoop', ForLoop.prototype],
+    ['ServerBlock', ServerBlock.prototype],
+    ['ClientBlock', ClientBlock.prototype],
+    ['HeadBlock', HeadBlock.prototype],
+];
+const CLASS_PROTOS = new Map(IR_CLASSES);
+const CLASS_BY_CTOR = new Map();
+for (const [name, proto] of IR_CLASSES) {
+    const ctor = proto.constructor;
+    if (ctor)
+        CLASS_BY_CTOR.set(ctor, name);
+}
+/**
+ * Recursively JSON-serializes an IR root. IR class instances are tagged with
+ * their class name so `irFromJSON` can revive them with their prototypes;
+ * `Set` values (IRRoot.importedNames) are tagged too. ESTree node subtrees
+ * (Expression.ast / RuntimeStatement.ast) are plain objects and serialize
+ * generically — `start`/`end` and `loc` arrays are plain JSON.
+ */
+export function irToJSON(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value)) {
+        const out = [];
+        for (const item of value)
+            out.push(irToJSON(item));
+        return out;
+    }
+    if (value instanceof Set) {
+        return { __vskIrType: 'set', items: irToJSON([...value]) };
+    }
+    const clsName = CLASS_BY_CTOR.get(value.constructor);
+    const data = {};
+    for (const key of Object.keys(value)) {
+        data[key] = irToJSON(value[key]);
+    }
+    if (clsName)
+        return { __vskIrType: 'class', name: clsName, data };
+    return data;
+}
+export function irFromJSON(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value)) {
+        const out = [];
+        for (const item of value)
+            out.push(irFromJSON(item));
+        return out;
+    }
+    const asRecord = value;
+    if (typeof asRecord.__vskIrType === 'string') {
+        if (asRecord.__vskIrType === 'set') {
+            const items = irFromJSON(asRecord.items);
+            return new Set(items);
+        }
+        if (asRecord.__vskIrType === 'class') {
+            const proto = CLASS_PROTOS.get(asRecord.name);
+            const revived = proto ? Object.create(proto) : {};
+            const data = irFromJSON(asRecord.data);
+            for (const key of Object.keys(data))
+                revived[key] = data[key];
+            return revived;
+        }
+    }
+    const out = {};
+    for (const key of Object.keys(asRecord)) {
+        out[key] = irFromJSON(asRecord[key]);
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Hydration.
+// ---------------------------------------------------------------------------
+function hydrateModuleScope(scope, plan) {
+    if (!plan.modules || plan.modules.length === 0)
+        return;
+    const byKey = new Map();
+    for (const m of plan.modules)
+        byKey.set(m.key, m);
+    const exportsByKey = new Map();
+    const evaluateModule = (key) => {
+        const existing = exportsByKey.get(key);
+        if (existing)
+            return existing;
+        const mod = byKey.get(key);
+        if (!mod)
+            return null;
+        const exportsObj = {};
+        exportsByKey.set(key, exportsObj);
+        const moduleObj = { exports: exportsObj };
+        const requireShim = (spec) => {
+            const depKey = mod.deps[spec];
+            if (depKey)
+                return evaluateModule(depKey) || {};
+            // Bare specifier, builtin, or node_modules dependency — hand it to the
+            // real loader (node_modules ships with the serverless deployment).
+            try {
+                const local = createRequire(join(mod.dir, '__vesk__.js'));
+                return local(spec);
+            }
+            catch (err) {
+                throw new Error(`Cannot resolve '${spec}' required by ${mod.key} during SSR hydrate: ${err?.message}`);
+            }
+        };
+        try {
+            const body = mod.code ? `'use strict';\n${mod.code}` : "'use strict';";
+            const fn = new Function('require', 'module', 'exports', '__dirname', '__filename', body);
+            fn(requireShim, moduleObj, moduleObj.exports, mod.dir, join(mod.dir, '__vesk__.js'));
+        }
+        catch (err) {
+            exportsByKey.delete(key);
+            console.warn(`[vesk] SSR: failed to evaluate bundled module ${mod.key} (${mod.dir}): ` +
+                `${err?.message ?? String(err)}`);
+            return null;
+        }
+        const finalized = moduleObj.exports && moduleObj.exports !== exportsObj
+            ? moduleObj.exports
+            : exportsObj;
+        exportsByKey.set(key, finalized);
+        return finalized;
+    };
+    // Evaluate every bundled module so side-effect imports (`import './x'`)
+    // run even when no binding references them. Cycles resolve through the
+    // pre-seeded partial exports objects. Dependencies pull themselves in via
+    // the require shim, so order across the array does not matter.
+    for (const m of plan.modules) {
+        if (!exportsByKey.has(m.key))
+            evaluateModule(m.key);
+    }
+    for (const binding of plan.bindings) {
+        const mod = exportsByKey.get(binding.key);
+        if (!mod)
+            continue;
+        if (binding.kind === '*') {
+            scope[binding.local] = mod;
+        }
+        else if (binding.kind === 'default') {
+            scope[binding.local] = binding.kind in mod ? mod[binding.kind] : mod;
+        }
+        else if (binding.kind in mod) {
+            scope[binding.local] = mod[binding.kind];
+        }
+    }
+}
+function hydrateFile(plan, seen) {
+    const ir = plan.ir ? irFromJSON(plan.ir) : new IRRoot([], [], new Set(), null, null, []);
+    const __vesk = loadRuntimeImports(plan.runtimeImports || []);
+    hydrateModuleScope(__vesk, plan);
+    evalTopLevelCode(plan.topLevelCode || [], __vesk);
+    const componentMap = new Map();
+    for (const entry of plan.components || []) {
+        let fn;
+        if (entry.isAsync) {
+            fn = new Function('props', '__registry', '__vesk', `return (async () => {\n${entry.source}\n})()`);
+        }
+        else {
+            fn = new Function('props', '__registry', '__vesk', entry.source);
+        }
+        fn.__veskScope = __vesk;
+        componentMap.set(entry.name, fn);
+    }
+    for (const sub of plan.subFiles || []) {
+        if (seen.has(sub.importPath))
+            continue;
+        seen.add(sub.importPath);
+        const subResult = hydrateFile(sub.plan, seen);
+        for (const [name, fn] of subResult.componentMap) {
+            if (!componentMap.has(name))
+                componentMap.set(name, fn);
+        }
+        for (const key of Object.keys(subResult.__vesk)) {
+            if (key in __vesk)
+                continue;
+            __vesk[key] = subResult.__vesk[key];
+        }
+    }
+    return { ir, componentMap, __vesk };
+}
+/**
+ * Rebuilds a `CompileFileResult` (ir + componentMap + __vesk) from a
+ * `precompile.ts` plan at SSR function load time. No source, no disk, no
+ * syntax analysis — the plan is fully compiled at build time.
+ */
+export function hydratePrecompile(plan) {
+    return hydrateFile(plan, new Set());
+}

package/dist/precompile.d.ts

@@ -0,0 +1,13 @@
+import type { PrecompileFilePlan } from '@vesk/compiler/src/precompile-runtime';
+/**
+ * Precompiles one `.vsk` file into a `PrecompileFilePlan` at BUILD time.
+ *
+ * This is the AOT counterpart of `compileFileInternal`: it fully compiles the
+ * file — component function sources, top-level statements (`defineAction`
+ * ids baked in), module bundle (closures preserved by bundling, not source
+ * paths), full IR — so a serverless function can rebuild the exact
+ * `CompileFileResult` at load time with `hydratePrecompile`, with no disk
+ * access and no `.vsk` source embedded in the deployment.
+ */
+export declare function precompileFile(source: string, sourcePath?: string): PrecompileFilePlan;
+//# sourceMappingURL=precompile.d.ts.map

package/dist/precompile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precompile.d.ts","sourceRoot":"","sources":["../src/precompile.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,kBAAkB,EAGnB,MAAM,uCAAuC,CAAC;AAG/C;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAEtF"}

package/dist/precompile.js

@@ -0,0 +1,76 @@
+import { readFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { parse } from '@vesk/compiler/src/parser';
+import { generateIR } from '@vesk/compiler/src/ir-generator';
+import { setVskHydrate } from '@vesk/compiler/src/server-utils';
+import { buildComponentEntries } from '@vesk/compiler/src/server-jsgen';
+import { transformTopLevelForActions } from '@vesk/compiler/src/actions';
+import { collectVskImportPaths } from '@vesk/compiler/src/vsk-imports';
+import { inlineMdImportsFrom, guessProjectRoots } from '@vesk/compiler/src/md-inline';
+import { collectModuleBundle, } from '@vesk/compiler/src/module-imports';
+import { irToJSON } from '@vesk/compiler/src/precompile-runtime';
+/**
+ * Precompiles one `.vsk` file into a `PrecompileFilePlan` at BUILD time.
+ *
+ * This is the AOT counterpart of `compileFileInternal`: it fully compiles the
+ * file — component function sources, top-level statements (`defineAction`
+ * ids baked in), module bundle (closures preserved by bundling, not source
+ * paths), full IR — so a serverless function can rebuild the exact
+ * `CompileFileResult` at load time with `hydratePrecompile`, with no disk
+ * access and no `.vsk` source embedded in the deployment.
+ */
+export function precompileFile(source, sourcePath) {
+    return precompileFileInternal(source, sourcePath, new Set());
+}
+function precompileFileInternal(source, sourcePath, seenImportFiles) {
+    if (sourcePath) {
+        const dir = dirname(sourcePath);
+        source = inlineMdImportsFrom(source, sourcePath, guessProjectRoots(dir));
+    }
+    const ast = parse(source, sourcePath ? { filename: sourcePath } : {});
+    const ir = generateIR(ast, source, sourcePath);
+    // `buildComponentEntries` consults `__vskHydrate` while generating the
+    // server component bodies; today's request-time `compileFile` ran under
+    // `setVskHydrate(true)`, so the build-time compile must match.
+    setVskHydrate(true);
+    let components = [];
+    try {
+        components = buildComponentEntries(ir).map((e) => ({
+            name: e.name,
+            source: e.source,
+            isAsync: e.isAsync,
+        }));
+    }
+    finally {
+        setVskHydrate(false);
+    }
+    const topLevelCode = transformTopLevelForActions(ir.topLevelCode, 'server');
+    const runtimeImports = ir.imports.slice();
+    const collector = { keysByAbs: new Map(), modules: [] };
+    const bindings = sourcePath !== undefined ? collectModuleBundle(ir.imports, dirname(sourcePath), collector) : [];
+    const subFiles = [];
+    if (sourcePath !== undefined) {
+        for (const importPath of collectVskImportPaths(ir.imports, sourcePath)) {
+            if (seenImportFiles.has(importPath))
+                continue;
+            seenImportFiles.add(importPath);
+            try {
+                const importedSrc = readFileSync(importPath, 'utf-8');
+                const subPlan = precompileFileInternal(importedSrc, importPath, seenImportFiles);
+                subFiles.push({ importPath, plan: subPlan });
+            }
+            catch {
+                // skip unresolvable imports — identical to compileFileInternal
+            }
+        }
+    }
+    return {
+        ir: irToJSON(ir),
+        runtimeImports,
+        components,
+        modules: collector.modules,
+        bindings,
+        topLevelCode,
+        subFiles,
+    };
+}

package/dist/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAM1D,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;GAMG;AACH,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAajD;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqB3F;AAkDD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUnE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,SAAS,EAAE,CAKjF;AAMD,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA2BzE;AA2HD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBrE;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAkCnG;AAoBD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAiFhF"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAM1D,MAAM,WAAW,WAAW;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;GAMG;AACH,4DAA4D;AAC5D,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAajD;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqB3F;AAkDD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUnE;AAwED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,SAAS,EAAE,CAKjF;AAMD,wBAAgB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA2BzE;AA6HD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBrE;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAoCnG;AAoBD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAmGhF"}

package/dist/router.js

@@ -126,6 +126,85 @@ export function extractMiddleware(sourcePath) {
         return null;
     }
 }
+function isStandaloneLayoutFile(layoutPath) {
+    try {
+        if (!existsSync(layoutPath))
+            return false;
+        const src = readFileSync(layoutPath, 'utf-8');
+        // Fast path: if the word "standalone" doesn't appear, it's not standalone
+        if (!src.includes('standalone'))
+            return false;
+        try {
+            const ast = parse(src, { filename: 'layout.vsk' });
+            for (const stmt of ast.body) {
+                // export const standalone = true  /  export let standalone = true
+                if (stmt.type === 'ExportNamedDeclaration' && stmt.declaration?.type === 'VariableDeclaration') {
+                    for (const decl of stmt.declaration.declarations) {
+                        if (decl.id?.name === 'standalone' && decl.init?.type === 'Literal' && decl.init.value === true) {
+                            return true;
+                        }
+                        if (decl.id?.name === 'standalone' && decl.init?.type === 'Identifier' && decl.init.name === 'true') {
+                            return true;
+                        }
+                    }
+                }
+                // component Layout(props: { standalone: boolean })  or  { standalone: true }
+                const comp = stmt.type === 'ComponentDeclaration' ? stmt
+                    : stmt.type === 'ExportNamedDeclaration' && stmt.declaration?.type === 'ComponentDeclaration' ? stmt.declaration
+                        : null;
+                if (comp && comp.params && comp.params.length > 0) {
+                    const firstParam = comp.params[0];
+                    // firstParam may have typeAnnotation: TSTypeAnnotation -> TSTypeLiteral with members
+                    const typeNode = firstParam.typeAnnotation?.typeAnnotation || firstParam.typeAnnotation;
+                    if (typeNode && typeNode.type === 'TSTypeLiteral' && Array.isArray(typeNode.members)) {
+                        for (const mem of typeNode.members) {
+                            if (mem.key?.name === 'standalone')
+                                return true;
+                        }
+                    }
+                    // Fallback: check raw param text for "standalone" if AST doesn't have it (e.g. no type)
+                    if (firstParam.typeAnnotation && String(src.slice(firstParam.start, firstParam.end)).includes('standalone')) {
+                        return true;
+                    }
+                }
+            }
+        }
+        catch {
+            // Fallback to raw text check if parse fails
+            if (src.includes('standalone') && src.includes('true'))
+                return true;
+        }
+        // Final fallback: check for export standalone pattern in raw text
+        if (src.includes('export') && src.includes('standalone') && src.includes('true')) {
+            // Use token scan to avoid false positives from comments
+            const tokens = tokenizeCode(src);
+            if (tokens) {
+                for (let i = 0; i < tokens.length; i++) {
+                    if (tokens[i].value === 'standalone') {
+                        // Check if it's exported and assigned true
+                        let hasExport = false;
+                        for (let j = Math.max(0, i - 3); j < i; j++) {
+                            if (tokens[j].value === 'export') {
+                                hasExport = true;
+                                break;
+                            }
+                        }
+                        if (hasExport) {
+                            for (let k = i + 1; k < Math.min(tokens.length, i + 4); k++) {
+                                if (tokens[k].value === 'true')
+                                    return true;
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
 export function scanRoutes(appDir, options = {}) {
     if (!existsSync(appDir)) {
         return [];
@@ -260,6 +339,7 @@ function scanDirectory(rootDir, dir, parentPath, options) {
     const fullPath = seg
         ? (parentPath === '/' ? '/' : parentPath + '/') + seg
         : (parentPath || '/');
+    const isStandalone = hasLayout ? isStandaloneLayoutFile(join(dir, 'layout.vsk')) : false;
     const node = {
         path: seg,
         fullPath: collapseSlashes(fullPath) || '/',
@@ -277,6 +357,7 @@ function scanDirectory(rootDir, dir, parentPath, options) {
         children: [],
         sourceDir: dir,
         segmentCount: isGroup || dir === rootDir ? 0 : 1,
+        standalone: isStandalone ? true : undefined,
     };
     for (const entry of entries) {
         const entryPath = join(dir, entry);
@@ -369,13 +450,16 @@ export function generateRouteManifest(tree, options = {}) {
             parts.push(`offline: ${node.offline}`);
         if (node.network)
             parts.push(`network: ${node.network}`);
+        if (node.standalone)
+            parts.push(`standalone: true`);
         if (node.children.length > 0) {
             const childCodes = node.children.map((c) => genNode(c));
             parts.push(`children: [\n${childCodes.map((c) => '\t\t' + c).join(',\n')}\n\t]`);
         }
         const pathStr = JSON.stringify(node.fullPath);
         const groupStr = node.isGroup ? `, isGroup: true` : '';
-        return `{ path: ${pathStr}${groupStr}, ${parts.join(', ')} }`;
+        const standaloneStr = node.standalone ? `, standalone: true` : '';
+        return `{ path: ${pathStr}${groupStr}${standaloneStr}, ${parts.join(', ')} }`;
     }
     const nodeCodes = tree.map(n => genNode(n));
     const components = flattenSources(tree);
@@ -422,12 +506,18 @@ export function matchUrl(tree, pathname) {
     if (rootNode) {
         chain.push(rootNode);
     }
+    function pushWithStandalone(node) {
+        if (node.standalone) {
+            chain.length = 0;
+        }
+        chain.push(node);
+    }
     function matchNodes(nodes, partIndex) {
         for (const node of nodes) {
             if (node.isGroup) {
                 if (matchNodes(node.children, partIndex)) {
                     if (node.layout)
-                        chain.push(node);
+                        pushWithStandalone(node);
                     return true;
                 }
                 continue;
@@ -436,8 +526,11 @@ export function matchUrl(tree, pathname) {
                 return matchNodes(node.children, partIndex);
             }
             if (partIndex >= parts.length) {
-                if (node.page) {
-                    chain.push(node);
+                // Only match if this node's fullPath exactly equals the requested pathname
+                // (e.g. "/" should only match the root, not the first child with a page)
+                const requestedPath = '/' + parts.join('/');
+                if (node.page && (node.fullPath === requestedPath || (requestedPath === '/' && node.fullPath === '/'))) {
+                    pushWithStandalone(node);
                     return true;
                 }
                 continue;
@@ -446,13 +539,17 @@ export function matchUrl(tree, pathname) {
             if (node.isCatchAll) {
                 const paramName = node.path.startsWith(':') ? node.path.slice(1) : node.path;
                 params[paramName] = parts.slice(partIndex).map(decodeURIComponent).join('/');
-                chain.push(node);
+                pushWithStandalone(node);
                 return true;
             }
             if (node.isDynamic) {
                 const paramName = node.path.startsWith(':') ? node.path.slice(1) : node.path;
                 params[paramName] = decodeURIComponent(part);
-                chain.push(node);
+                pushWithStandalone(node);
+                const remainingDynamic = parts.slice(partIndex + 1);
+                if (remainingDynamic.length === 0 && node.page) {
+                    return true;
+                }
                 if (node.children.length > 0) {
                     if (matchNodes(node.children, partIndex + 1))
                         return true;
@@ -465,7 +562,11 @@ export function matchUrl(tree, pathname) {
                 continue;
             }
             if (node.path === part) {
-                chain.push(node);
+                pushWithStandalone(node);
+                const remaining = parts.slice(partIndex + 1);
+                if (remaining.length === 0 && node.page) {
+                    return true;
+                }
                 if (node.children.length > 0) {
                     if (matchNodes(node.children, partIndex + 1))
                         return true;

package/dist/server-codegen.d.ts

@@ -1,5 +1,7 @@
 export { setRuntimeModule, prettifyHtml, isStatic, escapeHtml, quoteAttr, safeJsonForScript, randomToken, DEFAULT_MAX_BODY_BYTES, raw, exprJS, tryEvalExpr, childrenToHTML, extractTopLevelNames, extractRuntimeNames, buildParamInit, resolveComponentName, loadRuntimeImports, evalTopLevelCode, callStaticProps, callLoadFunction, __vskHydrate, __vskId, __vskImportedNames, resetVskState, setVskHydrate, setVskImportedNames, securityHeaders, corsHeaders, corsPreflight, csrfToken, verifyCsrfToken, csrfGuard, csrfHmac, assertSameOrigin, signCookie, unsignCookie, setSignedCookie, readSignedCookie, securityComment, redactLog, setRedactLogging, createRateLimiter, getClientIp, getClientProtocol, applyTrustProxy, } from '@vesk/compiler/src/server-utils';
 export { renderHeadHtml, mergeHeadHtml, } from '@vesk/compiler/src/server-head';
-export { irNodeToJS, generateFunctionBody, buildComponentMap, } from '@vesk/compiler/src/server-jsgen';
+export { irNodeToJS, generateFunctionBody, buildComponentMap, buildComponentEntries, } from '@vesk/compiler/src/server-jsgen';
+export { irToJSON, irFromJSON, hydratePrecompile, } from '@vesk/compiler/src/precompile-runtime';
+export { precompileFile, } from '@vesk/compiler/src/precompile';
 export { compileFile, render, renderPage, ssg, renderFullPage, renderPageStream, buildDataScripts, applyHeadPlugins, applyHeadInjects, applyHtmlPlugins, } from '@vesk/compiler/src/server-render';
 //# sourceMappingURL=server-codegen.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"server-codegen.d.ts","sourceRoot":"","sources":["../src/server-codegen.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,sBAAsB,EACtB,GAAG,EACH,MAAM,EACN,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,aAAa,EACb,SAAS,EACT,eAAe,EACf,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,cAAc,EACd,aAAa,GACd,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,WAAW,EACX,MAAM,EACN,UAAU,EACV,GAAG,EACH,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"server-codegen.d.ts","sourceRoot":"","sources":["../src/server-codegen.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,sBAAsB,EACtB,GAAG,EACH,MAAM,EACN,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,aAAa,EACb,SAAS,EACT,eAAe,EACf,SAAS,EACT,QAAQ,EACR,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,iBAAiB,EACjB,eAAe,GAChB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,cAAc,EACd,aAAa,GACd,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,QAAQ,EACR,UAAU,EACV,iBAAiB,GAClB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EACL,cAAc,GACf,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EACL,WAAW,EACX,MAAM,EACN,UAAU,EACV,GAAG,EACH,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,kCAAkC,CAAC"}

package/dist/server-codegen.js

@@ -1,4 +1,6 @@
 export { setRuntimeModule, prettifyHtml, isStatic, escapeHtml, quoteAttr, safeJsonForScript, randomToken, DEFAULT_MAX_BODY_BYTES, raw, exprJS, tryEvalExpr, childrenToHTML, extractTopLevelNames, extractRuntimeNames, buildParamInit, resolveComponentName, loadRuntimeImports, evalTopLevelCode, callStaticProps, callLoadFunction, __vskHydrate, __vskId, __vskImportedNames, resetVskState, setVskHydrate, setVskImportedNames, securityHeaders, corsHeaders, corsPreflight, csrfToken, verifyCsrfToken, csrfGuard, csrfHmac, assertSameOrigin, signCookie, unsignCookie, setSignedCookie, readSignedCookie, securityComment, redactLog, setRedactLogging, createRateLimiter, getClientIp, getClientProtocol, applyTrustProxy, } from '@vesk/compiler/src/server-utils';
 export { renderHeadHtml, mergeHeadHtml, } from '@vesk/compiler/src/server-head';
-export { irNodeToJS, generateFunctionBody, buildComponentMap, } from '@vesk/compiler/src/server-jsgen';
+export { irNodeToJS, generateFunctionBody, buildComponentMap, buildComponentEntries, } from '@vesk/compiler/src/server-jsgen';
+export { irToJSON, irFromJSON, hydratePrecompile, } from '@vesk/compiler/src/precompile-runtime';
+export { precompileFile, } from '@vesk/compiler/src/precompile';
 export { compileFile, render, renderPage, ssg, renderFullPage, renderPageStream, buildDataScripts, applyHeadPlugins, applyHeadInjects, applyHtmlPlugins, } from '@vesk/compiler/src/server-render';

package/dist/server-jsgen.d.ts

@@ -2,5 +2,16 @@ import type { IRNode, ComponentIR, IRRoot } from '@vesk/compiler/src/ir';
 import { type TrackedInfo } from '@vesk/compiler/src/client-codegen';
 export declare function irNodeToJS(node: IRNode, importedNames?: Set<string> | null, isAsync?: boolean, tracked?: Map<string, TrackedInfo>): string;
 export declare function generateFunctionBody(comp: ComponentIR, importedNames: Set<string>): string;
+export interface ComponentMapEntry {
+    name: string;
+    source: string;
+    isAsync: boolean;
+}
+/**
+ * Builds the compiled body source for every component in an IR root. Used by
+ * both `buildComponentMap` (live functions) and `precompile.ts` (AOT SSR plans
+ * that reconstruct the same functions at function-bundle load time).
+ */
+export declare function buildComponentEntries(irRoot: IRRoot): ComponentMapEntry[];
 export declare function buildComponentMap(irRoot: IRRoot, useSharedScope: boolean): Map<string, Function>;
 //# sourceMappingURL=server-jsgen.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"server-jsgen.d.ts","sourceRoot":"","sources":["../src/server-jsgen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAOzE,OAAO,EAAkG,KAAK,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAWrK,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,GAAE,OAAe,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,MAAM,CAmDjJ;AAiUD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAmD1F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAkChG"}
+{"version":3,"file":"server-jsgen.d.ts","sourceRoot":"","sources":["../src/server-jsgen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAOzE,OAAO,EAAkG,KAAK,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAoCrK,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,OAAO,GAAE,OAAe,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,MAAM,CAmDjJ;AA6VD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAmD1F;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CA4BzE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAYhG"}