@almadar/std 16.182.0 → 16.184.0

package/behaviors/registry/ui/core/molecules/ui-file-tree.orb

@@ -102,6 +102,38 @@
               "tier": "presentation",
               "type": "number"
             },
+            "items": {
+              "default": [],
+              "description": "Flat node list, nested by `parentId` at render time — takes precedence over `tree` when provided. A `parentId` with no matching row renders that node as a root rather than dropping it.",
+              "items": {
+                "properties": {
+                  "icon": {
+                    "name": "icon",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "id": {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "parentId": {
+                    "name": "parentId",
+                    "required": false,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Items",
+              "tier": "presentation",
+              "type": "[FileTreeItemsItem]"
+            },
             "onFileSelect": {
               "default": "FILE_SELECT",
               "description": "Called when a file is clicked",
@@ -109,6 +141,13 @@
               "tier": "presentation",
               "type": "string"
             },
+            "onNodeSelect": {
+              "default": "",
+              "description": "Called when a node is clicked, in flat `items` mode; carries the selected node's id. Presence-gated: binding this prop is what turns on the click-to-select affordance, mirroring Badge's `onRemove`.",
+              "label": "On Node Select",
+              "tier": "presentation",
+              "type": "string"
+            },
             "selectedPath": {
               "description": "Currently selected file path",
               "label": "Selected Path",
@@ -116,25 +155,8 @@
               "type": "string"
             },
             "tree": {
-              "default": [
-                {
-                  "children": [],
-                  "language": "Language",
-                  "name": "Name",
-                  "path": "Path",
-                  "size": 1.0,
-                  "type": "file"
-                },
-                {
-                  "children": [],
-                  "language": "Language 2",
-                  "name": "Name 2",
-                  "path": "Path 2",
-                  "size": 2.0,
-                  "type": "dir"
-                }
-              ],
-              "description": "The tree data",
+              "default": [],
+              "description": "The tree data (pre-nested). Ignored when `items` is provided.",
               "items": {
                 "properties": {
                   "children": {
@@ -246,7 +268,9 @@
                     {
                       "className": "@config.className",
                       "indent": "@config.indent",
+                      "items": "@config.items",
                       "onFileSelect": "@config.onFileSelect",
+                      "onNodeSelect": "@config.onNodeSelect",
                       "selectedPath": "@config.selectedPath",
                       "tree": "@config.tree",
                       "type": "file-tree"

package/behaviors/registry/ui/core/organisms/ui-detail-panel.orb

@@ -246,7 +246,10 @@
                 {
                   "header": "Header",
                   "key": "Key",
-                  "relation": "Relation",
+                  "relation": {
+                    "cardinality": "one",
+                    "entity": "Entity"
+                  },
                   "type": "Type",
                   "values": [
                     "Item",
@@ -256,7 +259,10 @@
                 {
                   "header": "Header 2",
                   "key": "Key 2",
-                  "relation": "Relation 2",
+                  "relation": {
+                    "cardinality": "many",
+                    "entity": "Entity 2"
+                  },
                   "type": "Type 2",
                   "values": [
                     "Item",
@@ -279,8 +285,27 @@
                   },
                   "relation": {
                     "name": "relation",
+                    "properties": {
+                      "cardinality": {
+                        "name": "cardinality",
+                        "required": false,
+                        "type": "string",
+                        "values": [
+                          "one",
+                          "many",
+                          "one-to-many",
+                          "many-to-one",
+                          "many-to-many"
+                        ]
+                      },
+                      "entity": {
+                        "name": "entity",
+                        "required": true,
+                        "type": "string"
+                      }
+                    },
                     "required": false,
-                    "type": "string"
+                    "type": "object"
                   },
                   "type": {
                     "name": "type",

package/behaviors/registry/ui/core/organisms/ui-form-section.orb

@@ -432,7 +432,10 @@
                         "type": "string",
                         "values": [
                           "one",
-                          "many"
+                          "many",
+                          "one-to-many",
+                          "many-to-one",
+                          "many-to-many"
                         ]
                       },
                       "displayField": {
@@ -738,7 +741,10 @@
                               "type": "string",
                               "values": [
                                 "one",
-                                "many"
+                                "many",
+                                "one-to-many",
+                                "many-to-one",
+                                "many-to-many"
                               ]
                             },
                             "displayField": {

package/behaviors/registry/ui/core/organisms/ui-form.orb

@@ -432,7 +432,10 @@
                         "type": "string",
                         "values": [
                           "one",
-                          "many"
+                          "many",
+                          "one-to-many",
+                          "many-to-one",
+                          "many-to-many"
                         ]
                       },
                       "displayField": {
@@ -738,7 +741,10 @@
                               "type": "string",
                               "values": [
                                 "one",
-                                "many"
+                                "many",
+                                "one-to-many",
+                                "many-to-one",
+                                "many-to-many"
                               ]
                             },
                             "displayField": {

package/behaviors/registry/ui/game/atoms/std-fx-trail.orb

@@ -0,0 +1,376 @@
+{
+  "description": "Headless motion-trail mechanic: records the moving body's recent positions as timestamped dots on a [runtime, shared] entity so the render layer can draw a fading comet trail. Rides the body authority's BODY_MOVED — appends a dot only when the body's speed exceeds minSpeed (standing still leaves no trail) and prunes dots older than ttl on the same pass, so no decay tick is needed and a stopped body's trail simply stops growing (the render side fades each dot by bornAt/ttl). RESTART clears. Renders nothing.",
+  "ledger": {
+    "entries": {
+      "ent_01M0PCAKRAB0PFSPQ98X9S0BNF": {
+        "bakedName": "FxTrailData",
+        "curName": "FxTrailData",
+        "id": "ent_01M0PCAKRAB0PFSPQ98X9S0BNF",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M0PCAKRA14YFRZZGT8CDR3BE": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M0PCAKRA14YFRZZGT8CDR3BE",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0PCAKRAJE43ZB66D52QJSGZ",
+        "renames": []
+      },
+      "evt_01M0PCAKRAK7M2V40695X450BC": {
+        "bakedName": "RESTART",
+        "curName": "RESTART",
+        "id": "evt_01M0PCAKRAK7M2V40695X450BC",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0PCAKRAJE43ZB66D52QJSGZ",
+        "renames": []
+      },
+      "evt_01M0PCAKRAWHX8VG91V45K7YYE": {
+        "bakedName": "BODY_MOVED",
+        "curName": "BODY_MOVED",
+        "id": "evt_01M0PCAKRAWHX8VG91V45K7YYE",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0PCAKRAJE43ZB66D52QJSGZ",
+        "renames": []
+      },
+      "orb_01M0PCAKRAXW91Y5Y34VV62FV0": {
+        "bakedName": "FxTrailOrbital",
+        "curName": "FxTrailOrbital",
+        "id": "orb_01M0PCAKRAXW91Y5Y34VV62FV0",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M0PCAKRAY62QVZS832H2XSWS": {
+        "bakedName": "FxTrailPage",
+        "curName": "FxTrailPage",
+        "id": "pag_01M0PCAKRAY62QVZS832H2XSWS",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M0PCAKRAJE43ZB66D52QJSGZ": {
+        "bakedName": "FxTrail",
+        "curName": "FxTrail",
+        "id": "trt_01M0PCAKRAJE43ZB66D52QJSGZ",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "std-fx-trail",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": [],
+            "items": {
+              "properties": {
+                "bornAt": {
+                  "name": "bornAt",
+                  "required": true,
+                  "type": "number"
+                },
+                "id": {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                },
+                "ttl": {
+                  "name": "ttl",
+                  "required": true,
+                  "type": "number"
+                },
+                "x": {
+                  "name": "x",
+                  "required": true,
+                  "type": "number"
+                },
+                "y": {
+                  "name": "y",
+                  "required": true,
+                  "type": "number"
+                }
+              },
+              "type": "object"
+            },
+            "name": "trail",
+            "type": "array"
+          },
+          {
+            "default": 0.0,
+            "name": "seq",
+            "type": "number"
+          }
+        ],
+        "id": "ent_01M0PCAKRAB0PFSPQ98X9S0BNF",
+        "name": "FxTrailData",
+        "persistence": "runtime",
+        "shared": true
+      },
+      "id": "orb_01M0PCAKRAXW91Y5Y34VV62FV0",
+      "name": "FxTrailOrbital",
+      "pages": [
+        {
+          "id": "pag_01M0PCAKRAY62QVZS832H2XSWS",
+          "name": "FxTrailPage",
+          "path": "/fx-trail",
+          "traits": [
+            {
+              "ref": "FxTrail",
+              "refId": "trt_01M0PCAKRAJE43ZB66D52QJSGZ"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "lifecycle",
+          "config": {
+            "minSpeed": {
+              "default": 0.5,
+              "description": "Body speed (units/s, from BODY_MOVED) below which no dot is appended, so a resting body doesn't pile dots on one spot.",
+              "label": "Min Speed",
+              "tier": "domain",
+              "type": "number"
+            },
+            "running": {
+              "default": true,
+              "description": "When true, BODY_MOVED appends trail dots; toggle to freeze the trail (existing dots still age out).",
+              "label": "Running",
+              "tier": "domain",
+              "type": "boolean"
+            },
+            "ttl": {
+              "default": 600.0,
+              "description": "Milliseconds a trail dot lives; at a 33ms move cadence ~600ms keeps the last eighteen positions. The ttl is also the natural length cap — no separate limit needed.",
+              "label": "Trail Ttl (ms)",
+              "tier": "presentation",
+              "type": "number"
+            }
+          },
+          "entityContract": {
+            "provides": [
+              "seq",
+              "trail"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "FxTrailData": "ent_01M0PCAKRAB0PFSPQ98X9S0BNF"
+          },
+          "id": "trt_01M0PCAKRAJE43ZB66D52QJSGZ",
+          "linkedEntity": "FxTrailData",
+          "linkedEntityId": "ent_01M0PCAKRAB0PFSPQ98X9S0BNF",
+          "name": "FxTrail",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M0PCAKRA14YFRZZGT8CDR3BE",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01M0PCAKRAWHX8VG91V45K7YYE",
+                "key": "BODY_MOVED",
+                "name": "Body Moved",
+                "payloadSchema": [
+                  {
+                    "name": "x",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "y",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "vx",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "vy",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "grounded",
+                    "required": true,
+                    "type": "boolean"
+                  },
+                  {
+                    "name": "skating",
+                    "required": true,
+                    "type": "boolean"
+                  },
+                  {
+                    "name": "speed",
+                    "required": true,
+                    "type": "number"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01M0PCAKRAK7M2V40695X450BC",
+                "key": "RESTART",
+                "name": "Restart",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ]
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "active"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.trail",
+                    []
+                  ],
+                  [
+                    "set",
+                    "@entity.seq",
+                    0.0
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M0PCAKRA14YFRZZGT8CDR3BE",
+                "from": "active",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.trail",
+                    [
+                      "array/filter",
+                      [
+                        "if",
+                        [
+                          ">",
+                          "@payload.speed",
+                          "@config.minSpeed"
+                        ],
+                        [
+                          "array/concat",
+                          "@entity.trail",
+                          [
+                            {
+                              "bornAt": [
+                                "time/now"
+                              ],
+                              "id": [
+                                "str/concat",
+                                "trail-",
+                                [
+                                  "+",
+                                  "@entity.seq",
+                                  1.0
+                                ]
+                              ],
+                              "ttl": "@config.ttl",
+                              "x": "@payload.x",
+                              "y": "@payload.y"
+                            }
+                          ]
+                        ],
+                        "@entity.trail"
+                      ],
+                      [
+                        "fn",
+                        "d",
+                        [
+                          "<",
+                          [
+                            "-",
+                            [
+                              "time/now"
+                            ],
+                            [
+                              "object/get",
+                              "@d",
+                              "bornAt"
+                            ]
+                          ],
+                          [
+                            "object/get",
+                            "@d",
+                            "ttl"
+                          ]
+                        ]
+                      ]
+                    ]
+                  ],
+                  [
+                    "if",
+                    [
+                      ">",
+                      "@payload.speed",
+                      "@config.minSpeed"
+                    ],
+                    [
+                      "set",
+                      "@entity.seq",
+                      [
+                        "+",
+                        "@entity.seq",
+                        1.0
+                      ]
+                    ],
+                    null
+                  ]
+                ],
+                "event": "BODY_MOVED",
+                "eventId": "evt_01M0PCAKRAWHX8VG91V45K7YYE",
+                "from": "active",
+                "guard": "@config.running",
+                "to": "active"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.trail",
+                    []
+                  ]
+                ],
+                "event": "RESTART",
+                "eventId": "evt_01M0PCAKRAK7M2V40695X450BC",
+                "from": "active",
+                "to": "active"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}