@elytracms/studio 0.0.86 → 0.0.88

package/dist/router/navigate-once.js.map

@@ -1 +1 @@
-{"version":3,"file":"navigate-once.js","sourceRoot":"","sources":["../../src/router/navigate-once.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useLayoutEffect, useRef } from 'react'\nimport { useLocation, useNavigate, useRouter } from '@tanstack/react-router'\n\n/**\n * Render-time redirect that fires its navigation ONCE per redirect intent per\n * committed location (EC-441). The studio's declarative redirects (launcher\n * auto-forward, project index → landing view, auth-gate bounces, deep-link\n * normalizations) must use THIS instead of TanStack Router's `<Navigate>`.\n *\n * Why: `<Navigate>` re-fires `navigate(props)` whenever its props OBJECT\n * IDENTITY changes — and JSX builds a fresh props object on every parent\n * render. While the redirect's target transition is still pending (slow route\n * modules on a cold dev boot, slow chunks in production), the redirecting\n * component stays mounted and re-renders on every router-store tick; each\n * re-render re-navigates, each `navigate()` re-enters `commitLocation`/`load`\n * and schedules another transition state update, and the cycle compounds until\n * React throws \"Maximum update depth exceeded\" inside `commitLocation` — an\n * unhandled rejection of the router's load promise (the EC-439 finding: 104\n * launcher re-navigations on one cold playground boot).\n *\n * The decision core (`nextRedirectAttempt`) is pure and value-keyed:\n *\n * - already at the target → never fire (idempotence — covers the EC-179 keyed\n *   `AuthProvider` remount, which recreates the redirecting component with\n *   fresh refs while the router has already committed the target);\n * - one fire per intent per committed location — re-renders and store ticks\n *   while the target transition is pending are inert;\n * - a NEW committed location re-arms the attempt, so navigating back to a URL\n *   that redirects (e.g. the bare project index) redirects again.\n */\nexport interface NavigateOnceIntent {\n  /** Target route path, addressed as a plain string (the router-seam contract). */\n  to: string\n  /** Route params (`{ projectId, _splat }` for the studio splat). */\n  params?: Record<string, string>\n  /** Search params for the target location. */\n  search?: Record<string, unknown>\n  /** Replace the current history entry (a redirect must not create one). */\n  replace?: boolean\n}\n\n/**\n * Pure value identity of a redirect intent. Fresh-but-equal `params`/`search`\n * objects (the upstream failure mode: new object literal every render) map to\n * ONE key; top-level entries are order-normalized so key insertion order never\n * splits an intent. Values are JSON-serialized — the studio's redirect targets\n * are strings and flat search records, both deterministic under JSON.\n */\nexport function navigateIntentKey(intent: NavigateOnceIntent): string {\n  const sorted = (record: Record<string, unknown> | undefined) =>\n    record\n      ? Object.entries(record).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))\n      : null\n  return JSON.stringify([\n    intent.to,\n    sorted(intent.params),\n    sorted(intent.search),\n    intent.replace === true,\n  ])\n}\n\n/**\n * Href equality for \"is this redirect already committed?\", trailing-slash\n * trimmed on the path segment (matching the router's own same-URL comparison)\n * while search and hash stay significant.\n */\nexport function isSameRedirectTarget(targetHref: string, committedHref: string): boolean {\n  const trim = (href: string) => {\n    const [pathAndSearch = '', hash = ''] = href.split('#', 2)\n    const [path = '', search = ''] = pathAndSearch.split('?', 2)\n    const trimmedPath = path.length > 1 ? path.replace(/\\/+$/, '') : path\n    return `${trimmedPath}${search ? `?${search}` : ''}${hash ? `#${hash}` : ''}`\n  }\n  return trim(targetHref) === trim(committedHref)\n}\n\n/**\n * Attempt bookkeeping for one mounted redirect: which intent keys have already\n * fired at the CURRENT committed location. A new committed href resets the set\n * (re-arm); the state is immutable so the caller can hold it in a ref.\n */\nexport interface RedirectAttemptState {\n  committedHref: string\n  firedKeys: ReadonlySet<string>\n}\n\n/**\n * The pure fire decision (EC-441's loop breaker, node-tested):\n *\n * 1. target already committed → no fire;\n * 2. this intent already fired at this committed location → no fire (the\n *    per-render re-fire cycle, and any intent ping-pong at one location);\n * 3. otherwise → fire, and record the intent for this location.\n */\nexport function nextRedirectAttempt(\n  state: RedirectAttemptState | null,\n  input: { intentKey: string; targetHref: string; committedHref: string },\n): { fire: boolean; state: RedirectAttemptState } {\n  const base: RedirectAttemptState =\n    state && state.committedHref === input.committedHref\n      ? state\n      : { committedHref: input.committedHref, firedKeys: new Set<string>() }\n  if (isSameRedirectTarget(input.targetHref, input.committedHref)) return { fire: false, state: base }\n  if (base.firedKeys.has(input.intentKey)) return { fire: false, state: base }\n  return {\n    fire: true,\n    state: {\n      committedHref: base.committedHref,\n      firedKeys: new Set(base.firedKeys).add(input.intentKey),\n    },\n  }\n}\n\n// Layout-effect timing on the client (start the redirect before paint, like\n// upstream `<Navigate>`); plain effect on the server, where layout effects warn\n// and redirects never run (the studio's redirect surfaces render null on SSR).\nconst useIsomorphicLayoutEffect = typeof document !== 'undefined' ? useLayoutEffect : useEffect\n\nexport function NavigateOnce({ to, params, search, replace }: NavigateOnceIntent) {\n  const router = useRouter()\n  const navigate = useNavigate()\n  // The COMMITTED location (not transient transition state): effect deps stay\n  // stable across the pending-transition re-renders that used to re-fire\n  // `<Navigate>`, and a commit re-runs the decision exactly once.\n  const committedHref = useLocation({ select: (location) => location.href })\n  const key = navigateIntentKey({ to, params, search, replace })\n  // Latest-value ref: the effect is keyed on the intent's VALUE (`key`), so it\n  // reads the current props through a ref instead of listing unstable object\n  // identities as dependencies.\n  const intentRef = useRef<NavigateOnceIntent>({ to, params, search, replace })\n  intentRef.current = { to, params, search, replace }\n  const attemptRef = useRef<RedirectAttemptState | null>(null)\n\n  useIsomorphicLayoutEffect(() => {\n    const intent = intentRef.current\n    const target = router.buildLocation({\n      to: intent.to,\n      params: intent.params,\n      search: intent.search,\n    })\n    const decision = nextRedirectAttempt(attemptRef.current, {\n      intentKey: key,\n      targetHref: target.href,\n      committedHref,\n    })\n    attemptRef.current = decision.state\n    if (!decision.fire) return\n    // Fire-and-forget, exactly like upstream `<Navigate>`: with the re-fire\n    // cycle gone the transition settles normally, so nothing here swallows a\n    // real navigation failure.\n    void navigate({\n      to: intent.to,\n      params: intent.params,\n      search: intent.search,\n      replace: intent.replace,\n    })\n  }, [key, committedHref, navigate, router])\n\n  return null\n}\n"]}
+{"version":3,"file":"navigate-once.js","sourceRoot":"","sources":["../../src/router/navigate-once.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useLayoutEffect, useRef } from 'react'\nimport { useLocation, useMatch, useNavigate, useRouter } from '@tanstack/react-router'\n\n/**\n * Render-time redirect that fires its navigation ONCE per redirect intent per\n * committed location (EC-441). The studio's declarative redirects (launcher\n * auto-forward, project index → landing view, auth-gate bounces, deep-link\n * normalizations) must use THIS instead of TanStack Router's `<Navigate>`.\n *\n * Why: `<Navigate>` re-fires `navigate(props)` whenever its props OBJECT\n * IDENTITY changes — and JSX builds a fresh props object on every parent\n * render. While the redirect's target transition is still pending (slow route\n * modules on a cold dev boot, slow chunks in production), the redirecting\n * component stays mounted and re-renders on every router-store tick; each\n * re-render re-navigates, each `navigate()` re-enters `commitLocation`/`load`\n * and schedules another transition state update, and the cycle compounds until\n * React throws \"Maximum update depth exceeded\" inside `commitLocation` — an\n * unhandled rejection of the router's load promise (the EC-439 finding: 104\n * launcher re-navigations on one cold playground boot).\n *\n * The decision core (`nextRedirectAttempt`) is pure and value-keyed:\n *\n * - already at the target → never fire (idempotence — covers the EC-179 keyed\n *   `AuthProvider` remount, which recreates the redirecting component with\n *   fresh refs while the router has already committed the target);\n * - one fire per intent per committed location — re-renders and store ticks\n *   while the target transition is pending are inert;\n * - a NEW committed location re-arms the attempt, so navigating back to a URL\n *   that redirects (e.g. the bare project index) redirects again;\n * - a redirect rendered by a route the committed location no longer matches is\n *   inert (EC-611). While a transition is pending the router keeps rendering\n *   the PREVIOUS match set, so a route component outlives its own URL: the\n *   launcher (`/`) is still mounted at `/sign-in?redirect=/aurora` until the\n *   sign-in module has loaded. Left to fire, its auto-forward and the auth\n *   gate's sign-in bounce alternate, each commit re-arming the other — the\n *   signed-out boot hang on `@tanstack/react-router` ≥ 1.170.41 (NK-050 F3).\n */\nexport interface NavigateOnceIntent {\n  /** Target route path, addressed as a plain string (the router-seam contract). */\n  to: string\n  /** Route params (`{ projectId, _splat }` for the studio splat). */\n  params?: Record<string, string>\n  /** Search params for the target location. */\n  search?: Record<string, unknown>\n  /** Replace the current history entry (a redirect must not create one). */\n  replace?: boolean\n}\n\n/**\n * Pure value identity of a redirect intent. Fresh-but-equal `params`/`search`\n * objects (the upstream failure mode: new object literal every render) map to\n * ONE key; top-level entries are order-normalized so key insertion order never\n * splits an intent. Values are JSON-serialized — the studio's redirect targets\n * are strings and flat search records, both deterministic under JSON.\n */\nexport function navigateIntentKey(intent: NavigateOnceIntent): string {\n  const sorted = (record: Record<string, unknown> | undefined) =>\n    record\n      ? Object.entries(record).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))\n      : null\n  return JSON.stringify([\n    intent.to,\n    sorted(intent.params),\n    sorted(intent.search),\n    intent.replace === true,\n  ])\n}\n\n/**\n * Href equality for \"is this redirect already committed?\", trailing-slash\n * trimmed on the path segment (matching the router's own same-URL comparison)\n * while search and hash stay significant.\n */\nexport function isSameRedirectTarget(targetHref: string, committedHref: string): boolean {\n  const trim = (href: string) => {\n    const [pathAndSearch = '', hash = ''] = href.split('#', 2)\n    const [path = '', search = ''] = pathAndSearch.split('?', 2)\n    const trimmedPath = path.length > 1 ? path.replace(/\\/+$/, '') : path\n    return `${trimmedPath}${search ? `?${search}` : ''}${hash ? `#${hash}` : ''}`\n  }\n  return trim(targetHref) === trim(committedHref)\n}\n\n/**\n * Attempt bookkeeping for one mounted redirect: which intent keys have already\n * fired at the CURRENT committed location. A new committed href resets the set\n * (re-arm); the state is immutable so the caller can hold it in a ref.\n */\nexport interface RedirectAttemptState {\n  committedHref: string\n  firedKeys: ReadonlySet<string>\n}\n\n/**\n * The pure fire decision (EC-441's loop breaker, node-tested):\n *\n * 1. the rendering route is not matched by the committed location → no fire\n *    (a stale render during a pending transition, EC-611);\n * 2. target already committed → no fire;\n * 3. this intent already fired at this committed location → no fire (the\n *    per-render re-fire cycle, and any intent ping-pong at one location);\n * 4. otherwise → fire, and record the intent for this location.\n */\nexport function nextRedirectAttempt(\n  state: RedirectAttemptState | null,\n  input: {\n    intentKey: string\n    targetHref: string\n    committedHref: string\n    /**\n     * Whether the route this redirect renders in is part of the committed\n     * location's match set. Absent means \"not a route-scoped render\" (treated\n     * as matched) so the decision stays usable from the root layout.\n     */\n    routeMatched?: boolean\n  },\n): { fire: boolean; state: RedirectAttemptState } {\n  const base: RedirectAttemptState =\n    state && state.committedHref === input.committedHref\n      ? state\n      : { committedHref: input.committedHref, firedKeys: new Set<string>() }\n  if (input.routeMatched === false) return { fire: false, state: base }\n  if (isSameRedirectTarget(input.targetHref, input.committedHref)) return { fire: false, state: base }\n  if (base.firedKeys.has(input.intentKey)) return { fire: false, state: base }\n  return {\n    fire: true,\n    state: {\n      committedHref: base.committedHref,\n      firedKeys: new Set(base.firedKeys).add(input.intentKey),\n    },\n  }\n}\n\n// Layout-effect timing on the client (start the redirect before paint, like\n// upstream `<Navigate>`); plain effect on the server, where layout effects warn\n// and redirects never run (the studio's redirect surfaces render null on SSR).\nconst useIsomorphicLayoutEffect = typeof document !== 'undefined' ? useLayoutEffect : useEffect\n\nexport function NavigateOnce({ to, params, search, replace }: NavigateOnceIntent) {\n  const router = useRouter()\n  const navigate = useNavigate()\n  // The COMMITTED location (not transient transition state): effect deps stay\n  // stable across the pending-transition re-renders that used to re-fire\n  // `<Navigate>`, and a commit re-runs the decision exactly once.\n  const committedHref = useLocation({ select: (location) => location.href })\n  // The route this redirect renders in (EC-611). `strict: false` resolves the\n  // NEAREST match, so a redirect in the root layout (the auth gate) reads the\n  // root route, which every location matches, and a redirect in a route\n  // component reads that route — which the committed location stops matching\n  // the moment a transition away from it starts.\n  const routeId = useMatch({ strict: false, select: (match) => match.routeId }) as\n    | string\n    | undefined\n  const key = navigateIntentKey({ to, params, search, replace })\n  // Latest-value ref: the effect is keyed on the intent's VALUE (`key`), so it\n  // reads the current props through a ref instead of listing unstable object\n  // identities as dependencies.\n  const intentRef = useRef<NavigateOnceIntent>({ to, params, search, replace })\n  intentRef.current = { to, params, search, replace }\n  const attemptRef = useRef<RedirectAttemptState | null>(null)\n\n  useIsomorphicLayoutEffect(() => {\n    const intent = intentRef.current\n    const target = router.buildLocation({\n      to: intent.to,\n      params: intent.params,\n      search: intent.search,\n    })\n    // Match the COMMITTED location against the route tree (no load, no state\n    // change): is the route rendering this redirect still on the URL? During\n    // a pending transition the previous match set keeps rendering, so this is\n    // the one fact that tells a live redirect from a stale one.\n    const routeMatched =\n      routeId === undefined ||\n      router.matchRoutes(router.state.location).some((match) => match.routeId === routeId)\n    const decision = nextRedirectAttempt(attemptRef.current, {\n      intentKey: key,\n      targetHref: target.href,\n      committedHref,\n      routeMatched,\n    })\n    attemptRef.current = decision.state\n    if (!decision.fire) return\n    // Fire-and-forget, exactly like upstream `<Navigate>`: with the re-fire\n    // cycle gone the transition settles normally, so nothing here swallows a\n    // real navigation failure.\n    void navigate({\n      to: intent.to,\n      params: intent.params,\n      search: intent.search,\n      replace: intent.replace,\n    })\n  }, [key, committedHref, navigate, router, routeId])\n\n  return null\n}\n"]}

package/dist/ui/badge.d.ts

@@ -1,7 +1,7 @@
 import { type VariantProps } from 'class-variance-authority';
 import type { HTMLAttributes } from 'react';
 export declare const badgeVariants: (props?: ({
-    variant?: "error" | "default" | "warning" | "info" | "success" | "primary" | "outline" | null | undefined;
+    variant?: "error" | "default" | "warning" | "success" | "primary" | "outline" | "info" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 export interface BadgeProps extends HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elytracms/studio",
   "author": "finaldream <hi@finaldream.de>",
-  "version": "0.0.86",
+  "version": "0.0.88",
   "engines": {
     "node": ">=22.18.0"
   },
@@ -153,7 +153,7 @@
     "lucide-react": "^1.23.0",
     "tailwind-merge": "^3.6.0",
     "zod": "^4.4.3",
-    "@elytracms/core": "^0.0.86"
+    "@elytracms/core": "^0.0.88"
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.170.0",
@@ -168,7 +168,7 @@
     }
   },
   "devDependencies": {
-    "@tanstack/react-router": "^1.170.17",
+    "@tanstack/react-router": "^1.170.41",
     "@types/node": "^26.1.0",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",

package/src/styles/studio.css

@@ -17,10 +17,11 @@
 @import '@fontsource-variable/hanken-grotesk';
 @import '@fontsource-variable/jetbrains-mono';
 /*
- * Design-token CSS variables (`:root` + `.dark`) are GENERATED from the canonical
- * @elytracms/design-tokens package. Edit tokens there and run `pnpm gen:tokens`.
- * Cool-slate neutrals + a confident cobalt accent; monospace carries every technical
- * token (component ids, path tokens, issue codes) to reinforce the code-first identity.
+ * The colour roles are declared once, hand-written, in tokens.css (EC-607); the
+ * `@theme inline` block below maps each to its Tailwind colour and is the one
+ * declaration of the fonts and the radius scale. Cool-slate neutrals + a confident
+ * cobalt accent; monospace carries every technical token (component ids, path tokens,
+ * issue codes) to reinforce the code-first identity.
  */
 @import './tokens.css';
 

package/src/styles/tokens.css

@@ -1,63 +1,80 @@
-/* GENERATED from @elytracms/design-tokens — do not edit by hand. Run `pnpm gen:tokens`. */
+/*
+ * Studio colour tokens: the one declaration (EC-607). Hand-written, so edit here.
+ *
+ * Each role is declared ONCE as `light-dark(<light>, <dark>)`, so a role cannot
+ * exist without both values. The `dark` class on <html> (lib/theme.ts) only flips
+ * `color-scheme`, which picks the value; it also gives native controls and
+ * scrollbars the matching scheme. A role that tracks another is a plain `var()`.
+ *
+ * Components never use raw colours: studio.css maps each role to a Tailwind colour
+ * (`bg-primary`, `text-muted-foreground`, …) and the in-canvas chrome uses no var()
+ * at all (canvas-chrome-css.ts). A new role is one line here plus its `@theme inline`
+ * line in studio.css; lib/theme-tokens-contract.test.ts fails if a mapped role is missing.
+ *
+ * Needs light-dark(): Chrome 123, Safari 17.5, Firefox 120.
+ */
 :root {
-  --background: oklch(0.985 0.002 250);
-  --foreground: oklch(0.21 0.02 264);
-  --card: oklch(1 0 0);
+  color-scheme: light;
+  --radius: 0.5rem;
+
+  /* App canvas background */
+  --background: light-dark(oklch(0.985 0.002 250), oklch(0.176 0.012 264));
+  /* Primary text */
+  --foreground: light-dark(oklch(0.21 0.02 264), oklch(0.95 0.005 250));
+  /* Card surface */
+  --card: light-dark(oklch(1 0 0), oklch(0.205 0.013 264));
+  /* Text on cards */
   --card-foreground: var(--foreground);
-  --panel: oklch(0.974 0.003 255);
+  /* Inspector / rail surface */
+  --panel: light-dark(oklch(0.974 0.003 255), oklch(0.196 0.013 264));
+  /* Text on panels */
   --panel-foreground: var(--foreground);
-  --popover: oklch(1 0 0);
+  /* Floating surface */
+  --popover: light-dark(oklch(1 0 0), oklch(0.214 0.013 264));
+  /* Text on popovers */
   --popover-foreground: var(--foreground);
-  --muted: oklch(0.955 0.004 255);
-  --muted-foreground: oklch(0.5 0.018 260);
-  --border: oklch(0.908 0.005 260);
-  --input: oklch(0.908 0.005 260);
-  --ring: oklch(0.55 0.17 256);
-  --primary: oklch(0.55 0.17 256);
-  --primary-foreground: oklch(0.99 0.005 250);
-  --secondary: oklch(0.955 0.004 255);
-  --secondary-foreground: oklch(0.3 0.02 264);
-  --accent: oklch(0.95 0.022 256);
-  --accent-foreground: oklch(0.36 0.07 256);
-  --success: oklch(0.58 0.13 150);
-  --success-foreground: oklch(0.99 0.01 150);
-  --warning: oklch(0.68 0.14 70);
-  --warning-foreground: oklch(0.24 0.04 70);
-  --destructive: oklch(0.57 0.2 27);
-  --destructive-foreground: oklch(0.99 0.01 27);
-  --info: oklch(0.56 0.12 248);
-  --info-foreground: oklch(0.99 0.01 248);
-  --grid-line: oklch(0.8 0.01 260 / 0.5);
-  --radius: 0.5rem;
+  /* Subtle fill */
+  --muted: light-dark(oklch(0.955 0.004 255), oklch(0.256 0.013 264));
+  /* Secondary text */
+  --muted-foreground: light-dark(oklch(0.5 0.018 260), oklch(0.66 0.02 258));
+  /* Hairline borders */
+  --border: light-dark(oklch(0.908 0.005 260), oklch(0.278 0.013 264));
+  /* Form control borders */
+  --input: light-dark(oklch(0.908 0.005 260), oklch(0.3 0.013 264));
+  /* Focus ring */
+  --ring: light-dark(oklch(0.55 0.17 256), oklch(0.66 0.16 256));
+  /* Primary action (cobalt) */
+  --primary: light-dark(oklch(0.55 0.17 256), oklch(0.66 0.16 256));
+  /* Text on primary */
+  --primary-foreground: light-dark(oklch(0.99 0.005 250), oklch(0.16 0.02 264));
+  /* Secondary action */
+  --secondary: light-dark(oklch(0.955 0.004 255), oklch(0.256 0.013 264));
+  /* Text on secondary */
+  --secondary-foreground: light-dark(oklch(0.3 0.02 264), oklch(0.92 0.005 250));
+  /* Selected / emphasis fill */
+  --accent: light-dark(oklch(0.95 0.022 256), oklch(0.288 0.03 256));
+  /* Text on accent */
+  --accent-foreground: light-dark(oklch(0.36 0.07 256), oklch(0.88 0.03 256));
+  /* Success / valid */
+  --success: light-dark(oklch(0.58 0.13 150), oklch(0.7 0.14 150));
+  /* Text on success */
+  --success-foreground: light-dark(oklch(0.99 0.01 150), oklch(0.16 0.03 150));
+  /* Warning */
+  --warning: light-dark(oklch(0.68 0.14 70), oklch(0.79 0.14 75));
+  /* Text on warning */
+  --warning-foreground: light-dark(oklch(0.24 0.04 70), oklch(0.2 0.04 75));
+  /* Error / destructive */
+  --destructive: light-dark(oklch(0.57 0.2 27), oklch(0.67 0.18 25));
+  /* Text on destructive */
+  --destructive-foreground: light-dark(oklch(0.99 0.01 27), oklch(0.16 0.03 25));
+  /* Informational / bound */
+  --info: light-dark(oklch(0.56 0.12 248), oklch(0.7 0.13 245));
+  /* Text on info */
+  --info-foreground: light-dark(oklch(0.99 0.01 248), oklch(0.16 0.03 245));
+  /* Canvas grid lines */
+  --grid-line: light-dark(oklch(0.8 0.01 260 / 0.5), oklch(0.5 0.012 264 / 0.32));
 }
 
 .dark {
-  --background: oklch(0.176 0.012 264);
-  --foreground: oklch(0.95 0.005 250);
-  --card: oklch(0.205 0.013 264);
-  --card-foreground: var(--foreground);
-  --panel: oklch(0.196 0.013 264);
-  --panel-foreground: var(--foreground);
-  --popover: oklch(0.214 0.013 264);
-  --popover-foreground: var(--foreground);
-  --muted: oklch(0.256 0.013 264);
-  --muted-foreground: oklch(0.66 0.02 258);
-  --border: oklch(0.278 0.013 264);
-  --input: oklch(0.3 0.013 264);
-  --ring: oklch(0.66 0.16 256);
-  --primary: oklch(0.66 0.16 256);
-  --primary-foreground: oklch(0.16 0.02 264);
-  --secondary: oklch(0.256 0.013 264);
-  --secondary-foreground: oklch(0.92 0.005 250);
-  --accent: oklch(0.288 0.03 256);
-  --accent-foreground: oklch(0.88 0.03 256);
-  --success: oklch(0.7 0.14 150);
-  --success-foreground: oklch(0.16 0.03 150);
-  --warning: oklch(0.79 0.14 75);
-  --warning-foreground: oklch(0.2 0.04 75);
-  --destructive: oklch(0.67 0.18 25);
-  --destructive-foreground: oklch(0.16 0.03 25);
-  --info: oklch(0.7 0.13 245);
-  --info-foreground: oklch(0.16 0.03 245);
-  --grid-line: oklch(0.5 0.012 264 / 0.32);
+  color-scheme: dark;
 }

package/convex/content.ts

@@ -1,291 +0,0 @@
-import { documentKey, documentSchema, unfoldValue } from '@elytracms/core/cms-core'
-import type {
-  CmsDocument,
-  CmsValidationIssue,
-  CollectionDef,
-  Locale,
-  LocaleConfig,
-  RedirectRecord,
-  RouteRecord,
-} from '@elytracms/core/cms-core'
-import { createContentClient, createContentContext, isDocumentHistory, rawDocument } from '@elytracms/core/content'
-import type {
-  ContentClient,
-  ContentContext,
-  ContentDocumentSource,
-  ContentLookup,
-  Perspective,
-} from '@elytracms/core/content'
-import type { AssetRecord } from '@elytracms/core/persistence'
-import type { QueryCtx } from './functions'
-
-/**
- * EC-145 — the Convex-side content kit (vision AD-3/AD-4).
- *
- * Custom Convex functions are the query escape hatch ("our query language is
- * TypeScript") — but only if developers never touch raw tables. `createContent`
- * gives a Convex query function the same delivery surface as the Next-side
- * accessors: `get`, `list`, `resolvePage`, plus the `raw` escape hatch, all
- * with ambient `{ locale, perspective }` context.
- *
- * Byte-equivalence with the Next side is guaranteed by construction: the kit
- * loads rows through `ctx.db`, builds the same synchronous `ContentLookup`
- * that `@elytracms/next`'s snapshot builds from a `PersistenceAdapter`, and then
- * runs the EXACT pure functions from `@elytracms/core/content`
- * (`createContentClient` → `resolveDocument`, `query.ts` validation, cache
- * tags). Nothing about resolution semantics is reimplemented here.
- *
- * Loading strategy (honest about v1 scale): the project's schema, documents,
- * and asset metadata are prefetched ONCE per `createContent` call via the
- * indexed `by_project` / `by_project_asset` scans, then every kit call is
- * synchronous over memory — exactly like `createContentSnapshot` on the Next
- * side. Filters and sorts therefore execute in-function over an indexed
- * by-project fetch; see `contentIndexes.ts` for the index requirements this
- * implies and the documented field-level-index upgrade path.
- *
- * Perspective isolation: the lookup holds the raw stored rows (draft state and
- * all), and EVERY read path through `@elytracms/core/content` — `resolveDocument`,
- * relation population, `listDocuments` filtering, slug fallback, and the `raw`
- * escape hatch — applies the EC-142 perspective gate (`selectPerspective`)
- * before any value is exposed. The kit never reads field values around that
- * gate, so a `published` kit cannot observe draft values. (Pre-filtering draft
- * rows out of the lookup would be redundant *and* would change structured
- * issue messages — e.g. `unknown-relation-target` reasons — breaking
- * byte-equivalence with the Next-side accessors.)
- */
-
-const DEFAULT_LOCALES: LocaleConfig = { default: 'en', locales: ['en'] }
-
-/**
- * Structured load-time problems (stored blobs that fail their canonical Zod
- * schema, unparsable graph revisions). Never thrown — the kit degrades to the
- * valid subset and reports what it skipped, mirroring the package-wide
- * "structured issues, never crashes" stance.
- *
- * `invalid-stored-schema` is retained for wire/back-compat but is no longer
- * produced: CMS collections are config-owned (EC-183, AD-11) and supplied by the
- * caller (already validated), so there is no stored schema blob to reject.
- */
-export type ContentKitIssueCode = 'invalid-stored-schema' | 'invalid-stored-document'
-
-export interface ContentKitIssue {
-  code: ContentKitIssueCode
-  message: string
-  meta?: Record<string, unknown>
-}
-
-export interface CreateContentOptions {
-  projectId: string
-  /** Draft or published perspective (EC-021); ambient for every kit call. */
-  perspective: Perspective
-  /** Requested locale; defaults to the project's default locale. */
-  locale?: Locale
-  /** Override the locale config derived from the project settings. */
-  locales?: LocaleConfig
-  /**
-   * CMS collections (EC-183, AD-11), sourced from `elytra.config.ts` by the
-   * caller — the backend no longer stores a schema. Defaults to none (the kit
-   * then resolves documents with no collection structure).
-   */
-  collections?: readonly CollectionDef[]
-  /** Route records served by `resolvePage` (EC-019). */
-  routes?: readonly RouteRecord[]
-  // Redirects are no longer an option (EC-303): they are editorial DATA, read from
-  // the `redirects` table inside `createContent`, not passed by the caller.
-}
-
-export interface ContentKit {
-  /** The ambient `{ locale, perspective }` context every call resolves under. */
-  readonly context: ContentContext
-  /** Structured load-time issues (invalid stored blobs); never thrown. */
-  readonly loadIssues: readonly ContentKitIssue[]
-  /** Structural route issues from router construction (conflicts, loops). */
-  readonly routerIssues: readonly CmsValidationIssue[]
-  /** Delivery-shaped single-document accessor — same semantics as Next-side `getDocument`. */
-  readonly get: ContentClient['getDocument']
-  /** Delivery-shaped list accessor — same filter vocabulary as EC-143. */
-  readonly list: ContentClient['listDocuments']
-  /** Route → page/document resolution (EC-019), when routes were provided. */
-  readonly resolvePage: ContentClient['resolvePage']
-  /**
-   * Escape hatch (EC-142 `rawDocument`): the stored row, untouched — no locale
-   * fallback, no population, no asset resolution. The perspective gate still
-   * applies: a `published` kit never sees draft rows, even raw.
-   */
-  raw(collection: string, id: string): CmsDocument | null
-}
-
-/**
- * Create the server-side content kit for one Convex query invocation.
- *
- * Usage inside a Convex query function:
- * ```ts
- * const content = await createContent(ctx, { projectId, perspective: 'published' })
- * const { document: post } = content.get<Post>('post', slug)
- * ```
- */
-export async function createContent(
-  ctx: QueryCtx,
-  options: CreateContentOptions,
-): Promise<ContentKit> {
-  const { projectId, perspective } = options
-  const routes = options.routes ?? []
-  const loadIssues: ContentKitIssue[] = []
-
-  // Redirects are editorial DATA now (EC-303), read from the `redirects` table —
-  // only ENABLED entries resolve. (Config redirects are retired; static infra
-  // redirects stay native.) Projected to the routing `RedirectRecord` shape.
-  const redirectRows = await ctx.db.query('redirects').withIndex('by_redirect').collect()
-  const redirects: RedirectRecord[] = redirectRows
-    .filter((row) => row.enabled)
-    .map((row) => ({ id: row.redirectId, from: row.from, to: row.to, permanent: row.permanent }))
-
-  // --- Prefetch (the only async part; everything below is synchronous) -----
-
-  // Config-first identity (EC-182/EC-183, AD-11): locales AND collections are
-  // supplied by the caller (sourced from `elytra.config.ts`); the backend has
-  // no `projects` row and no `cmsSchemas` table — it stores documents only.
-  const locales = options.locales ?? DEFAULT_LOCALES
-  const collectionDefs: CollectionDef[] = options.collections ? [...options.collections] : []
-
-  // One indexed scan over the project's documents (v1 scale; see module doc).
-  // A row's `document` is the continuous working **draft**; `publishedVersion`
-  // (when set) pins which recorded version is live — the Sanity model (EC-224).
-  const documentRows = await ctx.db.query('cmsDocuments').collect()
-
-  // The recorded version snapshots, indexed by (collection, docId, version), so
-  // a published read can serve the *pinned* version rather than the live draft.
-  const versionsByKey = new Map<string, Map<number, CmsDocument>>()
-  for (const row of await ctx.db.query('documentVersions').collect()) {
-    // EC-260: unfold the folded storage form before parsing — the kit resolves over
-    // STRUCTURED values, exactly like the Next-side snapshot (byte-equivalence).
-    const parsed = documentSchema.safeParse(unfoldValue(row.snapshot))
-    if (!parsed.success) continue
-    const key = `${row.collection}:${row.docId}`
-    let byVersion = versionsByKey.get(key)
-    if (!byVersion) {
-      byVersion = new Map()
-      versionsByKey.set(key, byVersion)
-    }
-    byVersion.set(row.version, parsed.data)
-  }
-
-  // Hybrid source per row (EC-224 A1a): a `publishedVersion` pointer yields a
-  // `DocumentHistory` (draft = the live row, published = the pinned snapshot),
-  // so the published perspective serves the recorded version, decoupled from
-  // the continuously-edited draft. An unpinned row stays a bare `CmsDocument`
-  // (the EC-142 gate reads its `state`) — backward-compatible: pre-pointer data
-  // resolves exactly as before.
-  const parsedSources: { key: string; source: ContentDocumentSource }[] = []
-  for (const row of documentRows) {
-    // EC-260: unfold the folded storage form before parsing (see the versions loop).
-    const parsed = documentSchema.safeParse(unfoldValue(row.document))
-    if (!parsed.success) {
-      loadIssues.push({
-        code: 'invalid-stored-document',
-        message: `Stored document "${row.collection}:${row.docId}" does not match the canonical document schema and was skipped.`,
-        meta: { projectId, collection: row.collection, docId: row.docId },
-      })
-      continue
-    }
-    const draft = parsed.data
-    const key = documentKey(draft)
-    if (row.publishedVersion === undefined) {
-      parsedSources.push({ key, source: draft })
-      continue
-    }
-    // Pinned: serve the recorded snapshot for `published`. A dangling pin
-    // (version missing/invalid) under-serves to `null` — never the live draft.
-    const published = versionsByKey.get(`${row.collection}:${row.docId}`)?.get(row.publishedVersion)
-    parsedSources.push({ key, source: { draft, published, versions: [] } })
-  }
-  // Deterministic iteration order regardless of row creation order.
-  parsedSources.sort((a, b) => (a.key < b.key ? -1 : 1))
-
-  const assetRows = await ctx.db.query('assets').withIndex('by_asset').collect()
-  const assetRecords: AssetRecord[] = []
-  for (const row of assetRows) {
-    // EC-151 stores a stable serve URL on upload; older rows fall back to a
-    // live storage lookup, then to the blob adapter's placeholder convention.
-    const url = row.url ?? (await ctx.storage.getUrl(row.storageKey)) ?? undefined
-    assetRecords.push({
-      id: row.assetId,
-      // Single-tenant: rows no longer store projectId; the kit's `projectId`
-      // option (the constant slug) satisfies the AssetRecord shape (EC-179).
-      projectId,
-      filename: row.filename,
-      contentType: row.contentType,
-      byteSize: row.byteSize,
-      ...(row.width !== undefined ? { width: row.width } : {}),
-      ...(row.height !== undefined ? { height: row.height } : {}),
-      ...(row.alt !== undefined ? { alt: row.alt } : {}),
-      // EC-301: focalPoint (EC-230) and the schema-driven metadata bag must reach
-      // delivery — both were dropped here, so a studio-set hotspot/metadata never
-      // made it into the LIVE snapshot (only the studio canvas, which reads records
-      // directly, showed them).
-      ...(row.focalPoint !== undefined ? { focalPoint: row.focalPoint } : {}),
-      ...(row.meta !== undefined ? { meta: row.meta } : {}),
-      storageKey: row.storageKey,
-      ...(url !== undefined ? { url } : {}),
-      createdAt: row.createdAt,
-      updatedAt: row.updatedAt,
-    })
-  }
-
-  // EC-287: there is no project graph. Pages are `page`-collection documents,
-  // resolved by `resolvePage` from the document lookup + routes — no graph load.
-
-  // --- Index into the synchronous lookup the pure accessors read through ---
-
-  const collections = new Map<string, CollectionDef>()
-  for (const collection of collectionDefs) collections.set(collection.id, collection)
-
-  const documents = new Map<string, ContentDocumentSource>()
-  const byCollection = new Map<string, ContentDocumentSource[]>()
-  for (const { key, source } of parsedSources) {
-    documents.set(key, source)
-    const collection = isDocumentHistory(source) ? source.draft.collection : source.collection
-    const list = byCollection.get(collection) ?? []
-    list.push(source)
-    byCollection.set(collection, list)
-  }
-
-  const assets = new Map<string, AssetRecord>()
-  for (const record of assetRecords) assets.set(record.id, record)
-
-  const lookup: ContentLookup = {
-    collection: (id) => collections.get(id),
-    document: (ref) => documents.get(documentKey(ref)),
-    documents: (collectionId) => byCollection.get(collectionId) ?? [],
-    asset: (id) => assets.get(id),
-    // Same convention as `ConvexBlobStorage.url`: stored serve URL when
-    // available, otherwise the explicit unresolved-placeholder scheme.
-    assetUrl: (asset) => asset.url ?? `convex://storage/${asset.storageKey}`,
-  }
-
-  const context = createContentContext({
-    locale: options.locale ?? locales.default,
-    perspective,
-    locales,
-  })
-
-  // The EXACT pure client the Next-side accessors run — this is what makes
-  // results byte-equivalent across runtimes for the same inputs.
-  const client = createContentClient({ lookup, context, routes, redirects })
-
-  const raw = (collection: string, id: string): CmsDocument | null => {
-    const source = documents.get(documentKey({ collection, id }))
-    if (!source) return null
-    return rawDocument(context, source)
-  }
-
-  return {
-    context,
-    loadIssues,
-    routerIssues: client.routerIssues,
-    get: client.getDocument,
-    list: client.listDocuments,
-    resolvePage: client.resolvePage,
-    raw,
-  }
-}

package/dist/components/collab/collab-context.d.ts

@@ -1,27 +0,0 @@
-import type { ReactNode } from 'react';
-import { Collaboration } from '@elytracms/core/collaboration';
-import type { Actor, PreviewMode } from '@elytracms/core/collaboration';
-/**
- * Per-project collaboration session (Phase 10). Holds one {@link Collaboration} store seeded with
- * an initial version + presence for the current user, and exposes a `mutate` helper that re-renders
- * consumers after an imperative store change. Non-persistent (session): it is the builder canvas's
- * session-scoped presence/perspective store. EC-287 retired the project graph and its publish path,
- * so the seed no longer reflects a pinned graph revision; content publishing is per document
- * (EC-224), surfaced by the CMS document Versions pane.
- */
-export interface CollabStore {
-    collab: Collaboration;
-    projectId: string;
-    me: Actor;
-    /** Draft vs published perspective the canvas/preview renders (EC-123). */
-    previewMode: PreviewMode;
-    setPreviewMode: (mode: PreviewMode) => void;
-    /** Run an imperative store mutation, then re-render consumers. */
-    mutate: <T>(fn: () => T) => T;
-}
-declare const useCollab: () => CollabStore;
-export declare function CollabProvider({ projectId, children, }: {
-    projectId: string;
-    children: ReactNode;
-}): import("react").JSX.Element;
-export { useCollab };

package/dist/components/collab/collab-context.js

@@ -1,39 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { useMemo, useReducer, useRef } from 'react';
-import { Collaboration, createSequentialClock, createSequentialIds } from '@elytracms/core/collaboration';
-import { createRequiredContext } from '@elytracms/studio/lib/required-context';
-import { seedCollabSession } from './collab-seed.js';
-const { Context: CollabContext, useRequired: useCollab } = createRequiredContext('Collab');
-const ME = { id: 'u-you', name: 'You' };
-export function CollabProvider({ projectId, children, }) {
-    const [tick, bump] = useReducer((n) => n + 1, 0);
-    const [previewMode, setPreviewModeState] = useReducer((_, next) => next, 'draft');
-    const ref = useRef(null);
-    if (ref.current === null) {
-        const collab = new Collaboration({ clock: createSequentialClock(), ids: createSequentialIds() });
-        // Seed one empty Initial version + presence for the current user (EC-122/126).
-        seedCollabSession(collab, projectId, { author: ME.name });
-        collab.presence.join(projectId, ME);
-        ref.current = collab;
-    }
-    const store = useMemo(() => {
-        const collab = ref.current;
-        return {
-            collab,
-            projectId,
-            me: ME,
-            previewMode,
-            setPreviewMode: setPreviewModeState,
-            mutate: (fn) => {
-                const result = fn();
-                bump();
-                return result;
-            },
-        };
-        // `tick` (bumped by `mutate`) and `previewMode` are in deps so consumers
-        // re-render after an imperative store mutation or a preview change.
-    }, [projectId, previewMode, tick]);
-    return _jsx(CollabContext.Provider, { value: store, children: children });
-}
-export { useCollab };
-//# sourceMappingURL=collab-context.js.map

package/dist/components/collab/collab-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"collab-context.js","sourceRoot":"","sources":["../../../src/components/collab/collab-context.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAEnD,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAEzG,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAA;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAqBjD,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAc,QAAQ,CAAC,CAAA;AAEvG,MAAM,EAAE,GAAU,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;AAE9C,MAAM,UAAU,cAAc,CAAC,EAC7B,SAAS,EACT,QAAQ,GAIT;IACC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;IACxD,MAAM,CAAC,WAAW,EAAE,mBAAmB,CAAC,GAAG,UAAU,CACnD,CAAC,CAAc,EAAE,IAAiB,EAAE,EAAE,CAAC,IAAI,EAC3C,OAAsB,CACvB,CAAA;IAED,MAAM,GAAG,GAAG,MAAM,CAAuB,IAAI,CAAC,CAAA;IAC9C,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,GAAG,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAA;QAChG,+EAA+E;QAC/E,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAA;QACzD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;QACnC,GAAG,CAAC,OAAO,GAAG,MAAM,CAAA;IACtB,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAc,GAAG,EAAE;QACtC,MAAM,MAAM,GAAG,GAAG,CAAC,OAAQ,CAAA;QAC3B,OAAO;YACL,MAAM;YACN,SAAS;YACT,EAAE,EAAE,EAAE;YACN,WAAW;YACX,cAAc,EAAE,mBAAmB;YACnC,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE;gBACb,MAAM,MAAM,GAAG,EAAE,EAAE,CAAA;gBACnB,IAAI,EAAE,CAAA;gBACN,OAAO,MAAM,CAAA;YACf,CAAC;SACF,CAAA;QACD,yEAAyE;QACzE,oEAAoE;IACtE,CAAC,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC,CAAA;IAElC,OAAO,KAAC,aAAa,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAA0B,CAAA;AAClF,CAAC;AAED,OAAO,EAAE,SAAS,EAAE,CAAA","sourcesContent":["import { useMemo, useReducer, useRef } from 'react'\nimport type { ReactNode } from 'react'\nimport { Collaboration, createSequentialClock, createSequentialIds } from '@elytracms/core/collaboration'\nimport type { Actor, PreviewMode } from '@elytracms/core/collaboration'\nimport { createRequiredContext } from '@elytracms/studio/lib/required-context'\nimport { seedCollabSession } from './collab-seed'\n\n/**\n * Per-project collaboration session (Phase 10). Holds one {@link Collaboration} store seeded with\n * an initial version + presence for the current user, and exposes a `mutate` helper that re-renders\n * consumers after an imperative store change. Non-persistent (session): it is the builder canvas's\n * session-scoped presence/perspective store. EC-287 retired the project graph and its publish path,\n * so the seed no longer reflects a pinned graph revision; content publishing is per document\n * (EC-224), surfaced by the CMS document Versions pane.\n */\nexport interface CollabStore {\n  collab: Collaboration\n  projectId: string\n  me: Actor\n  /** Draft vs published perspective the canvas/preview renders (EC-123). */\n  previewMode: PreviewMode\n  setPreviewMode: (mode: PreviewMode) => void\n  /** Run an imperative store mutation, then re-render consumers. */\n  mutate: <T>(fn: () => T) => T\n}\n\nconst { Context: CollabContext, useRequired: useCollab } = createRequiredContext<CollabStore>('Collab')\n\nconst ME: Actor = { id: 'u-you', name: 'You' }\n\nexport function CollabProvider({\n  projectId,\n  children,\n}: {\n  projectId: string\n  children: ReactNode\n}) {\n  const [tick, bump] = useReducer((n: number) => n + 1, 0)\n  const [previewMode, setPreviewModeState] = useReducer(\n    (_: PreviewMode, next: PreviewMode) => next,\n    'draft' as PreviewMode,\n  )\n\n  const ref = useRef<Collaboration | null>(null)\n  if (ref.current === null) {\n    const collab = new Collaboration({ clock: createSequentialClock(), ids: createSequentialIds() })\n    // Seed one empty Initial version + presence for the current user (EC-122/126).\n    seedCollabSession(collab, projectId, { author: ME.name })\n    collab.presence.join(projectId, ME)\n    ref.current = collab\n  }\n\n  const store = useMemo<CollabStore>(() => {\n    const collab = ref.current!\n    return {\n      collab,\n      projectId,\n      me: ME,\n      previewMode,\n      setPreviewMode: setPreviewModeState,\n      mutate: (fn) => {\n        const result = fn()\n        bump()\n        return result\n      },\n    }\n    // `tick` (bumped by `mutate`) and `previewMode` are in deps so consumers\n    // re-render after an imperative store mutation or a preview change.\n  }, [projectId, previewMode, tick])\n\n  return <CollabContext.Provider value={store}>{children}</CollabContext.Provider>\n}\n\nexport { useCollab }\n"]}

package/dist/components/collab/collab-seed.d.ts

@@ -1,15 +0,0 @@
-import type { Collaboration } from '@elytracms/core/collaboration';
-/**
- * Seed a fresh per-project {@link Collaboration} session.
- *
- * EC-287: the project graph and its publish path are retired (the DB holds
- * content only), so a session no longer reflects a pinned graph revision. The
- * collaboration store stays the builder's session-scoped presence/perspective
- * store; it seeds one empty "Initial" version so `versions.latest()` is defined,
- * with no graph snapshot and nothing published. Content publishing is per
- * document (EC-224), surfaced by the CMS document Versions pane — not here.
- */
-export declare function seedCollabSession(collab: Collaboration, projectId: string, options: {
-    /** Author recorded on the Initial version. */
-    author: string;
-}): void;