@elytracms/core 0.0.6

package/dist/cms-core/hierarchy.js

@@ -0,0 +1,223 @@
+import { splitPath } from './routes';
+const DEFAULT_PARENT_FIELD = 'parent';
+const DEFAULT_SLUG_FIELD = 'slug';
+/** Resolve a {@link HierarchyConfig} to its concrete field names. */
+export function hierarchyFields(config = {}) {
+    return {
+        parentField: config.parentField ?? DEFAULT_PARENT_FIELD,
+        slugField: config.slugField ?? DEFAULT_SLUG_FIELD,
+    };
+}
+/**
+ * The self-relation field that names a document's parent, if this collection
+ * declares one: a single-valued `relation` field, named per the config, whose
+ * target is the collection itself.
+ */
+export function parentRelationField(collection, config = {}) {
+    const { parentField } = hierarchyFields(config);
+    const field = collection.fields.find((f) => f.name === parentField);
+    if (field &&
+        field.type === 'relation' &&
+        field.target === collection.id &&
+        field.cardinality === 'one') {
+        return field;
+    }
+    return undefined;
+}
+/** Does this collection model a parent/child hierarchy (a `parent` self-relation)? */
+export function isHierarchical(collection, config = {}) {
+    return parentRelationField(collection, config) !== undefined;
+}
+/** The parent document id from a `one` self-relation value (a `DocumentRef` or bare id). */
+function readParentId(doc, parentField) {
+    const value = doc.values[parentField];
+    if (value == null)
+        return undefined;
+    if (typeof value === 'string')
+        return value.length > 0 ? value : undefined;
+    if (typeof value === 'object' && 'id' in value) {
+        const id = value.id;
+        return typeof id === 'string' && id.length > 0 ? id : undefined;
+    }
+    return undefined;
+}
+/** The local slug segment of a document, or undefined when unset/empty. */
+function readSlug(doc, slugField) {
+    const value = doc.values[slugField];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+/**
+ * Compose a document's full path segments by walking its parent chain from the
+ * leaf up, then ordering root → leaf. Cycle-safe: revisiting a document stops
+ * the walk and flags `cycle`. `getById` looks documents up *within the same
+ * collection* (a self-relation never crosses collections).
+ */
+export function composePath(doc, getById, config = {}) {
+    const { parentField, slugField } = hierarchyFields(config);
+    const segments = [];
+    const seen = new Set([doc.id]);
+    let cycle = false;
+    let missingSlug = false;
+    let danglingParent = false;
+    let current = doc;
+    while (current) {
+        const slug = readSlug(current, slugField);
+        if (slug === undefined)
+            missingSlug = true;
+        else
+            segments.unshift(slug);
+        const parentId = readParentId(current, parentField);
+        if (parentId === undefined)
+            break;
+        const parent = getById(parentId);
+        if (!parent) {
+            danglingParent = true;
+            break;
+        }
+        if (seen.has(parent.id)) {
+            cycle = true;
+            break;
+        }
+        seen.add(parent.id);
+        current = parent;
+    }
+    return { segments, ok: !cycle && !missingSlug && !danglingParent, cycle, missingSlug, danglingParent };
+}
+/** Does a document's parent chain loop? (cycle-safe; uses {@link composePath}). */
+export function hasParentCycle(doc, getById, config = {}) {
+    return composePath(doc, getById, config).cycle;
+}
+/**
+ * Order documents as a depth-first hierarchy (parents immediately before their
+ * children, siblings in input order), annotating each with its depth. Roots are
+ * documents with no parent, or whose parent is absent (orphans surface at the
+ * root). Cycle-safe: documents trapped in a parent cycle are never lost — they
+ * are appended at depth 0 rather than recursed into. The read-side of the
+ * hierarchical list view (EC-218).
+ */
+export function orderHierarchically(docs, config = {}) {
+    const { parentField } = hierarchyFields(config);
+    const byId = new Map(docs.map((d) => [d.id, d]));
+    // Bucket each document under its effective parent key (null = a root).
+    const children = new Map();
+    for (const doc of docs) {
+        const parentId = readParentId(doc, parentField);
+        const key = parentId != null && parentId !== doc.id && byId.has(parentId) ? parentId : null;
+        const bucket = children.get(key);
+        if (bucket)
+            bucket.push(doc);
+        else
+            children.set(key, [doc]);
+    }
+    const rows = [];
+    const visited = new Set();
+    const walk = (parentKey, depth) => {
+        for (const doc of children.get(parentKey) ?? []) {
+            if (visited.has(doc.id))
+                continue;
+            visited.add(doc.id);
+            rows.push({ doc, depth, hasChildren: (children.get(doc.id)?.length ?? 0) > 0 });
+            walk(doc.id, depth + 1);
+        }
+    };
+    walk(null, 0);
+    // Any document not reached from a root is trapped in a cycle — surface it at
+    // the root so the list never silently drops a document. It may still have
+    // (cycle-trapped) children, so report hasChildren the same way the main walk does.
+    for (const doc of docs) {
+        if (!visited.has(doc.id)) {
+            visited.add(doc.id);
+            rows.push({ doc, depth: 0, hasChildren: (children.get(doc.id)?.length ?? 0) > 0 });
+        }
+    }
+    return rows;
+}
+/**
+ * The ids of every descendant of `rootId` (children, grandchildren, …). Used to
+ * keep a `parent` picker from offering a document its own subtree — which would
+ * create a cycle. Excludes `rootId` itself; cycle-safe.
+ */
+export function descendantIds(rootId, docs, config = {}) {
+    const { parentField } = hierarchyFields(config);
+    const children = new Map();
+    for (const doc of docs) {
+        const parentId = readParentId(doc, parentField);
+        if (parentId == null)
+            continue;
+        const bucket = children.get(parentId);
+        if (bucket)
+            bucket.push(doc);
+        else
+            children.set(parentId, [doc]);
+    }
+    const out = new Set();
+    const stack = [rootId];
+    while (stack.length > 0) {
+        const id = stack.pop();
+        for (const child of children.get(id) ?? []) {
+            if (child.id !== rootId && !out.has(child.id)) {
+                out.add(child.id);
+                stack.push(child.id);
+            }
+        }
+    }
+    return out;
+}
+/**
+ * Is this route a hierarchy mount? — its pattern ends with a catch-all param
+ * segment (`:name*`), declaring "this collection's documents are served by their
+ * composed nested paths under this prefix" (EC-218). The host pulls these out of
+ * the router and resolves them per-request with {@link resolveByPath}, so the
+ * URL→document mapping stays perspective-aware (draft vs published) and the path
+ * stays derived, never stored.
+ */
+export function isHierarchyTemplate(route) {
+    if (!route.document)
+        return false;
+    const segments = splitPath(route.pattern);
+    const last = segments[segments.length - 1];
+    return last !== undefined && last.startsWith(':') && last.endsWith('*');
+}
+/**
+ * Parse a hierarchy mount from a catch-all template route (EC-218), or undefined
+ * when the route is not a valid mount (not a catch-all, or its prefix contains a
+ * dynamic segment, which a composed-path mount does not support).
+ */
+export function hierarchyMount(route) {
+    if (!isHierarchyTemplate(route) || !route.document)
+        return undefined;
+    const prefix = splitPath(route.pattern).slice(0, -1);
+    if (prefix.some((segment) => segment.startsWith(':')))
+        return undefined;
+    return {
+        collection: route.document.collection,
+        prefix,
+        ...(route.locale ? { locale: route.locale } : {}),
+    };
+}
+/**
+ * Resolve a path (its slug segments, prefix already stripped) to the one document
+ * whose composed nested path matches (EC-218). The caller supplies the documents
+ * already selected for the active perspective (draft/published), so resolution is
+ * perspective-aware. Documents with a broken or cyclic chain never match.
+ * Deterministic on the rare duplicate composed path: the lowest id wins (the same
+ * tie-break the single-slug fallback uses).
+ */
+export function resolveByPath(segments, docs, config = {}) {
+    if (segments.length === 0)
+        return undefined;
+    const byId = new Map(docs.map((d) => [d.id, d]));
+    const getById = (id) => byId.get(id);
+    const target = segments.join('/');
+    let match;
+    for (const doc of docs) {
+        const composed = composePath(doc, getById, config);
+        if (!composed.ok)
+            continue;
+        if (composed.segments.join('/') === target && (!match || doc.id < match.id)) {
+            match = doc;
+        }
+    }
+    return match;
+}
+//# sourceMappingURL=hierarchy.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * @elytracms/cms-core — provider-neutral, schema-driven CMS primitives (brief §7.4).
+ *
+ * Collections & fields, relations & assets, localization, route/redirect
+ * resolution, conflict & loop detection, and draft/published + version history.
+ * Reuses canonical types from `@elytracms/core/project-graph` and mirrors its
+ * structured-issue conventions (brief §4.11): invalid states are explicit
+ * `CmsValidationIssue`s, never silent failures or crashes.
+ */
+export declare const PACKAGE = "@elytracms/core/cms-core";
+export * from './issues';
+export * from './fields';
+export * from './collections';
+export * from './documents';
+export * from './envelopes';
+export * from './self-type';
+export * from './localization';
+export * from './validate-document';
+export * from './infer';
+export * from './json-schema';
+export * from './routes';
+export * from './hierarchy';
+export * from './url-for-document';
+export * from './versions';
+export * from './fixtures';

package/dist/cms-core/index.js

@@ -0,0 +1,26 @@
+/**
+ * @elytracms/cms-core — provider-neutral, schema-driven CMS primitives (brief §7.4).
+ *
+ * Collections & fields, relations & assets, localization, route/redirect
+ * resolution, conflict & loop detection, and draft/published + version history.
+ * Reuses canonical types from `@elytracms/core/project-graph` and mirrors its
+ * structured-issue conventions (brief §4.11): invalid states are explicit
+ * `CmsValidationIssue`s, never silent failures or crashes.
+ */
+export const PACKAGE = '@elytracms/core/cms-core';
+export * from './issues';
+export * from './fields';
+export * from './collections';
+export * from './documents';
+export * from './envelopes';
+export * from './self-type';
+export * from './localization';
+export * from './validate-document';
+export * from './infer';
+export * from './json-schema';
+export * from './routes';
+export * from './hierarchy';
+export * from './url-for-document';
+export * from './versions';
+export * from './fixtures';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cms-core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,0BAA0B,CAAA;AAEjD,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,qBAAqB,CAAA;AACnC,cAAc,SAAS,CAAA;AACvB,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

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

@@ -0,0 +1,103 @@
+import type { CollectionDef } from './collections';
+import type { DocumentRef } from './documents';
+import type { FieldDef } from './fields';
+/**
+ * Map a single field definition to its inferred runtime TS type. Relations
+ * resolve to `DocumentRef`(s), assets to asset-id string(s), select to its
+ * option-value union, etc. (EC-016: "inferred TS types").
+ *
+ * This is a *type-level* mapping consumed via `InferDocument<C>`. Cardinality
+ * (`one` vs `many`) widens to an array.
+ */
+export type InferFieldValue<F extends FieldDef> = F extends {
+    type: 'text';
+} ? string : F extends {
+    type: 'richText';
+} ? string : F extends {
+    type: 'number';
+} ? number : F extends {
+    type: 'boolean';
+} ? boolean : F extends {
+    type: 'date';
+} ? string | number : F extends {
+    type: 'select';
+    options: infer O;
+    multiple: infer M;
+} ? O extends ReadonlyArray<{
+    value: infer V;
+}> ? M extends true ? V[] : V : string : F extends {
+    type: 'relation';
+    cardinality: infer C;
+} ? C extends 'many' ? DocumentRef[] : DocumentRef : F extends {
+    type: 'asset';
+    cardinality: infer AC;
+} ? AC extends 'many' ? string[] : string : F extends {
+    type: 'object';
+    cardinality: infer OC;
+} ? OC extends 'many' ? Record<string, unknown>[] : Record<string, unknown> : unknown;
+/** The union of all field definitions in a collection literal. */
+type FieldUnion<C extends {
+    fields: readonly FieldDef[];
+}> = C['fields'][number];
+/** Names of all fields. */
+type FieldNames<C extends {
+    fields: readonly FieldDef[];
+}> = FieldUnion<C> extends {
+    name: infer N extends string;
+} ? N : never;
+/** Names of required fields (validation.required === true). */
+type RequiredFieldNames<C extends {
+    fields: readonly FieldDef[];
+}> = Extract<FieldUnion<C>, {
+    validation: {
+        required: true;
+    };
+}> extends {
+    name: infer N extends string;
+} ? N : never;
+/** Names of optional fields (everything that isn't required). */
+type OptionalFieldNames<C extends {
+    fields: readonly FieldDef[];
+}> = Exclude<FieldNames<C>, RequiredFieldNames<C>>;
+/** The inferred value type of the field named `N` in collection `C`. */
+type ValueOfField<C extends {
+    fields: readonly FieldDef[];
+}, N extends string> = InferFieldValue<Extract<FieldUnion<C>, {
+    name: N;
+}>>;
+/**
+ * Infer the TS shape of a document for a collection literal (EC-016). Use with
+ * `as const` collection definitions to get a precise type:
+ *
+ * ```ts
+ * const post = { id: 'post', kind: 'document', fields: [...] } as const
+ * type Post = InferDocument<typeof post>
+ * ```
+ *
+ * Required fields are required; the rest are optional. The value of each field
+ * is correlated to that field by name (not positionally), so per-field types are
+ * preserved precisely.
+ */
+export type InferDocument<C extends {
+    fields: readonly FieldDef[];
+}> = {
+    [N in RequiredFieldNames<C>]: ValueOfField<C, N>;
+} & {
+    [N in OptionalFieldNames<C>]?: ValueOfField<C, N>;
+};
+/**
+ * A runtime descriptor of a field's inferred type — useful for codegen and
+ * tooling that can't consume the type-level `InferDocument` (EC-016).
+ */
+export interface InferredFieldType {
+    name: string;
+    /** TS type expression, e.g. `string`, `DocumentRef[]`, `'a' | 'b'`. */
+    tsType: string;
+    optional: boolean;
+    localized: boolean;
+}
+/** Produce a runtime descriptor of a field's inferred TS type. */
+export declare function inferredFieldType(field: FieldDef): InferredFieldType;
+/** Runtime descriptors for every field in a collection (EC-016). */
+export declare function inferCollectionTypes(collection: CollectionDef): InferredFieldType[];
+export {};

package/dist/cms-core/infer.js

@@ -0,0 +1,57 @@
+function selectUnion(field) {
+    const union = field.options.map((o) => JSON.stringify(o.value)).join(' | ');
+    return field.multiple ? `(${union})[]` : union;
+}
+/** Produce a runtime descriptor of a field's inferred TS type. */
+export function inferredFieldType(field) {
+    const optional = field.validation?.required !== true;
+    const localized = field.localized === true;
+    const base = () => {
+        switch (field.type) {
+            case 'text':
+            case 'richText':
+                return 'string';
+            case 'number':
+                return 'number';
+            case 'boolean':
+                return 'boolean';
+            case 'date':
+                return 'string | number';
+            case 'select':
+                return selectUnion(field);
+            case 'relation':
+                return field.cardinality === 'many' ? 'DocumentRef[]' : 'DocumentRef';
+            case 'asset':
+                return field.cardinality === 'many' ? 'string[]' : 'string';
+            case 'blocks':
+                // Composition value (EC-186): an opaque tree to delivery consumers — the
+                // host renders it through the canvas engine. EC-187/188 refine this to
+                // the composition value type once compositions live in documents.
+                return field.cardinality === 'many' ? 'unknown[]' : 'unknown';
+            case 'object': {
+                // EC-253: a precise nested object type expression (the repeater's item
+                // shape), `Array<...>` for `many`. Recurses for nested objects.
+                const shape = field.fields
+                    .map((sub) => {
+                    const st = inferredFieldType(sub);
+                    return `${sub.name}${st.optional ? '?' : ''}: ${st.tsType}`;
+                })
+                    .join('; ');
+                const objectType = field.fields.length > 0 ? `{ ${shape} }` : 'Record<string, unknown>';
+                return field.cardinality === 'many' ? `Array<${objectType}>` : objectType;
+            }
+            default: {
+                // Exhaustiveness: a new field type must add a case above (EC-253).
+                const _exhaustive = field;
+                void _exhaustive;
+                return 'unknown';
+            }
+        }
+    };
+    return { name: field.name, tsType: base(), optional, localized };
+}
+/** Runtime descriptors for every field in a collection (EC-016). */
+export function inferCollectionTypes(collection) {
+    return collection.fields.map(inferredFieldType);
+}
+//# sourceMappingURL=infer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"infer.js","sourceRoot":"","sources":["../../src/cms-core/infer.ts"],"names":[],"mappings":"AA0GA,SAAS,WAAW,CAAC,KAA4C;IAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC3E,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAA;AAChD,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,iBAAiB,CAAC,KAAe;IAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,UAAU,EAAE,QAAQ,KAAK,IAAI,CAAA;IACpD,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,KAAK,IAAI,CAAA;IAC1C,MAAM,IAAI,GAAG,GAAW,EAAE;QACxB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,MAAM,CAAC;YACZ,KAAK,UAAU;gBACb,OAAO,QAAQ,CAAA;YACjB,KAAK,QAAQ;gBACX,OAAO,QAAQ,CAAA;YACjB,KAAK,SAAS;gBACZ,OAAO,SAAS,CAAA;YAClB,KAAK,MAAM;gBACT,OAAO,iBAAiB,CAAA;YAC1B,KAAK,QAAQ;gBACX,OAAO,WAAW,CAAC,KAAK,CAAC,CAAA;YAC3B,KAAK,UAAU;gBACb,OAAO,KAAK,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,aAAa,CAAA;YACvE,KAAK,OAAO;gBACV,OAAO,KAAK,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAA;YAC7D,KAAK,QAAQ;gBACX,yEAAyE;gBACzE,uEAAuE;gBACvE,kEAAkE;gBAClE,OAAO,KAAK,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAA;YAC/D,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,uEAAuE;gBACvE,gEAAgE;gBAChE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM;qBACvB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;oBACX,MAAM,EAAE,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAA;oBACjC,OAAO,GAAG,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,CAAA;gBAC7D,CAAC,CAAC;qBACD,IAAI,CAAC,IAAI,CAAC,CAAA;gBACb,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,yBAAyB,CAAA;gBACvF,OAAO,KAAK,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,UAAU,GAAG,CAAC,CAAC,CAAC,UAAU,CAAA;YAC3E,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,mEAAmE;gBACnE,MAAM,WAAW,GAAU,KAAK,CAAA;gBAChC,KAAK,WAAW,CAAA;gBAChB,OAAO,SAAS,CAAA;YAClB,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAA;AAClE,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,oBAAoB,CAAC,UAAyB;IAC5D,OAAO,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;AACjD,CAAC"}

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

@@ -0,0 +1,92 @@
+import { z } from 'zod';
+/**
+ * Stable codes for structured CMS validation issues (brief §4.11, §7.4).
+ *
+ * We mirror the conventions of `@elytracms/core/project-graph`'s `ValidationIssue`
+ * (a structured object with `code`/`severity`/`message`/`path`, never a thrown
+ * error) so callers can treat graph and CMS issues uniformly. The code set here
+ * is CMS-specific; the shape is shared.
+ */
+export declare const cmsIssueCodeSchema: z.ZodEnum<{
+    "route-conflict": "route-conflict";
+    "duplicate-collection": "duplicate-collection";
+    "duplicate-field": "duplicate-field";
+    "unknown-collection": "unknown-collection";
+    "invalid-collection-config": "invalid-collection-config";
+    "invalid-field-config": "invalid-field-config";
+    "reserved-field-name": "reserved-field-name";
+    "missing-required-field": "missing-required-field";
+    "invalid-field-value": "invalid-field-value";
+    "unknown-relation-target": "unknown-relation-target";
+    "unpublished-relation-target": "unpublished-relation-target";
+    "cardinality-violation": "cardinality-violation";
+    "unknown-asset": "unknown-asset";
+    "duplicate-document": "duplicate-document";
+    "unknown-locale": "unknown-locale";
+    "missing-localized-value": "missing-localized-value";
+    "redirect-loop": "redirect-loop";
+    "unknown-route-target": "unknown-route-target";
+    "hierarchy-cycle": "hierarchy-cycle";
+    "unknown-version": "unknown-version";
+}>;
+export type CmsIssueCode = z.infer<typeof cmsIssueCodeSchema>;
+export declare const cmsIssueSeveritySchema: z.ZodEnum<{
+    error: "error";
+    warning: "warning";
+}>;
+export type CmsIssueSeverity = z.infer<typeof cmsIssueSeveritySchema>;
+/** A JSON-serializable scalar carried in issue metadata. */
+export type CmsIssueMetaValue = string | number | boolean | null | readonly (string | number)[];
+/**
+ * A structured CMS validation issue. Same conventions as
+ * `@elytracms/core/project-graph`'s `ValidationIssue`: a path locating the offending
+ * data, optional document/collection identity, and free-form metadata.
+ */
+export declare const cmsValidationIssueSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        "route-conflict": "route-conflict";
+        "duplicate-collection": "duplicate-collection";
+        "duplicate-field": "duplicate-field";
+        "unknown-collection": "unknown-collection";
+        "invalid-collection-config": "invalid-collection-config";
+        "invalid-field-config": "invalid-field-config";
+        "reserved-field-name": "reserved-field-name";
+        "missing-required-field": "missing-required-field";
+        "invalid-field-value": "invalid-field-value";
+        "unknown-relation-target": "unknown-relation-target";
+        "unpublished-relation-target": "unpublished-relation-target";
+        "cardinality-violation": "cardinality-violation";
+        "unknown-asset": "unknown-asset";
+        "duplicate-document": "duplicate-document";
+        "unknown-locale": "unknown-locale";
+        "missing-localized-value": "missing-localized-value";
+        "redirect-loop": "redirect-loop";
+        "unknown-route-target": "unknown-route-target";
+        "hierarchy-cycle": "hierarchy-cycle";
+        "unknown-version": "unknown-version";
+    }>;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>;
+    message: z.ZodString;
+    path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    collectionId: z.ZodOptional<z.ZodString>;
+    documentId: z.ZodOptional<z.ZodString>;
+    meta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type CmsValidationIssue = z.infer<typeof cmsValidationIssueSchema>;
+export type CmsPath = ReadonlyArray<string | number>;
+export interface CmsIssueInit {
+    code: CmsIssueCode;
+    severity?: CmsIssueSeverity;
+    message: string;
+    path: CmsPath;
+    collectionId?: string;
+    documentId?: string;
+    meta?: Record<string, unknown>;
+}
+/** Construct a structured CMS issue. `severity` defaults to `error`. */
+export declare function cmsIssue(init: CmsIssueInit): CmsValidationIssue;
+/** True if a set of CMS issues contains no error-severity entries. */
+export declare function isCmsValid(issues: readonly CmsValidationIssue[]): boolean;

package/dist/cms-core/issues.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+/**
+ * Stable codes for structured CMS validation issues (brief §4.11, §7.4).
+ *
+ * We mirror the conventions of `@elytracms/core/project-graph`'s `ValidationIssue`
+ * (a structured object with `code`/`severity`/`message`/`path`, never a thrown
+ * error) so callers can treat graph and CMS issues uniformly. The code set here
+ * is CMS-specific; the shape is shared.
+ */
+export const cmsIssueCodeSchema = z.enum([
+    // collections & fields (EC-016)
+    'duplicate-collection',
+    'duplicate-field',
+    'unknown-collection',
+    'invalid-collection-config',
+    'invalid-field-config',
+    // self-describing data (EC-277): a field name collides with a reserved node key
+    'reserved-field-name',
+    'missing-required-field',
+    'invalid-field-value',
+    // relations & assets (EC-017)
+    'unknown-relation-target',
+    // broken published references after a weak unpublish (EC-173)
+    'unpublished-relation-target',
+    'cardinality-violation',
+    'unknown-asset',
+    'duplicate-document',
+    // localization (EC-018)
+    'unknown-locale',
+    'missing-localized-value',
+    // routes / redirects / resolution (EC-019, EC-020)
+    'route-conflict',
+    'redirect-loop',
+    'unknown-route-target',
+    // page hierarchy (EC-218): a parent chain that loops
+    'hierarchy-cycle',
+    // versions (EC-021)
+    'unknown-version',
+]);
+export const cmsIssueSeveritySchema = z.enum(['error', 'warning']);
+/**
+ * A structured CMS validation issue. Same conventions as
+ * `@elytracms/core/project-graph`'s `ValidationIssue`: a path locating the offending
+ * data, optional document/collection identity, and free-form metadata.
+ */
+export const cmsValidationIssueSchema = z.object({
+    code: cmsIssueCodeSchema,
+    severity: cmsIssueSeveritySchema,
+    message: z.string(),
+    /** Path into the CMS data, e.g. ['collections', 'post', 'fields', 'author']. */
+    path: z.array(z.union([z.string(), z.number()])),
+    /** The offending collection id, when applicable. */
+    collectionId: z.string().optional(),
+    /** The offending document id, when applicable. */
+    documentId: z.string().optional(),
+    meta: z.record(z.string(), z.unknown()).optional(),
+});
+/** Construct a structured CMS issue. `severity` defaults to `error`. */
+export function cmsIssue(init) {
+    return {
+        code: init.code,
+        severity: init.severity ?? 'error',
+        message: init.message,
+        path: [...init.path],
+        ...(init.collectionId ? { collectionId: init.collectionId } : {}),
+        ...(init.documentId ? { documentId: init.documentId } : {}),
+        ...(init.meta ? { meta: init.meta } : {}),
+    };
+}
+/** True if a set of CMS issues contains no error-severity entries. */
+export function isCmsValid(issues) {
+    return !issues.some((i) => i.severity === 'error');
+}
+//# sourceMappingURL=issues.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../src/cms-core/issues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,gCAAgC;IAChC,sBAAsB;IACtB,iBAAiB;IACjB,oBAAoB;IACpB,2BAA2B;IAC3B,sBAAsB;IACtB,gFAAgF;IAChF,qBAAqB;IACrB,wBAAwB;IACxB,qBAAqB;IACrB,8BAA8B;IAC9B,yBAAyB;IACzB,8DAA8D;IAC9D,6BAA6B;IAC7B,uBAAuB;IACvB,eAAe;IACf,oBAAoB;IACpB,wBAAwB;IACxB,gBAAgB;IAChB,yBAAyB;IACzB,mDAAmD;IACnD,gBAAgB;IAChB,eAAe;IACf,sBAAsB;IACtB,qDAAqD;IACrD,iBAAiB;IACjB,oBAAoB;IACpB,iBAAiB;CAClB,CAAC,CAAA;AAGF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;AAMlE;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,sBAAsB;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,gFAAgF;IAChF,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAChD,oDAAoD;IACpD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,kDAAkD;IAClD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAA;AAeF,wEAAwE;AACxE,MAAM,UAAU,QAAQ,CAAC,IAAkB;IACzC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,OAAO;QAClC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;QACpB,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAA;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,UAAU,CAAC,MAAqC;IAC9D,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAA;AACpD,CAAC"}

package/dist/cms-core/json-schema.d.ts

@@ -0,0 +1,25 @@
+import type { JsonValue } from '@elytracms/core/project-graph';
+import type { CollectionDef } from './collections';
+/**
+ * A JSON Schema document (draft 2020-12 subset) represented with the canonical
+ * `JsonValue` type from `@elytracms/core/project-graph` so it stays serialization-safe.
+ */
+export type JsonSchema = {
+    [key: string]: JsonValue;
+};
+export interface JsonSchemaOptions {
+    /**
+     * For localized fields, emit `{ [locale]: <value-schema> }` objects when a
+     * locale set is supplied; otherwise localized fields are emitted as their bare
+     * value schema (the document's default-locale value).
+     */
+    locales?: readonly string[];
+    /** $id for the schema; defaults to a urn derived from the collection id. */
+    $id?: string;
+}
+/**
+ * Produce a JSON Schema for a collection's document shape (EC-016). Required
+ * fields populate `required`; declared validation metadata maps to standard
+ * JSON Schema keywords. Localized fields can be wrapped in a per-locale object.
+ */
+export declare function collectionJsonSchema(collection: CollectionDef, options?: JsonSchemaOptions): JsonSchema;