@almadar/std 16.191.0 → 16.193.0

package/behaviors/registry/ui/core/atoms/std-tag-taxonomy.orb

@@ -64,6 +64,60 @@
         "parent": "trt_01KXG04HRH1T6RA6R9NY1XQC4J",
         "renames": []
       },
+      "evt_01M169QR0DBCS40K2H653NK3BC": {
+        "bakedName": "CANCEL_TAG",
+        "curName": "CANCEL_TAG",
+        "id": "evt_01M169QR0DBCS40K2H653NK3BC",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04HRH1T6RA6R9NY1XQC4J",
+        "renames": []
+      },
+      "evt_01M169QR0DBSS6H2VC2G50TM37": {
+        "bakedName": "COMMIT_TAG",
+        "curName": "COMMIT_TAG",
+        "id": "evt_01M169QR0DBSS6H2VC2G50TM37",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04HRH1T6RA6R9NY1XQC4J",
+        "renames": []
+      },
+      "evt_01M169QR0DC8SC439BREC46BQN": {
+        "bakedName": "TagCreateFailed",
+        "curName": "TagCreateFailed",
+        "id": "evt_01M169QR0DC8SC439BREC46BQN",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04HRH1T6RA6R9NY1XQC4J",
+        "renames": []
+      },
+      "evt_01M169QR0DYJMCCP7409YMSH6A": {
+        "bakedName": "NEW_TAG",
+        "curName": "NEW_TAG",
+        "id": "evt_01M169QR0DYJMCCP7409YMSH6A",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04HRH1T6RA6R9NY1XQC4J",
+        "renames": []
+      },
+      "evt_01M169QR0DZVZ04SDSQ1PSM3HR": {
+        "bakedName": "TagCreated",
+        "curName": "TagCreated",
+        "id": "evt_01M169QR0DZVZ04SDSQ1PSM3HR",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04HRH1T6RA6R9NY1XQC4J",
+        "renames": []
+      },
+      "evt_01M169RXDREJ5T7B8PWGVZEPP8": {
+        "bakedName": "LEVEL_RELOAD",
+        "curName": "LEVEL_RELOAD",
+        "id": "evt_01M169RXDREJ5T7B8PWGVZEPP8",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04HRH1T6RA6R9NY1XQC4J",
+        "renames": []
+      },
       "orb_01KXG04HRHG7GH6G42W4QW139F": {
         "bakedName": "TagTaxonomyOrbital",
         "curName": "TagTaxonomyOrbital",
@@ -169,11 +223,27 @@
           "config": {
             "allowEdit": {
               "default": false,
-              "description": "Show inline controls to create or rename tags",
+              "description": "Render the create-tag affordance: creations land at the level currently open (top level, or inside the drilled-into category). Rename is a follow-up (ledgered).",
               "label": "Allow editing",
               "tier": "domain",
               "type": "boolean"
             },
+            "createLabel": {
+              "default": "New tag",
+              "description": "Label on the create affordance and its form heading — say what this taxonomy calls its entries (New tag, New category, New topic).",
+              "label": "Create-button label",
+              "synonyms": "add label, new tag label, create caption",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "rootLabel": {
+              "default": "All tags",
+              "description": "Label on the back affordance that returns from a drilled-in level to the root — phrase it in this taxonomy's vocabulary (All tags, All categories).",
+              "label": "Back-to-root label",
+              "synonyms": "back label, root caption, all label",
+              "tier": "presentation",
+              "type": "string"
+            },
             "tableLook": {
               "default": "dense",
               "description": "Layer 2 visual treatment for the data table rendered by this atom.",
@@ -254,6 +324,119 @@
               ],
               "synonyms": "chosen, picked, activated, highlighted",
               "tier": "domain"
+            },
+            {
+              "description": "Opens the create-tag form (rendered only when allowEdit is on); the creation lands at the level currently open.",
+              "event": "NEW_TAG",
+              "eventId": "evt_01M169QR0DYJMCCP7409YMSH6A",
+              "synonyms": "add tag, create category, new category",
+              "tier": "domain"
+            },
+            {
+              "description": "The new-category form committed; data carries the name and the parent level.",
+              "event": "COMMIT_TAG",
+              "eventId": "evt_01M169QR0DBSS6H2VC2G50TM37",
+              "payloadSchema": [
+                {
+                  "name": "data",
+                  "properties": [
+                    {
+                      "name": "name",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "parentId",
+                      "type": "string"
+                    }
+                  ],
+                  "type": "object"
+                }
+              ],
+              "synonyms": "save tag, create tag",
+              "tier": "internal"
+            },
+            {
+              "description": "The new-category form was dismissed without creating.",
+              "event": "CANCEL_TAG",
+              "eventId": "evt_01M169QR0DBCS40K2H653NK3BC",
+              "synonyms": "cancel, back",
+              "tier": "internal"
+            },
+            {
+              "description": "Internal hop that refetches the open level after the new-category form closes (a fetch filter cannot read trait state, so the level travels by payload).",
+              "event": "LEVEL_RELOAD",
+              "eventId": "evt_01M169RXDREJ5T7B8PWGVZEPP8",
+              "payloadSchema": [
+                {
+                  "name": "tagId",
+                  "type": "string"
+                }
+              ],
+              "synonyms": "reload level, refresh",
+              "tier": "internal"
+            },
+            {
+              "description": "A new tag row persisted; the open level refetches to show it.",
+              "event": "TagCreated",
+              "eventId": "evt_01M169QR0DZVZ04SDSQ1PSM3HR",
+              "payloadSchema": [
+                {
+                  "name": "row",
+                  "properties": [
+                    {
+                      "name": "id",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "name",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "parentId",
+                      "type": "Tag"
+                    },
+                    {
+                      "name": "slug",
+                      "type": "string"
+                    },
+                    {
+                      "name": "color",
+                      "type": "string"
+                    },
+                    {
+                      "name": "count",
+                      "type": "number"
+                    },
+                    {
+                      "name": "createdAt",
+                      "type": "string"
+                    }
+                  ],
+                  "type": "object"
+                }
+              ],
+              "synonyms": "created, added",
+              "tier": "internal"
+            },
+            {
+              "description": "The tag create failed.",
+              "event": "TagCreateFailed",
+              "eventId": "evt_01M169QR0DC8SC439BREC46BQN",
+              "payloadSchema": [
+                {
+                  "name": "error",
+                  "type": "string"
+                },
+                {
+                  "name": "code",
+                  "type": "string"
+                }
+              ],
+              "synonyms": "error, failure",
+              "tier": "internal"
             }
           ],
           "entityRefIds": {
@@ -266,6 +449,20 @@
           "scope": "collection",
           "stateMachine": {
             "events": [
+              {
+                "description": "Internal hop that refetches the open level after the new-category form closes (a fetch filter cannot read trait state, so the level travels by payload).",
+                "id": "evt_01M169RXDREJ5T7B8PWGVZEPP8",
+                "key": "LEVEL_RELOAD",
+                "name": "Level Reload",
+                "payloadSchema": [
+                  {
+                    "name": "tagId",
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "reload level, refresh",
+                "tier": "internal"
+              },
               {
                 "id": "evt_01KXG04HRHZ7R8AVV6NCG6FC0S",
                 "key": "INIT",
@@ -323,6 +520,79 @@
                 "key": "SHOW_ROOT",
                 "name": "Show Root"
               },
+              {
+                "description": "Opens the create-tag form (rendered only when allowEdit is on); the creation lands at the level currently open.",
+                "id": "evt_01M169QR0DYJMCCP7409YMSH6A",
+                "key": "NEW_TAG",
+                "name": "New Tag",
+                "synonyms": "add tag, create category, new category",
+                "tier": "domain"
+              },
+              {
+                "description": "The new-category form committed; data carries the name and the parent level.",
+                "id": "evt_01M169QR0DBSS6H2VC2G50TM37",
+                "key": "COMMIT_TAG",
+                "name": "Commit Tag",
+                "payloadSchema": [
+                  {
+                    "name": "data",
+                    "properties": [
+                      {
+                        "name": "name",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "parentId",
+                        "type": "string"
+                      }
+                    ],
+                    "type": "object"
+                  }
+                ],
+                "synonyms": "save tag, create tag",
+                "tier": "internal"
+              },
+              {
+                "description": "The new-category form was dismissed without creating.",
+                "id": "evt_01M169QR0DBCS40K2H653NK3BC",
+                "key": "CANCEL_TAG",
+                "name": "Cancel Tag",
+                "synonyms": "cancel, back",
+                "tier": "internal"
+              },
+              {
+                "description": "A new tag row persisted; the open level refetches to show it.",
+                "id": "evt_01M169QR0DZVZ04SDSQ1PSM3HR",
+                "key": "TagCreated",
+                "name": "Tag created",
+                "payloadSchema": [
+                  {
+                    "name": "row",
+                    "type": "Tag"
+                  }
+                ],
+                "synonyms": "created, added",
+                "tier": "internal"
+              },
+              {
+                "description": "The tag create failed.",
+                "id": "evt_01M169QR0DC8SC439BREC46BQN",
+                "key": "TagCreateFailed",
+                "name": "Tag create failed",
+                "payloadSchema": [
+                  {
+                    "name": "error",
+                    "type": "string"
+                  },
+                  {
+                    "name": "code",
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "error, failure",
+                "tier": "internal"
+              },
               {
                 "description": "Signals a tag has been chosen for further exploration.",
                 "id": "evt_01KXG04HRKGA5B1JAYP300FR4C",
@@ -347,6 +617,9 @@
               {
                 "name": "browsing"
               },
+              {
+                "name": "creating"
+              },
               {
                 "name": "editing"
               },
@@ -355,6 +628,37 @@
               }
             ],
             "transitions": [
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "Tag",
+                    {
+                      "emit": {
+                        "failure": "TagLoadFailed",
+                        "success": "TagLoaded"
+                      },
+                      "filter": [
+                        "=",
+                        [
+                          "object/get",
+                          "@entity",
+                          "parentId"
+                        ],
+                        [
+                          "str/default",
+                          "@payload.tagId",
+                          ""
+                        ]
+                      ]
+                    }
+                  ]
+                ],
+                "event": "LEVEL_RELOAD",
+                "eventId": "evt_01M169RXDREJ5T7B8PWGVZEPP8",
+                "from": "loading",
+                "to": "loading"
+              },
               {
                 "effects": [
                   [
@@ -397,7 +701,7 @@
                         },
                         {
                           "color": "muted",
-                          "content": "Loading categories…",
+                          "content": "Loading…",
                           "type": "typography",
                           "variant": "caption"
                         }
@@ -434,7 +738,7 @@
                             true
                           ],
                           "icon": "arrow-left",
-                          "label": "All categories",
+                          "label": "@config.rootLabel",
                           "size": "sm",
                           "type": "button",
                           "variant": "ghost"
@@ -444,6 +748,19 @@
                           "type": "typography",
                           "variant": "h3"
                         },
+                        [
+                          "if",
+                          "@config.allowEdit",
+                          {
+                            "action": "NEW_TAG",
+                            "icon": "plus",
+                            "label": "@config.createLabel",
+                            "size": "sm",
+                            "type": "button",
+                            "variant": "secondary"
+                          },
+                          null
+                        ],
                         {
                           "entity": "@payload.data",
                           "fields": [],
@@ -589,7 +906,7 @@
                         },
                         {
                           "color": "muted",
-                          "content": "Loading categories…",
+                          "content": "Loading…",
                           "type": "typography",
                           "variant": "caption"
                         }
@@ -655,7 +972,7 @@
                         },
                         {
                           "color": "muted",
-                          "content": "Loading children…",
+                          "content": "Loading…",
                           "type": "typography",
                           "variant": "caption"
                         }
@@ -714,7 +1031,7 @@
                         },
                         {
                           "color": "muted",
-                          "content": "Loading categories…",
+                          "content": "Loading…",
                           "type": "typography",
                           "variant": "caption"
                         }
@@ -751,7 +1068,7 @@
                             true
                           ],
                           "icon": "arrow-left",
-                          "label": "All categories",
+                          "label": "@config.rootLabel",
                           "size": "sm",
                           "type": "button",
                           "variant": "ghost"
@@ -761,6 +1078,19 @@
                           "type": "typography",
                           "variant": "h3"
                         },
+                        [
+                          "if",
+                          "@config.allowEdit",
+                          {
+                            "action": "NEW_TAG",
+                            "icon": "plus",
+                            "label": "@config.createLabel",
+                            "size": "sm",
+                            "type": "button",
+                            "variant": "secondary"
+                          },
+                          null
+                        ],
                         {
                           "entity": "@payload.data",
                           "fields": [],
@@ -847,6 +1177,61 @@
                 "from": "browsing",
                 "to": "browsing"
               },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    {
+                      "children": [
+                        {
+                          "content": "@config.createLabel",
+                          "type": "typography",
+                          "variant": "h3"
+                        },
+                        {
+                          "color": "muted",
+                          "content": [
+                            "if",
+                            [
+                              "!=",
+                              "@entity.id",
+                              ""
+                            ],
+                            "Created inside the open category.",
+                            "Created at the top level."
+                          ],
+                          "type": "typography",
+                          "variant": "caption"
+                        },
+                        {
+                          "type": "divider"
+                        },
+                        {
+                          "cancelEvent": "CANCEL_TAG",
+                          "entity": {
+                            "parentId": "@entity.id"
+                          },
+                          "fields": [
+                            "name"
+                          ],
+                          "mode": "create",
+                          "submitEvent": "COMMIT_TAG",
+                          "type": "form-section"
+                        }
+                      ],
+                      "direction": "vertical",
+                      "gap": "md",
+                      "type": "stack"
+                    }
+                  ]
+                ],
+                "event": "NEW_TAG",
+                "eventId": "evt_01M169QR0DYJMCCP7409YMSH6A",
+                "from": "browsing",
+                "guard": "@config.allowEdit",
+                "to": "creating"
+              },
               {
                 "effects": [
                   [
@@ -864,6 +1249,162 @@
                 "from": "browsing",
                 "to": "error"
               },
+              {
+                "effects": [
+                  [
+                    "persist",
+                    "create",
+                    "Tag",
+                    {
+                      "name": [
+                        "object/get",
+                        "@payload.data",
+                        "name"
+                      ],
+                      "parentId": [
+                        "str/default",
+                        [
+                          "object/get",
+                          "@payload.data",
+                          "parentId"
+                        ],
+                        ""
+                      ]
+                    },
+                    {
+                      "emit": {
+                        "failure": "TagCreateFailed",
+                        "success": "TagCreated"
+                      }
+                    }
+                  ]
+                ],
+                "event": "COMMIT_TAG",
+                "eventId": "evt_01M169QR0DBSS6H2VC2G50TM37",
+                "from": "creating",
+                "to": "creating"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "spinner"
+                        },
+                        {
+                          "color": "muted",
+                          "content": "Loading…",
+                          "type": "typography",
+                          "variant": "caption"
+                        }
+                      ],
+                      "className": "py-12",
+                      "direction": "vertical",
+                      "gap": "md",
+                      "type": "stack"
+                    }
+                  ],
+                  [
+                    "emit",
+                    "LEVEL_RELOAD",
+                    {
+                      "tagId": "@entity.id"
+                    }
+                  ]
+                ],
+                "event": "CANCEL_TAG",
+                "eventId": "evt_01M169QR0DBCS40K2H653NK3BC",
+                "from": "creating",
+                "to": "loading"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    null
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "align": "center",
+                      "children": [
+                        {
+                          "type": "spinner"
+                        },
+                        {
+                          "color": "muted",
+                          "content": "Loading…",
+                          "type": "typography",
+                          "variant": "caption"
+                        }
+                      ],
+                      "className": "py-12",
+                      "direction": "vertical",
+                      "gap": "md",
+                      "type": "stack"
+                    }
+                  ],
+                  [
+                    "fetch",
+                    "Tag",
+                    {
+                      "emit": {
+                        "failure": "TagLoadFailed",
+                        "success": "TagLoaded"
+                      },
+                      "filter": [
+                        "=",
+                        [
+                          "object/get",
+                          "@entity",
+                          "parentId"
+                        ],
+                        [
+                          "str/default",
+                          [
+                            "object/get",
+                            "@payload.row",
+                            "parentId"
+                          ],
+                          ""
+                        ]
+                      ]
+                    }
+                  ]
+                ],
+                "event": "TagCreated",
+                "eventId": "evt_01M169QR0DZVZ04SDSQ1PSM3HR",
+                "from": "creating",
+                "to": "loading"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    {
+                      "message": "@payload.error",
+                      "type": "alert",
+                      "variant": "error"
+                    }
+                  ]
+                ],
+                "event": "TagCreateFailed",
+                "eventId": "evt_01M169QR0DC8SC439BREC46BQN",
+                "from": "creating",
+                "to": "creating"
+              },
               {
                 "effects": [
                   [
@@ -906,7 +1447,7 @@
                         },
                         {
                           "color": "muted",
-                          "content": "Loading categories…",
+                          "content": "Loading…",
                           "type": "typography",
                           "variant": "caption"
                         }
@@ -986,7 +1527,7 @@
                             true
                           ],
                           "icon": "arrow-left",
-                          "label": "All categories",
+                          "label": "@config.rootLabel",
                           "size": "sm",
                           "type": "button",
                           "variant": "ghost"
@@ -996,6 +1537,19 @@
                           "type": "typography",
                           "variant": "h3"
                         },
+                        [
+                          "if",
+                          "@config.allowEdit",
+                          {
+                            "action": "NEW_TAG",
+                            "icon": "plus",
+                            "label": "@config.createLabel",
+                            "size": "sm",
+                            "type": "button",
+                            "variant": "secondary"
+                          },
+                          null
+                        ],
                         {
                           "entity": "@payload.data",
                           "fields": [],
@@ -1141,7 +1695,7 @@
                         },
                         {
                           "color": "muted",
-                          "content": "Loading categories…",
+                          "content": "Loading…",
                           "type": "typography",
                           "variant": "caption"
                         }