@almadar/std 16.237.0 → 16.238.0

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

@@ -434,6 +434,14 @@
               "tier": "presentation",
               "type": "string"
             },
+            "avatarField": {
+              "default": "",
+              "description": "Name of the image field shown as the profile look's avatar; the title supplies initials when it is empty.",
+              "label": "Which field is the avatar?",
+              "synonyms": "photo field, avatar field, picture field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "bodyContent": {
               "default": {
                 "children": [
@@ -472,15 +480,36 @@
                         ]
                       ]
                     ],
+                    "avatarField": "@config.avatarField",
                     "closeEvent": "@config.closeEvent",
+                    "coverField": "@config.coverField",
                     "entity": "@entity.loadedRow",
                     "fields": "@config.fields",
                     "initialData": "@entity.loadedRow",
+                    "latitudeField": "@config.latitudeField",
+                    "lineItemColumns": "@config.lineItemColumns",
+                    "lineItems": [
+                      "object/get",
+                      "@entity.loadedRow",
+                      "@config.lineItemsField"
+                    ],
+                    "longitudeField": "@config.longitudeField",
+                    "look": "@config.recordLook",
                     "maxInlineActions": "@config.maxInlineActions",
+                    "mediaField": "@config.mediaField",
                     "sections": "@config.sections",
                     "showActions": "@config.showActions",
+                    "stageField": "@config.stageField",
+                    "stages": "@config.stages",
                     "subtitle": "@entity.description",
+                    "tabs": "@config.tabs",
+                    "thread": [
+                      "object/get",
+                      "@entity.loadedRow",
+                      "@config.threadField"
+                    ],
                     "title": "@entity.name",
+                    "totals": "@config.totals",
                     "type": "detail-panel"
                   }
                 ],
@@ -511,7 +540,7 @@
             },
             "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.",
+              "description": "Name of the image-typed field on the loaded record painted as the hero banner of the document look and of the profile record look (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",
@@ -785,6 +814,83 @@
               "tier": "internal",
               "type": "[string]"
             },
+            "latitudeField": {
+              "default": "",
+              "description": "Name of the latitude field the map look pins.",
+              "label": "Which field is the latitude?",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "lineItemColumns": {
+              "default": [],
+              "description": "Columns of the ledger look's line-items table.",
+              "items": {
+                "properties": {
+                  "align": {
+                    "name": "align",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "left",
+                      "center",
+                      "right"
+                    ]
+                  },
+                  "format": {
+                    "name": "format",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "badge",
+                      "date",
+                      "currency",
+                      "number",
+                      "percent",
+                      "boolean"
+                    ]
+                  },
+                  "header": {
+                    "name": "header",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "key": {
+                    "name": "key",
+                    "required": true,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Which line-item columns?",
+              "tier": "presentation",
+              "type": "[LineItemColumn]"
+            },
+            "lineItemsField": {
+              "default": "",
+              "description": "Name of the hydrated relation (list it in include) whose rows the ledger look tables.",
+              "label": "Which relation holds the line items?",
+              "synonyms": "line items field, order lines, invoice lines, child rows",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "loadingContent": {
+              "default": {
+                "type": "skeleton",
+                "variant": "detail"
+              },
+              "description": "Shown while the record loads, shaped like what replaces it so the page does not jump: the detail skeleton for the panel/slide-over/page looks; a document-look consumer sets { type: skeleton, variant: text, rows: 8 }.",
+              "label": "Loading placeholder",
+              "tier": "internal",
+              "type": "render-ui"
+            },
+            "longitudeField": {
+              "default": "",
+              "description": "Name of the longitude field the map look pins.",
+              "label": "Which field is the longitude?",
+              "tier": "presentation",
+              "type": "string"
+            },
             "maxInlineActions": {
               "default": 3.0,
               "description": "Actions beyond this count collapse into a '⋯' overflow menu.",
@@ -793,6 +899,14 @@
               "tier": "presentation",
               "type": "number"
             },
+            "mediaField": {
+              "default": "",
+              "description": "Name of the field the showcase look leads with: one image URL, a list of URLs, or a list of { src, caption }.",
+              "label": "Which field holds the images?",
+              "synonyms": "gallery field, photos field, images field, media field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "openOn": {
               "default": "init",
               "description": "init = a routed detail page; the record loads as soon as the page mounts (the default). event = an overlay that stays blank until a row-click OPEN_VIEW hands it an id, which is what a list-embedded slide-over needs — mounting an init-loading surface on a list page would fetch a record it has no id for.",
@@ -843,15 +957,36 @@
                         ]
                       ]
                     ],
+                    "avatarField": "@config.avatarField",
                     "closeEvent": "@config.closeEvent",
+                    "coverField": "@config.coverField",
                     "entity": "@entity.loadedRow",
                     "fields": "@config.fields",
                     "initialData": "@entity.loadedRow",
+                    "latitudeField": "@config.latitudeField",
+                    "lineItemColumns": "@config.lineItemColumns",
+                    "lineItems": [
+                      "object/get",
+                      "@entity.loadedRow",
+                      "@config.lineItemsField"
+                    ],
+                    "longitudeField": "@config.longitudeField",
+                    "look": "@config.recordLook",
                     "maxInlineActions": "@config.maxInlineActions",
+                    "mediaField": "@config.mediaField",
                     "sections": "@config.sections",
                     "showActions": "@config.showActions",
+                    "stageField": "@config.stageField",
+                    "stages": "@config.stages",
                     "subtitle": "@entity.description",
+                    "tabs": "@config.tabs",
+                    "thread": [
+                      "object/get",
+                      "@entity.loadedRow",
+                      "@config.threadField"
+                    ],
                     "title": "@entity.name",
+                    "totals": "@config.totals",
                     "type": "detail-panel"
                   }
                 ],
@@ -872,6 +1007,24 @@
               "tier": "presentation",
               "type": "string"
             },
+            "recordLook": {
+              "default": "panel",
+              "description": "How the record itself is arranged inside the panel/slide-over/page frame, so not every app reads as an admin form. panel = labelled field grid (default); profile = a person or member: avatar + cover hero (avatarField, coverField); showcase = image-first product or listing with a gallery (mediaField); workflow = a lifecycle stepper over the record (stageField, stages); map = a place: location map hero (latitudeField, longitudeField); ledger = an invoice/order document: line items then totals (lineItemsField, lineItemColumns, totals); conversation = a ticket or thread: the messages beside the record facts (threadField); workspace = a hub record with tabs (tabs). Regions with no data simply do not render. A region fed by a separate trait (replies with their composer, editable order lines, activity history) is composed by overriding the body and passing detail-panel's threadContent / lineItemsContent / activityContent.",
+              "label": "Record look",
+              "synonyms": "record style, profile page, product page, listing page, invoice view, ticket view, timeline view, tabbed record, location page",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "panel",
+                "profile",
+                "showcase",
+                "workflow",
+                "map",
+                "ledger",
+                "conversation",
+                "workspace"
+              ]
+            },
             "sections": {
               "default": [],
               "description": "Optional titled groups over `fields`, e.g. [{title: Contact, fields: [email, phone]}]. Group into sections of 3-5 once a record carries more than about seven fields — a flat list past that is the cognitive-load problem Almadar_UX.md §1.4 (Miller) describes. Empty = one ungrouped list, the default.",
@@ -944,16 +1097,37 @@
                         ]
                       ]
                     ],
+                    "avatarField": "@config.avatarField",
                     "closeEvent": "@config.closeEvent",
+                    "coverField": "@config.coverField",
                     "entity": "@entity.loadedRow",
                     "fields": "@config.fields",
                     "initialData": "@entity.loadedRow",
+                    "latitudeField": "@config.latitudeField",
+                    "lineItemColumns": "@config.lineItemColumns",
+                    "lineItems": [
+                      "object/get",
+                      "@entity.loadedRow",
+                      "@config.lineItemsField"
+                    ],
+                    "longitudeField": "@config.longitudeField",
+                    "look": "@config.recordLook",
                     "maxInlineActions": "@config.maxInlineActions",
+                    "mediaField": "@config.mediaField",
                     "sections": "@config.sections",
                     "showActions": "@config.showActions",
                     "slideOver": true,
+                    "stageField": "@config.stageField",
+                    "stages": "@config.stages",
                     "subtitle": "@entity.description",
+                    "tabs": "@config.tabs",
+                    "thread": [
+                      "object/get",
+                      "@entity.loadedRow",
+                      "@config.threadField"
+                    ],
                     "title": "@entity.name",
+                    "totals": "@config.totals",
                     "type": "detail-panel"
                   }
                 ],
@@ -966,6 +1140,37 @@
               "tier": "internal",
               "type": "render-ui"
             },
+            "stageField": {
+              "default": "",
+              "description": "Name of the field holding the record's current stage; the workflow look marks it on the stepper.",
+              "label": "Which field is the lifecycle stage?",
+              "synonyms": "stage field, status field, phase field, step field",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "stages": {
+              "default": [],
+              "description": "The workflow look's stepper: one { value, label } per stage, value matching stageField's enum.",
+              "items": {
+                "properties": {
+                  "label": {
+                    "name": "label",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "value": {
+                    "name": "value",
+                    "required": true,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "What is the lifecycle, in order?",
+              "synonyms": "lifecycle, pipeline stages, steps, phases",
+              "tier": "presentation",
+              "type": "[RecordStage]"
+            },
             "subtitleField": {
               "default": "description",
               "description": "Name of the field shown under the title (e.g. company, category). Set to \"\" for no subtitle at all — the right choice for the document look, whose metadata lives in the properties strip, not a second line.",
@@ -974,6 +1179,50 @@
               "tier": "presentation",
               "type": "string"
             },
+            "tabs": {
+              "default": [],
+              "description": "The workspace look's tabs after Overview: each lists field names, or composes a related trait as content (e.g. a company's deals list).",
+              "items": {
+                "properties": {
+                  "content": {
+                    "name": "content",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "fields": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "fields",
+                    "required": false,
+                    "type": "array"
+                  },
+                  "id": {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": true,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Which tabs follow the overview?",
+              "synonyms": "tabs, record tabs, sub pages, related lists",
+              "tier": "presentation",
+              "type": "[RecordTab]"
+            },
+            "threadField": {
+              "default": "",
+              "description": "Name of the hydrated relation (list it in include) whose messages the conversation look shows.",
+              "label": "Which relation holds the thread?",
+              "synonyms": "messages field, replies field, comments field, thread field",
+              "tier": "presentation",
+              "type": "string"
+            },
             "titleField": {
               "default": "name",
               "description": "Name of the field on the loaded record shown as the panel title (e.g. contactName, subject, title).",
@@ -982,6 +1231,94 @@
               "tier": "presentation",
               "type": "string"
             },
+            "titleFields": {
+              "default": [],
+              "description": "For records whose name is split across fields (firstName + lastName): the listed fields' values joined with spaces become the title, and override titleField. Empty = titleField alone, the default.",
+              "items": {
+                "type": "string"
+              },
+              "label": "Which fields make up the title, in order?",
+              "synonyms": "full name, name parts, composite title, first and last name",
+              "tier": "presentation",
+              "type": "[string]"
+            },
+            "totals": {
+              "default": [],
+              "description": "Record fields shown under the line items in order (e.g. subtotal, tax, total); the last is emphasised.",
+              "items": {
+                "properties": {
+                  "colorMap": {
+                    "items": {
+                      "type": "string",
+                      "values": [
+                        "default",
+                        "primary",
+                        "secondary",
+                        "success",
+                        "warning",
+                        "danger",
+                        "error",
+                        "info",
+                        "neutral",
+                        "destructive"
+                      ]
+                    },
+                    "name": "colorMap",
+                    "required": false,
+                    "type": "object"
+                  },
+                  "format": {
+                    "name": "format",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "date",
+                      "currency",
+                      "number",
+                      "boolean",
+                      "percent"
+                    ]
+                  },
+                  "header": {
+                    "name": "header",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "key": {
+                    "name": "key",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "labels": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "labels",
+                    "required": false,
+                    "type": "object"
+                  },
+                  "variant": {
+                    "name": "variant",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "h3",
+                      "h4",
+                      "body",
+                      "caption",
+                      "badge",
+                      "small",
+                      "progress"
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Which fields are the totals?",
+              "synonyms": "totals, subtotal, grand total, amount due",
+              "tier": "presentation",
+              "type": "[RecordFieldSpec]"
+            },
             "viewerRole": {
               "default": "",
               "description": "The signed-in viewer's role that each action's `roles` is checked against. Bind it explicitly at the call site (e.g. `viewerRole: @user.role`) in an app whose identity carries a role; left empty, only actions with no `roles` show.",
@@ -1964,10 +2301,7 @@
                   [
                     "render-ui",
                     "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
+                    "@config.loadingContent"
                   ]
                 ],
                 "event": "INIT",
@@ -2031,10 +2365,7 @@
                   [
                     "render-ui",
                     "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
+                    "@config.loadingContent"
                   ]
                 ],
                 "event": "INIT",
@@ -2094,10 +2425,7 @@
                   [
                     "render-ui",
                     "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
+                    "@config.loadingContent"
                   ]
                 ],
                 "event": "INIT",
@@ -2189,10 +2517,7 @@
                   [
                     "render-ui",
                     "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
+                    "@config.loadingContent"
                   ]
                 ],
                 "event": "OPEN_VIEW",
@@ -2231,10 +2556,7 @@
                   [
                     "render-ui",
                     "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
+                    "@config.loadingContent"
                   ]
                 ],
                 "event": "INIT",
@@ -2290,10 +2612,7 @@
                   [
                     "render-ui",
                     "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
+                    "@config.loadingContent"
                   ]
                 ],
                 "event": "INIT",
@@ -2346,9 +2665,41 @@
                     "set",
                     "@entity.name",
                     [
-                      "object/get",
-                      "@payload.data",
-                      "@config.titleField"
+                      "if",
+                      [
+                        ">",
+                        [
+                          "array/len",
+                          "@config.titleFields"
+                        ],
+                        0.0
+                      ],
+                      [
+                        "str/join",
+                        [
+                          "array/map",
+                          "@config.titleFields",
+                          [
+                            "fn",
+                            "f",
+                            [
+                              "str/default",
+                              [
+                                "object/get",
+                                "@payload.data",
+                                "@f"
+                              ],
+                              ""
+                            ]
+                          ]
+                        ],
+                        " "
+                      ],
+                      [
+                        "object/get",
+                        "@payload.data",
+                        "@config.titleField"
+                      ]
                     ]
                   ],
                   [
@@ -2447,9 +2798,41 @@
                     "set",
                     "@entity.name",
                     [
-                      "object/get",
-                      "@payload.data",
-                      "@config.titleField"
+                      "if",
+                      [
+                        ">",
+                        [
+                          "array/len",
+                          "@config.titleFields"
+                        ],
+                        0.0
+                      ],
+                      [
+                        "str/join",
+                        [
+                          "array/map",
+                          "@config.titleFields",
+                          [
+                            "fn",
+                            "f",
+                            [
+                              "str/default",
+                              [
+                                "object/get",
+                                "@payload.data",
+                                "@f"
+                              ],
+                              ""
+                            ]
+                          ]
+                        ],
+                        " "
+                      ],
+                      [
+                        "object/get",
+                        "@payload.data",
+                        "@config.titleField"
+                      ]
                     ]
                   ],
                   [
@@ -2589,12 +2972,47 @@
                     "set",
                     "@entity.name",
                     [
-                      "object/get",
+                      "if",
                       [
-                        "array/first",
-                        "@payload.data"
+                        ">",
+                        [
+                          "array/len",
+                          "@config.titleFields"
+                        ],
+                        0.0
                       ],
-                      "@config.titleField"
+                      [
+                        "str/join",
+                        [
+                          "array/map",
+                          "@config.titleFields",
+                          [
+                            "fn",
+                            "f",
+                            [
+                              "str/default",
+                              [
+                                "object/get",
+                                [
+                                  "array/first",
+                                  "@payload.data"
+                                ],
+                                "@f"
+                              ],
+                              ""
+                            ]
+                          ]
+                        ],
+                        " "
+                      ],
+                      [
+                        "object/get",
+                        [
+                          "array/first",
+                          "@payload.data"
+                        ],
+                        "@config.titleField"
+                      ]
                     ]
                   ],
                   [
@@ -2718,12 +3136,47 @@
                     "set",
                     "@entity.name",
                     [
-                      "object/get",
+                      "if",
                       [
-                        "array/first",
-                        "@payload.data"
+                        ">",
+                        [
+                          "array/len",
+                          "@config.titleFields"
+                        ],
+                        0.0
                       ],
-                      "@config.titleField"
+                      [
+                        "str/join",
+                        [
+                          "array/map",
+                          "@config.titleFields",
+                          [
+                            "fn",
+                            "f",
+                            [
+                              "str/default",
+                              [
+                                "object/get",
+                                [
+                                  "array/first",
+                                  "@payload.data"
+                                ],
+                                "@f"
+                              ],
+                              ""
+                            ]
+                          ]
+                        ],
+                        " "
+                      ],
+                      [
+                        "object/get",
+                        [
+                          "array/first",
+                          "@payload.data"
+                        ],
+                        "@config.titleField"
+                      ]
                     ]
                   ],
                   [
@@ -2935,10 +3388,7 @@
                   [
                     "render-ui",
                     "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
+                    "@config.loadingContent"
                   ]
                 ],
                 "event": "INIT",
@@ -3002,10 +3452,7 @@
                   [
                     "render-ui",
                     "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
+                    "@config.loadingContent"
                   ]
                 ],
                 "event": "INIT",
@@ -3273,9 +3720,41 @@
                     "set",
                     "@entity.name",
                     [
-                      "object/get",
-                      "@payload.data",
-                      "@config.titleField"
+                      "if",
+                      [
+                        ">",
+                        [
+                          "array/len",
+                          "@config.titleFields"
+                        ],
+                        0.0
+                      ],
+                      [
+                        "str/join",
+                        [
+                          "array/map",
+                          "@config.titleFields",
+                          [
+                            "fn",
+                            "f",
+                            [
+                              "str/default",
+                              [
+                                "object/get",
+                                "@payload.data",
+                                "@f"
+                              ],
+                              ""
+                            ]
+                          ]
+                        ],
+                        " "
+                      ],
+                      [
+                        "object/get",
+                        "@payload.data",
+                        "@config.titleField"
+                      ]
                     ]
                   ],
                   [
@@ -3402,12 +3881,47 @@
                     "set",
                     "@entity.name",
                     [
-                      "object/get",
+                      "if",
                       [
-                        "array/first",
-                        "@payload.data"
+                        ">",
+                        [
+                          "array/len",
+                          "@config.titleFields"
+                        ],
+                        0.0
+                      ],
+                      [
+                        "str/join",
+                        [
+                          "array/map",
+                          "@config.titleFields",
+                          [
+                            "fn",
+                            "f",
+                            [
+                              "str/default",
+                              [
+                                "object/get",
+                                [
+                                  "array/first",
+                                  "@payload.data"
+                                ],
+                                "@f"
+                              ],
+                              ""
+                            ]
+                          ]
+                        ],
+                        " "
                       ],
-                      "@config.titleField"
+                      [
+                        "object/get",
+                        [
+                          "array/first",
+                          "@payload.data"
+                        ],
+                        "@config.titleField"
+                      ]
                     ]
                   ],
                   [
@@ -3652,10 +4166,7 @@
                   [
                     "render-ui",
                     "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
+                    "@config.loadingContent"
                   ]
                 ],
                 "event": "INIT",
@@ -3711,10 +4222,7 @@
                   [
                     "render-ui",
                     "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
+                    "@config.loadingContent"
                   ]
                 ],
                 "event": "INIT",
@@ -3760,10 +4268,7 @@
                   [
                     "render-ui",
                     "main",
-                    {
-                      "rows": 4.0,
-                      "type": "skeleton"
-                    }
+                    "@config.loadingContent"
                   ]
                 ],
                 "event": "RETRY",
@@ -4372,6 +4877,25 @@
         }
       ],
       "types": {
+        "LineItemColumn": [
+          {
+            "name": "key",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "header",
+            "type": "string"
+          },
+          {
+            "name": "align",
+            "type": "string"
+          },
+          {
+            "name": "format",
+            "type": "string"
+          }
+        ],
         "MetaFieldSpec": [
           {
             "name": "key",
@@ -4464,6 +4988,38 @@
             "name": "fields",
             "type": "[string]"
           }
+        ],
+        "RecordStage": [
+          {
+            "name": "value",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "RecordTab": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "fields",
+            "type": "[string]"
+          },
+          {
+            "name": "content",
+            "type": "render-ui"
+          }
         ]
       }
     }