@almadar/std 16.191.0 → 16.192.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,7 +223,7 @@
           "config": {
             "allowEdit": {
               "default": false,
-              "description": "Show inline controls to create or rename tags",
+              "description": "Render the New-category 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"
@@ -254,6 +308,119 @@
               ],
               "synonyms": "chosen, picked, activated, highlighted",
               "tier": "domain"
+            },
+            {
+              "description": "Opens the new-category 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 +433,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 +504,79 @@
                 "key": "SHOW_ROOT",
                 "name": "Show Root"
               },
+              {
+                "description": "Opens the new-category 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 +601,9 @@
               {
                 "name": "browsing"
               },
+              {
+                "name": "creating"
+              },
               {
                 "name": "editing"
               },
@@ -355,6 +612,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": [
                   [
@@ -444,6 +732,19 @@
                           "type": "typography",
                           "variant": "h3"
                         },
+                        [
+                          "if",
+                          "@config.allowEdit",
+                          {
+                            "action": "NEW_TAG",
+                            "icon": "plus",
+                            "label": "New category",
+                            "size": "sm",
+                            "type": "button",
+                            "variant": "secondary"
+                          },
+                          null
+                        ],
                         {
                           "entity": "@payload.data",
                           "fields": [],
@@ -761,6 +1062,19 @@
                           "type": "typography",
                           "variant": "h3"
                         },
+                        [
+                          "if",
+                          "@config.allowEdit",
+                          {
+                            "action": "NEW_TAG",
+                            "icon": "plus",
+                            "label": "New category",
+                            "size": "sm",
+                            "type": "button",
+                            "variant": "secondary"
+                          },
+                          null
+                        ],
                         {
                           "entity": "@payload.data",
                           "fields": [],
@@ -847,6 +1161,61 @@
                 "from": "browsing",
                 "to": "browsing"
               },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "modal",
+                    {
+                      "children": [
+                        {
+                          "content": "New category",
+                          "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 +1233,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 categories…",
+                          "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 categories…",
+                          "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": [
                   [
@@ -996,6 +1521,19 @@
                           "type": "typography",
                           "variant": "h3"
                         },
+                        [
+                          "if",
+                          "@config.allowEdit",
+                          {
+                            "action": "NEW_TAG",
+                            "icon": "plus",
+                            "label": "New category",
+                            "size": "sm",
+                            "type": "button",
+                            "variant": "secondary"
+                          },
+                          null
+                        ],
                         {
                           "entity": "@payload.data",
                           "fields": [],

package/behaviors/registry/ui/core/atoms/std-version-history.orb

@@ -1244,7 +1244,11 @@
                               "label": "Document",
                               "look": "@config.statLook",
                               "type": "stat-display",
-                              "value": "@entity.documentId"
+                              "value": [
+                                "str/default",
+                                "@entity.summary",
+                                ""
+                              ]
                             },
                             {
                               "icon": "layers",

package/behaviors/registry/ui/core/molecules/ui-calendar-grid.orb

@@ -224,6 +224,13 @@
               "tier": "presentation",
               "type": "string"
             },
+            "selfFetch": {
+              "default": true,
+              "description": "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's.",
+              "label": "Fetch its own rows on mount?",
+              "tier": "internal",
+              "type": "boolean"
+            },
             "startField": {
               "default": "startTime",
               "description": "Row field holding the start timestamp (ISO or epoch). Defaults to `startTime`.",
@@ -540,6 +547,42 @@
                 "event": "INIT",
                 "eventId": "evt_01KXG04MY9M975Q1NST2R49XDA",
                 "from": "idle",
+                "guard": "@config.selfFetch",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "colorField": "@config.colorField",
+                      "dayWindow": "@config.dayWindow",
+                      "endField": "@config.endField",
+                      "events": "@entity",
+                      "longPressEvent": "@config.longPressEvent",
+                      "longPressPayload": "@config.longPressPayload",
+                      "onDayClick": "@config.onDayClick",
+                      "onEventClick": "@config.onEventClick",
+                      "onSlotClick": "@config.onSlotClick",
+                      "startField": "@config.startField",
+                      "swipeLeftEvent": "@config.swipeLeftEvent",
+                      "swipeRightEvent": "@config.swipeRightEvent",
+                      "timeSlots": "@config.timeSlots",
+                      "titleField": "@config.titleField",
+                      "type": "calendar-grid",
+                      "weekStart": "@config.weekStart"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KXG04MY9M975Q1NST2R49XDA",
+                "from": "idle",
+                "guard": [
+                  "not",
+                  "@config.selfFetch"
+                ],
                 "to": "idle"
               },
               {