@pega/sdk 0.0.1

package/dist/index.js

@@ -0,0 +1,753 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import path2 from "path";
+
+// src/scaffold.ts
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+import { spawn } from "child_process";
+
+// src/component-map-generator.ts
+var FIELD_COMPONENTS = [
+  { importName: "AutoComplete", importPath: "./field/AutoComplete" },
+  { importName: "CancelAlert", importPath: "./field/CancelAlert" },
+  { importName: "Checkbox", importPath: "./field/Checkbox" },
+  { importName: "Currency", importPath: "./field/Currency" },
+  { importName: "DateField", importPath: "./field/Date", registryName: "Date" },
+  { importName: "DateTime", importPath: "./field/DateTime" },
+  { importName: "Decimal", importPath: "./field/Decimal" },
+  { importName: "Dropdown", importPath: "./field/Dropdown" },
+  { importName: "Email", importPath: "./field/Email/Email" },
+  { importName: "Group", importPath: "./field/Group" },
+  { importName: "Integer", importPath: "./field/Integer" },
+  { importName: "Location", importPath: "./field/Location" },
+  { importName: "Multiselect", importPath: "./field/Multiselect/Multiselect" },
+  { importName: "ObjectReference", importPath: "./field/ObjectReference" },
+  { importName: "Percentage", importPath: "./field/Percentage" },
+  { importName: "Phone", importPath: "./field/Phone/Phone" },
+  { importName: "RadioButtons", importPath: "./field/RadioButtons" },
+  { importName: "RichText", importPath: "./field/RichText" },
+  { importName: "ScalarList", importPath: "./field/ScalarList" },
+  { importName: "SelectableCard", importPath: "./field/SelectableCard" },
+  { importName: "SemanticLink", importPath: "./field/SemanticLink" },
+  { importName: "TextArea", importPath: "./field/TextArea" },
+  { importName: "TextContent", importPath: "./field/TextContent" },
+  { importName: "TextInput", importPath: "./field/TextInput/TextInput" },
+  { importName: "Time", importPath: "./field/Time" },
+  {
+    importName: "URLComponent",
+    importPath: "./field/URL",
+    registryName: "URL"
+  },
+  { importName: "UserReference", importPath: "./field/UserReference" }
+];
+var TEMPLATE_COMPONENTS = [
+  { importName: "AdvancedSearch", importPath: "./template/AdvancedSearch" },
+  { importName: "AppShell", importPath: "./template/AppShell/AppShell" },
+  { importName: "BannerPage", importPath: "./template/BannerPage" },
+  { importName: "CaseSummary", importPath: "./template/CaseSummary" },
+  { importName: "CaseView", importPath: "./template/CaseView" },
+  {
+    importName: "CaseViewActionsMenu",
+    importPath: "./template/CaseViewActionsMenu"
+  },
+  { importName: "Confirmation", importPath: "./template/Confirmation" },
+  { importName: "DataReference", importPath: "./template/DataReference" },
+  { importName: "DefaultForm", importPath: "./template/DefaultForm" },
+  { importName: "DefaultPage", importPath: "./template/DefaultPage" },
+  { importName: "Details", importPath: "./template/Details/Details" },
+  {
+    importName: "DetailsSubTabs",
+    importPath: "./template/Details/DetailsSubTabs"
+  },
+  {
+    importName: "DetailsThreeColumn",
+    importPath: "./template/Details/DetailsThreeColumn"
+  },
+  {
+    importName: "DetailsTwoColumn",
+    importPath: "./template/Details/DetailsTwoColumn/DetailsTwoColumn"
+  },
+  { importName: "DynamicTabs", importPath: "./template/Details/DynamicTabs" },
+  {
+    importName: "FieldGroupTemplate",
+    importPath: "./template/FieldGroupTemplate"
+  },
+  { importName: "HierarchicalForm", importPath: "./template/HierarchicalForm" },
+  { importName: "InlineDashboard", importPath: "./template/InlineDashboard" },
+  {
+    importName: "InlineDashboardPage",
+    importPath: "./template/InlineDashboardPage/InlineDashboardPage"
+  },
+  { importName: "ListPage", importPath: "./template/ListPage/ListPage" },
+  { importName: "ListView", importPath: "./template/ListView" },
+  {
+    importName: "MultiReferenceReadOnly",
+    importPath: "./template/MultiReferenceReadOnly"
+  },
+  { importName: "NarrowWide", importPath: "./template/NarrowWide/NarrowWide" },
+  {
+    importName: "NarrowWideDetails",
+    importPath: "./template/NarrowWide/NarrowWideDetails"
+  },
+  {
+    importName: "NarrowWideForm",
+    importPath: "./template/NarrowWide/NarrowWideForm"
+  },
+  {
+    importName: "NarrowWidePage",
+    importPath: "./template/NarrowWide/NarrowWidePage"
+  },
+  { importName: "ObjectPage", importPath: "./template/ObjectPage" },
+  { importName: "OneColumn", importPath: "./template/OneColumn/OneColumn" },
+  {
+    importName: "OneColumnPage",
+    importPath: "./template/OneColumn/OneColumnPage"
+  },
+  {
+    importName: "OneColumnTab",
+    importPath: "./template/OneColumn/OneColumnTab"
+  },
+  { importName: "PromotedFilters", importPath: "./template/PromotedFilters" },
+  {
+    importName: "SearchForm",
+    importPath: "./template/DataReference/SearchForm"
+  },
+  {
+    importName: "SearchGroups",
+    importPath: "./template/AdvancedSearch/SearchGroups"
+  },
+  {
+    importName: "SelfServiceCaseView",
+    importPath: "./template/SelfServiceCaseView"
+  },
+  {
+    importName: "SimpleTable",
+    importPath: "./template/SimpleTable/SimpleTable"
+  },
+  {
+    importName: "SimpleTableManual",
+    importPath: "./template/SimpleTable/SimpleTableManual"
+  },
+  {
+    importName: "SimpleTableSelect",
+    importPath: "./template/SimpleTable/SimpleTableSelect"
+  },
+  {
+    importName: "SimpleTableSelectReadonly",
+    importPath: "./template/SimpleTable/SimpleTableSelectReadonly"
+  },
+  {
+    importName: "SingleReferenceReadOnly",
+    importPath: "./template/SingleReferenceReadOnly"
+  },
+  { importName: "SubTabs", importPath: "./template/SubTabs" },
+  { importName: "TwoColumn", importPath: "./template/TwoColumn/TwoColumn" },
+  {
+    importName: "TwoColumnPage",
+    importPath: "./template/TwoColumn/TwoColumnPage"
+  },
+  {
+    importName: "TwoColumnTab",
+    importPath: "./template/TwoColumn/TwoColumnTab"
+  },
+  { importName: "WideNarrow", importPath: "./template/WideNarrow/WideNarrow" },
+  {
+    importName: "WideNarrowDetails",
+    importPath: "./template/WideNarrow/WideNarrowDetails"
+  },
+  {
+    importName: "WideNarrowForm",
+    importPath: "./template/WideNarrow/WideNarrowForm"
+  },
+  {
+    importName: "WideNarrowPage",
+    importPath: "./template/WideNarrow/WideNarrowPage"
+  },
+  { importName: "WssNavBar", importPath: "./template/WssNavBar/WssNavBar" }
+];
+var WIDGET_COMPONENTS = [
+  { importName: "AppAnnouncement", importPath: "./widget/AppAnnouncement" },
+  { importName: "Attachment", importPath: "./widget/Attachment" },
+  { importName: "CaseHistory", importPath: "./widget/CaseHistory" },
+  {
+    importName: "ActionButtonsForFileUtil",
+    importPath: "./widget/FileUtility/ActionButtonsForFileUtil"
+  },
+  { importName: "FileUtility", importPath: "./widget/FileUtility/FileUtility" },
+  { importName: "Followers", importPath: "./widget/Followers" },
+  { importName: "QuickCreate", importPath: "./widget/QuickCreate" },
+  { importName: "SummaryItem", importPath: "./widget/SummaryItem" },
+  { importName: "SummaryList", importPath: "./widget/SummaryList" },
+  { importName: "ToDo", importPath: "./widget/ToDo" }
+];
+var INFRA_COMPONENTS = [
+  { importName: "ActionButtons", importPath: "./infra/ActionButtons" },
+  { importName: "DeferLoad", importPath: "./infra/DeferLoad" },
+  { importName: "NavBar", importPath: "./infra/NavBar" },
+  { importName: "Stages", importPath: "./infra/Stages" },
+  { importName: "DashboardFilter", importPath: "./infra/DashboardFilter" },
+  {
+    importName: "VerticalTabs",
+    importPath: "./infra/VerticalTabs/VerticalTabs"
+  },
+  {
+    importName: "LeftAlignVerticalTabs",
+    importPath: "./infra/VerticalTabs/LeftAlignVerticalTabs"
+  }
+];
+var DSE_COMPONENTS = [
+  {
+    importName: "AlertBanner",
+    importPath: "./designSystemExtension/AlertBanner"
+  },
+  { importName: "Banner", importPath: "./designSystemExtension/Banner" },
+  {
+    importName: "CaseSummaryFields",
+    importPath: "./designSystemExtension/CaseSummaryFields"
+  },
+  {
+    importName: "DetailsFields",
+    importPath: "./designSystemExtension/DetailsFields"
+  },
+  {
+    importName: "FieldGroup",
+    importPath: "./designSystemExtension/FieldGroup"
+  },
+  {
+    importName: "FieldGroupList",
+    importPath: "./designSystemExtension/FieldGroupList"
+  },
+  {
+    importName: "FieldValueList",
+    importPath: "./designSystemExtension/FieldValueList"
+  },
+  { importName: "Operator", importPath: "./designSystemExtension/Operator" },
+  { importName: "Pulse", importPath: "./designSystemExtension/Pulse" },
+  {
+    importName: "RichTextEditor",
+    importPath: "./designSystemExtension/RichTextEditor"
+  },
+  {
+    importName: "WssQuickCreate",
+    importPath: "./designSystemExtension/WssQuickCreate"
+  }
+];
+var CATEGORY_MAP = {
+  fields: FIELD_COMPONENTS,
+  templates: TEMPLATE_COMPONENTS,
+  widgets: WIDGET_COMPONENTS,
+  infra: INFRA_COMPONENTS,
+  designSystemExtension: DSE_COMPONENTS
+};
+var CATEGORY_COMMENT = {
+  fields: "Fields",
+  templates: "Templates",
+  widgets: "Widgets",
+  infra: "Infra",
+  designSystemExtension: "Design System Extension"
+};
+function generateComponentMap(categories, _framework) {
+  const imports = [];
+  const mapEntries = [];
+  imports.push(`import { sdkComponents } from '@pega/sdk-react';`);
+  imports.push(`import type { ComponentRegistry } from '@pega/sdk-types';`);
+  imports.push("");
+  for (const category of categories) {
+    const components = CATEGORY_MAP[category];
+    if (!components) continue;
+    imports.push(`// ${CATEGORY_COMMENT[category]}`);
+    for (const comp of components) {
+      imports.push(`import ${comp.importName} from '${comp.importPath}';`);
+    }
+    imports.push("");
+    mapEntries.push(`    // ${CATEGORY_COMMENT[category]}`);
+    for (const comp of components) {
+      const regName = comp.registryName || comp.importName;
+      if (regName !== comp.importName) {
+        mapEntries.push(`    ${regName}: ${comp.importName},`);
+      } else {
+        mapEntries.push(`    ${comp.importName},`);
+      }
+    }
+    mapEntries.push("");
+  }
+  const body = `${imports.join("\n")}
+/**
+ * Returns a map of Pega component names \u2192 sample React components.
+ */
+function getSampleComponentMap(): Record<string, React.ComponentType<Record<string, unknown>>> {
+  return {
+    // Infrastructure from sdk-react (View, Region, Reference, RootContainer, etc.)
+    ...sdkComponents,
+
+${mapEntries.join("\n")}  };
+}
+
+/**
+ * Registers all sample components into the given registry.
+ */
+export function registerSampleComponents(registry: ComponentRegistry<React.ComponentType<Record<string, unknown>>>) {
+  const map = getSampleComponentMap();
+  for (const [name, component] of Object.entries(map)) {
+    registry.register(name, component);
+  }
+}
+`;
+  return body;
+}
+
+// src/scaffold.ts
+var __dirname = path.dirname(fileURLToPath(import.meta.url));
+var MONOREPO_SAMPLES_DIR = path.resolve(
+  __dirname,
+  "..",
+  "..",
+  "..",
+  "samples"
+);
+var PACKAGED_TEMPLATES_DIR = path.resolve(__dirname, "..", "templates");
+function resolveTemplateSourceRoot() {
+  if (fs.existsSync(MONOREPO_SAMPLES_DIR)) {
+    return MONOREPO_SAMPLES_DIR;
+  }
+  if (fs.existsSync(PACKAGED_TEMPLATES_DIR)) {
+    return PACKAGED_TEMPLATES_DIR;
+  }
+  throw new Error(
+    `Template source not found. Expected either ${MONOREPO_SAMPLES_DIR} or ${PACKAGED_TEMPLATES_DIR}.`
+  );
+}
+var FRAMEWORK_SAMPLE_MAP = {
+  react: "react-sdk-reference",
+  angular: "angular-sdk-reference",
+  "web-components": "wc-sdk-reference",
+  "react-native": "react-native-sdk-reference"
+};
+var CATEGORY_DIR_MAP = {
+  fields: "field",
+  templates: "template",
+  widgets: "widget",
+  infra: "infra",
+  designSystemExtension: "designSystemExtension"
+};
+var SKIP_ENTRIES = /* @__PURE__ */ new Set([
+  "node_modules",
+  "dist",
+  ".DS_Store",
+  ".next",
+  ".expo",
+  ".angular"
+]);
+function shouldSkipFile(name) {
+  return name.endsWith(".tgz");
+}
+async function scaffold(choices, targetDir, onProgress) {
+  const report = (message) => onProgress?.(message);
+  const {
+    framework,
+    aiTool,
+    includeTemplates,
+    componentCategories,
+    projectName
+  } = choices;
+  report("Preparing project directory\u2026");
+  if (fs.existsSync(targetDir)) {
+    const files = fs.readdirSync(targetDir);
+    if (files.length > 0) {
+      throw new Error(`Directory "${targetDir}" is not empty.`);
+    }
+  } else {
+    fs.mkdirSync(targetDir, { recursive: true });
+  }
+  const templateSourceRoot = resolveTemplateSourceRoot();
+  const sampleName = FRAMEWORK_SAMPLE_MAP[framework];
+  const sampleDir = path.join(templateSourceRoot, sampleName);
+  if (!fs.existsSync(sampleDir)) {
+    throw new Error(`Template "${sampleName}" not found at ${sampleDir}.`);
+  }
+  report(`Copying ${sampleName} reference app\u2026`);
+  copyDir(sampleDir, targetDir);
+  report("Configuring component set\u2026");
+  const componentsDir = path.join(targetDir, "src", "components");
+  if (fs.existsSync(componentsDir)) {
+    if (!includeTemplates || componentCategories.length === 0) {
+      for (const cat of Object.values(CATEGORY_DIR_MAP)) {
+        const catDir = path.join(componentsDir, cat);
+        if (fs.existsSync(catDir)) {
+          fs.rmSync(catDir, { recursive: true });
+        }
+      }
+      fs.writeFileSync(
+        path.join(componentsDir, "component-map.ts"),
+        generateMinimalComponentMap()
+      );
+    } else {
+      const allCategories = [
+        "fields",
+        "templates",
+        "widgets",
+        "infra",
+        "designSystemExtension"
+      ];
+      for (const cat of allCategories) {
+        if (!componentCategories.includes(cat)) {
+          const catDir = path.join(componentsDir, CATEGORY_DIR_MAP[cat]);
+          if (fs.existsSync(catDir)) {
+            fs.rmSync(catDir, { recursive: true });
+          }
+        }
+      }
+      const componentMapContent = generateComponentMap(
+        componentCategories,
+        framework
+      );
+      fs.writeFileSync(
+        path.join(componentsDir, "component-map.ts"),
+        componentMapContent
+      );
+    }
+  }
+  if (!aiTool) {
+    for (const dir of [".github", ".cursor", "AGENTS.md"]) {
+      const target = path.join(targetDir, dir);
+      if (fs.existsSync(target)) {
+        fs.rmSync(target, { recursive: true });
+      }
+    }
+  } else {
+    const AI_TOOL_PATHS = {
+      copilot: [".github"],
+      cursor: [".cursor"],
+      "claude-code": ["AGENTS.md"]
+    };
+    const allAiPaths = Object.values(AI_TOOL_PATHS).flat();
+    const keepPaths = AI_TOOL_PATHS[aiTool];
+    for (const dir of allAiPaths) {
+      if (!keepPaths.includes(dir)) {
+        const target = path.join(targetDir, dir);
+        if (fs.existsSync(target)) {
+          fs.rmSync(target, { recursive: true });
+        }
+      }
+    }
+  }
+  report("Finalizing project configuration\u2026");
+  transformPackageJson(path.join(targetDir, "package.json"), projectName);
+  transformTsConfig(path.join(targetDir, "tsconfig.json"));
+  report("Installing dependencies (this may take a minute)\u2026");
+  try {
+    await runInstall(targetDir);
+  } catch {
+  }
+}
+function runInstall(cwd) {
+  return new Promise((resolve, reject) => {
+    const child = spawn("npm", ["install"], {
+      cwd,
+      stdio: "ignore",
+      shell: process.platform === "win32"
+    });
+    child.on("error", reject);
+    child.on("close", (code) => {
+      if (code === 0) resolve();
+      else reject(new Error(`npm install exited with code ${code}`));
+    });
+  });
+}
+function transformPackageJson(pkgJsonPath, projectName) {
+  if (!fs.existsSync(pkgJsonPath)) return;
+  const pkgJson = JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8"));
+  pkgJson.name = projectName;
+  delete pkgJson.private;
+  const fileDepsMap = {
+    "@pega/auth": "^0.2.42",
+    "@pega/constellationjs": "^0.26.2"
+  };
+  for (const section of ["dependencies", "devDependencies"]) {
+    const deps = pkgJson[section];
+    if (!deps) continue;
+    for (const [name, version] of Object.entries(deps)) {
+      if (typeof version === "string" && version.startsWith("file:")) {
+        deps[name] = fileDepsMap[name] || "*";
+      }
+    }
+  }
+  fs.writeFileSync(pkgJsonPath, JSON.stringify(pkgJson, null, 2) + "\n");
+}
+function transformTsConfig(tsconfigPath) {
+  if (!fs.existsSync(tsconfigPath)) return;
+  const tsconfig = JSON.parse(fs.readFileSync(tsconfigPath, "utf-8"));
+  if (tsconfig.compilerOptions) {
+    if (tsconfig.compilerOptions.paths) {
+      const cleanedPaths = {};
+      for (const [key, value] of Object.entries(
+        tsconfig.compilerOptions.paths
+      )) {
+        const isMonorepoPath = value.some(
+          (p2) => p2.includes("../../packages/")
+        );
+        if (!isMonorepoPath) {
+          cleanedPaths[key] = value;
+        }
+      }
+      if (Object.keys(cleanedPaths).length > 0) {
+        tsconfig.compilerOptions.paths = cleanedPaths;
+      } else {
+        delete tsconfig.compilerOptions.paths;
+      }
+    }
+    if (tsconfig.compilerOptions.typeRoots) {
+      tsconfig.compilerOptions.typeRoots = [
+        "./node_modules/@types",
+        "./node_modules/@pega"
+      ];
+    }
+  }
+  fs.writeFileSync(tsconfigPath, JSON.stringify(tsconfig, null, 2) + "\n");
+}
+function generateMinimalComponentMap() {
+  return `import { sdkComponents } from '@pega/sdk-react';
+import type { ComponentRegistry } from '@pega/sdk-types';
+
+/**
+ * Returns a map of Pega component names \u2192 React components.
+ * Add your own components here as you build them.
+ */
+function getSampleComponentMap(): Record<string, React.ComponentType<Record<string, unknown>>> {
+  return {
+    ...sdkComponents,
+  };
+}
+
+/**
+ * Registers all components into the given registry.
+ */
+export function registerSampleComponents(
+  registry: ComponentRegistry<React.ComponentType<Record<string, unknown>>>,
+) {
+  const map = getSampleComponentMap();
+  for (const [name, component] of Object.entries(map)) {
+    registry.register(name, component);
+  }
+}
+`;
+}
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (SKIP_ENTRIES.has(entry.name)) continue;
+    if (!entry.isDirectory() && shouldSkipFile(entry.name)) continue;
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+// src/index.ts
+async function main() {
+  console.clear();
+  p.intro(pc.bgCyan(pc.black(" @pega/sdk ")));
+  const args = process.argv.slice(2);
+  const command = args[0];
+  if (command !== "init") {
+    p.log.error(
+      `Unknown command "${command ?? ""}".
+
+Usage: ${pc.cyan("npx @pega/sdk init")}`
+    );
+    process.exit(1);
+  }
+  const nameResult = await p.text({
+    message: "What is the name of your project?",
+    placeholder: "my-pega-app",
+    validate(value) {
+      if (!value) return "Project name is required.";
+      if (!/^[a-z0-9@][a-z0-9._/-]*$/.test(value))
+        return "Invalid project name. Use lowercase letters, numbers, hyphens, and dots.";
+    }
+  });
+  if (p.isCancel(nameResult)) {
+    p.cancel("Operation cancelled.");
+    process.exit(0);
+  }
+  const projectName = nameResult;
+  const aiIntegration = await p.confirm({
+    message: "Include AI-assisted development setup? (adds agent instructions and skill files for your AI coding tool)",
+    initialValue: true
+  });
+  if (p.isCancel(aiIntegration)) {
+    p.cancel("Operation cancelled.");
+    process.exit(0);
+  }
+  let aiTool = null;
+  if (aiIntegration) {
+    const aiToolResult = await p.select({
+      message: "Which AI coding tool will you use?",
+      options: [
+        {
+          value: "copilot",
+          label: "GitHub Copilot",
+          hint: ".github/copilot-instructions.md + skill files"
+        },
+        {
+          value: "cursor",
+          label: "Cursor",
+          hint: ".cursor/rules/ + skill files"
+        },
+        {
+          value: "claude-code",
+          label: "Claude Code",
+          hint: "AGENTS.md + skill files"
+        }
+      ]
+    });
+    if (p.isCancel(aiToolResult)) {
+      p.cancel("Operation cancelled.");
+      process.exit(0);
+    }
+    aiTool = aiToolResult;
+  }
+  const framework = await p.select({
+    message: "Select a UI framework for your Pega SDK project:",
+    options: [
+      {
+        value: "react",
+        label: "React",
+        hint: "Vite + React 18 + @pega/sdk-react"
+      },
+      {
+        value: "angular",
+        label: "Angular",
+        hint: "Angular 18 + @pega/sdk-angular"
+      },
+      {
+        value: "web-components",
+        label: "Web Components",
+        hint: "Vite + Lit + @pega/sdk-wc"
+      },
+      {
+        value: "react-native",
+        label: "React Native",
+        hint: "Expo + @pega/sdk-react (experimental)"
+      }
+    ]
+  });
+  if (p.isCancel(framework)) {
+    p.cancel("Operation cancelled.");
+    process.exit(0);
+  }
+  const includeTemplates = await p.confirm({
+    message: "Include starter component implementations? (scaffolds working component files you can customize)",
+    initialValue: true
+  });
+  if (p.isCancel(includeTemplates)) {
+    p.cancel("Operation cancelled.");
+    process.exit(0);
+  }
+  let componentCategories = [];
+  if (includeTemplates) {
+    const categories = await p.multiselect({
+      message: "Which component types do you want scaffolded?",
+      options: [
+        {
+          value: "fields",
+          label: "Fields",
+          hint: "TextInput, Dropdown, Checkbox, Date, etc."
+        },
+        {
+          value: "templates",
+          label: "Templates",
+          hint: "OneColumn, TwoColumn, CaseView, DefaultForm, etc."
+        },
+        {
+          value: "widgets",
+          label: "Widgets",
+          hint: "Attachment, CaseHistory, ToDo, etc."
+        },
+        {
+          value: "infra",
+          label: "Infrastructure",
+          hint: "NavBar, ActionButtons, Stages, etc."
+        },
+        {
+          value: "designSystemExtension",
+          label: "Design System Extensions",
+          hint: "AlertBanner, FieldGroup, Pulse, etc."
+        }
+      ],
+      required: true
+    });
+    if (p.isCancel(categories)) {
+      p.cancel("Operation cancelled.");
+      process.exit(0);
+    }
+    componentCategories = categories;
+  }
+  const targetDir = path2.resolve(process.cwd(), projectName);
+  p.note(
+    [
+      `${pc.bold("Project")}:       ${projectName}`,
+      `${pc.bold("Directory")}:     ${targetDir}`,
+      `${pc.bold("Framework")}:     ${framework}`,
+      `${pc.bold("AI Tool")}:       ${aiTool ?? "None"}`,
+      `${pc.bold("Components")}:    ${includeTemplates ? componentCategories.join(", ") : "None"}`
+    ].join("\n"),
+    "Project Configuration"
+  );
+  const confirmed = await p.confirm({
+    message: "Proceed with scaffolding?",
+    initialValue: true
+  });
+  if (p.isCancel(confirmed) || !confirmed) {
+    p.cancel("Operation cancelled.");
+    process.exit(0);
+  }
+  const choices = {
+    projectName,
+    framework,
+    aiTool,
+    includeTemplates,
+    componentCategories
+  };
+  const spinner2 = p.spinner();
+  spinner2.start("Scaffolding your project\u2026");
+  try {
+    await scaffold(choices, targetDir, (message) => {
+      spinner2.message(message);
+    });
+    spinner2.stop("Project scaffolded successfully!");
+  } catch (err) {
+    spinner2.stop("Failed to scaffold project.");
+    p.log.error(String(err));
+    process.exit(1);
+  }
+  p.note(
+    [
+      `cd ${projectName}`,
+      "",
+      "# Configure your Pega server connection:",
+      "Edit sdk-config.json with your server URL, app alias, and credentials.",
+      "",
+      "# Install dependencies:",
+      "npm install",
+      "",
+      "# Start the development server:",
+      "npm run dev"
+    ].join("\n"),
+    "Next Steps"
+  );
+  p.outro(pc.green("Happy coding! \u{1F680}"));
+}
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});