@vesk/compiler 0.2.25 → 0.2.27

package/dist/errors.d.ts

@@ -28,6 +28,9 @@ export declare class VeskError extends Error {
     static componentNotFound(name: string, available?: string[], context?: VeskErrorOptions): VeskError;
     static configError(msg: string, validOptions?: string[], context?: VeskErrorOptions): VeskError;
     static asyncChildInSyncParent(parentName: string, childName: string, context?: VeskErrorOptions): VeskError;
+    static attrJsxElement(context?: VeskErrorOptions & {
+        attr?: string;
+    }): VeskError;
     toString(): string;
     toJSON(): Record<string, unknown>;
 }

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBxD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,WAAW,GAAE,MAAU,GAAG,MAAM,GAAG,IAAI,CAWrG;AAqCD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,KAAK,SAAI,GAAG,MAAM,CAkBrG;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAgBD,qBAAa,SAAU,SAAQ,KAAK;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEF,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB;IAYxD,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS;IA6BnG,MAAM,CAAC,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS;IAmB3D,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS;IAkBvF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS;IAkBvF,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS;IAO3G,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS;IAWvG,MAAM,CAAC,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS;IAkB/G,QAAQ,IAAI,MAAM;IA0BlB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAclC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAoBxD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,WAAW,GAAE,MAAU,GAAG,MAAM,GAAG,IAAI,CAWrG;AAqCD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,KAAK,SAAI,GAAG,MAAM,CAkBrG;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAgBD,qBAAa,SAAU,SAAQ,KAAK;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEF,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB;IAYxD,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS;IA8BnG,MAAM,CAAC,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS;IAoB3D,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS;IAmBvF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS;IAmBvF,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS;IAO3G,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,GAAE,MAAM,EAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS;IAYvG,MAAM,CAAC,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,SAAS;IAmB/G,MAAM,CAAC,cAAc,CAAC,OAAO,GAAE,gBAAgB,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,SAAS;IAmBpF,QAAQ,IAAI,MAAM;IA0BlB,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAclC"}

package/dist/errors.js

@@ -142,6 +142,7 @@ export class VeskError extends Error {
         }
         return new VeskError(msg, {
             ...context,
+            code: context.code || 'V0401',
             suggestions: [name, ...allCandidates.slice(0, 8)],
             nextSteps,
             tip: isBuiltin
@@ -152,6 +153,7 @@ export class VeskError extends Error {
     static classDecl(context = {}) {
         return new VeskError('class declarations are not supported inside Vesk components.', {
             ...context,
+            code: context.code || 'V0402',
             suggestions: [
                 'Use a plain object: const obj = { ... };',
                 'Use a factory function: function create() { return { ... }; }',
@@ -167,6 +169,7 @@ export class VeskError extends Error {
     static serverBlockInClient(compName, context = {}) {
         return new VeskError(`{#server} block found in client island "${compName}". Client islands render on both server and client, so {#server} blocks have no effect.`, {
             ...context,
+            code: context.code || 'V0403',
             suggestions: [
                 `Remove the {#server} block from "${compName}".`,
                 `Or remove the \`client\` keyword from "${compName}" declaration.`,
@@ -181,6 +184,7 @@ export class VeskError extends Error {
     static clientBlockInServer(compName, context = {}) {
         return new VeskError(`{#client} block found in component "${compName}", but this component is not a client island. {#client} blocks are only allowed inside components declared with the \`client\` keyword.`, {
             ...context,
+            code: context.code || 'V0404',
             suggestions: [
                 `Add \`client\`: \`component ${compName} client { ... }\``,
                 `Or remove the {#client}...{/client} block.`,
@@ -201,6 +205,7 @@ export class VeskError extends Error {
     static configError(msg, validOptions = [], context = {}) {
         return new VeskError(msg, {
             ...context,
+            code: context.code || 'V0405',
             suggestions: validOptions.length ? [`Valid options: ${validOptions.join(', ')}`] : [],
             nextSteps: [
                 'Check your vesk.config file for typos.',
@@ -211,6 +216,7 @@ export class VeskError extends Error {
     static asyncChildInSyncParent(parentName, childName, context = {}) {
         return new VeskError(`Component "${parentName}" renders "<${childName} />", but "<${childName} />" is async and "${parentName}" is not declared async.`, {
             ...context,
+            code: context.code || 'V0406',
             suggestions: [
                 `Declare the parent async: \`async component ${parentName} ...\``,
             ],
@@ -222,8 +228,23 @@ export class VeskError extends Error {
             tip: `A component that renders an async component must itself be async so the renderer can await it before serializing the HTML. Async components also include components that call \`useFetch\`.`,
         });
     }
+    static attrJsxElement(context = {}) {
+        return new VeskError(`Attribute "${context.attr ?? ''}" on an HTML element is given a JSX element value. DOM attributes hold plain values — JSX elements belong to content or to a component prop (where they become a content slot).`, {
+            ...context,
+            code: context.code || 'V0407',
+            suggestions: [
+                'Pass the element as a child instead: <div>{ <yourElement /> }</div>',
+                'If the component accepts it, pass the element as a component prop instead of an HTML attribute.',
+            ],
+            nextSteps: [
+                'Move the JSX element into the element\'s content so it renders as a child node.',
+                'Component props can hold JSX elements — they are threaded as content slots and read back with {props.<name>}.',
+            ],
+            tip: 'JSX elements are content. They render inside an element or travel as a component prop — never as an attribute value on an HTML tag.',
+        });
+    }
     toString() {
-        let out = `[vesk] ${this.message}`;
+        let out = this.code ? `[vesk ${this.code}] ${this.message}` : `[vesk] ${this.message}`;
         if (this.file) {
             out += `\n  File: ${this.file}`;
             if (this.line) {

package/dist/ir-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ir-generator.d.ts","sourceRoot":"","sources":["../src/ir-generator.ts"],"names":[],"mappings":"AACA,OAAO,EACL,MAAM,EAoBP,MAAM,uBAAuB,CAAC;AA0L/B,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAC;IAAC,cAAc,CAAC,EAAE,GAAG,CAAC;IAAC,UAAU,CAAC,EAAE,GAAG,EAAE,CAAA;CAAE,CAAC,GAAG,SAAS,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkCnL;AAg0BD,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CA2Q9E"}
+{"version":3,"file":"ir-generator.d.ts","sourceRoot":"","sources":["../src/ir-generator.ts"],"names":[],"mappings":"AACA,OAAO,EACL,MAAM,EAsBP,MAAM,uBAAuB,CAAC;AA8N/B,wBAAgB,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,GAAG,CAAC;IAAC,cAAc,CAAC,EAAE,GAAG,CAAC;IAAC,UAAU,CAAC,EAAE,GAAG,EAAE,CAAA;CAAE,CAAC,GAAG,SAAS,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkCnL;AA07BD,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAoR9E"}

package/dist/ir-generator.js

@@ -1,4 +1,4 @@
-import { IRRoot, ComponentIR, StaticNode, TextNode, DynamicBinding, OpaqueDynamicRegion, MapRegion, WhileLoop, SwitchBlock, TryCatch, RuntimeStatement, ForLoop, TrackDecl, ComponentRef, ComponentCall, ServerBlock, ClientBlock, HeadBlock, Expression, SlotNode, } from '@vesk/compiler/src/ir';
+import { IRRoot, ComponentIR, StaticNode, TextNode, DynamicBinding, OpaqueDynamicRegion, MapRegion, WhileLoop, SwitchBlock, TryCatch, RuntimeStatement, ForLoop, TrackDecl, ComponentRef, ComponentCall, ServerBlock, ClientBlock, HeadBlock, Expression, SlotNode, PropSlot, PropSlotRender, } from '@vesk/compiler/src/ir';
 import { VeskError, codeFrame } from '@vesk/compiler/src/errors';
 import { createBaseParser } from '@vesk/compiler/src/parser';
 import { skipWhitespace, findBalancedEnd, splitTopLevel, startsWithIdentifier, stripDeclKeyword, isWhitespaceChar, collapseNewlineWhitespace } from '@vesk/compiler/src/scan';
@@ -7,6 +7,14 @@ import { stripTypeImport } from '@vesk/compiler/src/vsk-imports';
 import { importBindingPairs } from '@vesk/compiler/src/module-imports';
 import { collectCalledIdentifiers, extractImportNames, importModuleTarget } from '@vesk/compiler/src/tokens';
 let __vskAnnotations = [];
+/**
+ * Prop names of the component currently being processed that are declared as
+ * renderable content (`*: Component`) and are therefore threaded through the
+ * slot channel. A content read `{props.<name>}` of such a prop compiles to
+ * {@link PropSlotRender} instead of a value binding, so the child can render a
+ * slot handed to it by a caller that wrote `name={<div/>}`.
+ */
+let __slotProps = null;
 function parseExprNode(text) {
     try {
         const ParserClass = createBaseParser();
@@ -39,6 +47,34 @@ function getForClauseAnnotation(forStart) {
 function getSource(source, node) {
     return source.slice(node.start, node.end);
 }
+/**
+ * Returns the source text for a loop/map binding pattern, preserving
+ * destructuring (`[a, b]`, `{x, y}`, defaults, rest) while stripping a
+ * top-level TS type annotation (`[a, b]: T` → `[a, b]`). Plain identifiers
+ * return their name directly so `const x: T` still yields `x`.
+ */
+function patternSource(source, node) {
+    if (!node)
+        return 'item';
+    if (node.type === 'Identifier')
+        return node.name ?? 'item';
+    const end = node.typeAnnotation ? node.typeAnnotation.start : node.end;
+    const text = source.slice(node.start, end).trim();
+    return text || 'item';
+}
+function mapParamSource(source, param) {
+    if (!param)
+        return 'item';
+    if (param.type === 'Identifier')
+        return param.name ?? 'item';
+    const end = param.typeAnnotation ? param.typeAnnotation.start : param.end;
+    if (typeof param.start === 'number' && typeof end === 'number') {
+        const text = source.slice(param.start, end).trim();
+        if (text)
+            return text;
+    }
+    return 'item';
+}
 function collectComponentCalls(nodes, out) {
     for (const n of nodes) {
         if (n instanceof ComponentCall) {
@@ -48,6 +84,9 @@ function collectComponentCalls(nodes, out) {
         else if (n instanceof StaticNode || n instanceof ServerBlock || n instanceof ClientBlock || n instanceof HeadBlock) {
             collectComponentCalls(n.children, out);
         }
+        else if (n instanceof PropSlot) {
+            collectComponentCalls(n.body, out);
+        }
         else if (n instanceof MapRegion) {
             collectComponentCalls(n.bodyTemplate, out);
             collectComponentCalls(n.alternateNodes, out);
@@ -281,10 +320,99 @@ function processAttribute(source, attr) {
         const expr = attr.value.expression;
         if (expr.type === 'Literal')
             return { name, value: String(expr.value) };
+        // A JSX element can never be a DOM attribute value — elements belong to
+        // content/slots, not to an attribute slot on an HTML tag. Surfacing a real
+        // error here beats a raw `(<div/>)` leaking into compiled JS (the previous
+        // behavior crashed with a runtime SyntaxError deep inside codegen).
+        if (containsJSX(expr)) {
+            throw VeskError.attrJsxElement({ attr: name });
+        }
         return { name, value: toExpression(source, expr) };
     }
     return { name, value: '' };
 }
+/**
+ * True when `node` (an expression AST) contains a JSX element or fragment
+ * anywhere in its subtree — used to distinguish slot-bearing prop values
+ * (`trigger={<Button/>}`, `trigger={open ? <A/> : <B/>}`) from plain ones
+ * (`align={'end'}`, `count={n + 1}`).
+ */
+function containsJSX(node) {
+    if (!node || typeof node !== 'object')
+        return false;
+    if (node.type === 'JSXElement' || node.type === 'JSXFragment')
+        return true;
+    if (node.type === 'JSXExpressionContainer')
+        return containsJSX(node.expression);
+    // TS-only position holders (type annotations, parameter names) never contain
+    // JSX — skipping them avoids walking TS structure.
+    for (const key of [
+        'expression', 'object', 'property', 'callee', 'arguments', 'test',
+        'consequent', 'alternate', 'left', 'right', 'init', 'elements', 'params', 'body',
+    ]) {
+        const child = node[key];
+        if (Array.isArray(child)) {
+            for (const c of child)
+                if (containsJSX(c))
+                    return true;
+        }
+        else if (child && containsJSX(child)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Returns the prop name when `expr` is a bare `props.<name>` read, else null.
+ */
+function slotReadPropName(expr) {
+    if (expr.type === 'MemberExpression' && !expr.computed &&
+        expr.object.type === 'Identifier' && expr.object.name === 'props' &&
+        expr.property.type === 'Identifier') {
+        return expr.property.name;
+    }
+    return null;
+}
+/**
+ * Parses an inline component props type (`{ trigger: Component; ... }`) and
+ * returns the set of prop names declared as renderable content — any member
+ * whose type text mentions `Component`. Those props may be handed a JSX
+ * element at the call site and are read back with `{props.<name>}` as slots.
+ */
+function slotPropNamesFromType(propsType) {
+    const out = new Set();
+    if (!propsType)
+        return out;
+    const trimmed = propsType.trim();
+    if (trimmed.startsWith('{')) {
+        const inner = findBalancedEnd(trimmed, 0) === trimmed.length - 1
+            ? trimmed.slice(1, -1)
+            : trimmed;
+        for (const part of splitTopLevel(inner, ';')) {
+            const colon = findTopLevelColon(part);
+            if (colon === -1)
+                continue;
+            const namePart = part.slice(0, colon).trim().replace(/^\$/, '').replace(/\?$/, '').trim();
+            const typePart = part.slice(colon + 1).trim();
+            if (namePart && typePart.includes('Component'))
+                out.add(namePart);
+        }
+    }
+    return out;
+}
+function findTopLevelColon(text) {
+    let depth = 0;
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        if (ch === '(' || ch === '[' || ch === '{' || ch === '<')
+            depth++;
+        else if (ch === ')' || ch === ']' || ch === '}')
+            depth = Math.max(0, depth - 1);
+        else if (ch === ':' && depth === 0)
+            return i;
+    }
+    return -1;
+}
 /**
  * Recognizes a statement-mode `if (cond)` opening among JSX children.
  * Returns the condition source, or null when `text` does not open an if
@@ -433,7 +561,7 @@ function processJSXChildren(source, children) {
                     const exprText = ofParts[1].trim();
                     const arrExpr = new Expression(exprText, [], parseExprNode(exprText), null);
                     const rawFor = hasForPrefix(child.value);
-                    const ann = rawFor ? getForClauseAnnotation(child.start + rawFor) : null;
+                    const ann = rawFor !== -1 ? getForClauseAnnotation(child.start + rawFor) : null;
                     const keyExpr = ann?.keyRange ? new Expression(source.slice(ann.keyRange[0], ann.keyRange[1])) : null;
                     const indexVar = ann?.indexName ?? null;
                     let alternate = [];
@@ -470,7 +598,7 @@ function processJSXChildren(source, children) {
             }
             if (isMapCall(expr)) {
                 const arrowFn = expr.arguments[0];
-                const itemVar = arrowFn.params[0]?.name ?? 'item';
+                const itemVar = mapParamSource(source, arrowFn.params[0]);
                 const indexVar = arrowFn.params[1]?.name ?? null;
                 const bodyNodes = processJSXCallbackBody(source, arrowFn.body);
                 const arrayExpr = toExpression(source, expr.callee.object);
@@ -502,6 +630,16 @@ function processJSXChildren(source, children) {
                 i++;
                 continue;
             }
+            // A content read of a component-declared slot prop (`{props.trigger}`)
+            // must render the threaded content — not stringify a fragment.
+            {
+                const slotName = slotReadPropName(expr);
+                if (slotName !== null && __slotProps !== null && __slotProps.has(slotName)) {
+                    result.push(new PropSlotRender(slotName));
+                    i++;
+                    continue;
+                }
+            }
             result.push(new DynamicBinding(toExpression(source, expr)));
             i++;
         }
@@ -557,7 +695,7 @@ function exprToIR(source, expr) {
     }
     if (isMapCall(expr)) {
         const arrowFn = expr.arguments[0];
-        const itemVar = arrowFn.params[0]?.name ?? 'item';
+        const itemVar = mapParamSource(source, arrowFn.params[0]);
         const indexVar = arrowFn.params[1]?.name ?? null;
         const bodyNodes = processJSXCallbackBody(source, arrowFn.body);
         const arrayExpr = toExpression(source, expr.callee.object);
@@ -580,6 +718,19 @@ function exprToIR(source, expr) {
         const consequent = exprToIR(source, expr.right);
         return [new OpaqueDynamicRegion(condExpr, consequent)];
     }
+    // `props.children` (or bare `children`) inside an expression branch must
+    // insert the slot nodes — not degrade to a text binding that stringifies
+    // the fragment (`String(props.children)` → "[object DocumentFragment]").
+    if ((expr.type === 'MemberExpression' && !expr.computed &&
+        expr.object.type === 'Identifier' && expr.object.name === 'props' &&
+        expr.property.type === 'Identifier' && expr.property.name === 'children')
+        || (expr.type === 'Identifier' && expr.name === 'children')) {
+        return [new SlotNode()];
+    }
+    const slotName = slotReadPropName(expr);
+    if (slotName !== null && __slotProps !== null && __slotProps.has(slotName)) {
+        return [new PropSlotRender(slotName)];
+    }
     return [new DynamicBinding(toExpression(source, expr))];
 }
 /**
@@ -633,18 +784,18 @@ function processJSXElement(source, element) {
     // actual in-scope value instead of `document.createElement("it.icon")` or a
     // registry lookup by dotted string.
     if (nameNode && nameNode.type === 'JSXMemberExpression') {
-        const { props, spreadProps } = extractProps(source, element);
+        const { props, spreadProps, slots } = extractProps(source, element);
         const children = selfClosing ? [] : processJSXChildren(source, element.children || []);
-        return [new ComponentCall(tagName, props, children, spreadProps, element.start, getSource(source, nameNode))];
+        return [new ComponentCall(tagName, props, [...children, ...slots.map((s) => new PropSlot(s.name, s.nodes))], spreadProps, element.start, getSource(source, nameNode))];
     }
     if (!isHTMLTag(tagName) && selfClosing) {
-        const { props, spreadProps } = extractProps(source, element);
-        return [new ComponentCall(tagName, props, [], spreadProps, element.start)];
+        const { props, spreadProps, slots } = extractProps(source, element);
+        return [new ComponentCall(tagName, props, slots.map((s) => new PropSlot(s.name, s.nodes)), spreadProps, element.start)];
     }
     if (!isHTMLTag(tagName)) {
-        const { props, spreadProps } = extractProps(source, element);
+        const { props, spreadProps, slots } = extractProps(source, element);
         const children = processJSXChildren(source, element.children || []);
-        return [new ComponentCall(tagName, props, children, spreadProps, element.start)];
+        return [new ComponentCall(tagName, props, [...children, ...slots.map((s) => new PropSlot(s.name, s.nodes))], spreadProps, element.start)];
     }
     const attributes = element.openingElement.attributes
         .filter((attr) => attr.type !== 'JSXSpreadAttribute')
@@ -677,22 +828,34 @@ function processJSXElement(source, element) {
 function extractProps(source, element) {
     const props = [];
     const spreadProps = [];
+    const slots = [];
     for (const attr of element.openingElement.attributes) {
         if (attr.type === 'JSXSpreadAttribute') {
             spreadProps.push(toExpression(source, attr.argument));
         }
         else {
-            props.push({
-                name: attr.name.type === 'JSXIdentifier' ? attr.name.name : getSource(source, attr.name),
-                value: attr.value === null
-                    ? new Expression('true')
-                    : attr.value.type === 'JSXExpressionContainer'
-                        ? toExpression(source, attr.value.expression)
-                        : new Expression(JSON.stringify(attr.value.value)),
-            });
+            const name = attr.name.type === 'JSXIdentifier' ? attr.name.name : getSource(source, attr.name);
+            let value;
+            if (attr.value === null) {
+                value = new Expression('true');
+            }
+            else if (attr.value.type === 'JSXExpressionContainer') {
+                const expr = attr.value.expression;
+                // JSX elements as prop values are named content slots (`trigger={<Button/>}`),
+                // not scalar values — the call site hoists them into the slot channel.
+                if (containsJSX(expr)) {
+                    slots.push({ name, nodes: exprToIR(source, expr) });
+                    continue;
+                }
+                value = toExpression(source, expr);
+            }
+            else {
+                value = new Expression(JSON.stringify(attr.value.value));
+            }
+            props.push({ name, value });
         }
     }
-    return { props, spreadProps };
+    return { props, spreadProps, slots };
 }
 function buildGuardChain(source, guardClauses, mainReturn) {
     const mainBody = [];
@@ -842,9 +1005,16 @@ function processIfStatement(source, stmt) {
 function processForStatement(source, stmt, alternate = []) {
     if (stmt.type === 'ForOfStatement') {
         const left = stmt.left;
-        const itemVar = left.type === 'VariableDeclaration'
-            ? left.declarations[0]?.id?.name ?? 'item'
-            : left.name ?? 'item';
+        let itemVar = 'item';
+        if (left.type === 'VariableDeclaration') {
+            itemVar = patternSource(source, left.declarations[0]?.id);
+        }
+        else if (left.type === 'Identifier') {
+            itemVar = left.name ?? 'item';
+        }
+        else if (typeof left.start === 'number' && typeof left.end === 'number') {
+            itemVar = source.slice(left.start, left.end).trim() || 'item';
+        }
         const arrayExpr = toExpression(source, stmt.right);
         const bodyTemplate = processBlockBody(source, stmt.body);
         const ann = getForClauseAnnotation(stmt.start);
@@ -1112,6 +1282,7 @@ function idxOfQuote(s, from) {
 }
 export function generateIR(ast, source, filename) {
     __vskAnnotations = ast.__vskAnnotations ?? [];
+    __slotProps = null;
     const file = filename || '';
     const components = [];
     const imports = [];
@@ -1206,6 +1377,11 @@ export function generateIR(ast, source, filename) {
         const propsType = getPropsType(inner.params, source);
         const bodyStmts = inner.body.body;
         const isClientComp = !!inner.client;
+        // Slot props are declared at the component boundary (`trigger: Component`),
+        // so content reads of `props.<name>` compile to slot renders instead of
+        // value bindings for THIS component only.
+        const prevSlotProps = __slotProps;
+        __slotProps = slotPropNamesFromType(propsType);
         if (isStatementMode(bodyStmts)) {
             const raw = processStatementModeBody(source, bodyStmts, file);
             const { body, css } = extractStyle(raw);
@@ -1213,6 +1389,7 @@ export function generateIR(ast, source, filename) {
             const comp = new ComponentIR(name, paramNames, body, { mode: 'statement', exported, defaultExport, isClient: inner.client, isAsync: inner.async, ssrAwait: componentUsesFetch(body), propsType });
             comp.style = css;
             components.push(comp);
+            __slotProps = prevSlotProps;
         }
         else {
             const guardClauses = [];
@@ -1261,6 +1438,7 @@ export function generateIR(ast, source, filename) {
             const comp = new ComponentIR(name, paramNames, body, { exported, defaultExport, isClient: inner.client, isAsync: inner.async, ssrAwait: componentUsesFetch(body), propsType });
             comp.style = css;
             components.push(comp);
+            __slotProps = prevSlotProps;
         }
     }
     const asyncNames = new Set(components.filter((c) => c.isAsync || c.ssrAwait).map((c) => c.name));

package/dist/ir.d.ts

@@ -104,6 +104,29 @@ export declare class ComponentCall {
 export declare class SlotNode {
     constructor();
 }
+/**
+ * A named content slot threaded to a component through a prop that was given a
+ * JSX element value at the call site (`<Popover trigger={<Button/>}>`). The
+ * prop is neither a scalar value nor JSON-able — it is renderable content, so
+ * codegen hoists the slot body and passes it under the prop name using the
+ * exact same channel as `children` (a serialized string IIFE on the server, a
+ * fresh DocumentFragment on the client). Child components draw it back with
+ * `{props.<name>}`, which compiles to a {@link PropSlotRender}.
+ */
+export declare class PropSlot {
+    propName: string;
+    body: IRNode[];
+    constructor(propName: string, body: IRNode[]);
+}
+/**
+ * A content read of a slot prop (`{props.trigger}`). The runtime value behind
+ * it is threaded through the same channel as `children`, so emitting it on the
+ * server pushes the serialized string and on the client appends the fragment.
+ */
+export declare class PropSlotRender {
+    propName: string;
+    constructor(propName: string);
+}
 export declare class WhileLoop {
     condition: Expression;
     bodyTemplate: IRNode[];
@@ -163,5 +186,5 @@ export declare class HeadBlock {
     children: IRNode[];
     constructor(children: IRNode[]);
 }
-export type IRNode = StaticNode | TextNode | DynamicBinding | OpaqueDynamicRegion | MapRegion | WhileLoop | SwitchBlock | TryCatch | ForLoop | TrackDecl | RuntimeStatement | ComponentRef | ComponentCall | ServerBlock | ClientBlock | HeadBlock | SlotNode;
+export type IRNode = StaticNode | TextNode | DynamicBinding | OpaqueDynamicRegion | MapRegion | WhileLoop | SwitchBlock | TryCatch | ForLoop | TrackDecl | RuntimeStatement | ComponentRef | ComponentCall | ServerBlock | ClientBlock | HeadBlock | SlotNode | PropSlot | PropSlotRender;
 //# sourceMappingURL=ir.d.ts.map

package/dist/ir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../src/ir.ts"],"names":[],"mappings":"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"}

package/dist/ir.js

@@ -139,6 +139,34 @@ export class ComponentCall {
 export class SlotNode {
     constructor() { }
 }
+/**
+ * A named content slot threaded to a component through a prop that was given a
+ * JSX element value at the call site (`<Popover trigger={<Button/>}>`). The
+ * prop is neither a scalar value nor JSON-able — it is renderable content, so
+ * codegen hoists the slot body and passes it under the prop name using the
+ * exact same channel as `children` (a serialized string IIFE on the server, a
+ * fresh DocumentFragment on the client). Child components draw it back with
+ * `{props.<name>}`, which compiles to a {@link PropSlotRender}.
+ */
+export class PropSlot {
+    propName;
+    body;
+    constructor(propName, body) {
+        this.propName = propName;
+        this.body = body;
+    }
+}
+/**
+ * A content read of a slot prop (`{props.trigger}`). The runtime value behind
+ * it is threaded through the same channel as `children`, so emitting it on the
+ * server pushes the serialized string and on the client appends the fragment.
+ */
+export class PropSlotRender {
+    propName;
+    constructor(propName) {
+        this.propName = propName;
+    }
+}
 export class WhileLoop {
     condition;
     bodyTemplate;

package/dist/module-imports.d.ts

@@ -41,10 +41,31 @@ export declare function readSsrSource(absPath: string): {
     raw: string;
     ast: ReturnType<typeof parse> | null;
 } | null;
+/** Nearest `tsconfig.json` at or above `fromDir`, or null. */
+export declare function findTsconfigPath(fromDir: string): string | null;
+/**
+ * Resolves a tsconfig-alias specifier (`@/x`, `@app/x`) to an existing file via
+ * the nearest tsconfig's `baseUrl` + `paths`, or null when the specifier is not
+ * aliased or no target exists (caller then falls through to normal resolution).
+ */
+export declare function resolveAliasModule(spec: string, fromDir: string): string | null;
+/**
+ * Resolves a relative import specifier to an absolute file path for a bundler
+ * (esbuild/rollup) to consume. An explicit extension is preserved — `./x.ts`
+ * stays `./x.ts` and must never become `./x.ts.ts`. An extensionless specifier
+ * is probed against `EXTENSIONS` (then `.vsk`, so component imports resolve),
+ * and falls back to `.ts` so the bundler reports the missing file by name.
+ * tsconfig `paths` aliases (`@/x`, `@app/x`) resolve against the app tsconfig;
+ * other bare/absolute specifiers are returned unchanged. This is the single
+ * source of truth for every relative-import rewrite (SSR loader and client
+ * chunk bundler).
+ */
+export declare function resolveImportPath(spec: string, fromDir: string): string;
 /**
  * Resolves a specifier to an absolute file path (or a `BUILTIN_PREFIX` marker
  * for Node builtins). Relative/absolute localities use extension probing;
- * bare specifiers (`npm-package`, `pkg/subpath`, `node:fs`, `fs`) prefer
+ * tsconfig `paths` aliases (`@/x`, `@app/x`) resolve against the app tsconfig;
+ * other bare specifiers (`npm-package`, `pkg/subpath`, `node:fs`, `fs`) prefer
  * Node's own resolver — which understands `exports` maps, conditions, scoped
  * packages and builtins — and fall back to a `node_modules` walk-up.
  *

package/dist/module-imports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-imports.d.ts","sourceRoot":"","sources":["../src/module-imports.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AA2ElD,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOzD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAgC1F;AAED,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAQpE;AAED,0FAA0F;AAC1F,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAIvD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,IAAI,CAuBN;AAiBD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAiE7E;AA6BD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAe3G;AA8TD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA8BlF;AAoJD,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAiGxF;AAaD,MAAM,WAAW,iBAAiB;IAChC,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAoDD,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,GAAG,MAAM,CAuCxF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,SAAS,EAAE,eAAe,GACzB,iBAAiB,EAAE,CAiBrB"}
+{"version":3,"file":"module-imports.d.ts","sourceRoot":"","sources":["../src/module-imports.ts"],"names":[],"mappings":"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"}