Composable UI frames and the universal page substrate (0346)

[crs48]

Summary

Implements exploration 0346 end to end — the UI's compositional unit (the Frame), the universal page substrate, visible relations, and agents as declarative composers. Five phases, each independently reviewed by commit:

Phase 1 — Light the embeds (c7ef045, fix 1ba00d4)

• databaseEmbed blocks render live through the ViewRegistry (the host hook renderDatabaseView was wired nowhere — embeds showed a placeholder). Any registry view works inside a document: board, map, calendar, plugin views; table renders through the grid engine.
• pageEmbed upgrades from a navigation card to summary-tier live transclusion (renderPageEmbed + extractDocPreviewLines; nested embeds degrade to marker lines, so transclusion cannot recurse).
• /view of… slash command with a registry-enumerated view chooser.
• Seed: Composable Frames Demo page — table + map frames of the same database.
• Live-verification fixes: embed width containment (min-w-0 on the NodeView wrapper) and ProseMirror event isolation (meta: { selectable: false }) so in-frame clicks/keys stop editing the document.

Phase 2 — The Frame contract (3478659)

• packages/views/src/frames/: FrameDef {source, viewType, config, tier, sortKey, layout} with the Set/Collection duality (node | query | collection sources) and the canvas cost ladder; FrameRenderer + schema-dispatched frameSourceRegistry; container adapters; the generic dashboard frame widget.
• Frame tabs: /frame/<viewType>~<nodeId> + one frame TabNodeType — every plugin view becomes an openable surface with zero app edits.
• Open with… on database/frame tab headers and in-embed (persisted onto the block).
• Persistence decision memo: docs/specs/FRAME_PERSISTENCE.md.

Phase 3 — Visible studs (290bb2e)

• Entangle bus (@xnetjs/react): page-scoped hover/select co-presence; adopted by grid rows, board cards, calendar chips, map pins (halo layer), and wikilink chips — hover a row and the same node lights up in every frame.
• Relations rail: ReverseRelationsPanel (previously unwired) on the database right island with per-group Open as frame.
• Drop-to-relate: node → database frame offers add-row / add-linked-row; database → page inserts a live frame.

Phase 4 — One substrate, three geometries (21d078f)

• Node passport: the same identity section on every node surface's right island.
• Promoted frames: a frame tab renders full-bleed (/db remains the untouched native surface).
• Geometry axis: pages gain geometry: stack | grid | space (additive); toggleGeometry with the round-trip invariant proven by test (frame set passes through unchanged).
• Cycle guard: ancestry-tracked clamping (A→A, A→B→A → summary card) + depth-2 clamp, with react tests.

Phase 5 — Agents and formulas as composers (6c12e59)

• Agent tools xnet_plan_frame_placement / xnet_apply_frame_placement / xnet_compose_page riding the existing plan→validate→apply pipeline (declarative tier only; audited; rollbackable). Tool-surface characterization updated.
• Cross-node formula scope: RELATED() / NODE() context functions (one engine; scope formulas bypass the value cache until 0317).
• 0213 seam closed: createFrameAwareDeliver / createIntegrationApply materialize webhook deliveries into ExternalItem nodes with an optional frameTarget page.
• Plugin capability rule: registerFrameRenderer namespaces ids per plugin; first-party renderers can't be shadowed.

Validation

• 492 test files / 5,023 tests green locally (all touched packages + apps/web), full-repo typecheck green (95 tasks).
• Live browser verification of the demo page: live table frame (real rows, inline editing), live map frame (9 pins from the same DB), live page transclusion with expand — two integration bugs found and fixed this way (width containment, PM event isolation).
• Two validation items rest on layer-below automated coverage rather than machine-driven end-to-end interaction: cross-frame live propagation and the remote-edit path both ride the store→bridge delta fan-out covered by the existing data-bridge/grid live tests (local and isRemote edits take the identical invalidation path). Screenshot parity for promoted frames holds by construction (/db surface untouched).

Changeset: editor/views/react/plugins/data minor (fixed-core lockstep). Changelog fragment included.

🤖 Generated with Claude Code

[github-actions]

Preview removed for PR #552.

[github-actions]

🖼️ UI changes in this PR

Screens

🆕 Home

Interactions

🎬 Create a page and use the editor

▶ Watch MP4

_{Auto-captured by CI · run. Informational — not a blocking check.}