@micacms/astro 0.5.0 → 0.6.0-rc.2

package/README.md

@@ -1,7 +1,7 @@
 # @micacms/astro
 
-> **Experimental.** Pre-1.0: the API and the content format can still change
-> without notice. Use it at your own risk.
+> **Public.** From 1.0, semver covers this package. Pre-1.0: the API and the
+> content format can still change in a minor release.
 
 Reads a Mica content repository as Astro Content Collections, through the
 Content Layer API — and publishes the content model for Mica to read back.
@@ -68,6 +68,17 @@ Astro hands a loader exactly what they require:
   loader watches its own directory and coalesces the burst of writes that saving
   one entry produces (`debounceMs`, 100 ms by default).
 
+Image fields reach Astro as Astro images: a `media({ accept: "image" })` field
+is `ImageMetadata`, optimised like Astro's own `image()`, and with `alt` it is
+`{ src, alt }` — `<Image {...entry.data.cover} />` needs no helper. Other media
+stay paths from the content root.
+
+The loaders also check references: a relation to a missing entry, or a missing
+file of a media field that is not an image, is a warning in the build log.
+`strict: true` makes it fail the build. A missing image file always fails the
+build, as with Astro's own `image()`. An entry in the other layout always fails the build, with the
+files and `npx mica migrate-layout`.
+
 ## Mixing with your own collections
 
 The return value is a plain object:
@@ -97,7 +108,8 @@ collections. They ship with the package, so they match the installed version.
 ## Install
 
 ```bash
-npm install @micacms/astro
+npm install @micacms/astro @micacms/core
 ```
 
-Astro 6 or 7 is a peer dependency. Requires Node 22.12 or newer. Licence: MIT.
+Astro 7, `@micacms/core` and zod 4 are peer dependencies. npm installs zod. ESM only. Requires Node 24 or newer.
+Licence: MIT.

package/dist/images.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Image fields reach Astro through its own `image()`, which resolves a path
+ * against the entry's file, optimizes the image and gives `ImageMetadata`. A
+ * site then needs no helper: `<Image {...entry.data.cover} />`.
+ */
+import type { FieldMap } from "@micacms/core";
+/**
+ * Rewrites the paths of `media({ accept: "image" })` fields, which the reader
+ * gives from the content root, to paths from the entry's data file.
+ */
+export declare function imagePathsFromEntry(fields: FieldMap, data: Record<string, unknown>, dataFile: string): Record<string, unknown>;
+//# sourceMappingURL=images.d.ts.map

package/dist/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../src/images.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,QAAQ,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB"}

package/dist/images.js

@@ -0,0 +1,41 @@
+/**
+ * Image fields reach Astro through its own `image()`, which resolves a path
+ * against the entry's file, optimizes the image and gives `ImageMetadata`. A
+ * site then needs no helper: `<Image {...entry.data.cover} />`.
+ */
+import { posix } from "node:path";
+/**
+ * Rewrites the paths of `media({ accept: "image" })` fields, which the reader
+ * gives from the content root, to paths from the entry's data file.
+ */
+export function imagePathsFromEntry(fields, data, dataFile) {
+    const from = posix.dirname(dataFile);
+    const relative = (path) => {
+        if (typeof path !== "string" || path === "")
+            return path;
+        const result = posix.relative(from, path);
+        return result.startsWith(".") ? result : `./${result}`;
+    };
+    const one = (value) => isRecord(value) ? { ...value, path: relative(value["path"]) } : relative(value);
+    const visit = (map, record) => {
+        const result = { ...record };
+        for (const [key, field] of Object.entries(map)) {
+            const value = record[key];
+            if (field.kind === "media" && field.accept === "image") {
+                result[key] = Array.isArray(value) ? value.map(one) : one(value);
+            }
+            else if (field.kind === "object" && isRecord(value)) {
+                result[key] = visit(field.fields, value);
+            }
+            else if (field.kind === "repeater" && Array.isArray(value)) {
+                result[key] = value.map((row) => (isRecord(row) ? visit(field.fields, row) : row));
+            }
+        }
+        return result;
+    };
+    return visit(fields, data);
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+//# sourceMappingURL=images.js.map

package/dist/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../src/images.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAIlC;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAgB,EAChB,IAA6B,EAC7B,QAAgB;IAEhB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,CAAC,IAAa,EAAW,EAAE;QAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QACzD,MAAM,MAAM,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,CAAC;IACzD,CAAC,CAAC;IACF,MAAM,GAAG,GAAG,CAAC,KAAc,EAAW,EAAE,CACtC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElF,MAAM,KAAK,GAAG,CAAC,GAAa,EAAE,MAA+B,EAA2B,EAAE;QACxF,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBACvD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACnE,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC3C,CAAC;iBAAM,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC7D,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC","sourcesContent":["/**\n * Image fields reach Astro through its own `image()`, which resolves a path\n * against the entry's file, optimizes the image and gives `ImageMetadata`. A\n * site then needs no helper: `<Image {...entry.data.cover} />`.\n */\n\nimport { posix } from \"node:path\";\n\nimport type { FieldMap } from \"@micacms/core\";\n\n/**\n * Rewrites the paths of `media({ accept: \"image\" })` fields, which the reader\n * gives from the content root, to paths from the entry's data file.\n */\nexport function imagePathsFromEntry(\n  fields: FieldMap,\n  data: Record<string, unknown>,\n  dataFile: string,\n): Record<string, unknown> {\n  const from = posix.dirname(dataFile);\n  const relative = (path: unknown): unknown => {\n    if (typeof path !== \"string\" || path === \"\") return path;\n    const result = posix.relative(from, path);\n    return result.startsWith(\".\") ? result : `./${result}`;\n  };\n  const one = (value: unknown): unknown =>\n    isRecord(value) ? { ...value, path: relative(value[\"path\"]) } : relative(value);\n\n  const visit = (map: FieldMap, record: Record<string, unknown>): Record<string, unknown> => {\n    const result = { ...record };\n    for (const [key, field] of Object.entries(map)) {\n      const value = record[key];\n      if (field.kind === \"media\" && field.accept === \"image\") {\n        result[key] = Array.isArray(value) ? value.map(one) : one(value);\n      } else if (field.kind === \"object\" && isRecord(value)) {\n        result[key] = visit(field.fields, value);\n      } else if (field.kind === \"repeater\" && Array.isArray(value)) {\n        result[key] = value.map((row) => (isRecord(row) ? visit(field.fields, row) : row));\n      }\n    }\n    return result;\n  };\n\n  return visit(fields, data);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n"]}

package/dist/index.d.ts

@@ -16,6 +16,7 @@
  * Publishing is a commit, and CI builds the commit.
  */
 import { type ContentSource, type InferCollection, type InferSingleton, type Site } from "@micacms/core";
+import type { ImageMetadata } from "astro";
 import { z } from "zod";
 import { DEFAULT_CONTENT_ROOT, resolveContentRoot } from "./root.js";
 export interface MicaCollectionsOptions {
@@ -45,6 +46,12 @@ export interface MicaCollectionsOptions {
      * after the burst is both faster and less confusing than one per file.
      */
     debounceMs?: number;
+    /**
+     * Fails the build on a relation to a missing entry or a missing media file.
+     * Without it, the build logs a warning for each and goes on; a missing image
+     * file fails the build either way, because Astro cannot import it.
+     */
+    strict?: boolean;
 }
 /**
  * Entry metadata attached to every collection document.
@@ -80,12 +87,15 @@ export interface AstroCollectionConfig<T = unknown> {
     type: "content_layer";
     loader: ContentLoader;
     /**
-     * Typed as `ZodType<T>` rather than a bare `ZodObject`, because Astro derives
-     * `CollectionEntry<"projects">["data"]` from `z.infer` of whatever this is.
-     * Left generic, every field in every template would degrade to `any` — and
-     * the point of the shared model is that renaming a field breaks the build.
+     * A function, so that Astro hands in its `image()`. Its result is typed as
+     * `ZodType<T>` because Astro derives `CollectionEntry<"projects">["data"]`
+     * from it: left generic, every field in every template would degrade to
+     * `any`, and the point of the shared model is that renaming a field breaks
+     * the build.
      */
-    schema: z.ZodType<T>;
+    schema: (context: {
+        image: () => z.ZodType;
+    }) => z.ZodType<T>;
 }
 /** The subset of Astro's `Loader` contract this package uses. */
 export interface ContentLoader {
@@ -99,6 +109,7 @@ export interface LoaderContext {
             id: string;
             data: Record<string, unknown>;
             digest?: string;
+            filePath?: string;
         }): boolean;
         keys(): string[];
     };
@@ -133,27 +144,22 @@ export interface LoaderContext {
     parseData(input: {
         id: string;
         data: Record<string, unknown>;
+        /** The entry's file, from the project root: Astro's `image()` resolves paths against it. */
+        filePath?: string;
     }): Promise<Record<string, unknown>>;
     generateDigest(data: Record<string, unknown> | string): string;
 }
 export type MicaCollections<S extends Site> = {
-    [K in keyof S["collections"]]: AstroCollectionConfig<AstroDocument<InferCollection<S["collections"][K]>>>;
+    [K in keyof S["collections"]]: AstroCollectionConfig<CollectionDocument<S, K>>;
 } & {
-    [K in keyof S["singletons"]]: AstroCollectionConfig<InferSingleton<S["singletons"][K]>>;
+    [K in keyof S["singletons"]]: AstroCollectionConfig<SingletonDocument<S, K>>;
 };
 export declare function micaCollections<S extends Site>(site: S, options?: MicaCollectionsOptions): MicaCollections<S>;
 /** The document type for one collection, as it appears in Astro. */
-export type CollectionDocument<S extends Site, K extends keyof S["collections"]> = AstroDocument<InferCollection<S["collections"][K]>>;
+export type CollectionDocument<S extends Site, K extends keyof S["collections"]> = AstroDocument<InferCollection<S["collections"][K], ImageMetadata>>;
 /** The document type for one singleton. */
-export type SingletonDocument<S extends Site, K extends keyof S["singletons"]> = InferSingleton<S["singletons"][K]>;
+export type SingletonDocument<S extends Site, K extends keyof S["singletons"]> = InferSingleton<S["singletons"][K], ImageMetadata>;
 export { manifestFor } from "./manifest.js";
 export { DEFAULT_CONTENT_ROOT, resolveContentRoot };
 export { renderRichText, transformRichText, validateRichText, type RichTextOptions, } from "./richtext.js";
-/**
- * Re-exported for convenience, so a project that only depends on this package
- * can still build a source or read a collection. They are defined in
- * `@micacms/core`, where the Mica server can reach them too.
- */
-export { ContentReadError, ContentSourceError, ORDER_FILE, memorySource, readCollection, readSingleton, type ContentSource, type DirectoryEntry, } from "@micacms/core";
-export { fileSystemSource } from "@micacms/core/node";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -17,9 +17,11 @@
  */
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join, relative, sep } from "node:path";
-import { fieldsSchema, isFieldKind, MANIFEST_PATH, readCollection, readSingleton, } from "@micacms/core";
+import { fileURLToPath } from "node:url";
+import { collectionEntryPath, createReferenceCheck, entryLayout, fieldsSchema, INDEX_FILE, singletonPath, isFieldKind, MANIFEST_PATH, readCollection, readSingleton, } from "@micacms/core";
 import { fileSystemSource } from "@micacms/core/node";
 import { z } from "zod";
+import { imagePathsFromEntry } from "./images.js";
 import { manifestFor } from "./manifest.js";
 import { DEFAULT_CONTENT_ROOT, resolveContentRoot } from "./root.js";
 const metaSchema = z.object({
@@ -46,6 +48,31 @@ export function micaCollections(site, options = {}) {
         options.publishModel === false || options.source
             ? Promise.resolve()
             : publishModel(site, rootFor(context), context.logger));
+    /** An entry's data file, from the content root and, outside tests, from the project root. */
+    const entryFile = (context, fields, name, slug) => {
+        const base = slug === undefined ? singletonPath(fields, name) : collectionEntryPath(fields, name, slug);
+        const inContent = entryLayout(fields) === "directory" ? `${base}/${INDEX_FILE}` : base;
+        const project = context.config?.root;
+        const inProject = project && !options.source
+            ? relative(fileURLToPath(project), join(rootFor(context), inContent)).split(sep).join("/")
+            : undefined;
+        return { inContent, inProject };
+    };
+    /** Warns about broken relations and missing files, or fails the build with `strict`. */
+    const checkReferences = async (context, source, documents) => {
+        const check = createReferenceCheck(site, source);
+        const problems = [];
+        for (const { label, fields, data } of documents) {
+            for (const issue of await check.issues(fields, data))
+                problems.push(`${label}: ${issue.path}: ${issue.message}`);
+        }
+        if (problems.length === 0)
+            return;
+        if (options.strict)
+            throw new Error(`Broken references:\n  ${problems.join("\n  ")}`);
+        for (const problem of problems)
+            context.logger.warn(problem);
+    };
     /** Collections whose watcher is already registered, so a reload adds none. */
     const watching = new Set();
     const watch = (context, name, reload) => {
@@ -87,10 +114,7 @@ export function micaCollections(site, options = {}) {
     for (const [name, def] of Object.entries(site.collections)) {
         collections[name] = {
             type: "content_layer",
-            // `storage` rather than `output`: a media reference is a path into the
-            // repository at rest and a path into the repository once loaded. There
-            // is no expansion step left to tell the two apart.
-            schema: fieldsSchema(def.fields, "storage").extend({ _mica: metaSchema }),
+            schema: ({ image }) => fieldsSchema(def.fields, { image }).extend({ _mica: metaSchema }),
             loader: {
                 name: `mica:${name}`,
                 load: async (context) => {
@@ -107,12 +131,20 @@ export function micaCollections(site, options = {}) {
                                 collection: name,
                                 position: entry.position,
                             };
+                            const file = entryFile(context, def.fields, name, entry.slug);
                             const data = await context.parseData({
                                 id: entry.slug,
-                                data: { ...entry.data, _mica: meta },
+                                data: { ...imagePathsFromEntry(def.fields, entry.data, file.inContent), _mica: meta },
+                                ...(file.inProject ? { filePath: file.inProject } : {}),
+                            });
+                            context.store.set({
+                                id: entry.slug,
+                                data,
+                                digest: context.generateDigest(data),
+                                ...(file.inProject ? { filePath: file.inProject } : {}),
                             });
-                            context.store.set({ id: entry.slug, data, digest: context.generateDigest(data) });
                         }
+                        await checkReferences(context, source, entries.map((entry) => ({ label: `${name}/${entry.slug}`, fields: def.fields, data: entry.data })));
                         context.logger.info(`Loaded ${entries.length} ${entries.length === 1 ? "entry" : "entries"} of "${def.label}"`);
                     };
                     await publish(context);
@@ -127,7 +159,7 @@ export function micaCollections(site, options = {}) {
     for (const [name, def] of Object.entries(site.singletons)) {
         collections[name] = {
             type: "content_layer",
-            schema: fieldsSchema(def.fields, "storage"),
+            schema: ({ image }) => fieldsSchema(def.fields, { image }),
             loader: {
                 name: `mica:${name}`,
                 load: async (context) => {
@@ -142,8 +174,19 @@ export function micaCollections(site, options = {}) {
                             context.logger.warn(`No content for "${def.label}" yet.`);
                             return;
                         }
-                        const parsed = await context.parseData({ id: name, data });
-                        context.store.set({ id: name, data: parsed, digest: context.generateDigest(parsed) });
+                        await checkReferences(context, source, [{ label: name, fields: def.fields, data }]);
+                        const file = entryFile(context, def.fields, name);
+                        const parsed = await context.parseData({
+                            id: name,
+                            data: imagePathsFromEntry(def.fields, data, file.inContent),
+                            ...(file.inProject ? { filePath: file.inProject } : {}),
+                        });
+                        context.store.set({
+                            id: name,
+                            data: parsed,
+                            digest: context.generateDigest(parsed),
+                            ...(file.inProject ? { filePath: file.inProject } : {}),
+                        });
                     };
                     await publish(context);
                     await read();
@@ -231,11 +274,4 @@ async function guard(context, source, read) {
 export { manifestFor } from "./manifest.js";
 export { DEFAULT_CONTENT_ROOT, resolveContentRoot };
 export { renderRichText, transformRichText, validateRichText, } from "./richtext.js";
-/**
- * Re-exported for convenience, so a project that only depends on this package
- * can still build a source or read a collection. They are defined in
- * `@micacms/core`, where the Mica server can reach them too.
- */
-export { ContentReadError, ContentSourceError, ORDER_FILE, memorySource, readCollection, readSingleton, } from "@micacms/core";
-export { fileSystemSource } from "@micacms/core/node";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @micacms/astro — a Git repository as an Astro content source.\n *\n *   // src/content.config.ts — the model is in src/mica.ts\n *   import { micaCollections } from \"@micacms/astro\";\n *   import { site } from \"./mica\";\n *\n *   export const collections = micaCollections(site);\n *\n * From there the website uses ordinary Astro APIs — `getCollection(\"projects\")`\n * — and knows nothing about how the content arrived.\n *\n * There is no CMS in this path. The loaders read files that are already in the\n * working tree, so a build needs a checkout and nothing else: no running\n * server, no token, no network. That is the point of the Git-native design.\n * Publishing is a commit, and CI builds the commit.\n */\n\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { dirname, join, relative, sep } from \"node:path\";\n\nimport {\n  fieldsSchema,\n  isFieldKind,\n  MANIFEST_PATH,\n  readCollection,\n  readSingleton,\n  type Collection,\n  type ContentSource,\n  type FieldMap,\n  type InferCollection,\n  type InferSingleton,\n  type Singleton,\n  type Site,\n} from \"@micacms/core\";\nimport { fileSystemSource } from \"@micacms/core/node\";\nimport { z } from \"zod\";\n\nimport { manifestFor } from \"./manifest.js\";\nimport { DEFAULT_CONTENT_ROOT, resolveContentRoot } from \"./root.js\";\n\nexport interface MicaCollectionsOptions {\n  /**\n   * Overrides `defineSite({ root })`, which is where the content root belongs.\n   *\n   * Relative paths resolve against the Astro project root, like Astro's own\n   * `glob({ base })`. An absolute path is used as given — which is what a\n   * project whose content is a separate repository, checked out by CI\n   * somewhere else, wants.\n   */\n  root?: string;\n  /** Overrides `root` entirely. Used by tests, and by a non-filesystem source. */\n  source?: ContentSource;\n  /**\n   * Turns off publishing the model to `<root>/.mica/schema.json`.\n   *\n   * Only for a project that is not edited through Mica at all: without that\n   * file in the repository, Mica has no model and refuses to start.\n   */\n  publishModel?: false;\n  /**\n   * How long to wait after a content change before reloading, in dev.\n   *\n   * Saving one entry touches several files — `index.json` and every `.mdoc`\n   * beside it — and a Git checkout touches all of them at once. One reload\n   * after the burst is both faster and less confusing than one per file.\n   */\n  debounceMs?: number;\n}\n\n/**\n * Entry metadata attached to every collection document.\n *\n * No timestamps: in Git they are commit metadata, which a static build cannot\n * read cheaply. A date an editor cares about belongs in the model as a `date()` field.\n *\n * Namespaced because these keys share a namespace with the customer's own\n * fields, and `position` is a plausible field name.\n */\nexport interface MicaMeta {\n  /** The entry slug, which is its identity in the repository. */\n  id: string;\n  slug: string;\n  collection: string;\n  /** Index in the collection's order, manual when `_order.json` says so. */\n  position: number;\n}\n\nconst metaSchema = z.object({\n  id: z.string(),\n  slug: z.string(),\n  collection: z.string(),\n  position: z.number(),\n});\n\n/** What a document looks like inside Astro: the payload plus `_mica`. */\nexport type AstroDocument<T> = T & { _mica: MicaMeta };\n\n/**\n * The shape Astro's config loader expects.\n *\n * Deliberately not built with `defineCollection` from `astro:content`: that is a\n * virtual module, resolvable only inside an Astro app's module graph, and this\n * package is pre-compiled. `defineCollection` does nothing more than stamp this\n * `type`, so producing the object directly keeps the package importable\n * anywhere — including from a plain unit test.\n */\nexport interface AstroCollectionConfig<T = unknown> {\n  type: \"content_layer\";\n  loader: ContentLoader;\n  /**\n   * Typed as `ZodType<T>` rather than a bare `ZodObject`, because Astro derives\n   * `CollectionEntry<\"projects\">[\"data\"]` from `z.infer` of whatever this is.\n   * Left generic, every field in every template would degrade to `any` — and\n   * the point of the shared model is that renaming a field breaks the build.\n   */\n  schema: z.ZodType<T>;\n}\n\n/** The subset of Astro's `Loader` contract this package uses. */\nexport interface ContentLoader {\n  name: string;\n  load(context: LoaderContext): Promise<void>;\n}\n\nexport interface LoaderContext {\n  store: {\n    clear(): void;\n    set(entry: { id: string; data: Record<string, unknown>; digest?: string }): boolean;\n    keys(): string[];\n  };\n  logger: {\n    info(message: string): void;\n    warn(message: string): void;\n    error(message: string): void;\n    debug(message: string): void;\n  };\n  meta: { get(key: string): string | undefined; set(key: string, value: string): void };\n  /**\n   * Astro's resolved config. Optional because this interface is a hand-written\n   * subset and the tests build a context by hand; `config.root` is what turns a\n   * relative content root into a path.\n   */\n  config?: { root: URL };\n  /**\n   * Present only while `astro dev` runs. Astro's watcher follows the module\n   * graph, and content files are not in it — no page imports\n   * `projects/haus-a/index.json` — so each loader watches its own directory\n   * here, exactly as Astro's own `glob` loader does.\n   */\n  watcher?: {\n    add(path: string): void;\n    on(event: \"add\" | \"change\" | \"unlink\", handler: (path: string) => void): void;\n  };\n  parseData(input: {\n    id: string;\n    data: Record<string, unknown>;\n  }): Promise<Record<string, unknown>>;\n  generateDigest(data: Record<string, unknown> | string): string;\n}\n\nexport type MicaCollections<S extends Site> = {\n  [K in keyof S[\"collections\"]]: AstroCollectionConfig<\n    AstroDocument<InferCollection<S[\"collections\"][K]>>\n  >;\n} & {\n  [K in keyof S[\"singletons\"]]: AstroCollectionConfig<InferSingleton<S[\"singletons\"][K]>>;\n};\n\nexport function micaCollections<S extends Site>(\n  site: S,\n  options: MicaCollectionsOptions = {},\n): MicaCollections<S> {\n  assertKnownKinds(site);\n\n  /**\n   * Everything below is resolved on first load rather than here, because the\n   * Astro project root is something only a loader is told — and it is what\n   * turns `./content` into a directory. Memoised: one root and one source,\n   * however many collections and however many reloads.\n   */\n  let root: string | undefined;\n  let source: ContentSource | undefined;\n\n  const rootFor = (context: LoaderContext): string =>\n    (root ??= resolveContentRoot(options.root ?? site.root, context.config?.root));\n\n  const sourceFor = (context: LoaderContext): ContentSource =>\n    (source ??= options.source ?? fileSystemSource(rootFor(context)));\n\n  /** Published once per process; a model change restarts the dev server. */\n  let publishing: Promise<void> | undefined;\n\n  const publish = (context: LoaderContext): Promise<void> =>\n    (publishing ??=\n      options.publishModel === false || options.source\n        ? Promise.resolve()\n        : publishModel(site, rootFor(context), context.logger));\n\n  /** Collections whose watcher is already registered, so a reload adds none. */\n  const watching = new Set<string>();\n\n  const watch = (context: LoaderContext, name: string, reload: () => Promise<void>): void => {\n    const watcher = context.watcher;\n    if (!watcher || options.source || watching.has(name)) return;\n    watching.add(name);\n\n    const base = rootFor(context);\n    watcher.add(base);\n\n    // A collection lives in `<root>/<name>/`; a singleton is either\n    // `<root>/<name>.json` or `<root>/<name>/…`. Both are covered by this\n    // prefix, and nothing outside it can concern this loader — which is what\n    // keeps one collection's save from re-reading every other one.\n    const prefix = join(base, name);\n    const mine = (path: string): boolean =>\n      path === `${prefix}.json` || path.startsWith(prefix + sep);\n\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    const onChange = (path: string): void => {\n      // The manifest is this package's own output; reloading content because\n      // the model was written is a loop waiting to happen.\n      if (path.endsWith(MANIFEST_PATH) || !mine(path)) return;\n\n      if (timer) clearTimeout(timer);\n      timer = setTimeout(() => {\n        // Content that fails its own schema lands here. The dev server has to\n        // survive it: the next save is very likely the fix.\n        void reload().catch((error: unknown) => {\n          context.logger.error(`Could not reload content: ${describe(error)}`);\n        });\n      }, options.debounceMs ?? 100);\n      // A pending reload is never a reason to keep the process alive.\n      timer.unref?.();\n    };\n\n    watcher.on(\"change\", onChange);\n    watcher.on(\"add\", onChange);\n    watcher.on(\"unlink\", onChange);\n  };\n\n  const collections = {} as Record<string, AstroCollectionConfig<unknown>>;\n\n  for (const [name, def] of Object.entries(site.collections) as [string, Collection][]) {\n    collections[name] = {\n      type: \"content_layer\",\n      // `storage` rather than `output`: a media reference is a path into the\n      // repository at rest and a path into the repository once loaded. There\n      // is no expansion step left to tell the two apart.\n      schema: fieldsSchema(def.fields, \"storage\").extend({ _mica: metaSchema }),\n      loader: {\n        name: `mica:${name}`,\n        load: async (context) => {\n          const read = async (): Promise<void> => {\n            const source = sourceFor(context);\n            const entries = await guard(context, source, () => readCollection(source, def, name));\n\n            // A full replace, not a merge: an entry deleted from the repository\n            // has to disappear from the build.\n            context.store.clear();\n\n            for (const entry of entries) {\n              const meta: MicaMeta = {\n                id: entry.slug,\n                slug: entry.slug,\n                collection: name,\n                position: entry.position,\n              };\n\n              const data = await context.parseData({\n                id: entry.slug,\n                data: { ...entry.data, _mica: meta },\n              });\n              context.store.set({ id: entry.slug, data, digest: context.generateDigest(data) });\n            }\n\n            context.logger.info(`Loaded ${entries.length} ${entries.length === 1 ? \"entry\" : \"entries\"} of \"${def.label}\"`);\n          };\n\n          await publish(context);\n          await read();\n          watch(context, name, read);\n        },\n      },\n    };\n  }\n\n  // A singleton becomes a one-entry collection whose id is its name, so the\n  // website reaches it with the same `getEntry` it uses for everything else.\n  for (const [name, def] of Object.entries(site.singletons) as [string, Singleton][]) {\n    collections[name] = {\n      type: \"content_layer\",\n      schema: fieldsSchema(def.fields, \"storage\"),\n      loader: {\n        name: `mica:${name}`,\n        load: async (context) => {\n          const read = async (): Promise<void> => {\n            const source = sourceFor(context);\n            const data = await guard(context, source, () => readSingleton(source, def, name));\n\n            context.store.clear();\n            if (data === null) {\n              // Not fatal. A site is normally deployed before every settings\n              // form has been filled in, and the page that reads this singleton\n              // reports the absence far better than the loader can.\n              context.logger.warn(`No content for \"${def.label}\" yet.`);\n              return;\n            }\n\n            const parsed = await context.parseData({ id: name, data });\n            context.store.set({ id: name, data: parsed, digest: context.generateDigest(parsed) });\n          };\n\n          await publish(context);\n          await read();\n          watch(context, name, read);\n        },\n      },\n    };\n  }\n\n  return collections as MicaCollections<S>;\n}\n\n/**\n * The site's own model must use only kinds this package knows. Mica reads an\n * unknown kind as one from a newer version and makes its collection read-only,\n * so a typo would otherwise pass the build and lock the collection.\n */\nfunction assertKnownKinds(site: Site): void {\n  const check = (fields: FieldMap, at: string) => {\n    for (const [key, field] of Object.entries(fields)) {\n      if (!isFieldKind(field.kind)) {\n        throw new Error(`Field \"${at}.${key}\" has the unknown kind \"${String(field.kind)}\". Use the field functions from @micacms/core.`);\n      }\n      if (field.kind === \"object\" || field.kind === \"repeater\") check(field.fields, `${at}.${key}`);\n    }\n  };\n  for (const [name, def] of Object.entries(site.collections)) check(def.fields, `collections.${name}`);\n  for (const [name, def] of Object.entries(site.singletons)) check(def.fields, `singletons.${name}`);\n}\n\n/**\n * Writes the model into the content root, for Mica to read back.\n *\n * Mica holds no content model: the Astro project is the only place a collection\n * is defined, and this is how it says so. The file goes *inside the content\n * root* so that it travels to Mica the way content does — through Git and the\n * repository connector — with nothing to mount and no second channel to keep in\n * step. Commit it.\n *\n * Done from a loader rather than an integration because this is the moment both\n * facts are in hand: the model, and the project root that turns `./content`\n * into a directory. It also means `astro.config` needs no Mica in it, which is\n * what lets a project define Mica collections and ordinary Astro ones in the\n * same `content.config.ts`.\n */\nasync function publishModel(\n  site: Site,\n  root: string,\n  logger: LoaderContext[\"logger\"],\n): Promise<void> {\n  const target = join(root, MANIFEST_PATH);\n  const contents = `${JSON.stringify(manifestFor(site), null, 2)}\\n`;\n\n  try {\n    // Only when it differs. The content root is watched in dev, and rewriting\n    // an identical file on every start would ask for a reload for no reason.\n    if ((await readFile(target, \"utf8\").catch(() => null)) === contents) return;\n\n    await mkdir(dirname(target), { recursive: true });\n    await writeFile(target, contents, \"utf8\");\n    logger.info(`Wrote the content model to ${relative(process.cwd(), target)} — commit it for Mica to read.`);\n  } catch (error) {\n    // A site that builds correctly should not fail over this, and a read-only\n    // checkout is a normal way to build one in CI. Mica reports a missing model\n    // itself, and far more usefully.\n    logger.warn(`Could not write the content model: ${describe(error)}`);\n  }\n}\n\nfunction describe(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/**\n * Reports a read failure against the content root that produced it.\n *\n * A build failing on unreadable content is correct — publishing a half-empty\n * site would be worse — but the message has to name the directory that was\n * read, because the usual cause is a content root pointing at the wrong place.\n */\nasync function guard<T>(\n  context: LoaderContext,\n  source: ContentSource,\n  read: () => Promise<T>,\n): Promise<T> {\n  try {\n    return await read();\n  } catch (error) {\n    const detail = error instanceof Error ? error.message : String(error);\n    context.logger.error(detail);\n\n    throw new Error(`Could not read content from ${source.origin}.\\n  ${detail}`, { cause: error });\n  }\n}\n\n/* ------------------------------------------------------------------ *\n * Types for the website\n * ------------------------------------------------------------------ */\n\n/** The document type for one collection, as it appears in Astro. */\nexport type CollectionDocument<\n  S extends Site,\n  K extends keyof S[\"collections\"],\n> = AstroDocument<InferCollection<S[\"collections\"][K]>>;\n\n/** The document type for one singleton. */\nexport type SingletonDocument<\n  S extends Site,\n  K extends keyof S[\"singletons\"],\n> = InferSingleton<S[\"singletons\"][K]>;\n\nexport { manifestFor } from \"./manifest.js\";\nexport { DEFAULT_CONTENT_ROOT, resolveContentRoot };\nexport {\n  renderRichText,\n  transformRichText,\n  validateRichText,\n  type RichTextOptions,\n} from \"./richtext.js\";\n\n/**\n * Re-exported for convenience, so a project that only depends on this package\n * can still build a source or read a collection. They are defined in\n * `@micacms/core`, where the Mica server can reach them too.\n */\nexport {\n  ContentReadError,\n  ContentSourceError,\n  ORDER_FILE,\n  memorySource,\n  readCollection,\n  readSingleton,\n  type ContentSource,\n  type DirectoryEntry,\n} from \"@micacms/core\";\nexport { fileSystemSource } from \"@micacms/core/node\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @micacms/astro — a Git repository as an Astro content source.\n *\n *   // src/content.config.ts — the model is in src/mica.ts\n *   import { micaCollections } from \"@micacms/astro\";\n *   import { site } from \"./mica\";\n *\n *   export const collections = micaCollections(site);\n *\n * From there the website uses ordinary Astro APIs — `getCollection(\"projects\")`\n * — and knows nothing about how the content arrived.\n *\n * There is no CMS in this path. The loaders read files that are already in the\n * working tree, so a build needs a checkout and nothing else: no running\n * server, no token, no network. That is the point of the Git-native design.\n * Publishing is a commit, and CI builds the commit.\n */\n\nimport { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport { dirname, join, relative, sep } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nimport {\n  collectionEntryPath,\n  createReferenceCheck,\n  entryLayout,\n  fieldsSchema,\n  INDEX_FILE,\n  singletonPath,\n  isFieldKind,\n  MANIFEST_PATH,\n  readCollection,\n  readSingleton,\n  type Collection,\n  type ContentSource,\n  type FieldMap,\n  type InferCollection,\n  type InferSingleton,\n  type Singleton,\n  type Site,\n} from \"@micacms/core\";\nimport { fileSystemSource } from \"@micacms/core/node\";\nimport type { ImageMetadata } from \"astro\";\nimport { z } from \"zod\";\n\nimport { imagePathsFromEntry } from \"./images.js\";\nimport { manifestFor } from \"./manifest.js\";\nimport { DEFAULT_CONTENT_ROOT, resolveContentRoot } from \"./root.js\";\n\nexport interface MicaCollectionsOptions {\n  /**\n   * Overrides `defineSite({ root })`, which is where the content root belongs.\n   *\n   * Relative paths resolve against the Astro project root, like Astro's own\n   * `glob({ base })`. An absolute path is used as given — which is what a\n   * project whose content is a separate repository, checked out by CI\n   * somewhere else, wants.\n   */\n  root?: string;\n  /** Overrides `root` entirely. Used by tests, and by a non-filesystem source. */\n  source?: ContentSource;\n  /**\n   * Turns off publishing the model to `<root>/.mica/schema.json`.\n   *\n   * Only for a project that is not edited through Mica at all: without that\n   * file in the repository, Mica has no model and refuses to start.\n   */\n  publishModel?: false;\n  /**\n   * How long to wait after a content change before reloading, in dev.\n   *\n   * Saving one entry touches several files — `index.json` and every `.mdoc`\n   * beside it — and a Git checkout touches all of them at once. One reload\n   * after the burst is both faster and less confusing than one per file.\n   */\n  debounceMs?: number;\n  /**\n   * Fails the build on a relation to a missing entry or a missing media file.\n   * Without it, the build logs a warning for each and goes on; a missing image\n   * file fails the build either way, because Astro cannot import it.\n   */\n  strict?: boolean;\n}\n\n/**\n * Entry metadata attached to every collection document.\n *\n * No timestamps: in Git they are commit metadata, which a static build cannot\n * read cheaply. A date an editor cares about belongs in the model as a `date()` field.\n *\n * Namespaced because these keys share a namespace with the customer's own\n * fields, and `position` is a plausible field name.\n */\nexport interface MicaMeta {\n  /** The entry slug, which is its identity in the repository. */\n  id: string;\n  slug: string;\n  collection: string;\n  /** Index in the collection's order, manual when `_order.json` says so. */\n  position: number;\n}\n\nconst metaSchema = z.object({\n  id: z.string(),\n  slug: z.string(),\n  collection: z.string(),\n  position: z.number(),\n});\n\n/** What a document looks like inside Astro: the payload plus `_mica`. */\nexport type AstroDocument<T> = T & { _mica: MicaMeta };\n\n/**\n * The shape Astro's config loader expects.\n *\n * Deliberately not built with `defineCollection` from `astro:content`: that is a\n * virtual module, resolvable only inside an Astro app's module graph, and this\n * package is pre-compiled. `defineCollection` does nothing more than stamp this\n * `type`, so producing the object directly keeps the package importable\n * anywhere — including from a plain unit test.\n */\nexport interface AstroCollectionConfig<T = unknown> {\n  type: \"content_layer\";\n  loader: ContentLoader;\n  /**\n   * A function, so that Astro hands in its `image()`. Its result is typed as\n   * `ZodType<T>` because Astro derives `CollectionEntry<\"projects\">[\"data\"]`\n   * from it: left generic, every field in every template would degrade to\n   * `any`, and the point of the shared model is that renaming a field breaks\n   * the build.\n   */\n  schema: (context: { image: () => z.ZodType }) => z.ZodType<T>;\n}\n\n/** The subset of Astro's `Loader` contract this package uses. */\nexport interface ContentLoader {\n  name: string;\n  load(context: LoaderContext): Promise<void>;\n}\n\nexport interface LoaderContext {\n  store: {\n    clear(): void;\n    set(entry: { id: string; data: Record<string, unknown>; digest?: string; filePath?: string }): boolean;\n    keys(): string[];\n  };\n  logger: {\n    info(message: string): void;\n    warn(message: string): void;\n    error(message: string): void;\n    debug(message: string): void;\n  };\n  meta: { get(key: string): string | undefined; set(key: string, value: string): void };\n  /**\n   * Astro's resolved config. Optional because this interface is a hand-written\n   * subset and the tests build a context by hand; `config.root` is what turns a\n   * relative content root into a path.\n   */\n  config?: { root: URL };\n  /**\n   * Present only while `astro dev` runs. Astro's watcher follows the module\n   * graph, and content files are not in it — no page imports\n   * `projects/haus-a/index.json` — so each loader watches its own directory\n   * here, exactly as Astro's own `glob` loader does.\n   */\n  watcher?: {\n    add(path: string): void;\n    on(event: \"add\" | \"change\" | \"unlink\", handler: (path: string) => void): void;\n  };\n  parseData(input: {\n    id: string;\n    data: Record<string, unknown>;\n    /** The entry's file, from the project root: Astro's `image()` resolves paths against it. */\n    filePath?: string;\n  }): Promise<Record<string, unknown>>;\n  generateDigest(data: Record<string, unknown> | string): string;\n}\n\nexport type MicaCollections<S extends Site> = {\n  [K in keyof S[\"collections\"]]: AstroCollectionConfig<CollectionDocument<S, K>>;\n} & {\n  [K in keyof S[\"singletons\"]]: AstroCollectionConfig<SingletonDocument<S, K>>;\n};\n\nexport function micaCollections<S extends Site>(\n  site: S,\n  options: MicaCollectionsOptions = {},\n): MicaCollections<S> {\n  assertKnownKinds(site);\n\n  /**\n   * Everything below is resolved on first load rather than here, because the\n   * Astro project root is something only a loader is told — and it is what\n   * turns `./content` into a directory. Memoised: one root and one source,\n   * however many collections and however many reloads.\n   */\n  let root: string | undefined;\n  let source: ContentSource | undefined;\n\n  const rootFor = (context: LoaderContext): string =>\n    (root ??= resolveContentRoot(options.root ?? site.root, context.config?.root));\n\n  const sourceFor = (context: LoaderContext): ContentSource =>\n    (source ??= options.source ?? fileSystemSource(rootFor(context)));\n\n  /** Published once per process; a model change restarts the dev server. */\n  let publishing: Promise<void> | undefined;\n\n  const publish = (context: LoaderContext): Promise<void> =>\n    (publishing ??=\n      options.publishModel === false || options.source\n        ? Promise.resolve()\n        : publishModel(site, rootFor(context), context.logger));\n\n  /** An entry's data file, from the content root and, outside tests, from the project root. */\n  const entryFile = (context: LoaderContext, fields: FieldMap, name: string, slug?: string) => {\n    const base = slug === undefined ? singletonPath(fields, name) : collectionEntryPath(fields, name, slug);\n    const inContent = entryLayout(fields) === \"directory\" ? `${base}/${INDEX_FILE}` : base;\n    const project = context.config?.root;\n    const inProject =\n      project && !options.source\n        ? relative(fileURLToPath(project), join(rootFor(context), inContent)).split(sep).join(\"/\")\n        : undefined;\n    return { inContent, inProject };\n  };\n\n  /** Warns about broken relations and missing files, or fails the build with `strict`. */\n  const checkReferences = async (\n    context: LoaderContext,\n    source: ContentSource,\n    documents: Array<{ label: string; fields: FieldMap; data: Record<string, unknown> }>,\n  ): Promise<void> => {\n    const check = createReferenceCheck(site, source);\n    const problems: string[] = [];\n    for (const { label, fields, data } of documents) {\n      for (const issue of await check.issues(fields, data)) problems.push(`${label}: ${issue.path}: ${issue.message}`);\n    }\n    if (problems.length === 0) return;\n    if (options.strict) throw new Error(`Broken references:\\n  ${problems.join(\"\\n  \")}`);\n    for (const problem of problems) context.logger.warn(problem);\n  };\n\n  /** Collections whose watcher is already registered, so a reload adds none. */\n  const watching = new Set<string>();\n\n  const watch = (context: LoaderContext, name: string, reload: () => Promise<void>): void => {\n    const watcher = context.watcher;\n    if (!watcher || options.source || watching.has(name)) return;\n    watching.add(name);\n\n    const base = rootFor(context);\n    watcher.add(base);\n\n    // A collection lives in `<root>/<name>/`; a singleton is either\n    // `<root>/<name>.json` or `<root>/<name>/…`. Both are covered by this\n    // prefix, and nothing outside it can concern this loader — which is what\n    // keeps one collection's save from re-reading every other one.\n    const prefix = join(base, name);\n    const mine = (path: string): boolean =>\n      path === `${prefix}.json` || path.startsWith(prefix + sep);\n\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    const onChange = (path: string): void => {\n      // The manifest is this package's own output; reloading content because\n      // the model was written is a loop waiting to happen.\n      if (path.endsWith(MANIFEST_PATH) || !mine(path)) return;\n\n      if (timer) clearTimeout(timer);\n      timer = setTimeout(() => {\n        // Content that fails its own schema lands here. The dev server has to\n        // survive it: the next save is very likely the fix.\n        void reload().catch((error: unknown) => {\n          context.logger.error(`Could not reload content: ${describe(error)}`);\n        });\n      }, options.debounceMs ?? 100);\n      // A pending reload is never a reason to keep the process alive.\n      timer.unref?.();\n    };\n\n    watcher.on(\"change\", onChange);\n    watcher.on(\"add\", onChange);\n    watcher.on(\"unlink\", onChange);\n  };\n\n  const collections = {} as Record<string, AstroCollectionConfig<unknown>>;\n\n  for (const [name, def] of Object.entries(site.collections) as [string, Collection][]) {\n    collections[name] = {\n      type: \"content_layer\",\n      schema: ({ image }) => fieldsSchema(def.fields, { image }).extend({ _mica: metaSchema }),\n      loader: {\n        name: `mica:${name}`,\n        load: async (context) => {\n          const read = async (): Promise<void> => {\n            const source = sourceFor(context);\n            const entries = await guard(context, source, () => readCollection(source, def, name));\n\n            // A full replace, not a merge: an entry deleted from the repository\n            // has to disappear from the build.\n            context.store.clear();\n\n            for (const entry of entries) {\n              const meta: MicaMeta = {\n                id: entry.slug,\n                slug: entry.slug,\n                collection: name,\n                position: entry.position,\n              };\n\n              const file = entryFile(context, def.fields, name, entry.slug);\n              const data = await context.parseData({\n                id: entry.slug,\n                data: { ...imagePathsFromEntry(def.fields, entry.data, file.inContent), _mica: meta },\n                ...(file.inProject ? { filePath: file.inProject } : {}),\n              });\n              context.store.set({\n                id: entry.slug,\n                data,\n                digest: context.generateDigest(data),\n                ...(file.inProject ? { filePath: file.inProject } : {}),\n              });\n            }\n\n            await checkReferences(\n              context,\n              source,\n              entries.map((entry) => ({ label: `${name}/${entry.slug}`, fields: def.fields, data: entry.data })),\n            );\n            context.logger.info(`Loaded ${entries.length} ${entries.length === 1 ? \"entry\" : \"entries\"} of \"${def.label}\"`);\n          };\n\n          await publish(context);\n          await read();\n          watch(context, name, read);\n        },\n      },\n    };\n  }\n\n  // A singleton becomes a one-entry collection whose id is its name, so the\n  // website reaches it with the same `getEntry` it uses for everything else.\n  for (const [name, def] of Object.entries(site.singletons) as [string, Singleton][]) {\n    collections[name] = {\n      type: \"content_layer\",\n      schema: ({ image }) => fieldsSchema(def.fields, { image }),\n      loader: {\n        name: `mica:${name}`,\n        load: async (context) => {\n          const read = async (): Promise<void> => {\n            const source = sourceFor(context);\n            const data = await guard(context, source, () => readSingleton(source, def, name));\n\n            context.store.clear();\n            if (data === null) {\n              // Not fatal. A site is normally deployed before every settings\n              // form has been filled in, and the page that reads this singleton\n              // reports the absence far better than the loader can.\n              context.logger.warn(`No content for \"${def.label}\" yet.`);\n              return;\n            }\n\n            await checkReferences(context, source, [{ label: name, fields: def.fields, data }]);\n            const file = entryFile(context, def.fields, name);\n            const parsed = await context.parseData({\n              id: name,\n              data: imagePathsFromEntry(def.fields, data, file.inContent),\n              ...(file.inProject ? { filePath: file.inProject } : {}),\n            });\n            context.store.set({\n              id: name,\n              data: parsed,\n              digest: context.generateDigest(parsed),\n              ...(file.inProject ? { filePath: file.inProject } : {}),\n            });\n          };\n\n          await publish(context);\n          await read();\n          watch(context, name, read);\n        },\n      },\n    };\n  }\n\n  return collections as MicaCollections<S>;\n}\n\n/**\n * The site's own model must use only kinds this package knows. Mica reads an\n * unknown kind as one from a newer version and makes its collection read-only,\n * so a typo would otherwise pass the build and lock the collection.\n */\nfunction assertKnownKinds(site: Site): void {\n  const check = (fields: FieldMap, at: string) => {\n    for (const [key, field] of Object.entries(fields)) {\n      if (!isFieldKind(field.kind)) {\n        throw new Error(`Field \"${at}.${key}\" has the unknown kind \"${String(field.kind)}\". Use the field functions from @micacms/core.`);\n      }\n      if (field.kind === \"object\" || field.kind === \"repeater\") check(field.fields, `${at}.${key}`);\n    }\n  };\n  for (const [name, def] of Object.entries(site.collections)) check(def.fields, `collections.${name}`);\n  for (const [name, def] of Object.entries(site.singletons)) check(def.fields, `singletons.${name}`);\n}\n\n/**\n * Writes the model into the content root, for Mica to read back.\n *\n * Mica holds no content model: the Astro project is the only place a collection\n * is defined, and this is how it says so. The file goes *inside the content\n * root* so that it travels to Mica the way content does — through Git and the\n * repository connector — with nothing to mount and no second channel to keep in\n * step. Commit it.\n *\n * Done from a loader rather than an integration because this is the moment both\n * facts are in hand: the model, and the project root that turns `./content`\n * into a directory. It also means `astro.config` needs no Mica in it, which is\n * what lets a project define Mica collections and ordinary Astro ones in the\n * same `content.config.ts`.\n */\nasync function publishModel(\n  site: Site,\n  root: string,\n  logger: LoaderContext[\"logger\"],\n): Promise<void> {\n  const target = join(root, MANIFEST_PATH);\n  const contents = `${JSON.stringify(manifestFor(site), null, 2)}\\n`;\n\n  try {\n    // Only when it differs. The content root is watched in dev, and rewriting\n    // an identical file on every start would ask for a reload for no reason.\n    if ((await readFile(target, \"utf8\").catch(() => null)) === contents) return;\n\n    await mkdir(dirname(target), { recursive: true });\n    await writeFile(target, contents, \"utf8\");\n    logger.info(`Wrote the content model to ${relative(process.cwd(), target)} — commit it for Mica to read.`);\n  } catch (error) {\n    // A site that builds correctly should not fail over this, and a read-only\n    // checkout is a normal way to build one in CI. Mica reports a missing model\n    // itself, and far more usefully.\n    logger.warn(`Could not write the content model: ${describe(error)}`);\n  }\n}\n\nfunction describe(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n\n/**\n * Reports a read failure against the content root that produced it.\n *\n * A build failing on unreadable content is correct — publishing a half-empty\n * site would be worse — but the message has to name the directory that was\n * read, because the usual cause is a content root pointing at the wrong place.\n */\nasync function guard<T>(\n  context: LoaderContext,\n  source: ContentSource,\n  read: () => Promise<T>,\n): Promise<T> {\n  try {\n    return await read();\n  } catch (error) {\n    const detail = error instanceof Error ? error.message : String(error);\n    context.logger.error(detail);\n\n    throw new Error(`Could not read content from ${source.origin}.\\n  ${detail}`, { cause: error });\n  }\n}\n\n/* ------------------------------------------------------------------ *\n * Types for the website\n * ------------------------------------------------------------------ */\n\n/** The document type for one collection, as it appears in Astro. */\nexport type CollectionDocument<\n  S extends Site,\n  K extends keyof S[\"collections\"],\n> = AstroDocument<InferCollection<S[\"collections\"][K], ImageMetadata>>;\n\n/** The document type for one singleton. */\nexport type SingletonDocument<\n  S extends Site,\n  K extends keyof S[\"singletons\"],\n> = InferSingleton<S[\"singletons\"][K], ImageMetadata>;\n\nexport { manifestFor } from \"./manifest.js\";\nexport { DEFAULT_CONTENT_ROOT, resolveContentRoot };\nexport {\n  renderRichText,\n  transformRichText,\n  validateRichText,\n  type RichTextOptions,\n} from \"./richtext.js\";\n"]}

package/package.json

@@ -1,9 +1,19 @@
 {
   "name": "@micacms/astro",
-  "version": "0.5.0",
+  "version": "0.6.0-rc.2",
   "type": "module",
   "description": "Reads a Mica content repository as Astro Content Collections via the Content Layer API.",
   "license": "MIT",
+  "homepage": "https://micacms.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/micacms/mica.git",
+    "directory": "packages/astro"
+  },
+  "bugs": "https://github.com/micacms/mica/issues",
+  "engines": {
+    "node": ">=24"
+  },
   "author": "Alexander Müdespacher",
   "keywords": [
     "mica",
@@ -25,20 +35,23 @@
   },
   "files": [
     "dist",
-    "setup"
+    "setup",
+    "src"
   ],
   "dependencies": {
-    "@markdoc/markdoc": "^0.5.9",
-    "zod": "^4.3.6",
-    "@micacms/core": "0.5.0"
+    "@markdoc/markdoc": "^0.5.9"
   },
   "peerDependencies": {
-    "astro": "^6.0.0 || ^7.0.0"
+    "astro": "^7.0.0",
+    "zod": "^4.3.6",
+    "@micacms/core": "^0.6.0-rc.2"
   },
   "devDependencies": {
     "@types/node": "^22.20.1",
     "astro": "^7.2.2",
-    "typescript": "^5.7.3"
+    "typescript": "^5.7.3",
+    "zod": "^4.3.6",
+    "@micacms/core": "0.6.0-rc.2"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",