@almadar/std 16.236.0 → 16.238.0

package/behaviors/lolo/ui/core/atoms/std-multi-party-flow.lolo

@@ -44,8 +44,10 @@ orbital MultiPartyFlowOrbital {
           emit: { failure: FlowLoadFailed, success: FlowLoaded }
         })
         (render-ui main {
-          title: "Loading transaction…"
-          type: loading-state
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: card }]
         })
       FlowLoaded -> awaiting
         (set @entity.currentPartyIndex 0)
@@ -259,6 +261,10 @@ orbital MultiPartyFlowOrbital {
           }, {
             entity: @entity.audit
             fields: (title description timestamp status)
+            titleField: "title"
+            descriptionField: "description"
+            dateField: "timestamp"
+            statusField: "status"
             look: @config.timelineLook
             type: timeline
           }, { type: divider }, {
@@ -508,6 +514,10 @@ orbital MultiPartyFlowOrbital {
           }, {
             entity: @entity.audit
             fields: (title description timestamp status)
+            titleField: "title"
+            descriptionField: "description"
+            dateField: "timestamp"
+            statusField: "status"
             look: @config.timelineLook
             type: timeline
           }, { type: divider }, {
@@ -671,6 +681,10 @@ orbital MultiPartyFlowOrbital {
           }, {
             entity: @entity.audit
             fields: (title description timestamp status)
+            titleField: "title"
+            descriptionField: "description"
+            dateField: "timestamp"
+            statusField: "status"
             look: @config.timelineLook
             type: timeline
           }]
@@ -827,6 +841,10 @@ orbital MultiPartyFlowOrbital {
           }, {
             entity: @entity.audit
             fields: (title description timestamp status)
+            titleField: "title"
+            descriptionField: "description"
+            dateField: "timestamp"
+            statusField: "status"
             look: @config.timelineLook
             type: timeline
           }, {
@@ -845,8 +863,10 @@ orbital MultiPartyFlowOrbital {
           emit: { failure: FlowLoadFailed, success: FlowLoaded }
         })
         (render-ui main {
-          title: "Returning…"
-          type: loading-state
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: card }]
         })
     }
 
@@ -905,6 +925,10 @@ orbital MultiPartyFlowOrbital {
           }, {
             entity: @entity.audit
             fields: (title description timestamp status)
+            titleField: "title"
+            descriptionField: "description"
+            dateField: "timestamp"
+            statusField: "status"
             look: @config.timelineLook
             type: timeline
           }, {
@@ -923,8 +947,10 @@ orbital MultiPartyFlowOrbital {
           emit: { failure: FlowLoadFailed, success: FlowLoaded }
         })
         (render-ui main {
-          title: "Returning…"
-          type: loading-state
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: card }]
         })
     }
 
@@ -989,6 +1015,10 @@ orbital MultiPartyFlowOrbital {
           }, {
             entity: @entity.audit
             fields: (title description timestamp status)
+            titleField: "title"
+            descriptionField: "description"
+            dateField: "timestamp"
+            statusField: "status"
             look: @config.timelineLook
             type: timeline
           }, {
@@ -1056,8 +1086,10 @@ orbital MultiPartyFlowOrbital {
           emit: { failure: FlowLoadFailed, success: FlowLoaded }
         })
         (render-ui main {
-          title: "Starting new transaction…"
-          type: loading-state
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: card }]
         })
     }
 
@@ -1067,8 +1099,10 @@ orbital MultiPartyFlowOrbital {
           emit: { failure: FlowLoadFailed, success: FlowLoaded }
         })
         (render-ui main {
-          title: "Starting new transaction…"
-          type: loading-state
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: card }]
         })
     }
 
@@ -1078,8 +1112,10 @@ orbital MultiPartyFlowOrbital {
           emit: { failure: FlowLoadFailed, success: FlowLoaded }
         })
         (render-ui main {
-          title: "Starting new transaction…"
-          type: loading-state
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: card }]
         })
     }
 
@@ -1089,8 +1125,10 @@ orbital MultiPartyFlowOrbital {
           emit: { failure: FlowLoadFailed, success: FlowLoaded }
         })
         (render-ui main {
-          title: "Retrying…"
-          type: loading-state
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: card }]
         })
     }
 

package/behaviors/lolo/ui/core/atoms/std-prose.lolo

@@ -33,7 +33,8 @@ orbital ProseOrbital {
               }, {
                 type: typography
                 content: @config.heading
-                variant: h2
+                variant: @config.headingLevel
+                size: "3xl"
                 weight: bold
                 className: (if (== @config.heading "") hidden "tracking-tight text-balance")
               }, {
@@ -62,6 +63,11 @@ orbital ProseOrbital {
         @description "Empty hides it"
         @synonyms "title"
         @tier "presentation"
+      headingLevel : "h1" | "h2" = h2
+        @label "Heading level"
+        @description "h1 when this text is the page's main content (its title names the page); h2 when it is one section among others"
+        @synonyms "page title, heading rank, outline level"
+        @tier "presentation"
       meta : string = ""
         @label "Meta line"
         @description "Date, author or reading time under the heading; empty hides it"

package/behaviors/lolo/ui/core/atoms/std-rating-review.lolo

@@ -38,8 +38,10 @@ orbital RatingReviewOrbital {
           emit: { failure: ReviewsLoadFailed, success: ReviewsLoaded }
         })
         (render-ui main {
-          title: "Loading reviews…"
-          type: loading-state
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: card }, { type: skeleton, variant: list, rows: 6 }]
         })
       ReviewsLoaded -> viewing
         (set @entity.reviewsSource (array/map ?data (fn row {
@@ -252,8 +254,10 @@ orbital RatingReviewOrbital {
           emit: { failure: ReviewsLoadFailed, success: ReviewsLoaded }
         })
         (render-ui main {
-          title: "Refreshing reviews…"
-          type: loading-state
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: card }, { type: skeleton, variant: list, rows: 6 }]
         })
       ReviewSaveFailed -> error
         (set @entity.errorMessage ?error)
@@ -299,6 +303,7 @@ orbital RatingReviewOrbital {
               }, {
                 action: RATE_DRAFT
                 max: 5
+                label: "Your rating"
                 type: star-rating
                 value: @entity.draftRating
               }, {
@@ -1102,6 +1107,7 @@ orbital RatingReviewOrbital {
               }, {
                 action: RATE_DRAFT
                 max: 5
+                label: "Your rating"
                 type: star-rating
                 value: @entity.draftRating
               }, {
@@ -1202,8 +1208,10 @@ orbital RatingReviewOrbital {
           emit: { failure: ReviewsLoadFailed, success: ReviewsLoaded }
         })
         (render-ui main {
-          title: "Refreshing reviews…"
-          type: loading-state
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: card }, { type: skeleton, variant: list, rows: 6 }]
         })
     }
 
@@ -1213,8 +1221,10 @@ orbital RatingReviewOrbital {
           emit: { failure: ReviewsLoadFailed, success: ReviewsLoaded }
         })
         (render-ui main {
-          title: "Retrying…"
-          type: loading-state
+          type: stack
+          direction: vertical
+          gap: lg
+          children: [{ type: skeleton, variant: header }, { type: skeleton, variant: card }, { type: skeleton, variant: list, rows: 6 }]
         })
     }
 
@@ -1423,6 +1433,7 @@ orbital RatingReviewOrbital {
             }, {
               action: RATE_DRAFT
               max: @config.maxStars
+              label: "Your rating"
               type: star-rating
               value: @entity.draftRating
             }, {
@@ -1453,6 +1464,7 @@ orbital RatingReviewOrbital {
             }, {
               action: RATE_DRAFT
               max: @config.maxStars
+              label: "Your rating"
               type: star-rating
               value: @entity.draftRating
             }, {
@@ -1503,6 +1515,7 @@ orbital RatingReviewOrbital {
             }, {
               action: RATE_DRAFT
               max: @config.maxStars
+              label: "Your rating"
               type: star-rating
               value: 0
             }, {
@@ -1569,6 +1582,7 @@ orbital RatingReviewOrbital {
             }, {
               action: RATE_DRAFT
               max: @config.maxStars
+              label: "Your rating"
               type: star-rating
               value: 0
             }, {
@@ -1601,6 +1615,7 @@ orbital RatingReviewOrbital {
             }, {
               action: RATE_DRAFT
               max: @config.maxStars
+              label: "Your rating"
               type: star-rating
               value: 0
             }, {

package/behaviors/lolo/ui/core/atoms/std-record-detail.lolo

@@ -3,9 +3,13 @@ app std-record-detail "1.0.0"
 ;; @capabilities "record detail, single record view, entity detail panel, drill-down record, show one record, record profile, detail page, view details, document editor, wiki page, note taking, article body, rich text editing, write and edit content"
 orbital RecordItemOrbital {
   type RecordAction = { label : string!, event : event!, icon : string, variant : primary | secondary | ghost | danger, roles : [string], when : SExpr }
-  type RecordFieldSpec = { key : string!, header : string, format : date | currency | number | boolean | percent }
+  type BadgeColor = "default" | "primary" | "secondary" | "success" | "warning" | "danger" | "error" | "info" | "neutral" | "destructive"
+  type RecordFieldSpec = { key : string!, header : string, format : date | currency | number | boolean | percent, variant : h3 | h4 | body | caption | badge | small | progress, colorMap : Map string BadgeColor, labels : Map string string }
   type MetaFieldSpec = { key : string!, label : string, kind : text | boolean | select | readonly, options : [string], icon : string, format : date | currency | number | boolean | percent }
   type RecordSection = { title : string!, fields : [string] }
+  type RecordStage = { value : string!, label : string! }
+  type RecordTab = { id : string!, label : string!, fields : [string], content : render-ui }
+  type LineItemColumn = { key : string!, header : string, align : left | center | right, format : badge | date | currency | number | percent | boolean }
 
   type RecordItemLoaded = Event { data : RecordItem, totalCount : number } "Fired when the single record finishes loading; payload.data holds the record. totalCount is accepted so a fetch emitter shared with collection atoms still validates."
 
@@ -45,7 +49,7 @@ orbital RecordItemOrbital {
           id: ?id
           include: @config.include
         })
-        (render-ui main { rows: 4, type: skeleton })
+        (render-ui main @config.loadingContent)
       ;; Slug-routed open (/things/:slug): no id on the payload, so fetch by
       ;; the slug field instead. Filtered rather than by-id, so the success
       ;; payload is a collection — its own event keeps the two shapes honest.
@@ -57,7 +61,7 @@ orbital RecordItemOrbital {
           emit: { failure: RecordItemLoadFailed, success: RecordItemSlugLoaded }
           include: @config.include
         })
-        (render-ui main { rows: 4, type: skeleton })
+        (render-ui main @config.loadingContent)
       ;; Fallback: an init-opened surface whose INIT carried neither key —
       ;; fetch by the (missing) id so the failure surfaces as the error
       ;; state's alert + Retry instead of a silent blank page. This is the
@@ -69,7 +73,7 @@ orbital RecordItemOrbital {
           id: ?id
           include: @config.include
         })
-        (render-ui main { rows: 4, type: skeleton })
+        (render-ui main @config.loadingContent)
       ;; Event-opened overlay (openOn: event): stays blank until OPEN_VIEW,
       ;; but renders the blank EXPLICITLY — an embedded @trait.X reference to
       ;; a trait with no indexed content is flagged by the compiled client's
@@ -101,7 +105,7 @@ orbital RecordItemOrbital {
           id: ?id
           include: @config.include
         })
-        (render-ui main { rows: 4, type: skeleton })
+        (render-ui main @config.loadingContent)
     }
 
     state loading {
@@ -115,7 +119,7 @@ orbital RecordItemOrbital {
         })
         ;; Skeleton, not a blank frame: the hand-authored detail traits this
         ;; atom replaces rendered nothing until the record arrived.
-        (render-ui main { rows: 4, type: skeleton })
+        (render-ui main @config.loadingContent)
       INIT -> loading when (and ["=", (str/default ?id ""), ""] ["!=", (str/default ?slug ""), ""])
         (set @entity.slug ?slug)
         (set @entity.openDraft (str/default ?draft ""))
@@ -124,7 +128,7 @@ orbital RecordItemOrbital {
           emit: { failure: RecordItemLoadFailed, success: RecordItemSlugLoaded }
           include: @config.include
         })
-        (render-ui main { rows: 4, type: skeleton })
+        (render-ui main @config.loadingContent)
       ;; A record minted blank by a document-first create arrives with
       ;; draft=1 and lands straight in the editor — a distinct target state,
       ;; not a flag on the render, so the machine stays honest about being
@@ -133,7 +137,7 @@ orbital RecordItemOrbital {
         ;; (object/merge … {}) is a type adapter only: type_compat lacks "declared object accepts a named row type" (ledgered)
         (set @entity.loadedRow (object/merge ?data {}))
         (set @entity.id (object/get ?data id))
-        (set @entity.name (object/get ?data @config.titleField))
+        (set @entity.name (if [">", (array/len @config.titleFields), 0] (str/join (array/map @config.titleFields (fn f (str/default (object/get ?data @f) ""))) " ") (object/get ?data @config.titleField)))
         (set @entity.description (str/default (object/get ?data @config.subtitleField) ""))
         (set @entity.content (object/get ?data @config.contentField))
         (set @entity.coverUrl (str/default (object/get ?data @config.coverField) ""))
@@ -143,7 +147,7 @@ orbital RecordItemOrbital {
         ;; (object/merge … {}) is a type adapter only: type_compat lacks "declared object accepts a named row type" (ledgered)
         (set @entity.loadedRow (object/merge ?data {}))
         (set @entity.id (object/get ?data id))
-        (set @entity.name (object/get ?data @config.titleField))
+        (set @entity.name (if [">", (array/len @config.titleFields), 0] (str/join (array/map @config.titleFields (fn f (str/default (object/get ?data @f) ""))) " ") (object/get ?data @config.titleField)))
         (set @entity.description (str/default (object/get ?data @config.subtitleField) ""))
         (set @entity.content (object/get ?data @config.contentField))
         (set @entity.coverUrl (str/default (object/get ?data @config.coverField) ""))
@@ -158,7 +162,7 @@ orbital RecordItemOrbital {
       RecordItemSlugLoaded -> editing when (and [">", (array/len ?data), 0] ["=", (str/default (object/get @entity openDraft) ""), "1"])
         (set @entity.loadedRow (array/first ?data))
         (set @entity.id (object/get (array/first ?data) id))
-        (set @entity.name (object/get (array/first ?data) @config.titleField))
+        (set @entity.name (if [">", (array/len @config.titleFields), 0] (str/join (array/map @config.titleFields (fn f (str/default (object/get (array/first ?data) @f) ""))) " ") (object/get (array/first ?data) @config.titleField)))
         (set @entity.description (str/default (object/get (array/first ?data) @config.subtitleField) ""))
         (set @entity.content (object/get (array/first ?data) @config.contentField))
         (set @entity.coverUrl (str/default (object/get (array/first ?data) @config.coverField) ""))
@@ -167,7 +171,7 @@ orbital RecordItemOrbital {
       RecordItemSlugLoaded -> viewing when (and [">", (array/len ?data), 0] ["!=", (str/default (object/get @entity openDraft) ""), "1"])
         (set @entity.loadedRow (array/first ?data))
         (set @entity.id (object/get (array/first ?data) id))
-        (set @entity.name (object/get (array/first ?data) @config.titleField))
+        (set @entity.name (if [">", (array/len @config.titleFields), 0] (str/join (array/map @config.titleFields (fn f (str/default (object/get (array/first ?data) @f) ""))) " ") (object/get (array/first ?data) @config.titleField)))
         (set @entity.description (str/default (object/get (array/first ?data) @config.subtitleField) ""))
         (set @entity.content (object/get (array/first ?data) @config.contentField))
         (set @entity.coverUrl (str/default (object/get (array/first ?data) @config.coverField) ""))
@@ -204,7 +208,7 @@ orbital RecordItemOrbital {
           id: ?id
           include: @config.include
         })
-        (render-ui main { rows: 4, type: skeleton })
+        (render-ui main @config.loadingContent)
       INIT -> loading when (and ["=", (str/default ?id ""), ""] ["!=", (str/default ?slug ""), ""] ["!=", ?slug, @entity.slug])
         (set @entity.slug ?slug)
         (set @entity.openDraft (str/default ?draft ""))
@@ -213,7 +217,7 @@ orbital RecordItemOrbital {
           emit: { failure: RecordItemLoadFailed, success: RecordItemSlugLoaded }
           include: @config.include
         })
-        (render-ui main { rows: 4, type: skeleton })
+        (render-ui main @config.loadingContent)
       CONTENT_CHANGE -> editing
         (set @entity.content ?value)
         (set @entity.loadedRow (object/set @entity.loadedRow @config.contentField ?value))
@@ -258,7 +262,7 @@ orbital RecordItemOrbital {
         ;; (object/merge … {}) is a type adapter only: type_compat lacks "declared object accepts a named row type" (ledgered)
         (set @entity.loadedRow (object/merge ?data {}))
         (set @entity.id (object/get ?data id))
-        (set @entity.name (object/get ?data @config.titleField))
+        (set @entity.name (if [">", (array/len @config.titleFields), 0] (str/join (array/map @config.titleFields (fn f (str/default (object/get ?data @f) ""))) " ") (object/get ?data @config.titleField)))
         (set @entity.description (str/default (object/get ?data @config.subtitleField) ""))
         (set @entity.content (object/get ?data @config.contentField))
         (set @entity.coverUrl (str/default (object/get ?data @config.coverField) ""))
@@ -273,7 +277,7 @@ orbital RecordItemOrbital {
       RecordItemSlugLoaded -> viewing when [">", (array/len ?data), 0]
         (set @entity.loadedRow (array/first ?data))
         (set @entity.id (object/get (array/first ?data) id))
-        (set @entity.name (object/get (array/first ?data) @config.titleField))
+        (set @entity.name (if [">", (array/len @config.titleFields), 0] (str/join (array/map @config.titleFields (fn f (str/default (object/get (array/first ?data) @f) ""))) " ") (object/get (array/first ?data) @config.titleField)))
         (set @entity.description (str/default (object/get (array/first ?data) @config.subtitleField) ""))
         (set @entity.content (object/get (array/first ?data) @config.contentField))
         (set @entity.coverUrl (str/default (object/get (array/first ?data) @config.coverField) ""))
@@ -310,7 +314,7 @@ orbital RecordItemOrbital {
           id: ?id
           include: @config.include
         })
-        (render-ui main { rows: 4, type: skeleton })
+        (render-ui main @config.loadingContent)
       INIT -> loading when (and ["=", (str/default ?id ""), ""] ["!=", (str/default ?slug ""), ""])
         (set @entity.slug ?slug)
         (set @entity.openDraft (str/default ?draft ""))
@@ -319,7 +323,7 @@ orbital RecordItemOrbital {
           emit: { failure: RecordItemLoadFailed, success: RecordItemSlugLoaded }
           include: @config.include
         })
-        (render-ui main { rows: 4, type: skeleton })
+        (render-ui main @config.loadingContent)
       ;; The hand-authored traits sent a failed load back to `loading` with no
       ;; effect, so the page stayed blank forever with no way out. RETRY is the
       ;; way out.
@@ -329,7 +333,7 @@ orbital RecordItemOrbital {
           id: @entity.id
           include: @config.include
         })
-        (render-ui main { rows: 4, type: skeleton })
+        (render-ui main @config.loadingContent)
     }
 
     emits {
@@ -448,12 +452,15 @@ orbital RecordItemOrbital {
       fields : [RecordFieldSpec] = [{
         header: Name
         key: name
+        variant: h4
       }, {
         header: Description
         key: description
+        variant: body
       }, {
         header: Status
         key: status
+        variant: badge
       }, {
         format: date
         header: Created
@@ -463,6 +470,11 @@ orbital RecordItemOrbital {
         @description "Each entry maps one entity field to a labelled row in the panel. Unlike a list row, a detail panel SHOULD label every field — the value stands alone here with no column header or repeated row position to name it."
         @synonyms "detail fields, record fields, panel fields, shown fields"
         @tier "presentation"
+      closeEvent : event = ""
+        @label "Which action closes the record?"
+        @description "The `actions` entry whose event matches renders as the panel's close (×) button. Empty = no close button (a routed detail page navigates back instead)."
+        @synonyms "close event, dismiss event, close button"
+        @tier "presentation"
       sections : [RecordSection] = []
         @label "How should the fields be grouped?"
         @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."
@@ -506,6 +518,11 @@ orbital RecordItemOrbital {
         @description "Name of the field on the loaded record shown as the panel title (e.g. contactName, subject, title)."
         @synonyms "title field, heading field, name field, label field"
         @tier "presentation"
+      titleFields : [string] = []
+        @label "Which fields make up the title, in order?"
+        @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."
+        @synonyms "full name, name parts, composite title, first and last name"
+        @tier "presentation"
       subtitleField : string = description
         @label "Which field is the subtitle?"
         @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."
@@ -526,6 +543,63 @@ orbital RecordItemOrbital {
         @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."
         @synonyms "detail style, drawer, slide over, full page, document, wiki page, note, article"
         @tier "presentation"
+      recordLook : "panel" | "profile" | "showcase" | "workflow" | "map" | "ledger" | "conversation" | "workspace" = panel
+        @label "Record look"
+        @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."
+        @synonyms "record style, profile page, product page, listing page, invoice view, ticket view, timeline view, tabbed record, location page"
+        @tier "presentation"
+      avatarField : string = ""
+        @label "Which field is the avatar?"
+        @description "Name of the image field shown as the profile look's avatar; the title supplies initials when it is empty."
+        @synonyms "photo field, avatar field, picture field"
+        @tier "presentation"
+      mediaField : string = ""
+        @label "Which field holds the images?"
+        @description "Name of the field the showcase look leads with: one image URL, a list of URLs, or a list of { src, caption }."
+        @synonyms "gallery field, photos field, images field, media field"
+        @tier "presentation"
+      stageField : string = ""
+        @label "Which field is the lifecycle stage?"
+        @description "Name of the field holding the record's current stage; the workflow look marks it on the stepper."
+        @synonyms "stage field, status field, phase field, step field"
+        @tier "presentation"
+      stages : [RecordStage] = []
+        @label "What is the lifecycle, in order?"
+        @description "The workflow look's stepper: one { value, label } per stage, value matching stageField's enum."
+        @synonyms "lifecycle, pipeline stages, steps, phases"
+        @tier "presentation"
+      latitudeField : string = ""
+        @label "Which field is the latitude?"
+        @description "Name of the latitude field the map look pins."
+        @tier "presentation"
+      longitudeField : string = ""
+        @label "Which field is the longitude?"
+        @description "Name of the longitude field the map look pins."
+        @tier "presentation"
+      lineItemsField : string = ""
+        @label "Which relation holds the line items?"
+        @description "Name of the hydrated relation (list it in include) whose rows the ledger look tables."
+        @synonyms "line items field, order lines, invoice lines, child rows"
+        @tier "presentation"
+      lineItemColumns : [LineItemColumn] = []
+        @label "Which line-item columns?"
+        @description "Columns of the ledger look's line-items table."
+        @tier "presentation"
+      totals : [RecordFieldSpec] = []
+        @label "Which fields are the totals?"
+        @description "Record fields shown under the line items in order (e.g. subtotal, tax, total); the last is emphasised."
+        @synonyms "totals, subtotal, grand total, amount due"
+        @tier "presentation"
+      threadField : string = ""
+        @label "Which relation holds the thread?"
+        @description "Name of the hydrated relation (list it in include) whose messages the conversation look shows."
+        @synonyms "messages field, replies field, comments field, thread field"
+        @tier "presentation"
+      tabs : [RecordTab] = []
+        @label "Which tabs follow the overview?"
+        @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)."
+        @synonyms "tabs, record tabs, sub pages, related lists"
+        @tier "presentation"
       contentField : string = content
         @label "Which field holds the document body?"
         @description "Name of the field on the loaded record that carries the rich-text HTML body the document look renders and edits (e.g. content, body, articleText)."
@@ -533,7 +607,7 @@ orbital RecordItemOrbital {
         @tier "presentation"
       coverField : string = ""
         @label "Which field is the cover image?"
-        @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."
         @synonyms "cover field, hero image field, banner field"
         @tier "presentation"
       iconField : string = ""
@@ -562,17 +636,35 @@ orbital RecordItemOrbital {
         @label "Placeholder text"
         @description "Placeholder shown in the document body when it is empty."
         @tier "presentation"
+      loadingContent : render-ui = { type: skeleton, variant: detail }
+        @label "Loading placeholder"
+        @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 }."
+        @tier "internal"
       bodyContent : render-ui = {
         children: [{
           actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           entity: @entity.loadedRow
           fields: @config.fields
+          closeEvent: @config.closeEvent
           initialData: @entity.loadedRow
           maxInlineActions: @config.maxInlineActions
           sections: @config.sections
           showActions: @config.showActions
           subtitle: @entity.description
           title: @entity.name
+          look: @config.recordLook
+          avatarField: @config.avatarField
+          coverField: @config.coverField
+          mediaField: @config.mediaField
+          stageField: @config.stageField
+          stages: @config.stages
+          latitudeField: @config.latitudeField
+          longitudeField: @config.longitudeField
+          lineItems: (object/get @entity.loadedRow @config.lineItemsField)
+          lineItemColumns: @config.lineItemColumns
+          totals: @config.totals
+          thread: (object/get @entity.loadedRow @config.threadField)
+          tabs: @config.tabs
           type: detail-panel
         }]
         direction: vertical
@@ -587,6 +679,7 @@ orbital RecordItemOrbital {
           actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           entity: @entity.loadedRow
           fields: @config.fields
+          closeEvent: @config.closeEvent
           initialData: @entity.loadedRow
           maxInlineActions: @config.maxInlineActions
           sections: @config.sections
@@ -594,6 +687,19 @@ orbital RecordItemOrbital {
           slideOver: true
           subtitle: @entity.description
           title: @entity.name
+          look: @config.recordLook
+          avatarField: @config.avatarField
+          coverField: @config.coverField
+          mediaField: @config.mediaField
+          stageField: @config.stageField
+          stages: @config.stages
+          latitudeField: @config.latitudeField
+          longitudeField: @config.longitudeField
+          lineItems: (object/get @entity.loadedRow @config.lineItemsField)
+          lineItemColumns: @config.lineItemColumns
+          totals: @config.totals
+          thread: (object/get @entity.loadedRow @config.threadField)
+          tabs: @config.tabs
           type: detail-panel
         }]
         direction: vertical
@@ -608,12 +714,26 @@ orbital RecordItemOrbital {
           actions: (array/filter @config.actions (fn action (or (= (array/len (object/get @action roles [])) 0) (array/includes (object/get @action roles []) @config.viewerRole))))
           entity: @entity.loadedRow
           fields: @config.fields
+          closeEvent: @config.closeEvent
           initialData: @entity.loadedRow
           maxInlineActions: @config.maxInlineActions
           sections: @config.sections
           showActions: @config.showActions
           subtitle: @entity.description
           title: @entity.name
+          look: @config.recordLook
+          avatarField: @config.avatarField
+          coverField: @config.coverField
+          mediaField: @config.mediaField
+          stageField: @config.stageField
+          stages: @config.stages
+          latitudeField: @config.latitudeField
+          longitudeField: @config.longitudeField
+          lineItems: (object/get @entity.loadedRow @config.lineItemsField)
+          lineItemColumns: @config.lineItemColumns
+          totals: @config.totals
+          thread: (object/get @entity.loadedRow @config.threadField)
+          tabs: @config.tabs
           type: detail-panel
         }]
         className: "w-full max-w-4xl"