refactor: remove InterfaceSchema, promote navigation tree and sharing/embed to AppSchema

- Delete interface.zod.ts and interface.test.ts
- Remove InterfaceNavItemSchema from NavigationItemSchema union
- Remove interfaces[] and defaultInterface from AppSchema
- Add sharing and embed fields to AppSchema (from SharingConfigSchema/EmbedConfigSchema)
- Restore navigation[] as full unlimited-depth navigation tree
- Rename interface-builder.zod.ts to page-builder.zod.ts (PageBuilderConfigSchema)
- Rewrite CRM example with nested navigation tree
- Migrate non-Interface tests to page.test.ts and component.test.ts
- Update ROADMAP.md, design docs, and studio roadmap
- Remove defineInterface from root exports

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

ROADMAP.md

@@ -129,7 +129,7 @@ The following renames are planned for packages that implement core service contr
 
 - [x] **Data Protocol** — Object, Field (35+ types), Query, Filter, Validation, Hook, Datasource, Dataset, Analytics, Document
 - [x] **Driver Specifications** — Memory, PostgreSQL, MongoDB driver schemas + SQL/NoSQL abstractions
-- [x] **UI Protocol** — View (List/Form/Kanban/Calendar/Gantt), App, Dashboard, Report, Action, Page (16 types), Chart, Widget, Theme, Animation, DnD, Touch, Keyboard, Responsive, Offline, Notification, i18n, Interface, Content Elements
+- [x] **UI Protocol** — View (List/Form/Kanban/Calendar/Gantt), App, Dashboard, Report, Action, Page (16 types), Chart, Widget, Theme, Animation, DnD, Touch, Keyboard, Responsive, Offline, Notification, i18n, Content Elements
 - [x] **System Protocol** — Manifest, Auth Config, Cache, Logging, Metrics, Tracing, Audit, Encryption, Masking, Migration, Tenant, Translation, Search Engine, HTTP Server, Worker, Job, Object Storage, Notification, Message Queue, Registry Config, Collaboration, Compliance, Change Management, Disaster Recovery, License, Security Context, Core Services
 - [x] **Automation Protocol** — Flow (autolaunched/screen/schedule), Workflow, State Machine, Trigger Registry, Approval, ETL, Sync, Webhook
 - [x] **AI Protocol** — Agent, Agent Action, Conversation, Cost, MCP, Model Registry, NLQ, Orchestration, Predictive, RAG Pipeline, Runtime Ops, Feedback Loop, DevOps Agent, Plugin Development
@@ -142,7 +142,7 @@ The following renames are planned for packages that implement core service contr
 - [x] **QA Protocol** — Testing framework schemas
 - [x] **Studio Protocol** — Plugin extension schemas
 - [x] **Contracts** — 25 service interfaces with full method signatures
-- [x] **Stack Definition** — `defineStack()`, `defineView()`, `defineApp()`, `defineInterface()`, `defineFlow()`, `defineAgent()` helpers
+- [x] **Stack Definition** — `defineStack()`, `defineView()`, `defineApp()`, `defineFlow()`, `defineAgent()` helpers
 - [x] **Error Map** — Custom Zod error messages with `objectStackErrorMap`
 - [x] **DX Utilities** — `safeParsePretty()`, `formatZodError()`, `suggestFieldType()`
 
@@ -355,10 +355,11 @@ The following renames are planned for packages that implement core service contr
 ### 8.1 UI Protocol Enhancement — Airtable Interface Parity
 
 > See [Airtable Interface Gap Analysis](docs/design/airtable-interface-gap-analysis.md) for the full evaluation.
+> **Note:** The `InterfaceSchema` layer has been removed in favor of direct App→Page navigation.
+> App now supports unlimited nesting depth and sharing/embed capabilities directly.
 
-#### Phase A: Interface Foundation (v3.2) ✅
+#### Phase A: Page Foundation (v3.2) ✅
 
-- [x] `InterfaceSchema` — Self-contained, shareable, multi-page application surface (`src/ui/interface.zod.ts`)
 - [x] `RecordReviewConfigSchema` — Sequential record review/approval page type with navigation and actions
 - [x] Content elements — `element:text`, `element:number`, `element:image`, `element:divider` as `PageComponentType` extensions
 - [x] Per-element data binding — `dataSource` property on `PageComponentSchema` for multi-object pages
@@ -369,26 +370,26 @@ The following renames are planned for packages that implement core service contr
 - [x] Interactive elements — `element:button`, `element:filter`, `element:form`, `element:record_picker`
 - [x] `BlankPageLayoutSchema` — Free-form canvas composition with grid-based positioning
 - [x] Record picker variable binding — `PageVariableSchema` integration with `element:record_picker`
-- [x] `InterfaceBuilderConfigSchema` — Canvas snap, zoom, element palette, layer panel configuration
-- [ ] Studio Interface Builder — Drag-and-drop element placement UI (runtime)
+- [x] `PageBuilderConfigSchema` — Canvas snap, zoom, element palette, layer panel configuration
+- [ ] Studio Page Builder — Drag-and-drop element placement UI (runtime)
 
 #### Phase C: Sharing, Embedding & Permissions (v4.0) 🟡
 
 - [x] `SharingConfigSchema` — Public link, password, domain restriction, expiration (`src/ui/sharing.zod.ts`)
 - [x] `EmbedConfigSchema` — iframe embedding with origin restrictions and display options
-- [x] Per-interface role assignment — `assignedRoles` on `InterfaceSchema`
+- [x] App-level sharing/embed — `sharing` and `embed` on `AppSchema`
 - [x] Public form sharing — `sharing` property on `FormViewSchema`
-- [ ] Design-time user impersonation — `previewAs` option for interface preview (see [UX Optimization](docs/design/visual-design-ux-optimization.md))
+- [ ] Design-time user impersonation — `previewAs` option for page preview (see [UX Optimization](docs/design/visual-design-ux-optimization.md))
 - [ ] Share link generation runtime service
 - [ ] Embed code generation runtime service
 - [ ] Security audit for shared/embedded access control
 
-#### Phase D: Advanced Interface Features (v4.1)
+#### Phase D: Advanced Page Features (v4.1)
 
-- [ ] Interface templates and duplication
-- [ ] Interface versioning — draft → published → archived lifecycle
-- [ ] Real-time collaborative interface editing
-- [ ] Interface analytics — page views, element interactions, user engagement
+- [ ] Page templates and duplication
+- [ ] Page versioning — draft → published → archived lifecycle
+- [ ] Real-time collaborative page editing
+- [ ] Page analytics — page views, element interactions, user engagement
 
 ### 8.2 Studio IDE
 
@@ -398,7 +399,7 @@ The following renames are planned for packages that implement core service contr
 - [ ] ER Diagram — interactive entity-relationship diagram with force/hierarchy/grid layouts, minimap, zoom, export (PNG/SVG)
 - [ ] Object Manager — unified object list with search, filter, card/table/tree views, quick preview, statistics
 - [ ] View Builder — drag-and-drop list/form/dashboard designers
-- [ ] Interface Builder — drag-and-drop interface designer with element palette (see [Gap Analysis](docs/design/airtable-interface-gap-analysis.md))
+- [ ] Page Builder — drag-and-drop page designer with element palette (see [Gap Analysis](docs/design/airtable-interface-gap-analysis.md))
 - [ ] Flow Builder — visual automation flow editor
 - [ ] Security Console — permission matrix, RLS policy editor
 - [ ] AI Playground — agent testing, NLQ sandbox
@@ -525,10 +526,10 @@ The following renames are planned for packages that implement core service contr
 |:---|:---|:---|
 | **v3.0** | ✅ Shipped | Protocol specification complete, core runtime stable |
 | **v3.1** | Q2 2026 | Essential services (`service-cache`, `service-queue`, `service-job`, `service-storage`), PostgreSQL driver, Turso/libSQL core driver ([design](docs/design/driver-turso.md)) |
-| **v3.2** | Q3 2026 | Communication services (`service-realtime`, `service-graphql`, `service-i18n`, `service-notification`), Turso embedded replica & edge sync, UI Protocol Enhancement Phase A (`InterfaceSchema`, `RecordReviewConfig`, content elements) — see [gap analysis](docs/design/airtable-interface-gap-analysis.md) |
-| **v3.3** | Q4 2026 | Business logic services (`service-automation`, `service-workflow`, `service-search`), Turso multi-tenancy (database-per-tenant), UI Protocol Enhancement Phase B spec ✅ complete (interactive elements, blank page layout), Studio Interface Builder runtime, Visual Design UX optimization ([plan](docs/design/visual-design-ux-optimization.md)) |
+| **v3.2** | Q3 2026 | Communication services (`service-realtime`, `service-graphql`, `service-i18n`, `service-notification`), Turso embedded replica & edge sync, UI Protocol Enhancement Phase A (`RecordReviewConfig`, content elements) — see [gap analysis](docs/design/airtable-interface-gap-analysis.md) |
+| **v3.3** | Q4 2026 | Business logic services (`service-automation`, `service-workflow`, `service-search`), Turso multi-tenancy (database-per-tenant), UI Protocol Enhancement Phase B spec ✅ complete (interactive elements, blank page layout), Studio Page Builder runtime, Visual Design UX optimization ([plan](docs/design/visual-design-ux-optimization.md)) |
 | **v4.0** | Q1 2027 | Zod v4 migration, `plugin-auth` → `service-auth` rename, JSON Schema output, OpenAPI generation, AI services, multi-tenancy, Turso vector search & FTS5 integration, UI Protocol Enhancement Phase C spec 🟡 mostly complete (sharing, embedding), `previewAs` design-time preview, Data Studio protocol, runtime share/embed services |
-| **v4.1** | Q2 2027 | Studio IDE general availability, marketplace launch, UI Protocol Enhancement Phase D (templates, versioning, collaborative editing), Interface Builder enhancements (selection model, clipboard, alignment) |
+| **v4.1** | Q2 2027 | Studio IDE general availability, marketplace launch, UI Protocol Enhancement Phase D (templates, versioning, collaborative editing), Page Builder enhancements (selection model, clipboard, alignment) |
 | **v5.0** | 2027+ | Managed cloud, app store, global ecosystem |
 
 ---

apps/studio/ROADMAP.md

@@ -118,12 +118,12 @@
 | | Mode-specific config panels: Kanban (status field, swimlanes), Calendar (date fields, duration), Gantt (dependencies, milestones). | | |
 | 2.3 | **FormView Designer** | `objectstack.form-designer` | 🔴 P0 |
 | | Section/column layout editor. Field placement with drag-and-drop. Conditional visibility (`visibleOn`). Widget selection per field. Preview mode. | | |
-| 2.4 | **Interface Builder** | `objectstack.interface-builder` | 🔴 P0 |
-| | **Airtable Interface Designer parity.** Drag-and-drop element canvas using `BlankPageLayoutSchema`. Element palette (12 types: text, number, image, divider, button, filter, form, record_picker, grid, chart, details, list). Property panel per element. Snap-to-grid with alignment guides. Layer ordering. Undo/redo (50 steps). Data source binding per element (`ElementDataSourceSchema`). See `InterfaceBuilderConfigSchema` in `@objectstack/spec/studio`. | | |
-| 2.5 | **Page Builder** | `objectstack.page-builder` | 🟡 P1 |
+| 2.4 | **Page Builder** | `objectstack.page-builder` | 🔴 P0 |
+| | **Drag-and-drop element canvas** using `BlankPageLayoutSchema`. Element palette (12 types: text, number, image, divider, button, filter, form, record_picker, grid, chart, details, list). Property panel per element. Snap-to-grid with alignment guides. Layer ordering. Undo/redo (50 steps). Data source binding per element (`ElementDataSourceSchema`). See `PageBuilderConfigSchema` in `@objectstack/spec/studio`. | | |
+| 2.5 | **Component Builder** | `objectstack.component-builder` | 🟡 P1 |
 | | Component composition canvas. Drag regions and components (header, details, related list, AI chat, custom). Property panel for each component. Preview with live data context. | | |
 | 2.6 | **App Builder** | `objectstack.app-builder` | 🟡 P1 |
-| | Navigation tree editor (drag-and-drop reorder). Add object/dashboard/page/URL items. Interface management (`interfaces[]`). Branding panel (colors, logo). Home page selector. | | |
+| | Navigation tree editor (drag-and-drop reorder). Add object/dashboard/page/URL/group items. Branding panel (colors, logo). Home page selector. Sharing/embed configuration. | | |
 | 2.7 | **Dashboard Designer** | `objectstack.dashboard-designer` | 🟡 P1 |
 | | Grid layout editor (React-Grid-Layout). Widget palette: charts, KPIs, lists, embedded views. Data source binding per widget. Auto-refresh config. | | |
 | 2.8 | **Report Builder** | `objectstack.report-builder` | 🟢 P2 |
@@ -361,7 +361,7 @@ export const myPlugin: StudioPlugin = {
 | Metadata types with dedicated viewer | 1 / 30+ | 15 / 30+ | 30+ / 30+ |
 | Object Designer protocol schemas | 16 schemas | — | — |
 | Object Designer protocol tests | 46 tests | — | — |
-| Interface Builder protocol schemas | 4 schemas | 10+ | 15+ |
+| Page Builder protocol schemas | 4 schemas | 10+ | 15+ |
 | Component test coverage | 0% | 50% | 80% |
 | Deep-linkable views | 0 | All | All |
 | Plugin count (built-in) | 7 | 20 | 35+ |

docs/design/airtable-interface-gap-analysis.md

@@ -2,7 +2,7 @@
 
 > **Author:** ObjectStack Core Team  
 > **Created:** 2026-02-16  
-> **Status:** Phase A–C Spec Complete · Studio Runtime Pending  
+> **Status:** ⚠️ SUPERSEDED — The `InterfaceSchema` layer has been removed. App now supports unlimited-depth navigation trees directly. Sharing/embed capabilities have been promoted to `AppSchema`. See the updated `app.zod.ts` for the current architecture.  
 > **Target Version:** v3.2 – v4.0
 
 ---