@elytracms/studio 0.0.1

package/dist/lib/workspace/index.d.ts

@@ -0,0 +1,109 @@
+import type { ElytraConfigInput } from '@elytracms/studio-core';
+import type { CollectionDef, RedirectRecord, RouteRecord } from '@elytracms/cms-core';
+import type { WorkspaceState } from './workspace-source';
+export { resolveWorkspaceState, WORKSPACE_ENV_VAR } from './workspace-source';
+export type { WorkspaceSources, WorkspaceState } from './workspace-source';
+export { persistedProjects, selectSwitcherProjects, unprovisionedProjects } from './switcher-source';
+export type { SwitcherEntry, SwitcherSourceInput } from './switcher-source';
+/**
+ * Mount the studio against a project config (EC-223 mount contract). The
+ * consumer's entry point does `import config from './elytra.config'` and calls
+ * this — an explicit init, NOT an `import.meta.glob` autoload that reaches into
+ * the consumer's filesystem (Oli, 2026-06-19: "there's always an entry point that
+ * can trigger a function call"). This is the config-injection responsibility of
+ * the eventual `createStudio(config)` package export; it seeds the workspace state
+ * every later query (`getActiveProjectSlug`, `resolveDeployment*`) reads.
+ */
+export declare function createStudio(config: ElytraConfigInput): void;
+/** Set the active project slug; returns whether the resolved deployment changed. */
+export declare function setActiveProjectSlug(slug: string | null): boolean;
+export declare function getActiveProjectSlug(): string | null;
+/** Test seam: reset the active project slug. Never used by app code. */
+export declare function setActiveProjectSlugForTests(slug: string | null): void;
+/** Extract a project slug from a studio path (`/<slug>/...`), else `null`. */
+export declare function projectSlugFromPath(pathname: string): string | null;
+/**
+ * The project whose backend the studio should bind for a given location
+ * (EC-179). A project path (`/<slug>`) binds that project; the sign-in screen
+ * binds the project from its `redirect` target so the *initial* sign-in
+ * authenticates against the backend the user is heading for (Sanity-style).
+ * Anywhere else (the launcher) → `null`, i.e. the default/first project.
+ */
+export declare function activeSlugForLocation(pathname: string, redirect?: string): string | null;
+/**
+ * The studio's resolved workspace state. Deterministic per boot: the config is
+ * static input (bundled file or deployment env), so it is resolved once and
+ * cached — every consumer (gate, switcher, launcher) sees the same state.
+ */
+export declare function getWorkspaceState(): WorkspaceState;
+/** Test seam: clear/replace the cached state. Never used by app code. */
+export declare function setWorkspaceStateForTests(next: WorkspaceState | null): void;
+/**
+ * Resolve the Convex deployment URL the studio should connect to (vision AD-8:
+ * the backend is wired in config). One project per backend, so the **active**
+ * project (see {@link setActiveProjectSlug}) selects the deployment via its
+ * `convex.deployment` (or its production environment's). At the launcher (no
+ * active project) the first configured project is the default backend. Absent
+ * config — or a project without a wired deployment — falls back to
+ * `VITE_CONVEX_URL` (`fallbackUrl`) for local single-deployment development.
+ */
+export declare function resolveDeploymentUrl(fallbackUrl: string): string;
+/** The deployment URL for a specific project slug (per-backend auth checks). */
+export declare function deploymentUrlForSlug(slug: string, fallbackUrl: string): string;
+/**
+ * The slug of the project bound to the active deployment (EC-179). One project
+ * per backend, so the active config project's slug identifies the deployment's
+ * one project; the Convex adapter stamps it onto deployment-scoped records.
+ * Absent config falls back to `fallbackId` (used only when wired by env alone).
+ */
+export declare function resolveDeploymentProjectId(fallbackId: string): string;
+/**
+ * The CMS collections of the active config project (AD-11, EC-183). CMS
+ * collection schemas are config-owned: the studio reads the model from
+ * `elytra.config.ts` (served through the persistence port — the backend has no
+ * `cmsSchemas` table). `[]` when the active project declares none, or when the
+ * studio is wired by env alone with no config.
+ */
+export declare function resolveDeploymentCollections(): CollectionDef[];
+/**
+ * The resolved URL routes of the active config project (EC-207, "routes as
+ * code"). Routes are config-sourced: the studio reads the materialized
+ * `RouteRecord[]` from the active `elytra.config.ts` project — never from the
+ * backend (the `routes` system collection is retired). The Routes surface and
+ * the per-page URL preview both read through here. `[]` when the active project
+ * declares none, or when the studio is wired by env alone with no config.
+ */
+export declare function resolveDeploymentRoutes(): RouteRecord[];
+/**
+ * The resolved redirects of the active config project (EC-207). Config-sourced
+ * exactly like {@link resolveDeploymentRoutes}: the `redirects` system
+ * collection is retired and nothing is read from the backend. `[]` when none
+ * are declared.
+ */
+export declare function resolveDeploymentRedirects(): RedirectRecord[];
+/**
+ * The configured locales of the active config project (AD-8). The same locale
+ * set the host stamps onto its per-locale cache tags — used by the revalidation
+ * webhook layer (EC-192) so a publish always invalidates EVERY configured locale
+ * (e.g. `/de`, `/fr`), never just the default. `[]` when wired by env alone.
+ */
+export declare function resolveDeploymentLocales(): string[];
+/**
+ * The active project's components reference (EC-194, AD-11): where the consuming
+ * repo's OWN real components live (`{ package }` or `{ dir }`). When set, the
+ * studio registry composes with the repo's components instead of the built-in
+ * demo fixtures — so the page builder edits the repo's actual component library.
+ * `undefined` → the project ships no code components; the studio falls back to the
+ * golden-path fixtures.
+ */
+export declare function resolveDeploymentComponents(): readonly import("@elytracms/studio-core").HostComponentEntry[] | undefined;
+/**
+ * The active project's public site URL (EC-215): the live site's base URL the
+ * studio links to (a document's live URL + open-live button, EC-216). Resolved
+ * in lockstep with {@link resolveDeploymentUrl} — the environment bound to the
+ * active deployment (the first with a wired deployment) provides the URL, falling
+ * back to the project-level `frontendUrl`. No active-environment selector exists
+ * yet, so the bound environment is the active one. `undefined` when the active
+ * project (or env-only wiring) configures no frontend URL.
+ */
+export declare function resolveDeploymentFrontendUrl(): string | undefined;

package/dist/lib/workspace/index.js

@@ -0,0 +1,206 @@
+import { frontendUrlForEnvironment } from '@elytracms/studio-core';
+import { resolveWorkspaceState } from './workspace-source';
+export { resolveWorkspaceState, WORKSPACE_ENV_VAR } from './workspace-source';
+export { persistedProjects, selectSwitcherProjects, unprovisionedProjects } from './switcher-source';
+let cached = null;
+/**
+ * Mount the studio against a project config (EC-223 mount contract). The
+ * consumer's entry point does `import config from './elytra.config'` and calls
+ * this — an explicit init, NOT an `import.meta.glob` autoload that reaches into
+ * the consumer's filesystem (Oli, 2026-06-19: "there's always an entry point that
+ * can trigger a function call"). This is the config-injection responsibility of
+ * the eventual `createStudio(config)` package export; it seeds the workspace state
+ * every later query (`getActiveProjectSlug`, `resolveDeployment*`) reads.
+ */
+export function createStudio(config) {
+    cached = resolveWorkspaceState({
+        fileModule: { default: config },
+        fileName: 'elytra.config.ts',
+    });
+}
+/**
+ * The active project slug (EC-179, vision AD-8). One project per backend, so the
+ * active project selects which Convex deployment the studio talks to. The root
+ * layout sets this from the URL (`/<slug>`) — or, on the sign-in screen, from
+ * the `redirect` target's slug — before the auth/persistence adapters are
+ * selected, so the *initial* sign-in authenticates against the project the user
+ * is heading for (Sanity-style: authenticate to one workspace, then the full
+ * config-based switcher is available). `null` at the launcher → the default
+ * (first) configured project's deployment.
+ */
+let activeProjectSlug = null;
+/** Set the active project slug; returns whether the resolved deployment changed. */
+export function setActiveProjectSlug(slug) {
+    const before = resolveDeploymentUrl('');
+    activeProjectSlug = slug && slug.trim() !== '' ? slug : null;
+    return resolveDeploymentUrl('') !== before;
+}
+export function getActiveProjectSlug() {
+    return activeProjectSlug;
+}
+/** Test seam: reset the active project slug. Never used by app code. */
+export function setActiveProjectSlugForTests(slug) {
+    activeProjectSlug = slug;
+}
+/**
+ * Reserved first-path segments that are NOT project slugs: the studio's own
+ * root routes (EC-220). Project surfaces now live at `/<slug>/...` (no `/p/`
+ * prefix), so the studio's root namespace is shared between project slugs and
+ * these fixed routes — they must be excluded from slug extraction. Keep in
+ * sync with the non-`$projectId` files in `src/routes/`; the launcher (`/`) is
+ * the empty segment, excluded by the regex requiring one path char.
+ */
+const RESERVED_ROOT_SEGMENTS = new Set(['sign-in', 'styleguide']);
+/** Extract a project slug from a studio path (`/<slug>/...`), else `null`. */
+export function projectSlugFromPath(pathname) {
+    const match = /^\/([^/?#]+)/.exec(pathname);
+    if (!match)
+        return null;
+    const segment = decodeURIComponent(match[1]);
+    return RESERVED_ROOT_SEGMENTS.has(segment) ? null : segment;
+}
+/**
+ * The project whose backend the studio should bind for a given location
+ * (EC-179). A project path (`/<slug>`) binds that project; the sign-in screen
+ * binds the project from its `redirect` target so the *initial* sign-in
+ * authenticates against the backend the user is heading for (Sanity-style).
+ * Anywhere else (the launcher) → `null`, i.e. the default/first project.
+ */
+export function activeSlugForLocation(pathname, redirect) {
+    const direct = projectSlugFromPath(pathname);
+    if (direct)
+        return direct;
+    if (pathname === '/sign-in' && redirect)
+        return projectSlugFromPath(redirect);
+    return null;
+}
+/** The active config project (by slug), or the first configured project. */
+function activeConfigProject() {
+    const state = getWorkspaceState();
+    if (state.kind !== 'config')
+        return undefined;
+    if (activeProjectSlug) {
+        const match = state.projects.find((p) => p.slug === activeProjectSlug);
+        if (match)
+            return match;
+    }
+    return state.projects[0];
+}
+/**
+ * The studio's resolved workspace state. Deterministic per boot: the config is
+ * static input (bundled file or deployment env), so it is resolved once and
+ * cached — every consumer (gate, switcher, launcher) sees the same state.
+ */
+export function getWorkspaceState() {
+    // Seeded by `createStudio(config)` at the entry point. Until then — or when the
+    // consumer wires no config — resolve to the empty `none` state (the single-project
+    // golden path), rather than reaching for the filesystem.
+    if (!cached)
+        cached = resolveWorkspaceState({});
+    return cached;
+}
+/** Test seam: clear/replace the cached state. Never used by app code. */
+export function setWorkspaceStateForTests(next) {
+    cached = next;
+}
+/**
+ * Resolve the Convex deployment URL the studio should connect to (vision AD-8:
+ * the backend is wired in config). One project per backend, so the **active**
+ * project (see {@link setActiveProjectSlug}) selects the deployment via its
+ * `convex.deployment` (or its production environment's). At the launcher (no
+ * active project) the first configured project is the default backend. Absent
+ * config — or a project without a wired deployment — falls back to
+ * `VITE_CONVEX_URL` (`fallbackUrl`) for local single-deployment development.
+ */
+export function resolveDeploymentUrl(fallbackUrl) {
+    return projectDeploymentUrl(activeConfigProject(), fallbackUrl);
+}
+/** The deployment URL for a specific project slug (per-backend auth checks). */
+export function deploymentUrlForSlug(slug, fallbackUrl) {
+    const state = getWorkspaceState();
+    const project = state.kind === 'config' ? state.projects.find((p) => p.slug === slug) : undefined;
+    return projectDeploymentUrl(project, fallbackUrl);
+}
+/** A project's wired deployment: per-environment ref → project ref → env fallback. */
+function projectDeploymentUrl(project, fallbackUrl) {
+    if (!project)
+        return fallbackUrl;
+    const envDeployment = project.environments.find((e) => e.convex?.deployment)?.convex?.deployment;
+    return envDeployment ?? project.convex?.deployment ?? fallbackUrl;
+}
+/**
+ * The slug of the project bound to the active deployment (EC-179). One project
+ * per backend, so the active config project's slug identifies the deployment's
+ * one project; the Convex adapter stamps it onto deployment-scoped records.
+ * Absent config falls back to `fallbackId` (used only when wired by env alone).
+ */
+export function resolveDeploymentProjectId(fallbackId) {
+    return activeConfigProject()?.slug ?? fallbackId;
+}
+/**
+ * The CMS collections of the active config project (AD-11, EC-183). CMS
+ * collection schemas are config-owned: the studio reads the model from
+ * `elytra.config.ts` (served through the persistence port — the backend has no
+ * `cmsSchemas` table). `[]` when the active project declares none, or when the
+ * studio is wired by env alone with no config.
+ */
+export function resolveDeploymentCollections() {
+    return activeConfigProject()?.collections ?? [];
+}
+/**
+ * The resolved URL routes of the active config project (EC-207, "routes as
+ * code"). Routes are config-sourced: the studio reads the materialized
+ * `RouteRecord[]` from the active `elytra.config.ts` project — never from the
+ * backend (the `routes` system collection is retired). The Routes surface and
+ * the per-page URL preview both read through here. `[]` when the active project
+ * declares none, or when the studio is wired by env alone with no config.
+ */
+export function resolveDeploymentRoutes() {
+    return activeConfigProject()?.routes ?? [];
+}
+/**
+ * The resolved redirects of the active config project (EC-207). Config-sourced
+ * exactly like {@link resolveDeploymentRoutes}: the `redirects` system
+ * collection is retired and nothing is read from the backend. `[]` when none
+ * are declared.
+ */
+export function resolveDeploymentRedirects() {
+    return activeConfigProject()?.redirects ?? [];
+}
+/**
+ * The configured locales of the active config project (AD-8). The same locale
+ * set the host stamps onto its per-locale cache tags — used by the revalidation
+ * webhook layer (EC-192) so a publish always invalidates EVERY configured locale
+ * (e.g. `/de`, `/fr`), never just the default. `[]` when wired by env alone.
+ */
+export function resolveDeploymentLocales() {
+    return activeConfigProject()?.locales ?? [];
+}
+/**
+ * The active project's components reference (EC-194, AD-11): where the consuming
+ * repo's OWN real components live (`{ package }` or `{ dir }`). When set, the
+ * studio registry composes with the repo's components instead of the built-in
+ * demo fixtures — so the page builder edits the repo's actual component library.
+ * `undefined` → the project ships no code components; the studio falls back to the
+ * golden-path fixtures.
+ */
+export function resolveDeploymentComponents() {
+    return activeConfigProject()?.components;
+}
+/**
+ * The active project's public site URL (EC-215): the live site's base URL the
+ * studio links to (a document's live URL + open-live button, EC-216). Resolved
+ * in lockstep with {@link resolveDeploymentUrl} — the environment bound to the
+ * active deployment (the first with a wired deployment) provides the URL, falling
+ * back to the project-level `frontendUrl`. No active-environment selector exists
+ * yet, so the bound environment is the active one. `undefined` when the active
+ * project (or env-only wiring) configures no frontend URL.
+ */
+export function resolveDeploymentFrontendUrl() {
+    const project = activeConfigProject();
+    if (!project)
+        return undefined;
+    const boundEnv = project.environments.find((e) => e.convex?.deployment);
+    return frontendUrlForEnvironment(project, boundEnv?.key);
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/workspace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/workspace/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/workspace/switcher-source.d.ts

@@ -0,0 +1,39 @@
+import type { Project } from '@elytracms/studio-core';
+import type { ResolvedWorkspaceProject } from '@elytracms/studio-core';
+import type { WorkspaceState } from './workspace-source';
+/**
+ * Config-driven switcher source (EC-154, reframed for EC-179 per-backend
+ * projects). Pure logic deciding what the project switcher and launcher list:
+ *
+ * - **No workspace config** → exactly today's behavior: the adapter-listed
+ *   projects, untouched (single-project golden path).
+ * - **Config present** → every configured project, in config order, as a
+ *   navigable entry; one that has no persisted counterpart yet is an explicit
+ *   `unprovisioned` state ("run `builder init --project <slug>`") rather than an
+ *   error. Persisted projects *not* in the config are not listed: the config is
+ *   the source of truth for what this workspace is.
+ *
+ * Visibility is **not** filtered by membership. One project per backend (vision
+ * AD-8): a configured project lives on its own deployment, so the *active*
+ * backend's memberships cannot speak to another project's. Access is enforced
+ * where it belongs — per-backend sign-in plus the EC-150 role hook on entry —
+ * not by hiding projects you'd authenticate into. (Hiding them was the
+ * single-backend assumption; cross-backend it just made projects unreachable.)
+ */
+export type SwitcherEntry = {
+    kind: 'project';
+    project: Project;
+} | {
+    kind: 'unprovisioned';
+    config: ResolvedWorkspaceProject;
+};
+export interface SwitcherSourceInput {
+    workspace: WorkspaceState;
+    /** The studio store's read model (config-derived under a workspace config). */
+    persisted: readonly Project[];
+}
+export declare function selectSwitcherProjects(input: SwitcherSourceInput): SwitcherEntry[];
+/** The persisted projects among the entries (for list surfaces filtering by status). */
+export declare function persistedProjects(entries: readonly SwitcherEntry[]): Project[];
+/** The not-yet-provisioned config entries (rendered as explicit CLI-hint states). */
+export declare function unprovisionedProjects(entries: readonly SwitcherEntry[]): ResolvedWorkspaceProject[];

package/dist/lib/workspace/switcher-source.js

@@ -0,0 +1,23 @@
+export function selectSwitcherProjects(input) {
+    if (input.workspace.kind !== 'config') {
+        // No-config golden path (an invalid config never reaches the switcher —
+        // the WorkspaceGate blocks boot): today's adapter-listed behavior.
+        return input.persisted.map((project) => ({ kind: 'project', project }));
+    }
+    const bySlug = new Map(input.persisted.map((project) => [project.slug, project]));
+    return input.workspace.projects.map((config) => {
+        const persisted = bySlug.get(config.slug);
+        return persisted
+            ? { kind: 'project', project: persisted }
+            : { kind: 'unprovisioned', config };
+    });
+}
+/** The persisted projects among the entries (for list surfaces filtering by status). */
+export function persistedProjects(entries) {
+    return entries.flatMap((entry) => (entry.kind === 'project' ? [entry.project] : []));
+}
+/** The not-yet-provisioned config entries (rendered as explicit CLI-hint states). */
+export function unprovisionedProjects(entries) {
+    return entries.flatMap((entry) => (entry.kind === 'unprovisioned' ? [entry.config] : []));
+}
+//# sourceMappingURL=switcher-source.js.map

package/dist/lib/workspace/switcher-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switcher-source.js","sourceRoot":"","sources":["../../../src/lib/workspace/switcher-source.ts"],"names":[],"mappings":"AAkCA,MAAM,UAAU,sBAAsB,CAAC,KAA0B;IAC/D,IAAI,KAAK,CAAC,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,wEAAwE;QACxE,mEAAmE;QACnE,OAAO,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC,CAAA;IACzE,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IACjF,OAAO,KAAK,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC7C,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACzC,OAAO,SAAS;YACd,CAAC,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,OAAO,EAAE,SAAS,EAAE;YAClD,CAAC,CAAC,EAAE,IAAI,EAAE,eAAwB,EAAE,MAAM,EAAE,CAAA;IAChD,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AACtF,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,qBAAqB,CACnC,OAAiC;IAEjC,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC3F,CAAC"}

package/dist/lib/workspace/workspace-source.d.ts

@@ -0,0 +1,47 @@
+import type { ResolvedWorkspaceProject, WorkspaceConfigIssue } from '@elytracms/studio-core';
+/**
+ * Workspace-config resolution for the studio (EC-154, vision AD-8).
+ *
+ * The hosted studio can receive a code-first workspace config through two
+ * channels, resolved here as pure, testable logic (the channel wiring lives in
+ * `./index.ts`):
+ *
+ * 1. **Bundled config file** — an `elytra.config.ts` at the builder app root,
+ *    picked up by Vite (`import.meta.glob`). This is the honest channel for
+ *    studio development and for a self-hosted builder whose repo *is* the
+ *    workspace.
+ * 2. **Env-injected JSON** — `VITE_ELYTRA_WORKSPACE` carrying the JSON form
+ *    of the config. This is the honest channel for a hosted builder deployment
+ *    serving a separate host repo: the host's CLI/CI serializes its
+ *    `elytra.config.ts` into the deployment env, so the studio sees exactly
+ *    the projects the repo declares without bundling host code.
+ *
+ * A bundled file wins over the env (the more deliberate, code-reviewed act).
+ * No channel → `none`: the single-project golden path, identical to today's
+ * adapter-listed behavior. An invalid config from either channel is a
+ * deterministic boot-error state (see `WorkspaceGate`) — never a silent
+ * fallback to the unconfigured behavior.
+ */
+/** Env var carrying the JSON-serialized workspace config for hosted deployments. */
+export declare const WORKSPACE_ENV_VAR = "VITE_ELYTRA_WORKSPACE";
+export type WorkspaceState = {
+    kind: 'none';
+} | {
+    kind: 'config';
+    source: string;
+    projects: ResolvedWorkspaceProject[];
+} | {
+    kind: 'invalid';
+    source: string;
+    issues: WorkspaceConfigIssue[];
+};
+export interface WorkspaceSources {
+    /** Module namespace of the bundled `elytra.config.ts`, when one was bundled. */
+    fileModule?: unknown;
+    /** Source label for file-channel issues (defaults to the conventional name). */
+    fileName?: string;
+    /** Raw value of {@link WORKSPACE_ENV_VAR}, when set. */
+    envJson?: string;
+}
+/** Resolve the workspace state from the available channels. Pure and deterministic. */
+export declare function resolveWorkspaceState(sources: WorkspaceSources): WorkspaceState;

package/dist/lib/workspace/workspace-source.js

@@ -0,0 +1,67 @@
+import { extractWorkspaceConfigExport, resolveWorkspaceConfig, WORKSPACE_CONFIG_FILE, } from '@elytracms/studio-core';
+/**
+ * Workspace-config resolution for the studio (EC-154, vision AD-8).
+ *
+ * The hosted studio can receive a code-first workspace config through two
+ * channels, resolved here as pure, testable logic (the channel wiring lives in
+ * `./index.ts`):
+ *
+ * 1. **Bundled config file** — an `elytra.config.ts` at the builder app root,
+ *    picked up by Vite (`import.meta.glob`). This is the honest channel for
+ *    studio development and for a self-hosted builder whose repo *is* the
+ *    workspace.
+ * 2. **Env-injected JSON** — `VITE_ELYTRA_WORKSPACE` carrying the JSON form
+ *    of the config. This is the honest channel for a hosted builder deployment
+ *    serving a separate host repo: the host's CLI/CI serializes its
+ *    `elytra.config.ts` into the deployment env, so the studio sees exactly
+ *    the projects the repo declares without bundling host code.
+ *
+ * A bundled file wins over the env (the more deliberate, code-reviewed act).
+ * No channel → `none`: the single-project golden path, identical to today's
+ * adapter-listed behavior. An invalid config from either channel is a
+ * deterministic boot-error state (see `WorkspaceGate`) — never a silent
+ * fallback to the unconfigured behavior.
+ */
+/** Env var carrying the JSON-serialized workspace config for hosted deployments. */
+export const WORKSPACE_ENV_VAR = 'VITE_ELYTRA_WORKSPACE';
+function fromValue(value, source) {
+    const result = resolveWorkspaceConfig(value, { file: source });
+    return result.ok
+        ? { kind: 'config', source, projects: result.projects }
+        : { kind: 'invalid', source, issues: result.issues };
+}
+/** Resolve the workspace state from the available channels. Pure and deterministic. */
+export function resolveWorkspaceState(sources) {
+    if (sources.fileModule !== undefined) {
+        const file = sources.fileName ?? WORKSPACE_CONFIG_FILE;
+        const extracted = extractWorkspaceConfigExport(sources.fileModule, file);
+        if ('issue' in extracted)
+            return { kind: 'invalid', source: file, issues: [extracted.issue] };
+        return fromValue(extracted.value, file);
+    }
+    if (sources.envJson !== undefined && sources.envJson.trim() !== '') {
+        const source = WORKSPACE_ENV_VAR;
+        let parsed;
+        try {
+            parsed = JSON.parse(sources.envJson);
+        }
+        catch (cause) {
+            return {
+                kind: 'invalid',
+                source,
+                issues: [
+                    {
+                        code: 'invalid-config-shape',
+                        severity: 'error',
+                        message: `${WORKSPACE_ENV_VAR} is not valid JSON: ${cause instanceof Error ? cause.message : String(cause)}`,
+                        path: [],
+                        file: source,
+                    },
+                ],
+            };
+        }
+        return fromValue(parsed, source);
+    }
+    return { kind: 'none' };
+}
+//# sourceMappingURL=workspace-source.js.map

package/dist/lib/workspace/workspace-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-source.js","sourceRoot":"","sources":["../../../src/lib/workspace/workspace-source.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wBAAwB,CAAA;AAG/B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,oFAAoF;AACpF,MAAM,CAAC,MAAM,iBAAiB,GAAG,uBAAuB,CAAA;AAgBxD,SAAS,SAAS,CAAC,KAAc,EAAE,MAAc;IAC/C,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;IAC9D,OAAO,MAAM,CAAC,EAAE;QACd,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE;QACvD,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAA;AACxD,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,qBAAqB,CAAC,OAAyB;IAC7D,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,IAAI,qBAAqB,CAAA;QACtD,MAAM,SAAS,GAAG,4BAA4B,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QACxE,IAAI,OAAO,IAAI,SAAS;YAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAA;QAC7F,OAAO,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACzC,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACnE,MAAM,MAAM,GAAG,iBAAiB,CAAA;QAChC,IAAI,MAAe,CAAA;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,MAAM;gBACN,MAAM,EAAE;oBACN;wBACE,IAAI,EAAE,sBAAsB;wBAC5B,QAAQ,EAAE,OAAO;wBACjB,OAAO,EAAE,GAAG,iBAAiB,uBAAuB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;wBAC5G,IAAI,EAAE,EAAE;wBACR,IAAI,EAAE,MAAM;qBACb;iBACF;aACF,CAAA;QACH,CAAC;QACD,OAAO,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AACzB,CAAC"}

package/dist/router/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Studio router adapter (EC-223 Stage 3 — the gating seam). The studio UI
+ * navigates through these primitives instead of importing `@tanstack/react-router`
+ * directly, so the engine owns its router CHOICE (TanStack Router) without being
+ * hard-wired to a specific app: the consuming app provides the router INSTANCE +
+ * the generated route tree (for Aurora, via TanStack Start). `@tanstack/react-router`
+ * is a PEER dependency so there is exactly one instance — hence one router context
+ * the re-exported hooks read.
+ *
+ * Only the runtime navigation primitives the studio components use are surfaced
+ * here; route DEFINITION (`createFileRoute`/`createRouter`) stays in the consumer's
+ * route files. Paths are addressed as plain strings (`to="/$projectId"`), so the
+ * components don't depend on the consumer's route-tree types.
+ */
+export { Link, Navigate, useBlocker, useLocation, useNavigate, useParams, useSearch, } from '@tanstack/react-router';
+export type { LinkProps } from '@tanstack/react-router';
+/**
+ * The studio's single in-project route (EC-223 Stage 6 — catch-all routing).
+ * Every URL under a project is served by one splat, addressed by its `_splat`
+ * subpath. By the route-table contract (`./match`), that subpath is the section
+ * id for a top-level section (`'cms'`, `'settings'`, …) and the deep path for a
+ * nested screen (`'cms/<collection>/<doc>'`). Navigate to a section with
+ * `to={STUDIO_PROJECT_ROUTE} params={{ projectId, _splat }}` rather than a
+ * per-section path that no longer exists in the consumer's route tree.
+ */
+export declare const STUDIO_PROJECT_ROUTE: "/$projectId/$";
+/**
+ * Typed `_splat` builder for the studio splat — the inverse of the engine route
+ * table (`./match`). Re-exported here so a component imports the link seam from
+ * one place: `{ Link, STUDIO_PROJECT_ROUTE, studioPath }`.
+ */
+export { studioPath } from './match';

package/dist/router/index.js

@@ -0,0 +1,32 @@
+/**
+ * Studio router adapter (EC-223 Stage 3 — the gating seam). The studio UI
+ * navigates through these primitives instead of importing `@tanstack/react-router`
+ * directly, so the engine owns its router CHOICE (TanStack Router) without being
+ * hard-wired to a specific app: the consuming app provides the router INSTANCE +
+ * the generated route tree (for Aurora, via TanStack Start). `@tanstack/react-router`
+ * is a PEER dependency so there is exactly one instance — hence one router context
+ * the re-exported hooks read.
+ *
+ * Only the runtime navigation primitives the studio components use are surfaced
+ * here; route DEFINITION (`createFileRoute`/`createRouter`) stays in the consumer's
+ * route files. Paths are addressed as plain strings (`to="/$projectId"`), so the
+ * components don't depend on the consumer's route-tree types.
+ */
+export { Link, Navigate, useBlocker, useLocation, useNavigate, useParams, useSearch, } from '@tanstack/react-router';
+/**
+ * The studio's single in-project route (EC-223 Stage 6 — catch-all routing).
+ * Every URL under a project is served by one splat, addressed by its `_splat`
+ * subpath. By the route-table contract (`./match`), that subpath is the section
+ * id for a top-level section (`'cms'`, `'settings'`, …) and the deep path for a
+ * nested screen (`'cms/<collection>/<doc>'`). Navigate to a section with
+ * `to={STUDIO_PROJECT_ROUTE} params={{ projectId, _splat }}` rather than a
+ * per-section path that no longer exists in the consumer's route tree.
+ */
+export const STUDIO_PROJECT_ROUTE = '/$projectId/$';
+/**
+ * Typed `_splat` builder for the studio splat — the inverse of the engine route
+ * table (`./match`). Re-exported here so a component imports the link seam from
+ * one place: `{ Link, STUDIO_PROJECT_ROUTE, studioPath }`.
+ */
+export { studioPath } from './match';
+//# sourceMappingURL=index.js.map

package/dist/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,SAAS,EACT,SAAS,GACV,MAAM,wBAAwB,CAAA;AAG/B;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAwB,CAAA;AAE5D;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA"}