@elytracms/core 0.0.6

package/dist/cms-core/fields.js

@@ -0,0 +1,250 @@
+import { z } from 'zod';
+/**
+ * Provider-neutral field type catalogue (brief §7.4). Relation and asset are
+ * first-class field types but carry extra config (target collection, cardinality),
+ * so they're modelled as discriminated variants below rather than bare strings.
+ */
+export const fieldTypeSchema = z.enum([
+    'text',
+    'number',
+    'boolean',
+    'date',
+    'select',
+    'richText',
+    'relation',
+    'asset',
+    // Composition field (EC-186, AD-12): the value is a constrained tree of
+    // registry components (a canvas), not a scalar. The vocabulary is code.
+    'blocks',
+    // Object / repeater field (EC-253): a nested group of field-defs — a single
+    // object (`cardinality: 'one'`) or an ordered array of them (`'many'`). The
+    // missing array-of-objects primitive real sites lean on (menus, forms, galleries).
+    'object',
+]);
+/** How many related documents a relation field points at. */
+export const cardinalitySchema = z.enum(['one', 'many']);
+/**
+ * Where a field-def is valid (EC-190 "props as fields"): a CMS document field, a
+ * component prop, or both. The same field-def vocabulary drives documents AND
+ * component props through one inspector/form engine — `context` only gates which
+ * document-only attributes apply, never the stored value or emitted JSON Schema.
+ */
+export const fieldContextSchema = z.enum(['document', 'prop', 'both']);
+/**
+ * Preferred input control when a field type maps to several presentation forms
+ * (e.g. a `text` field rendered as a single input, a textarea, a colour picker, or
+ * a JSON editor). Presentation only — never affects validation or stored values.
+ */
+export const fieldControlSchema = z.enum(['input', 'textarea', 'color', 'json']);
+/**
+ * Form/authoring metadata for a field (brief §7.4: groups/tabs/labels/order).
+ * Pure presentation hints — never affects validation or stored values.
+ */
+export const fieldFormMetaSchema = z.object({
+    /** Human label shown in the editor; falls back to the field name when omitted. */
+    label: z.string().optional(),
+    /** Helper/description text shown under the field. */
+    description: z.string().optional(),
+    /** Placeholder for text-like inputs. */
+    placeholder: z.string().optional(),
+    /** Grouping section the field belongs to (a fieldset). */
+    group: z.string().optional(),
+    /** Tab the field belongs to (for tabbed editors). */
+    tab: z.string().optional(),
+    /** Sort order within its group/tab; lower comes first. */
+    order: z.number().optional(),
+    /** When true the editor renders the field read-only. */
+    readOnly: z.boolean().optional(),
+    /** When true the editor hides the field (still validated/stored). */
+    hidden: z.boolean().optional(),
+    /** Preferred input control when the field type maps to several (EC-190). */
+    control: fieldControlSchema.optional(),
+    /**
+     * When true the editor edits this value inline on the canvas (EC-158) rather
+     * than as a form row — used for text-like component props rendered as visible
+     * content. The single home for inline-editing across documents and props.
+     */
+    inlineEditable: z.boolean().optional(),
+});
+/**
+ * Declarative validation metadata for a field (brief §7.4). These constraints
+ * are provider-neutral and drive both runtime validation (`validateDocument`)
+ * and JSON Schema output. They never throw — violations surface as structured
+ * issues.
+ */
+export const fieldValidationSchema = z.object({
+    /** When true a value must be present (and non-empty for strings/arrays). */
+    required: z.boolean().optional(),
+    /** Minimum string length / array length / numeric value (type-dependent). */
+    min: z.number().optional(),
+    /** Maximum string length / array length / numeric value (type-dependent). */
+    max: z.number().optional(),
+    /** RegExp source string a text value must match. */
+    pattern: z.string().optional(),
+    /** Value must be unique across the collection's documents. */
+    unique: z.boolean().optional(),
+});
+/** A single allowed option for a `select` field. */
+export const selectOptionSchema = z.object({
+    value: z.string(),
+    label: z.string().optional(),
+});
+const baseFieldShape = {
+    /** Stable field name (the key in a document's values; survives label changes). */
+    name: z.string().min(1),
+    /** When true the field stores a separate value per locale (EC-018). */
+    localized: z.boolean().optional(),
+    /**
+     * Marks the field as filterable/sortable for the closed-form list accessors
+     * (EC-143, vision AD-3). `listDocuments` filters and sorts are permitted only
+     * on declared fields — this keeps backend indexes honest and stops filter
+     * vocabulary creep. Never affects stored values or validation.
+     */
+    filterable: z.boolean().optional(),
+    /**
+     * Where this field-def is valid (EC-190): a CMS document field, a component
+     * prop, or both. Defaults to `document` when omitted (back-compat — every
+     * existing collection field-def stays a document field). Document-only
+     * attributes (`filterable`, `validation.unique`) declared on a `context:'prop'`
+     * field are a structured issue (`assertPropFieldDef`), never silent.
+     */
+    context: fieldContextSchema.optional(),
+    /**
+     * Default value applied when none is set (EC-190). On a component prop this is
+     * the renderer's static fallback (EC-015); on a document field it seeds new
+     * documents — the per-field starter-content mechanism (no template entity
+     * needed). Never affects whether a value is *stored*, only what fills a gap.
+     */
+    default: z.unknown().optional(),
+    form: fieldFormMetaSchema.optional(),
+    validation: fieldValidationSchema.optional(),
+};
+/** A schema of just the shared base attributes — the source for {@link BaseFieldDef}. */
+const baseFieldObjectSchema = z.object(baseFieldShape);
+/**
+ * The Zod schema mirroring {@link FieldDef}. The `object` member's `fields` is
+ * wrapped in `z.lazy` so the schema can reference itself, while the discriminator
+ * stays a static `z.literal('object')` so `discriminatedUnion` can still read it
+ * at construction time. The explicit `z.ZodType<FieldDef>` annotation breaks the
+ * self-referential inference cycle; the cast reconciles the parsed output (where
+ * defaulted `cardinality` is always present) with the union's optional-input type.
+ */
+export const fieldDefSchema = z.discriminatedUnion('type', [
+    z.object({ ...baseFieldShape, type: z.literal('text') }),
+    z.object({ ...baseFieldShape, type: z.literal('number') }),
+    z.object({ ...baseFieldShape, type: z.literal('boolean') }),
+    z.object({ ...baseFieldShape, type: z.literal('date') }),
+    z.object({
+        ...baseFieldShape,
+        type: z.literal('select'),
+        options: z.array(selectOptionSchema).min(1),
+        /** Allow selecting multiple options (stored as an array). */
+        multiple: z.boolean().optional(),
+    }),
+    z.object({
+        ...baseFieldShape,
+        type: z.literal('richText'),
+        /**
+         * Embeddable composition vocabulary (EC-189, AD-12): component ids editors
+         * may embed as `componentEmbed` blocks inside the prose — the SAME `allow`
+         * mechanism a `blocks` field uses, applied to rich-text embeds. Each embed
+         * holds a single `ComponentNode` validated against this list by
+         * `validateCompositionValue` (`@elytracms/core/project-graph`). Omit to allow any
+         * registered component; deeper nesting is governed by each component's slot
+         * `allow`. The leash is code.
+         */
+        allow: z.array(z.string().min(1)).optional(),
+    }),
+    z.object({
+        ...baseFieldShape,
+        type: z.literal('relation'),
+        /** Id of the collection this relation points at. */
+        target: z.string().min(1),
+        cardinality: cardinalitySchema,
+        /**
+         * Delivery-shape population declaration (EC-142). Defaults to populated:
+         * delivery resolution expands the relation to a depth-1 populated reference.
+         * Set to `false` to opt out and receive reference stubs
+         * (`{ id, collection }`) instead. Never affects stored values.
+         */
+        populate: z.boolean().optional(),
+        /**
+         * Strict referential integrity (EC-173). References are **weak by
+         * default**: unpublishing/deleting a referenced target is allowed and the
+         * reference degrades to an explicit validation issue plus a delivery
+         * fallback. `strict: true` is the deliberate opt-in that inverts this for
+         * one field: while any document references a target through this field,
+         * deleting the target is blocked — and while a *published* document does,
+         * unpublishing it is blocked too (enforced in `@elytracms/core/operations`).
+         */
+        strict: z.boolean().optional(),
+    }),
+    z.object({
+        ...baseFieldShape,
+        type: z.literal('asset'),
+        cardinality: cardinalitySchema.default('one'),
+        /** Restrict to specific asset kinds (e.g. 'image', 'file'); empty = any. */
+        accept: z.array(z.string()).optional(),
+    }),
+    z.object({
+        ...baseFieldShape,
+        type: z.literal('blocks'),
+        /**
+         * The composition vocabulary (EC-186, AD-12): allowed component ids editors
+         * may place as TOP-LEVEL blocks. Omit to allow any registered component;
+         * deeper nesting is governed by each component's slot `allow`. The value
+         * (a `ComponentNode` tree) is validated against this by
+         * `validateCompositionValue` (`@elytracms/core/project-graph`). The leash is code.
+         */
+        allow: z.array(z.string().min(1)).optional(),
+        /** `one` = a single root component; `many` = an ordered list (default). */
+        cardinality: cardinalitySchema.default('many'),
+    }),
+    z.object({
+        ...baseFieldShape,
+        type: z.literal('object'),
+        /**
+         * The nested field-defs. Recursive via `z.lazy` (a subfield may itself be an
+         * `object`), so Konditorei's nested menu, the form builder's groups→fields,
+         * and multi-entry settings model faithfully. Subfields carry their own `name`
+         * (they are object keys), so this is the full `FieldDef`, not the prop shape.
+         */
+        fields: z.lazy(() => z.array(fieldDefSchema)),
+        /** `one` = a single nested object; `many` = an ordered array (the repeater). */
+        cardinality: cardinalitySchema.default('one'),
+    }),
+]);
+/** Narrowing helpers. */
+export function isRelationField(field) {
+    return field.type === 'relation';
+}
+export function isAssetField(field) {
+    return field.type === 'asset';
+}
+export function isSelectField(field) {
+    return field.type === 'select';
+}
+export function isBlocksField(field) {
+    return field.type === 'blocks';
+}
+export function isRichTextField(field) {
+    return field.type === 'richText';
+}
+export function isObjectField(field) {
+    return field.type === 'object';
+}
+/** Resolve a field-def's context, defaulting to `document` (EC-190). */
+export function fieldContext(field) {
+    return field.context ?? 'document';
+}
+/** True if the field-def may be used as a component prop (EC-190). */
+export function isPropContext(field) {
+    const c = fieldContext(field);
+    return c === 'prop' || c === 'both';
+}
+/** True if the field-def may be used as a CMS document field (EC-190). */
+export function isDocumentContext(field) {
+    const c = fieldContext(field);
+    return c === 'document' || c === 'both';
+}
+//# sourceMappingURL=fields.js.map

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

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

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

@@ -0,0 +1,92 @@
+import type { CollectionDef } from './collections';
+import type { CmsDocument } from './documents';
+import type { LocaleConfig } from './localization';
+import type { RedirectRecord, RouteRecord } from './routes';
+/**
+ * Sample CMS model used across tests and as a worked example (mirrors the role of
+ * `validSampleGraph` in `@elytracms/core/project-graph`). Provider-neutral, deterministic.
+ */
+export declare const sampleLocaleConfig: LocaleConfig;
+/** An asset collection (EC-017). */
+export declare const assetCollection: CollectionDef;
+/** An author collection used as a relation target. */
+export declare const authorCollection: CollectionDef;
+/** A localized blog-post collection exercising every field type. */
+export declare const postCollection: CollectionDef;
+/**
+ * EC-187: the `page` collection — a document collection whose body IS a
+ * composition (`blocks`) field, surfaced on its own "Canvas" fieldset tab
+ * (EC-188). This is the config-owned model a routed page document is authored
+ * against: `name` (title), the `body` canvas, structured SEO, and a `layoutId`
+ * selecting which graph layout wraps the rendered composition at delivery.
+ *
+ * ADDITIVE + INERT (EC-187 slices 1–3): the collection exists in config so the
+ * studio can author page documents and the reference index walks their `body`
+ * tree, but NOTHING routes to it yet — the OLD `graph.pages` delivery path stays
+ * canonical until the breaking cutover wires routes/host/seed to `page`.
+ *
+ * The `body` field mirrors the post `content` blocks field EXACTLY (same `allow`
+ * code-leashed vocabulary, same `cardinality: 'many'`) so both composition
+ * surfaces deliver and index through one identical code path.
+ */
+export declare const pageCollection: CollectionDef;
+export declare const sampleCollections: CollectionDef[];
+/**
+ * The canonical EC-143 `filterable` declarations for the sample model — the
+ * single set the seeded schema (`@elytracms/core/persistence`), the accessor
+ * fixtures (`@elytracms/core/content`), and the studio sessions share, so the
+ * filter/sort pickers and the delivery engine agree on exactly one
+ * declaration set (EC-169 fix-pack).
+ *
+ * Deliberately *not* filterable: `title` (tests prove that filtering a
+ * real-but-undeclared field fails as a structured error) and the whole
+ * `asset` collection (a collection with no filterable fields).
+ */
+export declare const sampleFilterableFields: Record<string, readonly string[]>;
+/**
+ * `sampleCollections` with the canonical `filterable` declarations applied —
+ * same ids, same field shapes. `sampleCollections` itself stays undeclared on
+ * purpose (fixtures proving "no declarations → nothing offered" rely on it);
+ * schema-bearing surfaces (the persistence seed, accessor fixtures) use this
+ * variant.
+ */
+export declare const sampleFilterableCollections: CollectionDef[];
+export declare const coverAsset: CmsDocument;
+/**
+ * The CMS counterpart of the seeded asset-library record (`@elytracms/core/persistence`
+ * `SEED_ASSET`, id `asset_cover` — the EC-152 library). Sharing the library's
+ * id means picking that real library asset validates clean against the asset
+ * collection (EC-168/EC-172 fix-pack: the seeded post's `cover` previously had
+ * no library-matching asset document, so a re-pick failed validation).
+ * `coverAsset` above ('asset-cover') intentionally has NO library record — it
+ * remains the "missing asset record" delivery demo.
+ */
+export declare const libraryCoverAsset: CmsDocument;
+export declare const authorAda: CmsDocument;
+/** A valid, localized post that resolves all of its relations/assets. */
+export declare const validPost: CmsDocument;
+/** A post localized only in the default locale (exercises fallback, EC-018). */
+export declare const partiallyLocalizedPost: CmsDocument;
+/**
+ * The home page as a `page`-collection document (EC-187): `name`, a static
+ * `body` composition (no bindings — v1 static props), a `layoutId` selecting the
+ * graph layout, and flat `seo*` fields. This is what a routed page resolves to;
+ * the catch-all renders `body` into `layoutId` via `renderCompositionInLayout`.
+ */
+export declare const samplePageHome: CmsDocument;
+export declare const samplePageDocuments: CmsDocument[];
+export declare const sampleDocuments: CmsDocument[];
+/**
+ * The sample documents that are PUBLISHED (EC-224), as an explicit
+ * version-POINTER set — computed from each doc's identity, never a flat `state`
+ * flag, so it survives the field's removal (B-3c-4). Seeds pin exactly these;
+ * the playground/preview treat exactly these as live. (Every current sample doc
+ * is published; a future draft sample would be omitted here.)
+ */
+export declare const samplePublishedKeys: readonly string[];
+export declare const sampleRoutes: RouteRecord[];
+export declare const sampleRedirects: RedirectRecord[];
+/** Two routes that match the exact same concrete URLs (EC-020 conflict). */
+export declare const conflictingRoutes: RouteRecord[];
+/** A redirect loop (EC-020). */
+export declare const loopingRedirects: RedirectRecord[];