@elytracms/core 0.0.6

package/dist/cms-core/self-type.js

@@ -0,0 +1,191 @@
+import { assetNode, isAssetNode, isReferenceNode, referenceNode } from './envelopes';
+// --- Rich-text internal-link conventions (the conversion/migration home) -----------
+/**
+ * The legacy fuzzy href prefixes (EC-025) self-typing REPLACES. Internal links used
+ * to encode their target in the `href` string; EC-277 carries it as a structured
+ * `attrs.ref` envelope instead, leaving `href` for external URLs only. These
+ * constants live here because this lens is the one place that still READS them — to
+ * migrate them away.
+ */
+const RICH_TEXT_DOCUMENT_HREF_PREFIX = 'elytra:document/';
+const RICH_TEXT_ASSET_HREF_PREFIX = 'elytra:asset/';
+function isPlainRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function selfTypeRelationValue(value) {
+    if (isReferenceNode(value))
+        return value;
+    if (isPlainRecord(value) &&
+        typeof value.collection === 'string' &&
+        typeof value.id === 'string') {
+        return referenceNode({ collection: value.collection, id: value.id });
+    }
+    return value;
+}
+function selfTypeAssetValue(value) {
+    if (isAssetNode(value))
+        return value;
+    if (typeof value === 'string' && value.length > 0)
+        return assetNode(value);
+    return value;
+}
+// --- Composition (blocks) -----------------------------------------------------------
+/** Self-type one composition node's static props (via the manifest) + recurse slots. */
+function selfTypeComponentNode(node, options) {
+    const next = { ...node };
+    const propDefs = options.lookupManifest?.(node.componentId);
+    if (node.props && propDefs) {
+        const props = {};
+        for (const [name, prop] of Object.entries(node.props)) {
+            const def = propDefs[name];
+            // Only STATIC props carry self-typed values; bindings are parked (EC-187).
+            props[name] =
+                prop.kind === 'static' && def
+                    ? { kind: 'static', value: selfTypeFieldValue(def, prop.value, options) }
+                    : prop;
+        }
+        next.props = props;
+    }
+    if (node.slots) {
+        next.slots = Object.fromEntries(Object.entries(node.slots).map(([slot, children]) => [
+            slot,
+            children.map((child) => selfTypeComponentNode(child, options)),
+        ]));
+    }
+    return next;
+}
+function selfTypeBlocksValue(value, options) {
+    if (Array.isArray(value))
+        return value.map((root) => selfTypeBlocksValue(root, options));
+    if (isComponentNodeShape(value))
+        return selfTypeComponentNode(value, options);
+    return value;
+}
+function isComponentNodeShape(value) {
+    return isPlainRecord(value) && typeof value.id === 'string' && typeof value.componentId === 'string';
+}
+// --- Rich text ----------------------------------------------------------------------
+/** Convert a legacy internal `elytra:` href to a self-typed `ref` envelope (or undefined). */
+function refFromLegacyHref(href) {
+    if (href.startsWith(RICH_TEXT_DOCUMENT_HREF_PREFIX)) {
+        const [collection, id] = href.slice(RICH_TEXT_DOCUMENT_HREF_PREFIX.length).split('/');
+        if (collection && id)
+            return referenceNode({ collection, id });
+    }
+    else if (href.startsWith(RICH_TEXT_ASSET_HREF_PREFIX)) {
+        const id = href.slice(RICH_TEXT_ASSET_HREF_PREFIX.length);
+        if (id)
+            return assetNode(id);
+    }
+    return undefined;
+}
+/** Self-type a rich-text attrs bag: legacy href / docRef / assetId → structured `ref`. */
+function selfTypeRichTextAttrs(attrs) {
+    if (isReferenceNode(attrs.ref) || isAssetNode(attrs.ref))
+        return attrs; // already self-typed
+    const next = { ...attrs };
+    if (typeof attrs.href === 'string') {
+        const ref = refFromLegacyHref(attrs.href);
+        if (ref) {
+            next.ref = ref;
+            delete next.href; // internal link: target now lives in `ref`, not the href string
+        }
+    }
+    if (isPlainRecord(attrs.docRef) && typeof attrs.docRef.collection === 'string' && typeof attrs.docRef.id === 'string') {
+        next.ref = referenceNode({ collection: attrs.docRef.collection, id: attrs.docRef.id });
+        delete next.docRef;
+    }
+    else if (typeof attrs.assetId === 'string' && attrs.assetId.length > 0) {
+        next.ref = assetNode(attrs.assetId);
+        delete next.assetId;
+    }
+    return next;
+}
+function selfTypeRichTextNode(node, options) {
+    if (!isPlainRecord(node))
+        return node;
+    const next = { ...node };
+    if (isPlainRecord(node.attrs)) {
+        let attrs = selfTypeRichTextAttrs(node.attrs);
+        // EC-189: a `componentEmbed` node nests a ComponentNode under `attrs.node`.
+        if (isComponentNodeShape(attrs.node)) {
+            attrs = { ...attrs, node: selfTypeComponentNode(attrs.node, options) };
+        }
+        next.attrs = attrs;
+    }
+    if (Array.isArray(node.marks)) {
+        next.marks = node.marks.map((mark) => isPlainRecord(mark) && isPlainRecord(mark.attrs)
+            ? { ...mark, attrs: selfTypeRichTextAttrs(mark.attrs) }
+            : mark);
+    }
+    if (Array.isArray(node.content)) {
+        next.content = node.content.map((child) => selfTypeRichTextNode(child, options));
+    }
+    return next;
+}
+function selfTypeRichTextValue(value, options) {
+    if (!isPlainRecord(value) || !isPlainRecord(value.doc) || value.doc.type !== 'doc')
+        return value;
+    return { ...value, doc: selfTypeRichTextNode(value.doc, options) };
+}
+// --- Field / document entry points --------------------------------------------------
+/** Self-type one field value through the lens of its field-def. Idempotent. */
+export function selfTypeFieldValue(field, value, options = {}) {
+    if (value === undefined || value === null)
+        return value;
+    switch (field.type) {
+        case 'relation':
+            return Array.isArray(value) ? value.map(selfTypeRelationValue) : selfTypeRelationValue(value);
+        case 'asset':
+            return Array.isArray(value) ? value.map(selfTypeAssetValue) : selfTypeAssetValue(value);
+        case 'blocks':
+            return selfTypeBlocksValue(value, options);
+        case 'richText':
+            return selfTypeRichTextValue(value, options);
+        case 'object': {
+            const one = (item) => {
+                if (!isPlainRecord(item))
+                    return item;
+                const next = { ...item };
+                for (const sub of field.fields) {
+                    if (sub.name in next)
+                        next[sub.name] = selfTypeFieldValue(sub, next[sub.name], options);
+                }
+                return next;
+            };
+            return field.cardinality === 'many' && Array.isArray(value) ? value.map(one) : one(value);
+        }
+        default:
+            // text/number/boolean/date/select carry no references.
+            return value;
+    }
+}
+/** Self-type a bag of field values through a collection's field-defs. */
+function selfTypeValues(fields, values, options) {
+    const next = { ...values };
+    for (const field of fields) {
+        if (field.name in next)
+            next[field.name] = selfTypeFieldValue(field, next[field.name], options);
+    }
+    return next;
+}
+/**
+ * Self-type a whole document (its `values` and every `localized` locale) through the
+ * collection schema. Returns a new document; the input is not mutated. A document
+ * whose collection is absent from the schema is returned unchanged (drift-tolerant —
+ * AD-14: the store never blocks on schema divergence).
+ */
+export function selfTypeDocument(document, collection, options = {}) {
+    const next = {
+        ...document,
+        values: selfTypeValues(collection.fields, document.values ?? {}, options),
+    };
+    if (document.localized) {
+        next.localized = Object.fromEntries(Object.entries(document.localized).map(([locale, values]) => [
+            locale,
+            selfTypeValues(collection.fields, values, options),
+        ]));
+    }
+    return next;
+}
+//# sourceMappingURL=self-type.js.map

package/dist/cms-core/self-type.js.map

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

package/dist/cms-core/url-for-document.d.ts

@@ -0,0 +1,39 @@
+import type { CollectionDef } from './collections';
+import type { CmsDocument } from './documents';
+import type { LocaleConfig } from './localization';
+import type { HierarchyConfig } from './hierarchy';
+import type { RouteRecord } from './routes';
+export interface DocumentUrlConfig {
+    /** The project's route records (config-sourced, EC-207). */
+    routes: readonly RouteRecord[];
+    /** Public base URL (EC-215). When set, the result carries an absolute `href`. */
+    frontendUrl?: string;
+    /** Locale config — enables locale prefixing + localized slug resolution. */
+    localeConfig?: LocaleConfig;
+    /** Hierarchy field names (EC-218); defaults to `parent`/`slug`. */
+    hierarchy?: HierarchyConfig;
+}
+export interface DocumentUrl {
+    /** The resolved path, always starting with `/` (locale prefix applied). */
+    path: string;
+    /** Absolute URL — present only when `frontendUrl` was provided. */
+    href?: string;
+    /** The route record that addresses the document. */
+    route: RouteRecord;
+}
+export interface UrlForDocumentContext {
+    /**
+     * Sibling documents in the same collection — required to compose a nested
+     * (hierarchy-mount) path from the parent chain. Defaults to `[doc]`.
+     */
+    siblings?: readonly CmsDocument[];
+    /** Locale to build the URL for; defaults to `localeConfig.default`. */
+    locale?: string;
+}
+/**
+ * Derive a document's public URL from the project's routes (EC-216), or
+ * `undefined` when no route addresses it (a non-routable collection, or a
+ * hierarchy page with no slug / a broken parent chain). Pure: the URL is always
+ * derived, never read from a stored field.
+ */
+export declare function urlForDocument(config: DocumentUrlConfig, collection: CollectionDef, doc: CmsDocument, context?: UrlForDocumentContext): DocumentUrl | undefined;

package/dist/cms-core/url-for-document.js

@@ -0,0 +1,138 @@
+import { resolveField } from './localization';
+import { composePath, hierarchyMount, isHierarchyTemplate } from './hierarchy';
+import { splitPath } from './routes';
+/**
+ * Documents know their URL (EC-216). The inverse of route resolution: given a
+ * document and the project's config-sourced routes (EC-207), DERIVE its public
+ * URL — never store it (AD-11). This mirrors delivery's forward resolution
+ * (`@elytracms/core/content`) exactly so the URL a document advertises is the one the
+ * live site serves:
+ *
+ * - A literal-id route (`/about` → `page:about`) addresses only its one document.
+ * - A template route (`/blog/:slug` → `post::slug`) is filled from the document's
+ *   `slug` field, falling back to its id — the inverse of delivery's
+ *   `lookup.document(id) ?? findBySlug(slug)`.
+ * - A hierarchy mount (`/:path*`, EC-218) composes the full nested path from the
+ *   parent chain, so renaming a parent re-derives every descendant's URL.
+ *
+ * The locale prefix follows the host's own convention (`splitLocalePath` in
+ * `@elytracms/next`): the default locale serves at the root, other locales are
+ * `/{locale}`-prefixed. Patterns are locale-agnostic; the prefix is applied here.
+ *
+ * Perspective: the URL is derived from the documents you pass in. In the studio
+ * those are the DRAFT rows, so a published document whose `slug` (or a parent's)
+ * was edited but not yet re-published advertises its *pending* URL — the one that
+ * goes live on the next publish. For the common case (slug unchanged since
+ * publish) this equals the live URL; the studio publish-gates the "open live"
+ * action so an unpublished document never links anywhere.
+ */
+const SLUG_FIELD = 'slug';
+/** The document's `slug` field value (locale-resolved when possible), or undefined. */
+function readSlugValue(doc, collection, locale, localeConfig) {
+    if (!collection.fields.some((f) => f.name === SLUG_FIELD))
+        return undefined;
+    const raw = localeConfig && locale !== undefined
+        ? resolveField(collection, doc, SLUG_FIELD, locale, localeConfig).value
+        : doc.values[SLUG_FIELD];
+    return typeof raw === 'string' && raw.length > 0 ? raw : undefined;
+}
+/** Build the (locale-agnostic) path a single route would serve for `doc`, or undefined. */
+function pathForRoute(route, doc, collection, locale, localeConfig, getById, hierarchy) {
+    const target = route.document;
+    if (!target || target.collection !== collection.id)
+        return undefined;
+    // Hierarchy mount (EC-218): the path is the composed nested chain.
+    if (isHierarchyTemplate(route)) {
+        const mount = hierarchyMount(route);
+        if (!mount)
+            return undefined;
+        const composed = composePath(doc, getById, hierarchy);
+        if (!composed.ok)
+            return undefined;
+        return '/' + [...mount.prefix, ...composed.segments].join('/');
+    }
+    const idParam = target.id.startsWith(':') ? target.id.slice(1) : null;
+    // A literal-id route addresses only its one bound document.
+    if (idParam === null && target.id !== doc.id)
+        return undefined;
+    // The doc-id param resolves to the slug field, else the id. Delivery is
+    // id-FIRST (`lookup.document(id) ?? findBySlug(slug)`), so if this document's
+    // slug equals a DIFFERENT sibling's id, emitting the slug would round-trip to
+    // that other document — fall back to this doc's id to stay correct. (Detectable
+    // only when siblings are supplied; the bare-helper default cannot see them.)
+    const slugValue = readSlugValue(doc, collection, locale, localeConfig);
+    const collides = slugValue !== undefined && slugValue !== doc.id && getById(slugValue) !== undefined;
+    const identValue = slugValue !== undefined && !collides ? slugValue : doc.id;
+    const segments = [];
+    for (const seg of splitPath(route.pattern)) {
+        if (!seg.startsWith(':')) {
+            segments.push(seg);
+            continue;
+        }
+        const name = seg.replace(/[*+?]$/, '').slice(1);
+        if (idParam !== null && name === idParam) {
+            segments.push(encodeURIComponent(identValue));
+            continue;
+        }
+        // Any other pattern param is filled from the document's same-named field.
+        const value = doc.values[name];
+        if (typeof value !== 'string' || value.length === 0)
+            return undefined;
+        segments.push(encodeURIComponent(value));
+    }
+    return '/' + segments.join('/');
+}
+/**
+ * Rank addressing routes so the most specific wins, mirroring the router's
+ * precedence: an exact locale match, then an explicit route over the catch-all
+ * mount, then more static segments / fewer params.
+ */
+function routeRank(route, locale) {
+    let score = 0;
+    if (route.locale !== undefined && route.locale === locale)
+        score += 1000;
+    if (!isHierarchyTemplate(route))
+        score += 100;
+    const segs = splitPath(route.pattern);
+    const statics = segs.filter((s) => !s.startsWith(':')).length;
+    score += statics * 10 - (segs.length - statics);
+    return score;
+}
+/** Apply the host's locale-prefix convention: default at root, others `/{locale}`. */
+function applyLocalePrefix(path, locale, config) {
+    if (!config || locale === undefined || locale === config.default)
+        return path;
+    return path === '/' ? `/${locale}` : `/${locale}${path}`;
+}
+/**
+ * Derive a document's public URL from the project's routes (EC-216), or
+ * `undefined` when no route addresses it (a non-routable collection, or a
+ * hierarchy page with no slug / a broken parent chain). Pure: the URL is always
+ * derived, never read from a stored field.
+ */
+export function urlForDocument(config, collection, doc, context = {}) {
+    const locale = context.locale ?? config.localeConfig?.default;
+    const byId = new Map((context.siblings ?? [doc]).map((d) => [d.id, d]));
+    byId.set(doc.id, doc); // the document itself is always resolvable
+    const getById = (id) => byId.get(id);
+    let best;
+    for (const route of config.routes) {
+        // A locale-specific route serving a different locale cannot address this URL.
+        if (route.locale !== undefined && locale !== undefined && route.locale !== locale)
+            continue;
+        const path = pathForRoute(route, doc, collection, locale, config.localeConfig, getById, config.hierarchy);
+        if (path === undefined)
+            continue;
+        const rank = routeRank(route, locale);
+        // Deterministic tie-break on equal rank: the lower route id wins.
+        if (!best || rank > best.rank || (rank === best.rank && route.id < best.route.id)) {
+            best = { route, path, rank };
+        }
+    }
+    if (!best)
+        return undefined;
+    const path = applyLocalePrefix(best.path, locale, config.localeConfig);
+    const href = config.frontendUrl !== undefined ? config.frontendUrl.replace(/\/+$/, '') + path : undefined;
+    return { path, ...(href !== undefined ? { href } : {}), route: best.route };
+}
+//# sourceMappingURL=url-for-document.js.map

package/dist/cms-core/url-for-document.js.map

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

package/dist/cms-core/validate-document.d.ts

@@ -0,0 +1,121 @@
+import type { CollectionRegistry } from './collections';
+import type { BlocksFieldDef, FieldDef, RichTextFieldDef } from './fields';
+import type { CmsDocument, DocumentRef, FieldValues } from './documents';
+import type { LocaleConfig } from './localization';
+import type { CmsValidationIssue } from './issues';
+/** Index of documents by identity, used to validate relation/asset targets. */
+export interface DocumentStore {
+    has(ref: DocumentRef): boolean;
+    get(ref: DocumentRef): CmsDocument | undefined;
+}
+/** Build a `DocumentStore` from a flat list of documents. */
+export declare function createDocumentStore(docs: readonly CmsDocument[]): DocumentStore & {
+    list(): CmsDocument[];
+    issues: readonly CmsValidationIssue[];
+};
+/**
+ * A composition-validation finding, returned by the injected `validateComposition`
+ * callback (EC-188). cms-core stays free of `@elytracms/core/project-graph`: the studio
+ * wires the callback to `validateCompositionValue` + the component registry and
+ * returns these plain findings, which cms-core wraps into `CmsValidationIssue`s
+ * keyed on the field (so they surface inline like every other field issue).
+ */
+export interface CompositionIssue {
+    message: string;
+    severity?: 'error' | 'warning';
+    /** Slash-joined node path within the composition tree, for richer surfacing. */
+    nodePath?: string;
+}
+export interface ValidateDocumentOptions {
+    /** When provided, relation/asset targets are checked for existence (EC-017). */
+    store?: DocumentStore;
+    /** When provided, localized required fields are checked across all locales (EC-018). */
+    localeConfig?: LocaleConfig;
+    /**
+     * When provided, `blocks` composition field values are validated (EC-188).
+     * Injected so cms-core does not depend on `@elytracms/core/project-graph`; the studio
+     * binds it to `validateCompositionValue(value, { allow, components })`.
+     */
+    validateComposition?: (value: unknown, field: BlocksFieldDef) => readonly CompositionIssue[];
+    /**
+     * When provided, the composition embeds inside a `richText` field value are
+     * validated (EC-189). Injected so cms-core depends on neither
+     * `@elytracms/core/project-graph` nor `@elytracms/core/rich-text`; the studio binds it to walk
+     * the value's `componentEmbed` nodes and validate each embedded `ComponentNode`
+     * via `validateCompositionValue(node, { allow, components })` against the field's
+     * `allow` vocabulary. Findings carry the rich-text node path.
+     */
+    validateRichTextEmbeds?: (value: unknown, field: RichTextFieldDef) => readonly CompositionIssue[];
+    /**
+     * Published-ness oracle for the EC-173 weak-reference warning (EC-224): does a
+     * given document ref serve the published site? Sourced from the version
+     * pointer by the caller (the studio passes `cms.isPublished`). Absent → treated
+     * as "nothing is published", so the warning simply does not fire — the flat
+     * `state` flag is never consulted.
+     */
+    isPublished?: (ref: DocumentRef) => boolean;
+    /**
+     * Asset-existence oracle (EC-212 follow-up): assets live in their own
+     * repository, not as CMS documents, so the studio passes a predicate over the
+     * real asset library. When provided, it is the source of truth for asset-field
+     * existence; otherwise existence falls back to the document `store` (fixtures
+     * that model assets as documents). With neither, asset existence is not checked.
+     */
+    assetExists?: (id: string) => boolean;
+}
+/**
+ * Validate a document against its collection (EC-016/017/018). Returns structured
+ * issues; never throws. Checks unknown collection, missing required fields,
+ * scalar type correctness, declared constraints, relation targets, asset
+ * references, and required localized values across configured locales.
+ */
+export declare function validateDocument(registry: CollectionRegistry, doc: CmsDocument, options?: ValidateDocumentOptions): CmsValidationIssue[];
+/** Validate every document in a list against the registry. */
+export declare function validateDocuments(registry: CollectionRegistry, docs: readonly CmsDocument[], options?: ValidateDocumentOptions): CmsValidationIssue[];
+/**
+ * Pure scalar/structural type check for a field value (EC-190). Returns a human
+ * detail string when the value is the wrong shape for the field type, or null
+ * when it is acceptable. Existence checks (relation/asset targets) are NOT done
+ * here — they need a document store. Assumes a present value (the `required`
+ * check owns presence).
+ */
+export declare function checkScalarType(field: FieldDef, value: unknown): string | null;
+/**
+ * Pure declarative-constraint check (min/max/pattern) for a field value (EC-190).
+ * Returns the list of human detail strings for each violation (empty = valid).
+ * Mirrors `validateConstraints` without the issue-construction coupling.
+ */
+export declare function checkConstraints(field: FieldDef, value: unknown): string[];
+/**
+ * Build a pure, store-free validator for a single field-def's value (EC-190).
+ * Used by the renderer (invalid static prop → EC-015 visible fallback) and the
+ * inspector. Returns true when the value is structurally acceptable for the field
+ * type; absent values (undefined/null/'') are acceptable — the `required` check
+ * owns presence. Relation/asset existence and composition depth are validated
+ * elsewhere (they need a store / registry).
+ */
+export declare function fieldValueValidator(field: FieldDef): (value: unknown) => boolean;
+/**
+ * Lint a field-def used as a component prop (EC-190): document-only attributes
+ * (`filterable`, `validation.unique`) make no sense on a prop and surface as
+ * structured issues, never silently ignored. Returns [] for a valid prop
+ * field-def.
+ */
+export declare function assertPropFieldDef(field: FieldDef): CmsValidationIssue[];
+export interface ValidateComponentPropsOptions {
+    /**
+     * When provided, `blocks` prop values are validated (EC-188 callback wired to
+     * `validateCompositionValue` + the component registry by the studio).
+     */
+    validateComposition?: ValidateDocumentOptions['validateComposition'];
+    /**
+     * When provided, the composition embeds inside a `richText` prop value are
+     * validated (EC-189) — the prop-side mirror of the document callback.
+     */
+    validateRichTextEmbeds?: ValidateDocumentOptions['validateRichTextEmbeds'];
+}
+export declare function validateComponentProps(fieldDefs: readonly FieldDef[], props: Record<string, unknown>, options?: ValidateComponentPropsOptions): CmsValidationIssue[];
+/** Resolve a relation value into the referenced documents (EC-017). */
+export declare function resolveRelation(store: DocumentStore, value: unknown): CmsDocument[];
+/** Build a flat values bag (non-localized only) — convenience for tests/consumers. */
+export declare function plainValues(doc: CmsDocument): FieldValues;