pi-apexlang 0.1.0

package/skills/apexlang/templates/template-components/content-row/content-row.report-grouping-selection.md

@@ -0,0 +1,306 @@
+---
+templateId: content-row.report-grouping-selection
+componentType: templateComponent
+imports:
+  - content-row.common
+version: 1.0
+description: Report-mode grouping, native focus/single/multiple row selection, pagination, and entity titles.
+---
+
+# Purpose
+Provide the canonical report-mode pattern for native focus-only, single-row, and multiple-row selection, including page-item-backed selection state when persistence is required.
+
+# Output Template
+```apx
+region {{regionStaticId}} (
+    name: {{name}}
+    type: themeTemplateComponent/contentRow
+    source {
+        location: {{source.location}}
+        sampleData: {{source.sampleData}}
+    }
+    componentAppearance {
+        display: report
+    }
+    settings {
+        overline: {{settings.overlineLiteral}}
+        title: &{{settings.titleColumn}}.
+        description: &{{settings.descriptionColumn}}.
+        miscellaneous: &{{settings.miscellaneousColumn}}.
+        displayAvatar: {{settings.displayAvatar}}
+        displayBadge: {{settings.displayBadge}}
+    }
+    plugin-avatar {
+        type: {{pluginAvatar.type}}
+        initials: {{pluginAvatar.initialsColumn}}
+    }
+    plugin-badge {
+        label: {{pluginBadge.label}}
+        value: {{pluginBadge.valueColumn}}
+    }
+    plugin-appearance {
+        stackOnMobile: {{pluginAppearance.stackOnMobile}}
+    }
+    rowSelection {
+        type: singleSelection
+        currentSelectionPageItem: {{rowSelection.currentSelectionPageItem}}
+        selectAllPageItem: {{rowSelection.selectAllPageItem}}
+    }
+    pagination {
+        type: page
+        entitiesPerPage: {{pagination.entitiesPerPage}}
+    }
+    column {{pkColumnStaticId}} (
+        source {
+            databaseColumn: {{pkColumnName}}
+            dataType: {{pkColumnDataType}}
+            primaryKey: true
+        }
+    )
+)
+
+pageItem {{rowSelection.currentSelectionPageItem}} (
+    type: hidden
+    layout {
+        sequence: {{selectionItem.layout.sequence}}
+        slot: regionBody
+    }
+)
+
+pageItem {{rowSelection.selectAllPageItem}} (
+    type: checkbox
+    label {
+        label: Select All
+        alignment: left
+    }
+    layout {
+        sequence: {{selectAllItem.layout.sequence}}
+        region: @{{toolbarRegionStaticId}}
+        slot: regionBody
+        alignment: left
+    }
+)
+```
+
+# Conditional Rendering Rules
+- Keep grouping, native row selection, and pagination in report mode only.
+- When any child column uses grouping, emit top-level `orderBy` and sort by every grouped column first, in grouping order, before any remaining tie-breakers.
+- When `pagination {}` is emitted, use `type: page` or `type: scroll`; page-size examples in this file use `type: page`.
+- Use `rowSelection.type: focusOnly` when the user needs row focus behavior without storing selected-row state.
+- Use `rowSelection.type: singleSelection` with `currentSelectionPageItem` when the user needs Content Row single-row selection.
+- Use `rowSelection.type: multipleSelection` with both `currentSelectionPageItem` and `selectAllPageItem` when the user needs Content Row multi-row selection.
+- Create the referenced same-page hidden item by default; it stores the selected row value(s) for refreshes, conditions, dynamic actions, or child regions.
+- For `multipleSelection`, create the referenced select-all page item as a checkbox, typically in a toolbar/static-content container above the Content Row region.
+- The Content Row must include a primary-key column so native selection has stable selected value(s).
+- Literal display settings such as `overline: Employee` are allowed; query-column-backed display settings must use `&COLUMN_NAME.` syntax.
+- Use `fullRowLink` actions only for navigation or explicit action-driven behavior. Native `rowSelection.currentSelectionPageItem` is not a substitute for master-detail `behavior.target.items`; when the parent row filters child regions, use `content-row.report-master-detail-full-row-link.md`.
+
+# Focus-Only Example
+```apx
+region employees-focus-only (
+    name: Employees (Focus Only)
+    type: themeTemplateComponent/contentRow
+    source {
+        location: sampleData
+        sampleData: employees
+    }
+    componentAppearance { display: report }
+    settings {
+        overline: Employee
+        title: &NAME.
+        description: &JOB.
+        miscellaneous: &SALARY.
+    }
+    rowSelection {
+        type: focusOnly
+    }
+    column ID (
+        source {
+            databaseColumn: ID
+            dataType: number
+            primaryKey: true
+        }
+    )
+)
+```
+
+# Single-Selection Example
+```apx
+region employees-single-select (
+    name: Employees (Single Select)
+    type: themeTemplateComponent/contentRow
+    source {
+        location: sampleData
+        sampleData: employees
+    }
+    componentAppearance { display: report }
+    settings {
+        overline: Employee
+        title: &NAME.
+        description: &JOB.
+        miscellaneous: &SALARY.
+        displayAvatar: true
+        displayBadge: true
+    }
+    plugin-avatar {
+        type: initials
+        initials: INITIALS
+    }
+    plugin-badge {
+        label: ID
+        value: ID
+    }
+    plugin-appearance {
+        stackOnMobile: true
+    }
+    rowSelection {
+        type: singleSelection
+        currentSelectionPageItem: P2_SELECTED_EMPLOYEE
+    }
+    pagination {
+        type: page
+        entitiesPerPage: 50
+    }
+    column ID (
+        source {
+            databaseColumn: ID
+            dataType: number
+            primaryKey: true
+        }
+    )
+    column NAME (
+        source { databaseColumn: NAME dataType: varchar2 }
+    )
+    column JOB (
+        source { databaseColumn: JOB dataType: varchar2 }
+    )
+    column SALARY (
+        source { databaseColumn: SALARY dataType: number }
+    )
+    column INITIALS (
+        source { databaseColumn: INITIALS dataType: varchar2 }
+    )
+)
+
+pageItem P2_SELECTED_EMPLOYEE (
+    type: hidden
+    layout {
+        sequence: 10
+        slot: regionBody
+    }
+)
+```
+
+
+# Multiple-Selection Example
+```apx
+region toolbar-container (
+    name: Toolbar Container
+    type: staticContent
+    layout {
+        sequence: 10
+        slot: regionBody
+    }
+    appearance {
+        template: @/blank-with-attributes
+        templateOptions: #DEFAULT#
+    }
+)
+
+region employees-multiple-select (
+    name: Employees (Multiple Select)
+    type: themeTemplateComponent/contentRow
+    source {
+        location: sampleData
+        sampleData: employees
+    }
+    layout {
+        sequence: 30
+        slot: regionBody
+    }
+    componentAppearance { display: report }
+    settings {
+        overline: Employee
+        title: &NAME.
+        description: &JOB.
+        miscellaneous: &SALARY.
+        displayAvatar: true
+        displayBadge: true
+    }
+    plugin-avatar {
+        type: initials
+        initials: INITIALS
+    }
+    plugin-badge {
+        label: ID
+        value: ID
+    }
+    plugin-appearance {
+        stackOnMobile: true
+    }
+    rowSelection {
+        type: multipleSelection
+        currentSelectionPageItem: P2_SELECTED_EMPLOYEE
+        selectAllPageItem: P2_SELECT_ALL
+    }
+    pagination {
+        type: page
+        entitiesPerPage: 50
+    }
+    column ID (
+        source {
+            databaseColumn: ID
+            dataType: number
+            primaryKey: true
+        }
+    )
+    column NAME (
+        source { databaseColumn: NAME dataType: varchar2 }
+    )
+    column JOB (
+        source { databaseColumn: JOB dataType: varchar2 }
+    )
+    column SALARY (
+        source { databaseColumn: SALARY dataType: number }
+    )
+    column INITIALS (
+        source { databaseColumn: INITIALS dataType: varchar2 }
+    )
+)
+
+pageItem P2_SELECTED_EMPLOYEE (
+    type: hidden
+    layout {
+        sequence: 20
+        slot: regionBody
+    }
+)
+
+pageItem P2_SELECT_ALL (
+    type: checkbox
+    label {
+        label: Select All
+        alignment: left
+    }
+    layout {
+        sequence: 10
+        region: @toolbar-container
+        slot: regionBody
+        alignment: left
+    }
+    appearance {
+        template: @/optional-floating
+        templateOptions: #DEFAULT#
+    }
+)
+```
+
+# Validation Checklist
+- `rowSelection.type` is `focusOnly`, `singleSelection`, or `multipleSelection`.
+- `focusOnly` does not include `currentSelectionPageItem` or `selectAllPageItem`.
+- `singleSelection` and `multipleSelection` include `rowSelection.currentSelectionPageItem`, and that item references an existing same-page hidden item.
+- The hidden item stores native selected row value(s) for dependent refreshes, conditions, or dynamic actions; it does not replace the `fullRowLink` action required for master-detail child filtering.
+- `multipleSelection` includes `rowSelection.selectAllPageItem`, and that page item exists as a same-page checkbox.
+- A PK-backed Content Row column is present.
+- When grouping is used, top-level `orderBy` sorts by the grouped column set first.
+- Literal and column-backed settings use the correct syntax.

package/skills/apexlang/templates/template-components/content-row/content-row.report-link-positions.md

@@ -0,0 +1,31 @@
+---
+templateId: content-row.report-link-positions
+componentType: templateComponent
+imports:
+  - content-row.common
+version: 1.0
+description: Report-mode Content Row link-position coverage.
+---
+
+# Purpose
+Cover all link positions in report mode: `avatarLink`, `titleLink`, `badgeLink`, `fullRowLink`.
+
+# Output Template
+```apx
+region {{regionStaticId}} (
+    type: themeTemplateComponent/contentRow
+    componentAppearance { display: report }
+    action {{avatarActionId}} ( position: avatarLink )
+    action {{titleActionId}} ( position: titleLink )
+    action {{badgeActionId}} ( position: badgeLink )
+    action {{rowActionId}} ( position: fullRowLink )
+)
+```
+
+# Conditional Rendering Rules
+- Each link action uses exactly one supported link position.
+- Avoid redundant navigation affordances unless requested.
+
+# Validation Checklist
+- Behavior blocks use explicit redirect type and `targetUrl`.
+- Link actions are sequenced deterministically.

package/skills/apexlang/templates/template-components/content-row/content-row.report-master-detail-full-row-link.md

@@ -0,0 +1,70 @@
+---
+templateId: content-row.report-master-detail-full-row-link
+componentType: templateComponent
+imports:
+  - content-row.common
+version: 1.0
+description: Report-mode Content Row master-detail selector with a same-page full-row action.
+---
+
+# Purpose
+
+Render a parent Content Row list that drives child regions by updating a same-page hidden context item from the selected row primary key and refreshing dependent child regions without reloading the page.
+
+# Output Template
+```apx
+region {{regionStaticId}} (
+    name: {{name}}
+    type: themeTemplateComponent/contentRow
+    appearance {
+        template: @/standard
+        templateOptions: #DEFAULT#
+    }
+    componentAppearance { display: report }
+    settings {
+        overline: &{{settings.overlineColumn}}.
+        title: &{{settings.titleColumn}}.
+        description: &{{settings.descriptionColumn}}.
+        miscellaneous: &{{settings.miscellaneousColumn}}.
+    }
+
+    column {{pkColumnStaticId}} (
+        source {
+            databaseColumn: {{pkColumnName}}
+            primaryKey: true
+        }
+    )
+
+    action select-row (
+        position: fullRowLink
+        layout {
+            sequence: 10
+        }
+        behavior {
+            target: {
+                page: {{currentPageId}}
+                items: {
+                    {{contextItemName}}: &{{pkColumnName}}.
+                }
+            }
+        }
+    )
+)
+```
+
+# Conditional Rendering Rules
+- Use this scenario when a parent row selects context for one or more child regions on the same page.
+- Use `appearance.template: @/standard` for the visible master/list region. Do not use `@/blank-with-attributes`; reserve blank shells for structural containers and dashboard KPI strips.
+- The target item must be a hidden same-page item such as `P3_ORDER_ID`.
+- Do not implement the primary row selection with `redirectUrl`, `targetUrl`, or `f?p=` same-page reloads.
+- Add dynamic-action/declarative refresh behavior so each child region depending on the context item refreshes after the parent row selection changes the item.
+- Content Row settings backed by query columns must use `&COLUMN_NAME.` substitution syntax.
+- Do not render a visible select list for the same parent context unless the prompt explicitly requests manual selection.
+- Do not add `template` to a `fullRowLink` action; reserve `template: button|menu` for `primaryActions`.
+
+# Validation Checklist
+- Parent row PK column is present and marked as primary key.
+- Settings values such as overline/title/description/miscellaneous reference projected columns with `&COLUMN_NAME.` syntax.
+- `fullRowLink` action sets the hidden parent context item with `&COLUMN.` substitution.
+- Child reports that reference the hidden context item list it in `source.pageItemsToSubmit`.
+- Child reports are refreshed by parent-selection dynamic-action/declarative behavior.

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

@@ -0,0 +1,31 @@
+---
+templateId: content-row.report-minimal
+componentType: templateComponent
+imports:
+  - content-row.common
+version: 1.0
+description: Minimal report-mode Content Row example with explicit columns.
+---
+
+# Purpose
+Render a report-style Content Row list with minimal settings and PK-backed explicit columns.
+
+# Output Template
+```apx
+region {{regionStaticId}} (
+    type: themeTemplateComponent/contentRow
+    componentAppearance { display: report }
+    settings { title: &{{settings.titleColumn}}. }
+    column {{pkColumnStaticId}} (
+        source { databaseColumn: {{pkColumnName}} primaryKey: true }
+    )
+)
+```
+
+# Conditional Rendering Rules
+- Keep `display: report`.
+- Include explicit columns with `databaseColumn` mappings.
+
+# Validation Checklist
+- At least one PK-backed column is present.
+- `settings.title` uses `&COLUMN_NAME.` syntax and maps to a projected query/column alias.

package/skills/apexlang/templates/template-components/content-row/content-row.report-primary-actions-menu.md

@@ -0,0 +1,67 @@
+---
+templateId: content-row.report-primary-actions-menu
+componentType: templateComponent
+imports:
+  - content-row.common
+version: 1.0
+description: Report-mode primary actions with button and menu templates.
+---
+
+# Purpose
+Document Content Row primary actions using supported templates: `button` and `menu`.
+
+# Output Template
+```apx
+region {{regionStaticId}} (
+    type: themeTemplateComponent/contentRow
+    componentAppearance { display: report }
+    action {{buttonActionId}} (
+        position: primaryActions
+        template: button
+        label: {{buttonLabel}}
+        layout {
+            sequence: 10
+        }
+        behavior {
+            type: redirectUrl
+            targetUrl: {{buttonTargetUrl}}
+        }
+        appearance {
+            displayType: icon
+            icon: {{buttonIcon}}
+        }
+    )
+    action {{menuActionId}} (
+        position: primaryActions
+        template: menu
+        label: {{menuLabel}}
+        layout {
+            sequence: 20
+        }
+        appearance {
+            displayType: icon
+            icon: {{menuIcon}}
+        }
+
+        menu {{menuEntryId}} (
+            label: {{menuEntryLabel}}
+            layout {
+                sequence: 10
+            }
+            behavior {
+                type: redirectUrl
+                targetUrl: {{menuEntryTargetUrl}}
+            }
+        )
+    )
+)
+```
+
+# Conditional Rendering Rules
+- For `position: primaryActions`, allow only `template: button` or `template: menu`.
+- Render nested `menu` entries only for `template: menu`.
+- Close each `action ... (` component with `)` after all nested blocks.
+
+# Validation Checklist
+- No unsupported `primaryActions` template is used.
+- Menu entries include deterministic sequence and behavior.

package/skills/apexlang/templates/template-components/content-row/manifest.json

@@ -0,0 +1,165 @@
+[
+  {
+    "file": "content-row._common.md",
+    "title": "Content Row Common Contract",
+    "features": [
+      "shared-contract",
+      "variable-contract",
+      "validation-checklist"
+    ]
+  },
+  {
+    "file": "content-row._index.md",
+    "title": "Content Row Scenario Index",
+    "features": [
+      "routing",
+      "scenario-catalog"
+    ]
+  },
+  {
+    "file": "content-row._common.md",
+    "title": "Content Row Canonical Skeleton",
+    "display_mode": "partial|report",
+    "features": [
+      "canonical-skeleton",
+      "actions-all-positions",
+      "primary-actions-button-menu"
+    ]
+  },
+  {
+    "file": "content-row.partial-minimal.md",
+    "title": "Content Row Partial Minimal",
+    "display_mode": "partial",
+    "features": [
+      "minimal",
+      "single-row",
+      "core-settings"
+    ]
+  },
+  {
+    "file": "content-row.partial-rich-content.md",
+    "title": "Content Row Partial Rich Content",
+    "display_mode": "partial",
+    "features": [
+      "single-row",
+      "avatar",
+      "avatar-type",
+      "avatar-description",
+      "avatar-shape",
+      "avatar-size",
+      "avatar-css-classes",
+      "badge",
+      "badge-icon",
+      "badge-position",
+      "badge-state",
+      "badge-style",
+      "badge-shape",
+      "badge-size",
+      "title-link",
+      "avatar-link",
+      "badge-link"
+    ]
+  },
+  {
+    "file": "content-row.report-minimal.md",
+    "title": "Content Row Report Minimal",
+    "display_mode": "report",
+    "features": [
+      "minimal",
+      "pk-column",
+      "report-display"
+    ]
+  },
+  {
+    "file": "content-row.report-explicit-defaults.md",
+    "title": "Content Row Report Explicit Defaults",
+    "display_mode": "report",
+    "features": [
+      "explicit-defaults",
+      "pagination",
+      "entity-title"
+    ]
+  },
+  {
+    "file": "content-row.report-avatar-badge.md",
+    "title": "Content Row Report Avatar And Badge",
+    "display_mode": "report",
+    "features": [
+      "avatar",
+      "avatar-type",
+      "avatar-description",
+      "avatar-shape",
+      "avatar-size",
+      "avatar-css-classes",
+      "badge",
+      "badge-icon",
+      "badge-position",
+      "grouped-plugin-attributes"
+    ]
+  },
+  {
+    "file": "content-row.report-link-positions.md",
+    "title": "Content Row Report Link Positions",
+    "display_mode": "report",
+    "features": [
+      "title-link",
+      "avatar-link",
+      "badge-link",
+      "full-row-link"
+    ]
+  },
+  {
+    "file": "content-row.report-master-detail-full-row-link.md",
+    "title": "Content Row Report Master Detail Full Row Link",
+    "display_mode": "report",
+    "features": [
+      "master-detail",
+      "parent-child",
+      "full-row-link",
+      "hidden-context-item",
+      "same-page-target"
+    ]
+  },
+  {
+    "file": "content-row.report-primary-actions-menu.md",
+    "title": "Content Row Report Primary Actions Menu",
+    "display_mode": "report",
+    "features": [
+      "primary-actions",
+      "button-template",
+      "menu-template",
+      "menu-entries"
+    ]
+  },
+  {
+    "file": "content-row.report-grouping-selection.md",
+    "title": "Content Row Report Grouping And Selection",
+    "display_mode": "report",
+    "features": [
+      "grouping",
+      "row-selection",
+      "pagination",
+      "entity-title",
+      "native-single-selection",
+      "current-selection-page-item",
+      "hidden-selection-item",
+      "native-multiple-selection",
+      "select-all-page-item",
+      "select-all-checkbox",
+      "native-focus-only-selection",
+      "focus-only"
+    ]
+  },
+  {
+    "file": "content-row.report-appearance-variants.md",
+    "title": "Content Row Report Appearance Variants",
+    "display_mode": "report",
+    "features": [
+      "compact",
+      "hide-borders",
+      "remove-padding",
+      "stack-mobile",
+      "apply-theme-colors"
+    ]
+  }
+]

package/skills/apexlang/templates/template-components/flexbox-container._template_options.md

@@ -0,0 +1,20 @@
+# Flexbox Container Template Options
+
+These entries come from `create_plugin_attribute` and `create_plugin_attr_value`, not from `wwv_flow_template_options`.
+
+Apply these values through the owning component's settings block.
+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.
+
+## Flexbox Container (`flexboxContainer`)
+Supported: `REGION_ONLY`
+
+- `alignContent` | prompt=`Align-Content` | type=`SELECT LIST` | scope=`COMPONENT` | required=`false` | default=`--` | group=`--` | depends=`--` | values=`around=>u-align-content-around, between=>u-align-content-between, center=>u-align-content-center, end=>u-align-content-end, evenly=>u-align-content-evenly, start=>u-align-content-start`
+- `alignItems` | prompt=`Align-Items` | type=`SELECT LIST` | scope=`COMPONENT` | required=`false` | default=`--` | group=`--` | depends=`--` | values=`baseline=>u-align-items-baseline, center=>u-align-items-center, end=>u-align-items-end, start=>u-align-items-start, stretch=>u-align-items-stretch`
+- `direction` | prompt=`Direction` | type=`SELECT LIST` | scope=`COMPONENT` | required=`false` | default=`--` | group=`--` | depends=`--` | values=`column=>u-flex-direction-column, columnReverse=>u-flex-direction-column-reverse, row=>u-flex-direction-row, rowReverse=>u-flex-direction-row-reverse`
+- `flexBehavior` | prompt=`Flex Item Sizing` | type=`SELECT LIST` | scope=`COMPONENT` | required=`false` | default=`--` | group=`--` | depends=`--` | values=`doNotGrow=>a-FlexContainer--noGrow, fillAvailableSpace=>a-FlexContainer--fill, growIfNeeded=>a-FlexContainer--grow`
+- `gap` | prompt=`Gap` | type=`SELECT LIST` | scope=`COMPONENT` | required=`false` | default=`--` | group=`--` | depends=`--` | values=`lg=>u-gap-4, md=>u-gap-2, none=>u-gap-0, sm=>u-gap-1, xl=>u-gap-6, xs=>u-gap-0_5, xxl=>u-gap-8, xxs=>u-gap-px`
+- `justifyContent` | prompt=`Justify-Content` | type=`SELECT LIST` | scope=`COMPONENT` | required=`false` | default=`--` | group=`--` | depends=`--` | values=`around=>u-justify-content-space-around, between=>u-justify-content-space-between, center=>u-justify-content-center, end=>u-justify-content-flex-end, start=>u-justify-content-flex-start, stretch=>u-justify-content-stretch`
+- `overflow` | prompt=`Overflow` | type=`SELECT LIST` | scope=`COMPONENT` | required=`false` | default=`--` | group=`--` | depends=`--` | values=`auto=>u-overflow-auto, clip=>u-overflow-clip, hidden=>u-overflow-hidden, scrollHorizontally=>u-overflow-x-scroll, scrollVertically=>u-overflow-y-scroll, visible=>u-overflow-visible`
+- `wrap` | prompt=`Wrap` | type=`SELECT LIST` | scope=`COMPONENT` | required=`false` | default=`--` | group=`--` | depends=`--` | values=`noWrap=>u-flex-wrap-nowrap, wrap=>u-flex-wrap`