@almadar/std 6.5.2 → 7.2.0

package/dist/behaviors/registry/atoms/std-browse.orb

@@ -1,7 +1,7 @@
 {
   "name": "std-browse",
   "version": "1.0.0",
-  "description": "Data grid browsing atom. Renders a list of entities with configurable item actions. The browsing view that molecules compose with modal/confirmation atoms.",
+  "description": "std-browse as a Function",
   "orbitals": [
     {
       "name": "BrowseItemOrbital",
@@ -35,138 +35,159 @@
             "name": "createdAt",
             "type": "string"
           }
-        ],
-        "instances": [
-          {
-            "id": "bi-1",
-            "name": "Terry Schultz",
-            "description": "Senior product designer with 8 years of experience",
-            "status": "active",
-            "createdAt": "2026-01-15"
-          },
-          {
-            "id": "bi-2",
-            "name": "Dale Franey",
-            "description": "Full-stack developer specializing in React and Node.js",
-            "status": "active",
-            "createdAt": "2026-01-18"
-          },
-          {
-            "id": "bi-3",
-            "name": "Lorena Mayer",
-            "description": "Data analyst focused on business intelligence",
-            "status": "pending",
-            "createdAt": "2026-01-20"
-          },
-          {
-            "id": "bi-4",
-            "name": "Andrea Paucek",
-            "description": "Project manager with PMP certification",
-            "status": "active",
-            "createdAt": "2026-02-01"
-          },
-          {
-            "id": "bi-5",
-            "name": "Geneva Durgan",
-            "description": "UX researcher conducting user interviews",
-            "status": "inactive",
-            "createdAt": "2026-02-05"
-          },
-          {
-            "id": "bi-6",
-            "name": "Samantha Okuneva",
-            "description": "DevOps engineer managing cloud infrastructure",
-            "status": "active",
-            "createdAt": "2026-02-10"
-          },
-          {
-            "id": "bi-7",
-            "name": "Nelson Halby",
-            "description": "Technical writer documenting APIs",
-            "status": "active",
-            "createdAt": "2026-02-15"
-          },
-          {
-            "id": "bi-8",
-            "name": "Tanya Hand",
-            "description": "QA lead overseeing test automation",
-            "status": "pending",
-            "createdAt": "2026-02-20"
-          },
-          {
-            "id": "bi-9",
-            "name": "Rosemary Lind",
-            "description": "Marketing analyst tracking campaign performance",
-            "status": "active",
-            "createdAt": "2026-03-01"
-          },
-          {
-            "id": "bi-10",
-            "name": "Bernadette Anderson",
-            "description": "Security engineer conducting penetration tests",
-            "status": "active",
-            "createdAt": "2026-03-05"
-          }
         ]
       },
       "traits": [
         {
           "name": "BrowseItemBrowse",
-          "linkedEntity": "BrowseItem",
           "category": "interaction",
+          "linkedEntity": "BrowseItem",
+          "emits": [
+            {
+              "event": "BrowseItemLoaded",
+              "description": "Fired when the BrowseItem collection finishes loading",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "id",
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "type": "string"
+                },
+                {
+                  "name": "description",
+                  "type": "string"
+                },
+                {
+                  "name": "status",
+                  "type": "string"
+                },
+                {
+                  "name": "createdAt",
+                  "type": "string"
+                }
+              ]
+            },
+            {
+              "event": "BrowseItemLoadFailed",
+              "description": "Fired when the BrowseItem collection fails to load",
+              "scope": "internal",
+              "payload": [
+                {
+                  "name": "message",
+                  "type": "string"
+                }
+              ]
+            }
+          ],
           "stateMachine": {
             "states": [
               {
-                "name": "browsing",
+                "name": "loading",
                 "isInitial": true
+              },
+              {
+                "name": "browsing"
+              },
+              {
+                "name": "error"
               }
             ],
             "events": [
               {
                 "key": "INIT",
                 "name": "Initialize"
+              },
+              {
+                "key": "BrowseItemLoaded",
+                "name": "BrowseItem loaded"
+              },
+              {
+                "key": "BrowseItemLoadFailed",
+                "name": "BrowseItem load failed",
+                "payload": [
+                  {
+                    "name": "message",
+                    "type": "string"
+                  }
+                ]
               }
             ],
             "transitions": [
               {
-                "from": "browsing",
-                "to": "browsing",
+                "from": "loading",
+                "to": "loading",
                 "event": "INIT",
                 "effects": [
                   [
-                    "ref",
-                    "BrowseItem"
+                    "fetch",
+                    "BrowseItem",
+                    {
+                      "emit": {
+                        "success": "BrowseItemLoaded",
+                        "failure": "BrowseItemLoadFailed"
+                      }
+                    }
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
+                      "className": "max-w-5xl mx-auto w-full py-12",
+                      "children": [
+                        {
+                          "type": "spinner",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Loading BrowseItems…",
+                          "variant": "caption",
+                          "color": "muted"
+                        }
+                      ],
                       "direction": "vertical",
+                      "align": "center",
                       "gap": "lg",
-                      "className": "max-w-5xl mx-auto w-full",
+                      "type": "stack"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "loading",
+                "to": "browsing",
+                "event": "BrowseItemLoaded",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "type": "stack",
                       "children": [
                         {
                           "type": "stack",
+                          "justify": "space-between",
                           "direction": "horizontal",
                           "gap": "md",
-                          "justify": "space-between",
                           "align": "center",
                           "children": [
                             {
-                              "type": "stack",
                               "direction": "horizontal",
-                              "gap": "sm",
                               "align": "center",
+                              "gap": "sm",
+                              "type": "stack",
                               "children": [
                                 {
-                                  "type": "icon",
                                   "name": "list",
+                                  "type": "icon",
                                   "size": "lg"
                                 },
                                 {
-                                  "type": "typography",
                                   "content": "BrowseItems",
+                                  "type": "typography",
                                   "variant": "h2"
                                 }
                               ]
@@ -176,74 +197,187 @@
                         {
                           "type": "divider"
                         },
-                        {
-                          "type": "pull-to-refresh",
-                          "event": "REFRESH"
-                        },
-                        {
-                          "type": "swipeable-row",
-                          "leadingAction": {
-                            "label": "Edit",
-                            "event": "EDIT"
-                          },
-                          "trailingAction": {
-                            "label": "Delete",
-                            "event": "DELETE"
-                          }
-                        },
                         {
                           "type": "data-grid",
-                          "entity": "BrowseItem",
-                          "emptyIcon": "inbox",
-                          "emptyTitle": "No browseitems yet",
                           "emptyDescription": "Create your first browseitem to get started.",
                           "columns": [
                             {
                               "name": "name",
+                              "icon": "list",
                               "label": "Name",
-                              "variant": "h4",
-                              "icon": "list"
+                              "variant": "h4"
                             },
                             {
                               "name": "description",
-                              "label": "Description",
-                              "variant": "badge",
                               "colorMap": {
+                                "disabled": "neutral",
+                                "error": "destructive",
+                                "cancelled": "destructive",
                                 "active": "success",
+                                "inactive": "neutral",
+                                "archived": "neutral",
                                 "completed": "success",
-                                "done": "success",
-                                "pending": "warning",
                                 "draft": "warning",
+                                "failed": "destructive",
+                                "done": "success",
                                 "scheduled": "warning",
-                                "inactive": "neutral",
-                                "archived": "neutral",
-                                "disabled": "neutral",
-                                "error": "destructive",
-                                "cancelled": "destructive",
-                                "failed": "destructive"
-                              }
+                                "pending": "warning"
+                              },
+                              "label": "Description",
+                              "variant": "badge"
                             },
                             {
+                              "variant": "caption",
                               "name": "status",
-                              "label": "Status",
-                              "variant": "caption"
+                              "label": "Status"
                             }
-                          ]
+                          ],
+                          "entity": "BrowseItem",
+                          "emptyTitle": "No browseitems yet",
+                          "emptyIcon": "inbox"
                         },
                         {
-                          "type": "floating-action-button",
                           "icon": "plus",
+                          "tooltip": "Create",
+                          "type": "floating-action-button",
                           "event": "INIT",
-                          "label": "Create",
-                          "tooltip": "Create"
+                          "label": "Create"
+                        }
+                      ],
+                      "className": "max-w-5xl mx-auto w-full",
+                      "gap": "lg",
+                      "direction": "vertical"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "loading",
+                "to": "error",
+                "event": "BrowseItemLoadFailed",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "max-w-5xl mx-auto w-full py-12",
+                      "children": [
+                        {
+                          "type": "icon",
+                          "name": "alert-triangle",
+                          "size": "xl",
+                          "color": "destructive"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Failed to load BrowseItems",
+                          "variant": "h3"
+                        },
+                        {
+                          "content": "@payload.message",
+                          "variant": "body",
+                          "type": "typography",
+                          "color": "muted"
+                        },
+                        {
+                          "label": "Retry",
+                          "icon": "rotate-ccw",
+                          "event": "INIT",
+                          "variant": "primary",
+                          "type": "button"
+                        }
+                      ],
+                      "type": "stack",
+                      "align": "center",
+                      "direction": "vertical",
+                      "gap": "md"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "browsing",
+                "to": "loading",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "fetch",
+                    "BrowseItem",
+                    {
+                      "emit": {
+                        "success": "BrowseItemLoaded",
+                        "failure": "BrowseItemLoadFailed"
+                      }
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "gap": "lg",
+                      "className": "max-w-5xl mx-auto w-full py-12",
+                      "children": [
+                        {
+                          "type": "spinner",
+                          "size": "lg"
+                        },
+                        {
+                          "type": "typography",
+                          "content": "Refreshing…",
+                          "color": "muted",
+                          "variant": "caption"
                         }
-                      ]
+                      ],
+                      "direction": "vertical",
+                      "align": "center",
+                      "type": "stack"
+                    }
+                  ]
+                ]
+              },
+              {
+                "from": "error",
+                "to": "loading",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "fetch",
+                    "BrowseItem",
+                    {
+                      "emit": {
+                        "failure": "BrowseItemLoadFailed",
+                        "success": "BrowseItemLoaded"
+                      }
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": [
+                        {
+                          "type": "spinner",
+                          "size": "lg"
+                        },
+                        {
+                          "color": "muted",
+                          "type": "typography",
+                          "variant": "caption",
+                          "content": "Retrying…"
+                        }
+                      ],
+                      "type": "stack",
+                      "gap": "lg",
+                      "align": "center",
+                      "direction": "vertical",
+                      "className": "max-w-5xl mx-auto w-full py-12"
                     }
                   ]
                 ]
               }
             ]
-          }
+          },
+          "scope": "collection"
         }
       ],
       "pages": [
@@ -259,4 +393,4 @@
       ]
     }
   ]
-}
+}