pi-apexlang 0.1.0

package/skills/apexlang/templates/region-components/interactive-report/interactive-report._common.md

@@ -0,0 +1,171 @@
+---
+templateId: region.interactive-report.common
+componentType: region
+version: 1.0
+description: Shared contract for interactive report regions.
+---
+
+# Purpose
+
+Standardize the variable contract, guardrails, and template skeleton for interactive report scenarios.
+
+---
+
+# Generation Rules (MANDATORY)
+
+1. Load `references/policies/memory-bank/30-pages/apex.interactive-report.md` before drafting interactive reports.
+2. Validate SQL against the target schema or mark Validation Pending.
+3. Ensure column definitions align with the SQL projection and include comments.
+4. For NL2IR configurations, follow `references/policies/memory-bank/00-guard/ai.guard.md` and require annotation-scan metadata lookup with descriptive-annotation fallback before comments.
+5. Use `interactive-report._columns._common.md` as the canonical column contract.
+6. Emit explicit `column (...)` definitions for every SQL projection before finals; hidden technical columns still need structural headings.
+7. If `source.sqlQuery` references same-page items such as `:P3_ORDER_ID`, list those items in `source.pageItemsToSubmit`.
+8. For Interactive Report `source.sqlQuery` that uses page-item-driven text filters, emit `LOWER()` on both sides of `=` / `!=` / `LIKE`.
+9. If the report adds navigation, ask which mode is required every time: same application page, another application page, or URL redirect.
+10. When the chosen mode is same application page and the DSL supports it, emit a declarative page target instead of a URL string.
+
+---
+
+# Variable Contract
+
+
+| Name                                 | Required    | Type      | Notes                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| ------------------------------------ | ----------- | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| regionStaticId                       | yes         | string    | Identifier used after the `region` keyword.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| name                                 | yes         | string    | Builder display name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| type                                 | yes         | enum      | Always `interactiveReport`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| source.location                      | yes         | enum      | `localDatabase`, `restSource`, `sampleData`, etc.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| source.type                          | conditional | enum      | `sqlQuery`, `table`, or omitted for REST.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| source.sqlQuery                      | conditional | sql       | Required for `sqlQuery`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| source.tableName                     | conditional | string    | Required for table-sourced IRs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+| source.restSource                    | conditional | string    | Required when `location: restSource`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| source.pageItemsToSubmit             | optional    | list      | Use for REST parameters.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| layout.sequence                      | yes         | number    | Region order in the page slot.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| layout.slot                          | yes         | enum      | Slot the region occupies (e.g., `BODY`).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| appearance.template                  | optional    | string    | Report template (e.g., `@/standard`).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| appearance.templateOptions           | optional    | array     | Additional modifiers (`#DEFAULT#` default); use the documented accepted values in `interactive-report._template_options.md`, keep `#DEFAULT#` standalone, and keep documented composites atomic.                                                                                                                                                                                                                                                                                                                                                                                                 |
+| componentAppearance.showNullValuesAs | optional    | string    | Null-display value.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| pagination.type                      | optional    | enum      | Pagination strategy.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| performance.maxRowsToProcess         | optional    | number    | Max rows to process.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| messages.whenNoDataFound             | optional    | string    | Custom "no data" message.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| messages.whenMoreDataFound           | optional    | string    | Max row message.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
+| link                                 | optional    | object    | Region-level link configuration; use when needed to link to another page                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| link.linkColumn                      | conditional | enum      | Compiler-backed IR link mode. Use `customTarget` for same-app/page navigation. Other accepted runtime values include `exclude` and `singleRowView`; do not put a report column alias here.                                                                                                                                                                                                                                                                                                                                                                                                       |
+| link.target.page                     | conditional | string    | If a link is needed, set to the page ID of the target page                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| link.target.items                    | conditional | object    | If a link is needed, set page-item/value pairs for the destination page. Use `#COLUMN_ALIAS#` for current report-row column values, `&ITEM.` for page/app/session substitution values, or literals where appropriate. Example: `items: { P1_ID: #ID# P1_STATUS: &P1_STATUS. P1_VAL: 100 }`                                                                                                                                                                                                                                                                                                |
+| link.target.clearCache               | conditional | number    | List of comma-separated page numbers; used to clear the session cache of each page                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| link.target.action                   | conditional | string    | Use when performing an additional action on the page. Valid values are:- `clearRegions` : Completely tears down all session settings and customizations (like filters, aggregates, and highlights), reverting the region to the absolute default state.- `resetRegions` : Reverts the region back to its last saved state (e.g., the default report settings) while often preserving pagination or specific saved report metadata.- `resetPagination` : resets the pagination for all reports on the target pageIn most cases, this will be either omitted entirely or set to `resetPagination` |
+| link.target.request                  | conditional | string    | Context of actions typically refers to the **Request Value** sent during a page submission to trigger specific server-side processes; often used to simulate pressing a button                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| link.linkIcon                        | conditional | string    | Used to act as what the user will click to activate the link. Default to `<span role="img" aria-label="Edit" class="fa fa-edit" title="Edit"></span>`                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| link.linkAttributes                  | conditional | string    | Enter additional column link attributes to be included in the `<a href=...>` tag, including link target, classes or styles.                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| link.authorizationScheme             | conditional | string    | Enter the Authorization Scheme that a user need to have in order to see the link rendered on the report. Should be prefixed with `@`                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| columns                              | conditional | list      | One or more column blocks following `interactive-report._columns._common.md`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
+| savedReport.*                        | optional    | object    | Saved report defaults.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| genAI.*                              | optional    | object    | NL2IR settings (scan annotations first, then comments).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| serverSideCondition.*                | optional    | condition | Server-side gating of region visibility.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
+| security.authorizationScheme         | optional    | string    | Authorization scheme alias.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+
+
+---
+
+# Output Template – Full
+
+```apexlang
+region {{regionStaticId}} (
+  name: {{name}}
+  type: interactiveReport
+  source {
+    location: {{source.location}}
+    type: {{source.type}}
+    sqlQuery:
+        ```sql
+        {{source.sqlQuery}}
+        ```
+    tableName: {{source.tableName}}
+    restSource: {{source.restSource}}
+    pageItemsToSubmit: {{source.pageItemsToSubmit}}
+  }
+  layout {
+    sequence: {{layout.sequence}}
+    slot: {{layout.slot}}
+  }
+  appearance {
+    template: {{appearance.template}}
+    templateOptions: {{appearance.templateOptions}}
+  }
+  componentAppearance {
+    showNullValuesAs: {{componentAppearance.showNullValuesAs}}
+  }
+  link {
+      linkColumn: {{link.linkColumn}}
+      target: {
+          page: {{link.target.page}}
+          items: {
+              {{link.target.items}}
+          }
+          clearCache: {{link.target.clearCache}}
+          action: {{link.target.action}}
+          request: {{link.target.request}}
+      }
+      linkIcon: {{link.linkIcon}}
+      linkAttributes: {{link.linkAttributes}}
+      authorizationScheme: {{link.authorizationScheme}}
+  }
+  pagination {
+    type: {{pagination.type}}
+  }
+  performance {
+    maxRowsToProcess: {{performance.maxRowsToProcess}}
+  }
+  messages {
+    whenNoDataFound: {{messages.whenNoDataFound}}
+    whenMoreDataFound: {{messages.whenMoreDataFound}}
+  }
+  genAI {
+    naturalLanguageSupport: {{genAI.naturalLanguageSupport}}
+    reportContext: {{genAI.reportContext}}
+  }
+  serverSideCondition {
+    type: {{serverSideCondition.type}}
+    item: {{serverSideCondition.item}}
+    {{serverSideCondition.comparisonAttribute}}: {{serverSideCondition.comparisonValue}}
+  }
+  {{columns}}
+  savedReport {{savedReport.name}} (
+    visibility: {{savedReport.visibility}}
+    name: {{savedReport.displayName}}
+    view {
+      rowsPerPage: {{savedReport.rowsPerPage}}
+    }
+  )
+)
+```
+
+---
+
+# Mandatory Rendering Rules
+
+- Expand `{{columns}}` using `interactive-report._columns._common.md`.
+
+---
+
+# Conditional Rendering Rules
+
+- Remove optional blocks (`link`, `pagination`, `performance`, `messages`, `genAI`, `serverSideCondition`) when not required.
+- Use server-side conditions for feature flags, request-based visibility, or authorization policies.
+- For item colon-list membership conditions, render `comparisonAttribute` as `list`; keep `value` for other comparison types.
+- When a report-level link is needed, add the `link` section. For page navigation, set `link.linkColumn: customTarget` and then provide the declarative `target: { ... }` object. Do not put a report column alias such as `ORDER_ID` or `PRODUCT_ID` into `link.linkColumn`.
+- When the report source filters on same-page context items, emit `source.pageItemsToSubmit` with the exact item tokens used in the SQL binds.
+
+---
+
+# Guardrails
+
+- Keep templateOptions as `#DEFAULT#` unless a documented `static_id` in `interactive-report._template_options.md` is required.
+- Never concatenate `#DEFAULT#` with another modifier or substitute the emitted CSS class string for the documented accepted value.
+- Use declarative same-app page targets when supported; use URL patterns only for explicit URL mode or when the component contract genuinely requires a URL string.
+- Do not finalize an Interactive Report with projected SQL columns missing from the `column (...)` list.
+- Do not leave `source.pageItemsToSubmit` empty when the report SQL depends on same-page page-item bind variables.
+- For NL2IR, derive report and column context from annotations first, using descriptive annotations before comments as fallback (no inference).
+- Validate SQL with SQLcl when possible; otherwise mark "Validation Pending".
+- The `LOWER()` normalization rule for page-item-driven text predicates is specific to Interactive Reports and does not apply to Classic Report or Interactive Grid guidance.

package/skills/apexlang/templates/region-components/interactive-report/interactive-report._index.md

@@ -0,0 +1,21 @@
+---
+templateId: interactive-report.index
+componentType: template
+version: 1.0
+imports:
+  - interactive-report._common.md
+  - interactive-report._columns._common.md
+description: Routing entrypoint for interactive-report templates.
+---
+
+# Purpose
+
+Primary routing entrypoint for `interactive-report` templates.
+
+# Load Order
+
+1. Load this file.
+2. Load `interactive-report._common.md`.
+3. Load `interactive-report._columns._common.md`.
+4. Load one scenario template in this folder.
+5. Load `interactive-report._columns.format-template.md` when column formatting guidance is needed.

package/skills/apexlang/templates/region-components/interactive-report/interactive-report._template_options.md

@@ -0,0 +1,13 @@
+# Interactive Report Template Options
+
+Use the listed `static_id` as the exact value to pass in the region's `templateOptions`.
+Example: `templateOptions: [show-maximize-button]`
+`#DEFAULT#` remains a standalone entry when used. Composite values such as `t-IRR-region--hideHeader js-addHiddenHeadingRoleDesc` stay atomic only when that full combined value is the accepted emitted value.
+
+## Interactive Report (`interactive-report`)
+Preset: `t-IRR-region--hideHeader js-addHiddenHeadingRoleDesc`
+
+- Remove Borders | `static_id=remove-borders` | `css=t-IRR-region--noBorders` | `group=--`
+- Show Maximize Button | `static_id=show-maximize-button` | `css=js-showMaximizeButton` | `group=--`
+- Hidden | `static_id=hidden` | `css=t-IRR-region--removeHeader js-removeLandmark` | `group=Header`
+- Hidden but accessible | `static_id=hidden-but-accessible` | `css=t-IRR-region--hideHeader js-addHiddenHeadingRoleDesc` | `group=Header`

package/skills/apexlang/templates/region-components/interactive-report/interactive-report.nl2ir.md

@@ -0,0 +1,109 @@
+---
+templateId: region.interactive-report.nl2ir
+componentType: region
+version: 1.0
+imports:
+  - interactive-report._common.md
+  - interactive-report._columns._common.md
+description: Interactive report with Natural Language (NL2IR) settings.
+---
+
+# Purpose
+
+Interactive report configured for Natural Language to Interactive Report (NL2IR).
+
+---
+
+# Generation Rules (MANDATORY)
+
+1. Load `interactive-report._common.md`, `interactive-report._columns._common.md`, `references/policies/memory-bank/30-pages/apex.interactive-report.md`, and `references/policies/memory-bank/00-guard/ai.guard.md` before use.
+2. NL2IR report and column context must scan annotations first, use descriptive annotations before comments, and never infer missing context.
+3. If no DB connection is available, request `db_connection_name` and stop.
+
+---
+
+# Variable Contract
+
+## Required Variables
+
+- `regionStaticId`
+- `name`
+- `source.location`
+- `source.tableName`
+- `layout.sequence`
+- `layout.slot`
+- `appearance.template`
+- `genAI.naturalLanguageSupport`
+- `genAI.reportContext` (from table/view annotation `report_context`, else `description`, else table/view comment)
+- `columns` (from `interactive-report._columns._common.md`)
+
+## Optional Variables
+
+- `appearance.templateOptions`
+- `pagination.type`
+- `messages.whenNoDataFound`
+- `messages.whenMoreDataFound`
+- `advanced.savedReportMappingIdentifier`
+- `savedReport.*`
+
+---
+
+# Output Template – Full
+
+```apexlang
+region {{regionStaticId}} (
+  name: {{name}}
+  type: interactiveReport
+
+  source {
+    location: {{source.location}}
+    tableName: {{source.tableName}}
+  }
+
+  layout {
+    sequence: {{layout.sequence}}
+    slot: {{layout.slot}}
+  }
+
+  appearance {
+    template: {{appearance.template}}
+    templateOptions: {{appearance.templateOptions}}
+  }
+
+  pagination {
+    type: {{pagination.type}}
+  }
+
+  messages {
+    whenNoDataFound: {{messages.whenNoDataFound}}
+    whenMoreDataFound: {{messages.whenMoreDataFound}}
+  }
+
+  genAI {
+    naturalLanguageSupport: {{genAI.naturalLanguageSupport}}
+    reportContext: {{genAI.reportContext}}
+  }
+
+  advanced {
+    savedReportMappingIdentifier: {{advanced.savedReportMappingIdentifier}}
+  }
+
+  {{columns}}
+
+  savedReport {{savedReport.name}} (
+    visibility: {{savedReport.visibility}}
+    name: {{savedReport.displayName}}
+    view {
+      rowsPerPage: {{savedReport.rowsPerPage}}
+    }
+  )
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- NL2IR context must be derived from annotations first, using descriptive annotations before comments as fallback.
+- Render `{{columns}}` using `interactive-report._columns._common.md`.
+- Omit optional blocks when their corresponding variables are not provided.

package/skills/apexlang/templates/region-components/interactive-report/interactive-report.page-header-actions.md

@@ -0,0 +1,154 @@
+---
+templateId: region.interactive-report.page-header-actions
+componentType: region
+version: 1.0
+imports:
+  - interactive-report._common.md
+description: Optional page header, breadcrumb, and IR action button patterns.
+---
+
+# Purpose
+
+Optional page header, breadcrumb, and IR action button patterns used with interactive reports.
+
+---
+
+# Generation Rules (MANDATORY)
+
+1. Load `interactive-report._common.md` and `references/policies/memory-bank/30-pages/apex.page.md` before use.
+2. Use only existing theme templates and breadcrumb aliases.
+3. Use action buttons with `slot: RIGHT_OF_IR_SEARCH_BAR` only when bound to a specific IR region.
+
+---
+
+# Variable Contract
+
+## Required Variables
+
+- `headerRegion.staticId`
+- `headerRegion.name`
+- `headerRegion.type`
+- `headerRegion.sequence`
+- `headerRegion.slot`
+- `breadcrumbRegion.staticId`
+- `breadcrumbRegion.name`
+- `breadcrumbRegion.breadcrumb`
+- `button.staticId`
+- `button.buttonName`
+- `button.label`
+- `button.region`
+- `dynamicAction.staticId`
+
+## Optional Variables
+
+- `headerRegion.title`
+- `headerRegion.display`
+- `breadcrumbRegion.sequence`
+- `breadcrumbRegion.parentRegion`
+- `breadcrumbRegion.slot`
+- `breadcrumbRegion.template`
+- `breadcrumbRegion.templateOptions`
+- `breadcrumbRegion.breadcrumbTemplate`
+- `button.sequence`
+- `button.slot`
+- `button.template`
+- `button.templateOptions`
+- `button.icon`
+- `button.action`
+- `dynamicAction.name`
+- `dynamicAction.sequence`
+- `dynamicAction.event`
+- `dynamicAction.action.*`
+
+---
+
+# Output Template – Full
+
+```apexlang
+region {{headerRegion.staticId}} (
+  name: {{headerRegion.name}}
+  title: {{headerRegion.title}}
+  type: {{headerRegion.type}}
+  layout {
+    sequence: {{headerRegion.sequence}}
+    slot: {{headerRegion.slot}}
+  }
+  componentAppearance {
+    display: {{headerRegion.display}}
+  }
+)
+
+region {{breadcrumbRegion.staticId}} (
+  name: {{breadcrumbRegion.name}}
+  type: breadcrumb
+  source {
+    breadcrumb: @{{breadcrumbRegion.breadcrumb}}
+  }
+  layout {
+    sequence: {{breadcrumbRegion.sequence}}
+    parentRegion: @{{breadcrumbRegion.parentRegion}}
+    slot: {{breadcrumbRegion.slot}}
+  }
+  appearance {
+    template: {{breadcrumbRegion.template}}
+    templateOptions: {{breadcrumbRegion.templateOptions}}
+  }
+  componentAppearance {
+    breadcrumbTemplate: @{{breadcrumbRegion.breadcrumbTemplate}}
+    templateOptions: {{breadcrumbRegion.templateOptions}}
+  }
+)
+
+button {{button.staticId}} (
+  buttonName: {{button.buttonName}}
+  label: {{button.label}}
+  layout {
+    sequence: {{button.sequence}}
+    region: @{{button.region}}
+    slot: {{button.slot}}
+  }
+  appearance {
+    buttonTemplate: {{button.template}}
+    templateOptions: {{button.templateOptions}}
+    icon: {{button.icon}}
+  }
+  behavior {
+    action: {{button.action}}
+  }
+)
+
+dynamicAction {{dynamicAction.staticId}} (
+  name: {{dynamicAction.name}}
+  execution {
+    sequence: {{dynamicAction.sequence}}
+  }
+  when {
+    event: {{dynamicAction.event}}
+    selectionType: button
+    button: @{{button.staticId}}
+  }
+
+  action {{dynamicAction.action.staticId}} (
+    action: {{dynamicAction.action.type}}
+    settings {
+      title: {{dynamicAction.action.title}}
+      message: {{dynamicAction.action.message}}
+      style: {{dynamicAction.action.style}}
+      icon: {{dynamicAction.action.icon}}
+      okLabel: {{dynamicAction.action.okLabel}}
+    }
+    execution {
+      sequence: {{dynamicAction.action.sequence}}
+      event: @{{dynamicAction.staticId}}
+      fireOnInit: {{dynamicAction.action.fireOnInit}}
+    }
+  )
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Replace theme template references with valid aliases.
+- Remove button and dynamic action blocks when no custom action is required.

package/skills/apexlang/templates/region-components/interactive-report/interactive-report.rest-data-source-parameter.md

@@ -0,0 +1,155 @@
+---
+templateId: region.interactive-report.rest-data-source-parameter
+componentType: region
+version: 1.0
+imports:
+  - interactive-report._common.md
+  - interactive-report._columns._common.md
+description: Interactive report using REST Data Source with page item parameters.
+---
+
+# Purpose
+
+Interactive report backed by REST Data Source with page item parameter and refresh action.
+
+---
+
+# Generation Rules (MANDATORY)
+
+1. Load `interactive-report._common.md`, `interactive-report._columns._common.md`, and `references/policies/memory-bank/30-pages/apex.interactive-report.md` before use.
+2. Confirm REST Data Source aliases exist under `shared-components/rest-data-sources/`.
+3. Ensure page items listed in `source.pageItemsToSubmit` exist on the page.
+
+---
+
+# Variable Contract
+
+## Required Variables
+
+- `regionStaticId`
+- `name`
+- `source.location` (use `restSource`)
+- `source.restSource`
+- `source.pageItemsToSubmit`
+- `layout.sequence`
+- `layout.slot`
+- `appearance.template`
+- `columns` (from `interactive-report._columns._common.md`)
+- `parameter.name`
+- `parameter.value.type`
+- `pageItem.name`
+- `dynamicAction.name`
+
+## Optional Variables
+
+- `appearance.templateOptions`
+- `pagination.type`
+- `messages.whenNoDataFound`
+- `messages.whenMoreDataFound`
+- `advanced.savedReportMappingIdentifier`
+- `parameter.value.item`
+- `parameter.value.staticValue`
+- `pageItem.*`
+- `dynamicAction.*`
+
+---
+
+# Output Template – Full
+
+```apexlang
+region {{regionStaticId}} (
+  name: {{name}}
+  type: interactiveReport
+
+  source {
+    location: {{source.location}}
+    restSource: @{{source.restSource}}
+    pageItemsToSubmit: {{source.pageItemsToSubmit}}
+  }
+
+  layout {
+    sequence: {{layout.sequence}}
+    slot: {{layout.slot}}
+  }
+
+  appearance {
+    template: {{appearance.template}}
+    templateOptions: {{appearance.templateOptions}}
+  }
+
+  pagination {
+    type: {{pagination.type}}
+  }
+
+  messages {
+    whenNoDataFound: {{messages.whenNoDataFound}}
+    whenMoreDataFound: {{messages.whenMoreDataFound}}
+  }
+
+  advanced {
+    savedReportMappingIdentifier: {{advanced.savedReportMappingIdentifier}}
+  }
+
+  {{columns}}
+
+  parameter (
+    name: @{{parameter.name}}
+    value {
+      type: {{parameter.value.type}}
+      item: {{parameter.value.item}}
+      staticValue: {{parameter.value.staticValue}}
+    }
+  )
+)
+
+pageItem {{pageItem.name}} (
+  type: {{pageItem.type}}
+  label {
+    label: {{pageItem.label}}
+    alignment: {{pageItem.labelAlignment}}
+  }
+  layout {
+    sequence: {{pageItem.sequence}}
+    slot: {{pageItem.slot}}
+    alignment: {{pageItem.alignment}}
+  }
+  appearance {
+    template: {{pageItem.template}}
+    templateOptions: {{pageItem.templateOptions}}
+    width: {{pageItem.width}}
+  }
+)
+
+dynamicAction {{dynamicAction.name}} (
+  name: {{dynamicAction.displayName}}
+  execution {
+    sequence: {{dynamicAction.sequence}}
+  }
+  when {
+    selectionType: {{dynamicAction.when.selectionType}}
+    items: {{dynamicAction.when.items}}
+  }
+
+  action {{dynamicAction.action.name}} (
+    action: refresh
+    affectedElements {
+      selectionType: region
+      region: @{{regionStaticId}}
+    }
+    execution {
+      sequence: {{dynamicAction.action.sequence}}
+      event: @{{dynamicAction.name}}
+      fireOnInit: {{dynamicAction.action.fireOnInit}}
+    }
+  )
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Render `{{columns}}` using `interactive-report._columns._common.md`.
+- Omit `parameter.value.item` when value type is not `item`.
+- Omit `parameter.value.staticValue` when value type is not `static`.
+- Omit optional page item and dynamic action attributes when not provided.