@almadar/std 5.2.1 → 5.3.0

package/behaviors/exports/molecules/std-geospatial.orb

@@ -1,24 +1,9 @@
 {
-  "name": "std-geospatial",
+  "name": "LocationOrbital",
   "version": "1.0.0",
-  "description": "Location selection molecule. Composes atoms via shared event bus: - stdBrowse: location list with \"Select\" item action (fires SELECT) - stdModal: select/view location detail (responds to SELECT) - stdConfirmation: confirm location selection (responds to CONFIRM_SELECT)",
   "orbitals": [
     {
       "name": "LocationOrbital",
-      "uses": [
-        {
-          "from": "std/behaviors/std-browse",
-          "as": "Browse"
-        },
-        {
-          "from": "std/behaviors/std-confirmation",
-          "as": "Confirmation"
-        },
-        {
-          "from": "std/behaviors/std-modal",
-          "as": "Modal"
-        }
-      ],
       "entity": {
         "name": "Location",
         "persistence": "persistent",
@@ -59,423 +44,593 @@
       },
       "traits": [
         {
-          "ref": "Browse.traits.BrowseItemBrowse",
           "name": "LocationBrowse",
           "linkedEntity": "Location",
-          "effects": {
-            "INIT": [
-              [
-                "ref",
-                "Location"
-              ],
-              [
-                "render-ui",
-                "main",
-                {
-                  "type": "stack",
-                  "direction": "vertical",
-                  "gap": "lg",
-                  "className": "max-w-5xl mx-auto w-full",
-                  "children": [
+          "category": "interaction",
+          "listens": [
+            {
+              "event": "CONFIRMED",
+              "triggers": "INIT"
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "browsing",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "SELECT",
+                "name": "SELECT",
+                "payload": [
+                  {
+                    "name": "id",
+                    "type": "string",
+                    "required": true
+                  },
+                  {
+                    "name": "row",
+                    "type": "object"
+                  }
+                ]
+              }
+            ],
+            "transitions": [
+              {
+                "from": "browsing",
+                "to": "browsing",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "ref",
+                    "Location"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
                     {
                       "type": "stack",
-                      "direction": "horizontal",
-                      "gap": "md",
-                      "justify": "space-between",
-                      "align": "center",
+                      "direction": "vertical",
+                      "gap": "lg",
+                      "className": "max-w-5xl mx-auto w-full",
                       "children": [
                         {
                           "type": "stack",
                           "direction": "horizontal",
-                          "gap": "sm",
+                          "gap": "md",
+                          "justify": "space-between",
                           "align": "center",
                           "children": [
                             {
-                              "type": "icon",
-                              "name": "map-pin",
-                              "size": "lg"
-                            },
-                            {
-                              "type": "typography",
-                              "content": "Locations Picker",
-                              "variant": "h2"
+                              "type": "stack",
+                              "direction": "horizontal",
+                              "gap": "sm",
+                              "align": "center",
+                              "children": [
+                                {
+                                  "type": "icon",
+                                  "name": "map-pin",
+                                  "size": "lg"
+                                },
+                                {
+                                  "type": "typography",
+                                  "content": "Locations Picker",
+                                  "variant": "h2"
+                                }
+                              ]
                             }
                           ]
-                        }
-                      ]
-                    },
-                    {
-                      "type": "divider"
-                    },
-                    {
-                      "type": "data-grid",
-                      "entity": "Location",
-                      "emptyIcon": "inbox",
-                      "emptyTitle": "No locations found",
-                      "emptyDescription": "No locations are available to select.",
-                      "itemActions": [
-                        {
-                          "label": "Select Location",
-                          "event": "SELECT",
-                          "variant": "ghost",
-                          "size": "sm"
-                        }
-                      ],
-                      "columns": [
+                        },
                         {
-                          "name": "name",
-                          "label": "Name",
-                          "variant": "h4",
-                          "icon": "map-pin"
+                          "type": "divider"
                         },
                         {
-                          "name": "description",
-                          "label": "Description",
-                          "variant": "badge",
-                          "colorMap": {
-                            "active": "success",
-                            "completed": "success",
-                            "done": "success",
-                            "pending": "warning",
-                            "draft": "warning",
-                            "scheduled": "warning",
-                            "inactive": "neutral",
-                            "archived": "neutral",
-                            "disabled": "neutral",
-                            "error": "destructive",
-                            "cancelled": "destructive",
-                            "failed": "destructive"
-                          }
+                          "type": "data-grid",
+                          "entity": "Location",
+                          "emptyIcon": "inbox",
+                          "emptyTitle": "No locations found",
+                          "emptyDescription": "No locations are available to select.",
+                          "itemActions": [
+                            {
+                              "label": "Select Location",
+                              "event": "SELECT",
+                              "variant": "ghost",
+                              "size": "sm"
+                            }
+                          ],
+                          "columns": [
+                            {
+                              "name": "name",
+                              "label": "Name",
+                              "variant": "h4",
+                              "icon": "map-pin"
+                            },
+                            {
+                              "name": "description",
+                              "label": "Description",
+                              "variant": "badge",
+                              "colorMap": {
+                                "active": "success",
+                                "completed": "success",
+                                "done": "success",
+                                "pending": "warning",
+                                "draft": "warning",
+                                "scheduled": "warning",
+                                "inactive": "neutral",
+                                "archived": "neutral",
+                                "disabled": "neutral",
+                                "error": "destructive",
+                                "cancelled": "destructive",
+                                "failed": "destructive"
+                              }
+                            },
+                            {
+                              "name": "status",
+                              "label": "Status",
+                              "variant": "caption"
+                            }
+                          ]
                         },
                         {
-                          "name": "status",
-                          "label": "Status",
-                          "variant": "caption"
+                          "type": "floating-action-button",
+                          "icon": "plus",
+                          "event": "INIT",
+                          "label": "Create",
+                          "tooltip": "Create"
                         }
                       ]
-                    },
-                    {
-                      "type": "floating-action-button",
-                      "icon": "plus",
-                      "event": "INIT",
-                      "label": "Create",
-                      "tooltip": "Create"
                     }
                   ]
-                }
-              ]
+                ]
+              }
             ]
           }
         },
         {
-          "ref": "Modal.traits.ModalRecordModal",
           "name": "LocationSelect",
           "linkedEntity": "Location",
-          "events": {
-            "OPEN": "SELECT",
-            "SAVE": "CONFIRM_SELECT"
-          },
-          "effects": {
-            "INIT": [
-              [
-                "ref",
-                "Location"
-              ]
+          "category": "interaction",
+          "emits": [
+            {
+              "event": "CONFIRM_SELECT"
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "closed",
+                "isInitial": true
+              },
+              {
+                "name": "open"
+              }
             ],
-            "SELECT": [
-              [
-                "fetch",
-                "Location",
-                {
-                  "id": "@payload.id"
-                }
-              ],
-              [
-                "render-ui",
-                "modal",
-                {
-                  "type": "stack",
-                  "direction": "vertical",
-                  "gap": "md",
-                  "children": [
-                    {
-                      "type": "stack",
-                      "direction": "horizontal",
-                      "gap": "sm",
-                      "align": "center",
-                      "children": [
-                        {
-                          "type": "icon",
-                          "name": "map-pin",
-                          "size": "md"
-                        },
-                        {
-                          "type": "typography",
-                          "variant": "h3",
-                          "content": "@entity.name"
-                        }
-                      ]
-                    },
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "SELECT",
+                "name": "Open",
+                "payload": [
+                  {
+                    "name": "id",
+                    "type": "string",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "CLOSE",
+                "name": "Close"
+              },
+              {
+                "key": "CONFIRM_SELECT",
+                "name": "Save",
+                "payload": [
+                  {
+                    "name": "data",
+                    "type": "object",
+                    "required": true
+                  }
+                ]
+              }
+            ],
+            "transitions": [
+              {
+                "from": "closed",
+                "to": "closed",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "ref",
+                    "Location"
+                  ]
+                ]
+              },
+              {
+                "from": "closed",
+                "to": "open",
+                "event": "SELECT",
+                "effects": [
+                  [
+                    "fetch",
+                    "Location",
                     {
-                      "type": "divider"
-                    },
+                      "id": "@payload.id"
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "modal",
                     {
                       "type": "stack",
-                      "direction": "horizontal",
+                      "direction": "vertical",
                       "gap": "md",
                       "children": [
                         {
-                          "type": "typography",
-                          "variant": "caption",
-                          "content": "Name"
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "map-pin",
+                              "size": "md"
+                            },
+                            {
+                              "type": "typography",
+                              "variant": "h3",
+                              "content": "@entity.name"
+                            }
+                          ]
                         },
                         {
-                          "type": "typography",
-                          "variant": "body",
-                          "content": "@entity.name"
-                        }
-                      ]
-                    },
-                    {
-                      "type": "stack",
-                      "direction": "horizontal",
-                      "gap": "md",
-                      "children": [
-                        {
-                          "type": "typography",
-                          "variant": "caption",
-                          "content": "Description"
+                          "type": "divider"
                         },
                         {
-                          "type": "typography",
-                          "variant": "body",
-                          "content": "@entity.description"
-                        }
-                      ]
-                    },
-                    {
-                      "type": "stack",
-                      "direction": "horizontal",
-                      "gap": "md",
-                      "children": [
-                        {
-                          "type": "typography",
-                          "variant": "caption",
-                          "content": "Status"
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "typography",
+                              "variant": "caption",
+                              "content": "Name"
+                            },
+                            {
+                              "type": "typography",
+                              "variant": "body",
+                              "content": "@entity.name"
+                            }
+                          ]
                         },
                         {
-                          "type": "typography",
-                          "variant": "body",
-                          "content": "@entity.status"
-                        }
-                      ]
-                    },
-                    {
-                      "type": "stack",
-                      "direction": "horizontal",
-                      "gap": "md",
-                      "children": [
-                        {
-                          "type": "typography",
-                          "variant": "caption",
-                          "content": "Created At"
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "typography",
+                              "variant": "caption",
+                              "content": "Description"
+                            },
+                            {
+                              "type": "typography",
+                              "variant": "body",
+                              "content": "@entity.description"
+                            }
+                          ]
                         },
                         {
-                          "type": "typography",
-                          "variant": "body",
-                          "content": "@entity.createdAt"
-                        }
-                      ]
-                    },
-                    {
-                      "type": "stack",
-                      "direction": "horizontal",
-                      "gap": "md",
-                      "children": [
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "typography",
+                              "variant": "caption",
+                              "content": "Status"
+                            },
+                            {
+                              "type": "typography",
+                              "variant": "body",
+                              "content": "@entity.status"
+                            }
+                          ]
+                        },
                         {
-                          "type": "typography",
-                          "variant": "caption",
-                          "content": "Pending ID"
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "typography",
+                              "variant": "caption",
+                              "content": "Created At"
+                            },
+                            {
+                              "type": "typography",
+                              "variant": "body",
+                              "content": "@entity.createdAt"
+                            }
+                          ]
                         },
                         {
-                          "type": "typography",
-                          "variant": "body",
-                          "content": "@entity.pendingId"
-                        }
-                      ]
-                    },
-                    {
-                      "type": "divider"
-                    },
-                    {
-                      "type": "stack",
-                      "direction": "horizontal",
-                      "gap": "sm",
-                      "justify": "end",
-                      "children": [
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
+                          "children": [
+                            {
+                              "type": "typography",
+                              "variant": "caption",
+                              "content": "Pending ID"
+                            },
+                            {
+                              "type": "typography",
+                              "variant": "body",
+                              "content": "@entity.pendingId"
+                            }
+                          ]
+                        },
                         {
-                          "type": "button",
-                          "label": "Cancel",
-                          "event": "CLOSE",
-                          "variant": "ghost"
+                          "type": "divider"
                         },
                         {
-                          "type": "button",
-                          "label": "Confirm Selection",
-                          "event": "CONFIRM_SELECT",
-                          "variant": "primary",
-                          "icon": "check"
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "justify": "end",
+                          "children": [
+                            {
+                              "type": "button",
+                              "label": "Cancel",
+                              "event": "CLOSE",
+                              "variant": "ghost"
+                            },
+                            {
+                              "type": "button",
+                              "label": "Confirm Selection",
+                              "event": "CONFIRM_SELECT",
+                              "variant": "primary",
+                              "icon": "check"
+                            }
+                          ]
                         }
                       ]
                     }
                   ]
-                }
-              ]
-            ],
-            "CLOSE": [
-              [
-                "render-ui",
-                "modal",
-                null
-              ],
-              [
-                "notify",
-                "Cancelled",
-                "info"
-              ]
-            ],
-            "CONFIRM_SELECT": [
-              [
-                "render-ui",
-                "modal",
-                null
-              ]
+                ]
+              },
+              {
+                "from": "open",
+                "to": "closed",
+                "event": "CLOSE",
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ],
+                  [
+                    "notify",
+                    "Cancelled",
+                    "info"
+                  ]
+                ]
+              },
+              {
+                "from": "open",
+                "to": "closed",
+                "event": "CONFIRM_SELECT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ]
+                ]
+              }
             ]
           }
         },
         {
-          "ref": "Confirmation.traits.ConfirmActionConfirmation",
           "name": "LocationConfirmSelect",
           "linkedEntity": "Location",
-          "events": {
-            "REQUEST": "CONFIRM_SELECT",
-            "CONFIRM": "CONFIRMED"
-          },
-          "effects": {
-            "INIT": [
-              [
-                "ref",
-                "Location"
-              ]
+          "category": "interaction",
+          "emits": [
+            {
+              "event": "CONFIRMED"
+            }
+          ],
+          "stateMachine": {
+            "states": [
+              {
+                "name": "idle",
+                "isInitial": true
+              },
+              {
+                "name": "confirming"
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "key": "CONFIRM_SELECT",
+                "name": "Request Confirmation",
+                "payload": [
+                  {
+                    "name": "id",
+                    "type": "string",
+                    "required": true
+                  }
+                ]
+              },
+              {
+                "key": "CONFIRMED",
+                "name": "Confirm"
+              },
+              {
+                "key": "CANCEL",
+                "name": "Cancel"
+              },
+              {
+                "key": "CLOSE",
+                "name": "Close"
+              }
             ],
-            "CONFIRM_SELECT": [
-              [
-                "set",
-                "@entity.pendingId",
-                "@payload.id"
-              ],
-              [
-                "fetch",
-                "Location",
-                {
-                  "id": "@payload.id"
-                }
-              ],
-              [
-                "render-ui",
-                "modal",
-                {
-                  "type": "stack",
-                  "direction": "vertical",
-                  "gap": "md",
-                  "children": [
+            "transitions": [
+              {
+                "from": "idle",
+                "to": "idle",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "ref",
+                    "Location"
+                  ]
+                ]
+              },
+              {
+                "from": "idle",
+                "to": "confirming",
+                "event": "CONFIRM_SELECT",
+                "effects": [
+                  [
+                    "set",
+                    "@entity.pendingId",
+                    "@payload.id"
+                  ],
+                  [
+                    "fetch",
+                    "Location",
+                    {
+                      "id": "@payload.id"
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "modal",
                     {
                       "type": "stack",
-                      "direction": "horizontal",
-                      "gap": "sm",
-                      "align": "center",
+                      "direction": "vertical",
+                      "gap": "md",
                       "children": [
                         {
-                          "type": "icon",
-                          "name": "alert-triangle",
-                          "size": "md"
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "alert-triangle",
+                              "size": "md"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "Confirm Location Selection",
+                              "variant": "h3"
+                            }
+                          ]
                         },
                         {
-                          "type": "typography",
-                          "content": "Confirm Location Selection",
-                          "variant": "h3"
-                        }
-                      ]
-                    },
-                    {
-                      "type": "divider"
-                    },
-                    {
-                      "type": "alert",
-                      "variant": "danger",
-                      "message": "Are you sure you want to select this location?"
-                    },
-                    {
-                      "type": "stack",
-                      "direction": "horizontal",
-                      "gap": "sm",
-                      "justify": "end",
-                      "children": [
-                        {
-                          "type": "button",
-                          "label": "Cancel",
-                          "event": "CANCEL",
-                          "variant": "ghost"
+                          "type": "divider"
                         },
                         {
-                          "type": "button",
-                          "label": "Confirm",
-                          "event": "CONFIRMED",
+                          "type": "alert",
                           "variant": "danger",
-                          "icon": "check"
+                          "message": "Are you sure you want to select this location?"
+                        },
+                        {
+                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "justify": "end",
+                          "children": [
+                            {
+                              "type": "button",
+                              "label": "Cancel",
+                              "event": "CANCEL",
+                              "variant": "ghost"
+                            },
+                            {
+                              "type": "button",
+                              "label": "Confirm",
+                              "event": "CONFIRMED",
+                              "variant": "danger",
+                              "icon": "check"
+                            }
+                          ]
                         }
                       ]
                     }
                   ]
-                }
-              ]
-            ],
-            "CONFIRMED": [
-              [
-                "fetch",
-                "Location"
-              ],
-              [
-                "render-ui",
-                "modal",
-                null
-              ],
-              [
-                "ref",
-                "Location"
-              ]
-            ],
-            "CANCEL": [
-              [
-                "render-ui",
-                "modal",
-                null
-              ],
-              [
-                "ref",
-                "Location"
-              ]
-            ],
-            "CLOSE": [
-              [
-                "render-ui",
-                "modal",
-                null
-              ],
-              [
-                "ref",
-                "Location"
-              ]
+                ]
+              },
+              {
+                "from": "confirming",
+                "to": "idle",
+                "event": "CONFIRMED",
+                "effects": [
+                  [
+                    "fetch",
+                    "Location"
+                  ],
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ],
+                  [
+                    "ref",
+                    "Location"
+                  ]
+                ]
+              },
+              {
+                "from": "confirming",
+                "to": "idle",
+                "event": "CANCEL",
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ],
+                  [
+                    "ref",
+                    "Location"
+                  ]
+                ]
+              },
+              {
+                "from": "confirming",
+                "to": "idle",
+                "event": "CLOSE",
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ],
+                  [
+                    "ref",
+                    "Location"
+                  ]
+                ]
+              }
             ]
           }
         }
@@ -498,5 +653,6 @@
         }
       ]
     }
-  ]
-}
+  ],
+  "description": "Location selection molecule. Composes atoms via shared event bus: - stdBrowse: location list with \"Select\" item action (fires SELECT) - stdModal: select/view location detail (responds to SELECT) - stdConfirmation: confirm location selection (responds to CONFIRM_SELECT) No emits/listens wiring. Traits on the same page share the event bus. Only the trait with a matching transition from its current state responds. (2026-04-08). The canonical source for std behaviors is now the registry `.orb` file at `packages/almadar-std/behaviors/registry/<level>/<name>.orb`, which is generated from this TS source by `tools/almadar-behavior-ts-to-orb/` and consumed by the compiler's embedded loader. Consumers should import behaviors via `.lolo`/`.orb` `uses` declarations and reference them as `Alias.entity` / `Alias.traits.X` / `Alias.pages.X`, applying overrides at the call site (`linkedEntity`, `name`, `events`, `effects`, `listens`, `emitsScope`). The TS `*Params` interface and the exported factory functions remain ONLY as the authoring path for the converter; they are NOT a stable public API and may change without notice. See `docs/Almadar_Orb_Behaviors.md` for the orbital-as-function model and `docs/LOLO_Gaps.md` for the migration plan."
+}