pi-apexlang 0.1.0

package/skills/apexlang/templates/template-components/content-row/content-row._common.md

@@ -0,0 +1,225 @@
+---
+templateId: content-row.common
+componentType: templateComponent
+version: 1.0
+description: Shared canonical contract for Content Row template component generation.
+---
+
+# Purpose
+
+Define the shared variable contract, guardrails, and output skeleton for Content Row template component templates.
+
+---
+
+# Generation Rules (MANDATORY)
+
+1. Use `type: themeTemplateComponent/contentRow`.
+2. Use `appearance.template: @/standard` for visible report-mode Content Row list/master regions unless a narrower, documented structural exception applies. Do not use `@/blank-with-attributes` for master/detail parent lists.
+3. Use `componentAppearance.display: partial` or `report` only.
+4. For `primaryActions`, allow only `template: button` or `template: menu`.
+5. Use `databaseColumn` for column source mappings.
+6. Keep link/action behavior explicit. Use a structured `behavior.target` for same-application page targets when supported; use `behavior.type` plus `behavior.targetUrl` for URL-style targets.
+7. Use `settings.displayAvatar` to enable avatar rendering; do not place `displayAvatar` inside `plugin-avatar`.
+8. Use `settings.displayBadge` to enable badge rendering; do not place `displayBadge` inside `plugin-badge`.
+9. Use `plugin-badge.icon` only for badge icon configuration when the prompt explicitly requests an icon.
+10. Use `plugin-badge.position` only for badge placement configuration when the prompt explicitly requests a start/end placement override.
+11. Close component blocks declared with parentheses (for example `action ... (` or `column ... (`) using `)` after nested blocks.
+12. Keep plugin attribute names and enumerated values aligned with `content-row._template_options.md`, `../avatar._template_options.md`, and `../badge._template_options.md`.
+13. Content Row display settings that map to query columns must use `&COLUMN_NAME.` substitution syntax, for example `title: &ORDER_LABEL.`. Do not emit bare column aliases such as `title: ORDER_LABEL` for `overline`, `title`, `description`, or `miscellaneous`.
+14. Native row selection uses `rowSelection` in report mode. Use `type: focusOnly` for focus behavior without persisted selection state, `type: singleSelection` with `currentSelectionPageItem` for one selected row, or `type: multipleSelection` with both `currentSelectionPageItem` and `selectAllPageItem` for multi-select. The current-selection item should normally be a same-page hidden item that stores selected row value(s); the select-all item should be a same-page checkbox. `rowSelection.currentSelectionPageItem` is native selection state only and does not satisfy master-detail drill-down or parent-child context setting.
+15. SQL-backed Content Row regions must use top-level `orderBy {}` for deterministic ordering. Do not put `ORDER BY` inside `source.sqlQuery`.
+16. Use `orderBy { type: staticValue orderByClause: ... }` by default. Use `orderBy { type: item ... }` only when an available same-page page item controls the sort.
+17. When emitting `pagination {}` for report-mode Content Row, `pagination.type` is required and must be `page` or `scroll`. Do not reuse classic-report pagination enums such as `rowRangesXToYNoPagination`.
+18. When `rowSelection` is emitted with any non-null mode, at least one immediate child `column (...)` must mark the row identity with `source.primaryKey: true`.
+19. When any Content Row child column uses grouping, emit top-level `orderBy {}` and order by every grouped column first, in grouping order, before any secondary tie-breakers.
+20. In report mode, explicit child `column (...)` metadata is required and should match the delivered region source projection by default.
+21. Do not satisfy the compiler by adding only a minimal subset of child columns when the source projects more fields. By default, emit child `column (...)` blocks that match the region source columns in order.
+
+---
+
+# Variable Contract
+
+| Name | Required | Type | Notes |
+|------|----------|------|-------|
+| regionStaticId | yes | string | Region static identifier. |
+| name | yes | string | Region display name. |
+| source.location | yes | enum | Data-source location. |
+| orderBy.type | conditional | enum | Required for SQL-backed Content Row regions. Use `staticValue` or `item`. |
+| orderBy.orderByClause | conditional | string | Required when `orderBy.type = staticValue`; omit the leading `ORDER BY` keyword. |
+| orderBy.item.itemName | conditional | string | Required when `orderBy.type = item`; must reference an available same-page page item. |
+| orderBy.item.orderBys | conditional | object | Required when `orderBy.type = item`; maps page item values to ORDER BY clauses. |
+| componentAppearance.display | yes | enum | `partial` or `report`. |
+| settings.overline | optional | string | Overline content mapping/value; use `&COLUMN_NAME.` when mapped to a query column. |
+| settings.title | yes | string | Main row heading mapping/value; use `&COLUMN_NAME.` when mapped to a query column. |
+| settings.description | optional | string | Description mapping/value; use `&COLUMN_NAME.` when mapped to a query column. |
+| settings.miscellaneous | optional | string | Trailing metadata mapping/value; use `&COLUMN_NAME.` when mapped to a query column. |
+| settings.displayAvatar | optional | boolean | Enables avatar rendering for the row. |
+| settings.displayBadge | optional | boolean | Enables badge rendering for the row. |
+| plugin-avatar.type | conditional | enum | Avatar type when avatar rendering is enabled. |
+| plugin-avatar.icon | optional | string | Avatar icon mapping/value when `type` is `icon`. |
+| plugin-avatar.initials | optional | string | Avatar initials mapping/value when `type` is `initials`. |
+| plugin-avatar.description | optional | string | Accessible avatar description text. |
+| plugin-avatar.shape | optional | enum | Optional avatar shape when supported by the template. |
+| plugin-avatar.size | optional | enum | Optional avatar size when supported by the template. |
+| plugin-avatar.cssClasses | optional | string | Optional avatar styling classes when supported by the template. |
+| plugin-badge.label | conditional | string | Badge label text when badge rendering is enabled. |
+| plugin-badge.value | conditional | string | Badge value mapping when badge rendering is enabled. |
+| plugin-badge.state | optional | string | Badge state/style mapping when semantically meaningful. |
+| plugin-badge.style | optional | enum | Optional badge visual style when supported by the template, for example `subtle`. |
+| plugin-badge.shape | optional | enum | Optional badge shape when supported by the template, for example `rounded`. |
+| plugin-badge.size | optional | enum | Optional badge size when supported by the template. |
+| plugin-badge.icon | optional | string | Optional badge icon mapping/value when the prompt explicitly requests an icon. |
+| plugin-badge.displayLabel | optional | enum | Optional badge display override when supported by the template, for example `true`. |
+| plugin-badge.position | optional | enum | Optional badge placement override when supported by the template, for example `start` or `end`. |
+| plugin-badge.columnWidth | optional | enum | Optional badge width control when supported by the template. |
+| rowSelection.type | conditional | enum | Use `focusOnly`, `singleSelection`, or `multipleSelection` for native row selection in report mode. |
+| rowSelection.currentSelectionPageItem | conditional | string | Same-page hidden item that stores native selected row value(s), for example `P2_SELECTED_EMPLOYEE`; not a substitute for master-detail `fullRowLink` context setting. |
+| rowSelection.selectAllPageItem | conditional | string | Same-page checkbox item used by `multipleSelection` to toggle all rows, for example `P2_SELECT_ALL`. |
+| pagination.type | conditional | enum | Required when `pagination {}` is emitted in report mode. Valid values are `page` and `scroll`. |
+| pagination.entitiesPerPage | optional | number | Page size when `pagination.type: page` needs an explicit page length. |
+| pagination.showTotalCount | optional | boolean | Optional total-count indicator when supported. |
+| action.position | optional | enum | `avatarLink`, `titleLink`, `badgeLink`, `fullRowLink`, `primaryActions`. |
+| action.template | conditional | enum | Required for `primaryActions`; `button` or `menu`. |
+| action.behavior.target | conditional | object | Preferred for same-application page targets, especially master-detail `fullRowLink` actions that set same-page context items. |
+| action.behavior.targetUrl | conditional | string | Required for redirect URL actions. |
+| column.name | conditional | string | Required for report mode explicit columns. By default, emit one immediate child column per delivered source field in region-source order. |
+| column.layout.sequence | conditional | number | Required for every Content Row child column. Emit as a multiline `layout { sequence: ... }` block. |
+| column.source.databaseColumn | conditional | string | Required for report mode explicit columns. |
+| column.source.dataType | conditional | string | Required for report mode explicit columns, for example `number`, `varchar2`, `date`, or `timestamp`. |
+| column.source.primaryKey | optional | boolean | Emit `true` only on the row identity column. |
+
+---
+
+# Output Template – Full
+
+```apx
+region {{regionStaticId}} (
+    name: {{name}}
+    type: themeTemplateComponent/contentRow
+    source {
+        type: sqlQuery
+        sqlQuery:
+            ```sql
+            {{source.sqlQuery}}
+            ```
+    }
+    orderBy {
+        type: staticValue
+        orderByClause: {{orderBy.orderByClause}}
+    }
+    componentAppearance {
+        display: {{componentAppearance.display}}
+    }
+    settings {
+        overline: &{{settings.overlineColumn}}.
+        title: &{{settings.titleColumn}}.
+        description: &{{settings.descriptionColumn}}.
+        miscellaneous: &{{settings.miscellaneousColumn}}.
+        displayAvatar: {{settings.displayAvatar}}
+        displayBadge: {{settings.displayBadge}}
+    }
+    plugin-avatar {
+        type: {{pluginAvatar.type}}
+        icon: {{pluginAvatar.icon}}
+        initials: {{pluginAvatar.initials}}
+        description: {{pluginAvatar.description}}
+        shape: {{pluginAvatar.shape}}
+        size: {{pluginAvatar.size}}
+        cssClasses: {{pluginAvatar.cssClasses}}
+    }
+    plugin-badge {
+        label: {{pluginBadge.label}}
+        value: {{pluginBadge.value}}
+        state: {{pluginBadge.state}}
+        displayLabel: {{pluginBadge.displayLabel}}
+        style: {{pluginBadge.style}}
+        shape: {{pluginBadge.shape}}
+        size: {{pluginBadge.size}}
+        icon: {{pluginBadge.icon}}
+        position: {{pluginBadge.position}}
+        columnWidth: {{pluginBadge.columnWidth}}
+    }
+    rowSelection {
+        type: {{rowSelection.type}}
+        currentSelectionPageItem: {{rowSelection.currentSelectionPageItem}}
+        selectAllPageItem: {{rowSelection.selectAllPageItem}}
+    }
+    pagination {
+        type: {{pagination.type}}
+        entitiesPerPage: {{pagination.entitiesPerPage}}
+        showTotalCount: {{pagination.showTotalCount}}
+    }
+    action {{actionStaticId}} (
+        position: {{action.position}}
+        template: {{action.template}}
+        label: {{action.label}}
+        layout {
+            sequence: {{action.layout.sequence}}
+        }
+        behavior {
+            type: {{action.behavior.type}}
+            target: {{action.behavior.target}}
+            targetUrl: {{action.behavior.targetUrl}}
+            linkAttributes: {{action.behavior.linkAttributes}}
+        }
+    )
+    column {{column.name}} (
+        layout {
+            sequence: {{column.layout.sequence}}
+        }
+        source {
+            databaseColumn: {{column.source.databaseColumn}}
+            dataType: {{column.source.dataType}}
+            primaryKey: {{column.source.primaryKey}}
+        }
+    )
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- In `partial` mode, omit report-only blocks such as grouping, row selection, and pagination.
+- In `report` mode, include a PK-backed column when row identity matters.
+- In `report` mode with any `source.location`, emit immediate child `column (...)` blocks using the multiline layout/source shape shown above. Do not emit one-line child blocks such as `layout { sequence: 10 }`.
+- By default, emit a Content Row child column for every delivered source projection in region-source order.
+- At minimum, the emitted child columns must still cover row identity, `settings`, `plugin-avatar`, `plugin-badge`, row selection, row actions, and deterministic sorting, but the default generated shape should mirror the full source projection rather than a compiler-minimum subset.
+- When `pagination {}` is emitted, define `pagination.type: page` or `pagination.type: scroll`.
+- Use `pagination.entitiesPerPage` only when the page-based experience needs an explicit page size.
+- Render `action.template` only for `position: primaryActions`.
+- Render nested `menu` entries only when `template: menu`.
+- For `settings.overline`, `settings.title`, `settings.description`, and `settings.miscellaneous`, use `&COLUMN_NAME.` substitution for query-column mappings; literal strings such as `overline: Employee` are allowed when they are not query-column mappings.
+- Use `rowSelection { type: focusOnly }` for focus-only row behavior with no selection page items. Use `rowSelection { type: singleSelection currentSelectionPageItem: Pn_SELECTED_KEY }` for native single-row selection. Use `rowSelection { type: multipleSelection currentSelectionPageItem: Pn_SELECTED_KEYS selectAllPageItem: Pn_SELECT_ALL }` for native multi-row selection.
+- Use `position: fullRowLink` for row navigation and required master-detail context setting; do not use `primaryActions` for the primary row-selection affordance.
+- For same-page master-detail parent-child selection, set the hidden context item from the row PK using `behavior.target.items` with `&COLUMN.` substitution. Native `rowSelection.currentSelectionPageItem` does not satisfy this requirement.
+- When any `rowSelection` mode is used, keep one child column marked with `source.primaryKey: true`.
+- For SQL-backed Content Row regions, remove ordering from `source.sqlQuery` and emit a top-level `orderBy` block immediately after `source`.
+- For static sorting, `orderBy.orderByClause` contains only the clause body, for example `order_datetime desc, order_id desc`.
+- For item-controlled sorting, use the exact object shape `orderBy { type: item item: { itemName: Pn_SORT orderBys: { KEY: ORDER BY ... } } }` and ensure `itemName` refers to a page item on the same page.
+- When any child column carries a grouping property, ensure the top-level `orderBy` starts with every grouped column in grouping order before any remaining tie-breakers.
+- Keep `plugin-avatar` configuration-only; avatar visibility is controlled by `settings.displayAvatar`.
+- Keep `plugin-badge` configuration-only; badge visibility is controlled by `settings.displayBadge`.
+- Use `plugin-badge.style` and `plugin-badge.shape` only when the prompt explicitly requests a visual badge treatment.
+- Use `plugin-badge.icon` only when the prompt explicitly requests badge iconography.
+- Use `plugin-badge.position` only when the prompt explicitly requests a start/end badge placement override.
+- Keep optional plugin groups (`plugin-avatar`, `plugin-badge`, `plugin-appearance`, `plugin-grouping`) only when required by prompt.
+
+# Validation Checklist
+
+- Region type is `themeTemplateComponent/contentRow`.
+- All actions use supported positions.
+- `primaryActions` does not use unsupported templates.
+- Component blocks declared with parentheses close with `)`.
+- Column mappings use `databaseColumn`.
+- `position`, when present in `plugin-badge`, uses a supported placement value.
+- Content Row URL actions use `behavior.targetUrl`; same-application page actions use structured `behavior.target` when supported.
+- `settings` references columns that exist in the source query/columns and uses `&COLUMN_NAME.` syntax for column-backed display values.
+- SQL-backed Content Row regions include `orderBy {}`; `source.sqlQuery` contains no `ORDER BY`.
+- `orderBy.type` is `staticValue` or `item`. `staticValue` includes `orderByClause`; `item` includes `itemName` and `orderBys`.
+- When any child column uses grouping, `orderBy` sorts by all grouped columns first before any non-grouping tie-breakers.
+- Native row selection uses `rowSelection.type: focusOnly|singleSelection|multipleSelection`. `focusOnly` emits no selection page items. `singleSelection` includes `currentSelectionPageItem`, and the referenced hidden page item exists on the page. `multipleSelection` includes `currentSelectionPageItem` and `selectAllPageItem`, with a hidden current-selection item and same-page checkbox select-all item.
+- Master-detail parent-child filtering includes a `fullRowLink` action that sets the hidden context item through `behavior.target.items`; native `rowSelection.currentSelectionPageItem` alone does not satisfy drill-down/context setting.
+- When native row selection is present, at least one immediate child column carries `source.primaryKey: true`.
+- Content Row pagination uses `pagination.type: page` or `scroll`; do not emit classic-report pagination tokens.
+- Report-mode Content Row columns are immediate region children and must define multiline `layout { sequence: ... }` plus `source { databaseColumn: ... dataType: ... }`; add `primaryKey: true` only on the identity column.

package/skills/apexlang/templates/template-components/content-row/content-row._index.md

@@ -0,0 +1,49 @@
+---
+templateId: content-row.index
+componentType: templateComponent
+imports:
+  - content-row.common
+version: 1.0
+description: Entry point and routing catalog for Content Row template scenarios.
+---
+
+## Purpose
+Use as the routing index for Content Row templates. Select a scenario based on display mode and required features.
+
+## Default Routing
+- Default create-page/create-region prompts with Content Row and no qualifiers should select `content-row.report-minimal.md`.
+- Use `report-explicit-defaults` only when pagination or entity-title defaults are specifically requested.
+- Avatar scenarios use `settings.displayAvatar` for visibility and `plugin-avatar` for configuration fields such as `type`, `initials`, `description`, `shape`, `size`, and `cssClasses`.
+- Badge scenarios use `settings.displayBadge` for visibility and `plugin-badge` for configuration fields such as `label`, `value`, `state`, `icon`, `displayLabel`, `style`, `shape`, `size`, `columnWidth`, and `position`.
+- Use avatar, badge, links, primary actions, grouping, and appearance scenario files only when those features are explicitly requested.
+- Use `content-row.report-grouping-selection.md` when native Content Row focus-only, single-row, or multiple-row selection is requested; it documents `rowSelection.currentSelectionPageItem` and the same-page hidden item that stores native selected row state.
+- Use `content-row.report-master-detail-full-row-link.md` when a Content Row parent list filters or drives child detail regions. Native `rowSelection.currentSelectionPageItem` alone is not sufficient for parent-child context setting.
+- Use `content-row._template_options.md`, `../avatar._template_options.md`, and `../badge._template_options.md` when validating Content Row plugin attribute names or allowed values.
+- For SQL-backed Content Row scenarios, keep the SQL unordered and emit the region-level `orderBy {}` block from `content-row._common.md`.
+
+## Scenario Routing
+- Minimal partial row: `content-row.partial-minimal.md`
+- Rich partial row with avatar/badge/links: `content-row.partial-rich-content.md`
+- Minimal report row list: `content-row.report-minimal.md`
+- Report defaults + pagination/entity titles: `content-row.report-explicit-defaults.md`
+- Avatar + badge emphasis in report mode, including badge icon/position: `content-row.report-avatar-badge.md`
+- Link positions (`titleLink`, `avatarLink`, `badgeLink`, `fullRowLink`): `content-row.report-link-positions.md`
+- Master-detail parent selection with a same-page hidden item: `content-row.report-master-detail-full-row-link.md`
+- Primary actions (`button` + `menu`): `content-row.report-primary-actions-menu.md`
+- Native focus/single/multiple row selection + grouping + pagination: `content-row.report-grouping-selection.md`
+- Appearance modifiers: `content-row.report-appearance-variants.md`
+
+## Templates
+- Shared contract: `@/template-components/content-row/content-row._common.md`
+- Canonical executable skeleton: `@/template-components/content-row/content-row._common.md`
+- Scenario templates:
+  - `@/template-components/content-row/content-row.partial-minimal.md`
+  - `@/template-components/content-row/content-row.partial-rich-content.md`
+  - `@/template-components/content-row/content-row.report-minimal.md`
+  - `@/template-components/content-row/content-row.report-explicit-defaults.md`
+  - `@/template-components/content-row/content-row.report-avatar-badge.md`
+  - `@/template-components/content-row/content-row.report-link-positions.md`
+  - `@/template-components/content-row/content-row.report-master-detail-full-row-link.md`
+  - `@/template-components/content-row/content-row.report-primary-actions-menu.md`
+  - `@/template-components/content-row/content-row.report-grouping-selection.md`
+  - `@/template-components/content-row/content-row.report-appearance-variants.md`

package/skills/apexlang/templates/template-components/content-row/content-row._template_options.md

@@ -0,0 +1,27 @@
+# Content Row Template Options
+
+These entries come from `create_plugin_attribute` and `create_plugin_attr_value`, not from `wwv_flow_template_options`.
+
+Apply these values through `settings`, `plugin-appearance`, and `plugin-grouping`.
+Load `../avatar._template_options.md` and `../badge._template_options.md` for the shared avatar and badge substructures used by Content Row.
+Emit only exact accepted values from this inventory. Do not concatenate adjacent values into one token and do not substitute labels or implementation details.
+
+When a row includes `values=`, pass the left-hand side of each `name=>return_value` pair.
+
+## Content Row (`contentRow`)
+Supported: `PARTIAL:REPORT`
+
+- `description` | prompt=`Description` | type=`HTML` | scope=`COMPONENT` | required=`false` | default=`--` | group=`--` | depends=`--`
+- `displayAvatar` | prompt=`Display Avatar` | type=`CHECKBOX` | scope=`COMPONENT` | required=`false` | default=`N` | group=`--` | depends=`--`
+- `displayBadge` | prompt=`Display Badge` | type=`CHECKBOX` | scope=`COMPONENT` | required=`false` | default=`N` | group=`--` | depends=`--`
+- `itemCssClasses` | prompt=`Item CSS Classes` | type=`TEXT` | scope=`COMPONENT` | required=`false` | default=`--` | group=`--` | depends=`--`
+- `miscellaneous` | prompt=`Miscellaneous` | type=`HTML` | scope=`COMPONENT` | required=`false` | default=`--` | group=`--` | depends=`--`
+- `overline` | prompt=`Overline` | type=`HTML` | scope=`COMPONENT` | required=`false` | default=`--` | group=`--` | depends=`--`
+- `title` | prompt=`Title` | type=`HTML` | scope=`COMPONENT` | required=`false` | default=`--` | group=`--` | depends=`--`
+- `applyThemeColors` | prompt=`Apply Theme Colors` | type=`CHECKBOX` | scope=`REPORT` | required=`false` | default=`Y` | group=`Appearance` | depends=`--`
+- `hideBorders` | prompt=`Hide Borders` | type=`CHECKBOX` | scope=`REPORT` | required=`false` | default=`N` | group=`Appearance` | depends=`--`
+- `removePadding` | prompt=`Remove Padding` | type=`CHECKBOX` | scope=`REPORT` | required=`false` | default=`N` | group=`Appearance` | depends=`--`
+- `stackOnMobile` | prompt=`Stack on Mobile` | type=`CHECKBOX` | scope=`REPORT` | required=`false` | default=`N` | group=`Appearance` | depends=`--`
+- `style` | prompt=`Style` | type=`SELECT LIST` | scope=`REPORT` | required=`false` | default=`--` | group=`Appearance` | depends=`--` | values=`compact=>t-ContentRow--styleCompact`
+- `icon` | prompt=`Icon` | type=`ICON` | scope=`REPORT_GROUP` | required=`false` | default=`--` | group=`Grouping` | depends=`title NOT_NULL`
+- `title` | prompt=`Title` | type=`HTML` | scope=`REPORT_GROUP` | required=`true` | default=`--` | group=`Grouping` | depends=`--`

package/skills/apexlang/templates/template-components/content-row/content-row.partial-minimal.md

@@ -0,0 +1,33 @@
+---
+templateId: content-row.partial-minimal
+componentType: templateComponent
+imports:
+  - content-row.common
+version: 1.0
+description: Smallest valid Content Row partial-mode example.
+---
+
+# Purpose
+Render a single-row Content Row region in `partial` mode with core `settings` only.
+
+# Output Template
+```apx
+region {{regionStaticId}} (
+    name: {{name}}
+    type: themeTemplateComponent/contentRow
+    componentAppearance {
+        display: partial
+    }
+    settings {
+        title: &{{settings.titleColumn}}.
+    }
+)
+```
+
+# Conditional Rendering Rules
+- Keep `componentAppearance.display: partial`.
+- Omit report-only sections (pagination, grouping, row selection, entity title, explicit report columns).
+
+# Validation Checklist
+- One-row source query or deterministic single-entity source.
+- `settings.title` is present and uses `&COLUMN_NAME.` syntax when backed by a source column.

package/skills/apexlang/templates/template-components/content-row/content-row.partial-rich-content.md

@@ -0,0 +1,64 @@
+---
+templateId: content-row.partial-rich-content
+componentType: templateComponent
+imports:
+  - content-row.common
+version: 1.0
+description: Partial-mode example with avatar, badge, and inline link positions.
+---
+
+# Purpose
+Render a single-row Content Row with avatar and badge enabled and link positions for title/avatar/badge.
+
+# Output Template
+```apx
+region {{regionStaticId}} (
+    type: themeTemplateComponent/contentRow
+    componentAppearance { display: partial }
+    settings {
+        displayAvatar: true
+        displayBadge: true
+    }
+    plugin-avatar {
+        type: {{pluginAvatar.type}}
+        initials: {{pluginAvatar.initials}}
+        description: {{pluginAvatar.description}}
+        shape: {{pluginAvatar.shape}}
+        size: {{pluginAvatar.size}}
+        cssClasses: {{pluginAvatar.cssClasses}}
+    }
+    plugin-badge {
+        label: {{pluginBadge.label}}
+        value: {{pluginBadge.value}}
+        state: {{pluginBadge.state}}
+        displayLabel: {{pluginBadge.displayLabel}}
+        style: {{pluginBadge.style}}
+        shape: {{pluginBadge.shape}}
+        size: {{pluginBadge.size}}
+        icon: {{pluginBadge.icon}}
+        position: {{pluginBadge.position}}
+        columnWidth: {{pluginBadge.columnWidth}}
+    }
+    action {{titleActionId}} ( position: titleLink )
+    action {{avatarActionId}} ( position: avatarLink )
+    action {{badgeActionId}} ( position: badgeLink )
+)
+```
+
+# Conditional Rendering Rules
+- Keep `display: partial`.
+- Use `settings.displayAvatar` to enable avatar rendering and keep `plugin-avatar` for avatar configuration only.
+- Use `initials` only when `type` is `initials`.
+- Use `cssClasses` only when the prompt explicitly requests avatar styling.
+- Use `settings.displayBadge` to enable badge rendering and keep `plugin-badge` for badge configuration only.
+- Use `style` and `shape` only when the prompt explicitly requests a visual badge treatment.
+- Use `icon` only when the prompt explicitly requests an icon-bearing badge.
+- Use `position` only when the prompt explicitly requests a start/end badge placement override.
+- Use `displayLabel` only when the prompt explicitly requests to enable or show display label.
+- Include `plugin-avatar` and `plugin-badge` only when the corresponding feature content is present.
+- Use only supported link positions.
+
+# Validation Checklist
+- Link actions include supported positions and explicit behavior type.
+- Avatar/badge fields map to available source values.
+- Badge icon and badge position values use supported fields when supplied.

package/skills/apexlang/templates/template-components/content-row/content-row.report-appearance-variants.md

@@ -0,0 +1,33 @@
+---
+templateId: content-row.report-appearance-variants
+componentType: templateComponent
+imports:
+  - content-row.common
+version: 1.0
+description: Report-mode Content Row appearance variants.
+---
+
+# Purpose
+Show compact and layout-oriented appearance options such as borders, padding, stack-on-mobile, and theme colors.
+
+# Output Template
+```apx
+region {{regionStaticId}} (
+    type: themeTemplateComponent/contentRow
+    componentAppearance { display: report }
+    plugin-appearance {
+        style: compact
+        hideBorders: true
+        removePadding: true
+        stackOnMobile: true
+    }
+)
+```
+
+# Conditional Rendering Rules
+- Apply appearance variants only when readability and layout constraints require them.
+- Keep default appearance when no explicit styling intent is provided.
+
+# Validation Checklist
+- Appearance settings are supported plugin attributes.
+- Combined options do not conflict with readability goals.

package/skills/apexlang/templates/template-components/content-row/content-row.report-avatar-badge.md

@@ -0,0 +1,57 @@
+---
+templateId: content-row.report-avatar-badge
+componentType: templateComponent
+imports:
+  - content-row.common
+version: 1.0
+description: Report-mode Content Row avatar and badge permutations.
+---
+
+# Purpose
+Show grouped avatar and badge attributes in report mode.
+
+# Output Template
+```apx
+region {{regionStaticId}} (
+    type: themeTemplateComponent/contentRow
+    componentAppearance { display: report }
+    settings {
+        displayAvatar: true
+        displayBadge: true
+    }
+    plugin-avatar {
+        type: {{pluginAvatar.type}}
+        initials: {{pluginAvatar.initials}}
+        description: {{pluginAvatar.description}}
+        shape: {{pluginAvatar.shape}}
+        size: {{pluginAvatar.size}}
+        cssClasses: {{pluginAvatar.cssClasses}}
+    }
+    plugin-badge {
+        label: {{pluginBadge.label}}
+        value: {{pluginBadge.value}}
+        state: {{pluginBadge.state}}
+        displayLabel: {{pluginBadge.displayLabel}}
+        style: {{pluginBadge.style}}
+        shape: {{pluginBadge.shape}}
+        size: {{pluginBadge.size}}
+        icon: {{pluginBadge.icon}}
+        position: {{pluginBadge.position}}
+        columnWidth: {{pluginBadge.columnWidth}}
+    }
+)
+```
+
+# Conditional Rendering Rules
+- Keep display toggles aligned with the rendered features: use `settings.displayAvatar` for avatar visibility, `settings.displayBadge` for badge visibility, and use `plugin-avatar` only for avatar configuration when avatar content is supplied.
+- Use `initials` only when `type` is `initials`.
+- Use `cssClasses` only when the prompt explicitly requests avatar styling.
+- Use badge state/style only when semantically meaningful.
+- Use `style` and `shape` only when the prompt explicitly asks for a visual badge treatment such as `subtle` or `rounded`.
+- Use `icon` only when the prompt explicitly requests an icon-bearing badge.
+- Use `position` only when the prompt explicitly requests a start/end badge placement override.
+
+# Validation Checklist
+- Avatar and badge source values exist.
+- Badge icon and badge position values remain deterministic when supplied.
+- Mappings remain deterministic across rows.

package/skills/apexlang/templates/template-components/content-row/content-row.report-explicit-defaults.md

@@ -0,0 +1,29 @@
+---
+templateId: content-row.report-explicit-defaults
+componentType: templateComponent
+imports:
+  - content-row.common
+version: 1.0
+description: Report-mode Content Row example with explicit defaults and pagination/entity titles.
+---
+
+# Purpose
+Document explicit default blocks in report mode, including pagination and entity titles.
+
+# Output Template
+```apx
+region {{regionStaticId}} (
+    type: themeTemplateComponent/contentRow
+    componentAppearance { display: report }
+    pagination { type: page entitiesPerPage: {{pagination.entitiesPerPage}} }
+    entityTitle { singular: {{entityTitle.singular}} plural: {{entityTitle.plural}} }
+)
+```
+
+# Conditional Rendering Rules
+- Include pagination only in report mode.
+- Keep entity title singular/plural aligned with row entity semantics.
+
+# Validation Checklist
+- Pagination settings are valid for page-level listing.
+- Entity titles are present and consistent.