sunpeak 0.9.2 → 0.9.6

package/README.md

@@ -12,7 +12,7 @@
 [![npm downloads](https://img.shields.io/npm/dm/sunpeak.svg?style=flat-square)](https://www.npmjs.com/package/sunpeak)
 [![CI](https://img.shields.io/github/actions/workflow/status/Sunpeak-AI/sunpeak/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/Sunpeak-AI/sunpeak/actions)
 [![License](https://img.shields.io/npm/l/sunpeak.svg?style=flat-square)](https://github.com/Sunpeak-AI/sunpeak/blob/main/LICENSE)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.6-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue?style=flat-square&logo=typescript)](https://www.typescriptlang.org/)
 [![React](https://img.shields.io/badge/React-19-blue?style=flat-square&logo=react)](https://reactjs.org/)
 
 The ChatGPT App framework.
@@ -57,7 +57,7 @@ sunpeak is an npm package consisting of:
 2. **The `sunpeak` framework** (`./template`). Next.js for ChatGPT Apps. This templated npm package includes:
    1. Project scaffold - Complete development setup with build, test, and mcp tooling, including the sunpeak library.
    2. UI components - Production-ready components following ChatGPT design guidelines and using OpenAI apps-sdk-ui React components.
-   3. Convention over configuration - Create UIs (resources) by simply creating a `resources/NAME-resource.tsx` React file and `resources/NAME-resource.json` metadata file.
+   3. Convention over configuration - Create UIs (resources) by simply creating a `src/resources/NAME-resource.tsx` React file and `src/resources/NAME-resource.json` metadata file.
 3. **The `sunpeak` CLI** (`./bin`). Commands for managing ChatGPT Apps. Includes a client for the [sunpeak Resource Repository](https://app.sunpeak.ai/) (ECR for ChatGPT Apps). The repository helps you & your CI/CD decouple your App from your client-agnostic MCP server:
    1. Tag your app builds with version numbers and environment names (like `v1.0.0` and `prod`)
    2. `push` built Apps to a central location

package/dist/chatgpt/conversation.d.ts

@@ -1,12 +1,15 @@
 import { ScreenWidth } from './chatgpt-simulator-types';
 import * as React from 'react';
 interface ConversationProps {
-    children: React.ReactNode;
+    /** React content to render (mutually exclusive with iframeScriptSrc) */
+    children?: React.ReactNode;
+    /** URL to a built .js file to render in an iframe (mutually exclusive with children) */
+    iframeScriptSrc?: string;
     screenWidth: ScreenWidth;
     appName?: string;
     appIcon?: string;
     userMessage?: string;
     resourceMeta?: Record<string, unknown>;
 }
-export declare function Conversation({ children, screenWidth, appName, appIcon, userMessage, resourceMeta, }: ConversationProps): import("react/jsx-runtime").JSX.Element;
+export declare function Conversation({ children, iframeScriptSrc, screenWidth, appName, appIcon, userMessage, resourceMeta, }: ConversationProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/chatgpt/iframe-resource.d.ts

@@ -0,0 +1,69 @@
+import * as React from 'react';
+/**
+ * Escapes HTML special characters to prevent XSS via attribute injection.
+ */
+declare function escapeHtml(str: string): string;
+/**
+ * Validates that a script source URL is from an allowed origin.
+ * Allows same-origin scripts and scripts from whitelisted domains.
+ */
+declare function isAllowedScriptSrc(src: string): boolean;
+/**
+ * Generates a Content Security Policy string from CSP configuration.
+ * Creates a restrictive policy that only allows specified domains.
+ */
+declare function generateCSP(csp: WidgetCSP | undefined, scriptSrc: string): string;
+/**
+ * Content Security Policy configuration for iframe resources.
+ * Maps to the openai/widgetCSP field in resource JSON files.
+ */
+export interface WidgetCSP {
+    /** Domains allowed for fetch/XHR/WebSocket connections */
+    connect_domains?: string[];
+    /** Domains allowed for scripts, images, styles, fonts */
+    resource_domains?: string[];
+}
+interface IframeResourceProps {
+    /** URL to a built .js file to load in the iframe. The HTML wrapper is generated automatically. */
+    scriptSrc: string;
+    /** Optional className for the iframe container */
+    className?: string;
+    /** Optional style for the iframe */
+    style?: React.CSSProperties;
+    /** Optional Content Security Policy configuration */
+    csp?: WidgetCSP;
+}
+/**
+ * Generates the bridge script with allowed parent origins injected.
+ * This bridges the MessageChannel API with the window.openai interface.
+ * Uses MessageChannel for secure communication instead of postMessage('*').
+ */
+declare function generateBridgeScript(allowedParentOrigins: string[]): string;
+/**
+ * Generates HTML wrapper for a script URL.
+ * Includes minimal styling for transparent background and full-size root.
+ * The scriptSrc is escaped to prevent XSS via attribute injection.
+ */
+declare function generateScriptHtml(scriptSrc: string, theme: string, cspPolicy: string): string;
+/**
+ * IframeResource renders production .js files in an actual iframe.
+ *
+ * It sets up a postMessage bridge to communicate window.openai state
+ * between the parent simulator and the iframe content.
+ *
+ * Usage:
+ * ```tsx
+ * <IframeResource scriptSrc="/dist/carousel.js" />
+ * ```
+ */
+export declare function IframeResource({ scriptSrc, className, style, csp }: IframeResourceProps): import("react/jsx-runtime").JSX.Element;
+export declare const _testExports: {
+    escapeHtml: typeof escapeHtml;
+    isAllowedScriptSrc: typeof isAllowedScriptSrc;
+    generateBridgeScript: typeof generateBridgeScript;
+    generateCSP: typeof generateCSP;
+    generateScriptHtml: typeof generateScriptHtml;
+    ALLOWED_SCRIPT_ORIGINS: string[];
+    ALLOWED_PARENT_ORIGINS: string[];
+};
+export {};

package/dist/chatgpt/index.cjs

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const simulatorUrl = require("../simulator-url-CG8lAAC3.cjs");
+const simulatorUrl = require("../simulator-url-BStCoFTv.cjs");
 exports.ChatGPTSimulator = simulatorUrl.ChatGPTSimulator;
+exports.IframeResource = simulatorUrl.IframeResource;
 exports.ThemeProvider = simulatorUrl.ThemeProvider;
 exports.createSimulatorUrl = simulatorUrl.createSimulatorUrl;
 exports.initMockOpenAI = simulatorUrl.initMockOpenAI;

package/dist/chatgpt/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}

package/dist/chatgpt/index.d.ts

@@ -4,3 +4,4 @@ export { initMockOpenAI } from './mock-openai';
 export * from './theme-provider';
 export { createSimulatorUrl } from './simulator-url';
 export type { SimulatorUrlParams } from './simulator-url';
+export { IframeResource } from './iframe-resource';

package/dist/chatgpt/index.js

@@ -1,6 +1,7 @@
-import { C, T, c, i, u } from "../simulator-url-CexnaL-e.js";
+import { C, I, T, c, i, u } from "../simulator-url-BOSS60NS.js";
 export {
   C as ChatGPTSimulator,
+  I as IframeResource,
   T as ThemeProvider,
   c as createSimulatorUrl,
   i as initMockOpenAI,

package/dist/discovery-a4WId9PC.cjs

@@ -0,0 +1,125 @@
+"use strict";
+function toPascalCase(str) {
+  return str.split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
+}
+function extractResourceKey(path) {
+  const match = path.match(/([^/]+)-resource\.(tsx|json)$/);
+  return match == null ? void 0 : match[1];
+}
+function extractSimulationKey(path) {
+  const match = path.match(/([^/]+)-simulation\.json$/);
+  return match == null ? void 0 : match[1];
+}
+function findResourceKey(simulationKey, resourceKeys) {
+  const sorted = [...resourceKeys].sort((a, b) => b.length - a.length);
+  for (const resourceKey of sorted) {
+    if (simulationKey === resourceKey || simulationKey.startsWith(resourceKey + "-")) {
+      return resourceKey;
+    }
+  }
+  return void 0;
+}
+function getComponentName(resourceKey) {
+  return `${toPascalCase(resourceKey)}Resource`;
+}
+function createResourceExports(modules) {
+  const resources = {};
+  for (const [path, module2] of Object.entries(modules)) {
+    const key = extractResourceKey(path);
+    if (!key) continue;
+    const exportName = getComponentName(key);
+    const mod = module2;
+    const component = mod.default ?? mod[exportName];
+    if (component && (typeof component === "function" || typeof component === "object")) {
+      resources[exportName] = component;
+    }
+  }
+  return resources;
+}
+function createSimulationIndex(modules) {
+  return Object.fromEntries(
+    Object.entries(modules).map(([path, module2]) => {
+      const key = extractSimulationKey(path);
+      if (!key) return null;
+      return [key, module2.default];
+    }).filter((entry) => entry !== null)
+  );
+}
+function buildResourceMap(modules) {
+  const map = /* @__PURE__ */ new Map();
+  for (const [path, module2] of Object.entries(modules)) {
+    const key = extractResourceKey(path);
+    if (key) {
+      map.set(key, module2.default);
+    }
+  }
+  return map;
+}
+function buildSimulations(options) {
+  const {
+    simulationModules,
+    resourcesMap,
+    resourceComponents,
+    createSimulation,
+    onMissingResource = (key, prefix) => console.warn(
+      `No matching resource found for simulation "${key}". Expected a resource file like src/resources/${prefix}-resource.json`
+    )
+  } = options;
+  const resourceKeys = Array.from(resourcesMap.keys());
+  const simulations = {};
+  for (const [path, module2] of Object.entries(simulationModules)) {
+    const simulationKey = extractSimulationKey(path);
+    if (!simulationKey) continue;
+    const simulationData = module2.default;
+    const resourceKey = findResourceKey(simulationKey, resourceKeys);
+    if (!resourceKey) {
+      onMissingResource(simulationKey, simulationKey.split("-")[0]);
+      continue;
+    }
+    const resource = resourcesMap.get(resourceKey);
+    const componentName = getComponentName(resourceKey);
+    const resourceComponent = resourceComponents[componentName];
+    if (!resourceComponent) {
+      console.warn(
+        `Resource component "${componentName}" not found for resource "${resourceKey}". Make sure src/resources/${resourceKey}-resource.tsx exists with a default export.`
+      );
+      continue;
+    }
+    simulations[simulationKey] = createSimulation(
+      simulationKey,
+      simulationData,
+      resource,
+      resourceComponent
+    );
+  }
+  return simulations;
+}
+function buildDevSimulations(options) {
+  const { simulationModules, resourceModules, resourceComponents } = options;
+  const resourcesMap = buildResourceMap(resourceModules);
+  return buildSimulations({
+    simulationModules,
+    resourcesMap,
+    resourceComponents,
+    createSimulation: (simulationKey, simulationData, resource, resourceComponent) => ({
+      ...simulationData,
+      name: simulationKey,
+      resource: {
+        uri: `ui://${resource.name}`,
+        ...resource
+      },
+      resourceComponent
+    })
+  });
+}
+exports.buildDevSimulations = buildDevSimulations;
+exports.buildResourceMap = buildResourceMap;
+exports.buildSimulations = buildSimulations;
+exports.createResourceExports = createResourceExports;
+exports.createSimulationIndex = createSimulationIndex;
+exports.extractResourceKey = extractResourceKey;
+exports.extractSimulationKey = extractSimulationKey;
+exports.findResourceKey = findResourceKey;
+exports.getComponentName = getComponentName;
+exports.toPascalCase = toPascalCase;
+//# sourceMappingURL=discovery-a4WId9PC.cjs.map

package/dist/discovery-a4WId9PC.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-a4WId9PC.cjs","sources":["../src/lib/discovery.ts"],"sourcesContent":["/**\n * Discovery utilities for auto-discovering resources and simulations\n *\n * These helpers process the results of import.meta.glob() calls to extract\n * keys, build component maps, and connect simulations to resources.\n *\n * The glob calls themselves must remain in the template (Vite compile-time),\n * but all the processing logic lives here for easy updates across templates.\n */\n\nimport type { Simulation } from '../types/simulation.js';\n\n/**\n * Convert a kebab-case string to PascalCase\n * @example toPascalCase('review') // 'Review'\n * @example toPascalCase('album-art') // 'AlbumArt'\n */\nexport function toPascalCase(str: string): string {\n  return str\n    .split('-')\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join('');\n}\n\n/**\n * Extract the resource key from a resource file path\n * @example extractResourceKey('./review-resource.tsx') // 'review'\n * @example extractResourceKey('../src/resources/albums-resource.json') // 'albums'\n */\nexport function extractResourceKey(path: string): string | undefined {\n  const match = path.match(/([^/]+)-resource\\.(tsx|json)$/);\n  return match?.[1];\n}\n\n/**\n * Extract the simulation key from a simulation file path\n * @example extractSimulationKey('./albums-show-simulation.json') // 'albums-show'\n */\nexport function extractSimulationKey(path: string): string | undefined {\n  const match = path.match(/([^/]+)-simulation\\.json$/);\n  return match?.[1];\n}\n\n/**\n * Find the best matching resource key for a simulation key.\n * Matches the longest resource name that is a prefix of the simulation key.\n * @example findResourceKey('albums-show', ['albums', 'album']) // 'albums'\n * @example findResourceKey('review-diff', ['review', 'carousel']) // 'review'\n */\nexport function findResourceKey(simulationKey: string, resourceKeys: string[]): string | undefined {\n  // Sort by length descending to find longest match first\n  const sorted = [...resourceKeys].sort((a, b) => b.length - a.length);\n  for (const resourceKey of sorted) {\n    if (simulationKey === resourceKey || simulationKey.startsWith(resourceKey + '-')) {\n      return resourceKey;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Get the expected component export name for a resource\n * @example getComponentName('review') // 'ReviewResource'\n * @example getComponentName('album-art') // 'AlbumArtResource'\n */\nexport function getComponentName(resourceKey: string): string {\n  return `${toPascalCase(resourceKey)}Resource`;\n}\n\n// --- Glob processing helpers ---\n\ntype GlobModules = Record<string, unknown>;\n\n/**\n * Process resource component modules from import.meta.glob() result.\n * Extracts components and exports them with PascalCase names.\n *\n * @example\n * const modules = import.meta.glob('./*-resource.tsx', { eager: true });\n * export default createResourceExports(modules);\n */\nexport function createResourceExports(modules: GlobModules): Record<string, React.ComponentType> {\n  const resources: Record<string, React.ComponentType> = {};\n\n  for (const [path, module] of Object.entries(modules)) {\n    const key = extractResourceKey(path);\n    if (!key) continue;\n\n    const exportName = getComponentName(key);\n    const mod = module as Record<string, unknown>;\n\n    // Try default export first, then named export matching the expected name\n    const component = mod.default ?? mod[exportName];\n\n    // Accept functions (regular components) or objects (forwardRef/memo components)\n    if (component && (typeof component === 'function' || typeof component === 'object')) {\n      resources[exportName] = component as React.ComponentType;\n    }\n  }\n\n  return resources;\n}\n\n/**\n * Process simulation modules from import.meta.glob() result.\n * Builds a map of simulation key -> simulation data.\n *\n * @example\n * const modules = import.meta.glob('./*-simulation.json', { eager: true });\n * export const SIMULATIONS = createSimulationIndex(modules);\n */\nexport function createSimulationIndex(modules: GlobModules): Record<string, unknown> {\n  return Object.fromEntries(\n    Object.entries(modules)\n      .map(([path, module]) => {\n        const key = extractSimulationKey(path);\n        if (!key) return null;\n        return [key, (module as { default: unknown }).default];\n      })\n      .filter((entry): entry is [string, unknown] => entry !== null)\n  );\n}\n\n/**\n * Build a resource metadata map from import.meta.glob() result.\n * Used for connecting simulations to their resource definitions.\n *\n * @example\n * const modules = import.meta.glob('../src/resources/*-resource.json', { eager: true });\n * const resourcesMap = buildResourceMap(modules);\n */\nexport function buildResourceMap<T>(modules: GlobModules): Map<string, T> {\n  const map = new Map<string, T>();\n\n  for (const [path, module] of Object.entries(modules)) {\n    const key = extractResourceKey(path);\n    if (key) {\n      map.set(key, (module as { default: T }).default);\n    }\n  }\n\n  return map;\n}\n\n/**\n * Options for building simulations from discovered modules\n */\nexport interface BuildSimulationsOptions<TResource, TSimulation> {\n  /** Glob result of simulation JSON files */\n  simulationModules: GlobModules;\n  /** Map of resource key -> resource metadata */\n  resourcesMap: Map<string, TResource>;\n  /** Map of component name -> React component */\n  resourceComponents: Record<string, React.ComponentType>;\n  /** Create the final simulation object */\n  createSimulation: (\n    simulationKey: string,\n    simulationData: unknown,\n    resource: TResource,\n    resourceComponent: React.ComponentType\n  ) => TSimulation;\n  /** Optional warning handler for missing resources */\n  onMissingResource?: (simulationKey: string, expectedPrefix: string) => void;\n}\n\n/**\n * Build simulations by connecting simulation data with resources and components.\n * This is the main orchestration function for dev server bootstrap.\n */\nexport function buildSimulations<TResource, TSimulation>(\n  options: BuildSimulationsOptions<TResource, TSimulation>\n): Record<string, TSimulation> {\n  const {\n    simulationModules,\n    resourcesMap,\n    resourceComponents,\n    createSimulation,\n    onMissingResource = (key, prefix) =>\n      console.warn(\n        `No matching resource found for simulation \"${key}\". ` +\n          `Expected a resource file like src/resources/${prefix}-resource.json`\n      ),\n  } = options;\n\n  const resourceKeys = Array.from(resourcesMap.keys());\n  const simulations: Record<string, TSimulation> = {};\n\n  for (const [path, module] of Object.entries(simulationModules)) {\n    const simulationKey = extractSimulationKey(path);\n    if (!simulationKey) continue;\n\n    const simulationData = (module as { default: unknown }).default;\n\n    // Find matching resource\n    const resourceKey = findResourceKey(simulationKey, resourceKeys);\n    if (!resourceKey) {\n      onMissingResource(simulationKey, simulationKey.split('-')[0]);\n      continue;\n    }\n\n    const resource = resourcesMap.get(resourceKey)!;\n\n    // Get component\n    const componentName = getComponentName(resourceKey);\n    const resourceComponent = resourceComponents[componentName];\n\n    if (!resourceComponent) {\n      console.warn(\n        `Resource component \"${componentName}\" not found for resource \"${resourceKey}\". ` +\n          `Make sure src/resources/${resourceKey}-resource.tsx exists with a default export.`\n      );\n      continue;\n    }\n\n    simulations[simulationKey] = createSimulation(\n      simulationKey,\n      simulationData,\n      resource,\n      resourceComponent\n    );\n  }\n\n  return simulations;\n}\n\n// --- Dev server helpers ---\n\n/**\n * Resource metadata from *-resource.json files\n */\nexport interface ResourceMetadata {\n  name: string;\n  [key: string]: unknown;\n}\n\n/**\n * Options for building dev simulations\n */\nexport interface BuildDevSimulationsOptions {\n  /** Glob result of simulation JSON files: import.meta.glob('*-simulation.json', { eager: true }) */\n  simulationModules: GlobModules;\n  /** Glob result of resource JSON files: import.meta.glob('*-resource.json', { eager: true }) */\n  resourceModules: GlobModules;\n  /** Resource components map from src/resources/index.ts */\n  resourceComponents: Record<string, React.ComponentType>;\n}\n\n/**\n * Build simulations for the dev server from glob results.\n * This is the main entry point for dev.tsx bootstrap.\n *\n * @example\n * const simulations = buildDevSimulations({\n *   simulationModules: import.meta.glob('../src/simulations/*-simulation.json', { eager: true }),\n *   resourceModules: import.meta.glob('../src/resources/*-resource.json', { eager: true }),\n *   resourceComponents: resourceComponents,\n * });\n */\nexport function buildDevSimulations(\n  options: BuildDevSimulationsOptions\n): Record<string, Simulation> {\n  const { simulationModules, resourceModules, resourceComponents } = options;\n\n  // Build resource metadata map\n  const resourcesMap = buildResourceMap<ResourceMetadata>(resourceModules);\n\n  // Build simulations with the standard dev server format\n  return buildSimulations<ResourceMetadata, Simulation>({\n    simulationModules,\n    resourcesMap,\n    resourceComponents,\n    createSimulation: (simulationKey, simulationData, resource, resourceComponent) => ({\n      ...(simulationData as Omit<Simulation, 'name' | 'resourceComponent' | 'resource'>),\n      name: simulationKey,\n      resource: {\n        uri: `ui://${resource.name}`,\n        ...resource,\n      },\n      resourceComponent,\n    }),\n  });\n}\n"],"names":["module"],"mappings":"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"}

package/dist/discovery-ft3cd2dW.js

@@ -0,0 +1,126 @@
+function toPascalCase(str) {
+  return str.split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join("");
+}
+function extractResourceKey(path) {
+  const match = path.match(/([^/]+)-resource\.(tsx|json)$/);
+  return match == null ? void 0 : match[1];
+}
+function extractSimulationKey(path) {
+  const match = path.match(/([^/]+)-simulation\.json$/);
+  return match == null ? void 0 : match[1];
+}
+function findResourceKey(simulationKey, resourceKeys) {
+  const sorted = [...resourceKeys].sort((a, b) => b.length - a.length);
+  for (const resourceKey of sorted) {
+    if (simulationKey === resourceKey || simulationKey.startsWith(resourceKey + "-")) {
+      return resourceKey;
+    }
+  }
+  return void 0;
+}
+function getComponentName(resourceKey) {
+  return `${toPascalCase(resourceKey)}Resource`;
+}
+function createResourceExports(modules) {
+  const resources = {};
+  for (const [path, module] of Object.entries(modules)) {
+    const key = extractResourceKey(path);
+    if (!key) continue;
+    const exportName = getComponentName(key);
+    const mod = module;
+    const component = mod.default ?? mod[exportName];
+    if (component && (typeof component === "function" || typeof component === "object")) {
+      resources[exportName] = component;
+    }
+  }
+  return resources;
+}
+function createSimulationIndex(modules) {
+  return Object.fromEntries(
+    Object.entries(modules).map(([path, module]) => {
+      const key = extractSimulationKey(path);
+      if (!key) return null;
+      return [key, module.default];
+    }).filter((entry) => entry !== null)
+  );
+}
+function buildResourceMap(modules) {
+  const map = /* @__PURE__ */ new Map();
+  for (const [path, module] of Object.entries(modules)) {
+    const key = extractResourceKey(path);
+    if (key) {
+      map.set(key, module.default);
+    }
+  }
+  return map;
+}
+function buildSimulations(options) {
+  const {
+    simulationModules,
+    resourcesMap,
+    resourceComponents,
+    createSimulation,
+    onMissingResource = (key, prefix) => console.warn(
+      `No matching resource found for simulation "${key}". Expected a resource file like src/resources/${prefix}-resource.json`
+    )
+  } = options;
+  const resourceKeys = Array.from(resourcesMap.keys());
+  const simulations = {};
+  for (const [path, module] of Object.entries(simulationModules)) {
+    const simulationKey = extractSimulationKey(path);
+    if (!simulationKey) continue;
+    const simulationData = module.default;
+    const resourceKey = findResourceKey(simulationKey, resourceKeys);
+    if (!resourceKey) {
+      onMissingResource(simulationKey, simulationKey.split("-")[0]);
+      continue;
+    }
+    const resource = resourcesMap.get(resourceKey);
+    const componentName = getComponentName(resourceKey);
+    const resourceComponent = resourceComponents[componentName];
+    if (!resourceComponent) {
+      console.warn(
+        `Resource component "${componentName}" not found for resource "${resourceKey}". Make sure src/resources/${resourceKey}-resource.tsx exists with a default export.`
+      );
+      continue;
+    }
+    simulations[simulationKey] = createSimulation(
+      simulationKey,
+      simulationData,
+      resource,
+      resourceComponent
+    );
+  }
+  return simulations;
+}
+function buildDevSimulations(options) {
+  const { simulationModules, resourceModules, resourceComponents } = options;
+  const resourcesMap = buildResourceMap(resourceModules);
+  return buildSimulations({
+    simulationModules,
+    resourcesMap,
+    resourceComponents,
+    createSimulation: (simulationKey, simulationData, resource, resourceComponent) => ({
+      ...simulationData,
+      name: simulationKey,
+      resource: {
+        uri: `ui://${resource.name}`,
+        ...resource
+      },
+      resourceComponent
+    })
+  });
+}
+export {
+  extractSimulationKey as a,
+  createSimulationIndex as b,
+  createResourceExports as c,
+  buildResourceMap as d,
+  extractResourceKey as e,
+  findResourceKey as f,
+  getComponentName as g,
+  buildSimulations as h,
+  buildDevSimulations as i,
+  toPascalCase as t
+};
+//# sourceMappingURL=discovery-ft3cd2dW.js.map

package/dist/discovery-ft3cd2dW.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-ft3cd2dW.js","sources":["../src/lib/discovery.ts"],"sourcesContent":["/**\n * Discovery utilities for auto-discovering resources and simulations\n *\n * These helpers process the results of import.meta.glob() calls to extract\n * keys, build component maps, and connect simulations to resources.\n *\n * The glob calls themselves must remain in the template (Vite compile-time),\n * but all the processing logic lives here for easy updates across templates.\n */\n\nimport type { Simulation } from '../types/simulation.js';\n\n/**\n * Convert a kebab-case string to PascalCase\n * @example toPascalCase('review') // 'Review'\n * @example toPascalCase('album-art') // 'AlbumArt'\n */\nexport function toPascalCase(str: string): string {\n  return str\n    .split('-')\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join('');\n}\n\n/**\n * Extract the resource key from a resource file path\n * @example extractResourceKey('./review-resource.tsx') // 'review'\n * @example extractResourceKey('../src/resources/albums-resource.json') // 'albums'\n */\nexport function extractResourceKey(path: string): string | undefined {\n  const match = path.match(/([^/]+)-resource\\.(tsx|json)$/);\n  return match?.[1];\n}\n\n/**\n * Extract the simulation key from a simulation file path\n * @example extractSimulationKey('./albums-show-simulation.json') // 'albums-show'\n */\nexport function extractSimulationKey(path: string): string | undefined {\n  const match = path.match(/([^/]+)-simulation\\.json$/);\n  return match?.[1];\n}\n\n/**\n * Find the best matching resource key for a simulation key.\n * Matches the longest resource name that is a prefix of the simulation key.\n * @example findResourceKey('albums-show', ['albums', 'album']) // 'albums'\n * @example findResourceKey('review-diff', ['review', 'carousel']) // 'review'\n */\nexport function findResourceKey(simulationKey: string, resourceKeys: string[]): string | undefined {\n  // Sort by length descending to find longest match first\n  const sorted = [...resourceKeys].sort((a, b) => b.length - a.length);\n  for (const resourceKey of sorted) {\n    if (simulationKey === resourceKey || simulationKey.startsWith(resourceKey + '-')) {\n      return resourceKey;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Get the expected component export name for a resource\n * @example getComponentName('review') // 'ReviewResource'\n * @example getComponentName('album-art') // 'AlbumArtResource'\n */\nexport function getComponentName(resourceKey: string): string {\n  return `${toPascalCase(resourceKey)}Resource`;\n}\n\n// --- Glob processing helpers ---\n\ntype GlobModules = Record<string, unknown>;\n\n/**\n * Process resource component modules from import.meta.glob() result.\n * Extracts components and exports them with PascalCase names.\n *\n * @example\n * const modules = import.meta.glob('./*-resource.tsx', { eager: true });\n * export default createResourceExports(modules);\n */\nexport function createResourceExports(modules: GlobModules): Record<string, React.ComponentType> {\n  const resources: Record<string, React.ComponentType> = {};\n\n  for (const [path, module] of Object.entries(modules)) {\n    const key = extractResourceKey(path);\n    if (!key) continue;\n\n    const exportName = getComponentName(key);\n    const mod = module as Record<string, unknown>;\n\n    // Try default export first, then named export matching the expected name\n    const component = mod.default ?? mod[exportName];\n\n    // Accept functions (regular components) or objects (forwardRef/memo components)\n    if (component && (typeof component === 'function' || typeof component === 'object')) {\n      resources[exportName] = component as React.ComponentType;\n    }\n  }\n\n  return resources;\n}\n\n/**\n * Process simulation modules from import.meta.glob() result.\n * Builds a map of simulation key -> simulation data.\n *\n * @example\n * const modules = import.meta.glob('./*-simulation.json', { eager: true });\n * export const SIMULATIONS = createSimulationIndex(modules);\n */\nexport function createSimulationIndex(modules: GlobModules): Record<string, unknown> {\n  return Object.fromEntries(\n    Object.entries(modules)\n      .map(([path, module]) => {\n        const key = extractSimulationKey(path);\n        if (!key) return null;\n        return [key, (module as { default: unknown }).default];\n      })\n      .filter((entry): entry is [string, unknown] => entry !== null)\n  );\n}\n\n/**\n * Build a resource metadata map from import.meta.glob() result.\n * Used for connecting simulations to their resource definitions.\n *\n * @example\n * const modules = import.meta.glob('../src/resources/*-resource.json', { eager: true });\n * const resourcesMap = buildResourceMap(modules);\n */\nexport function buildResourceMap<T>(modules: GlobModules): Map<string, T> {\n  const map = new Map<string, T>();\n\n  for (const [path, module] of Object.entries(modules)) {\n    const key = extractResourceKey(path);\n    if (key) {\n      map.set(key, (module as { default: T }).default);\n    }\n  }\n\n  return map;\n}\n\n/**\n * Options for building simulations from discovered modules\n */\nexport interface BuildSimulationsOptions<TResource, TSimulation> {\n  /** Glob result of simulation JSON files */\n  simulationModules: GlobModules;\n  /** Map of resource key -> resource metadata */\n  resourcesMap: Map<string, TResource>;\n  /** Map of component name -> React component */\n  resourceComponents: Record<string, React.ComponentType>;\n  /** Create the final simulation object */\n  createSimulation: (\n    simulationKey: string,\n    simulationData: unknown,\n    resource: TResource,\n    resourceComponent: React.ComponentType\n  ) => TSimulation;\n  /** Optional warning handler for missing resources */\n  onMissingResource?: (simulationKey: string, expectedPrefix: string) => void;\n}\n\n/**\n * Build simulations by connecting simulation data with resources and components.\n * This is the main orchestration function for dev server bootstrap.\n */\nexport function buildSimulations<TResource, TSimulation>(\n  options: BuildSimulationsOptions<TResource, TSimulation>\n): Record<string, TSimulation> {\n  const {\n    simulationModules,\n    resourcesMap,\n    resourceComponents,\n    createSimulation,\n    onMissingResource = (key, prefix) =>\n      console.warn(\n        `No matching resource found for simulation \"${key}\". ` +\n          `Expected a resource file like src/resources/${prefix}-resource.json`\n      ),\n  } = options;\n\n  const resourceKeys = Array.from(resourcesMap.keys());\n  const simulations: Record<string, TSimulation> = {};\n\n  for (const [path, module] of Object.entries(simulationModules)) {\n    const simulationKey = extractSimulationKey(path);\n    if (!simulationKey) continue;\n\n    const simulationData = (module as { default: unknown }).default;\n\n    // Find matching resource\n    const resourceKey = findResourceKey(simulationKey, resourceKeys);\n    if (!resourceKey) {\n      onMissingResource(simulationKey, simulationKey.split('-')[0]);\n      continue;\n    }\n\n    const resource = resourcesMap.get(resourceKey)!;\n\n    // Get component\n    const componentName = getComponentName(resourceKey);\n    const resourceComponent = resourceComponents[componentName];\n\n    if (!resourceComponent) {\n      console.warn(\n        `Resource component \"${componentName}\" not found for resource \"${resourceKey}\". ` +\n          `Make sure src/resources/${resourceKey}-resource.tsx exists with a default export.`\n      );\n      continue;\n    }\n\n    simulations[simulationKey] = createSimulation(\n      simulationKey,\n      simulationData,\n      resource,\n      resourceComponent\n    );\n  }\n\n  return simulations;\n}\n\n// --- Dev server helpers ---\n\n/**\n * Resource metadata from *-resource.json files\n */\nexport interface ResourceMetadata {\n  name: string;\n  [key: string]: unknown;\n}\n\n/**\n * Options for building dev simulations\n */\nexport interface BuildDevSimulationsOptions {\n  /** Glob result of simulation JSON files: import.meta.glob('*-simulation.json', { eager: true }) */\n  simulationModules: GlobModules;\n  /** Glob result of resource JSON files: import.meta.glob('*-resource.json', { eager: true }) */\n  resourceModules: GlobModules;\n  /** Resource components map from src/resources/index.ts */\n  resourceComponents: Record<string, React.ComponentType>;\n}\n\n/**\n * Build simulations for the dev server from glob results.\n * This is the main entry point for dev.tsx bootstrap.\n *\n * @example\n * const simulations = buildDevSimulations({\n *   simulationModules: import.meta.glob('../src/simulations/*-simulation.json', { eager: true }),\n *   resourceModules: import.meta.glob('../src/resources/*-resource.json', { eager: true }),\n *   resourceComponents: resourceComponents,\n * });\n */\nexport function buildDevSimulations(\n  options: BuildDevSimulationsOptions\n): Record<string, Simulation> {\n  const { simulationModules, resourceModules, resourceComponents } = options;\n\n  // Build resource metadata map\n  const resourcesMap = buildResourceMap<ResourceMetadata>(resourceModules);\n\n  // Build simulations with the standard dev server format\n  return buildSimulations<ResourceMetadata, Simulation>({\n    simulationModules,\n    resourcesMap,\n    resourceComponents,\n    createSimulation: (simulationKey, simulationData, resource, resourceComponent) => ({\n      ...(simulationData as Omit<Simulation, 'name' | 'resourceComponent' | 'resource'>),\n      name: simulationKey,\n      resource: {\n        uri: `ui://${resource.name}`,\n        ...resource,\n      },\n      resourceComponent,\n    }),\n  });\n}\n"],"names":[],"mappings":"AAiBO,SAAS,aAAa,KAAqB;AAChD,SAAO,IACJ,MAAM,GAAG,EACT,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC,EAAE,YAAA,IAAgB,KAAK,MAAM,CAAC,CAAC,EAC1D,KAAK,EAAE;AACZ;AAOO,SAAS,mBAAmB,MAAkC;AACnE,QAAM,QAAQ,KAAK,MAAM,+BAA+B;AACxD,SAAO,+BAAQ;AACjB;AAMO,SAAS,qBAAqB,MAAkC;AACrE,QAAM,QAAQ,KAAK,MAAM,2BAA2B;AACpD,SAAO,+BAAQ;AACjB;AAQO,SAAS,gBAAgB,eAAuB,cAA4C;AAEjG,QAAM,SAAS,CAAC,GAAG,YAAY,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM;AACnE,aAAW,eAAe,QAAQ;AAChC,QAAI,kBAAkB,eAAe,cAAc,WAAW,cAAc,GAAG,GAAG;AAChF,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,iBAAiB,aAA6B;AAC5D,SAAO,GAAG,aAAa,WAAW,CAAC;AACrC;AAcO,SAAS,sBAAsB,SAA2D;AAC/F,QAAM,YAAiD,CAAA;AAEvD,aAAW,CAAC,MAAM,MAAM,KAAK,OAAO,QAAQ,OAAO,GAAG;AACpD,UAAM,MAAM,mBAAmB,IAAI;AACnC,QAAI,CAAC,IAAK;AAEV,UAAM,aAAa,iBAAiB,GAAG;AACvC,UAAM,MAAM;AAGZ,UAAM,YAAY,IAAI,WAAW,IAAI,UAAU;AAG/C,QAAI,cAAc,OAAO,cAAc,cAAc,OAAO,cAAc,WAAW;AACnF,gBAAU,UAAU,IAAI;AAAA,IAC1B;AAAA,EACF;AAEA,SAAO;AACT;AAUO,SAAS,sBAAsB,SAA+C;AACnF,SAAO,OAAO;AAAA,IACZ,OAAO,QAAQ,OAAO,EACnB,IAAI,CAAC,CAAC,MAAM,MAAM,MAAM;AACvB,YAAM,MAAM,qBAAqB,IAAI;AACrC,UAAI,CAAC,IAAK,QAAO;AACjB,aAAO,CAAC,KAAM,OAAgC,OAAO;AAAA,IACvD,CAAC,EACA,OAAO,CAAC,UAAsC,UAAU,IAAI;AAAA,EAAA;AAEnE;AAUO,SAAS,iBAAoB,SAAsC;AACxE,QAAM,0BAAU,IAAA;AAEhB,aAAW,CAAC,MAAM,MAAM,KAAK,OAAO,QAAQ,OAAO,GAAG;AACpD,UAAM,MAAM,mBAAmB,IAAI;AACnC,QAAI,KAAK;AACP,UAAI,IAAI,KAAM,OAA0B,OAAO;AAAA,IACjD;AAAA,EACF;AAEA,SAAO;AACT;AA2BO,SAAS,iBACd,SAC6B;AAC7B,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,oBAAoB,CAAC,KAAK,WACxB,QAAQ;AAAA,MACN,8CAA8C,GAAG,kDACA,MAAM;AAAA,IAAA;AAAA,EACzD,IACA;AAEJ,QAAM,eAAe,MAAM,KAAK,aAAa,MAAM;AACnD,QAAM,cAA2C,CAAA;AAEjD,aAAW,CAAC,MAAM,MAAM,KAAK,OAAO,QAAQ,iBAAiB,GAAG;AAC9D,UAAM,gBAAgB,qBAAqB,IAAI;AAC/C,QAAI,CAAC,cAAe;AAEpB,UAAM,iBAAkB,OAAgC;AAGxD,UAAM,cAAc,gBAAgB,eAAe,YAAY;AAC/D,QAAI,CAAC,aAAa;AAChB,wBAAkB,eAAe,cAAc,MAAM,GAAG,EAAE,CAAC,CAAC;AAC5D;AAAA,IACF;AAEA,UAAM,WAAW,aAAa,IAAI,WAAW;AAG7C,UAAM,gBAAgB,iBAAiB,WAAW;AAClD,UAAM,oBAAoB,mBAAmB,aAAa;AAE1D,QAAI,CAAC,mBAAmB;AACtB,cAAQ;AAAA,QACN,uBAAuB,aAAa,6BAA6B,WAAW,8BAC/C,WAAW;AAAA,MAAA;AAE1C;AAAA,IACF;AAEA,gBAAY,aAAa,IAAI;AAAA,MAC3B;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AAEA,SAAO;AACT;AAmCO,SAAS,oBACd,SAC4B;AAC5B,QAAM,EAAE,mBAAmB,iBAAiB,mBAAA,IAAuB;AAGnE,QAAM,eAAe,iBAAmC,eAAe;AAGvE,SAAO,iBAA+C;AAAA,IACpD;AAAA,IACA;AAAA,IACA;AAAA,IACA,kBAAkB,CAAC,eAAe,gBAAgB,UAAU,uBAAuB;AAAA,MACjF,GAAI;AAAA,MACJ,MAAM;AAAA,MACN,UAAU;AAAA,QACR,KAAK,QAAQ,SAAS,IAAI;AAAA,QAC1B,GAAG;AAAA,MAAA;AAAA,MAEL;AAAA,IAAA;AAAA,EACF,CACD;AACH;"}

package/dist/index.cjs

@@ -1,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const simulatorUrl = require("./simulator-url-CG8lAAC3.cjs");
+const simulatorUrl = require("./simulator-url-BStCoFTv.cjs");
 const React = require("react");
+const discovery = require("./discovery-a4WId9PC.cjs");
 function _interopNamespaceDefault(e) {
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
   if (e) {
@@ -3053,6 +3054,7 @@ const prefersReducedMotion = createMediaQueryFn("(prefers-reduced-motion: reduce
 const isPrimarilyTouchDevice = createMediaQueryFn("(pointer: coarse)");
 const isHoverAvailable = createMediaQueryFn("(hover: hover)");
 exports.ChatGPTSimulator = simulatorUrl.ChatGPTSimulator;
+exports.IframeResource = simulatorUrl.IframeResource;
 exports.SCREEN_WIDTHS = simulatorUrl.SCREEN_WIDTHS;
 exports.ThemeProvider = simulatorUrl.ThemeProvider;
 exports.createSimulatorUrl = simulatorUrl.createSimulatorUrl;
@@ -3077,6 +3079,16 @@ exports.useWidgetAPI = simulatorUrl.useWidgetAPI;
 exports.useWidgetGlobal = simulatorUrl.useWidgetGlobal;
 exports.useWidgetProps = simulatorUrl.useWidgetProps;
 exports.useWidgetState = simulatorUrl.useWidgetState;
+exports.buildDevSimulations = discovery.buildDevSimulations;
+exports.buildResourceMap = discovery.buildResourceMap;
+exports.buildSimulations = discovery.buildSimulations;
+exports.createResourceExports = discovery.createResourceExports;
+exports.createSimulationIndex = discovery.createSimulationIndex;
+exports.extractResourceKey = discovery.extractResourceKey;
+exports.extractSimulationKey = discovery.extractSimulationKey;
+exports.findResourceKey = discovery.findResourceKey;
+exports.getComponentName = discovery.getComponentName;
+exports.toPascalCase = discovery.toPascalCase;
 exports.cn = cn;
 exports.isHoverAvailable = isHoverAvailable;
 exports.isPrimarilyTouchDevice = isPrimarilyTouchDevice;