Skip to content

Commit 9fc1d47

Browse files
committed
docs(skills): the objectstack-ui navigation rule states the derived record surface per flow
The Surface bullet in skills/objectstack-ui/rules/navigation.md said a field-heavy object opens create/edit/detail as a full page and that mobile always pages. deriveRecordFlowSurface routes only the view flow to a page; the create, edit and child task flows open a modal, bounded on desktop and full-screen on mobile; a light record on desktop opens every flow in a drawer. The bullet now states that mapping, drops the "(or object)" placement (navigation is not an object key) and pays its tokens inside the file: net 0 lines, 2273 tokens against ceiling 2273. An @objectstack/skills patch changeset accompanies it. Claude-Session: https://claude.ai/code/session_01VqGhCg9wdsBXPz54uAEWg7 Co-authored-by: Claude <noreply@anthropic.com>
1 parent 0b1179f commit 9fc1d47

2 files changed

Lines changed: 13 additions & 4 deletions

File tree

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
---
2+
'@objectstack/skills': patch
3+
---
4+
5+
docs(skills): the `objectstack-ui` navigation rule states the derived record surface per flow — viewing routes to a page, creating or editing opens a modal bounded on desktop and full-screen on mobile, a light record uses a drawer (#23753)
6+
7+
Clause-②: no
8+
9+
`skills/objectstack-ui/rules/navigation.md`'s Surface bullet said a field-heavy object opens create/edit/detail as a full page and that mobile always pages. The platform's derivation (`deriveRecordFlowSurface` in `@objectstack/spec`) routes only the `view` flow to a page; the create, edit and child task flows never route — a field-heavy record, or any record on mobile, opens them in a modal that is bounded on desktop and full-screen on mobile, and a light record on desktop opens every flow in a drawer. The bullet now states that mapping and names the override only where the spec declares it: `navigation.mode` on the list view (`navigation` is not an object key). Text only; nothing an author writes changes.

‎skills/objectstack-ui/rules/navigation.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -128,10 +128,10 @@ at runtime from how heavy the record is + the client viewport, because an author
128128
(especially an AI) cannot know the client's screen. **Write the data (fields,
129129
`fieldGroups`); let the platform lay it out.**
130130

131-
- **Surface (page vs drawer).** Derived from field count: a field-heavy object
132-
opens create/edit/detail as a **full page**; a light one as a **drawer**. Mobile
133-
always pages. Don't set it. To force it for a specific object, set
134-
`navigation.mode` (`page` | `drawer` | `modal`) on the list view (or object) — or,
131+
- **Surface.** Derived from field count and viewport. A field-heavy record, or
132+
any on mobile, is viewed on a **page** and created/edited in a **modal**
133+
(bounded on desktop, full-screen on mobile); otherwise a **drawer**. To force
134+
it, set `navigation.mode` (`page` | `drawer` | `modal`) on the list view — or,
135135
for bespoke layout, assign a record `Page`.
136136
- **Field width.** **Omit it** (`auto` sizes by widget type × current columns —
137137
textarea / rich-text / file take the row). Both keys are valid: `colSpan`

0 commit comments

Comments
 (0)