@almadar/std 16.191.0 → 16.192.0

package/behaviors/registry/ui/core/atoms/std-record-detail.orb

@@ -199,6 +199,15 @@
         "parent": "trt_01M13SSYQC6GCVFQK8J7QAS1M7",
         "renames": []
       },
+      "evt_01M1696YX8ZY95Y09Z3XB3MPT0": {
+        "bakedName": "RELATION_OPEN",
+        "curName": "RELATION_OPEN",
+        "id": "evt_01M1696YX8ZY95Y09Z3XB3MPT0",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13SSYQC6GCVFQK8J7QAS1M7",
+        "renames": []
+      },
       "orb_01M11G7GKT7RY3DH0JWRPW7G7M": {
         "bakedName": "RecordItemOrbital",
         "curName": "RecordItemOrbital",
@@ -283,6 +292,20 @@
             "synonyms": "body, text, document, article body",
             "type": "string"
           },
+          {
+            "default": "",
+            "description": "The document look's cover/hero image URL, stamped from the loaded row's coverField.",
+            "intrinsic": true,
+            "name": "coverUrl",
+            "type": "string"
+          },
+          {
+            "default": "",
+            "description": "The document look's icon name, stamped from the loaded row's iconField.",
+            "intrinsic": true,
+            "name": "iconName",
+            "type": "string"
+          },
           {
             "default": {},
             "description": "The full row exactly as last fetched (relations hydrated when config.include asks). The details drawer binds it, and hosts that need it (e.g. a settings modal) stash it from RecordItemLoaded — the document panel itself takes only scalar props and emits scalar payloads ({ id, title }).",
@@ -420,6 +443,14 @@
               "tier": "presentation",
               "type": "string"
             },
+            "coverField": {
+              "default": "",
+              "description": "Name of the image-typed field on the loaded record painted as the document look's full-bleed hero banner (e.g. coverImage, heroImage). Empty = no banner, the default.",
+              "label": "Which field is the cover image?",
+              "synonyms": "cover field, hero image field, banner field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "detailLook": {
               "default": "panel",
               "description": "Visual treatment for the record surface. panel = an inline detail-panel in the page flow (bodyContent); slide-over = the same panel as a right-hand drawer over the list behind it (slideOverBodyContent); page = a full-width record page with roomier spacing (pageBodyContent); document = a wiki-page/note/article surface — big editable title over a rich-text body, no labelled field rows, click-to-edit with autosave (documentBodyContent / documentEditingContent). Selecting a look swaps which body tree renders after the record loads; any body may still be overridden directly at the call site.",
@@ -438,8 +469,10 @@
               "default": {
                 "actions": "@config.actions",
                 "className": "w-full",
+                "coverImage": "@entity.coverUrl",
                 "editEvent": "EDIT_CONTENT",
                 "editLabel": "@config.editLabel",
+                "icon": "@entity.iconName",
                 "id": "@entity.id",
                 "maxInlineActions": "@config.maxInlineActions",
                 "placeholder": "@config.placeholder",
@@ -460,9 +493,11 @@
                 "autosaveHint": "@config.autosaveHint",
                 "className": "w-full",
                 "contentChangeEvent": "CONTENT_CHANGE",
+                "coverImage": "@entity.coverUrl",
                 "doneEvent": "DONE_EDITING",
                 "doneLabel": "@config.doneLabel",
                 "editing": true,
+                "icon": "@entity.iconName",
                 "id": "@entity.id",
                 "maxInlineActions": "@config.maxInlineActions",
                 "placeholder": "@config.placeholder",
@@ -544,6 +579,14 @@
               "tier": "presentation",
               "type": "[RecordFieldSpec]"
             },
+            "iconField": {
+              "default": "",
+              "description": "Name of the field on the loaded record whose icon name renders beside the document title (e.g. icon). Empty = no icon, the default.",
+              "label": "Which field is the document icon?",
+              "synonyms": "icon field, glyph field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "include": {
               "default": [],
               "description": "Entity relation field names to hydrate on fetch, so panel fields can use dot-paths like owner.name. Empty = no hydration, the default.",
@@ -779,6 +822,14 @@
                       "name": "content",
                       "type": "string"
                     },
+                    {
+                      "name": "coverUrl",
+                      "type": "string"
+                    },
+                    {
+                      "name": "iconName",
+                      "type": "string"
+                    },
                     {
                       "name": "loadedRow",
                       "type": "object"
@@ -838,6 +889,14 @@
                       "name": "content",
                       "type": "string"
                     },
+                    {
+                      "name": "coverUrl",
+                      "type": "string"
+                    },
+                    {
+                      "name": "iconName",
+                      "type": "string"
+                    },
                     {
                       "name": "loadedRow",
                       "type": "object"
@@ -932,7 +991,9 @@
           "entityContract": {
             "provides": [
               "content",
+              "coverUrl",
               "description",
+              "iconName",
               "loadedRow",
               "name",
               "openDraft",
@@ -1188,6 +1249,14 @@
                         "name": "content",
                         "type": "string"
                       },
+                      {
+                        "name": "coverUrl",
+                        "type": "string"
+                      },
+                      {
+                        "name": "iconName",
+                        "type": "string"
+                      },
                       {
                         "name": "loadedRow",
                         "type": "object"
@@ -1247,6 +1316,14 @@
                         "name": "content",
                         "type": "string"
                       },
+                      {
+                        "name": "coverUrl",
+                        "type": "string"
+                      },
+                      {
+                        "name": "iconName",
+                        "type": "string"
+                      },
                       {
                         "name": "loadedRow",
                         "type": "object"
@@ -1708,6 +1785,32 @@
                       "@config.contentField"
                     ]
                   ],
+                  [
+                    "set",
+                    "@entity.coverUrl",
+                    [
+                      "str/default",
+                      [
+                        "object/get",
+                        "@payload.data",
+                        "@config.coverField"
+                      ],
+                      ""
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.iconName",
+                    [
+                      "str/default",
+                      [
+                        "object/get",
+                        "@payload.data",
+                        "@config.iconField"
+                      ],
+                      ""
+                    ]
+                  ],
                   [
                     "render-ui",
                     "main",
@@ -1783,6 +1886,32 @@
                       "@config.contentField"
                     ]
                   ],
+                  [
+                    "set",
+                    "@entity.coverUrl",
+                    [
+                      "str/default",
+                      [
+                        "object/get",
+                        "@payload.data",
+                        "@config.coverField"
+                      ],
+                      ""
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.iconName",
+                    [
+                      "str/default",
+                      [
+                        "object/get",
+                        "@payload.data",
+                        "@config.iconField"
+                      ],
+                      ""
+                    ]
+                  ],
                   [
                     "if",
                     [
@@ -1908,6 +2037,38 @@
                       "@config.contentField"
                     ]
                   ],
+                  [
+                    "set",
+                    "@entity.coverUrl",
+                    [
+                      "str/default",
+                      [
+                        "object/get",
+                        [
+                          "array/first",
+                          "@payload.data"
+                        ],
+                        "@config.coverField"
+                      ],
+                      ""
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.iconName",
+                    [
+                      "str/default",
+                      [
+                        "object/get",
+                        [
+                          "array/first",
+                          "@payload.data"
+                        ],
+                        "@config.iconField"
+                      ],
+                      ""
+                    ]
+                  ],
                   [
                     "render-ui",
                     "main",
@@ -2005,6 +2166,38 @@
                       "@config.contentField"
                     ]
                   ],
+                  [
+                    "set",
+                    "@entity.coverUrl",
+                    [
+                      "str/default",
+                      [
+                        "object/get",
+                        [
+                          "array/first",
+                          "@payload.data"
+                        ],
+                        "@config.coverField"
+                      ],
+                      ""
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.iconName",
+                    [
+                      "str/default",
+                      [
+                        "object/get",
+                        [
+                          "array/first",
+                          "@payload.data"
+                        ],
+                        "@config.iconField"
+                      ],
+                      ""
+                    ]
+                  ],
                   [
                     "if",
                     [
@@ -2519,6 +2712,32 @@
                       "@config.contentField"
                     ]
                   ],
+                  [
+                    "set",
+                    "@entity.coverUrl",
+                    [
+                      "str/default",
+                      [
+                        "object/get",
+                        "@payload.data",
+                        "@config.coverField"
+                      ],
+                      ""
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.iconName",
+                    [
+                      "str/default",
+                      [
+                        "object/get",
+                        "@payload.data",
+                        "@config.iconField"
+                      ],
+                      ""
+                    ]
+                  ],
                   [
                     "if",
                     [
@@ -2631,6 +2850,38 @@
                       "@config.contentField"
                     ]
                   ],
+                  [
+                    "set",
+                    "@entity.coverUrl",
+                    [
+                      "str/default",
+                      [
+                        "object/get",
+                        [
+                          "array/first",
+                          "@payload.data"
+                        ],
+                        "@config.coverField"
+                      ],
+                      ""
+                    ]
+                  ],
+                  [
+                    "set",
+                    "@entity.iconName",
+                    [
+                      "str/default",
+                      [
+                        "object/get",
+                        [
+                          "array/first",
+                          "@payload.data"
+                        ],
+                        "@config.iconField"
+                      ],
+                      ""
+                    ]
+                  ],
                   [
                     "if",
                     [
@@ -2942,6 +3193,7 @@
               "default": {
                 "entity": "@entity.loadedRow",
                 "fields": "@config.metaFields",
+                "relationEvent": "RELATION_OPEN",
                 "title": "@config.detailsTitle",
                 "type": "document-details"
               },
@@ -3057,6 +3309,14 @@
                       "name": "content",
                       "type": "string"
                     },
+                    {
+                      "name": "coverUrl",
+                      "type": "string"
+                    },
+                    {
+                      "name": "iconName",
+                      "type": "string"
+                    },
                     {
                       "name": "loadedRow",
                       "type": "object"
@@ -3076,6 +3336,30 @@
               "scope": "external",
               "synonyms": "property saved, metadata changed, field committed, update property",
               "tier": "domain"
+            },
+            {
+              "description": "A relation chip in the details drawer was clicked (a tag, the author, the category); id is the linked row's id. Hosts route it to the linked record's own surface — a navigate, a scoped overlay, a filtered list.",
+              "event": "RELATION_OPEN",
+              "eventId": "evt_01M1696YX8ZY95Y09Z3XB3MPT0",
+              "payloadSchema": [
+                {
+                  "name": "field",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "synonyms": "open relation, linked record clicked, tag clicked, chip clicked",
+              "tier": "domain"
             }
           ],
           "entityContract": {
@@ -3168,6 +3452,14 @@
                         "name": "content",
                         "type": "string"
                       },
+                      {
+                        "name": "coverUrl",
+                        "type": "string"
+                      },
+                      {
+                        "name": "iconName",
+                        "type": "string"
+                      },
                       {
                         "name": "loadedRow",
                         "type": "object"
@@ -3218,6 +3510,30 @@
                 ],
                 "synonyms": "property changed, metadata edited, field committed",
                 "tier": "domain"
+              },
+              {
+                "description": "A relation chip in the details drawer was clicked (a tag, the author, the category); id is the linked row's id. Hosts route it to the linked record's own surface — a navigate, a scoped overlay, a filtered list.",
+                "id": "evt_01M1696YX8ZY95Y09Z3XB3MPT0",
+                "key": "RELATION_OPEN",
+                "name": "Relation Open",
+                "payloadSchema": [
+                  {
+                    "name": "field",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "name",
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "open relation, linked record clicked, tag clicked, chip clicked",
+                "tier": "domain"
               }
             ],
             "states": [