@almadar/std 16.28.3 → 16.28.4

package/dist/behaviors/registry/core/atoms/std-step-flow.orb

@@ -21,16 +21,6 @@
             "items": {
               "type": "object",
               "properties": {
-                "isPending": {
-                  "name": "isPending",
-                  "type": "boolean",
-                  "required": false
-                },
-                "labelColor": {
-                  "name": "labelColor",
-                  "type": "string",
-                  "required": false
-                },
                 "title": {
                   "name": "title",
                   "type": "string",
@@ -41,8 +31,8 @@
                   "type": "string",
                   "required": true
                 },
-                "key": {
-                  "name": "key",
+                "label": {
+                  "name": "label",
                   "type": "string",
                   "required": false
                 },
@@ -51,18 +41,28 @@
                   "type": "string",
                   "required": false
                 },
+                "labelColor": {
+                  "name": "labelColor",
+                  "type": "string",
+                  "required": false
+                },
                 "indexLabel": {
                   "name": "indexLabel",
                   "type": "string",
                   "required": false
                 },
+                "isPending": {
+                  "name": "isPending",
+                  "type": "boolean",
+                  "required": false
+                },
                 "badgeVariant": {
                   "name": "badgeVariant",
                   "type": "string",
                   "required": false
                 },
-                "label": {
-                  "name": "label",
+                "key": {
+                  "name": "key",
                   "type": "string",
                   "required": false
                 },
@@ -468,8 +468,8 @@
                     "StepFlowView",
                     {
                       "emit": {
-                        "failure": "StepItemsLoadFailed",
-                        "success": "StepItemsLoaded"
+                        "success": "StepItemsLoaded",
+                        "failure": "StepItemsLoadFailed"
                       }
                     }
                   ],
@@ -524,41 +524,6 @@
                         "fn",
                         "step",
                         {
-                          "isPending": [
-                            ">",
-                            "@index",
-                            "@entity.currentStepIndex"
-                          ],
-                          "label": [
-                            "object/get",
-                            "@step",
-                            "label"
-                          ],
-                          "title": [
-                            "object/get",
-                            "@step",
-                            "label"
-                          ],
-                          "icon": [
-                            "object/get",
-                            "@step",
-                            "icon",
-                            "circle"
-                          ],
-                          "indexLabel": [
-                            "str/concat",
-                            "",
-                            [
-                              "+",
-                              "@index",
-                              1.0
-                            ]
-                          ],
-                          "key": [
-                            "object/get",
-                            "@step",
-                            "key"
-                          ],
                           "badgeVariant": [
                             "if",
                             [
@@ -578,10 +543,19 @@
                               "neutral"
                             ]
                           ],
-                          "id": [
+                          "label": [
                             "object/get",
                             "@step",
-                            "key"
+                            "label"
+                          ],
+                          "indexLabel": [
+                            "str/concat",
+                            "",
+                            [
+                              "+",
+                              "@index",
+                              1.0
+                            ]
                           ],
                           "description": [
                             "object/get",
@@ -589,6 +563,21 @@
                             "description",
                             ""
                           ],
+                          "id": [
+                            "object/get",
+                            "@step",
+                            "key"
+                          ],
+                          "isPending": [
+                            ">",
+                            "@index",
+                            "@entity.currentStepIndex"
+                          ],
+                          "key": [
+                            "object/get",
+                            "@step",
+                            "key"
+                          ],
                           "labelColor": [
                             "if",
                             [
@@ -598,6 +587,17 @@
                             ],
                             "default",
                             "muted"
+                          ],
+                          "title": [
+                            "object/get",
+                            "@step",
+                            "label"
+                          ],
+                          "icon": [
+                            "object/get",
+                            "@step",
+                            "icon",
+                            "circle"
                           ]
                         }
                       ]
@@ -733,9 +733,9 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "error-state",
+                      "message": "@entity.errorMessage",
                       "title": "Failed to load",
-                      "message": "@entity.errorMessage"
+                      "type": "error-state"
                     }
                   ]
                 ]
@@ -949,37 +949,6 @@
                             "@step",
                             "key"
                           ],
-                          "icon": [
-                            "object/get",
-                            "@step",
-                            "icon",
-                            "circle"
-                          ],
-                          "label": [
-                            "object/get",
-                            "@step",
-                            "label"
-                          ],
-                          "labelColor": [
-                            "if",
-                            [
-                              "=",
-                              "@index",
-                              "@entity.currentStepIndex"
-                            ],
-                            "default",
-                            "muted"
-                          ],
-                          "id": [
-                            "object/get",
-                            "@step",
-                            "key"
-                          ],
-                          "title": [
-                            "object/get",
-                            "@step",
-                            "label"
-                          ],
                           "indexLabel": [
                             "str/concat",
                             "",
@@ -989,12 +958,27 @@
                               1.0
                             ]
                           ],
+                          "label": [
+                            "object/get",
+                            "@step",
+                            "label"
+                          ],
                           "description": [
                             "object/get",
                             "@step",
                             "description",
                             ""
                           ],
+                          "isPending": [
+                            ">",
+                            "@index",
+                            "@entity.currentStepIndex"
+                          ],
+                          "title": [
+                            "object/get",
+                            "@step",
+                            "label"
+                          ],
                           "badgeVariant": [
                             "if",
                             [
@@ -1014,10 +998,26 @@
                               "neutral"
                             ]
                           ],
-                          "isPending": [
-                            ">",
-                            "@index",
-                            "@entity.currentStepIndex"
+                          "icon": [
+                            "object/get",
+                            "@step",
+                            "icon",
+                            "circle"
+                          ],
+                          "id": [
+                            "object/get",
+                            "@step",
+                            "key"
+                          ],
+                          "labelColor": [
+                            "if",
+                            [
+                              "=",
+                              "@index",
+                              "@entity.currentStepIndex"
+                            ],
+                            "default",
+                            "muted"
                           ]
                         }
                       ]
@@ -1078,45 +1078,45 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
-                      "gap": "lg",
+                      "direction": "vertical",
                       "children": [
                         {
                           "name": "check-circle",
-                          "type": "icon",
-                          "size": "lg"
+                          "size": "lg",
+                          "type": "icon"
                         },
                         {
-                          "content": "Approved",
-                          "variant": "h2",
                           "align": "center",
-                          "type": "typography"
+                          "content": "Approved",
+                          "type": "typography",
+                          "variant": "h2"
                         },
                         {
-                          "variant": "body",
-                          "type": "typography",
-                          "align": "center",
                           "content": "All review steps completed successfully.",
-                          "color": "muted"
+                          "color": "muted",
+                          "align": "center",
+                          "type": "typography",
+                          "variant": "body"
                         },
                         {
-                          "steps": "@entity.wizardSteps",
-                          "type": "wizard-progress",
+                          "allowNavigation": false,
                           "currentStep": "@entity.totalSteps",
-                          "allowNavigation": false
+                          "type": "wizard-progress",
+                          "steps": "@entity.wizardSteps"
                         },
                         {
+                          "label": "Start a new review",
+                          "variant": "secondary",
                           "action": "RESTART",
+                          "icon": "rotate-ccw",
                           "actionPayload": {
                             "id": "@entity.id"
                           },
-                          "icon": "rotate-ccw",
-                          "type": "button",
-                          "label": "Start a new review",
-                          "variant": "secondary"
+                          "type": "button"
                         }
                       ],
-                      "direction": "vertical",
+                      "type": "stack",
+                      "gap": "lg",
                       "align": "center"
                     }
                   ]
@@ -1263,6 +1263,16 @@
                         "fn",
                         "step",
                         {
+                          "labelColor": [
+                            "if",
+                            [
+                              "=",
+                              "@index",
+                              "@entity.currentStepIndex"
+                            ],
+                            "default",
+                            "muted"
+                          ],
                           "badgeVariant": [
                             "if",
                             [
@@ -1282,21 +1292,6 @@
                               "neutral"
                             ]
                           ],
-                          "id": [
-                            "object/get",
-                            "@step",
-                            "key"
-                          ],
-                          "title": [
-                            "object/get",
-                            "@step",
-                            "label"
-                          ],
-                          "isPending": [
-                            ">",
-                            "@index",
-                            "@entity.currentStepIndex"
-                          ],
                           "icon": [
                             "object/get",
                             "@step",
@@ -1312,31 +1307,36 @@
                               1.0
                             ]
                           ],
-                          "key": [
+                          "isPending": [
+                            ">",
+                            "@index",
+                            "@entity.currentStepIndex"
+                          ],
+                          "title": [
                             "object/get",
                             "@step",
-                            "key"
+                            "label"
                           ],
                           "label": [
                             "object/get",
                             "@step",
                             "label"
                           ],
-                          "labelColor": [
-                            "if",
-                            [
-                              "=",
-                              "@index",
-                              "@entity.currentStepIndex"
-                            ],
-                            "default",
-                            "muted"
-                          ],
                           "description": [
                             "object/get",
                             "@step",
                             "description",
                             ""
+                          ],
+                          "key": [
+                            "object/get",
+                            "@step",
+                            "key"
+                          ],
+                          "id": [
+                            "object/get",
+                            "@step",
+                            "key"
                           ]
                         }
                       ]
@@ -1368,57 +1368,57 @@
                     "render-ui",
                     "main",
                     {
-                      "align": "center",
                       "direction": "vertical",
                       "type": "stack",
                       "children": [
                         {
-                          "type": "icon",
+                          "size": "lg",
                           "name": "x-circle",
-                          "size": "lg"
+                          "type": "icon"
                         },
                         {
                           "align": "center",
+                          "variant": "h2",
                           "type": "typography",
-                          "content": "Rejected",
-                          "variant": "h2"
+                          "content": "Rejected"
                         },
                         {
-                          "type": "card",
-                          "look": "@config.cardLook",
                           "children": [
                             {
+                              "direction": "vertical",
                               "type": "stack",
                               "gap": "sm",
-                              "direction": "vertical",
                               "children": [
                                 {
-                                  "variant": "caption",
                                   "type": "typography",
+                                  "color": "muted",
                                   "content": "Reason",
-                                  "color": "muted"
+                                  "variant": "caption"
                                 },
                                 {
-                                  "variant": "body",
+                                  "type": "typography",
                                   "content": "@entity.rejectionReason",
-                                  "type": "typography"
+                                  "variant": "body"
                                 }
                               ]
                             }
-                          ]
+                          ],
+                          "look": "@config.cardLook",
+                          "type": "card"
                         },
                         {
-                          "type": "button",
-                          "label": "Start a new review",
-                          "action": "RESTART",
-                          "variant": "secondary",
-                          "icon": "rotate-ccw",
                           "actionPayload": {
                             "id": "@entity.id"
-                          }
+                          },
+                          "icon": "rotate-ccw",
+                          "label": "Start a new review",
+                          "type": "button",
+                          "variant": "secondary",
+                          "action": "RESTART"
                         }
                       ],
-                      "gap": "lg"
+                      "gap": "lg",
+                      "align": "center"
                     }
                   ]
                 ]
@@ -1437,40 +1437,40 @@
                     "render-ui",
                     "main",
                     {
-                      "gap": "lg",
+                      "align": "center",
                       "children": [
                         {
+                          "size": "lg",
                           "type": "icon",
-                          "name": "alert-triangle",
-                          "size": "lg"
+                          "name": "alert-triangle"
                         },
                         {
+                          "align": "center",
                           "content": "Escalated",
                           "variant": "h2",
-                          "type": "typography",
-                          "align": "center"
+                          "type": "typography"
                         },
                         {
+                          "type": "typography",
+                          "color": "muted",
                           "content": "This item has been escalated for further review.",
                           "variant": "body",
-                          "color": "muted",
-                          "type": "typography",
                           "align": "center"
                         },
                         {
-                          "type": "button",
-                          "label": "Start a new review",
-                          "variant": "secondary",
                           "icon": "rotate-ccw",
+                          "type": "button",
                           "actionPayload": {
                             "id": "@entity.id"
                           },
-                          "action": "RESTART"
+                          "label": "Start a new review",
+                          "action": "RESTART",
+                          "variant": "secondary"
                         }
                       ],
                       "direction": "vertical",
-                      "type": "stack",
-                      "align": "center"
+                      "gap": "lg",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -1495,8 +1495,8 @@
                     "StepFlowView",
                     {
                       "emit": {
-                        "failure": "StepItemsLoadFailed",
-                        "success": "StepItemsLoaded"
+                        "success": "StepItemsLoaded",
+                        "failure": "StepItemsLoadFailed"
                       }
                     }
                   ],
@@ -1535,8 +1535,8 @@
                     "StepFlowView",
                     {
                       "emit": {
-                        "failure": "StepItemsLoadFailed",
-                        "success": "StepItemsLoaded"
+                        "success": "StepItemsLoaded",
+                        "failure": "StepItemsLoadFailed"
                       }
                     }
                   ],
@@ -1544,8 +1544,8 @@
                     "render-ui",
                     "main",
                     {
-                      "title": "Restarting…",
-                      "type": "loading-state"
+                      "type": "loading-state",
+                      "title": "Restarting…"
                     }
                   ]
                 ]
@@ -1579,8 +1579,8 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "loading-state",
-                      "title": "Restarting…"
+                      "title": "Restarting…",
+                      "type": "loading-state"
                     }
                   ]
                 ]
@@ -1594,8 +1594,8 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "loading-state",
-                      "title": "Retrying…"
+                      "title": "Retrying…",
+                      "type": "loading-state"
                     }
                   ]
                 ]
@@ -1603,72 +1603,6 @@
             ]
           },
           "config": {
-            "title": {
-              "type": "string",
-              "default": "Review",
-              "label": "Flow title",
-              "description": "Heading shown above the step progress bar",
-              "tier": "presentation"
-            },
-            "steps": {
-              "type": "[StepSpec]",
-              "default": [
-                {
-                  "description": "Initial review by direct manager",
-                  "key": "manager",
-                  "label": "Manager Review",
-                  "icon": "user"
-                },
-                {
-                  "key": "director",
-                  "description": "Department director sign-off",
-                  "label": "Director Approval",
-                  "icon": "users"
-                },
-                {
-                  "description": "Final executive approval",
-                  "key": "executive",
-                  "label": "Executive Sign-off",
-                  "icon": "shield"
-                }
-              ],
-              "label": "Steps",
-              "description": "Ordered decision steps with label, icon, and optional role gates",
-              "tier": "domain",
-              "items": {
-                "type": "object",
-                "properties": {
-                  "label": {
-                    "name": "label",
-                    "type": "string",
-                    "required": true
-                  },
-                  "icon": {
-                    "name": "icon",
-                    "type": "string",
-                    "required": false
-                  },
-                  "key": {
-                    "name": "key",
-                    "type": "string",
-                    "required": false
-                  },
-                  "allowedRoles": {
-                    "name": "allowedRoles",
-                    "type": "array",
-                    "required": false,
-                    "items": {
-                      "type": "string"
-                    }
-                  },
-                  "description": {
-                    "name": "description",
-                    "type": "string",
-                    "required": false
-                  }
-                }
-              }
-            },
             "cardLook": {
               "type": "string",
               "default": "elevated",
@@ -1688,131 +1622,197 @@
             "bodyContent": {
               "type": "render-ui",
               "default": {
-                "gap": "lg",
-                "type": "stack",
-                "direction": "vertical",
                 "children": [
                   {
+                    "type": "stack",
+                    "align": "center",
+                    "direction": "horizontal",
+                    "gap": "sm",
                     "children": [
                       {
-                        "type": "icon",
-                        "name": "shield-check"
+                        "name": "shield-check",
+                        "type": "icon"
                       },
                       {
-                        "variant": "h3",
                         "content": "@config.title",
-                        "type": "typography"
+                        "type": "typography",
+                        "variant": "h3"
                       }
-                    ],
-                    "gap": "sm",
-                    "type": "stack",
-                    "align": "center",
-                    "direction": "horizontal"
+                    ]
                   },
                   {
                     "type": "wizard-progress",
-                    "allowNavigation": false,
+                    "steps": "@entity.wizardSteps",
                     "currentStep": "@entity.currentStepIndex",
-                    "steps": "@entity.wizardSteps"
+                    "allowNavigation": false
                   },
                   {
                     "look": "@config.cardLook",
                     "type": "card",
                     "children": [
                       {
+                        "gap": "md",
                         "children": [
                           {
-                            "type": "stack",
-                            "align": "center",
-                            "gap": "sm",
                             "children": [
                               {
+                                "name": "@entity.currentStepIcon",
                                 "type": "icon",
-                                "size": "lg",
-                                "name": "@entity.currentStepIcon"
+                                "size": "lg"
                               },
                               {
-                                "direction": "vertical",
+                                "type": "stack",
                                 "gap": "xs",
                                 "children": [
                                   {
-                                    "variant": "h2",
                                     "type": "typography",
-                                    "content": "@entity.currentStepLabel"
+                                    "content": "@entity.currentStepLabel",
+                                    "variant": "h2"
                                   },
                                   {
+                                    "content": "@entity.currentStepDescription",
                                     "type": "typography",
                                     "color": "muted",
-                                    "content": "@entity.currentStepDescription",
                                     "variant": "body"
                                   }
                                 ],
-                                "type": "stack"
+                                "direction": "vertical"
                               }
                             ],
+                            "gap": "sm",
+                            "type": "stack",
+                            "align": "center",
                             "direction": "horizontal"
                           }
                         ],
-                        "direction": "vertical",
-                        "gap": "md",
-                        "type": "stack"
+                        "type": "stack",
+                        "direction": "vertical"
                       }
                     ]
                   },
                   {
+                    "gap": "sm",
+                    "align": "center",
+                    "type": "stack",
                     "direction": "horizontal",
                     "children": [
                       {
                         "label": "Back",
-                        "action": "BACK",
+                        "variant": "ghost",
+                        "type": "button",
                         "disabled": "@entity.isFirstStep",
+                        "action": "BACK",
                         "actionPayload": {
                           "id": "@entity.id"
                         },
-                        "variant": "ghost",
-                        "type": "button",
                         "icon": "chevron-left"
                       },
                       {
-                        "label": "Reject",
                         "type": "button",
-                        "action": "REJECT",
                         "actionPayload": {
                           "id": "@entity.id"
                         },
+                        "action": "REJECT",
+                        "variant": "ghost",
                         "icon": "x",
-                        "variant": "ghost"
+                        "label": "Reject"
                       },
                       {
+                        "label": "Escalate",
                         "actionPayload": {
                           "id": "@entity.id"
                         },
-                        "variant": "ghost",
-                        "label": "Escalate",
+                        "icon": "alert-triangle",
                         "type": "button",
                         "action": "ESCALATE",
-                        "icon": "alert-triangle"
+                        "variant": "ghost"
                       },
                       {
                         "icon": "@entity.primaryActionIcon",
-                        "label": "@entity.primaryActionLabel",
+                        "action": "ADVANCE",
                         "actionPayload": {
                           "id": "@entity.id"
                         },
+                        "label": "@entity.primaryActionLabel",
                         "variant": "primary",
-                        "action": "ADVANCE",
                         "type": "button"
                       }
-                    ],
-                    "align": "center",
-                    "type": "stack",
-                    "gap": "sm"
+                    ]
                   }
-                ]
+                ],
+                "gap": "lg",
+                "type": "stack",
+                "direction": "vertical"
               },
               "label": "Body content tree",
               "description": "Render-ui SExpr rendered while the step chain is active (loading-success, running, BACK). Default is the canonical wizard-progress + step-card + action-row tree. Layer 3 variants override this with their own tree (horizontal stepper, sidebar progress, card carousel, etc.) to deliver entirely different step UX while inheriting the same trait, state machine, emits, and listens.",
               "tier": "internal"
+            },
+            "title": {
+              "type": "string",
+              "default": "Review",
+              "label": "Flow title",
+              "description": "Heading shown above the step progress bar",
+              "tier": "presentation"
+            },
+            "steps": {
+              "type": "[StepSpec]",
+              "default": [
+                {
+                  "description": "Initial review by direct manager",
+                  "key": "manager",
+                  "icon": "user",
+                  "label": "Manager Review"
+                },
+                {
+                  "key": "director",
+                  "label": "Director Approval",
+                  "description": "Department director sign-off",
+                  "icon": "users"
+                },
+                {
+                  "description": "Final executive approval",
+                  "key": "executive",
+                  "icon": "shield",
+                  "label": "Executive Sign-off"
+                }
+              ],
+              "label": "Steps",
+              "description": "Ordered decision steps with label, icon, and optional role gates",
+              "tier": "domain",
+              "items": {
+                "type": "object",
+                "properties": {
+                  "key": {
+                    "name": "key",
+                    "type": "string",
+                    "required": false
+                  },
+                  "icon": {
+                    "name": "icon",
+                    "type": "string",
+                    "required": false
+                  },
+                  "description": {
+                    "name": "description",
+                    "type": "string",
+                    "required": false
+                  },
+                  "label": {
+                    "name": "label",
+                    "type": "string",
+                    "required": true
+                  },
+                  "allowedRoles": {
+                    "name": "allowedRoles",
+                    "type": "array",
+                    "required": false,
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                }
+              }
             }
           },
           "scope": "instance"