@v7-cms/core 0.0.0-alpha.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PurrNeko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/body-mode.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Choosing how to edit a body.
+ *
+ * A rich-text editor normalises Markdown: it re-wraps emphasis, realigns tables, changes list
+ * markers and fence styles. That is fine for prose and fatal for MDX, which carries ESM imports
+ * and JSX that a Markdown editor does not understand at all. So a body is classified before it is
+ * opened, and anything the rich editor would not round-trip is edited as source instead.
+ *
+ * The bias is deliberate: when in doubt, choose source. A false positive costs the author a nicer
+ * editor; a false negative silently corrupts their file.
+ */
+export type BodyMode = 'rich' | 'source';
+export interface BodyModeOptions {
+    /** File extension, since MDX is always source-edited. */
+    extension?: string;
+    /** Set by the config when a field is explicitly source-only. */
+    forceSource?: boolean;
+    /** Fence languages this consumer treats as structured, added to the built-in set. */
+    structuredFences?: string[];
+}
+export interface BodyModeResult {
+    mode: BodyMode;
+    /** Why source was chosen, so the UI can explain itself instead of just refusing. */
+    reason?: 'mdx' | 'imports' | 'jsx' | 'structured-fence' | 'html' | 'math' | 'indented-code' | 'configured';
+}
+/**
+ * Decide how to edit a body.
+ *
+ * Only clear, unambiguous signals force source mode. A stray `<` in prose, or a `$` in a price,
+ * must not send the author to the source editor for no reason.
+ */
+export declare function classifyBody(body: string, options?: BodyModeOptions): BodyModeResult;
+/** Convenience for the UI: whether a body may be opened in the rich editor. */
+export declare function canEditAsRichText(body: string, options?: BodyModeOptions): boolean;
+//# sourceMappingURL=body-mode.d.ts.map

package/dist/body-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-mode.d.ts","sourceRoot":"","sources":["../src/body-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAgBzC,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,QAAQ,CAAC;IACf,oFAAoF;IACpF,MAAM,CAAC,EACH,KAAK,GACL,SAAS,GACT,KAAK,GACL,kBAAkB,GAClB,MAAM,GACN,MAAM,GACN,eAAe,GACf,YAAY,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc,CA8ExF;AAED,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAEtF"}

package/dist/body-mode.js

@@ -0,0 +1,116 @@
+/**
+ * Choosing how to edit a body.
+ *
+ * A rich-text editor normalises Markdown: it re-wraps emphasis, realigns tables, changes list
+ * markers and fence styles. That is fine for prose and fatal for MDX, which carries ESM imports
+ * and JSX that a Markdown editor does not understand at all. So a body is classified before it is
+ * opened, and anything the rich editor would not round-trip is edited as source instead.
+ *
+ * The bias is deliberate: when in doubt, choose source. A false positive costs the author a nicer
+ * editor; a false negative silently corrupts their file.
+ */
+/** Fence languages a Markdown editor would rewrite or mangle. */
+const STRUCTURED_FENCES = new Set([
+    'mermaid',
+    'abc',
+    'math',
+    'katex',
+    'plantuml',
+    'graphviz',
+    'markmap',
+    'mindmap',
+    'echarts',
+    'wavedrom',
+]);
+/**
+ * Decide how to edit a body.
+ *
+ * Only clear, unambiguous signals force source mode. A stray `<` in prose, or a `$` in a price,
+ * must not send the author to the source editor for no reason.
+ */
+export function classifyBody(body, options = {}) {
+    // The extension is the most specific signal, so it is reported ahead of a blanket config flag:
+    // "this is MDX" tells the author more than "this field is source only".
+    if (options.extension === 'mdx')
+        return { mode: 'source', reason: 'mdx' };
+    if (options.forceSource)
+        return { mode: 'source', reason: 'configured' };
+    const structured = options.structuredFences
+        ? new Set([...STRUCTURED_FENCES, ...options.structuredFences])
+        : STRUCTURED_FENCES;
+    const lines = body.split('\n');
+    let inFence = false;
+    for (const line of lines) {
+        const fence = /^\s{0,3}(?:`{3,}|~{3,})\s*([^\s`]*)/.exec(line);
+        if (fence) {
+            if (!inFence) {
+                const language = (fence[1] ?? '').toLowerCase();
+                if (language && structured.has(language)) {
+                    return { mode: 'source', reason: 'structured-fence' };
+                }
+                inFence = true;
+            }
+            else {
+                inFence = false;
+            }
+            continue;
+        }
+        if (inFence)
+            continue;
+        // ESM in MDX, at the start of a line where it is unambiguous.
+        if (/^\s*(import|export)\s/.test(line))
+            return { mode: 'source', reason: 'imports' };
+        // JSX or HTML component syntax: a capitalised tag, or an explicit block element. Prose rarely
+        // starts a line with one, so requiring line-start keeps false positives down.
+        if (/^\s*<\/?[A-Z][A-Za-z0-9.]*[\s/>]/.test(line))
+            return { mode: 'source', reason: 'jsx' };
+        if (/^\s*<(div|span|figure|details|summary|iframe|video|audio|table)\b/i.test(line)) {
+            return { mode: 'source', reason: 'html' };
+        }
+        // Display math. Inline `$…$` is common in prose and round-trips acceptably, but a `$$` block
+        // is a block-level construct and is treated as structured.
+        if (/^\s*\$\$/.test(line))
+            return { mode: 'source', reason: 'math' };
+    }
+    /**
+     * Four-space indented code blocks are ambiguous with nested list continuations, which is exactly
+     * the kind of thing a rich editor gets wrong. Only the ambiguous case counts: an indented block
+     * that follows a blank line at column zero. Indented lines inside a list, or inside a fenced
+     * block, are ordinary content.
+     */
+    function hasIndentedCodeBlock(body) {
+        const lines = body.split('\n');
+        let fenced = false;
+        let previousBlank = true;
+        for (const line of lines) {
+            if (/^\s{0,3}(`{3,}|~{3,})/.test(line)) {
+                fenced = !fenced;
+                previousBlank = false;
+                continue;
+            }
+            if (fenced)
+                continue;
+            // Inside a list, indentation is a continuation or a nested item, not a code block.
+            if (/^\s*(?:[-*+]|\d+[.)])\s/.test(line)) {
+                previousBlank = false;
+                continue;
+            }
+            if (/^(?: {4}|\t)\S/.test(line)) {
+                if (previousBlank)
+                    return true;
+                previousBlank = false;
+                continue;
+            }
+            previousBlank = line.trim() === '';
+        }
+        return false;
+    }
+    if (hasIndentedCodeBlock(body))
+        return { mode: 'source', reason: 'indented-code' };
+    return { mode: 'rich' };
+}
+/** Convenience for the UI: whether a body may be opened in the rich editor. */
+export function canEditAsRichText(body, options = {}) {
+    return classifyBody(body, options).mode === 'rich';
+}
+//# sourceMappingURL=body-mode.js.map

package/dist/body-mode.js.map

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

package/dist/config-load.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Config loading and validation.
+ *
+ * The config is the only thing that knows what a consumer's content looks like; everything else
+ * is generic. Validation is deliberately structural — it checks that the config itself makes
+ * sense (unique names, fields that exist) and leaves content values to the schema the consumer
+ * describes, because a CMS must not reject files it does not understand.
+ */
+import { z } from 'zod';
+import type { CMSConfig, Field } from './config.js';
+export declare const configSchema: z.ZodObject<{
+    backend: z.ZodObject<{
+        name: z.ZodEnum<{
+            github: "github";
+            local: "local";
+        }>;
+        repo: z.ZodOptional<z.ZodString>;
+        branch: z.ZodOptional<z.ZodString>;
+        authBase: z.ZodOptional<z.ZodString>;
+        authEndpoint: z.ZodOptional<z.ZodString>;
+        local: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<{
+                "fs-access": "fs-access";
+                proxy: "proxy";
+                memory: "memory";
+            }>;
+            url: z.ZodOptional<z.ZodString>;
+            files: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    media: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodEnum<{
+            repo: "repo";
+            s3: "s3";
+        }>;
+        repoPath: z.ZodOptional<z.ZodString>;
+        publicPath: z.ZodOptional<z.ZodString>;
+        maxEdge: z.ZodOptional<z.ZodNumber>;
+        exif: z.ZodOptional<z.ZodBoolean>;
+        s3: z.ZodOptional<z.ZodObject<{
+            endpoint: z.ZodString;
+            bucket: z.ZodString;
+            publicBase: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    collections: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+        kind: z.ZodLiteral<"fields">;
+        name: z.ZodString;
+        label: z.ZodString;
+        labelSingular: z.ZodOptional<z.ZodString>;
+        folder: z.ZodString;
+        extension: z.ZodEnum<{
+            mdx: "mdx";
+            md: "md";
+            json: "json";
+            yaml: "yaml";
+        }>;
+        format: z.ZodEnum<{
+            json: "json";
+            frontmatter: "frontmatter";
+        }>;
+        identifierField: z.ZodOptional<z.ZodString>;
+        contentField: z.ZodOptional<z.ZodString>;
+        nested: z.ZodOptional<z.ZodBoolean>;
+        media: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        create: z.ZodOptional<z.ZodBoolean>;
+        fields: z.ZodArray<z.ZodType<Field, unknown, z.core.$ZodTypeInternals<Field, unknown>>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"file">;
+        name: z.ZodString;
+        label: z.ZodString;
+        format: z.ZodOptional<z.ZodEnum<{
+            json: "json";
+            yaml: "yaml";
+        }>>;
+        files: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            label: z.ZodString;
+            file: z.ZodString;
+            fields: z.ZodOptional<z.ZodArray<z.ZodType<Field, unknown, z.core.$ZodTypeInternals<Field, unknown>>>>;
+            inferSchema: z.ZodOptional<z.ZodBoolean>;
+            fieldOverrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>]>>;
+    locale: z.ZodOptional<z.ZodString>;
+    editorialWorkflow: z.ZodOptional<z.ZodBoolean>;
+    preview: z.ZodOptional<z.ZodObject<{
+        devServerURL: z.ZodOptional<z.ZodString>;
+        pathTemplate: z.ZodOptional<z.ZodString>;
+        editAttribute: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    plugins: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+}, z.core.$strip>;
+export interface ConfigIssue {
+    path: string;
+    message: string;
+}
+/**
+ * Validate a config and report every problem at once, so a consumer fixing a typo does not have
+ * to reload repeatedly. Returns the parsed config on success.
+ */
+export declare function loadConfig(input: unknown): {
+    config: CMSConfig;
+    issues: ConfigIssue[];
+};
+//# sourceMappingURL=config-load.d.ts.map

package/dist/config-load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-load.d.ts","sourceRoot":"","sources":["../src/config-load.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAc,KAAK,EAAE,MAAM,aAAa,CAAC;AA6DhE,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+CvB,CAAC;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG;IAC1C,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB,CA2CA"}

package/dist/config-load.js

@@ -0,0 +1,193 @@
+/**
+ * Config loading and validation.
+ *
+ * The config is the only thing that knows what a consumer's content looks like; everything else
+ * is generic. Validation is deliberately structural — it checks that the config itself makes
+ * sense (unique names, fields that exist) and leaves content values to the schema the consumer
+ * describes, because a CMS must not reject files it does not understand.
+ */
+import { z } from 'zod';
+const fieldSchema = z.lazy(() => z
+    .object({
+    name: z.string().min(1),
+    label: z.string().optional(),
+    widget: z.string().min(1),
+    required: z.boolean().optional(),
+    hint: z.string().optional(),
+    fields: z.array(fieldSchema).optional(),
+    field: fieldSchema.optional(),
+    options: z
+        .array(z.union([z.string(), z.object({ label: z.string(), value: z.string() })]))
+        .optional(),
+    default: z.unknown().optional(),
+    collapseEmpty: z.boolean().optional(),
+    collection: z.string().optional(),
+    valueField: z.string().optional(),
+    displayFields: z.array(z.string()).optional(),
+    format: z.string().optional(),
+    pattern: z.tuple([z.string(), z.string()]).optional(),
+})
+    .loose());
+const fieldsCollectionSchema = z.object({
+    kind: z.literal('fields'),
+    name: z.string().min(1),
+    label: z.string().min(1),
+    labelSingular: z.string().optional(),
+    folder: z.string().min(1),
+    extension: z.enum(['md', 'mdx', 'json', 'yaml']),
+    format: z.enum(['frontmatter', 'json']),
+    identifierField: z.string().optional(),
+    contentField: z.string().optional(),
+    nested: z.boolean().optional(),
+    media: z.record(z.string(), z.unknown()).optional(),
+    create: z.boolean().optional(),
+    fields: z.array(fieldSchema).min(1),
+});
+const fileCollectionSchema = z.object({
+    kind: z.literal('file'),
+    name: z.string().min(1),
+    label: z.string().min(1),
+    format: z.enum(['yaml', 'json']).optional(),
+    files: z
+        .array(z.object({
+        name: z.string().min(1),
+        label: z.string().min(1),
+        file: z.string().min(1),
+        fields: z.array(fieldSchema).optional(),
+        inferSchema: z.boolean().optional(),
+        fieldOverrides: z.record(z.string(), z.record(z.string(), z.unknown())).optional(),
+    }))
+        .min(1),
+});
+export const configSchema = z.object({
+    backend: z.object({
+        name: z.enum(['github', 'local']),
+        repo: z
+            .string()
+            .regex(/^[\w.-]+\/[\w.-]+$/, 'Use the owner/repo form.')
+            .optional(),
+        branch: z.string().min(1).optional(),
+        authBase: z.string().optional(),
+        authEndpoint: z.string().optional(),
+        local: z
+            .object({
+            // `memory` backs the tests, demos and previews; the others are real file access.
+            kind: z.enum(['fs-access', 'proxy', 'memory']),
+            url: z.string().optional(),
+            /** Seed files for the memory backend, keyed by repository path. */
+            files: z.record(z.string(), z.string()).optional(),
+        })
+            .optional(),
+    }),
+    media: z
+        .object({
+        provider: z.enum(['repo', 's3']),
+        repoPath: z.string().optional(),
+        publicPath: z.string().optional(),
+        maxEdge: z.number().int().positive().optional(),
+        exif: z.boolean().optional(),
+        s3: z
+            .object({
+            endpoint: z.string(),
+            bucket: z.string(),
+            publicBase: z.string(),
+        })
+            .optional(),
+    })
+        .optional(),
+    collections: z.array(z.union([fieldsCollectionSchema, fileCollectionSchema])).min(1),
+    locale: z.string().optional(),
+    editorialWorkflow: z.boolean().optional(),
+    preview: z
+        .object({
+        devServerURL: z.string().optional(),
+        pathTemplate: z.string().optional(),
+        editAttribute: z.string().optional(),
+    })
+        .optional(),
+    plugins: z.array(z.unknown()).optional(),
+});
+/**
+ * Validate a config and report every problem at once, so a consumer fixing a typo does not have
+ * to reload repeatedly. Returns the parsed config on success.
+ */
+export function loadConfig(input) {
+    const issues = [];
+    const result = configSchema.safeParse(input);
+    if (!result.success) {
+        for (const issue of result.error.issues) {
+            issues.push({ path: issue.path.join('.'), message: issue.message });
+        }
+        return { config: input, issues };
+    }
+    const config = result.data;
+    const seen = new Set();
+    for (const collection of config.collections) {
+        if (seen.has(collection.name)) {
+            issues.push({
+                path: `collections.${collection.name}`,
+                message: 'Duplicate collection name.',
+            });
+        }
+        seen.add(collection.name);
+        collectFieldIssues(collection, issues);
+    }
+    if (config.backend.name === 'github' && !config.backend.repo) {
+        issues.push({
+            path: 'backend.repo',
+            message: 'The github backend needs a repo.',
+        });
+    }
+    if (config.backend.name === 'local' && !config.backend.local) {
+        issues.push({
+            path: 'backend.local',
+            message: 'The local backend needs a local mode.',
+        });
+    }
+    if (config.media?.provider === 's3' && !config.media.s3) {
+        issues.push({
+            path: 'media.s3',
+            message: 'The s3 media provider needs its settings.',
+        });
+    }
+    return { config, issues };
+}
+function collectFieldIssues(collection, issues) {
+    if (collection.kind !== 'fields')
+        return;
+    const walk = (fields, prefix) => {
+        const names = new Set();
+        for (const field of fields) {
+            const path = `${prefix}${field.name}`;
+            if (names.has(field.name)) {
+                issues.push({
+                    path,
+                    message: 'Duplicate field name in the same object.',
+                });
+            }
+            names.add(field.name);
+            if (field.widget === 'object' && !field.fields?.length) {
+                issues.push({ path, message: 'An object field needs nested fields.' });
+            }
+            if (field.widget === 'list' && !field.fields?.length && !field.field) {
+                issues.push({
+                    path,
+                    message: 'A list field needs either `fields` or `field`.',
+                });
+            }
+            if (field.fields)
+                walk(field.fields, `${path}.`);
+        }
+    };
+    walk(collection.fields, `${collection.name}.`);
+    if (collection.contentField) {
+        const top = collection.fields.some((field) => field.name === collection.contentField);
+        if (!top) {
+            issues.push({
+                path: `${collection.name}.contentField`,
+                message: `No field named "${collection.contentField}".`,
+            });
+        }
+    }
+}
+//# sourceMappingURL=config-load.js.map

package/dist/config-load.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,148 @@
+/**
+ * The config a consumer writes. Everything the CMS does is derived from this object; the CMS
+ * itself never mentions a specific collection or field name.
+ */
+import type { CommonFieldOptions } from './fields.js';
+export interface LocalizedString {
+    [locale: string]: string;
+}
+export interface BackendConfig {
+    /** `github` talks to the REST API. `local` uses a browser directory or the local proxy. */
+    name: 'github' | 'local';
+    /** `owner/repo`, required for the github backend. */
+    repo?: string;
+    branch?: string;
+    /** Base of the OAuth relay, e.g. `https://example.com`. Omit to use a personal access token. */
+    authBase?: string;
+    /**
+     * Path of the relay's endpoint on that base. Defaults to `auth`. A relay mounted under a prefix
+     * — `/api/auth`, say — needs this, and without it the sign-in popup is a 404.
+     */
+    authEndpoint?: string;
+    /** Where the local backend reads and writes. */
+    local?: {
+        /** `memory` backs the tests, demos and previews; the others are real file access. */
+        kind: 'fs-access' | 'proxy' | 'memory';
+        url?: string;
+        /** Seed files for the memory backend, keyed by repository path. */
+        files?: Record<string, string>;
+    };
+}
+export type MediaProvider = 'repo' | 's3';
+export interface MediaConfig {
+    provider: MediaProvider;
+    /** Path inside the repository, supports `{{slug}}` and `{{collection}}`. */
+    repoPath?: string;
+    /** Public URL prefix for the same files, e.g. `/images/albums/{{slug}}`. */
+    publicPath?: string;
+    /** Longest edge in pixels for uploaded images. */
+    maxEdge?: number;
+    /** Read EXIF from uploads to prefill photographic fields. */
+    exif?: boolean;
+    /** Object storage settings, used when `provider` is `s3`. */
+    s3?: {
+        endpoint: string;
+        bucket: string;
+        publicBase: string;
+    };
+}
+/** A field in a collection's schema. `widget` selects the field type. */
+export interface Field extends CommonFieldOptions {
+    /** Nested fields for `object` and for the item shape of `list`. */
+    fields?: Field[];
+    /** Item field for a scalar `list`, e.g. a list of strings. */
+    field?: Field;
+    options?: Array<string | {
+        label: string;
+        value: string;
+    }>;
+    /** Default value written when a new entry or list item is created. */
+    default?: unknown;
+    /** For `object`: omit the whole object when every child is empty. */
+    collapseEmpty?: boolean;
+    /** For `relation`: which collection to draw values from. */
+    collection?: string;
+    valueField?: string;
+    displayFields?: string[];
+    /** For `date`: output format. */
+    format?: string;
+    /** Regex the value must match, plus the message to show when it does not. */
+    pattern?: [string, string];
+    /** Singular label for a list's add button, e.g. "Add 图片". */
+    labelSingular?: string;
+    /** Free-form options passed through to the field type. */
+    [key: string]: unknown;
+}
+export interface CollectionBase {
+    name: string;
+    label: string;
+    labelSingular?: string;
+    /** Directory the entries live in, relative to the repository root. */
+    folder: string;
+    /** Which file extension new entries get. */
+    extension: 'md' | 'mdx' | 'json' | 'yaml';
+    format: 'frontmatter' | 'json';
+    /** Field whose value names an entry, used in URLs and in the entry list. */
+    identifierField?: string;
+    /** Field holding the body; omit for data-only collections. */
+    contentField?: string;
+    /** Allow entries in subdirectories of `folder`. */
+    nested?: boolean;
+    media?: Partial<MediaConfig>;
+    fields: Field[];
+}
+export interface FieldsCollection extends CollectionBase {
+    kind: 'fields';
+    create?: boolean;
+}
+export interface FileEntry {
+    name: string;
+    label: string;
+    /** Single file this entry edits, relative to the repository root. */
+    file: string;
+    fields?: Field[];
+    /** Derive the field list from the file's current contents instead of declaring it. */
+    inferSchema?: boolean;
+    /** Override inferred fields by path, with `*` matching one segment. */
+    fieldOverrides?: Record<string, Partial<Field>>;
+}
+export interface FileCollection {
+    kind: 'file';
+    name: string;
+    label: string;
+    format?: 'yaml' | 'json';
+    files: FileEntry[];
+}
+export type Collection = FieldsCollection | FileCollection;
+export type FieldsCollectionItem = FieldsCollection;
+export type FileCollectionItem = FileCollection;
+export interface PreviewConfig {
+    /** Dev server to embed, e.g. `http://localhost:4321`. */
+    devServerURL?: string;
+    /** URL of an entry inside that server, with `{{slug}}` and `{{collection}}` placeholders. */
+    pathTemplate?: string;
+    /**
+     * In-context editing: the attribute the site marks editable nodes with.
+     *
+     * A theme opts in by rendering `data-v7-field="title"` on the element that shows that field — the
+     * value is the dotted frontmatter path. The editor then outlines those nodes in the embedded
+     * page, and clicking one focuses the matching control.
+     *
+     * Off unless a site asks for it, because it can only work when the site cooperates: an editor
+     * that guessed which node showed which field would be wrong often enough to be worse than none.
+     */
+    editAttribute?: string;
+}
+export interface CMSConfig {
+    backend: BackendConfig;
+    media?: MediaConfig;
+    collections: Collection[];
+    /** UI language. Built in: `en`, `zh-CN`. */
+    locale?: string;
+    /** Turn on draft branches and review status. */
+    editorialWorkflow?: boolean;
+    preview?: PreviewConfig;
+    /** Consumer plugins: custom field types, preview renderers, UI slots. */
+    plugins?: unknown[];
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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

package/dist/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":""}