@almadar/std 14.26.0 → 14.28.0

package/behaviors/registry/app/atoms/std-help-category.orb

@@ -74,58 +74,7 @@
           "linkedEntity": "HelpCategory",
           "emits": [
             {
-              "event": "VIEW",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string",
-                  "required": true
-                },
-                {
-                  "name": "source",
-                  "type": "string"
-                }
-              ]
-            },
-            {
-              "event": "EDIT",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string",
-                  "required": true
-                },
-                {
-                  "name": "source",
-                  "type": "string"
-                }
-              ]
-            },
-            {
-              "event": "CREATE",
-              "payloadSchema": [
-                {
-                  "name": "source",
-                  "type": "string"
-                }
-              ]
-            },
-            {
-              "event": "REQUEST_DELETE",
-              "payloadSchema": [
-                {
-                  "name": "id",
-                  "type": "string",
-                  "required": true
-                },
-                {
-                  "name": "source",
-                  "type": "string"
-                }
-              ]
-            },
-            {
-              "event": "PUBLISH",
+              "event": "OPEN_CATEGORY",
               "payloadSchema": [
                 {
                   "name": "id",
@@ -178,55 +127,25 @@
               ]
             },
             {
-              "event": "ARCHIVE",
+              "event": "CLOSE_VIEW"
+            },
+            {
+              "event": "PUBLISH",
               "payloadSchema": [
                 {
                   "name": "id",
                   "type": "string",
                   "required": true
-                },
-                {
-                  "name": "row.id",
-                  "type": "string",
-                  "required": true
-                },
-                {
-                  "name": "row.name",
-                  "type": "string",
-                  "required": true
-                },
+                }
+              ]
+            },
+            {
+              "event": "ARCHIVE",
+              "payloadSchema": [
                 {
-                  "name": "row.slug",
+                  "name": "id",
                   "type": "string",
                   "required": true
-                },
-                {
-                  "name": "row.description",
-                  "type": "string"
-                },
-                {
-                  "name": "row.icon",
-                  "type": "string"
-                },
-                {
-                  "name": "row.sortOrder",
-                  "type": "number"
-                },
-                {
-                  "name": "row.articleCount",
-                  "type": "number"
-                },
-                {
-                  "name": "row.status",
-                  "type": "string"
-                },
-                {
-                  "name": "row.updatedAt",
-                  "type": "string"
-                },
-                {
-                  "name": "row.pendingId",
-                  "type": "string"
                 }
               ]
             },
@@ -260,7 +179,10 @@
                 "isInitial": true
               },
               {
-                "name": "viewing"
+                "name": "browsing"
+              },
+              {
+                "name": "viewing_single"
               },
               {
                 "name": "error"
@@ -296,75 +218,17 @@
                 ]
               },
               {
-                "key": "REFRESH",
-                "name": "Refresh",
-                "payloadSchema": [
-                  {
-                    "name": "source",
-                    "type": "string"
-                  }
-                ]
-              },
-              {
-                "key": "SEARCH",
-                "name": "Search",
-                "payloadSchema": [
-                  {
-                    "name": "query",
-                    "type": "string"
-                  }
-                ]
-              },
-              {
-                "key": "FILTER_STATUS",
-                "name": "Filter Status",
-                "payloadSchema": [
-                  {
-                    "name": "status",
-                    "type": "string"
-                  }
-                ]
-              },
-              {
-                "key": "CREATE",
-                "name": "Create",
-                "payloadSchema": [
-                  {
-                    "name": "source",
-                    "type": "string"
-                  }
-                ]
-              },
-              {
-                "key": "VIEW",
-                "name": "View",
-                "payloadSchema": [
-                  {
-                    "name": "id",
-                    "type": "string",
-                    "required": true
-                  }
-                ]
-              },
-              {
-                "key": "EDIT",
-                "name": "Edit",
+                "key": "OPEN_CATEGORY",
+                "name": "Open Category",
                 "payloadSchema": [
                   {
                     "name": "id",
                     "type": "string",
                     "required": true
-                  }
-                ]
-              },
-              {
-                "key": "PUBLISH",
-                "name": "Publish",
-                "payloadSchema": [
+                  },
                   {
-                    "name": "id",
-                    "type": "string",
-                    "required": true
+                    "name": "row",
+                    "type": "HelpCategory"
                   }
                 ]
               },
@@ -380,8 +244,12 @@
                 ]
               },
               {
-                "key": "REQUEST_DELETE",
-                "name": "Request Delete",
+                "key": "CLOSE_VIEW",
+                "name": "Close View"
+              },
+              {
+                "key": "PUBLISH",
+                "name": "Publish",
                 "payloadSchema": [
                   {
                     "name": "id",
@@ -411,101 +279,87 @@
                     "render-ui",
                     "main",
                     {
-                      "direction": "vertical",
-                      "align": "center",
                       "className": "py-12",
+                      "gap": "md",
+                      "type": "stack",
+                      "direction": "vertical",
                       "children": [
                         {
                           "type": "spinner"
                         },
                         {
                           "type": "typography",
+                          "variant": "caption",
                           "color": "muted",
-                          "content": "Loading help categories…",
-                          "variant": "caption"
+                          "content": "Loading help categories…"
                         }
                       ],
-                      "type": "stack",
-                      "gap": "md"
+                      "align": "center"
                     }
                   ]
                 ]
               },
               {
                 "from": "loading",
-                "to": "viewing",
+                "to": "browsing",
                 "event": "HelpCategoryLoaded",
                 "effects": [
                   [
                     "render-ui",
                     "main",
                     {
-                      "direction": "vertical",
-                      "gap": "md",
-                      "type": "stack",
                       "children": [
                         {
-                          "type": "stack",
                           "gap": "sm",
                           "align": "center",
+                          "type": "stack",
                           "children": [
                             {
                               "type": "icon",
                               "name": "folder"
                             },
                             {
-                              "type": "typography",
                               "content": "@config.title",
+                              "type": "typography",
                               "variant": "h3"
-                            },
-                            {
-                              "children": {
-                                "type": "icon",
-                                "name": "info"
-                              },
-                              "trigger": "click",
-                              "type": "popover",
-                              "content": {
-                                "type": "typography",
-                                "content": "Categories group related help articles into navigable sections."
-                              },
-                              "position": "bottom"
-                            },
-                            {
-                              "action": "CREATE",
-                              "variant": "primary",
-                              "type": "button",
-                              "label": "New Category"
                             }
                           ],
                           "direction": "horizontal"
                         },
                         {
-                          "columns": 3.0,
-                          "type": "feature-grid",
-                          "items": [
+                          "cols": 4.0,
+                          "children": [
                             {
-                              "description": "Onboarding and first-day setup",
-                              "icon": "rocket",
-                              "title": "Getting Started"
+                              "type": "stat-display",
+                              "label": "Total categories",
+                              "icon": "folder",
+                              "value": "@payload.data.length"
                             },
                             {
-                              "description": "Pricing, invoices, and renewals",
-                              "icon": "credit-card",
-                              "title": "Billing & Plans"
+                              "type": "stat-display",
+                              "icon": "check-circle",
+                              "value": "18",
+                              "label": "Published"
                             },
                             {
-                              "icon": "code",
-                              "title": "API Reference",
-                              "description": "Endpoints, auth, and webhooks"
+                              "type": "stat-display",
+                              "value": "246",
+                              "icon": "book-open",
+                              "label": "Articles"
+                            },
+                            {
+                              "value": "13",
+                              "label": "Avg per category",
+                              "icon": "bar-chart",
+                              "type": "stat-display"
                             }
-                          ]
+                          ],
+                          "type": "simple-grid"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "gap": "sm",
                           "fields": [
                             {
                               "name": "name",
@@ -523,53 +377,43 @@
                               "variant": "caption"
                             },
                             {
-                              "name": "sortOrder",
                               "variant": "caption",
-                              "label": "Order"
+                              "label": "Order",
+                              "name": "sortOrder"
                             },
                             {
-                              "label": "Status",
+                              "variant": "badge",
                               "name": "status",
-                              "variant": "badge"
+                              "label": "Status"
                             },
                             {
+                              "label": "Updated",
                               "name": "updatedAt",
-                              "variant": "caption",
-                              "label": "Updated"
+                              "variant": "caption"
                             }
                           ],
                           "cols": 1.0,
+                          "entity": "@payload.data",
+                          "gap": "sm",
+                          "type": "data-grid",
                           "itemActions": [
                             {
-                              "label": "View",
-                              "variant": "secondary",
-                              "event": "VIEW"
-                            },
-                            {
-                              "event": "EDIT",
-                              "label": "Edit",
-                              "variant": "secondary"
-                            },
-                            {
-                              "event": "PUBLISH",
-                              "label": "Publish",
-                              "variant": "primary"
+                              "event": "OPEN_CATEGORY",
+                              "variant": "primary",
+                              "label": "Open",
+                              "icon": "arrow-right"
                             },
                             {
-                              "variant": "ghost",
                               "label": "Archive",
-                              "event": "ARCHIVE"
-                            },
-                            {
-                              "variant": "danger",
-                              "label": "Delete",
-                              "event": "REQUEST_DELETE"
+                              "event": "ARCHIVE",
+                              "variant": "danger"
                             }
-                          ],
-                          "type": "data-grid",
-                          "entity": "@payload.data"
+                          ]
                         }
-                      ]
+                      ],
+                      "gap": "md",
+                      "direction": "vertical",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -583,64 +427,238 @@
                     "render-ui",
                     "main",
                     {
+                      "type": "alert",
                       "variant": "error",
-                      "message": "@payload.message",
-                      "type": "alert"
+                      "message": "@payload.message"
                     }
                   ]
                 ]
               },
               {
-                "from": "viewing",
-                "to": "loading",
-                "event": "REFRESH",
+                "from": "browsing",
+                "to": "viewing_single",
+                "event": "OPEN_CATEGORY",
                 "effects": [
                   [
-                    "fetch",
-                    "HelpCategory",
-                    {
-                      "emit": {
-                        "failure": "HelpCategoryLoadFailed",
-                        "success": "HelpCategoryLoaded"
-                      }
-                    }
+                    "set",
+                    "@entity.id",
+                    "@payload.row.id"
+                  ],
+                  [
+                    "set",
+                    "@entity.name",
+                    "@payload.row.name"
+                  ],
+                  [
+                    "set",
+                    "@entity.slug",
+                    "@payload.row.slug"
+                  ],
+                  [
+                    "set",
+                    "@entity.description",
+                    "@payload.row.description"
+                  ],
+                  [
+                    "set",
+                    "@entity.icon",
+                    "@payload.row.icon"
+                  ],
+                  [
+                    "set",
+                    "@entity.sortOrder",
+                    "@payload.row.sortOrder"
+                  ],
+                  [
+                    "set",
+                    "@entity.articleCount",
+                    "@payload.row.articleCount"
+                  ],
+                  [
+                    "set",
+                    "@entity.status",
+                    "@payload.row.status"
+                  ],
+                  [
+                    "set",
+                    "@entity.updatedAt",
+                    "@payload.row.updatedAt"
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "direction": "vertical",
                       "gap": "md",
-                      "align": "center",
+                      "type": "stack",
+                      "direction": "vertical",
                       "children": [
                         {
-                          "type": "spinner"
+                          "type": "stack",
+                          "gap": "sm",
+                          "children": [
+                            {
+                              "variant": "ghost",
+                              "label": "Back",
+                              "type": "button",
+                              "action": "CLOSE_VIEW"
+                            },
+                            {
+                              "type": "icon",
+                              "name": "folder"
+                            },
+                            {
+                              "type": "typography",
+                              "content": "@entity.name",
+                              "variant": "h3"
+                            },
+                            {
+                              "label": "@entity.status",
+                              "type": "badge",
+                              "variant": "default"
+                            }
+                          ],
+                          "direction": "horizontal",
+                          "align": "center"
                         },
                         {
-                          "type": "typography",
-                          "content": "Refreshing help categories…",
-                          "variant": "caption",
-                          "color": "muted"
+                          "type": "divider"
+                        },
+                        {
+                          "gap": "sm",
+                          "children": [
+                            {
+                              "type": "stack",
+                              "gap": "md",
+                              "direction": "horizontal",
+                              "children": [
+                                {
+                                  "content": "Slug",
+                                  "type": "typography",
+                                  "variant": "caption",
+                                  "color": "muted"
+                                },
+                                {
+                                  "type": "typography",
+                                  "variant": "body",
+                                  "content": "@entity.slug"
+                                }
+                              ]
+                            },
+                            {
+                              "gap": "md",
+                              "direction": "horizontal",
+                              "children": [
+                                {
+                                  "variant": "caption",
+                                  "color": "muted",
+                                  "type": "typography",
+                                  "content": "Description"
+                                },
+                                {
+                                  "variant": "body",
+                                  "type": "typography",
+                                  "content": "@entity.description"
+                                }
+                              ],
+                              "type": "stack"
+                            },
+                            {
+                              "type": "stack",
+                              "direction": "horizontal",
+                              "children": [
+                                {
+                                  "variant": "caption",
+                                  "content": "Icon",
+                                  "type": "typography",
+                                  "color": "muted"
+                                },
+                                {
+                                  "content": "@entity.icon",
+                                  "type": "typography",
+                                  "variant": "body"
+                                }
+                              ],
+                              "gap": "md"
+                            }
+                          ],
+                          "direction": "vertical",
+                          "type": "stack"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "children": [
+                            {
+                              "icon": "book-open",
+                              "type": "stat-display",
+                              "label": "Articles",
+                              "value": "@entity.articleCount"
+                            },
+                            {
+                              "icon": "list-ordered",
+                              "label": "Sort order",
+                              "type": "stat-display",
+                              "value": "@entity.sortOrder"
+                            },
+                            {
+                              "label": "Updated",
+                              "type": "stat-display",
+                              "icon": "calendar",
+                              "value": "@entity.updatedAt"
+                            }
+                          ],
+                          "type": "simple-grid",
+                          "cols": 3.0
+                        },
+                        {
+                          "type": "stack",
+                          "align": "center",
+                          "direction": "horizontal",
+                          "gap": "sm",
+                          "children": [
+                            {
+                              "variant": "primary",
+                              "actionPayload": {
+                                "id": "@entity.id"
+                              },
+                              "type": "button",
+                              "label": "Publish",
+                              "action": "PUBLISH"
+                            },
+                            {
+                              "action": "ARCHIVE",
+                              "type": "button",
+                              "label": "Archive",
+                              "variant": "danger",
+                              "actionPayload": {
+                                "id": "@entity.id"
+                              }
+                            }
+                          ]
                         }
-                      ],
-                      "type": "stack",
-                      "className": "py-12"
+                      ]
                     }
                   ]
                 ]
               },
               {
-                "from": "viewing",
+                "from": "browsing",
                 "to": "loading",
-                "event": "SEARCH",
+                "event": "ARCHIVE",
                 "effects": [
+                  [
+                    "set",
+                    "@entity.id",
+                    "@payload.id"
+                  ],
                   [
                     "fetch",
                     "HelpCategory",
                     {
                       "emit": {
-                        "success": "HelpCategoryLoaded",
-                        "failure": "HelpCategoryLoadFailed"
+                        "failure": "HelpCategoryLoadFailed",
+                        "success": "HelpCategoryLoaded"
                       }
                     }
                   ],
@@ -648,30 +666,30 @@
                     "render-ui",
                     "main",
                     {
-                      "direction": "vertical",
+                      "align": "center",
+                      "gap": "md",
+                      "className": "py-12",
                       "children": [
                         {
                           "type": "spinner"
                         },
                         {
                           "type": "typography",
+                          "content": "Archiving category…",
                           "variant": "caption",
-                          "content": "Searching help categories…",
                           "color": "muted"
                         }
                       ],
-                      "className": "py-12",
-                      "align": "center",
-                      "gap": "md",
-                      "type": "stack"
+                      "type": "stack",
+                      "direction": "vertical"
                     }
                   ]
                 ]
               },
               {
-                "from": "viewing",
+                "from": "viewing_single",
                 "to": "loading",
-                "event": "FILTER_STATUS",
+                "event": "CLOSE_VIEW",
                 "effects": [
                   [
                     "fetch",
@@ -687,46 +705,30 @@
                     "render-ui",
                     "main",
                     {
-                      "type": "stack",
                       "gap": "md",
+                      "align": "center",
                       "className": "py-12",
+                      "type": "stack",
+                      "direction": "vertical",
                       "children": [
                         {
                           "type": "spinner"
                         },
                         {
-                          "variant": "caption",
                           "color": "muted",
+                          "content": "Loading help categories…",
                           "type": "typography",
-                          "content": "Filtering help categories…"
+                          "variant": "caption"
                         }
-                      ],
-                      "direction": "vertical",
-                      "align": "center"
-                    }
-                  ]
-                ]
-              },
-              {
-                "from": "viewing",
-                "to": "viewing",
-                "event": "CREATE",
-                "effects": [
-                  [
-                    "render-ui",
-                    "main",
-                    {
-                      "variant": "info",
-                      "message": "Creating new help category",
-                      "type": "alert"
+                      ]
                     }
                   ]
                 ]
               },
               {
-                "from": "viewing",
-                "to": "viewing",
-                "event": "VIEW",
+                "from": "viewing_single",
+                "to": "loading",
+                "event": "PUBLISH",
                 "effects": [
                   [
                     "set",
@@ -734,61 +736,42 @@
                     "@payload.id"
                   ],
                   [
-                    "render-ui",
-                    "main",
+                    "fetch",
+                    "HelpCategory",
                     {
-                      "message": "Viewing help category",
-                      "type": "alert",
-                      "variant": "info"
+                      "emit": {
+                        "failure": "HelpCategoryLoadFailed",
+                        "success": "HelpCategoryLoaded"
+                      }
                     }
-                  ]
-                ]
-              },
-              {
-                "from": "viewing",
-                "to": "viewing",
-                "event": "EDIT",
-                "effects": [
-                  [
-                    "set",
-                    "@entity.id",
-                    "@payload.id"
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "variant": "info",
-                      "message": "Editing help category",
-                      "type": "alert"
-                    }
-                  ]
-                ]
-              },
-              {
-                "from": "viewing",
-                "to": "viewing",
-                "event": "PUBLISH",
-                "effects": [
-                  [
-                    "set",
-                    "@entity.id",
-                    "@payload.id"
-                  ],
-                  [
-                    "render-ui",
-                    "main",
-                    {
-                      "message": "Help category published",
-                      "type": "alert",
-                      "variant": "success"
+                      "type": "stack",
+                      "direction": "vertical",
+                      "className": "py-12",
+                      "children": [
+                        {
+                          "type": "spinner"
+                        },
+                        {
+                          "type": "typography",
+                          "variant": "caption",
+                          "content": "Publishing category…",
+                          "color": "muted"
+                        }
+                      ],
+                      "align": "center",
+                      "gap": "md"
                     }
                   ]
                 ]
               },
               {
-                "from": "viewing",
-                "to": "viewing",
+                "from": "viewing_single",
+                "to": "loading",
                 "event": "ARCHIVE",
                 "effects": [
                   [
@@ -797,33 +780,35 @@
                     "@payload.id"
                   ],
                   [
-                    "render-ui",
-                    "main",
+                    "fetch",
+                    "HelpCategory",
                     {
-                      "variant": "info",
-                      "type": "alert",
-                      "message": "Help category archived"
+                      "emit": {
+                        "success": "HelpCategoryLoaded",
+                        "failure": "HelpCategoryLoadFailed"
+                      }
                     }
-                  ]
-                ]
-              },
-              {
-                "from": "viewing",
-                "to": "viewing",
-                "event": "REQUEST_DELETE",
-                "effects": [
-                  [
-                    "set",
-                    "@entity.id",
-                    "@payload.id"
                   ],
                   [
                     "render-ui",
                     "main",
                     {
-                      "variant": "warning",
-                      "message": "Delete requested",
-                      "type": "alert"
+                      "children": [
+                        {
+                          "type": "spinner"
+                        },
+                        {
+                          "variant": "caption",
+                          "content": "Archiving category…",
+                          "color": "muted",
+                          "type": "typography"
+                        }
+                      ],
+                      "align": "center",
+                      "direction": "vertical",
+                      "className": "py-12",
+                      "gap": "md",
+                      "type": "stack"
                     }
                   ]
                 ]
@@ -847,8 +832,8 @@
                     "render-ui",
                     "main",
                     {
-                      "size": "sm",
-                      "type": "spinner"
+                      "type": "spinner",
+                      "size": "sm"
                     }
                   ]
                 ]