sunpeak 0.11.1 → 0.12.1

package/README.md

@@ -57,26 +57,32 @@ sunpeak is an npm package that helps you build ChatGPT Apps (MCP Resources) whil
 
 ### The `sunpeak` framework (`./template`)
 
-Next.js for ChatGPT Apps. This templated npm package includes:
+Next.js for ChatGPT Apps. Using a Review page as an example, sunpeak projects look like:
 
 ```bash
 my-app/
-├── src/
-│   └── resources/
-│       └── review/                                # My-app's Review UI.
-│           ├── review-resource.tsx                # Review UI component.
-│           ├── review-resource.json               # Review UI MCP metadata.
-│           └── review-{scenario}-simulation.json  # Mock state for testing.
+├── src/resources/
+│   └── review/
+│       ├── review-resource.tsx                 # Review UI component.
+│       └── review-resource.json                # Review UI MCP metadata.
+├── tests/simulations/
+│   └── review/
+│       ├── review-{scenario1}-simulation.json  # Mock state for testing.
+│       └── review-{scenario2}-simulation.json  # Mock state for testing.
 └── package.json
 ```
 
 1. Project scaffold: Complete development setup with 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 `src/resources/NAME/NAME-resource.tsx` React file and `src/resources/NAME/NAME-resource.json` metadata file.
+3. Convention over configuration:
+   1. Create UIs by creating a `-resource.tsx` component file ([example](#resource-component)) and `-resource.json` MCP metadata file ([example](#resource-mcp-metadata)).
+   2. Create test state (simulations) for local dev, ChatGPT dev, automated testing, and demos by creating a `-simulation.json` file. ([example](#simulation))
 
 ### The `sunpeak` CLI (`./bin`)
 
-Commands for managing ChatGPT Apps. Includes a client for the [sunpeak Resource Repository](https://app.sunpeak.ai/). The repository helps you & your CI/CD decouple your App from your client-agnostic MCP server while also providing a hosted runtime to collaborate, demo, and share your ChatGPT Apps:
+Commands for managing ChatGPT Apps. Includes a client for the [sunpeak Resource Repository](https://app.sunpeak.ai/). The repository helps you & your CI/CD decouple your App from your client-agnostic MCP server while also providing a hosted runtime to collaborate, demo, and share your ChatGPT Apps.
+
+Think Docker Hub for ChatGPT Apps:
 
 <div align="center">
   <a href="https://docs.sunpeak.ai/library/chatgpt-simulator">
@@ -88,14 +94,22 @@ Commands for managing ChatGPT Apps. Includes a client for the [sunpeak Resource
 
 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
-3. `pull` built Apps to be run in different environments
+3. `pull` built Apps to be run in different environments, like your production MCP server.
+4. Share your fully-functional demo Apps with teammates, prospects, and strangers!
+
+## Examples
+
+Example sunpeak resource & simulation files for an MCP Resource called "Review".
 
-## Example Resource Component
+### Resource Component
+
+React component defining a UI (MCP Resource) in your ChatGPT App.
 
 ```tsx
+// src/resources/review-resource.tsx
 import { Card } from './components';
 
-export function MCPResource() {
+export function ReviewResource() {
   return (
     <Card
       image="https://images.unsplash.com/photo-1520950237264-dfe336995c34"
@@ -111,6 +125,64 @@ export function MCPResource() {
 }
 ```
 
+### Resource MCP Metadata
+
+MCP metadata for your UI. Version your resource metadata alongside the resource itself.
+
+This is just an official [MCP Resource object](https://modelcontextprotocol.io/specification/2025-11-25/server/resources#resource).
+
+```json
+{
+  // src/resources/review-resource.json
+  "name": "review",
+  "title": "Review",
+  "description": "Visualize and review a proposed set of changes or actions",
+  "mimeType": "text/html+skybridge",
+  "_meta": {
+    "openai/widgetDomain": "https://sunpeak.ai",
+    "openai/widgetCSP": {
+      "resource_domains": ["https://cdn.openai.com"]
+    }
+  }
+}
+```
+
+### Simulation
+
+`sunpeak` object. Testing a ChatGPT App require setting a lot of state: state in your backend (accessed via MCP tool), the stored widget runtime, and ChatGPT itself.
+
+Simulation files let you define key App states for development, automated testing, and demo purposes.
+
+Simulation files contain an [official MCP Tool object](https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool) and an [official MCP CallToolResult object](https://modelcontextprotocol.io/specification/2025-11-25/server/tools#structured-content). ChatGPT state (like light/dark mode) is not set on the simulation, but rather on the sunpeak `ChatGPTSimulator` itself via UI, props, or URL params.
+
+```json
+{
+  // tests/simulations/review-diff-simulation.json
+  "userMessage": "Refactor the authentication module", // Simulator styling.
+  "tool": {
+    // Official MCP Tool object.
+    "name": "diff-review",
+    "description": "Show a review dialog for a proposed code diff",
+    "inputSchema": { "type": "object", "properties": {}, "additionalProperties": false },
+    "title": "Diff Review",
+    "annotations": { "readOnlyHint": false },
+    "_meta": {
+      "openai/toolInvocation/invoking": "Preparing changes",
+      "openai/toolInvocation/invoked": "Changes ready for review",
+      "openai/widgetAccessible": true,
+      "openai/resultCanProduceWidget": true
+    }
+  },
+  "callToolResult": {
+    // Official MCP CallToolResult object.
+    "structuredContent": {
+      // ...
+    },
+    "_meta": {}
+  }
+}
+```
+
 ## Resources
 
 - [ChatGPT Apps SDK Design Guidelines](https://developers.openai.com/apps-sdk/concepts/design-guidelines)

package/bin/commands/build.mjs

@@ -4,7 +4,7 @@ import react from '@vitejs/plugin-react';
 import tailwindcss from '@tailwindcss/vite';
 import { existsSync, rmSync, readdirSync, readFileSync, writeFileSync, mkdirSync, copyFileSync, unlinkSync } from 'fs';
 import path from 'path';
-import { toPascalCase, isSimulationFile } from '../lib/patterns.mjs';
+import { toPascalCase } from '../lib/patterns.mjs';
 
 /**
  * Build all resources for a Sunpeak project
@@ -241,16 +241,6 @@ export async function build(projectRoot = process.cwd()) {
       process.exit(1);
     }
 
-    // Copy affiliated simulation files (matching {resource}-*-simulation.json pattern)
-    const simulationFiles = readdirSync(resourceDir)
-      .filter(file => isSimulationFile(file, kebabName));
-
-    for (const simFile of simulationFiles) {
-      const srcSim = path.join(resourceDir, simFile);
-      const destSim = path.join(distOutDir, simFile);
-      copyFileSync(srcSim, destSim);
-      console.log(`✓ Copied ${kebabName}/${simFile}`);
-    }
   }
 
   // Clean up temp and build directories

package/bin/commands/deploy.mjs

@@ -28,6 +28,7 @@ Usage:
 Options:
   -r, --repository <owner/repo>  Repository name (defaults to git remote origin)
   -t, --tag <name>               Additional tag(s) to assign (always includes "prod")
+  --no-simulations               Skip pushing simulations, only push resources
   -h, --help                     Show this help message
 
 Arguments:
@@ -40,6 +41,7 @@ Examples:
   sunpeak deploy dist/carousel   Deploy a single resource
   sunpeak deploy -r myorg/my-app Deploy to "myorg/my-app" repository
   sunpeak deploy -t v1.0         Deploy with "prod" and "v1.0" tags
+  sunpeak deploy --no-simulations Deploy without simulations
 
 This command is equivalent to: sunpeak push --tag prod
 `);
@@ -75,7 +77,7 @@ This command is equivalent to: sunpeak push --tag prod
 /**
  * Parse command line arguments
  */
-function parseArgs(args) {
+export function parseArgs(args) {
   const options = { tags: [] };
   let i = 0;
 
@@ -86,6 +88,8 @@ function parseArgs(args) {
       options.repository = args[++i];
     } else if (arg === '--tag' || arg === '-t') {
       options.tags.push(args[++i]);
+    } else if (arg === '--no-simulations') {
+      options.noSimulations = true;
     } else if (arg === '--help' || arg === '-h') {
       console.log(`
 sunpeak deploy - Deploy resources to production (push with "prod" tag)
@@ -96,6 +100,7 @@ Usage:
 Options:
   -r, --repository <owner/repo>  Repository name (defaults to git remote origin)
   -t, --tag <name>               Additional tag(s) to assign (always includes "prod")
+  --no-simulations               Skip pushing simulations, only push resources
   -h, --help                     Show this help message
 
 Arguments:
@@ -108,6 +113,7 @@ Examples:
   sunpeak deploy dist/carousel   Deploy a single resource
   sunpeak deploy -r myorg/my-app Deploy to "myorg/my-app" repository
   sunpeak deploy -t v1.0         Deploy with "prod" and "v1.0" tags
+  sunpeak deploy --no-simulations Deploy without simulations
 
 This command is equivalent to: sunpeak push --tag prod
 `);

package/bin/commands/dev.mjs

@@ -154,12 +154,14 @@ export async function dev(projectRoot = process.cwd(), args = []) {
 
   // Discover simulations using sunpeak's discovery utilities
   const resourcesDir = join(projectRoot, 'src/resources');
+  const simulationsDir = join(projectRoot, 'tests/simulations');
   const resourceDirs = findResourceDirs(resourcesDir, (key) => `${key}-resource.json`, fs);
 
   const simulations = [];
   for (const { key: resourceKey, dir: resourceDir, resourcePath } of resourceDirs) {
     const resource = JSON.parse(readFileSync(resourcePath, 'utf-8'));
-    const simulationFiles = findSimulationFiles(resourceDir, resourceKey, fs);
+    const resourceSimDir = join(simulationsDir, resourceKey);
+    const simulationFiles = findSimulationFiles(resourceSimDir, resourceKey, fs);
 
     for (const { filename, path: simPath } of simulationFiles) {
       const simulationKey = filename.replace(/-simulation\.json$/, '');

package/bin/commands/new.mjs

@@ -0,0 +1,211 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, cpSync, readFileSync, writeFileSync, renameSync } from 'fs';
+import { join, dirname, basename } from 'path';
+import { fileURLToPath } from 'url';
+import { createInterface } from 'readline';
+import { discoverResources } from '../lib/patterns.mjs';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+/**
+ * Default prompt implementation using readline
+ * @param {string} question
+ * @returns {Promise<string>}
+ */
+function defaultPrompt(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+/**
+ * Default dependencies (real implementations)
+ */
+export const defaultDeps = {
+  discoverResources,
+  existsSync,
+  mkdirSync,
+  cpSync,
+  readFileSync,
+  writeFileSync,
+  renameSync,
+  prompt: defaultPrompt,
+  console,
+  process,
+  cwd: () => process.cwd(),
+  templateDir: join(__dirname, '..', '..', 'template'),
+  rootPkgPath: join(__dirname, '..', '..', 'package.json'),
+};
+
+/**
+ * Parse and validate resources input
+ * @param {string} input - Comma or space separated resource names
+ * @param {string[]} validResources - List of valid resource names
+ * @param {Object} deps - Dependencies for testing
+ * @returns {string[]} - Validated and deduplicated resource names
+ */
+export function parseResourcesInput(input, validResources, deps = defaultDeps) {
+  const d = { ...defaultDeps, ...deps };
+
+  // If no input, return all resources
+  if (!input || input.trim() === '') {
+    return validResources;
+  }
+
+  // Split by comma or space and trim
+  const tokens = input
+    .toLowerCase()
+    .split(/[,\s]+/)
+    .map((s) => s.trim())
+    .filter((s) => s.length > 0);
+
+  // Validate tokens
+  const invalid = tokens.filter((t) => !validResources.includes(t));
+  if (invalid.length > 0) {
+    d.console.error(`Error: Invalid resource(s): ${invalid.join(', ')}`);
+    d.console.error(`Valid resources are: ${validResources.join(', ')}`);
+    d.process.exit(1);
+  }
+
+  // Remove duplicates
+  return [...new Set(tokens)];
+}
+
+/**
+ * Create a new Sunpeak project
+ * @param {string} projectName - Name of the project directory
+ * @param {string} resourcesArg - Optional comma/space separated resources to include
+ * @param {Object} deps - Dependencies for testing
+ */
+export async function init(projectName, resourcesArg, deps = defaultDeps) {
+  const d = { ...defaultDeps, ...deps };
+
+  // Discover available resources from template
+  const availableResources = d.discoverResources();
+  if (availableResources.length === 0) {
+    d.console.error('Error: No resources found in template/src/resources/');
+    d.process.exit(1);
+  }
+
+  if (!projectName) {
+    projectName = await d.prompt('☀️ 🏔️ Project name [my-app]: ');
+    if (!projectName) {
+      projectName = 'my-app';
+    }
+  }
+
+  if (projectName === 'template') {
+    d.console.error('Error: "template" is a reserved name. Please choose another name.');
+    d.process.exit(1);
+  }
+
+  // Use resources from args or ask for them
+  let resourcesInput;
+  if (resourcesArg) {
+    resourcesInput = resourcesArg;
+    d.console.log(`☀️ 🏔️ Resources: ${resourcesArg}`);
+  } else {
+    resourcesInput = await d.prompt(
+      `☀️ 🏔️ Resources (UIs) to include [${availableResources.join(', ')}]: `
+    );
+  }
+  const selectedResources = parseResourcesInput(resourcesInput, availableResources, d);
+
+  const targetDir = join(d.cwd(), projectName);
+
+  if (d.existsSync(targetDir)) {
+    d.console.error(`Error: Directory "${projectName}" already exists`);
+    d.process.exit(1);
+  }
+
+  d.console.log(`☀️ 🏔️ Creating ${projectName}...`);
+
+  d.mkdirSync(targetDir, { recursive: true });
+
+  // Filter resource directories based on selection
+  const excludedResources = availableResources.filter((r) => !selectedResources.includes(r));
+
+  d.cpSync(d.templateDir, targetDir, {
+    recursive: true,
+    filter: (src) => {
+      const name = basename(src);
+
+      // Skip node_modules and lock file
+      if (name === 'node_modules' || name === 'pnpm-lock.yaml') {
+        return false;
+      }
+
+      for (const resource of excludedResources) {
+        // Skip entire resource directory: src/resources/{resource}/
+        if (src.includes('/resources/') && name === resource) {
+          return false;
+        }
+        // Skip simulation directories for excluded resources: tests/simulations/{resource}/
+        if (src.includes('/tests/simulations/') && name === resource) {
+          return false;
+        }
+        // Skip e2e test files for excluded resources
+        if (src.includes('/tests/e2e/') && name === `${resource}.spec.ts`) {
+          return false;
+        }
+      }
+
+      return true;
+    },
+  });
+
+  // Rename underscore-prefixed files to dotfiles
+  const dotfiles = ['_gitignore', '_prettierignore', '_prettierrc'];
+  for (const file of dotfiles) {
+    const srcPath = join(targetDir, file);
+    const destPath = join(targetDir, file.replace(/^_/, '.'));
+    if (d.existsSync(srcPath)) {
+      d.renameSync(srcPath, destPath);
+    }
+  }
+
+  // Read sunpeak version from root package.json
+  const rootPkg = JSON.parse(d.readFileSync(d.rootPkgPath, 'utf-8'));
+  const sunpeakVersion = `^${rootPkg.version}`;
+
+  // Update project package.json
+  const pkgPath = join(targetDir, 'package.json');
+  const pkg = JSON.parse(d.readFileSync(pkgPath, 'utf-8'));
+  pkg.name = projectName;
+
+  // Replace workspace:* with actual version
+  if (pkg.dependencies?.sunpeak === 'workspace:*') {
+    pkg.dependencies.sunpeak = sunpeakVersion;
+  }
+
+  d.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+
+  d.console.log(`
+Done! To get started:
+
+  cd ${projectName}
+  pnpm install
+  sunpeak dev
+
+That's it! Your project commands:
+
+  sunpeak dev       # Start dev server + MCP endpoint
+  sunpeak build     # Build for production
+  pnpm test         # Run tests
+
+See README.md for more details.
+`);
+}
+
+// Allow running directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+  const [projectName, resources] = process.argv.slice(2);
+  init(projectName, resources).catch((error) => {
+    console.error('Error:', error.message);
+    process.exit(1);
+  });
+}

package/bin/commands/pull.mjs

@@ -216,7 +216,7 @@ Examples:
 /**
  * Parse command line arguments
  */
-function parseArgs(args) {
+export function parseArgs(args) {
   const options = {};
   let i = 0;
 

package/bin/commands/push.mjs

@@ -61,23 +61,24 @@ export const defaultDeps = {
 };
 
 /**
- * Find simulation files for a resource in its directory
- * Expects files matching: {resourceName}-*-simulation.json
+ * Find simulation files for a resource in the simulations directory
+ * Expects files in: tests/simulations/{resourceName}/{resourceName}-*-simulation.json
  * Returns array of parsed simulation objects
  */
-function findSimulations(resourceDir, resourceName, deps = defaultDeps) {
+function findSimulations(simulationsDir, resourceName, deps = defaultDeps) {
   const d = { ...defaultDeps, ...deps };
 
-  if (!d.existsSync(resourceDir)) {
+  const resourceSimDir = join(simulationsDir, resourceName);
+  if (!d.existsSync(resourceSimDir)) {
     return [];
   }
 
-  const entries = d.readdirSync(resourceDir);
+  const entries = d.readdirSync(resourceSimDir);
   const simulations = [];
 
   for (const entry of entries) {
     if (isSimulationFile(entry, resourceName)) {
-      const simPath = join(resourceDir, entry);
+      const simPath = join(resourceSimDir, entry);
       try {
         const simData = JSON.parse(d.readFileSync(simPath, 'utf-8'));
         const simName = extractSimulationName(entry, resourceName);
@@ -94,9 +95,10 @@ function findSimulations(resourceDir, resourceName, deps = defaultDeps) {
 /**
  * Find all resources in a directory
  * Expects folder structure: dist/{resource}/{resource}.js
+ * Simulations are loaded from tests/simulations/{resource}/
  * Returns array of { name, jsPath, metaPath, meta, simulations }
  */
-export function findResources(distDir, deps = defaultDeps) {
+export function findResources(distDir, simulationsDir, deps = defaultDeps) {
   const d = { ...defaultDeps, ...deps };
 
   if (!d.existsSync(distDir)) {
@@ -120,7 +122,7 @@ export function findResources(distDir, deps = defaultDeps) {
         } catch {
           d.console.warn(`Warning: Could not parse ${resourceName}.json`);
         }
-        const simulations = findSimulations(resourceDir, resourceName, d);
+        const simulations = findSimulations(simulationsDir, resourceName, d);
         resources.push({ name: resourceName, dir: resourceDir, jsPath, metaPath, meta, simulations });
       }
     }
@@ -132,9 +134,10 @@ export function findResources(distDir, deps = defaultDeps) {
 /**
  * Build a resource from a resource directory path
  * Expects structure: dir/{name}.js, dir/{name}.json
+ * Simulations are loaded from tests/simulations/{name}/
  * Returns { name, jsPath, metaPath, meta, simulations }
  */
-function buildResourceFromDir(resourceDir, deps = defaultDeps) {
+function buildResourceFromDir(resourceDir, simulationsDir, deps = defaultDeps) {
   const d = { ...defaultDeps, ...deps };
 
   // Remove trailing slash if present
@@ -167,7 +170,7 @@ function buildResourceFromDir(resourceDir, deps = defaultDeps) {
     d.console.warn(`Warning: Could not parse ${name}.json`);
   }
 
-  const simulations = findSimulations(dir, name, d);
+  const simulations = findSimulations(simulationsDir, name, d);
 
   return { name, jsPath, metaPath, meta, simulations };
 }
@@ -281,6 +284,7 @@ Usage:
 Options:
   -r, --repository <owner/repo>  Repository name (defaults to git remote origin)
   -t, --tag <name>               Tag to assign (can be specified multiple times)
+  --no-simulations               Skip pushing simulations, only push resources
   -h, --help                     Show this help message
 
 Arguments:
@@ -293,6 +297,7 @@ Examples:
   sunpeak push -r myorg/my-app   Push to "myorg/my-app" repository
   sunpeak push -t v1.0.0         Push with a version tag
   sunpeak push -t v1.0.0 -t prod Push with multiple tags
+  sunpeak push --no-simulations  Push resources without simulations
 `);
     return;
   }
@@ -314,10 +319,11 @@ Examples:
   }
 
   // Find resources - either a specific directory or all from dist directory
+  const simulationsDir = join(projectRoot, 'tests/simulations');
   let resources;
   if (options.dir) {
     // Push a single specific resource from directory
-    resources = [buildResourceFromDir(options.dir, d)];
+    resources = [buildResourceFromDir(options.dir, simulationsDir, d)];
   } else {
     // Default: find all resources in dist directory
     const distDir = join(projectRoot, 'dist');
@@ -327,7 +333,7 @@ Examples:
       d.process.exit(1);
     }
 
-    resources = findResources(distDir, d);
+    resources = findResources(distDir, simulationsDir, d);
     if (resources.length === 0) {
       d.console.error(`Error: No resources found in dist/`);
       d.console.error('Run "sunpeak build" first to build your resources.');
@@ -335,10 +341,20 @@ Examples:
     }
   }
 
+  // Clear simulations if --no-simulations flag is set
+  if (options.noSimulations) {
+    for (const resource of resources) {
+      resource.simulations = [];
+    }
+  }
+
   d.console.log(`Pushing ${resources.length} resource(s) to repository "${repository}"...`);
   if (options.tags && options.tags.length > 0) {
     d.console.log(`Tags: ${options.tags.join(', ')}`);
   }
+  if (options.noSimulations) {
+    d.console.log('Simulations: skipped');
+  }
   d.console.log();
 
   // Push each resource
@@ -354,6 +370,9 @@ Examples:
       successCount++;
     } catch (error) {
       d.console.error(`✗ Failed to push ${resource.name}: ${error.message}`);
+      if (error.message.includes('Uri must be unique')) {
+        d.console.error('  You are trying to push a build that has already been pushed.');
+      }
     }
   }
 
@@ -369,7 +388,7 @@ Examples:
 /**
  * Parse command line arguments
  */
-function parseArgs(args) {
+export function parseArgs(args) {
   const options = { tags: [] };
   let i = 0;
 
@@ -380,6 +399,8 @@ function parseArgs(args) {
       options.repository = args[++i];
     } else if (arg === '--tag' || arg === '-t') {
       options.tags.push(args[++i]);
+    } else if (arg === '--no-simulations') {
+      options.noSimulations = true;
     } else if (arg === '--help' || arg === '-h') {
       console.log(`
 sunpeak push - Push resources to the Sunpeak repository
@@ -390,6 +411,7 @@ Usage:
 Options:
   -r, --repository <owner/repo>  Repository name (defaults to git remote origin)
   -t, --tag <name>               Tag to assign (can be specified multiple times)
+  --no-simulations               Skip pushing simulations, only push resources
   -h, --help                     Show this help message
 
 Arguments:
@@ -402,6 +424,7 @@ Examples:
   sunpeak push -r myorg/my-app   Push to "myorg/my-app" repository
   sunpeak push -t v1.0.0         Push with a version tag
   sunpeak push -t v1.0.0 -t prod Push with multiple tags
+  sunpeak push --no-simulations  Push resources without simulations
 `);
       process.exit(0);
     } else if (!arg.startsWith('-')) {

package/bin/lib/patterns.mjs

@@ -3,6 +3,31 @@
  * These mirror the patterns in src/lib/discovery.ts for consistency.
  */
 
+import { existsSync, readdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+/**
+ * Auto-discover available resources from template/src/resources directories.
+ * Each subdirectory containing a {name}-resource.tsx file is a valid resource.
+ * @returns {string[]} Array of resource names
+ */
+export function discoverResources() {
+  const resourcesDir = join(__dirname, '..', '..', 'template', 'src', 'resources');
+  if (!existsSync(resourcesDir)) {
+    return [];
+  }
+  return readdirSync(resourcesDir, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory())
+    .filter((entry) => {
+      const resourceFile = join(resourcesDir, entry.name, `${entry.name}-resource.tsx`);
+      return existsSync(resourceFile);
+    })
+    .map((entry) => entry.name);
+}
+
 /**
  * Convert a kebab-case string to PascalCase
  * @param {string} str