@elytracms/core 0.0.6

package/dist/cms-core/fixtures.js

@@ -0,0 +1,357 @@
+import { documentKey, refOf } from './documents';
+/**
+ * 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 const sampleLocaleConfig = {
+    default: 'en',
+    locales: ['en', 'de'],
+};
+/** An asset collection (EC-017). */
+export const assetCollection = {
+    id: 'asset',
+    kind: 'asset',
+    titleField: 'filename',
+    fields: [
+        { name: 'filename', type: 'text', validation: { required: true } },
+        { name: 'alt', type: 'text', localized: true },
+        { name: 'url', type: 'text', validation: { required: true } },
+    ],
+};
+/** An author collection used as a relation target. */
+export const authorCollection = {
+    id: 'author',
+    kind: 'document',
+    titleField: 'name',
+    fields: [
+        { name: 'name', type: 'text', validation: { required: true } },
+        { name: 'bio', type: 'richText' },
+    ],
+};
+/** A localized blog-post collection exercising every field type. */
+export const postCollection = {
+    id: 'post',
+    kind: 'document',
+    localized: true,
+    titleField: 'title',
+    form: {
+        label: 'Posts',
+        labelSingular: 'Post',
+        groups: ['content', 'meta'],
+        tabs: ['main', 'seo'],
+    },
+    fields: [
+        {
+            name: 'title',
+            type: 'text',
+            localized: true,
+            validation: { required: true, min: 1, max: 120 },
+            form: { label: 'Title', group: 'content', tab: 'main', order: 1 },
+        },
+        {
+            name: 'slug',
+            type: 'text',
+            validation: { required: true, pattern: '^[a-z0-9-]+$', unique: true },
+            form: { label: 'Slug', group: 'content', tab: 'main', order: 2 },
+        },
+        {
+            name: 'body',
+            type: 'richText',
+            localized: true,
+            form: { label: 'Body', group: 'content', tab: 'main', order: 3 },
+        },
+        {
+            name: 'views',
+            type: 'number',
+            validation: { min: 0 },
+            form: { label: 'Views', group: 'meta', tab: 'main' },
+        },
+        {
+            name: 'featured',
+            type: 'boolean',
+            form: { label: 'Featured', group: 'meta', tab: 'main' },
+        },
+        {
+            name: 'publishedAt',
+            type: 'date',
+            form: { label: 'Published at', group: 'meta', tab: 'main' },
+        },
+        {
+            name: 'status',
+            type: 'select',
+            options: [
+                { value: 'news', label: 'News' },
+                { value: 'guide', label: 'Guide' },
+            ],
+            form: { label: 'Status', group: 'meta', tab: 'main' },
+        },
+        {
+            name: 'author',
+            type: 'relation',
+            target: 'author',
+            cardinality: 'one',
+            validation: { required: true },
+            form: { label: 'Author', group: 'meta', tab: 'main' },
+        },
+        {
+            name: 'related',
+            type: 'relation',
+            target: 'post',
+            cardinality: 'many',
+            form: { label: 'Related posts', group: 'meta', tab: 'main' },
+        },
+        {
+            name: 'cover',
+            type: 'asset',
+            cardinality: 'one',
+            accept: ['image'],
+            form: { label: 'Cover image', group: 'content', tab: 'main' },
+        },
+    ],
+};
+/**
+ * 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 const pageCollection = {
+    id: 'page',
+    kind: 'document',
+    titleField: 'name',
+    form: {
+        label: 'Pages',
+        labelSingular: 'Page',
+        tabs: ['main', 'canvas', 'seo'],
+    },
+    fields: [
+        {
+            name: 'name',
+            type: 'text',
+            validation: { required: true },
+            form: { tab: 'main' },
+        },
+        {
+            name: 'body',
+            type: 'blocks',
+            allow: [
+                'base.primitives.Heading',
+                'base.primitives.Text',
+                'base.primitives.Image',
+                'base.primitives.Button',
+                'base.primitives.Stack',
+                'project.MarketingHero',
+                'project.FeatureCard',
+                'project.PricingCallout',
+            ],
+            cardinality: 'many',
+            form: { label: 'Canvas', tab: 'canvas' },
+        },
+        { name: 'layoutId', type: 'text', form: { tab: 'main' } },
+        { name: 'seoTitle', type: 'text', form: { tab: 'seo' } },
+        { name: 'seoDescription', type: 'text', form: { tab: 'seo' } },
+        { name: 'seoCanonical', type: 'text', form: { tab: 'seo' } },
+        { name: 'seoOgTitle', type: 'text', form: { tab: 'seo' } },
+        { name: 'seoOgImage', type: 'text', form: { tab: 'seo' } },
+        { name: 'seoNoindex', type: 'boolean', form: { tab: 'seo' } },
+    ],
+};
+export const sampleCollections = [
+    assetCollection,
+    authorCollection,
+    postCollection,
+    pageCollection,
+];
+/**
+ * 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 const sampleFilterableFields = {
+    author: ['name'],
+    post: ['slug', 'views', 'featured', 'publishedAt', 'status', 'author'],
+};
+function withSampleFilterable(collection) {
+    const filterable = new Set(sampleFilterableFields[collection.id] ?? []);
+    if (filterable.size === 0)
+        return collection;
+    return {
+        ...collection,
+        fields: collection.fields.map((field) => filterable.has(field.name) ? { ...field, filterable: true } : field),
+    };
+}
+/**
+ * `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 const sampleFilterableCollections = sampleCollections.map(withSampleFilterable);
+// ---- Sample documents ----
+export const coverAsset = {
+    collection: 'asset',
+    id: 'asset-cover',
+    values: { filename: 'cover.png', url: 'https://cdn/cover.png' },
+    localized: { en: { alt: 'A cover' }, de: { alt: 'Ein Titelbild' } },
+    defaultLocale: 'en',
+};
+/**
+ * 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 const libraryCoverAsset = {
+    collection: 'asset',
+    id: 'asset_cover',
+    values: { filename: 'cover.jpg', url: 'https://cdn/cover.jpg' },
+    localized: { en: { alt: 'Cover image' }, de: { alt: 'Titelbild' } },
+    defaultLocale: 'en',
+};
+export const authorAda = {
+    collection: 'author',
+    id: 'author-ada',
+    values: { name: 'Ada Lovelace', bio: 'Pioneer.' },
+};
+/** A valid, localized post that resolves all of its relations/assets. */
+export const validPost = {
+    collection: 'post',
+    id: 'post-hello',
+    values: {
+        slug: 'hello-world',
+        views: 10,
+        featured: true,
+        publishedAt: '2026-01-02T00:00:00.000Z',
+        status: 'news',
+        author: { collection: 'author', id: 'author-ada' },
+        related: [],
+        cover: 'asset-cover',
+    },
+    localized: {
+        en: { title: 'Hello World', body: '<p>Hi</p>' },
+        de: { title: 'Hallo Welt', body: '<p>Hallo</p>' },
+    },
+    defaultLocale: 'en',
+};
+/** A post localized only in the default locale (exercises fallback, EC-018). */
+export const partiallyLocalizedPost = {
+    collection: 'post',
+    id: 'post-fallback',
+    values: {
+        slug: 'fallback',
+        author: { collection: 'author', id: 'author-ada' },
+    },
+    localized: {
+        en: { title: 'Only English', body: '<p>en</p>' },
+        // no `de` variant — `de` requests must fall back to `en`
+    },
+    defaultLocale: 'en',
+};
+/**
+ * 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 const samplePageHome = {
+    collection: 'page',
+    id: 'home',
+    values: {
+        name: 'Home',
+        layoutId: 'layout.main',
+        seoTitle: 'Welcome to Elytra',
+        seoDescription: 'A code-first website builder.',
+        body: [
+            {
+                id: 'p-home-heading',
+                componentId: 'base.primitives.Heading',
+                props: {
+                    level: { kind: 'static', value: 1 },
+                    text: { kind: 'static', value: 'Welcome to Elytra' },
+                },
+            },
+            {
+                id: 'p-home-intro',
+                componentId: 'base.primitives.Text',
+                props: { value: { kind: 'static', value: 'A code-first website builder.' } },
+            },
+        ],
+    },
+    defaultLocale: 'en',
+};
+export const samplePageDocuments = [samplePageHome];
+export const sampleDocuments = [
+    coverAsset,
+    authorAda,
+    validPost,
+    partiallyLocalizedPost,
+    libraryCoverAsset,
+    samplePageHome,
+];
+/**
+ * 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 const samplePublishedKeys = sampleDocuments.map((doc) => documentKey(refOf(doc)));
+// ---- Sample routes & redirects ----
+export const sampleRoutes = [
+    { id: 'r-home', pattern: '/', locale: 'en', document: { collection: 'page', id: 'home' } },
+    { id: 'r-home-de', pattern: '/', locale: 'de', document: { collection: 'page', id: 'home' } },
+    {
+        id: 'r-post',
+        pattern: '/blog/:slug',
+        locale: 'en',
+        document: { collection: 'post', id: ':slug' },
+    },
+    {
+        id: 'r-about',
+        pattern: '/about',
+        locale: 'en',
+        document: { collection: 'post', id: 'post-hello' },
+    },
+];
+export const sampleRedirects = [
+    { id: 'rd-1', from: '/old', to: '/about', permanent: true },
+    { id: 'rd-chain-1', from: '/a', to: '/b', permanent: true },
+    { id: 'rd-chain-2', from: '/b', to: '/c', permanent: true },
+    { id: 'rd-chain-3', from: '/c', to: '/about', permanent: false },
+];
+/** Two routes that match the exact same concrete URLs (EC-020 conflict). */
+export const conflictingRoutes = [
+    {
+        id: 'r-a',
+        pattern: '/blog/:slug',
+        locale: 'en',
+        document: { collection: 'post', id: ':slug' },
+    },
+    { id: 'r-b', pattern: '/blog/:id', locale: 'en', document: { collection: 'post', id: ':id' } },
+];
+/** A redirect loop (EC-020). */
+export const loopingRedirects = [
+    { id: 'l1', from: '/x', to: '/y', permanent: true },
+    { id: 'l2', from: '/y', to: '/x', permanent: true },
+];
+//# sourceMappingURL=fixtures.js.map

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

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

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

@@ -0,0 +1,113 @@
+import type { CollectionDef } from './collections';
+import type { CmsDocument } from './documents';
+import type { RelationFieldDef } from './fields';
+import type { RouteRecord } from './routes';
+/**
+ * Page hierarchy (EC-218, vision §3.4 / AD-6).
+ *
+ * A routable collection models nesting with a **`parent` self-relation** + a
+ * local **`slug`** — never a stored full path. The full nested URL is *composed*
+ * by walking the parent chain (the Payload nested-docs / Sanity page-tree
+ * pattern), so moving or renaming a parent re-derives every descendant's URL
+ * with no denormalized bulk rewrite. Every walk here is cycle-safe by
+ * construction: a parent chain that loops stops at the repeat and is surfaced as
+ * a structured issue, never an infinite loop or a crash.
+ *
+ * The slug is read non-localized (one segment per document, per the EC-218
+ * decision); locale-specific routes are still expressed by the route record's
+ * own `locale`.
+ */
+export interface HierarchyConfig {
+    /** Self-relation field naming a document's parent (default `parent`). */
+    parentField?: string;
+    /** Text field holding the local URL segment (default `slug`). */
+    slugField?: string;
+}
+/** Resolve a {@link HierarchyConfig} to its concrete field names. */
+export declare function hierarchyFields(config?: HierarchyConfig): {
+    parentField: string;
+    slugField: string;
+};
+/**
+ * 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 declare function parentRelationField(collection: CollectionDef, config?: HierarchyConfig): RelationFieldDef | undefined;
+/** Does this collection model a parent/child hierarchy (a `parent` self-relation)? */
+export declare function isHierarchical(collection: CollectionDef, config?: HierarchyConfig): boolean;
+export interface ComposedPath {
+    /** Slug segments from root to leaf. */
+    segments: string[];
+    /** True iff the path is clean: no cycle, no missing slug, no dangling parent. */
+    ok: boolean;
+    /** The parent chain loops. */
+    cycle: boolean;
+    /** A document in the chain (this one or an ancestor) has no slug. */
+    missingSlug: boolean;
+    /** A parent ref pointed at a document that is not present. */
+    danglingParent: boolean;
+}
+/**
+ * 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 declare function composePath(doc: CmsDocument, getById: (id: string) => CmsDocument | undefined, config?: HierarchyConfig): ComposedPath;
+/** Does a document's parent chain loop? (cycle-safe; uses {@link composePath}). */
+export declare function hasParentCycle(doc: CmsDocument, getById: (id: string) => CmsDocument | undefined, config?: HierarchyConfig): boolean;
+export interface HierarchyRow {
+    doc: CmsDocument;
+    /** Nesting depth: 0 for roots, 1 for their children, … */
+    depth: number;
+    /** Whether this document has at least one child. */
+    hasChildren: boolean;
+}
+/**
+ * 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 declare function orderHierarchically(docs: readonly CmsDocument[], config?: HierarchyConfig): HierarchyRow[];
+/**
+ * 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 declare function descendantIds(rootId: string, docs: readonly CmsDocument[], config?: HierarchyConfig): Set<string>;
+/**
+ * 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 declare function isHierarchyTemplate(route: RouteRecord): boolean;
+export interface HierarchyMount {
+    /** The collection whose documents are served by composed path. */
+    collection: string;
+    /** Static URL segments before the catch-all (empty = mounted at the root). */
+    prefix: string[];
+    /** Locale this mount serves, if the template declared one. */
+    locale?: string;
+}
+/**
+ * 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 declare function hierarchyMount(route: RouteRecord): HierarchyMount | undefined;
+/**
+ * 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 declare function resolveByPath(segments: readonly string[], docs: readonly CmsDocument[], config?: HierarchyConfig): CmsDocument | undefined;