@pega/sdk 0.0.3 → 0.0.5

package/templates/react-sdk-reference/.claude/instructions/field-component.md

@@ -1,71 +0,0 @@
-<!-- Applies to: src/components/field/**/*.tsx -->
-
-# Field Component Rules
-
-When creating or modifying field components, follow these rules:
-
-## Required Structure
-
-1. **Import types from `@pega/sdk-react`**:
-   ```typescript
-   import type { PConnFieldProps } from '@pega/sdk-react';
-   ```
-
-2. **Define a props interface extending `PConnFieldProps`**:
-   ```typescript
-   interface MyFieldProps extends PConnFieldProps {
-     // additional props specific to this field
-   }
-   ```
-
-3. **Export as default function component**:
-   ```typescript
-   export default function MyField(props: MyFieldProps) { ... }
-   ```
-
-## Required Behaviors
-
-1. **Extract standard props**: `getPConnect`, `label`, `required`, `disabled`, `value`, `validatemessage`, `status`, `readOnly`, `testId`, `helperText`, `displayMode`, `hideLabel`, `placeholder`
-
-2. **Get PConnect APIs**:
-   ```typescript
-   const pConn = getPConnect();
-   const actions = pConn.getActionsApi();
-   const propName = (pConn.getStateProps() as any).value;
-   ```
-
-3. **Handle displayMode** (MUST be before the main return):
-   ```typescript
-   if (displayMode === 'DISPLAY_ONLY') {
-     return <FieldValueList name={hideLabel ? '' : label} value={value} />;
-   }
-   if (displayMode === 'STACKED_LARGE_VAL') {
-     return <FieldValueList name={hideLabel ? '' : label} value={value} variant='stacked' />;
-   }
-   ```
-
-4. **Use local state + blur pattern**:
-   - `onChange` → update local state only
-   - `onBlur` → call `handleEvent(actions, 'changeNblur', propName, localValue)`
-
-5. **Show validation**: Display `validatemessage` and apply error styling when `status === 'error'`
-
-6. **Pass test ID**: Set `data-test-id={testId}` on the interactive element
-
-7. **Use `getComponentFromRegistry('FieldValueList')`** — never hardcode FieldValueList import
-
-## Visual Preservation
-
-The replacement must look the same as the original component:
-
-1. **Read any `.css` file in the directory first.** Note every class's visual intent (spacing, sizing, colors, layout).
-2. Replicate those styles via inline `style` props, {{designSystem}} component props/variants, or by keeping the CSS import — whichever produces the closest match.
-3. Do NOT silently drop `makeStyles` classes — map each one to an equivalent style.
-
-## Do NOT
-
-- Skip `displayMode` handling — it breaks read-only views
-- Call `handleEvent` on every keystroke — only on blur
-- Hardcode component imports for components that exist in the registry
-- Remove the `handleEvent` import from `../../helpers/event-utils`
-- Drop visual styles when removing `makeStyles` — always map them to an equivalent

package/templates/react-sdk-reference/.claude/instructions/template-component.md

@@ -1,92 +0,0 @@
-<!-- Applies to: src/components/template/**/*.tsx -->
-
-# Template Component Rules
-
-When creating or modifying template/layout components, follow these rules:
-
-## Required Structure
-
-1. **Import types from `@pega/sdk-react`**:
-   ```typescript
-   import type { PConnProps } from '@pega/sdk-react';
-   ```
-
-2. **Export as default function component**:
-   ```typescript
-   export default function MyTemplate(props: MyTemplateProps) { ... }
-   ```
-
-## Template Categories
-
-### Layout Templates (TwoColumn, OneColumn, NarrowWide, WideNarrow)
-
-Receive React `children` directly:
-
-```typescript
-import type { PropsWithChildren, ReactElement } from 'react';
-
-interface TwoColumnProps extends PConnProps {
-  templateCol?: string;  // e.g. "1fr 1fr", "2fr 1fr"
-}
-
-export default function TwoColumn(props: PropsWithChildren<TwoColumnProps>) {
-  const { children, templateCol = '1fr 1fr' } = props;
-  const childrenToRender = children as ReactElement[];
-  // Render childrenToRender[0], childrenToRender[1], etc. in grid columns
-}
-```
-
-### Form/View Templates (DefaultForm, Details, CaseView)
-
-Render children via `getPConnect().getChildren()`:
-
-```typescript
-export default function DefaultForm(props: DefaultFormProps) {
-  const { getPConnect } = props;
-  const pConn = getPConnect();
-  const children = pConn.getChildren() as any[];
-
-  return (
-    <div>
-      {children.map((child, i) => (
-        <PConnectComponent key={i} getPConnect={() => child.getPConnect()} />
-      ))}
-    </div>
-  );
-}
-```
-
-### Page Templates (OneColumnPage, TwoColumnPage)
-
-Wrap a layout with page-level chrome (title, actions):
-
-```typescript
-export default function OneColumnPage(props: PageProps) {
-  const { getPConnect, children } = props;
-  const pConn = getPConnect();
-  const title = pConn.getDataObject('')?.caseInfo?.name;
-
-  return (
-    <div>
-      <h1>{title}</h1>
-      {children}
-    </div>
-  );
-}
-```
-
-## Visual Preservation
-
-The replacement must look the same as the original component:
-
-1. **Read any `.css` file in the directory first.** Note every class's visual intent (spacing, sizing, colors, layout).
-2. Replicate those styles via inline `style` props, the new design system's layout props, or by keeping the CSS import — whichever produces the closest match.
-3. Do NOT silently drop `makeStyles` classes — map each one to an equivalent style.
-
-## Key Rules
-
-- Use `PConnectComponent` from `@pega/sdk-react` to render PConnect children
-- Grid proportions come from `templateCol` prop — parse it to calculate column ratios
-- Templates must not call `handleEvent` or interact with field state
-- Templates are layout-only — they arrange, not edit
-- Do NOT drop column gap, padding, or alignment styles when removing MUI `Grid` — replicate them in the replacement layout

package/templates/react-sdk-reference/.claude/instructions/widget-component.md

@@ -1,87 +0,0 @@
-<!-- Applies to: src/components/widget/**/*.tsx -->
-
-# Widget Component Rules
-
-When creating or modifying widget components, follow these rules:
-
-## Required Structure
-
-1. **Import types from `@pega/sdk-react`**:
-   ```typescript
-   import type { PConnProps } from '@pega/sdk-react';
-   // or PConnFieldProps if the widget behaves like a field (e.g., Attachment)
-   ```
-
-2. **Export as default function component**:
-   ```typescript
-   export default function MyWidget(props: MyWidgetProps) { ... }
-   ```
-
-## Widget Patterns
-
-### Data-Fetching Widget (ToDo, CaseHistory, Followers)
-
-Fetches data from Pega data pages on mount:
-
-```typescript
-export default function MyWidget(props: MyWidgetProps) {
-  const { getPConnect, datasource, headerText } = props;
-  const pConn = getPConnect();
-  const [data, setData] = useState<any[]>([]);
-
-  useEffect(() => {
-    const context = pConn.getContextName();
-    PCore.getDataPageUtils()
-      .getDataAsync(datasource?.source, context, {})
-      .then((response: any) => {
-        setData(response.data || []);
-      });
-  }, []);
-
-  return (
-    <Card>
-      <CardHeader title={headerText} />
-      <CardContent>{/* render data */}</CardContent>
-    </Card>
-  );
-}
-```
-
-### Action Widget (ToDo)
-
-Triggers case actions:
-
-```typescript
-// Get assignments and trigger actions
-import { getToDoAssignments } from '@pega/sdk-react';
-
-const assignments = getToDoAssignments(getPConnect);
-// Each assignment has: onClick callback, urgency, name, etc.
-```
-
-### File Widget (Attachment, FileUtility)
-
-Handles file upload/download via PCore attachment APIs:
-
-```typescript
-PCore.getAttachmentUtils().uploadAttachment(file, onUploadProgress, errorHandler, context);
-PCore.getAttachmentUtils().downloadAttachment(attachmentId, context);
-```
-
-## Visual Preservation
-
-The replacement must look the same as the original component:
-
-1. **Read any `.css` file in the directory first.** Note every class's visual intent (spacing, sizing, colors, layout).
-2. Replicate those styles via inline `style` props, the new design system's component props/variants, or by keeping the CSS import — whichever produces the closest match.
-3. Do NOT silently drop `makeStyles` classes — map each one to an equivalent style.
-
-## Key Rules
-
-- Widgets are self-contained — they manage their own data fetching
-- Use `PCore.getDataPageUtils()` for data page access
-- Use `PCore.getAttachmentUtils()` for file operations
-- Always handle loading and error states
-- Widgets may use `PCore.getPubSubUtils()` to subscribe to events
-- Clean up subscriptions in `useEffect` return function
-- Do NOT drop card padding, list item spacing, or avatar sizing when removing MUI components — replicate them in the replacement

package/templates/react-sdk-reference/.claude/prompts/add-component.md

@@ -1,144 +0,0 @@
-## Step 0 — Resolve missing information
-
-Read the user's message carefully. Extract:
-
-- **Component name** — the exact name (e.g. `AutoComplete`, `DatePicker`)
-- **Component type** — one of: `field` | `template` | `widget` | `designSystemExtension`
-- **Design system** — the UI library to use (e.g. `Ant Design`, `Chakra UI`, `Carbon`, `Radix UI`)
-- **Output path** — the exact or relative path where the component should be generated (e.g. `src/components/field/AutoComplete`)
-
-If any of the four are missing or ambiguous, ask the user all unresolved items in **one numbered list** and wait for their answers before continuing. Do not guess or proceed with assumptions.
-
-Example questions to ask (only ask the ones that are actually missing):
-1. Which design system should I use? (e.g. Ant Design, Chakra UI, Carbon, Radix UI)
-2. What is the exact component name?
-3. What type of component is this? (field / template / widget / designSystemExtension)
-4. What is the exact or relative path where the component should be generated? (e.g. `src/components/field/AutoComplete`)
-
-### Case-insensitive component name matching
-
-The user may enter the component name in any casing (e.g. `autocomplete`, `Autocomplete`, `autoComplete`). It is your responsibility to match it to the correct canonical name by checking the skill files in `.claude/skills/field-skills/`, `.claude/skills/template-skills/`, `.claude/skills/widget-skills/`, and `.claude/skills/design-system-extension-skills/`. For example, if the user types `autocomplete`, match it to `AutoComplete`.
-
-Once all four are known, continue to Step 1.
-
----
-
-## Step 1 — Check for existing component (overwrite check)
-
-Before generating, check if a component already exists at the resolved output path:
-
-1. Check if `<outputPath>/<ComponentName>.tsx` (or the directory) already exists.
-2. If it **does exist**, ask the user: _"A component named `<ComponentName>` already exists at `<outputPath>`. Do you want to overwrite it with the new implementation?"_
-   - If the user says **yes**, proceed to overwrite.
-   - If the user says **no**, stop and skip generation.
-3. If it **does not exist**, continue to Step 2.
-
----
-
-## Step 2 — Check for skill files
-
-Always read the **general type skill** for the component type:
-
-| Component Type | General Skill File |
-|---|---|
-| `field` | `.claude/skills/field-components.md` |
-| `template` | `.claude/skills/template-components.md` |
-| `widget` | `.claude/skills/widget-components.md` |
-| `designSystemExtension` | `.claude/skills/design-system-extension.md` |
-
-Then look for a **component-specific skill** based on the component type:
-
-| Component Type | Specific Skill Location |
-|---|---|
-| `field` | `.claude/skills/field-skills/<ComponentName>.md` |
-| `template` | `.claude/skills/template-skills/<ComponentName>.md` |
-| `widget` | `.claude/skills/widget-skills/<ComponentName>.md` |
-| `designSystemExtension` | `.claude/skills/design-system-extension-skills/<ComponentName>.md` |
-
-If the component-specific skill file exists, read it fully. Pay special attention to:
-- **Behavioral Contract** — state management, event handling, option loading, edge cases
-- **Design System Mapping** table — the recommended component for the chosen design system
-
-You must read **both** the general type skill and the component-specific skill (if it exists) before proceeding.
-
-Examples:
-- `AutoComplete` (field) → read `field-components.md` + `field-skills/AutoComplete.md`
-- `AdvancedSearch` (template) → read `template-components.md` + `template-skills/AdvancedSearch.md`
-- `AppAnnouncement` (widget) → read `widget-components.md` + `widget-skills/AppAnnouncement.md`
-- `AlertBanner` (designSystemExtension) → read `design-system-extension.md` + `design-system-extension-skills/AlertBanner.md`
-
-If no component-specific skill file exists, continue using the general pattern from the type skill.
-
----
-
-## Step 3 — Check and install dependencies
-
-Run:
-```
-cat package.json | grep "<design-system-package>"
-```
-
-If the design system package is **not** listed in `dependencies` or `devDependencies`, install it:
-```
-npm install <design-system-package>
-```
-
-Also install any peer dependencies documented in the package's README. Report what was installed.
-
----
-
-## Step 4 — Discover the design system's API
-
-Before writing any code, inspect the installed package:
-
-1. `cat node_modules/<designSystem>/README.md` — note the correct import path and usage patterns for the installed version.
-2. `grep "^export" node_modules/<designSystem>/dist/index.d.ts 2>/dev/null || grep -rl "^export" node_modules/<designSystem> --include="index.d.ts" | head -3 | xargs grep "^export"` — lists every component actually exported by the installed version.
-3. For every component you plan to use, read its TypeScript prop interface from the installed `.d.ts`:
-   `find node_modules/<designSystem> -name "ComponentName.d.ts" | head -3`, then `grep -A 40 "interface.*Props"` on the result.
-4. Only use component names and prop names confirmed in those files. Do not rely on training knowledge of the API.
-
-Also check:
-- Whether the design system has a **form layout wrapper** (label + input + helper text) — use it instead of manual margins
-- Whether it has **size/density/variant conventions** — use built-in props rather than custom padding
-- Whether it has a **companion icons package** — read its exports before using any icon name; never guess icon names
-- Whether it has a **tokens or CSS directory** — use design system CSS custom properties for spacing; never hardcode `px` values
-
----
-
-## Step 5 — Generate the component
-
-Create the component directory at the resolved output path (from Step 0).
-
-Create `<ComponentName>.tsx` using the pattern for the component type:
-
-- **field**: Extend `PConnFieldProps` from `@pega/sdk-react`. Extract `getPConnect`, `label`, `required`, `disabled`, `value`, `validatemessage`, `status`, `readOnly`, `testId`, `helperText`, `displayMode`, `hideLabel`, `placeholder`. Call `handleEvent(actions, 'changeNblur', propName, value)` on blur. Handle `displayMode === 'DISPLAY_ONLY'` and `'STACKED_LARGE_VAL'` using `getComponentFromRegistry('FieldValueList')`. Show `validatemessage` when `status === 'error'`. Pass `data-test-id={testId}` on the interactive element.
-- **template**: Extend `PConnProps`, render children via the design system's grid/layout primitives
-- **widget**: Extend `PConnProps`, fetch data via `PCore.getDataPageUtils()`
-- **designSystemExtension**: Pure display props or extend `PConnProps`
-
-Create `index.tsx`:
-```typescript
-export { default } from './<ComponentName>';
-```
-
----
-
-## Step 6 — Register in component-map.ts
-
-Edit `src/components/component-map.ts`:
-
-1. Add the import at the top of the file, in the correct section (Fields / Templates / Widgets / Design System Extension)
-2. Add an entry in `getSampleComponentMap()` under the matching category comment
-
-Do not restructure or reorder any existing entries.
-
----
-
-## Step 7 — Verify the build
-
-Run:
-```
-npm run build
-```
-
-If build errors occur, fix them before reporting completion. Report what files were created and what was added to `component-map.ts`.

package/templates/react-sdk-reference/.claude/prompts/component-manifest.json

@@ -1,111 +0,0 @@
-{
-  "folderScopes": {
-    "field": "src/components/field",
-    "template": "src/components/template",
-    "widget": "src/components/widget",
-    "infra": "src/components/infra",
-    "designSystemExtension": "src/components/designSystemExtension"
-  },
-  "namedScopes": {
-    "workflow-form": {
-      "folders": ["field"],
-      "components": [
-        { "name": "Stages", "category": "infra", "path": "src/components/infra/Stages" }
-      ]
-    }
-  },
-  "components": {
-    "field": [
-      { "name": "AutoComplete",    "path": "src/components/field/AutoComplete" },
-      { "name": "CancelAlert",     "path": "src/components/field/CancelAlert" },
-      { "name": "Checkbox",        "path": "src/components/field/Checkbox" },
-      { "name": "Currency",        "path": "src/components/field/Currency" },
-      { "name": "Date",            "path": "src/components/field/Date" },
-      { "name": "DateTime",        "path": "src/components/field/DateTime" },
-      { "name": "Decimal",         "path": "src/components/field/Decimal" },
-      { "name": "Dropdown",        "path": "src/components/field/Dropdown" },
-      { "name": "Email",           "path": "src/components/field/Email" },
-      { "name": "Group",           "path": "src/components/field/Group" },
-      { "name": "Integer",         "path": "src/components/field/Integer" },
-      { "name": "Location",        "path": "src/components/field/Location" },
-      { "name": "Multiselect",     "path": "src/components/field/Multiselect" },
-      { "name": "ObjectReference", "path": "src/components/field/ObjectReference" },
-      { "name": "Percentage",      "path": "src/components/field/Percentage" },
-      { "name": "Phone",           "path": "src/components/field/Phone" },
-      { "name": "RadioButtons",    "path": "src/components/field/RadioButtons" },
-      { "name": "RichText",        "path": "src/components/field/RichText" },
-      { "name": "ScalarList",      "path": "src/components/field/ScalarList" },
-      { "name": "SelectableCard",  "path": "src/components/field/SelectableCard" },
-      { "name": "SemanticLink",    "path": "src/components/field/SemanticLink" },
-      { "name": "TextArea",        "path": "src/components/field/TextArea" },
-      { "name": "TextContent",     "path": "src/components/field/TextContent" },
-      { "name": "TextInput",       "path": "src/components/field/TextInput" },
-      { "name": "Time",            "path": "src/components/field/Time" },
-      { "name": "URL",             "path": "src/components/field/URL" },
-      { "name": "UserReference",   "path": "src/components/field/UserReference" }
-    ],
-    "template": [
-      { "name": "AdvancedSearch",         "path": "src/components/template/AdvancedSearch" },
-      { "name": "AppShell",               "path": "src/components/template/AppShell" },
-      { "name": "BannerPage",             "path": "src/components/template/BannerPage" },
-      { "name": "CaseSummary",            "path": "src/components/template/CaseSummary" },
-      { "name": "CaseView",               "path": "src/components/template/CaseView" },
-      { "name": "CaseViewActionsMenu",    "path": "src/components/template/CaseViewActionsMenu" },
-      { "name": "Confirmation",           "path": "src/components/template/Confirmation" },
-      { "name": "DataReference",          "path": "src/components/template/DataReference" },
-      { "name": "DefaultForm",            "path": "src/components/template/DefaultForm" },
-      { "name": "DefaultPage",            "path": "src/components/template/DefaultPage" },
-      { "name": "Details",                "path": "src/components/template/Details" },
-      { "name": "FieldGroupTemplate",     "path": "src/components/template/FieldGroupTemplate" },
-      { "name": "HierarchicalForm",       "path": "src/components/template/HierarchicalForm" },
-      { "name": "InlineDashboard",        "path": "src/components/template/InlineDashboard" },
-      { "name": "InlineDashboardPage",    "path": "src/components/template/InlineDashboardPage" },
-      { "name": "ListPage",               "path": "src/components/template/ListPage" },
-      { "name": "ListView",               "path": "src/components/template/ListView" },
-      { "name": "MultiReferenceReadOnly", "path": "src/components/template/MultiReferenceReadOnly" },
-      { "name": "NarrowWide",             "path": "src/components/template/NarrowWide" },
-      { "name": "ObjectPage",             "path": "src/components/template/ObjectPage" },
-      { "name": "OneColumn",              "path": "src/components/template/OneColumn" },
-      { "name": "PromotedFilters",        "path": "src/components/template/PromotedFilters" },
-      { "name": "SelfServiceCaseView",    "path": "src/components/template/SelfServiceCaseView" },
-      { "name": "SimpleTable",            "path": "src/components/template/SimpleTable" },
-      { "name": "SingleReferenceReadOnly","path": "src/components/template/SingleReferenceReadOnly" },
-      { "name": "SubTabs",                "path": "src/components/template/SubTabs" },
-      { "name": "TwoColumn",              "path": "src/components/template/TwoColumn" },
-      { "name": "WideNarrow",             "path": "src/components/template/WideNarrow" },
-      { "name": "WssNavBar",              "path": "src/components/template/WssNavBar" }
-    ],
-    "widget": [
-      { "name": "AppAnnouncement", "path": "src/components/widget/AppAnnouncement" },
-      { "name": "Attachment",      "path": "src/components/widget/Attachment" },
-      { "name": "CaseHistory",     "path": "src/components/widget/CaseHistory" },
-      { "name": "FileUtility",     "path": "src/components/widget/FileUtility" },
-      { "name": "Followers",       "path": "src/components/widget/Followers" },
-      { "name": "QuickCreate",     "path": "src/components/widget/QuickCreate" },
-      { "name": "SummaryItem",     "path": "src/components/widget/SummaryItem" },
-      { "name": "SummaryList",     "path": "src/components/widget/SummaryList" },
-      { "name": "ToDo",            "path": "src/components/widget/ToDo" }
-    ],
-    "infra": [
-      { "name": "ActionButtons",   "path": "src/components/infra/ActionButtons" },
-      { "name": "DashboardFilter", "path": "src/components/infra/DashboardFilter" },
-      { "name": "DeferLoad",       "path": "src/components/infra/DeferLoad" },
-      { "name": "NavBar",          "path": "src/components/infra/NavBar" },
-      { "name": "Stages",          "path": "src/components/infra/Stages" },
-      { "name": "VerticalTabs",    "path": "src/components/infra/VerticalTabs" }
-    ],
-    "designSystemExtension": [
-      { "name": "AlertBanner",       "path": "src/components/designSystemExtension/AlertBanner" },
-      { "name": "Banner",            "path": "src/components/designSystemExtension/Banner" },
-      { "name": "CaseSummaryFields", "path": "src/components/designSystemExtension/CaseSummaryFields" },
-      { "name": "DetailsFields",     "path": "src/components/designSystemExtension/DetailsFields" },
-      { "name": "FieldGroup",        "path": "src/components/designSystemExtension/FieldGroup" },
-      { "name": "FieldGroupList",    "path": "src/components/designSystemExtension/FieldGroupList" },
-      { "name": "FieldValueList",    "path": "src/components/designSystemExtension/FieldValueList" },
-      { "name": "Operator",          "path": "src/components/designSystemExtension/Operator" },
-      { "name": "Pulse",             "path": "src/components/designSystemExtension/Pulse" },
-      { "name": "RichTextEditor",    "path": "src/components/designSystemExtension/RichTextEditor" },
-      { "name": "WssQuickCreate",    "path": "src/components/designSystemExtension/WssQuickCreate" }
-    ]
-  }
-}

package/templates/react-sdk-reference/.claude/prompts/generate-all-components.md

@@ -1,149 +0,0 @@
-## Step 0 — Resolve inputs
-
-Read the user's message carefully. Extract:
-
-- **Design system** — the UI library to use (e.g. `Ant Design`, `Chakra UI`, `Carbon`, `Radix UI`)
-- **Base components folder** — the root folder that contains (or will contain) the component type subfolders (e.g. `src/components/`)
-- **Component types in scope** — which types to generate (default: all four if not specified)
-
-Both **design system** and **base components folder** are required. If either is missing or ambiguous, ask both unresolved items in one numbered list. Do not assume or default the base folder — the client's folder structure may differ.
-
-Example questions (ask only the ones that are actually missing):
-1. Which design system should I use? (e.g. Ant Design, Chakra UI, Carbon, Radix UI)
-2. What is your base components folder? (e.g. `src/components/`) — subfolders `field/`, `template/`, `widget/`, and `designSystemExtension/` will be used under it.
-
-### Component type scope
-
-Extract which types the user wants from the message:
-
-| User says | Types in scope |
-|---|---|
-| "generate all components" | field + template + widget + designSystemExtension |
-| "generate field and widget components" | field + widget |
-| "generate widget, template components" | widget + template |
-| "generate all components except templates" | field + widget + designSystemExtension |
-| "replace everything" | field + template + widget + designSystemExtension |
-
-Default to **all four types** if the message does not restrict the scope.
-
-### Derived output paths
-
-Once the base folder is known, derive the output path for each type in scope:
-
-| Type | Derived path |
-|---|---|
-| field | `<base>/field/` |
-| template | `<base>/template/` |
-| widget | `<base>/widget/` |
-| designSystemExtension | `<base>/designSystemExtension/` |
-
-Once design system, base folder, and type scope are resolved, continue to Step 1.
-
----
-
-## Step 1 — Read general skill files (once, for each type in scope)
-
-Read the general skill file for every type in scope. Do this upfront — do not re-read per component.
-
-| Type | Skill file to read |
-|---|---|
-| field | `.claude/skills/field-components.md` |
-| template | `.claude/skills/template-components.md` |
-| widget | `.claude/skills/widget-components.md` |
-| designSystemExtension | `.claude/skills/design-system-extension.md` |
-
-Keep all loaded skill files active throughout the entire session.
-
----
-
-## Step 2 — Install and discover the design system (once)
-
-Execute **Step 3** from `.claude/prompts/add-component.md` exactly as written:
-- Check `package.json` for the DS package
-- Install if missing, including any peer dependencies
-- Report what was installed
-
-Then execute **Step 4** from `.claude/prompts/add-component.md` exactly as written:
-- Read the DS README from `node_modules`
-- Discover all exported components from `dist/index.d.ts`
-- Read prop interfaces for primitives needed across **all types in scope**:
-  - **field**: form input controls (Input, Select, Checkbox, DatePicker, etc.)
-  - **template**: grid/layout primitives (Grid, Flex, Columns, SimpleGrid, etc.)
-  - **widget**: card/list/table/button/badge primitives
-  - **designSystemExtension**: alert/notification/avatar primitives
-- Note form layout wrappers, size/variant conventions, icon packages, and design tokens
-
-Build a unified **DS API reference map** covering all types in scope. Reuse it throughout — do not repeat discovery commands per component.
-
----
-
-## Step 3 — Overwrite check (all types, all at once)
-
-For every type in scope, check whether each component's `<outputPath>/<ComponentName>/<ComponentName>.tsx` already exists.
-
-Collect all existing components across all types and report them in one consolidated list:
-
-> "The following N components already exist across [types]: [list grouped by type]. How should I proceed?
-> - **Overwrite all** — replace all existing implementations
-> - **Skip existing** — only generate components that don't exist yet
-> - **Cancel** — stop without generating anything"
-
-Wait for the user's answer before proceeding. If none exist, continue immediately.
-
----
-
-## Step 4 — Generate field components (skip if field not in scope)
-
-If `field` is in scope, execute **Step 4** from `.claude/prompts/generate-field-components.md` in full:
-- Use the derived field output path: `<base>/field/`
-- The general skill (`field-components.md`) is already loaded from Step 1 — do not re-read it
-- The DS API reference map is already built from Step 2 — do not repeat discovery commands
-- For each of the 27 field components: read skill file → generate → register in `component-map.ts`
-- Report progress after each component
-
----
-
-## Step 5 — Generate template components (skip if template not in scope)
-
-If `template` is in scope, execute **Step 4** from `.claude/prompts/generate-template-components.md` in full:
-- Use the derived template output path: `<base>/template/`
-- The general skill (`template-components.md`) is already loaded from Step 1 — do not re-read it
-- The DS layout API is already discovered from Step 2 — do not repeat discovery commands
-- For each of the 32 template components: read skill file → generate → register in `component-map.ts`
-- Report progress after each component
-
----
-
-## Step 6 — Generate widget components (skip if widget not in scope)
-
-If `widget` is in scope, execute **Step 4** from `.claude/prompts/generate-widget-components.md` in full:
-- Use the derived widget output path: `<base>/widget/`
-- The general skill (`widget-components.md`) is already loaded from Step 1 — do not re-read it
-- The DS UI primitive map is already built from Step 2 — do not repeat discovery commands
-- For each of the 9 widget components: read skill file → generate → register in `component-map.ts`
-- If no skill file exists for a component (e.g., `SummaryList`), use the general pattern from `widget-components.md`
-- Report progress after each component
-
----
-
-## Step 7 — Generate design system extension components (skip if DSE not in scope)
-
-If `designSystemExtension` is in scope, execute **Step 4** from `.claude/prompts/generate-dse-components.md` in full:
-- Use the derived DSE output path: `<base>/designSystemExtension/`
-- The general skill (`design-system-extension.md`) is already loaded from Step 1 — do not re-read it
-- The DS display primitive map is already built from Step 2 — do not repeat discovery commands
-- For each of the 11 DSE components: read skill file → generate → register in `component-map.ts`
-- Apply the Pattern B/A/C branching as specified in the skill file and `design-system-extension.md`
-- Report progress after each component
-
----
-
-## Step 8 — Verify the build
-
-Execute **Step 7** from `.claude/prompts/add-component.md` exactly as written:
-- Run `npm run build`
-- Fix any TypeScript or build errors before reporting completion
-- Report a final summary:
-  - Total components generated, grouped by type
-  - All entries added to `component-map.ts`
-  - Any components skipped (if "skip existing" was chosen in Step 3)