prev-cli 0.24.19 → 0.25.0

package/dist/previews/components/cart-item/index.d.ts

@@ -0,0 +1,5 @@
+import { type Product } from '../../shared/data';
+export declare function CartItem({ product }: {
+    product: Product;
+}): import("react/jsx-runtime").JSX.Element;
+export default function CartItemDemo(): import("react/jsx-runtime").JSX.Element;

package/dist/previews/components/price-tag/index.d.ts

@@ -0,0 +1,6 @@
+export declare function PriceTag({ amount, original, size, }: {
+    amount: number;
+    original?: number;
+    size?: 'sm' | 'md' | 'lg';
+}): import("react/jsx-runtime").JSX.Element;
+export default function PriceTagDemo(): import("react/jsx-runtime").JSX.Element;

package/dist/previews/screens/cart/empty.d.ts

@@ -0,0 +1 @@
+export default function CartEmpty(): import("react/jsx-runtime").JSX.Element;

package/dist/previews/screens/cart/index.d.ts

@@ -0,0 +1 @@
+export default function Cart(): import("react/jsx-runtime").JSX.Element;

package/dist/previews/screens/payment/error.d.ts

@@ -0,0 +1 @@
+export default function PaymentError(): import("react/jsx-runtime").JSX.Element;

package/dist/previews/screens/payment/index.d.ts

@@ -0,0 +1 @@
+export default function PaymentForm(): import("react/jsx-runtime").JSX.Element;

package/dist/previews/screens/payment/processing.d.ts

@@ -0,0 +1 @@
+export default function PaymentProcessing(): import("react/jsx-runtime").JSX.Element;

package/dist/previews/screens/receipt/index.d.ts

@@ -0,0 +1 @@
+export default function Receipt(): import("react/jsx-runtime").JSX.Element;

package/dist/previews/shared/data.d.ts

@@ -0,0 +1,30 @@
+export declare const brand: {
+    readonly name: "Luminary";
+    readonly tagline: "Curated essentials, delivered.";
+};
+export declare const colors: {
+    readonly primary: "#1a1a2e";
+    readonly accent: "#e94560";
+    readonly success: "#10b981";
+    readonly error: "#ef4444";
+    readonly warning: "#f59e0b";
+    readonly muted: "#6b7280";
+    readonly border: "#e5e7eb";
+    readonly surface: "#f9fafb";
+    readonly white: "#ffffff";
+};
+export interface Product {
+    id: string;
+    name: string;
+    description: string;
+    price: number;
+    quantity: number;
+    image: string;
+}
+export declare const products: Product[];
+export declare const TAX_RATE = 0.0875;
+export declare function subtotal(items?: Product[]): number;
+export declare function tax(items?: Product[]): number;
+export declare function total(items?: Product[]): number;
+export declare function formatPrice(amount: number): string;
+export declare const orderNumber = "LMN-2026-48291";

package/dist/src/content/config-parser.d.ts

@@ -0,0 +1,30 @@
+import { type PreviewConfig, type PreviewType, type FlowDefinition, type FlowConfig } from './preview-types';
+export interface ParseOptions {
+    /** Inject id from folder name if not present */
+    injectId?: boolean;
+    /** Inject kind from directory type if not present */
+    injectKind?: boolean;
+    /** The preview type (for kind inference) */
+    previewType?: PreviewType;
+    /** The folder name (for id inference) */
+    folderName?: string;
+}
+export interface ParseResult<T> {
+    data: T | null;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Parse a config.yaml or config.yml file and validate against schema
+ */
+export declare function parsePreviewConfig(filePath: string, options?: ParseOptions): Promise<ParseResult<PreviewConfig>>;
+/**
+ * Parse a flow config from config.yaml (new format)
+ * Falls back to legacy index.yaml format for backwards compatibility
+ */
+export declare function parseFlowConfig(configPath: string, options?: ParseOptions): Promise<ParseResult<FlowConfig>>;
+/**
+ * Parse a flow index.yaml file (legacy format)
+ * @deprecated Use parseFlowConfig with config.yaml instead
+ */
+export declare function parseFlowDefinition(filePath: string): Promise<FlowDefinition | null>;

package/dist/src/content/flow-verifier.d.ts

@@ -0,0 +1,21 @@
+import type { FlowConfig } from './preview-types';
+export interface VerifyResult {
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Extract data-region names from TSX/JSX source code.
+ * Uses Bun.Transpiler to normalize JSX → JS, then regex to find region attributes.
+ */
+export declare function extractRegions(source: string): string[];
+/**
+ * Verify a flow config structurally:
+ * - Screen dirs exist
+ * - State files exist
+ * - Referenced regions exist in screen source
+ * - Goto targets reference valid step IDs
+ * - No duplicate step IDs
+ * - Warn on dead-end steps (no regions, not terminal)
+ * - Warn on orphan steps (unreachable from step[0])
+ */
+export declare function verifyFlow(config: FlowConfig, rootDir: string): VerifyResult;

package/dist/src/content/preview-types.d.ts

@@ -0,0 +1,288 @@
+import { z } from 'zod';
+export type PreviewType = 'component' | 'screen' | 'flow';
+export declare const componentConfigSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>>;
+    category: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        stable: "stable";
+        deprecated: "deprecated";
+    }>>;
+    schemaVersion: z.ZodOptional<z.ZodEnum<{
+        "1.0": "1.0";
+        "2.0": "2.0";
+    }>>;
+    order: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodOptional<z.ZodLiteral<"component">>;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnknown>;
+        enum: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    slots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const screenConfigSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>>;
+    category: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        stable: "stable";
+        deprecated: "deprecated";
+    }>>;
+    schemaVersion: z.ZodOptional<z.ZodEnum<{
+        "1.0": "1.0";
+        "2.0": "2.0";
+    }>>;
+    order: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodOptional<z.ZodLiteral<"screen">>;
+    states: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    layoutByRenderer: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
+}, z.core.$strip>;
+declare const regionGotoSchema: z.ZodObject<{
+    goto: z.ZodString;
+}, z.core.$strip>;
+declare const regionOutcomesSchema: z.ZodObject<{
+    outcomes: z.ZodRecord<z.ZodString, z.ZodObject<{
+        goto: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const regionSchema: z.ZodUnion<readonly [z.ZodObject<{
+    goto: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    outcomes: z.ZodRecord<z.ZodString, z.ZodObject<{
+        goto: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>]>;
+declare const flowStepSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    screen: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        ref: z.ZodString;
+        state: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>]>;
+    state: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+    trigger: z.ZodOptional<z.ZodString>;
+    highlight: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    regions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+        goto: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        outcomes: z.ZodRecord<z.ZodString, z.ZodObject<{
+            goto: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>]>>>;
+    terminal: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const flowConfigSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>>;
+    category: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        stable: "stable";
+        deprecated: "deprecated";
+    }>>;
+    schemaVersion: z.ZodOptional<z.ZodEnum<{
+        "1.0": "1.0";
+        "2.0": "2.0";
+    }>>;
+    order: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodOptional<z.ZodLiteral<"flow">>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        screen: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            ref: z.ZodString;
+            state: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>]>;
+        state: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+        trigger: z.ZodOptional<z.ZodString>;
+        highlight: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        regions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+            goto: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            outcomes: z.ZodRecord<z.ZodString, z.ZodObject<{
+                goto: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>]>>>;
+        terminal: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    transitions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        trigger: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const configSchema: z.ZodUnion<readonly [z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>>;
+    category: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        stable: "stable";
+        deprecated: "deprecated";
+    }>>;
+    schemaVersion: z.ZodOptional<z.ZodEnum<{
+        "1.0": "1.0";
+        "2.0": "2.0";
+    }>>;
+    order: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodOptional<z.ZodLiteral<"component">>;
+    props: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        type: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        default: z.ZodOptional<z.ZodUnknown>;
+        enum: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+    }, z.core.$strip>>>;
+    slots: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>>;
+    category: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        stable: "stable";
+        deprecated: "deprecated";
+    }>>;
+    schemaVersion: z.ZodOptional<z.ZodEnum<{
+        "1.0": "1.0";
+        "2.0": "2.0";
+    }>>;
+    order: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodOptional<z.ZodLiteral<"screen">>;
+    states: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    layoutByRenderer: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodUnknown>>>;
+}, z.core.$strip>, z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>>;
+    category: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        stable: "stable";
+        deprecated: "deprecated";
+    }>>;
+    schemaVersion: z.ZodOptional<z.ZodEnum<{
+        "1.0": "1.0";
+        "2.0": "2.0";
+    }>>;
+    order: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodOptional<z.ZodLiteral<"flow">>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        screen: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            ref: z.ZodString;
+            state: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>]>;
+        state: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+        trigger: z.ZodOptional<z.ZodString>;
+        highlight: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        regions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodObject<{
+            goto: z.ZodString;
+        }, z.core.$strip>, z.ZodObject<{
+            outcomes: z.ZodRecord<z.ZodString, z.ZodObject<{
+                goto: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>]>>>;
+        terminal: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    transitions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        trigger: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodOptional<z.ZodEnum<{
+        component: "component";
+        screen: "screen";
+        flow: "flow";
+    }>>;
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>>;
+    category: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        stable: "stable";
+        deprecated: "deprecated";
+    }>>;
+    schemaVersion: z.ZodOptional<z.ZodEnum<{
+        "1.0": "1.0";
+        "2.0": "2.0";
+    }>>;
+    order: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>]>;
+export type PreviewConfig = z.infer<typeof configSchema>;
+export type ComponentConfig = z.infer<typeof componentConfigSchema>;
+export type ScreenConfig = z.infer<typeof screenConfigSchema>;
+export type FlowConfig = z.infer<typeof flowConfigSchema>;
+export type RegionGoto = z.infer<typeof regionGotoSchema>;
+export type RegionOutcomes = z.infer<typeof regionOutcomesSchema>;
+export type Region = z.infer<typeof regionSchema>;
+export type FlowStep = z.infer<typeof flowStepSchema>;
+export interface PreviewUnit {
+    type: PreviewType;
+    name: string;
+    path: string;
+    route: string;
+    config: PreviewConfig | null;
+    files: {
+        index: string;
+        states?: string[];
+        schema?: string;
+        docs?: string;
+    };
+}
+export interface LegacyFlowStep {
+    id?: string;
+    title?: string;
+    description?: string;
+    screen: string;
+    state?: string;
+    note?: string;
+    trigger?: string;
+    highlight?: string[];
+}
+export interface FlowDefinition {
+    name: string;
+    description?: string;
+    steps: LegacyFlowStep[];
+}
+export {};

package/dist/{vite → src/content}/previews.d.ts

@@ -1,15 +1,5 @@
 import type { PreviewFile, PreviewConfig } from '../preview-runtime/types';
 import type { PreviewUnit } from './preview-types';
-export interface Preview {
-    name: string;
-    route: string;
-    htmlPath: string;
-}
-export interface PreviewWithFiles extends Preview {
-    files: PreviewFile[];
-    entry: string;
-}
-export declare function scanPreviews(rootDir: string): Promise<Preview[]>;
 /**
  * Scan all files in a preview directory for WASM bundling
  */
@@ -20,8 +10,10 @@ export declare function scanPreviewFiles(previewDir: string): Promise<PreviewFil
 export declare function detectEntry(files: PreviewFile[]): string;
 /**
  * Build a PreviewConfig for WASM runtime
+ * @param previewDir - Directory containing the preview files
+ * @param entryOverride - Optional entry file override (for building alternate states)
  */
-export declare function buildPreviewConfig(previewDir: string): Promise<PreviewConfig>;
+export declare function buildPreviewConfig(previewDir: string, entryOverride?: string): Promise<PreviewConfig>;
 /**
  * Scan previews with multi-type folder structure support
  * Supports: components/, screens/, flows/, atlas/

package/dist/{preview-runtime → src/preview-runtime}/build-optimized.d.ts

@@ -1,6 +1,8 @@
 import type { PreviewConfig } from './types';
 export interface OptimizedBuildOptions {
     vendorPath: string;
+    jsxPath?: string;
+    resolveDir?: string;
 }
 export interface OptimizedBuildResult {
     success: boolean;

package/dist/{preview-runtime → src/preview-runtime}/build.d.ts

@@ -5,6 +5,6 @@ export interface PreviewBuildResult {
 }
 /**
  * Build a preview into a standalone HTML file for production
- * Uses esbuild (native) to bundle at build time
+ * Uses Bun.build (native) to bundle at build time
  */
 export declare function buildPreviewHtml(config: PreviewConfig): Promise<PreviewBuildResult>;

package/dist/src/preview-runtime/region-bridge.d.ts

@@ -0,0 +1 @@
+export declare const REGION_BRIDGE_SCRIPT = "\n(function() {\n  // Click handler: delegate clicks on [data-region] elements\n  document.addEventListener('click', function(e) {\n    var el = e.target;\n    while (el && el !== document.body) {\n      if (el.getAttribute && el.getAttribute('data-region')) {\n        e.preventDefault();\n        e.stopPropagation();\n        window.parent.postMessage({\n          type: 'region-click',\n          region: el.getAttribute('data-region')\n        }, '*');\n        return;\n      }\n      el = el.parentElement;\n    }\n  }, true);\n\n  // Highlight handler: parent sends list of region names to highlight\n  window.addEventListener('message', function(e) {\n    if (!e.data || e.data.type !== 'highlight-regions') return;\n\n    // Remove existing highlights\n    var existing = document.querySelectorAll('[data-region-highlight]');\n    for (var i = 0; i < existing.length; i++) {\n      existing[i].removeAttribute('data-region-highlight');\n      existing[i].style.cursor = '';\n    }\n\n    var regions = e.data.regions || [];\n    if (regions.length === 0) {\n      // Report empty rects when cleared\n      window.parent.postMessage({ type: 'region-rects', rects: [] }, '*');\n      return;\n    }\n\n    for (var j = 0; j < regions.length; j++) {\n      var els = document.querySelectorAll('[data-region=\"' + regions[j] + '\"]');\n      for (var k = 0; k < els.length; k++) {\n        els[k].setAttribute('data-region-highlight', 'true');\n        els[k].style.cursor = 'pointer';\n      }\n    }\n\n    // Report bounding rects to parent\n    reportRegionRects();\n  });\n\n  // Measure and report region rects to parent\n  function reportRegionRects() {\n    var highlighted = document.querySelectorAll('[data-region-highlight]');\n    var rects = [];\n    for (var i = 0; i < highlighted.length; i++) {\n      var el = highlighted[i];\n      var rect = el.getBoundingClientRect();\n      rects.push({\n        name: el.getAttribute('data-region') || '',\n        x: rect.left,\n        y: rect.top,\n        width: rect.width,\n        height: rect.height\n      });\n    }\n    window.parent.postMessage({ type: 'region-rects', rects: rects }, '*');\n  }\n\n  // Debounced re-report on scroll/resize\n  var debounceTimer = null;\n  function debouncedReport() {\n    if (debounceTimer) clearTimeout(debounceTimer);\n    debounceTimer = setTimeout(function() {\n      var highlighted = document.querySelectorAll('[data-region-highlight]');\n      if (highlighted.length > 0) reportRegionRects();\n    }, 100);\n  }\n  window.addEventListener('scroll', debouncedReport, true);\n  window.addEventListener('resize', debouncedReport);\n\n  // Token override handler: parent sends CSS overrides to inject\n  window.addEventListener('message', function(e) {\n    if (!e.data || e.data.type !== 'token-overrides') return;\n    var styleId = 'prev-token-overrides';\n    var existing = document.getElementById(styleId);\n    if (e.data.css) {\n      if (!existing) {\n        existing = document.createElement('style');\n        existing.id = styleId;\n        document.head.appendChild(existing);\n      }\n      existing.textContent = e.data.css;\n    } else if (existing) {\n      existing.remove();\n    }\n  });\n})();\n";

package/dist/{preview-runtime → src/preview-runtime}/types.d.ts

@@ -29,4 +29,22 @@ export type PreviewMessage = {
 } | {
     type: 'error';
     error: string;
+} | {
+    type: 'region-click';
+    region: string;
+} | {
+    type: 'highlight-regions';
+    regions: string[];
+} | {
+    type: 'region-rects';
+    rects: Array<{
+        name: string;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+} | {
+    type: 'token-overrides';
+    css: string;
 };

package/dist/src/preview-runtime/vendors.d.ts

@@ -0,0 +1,11 @@
+export interface VendorBundleResult {
+    success: boolean;
+    code: string;
+    error?: string;
+}
+export declare function buildVendorBundle(): Promise<VendorBundleResult>;
+/**
+ * Build @prev/jsx bundle for static preview builds
+ * React is externalized, so temp dir location doesn't matter for resolution
+ */
+export declare function buildJsxBundle(vendorPath: string): Promise<VendorBundleResult>;

package/dist/{renderers → src/renderers}/index.d.ts

@@ -1,5 +1,5 @@
 export { registerAdapter, getAdapter, listAdapters, getAllAdapters, isValidRendererKey, getLayoutSchema, clearAdapters, initializeAdapters, validateRendererKeys, } from './registry';
 export { renderPreview, renderPreviews, selectAdapter, ensureAdaptersInitialized, supportsHMR, type RenderOptions, type RenderResult, } from './render';
-export type { RendererAdapter, RenderOutput, DevServer, PreviewKind, PreviewRef, BaseConfig, ComponentConfig, ScreenConfig, FlowConfig, AtlasConfig, PreviewConfig, FlowStep, FlowTransition, AtlasNode, AtlasRelationship, } from './types';
+export type { RendererAdapter, RenderOutput, DevServer, PreviewKind, PreviewRef, BaseConfig, ComponentConfig, ScreenConfig, FlowConfig, PreviewConfig, FlowStep, FlowTransition, } from './types';
 export { ReactAdapter } from './react';
 export { HTMLAdapter } from './html';

package/dist/{renderers → src/renderers}/types.d.ts

@@ -2,7 +2,7 @@ import type { JSONSchema7 } from 'json-schema';
 /**
  * Preview type discriminator
  */
-export type PreviewKind = 'component' | 'screen' | 'flow' | 'atlas';
+export type PreviewKind = 'component' | 'screen' | 'flow';
 /**
  * Reference to another preview unit
  */
@@ -97,34 +97,10 @@ export interface FlowConfig extends BaseConfig {
     steps: FlowStep[];
     transitions?: FlowTransition[];
 }
-/**
- * Atlas node definition
- */
-export interface AtlasNode {
-    id: string;
-    title: string;
-    ref?: PreviewRef;
-}
-/**
- * Atlas relationship definition
- */
-export interface AtlasRelationship {
-    from: string;
-    to: string;
-    type: string;
-}
-/**
- * Atlas config - defines information architecture
- */
-export interface AtlasConfig extends BaseConfig {
-    kind: 'atlas';
-    nodes: AtlasNode[];
-    relationships?: AtlasRelationship[];
-}
 /**
  * Union of all config types
  */
-export type PreviewConfig = ComponentConfig | ScreenConfig | FlowConfig | AtlasConfig;
+export type PreviewConfig = ComponentConfig | ScreenConfig | FlowConfig;
 /**
  * Output from rendering a preview
  */
@@ -148,7 +124,7 @@ export interface DevServer {
  * Renderer adapter interface - implementations for React, HTML, Solid, etc.
  *
  * The adapter interface is intentionally thin. Bundling, asset management,
- * and hydration are handled by the build system (Vite/esbuild), not the adapter.
+ * and hydration are handled by the build system (Bun.build), not the adapter.
  */
 export interface RendererAdapter {
     /**
@@ -173,10 +149,6 @@ export interface RendererAdapter {
      * Render the current step's screen with navigation UI (prev/next)
      */
     renderFlow(config: FlowConfig, step?: string): RenderOutput;
-    /**
-     * Render a graph visualization with node thumbnails
-     */
-    renderAtlas(config: AtlasConfig): RenderOutput;
     /**
      * Whether this adapter supports Hot Module Replacement
      */

package/dist/src/server/build.d.ts

@@ -0,0 +1,6 @@
+export interface BuildOptions {
+    rootDir: string;
+    include?: string[];
+    base?: string;
+}
+export declare function buildProductionSite(options: BuildOptions): Promise<void>;

package/dist/src/server/dev.d.ts

@@ -0,0 +1,13 @@
+import type { PrevConfig } from '../config';
+export interface DevServerOptions {
+    rootDir: string;
+    port: number;
+    include?: string[];
+    config?: PrevConfig;
+}
+export declare function startDevServer(options: DevServerOptions): Promise<{
+    server: Bun.Server<undefined>;
+    port: number | undefined;
+    url: string;
+    stop: () => void;
+}>;

package/dist/src/server/plugins/aliases.d.ts

@@ -0,0 +1,5 @@
+import type { BunPlugin } from 'bun';
+export interface AliasesOptions {
+    cliRoot: string;
+}
+export declare function aliasesPlugin(options: AliasesOptions): BunPlugin;

package/dist/src/server/plugins/mdx.d.ts

@@ -0,0 +1,5 @@
+import type { BunPlugin } from 'bun';
+export interface MdxPluginOptions {
+    rootDir: string;
+}
+export declare function mdxPlugin(options: MdxPluginOptions): BunPlugin;

package/dist/src/server/plugins/virtual-modules.d.ts

@@ -0,0 +1,8 @@
+import type { BunPlugin } from 'bun';
+import { type PrevConfig } from '../../config';
+export interface VirtualModulesOptions {
+    rootDir: string;
+    include?: string[];
+    config?: PrevConfig;
+}
+export declare function virtualModulesPlugin(options: VirtualModulesOptions): BunPlugin;

package/dist/src/server/preview.d.ts

@@ -0,0 +1,10 @@
+export interface PreviewServerOptions {
+    rootDir: string;
+    port: number;
+}
+export declare function startPreviewServer(options: PreviewServerOptions): Promise<{
+    server: Bun.Server<undefined>;
+    port: number | undefined;
+    url: string;
+    stop: () => Promise<void>;
+}>;

package/dist/src/server/routes/component-bundle.d.ts

@@ -0,0 +1 @@
+export declare function createComponentBundleHandler(rootDir: string): (req: Request) => Promise<Response | null>;

package/dist/src/server/routes/jsx-bundle.d.ts

@@ -0,0 +1,3 @@
+export declare function createJsxBundleHandler(cliRoot: string): (req: Request) => Promise<Response | null>;
+/** Invalidate the JSX bundle cache */
+export declare function invalidateJsxCache(handler: ReturnType<typeof createJsxBundleHandler>): void;

package/dist/src/server/routes/og-image.d.ts

@@ -0,0 +1,15 @@
+export declare function generateOgImage(opts: {
+    title: string;
+    type: string;
+    state?: string;
+    step?: string;
+    description?: string;
+}): string;
+export declare function handleOgImageRequest(req: Request, previewUnits: Array<{
+    name: string;
+    type: string;
+    config?: {
+        title?: string;
+        description?: string;
+    } | null;
+}>): Response | null;

package/dist/src/server/routes/preview-bundle.d.ts

@@ -0,0 +1 @@
+export declare function createPreviewBundleHandler(rootDir: string): (req: Request) => Promise<Response | null>;

package/dist/src/server/routes/preview-config.d.ts

@@ -0,0 +1 @@
+export declare function createPreviewConfigHandler(rootDir: string): (req: Request) => Promise<Response | null>;