pi-apexlang 0.1.0

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

@@ -0,0 +1,80 @@
+---
+templateId: region.chart.area
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+  - chart._series._common.md
+  - chart._axis._common.md
+description: Area chart scenario with variable-driven legend and series contracts.
+---
+
+# Purpose
+
+Variable-driven area chart scenario with shared series and axis contracts.
+
+---
+
+# Generation Rules (MANDATORY)
+
+1. Load `chart._common.md` first.
+2. Set `chart.type` to `area`.
+
+---
+
+# Variable Contract
+
+## Required Variables
+
+- `chart.type`
+- `series.alias`
+
+---
+
+# 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 {
+    regionDisplaySelector: {{advanced.regionDisplaySelector}}
+  }
+  chart {
+    type: {{chart.type}}
+    {{chart.options}}
+  }
+  chartAppearance {
+    {{chartAppearance}}
+  }
+  chartLayout {
+    {{chartLayout}}
+  }
+  dataCursor {
+    {{dataCursor}}
+  }
+  legend {
+    {{legend}}
+  }
+
+  {{seriesBlocks}}
+
+  {{axisBlocks}}
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Render `{{seriesBlocks}}` using `chart._series._common.md`.
+- Render `{{axisBlocks}}` using `chart._axis._common.md`.
+- Keep area fill behavior in the series or chart attributes only when the design requires it.

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

@@ -0,0 +1,81 @@
+---
+templateId: region.chart.bar
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+  - chart._series._common.md
+  - chart._axis._common.md
+description: Bar chart scenario with optional dual-axis configuration.
+---
+
+# Purpose
+
+Variable-driven bar chart scenario with optional secondary axis and series formatting.
+
+---
+
+# Generation Rules (MANDATORY)
+
+1. Load `chart._common.md` first.
+2. Set `chart.type` to `bar`.
+
+---
+
+# Variable Contract
+
+## Required Variables
+
+- `chart.type`
+- `series.alias`
+- `columnMapping.label`
+- `columnMapping.value`
+
+---
+
+# 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}}
+  }
+  legend {
+    {{legend}}
+  }
+
+  {{seriesBlocks}}
+
+  {{axisBlocks}}
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Render `{{seriesBlocks}}` using `chart._series._common.md`.
+- Render `{{axisBlocks}}` using `chart._axis._common.md`.
+- Include y2 axis only when a series is assigned to the secondary axis.
+- Keep bar-chart-specific axis tuning outside the shared shell unless required.

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

@@ -0,0 +1,53 @@
+---
+templateId: region.chart.bubble
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+  - chart._series._common.md
+  - chart._axis._common.md
+description: Bubble chart scenario with variable-driven source and axis contracts.
+---
+
+# Purpose
+
+Variable-driven bubble chart scenario for multi-metric comparisons.
+
+---
+
+# 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}}
+  }
+  chart {
+    type: {{chart.type}}
+    {{chart.options}}
+  }
+  legend {
+    {{legend}}
+  }
+
+  {{seriesBlocks}}
+
+  {{axisBlocks}}
+
+  {{scenarioExtensions}}
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Render `{{seriesBlocks}}` using `chart._series._common.md`.
+- Render `{{axisBlocks}}` using `chart._axis._common.md`.

package/skills/apexlang/templates/region-components/chart/chart.dashboard-combination.md

@@ -0,0 +1,59 @@
+---
+templateId: region.chart.dashboard-combination
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+  - chart._series._common.md
+  - chart._axis._common.md
+description: Dashboard combination chart scenario with variable-driven region contracts.
+---
+
+# Purpose
+
+Variable-driven dashboard chart scenario that composes multiple series behaviors in one region.
+
+---
+
+# 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 {
+    regionDisplaySelector: {{advanced.regionDisplaySelector}}
+  }
+  chart {
+    type: {{chart.type}}
+    {{chart.options}}
+  }
+  chartAppearance {
+    {{chartAppearance}}
+  }
+  legend {
+    {{legend}}
+  }
+
+  {{seriesBlocks}}
+
+  {{axisBlocks}}
+
+  {{scenarioExtensions}}
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Render `{{seriesBlocks}}` using `chart._series._common.md`.
+- Render `{{axisBlocks}}` using `chart._axis._common.md`.

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

@@ -0,0 +1,36 @@
+---
+templateId: region.chart.donut
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+description: Donut-chart qualifier for chart regions.
+---
+
+# Purpose
+
+Donut-chart variant of the native chart region.
+
+# Generation Rules (MANDATORY)
+
+1. Load `chart._common.md` first.
+2. Set `chart.type` to `donut`.
+
+# Variable Contract
+
+## Required Variables
+
+- `chart.type`
+- `series.alias`
+
+# Output Template – Full
+
+```apexlang
+chart {
+  type: donut
+}
+```
+
+# Conditional Rendering Rules
+
+- Keep donut-center or legend treatment outside the shared shell unless the scenario requires it.

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

@@ -0,0 +1,50 @@
+---
+templateId: region.chart.gantt
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+  - chart._series._common.md
+description: Gantt chart scenario with variable-driven task and timeline contracts.
+---
+
+# Purpose
+
+Variable-driven gantt chart scenario with reusable series and scheduling placeholders.
+
+---
+
+# 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}}
+  }
+  chart {
+    type: {{chart.type}}
+    {{chart.options}}
+  }
+  legend {
+    {{legend}}
+  }
+
+  {{seriesBlocks}}
+
+  {{scenarioExtensions}}
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Render `{{seriesBlocks}}` using `chart._series._common.md`.
+- Omit axis blocks unless the chosen gantt configuration explicitly requires them.

package/skills/apexlang/templates/region-components/chart/chart.line-with-area.md

@@ -0,0 +1,57 @@
+---
+templateId: region.chart.line-with-area
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+  - chart._series._common.md
+  - chart._axis._common.md
+description: Line-with-area chart scenario with variable-driven axis and series contracts.
+---
+
+# Purpose
+
+Variable-driven mixed line/area chart scenario.
+
+---
+
+# 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 {
+    regionDisplaySelector: {{advanced.regionDisplaySelector}}
+  }
+  chart {
+    type: {{chart.type}}
+    {{chart.options}}
+  }
+  chartAppearance {
+    {{chartAppearance}}
+  }
+  legend {
+    {{legend}}
+  }
+
+  {{seriesBlocks}}
+
+  {{axisBlocks}}
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Render `{{seriesBlocks}}` using `chart._series._common.md`.
+- Render `{{axisBlocks}}` using `chart._axis._common.md`.

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

@@ -0,0 +1,80 @@
+---
+templateId: region.chart.line
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+  - chart._series._common.md
+  - chart._axis._common.md
+description: Line chart scenario with variable-driven style and axis contracts.
+---
+
+# Purpose
+
+Variable-driven line chart scenario for stepped/curved or other line configurations.
+
+---
+
+# Generation Rules (MANDATORY)
+
+1. Load `chart._common.md` first.
+2. Set `chart.type` to `line`.
+
+---
+
+# Variable Contract
+
+## Required Variables
+
+- `chart.type`
+- `series.alias`
+
+---
+
+# 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}}
+  }
+  settings {
+    zoomAndScroll: {{settings.zoomAndScroll}}
+  }
+  advanced {
+    htmlDomId: {{advanced.htmlDomId}}
+    regionDisplaySelector: {{advanced.regionDisplaySelector}}
+  }
+  chart {
+    type: {{chart.type}}
+    {{chart.options}}
+  }
+  chartLayout {
+    {{chartLayout}}
+  }
+  legend {
+    {{legend}}
+  }
+
+  {{seriesBlocks}}
+
+  {{axisBlocks}}
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Render `{{seriesBlocks}}` using `chart._series._common.md`.
+- Render `{{axisBlocks}}` using `chart._axis._common.md`.
+- Keep line-chart trend and axis details in the series or axes groups when required.
+- `settings.zoomAndScroll` is optional; use only when a chart needs Zoom and Scroll capabilities
+  - Valid values for `settings.zoomAndScroll` are: `live` (default), `liveScrollOnly`, `delayed` and  `delayedScrollOnly`

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

@@ -0,0 +1,72 @@
+---
+templateId: region.chart.pie
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+  - chart._series._common.md
+description: Pie or donut chart scenario with variable-driven series contracts.
+---
+
+# Purpose
+
+Variable-driven pie/donut chart scenario with optional threshold and selection options.
+
+---
+
+# Generation Rules (MANDATORY)
+
+1. Load `chart._common.md` first.
+2. Set `chart.type` to `pie`.
+
+---
+
+# Variable Contract
+
+## Required Variables
+
+- `chart.type`
+- `series.alias`
+
+---
+
+# 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}}
+  }
+  chart {
+    type: {{chart.type}}
+    pieSelectionEffect: {{chart.pieSelectionEffect}}
+    style: {{chart.style}}
+    otherThreshold: {{chart.otherThreshold}}
+  }
+  chartLayout {
+    {{chartLayout}}
+  }
+  legend {
+    {{legend}}
+  }
+
+  {{seriesBlocks}}
+
+  {{scenarioExtensions}}
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Render `{{seriesBlocks}}` using `chart._series._common.md`.
+- Omit pie-only options when using non-pie chart types.
+- Suppress axis guidance for pie charts.

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

@@ -0,0 +1,51 @@
+---
+templateId: region.chart.scatter
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+  - chart._series._common.md
+  - chart._axis._common.md
+description: Scatter chart scenario with variable-driven axis-range and series contracts.
+---
+
+# Purpose
+
+Variable-driven scatter chart scenario supporting dynamic axis ranges and submitted page items.
+
+---
+
+# 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}}
+  }
+  chart {
+    type: {{chart.type}}
+    {{chart.options}}
+  }
+  legend {
+    {{legend}}
+  }
+
+  {{seriesBlocks}}
+
+  {{axisBlocks}}
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Render `{{seriesBlocks}}` using `chart._series._common.md`.
+- Render `{{axisBlocks}}` using `chart._axis._common.md`.

package/skills/apexlang/templates/region-components/chart/chart.status-meter-gauge.md

@@ -0,0 +1,51 @@
+---
+templateId: region.chart.status-meter-gauge
+componentType: region
+version: 1.0
+imports:
+  - chart._common.md
+  - chart._series._common.md
+description: Status meter gauge scenario with variable-driven thresholds and source contracts.
+---
+
+# Purpose
+
+Variable-driven status meter gauge scenario for circular or horizontal gauge variants.
+
+---
+
+# 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}}
+  }
+  chart {
+    type: {{chart.type}}
+    orientation: {{chart.orientation}}
+    {{chart.options}}
+  }
+  gauge {
+    {{gauge}}
+  }
+
+  {{seriesBlocks}}
+
+  {{scenarioExtensions}}
+)
+```
+
+---
+
+# Conditional Rendering Rules
+
+- Render `{{seriesBlocks}}` using `chart._series._common.md`.
+- Omit `gauge` options when defaults are sufficient.