@almadar/std 14.24.0 → 14.26.0

package/behaviors/registry/app/organisms/std-public-help-center.orb

@@ -114,28 +114,28 @@
           "ref": "AppShell.traits.AppLayout",
           "name": "HelpCenterAppLayout",
           "config": {
-            "notifications": [],
-            "notificationClickEvent": "HELP_CENTER_NOTIFICATIONS_OPEN",
+            "contentTrait": "@trait.HelpCenterCatalog",
             "appName": "Help Center",
             "searchEvent": "HELP_CENTER_SEARCH",
+            "notifications": [],
+            "notificationClickEvent": "HELP_CENTER_NOTIFICATIONS_OPEN",
             "navItems": [
               {
-                "label": "Help Centers",
                 "href": "/help-centers",
-                "icon": "life-buoy"
+                "icon": "life-buoy",
+                "label": "Help Centers"
               },
               {
+                "href": "/articles",
                 "label": "Articles",
-                "icon": "book-open",
-                "href": "/help-articles"
+                "icon": "book"
               },
               {
-                "href": "/help-categories",
-                "icon": "folder",
-                "label": "Categories"
+                "href": "/categories",
+                "label": "Categories",
+                "icon": "folder"
               }
-            ],
-            "contentTrait": "@trait.HelpCenterCatalog"
+            ]
           },
           "events": {
             "SEARCH": "HELP_CENTER_SEARCH",
@@ -222,12 +222,15 @@
                     "render-ui",
                     "main",
                     {
+                      "type": "stack",
+                      "gap": "lg",
+                      "direction": "vertical",
                       "children": [
                         {
-                          "type": "stack",
+                          "direction": "horizontal",
+                          "gap": "md",
                           "children": [
                             {
-                              "type": "stack",
                               "children": [
                                 {
                                   "type": "icon",
@@ -235,46 +238,46 @@
                                 },
                                 {
                                   "content": "Help Centers",
-                                  "variant": "h2",
-                                  "type": "typography"
+                                  "type": "typography",
+                                  "variant": "h2"
                                 }
                               ],
-                              "align": "center",
+                              "type": "stack",
                               "direction": "horizontal",
+                              "align": "center",
                               "gap": "sm"
                             },
                             {
                               "type": "stack",
-                              "direction": "horizontal",
-                              "gap": "sm",
                               "children": [
                                 {
-                                  "action": "CREATE",
-                                  "label": "New Help Center",
                                   "variant": "primary",
+                                  "label": "New Help Center",
                                   "icon": "plus",
-                                  "type": "button"
+                                  "type": "button",
+                                  "action": "CREATE"
                                 }
-                              ]
+                              ],
+                              "direction": "horizontal",
+                              "gap": "sm"
                             }
                           ],
                           "align": "center",
-                          "direction": "horizontal",
-                          "justify": "between",
-                          "gap": "md"
+                          "type": "stack",
+                          "justify": "between"
                         },
                         {
                           "type": "divider"
                         },
                         {
-                          "gap": "md",
                           "align": "center",
-                          "direction": "horizontal",
                           "type": "stack",
                           "children": [
                             "@trait.HelpCenterSearch",
                             "@trait.HelpCenterFilter"
-                          ]
+                          ],
+                          "gap": "md",
+                          "direction": "horizontal"
                         },
                         "@trait.HelpCenterStats",
                         "@trait.HelpCenterGraphs",
@@ -282,10 +285,7 @@
                           "type": "divider"
                         },
                         "@trait.HelpCenterBrowseList"
-                      ],
-                      "type": "stack",
-                      "direction": "vertical",
-                      "gap": "lg"
+                      ]
                     }
                   ]
                 ]
@@ -304,34 +304,34 @@
                     "render-ui",
                     "main",
                     {
+                      "gap": "md",
+                      "type": "stack",
                       "align": "center",
+                      "className": "py-8",
                       "children": [
                         {
                           "name": "bell",
                           "type": "icon"
                         },
                         {
-                          "content": "No notifications",
                           "type": "typography",
-                          "variant": "h3"
+                          "variant": "h3",
+                          "content": "No notifications"
                         },
                         {
-                          "type": "typography",
                           "color": "muted",
                           "content": "You're all caught up.",
+                          "type": "typography",
                           "variant": "caption"
                         },
                         {
                           "label": "Back to help centers",
+                          "type": "button",
                           "variant": "ghost",
-                          "action": "INIT",
-                          "type": "button"
+                          "action": "INIT"
                         }
                       ],
-                      "direction": "vertical",
-                      "type": "stack",
-                      "gap": "md",
-                      "className": "py-8"
+                      "direction": "vertical"
                     }
                   ]
                 ]
@@ -344,8 +344,8 @@
           "ref": "Search.traits.SearchResultSearch",
           "name": "HelpCenterSearch",
           "config": {
-            "event": "HELP_CENTER_SEARCH",
-            "placeholder": "Search help centers…"
+            "placeholder": "Search help centers…",
+            "event": "HELP_CENTER_SEARCH"
           }
         },
         {
@@ -355,8 +355,8 @@
             "filters": [
               {
                 "filterType": "select",
-                "label": "Status",
                 "field": "status",
+                "label": "Status",
                 "options": [
                   "draft",
                   "published",
@@ -371,18 +371,21 @@
           "ref": "Stats.traits.StatsItemStats",
           "name": "HelpCenterStats",
           "config": {
+            "title": "Help Centers",
             "metrics": [
               {
                 "variant": "primary",
                 "icon": "life-buoy",
+                "format": "number",
                 "label": "Total",
-                "aggregation": "count",
-                "format": "number"
+                "aggregation": "count"
               },
               {
+                "format": "number",
                 "aggregation": "count",
                 "label": "Published",
                 "icon": "check-circle",
+                "variant": "success",
                 "filter": [
                   "fn",
                   "row",
@@ -391,16 +394,14 @@
                     "@row.status",
                     "published"
                   ]
-                ],
-                "variant": "success",
-                "format": "number"
+                ]
               },
               {
                 "label": "Draft",
-                "format": "number",
-                "icon": "edit",
                 "aggregation": "count",
                 "variant": "warning",
+                "format": "number",
+                "icon": "edit",
                 "filter": [
                   "fn",
                   "row",
@@ -412,15 +413,14 @@
                 ]
               },
               {
-                "format": "number",
-                "field": "totalArticles",
-                "aggregation": "sum",
                 "label": "Articles",
                 "icon": "book-open",
-                "variant": "info"
+                "field": "totalArticles",
+                "aggregation": "sum",
+                "variant": "info",
+                "format": "number"
               }
-            ],
-            "title": "Help Centers"
+            ]
           },
           "listens": [
             {
@@ -437,13 +437,13 @@
           "ref": "Graphs.traits.GraphItemGraph",
           "name": "HelpCenterGraphs",
           "config": {
+            "subtitle": "Publication state across managed help centers",
             "categoryField": "status",
+            "chartType": "bar",
             "aggregation": "count",
-            "title": "Help Centers by Status",
-            "subtitle": "Publication state across managed help centers",
             "height": 240.0,
             "showLegend": false,
-            "chartType": "bar"
+            "title": "Help Centers by Status"
           },
           "listens": [
             {
@@ -461,56 +461,56 @@
           "name": "HelpCenterBrowseList",
           "linkedEntity": "HelpCenter",
           "config": {
+            "itemActions": [
+              {
+                "event": "VIEW",
+                "variant": "ghost",
+                "label": "View"
+              },
+              {
+                "event": "EDIT",
+                "variant": "ghost",
+                "label": "Edit"
+              },
+              {
+                "label": "Delete",
+                "event": "DELETE",
+                "variant": "danger"
+              }
+            ],
+            "cols": 1.0,
+            "gap": "sm",
             "fields": [
               {
-                "icon": "life-buoy",
+                "name": "name",
                 "variant": "h3",
-                "name": "name"
+                "icon": "life-buoy"
               },
               {
                 "variant": "caption",
                 "name": "slug"
               },
               {
-                "variant": "caption",
-                "name": "domain"
+                "name": "domain",
+                "variant": "caption"
               },
               {
-                "variant": "badge",
-                "name": "status"
+                "name": "status",
+                "variant": "badge"
               },
               {
-                "name": "totalArticles",
                 "variant": "badge",
-                "format": "number"
+                "format": "number",
+                "name": "totalArticles"
               },
               {
-                "name": "totalCategories",
                 "variant": "caption",
-                "format": "number"
-              },
-              {
-                "name": "lastUpdatedAt",
-                "variant": "caption"
-              }
-            ],
-            "gap": "sm",
-            "cols": 1.0,
-            "itemActions": [
-              {
-                "label": "View",
-                "event": "VIEW",
-                "variant": "ghost"
-              },
-              {
-                "label": "Edit",
-                "variant": "ghost",
-                "event": "EDIT"
+                "format": "number",
+                "name": "totalCategories"
               },
               {
-                "variant": "danger",
-                "event": "DELETE",
-                "label": "Delete"
+                "variant": "caption",
+                "name": "lastUpdatedAt"
               }
             ]
           },
@@ -562,15 +562,15 @@
           "name": "HelpCenterCreate",
           "linkedEntity": "HelpCenter",
           "config": {
+            "icon": "plus-circle",
             "fields": [
               "name",
               "slug",
               "domain",
               "status"
             ],
-            "title": "New Help Center",
             "mode": "create",
-            "icon": "plus-circle"
+            "title": "New Help Center"
           },
           "events": {
             "OPEN": "CREATE"
@@ -591,15 +591,15 @@
           "name": "HelpCenterEdit",
           "linkedEntity": "HelpCenter",
           "config": {
+            "title": "Edit Help Center",
+            "mode": "edit",
             "fields": [
               "name",
               "slug",
               "domain",
               "status"
             ],
-            "icon": "edit",
-            "title": "Edit Help Center",
-            "mode": "edit"
+            "icon": "edit"
           },
           "events": {
             "OPEN": "EDIT"
@@ -620,15 +620,15 @@
           "name": "HelpCenterView",
           "linkedEntity": "HelpCenter",
           "config": {
-            "mode": "edit",
-            "title": "View Help Center",
             "icon": "eye",
+            "mode": "edit",
             "fields": [
               "name",
               "slug",
               "domain",
               "status"
-            ]
+            ],
+            "title": "View Help Center"
           },
           "events": {
             "OPEN": "VIEW"
@@ -649,14 +649,14 @@
           "name": "HelpCenterDelete",
           "linkedEntity": "HelpCenter",
           "config": {
-            "icon": "alert-triangle",
             "alertMessage": "This action cannot be undone.",
+            "icon": "alert-triangle",
             "title": "Delete Help Center",
             "confirmLabel": "Delete"
           },
           "events": {
-            "REQUEST": "DELETE",
-            "CONFIRM": "CONFIRM_DELETE"
+            "CONFIRM": "CONFIRM_DELETE",
+            "REQUEST": "DELETE"
           },
           "listens": [
             {
@@ -897,6 +897,420 @@
           ]
         }
       ]
+    },
+    {
+      "name": "HelpArticlePanelOrbital",
+      "uses": [
+        {
+          "from": "std/behaviors/std-app-layout",
+          "as": "AppShell"
+        },
+        {
+          "from": "std/behaviors/std-help-article",
+          "as": "HelpArticle"
+        }
+      ],
+      "entity": {
+        "name": "HelpArticle",
+        "collection": "helparticles",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "title",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "slug",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "body",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "summary",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "categoryId",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "categoryName",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "author",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "draft",
+            "values": [
+              "draft",
+              "published",
+              "archived",
+              "needs-update"
+            ]
+          },
+          {
+            "name": "viewCount",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "helpfulCount",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "notHelpfulCount",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "publishedAt",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "updatedAt",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "pendingId",
+            "type": "string",
+            "default": ""
+          }
+        ]
+      },
+      "traits": [
+        {
+          "ref": "AppShell.traits.AppLayout",
+          "name": "HelpArticleAppLayout",
+          "config": {
+            "appName": "Help Center",
+            "notificationClickEvent": "HELP_ARTICLE_NOTIFICATIONS_OPEN",
+            "navItems": [
+              {
+                "icon": "book",
+                "label": "Articles",
+                "href": "/articles"
+              },
+              {
+                "label": "Help Centers",
+                "href": "/help-centers",
+                "icon": "life-buoy"
+              },
+              {
+                "href": "/categories",
+                "icon": "folder",
+                "label": "Categories"
+              }
+            ],
+            "notifications": [],
+            "contentTrait": "@trait.HelpArticlePanel",
+            "searchEvent": "HELP_ARTICLE_SEARCH"
+          },
+          "events": {
+            "NOTIFY_CLICK": "HELP_ARTICLE_NOTIFICATIONS_OPEN",
+            "SEARCH": "HELP_ARTICLE_SEARCH"
+          }
+        },
+        {
+          "name": "HelpArticlePanel",
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "composing",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "composing",
+                "to": "composing",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "direction": "vertical",
+                      "type": "stack",
+                      "className": "max-w-6xl mx-auto w-full p-4",
+                      "children": [
+                        {
+                          "type": "stack",
+                          "align": "center",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "book"
+                            },
+                            {
+                              "variant": "h2",
+                              "content": "Help Articles",
+                              "type": "typography"
+                            }
+                          ],
+                          "gap": "sm",
+                          "direction": "horizontal"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        "@trait.HelpArticleView"
+                      ],
+                      "gap": "lg"
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "scope": "instance"
+        },
+        {
+          "ref": "HelpArticle.traits.HelpArticleManage",
+          "name": "HelpArticleView",
+          "config": {
+            "title": "Help Articles"
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "ArticlesPage",
+          "path": "/articles",
+          "traits": [
+            {
+              "ref": "HelpArticleAppLayout"
+            },
+            {
+              "ref": "HelpArticlePanel"
+            },
+            {
+              "ref": "HelpArticleView"
+            }
+          ]
+        }
+      ]
+    },
+    {
+      "name": "HelpCategoryPanelOrbital",
+      "uses": [
+        {
+          "from": "std/behaviors/std-app-layout",
+          "as": "AppShell"
+        },
+        {
+          "from": "std/behaviors/std-help-category",
+          "as": "HelpCategory"
+        }
+      ],
+      "entity": {
+        "name": "HelpCategory",
+        "collection": "helpcategories",
+        "persistence": "persistent",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "name",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "slug",
+            "type": "string",
+            "required": true
+          },
+          {
+            "name": "description",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "icon",
+            "type": "string",
+            "default": "folder"
+          },
+          {
+            "name": "sortOrder",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "articleCount",
+            "type": "number",
+            "default": 0.0
+          },
+          {
+            "name": "status",
+            "type": "string",
+            "default": "draft",
+            "values": [
+              "published",
+              "draft",
+              "archived"
+            ]
+          },
+          {
+            "name": "updatedAt",
+            "type": "string",
+            "default": ""
+          },
+          {
+            "name": "pendingId",
+            "type": "string",
+            "default": ""
+          }
+        ]
+      },
+      "traits": [
+        {
+          "ref": "AppShell.traits.AppLayout",
+          "name": "HelpCategoryAppLayout",
+          "config": {
+            "notificationClickEvent": "HELP_CATEGORY_NOTIFICATIONS_OPEN",
+            "contentTrait": "@trait.HelpCategoryPanel",
+            "searchEvent": "HELP_CATEGORY_SEARCH",
+            "navItems": [
+              {
+                "label": "Categories",
+                "icon": "folder",
+                "href": "/categories"
+              },
+              {
+                "label": "Help Centers",
+                "href": "/help-centers",
+                "icon": "life-buoy"
+              },
+              {
+                "href": "/articles",
+                "icon": "book",
+                "label": "Articles"
+              }
+            ],
+            "notifications": [],
+            "appName": "Help Center"
+          },
+          "events": {
+            "SEARCH": "HELP_CATEGORY_SEARCH",
+            "NOTIFY_CLICK": "HELP_CATEGORY_NOTIFICATIONS_OPEN"
+          }
+        },
+        {
+          "name": "HelpCategoryPanel",
+          "category": "interaction",
+          "stateMachine": {
+            "states": [
+              {
+                "name": "composing",
+                "isInitial": true
+              }
+            ],
+            "events": [
+              {
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "transitions": [
+              {
+                "from": "composing",
+                "to": "composing",
+                "event": "INIT",
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "max-w-6xl mx-auto w-full p-4",
+                      "gap": "lg",
+                      "direction": "vertical",
+                      "children": [
+                        {
+                          "direction": "horizontal",
+                          "children": [
+                            {
+                              "type": "icon",
+                              "name": "folder"
+                            },
+                            {
+                              "type": "typography",
+                              "variant": "h2",
+                              "content": "Help Categories"
+                            }
+                          ],
+                          "type": "stack",
+                          "gap": "sm",
+                          "align": "center"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        "@trait.HelpCategoryView"
+                      ],
+                      "type": "stack"
+                    }
+                  ]
+                ]
+              }
+            ]
+          },
+          "scope": "instance"
+        },
+        {
+          "ref": "HelpCategory.traits.HelpCategoryDirectory",
+          "name": "HelpCategoryView",
+          "config": {
+            "title": "Help Categories"
+          }
+        }
+      ],
+      "pages": [
+        {
+          "name": "CategoriesPage",
+          "path": "/categories",
+          "traits": [
+            {
+              "ref": "HelpCategoryAppLayout"
+            },
+            {
+              "ref": "HelpCategoryPanel"
+            },
+            {
+              "ref": "HelpCategoryView"
+            }
+          ]
+        }
+      ]
     }
   ]
 }