@micacms/astro 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alexander Müdespacher
+
+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/README.md

@@ -0,0 +1,97 @@
+# @micacms/astro
+
+> **Experimental.** Pre-1.0: the API and the content format can still change
+> without notice. Use it at your own risk.
+
+Reads a Mica content repository as Astro Content Collections, through the
+Content Layer API — and publishes the content model for Mica to read back.
+
+The build needs no CMS running, no URL and no token. Content is files in the
+checkout the build is already in, so the website cannot be broken by the CMS
+being down, slow, or mid-deploy.
+
+```ts
+// src/mica.ts
+import { collection, defineSite, slug, text } from "@micacms/model";
+
+export const site = defineSite({
+  root: "./content",
+  collections: {
+    news: collection({
+      label: "News",
+      fields: { title: text({ required: true }), slug: slug({ from: "title" }) },
+    }),
+  },
+});
+```
+
+```ts
+// src/content.config.ts
+import { micaCollections } from "@micacms/astro";
+
+import { site } from "./mica";
+
+export const collections = micaCollections(site);
+```
+
+That is the whole setup. **Nothing goes in `astro.config`** — which is also what
+lets `content.config.ts` import `astro:content`, a virtual module that only
+exists inside the app's own module graph.
+
+Pages then use ordinary Astro:
+
+```astro
+---
+import { getCollection } from "astro:content";
+const news = await getCollection("news");
+---
+```
+
+`getCollection("news")` is fully typed from the model, with no code generation
+step — so renaming a field breaks the build rather than the page.
+
+## What `micaCollections` does
+
+One loader and one Zod schema per collection and singleton. Each document
+carries a `_mica` field with what the model knows about it; a singleton becomes
+a one-entry collection, reachable with the same `getEntry` as everything else.
+
+The loaders also do the two things that used to need an integration, because
+Astro hands a loader exactly what they require:
+
+- **Publish the model** to `<root>/.mica/schema.json`, once per build or
+  dev-server start. Commit that file: it is how a Mica deployment learns what
+  this project defines. `publishModel: false` turns it off, for a project that
+  is not edited through Mica.
+- **Reload in dev.** Astro's watcher follows the module graph and content files
+  are not in it, because no page imports `projects/haus-a/index.json`. Each
+  loader watches its own directory and coalesces the burst of writes that saving
+  one entry produces (`debounceMs`, 100 ms by default).
+
+## Mixing with your own collections
+
+The return value is a plain object:
+
+```ts
+export const collections = {
+  ...micaCollections(site),
+  docs: defineCollection({ loader: glob({ pattern: "**/*.md", base: "./src/docs" }) }),
+};
+```
+
+Mica edits what is in the model and does not know the rest exists. A save in one
+of its collections reloads that collection only — never a foreign loader.
+
+## Rich text
+
+`renderRichText(source)` turns a Markdoc field into an HTML string;
+`transformRichText(source)` returns the renderable tree instead, for a project
+that wants to render with its own components.
+
+## Install
+
+```bash
+npm install @micacms/astro
+```
+
+Astro 5 is a peer dependency. Requires Node 22.5 or newer. Licence: MIT.

package/dist/index.d.ts

@@ -0,0 +1,163 @@
+/**
+ * @micacms/astro — a Git repository as an Astro content source.
+ *
+ *   // src/content.config.ts
+ *   import { micaCollections } from "@micacms/astro";
+ *   import { defineSite } from "@micacms/model";
+ *
+ *   export const site = defineSite({ collections: { … } });
+ *   export const collections = micaCollections(site, { root: "./content" });
+ *
+ * From there the website uses ordinary Astro APIs — `getCollection("projects")`
+ * — and knows nothing about how the content arrived.
+ *
+ * There is no CMS in this path. The loaders read files that are already in the
+ * working tree, so a build needs a checkout and nothing else: no running
+ * server, no token, no network. That is the point of the Git-native design.
+ * Publishing is a commit, and CI builds the commit.
+ */
+import { type ContentSource, type InferCollection, type InferSingleton, type Site } from "@micacms/model";
+import { z } from "zod";
+import { DEFAULT_CONTENT_ROOT, resolveContentRoot } from "./root.js";
+export interface MicaCollectionsOptions {
+    /**
+     * Overrides `defineSite({ root })`, which is where the content root belongs.
+     *
+     * Relative paths resolve against the Astro project root, like Astro's own
+     * `glob({ base })`. An absolute path is used as given — which is what a
+     * project whose content is a separate repository, checked out by CI
+     * somewhere else, wants.
+     */
+    root?: string;
+    /** Overrides `root` entirely. Used by tests, and by a non-filesystem source. */
+    source?: ContentSource;
+    /**
+     * Turns off publishing the model to `<root>/.mica/schema.json`.
+     *
+     * Only for a project that is not edited through Mica at all: without that
+     * file in the repository, Mica has no model and refuses to start.
+     */
+    publishModel?: false;
+    /**
+     * How long to wait after a content change before reloading, in dev.
+     *
+     * Saving one entry touches several files — `index.json` and every `.mdoc`
+     * beside it — and a Git checkout touches all of them at once. One reload
+     * after the burst is both faster and less confusing than one per file.
+     */
+    debounceMs?: number;
+}
+/**
+ * Entry metadata attached to every collection document.
+ *
+ * Much smaller than it was when a database backed the CMS. Timestamps and
+ * version numbers came from table columns that no longer exist; in Git the
+ * equivalents are commit metadata, which a static build has no cheap way to
+ * read and no strong reason to need. A date an editor cares about belongs in
+ * the model as a `date()` field, where it is editorial rather than incidental.
+ *
+ * Namespaced because these keys share a namespace with the customer's own
+ * fields, and `position` is a plausible field name.
+ */
+export interface MicaMeta {
+    /** The entry slug, which is its identity in the repository. */
+    id: string;
+    slug: string;
+    collection: string;
+    /** Index in the collection's order, manual when `_order.json` says so. */
+    position: number;
+}
+/** What a document looks like inside Astro: the payload plus `_mica`. */
+export type AstroDocument<T> = T & {
+    _mica: MicaMeta;
+};
+/**
+ * The shape Astro's config loader expects.
+ *
+ * Deliberately not built with `defineCollection` from `astro:content`: that is a
+ * virtual module, resolvable only inside an Astro app's module graph, and this
+ * package is pre-compiled. `defineCollection` does nothing more than stamp this
+ * `type`, so producing the object directly keeps the package importable
+ * anywhere — including from a plain unit test.
+ */
+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.
+     */
+    schema: z.ZodType<T>;
+}
+/** The subset of Astro's `Loader` contract this package uses. */
+export interface ContentLoader {
+    name: string;
+    load(context: LoaderContext): Promise<void>;
+}
+export interface LoaderContext {
+    store: {
+        clear(): void;
+        set(entry: {
+            id: string;
+            data: Record<string, unknown>;
+            digest?: string;
+        }): boolean;
+        keys(): string[];
+    };
+    logger: {
+        info(message: string): void;
+        warn(message: string): void;
+        error(message: string): void;
+        debug(message: string): void;
+    };
+    meta: {
+        get(key: string): string | undefined;
+        set(key: string, value: string): void;
+    };
+    /**
+     * Astro's resolved config. Optional because this interface is a hand-written
+     * subset and the tests build a context by hand; `config.root` is what turns a
+     * relative content root into a path.
+     */
+    config?: {
+        root: URL;
+    };
+    /**
+     * Present only while `astro dev` runs. Astro's watcher follows the module
+     * graph, and content files are not in it — no page imports
+     * `projects/haus-a/index.json` — so each loader watches its own directory
+     * here, exactly as Astro's own `glob` loader does.
+     */
+    watcher?: {
+        add(path: string): void;
+        on(event: "add" | "change" | "unlink", handler: (path: string) => void): void;
+    };
+    parseData(input: {
+        id: string;
+        data: Record<string, unknown>;
+    }): 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["singletons"]]: AstroCollectionConfig<InferSingleton<S["singletons"][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]>>;
+/** The document type for one singleton. */
+export type SingletonDocument<S extends Site, K extends keyof S["singletons"]> = InferSingleton<S["singletons"][K]>;
+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/model`, where the Mica server can reach them too.
+ */
+export { ContentReadError, ContentSourceError, ORDER_FILE, memorySource, readCollection, readSingleton, type ContentSource, type DirectoryEntry, } from "@micacms/model";
+export { fileSystemSource } from "@micacms/model/node";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,221 @@
+/**
+ * @micacms/astro — a Git repository as an Astro content source.
+ *
+ *   // src/content.config.ts
+ *   import { micaCollections } from "@micacms/astro";
+ *   import { defineSite } from "@micacms/model";
+ *
+ *   export const site = defineSite({ collections: { … } });
+ *   export const collections = micaCollections(site, { root: "./content" });
+ *
+ * From there the website uses ordinary Astro APIs — `getCollection("projects")`
+ * — and knows nothing about how the content arrived.
+ *
+ * There is no CMS in this path. The loaders read files that are already in the
+ * working tree, so a build needs a checkout and nothing else: no running
+ * server, no token, no network. That is the point of the Git-native design.
+ * Publishing is a commit, and CI builds the commit.
+ */
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join, sep } from "node:path";
+import { fieldsSchema, MANIFEST_PATH, readCollection, readSingleton, } from "@micacms/model";
+import { fileSystemSource } from "@micacms/model/node";
+import { z } from "zod";
+import { manifestFor } from "./manifest.js";
+import { DEFAULT_CONTENT_ROOT, resolveContentRoot } from "./root.js";
+const metaSchema = z.object({
+    id: z.string(),
+    slug: z.string(),
+    collection: z.string(),
+    position: z.number(),
+});
+export function micaCollections(site, options = {}) {
+    /**
+     * Everything below is resolved on first load rather than here, because the
+     * Astro project root is something only a loader is told — and it is what
+     * turns `./content` into a directory. Memoised: one root and one source,
+     * however many collections and however many reloads.
+     */
+    let root;
+    let source;
+    const rootFor = (context) => (root ??= resolveContentRoot(options.root ?? site.root, context.config?.root));
+    const sourceFor = (context) => (source ??= options.source ?? fileSystemSource(rootFor(context)));
+    /** Published once per process; a model change restarts the dev server. */
+    let publishing;
+    const publish = (context) => (publishing ??=
+        options.publishModel === false || options.source
+            ? Promise.resolve()
+            : publishModel(site, rootFor(context), context.logger));
+    /** Collections whose watcher is already registered, so a reload adds none. */
+    const watching = new Set();
+    const watch = (context, name, reload) => {
+        const watcher = context.watcher;
+        if (!watcher || options.source || watching.has(name))
+            return;
+        watching.add(name);
+        const base = rootFor(context);
+        watcher.add(base);
+        // A collection lives in `<root>/<name>/`; a singleton is either
+        // `<root>/<name>.json` or `<root>/<name>/…`. Both are covered by this
+        // prefix, and nothing outside it can concern this loader — which is what
+        // keeps one collection's save from re-reading every other one.
+        const prefix = join(base, name);
+        const mine = (path) => path === `${prefix}.json` || path.startsWith(prefix + sep);
+        let timer;
+        const onChange = (path) => {
+            // The manifest is this package's own output; reloading content because
+            // the model was written is a loop waiting to happen.
+            if (path.endsWith(MANIFEST_PATH) || !mine(path))
+                return;
+            if (timer)
+                clearTimeout(timer);
+            timer = setTimeout(() => {
+                // Content that fails its own schema lands here. The dev server has to
+                // survive it: the next save is very likely the fix.
+                void reload().catch((error) => {
+                    context.logger.error(`Could not reload content: ${describe(error)}`);
+                });
+            }, options.debounceMs ?? 100);
+            // A pending reload is never a reason to keep the process alive.
+            timer.unref?.();
+        };
+        watcher.on("change", onChange);
+        watcher.on("add", onChange);
+        watcher.on("unlink", onChange);
+    };
+    const collections = {};
+    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 }),
+            loader: {
+                name: `mica:${name}`,
+                load: async (context) => {
+                    const read = async () => {
+                        const source = sourceFor(context);
+                        const entries = await guard(context, source, () => readCollection(source, def, name));
+                        // A full replace, not a merge: an entry deleted from the repository
+                        // has to disappear from the build.
+                        context.store.clear();
+                        for (const entry of entries) {
+                            const meta = {
+                                id: entry.slug,
+                                slug: entry.slug,
+                                collection: name,
+                                position: entry.position,
+                            };
+                            const data = await context.parseData({
+                                id: entry.slug,
+                                data: { ...entry.data, _mica: meta },
+                            });
+                            context.store.set({ id: entry.slug, data, digest: context.generateDigest(data) });
+                        }
+                        context.logger.info(`Loaded ${entries.length} ${def.label.toLowerCase()}`);
+                    };
+                    await publish(context);
+                    await read();
+                    watch(context, name, read);
+                },
+            },
+        };
+    }
+    // A singleton becomes a one-entry collection whose id is its name, so the
+    // website reaches it with the same `getEntry` it uses for everything else.
+    for (const [name, def] of Object.entries(site.singletons)) {
+        collections[name] = {
+            type: "content_layer",
+            schema: fieldsSchema(def.fields, "storage"),
+            loader: {
+                name: `mica:${name}`,
+                load: async (context) => {
+                    const read = async () => {
+                        const source = sourceFor(context);
+                        const data = await guard(context, source, () => readSingleton(source, def, name));
+                        context.store.clear();
+                        if (data === null) {
+                            // Not fatal. A site is normally deployed before every settings
+                            // form has been filled in, and the page that reads this singleton
+                            // reports the absence far better than the loader can.
+                            context.logger.warn(`No content for the "${def.label}" settings yet.`);
+                            return;
+                        }
+                        const parsed = await context.parseData({ id: name, data });
+                        context.store.set({ id: name, data: parsed, digest: context.generateDigest(parsed) });
+                    };
+                    await publish(context);
+                    await read();
+                    watch(context, name, read);
+                },
+            },
+        };
+    }
+    return collections;
+}
+/**
+ * Writes the model into the content root, for Mica to read back.
+ *
+ * Mica holds no content model: the Astro project is the only place a collection
+ * is defined, and this is how it says so. The file goes *inside the content
+ * root* so that it travels to Mica the way content does — through Git and the
+ * repository connector — with nothing to mount and no second channel to keep in
+ * step. Commit it.
+ *
+ * Done from a loader rather than an integration because this is the moment both
+ * facts are in hand: the model, and the project root that turns `./content`
+ * into a directory. It also means `astro.config` needs no Mica in it, which is
+ * what lets a project define Mica collections and ordinary Astro ones in the
+ * same `content.config.ts`.
+ */
+async function publishModel(site, root, logger) {
+    const target = join(root, MANIFEST_PATH);
+    const contents = `${JSON.stringify(manifestFor(site), null, 2)}\n`;
+    try {
+        // Only when it differs. The content root is watched in dev, and rewriting
+        // an identical file on every start would ask for a reload for no reason.
+        if ((await readFile(target, "utf8").catch(() => null)) === contents)
+            return;
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(target, contents, "utf8");
+        logger.info(`Wrote the content model to ${MANIFEST_PATH} — commit it for Mica to read.`);
+    }
+    catch (error) {
+        // A site that builds correctly should not fail over this, and a read-only
+        // checkout is a normal way to build one in CI. Mica reports a missing model
+        // itself, and far more usefully.
+        logger.warn(`Could not write the content model: ${describe(error)}`);
+    }
+}
+function describe(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Reports a read failure against the content root that produced it.
+ *
+ * A build failing on unreadable content is correct — publishing a half-empty
+ * site would be worse — but the message has to name the directory that was
+ * read, because the usual cause is a content root pointing at the wrong place.
+ */
+async function guard(context, source, read) {
+    try {
+        return await read();
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        context.logger.error(detail);
+        throw new Error(`Could not read content from ${source.origin}.\n  ${detail}`, { cause: error });
+    }
+}
+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/model`, where the Mica server can reach them too.
+ */
+export { ContentReadError, ContentSourceError, ORDER_FILE, memorySource, readCollection, readSingleton, } from "@micacms/model";
+export { fileSystemSource } from "@micacms/model/node";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The protocol manifest this project publishes.
+ *
+ * Its own module rather than a function in `index.ts`, so that the integration
+ * can emit a manifest without importing the loaders, and the loaders can be
+ * imported without pulling in the integration. The two files would otherwise
+ * import each other.
+ */
+import { type ProtocolManifest, type Site } from "@micacms/model";
+/**
+ * Mica holds no model of its own. The Astro project is the only place a
+ * collection is defined, and this is how it says so.
+ */
+export declare function manifestFor(site: Site): ProtocolManifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAkB,KAAK,gBAAgB,EAAE,KAAK,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAKlF;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,gBAAgB,CAExD"}

package/dist/manifest.js

@@ -0,0 +1,19 @@
+/**
+ * The protocol manifest this project publishes.
+ *
+ * Its own module rather than a function in `index.ts`, so that the integration
+ * can emit a manifest without importing the loaders, and the loaders can be
+ * imported without pulling in the integration. The two files would otherwise
+ * import each other.
+ */
+import { createManifest } from "@micacms/model";
+/** Replaced at publish time; the fallback keeps a workspace build honest. */
+const PACKAGE_VERSION = "0.0.1";
+/**
+ * Mica holds no model of its own. The Astro project is the only place a
+ * collection is defined, and this is how it says so.
+ */
+export function manifestFor(site) {
+    return createManifest(site, `@micacms/astro@${PACKAGE_VERSION}`);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAoC,MAAM,gBAAgB,CAAC;AAElF,6EAA6E;AAC7E,MAAM,eAAe,GAAG,OAAO,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAU;IACpC,OAAO,cAAc,CAAC,IAAI,EAAE,kBAAkB,eAAe,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/read.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Entry discovery.
+ *
+ * Turns a content directory into payloads, using the layout rules the model
+ * defines. Nothing here decides where a file belongs — `@micacms/model` does —
+ * so a directory written by the editor and a directory written by hand are read
+ * the same way.
+ */
+import { type Collection, type Singleton } from "@micacms/model";
+import type { ContentSource } from "./source.js";
+/**
+ * Optional manual ordering for a collection, listing slugs in the order an
+ * editor arranged them.
+ *
+ * A separate file rather than a field on each entry, because order is a
+ * property of the collection: writing it into the entries would make a single
+ * drag rewrite every one of them, and the resulting Git diff would say nothing
+ * about what changed.
+ */
+export declare const ORDER_FILE = "_order.json";
+export interface ContentEntry {
+    slug: string;
+    /** Index in the collection's order — manual when `_order.json` says so. */
+    position: number;
+    data: Record<string, unknown>;
+}
+/** Raised with the offending path attached, which a bare parse error lacks. */
+export declare class ContentReadError extends Error {
+    readonly path: string;
+    name: string;
+    constructor(message: string, path: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare function readCollection(source: ContentSource, def: Collection, name: string): Promise<ContentEntry[]>;
+/**
+ * A singleton's payload, or null when the repository has no file for it yet.
+ *
+ * Null rather than an error: a site is normally deployed before every settings
+ * form has been filled in, and the collection schema is a better place to
+ * report a missing required value than the reader is.
+ */
+export declare function readSingleton(source: ContentSource, def: Singleton, name: string): Promise<Record<string, unknown> | null>;
+//# sourceMappingURL=read.d.ts.map

package/dist/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../src/read.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAOL,KAAK,UAAU,EAEf,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,gBAAgB,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,+EAA+E;AAC/E,qBAAa,gBAAiB,SAAQ,KAAK;IAIvC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAHd,IAAI,SAAsB;gBAEjC,OAAO,EAAE,MAAM,EACN,IAAI,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAIhC;AAMD,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,EAAE,CAAC,CAYzB;AA4ED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAEzC"}

package/dist/read.js

@@ -0,0 +1,186 @@
+/**
+ * Entry discovery.
+ *
+ * Turns a content directory into payloads, using the layout rules the model
+ * defines. Nothing here decides where a file belongs — `@micacms/model` does —
+ * so a directory written by the editor and a directory written by hand are read
+ * the same way.
+ */
+import { DOCUMENT_EXTENSION, FormatError, INDEX_FILE, entryLayout, isValidSlug, parseEntry, } from "@micacms/model";
+/**
+ * Optional manual ordering for a collection, listing slugs in the order an
+ * editor arranged them.
+ *
+ * A separate file rather than a field on each entry, because order is a
+ * property of the collection: writing it into the entries would make a single
+ * drag rewrite every one of them, and the resulting Git diff would say nothing
+ * about what changed.
+ */
+export const ORDER_FILE = "_order.json";
+/** Raised with the offending path attached, which a bare parse error lacks. */
+export class ContentReadError extends Error {
+    path;
+    name = "ContentReadError";
+    constructor(message, path, options) {
+        super(message, options);
+        this.path = path;
+    }
+}
+/* ------------------------------------------------------------------ *
+ * Collections
+ * ------------------------------------------------------------------ */
+export async function readCollection(source, def, name) {
+    const slugs = await listSlugs(source, def.fields, name);
+    const ordered = await applyOrder(source, name, slugs);
+    const entries = [];
+    for (const [position, slug] of ordered.entries()) {
+        const data = await readEntry(source, def.fields, `${name}/${slug}`, entryBase(def.fields, name, slug));
+        if (data)
+            entries.push({ slug, position, data });
+    }
+    return entries;
+}
+/**
+ * Slugs present in a collection directory.
+ *
+ * The layout decides what to look at: directory-shaped entries are directories,
+ * file-shaped ones are `.json` files. Anything that does not match — a stray
+ * README, the order file, a directory without an `index.json` — is skipped
+ * rather than rejected, because a content repository belongs to its owner and
+ * may hold things Mica did not put there.
+ */
+async function listSlugs(source, fields, name) {
+    const directoryLayout = entryLayout(fields) === "directory";
+    const items = await source.list(name);
+    const slugs = [];
+    for (const item of items) {
+        if (directoryLayout) {
+            if (item.type !== "directory")
+                continue;
+            if (isValidSlug(item.name))
+                slugs.push(item.name);
+            continue;
+        }
+        if (item.type !== "file" || !item.name.endsWith(".json"))
+            continue;
+        const slug = item.name.slice(0, -".json".length);
+        if (isValidSlug(slug))
+            slugs.push(slug);
+    }
+    return slugs;
+}
+/**
+ * Reorders slugs to match `_order.json`.
+ *
+ * Tolerant in both directions: a slug the file does not mention goes after the
+ * ones it does, and a slug the file mentions but which no longer exists is
+ * dropped. Either happens routinely when someone adds or deletes an entry in
+ * Git without touching the order file.
+ */
+async function applyOrder(source, name, slugs) {
+    const path = `${name}/${ORDER_FILE}`;
+    const raw = await source.read(path);
+    if (raw === null)
+        return slugs;
+    let listed;
+    try {
+        listed = JSON.parse(raw);
+    }
+    catch (error) {
+        throw new ContentReadError(`${path} is not valid JSON.`, path, { cause: error });
+    }
+    if (!Array.isArray(listed)) {
+        throw new ContentReadError(`${path} must be an array of slugs.`, path);
+    }
+    const available = new Set(slugs);
+    const ordered = listed.filter((slug) => typeof slug === "string" && available.delete(slug));
+    // Whatever the order file did not mention keeps its alphabetical position.
+    return [...ordered, ...slugs.filter((slug) => available.has(slug))];
+}
+/* ------------------------------------------------------------------ *
+ * Singletons
+ * ------------------------------------------------------------------ */
+/**
+ * A singleton's payload, or null when the repository has no file for it yet.
+ *
+ * Null rather than an error: a site is normally deployed before every settings
+ * form has been filled in, and the collection schema is a better place to
+ * report a missing required value than the reader is.
+ */
+export async function readSingleton(source, def, name) {
+    return readEntry(source, def.fields, name, entryBase(def.fields, name));
+}
+/* ------------------------------------------------------------------ *
+ * Shared
+ * ------------------------------------------------------------------ */
+/** The directory an entry's files live in, or null for file-shaped entries. */
+function entryBase(fields, ...segments) {
+    return entryLayout(fields) === "directory" ? segments.join("/") : null;
+}
+async function readEntry(source, fields, label, base) {
+    const dataPath = base === null ? `${label}.json` : `${base}/${INDEX_FILE}`;
+    const data = await source.read(dataPath);
+    if (data === null)
+        return null;
+    const documents = base === null ? {} : await readDocuments(source, base);
+    let parsed;
+    try {
+        parsed = parseEntry(fields, { data, documents });
+    }
+    catch (error) {
+        // A `FormatError` names the problem but not the file, and a build that
+        // says only "Content is not valid JSON" is close to useless.
+        if (error instanceof FormatError) {
+            throw new ContentReadError(`${dataPath}: ${error.message}`, dataPath, { cause: error });
+        }
+        throw error;
+    }
+    return base === null ? parsed : resolveMedia(fields, parsed, base);
+}
+/**
+ * Rewrites media references to paths relative to the content root.
+ *
+ * On disk a reference is written the way a person reading the entry would
+ * write it: `media/exterior.jpg` for a file colocated with the entry, or
+ * `/shared/logo.svg` for one the whole site uses. Both are ambiguous once the
+ * entry is out of its directory, so the root-relative form is what leaves here.
+ */
+function resolveMedia(fields, data, base) {
+    const resolveOne = (value) => typeof value === "string" && value !== ""
+        ? value.startsWith("/")
+            ? value.slice(1)
+            : `${base}/${value}`
+        : value;
+    const visit = (map, record) => {
+        const result = { ...record };
+        for (const [key, field] of Object.entries(map)) {
+            const value = record[key];
+            if (field.kind === "media") {
+                result[key] = Array.isArray(value) ? value.map(resolveOne) : resolveOne(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);
+}
+async function readDocuments(source, base) {
+    const documents = {};
+    for (const item of await source.list(base)) {
+        if (item.type !== "file" || !item.name.endsWith(DOCUMENT_EXTENSION))
+            continue;
+        const contents = await source.read(`${base}/${item.name}`);
+        if (contents !== null)
+            documents[item.name] = contents;
+    }
+    return documents;
+}
+//# sourceMappingURL=read.js.map

package/dist/read.js.map

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

package/dist/richtext.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Rendering a rich-text field.
+ *
+ * A `richText()` field is persisted as Markdoc, and this is what turns it into
+ * HTML at build time. It runs during `astro build` only; the deployed page is
+ * static, and no visitor's browser ever sees Markdoc.
+ *
+ * Markdoc rather than Markdown-with-HTML for one reason that matters: a Markdoc
+ * document can only produce what the configuration allows. An undeclared
+ * `{% tag %}` renders as nothing rather than as itself, and raw HTML is inert
+ * unless it is explicitly permitted — which it is not here. So the canonical
+ * content format cannot carry markup that escapes the site's own styling, and a
+ * compromised or careless editor session cannot inject script into a build.
+ */
+import Markdoc, { type Config, type RenderableTreeNode } from "@markdoc/markdoc";
+export interface RichTextOptions {
+    /**
+     * Extra Markdoc configuration: custom tags, nodes or variables.
+     *
+     * The place a project adds a callout or a gallery block without giving up the
+     * closed set that makes the format safe. A tag must be declared here to
+     * render at all.
+     */
+    config?: Config;
+}
+/**
+ * Markdoc source to an HTML string.
+ *
+ * Returns an empty string for empty input, so a caller can render the result
+ * directly without a null check ahead of it.
+ */
+export declare function renderRichText(source: string | null | undefined, options?: RichTextOptions): string;
+/**
+ * The intermediate renderable tree, for a project that wants to render with
+ * its own components rather than to an HTML string.
+ */
+export declare function transformRichText(source: string, options?: RichTextOptions): RenderableTreeNode;
+/**
+ * Problems Markdoc found in a document, for a build that wants to be strict.
+ *
+ * Not called by `renderRichText`: a malformed heading should not stop a site
+ * from deploying, and Markdoc degrades to plain text rather than to nothing.
+ * Exposed so a project can decide otherwise.
+ */
+export declare function validateRichText(source: string, options?: RichTextOptions): Markdoc.ValidateError[];
+//# sourceMappingURL=richtext.d.ts.map

package/dist/richtext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"richtext.d.ts","sourceRoot":"","sources":["../src/richtext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,OAAO,EAAE,EAAE,KAAK,MAAM,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEjF,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CAKvG;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,kBAAkB,CAEpB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,2BAE7E"}

package/dist/richtext.js

@@ -0,0 +1,45 @@
+/**
+ * Rendering a rich-text field.
+ *
+ * A `richText()` field is persisted as Markdoc, and this is what turns it into
+ * HTML at build time. It runs during `astro build` only; the deployed page is
+ * static, and no visitor's browser ever sees Markdoc.
+ *
+ * Markdoc rather than Markdown-with-HTML for one reason that matters: a Markdoc
+ * document can only produce what the configuration allows. An undeclared
+ * `{% tag %}` renders as nothing rather than as itself, and raw HTML is inert
+ * unless it is explicitly permitted — which it is not here. So the canonical
+ * content format cannot carry markup that escapes the site's own styling, and a
+ * compromised or careless editor session cannot inject script into a build.
+ */
+import Markdoc, {} from "@markdoc/markdoc";
+/**
+ * Markdoc source to an HTML string.
+ *
+ * Returns an empty string for empty input, so a caller can render the result
+ * directly without a null check ahead of it.
+ */
+export function renderRichText(source, options = {}) {
+    if (!source || source.trim() === "")
+        return "";
+    const tree = transformRichText(source, options);
+    return Markdoc.renderers.html(tree);
+}
+/**
+ * The intermediate renderable tree, for a project that wants to render with
+ * its own components rather than to an HTML string.
+ */
+export function transformRichText(source, options = {}) {
+    return Markdoc.transform(Markdoc.parse(source), options.config ?? {});
+}
+/**
+ * Problems Markdoc found in a document, for a build that wants to be strict.
+ *
+ * Not called by `renderRichText`: a malformed heading should not stop a site
+ * from deploying, and Markdoc degrades to plain text rather than to nothing.
+ * Exposed so a project can decide otherwise.
+ */
+export function validateRichText(source, options = {}) {
+    return Markdoc.validate(Markdoc.parse(source), options.config ?? {});
+}
+//# sourceMappingURL=richtext.js.map

package/dist/richtext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"richtext.js","sourceRoot":"","sources":["../src/richtext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,OAAO,EAAE,EAAwC,MAAM,kBAAkB,CAAC;AAajF;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,MAAiC,EAAE,UAA2B,EAAE;IAC7F,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAE/C,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,UAA2B,EAAE;IAE7B,OAAO,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,EAAE,UAA2B,EAAE;IAC5E,OAAO,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;AACvE,CAAC"}

package/dist/root.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Where the content root is, said once.
+ *
+ * The collections, the dev integration and the manifest writer all have to
+ * agree on this directory, and a disagreement between them produces an empty
+ * build rather than an error — the worst kind of failure. So the project states
+ * it once, in `defineSite({ root })`, and everything here resolves that one
+ * string the same way.
+ *
+ * Resolved against the **Astro project root**, not the working directory, which
+ * is what Astro's own `glob({ base })` does. A relative root therefore means
+ * the same thing whether the build was started from the project, from a
+ * workspace root, or by an editor extension. Absolute paths are left alone, for
+ * content that lives outside the project.
+ */
+export declare const DEFAULT_CONTENT_ROOT = "./content";
+export declare function resolveContentRoot(root: string | undefined, projectRoot?: URL): string;
+//# sourceMappingURL=root.d.ts.map

package/dist/root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../src/root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAEhD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,WAAW,CAAC,EAAE,GAAG,GAAG,MAAM,CAetF"}

package/dist/root.js

@@ -0,0 +1,34 @@
+/**
+ * Where the content root is, said once.
+ *
+ * The collections, the dev integration and the manifest writer all have to
+ * agree on this directory, and a disagreement between them produces an empty
+ * build rather than an error — the worst kind of failure. So the project states
+ * it once, in `defineSite({ root })`, and everything here resolves that one
+ * string the same way.
+ *
+ * Resolved against the **Astro project root**, not the working directory, which
+ * is what Astro's own `glob({ base })` does. A relative root therefore means
+ * the same thing whether the build was started from the project, from a
+ * workspace root, or by an editor extension. Absolute paths are left alone, for
+ * content that lives outside the project.
+ */
+import { isAbsolute, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+export const DEFAULT_CONTENT_ROOT = "./content";
+export function resolveContentRoot(root, projectRoot) {
+    const configured = root ?? DEFAULT_CONTENT_ROOT;
+    if (isAbsolute(configured))
+        return configured;
+    // Only outside a loader or a hook — a plain unit test, or an Astro version
+    // that stops passing its config. The working directory is the best guess
+    // left, and it is right whenever the build was started from the project.
+    if (!projectRoot)
+        return resolve(configured);
+    // A base without a trailing slash would have its last segment replaced
+    // rather than appended to. Astro's `config.root` has one; nothing else is
+    // guaranteed to.
+    const base = projectRoot.href.endsWith("/") ? projectRoot.href : `${projectRoot.href}/`;
+    return fileURLToPath(new URL(configured, base));
+}
+//# sourceMappingURL=root.js.map

package/dist/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../src/root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAEhD,MAAM,UAAU,kBAAkB,CAAC,IAAwB,EAAE,WAAiB;IAC5E,MAAM,UAAU,GAAG,IAAI,IAAI,oBAAoB,CAAC;IAEhD,IAAI,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IAE9C,2EAA2E;IAC3E,yEAAyE;IACzE,yEAAyE;IACzE,IAAI,CAAC,WAAW;QAAE,OAAO,OAAO,CAAC,UAAU,CAAC,CAAC;IAE7C,uEAAuE;IACvE,0EAA0E;IAC1E,iBAAiB;IACjB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,GAAG,CAAC;IACxF,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/source.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Where content files come from.
+ *
+ * Two lines wide on purpose. Everything above it — entry discovery, layout,
+ * parsing — is written against `read` and `list` and nothing else, so the same
+ * reader serves a checked-out repository during a build, an in-memory fixture
+ * in a test, and later a repository connector that answers from a provider API
+ * instead of a disk.
+ */
+export interface DirectoryEntry {
+    name: string;
+    type: "file" | "directory";
+}
+export interface ContentSource {
+    /** A description of the origin, for error messages. */
+    readonly origin: string;
+    /** File contents as UTF-8 text, or null when there is no such file. */
+    read(path: string): Promise<string | null>;
+    /** Direct children of a directory; empty when the directory does not exist. */
+    list(path: string): Promise<DirectoryEntry[]>;
+}
+export declare class ContentSourceError extends Error {
+    name: string;
+}
+/**
+ * Reads a content directory in a checked-out repository.
+ *
+ * A missing file is not an error: an entry with no rich text simply has no
+ * `.mdoc` beside it, and a collection an editor has not filled in yet is an
+ * empty directory. Refusing to build over either would be wrong. Anything else
+ * — a permission problem, a corrupt file, a path that escapes the root — is
+ * raised, because it means the content the build was asked for is not there.
+ */
+export declare function fileSystemSource(root: string): ContentSource;
+/**
+ * A source built from a flat path-to-contents map, for tests and fixtures.
+ *
+ * Directories are inferred from the paths rather than declared, which keeps a
+ * fixture to the files it actually cares about.
+ */
+export declare function memorySource(files: Record<string, string>, origin?: string): ContentSource;
+//# sourceMappingURL=source.d.ts.map

package/dist/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3C,+EAA+E;IAC/E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC/C;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAClC,IAAI,SAAwB;CACtC;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CA6C5D;AAYD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,SAAW,GAAG,aAAa,CA8B5F"}

package/dist/source.js

@@ -0,0 +1,113 @@
+/**
+ * Where content files come from.
+ *
+ * Two lines wide on purpose. Everything above it — entry discovery, layout,
+ * parsing — is written against `read` and `list` and nothing else, so the same
+ * reader serves a checked-out repository during a build, an in-memory fixture
+ * in a test, and later a repository connector that answers from a provider API
+ * instead of a disk.
+ */
+import { readdir, readFile } from "node:fs/promises";
+import { isAbsolute, join, resolve, sep } from "node:path";
+export class ContentSourceError extends Error {
+    name = "ContentSourceError";
+}
+/* ------------------------------------------------------------------ *
+ * Filesystem
+ * ------------------------------------------------------------------ */
+/**
+ * Reads a content directory in a checked-out repository.
+ *
+ * A missing file is not an error: an entry with no rich text simply has no
+ * `.mdoc` beside it, and a collection an editor has not filled in yet is an
+ * empty directory. Refusing to build over either would be wrong. Anything else
+ * — a permission problem, a corrupt file, a path that escapes the root — is
+ * raised, because it means the content the build was asked for is not there.
+ */
+export function fileSystemSource(root) {
+    const base = resolve(root);
+    const within = (path) => {
+        if (isAbsolute(path)) {
+            throw new ContentSourceError(`Content path "${path}" must be relative to the content root.`);
+        }
+        const full = resolve(base, path);
+        // `startsWith(base)` alone would accept a sibling called `content-old`.
+        if (full !== base && !full.startsWith(base + sep)) {
+            throw new ContentSourceError(`Content path "${path}" escapes the content root.`);
+        }
+        return full;
+    };
+    return {
+        origin: base,
+        async read(path) {
+            try {
+                return await readFile(within(path), "utf8");
+            }
+            catch (error) {
+                if (isMissing(error))
+                    return null;
+                throw error;
+            }
+        },
+        async list(path) {
+            let items;
+            try {
+                items = await readdir(within(path), { withFileTypes: true });
+            }
+            catch (error) {
+                if (isMissing(error))
+                    return [];
+                throw error;
+            }
+            return items
+                .filter((item) => item.isFile() || item.isDirectory())
+                // Sorted here rather than at each call site, so that a build does not
+                // depend on the order a filesystem happens to report.
+                .sort((a, b) => a.name.localeCompare(b.name))
+                .map((item) => ({ name: item.name, type: item.isFile() ? "file" : "directory" }));
+        },
+    };
+}
+/** ENOENT, and ENOTDIR for a path whose parent turned out to be a file. */
+function isMissing(error) {
+    const code = error?.code;
+    return code === "ENOENT" || code === "ENOTDIR";
+}
+/* ------------------------------------------------------------------ *
+ * In memory
+ * ------------------------------------------------------------------ */
+/**
+ * A source built from a flat path-to-contents map, for tests and fixtures.
+ *
+ * Directories are inferred from the paths rather than declared, which keeps a
+ * fixture to the files it actually cares about.
+ */
+export function memorySource(files, origin = "memory") {
+    const normalise = (path) => path.replace(/^\.?\//, "").replace(/\/$/, "");
+    return {
+        origin,
+        async read(path) {
+            return files[normalise(path)] ?? null;
+        },
+        async list(path) {
+            const prefix = normalise(path) === "" ? "" : `${normalise(path)}/`;
+            const seen = new Map();
+            for (const key of Object.keys(files)) {
+                if (!key.startsWith(prefix))
+                    continue;
+                const rest = key.slice(prefix.length);
+                if (rest === "")
+                    continue;
+                const slash = rest.indexOf("/");
+                if (slash === -1)
+                    seen.set(rest, "file");
+                else
+                    seen.set(rest.slice(0, slash), "directory");
+            }
+            return [...seen]
+                .sort(([a], [b]) => a.localeCompare(b))
+                .map(([name, type]) => ({ name, type }));
+        },
+    };
+}
+//# sourceMappingURL=source.js.map

package/dist/source.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@micacms/astro",
+  "version": "0.0.2",
+  "type": "module",
+  "description": "Reads a Mica content repository as Astro Content Collections via the Content Layer API.",
+  "license": "MIT",
+  "author": "Alexander Müdespacher",
+  "keywords": [
+    "mica",
+    "cms",
+    "astro",
+    "astro-integration",
+    "content-layer",
+    "markdoc"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@markdoc/markdoc": "^0.5.9",
+    "zod": "^3.25.76",
+    "@micacms/model": "0.0.2"
+  },
+  "peerDependencies": {
+    "astro": "^5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "astro": "^5.13.0",
+    "typescript": "^5.7.3"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch --preserveWatchOutput",
+    "typecheck": "tsc -p tsconfig.test.json",
+    "test": "tsc -p tsconfig.json && node --test test/*.test.ts"
+  }
+}