@elytracms/studio 0.0.1

package/dist/components/cms/cell.js

@@ -0,0 +1,127 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Boxes, Check, Image, Link2, Minus } from 'lucide-react';
+import { blockRootsOf } from '@elytracms/project-graph';
+import { Badge, Code, Text } from '@elytracms/studio/ui';
+import { localeChipLabel, resolveDisplayedValue } from '@elytracms/studio/lib/locale';
+import { useOptionalAssets } from '../assets/assets-store';
+import { useCms } from './cms-store';
+/**
+ * Render a document's field value for a table cell, by field type (brief
+ * §8.4, EC-070), resolved in the studio's ambient active locale (EC-176).
+ * A value served via EC-018 locale fallback carries a visible chip — never
+ * silently mixed in as if it were translated.
+ */
+export function CellValue({ collection, doc, field, }) {
+    const cms = useCms();
+    const { value, fallback } = resolveDisplayedValue(collection, doc, field.name, cms.activeLocale, cms.localeConfig);
+    if (value === undefined || value === null || value === '') {
+        return _jsx(Minus, { className: "size-3.5 text-muted-foreground/50" });
+    }
+    return (_jsxs("span", { className: "inline-flex min-w-0 max-w-full items-center gap-1.5", children: [_jsx(TypedCellValue, { field: field, value: value }), _jsx(FallbackChip, { fallback: fallback, testId: `cell-fallback-${doc.id}-${field.name}` })] }));
+}
+/**
+ * Subtle source-locale chip on a fallback-displayed value (EC-176): e.g. a
+ * German view showing untranslated English content gets an "EN" marker.
+ */
+export function FallbackChip({ fallback, testId, }) {
+    if (fallback === null)
+        return null;
+    return (_jsx(Badge, { variant: "outline", "data-testid": testId, title: fallbackTitle(fallback), className: "shrink-0 px-1 py-0 text-[0.6rem] uppercase tracking-wide text-muted-foreground", children: localeChipLabel(fallback.sourceLocale) }));
+}
+/** Plain-language tooltip of a fallback chip. */
+export function fallbackTitle(fallback) {
+    return `Showing ${localeChipLabel(fallback.sourceLocale)} (fallback) — no ${localeChipLabel(fallback.requestedLocale)} translation yet. Edit to translate.`;
+}
+function TypedCellValue({ field, value }) {
+    switch (field.type) {
+        case 'boolean':
+            return value === true ? (_jsx(Check, { className: "size-4 text-success" })) : (_jsx(Minus, { className: "size-3.5 text-muted-foreground/50" }));
+        case 'select':
+            return _jsx(Badge, { variant: "outline", children: String(value) });
+        case 'number':
+            return _jsx(Text, { size: "sm", mono: true, children: String(value) });
+        case 'date':
+            return (_jsx(Text, { size: "sm", tone: "muted", mono: true, children: String(value).slice(0, 10) }));
+        case 'richText':
+            return (_jsx(Text, { size: "xs", tone: "subtle", children: stripHtml(String(value)).slice(0, 40) || 'rich text' }));
+        case 'relation':
+            return _jsx(RelationCell, { value: value });
+        case 'asset':
+            return _jsx(AssetCell, { value: value });
+        case 'blocks':
+            return _jsx(BlocksCell, { value: value });
+        case 'object': {
+            // EC-253: list-view summary, never `[object Object]`. A repeater shows its
+            // item count; a single object is edited in the detail form, not the cell.
+            if (field.cardinality === 'many') {
+                const count = Array.isArray(value) ? value.length : 0;
+                return (_jsxs(Badge, { variant: "outline", children: [count, " ", count === 1 ? 'item' : 'items'] }));
+            }
+            return (_jsx(Text, { size: "xs", tone: "subtle", children: value && typeof value === 'object' ? 'object' : '—' }));
+        }
+        default:
+            return (_jsx(Text, { size: "sm", className: "truncate", children: String(value) }));
+    }
+}
+function RelationCell({ value }) {
+    const cms = useCms();
+    const refs = toRefArray(value);
+    if (refs.length === 0)
+        return _jsx(Minus, { className: "size-3.5 text-muted-foreground/50" });
+    return (_jsxs("div", { className: "flex flex-wrap items-center gap-1", children: [refs.slice(0, 3).map((ref, i) => (_jsxs(Badge, { variant: "info", children: [_jsx(Link2, { className: "size-3" }), " ", cms.titleOf(ref)] }, `${ref.id}-${i}`))), refs.length > 3 ? _jsxs(Text, { size: "xs", tone: "subtle", children: ["+", refs.length - 3] }) : null] }));
+}
+/**
+ * A blocks/composition cell: a count of TOP-LEVEL blocks (EC-212) — matching
+ * what the canvas/page-tree present as the block list, never `[object Object]`.
+ */
+function BlocksCell({ value }) {
+    const count = blockRootsOf(value).length;
+    if (count === 0)
+        return _jsx(Minus, { className: "size-3.5 text-muted-foreground/50" });
+    return (_jsxs(Badge, { variant: "outline", children: [_jsx(Boxes, { className: "size-3" }), " ", count, " ", count === 1 ? 'block' : 'blocks'] }));
+}
+function AssetCell({ value }) {
+    const cms = useCms();
+    const assetStore = useOptionalAssets();
+    const assetCollectionId = cms.collections.find((c) => c.kind === 'asset')?.id ?? 'asset';
+    const ids = (Array.isArray(value) ? value : [value]).filter((v) => typeof v === 'string');
+    if (ids.length === 0)
+        return _jsx(Minus, { className: "size-3.5 text-muted-foreground/50" });
+    const first = ids[0];
+    const record = assetStore?.assets.find((asset) => asset.id === first);
+    const label = record?.title ?? record?.filename ?? cms.titleOf({ collection: assetCollectionId, id: first });
+    return (_jsxs("div", { className: "flex flex-wrap items-center gap-1.5", children: [_jsx(AssetPreview, { record: record, label: label }), ids.length > 1 ? _jsxs(Text, { size: "xs", tone: "subtle", children: ["+", ids.length - 1] }) : null] }));
+}
+/**
+ * An asset reference in a cell: an image thumbnail for image assets with a
+ * resolvable URL (EC-212), otherwise the labelled icon badge (and the same
+ * badge whenever no `<AssetsProvider>` is mounted to resolve the record).
+ */
+function AssetPreview({ record, label }) {
+    const isImage = record?.contentType.startsWith('image/') ?? false;
+    const url = record?.url;
+    if (isImage && url && url.startsWith('http')) {
+        return (_jsxs("span", { className: "inline-flex min-w-0 items-center gap-1.5", children: [_jsx("img", { src: url, alt: record?.alt ?? label, loading: "lazy", className: "size-7 shrink-0 rounded border border-border bg-muted object-cover" }), _jsx(Text, { size: "xs", tone: "subtle", className: "max-w-[10rem] truncate", children: label })] }));
+    }
+    return (_jsxs(Badge, { variant: "outline", children: [_jsx(Image, { className: "size-3" }), " ", label] }));
+}
+/** Normalize a relation value (single ref or array of refs) into an array. */
+export function toRefArray(value) {
+    if (Array.isArray(value))
+        return value.filter(isRef);
+    return isRef(value) ? [value] : [];
+}
+function isRef(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.collection === 'string' &&
+        typeof value.id === 'string');
+}
+function stripHtml(html) {
+    return html.replace(/<[^>]*>/g, ' ').replace(/\s+/g, ' ').trim();
+}
+/** Render a small mono code for the raw stored value (debug/primary-cell hint). */
+export function RawValue({ value }) {
+    return _jsx(Code, { tone: "muted", children: typeof value === 'string' ? value : JSON.stringify(value) });
+}
+//# sourceMappingURL=cell.js.map

package/dist/components/cms/cell.js.map

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

package/dist/components/cms/cms-index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The CMS section landing view (EC-223 Stage 6): the collection grid, shown when
+ * no collection is selected. Takes `projectId` as a prop; the splat resolver
+ * mounts it inside the CMS provider so {@link useCms} resolves.
+ */
+export declare function CmsIndex({ projectId }: {
+    projectId: string;
+}): import("react").JSX.Element;

package/dist/components/cms/cms-index.js

@@ -0,0 +1,23 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Database, FileCog } from 'lucide-react';
+import { isSingleton } from '@elytracms/cms-core';
+import { Link, STUDIO_PROJECT_ROUTE, studioPath } from '@elytracms/studio/router';
+import { useCms } from '@elytracms/studio/components/cms/cms-store';
+import { CollectionsSidebar } from '@elytracms/studio/components/cms/collections-sidebar';
+import { Card, Code, Heading, Spacer, Stack, Text } from '@elytracms/studio/ui';
+/**
+ * The CMS section landing view (EC-223 Stage 6): the collection grid, shown when
+ * no collection is selected. Takes `projectId` as a prop; the splat resolver
+ * mounts it inside the CMS provider so {@link useCms} resolves.
+ */
+export function CmsIndex({ projectId }) {
+    const cms = useCms();
+    return (_jsxs("div", { className: "mx-auto w-full max-w-3xl p-4 sm:p-6", children: [_jsx("div", { className: "mb-6 h-72 overflow-hidden rounded-lg border border-border md:hidden", children: _jsx(CollectionsSidebar, { projectId: projectId }) }), _jsxs(Stack, { gap: "6", children: [_jsxs(Stack, { gap: "1", children: [_jsx(Heading, { size: "display", children: "Content" }), _jsx(Text, { tone: "muted", children: "Schema-driven collections. Open a collection to browse its documents as a table and edit them in the detail editor." })] }), _jsx("div", { className: "grid gap-3 sm:grid-cols-2", children: cms.collections.map((collection) => {
+                            // EC-217: a singleton reads as one fixed document — a distinct icon
+                            // and a "Single document" note instead of a (always-1) row count.
+                            const singleton = isSingleton(collection);
+                            const Icon = singleton ? FileCog : Database;
+                            return (_jsx(Link, { to: STUDIO_PROJECT_ROUTE, params: { projectId, _splat: studioPath.cmsCollection(collection.id) }, children: _jsxs(Card, { className: "flex items-center gap-3 p-4 transition-colors hover:border-primary/30", children: [_jsx("span", { className: "grid size-9 shrink-0 place-items-center rounded-lg bg-muted text-muted-foreground", children: _jsx(Icon, { className: "size-4" }) }), _jsxs(Stack, { gap: "none", className: "min-w-0", children: [_jsx(Text, { weight: "semibold", className: "truncate", children: collection.form?.label ?? collection.id }), _jsxs(Code, { tone: "muted", className: "w-fit", children: [collection.id, " \u00B7 ", collection.fields.length, " fields"] })] }), _jsx(Spacer, {}), singleton ? (_jsx(Text, { size: "xs", tone: "muted", className: "whitespace-nowrap", children: "Single document" })) : (_jsx(Text, { size: "sm", tone: "muted", mono: true, children: cms.documentsOf(collection.id).length }))] }) }, collection.id));
+                        }) })] })] }));
+}
+//# sourceMappingURL=cms-index.js.map

package/dist/components/cms/cms-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms-index.js","sourceRoot":"","sources":["../../../src/components/cms/cms-index.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,4CAA4C,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAA;AACzF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAE/E;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAE,SAAS,EAAyB;IAC3D,MAAM,GAAG,GAAG,MAAM,EAAE,CAAA;IAEpB,OAAO,CACL,eAAK,SAAS,EAAC,qCAAqC,aAClD,cAAK,SAAS,EAAC,qEAAqE,YAClF,KAAC,kBAAkB,IAAC,SAAS,EAAE,SAAS,GAAI,GACxC,EACN,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,aACZ,MAAC,KAAK,IAAC,GAAG,EAAC,GAAG,aACZ,KAAC,OAAO,IAAC,IAAI,EAAC,SAAS,wBAAkB,EACzC,KAAC,IAAI,IAAC,IAAI,EAAC,OAAO,oIAGX,IACD,EACR,cAAK,SAAS,EAAC,2BAA2B,YACvC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;4BAClC,oEAAoE;4BACpE,kEAAkE;4BAClE,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;4BACzC,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAA;4BAC3C,OAAO,CACL,KAAC,IAAI,IAEH,EAAE,EAAE,oBAAoB,EACxB,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,YAEtE,MAAC,IAAI,IAAC,SAAS,EAAC,uEAAuE,aACrF,eAAM,SAAS,EAAC,mFAAmF,YACjG,KAAC,IAAI,IAAC,SAAS,EAAC,QAAQ,GAAG,GACtB,EACP,MAAC,KAAK,IAAC,GAAG,EAAC,MAAM,EAAC,SAAS,EAAC,SAAS,aACnC,KAAC,IAAI,IAAC,MAAM,EAAC,UAAU,EAAC,SAAS,EAAC,UAAU,YACzC,UAAU,CAAC,IAAI,EAAE,KAAK,IAAI,UAAU,CAAC,EAAE,GACnC,EACP,MAAC,IAAI,IAAC,IAAI,EAAC,OAAO,EAAC,SAAS,EAAC,OAAO,aACjC,UAAU,CAAC,EAAE,cAAK,UAAU,CAAC,MAAM,CAAC,MAAM,eACtC,IACD,EACR,KAAC,MAAM,KAAG,EACT,SAAS,CAAC,CAAC,CAAC,CACX,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAC,SAAS,EAAC,mBAAmB,gCAEnD,CACR,CAAC,CAAC,CAAC,CACF,KAAC,IAAI,IAAC,IAAI,EAAC,IAAI,EAAC,IAAI,EAAC,OAAO,EAAC,IAAI,kBAC9B,GAAG,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,GACjC,CACR,IACI,IA1BF,UAAU,CAAC,EAAE,CA2Bb,CACR,CAAA;wBACH,CAAC,CAAC,GACE,IACA,IACJ,CACP,CAAA;AACH,CAAC"}

package/dist/components/cms/cms-store.d.ts

@@ -0,0 +1,188 @@
+import type { ReactNode } from 'react';
+import type { CmsDocument, CmsValidationIssue, CollectionDef, DocumentRef, FieldDef, Locale, LocaleConfig } from '@elytracms/cms-core';
+import type { DocumentVersionRecord } from '@elytracms/persistence';
+import type { OperationError } from '@elytracms/studio/lib/operations';
+import type { TableViewState } from '@elytracms/studio/lib/cms-views';
+import type { CellCommitInput, CellCommitOutcome } from './cell-edit';
+import type { BulkAction, BulkReport } from './bulk-actions';
+/**
+ * A saved table view (EC-169, supersedes the EC-071 column presets): a named
+ * bundle of filters (closed AD-3 vocabulary), sort, and visible/ordered
+ * columns. Named views persist project-scoped through operations (see
+ * `lib/cms-views/views-store`); the unnamed "All documents" default is derived
+ * per collection and never persisted.
+ */
+export interface SavedView {
+    id: string;
+    name: string;
+    state: TableViewState;
+}
+/**
+ * Mint a collision-safe, slug-derived page id (EC-192): the slug of the page name,
+ * suffixed `-2`/`-3`/… until it is free among the ids already taken. Empty or
+ * symbol-only names fall back to `page`. Pure so the id rule is testable without
+ * the store; `createPage` applies it against the live page documents.
+ */
+export declare function nextPageId(name: string, taken: ReadonlySet<string>): string;
+export interface ImportReport {
+    added: number;
+    rejected: {
+        id: string;
+        issues: CmsValidationIssue[];
+    }[];
+}
+/**
+ * A document's recorded version history plus its live pin (EC-224), as the
+ * Versions inspector pane reads it. `versions` is newest-first; `publishedVersion`
+ * is the recorded version currently pinned live, absent when unpublished.
+ */
+export interface DocumentVersionsView {
+    versions: DocumentVersionRecord[];
+    publishedVersion?: number;
+}
+export interface CmsStore {
+    /** The project this CMS session edits (set when persistence is enabled); the asset picker scopes the real library by it (EC-152). */
+    projectId?: string;
+    collections: readonly CollectionDef[];
+    localeConfig: LocaleConfig;
+    /**
+     * The studio's ambient active locale (EC-176): table cells, detail forms,
+     * and inline edits all display and write THIS locale. Switched once via the
+     * shared `LocaleSwitcher`, never per control.
+     */
+    activeLocale: Locale;
+    getCollection(id: string): CollectionDef | undefined;
+    documentsOf(collectionId: string): CmsDocument[];
+    getDocument(ref: DocumentRef): CmsDocument | undefined;
+    /** Resolve a relation/asset target's display title. */
+    titleOf(ref: DocumentRef): string;
+    saveDocument(doc: CmsDocument): void;
+    /**
+     * Commit ONE field edit from the table (EC-168): optimistic session apply +
+     * exactly one `documents.upsert` operations command, awaited. Validation
+     * failures and operation rejections return a structured error (the caller
+     * renders it on the cell) and leave the session rolled back.
+     */
+    commitFieldEdit(input: CellCommitInput): Promise<CellCommitOutcome>;
+    createDocument(collectionId: string): DocumentRef;
+    /** Create a named page (`page` collection) with a stable, slug-derived id. */
+    createPage(input: {
+        name: string;
+    }): DocumentRef;
+    /**
+     * Ensure a singleton collection's one fixed document exists (EC-217): the
+     * document id is the collection id ({@link singletonDocId}). Idempotent —
+     * returns the ref whether it created the (empty) document or it was already
+     * present. The detail editor for a singleton opens through this so the single
+     * document always exists to edit.
+     */
+    ensureSingletonDocument(collectionId: string): DocumentRef;
+    deleteDocument(ref: DocumentRef): void;
+    /**
+     * Is this document currently published? Sourced from the version POINTER
+     * (EC-224), not the flat `state` enum — seeded from hydration and updated by
+     * {@link publishDocument}/{@link unpublishDocument}.
+     */
+    isPublished(ref: DocumentRef): boolean;
+    /**
+     * Publish: snapshot the draft as a new version and pin it live (EC-224).
+     * Flips published-ness optimistically, then reconciles against the backend
+     * record (EC-225) so the badge can never claim a publish the backend refused
+     * (e.g. blocked by publish-time field validation).
+     */
+    publishDocument(ref: DocumentRef): Promise<void>;
+    /**
+     * Unpublish: clear the live version pin (EC-224). Blocked at the operations
+     * layer while strict relation fields published-reference it (EC-173); the
+     * optimistic flip reconciles against the backend on rejection (EC-225).
+     */
+    unpublishDocument(ref: DocumentRef): Promise<void>;
+    /**
+     * Load this document's recorded version history + live pin (EC-224) for the
+     * Versions inspector pane. Fixture/playground sessions (no project) have no
+     * persisted history → an empty view. Failures surface as {@link persistError}.
+     */
+    loadDocumentVersions(ref: DocumentRef): Promise<DocumentVersionsView>;
+    /**
+     * Restore a recorded version as the new working draft (EC-224): the operation
+     * snapshots the current draft first (so the rollback is itself undoable), then
+     * loads the chosen snapshot. Returns the restored draft (or null on
+     * failure/fixture session) so the open editor can adopt it.
+     */
+    restoreDocumentVersion(ref: DocumentRef, version: number): Promise<CmsDocument | null>;
+    importDocuments(collectionId: string, docs: unknown[]): ImportReport;
+    validate(doc: CmsDocument): CmsValidationIssue[];
+    isFieldReadOnly(collectionId: string, field: FieldDef): boolean;
+    viewsOf(collectionId: string): SavedView[];
+    activeViewId(collectionId: string): string;
+    /** Switch views — resets the working table state to the view's state. */
+    setActiveView(collectionId: string, viewId: string): void;
+    /** The live table state (the active view's state plus unsaved edits). */
+    tableStateOf(collectionId: string): TableViewState;
+    /**
+     * Update the working state. Always pass an updater when deriving from the
+     * previous state — render-time snapshots go stale across rapid events.
+     */
+    setTableState(collectionId: string, update: TableViewState | ((prev: TableViewState) => TableViewState)): void;
+    /** Does the working state diverge from the active view ("unsaved changes")? */
+    isViewDirty(collectionId: string): boolean;
+    /** Discard working-state edits, back to the active view. */
+    resetTableState(collectionId: string): void;
+    /** Persist the working state into the active named view. False on rejection. */
+    saveActiveView(collectionId: string): Promise<boolean>;
+    /** Persist the working state as a new named view and activate it. */
+    saveViewAs(collectionId: string, name: string): Promise<boolean>;
+    /** Delete a named view — a view-only operation; documents are never touched. */
+    deleteView(collectionId: string, viewId: string): Promise<boolean>;
+    /**
+     * Bulk publish/unpublish/delete (EC-169): one operations command PER item,
+     * per-item outcomes in the report — partial failure is enumerated, never
+     * silent. Only succeeded items mutate the session.
+     */
+    runBulk(collectionId: string, ids: readonly string[], action: BulkAction): Promise<BulkReport>;
+    /**
+     * Mirror a collection into the session (e.g. an accepted AI-generated
+     * schema, EC-097). Replaces by id. Session-only: persistence happens through
+     * the accept flow's changeset (`schema.upsertCollection`), not here.
+     */
+    addCollection(def: CollectionDef): void;
+    /**
+     * Most recent failed/denied persisted mutation (structured, from the
+     * operation result). Rendered by the CMS surface — never a silent failure.
+     */
+    persistError: OperationError | null;
+    clearPersistError(): void;
+    /** Seed the persisted baseline now (e.g. before applying an AI changeset). */
+    ensurePersistedBaseline(): Promise<void>;
+    /** Await all queued persisted mutations (tests, publish flows). */
+    flushPersistence(): Promise<void>;
+}
+declare function primaryField(collection: CollectionDef): string;
+/**
+ * The CMS session store (EC-141): documents and collections are optimistic,
+ * synchronous session state (live validation while typing); every mutation —
+ * create/save/delete/state transitions — is mirrored onto the operations
+ * layer (`documents.*` / `schema.*` commands) through {@link createCmsPersister}.
+ * Failed/denied commands surface as {@link CmsStore.persistError}.
+ */
+export declare function CmsProvider({ children, projectId, initialCollections, initialDocuments, initialPublishedKeys, initialLocaleConfig, }: {
+    children: ReactNode;
+    /** Enables persistence through the shared operations client. */
+    projectId?: string;
+    /** Seed collections (e.g. from an imported starter kit, EC-119); defaults to the samples. */
+    initialCollections?: CollectionDef[];
+    initialDocuments?: CmsDocument[];
+    /**
+     * Published document keys from hydration (EC-224): the version pointer
+     * (`publishedVersion` set). Absent (kit / fixture sessions) → the sample
+     * fixtures' published set (`samplePublishedKeys`).
+     */
+    initialPublishedKeys?: readonly string[];
+    /** Locale config for the seeded content; defaults to the sample config. */
+    initialLocaleConfig?: LocaleConfig;
+}): import("react").JSX.Element;
+export declare function useCms(): CmsStore;
+/** Export a locale-aware label for a field (form label or name). */
+export declare function fieldLabel(field: FieldDef): string;
+export { primaryField };
+export type { Locale };