Component

Empty Properties Schema

Source: packages/spec/src/ui/component.zod.ts

TypeScript Usage

import { AIChatWindowProps, ElementButtonPropsSchema, ElementFilterPropsSchema, ElementFormPropsSchema, ElementImagePropsSchema, ElementMetadataViewerPropsSchema, ElementNumberPropsSchema, ElementRecordPickerPropsSchema, ElementTextInputPropsSchema, ElementTextPropsSchema, ObjectCalendarPropsSchema, ObjectFormPropsSchema, ObjectGridPropsSchema, ObjectKanbanPropsSchema, ObjectMasterDetailFormPropsSchema, ObjectMetricPropsSchema, PageAccordionProps, PageCardProps, PageContainerProps, PageHeaderProps, PageTabsProps, RecordActivityProps, RecordChatterProps, RecordDetailsProps, RecordHighlightsField, RecordHighlightsProps, RecordPathProps, RecordRelatedListProps } from '@objectstack/spec/ui';
import type { ElementNumberProps, ElementRecordPickerProps, ObjectCalendarProps, ObjectFormProps, ObjectGridProps, ObjectKanbanProps, ObjectMasterDetailFormProps, ObjectMetricProps, PageContainerProps, RecordHighlightsField, RecordPathProps } from '@objectstack/spec/ui';

// Validate data
const result = AIChatWindowProps.parse(data);

AIChatWindowProps

Properties

Property	Type	Required	Description
mode	`Enum<'float' \| 'sidebar' \| 'inline'>`	✅	Display mode for the chat window
agentId	`string`	optional	Specific AI agent to use
context	`Record<string, any>`	optional	Contextual data to pass to the AI
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

ElementButtonProps

Properties

Property	Type	Required	Description
label	`string \| Record<string, string>`	✅	Button display label
variant	`Enum<'primary' \| 'secondary' \| 'danger' \| 'ghost' \| 'link'>`	optional	Button visual variant
size	`Enum<'small' \| 'medium' \| 'large'>`	optional	Button size
icon	`string`	optional	Icon name (Lucide icon)
iconPosition	`Enum<'left' \| 'right'>`	optional	Icon position relative to label
disabled	`boolean`	optional	Disable the button
action	`{ type?: Enum<'script' \| 'url' \| 'modal' \| 'flow' \| 'api' \| 'form'>; name?: string; label?: string \| Record<string, string>; target?: string; … }`	optional	Inline action executed on click
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

ElementFilterProps

Properties

Property	Type	Required	Description
object	`string`	✅	Object to filter
fields	`string[]`	✅	Filterable field names
targetVariable	`string`	optional	Page variable to store filter state
layout	`Enum<'inline' \| 'dropdown' \| 'sidebar'>`	✅	Filter display layout
showSearch	`boolean`	✅	Show search input
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

ElementFormProps

Properties

Property	Type	Required	Description
object	`string`	✅	Object for the form
fields	`string[]`	optional	Fields to display (defaults to all editable fields)
mode	`Enum<'create' \| 'edit'>`	optional	Form mode
submitLabel	`string \| Record<string, string>`	optional	Submit button label
onSubmit	`string \| { dialect: Enum<'cel' \| 'cron' \| 'template'>; source?: string; ast?: any; meta?: object }`	optional	Action expression on form submit (CEL)
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

ElementImageProps

Properties

Property	Type	Required	Description
src	`string`	✅	Image URL or attachment field
alt	`string`	optional	Alt text for accessibility
fit	`Enum<'cover' \| 'contain' \| 'fill'>`	✅	Image object-fit mode
height	`number`	optional	Fixed height in pixels
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

ElementMetadataViewerProps

Properties

Property	Type	Required	Description
type	`Enum<'state_machine' \| 'flow' \| 'permission'>`	✅	Metadata view kind (ADR-0051): state_machine \| flow \| permission
name	`string`	✅	Target metadata item name; resolved package-scoped (ADR-0048), then dependencies (ADR-0046 §3.3)
object	`string`	optional	Owning object — required for object-scoped kinds: state_machine is a rule ON an object (ADR-0020), permission renders a matrix FOR one; omit for top-level flow
mode	`Enum<'diagram' \| 'matrix' \| 'summary'>`	optional	Render form; defaults per type (diagram for flow/state_machine, matrix for permission)
detail	`Enum<'business' \| 'technical'>`	✅	Authoring altitude (ADR-0051 §3.4): business collapses technical flow nodes to business steps + approvals. NOT access (cf. book.audience); permission projection is automatic and render-time, never set here
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

ElementNumberProps

Properties

Property	Type	Required	Description
object	`string`	✅	Source object
field	`string`	optional	Field to aggregate
aggregate	`Enum<'count' \| 'sum' \| 'avg' \| 'min' \| 'max'>`	✅	Aggregation function
filter	`any`	optional	Filter criteria
format	`Enum<'number' \| 'currency' \| 'percent'>`	optional	Number display format
prefix	`string`	optional	Prefix text (e.g. "$")
suffix	`string`	optional	Suffix text (e.g. "%")
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

ElementRecordPickerProps

Properties

Property	Type	Required	Description
object	`string`	✅	Object to pick records from
labelField	`string`	optional	Field rendered as each row's text (default `name`)
valueField	`string`	optional	Field whose value is written into the bound page variable (default `id`)
label	`string \| Record<string, string>`	optional	Control label rendered above the select
filter	`any`	optional	Filter criteria for available records
sort	`{ field: string; order: Enum<'asc' \| 'desc'> }[]`	optional	Row order — synonym of the component-level `dataSource.sort`, which takes precedence when both are set
limit	`integer`	optional	Max records offered — synonym of the component-level `dataSource.limit`, which takes precedence when both are set (renderer default 50)
targetVariable	`string`	optional	Page variable to bind selected record ID(s)
placeholder	`string \| Record<string, string>`	optional	Placeholder text
emptyText	`string \| Record<string, string>`	optional	Text shown when the query returns no records (default "No records")
displayField	`never`	optional	[REMOVED] `element:record_picker` property `displayField` was removed in @objectstack/spec 17.0.0 (#5775, ADR-0087 D2) — it was a required declaration no renderer ever read, while the renderer honoured `labelField` for the same thing and defaulted to `name`. Rename the key to `labelField`; the value (a field name) is unchanged. Run `os migrate meta --from 16` to rewrite existing sources automatically.
searchFields	`never`	optional	[REMOVED] `element:record_picker` property `searchFields` was removed in @objectstack/spec 17.0.0 (#5775, ADR-0049) — the picker renders a plain single-select with no search input, so no renderer ever read it and it narrowed nothing. Delete the key. To restrict which records the picker offers, use `filter` (or the component-level `dataSource.filter`), which the query path does apply. Run `os migrate meta --from 16` to rewrite existing sources automatically.
multiple	`never`	optional	[REMOVED] `element:record_picker` property `multiple` was removed in @objectstack/spec 17.0.0 (#5775, ADR-0049) — the picker is a single-select `Select` and the bound page variable holds one record id, so `multiple: true` selected nothing extra and reported success. Delete the key; multi-record selection is not implemented on this element. Run `os migrate meta --from 16` to rewrite existing sources automatically.
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

ElementTextInputProps

Properties

Property	Type	Required	Description
inputType	`Enum<'text' \| 'email' \| 'number' \| 'tel' \| 'url' \| 'password'>`	✅	Native input type — drives keyboard/validation affordance and how the bound value is coerced (number → numeric).
label	`string \| Record<string, string>`	optional	Field label shown above the input
placeholder	`string \| Record<string, string>`	optional	Placeholder text shown when empty
defaultValue	`string \| number`	optional	Initial value; seeds the bound page variable on mount
required	`boolean`	✅	Mark the field as required
disabled	`boolean`	✅	Disable the input
description	`string \| Record<string, string>`	optional	Helper text shown below the input
targetVariable	`string`	optional	Page variable this input writes to. Declarative hint; the live binding resolves via the variable whose `source` equals this component id (see PageVariableSchema).
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

ElementTextProps

Properties

Property	Type	Required	Description
content	`string \| Record<string, string>`	✅	Text or Markdown content — a plain string, or an inline locale map
variant	`Enum<'heading' \| 'subheading' \| 'body' \| 'caption'>`	✅	Text style variant
align	`Enum<'left' \| 'center' \| 'right'>`	✅	Text alignment
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

ObjectCalendarProps

Properties

Property	Type	Required	Description
objectName	`string`	optional	Object this calendar binds to. Optional because the component-level `dataSource` binding can supply the object instead (#6953)
calendar	`any`	optional	Calendar field config: `{ startDateField, endDateField?, titleField?, colorField?, allDayField? }`
defaultView	`Enum<'month' \| 'week' \| 'day'>`	optional	Initial view mode
filter	`any`	optional	Base query filter
sort	`any`	optional	Sort for the fetched events
data	`any[]`	optional	Pre-fetched records — skips the internal fetch
staticData	`any[]`	optional	Static inline records
locale	`string`	optional	Locale override for the calendar chrome
loading	`boolean`	optional	External loading state (honoured only alongside `data`)

ObjectFormProps

Properties

Property	Type	Required	Description
objectName	`string`	optional	Object this form creates/edits. Optional because the component-level `dataSource` binding can supply the object instead (#6953)
recordId	`string \| number`	optional	Record to load (edit/view modes)
mode	`Enum<'create' \| 'edit' \| 'view'>`	optional	Form mode
formType	`Enum<'simple' \| 'tabbed' \| 'wizard' \| 'split' \| 'drawer' \| 'modal'>`	optional	Form presentation
layout	`Enum<'vertical' \| 'horizontal' \| 'inline' \| 'grid'>`	optional	Field layout
columns	`number`	optional	Field columns in grid layout
fields	`any[]`	optional	Limit/order the fields shown
customFields	`any`	optional	Custom field definitions merged into the generated set
sections	`any[]`	optional	Form sections (`{ label, description?, fields }` — wizard steps / tab panes)
title	`string \| Record<string, string>`	optional	Form title
description	`string \| Record<string, string>`	optional	Form description (rendered by the drawer/modal presentations)
defaultTab	`string`	optional	Initially active tab (tabbed)
tabPosition	`Enum<'top' \| 'bottom' \| 'left' \| 'right'>`	optional	Tab strip position (tabbed)
allowSkip	`boolean`	optional	Allow skipping steps (wizard)
showStepIndicator	`boolean`	optional	Show the step indicator (wizard)
splitDirection	`Enum<'horizontal' \| 'vertical'>`	optional	Split direction (split)
splitSize	`number`	optional	Split panel size in percent (split)
splitResizable	`boolean`	optional	Allow resizing the split (split)
drawerSide	`Enum<'top' \| 'bottom' \| 'left' \| 'right'>`	optional	Drawer side (drawer)
drawerWidth	`string \| number`	optional	Drawer width (drawer)
modalSize	`Enum<'sm' \| 'default' \| 'lg' \| 'xl' \| 'full'>`	optional	Modal size (modal)
modalCloseButton	`boolean`	optional	Show the modal close button (modal)
contentLayout	`any`	optional	Modal content layout config (modal)
confirmOnDiscard	`boolean`	optional	Confirm before discarding edits (drawer/modal)
submitText	`string \| Record<string, string>`	optional	Submit button label
cancelText	`string \| Record<string, string>`	optional	Cancel button label
nextText	`string \| Record<string, string>`	optional	Next-step button label (wizard)
prevText	`string \| Record<string, string>`	optional	Previous-step button label (wizard)
showSubmit	`boolean`	optional	Show the submit button
showCancel	`boolean`	optional	Show the cancel button
showReset	`boolean`	optional	Show the reset button
submitBehavior	`any`	optional	What happens after a successful submit (`{ kind: 'thank-you' \| …, title?, message? }`)
successMessage	`string \| Record<string, string>`	optional	Toast message on successful submit
resetOnSuccess	`boolean`	optional	Reset the form after a successful submit
navigateOnSuccess	`any`	optional	Navigate after a successful submit
readOnly	`boolean`	optional	Render every field read-only
initialValues	`Record<string, any>`	optional	Prefill values (create mode)
initialData	`Record<string, any>`	optional	Alternate spelling of `initialValues` the renderer also reads
mobile	`any`	optional	Mobile presentation overrides

ObjectGridProps

Properties

Property	Type	Required	Description
objectName	`string`	optional	Object this grid binds to. Optional because the component-level `dataSource` binding can supply the object instead (#6953)
label	`string \| Record<string, string>`	optional	Grid label — used as the table caption and export file title
title	`string \| Record<string, string>`	optional	Fallback for `label` (the renderer reads `label \|\| title`)
columns	`any[]`	optional	Columns: field names or column definition objects
fields	`any[]`	optional	Field list fallback used when `columns` is absent
filter	`any`	optional	Base query filter (ObjectQL filter array/AST) — lowered to the wire `$filter`. THE key #7750 misspelled as plural
defaultFilters	`any`	optional	Legacy base-filter fallback, read only when `filter` is absent. Prefer `filter`
sort	`any`	optional	Initial sort (array of `{ field, order }`)
defaultSort	`any`	optional	Legacy single-sort fallback (`{ field, order }`), read only when `sort` is absent. Prefer `sort`
pagination	`any`	optional	Pagination config (`{ pageSize, pageSizeOptions, … }`); its presence enables paging
pageSize	`number`	optional	Flat page-size shorthand; `pagination.pageSize` wins when both are set
showPagination	`boolean`	optional	Show the pager (read only when `pagination` is absent)
searchableFields	`string[]`	optional	Fields the toolbar search queries; a non-empty list enables search
showSearch	`boolean`	optional	Show the search box (read only when `searchableFields` is absent)
rowHeight	`any`	optional	Row density mode (e.g. compact / comfortable)
grouping	`any`	optional	Row grouping config
aggregations	`any`	optional	Group aggregation config (sum/avg/… per column)
conditionalFormatting	`any`	optional	Conditional row/cell formatting rules
rowColor	`any`	optional	Row color rules
selection	`any`	optional	Selection config (`{ type: none \| single \| multiple }`)
selectable	`any`	optional	Legacy selection shorthand, read only when `selection` is absent. Prefer `selection`
rowActions	`any[]`	optional	Per-row action names
bulkActions	`any[]`	optional	Bulk action names shown on selection
batchActions	`any[]`	optional	Alternate spelling the renderer reads FIRST (`batchActions ?? bulkActions`)
bulkActionDefs	`any[]`	optional	Inline bulk-action definitions (full defs, not names)
navigation	`any`	optional	Row-click navigation config (`{ mode: page \| drawer \| modal \| split \| none }`)
editable	`boolean`	optional	Enable inline cell editing
singleClickEdit	`boolean`	optional	Enter cell edit on single click (default true when editable)
resizable	`boolean`	optional	Allow column resize (read before `resizableColumns`)
resizableColumns	`boolean`	optional	Alternate spelling of `resizable` (the renderer reads `resizable ?? resizableColumns`)
reorderableColumns	`boolean`	optional	Allow column drag-reorder
frozenColumns	`number`	optional	How many leading columns stay frozen (default 1)
showColumnTypeIcons	`boolean`	optional	Show field-type icons in column headers
exportOptions	`any`	optional	Export config (`{ formats, streaming }`)
operations	`any`	optional	Operation toggles (`{ export: false, … }`)
data	`any[]`	optional	Static inline rows — bypasses the object query
staticData	`any[]`	optional	Alternate spelling of `data` the renderer also reads

ObjectKanbanProps

Properties

Property	Type	Required	Description
objectName	`string`	optional	Object this board binds to. Optional because the component-level `dataSource` binding can supply the object instead (#6953)
groupBy	`string`	optional	Field whose values become the board columns
columns	`any[]`	optional	Swimlane definitions (`{ id, title }` per `groupBy` value, or bare value strings) — NOT a field projection
filter	`any`	optional	Base query filter, handed to the wire `$filter`
data	`any[]`	optional	Static inline cards — bypasses the object query
cardTitle	`string`	optional	Field rendered as each card title
titleField	`string`	optional	Legacy fallback for `cardTitle` (the board reads `cardTitle \|\| titleField`). Prefer `cardTitle`
cardFields	`string[]`	optional	Fields rendered on each card
swimlaneField	`string`	optional	Field for horizontal swimlanes (in addition to columns)
grouping	`any`	optional	View grouping config; its first field is the swimlane fallback
quickAdd	`boolean`	optional	Show the per-column quick-add affordance
coverImageField	`string`	optional	Image field rendered as the card cover
conditionalFormatting	`any`	optional	Card conditional formatting rules

ObjectMasterDetailFormProps

Properties

Property	Type	Required	Description
objectName	`string`	optional	PARENT object. Optional because the component-level `dataSource` binding can supply the object instead (#7121)
recordId	`string \| number`	optional	Parent record to load (edit mode)
mode	`Enum<'create' \| 'edit'>`	optional	Form mode
formType	`string`	optional	Parent form presentation
sections	`any[]`	optional	Parent form sections
fields	`any[]`	optional	Parent fields shown
details	`any[]`	optional	Detail collections (`{ title, childObject, addLabel?, columns?, relationshipField? }` — FK and columns auto-derive from child metadata)
title	`string \| Record<string, string>`	optional	Form title
submitText	`string \| Record<string, string>`	optional	Submit button label
cancelText	`string \| Record<string, string>`	optional	Cancel button label
showSubmit	`boolean`	optional	Show the submit button
initialValues	`Record<string, any>`	optional	Prefill values for the parent (create mode)
initialData	`Record<string, any>`	optional	Alternate spelling of `initialValues` the renderer also reads
taxRateField	`string`	optional	Child field holding the per-line tax rate (line-items totals)

ObjectMetricProps

Properties

Property	Type	Required	Description
objectName	`string`	optional	Object this metric aggregates. Optional because the component-level `dataSource` binding can supply the object instead (#6953)
label	`string \| Record<string, string>`	optional	Metric label
description	`string \| Record<string, string>`	optional	Helper text under the value
title	`string \| Record<string, string>`	optional	Drill-down panel title; defaults to the metric label
icon	`string`	optional	Icon name (Lucide)
colorVariant	`Enum<'default' \| 'blue' \| 'teal' \| 'orange' \| 'purple' \| 'success' \| 'warning' \| 'danger'>`	optional	Icon container color variant
aggregate	`any`	optional	Aggregation config (`{ field, function, groupBy? }`) run against the object
filter	`any`	optional	Filter the aggregation is scoped by
format	`string`	optional	Number format pattern (e.g. '0,0', '$0,0', '0%')
currency	`string`	optional	ISO currency code (e.g. 'USD') — enables currency formatting
prefix	`string`	optional	Static prefix before the formatted value
suffix	`string`	optional	Static suffix after the formatted value
invert	`boolean`	optional	Display `1 - value` for opposite-signal gauges (compliance/uptime)
variant	`Enum<'card' \| 'bare'>`	optional	Layout variant
fallbackValue	`string \| number`	optional	Static value shown when no data source is available
trend	`any`	optional	Static trend info (`{ value, label, direction }`)
drillDown	`any`	optional	Click-through drill config — opens the underlying records
compareTo	`any`	optional	Period-over-period comparison (`{ kind: 'previousPeriod' \| 'previousYear' }`)

PageAccordionProps

Properties

Property	Type	Required	Description
items	`{ label: string \| Record<string, string>; icon?: string; collapsed: boolean; children: any[] }[]`	✅
allowMultiple	`boolean`	✅	Allow multiple panels to be expanded simultaneously
variant	`Enum<'flush' \| 'card'>`	✅	Panel framing: 'flush' draws a divider under each panel; 'card' leaves the border to each panel's own content
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

PageCardProps

Properties

Property	Type	Required	Description
title	`string \| Record<string, string>`	optional	Display label — the default-language string, or an inline locale map (`{ en, "zh-CN" }`) resolved at render time
bordered	`boolean`	✅
actions	`never`	optional	[REMOVED] `page:card` property `actions` was removed in @objectstack/spec 17.0.0 (#6946, ADR-0087 D2) — no renderer ever read it: objectui's card renderer builds its `<Card>` from `title`, `bordered`, `children` and `footer` only, has no actions area, and the component registry never published it as an input, so an authored value was accepted and dropped. Delete the key and author the buttons as components in the card's `children` or `footer` (`element:button`, `record:quick_actions`), which is what actually renders. Run `os migrate meta --from 16` to rewrite existing sources automatically.
children	`any[]`	optional	Card content components, in order (the card body slot)
body	`never`	optional	[REMOVED] `page:card` property `body` was removed in @objectstack/spec 17.0.0 (#5775, ADR-0087 D2) — it was a second spelling of the composition slot every other container calls `children`, and the renderer reads both. Rename the key to `children`; the value (an array of child components) is unchanged. Run `os migrate meta --from 16` to rewrite existing sources automatically.
footer	`any[]`	optional	Card footer components (slot)
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

PageContainerProps

Properties

Property	Type	Required	Description
children	`any[]`	optional	Child components rendered inside this container, in order

PageHeaderProps

Properties

Property	Type	Required	Description
title	`string \| Record<string, string>`	optional	Page title. Omit to let the renderer derive the heading from the record (the default for record pages) — set explicitly on non-record pages (dashboard, landing) with no record to derive from.
subtitle	`string \| Record<string, string>`	optional	Page subtitle
icon	`never`	optional	[REMOVED] `page:header` property `icon` was removed in @objectstack/spec 17.0.0 (#6946, ADR-0087 D2) — no renderer ever read it: objectui resolves `icon` only per header action (`action.icon`), never off the header's own props bag, and the component registry never published it as an input, so an authored value was accepted and dropped. Delete the key. The header's own identity is drawn by the record chrome (`recordChrome`, on by default) and each action carries its own `icon`. Run `os migrate meta --from 16` to rewrite existing sources automatically.
breadcrumb	`boolean`	✅	Show breadcrumb
actions	`string[]`	optional	Action IDs to show in header
recordChrome	`boolean`	✅	Render the record chrome — the title as a record chip with its follow star and copy-id button. Set false on a non-record page (dashboard, landing) to fall back to the bare heading layout.
showStar	`boolean`	✅	Show the follow (favourite) star beside the record title. Part of the record chrome — no effect when `recordChrome` is false.
showCopyId	`boolean`	✅	Show the copy-record-id button beside the record title. Part of the record chrome — no effect when `recordChrome` is false.
maxVisible	`integer`	optional	How many header actions render as inline buttons before the rest fold into the overflow menu (renderer default 3).
mobileMaxVisible	`integer`	optional	The `maxVisible` budget on mobile viewports (renderer default 1).
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

PageTabsProps

Properties

Property	Type	Required	Description
tabStyle	`Enum<'line' \| 'card' \| 'pill'>`	optional	Tab-strip visual style: 'line' underlines the active tab, 'card' frames each tab, 'pill' renders rounded pills
type	`never`	optional	[REMOVED] `page:tabs` property `type` was removed in @objectstack/spec 17.0.0 (#6776, ADR-0087 D2) — a props key named `type` collides with the page component's own dispatch key, so it is unauthorable in the flat and JSX carriers and was never validated in them. Rename the key to `tabStyle`; the value (`line` \| `card` \| `pill`) is unchanged. Run `os migrate meta --from 16` to rewrite existing sources automatically.
position	`Enum<'top' \| 'left'>`	optional
alwaysShowStrip	`boolean`	optional	Render the tab strip even when only one tab is visible (renderer default: a one-tab strip is hidden).
items	`{ label: string \| Record<string, string>; icon?: string; visibleWhen?: string \| object; value?: string; … }[]`	✅
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

RecordActivityProps

Properties

Property	Type	Required	Description
types	`Enum<'comment' \| 'field_change' \| 'task' \| 'event' \| 'email' \| 'call' \| 'note' \| 'file' \| 'record_create' \| 'record_delete' \| 'approval' \| 'sharing' \| 'system'>[]`	optional	Feed item types to show (default: all)
filterMode	`Enum<'all' \| 'comments_only' \| 'changes_only' \| 'tasks_only'>`	✅	Default activity filter
showFilterToggle	`boolean`	✅	Show filter dropdown in panel header
limit	`integer`	✅	Number of items to load per page
showCompleted	`boolean`	✅	Include completed activities
unifiedTimeline	`boolean`	✅	Mix field changes and comments in one timeline (Airtable style)
showCommentInput	`boolean`	✅	Show "Leave a comment" input at the bottom
enableMentions	`boolean`	✅	Enable @mentions in comments
enableReactions	`boolean`	✅	Enable emoji reactions on feed items
enableThreading	`boolean`	✅	Enable threaded replies on comments
showSubscriptionToggle	`boolean`	✅	Show bell icon for record-level notification subscription
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

RecordChatterProps

Properties

Property	Type	Required	Description
position	`Enum<'sidebar' \| 'inline' \| 'drawer'>`	✅	Where to render the chatter panel
width	`string \| number`	optional	Panel width (e.g., "350px", "30%")
collapsible	`boolean`	✅	Whether the panel can be collapsed
defaultCollapsed	`boolean`	✅	Whether the panel starts collapsed
feed	`{ types?: Enum<'comment' \| 'field_change' \| 'task' \| 'event' \| 'email' \| 'call' \| 'note' \| … +6 more>[]; filterMode: Enum<'all' \| 'comments_only' \| 'changes_only' \| 'tasks_only'>; showFilterToggle: boolean; limit: integer; … }`	optional	Embedded activity feed configuration
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

RecordDetailsProps

Properties

Property	Type	Required	Description
columns	`Enum<'1' \| '2' \| '3' \| '4'>`	✅	Number of columns for field layout (1-4)
layout	`never`	optional	[REMOVED] `record:details` property `layout` was removed in @objectstack/spec 17.0.0 (#6946, ADR-0087 D2) — its declared `auto` \| `custom` semantics were never implemented: the renderer tests `layout` only against `inline` \| `compact`, two values the schema never permitted, so both legal values took the same branch and the key selected nothing. Delete the key — the body is already chosen by what you author: `sections` renders the explicit groups (the old `custom`), and omitting it falls back to the object's `highlightFields` (the old `auto`). Run `os migrate meta --from 16` to rewrite existing sources automatically.
sections	`{ name?: string; label?: string \| Record<string, string>; columns?: integer; fields: string[] }[]`	optional	Field groups rendered as the detail body, in order. Object form: `{ name?, label?, columns?, fields }`.
fields	`string[]`	optional	Explicit field list to display (optional, overrides highlightFields)
hideFields	`string[]`	optional	Field names to omit from the body — applied to `fields` and to every section's `fields` (used to dedupe fields already shown in `record:highlights` or as the page title)
inlineEdit	`boolean`	optional	Allow inline field editing in the detail body (renderer default: on, where the object itself is editable — set `false` to force it off).
showHeader	`boolean`	optional	Render the detail body's own heading (renderer default: off).
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

RecordHighlightsField

Highlight field: bare name, or {name,label?,icon?,type?,readonly?}

Union Options

This schema accepts one of the following structures:

Option 1

Type: string

Option 2

Properties

Property	Type	Required	Description
name	`string`	✅	Field name on the record
label	`string`	optional	Display label (overrides schema label)
icon	`string`	optional	Icon name (lucide icon key)
type	`string`	optional	Override cell renderer type (rare)
readonly	`boolean`	optional	Render this chip read-only — suppresses inline editing on the highlight card. Use for hook/automation-maintained columns that must not be hand-edited from the record header.

RecordHighlightsProps

Properties

Property	Type	Required	Description
fields	`(string \| { name: string; label?: string; icon?: string; type?: string; … })[]`	✅	Key fields to highlight (1-7 fields max, typically displayed as prominent cards). Each item may be a bare field name or `{name, label?, icon?, type?, readonly?}` for inline overrides.
layout	`Enum<'horizontal' \| 'vertical'>`	✅	Layout orientation for highlight fields
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

RecordPathProps

Properties

Property	Type	Required	Description
statusField	`string`	✅	Field name representing the current status/stage
stages	`{ value: string; label: string \| Record<string, string>; terminal?: Enum<'won' \| 'lost'> }[]`	optional	Explicit stage definitions (if not using field metadata)
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

RecordRelatedListProps

Properties

Property	Type	Required	Description
objectName	`string`	✅	Related object name (e.g., "task", "opportunity")
relationshipField	`string`	✅	Field on related object that points to this record (e.g., "account_id")
relationshipValueField	`string`	✅	Parent-record field whose value relationshipField stores (default 'id'; e.g. 'name' for name-keyed junctions).
columns	`string[]`	optional	Fields to display in the related list. Optional: when omitted, columns derive from the related object's highlightFields / default list columns (a related list is just another surface that lists that object). Override chain: child highlightFields → field-level relatedListColumns → this inline list.
sort	`string \| { field: string; order: Enum<'asc' \| 'desc'> }[]`	optional	Sort order for related records
limit	`integer`	✅	Number of records to display initially
filter	`{ field: string; operator: Enum<'equals' \| 'not_equals' \| 'contains' \| 'not_contains' \| 'starts_with' \| … +14 more>; value?: string \| number \| boolean \| null \| (string \| number)[] }[]`	optional	Additional filter criteria for related records
title	`string \| Record<string, string>`	optional	Custom title for the related list
showViewAll	`boolean`	✅	Show "View All" link to see all related records
actions	`string[]`	optional	Action IDs available for related records
add	`{ picker: object; linkField?: string; label?: string \| Record<string, string> }`	optional	Add-existing-via-picker config (generic m2m/junction assignment).
aria	`{ ariaLabel?: string \| Record<string, string>; ariaDescribedBy?: string; role?: string }`	optional	ARIA accessibility attributes

On this page