feat(spec)!: remove the dead PortalSchema — never-enforced no-op projection (#3464) (#3486)

PortalSchema and its StackSchema `portals` collection were a forward-looking
design that was never wired to a runtime: no metadata-type registration, no
dispatcher route family, no auth scope, and no LayoutDispatcher /
NavigationBuilder / ThemeProvider consumer. Authoring a portal was already a
documented no-op marked [EXPERIMENTAL — not enforced]. This implements issue
#3464 disposition A (prune the dead schema) rather than B (build a runtime).

Removes ui/portal.zod.ts + its test, the `portals` key on StackSchema /
defineStack, every Portal* export, the showcase ClientPortal fixture, and the
generated Portal artifacts (json-schema manifest keys, api-surface entries,
reference doc). Hand-written docs/skills stop advertising portals as a live
surface; the real guest_portal public-forms path is left untouched.

Versioned minor per the #2377 enforce-or-remove precedent and the launch-window
no-major guard.

Co-authored-by: Jack Zhuang <277994282+os-zhuang@users.noreply.github.com>
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

Author: os-zhuang

.changeset/prune-portal-schema-3464.md

@@ -0,0 +1,31 @@
+---
+"@objectstack/spec": minor
+---
+
+feat(spec)!: remove the dead PortalSchema (portal metadata was never enforced)
+
+`PortalSchema` and its top-level `portals` collection on `StackSchema` were a
+forward-looking design that was **never wired to a runtime** — no metadata-type
+registration, no dispatcher route family, no auth scope, and no
+LayoutDispatcher / NavigationBuilder / ThemeProvider ever consumed it. Authoring
+a portal was already documented as a no-op and marked
+`[EXPERIMENTAL — not enforced]`. This removes the dead schema rather than
+building a portal runtime (issue #3464, disposition **A — prune**).
+
+**Removed exports** (`@objectstack/spec`, from `ui/portal.zod`):
+`PortalSchema`, `Portal`, `definePortal`, and the `PortalInput` /
+`PortalTheme` / `PortalNavItem` (+ `PortalViewNavItem`, `PortalActionNavItem`,
+`PortalDashboardNavItem`, `PortalUrlNavItem`) / `PortalAnonymousEntry` /
+`PortalAnonymousRoute` / `PortalRateLimit` / `PortalSeo` / `PortalAuthMode` /
+`PortalLayout` schemas and inferred types. The `portals` key is removed from
+`StackSchema` / `defineStack()`.
+
+**Migration**: none required for behavior — authoring a portal had no runtime
+effect. Any `portals: [...]` entry in a `defineStack()` config was already
+ignored at runtime and should be deleted (with the schema gone it is an
+excess-property type error). To project a scoped UI to external users today,
+compose the existing `apps` / `views` surfaces and gate admission with
+`positions` + permission sets (`externalSharingModel` on the objects you
+expose).
+
+Refs #3464, #1893, #1878.

content/docs/references/ui/index.mdx

@@ -19,7 +19,6 @@ This section contains all protocol schemas for the ui layer of ObjectStack.
   <Card href="/docs/references/ui/notification" title="Notification" description="Source: packages/spec/src/ui/notification.zod.ts" />
   <Card href="/docs/references/ui/offline" title="Offline" description="Source: packages/spec/src/ui/offline.zod.ts" />
   <Card href="/docs/references/ui/page" title="Page" description="Source: packages/spec/src/ui/page.zod.ts" />
-  <Card href="/docs/references/ui/portal" title="Portal" description="Source: packages/spec/src/ui/portal.zod.ts" />
   <Card href="/docs/references/ui/report" title="Report" description="Source: packages/spec/src/ui/report.zod.ts" />
   <Card href="/docs/references/ui/responsive" title="Responsive" description="Source: packages/spec/src/ui/responsive.zod.ts" />
   <Card href="/docs/references/ui/sharing" title="Sharing" description="Source: packages/spec/src/ui/sharing.zod.ts" />

content/docs/references/ui/meta.json

@@ -5,7 +5,6 @@
     "action",
     "app",
     "page",
-    "portal",
     "view",
     "---Visualization---",
     "chart",