pi-apexlang 0.1.0

package/skills/apexlang/templates/page-layout-templates/marquee/marquee.basic.md

@@ -0,0 +1,54 @@
+---
+templateId: page.marquee.basic
+component: page
+dslVersion: 1.0
+imports:
+  - marquee._common.md
+description: Baseline marquee page example with hero and body content regions.
+---
+
+## Purpose
+Provide a baseline `@/marquee` page example for landing or dashboard-style experiences with a strong hero section.
+
+## Template
+```apexlang
+page 140 (
+    name: Executive Summary
+    alias: EXECUTIVE-SUMMARY
+    title: Executive Summary
+    appearance {
+        pageTemplate: @/marquee
+        templateOptions: #DEFAULT#
+    }
+    navigation {
+        cursorFocus: doNotFocusCursor
+    }
+    security {
+        authorizationScheme: mustNotBePublicUser
+        pageAccessProtection: argumentsMustHaveChecksum
+        formAutoComplete: false
+    }
+
+    region HERO (
+        name: Hero
+        type: staticContent
+        layout {
+            sequence: 10
+            slot: REGION_POSITION_07
+        }
+    )
+
+    region CONTENT (
+        name: Content
+        type: staticContent
+        layout {
+            sequence: 20
+            slot: BODY
+        }
+    )
+)
+```
+
+## Notes
+- Add supporting regions in `REGION_POSITION_02` or `REGION_POSITION_03` only when they reinforce the marquee hierarchy.
+- Keep overlays and launch surfaces in `REGION_POSITION_04`.

package/skills/apexlang/templates/page-layout-templates/minimal-no-navigation/README.md

@@ -0,0 +1,18 @@
+# Minimal No Navigation Templates
+
+## Purpose
+Canonical guidance for the `@/minimal-no-navigation` page layout family and its markdown entrypoints.
+
+## Usage
+- Load [`../_shared/page.common.md`](../_shared/page.common.md) first to align shared non-dialog variables and slot guidance.
+- Load `minimal-no-navigation._common.md` next for the `@/minimal-no-navigation` family contract.
+- Load `minimal-no-navigation.basic.md` for a baseline example.
+
+## Template Catalog
+- `minimal-no-navigation._common.md`
+- `minimal-no-navigation.basic.md`
+
+## Maintenance
+- Keep this README synchronized with actual files in the directory.
+- Preserve the markdown-only contract for page layout templates in this tree.
+- Keep slot and template-option guidance aligned with current Theme 42 metadata.

package/skills/apexlang/templates/page-layout-templates/minimal-no-navigation/minimal-no-navigation._common.md

@@ -0,0 +1,65 @@
+---
+templateId: page.minimal-no-navigation
+component: page
+dslVersion: 1.0
+description: Focused Theme 42 page layout with standard content slots but no navigation chrome.
+---
+
+## Purpose
+Apply the shared non-dialog page contract to the Theme 42 `Minimal (No Navigation)` page template. Use this layout for focused tasks, embedded flows, or utility pages that should avoid full app navigation.
+
+## Variables
+| Name | Required | Type | Description |
+|------|----------|------|-------------|
+| base page vars | inherited | `page.common` | Load [`../_shared/page.common.md`](../_shared/page.common.md) first. |
+| appearance.pageTemplate | yes | string | Must be `@/minimal-no-navigation`. |
+| appearance.templateOptions | optional | string or array | Usually `#DEFAULT#` or `sticky-header-on-mobile`; use the `static_id` values from the inventory in [`../README.md`](../README.md). |
+| layout slots | derived | slot set | `AFTER_LOGO`, `AFTER_NAVIGATION_BAR`, `REGION_POSITION_07`, `BEFORE_NAVIGATION_BAR`, `BODY`, `REGION_POSITION_01`, `REGION_POSITION_04`, `REGION_POSITION_05`, `REGION_POSITION_08`, `REGION_POSITION_06`. |
+
+## Template
+```apexlang
+page [pageNumber] (
+    name: [name]
+    alias: [alias]
+    title: [title]
+    appearance {
+        pageTemplate: @/minimal-no-navigation
+        templateOptions: [appearance.templateOptions]
+    }
+    navigation {
+        cursorFocus: doNotFocusCursor
+    }
+    security {
+        authorizationScheme: mustNotBePublicUser
+        pageAccessProtection: [security.pageAccessProtection]
+        formAutoComplete: false
+    }
+
+    region content (
+        name: [contentRegionName]
+        type: [contentRegionType]
+        layout {
+            sequence: 10
+            slot: BODY
+        }
+    )
+)
+```
+
+## Slot Guidance
+- `BODY`: Primary content area.
+- `REGION_POSITION_01`: Breadcrumb or page-title content when needed.
+- `REGION_POSITION_04`: Dialogs, drawers, and popup launch regions.
+- `REGION_POSITION_05`: Footer content.
+- `REGION_POSITION_06`: Optional top navigation or utility content even though the page omits the standard nav chrome.
+
+## Conditional Rules
+- Prefer this template when navigation should be intentionally absent rather than merely hidden by conditions.
+- Keep banner and footer regions optional unless the task flow truly needs them.
+
+## Guardrails
+- Do not use this template as a substitute for access control; it is a layout decision, not a security mode.
+- When the page starts accumulating column-based content, switch to a more explicit page template.
+
+## Source Anchors
+- `core/themes/theme_42/f8842.261/application/shared_components/user_interface/templates/page/minimal_no_navigation.sql`

package/skills/apexlang/templates/page-layout-templates/minimal-no-navigation/minimal-no-navigation._index.md

@@ -0,0 +1,18 @@
+---
+templateId: minimal-no-navigation.index
+componentType: template
+dslVersion: 1.0
+imports:
+  - ../_shared/page.common.md
+  - minimal-no-navigation._common.md
+description: Routing entrypoint for minimal-no-navigation templates.
+---
+
+## Purpose
+Primary routing entrypoint for `minimal-no-navigation` templates.
+
+## Load Order
+1. Load this file.
+2. Load `../_shared/page.common.md`.
+3. Load `minimal-no-navigation._common.md`.
+4. Load `minimal-no-navigation.basic.md` when a baseline example is needed.

package/skills/apexlang/templates/page-layout-templates/minimal-no-navigation/minimal-no-navigation.basic.md

@@ -0,0 +1,45 @@
+---
+templateId: page.minimal-no-navigation.basic
+component: page
+dslVersion: 1.0
+imports:
+  - minimal-no-navigation._common.md
+description: Baseline minimal-no-navigation page example with a single focused content region.
+---
+
+## Purpose
+Provide a baseline `@/minimal-no-navigation` example for focused tasks that should not show the standard application navigation chrome.
+
+## Template
+```apexlang
+page 150 (
+    name: Guided Task
+    alias: GUIDED-TASK
+    title: Guided Task
+    appearance {
+        pageTemplate: @/minimal-no-navigation
+        templateOptions: #DEFAULT#
+    }
+    navigation {
+        cursorFocus: doNotFocusCursor
+    }
+    security {
+        authorizationScheme: mustNotBePublicUser
+        pageAccessProtection: argumentsMustHaveChecksum
+        formAutoComplete: false
+    }
+
+    region CONTENT (
+        name: Content
+        type: staticContent
+        layout {
+            sequence: 10
+            slot: BODY
+        }
+    )
+)
+```
+
+## Notes
+- Use this template when the absence of navigation chrome is intentional.
+- Switch to `@/standard` if the page starts needing broader application framing.

package/skills/apexlang/templates/page-layout-templates/modal-dialog/README.md

@@ -0,0 +1,18 @@
+# Modal Dialog Templates
+
+## Purpose
+Canonical guidance for the `@/modal-dialog` page layout family and its markdown entrypoints.
+
+## Usage
+- Load [`../_shared/page.modal-dialog.common.md`](../_shared/page.modal-dialog.common.md) first to align dialog-specific variables and slot guidance.
+- Load `modal-dialog._common.md` next for the `@/modal-dialog` family contract.
+- Load `modal-dialog.basic.md` for a baseline example.
+
+## Template Catalog
+- `modal-dialog._common.md`
+- `modal-dialog.basic.md`
+
+## Maintenance
+- Keep this README synchronized with actual files in the directory.
+- Preserve the markdown-only contract for page layout templates in this tree.
+- Keep slot and template-option guidance aligned with current Theme 42 metadata.

package/skills/apexlang/templates/page-layout-templates/modal-dialog/modal-dialog._common.md

@@ -0,0 +1,62 @@
+---
+templateId: page.modal-dialog
+component: page
+dslVersion: 1.0
+description: Standard Theme 42 modal dialog page layout.
+---
+
+## Purpose
+Apply the shared modal dialog contract to the Theme 42 `Modal Dialog` page template. This is the default dialog page surfaced by the generator's dialog defaults.
+
+## Variables
+| Name | Required | Type | Description |
+|------|----------|------|-------------|
+| base dialog vars | inherited | `page.modal-dialog.common` | Load [`../_shared/page.modal-dialog.common.md`](../_shared/page.modal-dialog.common.md) first. |
+| appearance.dialogTemplate | yes | string | Must be `@/modal-dialog`. |
+| appearance.templateOptions | optional | string or array | `#DEFAULT#`, `remove-body-padding`, or `stretch-to-fit-window`; use the `static_id` values from the inventory in [`../README.md`](../README.md). |
+| layout slots | derived | slot set | `BODY` (`contentBody`), `REGION_POSITION_01` (`dialogHeader`), `REGION_POSITION_03` (`dialogFooter`). |
+
+## Template
+```apexlang
+page [pageNumber] (
+    name: [name]
+    alias: [alias]
+    title: [title]
+    appearance {
+        pageMode: modalDialog
+        dialogTemplate: @/modal-dialog
+        templateOptions: [appearance.templateOptions]
+    }
+    security {
+        authorizationScheme: mustNotBePublicUser
+        pageAccessProtection: [security.pageAccessProtection]
+        formAutoComplete: false
+    }
+
+    region content (
+        name: [contentRegionName]
+        type: [contentRegionType]
+        layout {
+            sequence: 10
+            slot: BODY
+        }
+    )
+)
+```
+
+## Slot Guidance
+- `BODY`: Main dialog content.
+- `REGION_POSITION_01`: Title bar, breadcrumb-style context, or compact helper content.
+- `REGION_POSITION_03`: Footer content such as dialog button regions.
+
+## Conditional Rules
+- Put submit and cancel buttons in the footer slot when the page follows the standard dialog pattern.
+- Use explicit close-dialog processing after successful submit flows so parent pages can refresh predictably.
+
+## Guardrails
+- Keep the dialog footer focused on actions rather than large supporting regions.
+- Use the stretch option only when the dialog truly needs viewport-sized content.
+
+## Source Anchors
+- `core/themes/theme_42/f8842.261/application/shared_components/user_interface/templates/page/modal_dialog.sql`
+- Internal template-source metadata (`dialogDefaults`)

package/skills/apexlang/templates/page-layout-templates/modal-dialog/modal-dialog._index.md

@@ -0,0 +1,18 @@
+---
+templateId: modal-dialog.index
+componentType: template
+dslVersion: 1.0
+imports:
+  - ../_shared/page.modal-dialog.common.md
+  - modal-dialog._common.md
+description: Routing entrypoint for modal-dialog templates.
+---
+
+## Purpose
+Primary routing entrypoint for `modal-dialog` templates.
+
+## Load Order
+1. Load this file.
+2. Load `../_shared/page.modal-dialog.common.md`.
+3. Load `modal-dialog._common.md`.
+4. Load `modal-dialog.basic.md` when a baseline example is needed.

package/skills/apexlang/templates/page-layout-templates/modal-dialog/modal-dialog.basic.md

@@ -0,0 +1,53 @@
+---
+templateId: page.modal-dialog.basic
+component: page
+dslVersion: 1.0
+imports:
+  - modal-dialog._common.md
+description: Baseline modal dialog example with body content and a footer region host.
+---
+
+## Purpose
+Provide a baseline `@/modal-dialog` example for standard dialog interactions.
+
+## Template
+```apexlang
+page 160 (
+    name: Modal Dialog
+    alias: MODAL-DIALOG
+    title: Modal Dialog
+    appearance {
+        pageMode: modalDialog
+        dialogTemplate: @/modal-dialog
+        templateOptions: #DEFAULT#
+    }
+    security {
+        authorizationScheme: mustNotBePublicUser
+        pageAccessProtection: argumentsMustHaveChecksum
+        formAutoComplete: false
+    }
+
+    region CONTENT (
+        name: Content
+        type: staticContent
+        layout {
+            sequence: 10
+            slot: BODY
+        }
+    )
+
+    region FOOTER (
+        name: Footer
+        type: staticContent
+        layout {
+            sequence: 20
+            slot: REGION_POSITION_03
+        }
+    )
+)
+```
+
+## Notes
+- Host submit and cancel buttons in a footer region anchored to `REGION_POSITION_03`.
+- Add header context in `REGION_POSITION_01` only when the dialog needs more than the default title chrome.
+- Use explicit submit and close-dialog processing so the calling page can refresh predictably.

package/skills/apexlang/templates/page-layout-templates/page-layout-template-family-registry.json

@@ -0,0 +1,92 @@
+{
+  "version": 1,
+  "entries": [
+    {
+      "slug": "_shared",
+      "path": "_shared/",
+      "examples": [
+        "_shared/README.md",
+        "_shared/page.common.md",
+        "_shared/page.drawer.common.md",
+        "_shared/page.modal-dialog.common.md"
+      ]
+    },
+    {
+      "slug": "blank",
+      "path": "blank/",
+      "readme": "blank/README.md",
+      "index": "blank/blank._index.md",
+      "common": "blank/blank._common.md"
+    },
+    {
+      "slug": "drawer",
+      "path": "drawer/",
+      "readme": "drawer/README.md",
+      "index": "drawer/drawer._index.md",
+      "common": "drawer/drawer._common.md"
+    },
+    {
+      "slug": "left-and-right-side-columns",
+      "path": "left-and-right-side-columns/",
+      "readme": "left-and-right-side-columns/README.md",
+      "index": "left-and-right-side-columns/left-and-right-side-columns._index.md",
+      "common": "left-and-right-side-columns/left-and-right-side-columns._common.md"
+    },
+    {
+      "slug": "left-side-column",
+      "path": "left-side-column/",
+      "readme": "left-side-column/README.md",
+      "index": "left-side-column/left-side-column._index.md",
+      "common": "left-side-column/left-side-column._common.md"
+    },
+    {
+      "slug": "login",
+      "path": "login/",
+      "readme": "login/README.md",
+      "index": "login/login._index.md",
+      "common": "login/login._common.md"
+    },
+    {
+      "slug": "marquee",
+      "path": "marquee/",
+      "readme": "marquee/README.md",
+      "index": "marquee/marquee._index.md",
+      "common": "marquee/marquee._common.md"
+    },
+    {
+      "slug": "minimal-no-navigation",
+      "path": "minimal-no-navigation/",
+      "readme": "minimal-no-navigation/README.md",
+      "index": "minimal-no-navigation/minimal-no-navigation._index.md",
+      "common": "minimal-no-navigation/minimal-no-navigation._common.md"
+    },
+    {
+      "slug": "modal-dialog",
+      "path": "modal-dialog/",
+      "readme": "modal-dialog/README.md",
+      "index": "modal-dialog/modal-dialog._index.md",
+      "common": "modal-dialog/modal-dialog._common.md"
+    },
+    {
+      "slug": "right-side-column",
+      "path": "right-side-column/",
+      "readme": "right-side-column/README.md",
+      "index": "right-side-column/right-side-column._index.md",
+      "common": "right-side-column/right-side-column._common.md"
+    },
+    {
+      "slug": "standard",
+      "path": "standard/",
+      "readme": "standard/README.md",
+      "index": "standard/standard._index.md",
+      "common": "standard/standard._common.md"
+    },
+    {
+      "slug": "wizard-modal-dialog",
+      "path": "wizard-modal-dialog/",
+      "readme": "wizard-modal-dialog/README.md",
+      "index": "wizard-modal-dialog/wizard-modal-dialog._index.md",
+      "common": "wizard-modal-dialog/wizard-modal-dialog._common.md"
+    }
+  ]
+}

package/skills/apexlang/templates/page-layout-templates/right-side-column/README.md

@@ -0,0 +1,18 @@
+# Right Side Column Templates
+
+## Purpose
+Canonical guidance for the `@/right-side-column` page layout family and its markdown entrypoints.
+
+## Usage
+- Load [`../_shared/page.common.md`](../_shared/page.common.md) first to align shared non-dialog variables and slot guidance.
+- Load `right-side-column._common.md` next for the `@/right-side-column` family contract.
+- Load `right-side-column.basic.md` for a baseline example.
+
+## Template Catalog
+- `right-side-column._common.md`
+- `right-side-column.basic.md`
+
+## Maintenance
+- Keep this README synchronized with actual files in the directory.
+- Preserve the markdown-only contract for page layout templates in this tree.
+- Keep slot and template-option guidance aligned with current Theme 42 metadata.

package/skills/apexlang/templates/page-layout-templates/right-side-column/right-side-column._common.md

@@ -0,0 +1,74 @@
+---
+templateId: page.right-side-column
+component: page
+dslVersion: 1.0
+description: Standard Theme 42 page layout with an additional right column slot.
+---
+
+## Purpose
+Apply the shared non-dialog page contract to the Theme 42 `Right Side Column` page template. Use this layout when secondary information or actions belong in a right rail.
+
+## Variables
+| Name | Required | Type | Description |
+|------|----------|------|-------------|
+| base page vars | inherited | `page.common` | Load [`../_shared/page.common.md`](../_shared/page.common.md) first. |
+| appearance.pageTemplate | yes | string | Must be `@/right-side-column`. |
+| appearance.templateOptions | optional | string or array | Usually `#DEFAULT#` or `sticky-header-on-mobile`; use the `static_id` values from the inventory in [`../README.md`](../README.md). |
+| layout slots | derived | slot set | Standard slots plus `REGION_POSITION_03` (`rightColumn`). |
+
+## Template
+```apexlang
+page [pageNumber] (
+    name: [name]
+    alias: [alias]
+    title: [title]
+    appearance {
+        pageTemplate: @/right-side-column
+        templateOptions: [appearance.templateOptions]
+    }
+    navigation {
+        cursorFocus: doNotFocusCursor
+    }
+    security {
+        authorizationScheme: mustNotBePublicUser
+        pageAccessProtection: [security.pageAccessProtection]
+        formAutoComplete: false
+    }
+
+    region content (
+        name: [contentRegionName]
+        type: [contentRegionType]
+        layout {
+            sequence: 10
+            slot: BODY
+        }
+    )
+
+    region rightRail (
+        name: [rightRailName]
+        type: [rightRailType]
+        layout {
+            sequence: 20
+            slot: REGION_POSITION_03
+        }
+    )
+)
+```
+
+## Slot Guidance
+- `REGION_POSITION_03` (`rightColumn`): Supporting cards, contextual actions, and inspector-style content.
+- In the current Theme 42 implementation, `rightColumn` is a fixed-width rail of about `15rem`. Treat that width as a build-pinned selection heuristic, not a tunable body-grid ratio.
+- Use this rail for selector-driven main-pane behavior only when the UX intentionally places the controlling chooser or contextual inspector on the right; otherwise prefer the left rail for navigation-like patterns.
+- All standard-page slots remain available.
+
+## Conditional Rules
+- Keep the right rail conditional when it depends on selected content or page mode.
+- Avoid moving right-rail actions into the footer unless they truly belong to the whole page.
+
+## Guardrails
+- Use this template when the right rail is structurally part of the page, not as a workaround for crowded main content.
+- If the requirement needs a wider or tunable sidebar-main ratio, prefer `@/standard` plus explicit body-grid coordinates instead of this fixed rail.
+- Reserve `REGION_POSITION_03` for narrow supporting content rather than full-width reports or forms.
+
+## Source Anchors
+- `core/themes/theme_42/f8842.261/application/shared_components/user_interface/templates/page/right_side_column.sql`

package/skills/apexlang/templates/page-layout-templates/right-side-column/right-side-column._index.md

@@ -0,0 +1,18 @@
+---
+templateId: right-side-column.index
+componentType: template
+dslVersion: 1.0
+imports:
+  - ../_shared/page.common.md
+  - right-side-column._common.md
+description: Routing entrypoint for right-side-column templates.
+---
+
+## Purpose
+Primary routing entrypoint for `right-side-column` templates.
+
+## Load Order
+1. Load this file.
+2. Load `../_shared/page.common.md`.
+3. Load `right-side-column._common.md`.
+4. Load `right-side-column.basic.md` when a baseline example is needed.

package/skills/apexlang/templates/page-layout-templates/right-side-column/right-side-column.basic.md

@@ -0,0 +1,54 @@
+---
+templateId: page.right-side-column.basic
+component: page
+dslVersion: 1.0
+imports:
+  - right-side-column._common.md
+description: Baseline right-side-column page example with a supporting right rail.
+---
+
+## Purpose
+Provide a baseline `@/right-side-column` page example for pages that need contextual content in a right rail.
+
+## Template
+```apexlang
+page 170 (
+    name: Record Review
+    alias: RECORD-REVIEW
+    title: Record Review
+    appearance {
+        pageTemplate: @/right-side-column
+        templateOptions: #DEFAULT#
+    }
+    navigation {
+        cursorFocus: doNotFocusCursor
+    }
+    security {
+        authorizationScheme: mustNotBePublicUser
+        pageAccessProtection: argumentsMustHaveChecksum
+        formAutoComplete: false
+    }
+
+    region CONTENT (
+        name: Content
+        type: staticContent
+        layout {
+            sequence: 10
+            slot: BODY
+        }
+    )
+
+    region RIGHT_RAIL (
+        name: Right Rail
+        type: staticContent
+        layout {
+            sequence: 20
+            slot: REGION_POSITION_03
+        }
+    )
+)
+```
+
+## Notes
+- Use the right rail for supporting details, actions, or inspector-style content.
+- Keep the main page body dominant.

package/skills/apexlang/templates/page-layout-templates/standard/README.md

@@ -0,0 +1,18 @@
+# Standard Templates
+
+## Purpose
+Canonical guidance for the `@/standard` page layout family and its markdown entrypoints.
+
+## Usage
+- Load [`../_shared/page.common.md`](../_shared/page.common.md) first to align shared non-dialog variables and slot guidance.
+- Load `standard._common.md` next for the `@/standard` family contract.
+- Load `standard.basic.md` for a baseline example.
+
+## Template Catalog
+- `standard._common.md`
+- `standard.basic.md`
+
+## Maintenance
+- Keep this README synchronized with actual files in the directory.
+- Preserve the markdown-only contract for page layout templates in this tree.
+- Keep slot and template-option guidance aligned with current Theme 42 metadata.