@krantho/schema 0.0.0-stage → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Descoped
+
+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/archetypes.d.ts

@@ -0,0 +1,39 @@
+import type { ContentContract } from '@krantho/persistence';
+import type { ZodObject, ZodRawShape } from 'zod';
+export interface MetadataArchetype<T extends ZodObject<ZodRawShape> = ZodObject<ZodRawShape>> {
+    readonly id: string;
+    readonly label: string;
+    readonly schema: T;
+}
+export interface MetadataSlot {
+    readonly archetype: MetadataArchetype;
+    readonly required?: boolean | undefined;
+}
+export interface DocumentArchetype<T extends ZodObject<ZodRawShape> = ZodObject<ZodRawShape>> {
+    readonly id: string;
+    readonly label: string;
+    readonly fields: T;
+    readonly metadata: Readonly<Record<string, MetadataSlot>>;
+    readonly body: 'none' | 'optional' | 'required';
+    readonly sections: readonly string[];
+}
+export declare function assertAuthorProperty(name: string): void;
+export declare function contentDigest(value: unknown): string;
+export declare function documentChecksum(value: {
+    fields: Record<string, unknown>;
+    body: string;
+    metadata?: unknown;
+    defaults?: unknown;
+    contract?: {
+        id: string;
+        revision: string;
+    } | null | undefined;
+}): string;
+export declare function defineMetadataArchetype<T extends ZodObject<ZodRawShape>>(definition: MetadataArchetype<T>): MetadataArchetype<T>;
+export declare function defineDocumentArchetype<T extends ZodObject<ZodRawShape>>(definition: Omit<DocumentArchetype<T>, 'metadata' | 'body' | 'sections'> & {
+    metadata?: Readonly<Record<string, MetadataSlot>> | undefined;
+    body?: DocumentArchetype['body'] | undefined;
+    sections?: readonly string[] | undefined;
+}): DocumentArchetype<T>;
+export declare function compileContentContract(archetype: DocumentArchetype, fields?: ZodObject<ZodRawShape>): ContentContract;
+//# sourceMappingURL=archetypes.d.ts.map

package/dist/archetypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archetypes.d.ts","sourceRoot":"","sources":["../src/archetypes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAyB,MAAM,sBAAsB,CAAA;AAClF,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,CAAA;AAGjD,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,SAAS,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC;IAC1F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAA;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACxC;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,SAAS,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC;IAC1F,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAClB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAA;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,CAAA;IAC/C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAwBD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIvD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,GAAG,SAAS,CAAA;CAC/D,GAAG,MAAM,CAQT;AAiCD,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,SAAS,CAAC,WAAW,CAAC,EACtE,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC/B,iBAAiB,CAAC,CAAC,CAAC,CAKtB;AAED,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,SAAS,CAAC,WAAW,CAAC,EACtE,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC,GAAG;IACzE,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,GAAG,SAAS,CAAA;IAC7D,IAAI,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAAG,SAAS,CAAA;IAC5C,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CACzC,GACA,iBAAiB,CAAC,CAAC,CAAC,CA2BtB;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,iBAAiB,EAC5B,MAAM,GAAE,SAAS,CAAC,WAAW,CAAoB,GAChD,eAAe,CAkCjB"}

package/dist/archetypes.js

@@ -0,0 +1,139 @@
+import { createHash } from 'node:crypto';
+import { canonicalJson } from '@krantho/core';
+import { portableJsonSchema } from './portable-schema.js';
+const RESERVED = new Set([
+    'meta',
+    'identity',
+    'basis',
+    'metadata',
+    'contract',
+    'defaults',
+    'body',
+    'html',
+    'sections',
+    'collection',
+    'slug',
+    'locale',
+    'liveVersion',
+    'status',
+    'changedBy',
+    'createdAt',
+    '__proto__',
+    'prototype',
+    'constructor',
+]);
+export function assertAuthorProperty(name) {
+    if (!/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(name) || RESERVED.has(name)) {
+        throw new Error(`Property "${name}" is reserved or invalid`);
+    }
+}
+export function contentDigest(value) {
+    return createHash('sha256').update(canonicalJson(value)).digest('hex');
+}
+export function documentChecksum(value) {
+    return contentDigest({
+        fields: value.fields,
+        body: value.body,
+        metadata: value.metadata ?? {},
+        defaults: value.defaults ?? [],
+        contract: value.contract ? { id: value.contract.id, revision: value.contract.revision } : null,
+    });
+}
+function identity(id, label) {
+    if (!/^[a-zA-Z][a-zA-Z0-9._/-]*$/.test(id) || !label.trim()) {
+        throw new Error('Archetypes require a stable ID and a readable label');
+    }
+}
+function portableSchema(schema) {
+    const result = portableJsonSchema(schema);
+    result['additionalProperties'] = false;
+    strictObjects(result);
+    return result;
+}
+/** Nested groups reject unknown values too, including objects inside arrays. */
+function strictObjects(value) {
+    if (!value || typeof value !== 'object')
+        return;
+    if (Array.isArray(value)) {
+        value.forEach(strictObjects);
+        return;
+    }
+    const record = value;
+    if (record['type'] === 'object' &&
+        record['properties'] &&
+        Object.keys(record['properties']).length > 0)
+        record['additionalProperties'] = false;
+    if (Array.isArray(record['required']))
+        record['required'].sort();
+    Object.values(record).forEach(strictObjects);
+}
+export function defineMetadataArchetype(definition) {
+    identity(definition.id, definition.label);
+    Object.keys(definition.schema.shape).forEach(assertAuthorProperty);
+    portableSchema(definition.schema);
+    return Object.freeze({ ...definition });
+}
+export function defineDocumentArchetype(definition) {
+    identity(definition.id, definition.label);
+    Object.keys(definition.fields.shape).forEach(assertAuthorProperty);
+    Object.keys(definition.metadata ?? {}).forEach(assertAuthorProperty);
+    const sections = (definition.sections ?? []).map((section) => section.trim());
+    if (sections.some((section) => !section) ||
+        new Set(sections.map((section) => section.toLowerCase())).size !== sections.length) {
+        throw new Error('Archetypes require distinct, non-empty section names');
+    }
+    const metadata = Object.freeze(Object.fromEntries(Object.entries(definition.metadata ?? {}).map(([slot, value]) => [
+        slot,
+        Object.freeze({ ...value }),
+    ])));
+    const result = {
+        ...definition,
+        metadata,
+        body: definition.body ?? 'optional',
+        sections: Object.freeze(sections),
+    };
+    compileContentContract(result);
+    return Object.freeze(result);
+}
+export function compileContentContract(archetype, fields = archetype.fields) {
+    const metadata = {};
+    for (const [slot, { archetype: group, required }] of Object.entries(archetype.metadata)) {
+        const schema = portableSchema(group.schema);
+        metadata[slot] = {
+            id: group.id,
+            label: group.label,
+            revision: contentDigest({ id: group.id, schema }),
+            required: required ?? false,
+            schema,
+        };
+    }
+    const resolved = {
+        id: archetype.id,
+        label: archetype.label,
+        fields: portableSchema(fields),
+        metadata,
+        body: archetype.body,
+        sections: [...archetype.sections],
+    };
+    // Labels are presentation: renaming one keeps saved snapshots on the same revision
+    const revision = contentDigest({
+        id: resolved.id,
+        fields: resolved.fields,
+        metadata: Object.fromEntries(Object.entries(metadata).map(([slot, group]) => [
+            slot,
+            { id: group.id, required: group.required, schema: group.schema },
+        ])),
+        body: resolved.body,
+        sections: resolved.sections,
+    });
+    return freezeContract({ ...resolved, revision });
+}
+/** Freeze the JSON contract only; Zod's internal caches remain usable. */
+function freezeContract(value) {
+    if (value && typeof value === 'object') {
+        Object.values(value).forEach(freezeContract);
+        Object.freeze(value);
+    }
+    return value;
+}
+//# sourceMappingURL=archetypes.js.map

package/dist/archetypes.js.map

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

package/dist/collection.d.ts

@@ -0,0 +1,78 @@
+import type { ZodError, ZodObject, ZodRawShape, z } from 'zod';
+import { type DocumentArchetype } from './archetypes.js';
+import { type ParsedRepositoryContent } from './repository-content.js';
+/**
+ * Configuration for a content collection.
+ *
+ * @typeParam T - Zod object schema describing content fields
+ */
+export interface CollectionConfig<T extends ZodObject<ZodRawShape>> {
+    /** Unique collection name — used as namespace for slugs */
+    name: string;
+    /** Where the content is mastered */
+    source: 'filesystem' | 'database';
+    /** Directory path for filesystem-mastered collections (relative to project root) */
+    directory?: string | undefined;
+    /** Zod schema for fields validation and type inference */
+    schema?: T | undefined;
+    /** Explicit reusable contract; use schema for an inline collection contract. */
+    archetype?: DocumentArchetype<T> | undefined;
+    /**
+     * Where the collection's documents render as pages — read by the sitemap,
+     * **Preview on site**, page refresh and JSON-LD through `documentPath()` in
+     * `@krantho/core`. A pattern holding `:slug` (`'/deploy/:slug'`; the slug
+     * `index` renders at `'/deploy'`), a fixed path every document renders at
+     * (`'/'` for a landing singleton), or `false` when the documents have no page
+     * of their own. Unset: `pages` at the site root (`home` at `/`), `globals`
+     * without pages, any other collection at `/<name>/<slug>`.
+     */
+    path?: string | false | undefined;
+    /**
+     * The `##` sections the collection's page template designs, in order — the
+     * template gives each its own treatment, renders other sections as prose and
+     * leaves missing ones out. Studio shows editors which ones a document has.
+     */
+    sections?: readonly string[] | undefined;
+}
+/**
+ * A defined content collection with typed fields.
+ *
+ * @typeParam T - Zod object schema for this collection's fields
+ */
+export interface Collection<T extends ZodObject<ZodRawShape> = ZodObject<ZodRawShape>> {
+    readonly name: string;
+    readonly source: 'filesystem' | 'database';
+    readonly directory: string | undefined;
+    readonly schema: T;
+    readonly archetype: DocumentArchetype<T>;
+    readonly parseDocument: (slug: string, frontmatter: Record<string, unknown>, body: string) => {
+        success: true;
+        data: ParsedRepositoryContent;
+    } | {
+        success: false;
+        error: ZodError;
+    };
+    /** Where the documents render as pages; `undefined` when not declared */
+    readonly path: string | false | undefined;
+    /** The `##` sections the page template designs, in order; empty when it designs none */
+    readonly sections: readonly string[];
+    /** Inferred TypeScript type for validated fields (phantom — never assigned at runtime) */
+    readonly _fields: z.infer<T>;
+}
+/**
+ * Define a content collection with a Zod schema for fields validation.
+ *
+ * @example
+ * ```ts
+ * const pages = defineCollection({
+ *   name: 'pages',
+ *   source: 'filesystem',
+ *   directory: 'content/pages',
+ *   schema: z.object({
+ *     title: z.string(),
+ *   }),
+ * })
+ * ```
+ */
+export declare function defineCollection<T extends ZodObject<ZodRawShape>>(config: CollectionConfig<T>): Collection<T>;
+//# sourceMappingURL=collection.d.ts.map

package/dist/collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC9D,OAAO,EAAE,KAAK,iBAAiB,EAA2B,MAAM,iBAAiB,CAAA;AACjF,OAAO,EAAE,KAAK,uBAAuB,EAA0B,MAAM,yBAAyB,CAAA;AAE9F;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,SAAS,CAAC,WAAW,CAAC;IAChE,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,MAAM,EAAE,YAAY,GAAG,UAAU,CAAA;IACjC,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,CAAC,GAAG,SAAS,CAAA;IACtB,gFAAgF;IAChF,SAAS,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;IAC5C;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;IACjC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;CACzC;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,SAAS,CAAC,WAAW,CAAC,GAAG,SAAS,CAAC,WAAW,CAAC;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAAA;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAA;IAClB,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAA;IACxC,QAAQ,CAAC,aAAa,EAAE,CACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,IAAI,EAAE,MAAM,KACT;QAAE,OAAO,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,uBAAuB,CAAA;KAAE,GAAG;QAAE,OAAO,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,CAAA;IAC3F,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;IACzC,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;CAC7B;AAeD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,SAAS,CAAC,WAAW,CAAC,EAC/D,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC1B,UAAU,CAAC,CAAC,CAAC,CAwCf"}

package/dist/collection.js

@@ -0,0 +1,65 @@
+import { defineDocumentArchetype } from './archetypes.js';
+import { parseRepositoryContent } from './repository-content.js';
+/** The designed sections, checked: each a non-empty heading, none repeated (case aside) */
+function designedSections(collection, sections) {
+    const seen = new Set();
+    for (const section of sections) {
+        const key = section.trim().toLowerCase();
+        if (!key)
+            throw new Error(`Collection "${collection}" has an empty section name`);
+        if (seen.has(key))
+            throw new Error(`Collection "${collection}" lists section "${section}" twice`);
+        seen.add(key);
+    }
+    return sections.map((section) => section.trim());
+}
+/**
+ * Define a content collection with a Zod schema for fields validation.
+ *
+ * @example
+ * ```ts
+ * const pages = defineCollection({
+ *   name: 'pages',
+ *   source: 'filesystem',
+ *   directory: 'content/pages',
+ *   schema: z.object({
+ *     title: z.string(),
+ *   }),
+ * })
+ * ```
+ */
+export function defineCollection(config) {
+    if (!config.name) {
+        throw new Error('Collection name is required');
+    }
+    if (config.source === 'filesystem' && !config.directory) {
+        throw new Error(`Collection "${config.name}" with source "filesystem" requires a "directory" property`);
+    }
+    if (typeof config.path === 'string' && !config.path.startsWith('/')) {
+        throw new Error(`Collection "${config.name}" path "${config.path}" must start with "/"`);
+    }
+    if (Boolean(config.schema) === Boolean(config.archetype)) {
+        throw new Error('A collection requires either schema or archetype');
+    }
+    const archetype = config.archetype ??
+        defineDocumentArchetype({
+            id: `collection/${config.name}`,
+            label: config.name,
+            fields: config.schema,
+            sections: designedSections(config.name, config.sections ?? []),
+        });
+    const collection = {
+        name: config.name,
+        source: config.source,
+        directory: config.directory,
+        schema: archetype.fields,
+        archetype,
+        parseDocument: (slug, frontmatter, body) => parseRepositoryContent(collection, slug, frontmatter, body),
+        path: config.path,
+        sections: designedSections(config.name, config.sections ?? archetype.sections),
+        // Phantom type — never used at runtime, only for type inference
+        _fields: undefined,
+    };
+    return collection;
+}
+//# sourceMappingURL=collection.js.map

package/dist/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection.js","sourceRoot":"","sources":["../src/collection.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AACjF,OAAO,EAAgC,sBAAsB,EAAE,MAAM,yBAAyB,CAAA;AA4D9F,2FAA2F;AAC3F,SAAS,gBAAgB,CAAC,UAAkB,EAAE,QAA2B;IACvE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QACxC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,eAAe,UAAU,6BAA6B,CAAC,CAAA;QACjF,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,eAAe,UAAU,oBAAoB,OAAO,SAAS,CAAC,CAAA;QAChF,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACf,CAAC;IACD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;AAClD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAA2B;IAE3B,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;IAChD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,eAAe,MAAM,CAAC,IAAI,4DAA4D,CACvF,CAAA;IACH,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,eAAe,MAAM,CAAC,IAAI,WAAW,MAAM,CAAC,IAAI,uBAAuB,CAAC,CAAA;IAC1F,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;IACrE,CAAC;IACD,MAAM,SAAS,GACb,MAAM,CAAC,SAAS;QAChB,uBAAuB,CAAC;YACtB,EAAE,EAAE,cAAc,MAAM,CAAC,IAAI,EAAE;YAC/B,KAAK,EAAE,MAAM,CAAC,IAAI;YAClB,MAAM,EAAE,MAAM,CAAC,MAAW;YAC1B,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;SAC/D,CAAC,CAAA;IACJ,MAAM,UAAU,GAAkB;QAChC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,SAAS;QACT,aAAa,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CACzC,sBAAsB,CAAC,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC;QAC7D,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS,CAAC,QAAQ,CAAC;QAC9E,gEAAgE;QAChE,OAAO,EAAE,SAAkC;KAC5C,CAAA;IACD,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,27 @@
+import type { ZodObject, ZodRawShape } from 'zod';
+import type { Collection } from './collection.js';
+/**
+ * Input to defineConfig — a record of named collections.
+ */
+export interface ContentConfigInput {
+    collections: Record<string, Collection<ZodObject<ZodRawShape>>>;
+}
+/**
+ * Resolved content configuration. Carries the full collection map
+ * for use by the content engine and validation functions.
+ */
+export interface ContentConfig {
+    readonly collections: ReadonlyMap<string, Collection<ZodObject<ZodRawShape>>>;
+}
+/**
+ * Define the project-level content configuration.
+ *
+ * @example
+ * ```ts
+ * export default defineConfig({
+ *   collections: { pages, blog },
+ * })
+ * ```
+ */
+export declare function defineConfig(input: ContentConfigInput): ContentConfig;
+//# 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":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,KAAK,CAAA;AAEjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;CAChE;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;CAC9E;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CA8BrE"}

package/dist/config.js

@@ -0,0 +1,38 @@
+import { compileContentContract } from './archetypes.js';
+/**
+ * Define the project-level content configuration.
+ *
+ * @example
+ * ```ts
+ * export default defineConfig({
+ *   collections: { pages, blog },
+ * })
+ * ```
+ */
+export function defineConfig(input) {
+    const entries = Object.entries(input.collections);
+    if (entries.length === 0) {
+        throw new Error('defineConfig requires at least one collection');
+    }
+    const definitions = new Map();
+    const register = (id, revision) => {
+        const existing = definitions.get(id);
+        if (existing !== undefined && existing !== revision)
+            throw new Error(`Archetype "${id}" has incompatible definitions; give each variant its own identity`);
+        definitions.set(id, revision);
+    };
+    // Verify collection names match their record keys
+    for (const [key, collection] of entries) {
+        const contract = compileContentContract(collection.archetype);
+        register(contract.id, contract.revision);
+        for (const group of Object.values(contract.metadata))
+            register(group.id, group.revision);
+        if (key !== collection.name) {
+            throw new Error(`Collection key "${key}" does not match collection name "${collection.name}"`);
+        }
+    }
+    return {
+        collections: new Map(entries),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAkBxD;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAAC,KAAyB;IACpD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IAEjD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;IAClE,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC7C,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAE,QAAgB,EAAQ,EAAE;QACtD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACpC,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,QAAQ;YACjD,MAAM,IAAI,KAAK,CACb,cAAc,EAAE,oEAAoE,CACrF,CAAA;QACH,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;IAC/B,CAAC,CAAA;IAED,kDAAkD;IAClD,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,OAAO,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;QAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;QACxC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;QACxF,IAAI,GAAG,KAAK,UAAU,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,qCAAqC,UAAU,CAAC,IAAI,GAAG,CAAC,CAAA;QAChG,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW,EAAE,IAAI,GAAG,CAAC,OAAO,CAAC;KAC9B,CAAA;AACH,CAAC"}

package/dist/content-archetypes.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+export declare const editorialMetadata: import("./archetypes.js").MetadataArchetype<z.ZodObject<{
+    byline: z.ZodString;
+}, z.core.$strip>>;
+export declare const publicationMetadata: import("./archetypes.js").MetadataArchetype<z.ZodObject<{
+    date: z.ZodISODateTime;
+}, z.core.$strip>>;
+export declare const classificationMetadata: import("./archetypes.js").MetadataArchetype<z.ZodObject<{
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    category: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+/** Sharing is optional authored content. A site may use it without enabling SEO. */
+export declare const sharingMetadata: import("./archetypes.js").MetadataArchetype<z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    image: z.ZodOptional<z.ZodString>;
+    canonicalUrl: z.ZodOptional<z.ZodURL>;
+    index: z.ZodOptional<z.ZodBoolean>;
+    follow: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>>;
+/**
+ * A page's own structured data: the Schema.org graph the editor's Data mode
+ * edits, versioned with the page. Declare it as the `seo` slot.
+ */
+export declare const structuredDataMetadata: import("./archetypes.js").MetadataArchetype<z.ZodObject<z.core.$ZodLooseShape, z.core.$strip>>;
+export declare const websiteContent: import("./archetypes.js").DocumentArchetype<z.ZodObject<{
+    title: z.ZodString;
+    summary: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+export declare const blogContent: import("./archetypes.js").DocumentArchetype<z.ZodObject<{
+    title: z.ZodString;
+    excerpt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=content-archetypes.d.ts.map

package/dist/content-archetypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-archetypes.d.ts","sourceRoot":"","sources":["../src/content-archetypes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,eAAO,MAAM,iBAAiB;;kBAI5B,CAAA;AAEF,eAAO,MAAM,mBAAmB;;kBAM9B,CAAA;AAEF,eAAO,MAAM,sBAAsB;;;kBAIjC,CAAA;AAEF,oFAAoF;AACpF,eAAO,MAAM,eAAe;;;;;;;kBAW1B,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,gGAIjC,CAAA;AAEF,eAAO,MAAM,cAAc;;;kBAQzB,CAAA;AAEF,eAAO,MAAM,WAAW;;;kBAWtB,CAAA"}

package/dist/content-archetypes.js

@@ -0,0 +1,64 @@
+import { DOCUMENT_SEO_METADATA_SCHEMA } from '@krantho/seo-shared';
+import { z } from 'zod';
+import { defineDocumentArchetype, defineMetadataArchetype } from './archetypes.js';
+export const editorialMetadata = defineMetadataArchetype({
+    id: 'krantho/editorial',
+    label: 'Editorial',
+    schema: z.object({ byline: z.string().min(1).describe('The name readers see as the author.') }),
+});
+export const publicationMetadata = defineMetadataArchetype({
+    id: 'krantho/publication',
+    label: 'Publication',
+    schema: z.object({
+        date: z.iso.datetime().describe('When the page is published.'),
+    }),
+});
+export const classificationMetadata = defineMetadataArchetype({
+    id: 'krantho/classification',
+    label: 'Topics',
+    schema: z.object({ tags: z.array(z.string()).optional(), category: z.string().optional() }),
+});
+/** Sharing is optional authored content. A site may use it without enabling SEO. */
+export const sharingMetadata = defineMetadataArchetype({
+    id: 'krantho/sharing',
+    label: 'Search and sharing',
+    schema: z.object({
+        title: z.string().optional(),
+        description: z.string().optional(),
+        image: z.string().describe('media').optional(),
+        canonicalUrl: z.url().optional(),
+        index: z.boolean().optional(),
+        follow: z.boolean().optional(),
+    }),
+});
+/**
+ * A page's own structured data: the Schema.org graph the editor's Data mode
+ * edits, versioned with the page. Declare it as the `seo` slot.
+ */
+export const structuredDataMetadata = defineMetadataArchetype({
+    id: 'krantho/structured-data',
+    label: 'Structured data',
+    schema: z.fromJSONSchema(DOCUMENT_SEO_METADATA_SCHEMA),
+});
+export const websiteContent = defineDocumentArchetype({
+    id: 'krantho/website-content',
+    label: 'Website content',
+    fields: z.object({ title: z.string(), summary: z.string().optional() }),
+    metadata: {
+        classification: { archetype: classificationMetadata },
+        sharing: { archetype: sharingMetadata },
+    },
+});
+export const blogContent = defineDocumentArchetype({
+    id: 'krantho/blog-post',
+    label: 'Blog post',
+    fields: z.object({ title: z.string(), excerpt: z.string().optional() }),
+    body: 'required',
+    metadata: {
+        editorial: { archetype: editorialMetadata, required: true },
+        publication: { archetype: publicationMetadata },
+        classification: { archetype: classificationMetadata },
+        sharing: { archetype: sharingMetadata },
+    },
+});
+//# sourceMappingURL=content-archetypes.js.map

package/dist/content-archetypes.js.map

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

package/dist/contract-codegen.d.ts

@@ -0,0 +1,11 @@
+import type { ContentContract } from '@krantho/persistence';
+interface CollectionBinding {
+    name: string;
+    source: 'filesystem' | 'database';
+    directory?: string | undefined;
+    path?: string | false | undefined;
+}
+/** Code adoption retains the complete portable contract, including nested constraints and groups. */
+export declare function exportContractAsZod(binding: CollectionBinding, contract: ContentContract): string;
+export {};
+//# sourceMappingURL=contract-codegen.d.ts.map

package/dist/contract-codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-codegen.d.ts","sourceRoot":"","sources":["../src/contract-codegen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,YAAY,GAAG,UAAU,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAA;CAClC;AAED,qGAAqG;AACrG,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe,GAAG,MAAM,CA8BjG"}

package/dist/contract-codegen.js

@@ -0,0 +1,29 @@
+/** Code adoption retains the complete portable contract, including nested constraints and groups. */
+export function exportContractAsZod(binding, contract) {
+    const groupEntries = Object.entries(contract.metadata);
+    const imports = groupEntries.length
+        ? 'defineCollection, defineDocumentArchetype, defineMetadataArchetype, fromPortableJsonSchema'
+        : 'defineCollection, defineDocumentArchetype, fromPortableJsonSchema';
+    const groups = groupEntries.map(([slot, group]) => `    ${JSON.stringify(slot)}: { required: ${group.required}, archetype: defineMetadataArchetype({\n` +
+        `      id: ${JSON.stringify(group.id)}, label: ${JSON.stringify(group.label)},\n` +
+        `      schema: fromPortableJsonSchema(${JSON.stringify(group.schema, null, 2)}),\n` +
+        '    }) },');
+    const routing = binding.path === undefined ? '' : `  path: ${JSON.stringify(binding.path)},\n`;
+    const directory = binding.directory === undefined ? '' : `  directory: ${JSON.stringify(binding.directory)},\n`;
+    return `import { ${imports} } from '@krantho/schema'
+
+// Review the collection directory before adopting this definition in your repository.
+export const collection_${binding.name.replace(/[^a-zA-Z0-9_$]/g, '_')} = defineCollection({
+  name: ${JSON.stringify(binding.name)}, source: ${JSON.stringify(binding.source)},
+${directory}${routing}  archetype: defineDocumentArchetype({
+    id: ${JSON.stringify(contract.id)}, label: ${JSON.stringify(contract.label)},
+    body: ${JSON.stringify(contract.body)}, sections: ${JSON.stringify(contract.sections)},
+    fields: fromPortableJsonSchema(${JSON.stringify(contract.fields, null, 2)}),
+    metadata: {
+${groups.join('\n')}
+    },
+  }),
+})
+`;
+}
+//# sourceMappingURL=contract-codegen.js.map

package/dist/contract-codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-codegen.js","sourceRoot":"","sources":["../src/contract-codegen.ts"],"names":[],"mappings":"AASA,qGAAqG;AACrG,MAAM,UAAU,mBAAmB,CAAC,OAA0B,EAAE,QAAyB;IACvF,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACtD,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM;QACjC,CAAC,CAAC,4FAA4F;QAC9F,CAAC,CAAC,mEAAmE,CAAA;IACvE,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAC7B,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAChB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,KAAK,CAAC,QAAQ,0CAA0C;QACpG,aAAa,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK;QACjF,wCAAwC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM;QACnF,WAAW,CACd,CAAA;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAA;IAC9F,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAA;IAC/F,OAAO,YAAY,OAAO;;;0BAGF,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC;UAC5D,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;EAC/E,SAAS,GAAG,OAAO;UACX,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC;YACnE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;qCACpD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;;EAE3E,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;;;;CAIlB,CAAA;AACD,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,31 @@
+/**
+ * A single validation error with context for debugging.
+ */
+export interface ValidationError {
+    collection: string;
+    slug: string;
+    field: string;
+    message: string;
+    expected: string;
+    received: string;
+}
+/**
+ * Result of validating all content across all collections.
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors: readonly ValidationError[];
+    summary: {
+        total: number;
+        valid: number;
+        invalid: number;
+    };
+}
+/**
+ * Thrown when content validation fails in strict mode.
+ */
+export declare class ContentValidationError extends Error {
+    readonly errors: readonly ValidationError[];
+    constructor(errors: readonly ValidationError[]);
+}
+//# sourceMappingURL=errors.d.ts.map