@pwfabric/runtime 0.0.0-stage → 1.0.0-rc.1

package/dist/surface/primitives.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Built-in Primitives
+ *
+ * Core primitive definitions for the runtime
+ *
+ * These are the built-in primitives that the runtime knows how to render.
+ * Each primitive has a defined contract for its props.
+ *
+ * @module @pwfabric/runtime/surface/primitives
+ */
+import type { PrimitiveType, RenderNode, BaseNodeProps } from './types.js';
+/**
+ * Text primitive props
+ */
+export interface TextProps extends BaseNodeProps {
+    readonly content: string;
+    readonly variant?: 'body' | 'caption' | 'label';
+    readonly weight?: 'normal' | 'medium' | 'bold';
+    readonly truncate?: boolean;
+}
+/**
+ * Container primitive props
+ */
+export interface ContainerProps extends BaseNodeProps {
+    readonly direction?: 'row' | 'column';
+    readonly align?: 'start' | 'center' | 'end' | 'stretch';
+    readonly justify?: 'start' | 'center' | 'end' | 'between' | 'around';
+    readonly gap?: number | string;
+    readonly padding?: number | string;
+    readonly wrap?: boolean;
+}
+/**
+ * Button primitive props
+ */
+export interface ButtonProps extends BaseNodeProps {
+    readonly label: string;
+    readonly variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
+    readonly size?: 'sm' | 'md' | 'lg';
+    readonly disabled?: boolean;
+    readonly loading?: boolean;
+    readonly onClick?: string;
+}
+/**
+ * Input primitive props
+ */
+export interface InputProps extends BaseNodeProps {
+    readonly name: string;
+    readonly type?: 'text' | 'email' | 'password' | 'number' | 'tel' | 'url';
+    readonly placeholder?: string;
+    readonly value?: string;
+    readonly disabled?: boolean;
+    readonly required?: boolean;
+    readonly onChange?: string;
+}
+/**
+ * Image primitive props
+ */
+export interface ImageProps extends BaseNodeProps {
+    readonly src: string;
+    readonly alt: string;
+    readonly width?: number | string;
+    readonly height?: number | string;
+    readonly loading?: 'eager' | 'lazy';
+    readonly fit?: 'contain' | 'cover' | 'fill' | 'none';
+}
+/**
+ * Link primitive props
+ */
+export interface LinkProps extends BaseNodeProps {
+    readonly href: string;
+    readonly target?: '_self' | '_blank' | '_parent' | '_top';
+    readonly rel?: string;
+}
+/**
+ * List primitive props
+ */
+export interface ListProps extends BaseNodeProps {
+    readonly type?: 'ordered' | 'unordered';
+    readonly marker?: 'disc' | 'circle' | 'square' | 'decimal' | 'none';
+}
+/**
+ * Heading primitive props
+ */
+export interface HeadingProps extends BaseNodeProps {
+    readonly level: 1 | 2 | 3 | 4 | 5 | 6;
+    readonly content: string;
+}
+/**
+ * Spacer primitive props
+ */
+export interface SpacerProps extends BaseNodeProps {
+    readonly size: number | string;
+    readonly direction?: 'horizontal' | 'vertical';
+}
+/**
+ * Divider primitive props
+ */
+export interface DividerProps extends BaseNodeProps {
+    readonly orientation?: 'horizontal' | 'vertical';
+    readonly variant?: 'solid' | 'dashed' | 'dotted';
+}
+/**
+ * Slot primitive props - placeholder for injected content
+ */
+export interface SlotProps extends BaseNodeProps {
+    readonly name: string;
+    readonly fallback?: readonly RenderNode[];
+}
+/**
+ * Conditional primitive props
+ */
+export interface ConditionalProps extends BaseNodeProps {
+    readonly condition: string;
+    readonly then?: readonly RenderNode[];
+    readonly else?: readonly RenderNode[];
+}
+/**
+ * Loop primitive props
+ */
+export interface LoopProps extends BaseNodeProps {
+    readonly items: string;
+    readonly as: string;
+    readonly keyExpr?: string;
+}
+/**
+ * Primitive definition
+ */
+export interface PrimitiveDefinition {
+    readonly type: PrimitiveType;
+    readonly name: string;
+    readonly description: string;
+    readonly props: Record<string, PropDefinition>;
+    readonly allowsChildren: boolean;
+}
+/**
+ * Property definition
+ */
+export interface PropDefinition {
+    readonly type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'expression';
+    readonly required: boolean;
+    readonly description: string;
+    readonly defaultValue?: unknown;
+    readonly oneOf?: readonly unknown[];
+}
+/**
+ * Built-in primitive definitions
+ */
+export declare const PRIMITIVE_DEFINITIONS: Record<PrimitiveType, PrimitiveDefinition>;
+/**
+ * Create a text node
+ */
+export declare function text(content: string, props?: Omit<TextProps, 'content'>): RenderNode;
+/**
+ * Create a container node
+ */
+export declare function container(children: readonly RenderNode[], props?: ContainerProps): RenderNode;
+/**
+ * Create a button node
+ */
+export declare function button(label: string, props?: Omit<ButtonProps, 'label'>): RenderNode;
+/**
+ * Create a heading node
+ */
+export declare function heading(level: 1 | 2 | 3 | 4 | 5 | 6, content: string, props?: Omit<HeadingProps, 'level' | 'content'>): RenderNode;
+/**
+ * Create a spacer node
+ */
+export declare function spacer(size: number | string, direction?: 'horizontal' | 'vertical'): RenderNode;
+/**
+ * Create a divider node
+ */
+export declare function divider(props?: DividerProps): RenderNode;
+/**
+ * Check if a type is a known primitive
+ */
+export declare function isPrimitive(type: string): type is PrimitiveType;
+/**
+ * Get primitive definition
+ */
+export declare function getPrimitiveDefinition(type: PrimitiveType): PrimitiveDefinition | undefined;

package/dist/surface/primitives.js

@@ -0,0 +1,339 @@
+/**
+ * Built-in Primitives
+ *
+ * Core primitive definitions for the runtime
+ *
+ * These are the built-in primitives that the runtime knows how to render.
+ * Each primitive has a defined contract for its props.
+ *
+ * @module @pwfabric/runtime/surface/primitives
+ */
+import { createNode } from './types.js';
+/**
+ * Built-in primitive definitions
+ */
+export const PRIMITIVE_DEFINITIONS = {
+    text: {
+        type: 'text',
+        name: 'Text',
+        description: 'Display text content',
+        props: {
+            content: { type: 'string', required: true, description: 'Text content to display' },
+            variant: {
+                type: 'string',
+                required: false,
+                description: 'Text variant',
+                oneOf: ['body', 'caption', 'label'],
+                defaultValue: 'body',
+            },
+            weight: {
+                type: 'string',
+                required: false,
+                description: 'Font weight',
+                oneOf: ['normal', 'medium', 'bold'],
+                defaultValue: 'normal',
+            },
+            truncate: {
+                type: 'boolean',
+                required: false,
+                description: 'Truncate with ellipsis',
+                defaultValue: false,
+            },
+        },
+        allowsChildren: false,
+    },
+    container: {
+        type: 'container',
+        name: 'Container',
+        description: 'Layout container for child elements',
+        props: {
+            direction: {
+                type: 'string',
+                required: false,
+                description: 'Flex direction',
+                oneOf: ['row', 'column'],
+                defaultValue: 'column',
+            },
+            align: {
+                type: 'string',
+                required: false,
+                description: 'Align items',
+                oneOf: ['start', 'center', 'end', 'stretch'],
+            },
+            justify: {
+                type: 'string',
+                required: false,
+                description: 'Justify content',
+                oneOf: ['start', 'center', 'end', 'between', 'around'],
+            },
+            gap: { type: 'string', required: false, description: 'Gap between children' },
+            padding: { type: 'string', required: false, description: 'Container padding' },
+            wrap: { type: 'boolean', required: false, description: 'Wrap children', defaultValue: false },
+        },
+        allowsChildren: true,
+    },
+    button: {
+        type: 'button',
+        name: 'Button',
+        description: 'Interactive button element',
+        props: {
+            label: { type: 'string', required: true, description: 'Button label' },
+            variant: {
+                type: 'string',
+                required: false,
+                description: 'Button style variant',
+                oneOf: ['primary', 'secondary', 'ghost', 'danger'],
+                defaultValue: 'primary',
+            },
+            size: {
+                type: 'string',
+                required: false,
+                description: 'Button size',
+                oneOf: ['sm', 'md', 'lg'],
+                defaultValue: 'md',
+            },
+            disabled: { type: 'boolean', required: false, description: 'Disable button' },
+            loading: { type: 'boolean', required: false, description: 'Show loading state' },
+            onClick: { type: 'expression', required: false, description: 'Click handler expression' },
+        },
+        allowsChildren: false,
+    },
+    input: {
+        type: 'input',
+        name: 'Input',
+        description: 'Text input field',
+        props: {
+            name: { type: 'string', required: true, description: 'Input name' },
+            type: {
+                type: 'string',
+                required: false,
+                description: 'Input type',
+                oneOf: ['text', 'email', 'password', 'number', 'tel', 'url'],
+                defaultValue: 'text',
+            },
+            placeholder: { type: 'string', required: false, description: 'Placeholder text' },
+            value: { type: 'string', required: false, description: 'Current value' },
+            disabled: { type: 'boolean', required: false, description: 'Disable input' },
+            required: { type: 'boolean', required: false, description: 'Mark as required' },
+            onChange: { type: 'expression', required: false, description: 'Change handler expression' },
+        },
+        allowsChildren: false,
+    },
+    image: {
+        type: 'image',
+        name: 'Image',
+        description: 'Display an image',
+        props: {
+            src: { type: 'string', required: true, description: 'Image source URL' },
+            alt: { type: 'string', required: true, description: 'Alt text for accessibility' },
+            width: { type: 'string', required: false, description: 'Image width' },
+            height: { type: 'string', required: false, description: 'Image height' },
+            loading: {
+                type: 'string',
+                required: false,
+                description: 'Loading strategy',
+                oneOf: ['eager', 'lazy'],
+                defaultValue: 'lazy',
+            },
+            fit: {
+                type: 'string',
+                required: false,
+                description: 'Object fit',
+                oneOf: ['contain', 'cover', 'fill', 'none'],
+            },
+        },
+        allowsChildren: false,
+    },
+    link: {
+        type: 'link',
+        name: 'Link',
+        description: 'Navigation link',
+        props: {
+            href: { type: 'string', required: true, description: 'Link destination' },
+            target: {
+                type: 'string',
+                required: false,
+                description: 'Link target',
+                oneOf: ['_self', '_blank', '_parent', '_top'],
+            },
+            rel: { type: 'string', required: false, description: 'Link relationship' },
+        },
+        allowsChildren: true,
+    },
+    list: {
+        type: 'list',
+        name: 'List',
+        description: 'List container',
+        props: {
+            type: {
+                type: 'string',
+                required: false,
+                description: 'List type',
+                oneOf: ['ordered', 'unordered'],
+                defaultValue: 'unordered',
+            },
+            marker: {
+                type: 'string',
+                required: false,
+                description: 'List marker style',
+                oneOf: ['disc', 'circle', 'square', 'decimal', 'none'],
+            },
+        },
+        allowsChildren: true,
+    },
+    'list-item': {
+        type: 'list-item',
+        name: 'List Item',
+        description: 'Item within a list',
+        props: {},
+        allowsChildren: true,
+    },
+    heading: {
+        type: 'heading',
+        name: 'Heading',
+        description: 'Section heading',
+        props: {
+            level: {
+                type: 'number',
+                required: true,
+                description: 'Heading level (1-6)',
+                oneOf: [1, 2, 3, 4, 5, 6],
+            },
+            content: { type: 'string', required: true, description: 'Heading text' },
+        },
+        allowsChildren: false,
+    },
+    paragraph: {
+        type: 'paragraph',
+        name: 'Paragraph',
+        description: 'Text paragraph',
+        props: {},
+        allowsChildren: true,
+    },
+    spacer: {
+        type: 'spacer',
+        name: 'Spacer',
+        description: 'Empty space',
+        props: {
+            size: { type: 'string', required: true, description: 'Space size' },
+            direction: {
+                type: 'string',
+                required: false,
+                description: 'Space direction',
+                oneOf: ['horizontal', 'vertical'],
+                defaultValue: 'vertical',
+            },
+        },
+        allowsChildren: false,
+    },
+    divider: {
+        type: 'divider',
+        name: 'Divider',
+        description: 'Visual separator',
+        props: {
+            orientation: {
+                type: 'string',
+                required: false,
+                description: 'Divider orientation',
+                oneOf: ['horizontal', 'vertical'],
+                defaultValue: 'horizontal',
+            },
+            variant: {
+                type: 'string',
+                required: false,
+                description: 'Divider style',
+                oneOf: ['solid', 'dashed', 'dotted'],
+                defaultValue: 'solid',
+            },
+        },
+        allowsChildren: false,
+    },
+    slot: {
+        type: 'slot',
+        name: 'Slot',
+        description: 'Named slot for content injection',
+        props: {
+            name: { type: 'string', required: true, description: 'Slot name' },
+        },
+        allowsChildren: true, // Children are fallback content
+    },
+    fragment: {
+        type: 'fragment',
+        name: 'Fragment',
+        description: 'Invisible wrapper for multiple children',
+        props: {},
+        allowsChildren: true,
+    },
+    conditional: {
+        type: 'conditional',
+        name: 'Conditional',
+        description: 'Conditionally render content',
+        props: {
+            condition: { type: 'expression', required: true, description: 'Condition expression' },
+        },
+        allowsChildren: true,
+    },
+    loop: {
+        type: 'loop',
+        name: 'Loop',
+        description: 'Iterate over items',
+        props: {
+            items: { type: 'expression', required: true, description: 'Items expression' },
+            as: { type: 'string', required: true, description: 'Item variable name' },
+            keyExpr: { type: 'expression', required: false, description: 'Key expression' },
+        },
+        allowsChildren: true,
+    },
+};
+// ============================================================
+// PRIMITIVE FACTORY FUNCTIONS
+// ============================================================
+/**
+ * Create a text node
+ */
+export function text(content, props) {
+    return createNode('text', { content, ...props });
+}
+/**
+ * Create a container node
+ */
+export function container(children, props) {
+    return createNode('container', props ? { ...props } : {}, children);
+}
+/**
+ * Create a button node
+ */
+export function button(label, props) {
+    return createNode('button', { label, ...props });
+}
+/**
+ * Create a heading node
+ */
+export function heading(level, content, props) {
+    return createNode('heading', { level, content, ...props });
+}
+/**
+ * Create a spacer node
+ */
+export function spacer(size, direction) {
+    return createNode('spacer', { size, direction });
+}
+/**
+ * Create a divider node
+ */
+export function divider(props) {
+    return createNode('divider', props ? { ...props } : {});
+}
+/**
+ * Check if a type is a known primitive
+ */
+export function isPrimitive(type) {
+    return type in PRIMITIVE_DEFINITIONS;
+}
+/**
+ * Get primitive definition
+ */
+export function getPrimitiveDefinition(type) {
+    return PRIMITIVE_DEFINITIONS[type];
+}
+//# sourceMappingURL=primitives.js.map

package/dist/surface/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../src/surface/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AA8JvC;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA+C;IAC/E,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,sBAAsB;QACnC,KAAK,EAAE;YACL,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,yBAAyB,EAAE;YACnF,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,cAAc;gBAC3B,KAAK,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;gBACnC,YAAY,EAAE,MAAM;aACrB;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,aAAa;gBAC1B,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC;gBACnC,YAAY,EAAE,QAAQ;aACvB;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,wBAAwB;gBACrC,YAAY,EAAE,KAAK;aACpB;SACF;QACD,cAAc,EAAE,KAAK;KACtB;IAED,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,qCAAqC;QAClD,KAAK,EAAE;YACL,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,gBAAgB;gBAC7B,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;gBACxB,YAAY,EAAE,QAAQ;aACvB;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,aAAa;gBAC1B,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC;aAC7C;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,iBAAiB;gBAC9B,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC;aACvD;YACD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE;YAC7E,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE;YAC9E,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,EAAE;SAC9F;QACD,cAAc,EAAE,IAAI;KACrB;IAED,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,4BAA4B;QACzC,KAAK,EAAE;YACL,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE;YACtE,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,sBAAsB;gBACnC,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC;gBAClD,YAAY,EAAE,SAAS;aACxB;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,aAAa;gBAC1B,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;gBACzB,YAAY,EAAE,IAAI;aACnB;YACD,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE;YAC7E,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE;YAChF,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,0BAA0B,EAAE;SAC1F;QACD,cAAc,EAAE,KAAK;KACtB;IAED,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,kBAAkB;QAC/B,KAAK,EAAE;YACL,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE;YACnE,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,YAAY;gBACzB,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC;gBAC5D,YAAY,EAAE,MAAM;aACrB;YACD,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE;YACjF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE;YACxE,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE;YAC5E,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE;YAC/E,QAAQ,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,2BAA2B,EAAE;SAC5F;QACD,cAAc,EAAE,KAAK;KACtB;IAED,KAAK,EAAE;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,kBAAkB;QAC/B,KAAK,EAAE;YACL,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,kBAAkB,EAAE;YACxE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,4BAA4B,EAAE;YAClF,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE;YACtE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE;YACxE,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,kBAAkB;gBAC/B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;gBACxB,YAAY,EAAE,MAAM;aACrB;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,YAAY;gBACzB,KAAK,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC;aAC5C;SACF;QACD,cAAc,EAAE,KAAK;KACtB;IAED,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,iBAAiB;QAC9B,KAAK,EAAE;YACL,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,kBAAkB,EAAE;YACzE,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,aAAa;gBAC1B,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;aAC9C;YACD,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE;SAC3E;QACD,cAAc,EAAE,IAAI;KACrB;IAED,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,gBAAgB;QAC7B,KAAK,EAAE;YACL,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,WAAW;gBACxB,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;gBAC/B,YAAY,EAAE,WAAW;aAC1B;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,mBAAmB;gBAChC,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;aACvD;SACF;QACD,cAAc,EAAE,IAAI;KACrB;IAED,WAAW,EAAE;QACX,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,oBAAoB;QACjC,KAAK,EAAE,EAAE;QACT,cAAc,EAAE,IAAI;KACrB;IAED,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,iBAAiB;QAC9B,KAAK,EAAE;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,qBAAqB;gBAClC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;aAC1B;YACD,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE;SACzE;QACD,cAAc,EAAE,KAAK;KACtB;IAED,SAAS,EAAE;QACT,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,gBAAgB;QAC7B,KAAK,EAAE,EAAE;QACT,cAAc,EAAE,IAAI;KACrB;IAED,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,aAAa;QAC1B,KAAK,EAAE;YACL,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE;YACnE,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,iBAAiB;gBAC9B,KAAK,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC;gBACjC,YAAY,EAAE,UAAU;aACzB;SACF;QACD,cAAc,EAAE,KAAK;KACtB;IAED,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,kBAAkB;QAC/B,KAAK,EAAE;YACL,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,qBAAqB;gBAClC,KAAK,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC;gBACjC,YAAY,EAAE,YAAY;aAC3B;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,eAAe;gBAC5B,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC;gBACpC,YAAY,EAAE,OAAO;aACtB;SACF;QACD,cAAc,EAAE,KAAK;KACtB;IAED,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,kCAAkC;QAC/C,KAAK,EAAE;YACL,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE;SACnE;QACD,cAAc,EAAE,IAAI,EAAE,gCAAgC;KACvD;IAED,QAAQ,EAAE;QACR,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,yCAAyC;QACtD,KAAK,EAAE,EAAE;QACT,cAAc,EAAE,IAAI;KACrB;IAED,WAAW,EAAE;QACX,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,8BAA8B;QAC3C,KAAK,EAAE;YACL,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE;SACvF;QACD,cAAc,EAAE,IAAI;KACrB;IAED,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,oBAAoB;QACjC,KAAK,EAAE;YACL,KAAK,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,kBAAkB,EAAE;YAC9E,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE;YACzE,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE;SAChF;QACD,cAAc,EAAE,IAAI;KACrB;CACF,CAAA;AAED,+DAA+D;AAC/D,8BAA8B;AAC9B,+DAA+D;AAE/D;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,OAAe,EAAE,KAAkC;IACtE,OAAO,UAAU,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,QAA+B,EAAE,KAAsB;IAC/E,OAAO,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAa,EAAE,KAAkC;IACtE,OAAO,UAAU,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,KAA4B,EAC5B,OAAe,EACf,KAA+C;IAE/C,OAAO,UAAU,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC,CAAA;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,IAAqB,EAAE,SAAqC;IACjF,OAAO,UAAU,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAoB;IAC1C,OAAO,UAAU,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,IAAI,IAAI,qBAAqB,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAmB;IACxD,OAAO,qBAAqB,CAAC,IAAI,CAAC,CAAA;AACpC,CAAC","sourcesContent":["/**\n * Built-in Primitives\n *\n * Core primitive definitions for the runtime\n *\n * These are the built-in primitives that the runtime knows how to render.\n * Each primitive has a defined contract for its props.\n *\n * @module @pwfabric/runtime/surface/primitives\n */\n\nimport type { PrimitiveType, RenderNode, BaseNodeProps } from './types.js'\nimport { createNode } from './types.js'\n\n// ============================================================\n// PRIMITIVE DEFINITIONS\n// ============================================================\n\n/**\n * Text primitive props\n */\nexport interface TextProps extends BaseNodeProps {\n  readonly content: string\n  readonly variant?: 'body' | 'caption' | 'label'\n  readonly weight?: 'normal' | 'medium' | 'bold'\n  readonly truncate?: boolean\n}\n\n/**\n * Container primitive props\n */\nexport interface ContainerProps extends BaseNodeProps {\n  readonly direction?: 'row' | 'column'\n  readonly align?: 'start' | 'center' | 'end' | 'stretch'\n  readonly justify?: 'start' | 'center' | 'end' | 'between' | 'around'\n  readonly gap?: number | string\n  readonly padding?: number | string\n  readonly wrap?: boolean\n}\n\n/**\n * Button primitive props\n */\nexport interface ButtonProps extends BaseNodeProps {\n  readonly label: string\n  readonly variant?: 'primary' | 'secondary' | 'ghost' | 'danger'\n  readonly size?: 'sm' | 'md' | 'lg'\n  readonly disabled?: boolean\n  readonly loading?: boolean\n  readonly onClick?: string // Expression or capability reference\n}\n\n/**\n * Input primitive props\n */\nexport interface InputProps extends BaseNodeProps {\n  readonly name: string\n  readonly type?: 'text' | 'email' | 'password' | 'number' | 'tel' | 'url'\n  readonly placeholder?: string\n  readonly value?: string\n  readonly disabled?: boolean\n  readonly required?: boolean\n  readonly onChange?: string\n}\n\n/**\n * Image primitive props\n */\nexport interface ImageProps extends BaseNodeProps {\n  readonly src: string\n  readonly alt: string\n  readonly width?: number | string\n  readonly height?: number | string\n  readonly loading?: 'eager' | 'lazy'\n  readonly fit?: 'contain' | 'cover' | 'fill' | 'none'\n}\n\n/**\n * Link primitive props\n */\nexport interface LinkProps extends BaseNodeProps {\n  readonly href: string\n  readonly target?: '_self' | '_blank' | '_parent' | '_top'\n  readonly rel?: string\n}\n\n/**\n * List primitive props\n */\nexport interface ListProps extends BaseNodeProps {\n  readonly type?: 'ordered' | 'unordered'\n  readonly marker?: 'disc' | 'circle' | 'square' | 'decimal' | 'none'\n}\n\n/**\n * Heading primitive props\n */\nexport interface HeadingProps extends BaseNodeProps {\n  readonly level: 1 | 2 | 3 | 4 | 5 | 6\n  readonly content: string\n}\n\n/**\n * Spacer primitive props\n */\nexport interface SpacerProps extends BaseNodeProps {\n  readonly size: number | string\n  readonly direction?: 'horizontal' | 'vertical'\n}\n\n/**\n * Divider primitive props\n */\nexport interface DividerProps extends BaseNodeProps {\n  readonly orientation?: 'horizontal' | 'vertical'\n  readonly variant?: 'solid' | 'dashed' | 'dotted'\n}\n\n/**\n * Slot primitive props - placeholder for injected content\n */\nexport interface SlotProps extends BaseNodeProps {\n  readonly name: string\n  readonly fallback?: readonly RenderNode[]\n}\n\n/**\n * Conditional primitive props\n */\nexport interface ConditionalProps extends BaseNodeProps {\n  readonly condition: string // Expression\n  readonly then?: readonly RenderNode[]\n  readonly else?: readonly RenderNode[]\n}\n\n/**\n * Loop primitive props\n */\nexport interface LoopProps extends BaseNodeProps {\n  readonly items: string // Expression\n  readonly as: string\n  readonly keyExpr?: string\n}\n\n// ============================================================\n// PRIMITIVE REGISTRY\n// ============================================================\n\n/**\n * Primitive definition\n */\nexport interface PrimitiveDefinition {\n  readonly type: PrimitiveType\n  readonly name: string\n  readonly description: string\n  readonly props: Record<string, PropDefinition>\n  readonly allowsChildren: boolean\n}\n\n/**\n * Property definition\n */\nexport interface PropDefinition {\n  readonly type: 'string' | 'number' | 'boolean' | 'object' | 'array' | 'expression'\n  readonly required: boolean\n  readonly description: string\n  readonly defaultValue?: unknown\n  readonly oneOf?: readonly unknown[]\n}\n\n/**\n * Built-in primitive definitions\n */\nexport const PRIMITIVE_DEFINITIONS: Record<PrimitiveType, PrimitiveDefinition> = {\n  text: {\n    type: 'text',\n    name: 'Text',\n    description: 'Display text content',\n    props: {\n      content: { type: 'string', required: true, description: 'Text content to display' },\n      variant: {\n        type: 'string',\n        required: false,\n        description: 'Text variant',\n        oneOf: ['body', 'caption', 'label'],\n        defaultValue: 'body',\n      },\n      weight: {\n        type: 'string',\n        required: false,\n        description: 'Font weight',\n        oneOf: ['normal', 'medium', 'bold'],\n        defaultValue: 'normal',\n      },\n      truncate: {\n        type: 'boolean',\n        required: false,\n        description: 'Truncate with ellipsis',\n        defaultValue: false,\n      },\n    },\n    allowsChildren: false,\n  },\n\n  container: {\n    type: 'container',\n    name: 'Container',\n    description: 'Layout container for child elements',\n    props: {\n      direction: {\n        type: 'string',\n        required: false,\n        description: 'Flex direction',\n        oneOf: ['row', 'column'],\n        defaultValue: 'column',\n      },\n      align: {\n        type: 'string',\n        required: false,\n        description: 'Align items',\n        oneOf: ['start', 'center', 'end', 'stretch'],\n      },\n      justify: {\n        type: 'string',\n        required: false,\n        description: 'Justify content',\n        oneOf: ['start', 'center', 'end', 'between', 'around'],\n      },\n      gap: { type: 'string', required: false, description: 'Gap between children' },\n      padding: { type: 'string', required: false, description: 'Container padding' },\n      wrap: { type: 'boolean', required: false, description: 'Wrap children', defaultValue: false },\n    },\n    allowsChildren: true,\n  },\n\n  button: {\n    type: 'button',\n    name: 'Button',\n    description: 'Interactive button element',\n    props: {\n      label: { type: 'string', required: true, description: 'Button label' },\n      variant: {\n        type: 'string',\n        required: false,\n        description: 'Button style variant',\n        oneOf: ['primary', 'secondary', 'ghost', 'danger'],\n        defaultValue: 'primary',\n      },\n      size: {\n        type: 'string',\n        required: false,\n        description: 'Button size',\n        oneOf: ['sm', 'md', 'lg'],\n        defaultValue: 'md',\n      },\n      disabled: { type: 'boolean', required: false, description: 'Disable button' },\n      loading: { type: 'boolean', required: false, description: 'Show loading state' },\n      onClick: { type: 'expression', required: false, description: 'Click handler expression' },\n    },\n    allowsChildren: false,\n  },\n\n  input: {\n    type: 'input',\n    name: 'Input',\n    description: 'Text input field',\n    props: {\n      name: { type: 'string', required: true, description: 'Input name' },\n      type: {\n        type: 'string',\n        required: false,\n        description: 'Input type',\n        oneOf: ['text', 'email', 'password', 'number', 'tel', 'url'],\n        defaultValue: 'text',\n      },\n      placeholder: { type: 'string', required: false, description: 'Placeholder text' },\n      value: { type: 'string', required: false, description: 'Current value' },\n      disabled: { type: 'boolean', required: false, description: 'Disable input' },\n      required: { type: 'boolean', required: false, description: 'Mark as required' },\n      onChange: { type: 'expression', required: false, description: 'Change handler expression' },\n    },\n    allowsChildren: false,\n  },\n\n  image: {\n    type: 'image',\n    name: 'Image',\n    description: 'Display an image',\n    props: {\n      src: { type: 'string', required: true, description: 'Image source URL' },\n      alt: { type: 'string', required: true, description: 'Alt text for accessibility' },\n      width: { type: 'string', required: false, description: 'Image width' },\n      height: { type: 'string', required: false, description: 'Image height' },\n      loading: {\n        type: 'string',\n        required: false,\n        description: 'Loading strategy',\n        oneOf: ['eager', 'lazy'],\n        defaultValue: 'lazy',\n      },\n      fit: {\n        type: 'string',\n        required: false,\n        description: 'Object fit',\n        oneOf: ['contain', 'cover', 'fill', 'none'],\n      },\n    },\n    allowsChildren: false,\n  },\n\n  link: {\n    type: 'link',\n    name: 'Link',\n    description: 'Navigation link',\n    props: {\n      href: { type: 'string', required: true, description: 'Link destination' },\n      target: {\n        type: 'string',\n        required: false,\n        description: 'Link target',\n        oneOf: ['_self', '_blank', '_parent', '_top'],\n      },\n      rel: { type: 'string', required: false, description: 'Link relationship' },\n    },\n    allowsChildren: true,\n  },\n\n  list: {\n    type: 'list',\n    name: 'List',\n    description: 'List container',\n    props: {\n      type: {\n        type: 'string',\n        required: false,\n        description: 'List type',\n        oneOf: ['ordered', 'unordered'],\n        defaultValue: 'unordered',\n      },\n      marker: {\n        type: 'string',\n        required: false,\n        description: 'List marker style',\n        oneOf: ['disc', 'circle', 'square', 'decimal', 'none'],\n      },\n    },\n    allowsChildren: true,\n  },\n\n  'list-item': {\n    type: 'list-item',\n    name: 'List Item',\n    description: 'Item within a list',\n    props: {},\n    allowsChildren: true,\n  },\n\n  heading: {\n    type: 'heading',\n    name: 'Heading',\n    description: 'Section heading',\n    props: {\n      level: {\n        type: 'number',\n        required: true,\n        description: 'Heading level (1-6)',\n        oneOf: [1, 2, 3, 4, 5, 6],\n      },\n      content: { type: 'string', required: true, description: 'Heading text' },\n    },\n    allowsChildren: false,\n  },\n\n  paragraph: {\n    type: 'paragraph',\n    name: 'Paragraph',\n    description: 'Text paragraph',\n    props: {},\n    allowsChildren: true,\n  },\n\n  spacer: {\n    type: 'spacer',\n    name: 'Spacer',\n    description: 'Empty space',\n    props: {\n      size: { type: 'string', required: true, description: 'Space size' },\n      direction: {\n        type: 'string',\n        required: false,\n        description: 'Space direction',\n        oneOf: ['horizontal', 'vertical'],\n        defaultValue: 'vertical',\n      },\n    },\n    allowsChildren: false,\n  },\n\n  divider: {\n    type: 'divider',\n    name: 'Divider',\n    description: 'Visual separator',\n    props: {\n      orientation: {\n        type: 'string',\n        required: false,\n        description: 'Divider orientation',\n        oneOf: ['horizontal', 'vertical'],\n        defaultValue: 'horizontal',\n      },\n      variant: {\n        type: 'string',\n        required: false,\n        description: 'Divider style',\n        oneOf: ['solid', 'dashed', 'dotted'],\n        defaultValue: 'solid',\n      },\n    },\n    allowsChildren: false,\n  },\n\n  slot: {\n    type: 'slot',\n    name: 'Slot',\n    description: 'Named slot for content injection',\n    props: {\n      name: { type: 'string', required: true, description: 'Slot name' },\n    },\n    allowsChildren: true, // Children are fallback content\n  },\n\n  fragment: {\n    type: 'fragment',\n    name: 'Fragment',\n    description: 'Invisible wrapper for multiple children',\n    props: {},\n    allowsChildren: true,\n  },\n\n  conditional: {\n    type: 'conditional',\n    name: 'Conditional',\n    description: 'Conditionally render content',\n    props: {\n      condition: { type: 'expression', required: true, description: 'Condition expression' },\n    },\n    allowsChildren: true,\n  },\n\n  loop: {\n    type: 'loop',\n    name: 'Loop',\n    description: 'Iterate over items',\n    props: {\n      items: { type: 'expression', required: true, description: 'Items expression' },\n      as: { type: 'string', required: true, description: 'Item variable name' },\n      keyExpr: { type: 'expression', required: false, description: 'Key expression' },\n    },\n    allowsChildren: true,\n  },\n}\n\n// ============================================================\n// PRIMITIVE FACTORY FUNCTIONS\n// ============================================================\n\n/**\n * Create a text node\n */\nexport function text(content: string, props?: Omit<TextProps, 'content'>): RenderNode {\n  return createNode('text', { content, ...props })\n}\n\n/**\n * Create a container node\n */\nexport function container(children: readonly RenderNode[], props?: ContainerProps): RenderNode {\n  return createNode('container', props ? { ...props } : {}, children)\n}\n\n/**\n * Create a button node\n */\nexport function button(label: string, props?: Omit<ButtonProps, 'label'>): RenderNode {\n  return createNode('button', { label, ...props })\n}\n\n/**\n * Create a heading node\n */\nexport function heading(\n  level: 1 | 2 | 3 | 4 | 5 | 6,\n  content: string,\n  props?: Omit<HeadingProps, 'level' | 'content'>\n): RenderNode {\n  return createNode('heading', { level, content, ...props })\n}\n\n/**\n * Create a spacer node\n */\nexport function spacer(size: number | string, direction?: 'horizontal' | 'vertical'): RenderNode {\n  return createNode('spacer', { size, direction })\n}\n\n/**\n * Create a divider node\n */\nexport function divider(props?: DividerProps): RenderNode {\n  return createNode('divider', props ? { ...props } : {})\n}\n\n/**\n * Check if a type is a known primitive\n */\nexport function isPrimitive(type: string): type is PrimitiveType {\n  return type in PRIMITIVE_DEFINITIONS\n}\n\n/**\n * Get primitive definition\n */\nexport function getPrimitiveDefinition(type: PrimitiveType): PrimitiveDefinition | undefined {\n  return PRIMITIVE_DEFINITIONS[type]\n}\n"]}

package/dist/surface/renderer.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Surface Renderer
+ *
+ * Deterministic surface rendering engine
+ *
+ * The renderer takes an interpreted surface and produces a render tree.
+ * Rendering is deterministic: same input + context = same output.
+ *
+ * INVARIANTS:
+ * - Rendering is pure (no side effects)
+ * - Same input always produces same output
+ * - Render order is deterministic
+ * - All expressions are evaluated synchronously
+ *
+ * @module @pwfabric/runtime/surface/renderer
+ */
+import type { RenderNode, RenderContext, RenderResult, RenderOutput, RenderError, LayoutJSON } from './types.js';
+import { type LayoutResult } from './layout.js';
+import type { InterpretedSurface } from './interpreter.js';
+/**
+ * Surface renderer options
+ */
+export interface RenderOptions {
+    readonly data?: Record<string, unknown>;
+    readonly slots?: Record<string, readonly RenderNode[]>;
+    readonly strict?: boolean;
+}
+/**
+ * Surface renderer
+ */
+export interface SurfaceRenderer {
+    /**
+     * Render an interpreted surface
+     */
+    render(surface: InterpretedSurface, options?: RenderOptions): RenderResult;
+    /**
+     * Render a layout directly
+     */
+    renderLayout(layout: LayoutJSON, context: RenderContext): LayoutResult;
+}
+/**
+ * Deterministic surface renderer implementation
+ *
+ * This renderer guarantees:
+ * - Same input produces same output
+ * - No hidden state or side effects
+ * - Predictable ordering
+ */
+export declare class DeterministicRenderer implements SurfaceRenderer {
+    render(surface: InterpretedSurface, options?: RenderOptions): RenderResult;
+    renderLayout(layout: LayoutJSON, context: RenderContext): LayoutResult;
+}
+/**
+ * Create a new surface renderer
+ */
+export declare function createRenderer(): SurfaceRenderer;
+/**
+ * Render a surface to a render tree
+ */
+export declare function renderSurface(surface: InterpretedSurface, options?: RenderOptions): RenderResult;
+/**
+ * Check if a render result is successful
+ */
+export declare function isRenderSuccess(result: RenderResult): result is {
+    success: true;
+    output: RenderOutput;
+};
+/**
+ * Check if a render result is a failure
+ */
+export declare function isRenderError(result: RenderResult): result is {
+    success: false;
+    error: RenderError;
+};
+/**
+ * Serialize a render node to JSON
+ */
+export declare function serializeNode(node: RenderNode): object;
+/**
+ * Serialize render output to JSON
+ */
+export declare function serializeOutput(output: RenderOutput): object;
+/**
+ * Compute a hash of a render node for determinism verification
+ *
+ * Same input should always produce same hash
+ */
+export declare function hashNode(node: RenderNode): string;
+/**
+ * Verify determinism by rendering twice and comparing hashes
+ */
+export declare function verifyDeterminism(surface: InterpretedSurface, options?: RenderOptions): {
+    deterministic: boolean;
+    hash1: string;
+    hash2: string;
+};