@pega/sdk 0.0.3 → 0.0.5

package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/FieldGroup.md

@@ -1,131 +0,0 @@
-# Skill: FieldGroup
-
-Collapsible or static container that groups related fields under an optional section header and instructions text.
-
-> **Prerequisite skill:** [`design-system-extension.md`](../design-system-extension.md) — covers architecture, props interface, styling patterns, and registration patterns common to ALL DSE components.
-
----
-
-## Component Purpose
-
-Renders a labeled section that wraps one or more field components. Supports optional:
-- **Section name** — rendered as a bold header above the fields.
-- **Collapsible behavior** — the name header becomes a toggle that shows/hides the fields.
-- **Instructions text** — rendered as HTML below the header and above the fields.
-
-Children are rendered inside a full-width inner container.
-
-## Pega Metadata
-
-- **Pega Name:** `FieldGroup`
-- **Registration key:** `FieldGroup` (in `component-map.ts`)
-- **Does NOT use `getPConnect`** — receives children via `PropsWithChildren`
-
-## Props
-
-| Prop | Type | Required | Description |
-|------|------|----------|-------------|
-| `children` | `ReactNode` | No | Field components to render inside the group |
-| `name` | `string` | No | Section heading displayed above the fields |
-| `collapsible` | `boolean` | No | If `true`, the header acts as a collapse/expand toggle. Default `false` |
-| `instructions` | `string` | No | HTML string of instruction text shown between header and fields |
-
-## Behavioral Contract
-
-1. **State:** Maintain a `collapsed` boolean in local state, initialized to `false` (expanded).
-2. **Name rendering:**
-   - If `name` is not provided, render no header.
-   - If `name` is provided and `collapsible` is `false`, render `<b>{name}</b>`.
-   - If `name` is provided and `collapsible` is `true`, wrap in a clickable `<span>` with:
-     - `id='field-group-header'`
-     - A directional arrow icon: **right arrow** when `collapsed === true`, **down arrow** when `collapsed === false`.
-     - The bold name text beside the arrow.
-     - Clicking the span toggles `collapsed`.
-3. **Instructions:** If `instructions` is provided AND is not the string `'none'`, render it with `dangerouslySetInnerHTML={{ __html: instructions }}`.
-4. **Children:** Render children inside a full-width div. If `collapsed` is `true`, do NOT render children (or instructions).
-5. **Header cursor:** When `collapsible` is `true`, the header span uses `cursor: pointer`. When `collapsible` is `false`, cursor is `auto`.
-6. **Layout:** All content is wrapped in a `Grid container` with `spacing={4}` and `justifyContent='space-between'`. The name row and children are inside a single inner `Grid` at full width.
-
-## Visual Specifications
-
-Derived from `FieldGroup.tsx` makeStyles:
-
-### Outer Container
-
-| Property | Value |
-|----------|-------|
-| Spacing | 4 units (≈ 32px in MUI default) |
-
-### Component Root Margins
-
-| Property | Value |
-|----------|-------|
-| Margin right | `theme.spacing(1)` (≈ 8px) |
-| Margin left | `theme.spacing(1)` |
-| Margin top | `theme.spacing(1)` |
-| Margin bottom | `theme.spacing(1)` |
-
-### Field Margin (name row)
-
-| Property | Value |
-|----------|-------|
-| Padding top | `theme.spacing(1)` |
-| Padding bottom | `theme.spacing(1)` |
-| Margin top | `theme.spacing(1)` |
-
-### Header Row (collapsible)
-
-| Property | Value |
-|----------|-------|
-| Display | flex |
-| Align items | center |
-| Gap | 5px |
-| Cursor | `pointer` (collapsible) or `auto` (non-collapsible) |
-
-### Instructions
-
-| Property | Value |
-|----------|-------|
-| Padding | `5px 0` |
-
-**CSS-only implementation notes:**
-- Outer wrapper: `margin: 8px`.
-- Name row: `padding: 8px 0; margin-top: 8px`.
-- Collapsible header: `display: flex; align-items: center; gap: 5px; cursor: pointer; user-select: none`.
-- Non-collapsible name: plain `<b>` with no wrapper.
-- Instructions: `padding: 5px 0`.
-- Arrow icons: use Unicode or inline SVG — collapsed → `▶` / `›`, expanded → `▼` / `⌄`.
-- Children wrapper: `width: 100%`.
-- When collapsed, use `display: none` or conditional rendering to hide children.
-
-## Edge Cases & Special Logic
-
-- If `collapsible` is `false` (default), the `collapsed` state is never changed — clicking the name does nothing.
-- `instructions` equal to the string `'none'` must NOT be rendered (skip entirely).
-- `instructions` is rendered as raw HTML — ensure the content is trusted (server-side).
-- If `name` is absent, render no header row, but still render instructions (if any) and children.
-
-## Dependencies
-
-- No Pega SDK imports required (no `getPConnect`)
-- Arrow icons: `KeyboardArrowRightIcon` / `KeyboardArrowDownIcon` from `@mui/icons-material` (MUI only) — use equivalent icons or Unicode characters in non-MUI implementations
-
-## Design System Mapping
-
-**UI control type:** Collapsible section container with label, instructions, and children.
-
-Listed design systems are examples only.
-
-| Design System | Recommended Component |
-|---|---|
-| Default (CSS only) | `<div>` with toggled `display: none` on children, `<b>` header |
-| MUI | Grid container with `KeyboardArrowRight/Down` icons for collapse toggle |
-| Ant Design | `<Collapse>` or `<Card>` with collapsible panels |
-| Chakra UI | `<Accordion>` or manual `<Box>` with toggle state |
-| Shadcn/ui | `<Collapsible>` + `<CollapsibleTrigger>` + `<CollapsibleContent>` |
-
-When implementing in a specific design system, map the following:
-- `collapsed` toggle → design system's collapse/expand state or controlled component
-- Arrow direction → visual indicator of expand/collapse state (chevron or arrow icon)
-- `instructions` HTML → design system's `dangerouslySetInnerHTML` or rich content slot
-- Full-width children → ensure children container spans the full group width

package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/FieldGroupList.md

@@ -1,111 +0,0 @@
-# Skill: FieldGroupList
-
-Repeating list of named field groups, each with its own children. Supports per-item delete and a global "+Add" link at the bottom.
-
-> **Prerequisite skill:** [`design-system-extension.md`](../design-system-extension.md) — covers architecture, props interface, styling patterns, and registration patterns common to ALL DSE components.
-
----
-
-## Component Purpose
-
-Renders a vertical list of field group items. Each item has a bold name header, optional delete button (top-right), and rendered children (the group's fields). An optional "+Add" link appears at the bottom when adding is allowed. A horizontal divider separates items when `onAdd` is provided.
-
-## Pega Metadata
-
-- **Pega Name:** `FieldGroupList`
-- **Registration key:** `FieldGroupList` (in `component-map.ts`)
-- **Does NOT use `getPConnect`** — receives all data as direct props
-
-## Props
-
-| Prop | Type | Required | Description |
-|------|------|----------|-------------|
-| `items` | `Array<{ name: string; id: string; children: ReactNode }>` | Yes | List of field group items to render |
-| `onDelete` | `(id: string) => void` | No | Called with the item's `id` when the delete button is clicked. If not provided, no delete button is shown |
-| `onAdd` | `() => void` | No | Called when the "+Add" link is clicked. If not provided, no add link or dividers are shown |
-
-## Behavioral Contract
-
-1. Render a `Grid container` with `spacing={4}` and `justifyContent='space-between'` as the outer wrapper.
-2. Inside, render a full-width inner Grid with `spacing={1}`.
-3. For **each item** in `props.items`:
-   - Render a full-width `Grid` keyed by `item.name`.
-   - Render `<b>{item.name}</b>` as the item header.
-   - If `onDelete` is provided, render a delete button:
-     - Floated right.
-     - `type='button'`, `id={'delete-row-' + item.id}`, `aria-label='Delete Row'`.
-     - Button class: `psdk-utility-button`.
-     - On click: call `onDelete(item.id)`.
-     - Button contains an `<img>` with the trash icon loaded via `Utils.getImageSrc('trash', Utils.getSDKStaticConentUrl())`.
-     - Image class: `psdk-utility-card-action-svg-icon`.
-   - Render `{item.children}`.
-   - Render `<br />`.
-   - If `onAdd` is provided: render `<Divider />`, then `<br />`.
-4. After all items, if `onAdd` is provided, render a `<Link>` (or `<a>`) with text `'+Add'`, `cursor: pointer`, and `onClick={onAdd}`.
-
-## Visual Specifications
-
-Derived from `FieldGroupList.tsx`:
-
-### Outer Layout
-
-| Property | Value |
-|----------|-------|
-| Grid container spacing | 4 (≈ 32px) |
-
-### Delete Button
-
-| Property | Value |
-|----------|-------|
-| Float | right |
-| Style class | `psdk-utility-button` |
-| Icon source | `Utils.getImageSrc('trash', Utils.getSDKStaticConentUrl())` |
-
-### "+Add" Link
-
-| Property | Value |
-|----------|-------|
-| Cursor | pointer |
-| Underline | hover |
-| Text | `'+Add'` |
-
-**CSS-only implementation notes:**
-- Outer wrapper: `display: flex; flex-direction: column; gap: 32px`.
-- Item wrapper: `display: flex; flex-direction: column; gap: 8px; width: 100%`.
-- Item header row: `display: flex; justify-content: space-between; align-items: center`.
-- Delete button: `float: right` (or use flexbox `justify-content: space-between` on the header row instead).
-- Delete icon: `width: 20px; height: 20px` SVG image of a trash/delete icon.
-- Divider: `border-top: 1px solid var(--divider-color); margin: 8px 0`.
-- "+Add" link: `cursor: pointer; text-decoration: underline; color: var(--app-primary-color)`.
-
-## Edge Cases & Special Logic
-
-- If `items` is empty, render only the "+Add" link (if `onAdd` is provided).
-- If neither `onDelete` nor `onAdd` is provided, the list is read-only (no interactive elements).
-- The trash icon is loaded dynamically via `Utils.getImageSrc` — if this utility is unavailable, fall back to a standard `🗑` character or an SVG trash icon.
-- The delete button must use `type='button'` to prevent form submission.
-
-## Dependencies
-
-- `Utils` from `../../helpers/utils` — for `getImageSrc` and `getSDKStaticConentUrl` (used only for the trash icon)
-- No Pega SDK `getPConnect` imports required
-
-## Design System Mapping
-
-**UI control type:** Repeating list of named groups with optional delete and add actions.
-
-Listed design systems are examples only.
-
-| Design System | Recommended Component |
-|---|---|
-| Default (CSS only) | Flex column layout with `<hr>` divider and `<button>` delete |
-| MUI | `<Grid container>` items with `<Divider>` and `<Link>` for "+Add" |
-| Ant Design | `<List>` items with `<Divider>` and `<Button type='link'>` for "+Add" |
-| Chakra UI | `<VStack>` with `<Divider>` and `<Button variant='link'>` |
-| Shadcn/ui | `<div>` flex column with `<Separator>` and a link button |
-
-When implementing in a specific design system, map the following:
-- Delete button → icon button or `danger` variant button placed at the item top-right
-- Divider between items → `<Divider>` / `<hr>` (only when `onAdd` is present)
-- "+Add" link → a text link / `Button variant='link'` that calls `onAdd`
-- Trash icon → design system's delete icon or an SVG

package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/FieldValueList.md

@@ -1,115 +0,0 @@
-# Skill: FieldValueList
-
-Single field-value pair display component. Renders a label and value in either an inline (side-by-side) or stacked layout. Also used as a display mode renderer by field components (e.g., `TextInput`, `Dropdown`, etc.).
-
-> **Prerequisite skill:** [`design-system-extension.md`](../design-system-extension.md) — covers architecture, props interface, styling patterns, and registration patterns common to ALL DSE components.
-
----
-
-## Component Purpose
-
-Renders a single name/value pair in a compact read-only layout. Supports two layout variants:
-- **Inline:** Label and value are side by side (label 4/12 cols, value 8/12 cols).
-- **Stacked:** Label is on top, value is larger below (both 12/12 cols).
-
-When no name is provided, only the value is rendered at full width. Used directly as a display widget and delegated to by field components for their `DISPLAY_ONLY` and `STACKED_LARGE_VAL` display modes.
-
-## Pega Metadata
-
-- **Pega Name:** `FieldValueList`
-- **Registration key:** `FieldValueList` (in `component-map.ts`)
-- **Does NOT use `getPConnect`** — receives all data as direct props
-
-## Props
-
-| Prop | Type | Required | Description |
-|------|------|----------|-------------|
-| `name` | `string` | No | Field label. If omitted, only the value is rendered |
-| `value` | `any` | Yes | Field value to display |
-| `variant` | `string` | No | Layout: `'inline'` (default) or `'stacked'` |
-| `isHtml` | `boolean` | No | If `true`, render value as raw HTML (default `false`) |
-
-## Behavioral Contract
-
-1. **Empty value fallback:** If `value` is `undefined` or an empty string (`''`), display `'---'` instead.
-2. **No-name case:** If `name` is not provided, render only the value at full width (12 columns) regardless of `variant`.
-3. **Inline variant** (default — `variant !== 'stacked'`):
-   - Label column: 4 of 12 columns.
-   - Value column: 8 of 12 columns (or 12 if no name).
-   - Label: secondary text color, `body2` typography, `fontWeight: 400`.
-   - Value: primary text color, `body2` typography.
-4. **Stacked variant** (`variant === 'stacked'`):
-   - Label column: 12 of 12, `paddingBottom: 0` (label sits tight above value).
-   - Value column: 12 of 12, `paddingTop: 0` (value sits tight below label).
-   - Label: secondary text color, `body2` typography, `fontWeight: 400`.
-   - Value: primary text color, **`h6` typography** (larger / more prominent than inline).
-5. **HTML rendering:** If `isHtml` is `true`, wrap value in a `<div dangerouslySetInnerHTML={{ __html: formattedValue }}>`. The formatted value (with `'---'` fallback) is passed to `__html`.
-6. **Layout wrapper:** Render everything inside a container row with space-between justification and consistent spacing.
-
-## Visual Specifications
-
-Derived from `FieldValueList.tsx` makeStyles:
-
-### Label
-
-| Property | Value |
-|----------|-------|
-| Font weight | 400 |
-| Color | `theme.palette.text.secondary` (muted/secondary text) |
-| Typography | `body2` (≈ 0.875rem / 14px) |
-
-### Value
-
-| Property | Value |
-|----------|-------|
-| Color | `theme.palette.text.primary` (default text) |
-| Typography (inline) | `body2` (≈ 0.875rem / 14px) |
-| Typography (stacked) | `h6` (≈ 1.25rem / 20px, weight 500) |
-
-### Padding Adjustments (stacked only)
-
-| Property | Value |
-|----------|-------|
-| Label bottom padding | `0 !important` |
-| Value top padding | `0 !important` |
-
-**CSS-only implementation notes:**
-- Root row: `display: flex; justify-content: space-between; align-items: baseline; gap: 1rem`.
-- **Inline label:** `flex: 0 0 33%; font-weight: 400; font-size: 0.875rem; color: var(--text-secondary)`.
-- **Inline value:** `flex: 1; font-size: 0.875rem; color: var(--text-primary)`.
-- **Stacked:** `display: flex; flex-direction: column; gap: 0`.
-- **Stacked label:** `font-weight: 400; font-size: 0.875rem; color: var(--text-secondary); margin-bottom: 0`.
-- **Stacked value:** `font-size: 1.25rem; font-weight: 500; color: var(--text-primary); margin-top: 0`.
-
-## Edge Cases & Special Logic
-
-- `value` can be any type (string, number, boolean, React element). Render it as-is unless it's empty/undefined.
-- When `isHtml` is `true`, set the raw HTML from the formatted value — do NOT sanitize (the caller is responsible). Ensure value is a string before passing to `dangerouslySetInnerHTML`.
-- When `variant` is `'stacked'` and `name` is absent, render value at 12 cols with `h6` typography.
-- When `variant` is `'inline'` and `name` is absent, render value at 12 cols with `body2` typography.
-
-## Dependencies
-
-- No Pega SDK imports required (no `getPConnect`)
-- No helper utilities required
-
-## Design System Mapping
-
-**UI control type:** Read-only field label/value display pair.
-
-Listed design systems are examples only.
-
-| Design System | Recommended Component |
-|---|---|
-| Default (CSS only) | `<div class='field-value-inline'>` or `<div class='field-value-stacked'>` with CSS |
-| MUI | `<Grid container>` with `<Typography>` for label and value |
-| Ant Design | `<Descriptions>` item, or `<Typography.Text type='secondary'>` + `<Typography.Text>` |
-| Chakra UI | `<Stack direction='row'>` (inline) or `<Stack spacing={0}>` (stacked) |
-| Shadcn/ui | Custom label/value pair with Tailwind flex utilities |
-
-When implementing in a specific design system, map the following:
-- Label → secondary/muted text style
-- Value inline → same size as label
-- Value stacked → larger typography (h6 equivalent)
-- Empty value → always display `'---'` (never show blank)
-- `isHtml={true}` → design system's `dangerouslySetInnerHTML` or `innerHTML` equivalent

package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/Operator.md

@@ -1,149 +0,0 @@
-# Skill: Operator
-
-Read-only display of a Pega case operator (creator or updater). Shows the operator's name and relative timestamp. On click, fetches full operator details from Pega and displays them in a popover.
-
-> **Prerequisite skill:** [`design-system-extension.md`](../design-system-extension.md) — covers architecture, props interface, styling patterns, and registration patterns common to ALL DSE components.
-
----
-
-## Component Purpose
-
-Renders a clickable read-only field displaying a case operator's name and the relative time of their action (created/updated). Clicking the field triggers an async fetch of the operator's profile details (position, organization, reports-to, telephone, email) and shows them in a popover panel.
-
-## Pega Metadata
-
-- **Pega Name:** `Operator`
-- **Registration key:** `Operator` (in `component-map.ts`)
-- **Extends `PConnProps`** — but does NOT call `getPConnect()`. Props are all passed directly.
-
-## Props
-
-The component interface extends `PConnProps` but all rendering data is passed as explicit props:
-
-| Prop | Type | Required | Description |
-|------|------|----------|-------------|
-| `label` | `string` | Yes | The field label used to identify which operator to display. Must be `'create operator'` or `'update operator'` (case-insensitive). |
-| `displayLabel` | `any` | No | Alternative label (used if `label` doesn't match). Also compared case-insensitively. |
-| `createDateTime` | `string` | Yes | ISO datetime string of when the case was created |
-| `createLabel` | `string` | Yes | Display label for the create operator field |
-| `createOperator` | `{ userName: string; userId: string }` | Yes | Creator's name and ID |
-| `updateDateTime` | `string` | Yes | ISO datetime string of last update |
-| `updateLabel` | `string` | Yes | Display label for the update operator field |
-| `updateOperator` | `{ userName: string; userId: string }` | Yes | Updater's name and ID |
-
-## Behavioral Contract
-
-### 1. Operator Selection
-
-Determine which operator to display based on `label.toLowerCase()` or `displayLabel?.toLowerCase()`:
-- If either is `'create operator'`:
-  - `caseOpLabel = createLabel`
-  - `caseOpName = createOperator.userName`
-  - `caseOpId = createOperator.userId`
-  - `caseTime = createDateTime`
-- If either is `'update operator'`:
-  - `caseOpLabel = updateLabel`
-  - `caseOpName = updateOperator.userName`
-  - `caseOpId = updateOperator.userId`
-  - `caseTime = updateDateTime`
-- Otherwise: `caseOpLabel = '---'`, `caseOpName = '---'`, `caseOpId = ''`, `caseTime = ''`.
-
-### 2. Main Display
-
-Render a read-only TextField (standard variant, no underline, pointer cursor) with:
-- `defaultValue={caseOpName}`
-- `label={caseOpLabel}`
-- `onClick={showOperatorDetails}`
-- `readOnly: true`, `disableUnderline: true`, `cursor: 'pointer'`
-
-Below the TextField, render the relative time: `Utils.generateDateTime(caseTime, 'DateTime-Since')`.
-
-### 3. Popover on Click (`showOperatorDetails`)
-
-When the TextField is clicked:
-1. Call `PCore.getUserApi().getOperatorDetails(caseOpId)` — returns a Promise.
-2. Use `PCore.getLocaleUtils().getLocaleValue(key, 'Operator')` to localize field labels.
-3. On resolution, build a fields array with these entries (using `'---'` as fallback for missing values):
-   - Position (`pyPosition`)
-   - Organization (`pyOrganization`)
-   - Reports to (`pyReportToUserName`)
-   - Telephone (`pyTelephone`) — rendered as `<a href={'tel:' + value}>{value}</a>`
-   - Email address (`pyEmailAddress`) — rendered as `<a href={'mailto:' + value}>{value}</a>`
-4. If `res.data.pyOperatorInfo.pyUserName` is empty, use all `'---'` fallbacks.
-5. Set `popoverFields` state with the resolved fields.
-6. Set `popoverAnchorEl` to the clicked element to open the popover.
-
-### 4. Popover Layout
-
-The popover renders when `popoverAnchorEl` is set:
-- Anchor origin: `{ vertical: 'bottom', horizontal: 'center' }`
-- Transform origin: `{ vertical: 'top', horizontal: 'center' }`
-- Max width: `45ch`
-- Content: A `Grid container` with:
-  - `Typography h6` showing `caseOpName` at full width.
-  - One row per field: 6-col `Typography caption` (label) + 6-col `Typography subtitle2` (value).
-
-Closing the popover sets `popoverAnchorEl` to `null`.
-
-## Visual Specifications
-
-Derived from `Operator.tsx` makeStyles:
-
-### Root Container
-
-| Property | Value |
-|----------|-------|
-| Padding | `theme.spacing(1)` (≈ 8px) |
-| Margin | `theme.spacing(1)` |
-
-### Popover Container
-
-| Property | Value |
-|----------|-------|
-| Padding | `theme.spacing(1)` |
-| Margin | `theme.spacing(1)` |
-| Max width | 45ch |
-
-**CSS-only implementation notes:**
-- Main display: read-only text field with label above, value below, pointer cursor on the value element.
-- Time display: secondary muted text below the operator name (e.g., `font-size: 0.75rem; color: var(--text-secondary)`).
-- Popover: `position: absolute; background: var(--bg-paper); border: 1px solid var(--divider); border-radius: 4px; padding: 8px; max-width: 45ch; box-shadow: 0 4px 12px rgba(0,0,0,0.15)`.
-- Operator name in popover: `font-size: 1.25rem; font-weight: 500; margin-bottom: 8px`.
-- Detail rows: `display: grid; grid-template-columns: 1fr 1fr; gap: 4px; align-items: baseline`.
-- Detail label: `font-size: 0.75rem; color: var(--text-secondary)`.
-- Detail value: `font-size: 0.875rem; font-weight: 500`.
-- Close popover on outside click (use `onClose` / blur handler).
-
-## Edge Cases & Special Logic
-
-- If `caseOpId` is empty (label not recognized), do NOT call `getOperatorDetails` — the fetch would fail.
-- If the API response has no `pyOperatorInfo.pyUserName`, fall back to all `'---'` for field values (still open the popover).
-- `Utils.generateDateTime(caseTime, 'DateTime-Since')` handles empty `caseTime` gracefully.
-- State: `popoverFields` starts as empty array `[]`. Check `popoverFields.length === 0` and return `undefined` from `getPopoverGrid()` to render nothing before data loads.
-
-## Dependencies
-
-- `Utils` from `../../helpers/utils` — `Utils.generateDateTime` for relative time display
-- `PCore.getUserApi().getOperatorDetails(userId)` — global Pega runtime API for operator details
-- `PCore.getLocaleUtils().getLocaleValue(key, 'Operator')` — for localized field labels in the popover
-
-## Design System Mapping
-
-**UI control type:** Clickable read-only field with async popover detail panel.
-
-Listed design systems are examples only.
-
-| Design System | Recommended Component |
-|---|---|
-| Default (CSS only) | `<div>` with click handler, custom CSS popover/tooltip panel |
-| MUI | Read-only `<TextField>` + `<Popover>` with `<Grid>` detail rows |
-| Ant Design | `<Input readOnly>` + `<Popover>` with `<Descriptions>` |
-| Chakra UI | `<Input isReadOnly>` + `<Popover>` with custom content |
-| Shadcn/ui | `<Input readOnly>` + `<Popover>` + `<PopoverContent>` |
-
-When implementing in a specific design system, map the following:
-- `onClick` on read-only input → trigger async fetch + open popover
-- `PCore.getUserApi().getOperatorDetails()` → call this before showing the popover
-- Popover anchor → position relative to the clicked element
-- `Utils.generateDateTime(caseTime, 'DateTime-Since')` → relative time display (e.g., "2 hours ago")
-- Telephone/email in popover → clickable `<a href='tel:...'>` and `<a href='mailto:...'>` links

package/templates/react-sdk-reference/.claude/skills/design-system-extension-skills/Pulse.md

@@ -1,83 +0,0 @@
-# Skill: Pulse
-
-Placeholder activity feed / comments stream card. Currently a stub implementation that renders a card titled "Pulse".
-
-> **Prerequisite skill:** [`design-system-extension.md`](../design-system-extension.md) — covers architecture, props interface, styling patterns, and registration patterns common to ALL DSE components.
-
----
-
-## Component Purpose
-
-Renders a card container intended to display an activity feed or comments stream for a Pega case. The current reference implementation is a **stub** — it renders only a Card with the title "Pulse" and placeholder body text. A production implementation would render a real activity feed stream inside the card using the `children` slot.
-
-## Pega Metadata
-
-- **Pega Name:** `Pulse`
-- **Registration key:** `Pulse` (in `component-map.ts`)
-- **Does NOT use `getPConnect`** — receives children via `PropsWithChildren`
-
-## Props
-
-| Prop | Type | Required | Description |
-|------|------|----------|-------------|
-| `children` | `ReactNode` | No | Child components (activity stream content) — currently unused in the stub |
-
-> **Note:** The current reference implementation ignores `children` and renders placeholder content. A full implementation would render `children` inside the card body.
-
-## Behavioral Contract
-
-1. Render a `Card` (or equivalent container) with a distinct left border accent.
-2. Render a card header with the title text `"Pulse"` using a heading style (e.g., `h6`).
-3. Render card content body with placeholder text `"Pulse"`.
-4. The left border accent uses the **primary light** color from the design system's theme.
-5. The card has top and bottom margin (1 spacing unit each).
-
-> **Stub note:** Steps 2–3 are placeholder content. In a real implementation, the card header would show a section label and the card body would render the `children` activity stream.
-
-## Visual Specifications
-
-Derived from `Pulse.tsx` makeStyles:
-
-### Card Container
-
-| Property | Value |
-|----------|-------|
-| Margin top | `theme.spacing(1)` (≈ 8px in MUI default) |
-| Margin bottom | `theme.spacing(1)` (≈ 8px) |
-| Border left | `6px solid` |
-| Border left color | `theme.palette.primary.light` (light variant of the primary brand color) |
-
-**CSS-only implementation notes:**
-- Card wrapper: `margin-top: 8px; margin-bottom: 8px; border-left: 6px solid var(--app-primary-light-color); border-radius: 4px; box-shadow: 0 1px 3px rgba(0,0,0,0.12)`.
-- Card header: `padding: 16px; font-size: 1.25rem; font-weight: 500`.
-- Card body: `padding: 0 16px 16px`.
-- Use a CSS variable `--app-primary-light-color` for the accent border color.
-
-## Edge Cases & Special Logic
-
-- The `children` prop is received but not currently rendered — it is intentional in the stub.
-- The component renders unconditionally (no conditional logic based on props).
-
-## Dependencies
-
-- No Pega SDK imports required (no `getPConnect`)
-- No helper utilities required
-
-## Design System Mapping
-
-**UI control type:** Card with left accent border and header/body sections.
-
-Listed design systems are examples only.
-
-| Design System | Recommended Component |
-|---|---|
-| Default (CSS only) | `<div>` with `border-left: 6px solid` + inner header/body divs |
-| MUI | `<Card><CardHeader title={<Typography variant='h6'>Pulse</Typography>} /><CardContent>` |
-| Ant Design | `<Card title='Pulse'>` with left border via `style` prop |
-| Chakra UI | `<Card>` with `borderLeft='6px solid' borderColor='blue.300'` |
-| Shadcn/ui | `<Card><CardHeader><CardTitle>` |
-
-When implementing in a specific design system, map the following:
-- Left border accent → `borderLeft` / `border-left` on the card root
-- Left border color → primary light color from the design system's palette
-- Card header title typography → design system's heading variant (h6 or equivalent)