pi-apexlang 0.1.0

package/skills/apexlang/templates/region-components/cards/cards.standard.md

@@ -0,0 +1,156 @@
+---
+templateId: region.cards.standard
+componentType: region
+version: 1.0
+imports:
+  - cards._common
+description: Standard SQL-backed cards region.
+---
+
+# Output Template
+
+```
+region {{regionStaticId}} (
+  name: {{name}}
+  type: cards
+  source {
+    location: localDatabase
+    type: sqlQuery
+    sqlQuery:
+      ```sql
+      {{source.sqlQuery}}
+      ```
+  }
+  layout {
+    sequence: {{layout.sequence}}
+    slot: {{layout.slot}}
+  }
+  appearance {
+    template: @/cards-container
+    templateOptions: #DEFAULT#
+  }
+  card {
+    primaryKeyColumn1: {{card.primaryKeyColumn1}}
+  }
+  title {
+    column: {{title.column}}
+    htmlExpression: {{title.htmlExpression}}
+    advancedFormatting: {{title.advancedFormatting}}
+  }
+  subtitle {
+    column: {{subtitle.column}}
+    htmlExpression: {{subtitle.htmlExpression}}
+    advancedFormatting: {{subtitle.advancedFormatting}}
+  }
+  body {
+    column: {{body.column}}
+    htmlExpression: {{body.htmlExpression}}
+    advancedFormatting: {{body.advancedFormatting}}
+  }
+  secondaryBody {
+    column: {{secondaryBody.column}}
+    htmlExpression: {{secondaryBody.htmlExpression}}
+    advancedFormatting: {{secondaryBody.advancedFormatting}}
+  }
+  media {
+    source: {{media.source}}
+    {{media.sourceValueProperty}}: {{media.sourceValue}}
+  }
+  blobAttributes {
+    mimeTypeColumn: {{blobAttributes.mimeTypeColumn}}
+    lastUpdatedColumn: {{blobAttributes.lastUpdatedColumn}}
+  }
+  iconAndBadge {
+    iconSource: {{iconAndBadge.iconSource}}
+    iconColumn: {{iconAndBadge.iconColumn}}
+    iconCssClasses: {{iconAndBadge.iconCssClasses}}
+    iconDescription: {{iconAndBadge.iconDescription}}
+    badgeColumn: {{iconAndBadge.badgeColumn}}
+    badgeLabel: {{iconAndBadge.badgeLabel}}
+    badgeCssClasses: {{iconAndBadge.badgeCssClasses}}
+  }
+  messages {
+    whenNoDataFound: {{messages.whenNoDataFound}}
+    noDataFoundIcon: {{messages.noDataFoundIcon}}
+  }
+  componentAppearance {
+    gridColumns: {{componentAppearance.gridColumns}}
+  }
+)
+```
+
+In the template above, `{{media.sourceValueProperty}}` / `{{media.sourceValue}}` is schematic. Emit exactly one concrete source-value property according to this mapping:
+
+| media.source | Required value property |
+|--------------|-------------------------|
+| `blobColumn` | `blobColumn` |
+| `urlColumn` | `urlColumn` |
+| `imageUrl` | `url` |
+
+# Media Source Shapes
+
+Use exactly one of these source-specific shapes when a Cards region needs media:
+
+```apexlang
+media {
+    source: blobColumn
+    blobColumn: <BLOB_COLUMN_ALIAS>
+}
+blobAttributes {
+    mimeTypeColumn: <MIME_TYPE_COLUMN_ALIAS>
+    lastUpdatedColumn: <LAST_UPDATED_COLUMN_ALIAS>
+}
+```
+
+```apexlang
+media {
+    source: urlColumn
+    urlColumn: <URL_COLUMN_ALIAS>
+}
+```
+
+```apexlang
+media {
+    source: imageUrl
+    url: <STATIC_IMAGE_URL_OR_COLUMN_SUBSTITUTION>
+}
+```
+
+## Non-Default Media Presentation
+
+Default media presentation is represented by omission: do not emit any APEXlang-side `position`, `appearance`, or `sizing` property for default Cards media. Emit these properties only when the user or spec explicitly asks for a non-default media presentation. Never emit `position: first`, `appearance: square`, or `sizing: cover` just to mirror APEX defaults.
+
+When a non-default presentation is required, add only the needed supported properties inside the same `media` block:
+
+```apexlang
+position: first
+appearance: square
+sizing: cover
+```
+
+# Conditional Rendering Rules
+
+- If `title.column` is emitted, omit `title.htmlExpression` and omit `title.advancedFormatting`.
+- If `title.htmlExpression` is emitted, `title.advancedFormatting` must also be emitted with value `true`, and `title.column` must be omitted.
+- If `subtitle.column` is emitted, omit `subtitle.htmlExpression` and omit `subtitle.advancedFormatting`.
+- If `subtitle.htmlExpression` is emitted, `subtitle.advancedFormatting` must also be emitted with value `true`, and `subtitle.column` must be omitted.
+- If `body.column` is emitted, omit `body.htmlExpression` and omit `body.advancedFormatting`.
+- If `body.htmlExpression` is emitted, `body.advancedFormatting` must also be emitted with value `true`, and `body.column` must be omitted.
+- If `secondaryBody.column` is emitted, omit `secondaryBody.htmlExpression` and omit `secondaryBody.advancedFormatting`.
+- If `secondaryBody.htmlExpression` is emitted, `secondaryBody.advancedFormatting` must also be emitted with value `true`, and `secondaryBody.column` must be omitted.
+- If the Cards region displays a BLOB image, project the raw BLOB column in SQL for display only, define `card.primaryKeyColumn1`, and emit `media { source: blobColumn blobColumn: <BLOB_COLUMN_ALIAS> }`.
+- Do not use the raw BLOB alias as a comparison key; sorting, grouping, distincting, joining, analytic keys, and filter comparisons must follow `SQL_PLSQL_LOB_COMPARISON_KEY_FORBIDDEN_001` in `20-data/apex.sql.md`.
+- Keep companion image metadata columns projected in SQL when available. If MIME type or last-updated aliases are available, emit them in `blobAttributes { mimeTypeColumn: <MIME_TYPE_ALIAS> lastUpdatedColumn: <LAST_UPDATED_ALIAS> }`.
+- Emit `blobAttributes` if and only if `media.source: blobColumn` is present; do not emit it for other media sources or for Cards regions without BLOB media.
+- If the Cards region displays images from a URL column, project that URL alias in SQL and emit `media { source: urlColumn urlColumn: <URL_COLUMN_ALIAS> }`.
+- If the Cards region displays a static image URL or column substitution URL, emit `media { source: imageUrl url: <STATIC_IMAGE_URL_OR_COLUMN_SUBSTITUTION> }`; substitution values use APEX syntax such as `&IMAGE_URL_COLUMN.`.
+- In any Cards `media` block, emit at most one source-specific value property: `blobColumn` with `source: blobColumn`, `urlColumn` with `source: urlColumn`, or `url` with `source: imageUrl`.
+- Default media presentation emits no APEXlang-side `position`, `appearance`, or `sizing` property.
+- Emit `position`, `appearance`, and `sizing` only for explicit non-default media presentation requirements. Accepted values are `position: first | background`, `appearance: square | widescreen`, and `sizing: cover`.
+- Never emit `position: first`, `appearance: square`, or `sizing: cover` just to mirror APEX defaults.
+- Do not emit additional `media` or `blobAttributes` properties unless compiler-backed truth proves them.
+- Do not add report-style child `column (...)` blocks for Cards BLOB display.
+- Inside cards `title.htmlExpression`, `subtitle.htmlExpression`, `body.htmlExpression`, and `secondaryBody.htmlExpression`, use `&COLUMN.` substitution strings, not `#COLUMN#`.
+- Omit the `componentAppearance` block by default.
+- Emit `componentAppearance.gridColumns` only when the prompt explicitly specifies a fixed card column count.
+- If emitted, `componentAppearance.gridColumns` must be one of `2`, `3`, `4`, or `5`.

package/skills/apexlang/templates/region-components/chart/README.md

@@ -0,0 +1,80 @@
+# Chart Templates
+
+## Purpose
+Canonical guidance for the `chart` region family, including shared contract loading and supported scenario variants.
+
+## Usage
+- Load `chart._index.md` first.
+- Load `chart._common.md` next to align variable contracts, guardrails, and required inputs.
+- Load `chart._series._common.md` for canonical series blocks.
+- Load `chart._axis._common.md` for canonical axis blocks.
+- Load one scenario variant matching the requested chart interaction pattern.
+- Load `config/` and `features/` modules only when scenario-specific behavior requires them.
+- For compiler-backed prop lookup, start with:
+  - `--component chart.series`
+  - `--component chart.axis`
+  - `--component chart.series --group columnMapping`
+- Do not query chart series or chart axis with `--parent region`; in this runtime the compiler resolves both under chart `attributes`, so `--component series --parent region` is the wrong path.
+
+## Canonical Shared Files
+- `chart._common.md` is the shared chart-region shell.
+- `chart._series._common.md` is the shared series contract.
+- `chart._axis._common.md` is the shared axis contract.
+
+Agents should not need to list the chart directory to discover the shared series or axis filenames; use the three files above directly.
+
+## Scenario Routing
+
+Choose one chart-type qualifier file:
+
+| Intent | File |
+|---|---|
+| area | `chart.area.md` |
+| area with custom legend | `chart.area-custom-legend.md` |
+| bar | `chart.bar.md` |
+| bubble | `chart.bubble.md` |
+| dashboard combination | `chart.dashboard-combination.md` |
+| donut | `chart.donut.md` |
+| gantt | `chart.gantt.md` |
+| line | `chart.line.md` |
+| line with area | `chart.line-with-area.md` |
+| pie | `chart.pie.md` |
+| scatter | `chart.scatter.md` |
+| status meter gauge | `chart.status-meter-gauge.md` |
+| stock | `chart.stock.md` |
+
+## Practical Defaults
+
+- Monthly trend or monthly spend chart:
+  - `chart.line.md` for trend emphasis
+  - `chart.bar.md` for period-over-period comparison
+  - `chart.area.md` for filled trend emphasis
+- Cartesian charts require the shared axis contract.
+- Pie and donut charts use the shared series contract but suppress axis work.
+- Use `features/` and `config/` only after the base qualifier is selected.
+
+## Template Catalog
+- `chart._index.md`
+- `chart._common.md`
+- `chart._series._common.md`
+- `chart._axis._common.md`
+- `_configuration-modules.md`
+- `chart.area-custom-legend.md`
+- `chart.area.md`
+- `chart.bar.md`
+- `chart.bubble.md`
+- `chart.dashboard-combination.md`
+- `chart.gantt.md`
+- `chart.line-with-area.md`
+- `chart.line.md`
+- `chart.pie.md`
+- `chart.scatter.md`
+- `chart.status-meter-gauge.md`
+- `chart.stock.md`
+- `config/`
+- `features/`
+
+## Maintenance
+- Keep this README synchronized with actual files in the directory.
+- Update catalogs and usage notes whenever templates are added, removed, or renamed.
+- Keep family guidance aligned with page-level standards in memory-bank rules and with scenario coverage in this folder.

package/skills/apexlang/templates/region-components/chart/_configuration-modules.md

@@ -0,0 +1,26 @@
+## Chart Config Modules
+
+Reusable add-ons that complement base chart variants. Each module documents a focused capability (legend customization, dual axis, data label formatting, etc.).
+
+| Module Name | Focus | Notes |
+|-------------|-------|-------|
+| legend-image-icons | Legend icons via static files | Replaces legend entries with images sourced from static application files. |
+| region-display-selector | Toggle chart variants | Ensures target regions set `advanced.regionDisplaySelector: true`. |
+| sql-driven-colors | Color columns in SQL | Alias color values and map through `columnMapping.color`. |
+| legend-resize-buttons | Legend size adjustments | Uses dynamic actions to adjust legend size at runtime. |
+| donut-other-threshold | Donut threshold control | Documents how to alter `otherThreshold` via dynamic actions. |
+| date-range-filters | Date pickers for viewport | Covers item configuration and `pageItemsToSubmit`. |
+| no-data-translation | No-data messaging | Wraps translation override patterns. |
+| axis-formatting | Axis format enums | Reference for `value.format`, decimal places, min/max. |
+| axis-range-controls | Axis min/max items | Steps for item creation and `minimum/maximum` configuration. |
+| page-items-to-submit | Refresh dependencies | Checklist for submitting items used in predicates or JS. |
+| dual-axis | Y/Y2 configuration | Details `dualYAxes` block and series assignment. |
+| data-label-formatting | Label positioning | Patterns for `label.position`, font, color, percentage formatting. |
+| line-style-variants | Line/marker styles | Catalog of `line.type` and `marker.shape` combinations. |
+| stacked-percent-axis | Percent stacking | Axis min/max and format requirements for percent views. |
+| tooltip-formatting | Tooltip overrides | Declarative vs JS tooltip customization. |
+| dashboard-layout | Dashboard composition | Guidance for combining charts with supporting regions. |
+| zoom-scroll | Zoom & scroll behaviors | Explains `zoomAndScroll`, overview usage, and interactions. |
+| chart-links | Chart link patterns | Summarizes redirect URL, link columns, and action integration. |
+
+Add modules under `config/` as markdown files and reference them from scenario templates as needed.

package/skills/apexlang/templates/region-components/chart/chart._axis._common.md

@@ -0,0 +1,67 @@
+---
+templateId: region.chart.axis.common
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+description: Shared contract for chart axis blocks.
+---
+
+# Purpose
+
+Standardize reusable axis contracts across cartesian and dual-axis chart scenarios.
+
+---
+
+# Variable Contract
+
+## Required Variables
+
+- `axisBlocks`
+
+## Axis Fields
+
+- `axis.staticId`
+- `axis.name`
+
+## Optional Axis Fields
+
+- `axis.title`
+- `axis.value.min`
+- `axis.value.max`
+- `axis.value.*`
+- `axis.majorTicks.*`
+- `axis.minorTicks.*`
+
+---
+
+# Output Template – Axis Block
+
+```apexlang
+axis {{axis.staticId}} (
+  name: {{axis.name}}
+  title: {{axis.title}}
+  value {
+    min: {{axis.value.min}}
+    max: {{axis.value.max}}
+    format: {{axis.value.format}}
+    decimalPlaces: {{axis.value.decimalPlaces}}
+    formatScaling: {{axis.value.formatScaling}}
+  }
+  majorTicks {
+    show: {{axis.majorTicks.show}}
+  }
+  minorTicks {
+    show: {{axis.minorTicks.show}}
+  }
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Cartesian charts must render x and y axis blocks.
+- Render y2 axis only when one or more series are assigned to the secondary axis.
+- Use plural tick block names: `majorTicks` and `minorTicks`.
+- Axis value formatting must use supported APEX enums; omit `value.format` for textual axes.

package/skills/apexlang/templates/region-components/chart/chart._common.md

@@ -0,0 +1,119 @@
+---
+templateId: region.chart._common
+componentType: region
+version: 1.0
+description: Shared guardrails and variable contract for Oracle APEX chart regions.
+---
+
+# Purpose
+
+Define canonical chart-region contract, required inputs, and guardrails for all chart scenario templates.
+
+---
+
+# Rules & Guardrails
+
+1. Load `chart._index.md`, `chart._common.md`, `chart._series._common.md`, and `chart._axis._common.md` before drafting chart scenarios.
+2. Load `references/policies/memory-bank/30-pages/apex.chart-page.md`, `20-data/apex.sql.md`, and `40-components/apex.templates.md` for page/data/template guardrails.
+3. Use the dedicated `region-chart` template variant.
+4. Treat the chart qualifier as mandatory design intent: `bar`, `line`, `pie`, `donut`, or `area`.
+5. Use variable-driven placeholders in executable output templates; keep static demonstrations in `config/` and `features/` references.
+6. Keep SQL deterministic with explicit aliases; avoid `SELECT *`.
+7. Cartesian charts must render x and y axis blocks; render y2 only when needed.
+8. Axis metadata must use the canonical chart-axis contract, including plural tick blocks (`majorTicks`, `minorTicks`) and supported value-format enums only.
+9. Keep label and value mappings on the series block.
+10. Default chart regions to `appearance.template: @/standard` unless a documented chart scenario explicitly needs a different structural shell.
+11. Treat the qualifier file as the authoritative chart-type selector. Do not browse the folder to rediscover shared series/axis filenames; the canonical shared files are `chart._series._common.md` and `chart._axis._common.md`.
+12. If compiler-backed prop lookup is uncertain because the exact internal chart subtype token is unknown, stop guessing and draft from the checked-in chart contracts instead of bouncing between query attempts.
+13. For compiler-backed chart child lookup, use the dotted aliases `chart.series` and `chart.axis` first. Do not query those child contracts with `--parent region`; in this runtime the compiler resolves them under chart `attributes`.
+
+---
+
+# Variable Contract
+
+## Required Variables
+
+- `chartRegion.staticId`
+- `chartRegion.name`
+- `layout.sequence`
+- `layout.slot`
+- `chart.type`
+- `seriesBlocks` (from `chart._series._common.md`)
+
+## Optional Variables
+
+- `appearance.*`
+- `advanced.*`
+- `chart.options`
+- `chartAppearance`
+- `chartLayout`
+- `legend`
+- `axisBlocks` (from `chart._axis._common.md`)
+- `scenarioExtensions`
+
+---
+
+# Output Template – Skeleton
+
+```apexlang
+region {{chartRegion.staticId}} (
+  name: {{chartRegion.name}}
+  type: chart
+  layout {
+    sequence: {{layout.sequence}}
+    slot: {{layout.slot}}
+  }
+  appearance {
+    template: {{appearance.template}}
+    templateOptions: {{appearance.templateOptions}}
+  }
+  advanced {
+    htmlDomId: {{advanced.htmlDomId}}
+    regionDisplaySelector: {{advanced.regionDisplaySelector}}
+  }
+  chart {
+    type: {{chart.type}}
+    {{chart.options}}
+  }
+  chartAppearance {
+    {{chartAppearance}}
+  }
+  chartLayout {
+    {{chartLayout}}
+  }
+  legend {
+    {{legend}}
+  }
+
+  {{seriesBlocks}}
+
+  {{axisBlocks}}
+
+  {{scenarioExtensions}}
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Pick exactly one chart qualifier file per region.
+- Render `{{seriesBlocks}}` using `chart._series._common.md`.
+- Render `{{axisBlocks}}` using `chart._axis._common.md` when axis-capable chart types are used.
+- For bar, line, area, scatter, stock, and other cartesian chart types, the shared axis file is mandatory.
+- For pie, donut, and other non-axis chart types, omit axis blocks unless the chosen qualifier explicitly requires them.
+- Chart regions may also include standard region-title blocks when the scenario needs a visible heading.
+- Keep axis configuration only when the selected chart type uses axes.
+- Omit optional blocks not required by the selected chart type.
+- Keep `appearance.template: @/standard` as the default shell for chart regions.
+
+---
+
+# Guardrails
+
+- Metadata export lookup: search for `Chart`, the qualifier name, and the series label/value mapping properties.
+- Preferred query helpers for chart children:
+  - `node tools/query-valid-props.mjs --component chart.series`
+  - `node tools/query-valid-props.mjs --component chart.axis`
+  - `node tools/query-valid-props.mjs --component chart.series --group columnMapping`
+- Avoid `node ... --component series --parent region ...` for charts; that path is not how this runtime exposes chart child contracts.

package/skills/apexlang/templates/region-components/chart/chart._index.md

@@ -0,0 +1,62 @@
+---
+templateId: region.chart.index
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+  - chart._series._common.md
+  - chart._axis._common.md
+description: Routing entrypoint for chart region templates.
+---
+
+# Purpose
+
+Primary routing entrypoint for `chart` region templates.
+
+# Load Order
+
+1. Load this file.
+2. Load `chart._common.md`.
+3. Load `chart._series._common.md`.
+4. Load `chart._axis._common.md`.
+5. Load exactly one chart-type qualifier file from this folder.
+6. Load optional `config/` and `features/` modules only when needed.
+
+# Shared Files
+
+- Shared chart-region contract: `chart._common.md`
+- Shared series contract: `chart._series._common.md`
+- Shared axis contract: `chart._axis._common.md`
+
+Do not browse the directory to rediscover the shared contract filenames. These three files are the canonical shared entrypoints for all chart work.
+
+# Chart-Type Routing
+
+Use exactly one qualifier file per chart region:
+
+| Intent | Qualifier file |
+|---|---|
+| area chart | `chart.area.md` |
+| area chart with custom legend | `chart.area-custom-legend.md` |
+| bar chart | `chart.bar.md` |
+| bubble chart | `chart.bubble.md` |
+| dashboard combination chart | `chart.dashboard-combination.md` |
+| donut chart | `chart.donut.md` |
+| gantt chart | `chart.gantt.md` |
+| line chart | `chart.line.md` |
+| line chart with area fill | `chart.line-with-area.md` |
+| pie chart | `chart.pie.md` |
+| scatter chart | `chart.scatter.md` |
+| status meter gauge | `chart.status-meter-gauge.md` |
+| stock chart | `chart.stock.md` |
+
+# Query Guidance
+
+- Use the dotted chart aliases first:
+  - `--component chart.series`
+  - `--component chart.axis`
+  - `--component chart.series --group columnMapping`
+- Do not query chart series or chart axis with `--parent region`. In the compiler metadata for this runtime, `series` and `axis` resolve under chart `attributes`, not as direct `region` children, so `--component series --parent region` returns no matches.
+- Use compiler-backed prop lookup when the exact chart subtype token is already known.
+- If chart-specific compiler lookup is uncertain, do not bounce between guesses. Load the shared chart contracts above plus the matching qualifier file from the routing table and draft from the checked-in chart templates.
+- For monthly trend or monthly spend visuals, start with `chart.line.md`, `chart.bar.md`, or `chart.area.md` based on the requested visual form, then add only the needed `features/` or `config/` modules.

package/skills/apexlang/templates/region-components/chart/chart._series._common.md

@@ -0,0 +1,92 @@
+---
+templateId: region.chart.series.common
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+description: Shared contract for chart series blocks.
+---
+
+# Purpose
+
+Standardize reusable series contracts across all chart scenarios.
+
+---
+
+# Variable Contract
+
+## Required Variables
+
+- `seriesBlocks`
+
+## Series Fields
+
+- `series.staticId`
+- `series.name`
+- `series.source.type`
+- `series.columnMapping`
+
+## Optional Series Fields
+
+- `series.execution.*`
+- `series.source.sqlQuery`
+- `series.source.restSource`
+- `series.source.pageItemsToSubmit`
+- `series.appearance.*`
+- `series.label.*`
+- `series.marker.*`
+- `series.line.*`
+- `series.tooltip.*`
+- `series.advanced.*`
+
+---
+
+# Output Template – Series Block
+
+```apexlang
+series {{series.staticId}} (
+  name: {{series.name}}
+  execution {
+    sequence: {{series.execution.sequence}}
+  }
+  source {
+    type: {{series.source.type}}
+    restSource: @{{series.source.restSource}}
+    pageItemsToSubmit: {{series.source.pageItemsToSubmit}}
+    sqlQuery:
+      ```sql
+      {{series.source.sqlQuery}}
+      ```
+  }
+  columnMapping {
+    {{series.columnMapping}}
+  }
+  appearance {
+    {{series.appearance}}
+  }
+  line {
+    {{series.line}}
+  }
+  marker {
+    {{series.marker}}
+  }
+  label {
+    {{series.label}}
+  }
+  tooltip {
+    {{series.tooltip}}
+  }
+  advanced {
+    {{series.advanced}}
+  }
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Render only attributes needed by the target chart type.
+- Keep alias mappings deterministic and schema-valid.
+- SQL output aliases referenced by `columnMapping` must match the returned query metadata exactly, including case.
+- For generated SQL-backed charts, prefer uppercase aliases in both the SQL and `columnMapping` (for example `LABEL`, `VALUE`, `STORE_LABEL`, `TOTAL_VALUE`) to avoid runtime column-resolution mismatches.

package/skills/apexlang/templates/region-components/chart/chart.area-custom-legend.md

@@ -0,0 +1,78 @@
+---
+templateId: region.chart.area-custom-legend
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+  - chart._series._common.md
+  - chart._axis._common.md
+description: Area chart scenario with custom-legend extension hooks.
+---
+
+# Purpose
+
+Variable-driven area chart scenario with optional custom legend behavior.
+
+---
+
+# Generation Rules (MANDATORY)
+
+1. Load `chart._common.md`, `chart._series._common.md`, and `chart._axis._common.md` before use.
+2. Keep legend scripts and static-file references variable-driven.
+3. Keep executable output contract-only; move fixed demonstrations to config/features references.
+
+---
+
+# Output Template – Full
+
+```apexlang
+region {{chartRegion.staticId}} (
+  name: {{chartRegion.name}}
+  type: chart
+  layout {
+    sequence: {{layout.sequence}}
+    slot: {{layout.slot}}
+  }
+  appearance {
+    template: {{appearance.template}}
+    templateOptions: {{appearance.templateOptions}}
+  }
+  advanced {
+    htmlDomId: {{advanced.htmlDomId}}
+    regionDisplaySelector: {{advanced.regionDisplaySelector}}
+  }
+  chart {
+    type: {{chart.type}}
+    {{chart.options}}
+  }
+  chartAppearance {
+    {{chartAppearance}}
+  }
+  chartLayout {
+    {{chartLayout}}
+  }
+  componentAdvanced {
+    initJavaScriptFunction:
+      ```javascript-browser
+      {{componentAdvanced.initJavaScriptFunction}}
+      ```
+  }
+  legend {
+    {{legend}}
+  }
+
+  {{seriesBlocks}}
+
+  {{axisBlocks}}
+
+  {{scenarioExtensions}}
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Render `{{seriesBlocks}}` using `chart._series._common.md`.
+- Render `{{axisBlocks}}` using `chart._axis._common.md`.
+- Omit `componentAdvanced` when custom legend JavaScript is not required.