pi-apexlang 0.2.2 → 0.4.0

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

@@ -31,30 +31,32 @@ region {{regionStaticId}} (
   }
   card {
     primaryKeyColumn1: {{card.primaryKeyColumn1}}
+    primaryKeyColumn2: {{card.primaryKeyColumn2}}
+    cssClasses: {{card.cssClasses}}
   }
   title {
-    column: {{title.column}}
-    htmlExpression: {{title.htmlExpression}}
     advancedFormatting: {{title.advancedFormatting}}
+    {{title.valueProperty}}: {{title.value}}
   }
   subtitle {
-    column: {{subtitle.column}}
-    htmlExpression: {{subtitle.htmlExpression}}
     advancedFormatting: {{subtitle.advancedFormatting}}
+    {{subtitle.valueProperty}}: {{subtitle.value}}
   }
   body {
-    column: {{body.column}}
-    htmlExpression: {{body.htmlExpression}}
     advancedFormatting: {{body.advancedFormatting}}
+    {{body.valueProperty}}: {{body.value}}
   }
   secondaryBody {
-    column: {{secondaryBody.column}}
-    htmlExpression: {{secondaryBody.htmlExpression}}
     advancedFormatting: {{secondaryBody.advancedFormatting}}
+    {{secondaryBody.valueProperty}}: {{secondaryBody.value}}
   }
   media {
+    advancedFormatting: false
     source: {{media.source}}
     {{media.sourceValueProperty}}: {{media.sourceValue}}
+    position: {{media.position}}
+    sizing: {{media.sizing}}
+    imageDescription: {{media.imageDescription}}
   }
   blobAttributes {
     mimeTypeColumn: {{blobAttributes.mimeTypeColumn}}
@@ -62,8 +64,8 @@ region {{regionStaticId}} (
   }
   iconAndBadge {
     iconSource: {{iconAndBadge.iconSource}}
-    iconColumn: {{iconAndBadge.iconColumn}}
-    iconCssClasses: {{iconAndBadge.iconCssClasses}}
+    {{iconAndBadge.sourceValueProperty}}: {{iconAndBadge.sourceValue}}
+    iconPosition: {{iconAndBadge.iconPosition}}
     iconDescription: {{iconAndBadge.iconDescription}}
     badgeColumn: {{iconAndBadge.badgeColumn}}
     badgeLabel: {{iconAndBadge.badgeLabel}}
@@ -74,12 +76,14 @@ region {{regionStaticId}} (
     noDataFoundIcon: {{messages.noDataFoundIcon}}
   }
   componentAppearance {
+    layout: {{componentAppearance.layout}}
     gridColumns: {{componentAppearance.gridColumns}}
+    cssClasses: {{componentAppearance.cssClasses}}
   }
 )
 ```
 
-In the template above, `{{media.sourceValueProperty}}` / `{{media.sourceValue}}` is schematic. Emit exactly one concrete source-value property according to this mapping:
+The `valueProperty` placeholders are schematic. For title, subtitle, body, and secondary body, emit exactly one pair: `advancedFormatting: false` plus `column`, or `advancedFormatting: true` plus `htmlExpression`. For actions, append the native action shape from `cards._common.md`; button actions may add `appearance`, `advanced`, and `serverSideCondition`, while `behavior.type: triggerAction` requires a nested `triggerAction` child and omits navigation targets. For media, emit exactly one concrete source-value property according to this mapping:
 
 | media.source | Required value property |
 |--------------|-------------------------|
@@ -93,8 +97,11 @@ Use exactly one of these source-specific shapes when a Cards region needs media:
 
 ```apexlang
 media {
+    advancedFormatting: false
     source: blobColumn
     blobColumn: <BLOB_COLUMN_ALIAS>
+    position: first
+    sizing: cover
 }
 blobAttributes {
     mimeTypeColumn: <MIME_TYPE_COLUMN_ALIAS>
@@ -104,21 +111,27 @@ blobAttributes {
 
 ```apexlang
 media {
+    advancedFormatting: false
     source: urlColumn
     urlColumn: <URL_COLUMN_ALIAS>
+    position: first
+    sizing: cover
 }
 ```
 
 ```apexlang
 media {
+    advancedFormatting: false
     source: imageUrl
     url: <STATIC_IMAGE_URL_OR_COLUMN_SUBSTITUTION>
+    position: first
+    sizing: cover
 }
 ```
 
 ## 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.
+Every direct-source media block emits `advancedFormatting: false`, required `position`, and required `sizing`. Use `position: first` and `sizing: cover` as deterministic defaults; emit optional `appearance` only when requested.
 
 When a non-default presentation is required, add only the needed supported properties inside the same `media` block:
 
@@ -130,13 +143,17 @@ sizing: cover
 
 # Conditional Rendering Rules
 
-- If `title.column` is emitted, omit `title.htmlExpression` and omit `title.advancedFormatting`.
+- Every title, subtitle, body, secondary-body, primary-key, icon, media, badge, link, or conditional-style alias used by the region must be projected by `source.sqlQuery` and proven by schema/live/user-asserted object evidence.
+- Omit `card.cssClasses` unless conditional per-row styling is explicitly requested. When used, map a projected alias whose values are restricted to an active-build allowlist of semantic Universal Theme classes.
+- When refreshed SQL binds page items, emit every bind item in `source.pageItemsToSubmit` and target the region static ID with the native Refresh dynamic-action capability.
+
+- If `title.column` is emitted, set `title.advancedFormatting: false` and omit `title.htmlExpression`.
 - 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.column` is emitted, set `subtitle.advancedFormatting: false` and omit `subtitle.htmlExpression`.
 - 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.column` is emitted, set `body.advancedFormatting: false` and omit `body.htmlExpression`.
 - 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.column` is emitted, set `secondaryBody.advancedFormatting: false` and omit `secondaryBody.htmlExpression`.
 - 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`.
@@ -145,12 +162,11 @@ sizing: cover
 - 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.
+- Direct-source media always emits `advancedFormatting: false`, `position: first | body | background`, and `sizing: fit | cover`; default to `first` and `cover`. `appearance: square | widescreen` remains optional.
 - 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.
+- Emit `componentAppearance.layout: grid`, `float`, or `horizontal` from explicit layout intent. Emit `gridColumns` only with `layout: grid` and an explicit fixed card column count; otherwise omit it. Use `componentAppearance.cssClasses` only for a proven Cards-container class.
 - If emitted, `componentAppearance.gridColumns` must be one of `2`, `3`, `4`, or `5`.
+- If full-card and decision-button actions coexist, document interaction precedence and evidence-backed business conditions rather than inferring exclusivity.
+- Do not add filtering/search regions or filter orchestration in this Cards template. Route that composition to its owning Faceted Search or Smart Filters pattern.

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

@@ -36,7 +36,6 @@ Standardize reusable series contracts across all chart scenarios.
 - `series.label.*`
 - `series.marker.*`
 - `series.line.*`
-- `series.tooltip.*`
 - `series.advanced.*`
 
 ---
@@ -73,9 +72,6 @@ series {{series.staticId}} (
   label {
     {{series.label}}
   }
-  tooltip {
-    {{series.tooltip}}
-  }
   advanced {
     {{series.advanced}}
   }
@@ -90,3 +86,4 @@ series {{series.staticId}} (
 - 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.
+- Use `columnMapping.customTooltip`, `columnMapping.legendTooltip`, or `columnMapping.labelTooltip` for tooltip columns; do not emit a `series.tooltip` group.

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

@@ -46,9 +46,12 @@ region {{chartRegion.staticId}} (
   }
   chart {
     type: {{chart.type}}
+  }
+  settings {
     pieSelectionEffect: {{chart.pieSelectionEffect}}
-    style: {{chart.style}}
-    otherThreshold: {{chart.otherThreshold}}
+  }
+  value {
+    pieChartOtherThreshold: {{chart.otherThreshold}}
   }
   chartLayout {
     {{chartLayout}}
@@ -70,3 +73,4 @@ region {{chartRegion.staticId}} (
 - Render `{{seriesBlocks}}` using `chart._series._common.md`.
 - Omit pie-only options when using non-pie chart types.
 - Suppress axis guidance for pie charts.
+- Do not emit `chart.style`; the current grammar has no pie chart style property.

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

@@ -30,10 +30,10 @@ region {{chartRegion.staticId}} (
   }
   chart {
     type: {{chart.type}}
-    orientation: {{chart.orientation}}
     {{chart.options}}
   }
   gauge {
+    orientation: {{chart.orientation}}
     {{gauge}}
   }
 

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

@@ -31,6 +31,8 @@ region {{chartRegion.staticId}} (
   }
   chart {
     type: {{chart.type}}
+  }
+  settings {
     initialZooming: {{chart.initialZooming}}
     {{chart.options}}
   }

package/skills/apexlang/templates/region-components/chart/features/chart.feature-chart-links.md

@@ -13,7 +13,7 @@ description: Adds link targets to chart data points using SQL-generated URLs.
 # Usage
 
 1. Add a SQL column that returns the desired URL (e.g., `apex_page.get_url`).
-2. Map the column through `columnMapping.link`.
+2. Enable the series `link` block using `type: redirectUrlReturnedByFirstCol`.
 3. Ensure navigation targets respect security (checksums, authorization).
 
 # Example Snippet
@@ -26,11 +26,11 @@ series FEATURE_CHART_LINKS (
         type: sqlQuery
         sqlQuery:
             ```sql
-            select product_name,
-                   sum(quantity) total_quantity,
-                   apex_page.get_url(p_page => 10,
+            select apex_page.get_url(p_page => 10,
                                       p_items => 'P10_PRODUCT',
-                                      p_values => product_name) as detail_link
+                                      p_values => product_name) as detail_link,
+                   product_name,
+                   sum(quantity) total_quantity,
               from eba_demo_chart_orders
              group by product_name
             ```
@@ -39,7 +39,10 @@ series FEATURE_CHART_LINKS (
     columnMapping {
         label: PRODUCT_NAME
         value: TOTAL_QUANTITY
-        link: DETAIL_LINK
+    }
+
+    link {
+        type: redirectUrlReturnedByFirstCol
     }
 )
 ```
@@ -50,4 +53,3 @@ series FEATURE_CHART_LINKS (
 - Combine with region actions (refresh, modal launch) to keep navigation consistent with UX guidelines.
 
 # References
-

package/skills/apexlang/templates/region-components/faceted-search/faceted-search._common.md

@@ -30,11 +30,6 @@ Document the native faceted-search region shell and its filter child metadata bo
 | source.filteredRegion | yes | ref | Must reference results region id. |
 | layout.slot | optional | string | Default to `leftColumn` for the standard pattern. |
 | appearance.template | optional | string | Default to `@/standard`. |
-| compactNosThreshold setting | yes | number | Standard default is `10000`. |
-| showCurrentFacets setting | yes | boolean/string | Standard default is `true`; use `selector` only for explicit selector-mode requests. |
-| showTotalRowCount setting | yes | boolean | Standard default is `true`. |
-| displayChartForTopNValues setting | optional | positive integer | Opt-in only for explicit chart/top-N requests; common value is `10`. |
-| currentFacetsSelector setting | conditional | selector | Required only when `showCurrentFacets: selector` is emitted. |
 | facets | optional | array | Facet definitions and LOV/source metadata. |
 | searchFacet.enabled | optional | boolean | Enables free-text facet search. |
 
@@ -143,21 +138,13 @@ region {{regionStaticId}} (
     template: {{appearance.template}}
     templateOptions: #DEFAULT#
   }
-  settings {
-    compactNosThreshold: 10000
-    showCurrentFacets: true
-    showTotalRowCount: true
-  }
   {{facets}}
 )
 ```
 
 # Conditional Rendering Rules
 
-- Emit the standard three-property `settings` block by default: `compactNosThreshold: 10000`, `showCurrentFacets: true`, and `showTotalRowCount: true`.
-- Keep current-facets selector configuration in `settings`, but only for explicit selector-mode requests.
-- When selector mode is requested, emit both `showCurrentFacets: selector` and a concrete `currentFacetsSelector` value. Do not invent an external target unless the generated page also creates a clearly named target.
-- Emit `displayChartForTopNValues` only for explicit chart/top-N requests; use a positive integer such as `10`.
+- Do not emit faceted-search `settings` properties unless the grammar exposes them; the current region grammar does not allow the prior `compactNosThreshold`, `showCurrentFacets`, or `showTotalRowCount` properties.
 - Do not merge facet child definitions into the region shell description.
 - The standard page-level composition for this region family is breadcrumb in `breadcrumbBar`, results in `body`, and faceted search in `leftColumn`.
 - When the request calls for Product, Store, Status, or other discrete value filters, start from `selectList`, `checkboxGroup`, or `radioGroup` plus `lov { type: distinctValues }` instead of internal `NATIVE_*` token guessing.

package/skills/apexlang/templates/region-components/form/form._items._common.md

@@ -38,7 +38,6 @@ Standardize reusable form item blocks so scenario templates can render item defi
 - `item.label.*`
 - `item.layout.*`
 - `item.appearance.*`
-- `item.settings.*`
 - `item.validation.*`
 - `item.lov.*`
 - `item.security.*`
@@ -65,9 +64,6 @@ pageItem {{item.staticId}} (
     templateOptions: {{item.appearance.templateOptions}}
     width: {{item.appearance.width}}
   }
-  settings {
-    sendOnPageSubmit: {{item.settings.sendOnPageSubmit}}
-  }
   validation {
     valueRequired: {{item.validation.valueRequired}}
   }
@@ -93,7 +89,7 @@ pageItem {{item.staticId}} (
 
 - Omit optional blocks when values are not provided.
 - Do not emit `appearance.width` for item types whose schema forbids it; `displayOnly` supports only `appearance.template` and `appearance.templateOptions`.
-- For `displayOnly`, always emit `settings { sendOnPageSubmit: false }` by default.
+- Do not emit page-item `settings` blocks; the current grammar does not expose a pageItem settings group.
 - Keep each item mapped to exactly one form region via `item.region`.
 - For items rendered inside the main form region body, emit `layout.slot: regionBody` instead of `BODY`.
 - Every form region must have at least one source-mapped primary-key item; emit `primaryKey: true` on each PK item.

package/skills/apexlang/templates/region-components/interactive-report/interactive-report._columns._common.md

@@ -42,7 +42,6 @@ Standardize `column` variable contracts, output shape, and guardrails for all in
 | column.link.linkAttributes | optional | string | HTML attributes for the rendered link. |
 | column.comments | required by default | string | Descriptive metadata string for `comments { comments: ... }` on business-significant, derived, status, and action columns; include the required attributes `Display Label`, `Display in Report`, `Display in Form`, `Format Mask`, `Value Required`, `Read Only`, `Primary Display Column`, and `Authorization Scheme`, with optional leading `Summary`. |
 | column.genAI.columnContext | optional | string | NL2IR column context from column annotation `column_context`, else `ai_context`, else `description`, else column comment. |
-| column.advanced.columnAlias | optional | string | APEX alias for REST/NL2IR scenarios. |
 
 ---
 
@@ -71,7 +70,7 @@ column {{column.name}} (
   }
   lov {
     type: {{column.lov.type}}
-    listOfValues: @{{column.lov.sharedComponent}}
+    lov: @{{column.lov.sharedComponent}}
   }
   security {
     authorizationScheme: @{{column.security.authorizationScheme}}
@@ -93,9 +92,6 @@ column {{column.name}} (
   genAI {
     columnContext: {{column.genAI.columnContext}}
   }
-  advanced {
-    columnAlias: {{column.advanced.columnAlias}}
-  }
 )
 ```
 
@@ -115,7 +111,7 @@ column {{column.name}} (
 - Omit `link` unless column-level navigation is explicitly requested and target page/item mappings are known.
 - Omit `comments` only for hidden technical columns or when a documented exemption applies.
 - Omit `genAI` unless NL2IR context is required.
-- Omit `advanced` unless `column.advanced.colAlias` is provided.
+- Do not emit `advanced.columnAlias`; the current grammar does not allow that property for Interactive Report columns.
 
 ---
 

package/skills/apexlang/templates/region-components/interactive-report/interactive-report.page-header-actions.md

@@ -130,13 +130,6 @@ dynamicAction {{dynamicAction.staticId}} (
 
   action {{dynamicAction.action.staticId}} (
     action: {{dynamicAction.action.type}}
-    settings {
-      title: {{dynamicAction.action.title}}
-      message: {{dynamicAction.action.message}}
-      style: {{dynamicAction.action.style}}
-      icon: {{dynamicAction.action.icon}}
-      okLabel: {{dynamicAction.action.okLabel}}
-    }
     execution {
       sequence: {{dynamicAction.action.sequence}}
       event: @{{dynamicAction.staticId}}
@@ -152,3 +145,4 @@ dynamicAction {{dynamicAction.staticId}} (
 
 - Replace theme template references with valid aliases.
 - Remove button and dynamic action blocks when no custom action is required.
+- Do not emit a dynamic-action `action.settings` block; action-specific dialog text must wait for a grammar-backed property path.

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

@@ -7,7 +7,7 @@ Catalog of canonical list region templates for the `list` region family, includi
 - Load `list._index.md` first as the routing entrypoint.
 - Load `list._common.md` to align variable contracts, guardrails, and required inputs.
 - Choose a qualifier file matching the intended list template appearance (`cards` or `mediaList`).
-- For `mediaList`, align report-level attribute names and values with `../../template-components/media-list._template_options.md`, plus `../../template-components/avatar._template_options.md` and `../../template-components/badge._template_options.md` for shared substructures.
+- For `mediaList`, align report-level attribute names and values with `../../template-components/media-list/media-list._template_options.md`, plus `../../template-components/avatar/avatar._template_options.md` and `../../template-components/badge/badge._template_options.md` for shared substructures.
 - Preserve canonical path references and markdown-first conventions when updating workflow or registry links.
 
 ## Template Catalog

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

@@ -14,7 +14,7 @@ Document the native list region shell and qualifier-dependent list-template appe
 1. Use the dedicated `region-list` template.
 2. Treat the qualifier as mandatory design intent: `cards` or `mediaList`.
 3. Keep the list shared-component reference in the source block.
-4. When the qualifier is `mediaList`, align the report-level appearance values with `../../template-components/media-list._template_options.md`, plus the shared `../../template-components/avatar._template_options.md` and `../../template-components/badge._template_options.md` owner files.
+4. When the qualifier is `mediaList`, align the report-level appearance values with `../../template-components/media-list/media-list._template_options.md`, plus the shared `../../template-components/avatar/avatar._template_options.md` and `../../template-components/badge/badge._template_options.md` owner files.
 
 # Variable Contract
 

package/skills/apexlang/templates/region-components/map/map.backgrounds.md

@@ -20,9 +20,9 @@ Document the `mapBackground` shared component family: raster XYZ tile layers, ve
 | `type` | yes | enum | `raster`, `vector`, or OGC WMS. |
 | `url` | yes | string | Background URL. |
 | `attribution` | conditional | text | Used for raster and OGC WMS backgrounds. |
-| `apiKeyType` | optional | enum | none, static value, or web credential. |
-| `apiKey` | conditional | string | Static API-key value. |
-| `apiKeyCredential` | conditional | credential ref | URL Query String Web Credential. |
+| `apiKey.type` | optional | enum | `staticValue` or `webCredential`. |
+| `apiKey.staticValue` | conditional | string | Static API-key value. |
+| `apiKey.webCredential` | conditional | credential ref | URL Query String Web Credential. |
 | `httpHeaders` | optional | text | Key-value pairs, one per line. |
 | `minZoomLevel` / `maxZoomLevel` | optional | number | Background zoom limits. |
 | subscription fields | optional | subscription | Shared-component subscription metadata. |
@@ -34,16 +34,18 @@ Document the `mapBackground` shared component family: raster XYZ tile layers, ve
 ```apexlang
 mapBackground {{staticId}} (
   name: {{name}}
-  staticId: {{staticId}}
   type: {{type}}
   url: {{url}}
   attribution: {{attribution}}
-  apiKeyType: {{apiKeyType}}
-  apiKey: {{apiKey}}
-  apiKeyCredential: {{apiKeyCredential}}
+  apiKey: {{apiKey.type}}
+  staticValue: {{apiKey.staticValue}}
+  webCredential: @{{apiKey.webCredential}}
   httpHeaders: {{httpHeaders}}
-  minZoomLevel: {{minZoomLevel}}
-  maxZoomLevel: {{maxZoomLevel}}
+  advanced {
+    staticId: {{staticId}}
+    minZoomLevel: {{minZoomLevel}}
+    maxZoomLevel: {{maxZoomLevel}}
+  }
 )
 ```
 
@@ -64,7 +66,7 @@ Use shared backgrounds from a map region when `tileLayerType` selects the shared
 - OGC WMS
   - Provide the URL with the required WMS parameters except `BBOX`, `WIDTH`, `HEIGHT`, `REQUEST`, `FORMAT`, and `SRS/CRS`; the map region adds those automatically.
 - `attribution` only applies to raster and OGC WMS backgrounds in the current seed metadata.
-- `apiKeyType: webCredential`
+- `apiKey: webCredential`
   - The credential must be a URL Query String Web Credential.
 - Background vector-tile usage is still subject to the application-scoped native plugin setting `useVectorTileLayers`.
 

package/skills/apexlang/templates/region-components/map/map.layer.extruded-polygons.md

@@ -24,15 +24,15 @@ Document 3D polygon-layer behavior for Maps: extruded polygon geometry, height-b
 - `layer.layout.sequence`
 - `layer.source.tableName`
 - `layer.columnMapping.geometryColumnDataType`
-- `layer.feature3dValueColumn`
-- `layer.feature3dValueUnit`
+- `layer.appearance.extrusionValueColumn`
+- `layer.appearance.unit`
 
 ## Optional Variables
 
-- `layer.featureFillColor`
-- `layer.featureFillOpacity`
-- `layer.featureStrokeColor`
-- `layer.featureStrokeWidth`
+- `layer.appearance.fillColor`
+- `layer.appearance.fillOpacity`
+- `layer.appearance.strokeColor`
+- `layer.appearance.strokeWidth`
 
 ---
 
@@ -57,10 +57,14 @@ layer {{layer.staticId}} (
     geometryColumn: {{layer.columnMapping.geometryColumn}}
     primaryKeyColumn: {{layer.columnMapping.primaryKeyColumn}}
   }
-  feature3dValueColumn: {{layer.feature3dValueColumn}}
-  feature3dValueUnit: {{layer.feature3dValueUnit}}
-  featureFillColor: {{layer.featureFillColor}}
-  featureFillOpacity: {{layer.featureFillOpacity}}
+  appearance {
+    extrusionValueColumn: {{layer.appearance.extrusionValueColumn}}
+    unit: {{layer.appearance.unit}}
+    fillColor: {{layer.appearance.fillColor}}
+    fillOpacity: {{layer.appearance.fillOpacity}}
+    strokeColor: {{layer.appearance.strokeColor}}
+    strokeWidth: {{layer.appearance.strokeWidth}}
+  }
 )
 ```
 
@@ -68,7 +72,7 @@ layer {{layer.staticId}} (
 
 # Guardrails
 
-- `feature3dValueColumn` is required for `POLYGON_3D`.
-- `feature3dValueUnit` becomes required once the extrusion value column is set.
+- `appearance.extrusionValueColumn` is required for extruded polygons.
+- `appearance.unit` becomes required once the extrusion value column is set.
 - Use polygon geometry for the layer source; extrusion metadata is not a substitute for valid polygon geometry.
 - Extruded polygons share the same fill-color-spectrum rules as normal polygon layers.

package/skills/apexlang/templates/region-components/map/map.layer.heat-map.md

@@ -27,10 +27,10 @@ Document heat-map behavior for Maps: point-density rendering, heat-map color sch
 
 ## Optional Variables
 
-- `layer.featureHeatmapValueColumn`
-- `layer.layerHeatmapSpectrumType`
+- `layer.appearance.valueColumn`
+- `layer.appearance.colorScheme`
 - `layer.layerHeatmap*Name`
-- `layer.layerHeatmapCustomSpectrum`
+- `layer.appearance.customColorList`
 
 ---
 
@@ -57,9 +57,12 @@ layer {{layer.staticId}} (
     latitudeColumn: {{layer.columnMapping.latitudeColumn}}
     primaryKeyColumn: {{layer.columnMapping.primaryKeyColumn}}
   }
-  featureHeatmapValueColumn: {{layer.featureHeatmapValueColumn}}
-  layerHeatmapSpectrumType: {{layer.layerHeatmapSpectrumType}}
-  layerHeatmapCustomSpectrum: {{layer.layerHeatmapCustomSpectrum}}
+  appearance {
+    valueColumn: {{layer.appearance.valueColumn}}
+    colorScheme: {{layer.appearance.colorScheme}}
+    schemeName: {{layer.appearance.schemeName}}
+    customColorList: {{layer.appearance.customColorList}}
+  }
 )
 ```
 
@@ -69,5 +72,5 @@ layer {{layer.staticId}} (
 
 - Heat maps are point-only in practice. If the source uses `sdoGeometry` or `geojson`, it must still return point objects.
 - Heat-map layers do not expose the normal tooltip, link-target, or info-window metadata paths.
-- `featureHeatmapValueColumn` is optional. Without it, the widget derives color intensity from point density alone.
+- `appearance.valueColumn` is optional. Without it, the widget derives color intensity from point density alone.
 - Use high-contrast color ramps and avoid problematic red-green-only schemes.

package/skills/apexlang/templates/region-components/map/map.layer.lines.md

@@ -27,10 +27,10 @@ Document line-layer behavior for Maps: line geometry mapping, stroke styling, co
 
 ## Optional Variables
 
-- `layer.featureStrokeColor`
-- `layer.featureStrokeWidth`
-- `layer.featureStrokeStyle`
-- `layer.featureFillColorValueColumn`
+- `layer.appearance.strokeColor`
+- `layer.appearance.strokeWidth`
+- `layer.appearance.strokeStyle`
+- `layer.appearance.colorValueColumn`
 
 ---
 
@@ -55,10 +55,12 @@ layer {{layer.staticId}} (
     geometryColumn: {{layer.columnMapping.geometryColumn}}
     primaryKeyColumn: {{layer.columnMapping.primaryKeyColumn}}
   }
-  featureStrokeColor: {{layer.featureStrokeColor}}
-  featureStrokeWidth: {{layer.featureStrokeWidth}}
-  featureStrokeStyle: {{layer.featureStrokeStyle}}
-  featureFillColorValueColumn: {{layer.featureFillColorValueColumn}}
+  appearance {
+    strokeColor: {{layer.appearance.strokeColor}}
+    strokeWidth: {{layer.appearance.strokeWidth}}
+    strokeStyle: {{layer.appearance.strokeStyle}}
+    colorValueColumn: {{layer.appearance.colorValueColumn}}
+  }
 )
 ```
 

package/skills/apexlang/templates/region-components/map/map.layer.polygons.md

@@ -27,16 +27,16 @@ Document 2D polygon-layer behavior for Maps: polygon geometry, static fill and s
 
 ## Optional Variables
 
-- `layer.featureFillColorIsSpectrum`
-- `layer.layerColorSpectrumType`
+- `layer.appearance.useColorScheme`
+- `layer.appearance.colorScheme`
 - `layer.layerColorSpectrum*Name`
 - `layer.featureFillColorSpectrum`
-- `layer.featureFillColorValueColumn`
-- `layer.featureFillColor`
-- `layer.featureFillOpacity`
-- `layer.featureStrokeColor`
-- `layer.featureStrokeWidth`
-- `layer.featureStrokeStyle`
+- `layer.appearance.colorValueColumn`
+- `layer.appearance.fillColor`
+- `layer.appearance.fillOpacity`
+- `layer.appearance.strokeColor`
+- `layer.appearance.strokeWidth`
+- `layer.appearance.strokeStyle`
 - `layer.mapFeatureLegendAdvFormatting`
 - `layer.mapFeatureLegendHtmlExpr`
 
@@ -63,14 +63,17 @@ layer {{layer.staticId}} (
     geometryColumn: {{layer.columnMapping.geometryColumn}}
     primaryKeyColumn: {{layer.columnMapping.primaryKeyColumn}}
   }
-  featureFillColorIsSpectrum: {{layer.featureFillColorIsSpectrum}}
-  layerColorSpectrumType: {{layer.layerColorSpectrumType}}
-  featureFillColorValueColumn: {{layer.featureFillColorValueColumn}}
-  featureFillColor: {{layer.featureFillColor}}
-  featureFillOpacity: {{layer.featureFillOpacity}}
-  featureStrokeColor: {{layer.featureStrokeColor}}
-  featureStrokeWidth: {{layer.featureStrokeWidth}}
-  featureStrokeStyle: {{layer.featureStrokeStyle}}
+  appearance {
+    useColorScheme: {{layer.appearance.useColorScheme}}
+    colorScheme: {{layer.appearance.colorScheme}}
+    schemeName: {{layer.appearance.schemeName}}
+    colorValueColumn: {{layer.appearance.colorValueColumn}}
+    fillColor: {{layer.appearance.fillColor}}
+    fillOpacity: {{layer.appearance.fillOpacity}}
+    strokeColor: {{layer.appearance.strokeColor}}
+    strokeWidth: {{layer.appearance.strokeWidth}}
+    strokeStyle: {{layer.appearance.strokeStyle}}
+  }
 )
 ```
 
@@ -78,6 +81,6 @@ layer {{layer.staticId}} (
 
 # Guardrails
 
-- Spectrum-driven fill on polygons requires a numeric `featureFillColorValueColumn`.
-- When spectrum mode is off, the layer falls back to static `featureFillColor`.
+- Spectrum-driven fill on polygons requires a numeric `appearance.colorValueColumn`.
+- When spectrum mode is off, the layer falls back to static `appearance.fillColor`.
 - Keep contrast between polygon fill, stroke, and the underlying basemap high enough for clear differentiation.