Skip to content

Commit 87aa2ce

Browse files
hotlongclaude
andcommitted
docs(releases): make v12–v14 the whole-platform (backend + Console) view
Add per-version Console (Studio) sections so each release page covers the frontend bundled into @objectstack/console, not just the backend — the whole-platform picture the version-locked train describes: - v12: adaptive record surfaces, the related-list model (primary tab, per-FK lists, self-referential child lists, unified highlightFields columns), parameterized nav filter chips, dependent picklists. - v13: brief cross-line pointer — Permission Model v2 Console surfaces roll out across v13–v14. - v14: position assignment panels, Record Attachments, and the Permission Model v2 surfaces (Roles→Positions relabel, xRef picker, Explain / Access Matrix / Delegated Administration pages). Each section links to the objectui CHANGELOG for per-commit frontend detail. Re-baseline the two migration/relabel "role" references the new copy adds (v13 15→17, v14 7→9); no other file changed. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SXFPRKA2ixrZmRFwK7Cxh6
1 parent 83ba981 commit 87aa2ce

4 files changed

Lines changed: 57 additions & 9 deletions

File tree

content/docs/releases/v12.mdx

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -173,6 +173,31 @@ validation rejects mappings targeting undefined objects at build time.
173173
Descriptions moved from `[EXPERIMENTAL — not enforced]` to `[RBAC-gated;
174174
operation pending M2]`.
175175

176+
## New in Console (Studio)
177+
178+
The Console build frozen into `@objectstack/console` 12.x renders the adaptive
179+
surfaces and related-list model this release derives:
180+
181+
- **Records open at the right size automatically** — the renderer consumes
182+
`deriveRecordSurface` / `deriveRecordFlowSurface`: field-heavy records open as
183+
a full page, light ones as a drawer/modal, and create/edit tasks always as an
184+
overlay that returns losslessly to its origin. An explicit form/navigation
185+
config still wins.
186+
- **Related lists gain structure** — a `relatedList: 'primary'` child gets its
187+
own detail-page tab while the rest collapse into one shared **Related** tab;
188+
every eligible FK surfaces its own list (a child referencing the parent
189+
through several relationships now shows each), self-referential hierarchies
190+
surface a "child" list, and the lookup picker and related list of the same
191+
object share one `highlightFields` column source.
192+
- **Parameterized nav landings** — an `ObjectNavItem.filters` entry resolves to
193+
the bare data surface (`/:object/data?filter[…]`) with removable filter chips,
194+
for drill-throughs and "assigned to me" links.
195+
- **Dependent picklists**`SelectOption.visibleWhen` hides options client-side
196+
as a UX affordance (the value is still authorized server-side).
197+
198+
For exhaustive, per-commit frontend detail, see the
199+
[objectui CHANGELOG](https://github.com/objectstack-ai/objectui/blob/main/CHANGELOG.md).
200+
176201
## Notable fixes
177202

178203
- **Package seed can no longer wedge the platform via record-change

content/docs/releases/v13.mdx

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -166,6 +166,17 @@ protocol's per-object prefix rule (`crm_account`) was silently inert.
166166
and `protocol.publishPackageDrafts` rejects any object draft whose name lacks
167167
the package prefix, atomically, with an actionable message.
168168

169+
## New in Console (Studio)
170+
171+
Permission Model v2 is a backend-heavy release; the matching Console surfaces —
172+
the Roles → Positions relabel across Setup, the Studio cross-reference picker
173+
moving its `role` kind to `position`, and the standalone **Explain**, **Access
174+
Matrix**, and **Delegated Administration** admin pages that expose the D6/D12
175+
engines — roll out across the v13–v14 line. See
176+
[v14](/docs/releases/v14)'s Console notes for the shipped surfaces, and the
177+
[objectui CHANGELOG](https://github.com/objectstack-ai/objectui/blob/main/CHANGELOG.md)
178+
for per-commit detail.
179+
169180
## Removed: declared-but-never-enforced subsystems (ADR-0056 D8)
170181

171182
Compliance-grade configuration must never merely look live. These schemas were

content/docs/releases/v14.mdx

Lines changed: 19 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -196,13 +196,25 @@ real enforced consumer.
196196
`planned` + `authorWarn`, and the docs say external-principal evaluation lands
197197
with the principal-taxonomy phase.
198198

199-
## Console (Studio) notes
200-
201-
The renderer changes that pair with this line ship in the version-locked
202-
`@objectstack/console` bundle: the generic `record:related_list` Add-picker and
203-
`relationshipValueField` support (the position panels degrade to read-only lists
204-
on older renderers), and the `RecordAttachmentsPanel` (the three-step presigned
205-
storage flow) rendered on record pages when `enable.files` is true.
199+
## New in Console (Studio)
200+
201+
The version-locked `@objectstack/console` bundle carries the frontend for this
202+
line, including the Permission Model v2 alignment that spans v13–v14:
203+
204+
- **Position assignment panels** — the generic `record:related_list` Add-picker
205+
and `relationshipValueField` support render the `sys_user` **Positions** tab
206+
and the `sys_position` **Holders** / **Permission Sets** tabs. With older
207+
renderers these degrade to read-only lists.
208+
- **Record Attachments**`RecordAttachmentsPanel` (upload / list / download /
209+
delete over the three-step presigned storage flow) renders on record pages
210+
when the object sets `enable: { files: true }`.
211+
- **Permission Model v2 surfaces** — Setup relabels Roles → Positions, the
212+
Studio cross-reference picker moves its `role` kind to `position`, and
213+
standalone **Explain**, **Access Matrix**, and **Delegated Administration**
214+
pages expose the D6/D12 engines.
215+
216+
For exhaustive, per-commit frontend detail, see the
217+
[objectui CHANGELOG](https://github.com/objectstack-ai/objectui/blob/main/CHANGELOG.md).
206218

207219
## Upgrade checklist
208220

scripts/role-word-baseline.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@
3737
"content/docs/protocol/objectui/widget-contract.mdx": 3,
3838
"content/docs/releases/implementation-status.mdx": 1,
3939
"content/docs/releases/index.mdx": 1,
40-
"content/docs/releases/v13.mdx": 15,
41-
"content/docs/releases/v14.mdx": 7,
40+
"content/docs/releases/v13.mdx": 17,
41+
"content/docs/releases/v14.mdx": 9,
4242
"content/docs/ui/forms.mdx": 3,
4343
"skills/objectstack-ai/SKILL.md": 8,
4444
"skills/objectstack-api/SKILL.md": 1,

0 commit comments

Comments
 (0)