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

package/dist/surface/layout.js

@@ -0,0 +1,288 @@
+/**
+ * Layout System
+ *
+ * Slot and layout resolution for surfaces
+ *
+ * The layout system handles:
+ * - Slot resolution (named slots with fallback content)
+ * - Layout composition (nesting surfaces)
+ * - Conditional rendering
+ * - Loop expansion
+ *
+ * @module @pwfabric/runtime/surface/layout
+ */
+import { createNode, createChildContext } from './types.js';
+import { evaluate, createExpressionContext, } from './expression.js';
+import { isPrimitive } from './primitives.js';
+/**
+ * Resolve a layout definition into render nodes
+ */
+export function resolveLayout(layout, context) {
+    const exprContext = createExpressionContext(context.data);
+    return resolveLayoutNode(layout, context, exprContext);
+}
+/**
+ * Resolve a single layout node
+ */
+function resolveLayoutNode(layout, context, exprContext) {
+    // Handle conditional rendering
+    if (layout.if) {
+        const condResult = evaluate(layout.if, exprContext);
+        if (!condResult.success) {
+            return { success: false, error: `Condition error: ${condResult.error}` };
+        }
+        if (!condResult.value) {
+            // Condition is false, render nothing
+            return { success: true, nodes: [] };
+        }
+    }
+    // Handle loop expansion
+    if (layout.each) {
+        return resolveLoop(layout, context, exprContext);
+    }
+    // Handle slot
+    if (layout.slot) {
+        return resolveSlot(layout, context, exprContext);
+    }
+    // Handle primitive or custom component
+    return resolvePrimitive(layout, context, exprContext);
+}
+/**
+ * Resolve a loop layout into multiple nodes
+ */
+function resolveLoop(layout, context, exprContext) {
+    const { each } = layout;
+    if (!each) {
+        return { success: false, error: 'Loop layout missing each config' };
+    }
+    const itemsResult = evaluate(each.items, exprContext);
+    if (!itemsResult.success) {
+        return { success: false, error: `Loop items error: ${itemsResult.error}` };
+    }
+    const items = itemsResult.value;
+    if (!Array.isArray(items)) {
+        return { success: false, error: `Loop items must be an array, got ${typeof items}` };
+    }
+    const nodes = [];
+    for (let index = 0; index < items.length; index++) {
+        const item = items[index];
+        // Create child context with loop variables
+        const loopData = {
+            [each.as]: item,
+            [`${each.as}Index`]: index,
+            [`${each.as}First`]: index === 0,
+            [`${each.as}Last`]: index === items.length - 1,
+        };
+        const childContext = createChildContext(context, loopData);
+        const childExprContext = createExpressionContext({ ...exprContext.data, ...loopData });
+        // Generate key
+        let key;
+        if (each.key) {
+            const keyResult = evaluate(each.key, childExprContext);
+            key = keyResult.success ? String(keyResult.value) : `loop-${index}`;
+        }
+        else {
+            key = `loop-${index}`;
+        }
+        // Resolve children for this iteration
+        if (layout.children) {
+            for (const child of layout.children) {
+                const childResult = resolveLayoutNode(child, childContext, childExprContext);
+                if (!childResult.success) {
+                    return childResult;
+                }
+                // Add key to each child
+                for (const node of childResult.nodes) {
+                    nodes.push(createNode(node.type, { ...node.props, key }, node.children));
+                }
+            }
+        }
+    }
+    return { success: true, nodes };
+}
+/**
+ * Resolve a slot layout
+ */
+function resolveSlot(layout, context, exprContext) {
+    const slotName = layout.slot;
+    if (!slotName) {
+        return { success: false, error: 'Slot layout missing slot name' };
+    }
+    const slotContent = context.slots.get(slotName);
+    if (slotContent && slotContent.length > 0) {
+        // Slot has content, use it
+        return { success: true, nodes: slotContent };
+    }
+    // No slot content, use fallback (children)
+    if (layout.children) {
+        const nodes = [];
+        for (const child of layout.children) {
+            const childResult = resolveLayoutNode(child, context, exprContext);
+            if (!childResult.success) {
+                return childResult;
+            }
+            nodes.push(...childResult.nodes);
+        }
+        return { success: true, nodes };
+    }
+    // No fallback either
+    return { success: true, nodes: [] };
+}
+/**
+ * Resolve a primitive or custom component
+ */
+function resolvePrimitive(layout, context, exprContext) {
+    const { type, props = {}, children = [] } = layout;
+    // Resolve props (evaluate expressions in prop values)
+    const resolvedProps = {};
+    for (const [key, value] of Object.entries(props)) {
+        if (typeof value === 'string' && value.startsWith('{{') && value.endsWith('}}')) {
+            // Expression prop
+            const expr = value.slice(2, -2).trim();
+            const result = evaluate(expr, exprContext);
+            if (!result.success) {
+                return { success: false, error: `Prop ${key} expression error: ${result.error}` };
+            }
+            resolvedProps[key] = result.value;
+        }
+        else if (typeof value === 'string' && value.includes('{{')) {
+            // Template string with interpolation
+            const result = interpolateString(value, exprContext);
+            if (!result.success) {
+                return { success: false, error: `Prop ${key} interpolation error: ${result.error}` };
+            }
+            resolvedProps[key] = result.value;
+        }
+        else {
+            resolvedProps[key] = value;
+        }
+    }
+    // Resolve children recursively
+    const resolvedChildren = [];
+    for (const child of children) {
+        const childResult = resolveLayoutNode(child, context, exprContext);
+        if (!childResult.success) {
+            return childResult;
+        }
+        resolvedChildren.push(...childResult.nodes);
+    }
+    // Validate primitive type
+    if (!isPrimitive(type) && !type.includes(':')) {
+        // Unknown type - could be a custom component, let it pass
+    }
+    const node = createNode(type, resolvedProps, resolvedChildren);
+    return { success: true, nodes: [node] };
+}
+/**
+ * Interpolate a string with expressions
+ */
+function interpolateString(template, exprContext) {
+    const pattern = /\{\{(.+?)\}\}/g;
+    let result = template;
+    let match;
+    // Need to reset lastIndex since we're using the regex multiple times
+    pattern.lastIndex = 0;
+    const replacements = [];
+    while ((match = pattern.exec(template)) !== null) {
+        const placeholder = match[0];
+        const expression = match[1];
+        if (!expression)
+            continue;
+        const evalResult = evaluate(expression.trim(), exprContext);
+        if (!evalResult.success) {
+            return { success: false, error: evalResult.error };
+        }
+        replacements.push({ from: placeholder, to: String(evalResult.value ?? '') });
+    }
+    for (const { from, to } of replacements) {
+        result = result.replace(from, to);
+    }
+    return { success: true, value: result };
+}
+// ============================================================
+// SLOT MANAGEMENT
+// ============================================================
+/**
+ * Create a slot map from slot content
+ */
+export function createSlotMap(slots) {
+    return new Map(Object.entries(slots));
+}
+/**
+ * Extract slots from children based on slot attribute
+ */
+export function extractSlots(children) {
+    const defaultSlot = [];
+    const namedSlots = new Map();
+    for (const child of children) {
+        const slotName = child.props.slot;
+        if (slotName) {
+            const existing = namedSlots.get(slotName) ?? [];
+            existing.push(child);
+            namedSlots.set(slotName, existing);
+        }
+        else {
+            defaultSlot.push(child);
+        }
+    }
+    return { default: defaultSlot, named: namedSlots };
+}
+// ============================================================
+// LAYOUT COMPOSITION
+// ============================================================
+/**
+ * Compose multiple layouts into one
+ */
+export function composeLayouts(layouts, context) {
+    const nodes = [];
+    for (const layout of layouts) {
+        const result = resolveLayout(layout, context);
+        if (!result.success) {
+            return result;
+        }
+        nodes.push(...result.nodes);
+    }
+    return { success: true, nodes };
+}
+/**
+ * Wrap nodes in a container
+ */
+export function wrapInContainer(nodes, props) {
+    return createNode('container', props ?? {}, nodes);
+}
+// ============================================================
+// LAYOUT VALIDATION
+// ============================================================
+/**
+ * Validate a layout definition
+ */
+export function validateLayout(layout) {
+    const errors = [];
+    // Must have a type
+    if (!layout.type) {
+        errors.push('Layout must have a type');
+    }
+    // Validate each config
+    if (layout.each) {
+        if (!layout.each.items) {
+            errors.push('Loop layout must have items expression');
+        }
+        if (!layout.each.as) {
+            errors.push('Loop layout must have as variable name');
+        }
+    }
+    // Validate children recursively
+    if (layout.children) {
+        for (let i = 0; i < layout.children.length; i++) {
+            const child = layout.children[i];
+            if (!child)
+                continue;
+            const childResult = validateLayout(child);
+            if (!childResult.valid) {
+                errors.push(...childResult.errors.map((e) => `children[${i}]: ${e}`));
+            }
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=layout.js.map

package/dist/surface/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/surface/layout.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Layout System\n *\n * Slot and layout resolution for surfaces\n *\n * The layout system handles:\n * - Slot resolution (named slots with fallback content)\n * - Layout composition (nesting surfaces)\n * - Conditional rendering\n * - Loop expansion\n *\n * @module @pwfabric/runtime/surface/layout\n */\n\nimport type { RenderNode, RenderContext, LayoutJSON } from './types.js'\nimport { createNode, createChildContext } from './types.js'\nimport {\n  evaluate,\n  createExpressionContext,\n  type ExpressionContext,\n  type ExpressionResult,\n} from './expression.js'\nimport { isPrimitive } from './primitives.js'\n\n// ============================================================\n// LAYOUT RESOLUTION\n// ============================================================\n\n/**\n * Layout resolution result\n */\nexport type LayoutResult =\n  | { readonly success: true; readonly nodes: readonly RenderNode[] }\n  | { readonly success: false; readonly error: string }\n\n/**\n * Resolve a layout definition into render nodes\n */\nexport function resolveLayout(layout: LayoutJSON, context: RenderContext): LayoutResult {\n  const exprContext = createExpressionContext(context.data)\n\n  return resolveLayoutNode(layout, context, exprContext)\n}\n\n/**\n * Resolve a single layout node\n */\nfunction resolveLayoutNode(\n  layout: LayoutJSON,\n  context: RenderContext,\n  exprContext: ExpressionContext\n): LayoutResult {\n  // Handle conditional rendering\n  if (layout.if) {\n    const condResult = evaluate(layout.if, exprContext)\n    if (!condResult.success) {\n      return { success: false, error: `Condition error: ${condResult.error}` }\n    }\n    if (!condResult.value) {\n      // Condition is false, render nothing\n      return { success: true, nodes: [] }\n    }\n  }\n\n  // Handle loop expansion\n  if (layout.each) {\n    return resolveLoop(layout, context, exprContext)\n  }\n\n  // Handle slot\n  if (layout.slot) {\n    return resolveSlot(layout, context, exprContext)\n  }\n\n  // Handle primitive or custom component\n  return resolvePrimitive(layout, context, exprContext)\n}\n\n/**\n * Resolve a loop layout into multiple nodes\n */\nfunction resolveLoop(\n  layout: LayoutJSON,\n  context: RenderContext,\n  exprContext: ExpressionContext\n): LayoutResult {\n  const { each } = layout\n  if (!each) {\n    return { success: false, error: 'Loop layout missing each config' }\n  }\n\n  const itemsResult = evaluate(each.items, exprContext)\n  if (!itemsResult.success) {\n    return { success: false, error: `Loop items error: ${itemsResult.error}` }\n  }\n\n  const items = itemsResult.value\n  if (!Array.isArray(items)) {\n    return { success: false, error: `Loop items must be an array, got ${typeof items}` }\n  }\n\n  const nodes: RenderNode[] = []\n\n  for (let index = 0; index < items.length; index++) {\n    const item = items[index]\n\n    // Create child context with loop variables\n    const loopData: Record<string, unknown> = {\n      [each.as]: item,\n      [`${each.as}Index`]: index,\n      [`${each.as}First`]: index === 0,\n      [`${each.as}Last`]: index === items.length - 1,\n    }\n\n    const childContext = createChildContext(context, loopData)\n    const childExprContext = createExpressionContext({ ...exprContext.data, ...loopData })\n\n    // Generate key\n    let key: string\n    if (each.key) {\n      const keyResult = evaluate(each.key, childExprContext)\n      key = keyResult.success ? String(keyResult.value) : `loop-${index}`\n    } else {\n      key = `loop-${index}`\n    }\n\n    // Resolve children for this iteration\n    if (layout.children) {\n      for (const child of layout.children) {\n        const childResult = resolveLayoutNode(child, childContext, childExprContext)\n        if (!childResult.success) {\n          return childResult\n        }\n        // Add key to each child\n        for (const node of childResult.nodes) {\n          nodes.push(createNode(node.type, { ...node.props, key }, node.children))\n        }\n      }\n    }\n  }\n\n  return { success: true, nodes }\n}\n\n/**\n * Resolve a slot layout\n */\nfunction resolveSlot(\n  layout: LayoutJSON,\n  context: RenderContext,\n  exprContext: ExpressionContext\n): LayoutResult {\n  const slotName = layout.slot\n  if (!slotName) {\n    return { success: false, error: 'Slot layout missing slot name' }\n  }\n  const slotContent = context.slots.get(slotName)\n\n  if (slotContent && slotContent.length > 0) {\n    // Slot has content, use it\n    return { success: true, nodes: slotContent }\n  }\n\n  // No slot content, use fallback (children)\n  if (layout.children) {\n    const nodes: RenderNode[] = []\n    for (const child of layout.children) {\n      const childResult = resolveLayoutNode(child, context, exprContext)\n      if (!childResult.success) {\n        return childResult\n      }\n      nodes.push(...childResult.nodes)\n    }\n    return { success: true, nodes }\n  }\n\n  // No fallback either\n  return { success: true, nodes: [] }\n}\n\n/**\n * Resolve a primitive or custom component\n */\nfunction resolvePrimitive(\n  layout: LayoutJSON,\n  context: RenderContext,\n  exprContext: ExpressionContext\n): LayoutResult {\n  const { type, props = {}, children = [] } = layout\n\n  // Resolve props (evaluate expressions in prop values)\n  const resolvedProps: Record<string, unknown> = {}\n  for (const [key, value] of Object.entries(props)) {\n    if (typeof value === 'string' && value.startsWith('{{') && value.endsWith('}}')) {\n      // Expression prop\n      const expr = value.slice(2, -2).trim()\n      const result = evaluate(expr, exprContext)\n      if (!result.success) {\n        return { success: false, error: `Prop ${key} expression error: ${result.error}` }\n      }\n      resolvedProps[key] = result.value\n    } else if (typeof value === 'string' && value.includes('{{')) {\n      // Template string with interpolation\n      const result = interpolateString(value, exprContext)\n      if (!result.success) {\n        return { success: false, error: `Prop ${key} interpolation error: ${result.error}` }\n      }\n      resolvedProps[key] = result.value\n    } else {\n      resolvedProps[key] = value\n    }\n  }\n\n  // Resolve children recursively\n  const resolvedChildren: RenderNode[] = []\n  for (const child of children) {\n    const childResult = resolveLayoutNode(child, context, exprContext)\n    if (!childResult.success) {\n      return childResult\n    }\n    resolvedChildren.push(...childResult.nodes)\n  }\n\n  // Validate primitive type\n  if (!isPrimitive(type) && !type.includes(':')) {\n    // Unknown type - could be a custom component, let it pass\n  }\n\n  const node = createNode(type, resolvedProps, resolvedChildren)\n  return { success: true, nodes: [node] }\n}\n\n/**\n * Interpolate a string with expressions\n */\nfunction interpolateString(\n  template: string,\n  exprContext: ExpressionContext\n): ExpressionResult<string> {\n  const pattern = /\\{\\{(.+?)\\}\\}/g\n  let result = template\n  let match: RegExpExecArray | null\n\n  // Need to reset lastIndex since we're using the regex multiple times\n  pattern.lastIndex = 0\n\n  const replacements: { from: string; to: string }[] = []\n\n  while ((match = pattern.exec(template)) !== null) {\n    const placeholder = match[0]\n    const expression = match[1]\n    if (!expression) continue\n    const evalResult = evaluate(expression.trim(), exprContext)\n    if (!evalResult.success) {\n      return { success: false, error: evalResult.error }\n    }\n    replacements.push({ from: placeholder, to: String(evalResult.value ?? '') })\n  }\n\n  for (const { from, to } of replacements) {\n    result = result.replace(from, to)\n  }\n\n  return { success: true, value: result }\n}\n\n// ============================================================\n// SLOT MANAGEMENT\n// ============================================================\n\n/**\n * Create a slot map from slot content\n */\nexport function createSlotMap(\n  slots: Record<string, readonly RenderNode[]>\n): Map<string, readonly RenderNode[]> {\n  return new Map(Object.entries(slots))\n}\n\n/**\n * Extract slots from children based on slot attribute\n */\nexport function extractSlots(children: readonly RenderNode[]): {\n  default: readonly RenderNode[]\n  named: Map<string, readonly RenderNode[]>\n} {\n  const defaultSlot: RenderNode[] = []\n  const namedSlots = new Map<string, RenderNode[]>()\n\n  for (const child of children) {\n    const slotName = child.props.slot as string | undefined\n    if (slotName) {\n      const existing = namedSlots.get(slotName) ?? []\n      existing.push(child)\n      namedSlots.set(slotName, existing)\n    } else {\n      defaultSlot.push(child)\n    }\n  }\n\n  return { default: defaultSlot, named: namedSlots }\n}\n\n// ============================================================\n// LAYOUT COMPOSITION\n// ============================================================\n\n/**\n * Compose multiple layouts into one\n */\nexport function composeLayouts(\n  layouts: readonly LayoutJSON[],\n  context: RenderContext\n): LayoutResult {\n  const nodes: RenderNode[] = []\n\n  for (const layout of layouts) {\n    const result = resolveLayout(layout, context)\n    if (!result.success) {\n      return result\n    }\n    nodes.push(...result.nodes)\n  }\n\n  return { success: true, nodes }\n}\n\n/**\n * Wrap nodes in a container\n */\nexport function wrapInContainer(\n  nodes: readonly RenderNode[],\n  props?: Record<string, unknown>\n): RenderNode {\n  return createNode('container', props ?? {}, nodes)\n}\n\n// ============================================================\n// LAYOUT VALIDATION\n// ============================================================\n\n/**\n * Validate a layout definition\n */\nexport function validateLayout(layout: LayoutJSON): { valid: boolean; errors: string[] } {\n  const errors: string[] = []\n\n  // Must have a type\n  if (!layout.type) {\n    errors.push('Layout must have a type')\n  }\n\n  // Validate each config\n  if (layout.each) {\n    if (!layout.each.items) {\n      errors.push('Loop layout must have items expression')\n    }\n    if (!layout.each.as) {\n      errors.push('Loop layout must have as variable name')\n    }\n  }\n\n  // Validate children recursively\n  if (layout.children) {\n    for (let i = 0; i < layout.children.length; i++) {\n      const child = layout.children[i]\n      if (!child) continue\n      const childResult = validateLayout(child)\n      if (!childResult.valid) {\n        errors.push(...childResult.errors.map((e) => `children[${i}]: ${e}`))\n      }\n    }\n  }\n\n  return { valid: errors.length === 0, errors }\n}\n"]}

package/dist/surface/output.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Typed Output Factories
+ *
+ * Typed wrappers for BaseSurfaceOutput.data.
+ * These do NOT modify @pwfabric/contracts. They extend the contract types
+ * with narrowed data fields and provide factory functions that validate.
+ *
+ * @module @pwfabric/runtime/surface/output
+ */
+import type { WebSurfaceOutput, ApiSurfaceOutput, CliSurfaceOutput } from '@pwfabric/contracts';
+/**
+ * Web output with narrowed data type
+ */
+export interface TypedWebOutput extends WebSurfaceOutput {
+    readonly data: {
+        readonly html: string;
+        readonly css?: string;
+        readonly head?: string;
+    };
+}
+/**
+ * API output with narrowed data type
+ */
+export interface TypedApiOutput extends ApiSurfaceOutput {
+    readonly data: {
+        readonly json: unknown;
+        readonly status: number;
+    };
+}
+/**
+ * CLI output with narrowed data type
+ */
+export interface TypedCliOutput extends CliSurfaceOutput {
+    readonly data: {
+        readonly formatted: string;
+        readonly raw?: unknown;
+    };
+}
+/**
+ * Result of creating a typed output
+ */
+export type OutputFactoryResult<T> = {
+    readonly success: true;
+    readonly output: T;
+} | {
+    readonly success: false;
+    readonly errors: readonly string[];
+};
+/**
+ * Create a validated TypedWebOutput.
+ *
+ * Validates the data shape and returns a typed output or errors.
+ */
+export declare function createWebOutput(options: {
+    readonly data: {
+        readonly html: string;
+        readonly css?: string;
+        readonly head?: string;
+    };
+    readonly component?: unknown;
+    readonly html?: string;
+}): OutputFactoryResult<TypedWebOutput>;
+/**
+ * Create a validated TypedApiOutput.
+ *
+ * Validates the data shape and returns a typed output or errors.
+ */
+export declare function createApiOutput(options: {
+    readonly data: {
+        readonly json: unknown;
+        readonly status: number;
+    };
+    readonly status: number;
+    readonly headers?: Record<string, string>;
+    readonly body?: unknown;
+}): OutputFactoryResult<TypedApiOutput>;
+/**
+ * Create a validated TypedCliOutput.
+ *
+ * Validates the data shape and returns a typed output or errors.
+ */
+export declare function createCliOutput(options: {
+    readonly data: {
+        readonly formatted: string;
+        readonly raw?: unknown;
+    };
+    readonly exitCode: number;
+    readonly stdout?: string;
+    readonly stderr?: string;
+}): OutputFactoryResult<TypedCliOutput>;

package/dist/surface/output.js

@@ -0,0 +1,104 @@
+/**
+ * Typed Output Factories
+ *
+ * Typed wrappers for BaseSurfaceOutput.data.
+ * These do NOT modify @pwfabric/contracts. They extend the contract types
+ * with narrowed data fields and provide factory functions that validate.
+ *
+ * @module @pwfabric/runtime/surface/output
+ */
+import { z } from 'zod';
+// ============================================================
+// ZOD SCHEMAS
+// ============================================================
+const webOutputDataSchema = z.object({
+    html: z.string(),
+    css: z.string().optional(),
+    head: z.string().optional(),
+});
+const apiOutputDataSchema = z.object({
+    json: z.unknown(),
+    status: z.number().int().min(100).max(599),
+});
+const cliOutputDataSchema = z.object({
+    formatted: z.string(),
+    raw: z.unknown().optional(),
+});
+// ============================================================
+// FACTORY FUNCTIONS
+// ============================================================
+/**
+ * Create a validated TypedWebOutput.
+ *
+ * Validates the data shape and returns a typed output or errors.
+ */
+export function createWebOutput(options) {
+    const dataResult = webOutputDataSchema.safeParse(options.data);
+    if (!dataResult.success) {
+        return {
+            success: false,
+            errors: dataResult.error.issues.map((i) => `data.${i.path.join('.')}: ${i.message}`),
+        };
+    }
+    const data = {
+        html: dataResult.data.html,
+        ...(dataResult.data.css !== undefined ? { css: dataResult.data.css } : {}),
+        ...(dataResult.data.head !== undefined ? { head: dataResult.data.head } : {}),
+    };
+    const output = {
+        type: 'web',
+        data,
+        ...(options.component !== undefined ? { component: options.component } : {}),
+        ...(options.html !== undefined ? { html: options.html } : {}),
+    };
+    return { success: true, output };
+}
+/**
+ * Create a validated TypedApiOutput.
+ *
+ * Validates the data shape and returns a typed output or errors.
+ */
+export function createApiOutput(options) {
+    const dataResult = apiOutputDataSchema.safeParse(options.data);
+    if (!dataResult.success) {
+        return {
+            success: false,
+            errors: dataResult.error.issues.map((i) => `data.${i.path.join('.')}: ${i.message}`),
+        };
+    }
+    const data = {
+        json: dataResult.data.json,
+        status: dataResult.data.status,
+    };
+    const output = {
+        type: 'api',
+        data,
+        status: options.status,
+        body: options.body ?? null,
+        ...(options.headers ? { headers: options.headers } : {}),
+    };
+    return { success: true, output };
+}
+/**
+ * Create a validated TypedCliOutput.
+ *
+ * Validates the data shape and returns a typed output or errors.
+ */
+export function createCliOutput(options) {
+    const dataResult = cliOutputDataSchema.safeParse(options.data);
+    if (!dataResult.success) {
+        return {
+            success: false,
+            errors: dataResult.error.issues.map((i) => `data.${i.path.join('.')}: ${i.message}`),
+        };
+    }
+    const output = {
+        type: 'cli',
+        data: dataResult.data,
+        exitCode: options.exitCode,
+        ...(options.stdout !== undefined && { stdout: options.stdout }),
+        ...(options.stderr !== undefined && { stderr: options.stderr }),
+    };
+    return { success: true, output };
+}
+//# sourceMappingURL=output.js.map

package/dist/surface/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/surface/output.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Typed Output Factories\n *\n * Typed wrappers for BaseSurfaceOutput.data.\n * These do NOT modify @pwfabric/contracts. They extend the contract types\n * with narrowed data fields and provide factory functions that validate.\n *\n * @module @pwfabric/runtime/surface/output\n */\n\nimport { z } from 'zod'\nimport type { WebSurfaceOutput, ApiSurfaceOutput, CliSurfaceOutput } from '@pwfabric/contracts'\n\n// ============================================================\n// TYPED OUTPUT INTERFACES\n// ============================================================\n\n/**\n * Web output with narrowed data type\n */\nexport interface TypedWebOutput extends WebSurfaceOutput {\n  readonly data: {\n    readonly html: string\n    readonly css?: string\n    readonly head?: string\n  }\n}\n\n/**\n * API output with narrowed data type\n */\nexport interface TypedApiOutput extends ApiSurfaceOutput {\n  readonly data: {\n    readonly json: unknown\n    readonly status: number\n  }\n}\n\n/**\n * CLI output with narrowed data type\n */\nexport interface TypedCliOutput extends CliSurfaceOutput {\n  readonly data: {\n    readonly formatted: string\n    readonly raw?: unknown\n  }\n}\n\n// ============================================================\n// ZOD SCHEMAS\n// ============================================================\n\nconst webOutputDataSchema = z.object({\n  html: z.string(),\n  css: z.string().optional(),\n  head: z.string().optional(),\n})\n\nconst apiOutputDataSchema = z.object({\n  json: z.unknown(),\n  status: z.number().int().min(100).max(599),\n})\n\nconst cliOutputDataSchema = z.object({\n  formatted: z.string(),\n  raw: z.unknown().optional(),\n})\n\n// ============================================================\n// VALIDATION RESULT\n// ============================================================\n\n/**\n * Result of creating a typed output\n */\nexport type OutputFactoryResult<T> =\n  | { readonly success: true; readonly output: T }\n  | { readonly success: false; readonly errors: readonly string[] }\n\n// ============================================================\n// FACTORY FUNCTIONS\n// ============================================================\n\n/**\n * Create a validated TypedWebOutput.\n *\n * Validates the data shape and returns a typed output or errors.\n */\nexport function createWebOutput(options: {\n  readonly data: { readonly html: string; readonly css?: string; readonly head?: string }\n  readonly component?: unknown\n  readonly html?: string\n}): OutputFactoryResult<TypedWebOutput> {\n  const dataResult = webOutputDataSchema.safeParse(options.data)\n\n  if (!dataResult.success) {\n    return {\n      success: false,\n      errors: dataResult.error.issues.map((i) => `data.${i.path.join('.')}: ${i.message}`),\n    }\n  }\n\n  const data: TypedWebOutput['data'] = {\n    html: dataResult.data.html,\n    ...(dataResult.data.css !== undefined ? { css: dataResult.data.css } : {}),\n    ...(dataResult.data.head !== undefined ? { head: dataResult.data.head } : {}),\n  }\n\n  const output: TypedWebOutput = {\n    type: 'web',\n    data,\n    ...(options.component !== undefined ? { component: options.component } : {}),\n    ...(options.html !== undefined ? { html: options.html } : {}),\n  }\n\n  return { success: true, output }\n}\n\n/**\n * Create a validated TypedApiOutput.\n *\n * Validates the data shape and returns a typed output or errors.\n */\nexport function createApiOutput(options: {\n  readonly data: { readonly json: unknown; readonly status: number }\n  readonly status: number\n  readonly headers?: Record<string, string>\n  readonly body?: unknown\n}): OutputFactoryResult<TypedApiOutput> {\n  const dataResult = apiOutputDataSchema.safeParse(options.data)\n\n  if (!dataResult.success) {\n    return {\n      success: false,\n      errors: dataResult.error.issues.map((i) => `data.${i.path.join('.')}: ${i.message}`),\n    }\n  }\n\n  const data: TypedApiOutput['data'] = {\n    json: dataResult.data.json,\n    status: dataResult.data.status,\n  }\n\n  const output: TypedApiOutput = {\n    type: 'api',\n    data,\n    status: options.status,\n    body: options.body ?? null,\n    ...(options.headers ? { headers: options.headers } : {}),\n  }\n\n  return { success: true, output }\n}\n\n/**\n * Create a validated TypedCliOutput.\n *\n * Validates the data shape and returns a typed output or errors.\n */\nexport function createCliOutput(options: {\n  readonly data: { readonly formatted: string; readonly raw?: unknown }\n  readonly exitCode: number\n  readonly stdout?: string\n  readonly stderr?: string\n}): OutputFactoryResult<TypedCliOutput> {\n  const dataResult = cliOutputDataSchema.safeParse(options.data)\n\n  if (!dataResult.success) {\n    return {\n      success: false,\n      errors: dataResult.error.issues.map((i) => `data.${i.path.join('.')}: ${i.message}`),\n    }\n  }\n\n  const output: TypedCliOutput = {\n    type: 'cli',\n    data: dataResult.data,\n    exitCode: options.exitCode,\n    ...(options.stdout !== undefined && { stdout: options.stdout }),\n    ...(options.stderr !== undefined && { stderr: options.stderr }),\n  }\n\n  return { success: true, output }\n}\n"]}