@micacms/astro 0.0.4 → 0.1.1

package/README.md

@@ -94,4 +94,4 @@ that wants to render with its own components.
 npm install @micacms/astro
 ```
 
-Astro 5 is a peer dependency. Requires Node 22.5 or newer. Licence: MIT.
+Astro 6 or 7 is a peer dependency. Requires Node 22.12 or newer. Licence: MIT.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@micacms/astro",
-  "version": "0.0.4",
+  "version": "0.1.1",
   "type": "module",
   "description": "Reads a Mica content repository as Astro Content Collections via the Content Layer API.",
   "license": "MIT",
@@ -28,15 +28,15 @@
   ],
   "dependencies": {
     "@markdoc/markdoc": "^0.5.9",
-    "zod": "^3.25.76",
-    "@micacms/model": "0.0.4"
+    "zod": "^4.3.6",
+    "@micacms/model": "0.1.1"
   },
   "peerDependencies": {
-    "astro": "^5.0.0"
+    "astro": "^6.0.0 || ^7.0.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.1",
-    "astro": "^5.13.0",
+    "astro": "^7.2.2",
     "typescript": "^5.7.3"
   },
   "scripts": {

package/dist/read.d.ts

@@ -1,44 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,186 +0,0 @@
-/**
- * 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

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

package/dist/source.d.ts

@@ -1,42 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,113 +0,0 @@
-/**
- * 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

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