pi-apexlang 0.2.2 → 0.4.0

package/skills/apexlang/manifest.json

@@ -23,9 +23,17 @@
     "assets/apexlang/domains-catalog.json",
     "assets/orchestration.manifest.json",
     "assets/rules-mapping.json",
+    "assets/rules.catalog.json",
     "assets/component-policies.json",
     "assets/component-attributes.json",
+    "assets/grammar/apexlang.ebnf",
     "assets/validator-fix-recipes.json",
+    "assets/indexes/font-apex-icon-index.json",
+    "assets/contracts/page-patterns.json",
+    "assets/contracts/page-construction-packs.json",
+    "assets/contracts/grammar-semantic-rules.json",
+    "assets/contracts/package-layers.json",
+    "assets/apex-generation/components.registry.json",
     "references/policies/compiler-prop-map.md",
     "references/workflows/apex-generation.md",
     "references/workflows/apexlang/apexlang-execution-model.md",
@@ -37,6 +45,8 @@
     "references/ops/runtime-gates.md",
     "tools/apexctl.mjs",
     "tools/query-valid-props.mjs",
+    "tools/query-valid-props-context.mjs",
+    "tools/query-valid-props-semantics.mjs",
     "tools/query-valid-props-normalize.mjs",
     "tools/query-valid-props-runtime.mjs",
     "tools/compiler-truth-audit.mjs",
@@ -84,10 +94,22 @@
       "source": "skills/apexlang/tools/lib/common.mjs",
       "dest": "runtime/lib/common.mjs"
     },
+    {
+      "source": "skills/apexlang/tools/lib/catalogs.mjs",
+      "dest": "runtime/lib/catalogs.mjs"
+    },
+    {
+      "source": "skills/apexlang/tools/public/grammar_contract.mjs",
+      "dest": "runtime/grammar_contract.mjs"
+    },
     {
       "source": "skills/apexlang/tools/internal/python/validate_apexlang.py",
       "dest": "runtime/internal/python/validate_apexlang.py"
     },
+    {
+      "source": "skills/apexlang/tools/internal/python/format_apexlang.py",
+      "dest": "runtime/internal/python/format_apexlang.py"
+    },
     {
       "source": "skills/apexlang/tools/internal/python/validate_apexlang_vocab.py",
       "dest": "runtime/internal/python/validate_apexlang_vocab.py"
@@ -105,6 +127,8 @@
     "SKILL.md",
     "tools/apexctl.mjs",
     "tools/query-valid-props.mjs",
+    "tools/query-valid-props-context.mjs",
+    "tools/query-valid-props-semantics.mjs",
     "tools/query-valid-props-normalize.mjs",
     "tools/query-valid-props-runtime.mjs",
     "tools/compiler-truth-audit.mjs"
@@ -161,6 +185,22 @@
       "path": "assets/context-schema.json",
       "source": null
     },
+    {
+      "path": "assets/contracts/grammar-semantic-rules.json",
+      "source": "skills/apexlang/contracts/grammar-semantic-rules.json"
+    },
+    {
+      "path": "assets/contracts/package-layers.json",
+      "source": "skills/apexlang/contracts/package-layers.json"
+    },
+    {
+      "path": "assets/contracts/page-construction-packs.json",
+      "source": "skills/apexlang/contracts/page-construction-packs.json"
+    },
+    {
+      "path": "assets/contracts/page-patterns.json",
+      "source": "skills/apexlang/contracts/page-patterns.json"
+    },
     {
       "path": "assets/domains/business-logic/computations-prompt.md",
       "source": "skills/apexlang/business-logic/assets/computations-prompt.md"
@@ -209,6 +249,14 @@
       "path": "assets/domains/universal-attr-config/translations.prompts.json",
       "source": "skills/apexlang/universal-attr-config/assets/translations.prompts.json"
     },
+    {
+      "path": "assets/grammar/apexlang.ebnf",
+      "source": "ai-context/apexlang/grammar/apexlang.ebnf"
+    },
+    {
+      "path": "assets/indexes/font-apex-icon-index.json",
+      "source": "skills/apexlang/assets/indexes/font-apex-icon-index.json"
+    },
     {
       "path": "assets/orchestration.manifest.json",
       "source": "skills/sqlcl/assets/orchestration.manifest.json"
@@ -229,6 +277,10 @@
       "path": "assets/rules-mapping.json",
       "source": "ai-context/memory-bank/rules-mapping.json"
     },
+    {
+      "path": "assets/rules.catalog.json",
+      "source": "ai-context/memory-bank/rules.catalog.json"
+    },
     {
       "path": "assets/validator-fix-recipes.json",
       "source": "skills/apexlang/assets/validator-fix-recipes.json"
@@ -385,6 +437,10 @@
       "path": "references/domains/page-components/regions/interactive-report/workflow-interactive-report.md",
       "source": "skills/apexlang/page-components/regions/references/interactive-report/workflow-interactive-report.md"
     },
+    {
+      "path": "references/domains/page-components/regions/region-display-selector/workflow-region-display-selector.md",
+      "source": "skills/apexlang/page-components/regions/references/region-display-selector/workflow-region-display-selector.md"
+    },
     {
       "path": "references/domains/page-components/regions/registry.md",
       "source": "skills/apexlang/page-components/regions/references/registry.md"
@@ -421,6 +477,10 @@
       "path": "references/domains/shared-components/workflow-translations.md",
       "source": "skills/apexlang/shared-components/references/workflow-translations.md"
     },
+    {
+      "path": "references/domains/template-components/comments.md",
+      "source": "skills/apexlang/page-components/template-components/references/comments.md"
+    },
     {
       "path": "references/domains/template-components/registry.md",
       "source": "skills/apexlang/page-components/template-components/references/registry.md"
@@ -429,6 +489,10 @@
       "path": "references/domains/template-components/templates.md",
       "source": "skills/apexlang/page-components/template-components/references/templates.md"
     },
+    {
+      "path": "references/domains/template-components/timeline.md",
+      "source": "skills/apexlang/page-components/template-components/references/timeline.md"
+    },
     {
       "path": "references/domains/template-components/workflow-items-templates.md",
       "source": "skills/apexlang/page-components/template-components/references/workflow-items-templates.md"
@@ -553,6 +617,10 @@
       "path": "references/policies/memory-bank/30-pages/apex.calendar.md",
       "source": "ai-context/memory-bank/30-pages/apex.calendar.md"
     },
+    {
+      "path": "references/policies/memory-bank/30-pages/apex.cards-page.md",
+      "source": "ai-context/memory-bank/30-pages/apex.cards-page.md"
+    },
     {
       "path": "references/policies/memory-bank/30-pages/apex.chart-page.md",
       "source": "ai-context/memory-bank/30-pages/apex.chart-page.md"
@@ -701,6 +769,14 @@
       "path": "references/workflows/apexlang/workflow-create-app-from-fr-and-model.md",
       "source": "skills/apexlang/references/workflow-create-app-from-fr-and-model.md"
     },
+    {
+      "path": "runtime/grammar_contract.mjs",
+      "source": null
+    },
+    {
+      "path": "runtime/internal/python/format_apexlang.py",
+      "source": null
+    },
     {
       "path": "runtime/internal/python/validate_apexlang.py",
       "source": null
@@ -717,6 +793,10 @@
       "path": "runtime/internal/python/validator_common.py",
       "source": null
     },
+    {
+      "path": "runtime/lib/catalogs.mjs",
+      "source": null
+    },
     {
       "path": "runtime/lib/common.mjs",
       "source": null
@@ -2193,6 +2273,14 @@
       "path": "templates/region-components/cards/cards._template_options.md",
       "source": "ai-context/apexlang/templates/region-components/cards/cards._template_options.md"
     },
+    {
+      "path": "templates/region-components/cards/cards.refresh-after-dialog.md",
+      "source": "ai-context/apexlang/templates/region-components/cards/cards.refresh-after-dialog.md"
+    },
+    {
+      "path": "templates/region-components/cards/cards.refresh-on-change.md",
+      "source": "ai-context/apexlang/templates/region-components/cards/cards.refresh-on-change.md"
+    },
     {
       "path": "templates/region-components/cards/cards.rest-source.md",
       "source": "ai-context/apexlang/templates/region-components/cards/cards.rest-source.md"
@@ -2685,6 +2773,10 @@
       "path": "templates/region-components/region-display-selector/region-display-selector._index.md",
       "source": "ai-context/apexlang/templates/region-components/region-display-selector/region-display-selector._index.md"
     },
+    {
+      "path": "templates/region-components/region-display-selector/region-display-selector.permutations.md",
+      "source": "ai-context/apexlang/templates/region-components/region-display-selector/region-display-selector.permutations.md"
+    },
     {
       "path": "templates/region-components/region-display-selector/region-display-selector.standard.md",
       "source": "ai-context/apexlang/templates/region-components/region-display-selector/region-display-selector.standard.md"
@@ -3086,12 +3178,56 @@
       "source": "ai-context/apexlang/templates/template-components/actions/actions.nested-group.md"
     },
     {
-      "path": "templates/template-components/avatar._template_options.md",
-      "source": "ai-context/apexlang/templates/template-components/avatar._template_options.md"
+      "path": "templates/template-components/avatar/README.md",
+      "source": "ai-context/apexlang/templates/template-components/avatar/README.md"
+    },
+    {
+      "path": "templates/template-components/avatar/avatar._common.md",
+      "source": "ai-context/apexlang/templates/template-components/avatar/avatar._common.md"
+    },
+    {
+      "path": "templates/template-components/avatar/avatar._index.md",
+      "source": "ai-context/apexlang/templates/template-components/avatar/avatar._index.md"
+    },
+    {
+      "path": "templates/template-components/avatar/avatar._template_options.md",
+      "source": "ai-context/apexlang/templates/template-components/avatar/avatar._template_options.md"
+    },
+    {
+      "path": "templates/template-components/avatar/avatar.report-icon.md",
+      "source": "ai-context/apexlang/templates/template-components/avatar/avatar.report-icon.md"
+    },
+    {
+      "path": "templates/template-components/avatar/avatar.report-image-url-column.md",
+      "source": "ai-context/apexlang/templates/template-components/avatar/avatar.report-image-url-column.md"
+    },
+    {
+      "path": "templates/template-components/avatar/avatar.report-initials.md",
+      "source": "ai-context/apexlang/templates/template-components/avatar/avatar.report-initials.md"
+    },
+    {
+      "path": "templates/template-components/badge/README.md",
+      "source": "ai-context/apexlang/templates/template-components/badge/README.md"
+    },
+    {
+      "path": "templates/template-components/badge/badge._common.md",
+      "source": "ai-context/apexlang/templates/template-components/badge/badge._common.md"
+    },
+    {
+      "path": "templates/template-components/badge/badge._index.md",
+      "source": "ai-context/apexlang/templates/template-components/badge/badge._index.md"
+    },
+    {
+      "path": "templates/template-components/badge/badge._template_options.md",
+      "source": "ai-context/apexlang/templates/template-components/badge/badge._template_options.md"
     },
     {
-      "path": "templates/template-components/badge._template_options.md",
-      "source": "ai-context/apexlang/templates/template-components/badge._template_options.md"
+      "path": "templates/template-components/badge/badge.report-link.md",
+      "source": "ai-context/apexlang/templates/template-components/badge/badge.report-link.md"
+    },
+    {
+      "path": "templates/template-components/badge/badge.report-minimal.md",
+      "source": "ai-context/apexlang/templates/template-components/badge/badge.report-minimal.md"
     },
     {
       "path": "templates/template-components/button/README.md",
@@ -3122,8 +3258,32 @@
       "source": "ai-context/apexlang/templates/template-components/button/button.navigation.md"
     },
     {
-      "path": "templates/template-components/comments._template_options.md",
-      "source": "ai-context/apexlang/templates/template-components/comments._template_options.md"
+      "path": "templates/template-components/comments/README.md",
+      "source": "ai-context/apexlang/templates/template-components/comments/README.md"
+    },
+    {
+      "path": "templates/template-components/comments/comments._common.md",
+      "source": "ai-context/apexlang/templates/template-components/comments/comments._common.md"
+    },
+    {
+      "path": "templates/template-components/comments/comments._index.md",
+      "source": "ai-context/apexlang/templates/template-components/comments/comments._index.md"
+    },
+    {
+      "path": "templates/template-components/comments/comments._template_options.md",
+      "source": "ai-context/apexlang/templates/template-components/comments/comments._template_options.md"
+    },
+    {
+      "path": "templates/template-components/comments/comments.apex-task-comments.md",
+      "source": "ai-context/apexlang/templates/template-components/comments/comments.apex-task-comments.md"
+    },
+    {
+      "path": "templates/template-components/comments/comments.partial-column.md",
+      "source": "ai-context/apexlang/templates/template-components/comments/comments.partial-column.md"
+    },
+    {
+      "path": "templates/template-components/comments/comments.permutations.md",
+      "source": "ai-context/apexlang/templates/template-components/comments/comments.permutations.md"
     },
     {
       "path": "templates/template-components/content-row/README.md",
@@ -3186,12 +3346,56 @@
       "source": "ai-context/apexlang/templates/template-components/content-row/manifest.json"
     },
     {
-      "path": "templates/template-components/flexbox-container._template_options.md",
-      "source": "ai-context/apexlang/templates/template-components/flexbox-container._template_options.md"
+      "path": "templates/template-components/flexbox-container/README.md",
+      "source": "ai-context/apexlang/templates/template-components/flexbox-container/README.md"
+    },
+    {
+      "path": "templates/template-components/flexbox-container/flexbox-container._index.md",
+      "source": "ai-context/apexlang/templates/template-components/flexbox-container/flexbox-container._index.md"
+    },
+    {
+      "path": "templates/template-components/flexbox-container/flexbox-container._template_options.md",
+      "source": "ai-context/apexlang/templates/template-components/flexbox-container/flexbox-container._template_options.md"
+    },
+    {
+      "path": "templates/template-components/media-list/README.md",
+      "source": "ai-context/apexlang/templates/template-components/media-list/README.md"
+    },
+    {
+      "path": "templates/template-components/media-list/media-list._common.md",
+      "source": "ai-context/apexlang/templates/template-components/media-list/media-list._common.md"
+    },
+    {
+      "path": "templates/template-components/media-list/media-list._index.md",
+      "source": "ai-context/apexlang/templates/template-components/media-list/media-list._index.md"
+    },
+    {
+      "path": "templates/template-components/media-list/media-list._template_options.md",
+      "source": "ai-context/apexlang/templates/template-components/media-list/media-list._template_options.md"
+    },
+    {
+      "path": "templates/template-components/media-list/media-list.partial.md",
+      "source": "ai-context/apexlang/templates/template-components/media-list/media-list.partial.md"
+    },
+    {
+      "path": "templates/template-components/media-list/media-list.report-avatar-badge.md",
+      "source": "ai-context/apexlang/templates/template-components/media-list/media-list.report-avatar-badge.md"
+    },
+    {
+      "path": "templates/template-components/media-list/media-list.report-base.md",
+      "source": "ai-context/apexlang/templates/template-components/media-list/media-list.report-base.md"
     },
     {
-      "path": "templates/template-components/media-list._template_options.md",
-      "source": "ai-context/apexlang/templates/template-components/media-list._template_options.md"
+      "path": "templates/template-components/media-list/media-list.report-grouped.md",
+      "source": "ai-context/apexlang/templates/template-components/media-list/media-list.report-grouped.md"
+    },
+    {
+      "path": "templates/template-components/media-list/media-list.report-layouts.md",
+      "source": "ai-context/apexlang/templates/template-components/media-list/media-list.report-layouts.md"
+    },
+    {
+      "path": "templates/template-components/media-list/media-list.report-link.md",
+      "source": "ai-context/apexlang/templates/template-components/media-list/media-list.report-link.md"
     },
     {
       "path": "templates/template-components/metric-card/README.md",
@@ -3209,6 +3413,30 @@
       "path": "templates/template-components/metric-card/metric-card._template_options.md",
       "source": "ai-context/apexlang/templates/template-components/metric-card/metric-card._template_options.md"
     },
+    {
+      "path": "templates/template-components/metric-card/metric-card.partial-minimal.md",
+      "source": "ai-context/apexlang/templates/template-components/metric-card/metric-card.partial-minimal.md"
+    },
+    {
+      "path": "templates/template-components/metric-card/metric-card.permutations.md",
+      "source": "ai-context/apexlang/templates/template-components/metric-card/metric-card.permutations.md"
+    },
+    {
+      "path": "templates/template-components/metric-card/metric-card.report-avatar-badge.md",
+      "source": "ai-context/apexlang/templates/template-components/metric-card/metric-card.report-avatar-badge.md"
+    },
+    {
+      "path": "templates/template-components/metric-card/metric-card.report-grouping-selection.md",
+      "source": "ai-context/apexlang/templates/template-components/metric-card/metric-card.report-grouping-selection.md"
+    },
+    {
+      "path": "templates/template-components/metric-card/metric-card.report-link.md",
+      "source": "ai-context/apexlang/templates/template-components/metric-card/metric-card.report-link.md"
+    },
+    {
+      "path": "templates/template-components/metric-card/metric-card.report-minimal.md",
+      "source": "ai-context/apexlang/templates/template-components/metric-card/metric-card.report-minimal.md"
+    },
     {
       "path": "templates/template-components/template-component-profiles.json",
       "source": "ai-context/apexlang/templates/template-components/template-component-profiles.json"
@@ -3218,8 +3446,28 @@
       "source": "ai-context/apexlang/templates/template-components/template-components.registry.json"
     },
     {
-      "path": "templates/template-components/timeline._template_options.md",
-      "source": "ai-context/apexlang/templates/template-components/timeline._template_options.md"
+      "path": "templates/template-components/timeline/README.md",
+      "source": "ai-context/apexlang/templates/template-components/timeline/README.md"
+    },
+    {
+      "path": "templates/template-components/timeline/timeline._common.md",
+      "source": "ai-context/apexlang/templates/template-components/timeline/timeline._common.md"
+    },
+    {
+      "path": "templates/template-components/timeline/timeline._index.md",
+      "source": "ai-context/apexlang/templates/template-components/timeline/timeline._index.md"
+    },
+    {
+      "path": "templates/template-components/timeline/timeline._template_options.md",
+      "source": "ai-context/apexlang/templates/template-components/timeline/timeline._template_options.md"
+    },
+    {
+      "path": "templates/template-components/timeline/timeline.permutations.md",
+      "source": "ai-context/apexlang/templates/template-components/timeline/timeline.permutations.md"
+    },
+    {
+      "path": "templates/template-components/timeline/timeline.report-sample-data.md",
+      "source": "ai-context/apexlang/templates/template-components/timeline/timeline.report-sample-data.md"
     },
     {
       "path": "templates/template-family-registry.json",
@@ -3249,6 +3497,10 @@
       "path": "tools/compiler-truth-audit.mjs",
       "source": null
     },
+    {
+      "path": "tools/query-valid-props-context.mjs",
+      "source": null
+    },
     {
       "path": "tools/query-valid-props-normalize.mjs",
       "source": null
@@ -3257,6 +3509,10 @@
       "path": "tools/query-valid-props-runtime.mjs",
       "source": null
     },
+    {
+      "path": "tools/query-valid-props-semantics.mjs",
+      "source": null
+    },
     {
       "path": "tools/query-valid-props-template-components.mjs",
       "source": null

package/skills/apexlang/references/domains/README.md

@@ -92,7 +92,7 @@ Canonical packaged entrypoint for APEXlang domain guidance.
 
 ### Agent Flow
 - Invoke `references/ops/sqlcl-agents/00-connection-gate.md` if server-side validation or invokeApi conversions require DB context.
-- Coordinate the internal generate -> review -> fix loop via Apex Developer master agents.
+- Coordinate the internal generate -> review -> fix loop via APEX Developer master agents.
 - For import-ready runs, execute `references/ops/runtime-gates/02-direct-sqlcl-validate-gate.md` before completion.
 
 ### Outputs

package/skills/apexlang/references/domains/page-components/buttons.md

@@ -1,6 +1,6 @@
 ---
 name: buttons
-description: Configure Oracle APEX buttons, confirmation dialogs, and apply/remove actions using canonical templates and guardrails. Use when Codex must add, update, or remove buttons within Apex Developer flows.
+description: Configure Oracle APEX buttons, confirmation dialogs, and apply/remove actions using canonical templates and guardrails. Use when Codex must add, update, or remove buttons within APEX Developer flows.
 ---
 
 # Reference Package — Buttons & Actions
@@ -64,4 +64,4 @@ description: Configure Oracle APEX buttons, confirmation dialogs, and apply/remo
 - `references/domains/page-components/buttons/registry.md`
 - Reusable prompts: `assets/domains/page-components/buttons/button-actions.md`
 
-Use this package whenever button configuration or batch actions are required in Apex Developer flows.
+Use this package whenever button configuration or batch actions are required in APEX Developer flows.

package/skills/apexlang/references/domains/page-components/page-items.md

@@ -1,6 +1,6 @@
 ---
 name: page-items
-description: Configure Oracle APEX page items the Items skill. Use when Codex must add or adjust page items under Apex Developer guardrails.
+description: Configure Oracle APEX page items the Items skill. Use when Codex must add or adjust page items under APEX Developer guardrails.
 ---
 
 # Reference Package — Page Items & LOVs
@@ -51,7 +51,7 @@ description: Configure Oracle APEX page items the Items skill. Use when Codex mu
 
 ## Agent Flow
 - Invoke `references/ops/sqlcl-agents/00-connection-gate.md` when DB validation is needed.
-- Use the internal generate -> review -> fix loop via Apex Developer agents, referencing business-logic prompts when computations/validations are involved.
+- Use the internal generate -> review -> fix loop via APEX Developer agents, referencing business-logic prompts when computations/validations are involved.
 - For import-ready runs, execute `references/ops/runtime-gates/02-direct-sqlcl-validate-gate.md`.
 - After runtime gate pass, import via `references/ops/runtime-gates/01-direct-sqlcl-import.md` proceeds automatically.
 
@@ -65,4 +65,4 @@ description: Configure Oracle APEX page items the Items skill. Use when Codex mu
 - `references/domains/page-components/page-items/registry.md` (keyword → template mapping)
 - `references/domains/README.md` for validations/computations/dynamic actions
 
-Use this package for any page item, LOV, validation, or computation tasks within Apex Developer.
+Use this package for any page item, LOV, validation, or computation tasks within APEX Developer.

package/skills/apexlang/references/domains/page-components/regions/region-display-selector/workflow-region-display-selector.md

@@ -0,0 +1,69 @@
+# Workflow: Region Display Selector
+
+## Purpose
+
+Generate one native Region Display Selector (RDS) that deterministically controls an explicit set of sibling page regions without introducing a data source.
+
+## Required Inputs
+
+- Page target.
+- At least two controlled region identifiers.
+- Mode: `viewSingleRegion` or `scrollWindow`.
+- Whether controlled-region icons are displayed.
+- For `viewSingleRegion`, whether Show All is included.
+- Persistence: `byUser`, `bySession`, or `false`.
+- Optional application-scoped `includeSlider` only when explicitly requested.
+
+## Compiler Evidence
+
+- APEX 26.1 native metadata identifies the plugin as `NATIVE_DISPLAY_SELECTOR`.
+- `rds_mode` accepts `STANDARD` (View Single Region) and `JUMP` (Scroll Window).
+- `include_show_all` is available only for `STANDARD`.
+- `display_region_icons` is Yes/No.
+- `remember_selection` accepts `USER`, `SESSION`, and `NO`.
+- The upstream catalog also defines application-scoped `include_slider` with default `true`. In this repository it is emitted, when explicitly requested, through `componentSetting NATIVE_DISPLAY_SELECTOR` and `settings.attributes.includeSlider`; it is not a controller setting.
+- APEXlang generation uses the normalized values in the required-input list. Run target-build `apex validate` because static compiler-property metadata does not expose the native plugin's custom setting inventory.
+- Apply the shared RDS identifier contract in `region-display-selector._common.md`; direct target-build validation is authoritative for region identifiers.
+
+## Generation Contract
+
+1. Create exactly one page-level region with `type: regionDisplaySelector`.
+2. Do not emit a `source` block on the controller.
+3. Emit `settings.mode`, `settings.displayRegionIcons`, and `settings.rememberSelection` explicitly.
+4. Emit `settings.includeShowAll` only when mode is `viewSingleRegion`; omit it for `scrollWindow`.
+5. Resolve the exact controlled-region list before generation. Do not infer every body region as a target.
+6. On each selected region, emit `advanced.regionDisplaySelector: true` and a stable `advanced.htmlDomId`.
+7. Leave the flag omitted or false on every unselected region.
+8. Preserve controlled-region `layout.sequence`; it defines selector order.
+9. Never select the controller, breadcrumb regions, nested regions, or regions placed in header/breadcrumb slots.
+10. When `displayRegionIcons: true`, every selected region must emit one catalogue-valid `appearance.icon` under `FA_ICON_REQUIRED_001`.
+11. Mixed target families are supported when each target is a page-level region whose compiler contract accepts `advanced.regionDisplaySelector`. Preserve each template component's own source, settings, nested-component, and column rules.
+12. Keep application-scoped `includeSlider` out of the controller's four instance-level settings; emit its `componentSetting` only when the application requirement explicitly requests it.
+
+## Interaction Semantics
+
+- `viewSingleRegion`: selecting an entry displays that region and hides the other selected regions. Show All may expose all selected regions.
+- `scrollWindow`: all selected regions remain visible; selecting an entry scrolls to that region. `includeShowAll` is inapplicable and must be omitted.
+- `byUser`: persists selection across sessions for the user and therefore requires stable selected-region DOM IDs.
+- `bySession`: persists selection only for the current session.
+- `false`: does not remember selection.
+
+## Safety Boundary
+
+RDS is presentation behavior, not access control. Preserve authorization schemes, server-side conditions, and data protections on every selected region. Do not use an RDS-hidden region as a security boundary.
+
+## Validation
+
+- Reject zero or one selected region.
+- Reject more than one RDS controller on a page.
+- Reject a controller that opts itself into RDS.
+- Reject selected breadcrumb/header regions.
+- Reject `includeShowAll` in `scrollWindow` mode.
+- Reject a missing controlled-region icon when `displayRegionIcons: true`.
+- Run strict structure formatting, local APEXlang validation, compiler-truth audit, and target-build `apex validate`.
+
+## Templates
+
+- `templates/region-components/region-display-selector/region-display-selector._common.md`
+- `templates/region-components/region-display-selector/region-display-selector.standard.md`
+- `templates/region-components/region-display-selector/region-display-selector.permutations.md`

package/skills/apexlang/references/domains/page-components/regions.md

@@ -20,6 +20,7 @@ This skill orchestrates the Tier 1 region workflows under `skills/` (interactive
 - `references/domains/page-components/regions/interactive-report/workflow-interactive-report.md`
 - `references/domains/page-components/regions/dashboard/workflow-dashboard.md`
 - `references/domains/page-components/regions/chart/workflow-charts.md`
+- `references/domains/page-components/regions/region-display-selector/workflow-region-display-selector.md`
 - `references/domains/business-logic/dynamic-actions/workflow-dynamic-actions.md`
 - `references/domains/business-logic/dynamic-actions/workflow-dynamic-actions-batch.md`
 - `references/domains/page-components/buttons/workflow-button-batch.md`

package/skills/apexlang/references/domains/template-components/comments.md

@@ -0,0 +1,61 @@
+# Workflow: Comments Template Component
+
+## Purpose
+
+Generate a Universal Theme Comments template component only when the request explicitly selects Comments. The component is available as `partial` or `report`; it is not a static-content region and must not be treated as developer documentation comments.
+
+## Required Evidence
+
+1. Inspect the bundled Universal Theme Comments inventory when attribute context is needed:
+
+   ```bash
+   node tools/query-valid-props.mjs --template-component comments --json
+   ```
+
+   This result is theme-export metadata only and is not compiler-backed. It may contain attributes that the APEXlang compiler rejects; never use it as legality evidence.
+2. Prove emitted structure with the curated Comments contract and direct compiler validation against the target APEX build. If a requested shape is outside the exact supported fixtures and cannot be validated directly, stop with `Missing Inputs`.
+3. For a database-backed source, confirm every referenced table/view and mapped column from offline schema metadata, live DB metadata, or an explicit user assertion. The bundled examples use only the user-confirmed `APEX_TASK_COMMENTS(CREATED_BY, TEXT, CREATED_ON)` source.
+4. Require direct declared child-column mappings for Comments' required `userName` and `commentText` values and optional `date`; require an accepted `style` enum in report mode and omit `style` in partial mode.
+5. Stop with `Missing Inputs` if the parent shape, source mode, or required mappings are not proven.
+
+## Supported Configuration
+
+- The authoritative Comments inventory is `templates/template-components/comments/comments._template_options.md`.
+- The shared family contract is `templates/template-components/comments/comments._common.md`; load it through `comments._index.md` before selecting an example.
+- `templates/template-components/comments/comments.apex-task-comments.md` is the canonical report-mode SQL example. Reuse its enclosing shape only when the requested mode, parent context, and source mappings match.
+- The root Comments values exposed by APEXlang belong in `settings`: `userName` and `commentText` are always required; `style` is required only for report display and rejected for partial display; `date`, `attributes`, `commentClass`, `displayAvatar`, `alignment`, and `applyThemeColors` are optional.
+- Every Comments region must emit `source`, `componentAppearance`, and `settings`; omission of any one is a local validation failure.
+- When `settings.displayAvatar: true`, emit `plugin-avatar.type` and `plugin-avatar.shape`, then exactly one matching payload: `icon` for `type: icon`, `image` for `type: image`, or `initials` for `type: initials`. For initials, require a dedicated projected varchar2 column containing only the first-name and last-name initials; do not pass the full `settings.userName` column.
+- Do not map `plugin-avatar.initials` to `INITIALS` when the Comments source is `sampleData: tasks`. Live APEX 26.1 runtime evidence reports `ORA-00904: "D"."INITIALS": invalid identifier`; use a verified SQL-projected initials column such as `AVATAR_INITIALS`, or omit the initials permutation when no such projection is available.
+- A nested `plugin-avatar.image` must use `type: urlColumn`, reference a declared varchar2 Comments child column, and satisfy `AVATAR_IMAGE_URL_SAFETY_REQUIRED_001`: project only `:APP_FILES` or `:APEX_FILES` plus one static relative path. Reject raw, external, protocol-relative, `javascript:`, `data:`, traversal, substitution, and BLOB-endpoint URL sources.
+- Treat `avatar/avatar._template_options.md` as the canonical shared Avatar inventory for nested visual values. The standalone `themeTemplateComponent/avatar` workflow owns a separate report region, source, ordering, security, accessibility, and CSS contract; do not copy those standalone rules into Comments' nested `plugin-avatar` block.
+- Treat `plugin-avatar.icon` as icon-bearing. When a Comments request explicitly asks for an Avatar icon, resolve the `icons` profile and apply `FA_ICON_REQUIRED_001`: select exactly one static icon from the pinned Font APEX index, with only index-listed modifiers. Do not invent `fa-*` tokens or load the index for a request that does not require an icon.
+- Treat author initials, user initials, profile-image, profile-picture, and author/user-icon wording as nested Avatar intent and load the shared Avatar inventory without selecting the standalone Avatar component.
+- A Comments `partial` component renders one entity. Require a source proven to return no more than one row; for SQL, use an explicit `fetch first 1 row only` or an equivalent `rownum` bound. Omit `settings.style` and do not emit the report-only `rowSelection`, `performance`, `pagination`, `entityTitle`, `messages`, or `advanced` blocks in partial mode.
+- Report-mode Comments may use compiler-confirmed `rowSelection`, `performance`, `pagination`, `entityTitle`, `messages`, and `advanced` blocks. Omit `rowSelection` for no selection; when selection is requested, use `focusOnly`, `singleSelection`, or `multipleSelection`. Use `pagination.type: page`, keep `pagination.entitiesPerPage` positive, and keep report source projections synchronized with named child columns.
+- Compiler-backed APEXlang legality is authoritative. Universal Theme `REPORT` and `REPORT_GROUP` metadata does not establish an APEXlang emission shape.
+- Do not emit nested `plugin-badge` or `plugin-grouping` blocks. A request for a badge on each comment is an unsupported nested combination and must not load or apply the standalone Badge region contract. A direct APEX 26.1 probe rejects `plugin-grouping.groupTitle` and `plugin-grouping.groupIcon` as invalid application-source properties; grouping is unsupported for generated APEXlang. Comments actions are supported only at `actions`, `avatarLink`, and `userNameLink`: use root `position`, `label` only for `actions`, numeric `layout.sequence`, and structured `behavior.target`; omit `template` and `behavior.type`.
+- The supported-configuration fixture is `templates/template-components/comments/comments.permutations.md`. Use one valid branch per generated region rather than combining mutually exclusive Avatar payloads.
+
+## Security and Rendering
+
+- Preserve default escaping and use the selected application's proven authorization model. Do not invent an authorization scheme or attachment point.
+- Keep `attributes` free of scriptable markup, URLs, and event handlers. Keep `commentClass` to static CSS tokens or a declared varchar2 source-column mapping; do not use substitutions or arbitrary dynamic CSS classes.
+- Do not substitute a static HTML region, a Timeline component, or a report with hand-written comment markup.
+- Treat the template option inventory as accepted attribute evidence only; use compiler truth for the enclosing APEXlang region shape and any non-exact configuration.
+
+## Validation
+
+1. Run strict formatter and local APEXlang validation.
+2. Run compiler-truth audit with component attributes enabled. Treat it as a local regression gate, not as proof for opaque nested template-component attributes.
+3. Run target-build `apex validate` through the runtime roundtrip before declaring the emitted Comments component compiler-valid.
+4. Route reported findings through `context repair`; revise only the reported shape or mapping.
+
+Record the target build, application path, `live_check_status`, and validation artifact paths with the review evidence. Local lint and unit tests alone are not compiler acceptance evidence.
+
+## AUX-2687 target-build evidence
+
+- Target compiler/runtime: APEX `26.1.0+3102`, build-root `apex sql`, saved connection `apex_26.1.0-3102`.
+- Positive QA coverage: report Comments, partial Comments, partial Interactive Report Comments column, icon/image/initials Avatar variants, and `actions`/`avatarLink`/`userNameLink` actions all passed target validation with `live_check_status: pass` and zero unresolved problems.
+- Validate-only roundtrip: local, live, and final checks all passed; import was skipped by explicit `validate-only` intent.
+- Expected unsupported probes: `plugin-grouping` failed target validation on `groupTitle` and `groupIcon`; nested `plugin-badge` failed target validation on `display`. These cases remain rejected with deterministic guidance and are not emitted.

package/skills/apexlang/references/domains/template-components/registry.md

@@ -6,6 +6,8 @@
 | `button template` | `template-button` | Maps to `40-components/apex.templates.md` |
 | `content row` | `region-template-content-row` | Layout slot adjustments |
 | `metric card` | `region-template-metric-card` | KPI / summary card layouts via `themeTemplateComponent/metricCard` |
+| `timeline template component`, `timeline region`, `activity timeline` | `timeline` | Route to the Timeline workflow; do not treat this as a Gantt/timeline chart. |
+| `comments template component`, `comments region`, `comment feed` | `comments` | Route to the Comments workflow; do not treat this as region documentation comments. |
 | `cards` | `cards` | Use for UT card templates |
 | `alerts` | `alerts` | Alert template options |
 | `help-text-batch` | `references/domains/universal-attr-config/workflow-help-text-batch.md` | Inline help for template-driven items |