@elytracms/studio 0.0.1

package/dist/lib/locale/index.js

@@ -0,0 +1,7 @@
+export * from './locale-store';
+export * from './fallback';
+export * from './route-variant';
+export * from './binding-fallback';
+export * from './use-studio-locale';
+export * from './locale-switcher';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/locale/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA"}

package/dist/lib/locale/locale-store.d.ts

@@ -0,0 +1,40 @@
+import type { Locale, LocaleConfig } from '@elytracms/cms-core';
+/**
+ * The studio's ambient locale (EC-176) — framework-free core.
+ *
+ * One studio-level active locale, set once via the locale switcher, that the
+ * builder canvas preview, the CMS table, and the detail editor all follow.
+ * Module-level (not React context) on purpose: the playground's content
+ * client (`lib/data/collection-content`) reads it at query time without any
+ * provider plumbing, and React surfaces subscribe through
+ * `useStudioLocale` (`useSyncExternalStore`).
+ *
+ * Deliberately NOT part of `lib/data/data-store` — the locale is studio
+ * state, not a data source.
+ */
+interface StudioLocaleState {
+    readonly config: LocaleConfig;
+    readonly active: Locale;
+}
+/** Snapshot of `{ config, active }` — stable identity until the next change. */
+export declare function getStudioLocaleState(): StudioLocaleState;
+/** The active studio locale every surface renders in. */
+export declare function getStudioLocale(): Locale;
+/** The project locale config driving the switcher options. */
+export declare function getStudioLocaleConfig(): LocaleConfig;
+/**
+ * Switch the ambient locale. Unknown locales are ignored (the switcher only
+ * offers configured ones; programmatic callers get a no-op, never a crash).
+ */
+export declare function setStudioLocale(locale: Locale): void;
+/**
+ * Install the project's locale config (e.g. when a CMS session or builder
+ * shell mounts with a starter kit's locales). The active locale is kept when
+ * it is still configured, otherwise it snaps back to the new default.
+ */
+export declare function configureStudioLocales(config: LocaleConfig): void;
+/** Subscribe to locale/config changes. Returns the unsubscribe function. */
+export declare function subscribeStudioLocale(listener: () => void): () => void;
+/** Reset to the sample defaults (tests only — module state is shared). */
+export declare function resetStudioLocale(): void;
+export {};

package/dist/lib/locale/locale-store.js

@@ -0,0 +1,61 @@
+import { createLocaleConfig, isKnownLocale, sampleLocaleConfig } from '@elytracms/cms-core';
+let state = {
+    config: sampleLocaleConfig,
+    active: sampleLocaleConfig.default,
+};
+const listeners = new Set();
+function emit() {
+    for (const listener of listeners)
+        listener();
+}
+/** Snapshot of `{ config, active }` — stable identity until the next change. */
+export function getStudioLocaleState() {
+    return state;
+}
+/** The active studio locale every surface renders in. */
+export function getStudioLocale() {
+    return state.active;
+}
+/** The project locale config driving the switcher options. */
+export function getStudioLocaleConfig() {
+    return state.config;
+}
+/**
+ * Switch the ambient locale. Unknown locales are ignored (the switcher only
+ * offers configured ones; programmatic callers get a no-op, never a crash).
+ */
+export function setStudioLocale(locale) {
+    if (locale === state.active || !isKnownLocale(state.config, locale))
+        return;
+    state = { ...state, active: locale };
+    emit();
+}
+/**
+ * Install the project's locale config (e.g. when a CMS session or builder
+ * shell mounts with a starter kit's locales). The active locale is kept when
+ * it is still configured, otherwise it snaps back to the new default.
+ */
+export function configureStudioLocales(config) {
+    const normalized = createLocaleConfig({ default: config.default, locales: config.locales });
+    const sameConfig = normalized.default === state.config.default &&
+        normalized.locales.length === state.config.locales.length &&
+        normalized.locales.every((locale, i) => locale === state.config.locales[i]);
+    const active = isKnownLocale(normalized, state.active) ? state.active : normalized.default;
+    if (sameConfig && active === state.active)
+        return;
+    state = { config: normalized, active };
+    emit();
+}
+/** Subscribe to locale/config changes. Returns the unsubscribe function. */
+export function subscribeStudioLocale(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/** Reset to the sample defaults (tests only — module state is shared). */
+export function resetStudioLocale() {
+    state = { config: sampleLocaleConfig, active: sampleLocaleConfig.default };
+    emit();
+}
+//# sourceMappingURL=locale-store.js.map

package/dist/lib/locale/locale-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-store.js","sourceRoot":"","sources":["../../../src/lib/locale/locale-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAsB3F,IAAI,KAAK,GAAsB;IAC7B,MAAM,EAAE,kBAAkB;IAC1B,MAAM,EAAE,kBAAkB,CAAC,OAAO;CACnC,CAAA;AAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAc,CAAA;AAEvC,SAAS,IAAI;IACX,KAAK,MAAM,QAAQ,IAAI,SAAS;QAAE,QAAQ,EAAE,CAAA;AAC9C,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,oBAAoB;IAClC,OAAO,KAAK,CAAA;AACd,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,CAAC,MAAM,CAAA;AACrB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,qBAAqB;IACnC,OAAO,KAAK,CAAC,MAAM,CAAA;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,IAAI,MAAM,KAAK,KAAK,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC;QAAE,OAAM;IAC3E,KAAK,GAAG,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;IACpC,IAAI,EAAE,CAAA;AACR,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAoB;IACzD,MAAM,UAAU,GAAG,kBAAkB,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAA;IAC3F,MAAM,UAAU,GACd,UAAU,CAAC,OAAO,KAAK,KAAK,CAAC,MAAM,CAAC,OAAO;QAC3C,UAAU,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM;QACzD,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7E,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAA;IAC1F,IAAI,UAAU,IAAI,MAAM,KAAK,KAAK,CAAC,MAAM;QAAE,OAAM;IACjD,KAAK,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAA;IACtC,IAAI,EAAE,CAAA;AACR,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,qBAAqB,CAAC,QAAoB;IACxD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACvB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC5B,CAAC,CAAA;AACH,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,iBAAiB;IAC/B,KAAK,GAAG,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,CAAC,OAAO,EAAE,CAAA;IAC1E,IAAI,EAAE,CAAA;AACR,CAAC"}

package/dist/lib/locale/locale-switcher.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The ambient locale switcher (EC-176): one segmented control, mounted in the
+ * builder toolbar and the CMS surface header, both driving the same
+ * studio-level active locale. Options come from the project locale config;
+ * the default locale is marked. Renders nothing for single-locale projects —
+ * no per-control locale ceremony anywhere else.
+ */
+export declare function LocaleSwitcher({ className }: {
+    className?: string;
+}): import("react").JSX.Element | null;

package/dist/lib/locale/locale-switcher.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Globe } from 'lucide-react';
+import { cn } from '../utils';
+import { localeChipLabel } from './fallback';
+import { useStudioLocale } from './use-studio-locale';
+/**
+ * The ambient locale switcher (EC-176): one segmented control, mounted in the
+ * builder toolbar and the CMS surface header, both driving the same
+ * studio-level active locale. Options come from the project locale config;
+ * the default locale is marked. Renders nothing for single-locale projects —
+ * no per-control locale ceremony anywhere else.
+ */
+export function LocaleSwitcher({ className }) {
+    const { locale, config, setLocale } = useStudioLocale();
+    if (config.locales.length <= 1)
+        return null;
+    return (_jsxs("div", { role: "group", "aria-label": "Active locale", "data-testid": "locale-switcher", className: cn('flex items-center gap-1 rounded-md bg-muted/50 p-0.5', className), children: [_jsx(Globe, { "aria-hidden": true, className: "ml-1 size-3.5 self-center text-muted-foreground" }), config.locales.map((option) => {
+                const isDefault = option === config.default;
+                return (_jsxs("button", { type: "button", "aria-pressed": option === locale, title: isDefault ? `${localeChipLabel(option)} (default locale)` : localeChipLabel(option), "data-testid": `locale-option-${option}`, onClick: () => setLocale(option), className: cn('rounded-[5px] px-2 py-0.5 text-xs font-medium uppercase transition-colors', option === locale
+                        ? 'bg-background text-foreground shadow-sm'
+                        : 'text-muted-foreground hover:text-foreground'), children: [option, isDefault ? _jsx("span", { className: "ml-0.5 text-muted-foreground/70", children: "\u00B7" }) : null] }, option));
+            })] }));
+}
+//# sourceMappingURL=locale-switcher.js.map

package/dist/lib/locale/locale-switcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale-switcher.js","sourceRoot":"","sources":["../../../src/lib/locale/locale-switcher.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAA;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,EAAE,SAAS,EAA0B;IAClE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,eAAe,EAAE,CAAA;IACvD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAE3C,OAAO,CACL,eACE,IAAI,EAAC,OAAO,gBACD,eAAe,iBACd,iBAAiB,EAC7B,SAAS,EAAE,EAAE,CAAC,sDAAsD,EAAE,SAAS,CAAC,aAEhF,KAAC,KAAK,yBAAa,SAAS,EAAC,iDAAiD,GAAG,EAChF,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;gBAC7B,MAAM,SAAS,GAAG,MAAM,KAAK,MAAM,CAAC,OAAO,CAAA;gBAC3C,OAAO,CACL,kBAEE,IAAI,EAAC,QAAQ,kBACC,MAAM,KAAK,MAAM,EAC/B,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,iBAC7E,iBAAiB,MAAM,EAAE,EACtC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,EAChC,SAAS,EAAE,EAAE,CACX,2EAA2E,EAC3E,MAAM,KAAK,MAAM;wBACf,CAAC,CAAC,yCAAyC;wBAC3C,CAAC,CAAC,6CAA6C,CAClD,aAEA,MAAM,EACN,SAAS,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,iCAAiC,uBAAS,CAAC,CAAC,CAAC,IAAI,KAdzE,MAAM,CAeJ,CACV,CAAA;YACH,CAAC,CAAC,IACE,CACP,CAAA;AACH,CAAC"}

package/dist/lib/locale/route-variant.d.ts

@@ -0,0 +1,14 @@
+import type { Locale, RouteRecord } from '@elytracms/cms-core';
+/**
+ * Per-locale URL preview (EC-176 over EC-170's per-locale routes): given the
+ * route records serving one page/template, pick the variant the active locale
+ * is actually served by — the locale's own route, else a locale-agnostic
+ * route, else the default locale's route *marked as a fallback* (the page has
+ * no address of its own in the active locale yet).
+ */
+export interface LocaleRouteVariant {
+    route: RouteRecord;
+    /** True when the active locale has no own/agnostic route — the URL shown is the default locale's. */
+    fellBack: boolean;
+}
+export declare function localeRouteVariant(routes: readonly RouteRecord[], locale: Locale, defaultLocale: Locale): LocaleRouteVariant | null;

package/dist/lib/locale/route-variant.js

@@ -0,0 +1,11 @@
+export function localeRouteVariant(routes, locale, defaultLocale) {
+    const own = routes.find((route) => route.locale === locale);
+    if (own)
+        return { route: own, fellBack: false };
+    const agnostic = routes.find((route) => route.locale === undefined);
+    if (agnostic)
+        return { route: agnostic, fellBack: false };
+    const fallback = routes.find((route) => route.locale === defaultLocale) ?? routes[0];
+    return fallback ? { route: fallback, fellBack: true } : null;
+}
+//# sourceMappingURL=route-variant.js.map

package/dist/lib/locale/route-variant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-variant.js","sourceRoot":"","sources":["../../../src/lib/locale/route-variant.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,kBAAkB,CAChC,MAA8B,EAC9B,MAAc,EACd,aAAqB;IAErB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAA;IAC3D,IAAI,GAAG;QAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;IAC/C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAA;IACnE,IAAI,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;IACzD,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,aAAa,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAA;IACpF,OAAO,QAAQ,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAC9D,CAAC"}

package/dist/lib/locale/use-studio-locale.d.ts

@@ -0,0 +1,10 @@
+import type { Locale, LocaleConfig } from '@elytracms/cms-core';
+export interface StudioLocale {
+    /** The ambient active locale every studio surface renders in. */
+    locale: Locale;
+    /** The project locale config driving the switcher options. */
+    config: LocaleConfig;
+    setLocale: (locale: Locale) => void;
+}
+/** Subscribe a React surface to the studio's ambient locale (EC-176). */
+export declare function useStudioLocale(): StudioLocale;

package/dist/lib/locale/use-studio-locale.js

@@ -0,0 +1,8 @@
+import { useSyncExternalStore } from 'react';
+import { getStudioLocaleState, setStudioLocale, subscribeStudioLocale, } from './locale-store';
+/** Subscribe a React surface to the studio's ambient locale (EC-176). */
+export function useStudioLocale() {
+    const state = useSyncExternalStore(subscribeStudioLocale, getStudioLocaleState, getStudioLocaleState);
+    return { locale: state.active, config: state.config, setLocale: setStudioLocale };
+}
+//# sourceMappingURL=use-studio-locale.js.map

package/dist/lib/locale/use-studio-locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-studio-locale.js","sourceRoot":"","sources":["../../../src/lib/locale/use-studio-locale.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAA;AAE5C,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,gBAAgB,CAAA;AAUvB,yEAAyE;AACzE,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG,oBAAoB,CAChC,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,CACrB,CAAA;IACD,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,CAAA;AACnF,CAAC"}

package/dist/lib/operations/asset-repository.d.ts

@@ -0,0 +1,15 @@
+import type { AssetRepository } from '@elytracms/persistence';
+import type { OperationsClient } from './operations-package';
+/**
+ * `AssetRepository` facade over the operations layer (EC-141). The asset
+ * flows (upload confirm, reference-respecting delete — EC-151) are written
+ * against the repository interface; this facade keeps those flows intact
+ * while routing every metadata *write* through `assets.*` commands (validate →
+ * authorize → mutate → event) and serving reads through `assets.*` queries.
+ * Blob bytes stay on `adapter.blobs` — transport, not domain.
+ *
+ * Operation failures are re-thrown as errors carrying the structured message;
+ * the asset flows already convert thrown failures into their structured
+ * results (`UploadResult` / `DeleteAssetResult`), which the UI renders.
+ */
+export declare function operationsAssetRepository(operations: OperationsClient): AssetRepository;

package/dist/lib/operations/asset-repository.js

@@ -0,0 +1,56 @@
+/**
+ * `AssetRepository` facade over the operations layer (EC-141). The asset
+ * flows (upload confirm, reference-respecting delete — EC-151) are written
+ * against the repository interface; this facade keeps those flows intact
+ * while routing every metadata *write* through `assets.*` commands (validate →
+ * authorize → mutate → event) and serving reads through `assets.*` queries.
+ * Blob bytes stay on `adapter.blobs` — transport, not domain.
+ *
+ * Operation failures are re-thrown as errors carrying the structured message;
+ * the asset flows already convert thrown failures into their structured
+ * results (`UploadResult` / `DeleteAssetResult`), which the UI renders.
+ */
+export function operationsAssetRepository(operations) {
+    return {
+        async upsertAsset(pid, input) {
+            const result = await operations.assets.upsert({ projectId: pid, asset: input });
+            if (!result.ok)
+                throw new Error(result.error.message);
+            return result.value;
+        },
+        async removeAsset(pid, id) {
+            const result = await operations.assets.remove({ projectId: pid, assetId: id });
+            if (!result.ok)
+                throw new Error(result.error.message);
+        },
+        async getAsset(pid, id) {
+            const result = await operations.assets.get({ projectId: pid, assetId: id });
+            if (!result.ok)
+                throw new Error(result.error.message);
+            return result.value;
+        },
+        async findAsset(pid, id) {
+            const result = await operations.assets.get({ projectId: pid, assetId: id });
+            if (!result.ok) {
+                if (result.error.code === 'not-found')
+                    return undefined;
+                throw new Error(result.error.message);
+            }
+            return result.value;
+        },
+        async listAssets(pid) {
+            const result = await operations.assets.list({ projectId: pid });
+            if (!result.ok)
+                throw new Error(result.error.message);
+            return result.value;
+        },
+        async resolveMany(pid, ids) {
+            const result = await operations.assets.list({ projectId: pid });
+            if (!result.ok)
+                throw new Error(result.error.message);
+            const wanted = new Set(ids);
+            return new Map(result.value.filter((a) => wanted.has(a.id)).map((a) => [a.id, a]));
+        },
+    };
+}
+//# sourceMappingURL=asset-repository.js.map

package/dist/lib/operations/asset-repository.js.map

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

package/dist/lib/operations/cms-persistence.d.ts

@@ -0,0 +1,35 @@
+import type { CmsDocument, CollectionDef, DocumentRef } from '@elytracms/cms-core';
+import type { OperationError, OperationsClient } from './operations-package';
+/**
+ * CMS session → operations persistence (EC-141). The CMS store keeps documents
+ * and collections as optimistic session state (synchronous editing, validation
+ * feedback while typing); every mutation is mirrored onto the operations layer
+ * through `documents.*` / `schema.*` commands in dispatch order.
+ *
+ * Baseline: the persisted seed only covers the sample project. Before the
+ * first mirrored command, the persister ensures the project has a persisted
+ * schema + documents matching the session's starting state (kit imports,
+ * sample fixtures), so deletes/updates address records that exist.
+ */
+export interface CmsPersister {
+    upsertDocument(doc: CmsDocument): void;
+    deleteDocument(ref: DocumentRef): void;
+    /** Publish (EC-224): snapshot the current draft as a new version and pin it live. */
+    publishDocument(ref: DocumentRef): void;
+    /** Unpublish (EC-224): clear the live version pin + any legacy published marker. */
+    unpublishDocument(ref: DocumentRef): void;
+    upsertCollection(collection: CollectionDef): void;
+    /** Run the baseline seed now (e.g. before applying an AI changeset). */
+    ensureBaseline(): Promise<void>;
+    /** Await every queued command. */
+    flush(): Promise<void>;
+}
+export interface CmsPersisterOptions {
+    projectId: string;
+    getOperations: () => Promise<OperationsClient>;
+    /** Session collections/documents at baseline time (read lazily via refs). */
+    getCollections: () => readonly CollectionDef[];
+    getDocuments: () => readonly CmsDocument[];
+    onError: (error: OperationError) => void;
+}
+export declare function createCmsPersister(options: CmsPersisterOptions): CmsPersister;

package/dist/lib/operations/cms-persistence.js

@@ -0,0 +1,75 @@
+import { createPersistQueue } from './persist-queue';
+export function createCmsPersister(options) {
+    const queue = createPersistQueue();
+    let baselineDone = false;
+    async function ensureBaselineNow() {
+        if (baselineDone)
+            return true;
+        const operations = await options.getOperations();
+        const schema = await operations.schema.get({ projectId: options.projectId });
+        if (schema.ok) {
+            // A persisted schema exists (seeded sample project or an earlier
+            // session) — the session started from the same fixtures, so commands
+            // can apply directly.
+            baselineDone = true;
+            return true;
+        }
+        const saved = await operations.schema.save({
+            projectId: options.projectId,
+            collections: [...options.getCollections()],
+        });
+        if (!saved.ok) {
+            options.onError(saved.error);
+            return false;
+        }
+        for (const document of options.getDocuments()) {
+            const result = await operations.documents.upsert({
+                projectId: options.projectId,
+                document,
+            });
+            if (!result.ok) {
+                options.onError(result.error);
+                return false;
+            }
+        }
+        baselineDone = true;
+        return true;
+    }
+    function command(run) {
+        queue.push(async () => {
+            // A failed baseline already surfaced through onError — running the
+            // command against missing records would only add a confusing follow-up.
+            if (!(await ensureBaselineNow()))
+                return;
+            const operations = await options.getOperations();
+            const result = await run(operations);
+            if (!result.ok)
+                options.onError(result.error);
+        });
+    }
+    return {
+        upsertDocument(doc) {
+            command((operations) => operations.documents.upsert({ projectId: options.projectId, document: doc }));
+        },
+        deleteDocument(ref) {
+            command((operations) => operations.documents.delete({ projectId: options.projectId, ref }));
+        },
+        publishDocument(ref) {
+            command((operations) => operations.documents.publish({ projectId: options.projectId, ref }));
+        },
+        unpublishDocument(ref) {
+            command((operations) => operations.documents.unpublish({ projectId: options.projectId, ref }));
+        },
+        upsertCollection(collection) {
+            command((operations) => operations.schema.upsertCollection({ projectId: options.projectId, collection }));
+        },
+        async ensureBaseline() {
+            queue.push(async () => {
+                await ensureBaselineNow();
+            });
+            await queue.flush();
+        },
+        flush: () => queue.flush(),
+    };
+}
+//# sourceMappingURL=cms-persistence.js.map

package/dist/lib/operations/cms-persistence.js.map

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

package/dist/lib/operations/graph-commands.d.ts

@@ -0,0 +1,140 @@
+import type { ComponentNode, Condition, InsertTarget, ProjectGraph, PropValue } from '@elytracms/project-graph';
+import type { WorkingGraph, WorkingPageSeo } from '../working-graph';
+import type { OperationResult, OperationsClient } from './operations-package';
+/**
+ * Builder action → graph operation mapping (EC-141, reshaped by EC-187).
+ *
+ * The canonical `ProjectGraph` is now LAYOUTS-ONLY, and the page-node graph
+ * commands (`graph.insertNode`/`removeNode`/`duplicateNode`/`moveNode`/
+ * `reorderNode`/`setNodeProp`/`removeNodeProp`/`setNodeCondition`) were DELETED
+ * from the operations layer — a page is a CMS document now, edited through the
+ * composition-field path, not mirrored as node ops. So every page-tree edit
+ * here returns `null`: the legacy `/builder` page editor is in-memory-only for
+ * page edits (it is retired in a later slice).
+ *
+ * What still persists: `loadGraph` (restoring a saved revision), `undo`, and
+ * `redo` each save the whole graph via `graph.save` — but a `graph.save`
+ * persists a CANONICAL layouts-only `ProjectGraph`, so the WorkingGraph
+ * `present` is converted via `toProjectGraph` before it is sent.
+ */
+/** The builder store's action union (owned here so the mapping stays React-free). */
+export type BuilderAction = 
+/** `pageId` additionally switches the active page (reference deep links, EC-172). */
+{
+    type: 'select';
+    id: string | null;
+    pageId?: string;
+} | {
+    type: 'hover';
+    id: string | null;
+} | {
+    type: 'viewport';
+    viewport: 'desktop' | 'tablet' | 'mobile';
+} | {
+    type: 'undo';
+} | {
+    type: 'redo';
+} | {
+    type: 'insert';
+    target: InsertTarget;
+    node: ComponentNode;
+    select?: boolean;
+} | {
+    type: 'remove';
+    id: string;
+} | {
+    type: 'duplicate';
+    id: string;
+} | {
+    type: 'reorder';
+    id: string;
+    delta: -1 | 1;
+} | {
+    type: 'move';
+    id: string;
+    target: InsertTarget;
+}
+/**
+ * EC-162 layout gesture: wrap the reference node and the dragged subject in
+ * a two-column Grid container as ONE atomic structural edit (one undo step).
+ */
+ | {
+    type: 'wrap';
+    referenceId: string;
+    side: 'left' | 'right';
+    subject: {
+        kind: 'node';
+        nodeId: string;
+    } | {
+        kind: 'component';
+        node: ComponentNode;
+    };
+} | {
+    type: 'setProp';
+    id: string;
+    name: string;
+    value: PropValue;
+    coalesceKey?: string;
+} | {
+    type: 'removeProp';
+    id: string;
+    name: string;
+} | {
+    type: 'setCondition';
+    id: string;
+    condition: Condition | undefined;
+}
+/**
+ * EC-171 legacy page SEO (in-memory only): set a working page's `seo` block.
+ * Page SEO persists via the `page` CMS document now, never as a node op — so
+ * this action does not mirror to a `graph.*` command.
+ */
+ | {
+    type: 'setPageSeo';
+    pageId: string;
+    seo: WorkingPageSeo | undefined;
+} | {
+    type: 'loadGraph';
+    graph: ProjectGraph;
+};
+/** The slice of builder state the mapping needs (pre-dispatch snapshot). */
+export interface BuilderSnapshot {
+    present: WorkingGraph;
+    pageId: string;
+    nodeSeq: number;
+}
+/** A graph operation invocation, dispatchable via `operations.execute`. */
+export interface GraphInvocation {
+    operation: string;
+    input: unknown;
+}
+/**
+ * Map a dispatched builder action onto the `graph.*` command that persists it.
+ *
+ * After EC-187 only the whole-graph operations survive: `loadGraph`/`undo`/
+ * `redo` persist a layouts-only `ProjectGraph` via `graph.save`. Every
+ * page-tree edit (insert/remove/duplicate/move/reorder/wrap/setProp/
+ * removeProp/setCondition) returns `null` — page-node graph commands are gone;
+ * those edits stay in-memory until the page is saved as a CMS document.
+ */
+export declare function graphInvocationFor(projectId: string, action: BuilderAction, prev: BuilderSnapshot, next: {
+    present: WorkingGraph;
+}): GraphInvocation | null;
+/**
+ * Make the persisted latest revision equal `graph` (the session's working
+ * graph) so node-level `graph.*` commands apply onto identical state. Saves a
+ * baseline revision when the project has no revision yet or the persisted
+ * latest diverged from the session (the builder session is the source of
+ * truth for the draft timeline — see the builder-store design note).
+ */
+export declare function ensureGraphBaseline(operations: OperationsClient, projectId: string, graph: ProjectGraph | WorkingGraph): Promise<OperationResult<unknown>>;
+/**
+ * Persist "publish the session's latest state" (EC-141): ensure the working
+ * graph is the persisted latest revision (as the canonical layouts-only
+ * graph), then pin it live via `publishing.publish`. Single-environment
+ * (EC-179): a deployment IS one environment, so there is no target environment
+ * and no promote.
+ */
+export declare function persistPublish(operations: OperationsClient, projectId: string, workingGraph: ProjectGraph | WorkingGraph): Promise<OperationResult<unknown>>;
+/** Persist an unpublish: revert the deployment to draft. */
+export declare function persistUnpublish(operations: OperationsClient, projectId: string): Promise<OperationResult<unknown>>;

package/dist/lib/operations/graph-commands.js

@@ -0,0 +1,86 @@
+import { toProjectGraph } from '../working-graph';
+/**
+ * Map a dispatched builder action onto the `graph.*` command that persists it.
+ *
+ * After EC-187 only the whole-graph operations survive: `loadGraph`/`undo`/
+ * `redo` persist a layouts-only `ProjectGraph` via `graph.save`. Every
+ * page-tree edit (insert/remove/duplicate/move/reorder/wrap/setProp/
+ * removeProp/setCondition) returns `null` — page-node graph commands are gone;
+ * those edits stay in-memory until the page is saved as a CMS document.
+ */
+export function graphInvocationFor(projectId, action, prev, next) {
+    switch (action.type) {
+        case 'undo':
+        case 'redo': {
+            if (prev.present === next.present)
+                return null;
+            return {
+                operation: 'graph.save',
+                input: {
+                    projectId,
+                    // graph.save persists the canonical layouts-only graph.
+                    graph: toProjectGraph(next.present),
+                    message: action.type === 'undo' ? 'Undo' : 'Redo',
+                },
+            };
+        }
+        case 'loadGraph':
+            return {
+                operation: 'graph.save',
+                // `loadGraph` carries a canonical (layouts-only) ProjectGraph restore.
+                input: { projectId, graph: action.graph, message: 'Load graph' },
+            };
+        // Page-tree edits no longer mirror to node-level graph commands (those
+        // operations were deleted) — the page editor is in-memory-only now.
+        case 'select':
+        case 'hover':
+        case 'viewport':
+        case 'insert':
+        case 'remove':
+        case 'duplicate':
+        case 'reorder':
+        case 'move':
+        case 'wrap':
+        case 'setProp':
+        case 'removeProp':
+        case 'setCondition':
+        case 'setPageSeo':
+            return null;
+        default:
+            return null;
+    }
+}
+/**
+ * Make the persisted latest revision equal `graph` (the session's working
+ * graph) so node-level `graph.*` commands apply onto identical state. Saves a
+ * baseline revision when the project has no revision yet or the persisted
+ * latest diverged from the session (the builder session is the source of
+ * truth for the draft timeline — see the builder-store design note).
+ */
+export async function ensureGraphBaseline(operations, projectId, graph) {
+    // A working graph (the live session) is persisted as the canonical
+    // layouts-only graph; a canonical graph passes through unchanged.
+    const canonical = 'pages' in graph ? toProjectGraph(graph) : graph;
+    const latest = await operations.graph.getLatest({ projectId });
+    if (latest.ok && JSON.stringify(latest.value.graph) === JSON.stringify(canonical))
+        return latest;
+    return operations.graph.save({ projectId, graph: canonical, message: 'Builder session baseline' });
+}
+/**
+ * Persist "publish the session's latest state" (EC-141): ensure the working
+ * graph is the persisted latest revision (as the canonical layouts-only
+ * graph), then pin it live via `publishing.publish`. Single-environment
+ * (EC-179): a deployment IS one environment, so there is no target environment
+ * and no promote.
+ */
+export async function persistPublish(operations, projectId, workingGraph) {
+    const baseline = await ensureGraphBaseline(operations, projectId, workingGraph);
+    if (!baseline.ok)
+        return baseline;
+    return operations.publishing.publish({ projectId });
+}
+/** Persist an unpublish: revert the deployment to draft. */
+export async function persistUnpublish(operations, projectId) {
+    return operations.publishing.unpublish({ projectId });
+}
+//# sourceMappingURL=graph-commands.js.map