docs: teach highlightFields/stageField in place of compactLayout (ADR-0085)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: os-zhuang

content/docs/guides/data-modeling.mdx

@@ -39,7 +39,7 @@ export const MyObject = ObjectSchema.create({
 
   // Display configuration
   titleFormat: '{{record.field1}} - {{record.field2}}',
-  compactLayout: ['field1', 'field2', 'field3'],
+  highlightFields: ['field1', 'field2', 'field3'],
 
   // Fields definition
   fields: {
@@ -67,7 +67,7 @@ export const MyObject = ObjectSchema.create({
 | `icon` | string | Icon identifier | `'building'` |
 | `description` | string | Help text | `'Companies...'` |
 | `titleFormat` | string | Record title template (`{{record.field}}` interpolation) | `'{{record.name}} - {{record.id}}'` |
-| `compactLayout` | string[] | Quick view fields | `['name', 'status']` |
+| `highlightFields` | string[] | Most-important fields, in priority order (default columns, cards, previews, detail highlight strip; ADR-0085 — formerly `compactLayout`, still accepted as an alias) | `['name', 'status']` |
 
 ### Enable Features
 

content/docs/guides/metadata/object.mdx

@@ -68,7 +68,8 @@ export const Account = ObjectSchema.create({
 | :--- | :--- | :--- | :--- |
 | `displayNameField` | `string` | optional | Field used as record display name (defaults to `'name'`) |
 | `titleFormat` | `string` | optional | Title expression (e.g. `'{name} - {code}'`) |
-| `compactLayout` | `string[]` | optional | Primary fields for hover cards and lookups |
+| `highlightFields` | `string[]` | optional | Most-important fields in priority order — default list columns, cards, previews, detail highlight strip (ADR-0085; formerly `compactLayout`, accepted as an alias) |
+| `stageField` | `string \| false` | optional | Linear lifecycle field; `false` declares the status field non-linear and suppresses stage heuristics (ADR-0085) |
 | `recordName` | `object` | optional | Record name auto-generation config |
 
 ### Capabilities (`enable`)

content/docs/guides/standards.mdx

@@ -95,7 +95,7 @@ export const MyObject = ObjectSchema.create({
 
   // ✅ Display Configuration
   titleFormat: '{field1} - {field2}',
-  compactLayout: ['field1', 'field2', 'field3'],
+  highlightFields: ['field1', 'field2', 'field3'],
 
   // ✅ Fields Definition
   fields: {

content/docs/references/ui/component.mdx

@@ -274,9 +274,9 @@ const result = AIChatWindowProps.parse(data);
 | Property | Type | Required | Description |
 | :--- | :--- | :--- | :--- |
 | **columns** | `Enum<'1' \| '2' \| '3' \| '4'>` | ✅ | Number of columns for field layout (1-4) |
-| **layout** | `Enum<'auto' \| 'custom'>` | ✅ | Layout mode: auto uses object compactLayout, custom uses explicit sections |
+| **layout** | `Enum<'auto' \| 'custom'>` | ✅ | Layout mode: auto uses object highlightFields (formerly compactLayout), custom uses explicit sections |
 | **sections** | `string[]` | optional | Section IDs to show (required when layout is "custom") |
-| **fields** | `string[]` | optional | Explicit field list to display (optional, overrides compactLayout) |
+| **fields** | `string[]` | optional | Explicit field list to display (optional, overrides highlightFields) |
 | **aria** | `Object` | optional | ARIA accessibility attributes |