@elytracms/core 0.0.6

package/dist/clipboard/index.js

@@ -0,0 +1,16 @@
+/**
+ * @elytracms/clipboard — the spec'd, versioned clipboard fragment (EC-174,
+ * vision 3.7). Copy/paste as a real interchange format: a Zod-validated
+ * envelope carrying a graph subtree, manifest references, binding declarations,
+ * asset references, and source metadata, serialized to the OS clipboard as
+ * canonical JSON with a human-readable (and losslessly round-tripping) HTML
+ * fallback. Package-level only — EC-175 wires it into the studio.
+ */
+export const PACKAGE = '@elytracms/core/clipboard';
+export * from './fragment';
+export * from './references';
+export * from './serialize';
+export * from './build';
+export * from './html';
+export * from './clipboard';
+//# sourceMappingURL=index.js.map

package/dist/clipboard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/clipboard/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,2BAA2B,CAAA;AAElD,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,aAAa,CAAA"}

package/dist/clipboard/references.d.ts

@@ -0,0 +1,50 @@
+import type { BindingReference, ComponentNode } from '@elytracms/core/project-graph';
+import type { AssetRef, ClipboardFragment, ManifestRef } from './fragment';
+/**
+ * Reference collection: deterministic, structural walks over a fragment subtree
+ * that enumerate everything it points at — component ids, binding declarations,
+ * asset ids. Builders use these to populate the payload's reference lists;
+ * `parseFragment` recomputes them so consumers can diff a pasted fragment
+ * against their registry/sources without re-walking the tree themselves.
+ *
+ * All collectors are pure, never throw, and return sorted, de-duplicated lists
+ * so equal subtrees yield byte-identical fragments.
+ */
+/**
+ * Convention for asset references inside static prop values (shared with
+ * rich-text link marks and persistence reference extraction, EC-155):
+ * `elytra:asset/<id>` strings, or objects carrying an `assetId` string.
+ */
+export declare const ASSET_REFERENCE_PREFIX = "elytra:asset/";
+/** Every component id used anywhere in the subtree (sorted, unique). */
+export declare function collectComponentIds(root: ComponentNode): string[];
+/**
+ * Every binding declaration referenced by the subtree's bound props and render
+ * conditions (sorted by source id, token, mode; unique).
+ */
+export declare function collectBindingDeclarations(root: ComponentNode): BindingReference[];
+/**
+ * Every asset id referenced by static prop values in the subtree (sorted,
+ * unique). Detects the `elytra:asset/<id>` string convention and embedded
+ * `assetId` attributes (e.g. rich-text image nodes).
+ */
+export declare function collectAssetIds(root: ComponentNode): string[];
+/**
+ * Everything a fragment references, enumerated for the consumer: the component
+ * ids actually used by the subtree, the declared manifest refs, and the binding
+ * and asset declarations. Paste targets diff these against their registry and
+ * data sources — a mismatch is the consumer's structured issue, never a parse
+ * failure here.
+ */
+export interface FragmentReferences {
+    /** Component ids used anywhere in the subtree (sorted, unique). */
+    componentIds: string[];
+    /** Manifest references declared in the payload (`name@version`). */
+    manifests: ManifestRef[];
+    /** Binding declarations referenced by props/conditions. */
+    bindings: BindingReference[];
+    /** Asset references declared in the payload. */
+    assets: AssetRef[];
+}
+/** Enumerate a fragment's references (recomputed from the subtree, plus declared lists). */
+export declare function collectFragmentReferences(fragment: ClipboardFragment): FragmentReferences;

package/dist/clipboard/references.js.map

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

package/dist/clipboard/serialize.d.ts

@@ -0,0 +1,69 @@
+import type { ClipboardFragment } from './fragment';
+import type { FragmentReferences } from './references';
+/**
+ * Fragment serialization, following `@elytracms/core/project-graph`'s conventions:
+ * parse-before-serialize (the output contains no runtime-only values) and a
+ * never-throw parse. On top of that, serialization is *canonical* — object keys
+ * are sorted recursively — so build → serialize → parse → serialize is
+ * byte-identical regardless of property insertion order. Canonical bytes are
+ * what goes onto the OS clipboard (and into the HTML fallback's data
+ * attribute), so two copies of the same subtree are comparable as strings.
+ */
+/**
+ * Deterministic JSON: arrays in order, object keys sorted recursively,
+ * `undefined` object values dropped (matching `JSON.stringify`).
+ */
+export declare function canonicalJsonStringify(value: unknown): string;
+/**
+ * Serialize a fragment to canonical JSON. Parsing first guarantees the output
+ * is exactly the spec'd envelope (programmer error in the input throws — this
+ * is the trusted, in-process direction; `parseFragment` owns untrusted input).
+ */
+export declare function serializeFragment(fragment: ClipboardFragment): string;
+/** One schema violation, flattened to a path string for display/logging. */
+export interface FragmentIssue {
+    path: string;
+    message: string;
+}
+/**
+ * The closed taxonomy of parse failures. Every way untrusted clipboard content
+ * can be wrong maps to exactly one structured code — never an exception:
+ *
+ * - `corrupt-json`          the string is not JSON at all
+ * - `foreign-format`        valid JSON, but not an Elytra fragment envelope
+ * - `unsupported-version`   our format, but a spec version this package does not read
+ * - `invalid-payload`       our format + version, but the payload violates the schema
+ */
+export type FragmentParseError = {
+    code: 'corrupt-json';
+    message: string;
+} | {
+    code: 'foreign-format';
+    message: string;
+    format?: string;
+} | {
+    code: 'unsupported-version';
+    message: string;
+    version: number;
+} | {
+    code: 'invalid-payload';
+    message: string;
+    issues: FragmentIssue[];
+};
+export type ParseFragmentResult = {
+    ok: true;
+    fragment: ClipboardFragment;
+    references: FragmentReferences;
+} | {
+    ok: false;
+    error: FragmentParseError;
+};
+/**
+ * Parse a fragment from a JSON string or an already-parsed value. Never throws.
+ *
+ * Permissive by design: components unknown to the receiving registry and
+ * bindings the target cannot resolve still parse — the result's `references`
+ * enumerate every component/binding/asset the fragment points at so the
+ * consumer can diff them against its registry and raise its own issues.
+ */
+export declare function parseFragment(input: string | unknown): ParseFragmentResult;

package/dist/clipboard/serialize.js

@@ -0,0 +1,130 @@
+import { CLIPBOARD_FRAGMENT_FORMAT, CLIPBOARD_FRAGMENT_VERSION, clipboardFragmentSchema } from './fragment';
+import { collectFragmentReferences } from './references';
+/**
+ * Fragment serialization, following `@elytracms/core/project-graph`'s conventions:
+ * parse-before-serialize (the output contains no runtime-only values) and a
+ * never-throw parse. On top of that, serialization is *canonical* — object keys
+ * are sorted recursively — so build → serialize → parse → serialize is
+ * byte-identical regardless of property insertion order. Canonical bytes are
+ * what goes onto the OS clipboard (and into the HTML fallback's data
+ * attribute), so two copies of the same subtree are comparable as strings.
+ */
+/**
+ * Deterministic JSON: arrays in order, object keys sorted recursively,
+ * `undefined` object values dropped (matching `JSON.stringify`).
+ */
+export function canonicalJsonStringify(value) {
+    return canonicalize(value) ?? 'null';
+}
+function canonicalize(value) {
+    if (value === null)
+        return 'null';
+    switch (typeof value) {
+        case 'string':
+        case 'number':
+        case 'boolean':
+            return JSON.stringify(value);
+        case 'object': {
+            if (Array.isArray(value)) {
+                // JSON.stringify renders un-serializable array items as null — match it.
+                return `[${value.map((item) => canonicalize(item) ?? 'null').join(',')}]`;
+            }
+            const entries = Object.entries(value)
+                .map(([key, item]) => [key, canonicalize(item)])
+                .filter((entry) => entry[1] !== undefined)
+                .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+                .map(([key, item]) => `${JSON.stringify(key)}:${item}`);
+            return `{${entries.join(',')}}`;
+        }
+        default:
+            // undefined / function / symbol — not representable, dropped by the caller.
+            return undefined;
+    }
+}
+/**
+ * Serialize a fragment to canonical JSON. Parsing first guarantees the output
+ * is exactly the spec'd envelope (programmer error in the input throws — this
+ * is the trusted, in-process direction; `parseFragment` owns untrusted input).
+ */
+export function serializeFragment(fragment) {
+    const parsed = clipboardFragmentSchema.parse(fragment);
+    return canonicalJsonStringify(parsed);
+}
+/**
+ * Parse a fragment from a JSON string or an already-parsed value. Never throws.
+ *
+ * Permissive by design: components unknown to the receiving registry and
+ * bindings the target cannot resolve still parse — the result's `references`
+ * enumerate every component/binding/asset the fragment points at so the
+ * consumer can diff them against its registry and raise its own issues.
+ */
+export function parseFragment(input) {
+    let json;
+    if (typeof input === 'string') {
+        try {
+            json = JSON.parse(input);
+        }
+        catch (cause) {
+            const detail = cause instanceof Error ? cause.message : String(cause);
+            return {
+                ok: false,
+                error: { code: 'corrupt-json', message: `Clipboard content is not valid JSON: ${detail}` },
+            };
+        }
+    }
+    else {
+        json = input;
+    }
+    if (typeof json !== 'object' || json === null || Array.isArray(json)) {
+        return {
+            ok: false,
+            error: {
+                code: 'foreign-format',
+                message: 'Clipboard content is not an Elytra fragment envelope.',
+            },
+        };
+    }
+    const probe = json;
+    if (probe.format !== CLIPBOARD_FRAGMENT_FORMAT) {
+        return {
+            ok: false,
+            error: {
+                code: 'foreign-format',
+                message: `Clipboard content is not an Elytra fragment (expected format "${CLIPBOARD_FRAGMENT_FORMAT}").`,
+                ...(typeof probe.format === 'string' ? { format: probe.format } : {}),
+            },
+        };
+    }
+    if (typeof probe.version === 'number' && probe.version !== CLIPBOARD_FRAGMENT_VERSION) {
+        return {
+            ok: false,
+            error: {
+                code: 'unsupported-version',
+                message: probe.version > CLIPBOARD_FRAGMENT_VERSION
+                    ? `Fragment version ${probe.version} is newer than this studio supports (version ${CLIPBOARD_FRAGMENT_VERSION}).`
+                    : `Fragment version ${probe.version} is not supported (this studio reads version ${CLIPBOARD_FRAGMENT_VERSION}).`,
+                version: probe.version,
+            },
+        };
+    }
+    const result = clipboardFragmentSchema.safeParse(json);
+    if (!result.success) {
+        return {
+            ok: false,
+            error: {
+                code: 'invalid-payload',
+                message: 'Clipboard fragment violates the fragment schema.',
+                issues: result.error.issues.map((issue) => ({
+                    path: issue.path.map(String).join('/'),
+                    message: issue.message,
+                })),
+            },
+        };
+    }
+    return {
+        ok: true,
+        fragment: result.data,
+        references: collectFragmentReferences(result.data),
+    };
+}
+//# sourceMappingURL=serialize.js.map

package/dist/clipboard/serialize.js.map

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

package/dist/cms-core/collections.d.ts

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+import type { FieldDef } from './fields';
+import type { CmsValidationIssue } from './issues';
+/**
+ * The kind of a collection (brief §7.4).
+ * - `document`  ordinary content collection (posts, pages, authors…).
+ * - `asset`     the asset collection concept: holds uploaded media/files that
+ *               `asset` fields point at (EC-017).
+ */
+export declare const collectionKindSchema: z.ZodEnum<{
+    asset: "asset";
+    document: "document";
+}>;
+export type CollectionKind = z.infer<typeof collectionKindSchema>;
+/** Form metadata at the collection level (labels, ordering of groups/tabs). */
+export declare const collectionFormMetaSchema: z.ZodObject<{
+    label: z.ZodOptional<z.ZodString>;
+    labelSingular: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    tabs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type CollectionFormMeta = z.infer<typeof collectionFormMetaSchema>;
+/**
+ * A collection definition: an id, a kind, an ordered list of fields, and
+ * optional form metadata. The field whose value identifies a document for
+ * routing/display defaults to `title` when present (see `titleFieldOf`).
+ */
+export declare const collectionDefSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodDefault<z.ZodEnum<{
+        asset: "asset";
+        document: "document";
+    }>>;
+    fields: z.ZodDefault<z.ZodArray<z.ZodType<FieldDef, unknown, z.core.$ZodTypeInternals<FieldDef, unknown>>>>;
+    form: z.ZodOptional<z.ZodObject<{
+        label: z.ZodOptional<z.ZodString>;
+        labelSingular: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        groups: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        tabs: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    localized: z.ZodOptional<z.ZodBoolean>;
+    titleField: z.ZodOptional<z.ZodString>;
+    singleton: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type CollectionDef = z.infer<typeof collectionDefSchema>;
+/** Look up a field by name within a collection. */
+export declare function fieldOf(collection: CollectionDef, name: string): FieldDef | undefined;
+/** The field used as the display title, if resolvable. */
+export declare function titleFieldOf(collection: CollectionDef): FieldDef | undefined;
+/**
+ * Is this a singleton collection — one fixed document, no list view (EC-217)?
+ * A singleton `asset` collection is a config error (asset collections are
+ * inherently multi-document); we defensively treat it as a normal asset
+ * collection so routing never mis-branches, and the registry surfaces the
+ * misconfiguration as an `invalid-collection-config` issue.
+ */
+export declare function isSingleton(collection: CollectionDef): boolean;
+/**
+ * The fixed document id for a singleton collection (EC-217): the collection id
+ * itself, so the one document is predictable and addressable
+ * (`{ collection: 'settings', id: 'settings' }`) without a generated key.
+ */
+export declare function singletonDocId(collection: CollectionDef): string;
+/**
+ * A metadata registry of collections, keyed by id (brief §7.4 "metadata
+ * registries"). Construction validates structural invariants (duplicate
+ * collection/field ids) and surfaces them as structured issues rather than
+ * throwing — an invalid registry is still inspectable.
+ */
+export interface CollectionRegistry {
+    readonly collections: ReadonlyMap<string, CollectionDef>;
+    readonly issues: readonly CmsValidationIssue[];
+    get(id: string): CollectionDef | undefined;
+    has(id: string): boolean;
+    list(): CollectionDef[];
+    /** Asset-kind collections only (EC-017). */
+    assetCollections(): CollectionDef[];
+}
+/** Build a collection registry from definitions, collecting structural issues. */
+export declare function createCollectionRegistry(defs: readonly CollectionDef[]): CollectionRegistry;

package/dist/cms-core/collections.js

@@ -0,0 +1,187 @@
+import { z } from 'zod';
+import { RESERVED_NODE_KEYS } from './envelopes';
+import { fieldDefSchema } from './fields';
+import { cmsIssue } from './issues';
+/**
+ * The kind of a collection (brief §7.4).
+ * - `document`  ordinary content collection (posts, pages, authors…).
+ * - `asset`     the asset collection concept: holds uploaded media/files that
+ *               `asset` fields point at (EC-017).
+ */
+export const collectionKindSchema = z.enum(['document', 'asset']);
+/** Form metadata at the collection level (labels, ordering of groups/tabs). */
+export const collectionFormMetaSchema = z.object({
+    /** Plural human label, e.g. "Blog Posts". */
+    label: z.string().optional(),
+    /** Singular human label, e.g. "Blog Post". */
+    labelSingular: z.string().optional(),
+    description: z.string().optional(),
+    /** Declared ordering of form groups (fieldsets). */
+    groups: z.array(z.string()).optional(),
+    /** Declared ordering of form tabs. */
+    tabs: z.array(z.string()).optional(),
+});
+/**
+ * A collection definition: an id, a kind, an ordered list of fields, and
+ * optional form metadata. The field whose value identifies a document for
+ * routing/display defaults to `title` when present (see `titleFieldOf`).
+ */
+export const collectionDefSchema = z.object({
+    id: z.string().min(1),
+    kind: collectionKindSchema.default('document'),
+    fields: z.array(fieldDefSchema).default([]),
+    form: collectionFormMetaSchema.optional(),
+    /** When true, documents in this collection support localized variants (EC-018). */
+    localized: z.boolean().optional(),
+    /** Name of the field used as the document's display title (defaults to `title`). */
+    titleField: z.string().optional(),
+    /**
+     * When true, this collection holds exactly ONE fixed document — Settings,
+     * Menus, Footer, Homepage SEO… (EC-217). The studio skips the list view and
+     * opens the detail editor directly on the single document. Pure authoring
+     * sugar: internally identical to a `document` collection, so the engine,
+     * delivery, and validation paths are unchanged. Meaningless on an `asset`
+     * collection (flagged as `invalid-collection-config`).
+     */
+    singleton: z.boolean().optional(),
+});
+/** Look up a field by name within a collection. */
+export function fieldOf(collection, name) {
+    return collection.fields.find((f) => f.name === name);
+}
+/** The field used as the display title, if resolvable. */
+export function titleFieldOf(collection) {
+    const name = collection.titleField ?? 'title';
+    return fieldOf(collection, name);
+}
+/**
+ * Is this a singleton collection — one fixed document, no list view (EC-217)?
+ * A singleton `asset` collection is a config error (asset collections are
+ * inherently multi-document); we defensively treat it as a normal asset
+ * collection so routing never mis-branches, and the registry surfaces the
+ * misconfiguration as an `invalid-collection-config` issue.
+ */
+export function isSingleton(collection) {
+    return collection.singleton === true && collection.kind !== 'asset';
+}
+/**
+ * The fixed document id for a singleton collection (EC-217): the collection id
+ * itself, so the one document is predictable and addressable
+ * (`{ collection: 'settings', id: 'settings' }`) without a generated key.
+ */
+export function singletonDocId(collection) {
+    return collection.id;
+}
+/**
+ * Recursively validate a single field's shape (EC-253): select-option uniqueness,
+ * plus — for an `object` field — unique subfield names and the same checks applied
+ * recursively to its nested fields. Pure; collects structured issues, never throws.
+ */
+function validateFieldShape(field, fieldPath, collectionId, issues) {
+    // EC-277 (AD-15): `type` is reserved as the self-describing node discriminator, so
+    // a value object can never carry a user field that collides with it. The schema
+    // lens forbids declaring such a field — surfaced as a visible issue, never silent.
+    if (RESERVED_NODE_KEYS.has(field.name)) {
+        issues.push(cmsIssue({
+            code: 'reserved-field-name',
+            message: `Field name "${field.name}" is reserved (the self-describing node discriminator).`,
+            path: [...fieldPath, 'name'],
+            collectionId,
+            meta: { field: field.name },
+        }));
+    }
+    // select fields must declare at least one option (schema enforces min(1), but a
+    // select with duplicate option values is a config error we surface).
+    if (field.type === 'select') {
+        const values = new Set();
+        for (const opt of field.options) {
+            if (values.has(opt.value)) {
+                issues.push(cmsIssue({
+                    code: 'invalid-field-config',
+                    message: `Duplicate select option "${opt.value}" on field "${field.name}".`,
+                    path: [...fieldPath, 'options'],
+                    collectionId,
+                    meta: { field: field.name, option: opt.value },
+                }));
+            }
+            values.add(opt.value);
+        }
+    }
+    else if (field.type === 'object') {
+        const seen = new Set();
+        field.fields.forEach((sub, i) => {
+            if (seen.has(sub.name)) {
+                issues.push(cmsIssue({
+                    code: 'duplicate-field',
+                    message: `Duplicate field "${sub.name}" in object field "${field.name}".`,
+                    path: [...fieldPath, 'fields', i],
+                    collectionId,
+                    meta: { field: sub.name },
+                }));
+            }
+            else {
+                seen.add(sub.name);
+            }
+            validateFieldShape(sub, [...fieldPath, 'fields', i], collectionId, issues);
+        });
+    }
+}
+function validateCollectionShape(collection) {
+    const issues = [];
+    // EC-217: an asset collection is inherently multi-document — `singleton` is a
+    // nonsensical combination, surfaced rather than silently ignored.
+    if (collection.singleton === true && collection.kind === 'asset') {
+        issues.push(cmsIssue({
+            code: 'invalid-collection-config',
+            message: `Asset collection "${collection.id}" cannot be a singleton.`,
+            path: ['collections', collection.id],
+            collectionId: collection.id,
+        }));
+    }
+    const seenFields = new Set();
+    collection.fields.forEach((field, i) => {
+        if (seenFields.has(field.name)) {
+            issues.push(cmsIssue({
+                code: 'duplicate-field',
+                message: `Duplicate field "${field.name}" in collection "${collection.id}".`,
+                path: ['collections', collection.id, 'fields', i],
+                collectionId: collection.id,
+                meta: { field: field.name },
+            }));
+        }
+        else {
+            seenFields.add(field.name);
+        }
+        validateFieldShape(field, ['collections', collection.id, 'fields', i], collection.id, issues);
+    });
+    return issues;
+}
+/** Build a collection registry from definitions, collecting structural issues. */
+export function createCollectionRegistry(defs) {
+    const collections = new Map();
+    const issues = [];
+    for (const raw of defs) {
+        // Apply schema defaults (kind, fields) deterministically.
+        const def = collectionDefSchema.parse(raw);
+        if (collections.has(def.id)) {
+            issues.push(cmsIssue({
+                code: 'duplicate-collection',
+                message: `Duplicate collection id "${def.id}".`,
+                path: ['collections', def.id],
+                collectionId: def.id,
+            }));
+            continue;
+        }
+        collections.set(def.id, def);
+        issues.push(...validateCollectionShape(def));
+    }
+    return {
+        collections,
+        issues,
+        get: (id) => collections.get(id),
+        has: (id) => collections.has(id),
+        list: () => [...collections.values()],
+        assetCollections: () => [...collections.values()].filter((c) => c.kind === 'asset'),
+    };
+}
+//# sourceMappingURL=collections.js.map

package/dist/cms-core/collections.js.map

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

package/dist/cms-core/documents.d.ts

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+/**
+ * A locale code (BCP-47-ish, e.g. `en`, `en-US`, `de`). Kept as a plain
+ * non-empty string so unusual locales still parse; validity against a project's
+ * declared locale set is checked semantically (EC-018).
+ */
+export declare const localeSchema: z.ZodString;
+export type Locale = z.infer<typeof localeSchema>;
+/**
+ * A document identity (EC-017): the stable pointer to a piece of content. A
+ * document belongs to exactly one collection and has a stable id. For localized
+ * content the *identity* is collection+id; a specific localized variant is
+ * addressed by additionally carrying a locale (see `LocaleAwareDocumentRef`).
+ */
+export declare const documentRefSchema: z.ZodObject<{
+    collection: z.ZodString;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type DocumentRef = z.infer<typeof documentRefSchema>;
+/** A document identity together with a specific locale (EC-018). */
+export declare const localeAwareDocumentRefSchema: z.ZodObject<{
+    collection: z.ZodString;
+    id: z.ZodString;
+    locale: z.ZodString;
+}, z.core.$strip>;
+export type LocaleAwareDocumentRef = z.infer<typeof localeAwareDocumentRefSchema>;
+/** Stable string key for a document identity. */
+export declare function documentKey(ref: DocumentRef): string;
+/** Stable string key for a locale-aware document identity. */
+export declare function localeAwareDocumentKey(ref: LocaleAwareDocumentRef): string;
+/** Equality on document identity (collection + id), ignoring locale. */
+export declare function documentRefEquals(a: DocumentRef, b: DocumentRef): boolean;
+/**
+ * Target state of a publish/unpublish *action* (EC-021). No longer a stored
+ * document field (EC-224 retired it — publish-ness is the version pointer, see
+ * `publishedVersion`); this enum names the *intent* of a bulk publish/unpublish
+ * action (the studio's `applyState` contract), not a property a row carries.
+ */
+export declare const publicationStateSchema: z.ZodEnum<{
+    draft: "draft";
+    published: "published";
+}>;
+export type PublicationState = z.infer<typeof publicationStateSchema>;
+/**
+ * A bag of field values for a single (locale of a) document. Values are arbitrary
+ * JSON — validated against the collection's fields by `validateDocument`, not at
+ * this layer. Relations store `DocumentRef`(s); assets store asset ids.
+ */
+export type FieldValues = Record<string, unknown>;
+/**
+ * A stored document (EC-016/017/018). The live row is the continuous DRAFT
+ * (the Sanity model, EC-224). Holds:
+ * - identity (`collection` + `id`),
+ * - non-localized field values in `values`,
+ * - per-locale field values in `localized` (only for localized fields).
+ *
+ * Publish-ness is NOT a field here: a document is published when an append-only
+ * version is pinned via the record's `publishedVersion` pointer (EC-224). The
+ * delivery `published` perspective serves that pinned snapshot; this live row
+ * is always the working draft.
+ */
+export declare const documentSchema: z.ZodObject<{
+    collection: z.ZodString;
+    id: z.ZodString;
+    values: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    localized: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    defaultLocale: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CmsDocument = z.infer<typeof documentSchema>;
+/** The identity of a stored document. */
+export declare function refOf(doc: CmsDocument): DocumentRef;