@refrakt-md/content 0.1.0

package/dist/content-tree.d.ts

@@ -0,0 +1,35 @@
+export interface ContentPage {
+    /** Absolute file path */
+    filePath: string;
+    /** Relative path from content root */
+    relativePath: string;
+    /** Raw file content */
+    raw: string;
+}
+export interface ContentDirectory {
+    /** Directory name */
+    name: string;
+    /** Absolute path */
+    dirPath: string;
+    /** Child pages */
+    pages: ContentPage[];
+    /** Child directories */
+    children: ContentDirectory[];
+    /** Layout file in this directory, if any */
+    layout?: ContentPage;
+}
+export interface ContentNode {
+    page: ContentPage;
+    directory: ContentDirectory;
+}
+export declare class ContentTree {
+    readonly root: ContentDirectory;
+    constructor(root: ContentDirectory);
+    /** Recursively walk a content directory and build the tree */
+    static fromDirectory(dirPath: string): Promise<ContentTree>;
+    /** All pages in the tree (depth-first) */
+    pages(): Generator<ContentPage>;
+    /** All layout files in the tree (depth-first) */
+    layouts(): Generator<ContentPage>;
+}
+//# sourceMappingURL=content-tree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-tree.d.ts","sourceRoot":"","sources":["../src/content-tree.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,wBAAwB;IACxB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,qBAAa,WAAW;aACM,IAAI,EAAE,gBAAgB;gBAAtB,IAAI,EAAE,gBAAgB;IAElD,8DAA8D;WACjD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAKjE,0CAA0C;IACzC,KAAK,IAAI,SAAS,CAAC,WAAW,CAAC;IAIhC,iDAAiD;IAChD,OAAO,IAAI,SAAS,CAAC,WAAW,CAAC;CAGnC"}

package/dist/content-tree.js

@@ -0,0 +1,71 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+export class ContentTree {
+    root;
+    constructor(root) {
+        this.root = root;
+    }
+    /** Recursively walk a content directory and build the tree */
+    static async fromDirectory(dirPath) {
+        const root = await readDirectory(dirPath, dirPath);
+        return new ContentTree(root);
+    }
+    /** All pages in the tree (depth-first) */
+    *pages() {
+        yield* walkPages(this.root);
+    }
+    /** All layout files in the tree (depth-first) */
+    *layouts() {
+        yield* walkLayouts(this.root);
+    }
+}
+async function readDirectory(dirPath, rootPath) {
+    const entries = await fs.promises.readdir(dirPath, { withFileTypes: true });
+    const dir = {
+        name: path.basename(dirPath),
+        dirPath,
+        pages: [],
+        children: [],
+    };
+    for (const entry of entries) {
+        const fullPath = path.join(dirPath, entry.name);
+        if (entry.isDirectory() && !entry.name.startsWith('.')) {
+            dir.children.push(await readDirectory(fullPath, rootPath));
+        }
+        else if (entry.isFile() && entry.name.endsWith('.md')) {
+            const raw = await fs.promises.readFile(fullPath, 'utf-8');
+            const page = {
+                filePath: fullPath,
+                relativePath: path.relative(rootPath, fullPath),
+                raw,
+            };
+            if (entry.name === '_layout.md') {
+                dir.layout = page;
+            }
+            else {
+                dir.pages.push(page);
+            }
+        }
+    }
+    // Sort pages by name for deterministic ordering
+    dir.pages.sort((a, b) => a.relativePath.localeCompare(b.relativePath));
+    dir.children.sort((a, b) => a.name.localeCompare(b.name));
+    return dir;
+}
+function* walkPages(dir) {
+    for (const page of dir.pages) {
+        yield page;
+    }
+    for (const child of dir.children) {
+        yield* walkPages(child);
+    }
+}
+function* walkLayouts(dir) {
+    if (dir.layout) {
+        yield dir.layout;
+    }
+    for (const child of dir.children) {
+        yield* walkLayouts(child);
+    }
+}
+//# sourceMappingURL=content-tree.js.map

package/dist/content-tree.js.map

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

package/dist/frontmatter.d.ts

@@ -0,0 +1,18 @@
+export interface Frontmatter {
+    title?: string;
+    description?: string;
+    slug?: string;
+    draft?: boolean;
+    redirect?: string;
+    order?: number;
+    [key: string]: unknown;
+}
+/**
+ * Parse YAML frontmatter from raw markdown content.
+ * Returns the frontmatter object and the content without frontmatter.
+ */
+export declare function parseFrontmatter(raw: string): {
+    frontmatter: Frontmatter;
+    content: string;
+};
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,WAAW,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAW3F"}

package/dist/frontmatter.js

@@ -0,0 +1,15 @@
+import yaml from 'yaml';
+/**
+ * Parse YAML frontmatter from raw markdown content.
+ * Returns the frontmatter object and the content without frontmatter.
+ */
+export function parseFrontmatter(raw) {
+    const match = raw.match(/^---\r?\n([\s\S]*?\r?\n)?---\r?\n?([\s\S]*)$/);
+    if (!match) {
+        return { frontmatter: {}, content: raw };
+    }
+    const frontmatter = yaml.parse(match[1] ?? '') ?? {};
+    const content = match[2];
+    return { frontmatter, content };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAYxB;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAExE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAgB,IAAI,EAAE,CAAC;IACpE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEzB,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAClC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { ContentTree, type ContentNode, type ContentPage, type ContentDirectory } from './content-tree.js';
+export { parseFrontmatter, type Frontmatter } from './frontmatter.js';
+export { Router, type Route } from './router.js';
+export { resolveLayouts, type ResolvedLayout, type Region } from './layout.js';
+export { buildNavigation, type NavTree, type NavGroup, type NavItem } from './navigation.js';
+export { loadContent, type Site, type SitePage } from './site.js';
+//# 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":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC3G,OAAO,EAAE,gBAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { ContentTree } from './content-tree.js';
+export { parseFrontmatter } from './frontmatter.js';
+export { Router } from './router.js';
+export { resolveLayouts } from './layout.js';
+export { buildNavigation } from './navigation.js';
+export { loadContent } from './site.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA6D,MAAM,mBAAmB,CAAC;AAC3G,OAAO,EAAE,gBAAgB,EAAoB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,MAAM,EAAc,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAoC,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,eAAe,EAA6C,MAAM,iBAAiB,CAAC;AAC7F,OAAO,EAAE,WAAW,EAA4B,MAAM,WAAW,CAAC"}

package/dist/layout.d.ts

@@ -0,0 +1,19 @@
+import type { RenderableTreeNode } from '@markdoc/markdoc';
+import { ContentDirectory, ContentPage } from './content-tree.js';
+export interface Region {
+    name: string;
+    mode: 'replace' | 'prepend' | 'append';
+    content: RenderableTreeNode[];
+}
+export interface ResolvedLayout {
+    /** The chain of layout files from root to nearest, in order */
+    chain: ContentPage[];
+    /** Merged regions after applying inheritance */
+    regions: Map<string, Region>;
+}
+/**
+ * Resolve the layout chain for a page by walking up the directory tree.
+ * Collects all _layout.md files from the page's directory up to the root.
+ */
+export declare function resolveLayouts(page: ContentPage, rootDir: ContentDirectory): ResolvedLayout;
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAuB,MAAM,kBAAkB,CAAC;AAGhF,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGlE,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvC,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,gDAAgD;IAChD,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,gBAAgB,GACxB,cAAc,CAIhB"}

package/dist/layout.js

@@ -0,0 +1,94 @@
+import Markdoc from '@markdoc/markdoc';
+const { Tag } = Markdoc;
+import { tags, nodes } from '@refrakt-md/runes';
+import { parseFrontmatter } from './frontmatter.js';
+/**
+ * Resolve the layout chain for a page by walking up the directory tree.
+ * Collects all _layout.md files from the page's directory up to the root.
+ */
+export function resolveLayouts(page, rootDir) {
+    const chain = findLayoutChain(page, rootDir);
+    const regions = mergeRegions(chain);
+    return { chain, regions };
+}
+/**
+ * Find all _layout.md files from root down to the page's directory.
+ */
+function findLayoutChain(page, rootDir) {
+    const parts = page.relativePath.split('/').slice(0, -1); // directory segments
+    const chain = [];
+    let current = rootDir;
+    // Root layout
+    if (current.layout) {
+        chain.push(current.layout);
+    }
+    // Walk down through directories toward the page
+    for (const part of parts) {
+        current = current.children.find(c => c.name === part);
+        if (!current)
+            break;
+        if (current.layout) {
+            chain.push(current.layout);
+        }
+    }
+    return chain;
+}
+/**
+ * Parse a layout file through Markdoc and extract regions.
+ */
+function parseLayout(layoutPage) {
+    const { content } = parseFrontmatter(layoutPage.raw);
+    const ast = Markdoc.parse(content);
+    const config = { tags, nodes, variables: { generatedIds: new Set(), path: layoutPage.relativePath } };
+    const rendered = Markdoc.transform(ast, config);
+    const regions = [];
+    findRegions(rendered, regions);
+    return regions;
+}
+/**
+ * Recursively walk a rendered Tag tree to find data-region containers.
+ */
+function findRegions(node, results) {
+    if (Array.isArray(node)) {
+        for (const child of node) {
+            findRegions(child, results);
+        }
+        return;
+    }
+    if (!Tag.isTag(node))
+        return;
+    const regionName = node.attributes['data-region'];
+    if (regionName) {
+        const mode = node.attributes['data-mode'] || 'replace';
+        results.push({ name: regionName, mode, content: node.children });
+        return; // Don't recurse into region children — they're the region's content
+    }
+    // Recurse into non-region tags (e.g., the layout wrapper div)
+    for (const child of node.children) {
+        findRegions(child, results);
+    }
+}
+/**
+ * Merge regions from a layout chain.
+ * Later layouts in the chain can replace, prepend, or append to earlier regions.
+ */
+function mergeRegions(chain) {
+    const merged = new Map();
+    for (const layoutPage of chain) {
+        const regions = parseLayout(layoutPage);
+        for (const { name, mode, content } of regions) {
+            const existing = merged.get(name);
+            if (!existing || mode === 'replace') {
+                merged.set(name, { name, mode, content });
+            }
+            else if (mode === 'prepend') {
+                merged.set(name, { name, mode: existing.mode, content: [...content, ...existing.content] });
+            }
+            else if (mode === 'append') {
+                merged.set(name, { name, mode: existing.mode, content: [...existing.content, ...content] });
+            }
+        }
+    }
+    return merged;
+}
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

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

package/dist/navigation.d.ts

@@ -0,0 +1,29 @@
+export interface NavItem {
+    /** Page slug or URL */
+    slug: string;
+    /** Display title */
+    title?: string;
+    /** Child items */
+    children: NavItem[];
+}
+export interface NavGroup {
+    /** Group title */
+    title: string;
+    /** Items in this group */
+    items: NavItem[];
+}
+export interface NavTree {
+    /** Navigation groups */
+    groups: NavGroup[];
+    /** Top-level items not in any group */
+    items: NavItem[];
+    /** Whether this nav supports sequential pagination */
+    ordered: boolean;
+}
+/**
+ * Build a navigation tree from parsed {% nav %} rune output.
+ * This processes the rendered Tag tree from the nav rune into a
+ * structured navigation object.
+ */
+export declare function buildNavigation(navTag: unknown): NavTree;
+//# sourceMappingURL=navigation.d.ts.map

package/dist/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO;IACtB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,QAAQ;IACvB,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,OAAO;IACtB,wBAAwB;IACxB,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,uCAAuC;IACvC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,sDAAsD;IACtD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAOxD"}

package/dist/navigation.js

@@ -0,0 +1,14 @@
+/**
+ * Build a navigation tree from parsed {% nav %} rune output.
+ * This processes the rendered Tag tree from the nav rune into a
+ * structured navigation object.
+ */
+export function buildNavigation(navTag) {
+    // TODO: Implement full nav tree building from rendered Tag output
+    return {
+        groups: [],
+        items: [],
+        ordered: false,
+    };
+}
+//# sourceMappingURL=navigation.js.map

package/dist/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"AAyBA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAe;IAC7C,kEAAkE;IAClE,OAAO;QACL,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,30 @@
+import { Frontmatter } from './frontmatter.js';
+export interface Route {
+    /** The URL path for this page */
+    url: string;
+    /** The original relative file path */
+    filePath: string;
+    /** Whether this page is a draft */
+    draft: boolean;
+    /** Redirect target, if any */
+    redirect?: string;
+}
+export declare class Router {
+    private basePath;
+    constructor(basePath?: string);
+    /**
+     * Layer 1: File path → URL path
+     * - Strip .md extension
+     * - Convert index.md to /
+     * - Strip numeric prefixes (01-intro → intro)
+     */
+    filePathToUrl(relativePath: string): string;
+    /**
+     * Layer 2: Apply frontmatter overrides
+     * - slug override replaces the computed URL
+     * - draft pages are flagged
+     * - redirect pages are flagged
+     */
+    resolve(relativePath: string, frontmatter: Frontmatter): Route;
+}
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,WAAW,KAAK;IACpB,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,MAAM;IACL,OAAO,CAAC,QAAQ;gBAAR,QAAQ,GAAE,MAAY;IAE1C;;;;;OAKG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAgB3C;;;;;OAKG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,KAAK;CAY/D"}

package/dist/router.js

@@ -0,0 +1,44 @@
+import * as path from 'node:path';
+export class Router {
+    basePath;
+    constructor(basePath = '/') {
+        this.basePath = basePath;
+    }
+    /**
+     * Layer 1: File path → URL path
+     * - Strip .md extension
+     * - Convert index.md to /
+     * - Strip numeric prefixes (01-intro → intro)
+     */
+    filePathToUrl(relativePath) {
+        let url = relativePath
+            .replace(/\.md$/, '')
+            .split(path.sep)
+            .map(segment => segment.replace(/^\d+-/, ''))
+            .join('/');
+        // index files map to directory root
+        if (url.endsWith('/index') || url === 'index') {
+            url = url.replace(/\/?index$/, '');
+        }
+        const base = this.basePath.endsWith('/') ? this.basePath.slice(0, -1) : this.basePath;
+        return `${base}/${url}` || '/';
+    }
+    /**
+     * Layer 2: Apply frontmatter overrides
+     * - slug override replaces the computed URL
+     * - draft pages are flagged
+     * - redirect pages are flagged
+     */
+    resolve(relativePath, frontmatter) {
+        const url = frontmatter.slug
+            ? (frontmatter.slug.startsWith('/') ? frontmatter.slug : `${this.basePath}${frontmatter.slug}`)
+            : this.filePathToUrl(relativePath);
+        return {
+            url,
+            filePath: relativePath,
+            draft: frontmatter.draft === true,
+            redirect: frontmatter.redirect,
+        };
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAclC,MAAM,OAAO,MAAM;IACG;IAApB,YAAoB,WAAmB,GAAG;QAAtB,aAAQ,GAAR,QAAQ,CAAc;IAAG,CAAC;IAE9C;;;;;OAKG;IACH,aAAa,CAAC,YAAoB;QAChC,IAAI,GAAG,GAAG,YAAY;aACnB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;aACpB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;aACf,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;aAC5C,IAAI,CAAC,GAAG,CAAC,CAAC;QAEb,oCAAoC;QACpC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YAC9C,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACrC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QACtF,OAAO,GAAG,IAAI,IAAI,GAAG,EAAE,IAAI,GAAG,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,YAAoB,EAAE,WAAwB;QACpD,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI;YAC1B,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC;YAC/F,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QAErC,OAAO;YACL,GAAG;YACH,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,WAAW,CAAC,KAAK,KAAK,IAAI;YACjC,QAAQ,EAAE,WAAW,CAAC,QAAQ;SAC/B,CAAC;IACJ,CAAC;CACF"}

package/dist/site.d.ts

@@ -0,0 +1,26 @@
+import type { RenderableTreeNodes } from '@markdoc/markdoc';
+import { ContentTree } from './content-tree.js';
+import { Frontmatter } from './frontmatter.js';
+import { Route } from './router.js';
+import { ResolvedLayout } from './layout.js';
+import { NavTree } from './navigation.js';
+export interface Site {
+    /** The content tree */
+    tree: ContentTree;
+    /** All resolved pages with routes and layouts */
+    pages: SitePage[];
+    /** Navigation trees found in layouts */
+    navigation: NavTree[];
+}
+export interface SitePage {
+    route: Route;
+    frontmatter: Frontmatter;
+    content: string;
+    renderable: RenderableTreeNodes;
+    layout: ResolvedLayout;
+}
+/**
+ * Load a content directory and resolve all pages, routes, layouts, and navigation.
+ */
+export declare function loadContent(dirPath: string, basePath?: string): Promise<Site>;
+//# sourceMappingURL=site.d.ts.map

package/dist/site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAoB,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAU,KAAK,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAkB,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,MAAM,WAAW,IAAI;IACnB,uBAAuB;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,iDAAiD;IACjD,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,wCAAwC;IACxC,UAAU,EAAE,OAAO,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,mBAAmB,CAAC;IAChC,MAAM,EAAE,cAAc,CAAC;CACxB;AASD;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBxF"}

package/dist/site.js

@@ -0,0 +1,33 @@
+import Markdoc from '@markdoc/markdoc';
+import { tags, nodes, extractHeadings } from '@refrakt-md/runes';
+import { ContentTree } from './content-tree.js';
+import { parseFrontmatter } from './frontmatter.js';
+import { Router } from './router.js';
+import { resolveLayouts } from './layout.js';
+function transformContent(content, path) {
+    const ast = Markdoc.parse(content);
+    const headings = extractHeadings(ast);
+    const config = { tags, nodes, variables: { generatedIds: new Set(), path, headings } };
+    return Markdoc.transform(ast, config);
+}
+/**
+ * Load a content directory and resolve all pages, routes, layouts, and navigation.
+ */
+export async function loadContent(dirPath, basePath = '/') {
+    const tree = await ContentTree.fromDirectory(dirPath);
+    const router = new Router(basePath);
+    const pages = [];
+    for (const page of tree.pages()) {
+        const { frontmatter, content } = parseFrontmatter(page.raw);
+        const route = router.resolve(page.relativePath, frontmatter);
+        const layout = resolveLayouts(page, tree.root);
+        const renderable = transformContent(content, route.url);
+        pages.push({ route, frontmatter, content, renderable, layout });
+    }
+    return {
+        tree,
+        pages,
+        navigation: [], // TODO: Extract from resolved layouts
+    };
+}
+//# sourceMappingURL=site.js.map

package/dist/site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,kBAAkB,CAAC;AAEvC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAe,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAS,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAkB,MAAM,aAAa,CAAC;AAoB7D,SAAS,gBAAgB,CAAC,OAAe,EAAE,IAAY;IACrD,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,IAAI,GAAG,EAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;IAC/F,OAAO,OAAO,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAe,EAAE,WAAmB,GAAG;IACvE,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,KAAK,GAAe,EAAE,CAAC;IAE7B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QAChC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,MAAM,UAAU,GAAG,gBAAgB,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAExD,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO;QACL,IAAI;QACJ,KAAK;QACL,UAAU,EAAE,EAAE,EAAE,sCAAsC;KACvD,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@refrakt-md/content",
+  "description": "Content loading and transformation pipeline",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/refrakt-md/refrakt.git",
+    "directory": "packages/content"
+  },
+  "bugs": "https://github.com/refrakt-md/refrakt/issues",
+  "homepage": "https://github.com/refrakt-md/refrakt",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@refrakt-md/runes": "0.1.0",
+    "@refrakt-md/types": "0.1.0",
+    "@markdoc/markdoc": "0.4.0",
+    "yaml": "^2.4.0"
+  }
+}