Skip to content

docs(builder-ui): draft-vs-preview semantics for the Data Form view#2523

Merged
os-zhuang merged 1 commit into
mainfrom
docs/builder-ui-preview-semantics
Jul 2, 2026
Merged

docs(builder-ui): draft-vs-preview semantics for the Data Form view#2523
os-zhuang merged 1 commit into
mainfrom
docs/builder-ui-preview-semantics

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Codifies the owner decision on the Form view's two sub-modes:

  • 布局 = draft confirmation — renders the draft at the metadata level (fields + fieldGroups, per-type control previews, no object-data SQL). Safe by construction: structural draft changes have no physical columns until publish.
  • 预览 = published runtime reference — deliberately renders the published ObjectForm, because a data-bound draft preview would hit columns that don't exist yet. Publishing stays a deliberate user action; with unpublished changes the preview now says so (companion objectui PR).
  • Data-bound draft preview = deferred — it's a structural-authoring / DDL-timing decision, not a rendering feature.

Also refreshes §4 Built-so-far (Form view 布局⇄预览 + package-level publish landed via objectui#2142/#2147/#2155) and trims Still-to-build.

Docs only.

🤖 Generated with Claude Code

Codify the decision: 布局 renders the DRAFT at the metadata level (no data SQL —
safe by construction while draft DDL hasn't landed); 预览 renders the PUBLISHED
runtime ObjectForm on purpose (structural draft changes have no physical columns
until publish; publishing stays a deliberate user action, and the UI says so when
unpublished changes exist). Data-bound draft preview = deferred (DDL-timing
decision, not a rendering feature). Also refresh the Data pillar's Built-so-far
(Form view + package-level publish landed) and Still-to-build lists.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 2, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jul 2, 2026 4:32pm

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation size/s and removed documentation Improvements or additions to documentation labels Jul 2, 2026
@os-zhuang
os-zhuang merged commit ffbade1 into main Jul 2, 2026
15 checks passed
@os-zhuang
os-zhuang deleted the docs/builder-ui-preview-semantics branch July 2, 2026 17:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant