@galaxy-foundry/content-reader 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 John Chilton
+
+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,71 @@
+# @galaxy-foundry/content-reader
+
+The headless content-reading plumbing shared by Foundry-pattern instances.
+
+```sh
+pnpm add @galaxy-foundry/content-reader
+```
+
+An instance owns its kinds, zod schemas, collection table, routes, registries, identity, theme,
+and domain-specific page furniture. Once it has those, every content site asks the same mechanical
+questions: which files does a collection select, what are their route IDs, which notes may wiki
+links target, and how does the Markdown renderer bind those links?
+
+```ts
+import { createContentReader } from '@galaxy-foundry/content-reader';
+
+export const contentReader = createContentReader({
+  collections: COLLECTIONS,
+  contentPath,
+  aliases: (meta, id, collection) =>
+    meta.type === 'cli-command' && typeof meta.tool === 'string' && typeof meta.command === 'string'
+      ? [`${meta.tool} ${meta.command}`]
+      : meta.type === 'mold' && typeof meta.name === 'string'
+        ? [meta.name]
+        : [],
+  targetOf: (collection, id, meta) => {
+    const target = { path: `${collection}/${id}` };
+    return typeof meta?.summary === 'string' ? { ...target, title: meta.summary } : target;
+  },
+});
+
+contentReader.noteFiles('papers');
+contentReader.noteIds('papers');
+contentReader.wikiLinkMap();
+contentReader.remarkWikiLinks({ base: '/my-foundry' });
+contentReader.resolveMarkdown(source, { base: '/my-foundry' });
+```
+
+Extra content targets, such as design documents outside the typed collection table, are passed as
+`{ key, target }` entries.
+
+`aliases` is the instance vocabulary seam: the package reads each routed note's YAML frontmatter
+once and registers the returned second addresses. The same frontmatter is passed to `targetOf`, so
+route targets can carry a `summary` tooltip without another filesystem walk. Readers that omit
+`aliases` continue to touch directory entries only; set `readFrontmatter: true` when `targetOf`
+needs metadata but no aliases are required.
+
+Address precedence is deterministic:
+
+1. Primary note addresses are registered in collection property order, then sorted note-path
+   order. A later primary overwrites an earlier primary, so collection declaration order is a
+   contractual part of a corpus with basename collisions.
+2. Aliases fill empty addresses and never overwrite a primary. The first routed note wins when
+   two aliases collide.
+3. Explicit `extraTargets` are applied last and may deliberately override either.
+
+Only files admitted by the collection table become primary or alias targets. Markdown companions
+and other adjacent files remain visible to `markdownFiles()` but cannot leak into `wikiLinkMap()`.
+
+## Boundary
+
+This package deliberately does not assemble zod schemas or Astro collections. Astro preserves the
+frontmatter type of a collection only when each schema-bearing export is written out; mapping a
+heterogeneous catalog collapses the inferred shapes. It also does not decide how a Package differs
+from a Paper or how either is rendered. Those are the instance's content model.
+
+The package touches the filesystem, so it belongs in build, validation, and Astro server code—not
+browser bundles. Reusable Astro presentation lives in `@galaxy-foundry/site-kit`.
+
+See the [content-reader boundary](../../docs/architecture/content-reader-boundary.md) for the
+cross-package and instance ownership map.

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+import { type CollectionTable } from '@galaxy-foundry/kind-schema/collections';
+import remarkWikiLinks from '@galaxy-foundry/wiki-links/remark';
+export interface ContentTarget {
+    /** Site-relative path without the deployment base or trailing slash. */
+    path: string;
+    /** Optional tooltip carried by rendered wiki links. */
+    title?: string;
+}
+/** A note's YAML frontmatter before an instance schema has parsed it. */
+export type Frontmatter = Record<string, unknown>;
+/** Extra wiki-link addresses derived from an instance's own note vocabulary. */
+export type ContentAliases<Collections extends CollectionTable> = (meta: Frontmatter, id: string, collection: keyof Collections & string) => readonly string[];
+export interface ExtraContentTarget<Target extends ContentTarget = ContentTarget> {
+    /** Author-facing key before wiki-link slugification. */
+    key: string;
+    target: Target;
+}
+export interface ContentLink {
+    href: string | null;
+    label: string;
+}
+export interface ContentLinkOptions<Target extends ContentTarget> {
+    base?: string;
+    extraTargets?: readonly ExtraContentTarget<Target>[];
+}
+export interface ContentReaderOptions<Collections extends CollectionTable, Target extends ContentTarget> {
+    /**
+     * Routed collections in primary-address precedence order. When two notes have the same
+     * primary slug, the later collection wins.
+     */
+    collections: Collections;
+    /** Resolve a content-relative path to the filesystem frame used by this process. */
+    contentPath: (relativePath: string) => string;
+    /**
+     * Read YAML frontmatter even when no aliases are configured. Supplying aliases already opts
+     * into frontmatter reads.
+     */
+    readFrontmatter?: boolean;
+    /** Instance-owned second addresses for a note. Aliases never overwrite a primary address. */
+    aliases?: ContentAliases<Collections>;
+    /** Map a typed note to its content route. Route policy stays with the instance. */
+    targetOf: (collection: keyof Collections & string, id: string, meta: Frontmatter | undefined) => Target;
+}
+export interface ContentReader<Collections extends CollectionTable, Target extends ContentTarget> {
+    markdownFiles(): string[];
+    noteFiles<Name extends keyof Collections & string>(name: Name): string[];
+    noteIds<Name extends keyof Collections & string>(name: Name): string[];
+    wikiLinkMap(extraTargets?: readonly ExtraContentTarget<Target>[]): Map<string, Target>;
+    resolveLink(value: string, options?: ContentLinkOptions<Target>): ContentLink;
+    remarkWikiLinks(options?: ContentLinkOptions<Target>): ReturnType<typeof remarkWikiLinks>;
+    resolveMarkdown(source: string, options?: ContentLinkOptions<Target>): string;
+}
+/** Remove the two note layouts from a collection-relative path. */
+export declare function noteIdFromPath(relativePath: string): string;
+export declare function resolveContentLink<Target extends ContentTarget>(value: string, map: ReadonlyMap<string, Target>, base?: string): ContentLink;
+export declare function remarkContentWikiLinks<Target extends ContentTarget>(map: ReadonlyMap<string, Target>, base?: string): ReturnType<typeof remarkWikiLinks>;
+export declare function resolveContentMarkdown<Target extends ContentTarget>(source: string, map: ReadonlyMap<string, Target>, base?: string): string;
+export declare function createContentReader<Collections extends CollectionTable, Target extends ContentTarget = ContentTarget>(options: ContentReaderOptions<Collections, Target>): ContentReader<Collections, Target>;
+//# 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,139 @@
+import fs from 'node:fs';
+import yaml from 'js-yaml';
+import { matchesCollection } from '@galaxy-foundry/kind-schema/collections';
+import { parseWikiLink, resolveWikiLink, resolveWikiLinksInMarkdown, slugify, } from '@galaxy-foundry/wiki-links';
+import remarkWikiLinks from '@galaxy-foundry/wiki-links/remark';
+/** Remove the two note layouts from a collection-relative path. */
+export function noteIdFromPath(relativePath) {
+    return relativePath.replace(/(?:\/index)?\.md$/, '');
+}
+const FRONTMATTER_RE = /^(?:\uFEFF)?---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/;
+const normalizeFrontmatterValue = (value) => {
+    if (value instanceof Date)
+        return value.toISOString().slice(0, 10);
+    if (Array.isArray(value))
+        return value.map(normalizeFrontmatterValue);
+    if (value !== null && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value).map(([key, nested]) => [key, normalizeFrontmatterValue(nested)]));
+    }
+    return value;
+};
+const readNoteFrontmatter = (filePath) => {
+    const source = fs.readFileSync(filePath, 'utf8');
+    const document = FRONTMATTER_RE.exec(source)?.[1];
+    if (document === undefined)
+        return {};
+    const parsed = yaml.load(document);
+    if (parsed === undefined || parsed === null)
+        return {};
+    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new TypeError(`${filePath}: YAML frontmatter must be a mapping`);
+    }
+    return normalizeFrontmatterValue(parsed);
+};
+const hrefFor = (base, target) => {
+    const normalizedBase = base.replace(/\/$/, '');
+    const normalizedPath = target.path.replace(/^\//, '').replace(/\/$/, '');
+    return `${normalizedBase}/${normalizedPath}/`;
+};
+const destinationFor = (base, target) => {
+    const href = hrefFor(base, target);
+    return target.title === undefined ? { href } : { href, title: target.title };
+};
+export function resolveContentLink(value, map, base = '') {
+    const parsed = parseWikiLink(value);
+    const target = resolveWikiLink(value, map);
+    const label = parsed?.display ?? parsed?.target ?? value;
+    return {
+        href: target ? `${hrefFor(base, target)}${parsed?.anchor ?? ''}` : null,
+        label,
+    };
+}
+export function remarkContentWikiLinks(map, base = '') {
+    return remarkWikiLinks({
+        resolve: (link) => {
+            const target = resolveWikiLink(link.target, map);
+            return target ? destinationFor(base, target) : null;
+        },
+    });
+}
+export function resolveContentMarkdown(source, map, base = '') {
+    return resolveWikiLinksInMarkdown(source, {
+        resolve: (link) => {
+            const target = resolveWikiLink(link.target, map);
+            return target ? destinationFor(base, target) : null;
+        },
+    });
+}
+export function createContentReader(options) {
+    const { aliases, collections, contentPath, readFrontmatter = false, targetOf } = options;
+    const walk = (directory) => {
+        const absoluteDirectory = contentPath(directory);
+        if (!fs.existsSync(absoluteDirectory))
+            return [];
+        const files = [];
+        for (const entry of fs.readdirSync(absoluteDirectory, { withFileTypes: true })) {
+            const relativePath = directory ? `${directory}/${entry.name}` : entry.name;
+            if (entry.isDirectory())
+                files.push(...walk(relativePath));
+            else if (entry.isFile())
+                files.push(relativePath);
+        }
+        return files;
+    };
+    const noteFiles = (name) => {
+        const row = collections[name];
+        return walk(row.base)
+            .filter((relativePath) => matchesCollection(relativePath, row))
+            .sort();
+    };
+    const noteIds = (name) => {
+        const prefix = `${collections[name].base}/`;
+        return noteFiles(name).map((relativePath) => noteIdFromPath(relativePath.slice(prefix.length)));
+    };
+    const wikiLinkMap = (extraTargets = []) => {
+        const map = new Map();
+        // Object property order is the collection-precedence contract. Keep primary registration in
+        // this first pass so no alias can take an address that belongs to a routed note. Within a
+        // collection noteFiles is sorted, making the full precedence deterministic.
+        const notes = [];
+        for (const name of Object.keys(collections)) {
+            const prefix = `${collections[name].base}/`;
+            for (const relativePath of noteFiles(name)) {
+                const id = noteIdFromPath(relativePath.slice(prefix.length));
+                const meta = aliases || readFrontmatter ? readNoteFrontmatter(contentPath(relativePath)) : undefined;
+                const target = targetOf(name, id, meta);
+                notes.push({ collection: name, id, meta, target });
+                map.set(slugify(id.replace(/\//g, '-')), target);
+            }
+        }
+        // Aliases fill empty addresses only. In an alias/alias collision, the first routed note wins;
+        // in an alias/primary collision, the primary wins regardless of collection order.
+        if (aliases) {
+            for (const note of notes) {
+                for (const alias of aliases(note.meta, note.id, note.collection)) {
+                    const key = slugify(alias);
+                    if (!map.has(key))
+                        map.set(key, note.target);
+                }
+            }
+        }
+        // Explicit extra targets are the caller's escape hatch and retain their existing final-write
+        // behavior, including the ability to override a routed target deliberately.
+        for (const { key, target } of extraTargets)
+            map.set(slugify(key), target);
+        return map;
+    };
+    return {
+        markdownFiles: () => walk('')
+            .filter((file) => file.endsWith('.md'))
+            .sort(),
+        noteFiles,
+        noteIds,
+        wikiLinkMap,
+        resolveLink: (value, linkOptions = {}) => resolveContentLink(value, wikiLinkMap(linkOptions.extraTargets), linkOptions.base),
+        remarkWikiLinks: (linkOptions = {}) => remarkContentWikiLinks(wikiLinkMap(linkOptions.extraTargets), linkOptions.base),
+        resolveMarkdown: (source, linkOptions = {}) => resolveContentMarkdown(source, wikiLinkMap(linkOptions.extraTargets), linkOptions.base),
+    };
+}
+//# 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/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@galaxy-foundry/content-reader",
+  "version": "0.1.0",
+  "description": "Collection-backed content and wiki-link plumbing shared by Foundry sites; schemas, routes, and domain presentation stay per-instance.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jmchilton/foundry-lib.git",
+    "directory": "packages/content-reader"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "keywords": [
+    "foundry",
+    "content-reader",
+    "content",
+    "wiki-links"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "js-yaml": "^4.1.0",
+    "@galaxy-foundry/wiki-links": "^0.4.0",
+    "@galaxy-foundry/kind-schema": "^0.5.1"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.10"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc -p tsconfig.test.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}