@almadar/std 16.151.0 → 16.152.0

package/behaviors/registry/ui/core/atoms/std-browse.orb

@@ -916,6 +916,22 @@
               "tier": "internal",
               "type": "string"
             },
+            "initialFilterField": {
+              "default": "",
+              "description": "Name the field the INITIAL load filters on, paired with initialFilterValue. This is the detail half of a list-detail pair: a thread that must wait for a conversation to be picked sets the field to its parent key and leaves the value blank, so the first load matches nothing and the empty state shows instead of every record in the table. REFETCH_FILTER then supplies the real selection. Left blank the first load is unfiltered, which is the default.",
+              "label": "Which field does the first load filter on?",
+              "synonyms": "initial filter, first load filter, wait for selection, detail pane filter, requires selection, start empty",
+              "tier": "policy",
+              "type": "string"
+            },
+            "initialFilterValue": {
+              "default": "",
+              "description": "The value initialFilterField must equal on the first load. Blank is meaningful: it matches only records whose field is itself blank, which for a detail pane is normally none — that is how a thread stays empty until its parent is selected.",
+              "label": "What value does the first load filter for?",
+              "synonyms": "initial filter value, first load value, default selection",
+              "tier": "policy",
+              "type": "string"
+            },
             "itemActions": {
               "default": [],
               "description": "Buttons rendered on each row (e.g. Edit, Delete, View).",
@@ -1638,20 +1654,40 @@
                         "success": "BrowseItemLoaded"
                       },
                       "filter": [
-                        "or",
+                        "and",
                         [
-                          "=",
-                          "@config.scopeField",
-                          ""
+                          "or",
+                          [
+                            "=",
+                            "@config.scopeField",
+                            ""
+                          ],
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.scopeField"
+                            ],
+                            "@user.id"
+                          ]
                         ],
                         [
-                          "=",
+                          "or",
                           [
-                            "object/get",
-                            "@entity",
-                            "@config.scopeField"
+                            "=",
+                            "@config.initialFilterField",
+                            ""
                           ],
-                          "@user.id"
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.initialFilterField"
+                            ],
+                            "@config.initialFilterValue"
+                          ]
                         ]
                       ],
                       "limit": "@config.pageSize",
@@ -1779,20 +1815,40 @@
                         "success": "BrowseItemLoaded"
                       },
                       "filter": [
-                        "or",
+                        "and",
                         [
-                          "=",
-                          "@config.scopeField",
-                          ""
+                          "or",
+                          [
+                            "=",
+                            "@config.scopeField",
+                            ""
+                          ],
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.scopeField"
+                            ],
+                            "@user.id"
+                          ]
                         ],
                         [
-                          "=",
+                          "or",
                           [
-                            "object/get",
-                            "@entity",
-                            "@config.scopeField"
+                            "=",
+                            "@config.initialFilterField",
+                            ""
                           ],
-                          "@user.id"
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.initialFilterField"
+                            ],
+                            "@config.initialFilterValue"
+                          ]
                         ]
                       ],
                       "limit": "@config.pageSize",
@@ -2089,20 +2145,40 @@
                         "success": "BrowseItemLoaded"
                       },
                       "filter": [
-                        "or",
+                        "and",
                         [
-                          "=",
-                          "@config.scopeField",
-                          ""
+                          "or",
+                          [
+                            "=",
+                            "@config.scopeField",
+                            ""
+                          ],
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.scopeField"
+                            ],
+                            "@user.id"
+                          ]
                         ],
                         [
-                          "=",
+                          "or",
                           [
-                            "object/get",
-                            "@entity",
-                            "@config.scopeField"
+                            "=",
+                            "@config.initialFilterField",
+                            ""
                           ],
-                          "@user.id"
+                          [
+                            "=",
+                            [
+                              "object/get",
+                              "@entity",
+                              "@config.initialFilterField"
+                            ],
+                            "@config.initialFilterValue"
+                          ]
                         ]
                       ],
                       "limit": "@config.pageSize",
@@ -2153,5 +2229,5 @@
     }
   ],
   "schemaVersion": 1,
-  "version": "2.4.0"
+  "version": "2.5.0"
 }

package/behaviors/registry/ui/core/molecules/ui-data-list.orb

@@ -489,6 +489,23 @@
               "tier": "presentation",
               "type": "string"
             },
+            "sortBy": {
+              "description": "Field name to order rows by. Values are compared by their own type — numbers numerically, date-like strings chronologically, everything else alphabetically — never by what the field is called. Empty cells sort last. Unset leaves the incoming order untouched. Orders only the rows already fetched: a collection larger than its `limit` still needs ordering at the data layer.",
+              "label": "Sort By",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "sortDirection": {
+              "default": "asc",
+              "description": "Direction for `sortBy`. Defaults to ascending.",
+              "label": "Sort Direction",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "asc",
+                "desc"
+              ]
+            },
             "sortable": {
               "description": "Enable in-container reorder; items can be dragged to new positions among siblings",
               "label": "Sortable",
@@ -873,6 +890,8 @@
                       "reorderable": "@config.reorderable",
                       "senderField": "@config.senderField",
                       "senderLabelField": "@config.senderLabelField",
+                      "sortBy": "@config.sortBy",
+                      "sortDirection": "@config.sortDirection",
                       "sortable": "@config.sortable",
                       "swipeLeftActions": "@config.swipeLeftActions",
                       "swipeLeftEvent": "@config.swipeLeftEvent",
@@ -923,6 +942,8 @@
                       "reorderable": "@config.reorderable",
                       "senderField": "@config.senderField",
                       "senderLabelField": "@config.senderLabelField",
+                      "sortBy": "@config.sortBy",
+                      "sortDirection": "@config.sortDirection",
                       "sortable": "@config.sortable",
                       "swipeLeftActions": "@config.swipeLeftActions",
                       "swipeLeftEvent": "@config.swipeLeftEvent",

package/behaviors/registry/ui/game/atoms/ui-draw-group.orb

@@ -0,0 +1,196 @@
+{
+  "description": "DrawGroup — UI factory (1:1 with the @almadar/ui draw-group pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01KYMSJ0XC4FZ6XDMWJFY33XPW": {
+        "bakedName": "DrawGroupItem",
+        "curName": "DrawGroupItem",
+        "id": "ent_01KYMSJ0XC4FZ6XDMWJFY33XPW",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01KYMSJ0XCMQ913RB16GM5PWV3": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01KYMSJ0XCMQ913RB16GM5PWV3",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYMSJ0XCXD36RE50XVZ2PJDP",
+        "renames": []
+      },
+      "orb_01KYMSJ0XCK8CKQ75MKSNFD3JY": {
+        "bakedName": "DrawGroupOrbital",
+        "curName": "DrawGroupOrbital",
+        "id": "orb_01KYMSJ0XCK8CKQ75MKSNFD3JY",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01KYMSJ0XGAMW6KQFWSN214CQZ": {
+        "bakedName": "DrawGroupPage",
+        "curName": "DrawGroupPage",
+        "id": "pag_01KYMSJ0XGAMW6KQFWSN214CQZ",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYMSJ0XCXD36RE50XVZ2PJDP": {
+        "bakedName": "DrawGroupRender",
+        "curName": "DrawGroupRender",
+        "id": "trt_01KYMSJ0XCXD36RE50XVZ2PJDP",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-draw-group",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01KYMSJ0XC4FZ6XDMWJFY33XPW",
+        "name": "DrawGroupItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01KYMSJ0XCK8CKQ75MKSNFD3JY",
+      "name": "DrawGroupOrbital",
+      "pages": [
+        {
+          "id": "pag_01KYMSJ0XGAMW6KQFWSN214CQZ",
+          "name": "DrawGroupPage",
+          "path": "/draw-group",
+          "traits": [
+            {
+              "ref": "DrawGroupRender",
+              "refId": "trt_01KYMSJ0XCXD36RE50XVZ2PJDP"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "items": {
+              "default": [],
+              "description": "The grouped drawables, painted through the normal dispatch.",
+              "items": {
+                "type": "object"
+              },
+              "label": "Items",
+              "tier": "presentation",
+              "type": "[json]"
+            },
+            "opacity": {
+              "description": "0..1 opacity.",
+              "label": "Opacity",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "position": {
+              "default": {
+                "x": 1.0,
+                "y": 1.0,
+                "z": 1.0
+              },
+              "description": "Logical scene position; the projector maps it to pixels / world.",
+              "label": "Position",
+              "properties": {
+                "x": {
+                  "name": "x",
+                  "required": true,
+                  "type": "number"
+                },
+                "y": {
+                  "name": "y",
+                  "required": true,
+                  "type": "number"
+                },
+                "z": {
+                  "name": "z",
+                  "required": false,
+                  "type": "number"
+                }
+              },
+              "tier": "presentation",
+              "type": "DrawGroupPosition"
+            },
+            "rotate": {
+              "description": "Rotation in radians (painter units).",
+              "label": "Rotate",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "scale": {
+              "description": "Uniform scale applied to the whole group.",
+              "label": "Scale",
+              "tier": "presentation",
+              "type": "number"
+            }
+          },
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "DrawGroupItem": "ent_01KYMSJ0XC4FZ6XDMWJFY33XPW"
+          },
+          "id": "trt_01KYMSJ0XCXD36RE50XVZ2PJDP",
+          "linkedEntity": "DrawGroupItem",
+          "linkedEntityId": "ent_01KYMSJ0XC4FZ6XDMWJFY33XPW",
+          "name": "DrawGroupRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01KYMSJ0XCMQ913RB16GM5PWV3",
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "items": "@config.items",
+                      "opacity": "@config.opacity",
+                      "position": "@config.position",
+                      "rotate": "@config.rotate",
+                      "scale": "@config.scale",
+                      "type": "draw-group"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYMSJ0XCMQ913RB16GM5PWV3",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

package/behaviors/registry/ui/game/atoms/ui-draw-shape.orb

@@ -87,6 +87,12 @@
               "tier": "presentation",
               "type": "json"
             },
+            "d": {
+              "description": "SVG path data in world units relative to the cell's projected top-left — same coordinate convention as `points`.",
+              "label": "D",
+              "tier": "presentation",
+              "type": "string"
+            },
             "fill": {
               "description": "fill prop",
               "label": "Fill",
@@ -177,7 +183,8 @@
                 "cell",
                 "rect",
                 "ellipse",
-                "poly"
+                "poly",
+                "path"
               ]
             },
             "stroke": {
@@ -234,6 +241,7 @@
                     "main",
                     {
                       "anchor": "@config.anchor",
+                      "d": "@config.d",
                       "fill": "@config.fill",
                       "height": "@config.height",
                       "offsetX": "@config.offsetX",

package/behaviors/registry/ui/game/atoms/ui-svg-draw-group.orb

@@ -0,0 +1,186 @@
+{
+  "description": "SvgDrawGroup — UI factory (1:1 with the @almadar/ui svg-draw-group pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01KYMKTF35MDDAS1R74C2SG6T5": {
+        "bakedName": "SvgDrawGroupItem",
+        "curName": "SvgDrawGroupItem",
+        "id": "ent_01KYMKTF35MDDAS1R74C2SG6T5",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01KYMKTF3562FXPARGCC220TWE": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01KYMKTF3562FXPARGCC220TWE",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYMKTF35P7FYP2AJB4689VCN",
+        "renames": []
+      },
+      "orb_01KYMKTF35FTQ5Y8HCZBQPYVZ4": {
+        "bakedName": "SvgDrawGroupOrbital",
+        "curName": "SvgDrawGroupOrbital",
+        "id": "orb_01KYMKTF35FTQ5Y8HCZBQPYVZ4",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01KYMKTF36J0SESNTGYJ55AZTF": {
+        "bakedName": "SvgDrawGroupPage",
+        "curName": "SvgDrawGroupPage",
+        "id": "pag_01KYMKTF36J0SESNTGYJ55AZTF",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYMKTF35P7FYP2AJB4689VCN": {
+        "bakedName": "SvgDrawGroupRender",
+        "curName": "SvgDrawGroupRender",
+        "id": "trt_01KYMKTF35P7FYP2AJB4689VCN",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-svg-draw-group",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01KYMKTF35MDDAS1R74C2SG6T5",
+        "name": "SvgDrawGroupItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01KYMKTF35FTQ5Y8HCZBQPYVZ4",
+      "name": "SvgDrawGroupOrbital",
+      "pages": [
+        {
+          "id": "pag_01KYMKTF36J0SESNTGYJ55AZTF",
+          "name": "SvgDrawGroupPage",
+          "path": "/svg-draw-group",
+          "traits": [
+            {
+              "ref": "SvgDrawGroupRender",
+              "refId": "trt_01KYMKTF35P7FYP2AJB4689VCN"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "children": {
+              "description": "children prop",
+              "label": "Children",
+              "tier": "presentation",
+              "type": "node"
+            },
+            "className": {
+              "description": "Additional CSS classes",
+              "label": "Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "opacity": {
+              "description": "0..1 opacity.",
+              "label": "Opacity",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "rotate": {
+              "description": "Rotation in degrees applied after the translate.",
+              "label": "Rotate",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "scale": {
+              "description": "Uniform scale applied after the translate.",
+              "label": "Scale",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "x": {
+              "default": 0.0,
+              "description": "Grid-cell x of the group's origin.",
+              "label": "X",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "y": {
+              "default": 0.0,
+              "description": "Grid-cell y of the group's origin.",
+              "label": "Y",
+              "tier": "presentation",
+              "type": "number"
+            }
+          },
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "SvgDrawGroupItem": "ent_01KYMKTF35MDDAS1R74C2SG6T5"
+          },
+          "id": "trt_01KYMKTF35P7FYP2AJB4689VCN",
+          "linkedEntity": "SvgDrawGroupItem",
+          "linkedEntityId": "ent_01KYMKTF35MDDAS1R74C2SG6T5",
+          "name": "SvgDrawGroupRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01KYMKTF3562FXPARGCC220TWE",
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": "@config.children",
+                      "className": "@config.className",
+                      "opacity": "@config.opacity",
+                      "rotate": "@config.rotate",
+                      "scale": "@config.scale",
+                      "type": "svg-draw-group",
+                      "x": "@config.x",
+                      "y": "@config.y"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYMKTF3562FXPARGCC220TWE",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}