pi-apexlang 0.2.2 → 0.4.0

package/skills/apexlang/templates/page-examples/task-definition-task-details/task-definition-task-details.example.md

@@ -38,7 +38,7 @@ page 10 (
         resizable: false
     }
     javaScript {
-        functionAndGlobalVarDeclaration:
+        functionAndGlobalVariableDeclaration:
             ```javascript-browser
             apex.jQuery(() => {
                 apex.jQuery("a.taskActionMenu").each((index, item) => {
@@ -97,9 +97,6 @@ page 10 (
                     p_operation => apex_human_task.c_task_op_add_comment )
                 ```
         }
-        settings {
-            outputAs: text
-        }
     )
 
     region buttons (
@@ -121,9 +118,6 @@ page 10 (
         advanced {
             regionDisplaySelector: true
         }
-        settings {
-            outputAs: text
-        }
     )
 
     region cancel-task (
@@ -214,12 +208,17 @@ page 10 (
         componentAppearance {
             display: report
         }
-        settings {
-            commentText: COMMENT_TEXT
-            userName: USER_NAME
-            date: COMMENT_DATE
-            style: chatSpeechBubbles
-            applyThemeColors: false
+        title {
+            advancedFormatting: false
+            column: USER_NAME
+        }
+        body {
+            advancedFormatting: false
+            column: COMMENT_TEXT
+        }
+        subtitle {
+            advancedFormatting: false
+            column: COMMENT_DATE
         }
         plugin-avatar {
             avatarType: initials
@@ -326,9 +325,6 @@ page 10 (
                     p_operation => apex_human_task.c_task_op_delegate )
                 ```
         }
-        settings {
-            outputAs: text
-        }
     )
 
     region details (
@@ -378,9 +374,13 @@ page 10 (
         componentAppearance {
             display: report
         }
-        settings {
-            overline: &PARAM_LABEL.
-            title: &PARAM_VALUE.
+        title {
+            advancedFormatting: false
+            column: PARAM_VALUE
+        }
+        subtitle {
+            advancedFormatting: false
+            column: PARAM_LABEL
         }
         plugin-appearance {
             applyThemeColors: false
@@ -555,9 +555,6 @@ page 10 (
                     p_operation => apex_human_task.c_task_op_set_due_date )
                 ```
         }
-        settings {
-            outputAs: text
-        }
     )
 
     region edit-parameter (
@@ -583,9 +580,6 @@ page 10 (
             type: expression
             plsqlExpression: :P10_CAN_UPDATE_PARAMS = 'Y'
         }
-        settings {
-            outputAs: text
-        }
     )
 
     region history (
@@ -629,12 +623,17 @@ page 10 (
         componentAppearance {
             display: report
         }
-        settings {
-            commentText: DISPLAY_MSG
-            userName: EVENT_CREATOR
-            date: EVENT_TIMESTAMP
-            displayAvatar: false
-            applyThemeColors: false
+        title {
+            advancedFormatting: false
+            column: EVENT_CREATOR
+        }
+        body {
+            advancedFormatting: false
+            column: DISPLAY_MSG
+        }
+        subtitle {
+            advancedFormatting: false
+            column: EVENT_TIMESTAMP
         }
 
         column DISPLAY_MSG (
@@ -709,9 +708,6 @@ page 10 (
                     p_operation => apex_human_task.c_task_op_add_owner )
                 ```
         }
-        settings {
-            outputAs: text
-        }
     )
 
     region priority (
@@ -745,9 +741,6 @@ page 10 (
                     p_operation => apex_human_task.c_task_op_set_priority )
                 ```
         }
-        settings {
-            outputAs: text
-        }
     )
 
     region remove-participant (
@@ -781,9 +774,6 @@ page 10 (
                     p_operation => apex_human_task.c_task_op_remove_owner )
                 ```
         }
-        settings {
-            outputAs: text
-        }
     )
 
     region request-information (
@@ -817,9 +807,6 @@ page 10 (
                     p_operation => apex_human_task.c_task_op_request_info )
                 ```
         }
-        settings {
-            outputAs: text
-        }
     )
 
     region subject (
@@ -877,9 +864,12 @@ page 10 (
         componentAppearance {
             display: partial
         }
-        settings {
+        title {
             title: &SUBJECT.
-            description:
+        }
+        subtitle {
+            advancedFormatting: true
+            htmlExpression:
                 ```html
                 <strong>&TASK_DEF_NAME!HTML.</strong>
                 {if INITIATOR/}
@@ -928,9 +918,9 @@ page 10 (
                     &OUTCOME.
                 {endif/}
                 ```
-            displayBadge: true
         }
         plugin-badge {
+            displayBadge: true
             label: State
             value: BADGE_TEXT
             state: BADGE_STATE
@@ -1404,9 +1394,6 @@ page 10 (
                     p_operation => apex_human_task.c_task_op_submit_info )
                 ```
         }
-        settings {
-            outputAs: text
-        }
     )
 
     pageItem P10_ALL_COMMENTS (
@@ -1415,11 +1402,6 @@ page 10 (
             label: Include comments from expired tasks
             alignment: left
         }
-        settings {
-            useDefaults: false
-            checkedValue: Y
-            uncheckedValue: N
-        }
         layout {
             sequence: 20
             region: @comments
@@ -1456,11 +1438,6 @@ page 10 (
             label: Include history from expired tasks
             alignment: left
         }
-        settings {
-            useDefaults: false
-            checkedValue: Y
-            uncheckedValue: N
-        }
         layout {
             sequence: 10
             region: @history
@@ -1512,9 +1489,6 @@ page 10 (
             label: Comment
             alignment: left
         }
-        settings {
-            autoHeight: true
-        }
         layout {
             sequence: 10
             region: @add-comment
@@ -1541,9 +1515,6 @@ page 10 (
 
     pageItem P10_IS_REQUIRED (
         type: hidden
-        settings {
-            valueProtected: false
-        }
         layout {
             sequence: 50
             region: @edit-parameter
@@ -1556,6 +1527,7 @@ page 10 (
             storage: request
         }
         security {
+            sessionStateProtection: unrestricted
             encryptSessionState: false
         }
     )
@@ -1566,10 +1538,6 @@ page 10 (
             label: New Due Date
             alignment: left
         }
-        settings {
-            showTime: true
-            displayAs: inline
-        }
         layout {
             sequence: 10
             region: @due
@@ -1736,9 +1704,6 @@ page 10 (
             label: Parameter
             alignment: left
         }
-        settings {
-            sendOnPageSubmit: false
-        }
         layout {
             sequence: 20
             region: @edit-parameter
@@ -1762,9 +1727,6 @@ page 10 (
 
     pageItem P10_PARAM_STATIC_ID (
         type: hidden
-        settings {
-            valueProtected: false
-        }
         layout {
             sequence: 10
             region: @edit-parameter
@@ -1777,6 +1739,7 @@ page 10 (
             storage: request
         }
         security {
+            sessionStateProtection: unrestricted
             encryptSessionState: false
         }
     )
@@ -1787,9 +1750,6 @@ page 10 (
             label: Current Value
             alignment: left
         }
-        settings {
-            sendOnPageSubmit: false
-        }
         layout {
             sequence: 30
             region: @edit-parameter
@@ -1852,9 +1812,6 @@ page 10 (
             label: Message
             alignment: left
         }
-        settings {
-            autoHeight: true
-        }
         layout {
             sequence: 10
             region: @request-information
@@ -1885,9 +1842,6 @@ page 10 (
             label: Message
             alignment: left
         }
-        settings {
-            autoHeight: true
-        }
         layout {
             sequence: 10
             region: @submit-information
@@ -2721,11 +2675,6 @@ page 10 (
 
         action native-set-value (
             action: setValue
-            settings {
-                type: javaScriptExpression
-                javaScriptExpression: apex.jQuery(this.triggeringElement).attr("data-id")
-                suppressChangeEvent: true
-            }
             affectedElements {
                 selectionType: items
                 items: P10_PARAM_STATIC_ID
@@ -2739,11 +2688,6 @@ page 10 (
 
         action native-set-value-2 (
             action: setValue
-            settings {
-                type: javaScriptExpression
-                javaScriptExpression: apex.jQuery(this.triggeringElement).attr("data-label")
-                suppressChangeEvent: true
-            }
             affectedElements {
                 selectionType: items
                 items: P10_PARAM_LABEL
@@ -2757,11 +2701,6 @@ page 10 (
 
         action native-set-value-3 (
             action: setValue
-            settings {
-                type: javaScriptExpression
-                javaScriptExpression: apex.jQuery(this.triggeringElement).attr("data-value")
-                suppressChangeEvent: true
-            }
             affectedElements {
                 selectionType: items
                 items: [
@@ -2778,11 +2717,6 @@ page 10 (
 
         action native-set-value-4 (
             action: setValue
-            settings {
-                type: javaScriptExpression
-                javaScriptExpression: apex.jQuery(this.triggeringElement).attr("data-required")
-                suppressChangeEvent: true
-            }
             affectedElements {
                 selectionType: items
                 items: P10_IS_REQUIRED
@@ -2870,13 +2804,6 @@ page 10 (
     process add-comment (
         name: Add Comment
         type: humanTaskManage
-        action {
-            type: comment
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-            commentText: &P10_COMMENT_TEXT.
-        }
         execution {
             sequence: 150
         }
@@ -2897,12 +2824,6 @@ page 10 (
     process cancel-task (
         name: Cancel Task
         type: humanTaskManage
-        action {
-            type: cancel
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-        }
         execution {
             sequence: 130
         }
@@ -2923,13 +2844,6 @@ page 10 (
     process change-due-date (
         name: Change Due Date
         type: humanTaskManage
-        action {
-            type: setDueDate
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-            dueDateItem: P10_NEW_DUE_DATE
-        }
         execution {
             sequence: 80
         }
@@ -2950,13 +2864,6 @@ page 10 (
     process change-priority (
         name: Change Priority
         type: humanTaskManage
-        action {
-            type: setPriority
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-            priorityItem: P10_NEW_PRIORITY
-        }
         execution {
             sequence: 70
         }
@@ -2977,12 +2884,6 @@ page 10 (
     process claim (
         name: Claim
         type: humanTaskManage
-        action {
-            type: claim
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-        }
         execution {
             sequence: 20
         }
@@ -3015,12 +2916,6 @@ page 10 (
     process complete (
         name: Complete
         type: humanTaskManage
-        action {
-            type: completeWithoutOutcome
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-        }
         execution {
             sequence: 30
         }
@@ -3041,13 +2936,6 @@ page 10 (
     process delegate (
         name: Delegate
         type: humanTaskManage
-        action {
-            type: delegate
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-            toUserItem: P10_NEW_OWNER
-        }
         execution {
             sequence: 60
         }
@@ -3068,13 +2956,6 @@ page 10 (
     process invite-participant (
         name: Invite Participant
         type: humanTaskManage
-        action {
-            type: inviteParticipant
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-            toUserItem: P10_NEW_POTENTIAL_OWNER
-        }
         execution {
             sequence: 110
         }
@@ -3095,12 +2976,6 @@ page 10 (
     process release (
         name: Release
         type: humanTaskManage
-        action {
-            type: release
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-        }
         execution {
             sequence: 50
         }
@@ -3122,13 +2997,6 @@ page 10 (
     process remove-participant (
         name: Remove Participant
         type: humanTaskManage
-        action {
-            type: removeParticipant
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-            toUserItem: P10_POTENTIAL_OWNER
-        }
         execution {
             sequence: 120
         }
@@ -3149,15 +3017,6 @@ page 10 (
     process renew-task (
         name: Renew Task
         type: humanTaskManage
-        action {
-            type: renew
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-        }
-        renew {
-            renewedTaskIdItem: P10_TASK_ID
-        }
         execution {
             sequence: 10
         }
@@ -3179,13 +3038,6 @@ page 10 (
     process request-information (
         name: Request Information
         type: humanTaskManage
-        action {
-            type: requestInfo
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-            commentText: &P10_REQUEST_INFO_TEXT.
-        }
         execution {
             sequence: 90
         }
@@ -3206,13 +3058,6 @@ page 10 (
     process submit-information (
         name: Submit Information
         type: humanTaskManage
-        action {
-            type: submitInfo
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-            commentText: &P10_SUBMIT_INFO_TEXT.
-        }
         execution {
             sequence: 100
         }
@@ -3233,14 +3078,6 @@ page 10 (
     process update-parameter (
         name: Update Parameter
         type: humanTaskManage
-        action {
-            type: updateParam
-        }
-        humanTask {
-            taskIdItem: P10_TASK_ID
-            paramItem: P10_PARAM_STATIC_ID
-            newValueItem: P10_NEW_VALUE
-        }
         execution {
             sequence: 140
         }

package/skills/apexlang/templates/region-components/calendar/calendar.custom-styling.md

@@ -96,7 +96,9 @@ region {{regionStaticIdIcons}} (
 
 # Output Template – Custom CSS Variant
 
-```apexlang
+Note: This custom CSS snippet is illustrative; the current grammar-backed emitted calendar contract does not expose a region-level `css {}` block.
+
+```text
 region {{regionStaticIdCss}} (
   name: {{name}} Custom Styling
   type: calendar

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

@@ -78,7 +78,6 @@ region {{regionStaticId}} (
     startDateColumn: START_DATE
     endDateColumn: END_DATE
     pkColumn: ID
-    multipleLineEvents: false
     additionalCalendarViews: [
       list
       navigation
@@ -113,7 +112,9 @@ region {{regionStaticId}} (
 
 # Faceted Search Companion
 
-```apexlang
+Note: This companion faceted-search snippet is illustrative until its settings surface is compiler-provenanced for emitted template use.
+
+```text
 region {{facetRegionId}} (
   name: {{facetName}}
   type: facetedSearch

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

@@ -7,19 +7,27 @@ Canonical guidance for the `cards` region family, including shared contract load
 - Load `cards._common.md` first to align variable contracts, guardrails, and required inputs.
 - Load `cards._template_options.md` when the request changes region `appearance.templateOptions`.
 - Choose a scenario variant matching the requested interaction pattern, data source type, and page composition context.
-- When cards need row navigation, model it with native card `action` blocks using `label` plus declarative `behavior.target`; do not emit `position` on native Cards actions.
-- Use the optional `componentAppearance.gridColumns` control only when the design needs a fixed 2-5 column cards grid; otherwise omit it to keep the default automatic layout.
+- For people, product, status, or entity summaries, select the `visual-summary-cards` structured pattern and freeze its source-to-attribute mapping before loading a scenario template.
+- When cards need row navigation, model it with native `action` blocks using required `action.type`, `layout.sequence`, `behavior.type`, and the matching target property. Only button actions emit required `label` and `layout.position`.
+- Emit `componentAppearance.layout: grid`, `float`, or `horizontal` from explicit layout intent; add `gridColumns` only for `grid` and an explicit fixed 2-5 column Cards grid. Use `componentAppearance.cssClasses` only for a proven container class requirement.
 - When cards need images or thumbnails, use the native cards `media` block for this runtime. Use `media.source: blobColumn` with `media.blobColumn` for BLOB-backed images, or `media.source: urlColumn` with `media.urlColumn` when the source already projects a usable image URL column.
-- When the source provides image description text, map it to `media.accessibleDescription`.
+- When the source provides image description text, map it to `media.imageDescription`.
 - Prefer the native `iconAndBadge.badgeColumn` cards contract whenever the design asks for a badge; only fall back to badge HTML inside title/subtitle/body blocks when a confirmed runtime limitation requires it.
-- When cards `title`, `subtitle`, `body`, or `secondaryBody` use `htmlExpression`, emit `advancedFormatting: true` on that same block.
+- Every emitted `title`, `subtitle`, `body`, or `secondaryBody` block requires `advancedFormatting`: use `false` with `column` and `true` with `htmlExpression`.
 - Inside cards `title.htmlExpression`, `subtitle.htmlExpression`, `body.htmlExpression`, and `secondaryBody.htmlExpression`, use `&COLUMN.` substitution strings rather than `#COLUMN#`; prefer escaped forms such as `&COLUMN!HTML.` for text content.
 - Preserve canonical path references and markdown-first conventions when updating workflow or registry links.
+- For row-dependent conditional styling, project an allowlisted semantic class alias and map it through compiler-confirmed `card.cssClasses`; retain the status in a native badge or text role.
+- Cards actions support native button presentation (`appearance.displayType`, `icon`, `hot`, and `cssClasses`), an `advanced.staticId`, a `serverSideCondition`, and a nested `triggerAction` child when `behavior.type: triggerAction`. Redirect actions require their matching target; `triggerAction` omits both navigation target properties.
+- If a region combines a full-card action with a decision button, define the intended interaction precedence and any business conditions in the UX contract. Do not claim the actions are mutually exclusive unless that condition is evidenced.
+- For dynamic refresh, identify the trigger and Cards static ID, then load `cards.refresh-on-change.md` or `cards.refresh-after-dialog.md`. Include bound page items in the Cards `source.pageItemsToSubmit`.
+- Filtering and search orchestration are outside the visual-summary Cards pattern. Route combined requests to the Faceted Search or Smart Filters owner and use Cards only as its results region.
 
 ## Template Catalog
 - `cards._common.md`
 - `cards._template_options.md`
 - `cards.rest-source.md`
+- `cards.refresh-on-change.md`
+- `cards.refresh-after-dialog.md`
 - `cards.standard.md`
 
 ## Maintenance