mordoc 0.1.13 → 1.0.0

package/dist/config/site.js

@@ -0,0 +1,72 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// Relative path to the site config file within any Mordoc project root.
+const SITE_CONFIG_PATH = join('config', 'site.json');
+// Fields that must be present and non-empty for a config to be considered valid.
+const REQUIRED_FIELDS = [
+    'name',
+    'description',
+    'baseUrl',
+    'defaultLanguage',
+];
+/**
+ * Validates the raw parsed JSON from site.json and narrows it to SiteConfig.
+ * Throws a descriptive error if any required field is missing or malformed,
+ * so the user gets actionable feedback rather than a cryptic runtime crash.
+ */
+function validateSiteConfig(raw) {
+    if (typeof raw !== 'object' || raw === null) {
+        throw new Error('site.json must contain a JSON object.');
+    }
+    const obj = raw;
+    for (const field of REQUIRED_FIELDS) {
+        if (typeof obj[field] !== 'string' || obj[field] === '') {
+            throw new Error(`site.json: "${field}" is required and must be a non-empty string.`);
+        }
+    }
+    // Validate baseUrl with the built-in URL parser — it handles all the edge
+    // cases (missing protocol, invalid characters, etc.) so we don't have to.
+    const baseUrl = obj['baseUrl'];
+    try {
+        new URL(baseUrl);
+    }
+    catch {
+        throw new Error(`site.json: "baseUrl" must be a valid URL. Got: "${baseUrl}"`);
+    }
+    // A trailing slash on baseUrl would cause double-slashes when paths are appended.
+    if (baseUrl.endsWith('/')) {
+        throw new Error(`site.json: "baseUrl" must not end with a trailing slash. Got: "${baseUrl}"`);
+    }
+    return raw;
+}
+/**
+ * Reads and validates the site.json config file for a Mordoc project.
+ *
+ * @param projectRoot - Absolute path to the project's root directory.
+ * @returns The validated site configuration object.
+ * @throws If the file is missing, unreadable, contains invalid JSON,
+ *         or fails field validation.
+ */
+export async function loadSiteConfig(projectRoot) {
+    const filePath = join(projectRoot, SITE_CONFIG_PATH);
+    let content;
+    try {
+        content = await readFile(filePath, 'utf-8');
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT') {
+            throw new Error(`Config file not found: ${filePath}\nEvery Mordoc project requires a config/site.json file.`);
+        }
+        throw new Error(`Failed to read ${filePath}: ${err.message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(content);
+    }
+    catch {
+        throw new Error(`Failed to parse ${filePath}: Invalid JSON.`);
+    }
+    return validateSiteConfig(parsed);
+}
+//# sourceMappingURL=site.js.map

package/dist/config/site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../../src/config/site.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,wEAAwE;AACxE,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAErD,iFAAiF;AACjF,MAAM,eAAe,GAAyB;IAC5C,MAAM;IACN,aAAa;IACb,SAAS;IACT,iBAAiB;CAClB,CAAC;AAEF;;;;GAIG;AACH,SAAS,kBAAkB,CAAC,GAAY;IACtC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,GAAG,GAAG,GAA8B,CAAC;IAE3C,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACpC,IAAI,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YACxD,MAAM,IAAI,KAAK,CAAC,eAAe,KAAK,+CAA+C,CAAC,CAAC;QACvF,CAAC;IACH,CAAC;IAED,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAW,CAAC;IACzC,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,mDAAmD,OAAO,GAAG,CAAC,CAAC;IACjF,CAAC;IAED,kFAAkF;IAClF,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,kEAAkE,OAAO,GAAG,CAAC,CAAC;IAChG,CAAC;IAED,OAAO,GAAiB,CAAC;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB;IACtD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAErD,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,0DAA0D,CAAC,CAAC;QAChH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kBAAkB,QAAQ,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,iBAAiB,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/config/topnav-loader.d.ts

@@ -0,0 +1,10 @@
+import type { ResolvedTopnavConfig } from '../types/navigation.js';
+/**
+ * Loads config/navigation/topnav.yaml and resolves all referenced sidenav files.
+ * Returns null if topnav.yaml does not exist (single-sidenav project).
+ *
+ * @param projectRoot - Absolute path to the project's root directory.
+ * @returns The resolved topnav with loaded sidenavs, or null if topnav.yaml is absent.
+ */
+export declare function loadTopnavConfig(projectRoot: string): Promise<ResolvedTopnavConfig | null>;
+//# sourceMappingURL=topnav-loader.d.ts.map

package/dist/config/topnav-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topnav-loader.d.ts","sourceRoot":"","sources":["../../src/config/topnav-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAA4B,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAiD7F;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAkChG"}

package/dist/config/topnav-loader.js

@@ -0,0 +1,78 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import yaml from 'js-yaml';
+import { loadSidenavFile } from './sidenav-loader.js';
+const NAV_DIR = join('config', 'navigation');
+const TOPNAV_CONFIG_PATH = join(NAV_DIR, 'topnav.yaml');
+function validateTopnavConfig(raw) {
+    if (!Array.isArray(raw)) {
+        throw new Error('topnav.yaml: file must contain a YAML array at the top level.');
+    }
+    if (raw.length === 0) {
+        throw new Error('topnav.yaml: navigation array must not be empty.');
+    }
+    const seenSidenavs = new Set();
+    for (const [index, entry] of raw.entries()) {
+        if (typeof entry !== 'object' || entry === null) {
+            throw new Error(`topnav.yaml: items[${index}] must be an object.`);
+        }
+        const obj = entry;
+        if (typeof obj['label'] !== 'string' || obj['label'] === '') {
+            throw new Error(`topnav.yaml: items[${index}].label is required and must be a non-empty string.`);
+        }
+        if (typeof obj['path'] !== 'string' || obj['path'] === '') {
+            throw new Error(`topnav.yaml: items[${index}].path is required and must be a non-empty string.`);
+        }
+        if (typeof obj['sidenav'] !== 'string' || obj['sidenav'] === '') {
+            throw new Error(`topnav.yaml: items[${index}].sidenav is required and must be a non-empty string.`);
+        }
+        if (!obj['sidenav'].endsWith('.yaml') && !obj['sidenav'].endsWith('.yml')) {
+            throw new Error(`topnav.yaml: items[${index}].sidenav must be a .yaml or .yml filename.`);
+        }
+        if (seenSidenavs.has(obj['sidenav'])) {
+            throw new Error(`topnav.yaml: duplicate sidenav reference "${obj['sidenav']}".`);
+        }
+        seenSidenavs.add(obj['sidenav']);
+    }
+    return raw;
+}
+/**
+ * Loads config/navigation/topnav.yaml and resolves all referenced sidenav files.
+ * Returns null if topnav.yaml does not exist (single-sidenav project).
+ *
+ * @param projectRoot - Absolute path to the project's root directory.
+ * @returns The resolved topnav with loaded sidenavs, or null if topnav.yaml is absent.
+ */
+export async function loadTopnavConfig(projectRoot) {
+    const filePath = join(projectRoot, TOPNAV_CONFIG_PATH);
+    let content;
+    try {
+        content = await readFile(filePath, 'utf-8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            return null;
+        }
+        throw new Error(`Failed to read ${filePath}: ${err.message}`);
+    }
+    let parsed;
+    try {
+        parsed = yaml.load(content);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse ${filePath}: ${err.message}`);
+    }
+    const topnavItems = validateTopnavConfig(parsed);
+    const resolved = [];
+    for (const item of topnavItems) {
+        const sidenavPath = join(projectRoot, NAV_DIR, item.sidenav);
+        const sidenav = await loadSidenavFile(sidenavPath);
+        resolved.push({
+            label: item.label,
+            path: item.path,
+            sidenav,
+        });
+    }
+    return resolved;
+}
+//# sourceMappingURL=topnav-loader.js.map

package/dist/config/topnav-loader.js.map

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

package/dist/config/translations-loader.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Loads navigation label translations for all non-default languages from
+ * config/navigation/translations/<lang>.yaml. Missing files silently yield
+ * an empty map (English labels are shown as fallback).
+ */
+export declare function loadNavTranslations(projectRoot: string, languages: string[], defaultLanguage: string): Promise<Record<string, Record<string, string>>>;
+//# sourceMappingURL=translations-loader.d.ts.map

package/dist/config/translations-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations-loader.d.ts","sourceRoot":"","sources":["../../src/config/translations-loader.ts"],"names":[],"mappings":"AA2CA;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,EACnB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAUjD"}

package/dist/config/translations-loader.js

@@ -0,0 +1,51 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import yaml from 'js-yaml';
+const TRANSLATIONS_DIR = join('config', 'navigation', 'translations');
+async function loadTranslationFile(filePath, lang) {
+    let content;
+    try {
+        content = await readFile(filePath, 'utf-8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return {};
+        throw new Error(`Failed to read translation file for "${lang}": ${err.message}`);
+    }
+    let parsed;
+    try {
+        parsed = yaml.load(content);
+    }
+    catch (err) {
+        throw new Error(`Failed to parse translation file for "${lang}": ${err.message}`);
+    }
+    if (parsed === null || parsed === undefined)
+        return {};
+    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`Translation file for "${lang}" must be a YAML object (label: translation pairs).`);
+    }
+    const result = {};
+    for (const [key, value] of Object.entries(parsed)) {
+        if (typeof value !== 'string') {
+            throw new Error(`Translation file for "${lang}": value for key "${key}" must be a string.`);
+        }
+        result[key] = value;
+    }
+    return result;
+}
+/**
+ * Loads navigation label translations for all non-default languages from
+ * config/navigation/translations/<lang>.yaml. Missing files silently yield
+ * an empty map (English labels are shown as fallback).
+ */
+export async function loadNavTranslations(projectRoot, languages, defaultLanguage) {
+    const result = {};
+    for (const lang of languages) {
+        if (lang === defaultLanguage)
+            continue;
+        const filePath = join(projectRoot, TRANSLATIONS_DIR, `${lang}.yaml`);
+        result[lang] = await loadTranslationFile(filePath, lang);
+    }
+    return result;
+}
+//# sourceMappingURL=translations-loader.js.map

package/dist/config/translations-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations-loader.js","sourceRoot":"","sources":["../../src/config/translations-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,cAAc,CAAC,CAAC;AAEtE,KAAK,UAAU,mBAAmB,CAAC,QAAgB,EAAE,IAAY;IAC/D,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,MAAO,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,yCAAyC,IAAI,MAAO,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAEvD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,qDAAqD,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,EAAE,CAAC;QAC7E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,yBAAyB,IAAI,qBAAqB,GAAG,qBAAqB,CAC3E,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,EACnB,SAAmB,EACnB,eAAuB;IAEvB,MAAM,MAAM,GAA2C,EAAE,CAAC;IAE1D,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,eAAe;YAAE,SAAS;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;QACrE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/content/content-loader.d.ts

@@ -0,0 +1,16 @@
+import type { ContentMap } from '../types/content.js';
+/**
+ * Discovers all markdown content files and builds a route manifest.
+ *
+ * - Scans content/<lang>/ for each language.
+ * - Default language routes have no prefix ("/overview"); other languages are prefixed ("/de/overview").
+ * - If a declared language has no content directory, it is skipped with a warning (falls back to default at runtime).
+ * - Errors if the default language has no content directory or no index.md.
+ *
+ * @param projectRoot - Absolute path to the project's root directory.
+ * @param defaultLanguage - The defaultLanguage value from site.json.
+ * @param languages - Array of declared languages from language.json, or null for single-language projects.
+ * @returns The content manifest with all discovered entries.
+ */
+export declare function loadContent(projectRoot: string, defaultLanguage: string, languages: string[] | null): Promise<ContentMap>;
+//# sourceMappingURL=content-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-loader.d.ts","sourceRoot":"","sources":["../../src/content/content-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAwFpE;;;;;;;;;;;;GAYG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,GACzB,OAAO,CAAC,UAAU,CAAC,CA0DrB"}

package/dist/content/content-loader.js

@@ -0,0 +1,126 @@
+import { readdir, access } from 'node:fs/promises';
+import { join, sep } from 'node:path';
+const CONTENT_DIR = 'content';
+/**
+ * Checks whether a directory exists on disk.
+ */
+async function dirExists(dirPath) {
+    try {
+        await access(dirPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Recursively finds all .md files in a directory and returns their paths
+ * relative to that directory, using forward slashes.
+ */
+async function findMarkdownFiles(dir) {
+    let entries;
+    try {
+        entries = await readdir(dir, { recursive: true });
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT')
+            return [];
+        throw new Error(`Failed to read directory ${dir}: ${err.message}`);
+    }
+    return entries
+        .filter((entry) => entry.endsWith('.md'))
+        .map((entry) => entry.replaceAll(sep, '/'));
+}
+/**
+ * Converts a relative .md file path into a ContentEntry.
+ *
+ * @param relativePath - Forward-slash path relative to the language dir (e.g. "prerequisites/install-code-editor.md").
+ * @param language - The language code (e.g. "en").
+ * @param langDir - Absolute path to the language content directory.
+ * @param defaultLanguage - The project's default language (no URL prefix for this language).
+ */
+function buildEntry(relativePath, language, langDir, defaultLanguage) {
+    const filePath = join(langDir, relativePath.replaceAll('/', sep));
+    const withoutExt = relativePath.replace(/\.md$/, '');
+    const isIndex = withoutExt.endsWith('/index') || withoutExt === 'index';
+    const segments = isIndex
+        ? withoutExt === 'index' ? [] : withoutExt.replace(/\/index$/, '').split('/')
+        : withoutExt.split('/');
+    const slug = isIndex
+        ? 'index'
+        : segments[segments.length - 1];
+    const prefix = language === defaultLanguage ? '' : `/${language}`;
+    const routePath = segments.length === 0
+        ? prefix || '/'
+        : `${prefix}/${segments.join('/')}`;
+    return { language, segments, routePath, filePath, slug, isIndex };
+}
+/**
+ * Detects route collisions — e.g. both "prerequisites.md" and
+ * "prerequisites/index.md" claiming the same route path.
+ */
+function detectCollisions(entries, language) {
+    const seen = new Map();
+    for (const entry of entries) {
+        const existing = seen.get(entry.routePath);
+        if (existing) {
+            throw new Error(`Route collision for "${entry.routePath}" in language "${language}": ` +
+                `"${existing}" and "${entry.filePath}" both resolve to the same route.`);
+        }
+        seen.set(entry.routePath, entry.filePath);
+    }
+}
+/**
+ * Discovers all markdown content files and builds a route manifest.
+ *
+ * - Scans content/<lang>/ for each language.
+ * - Default language routes have no prefix ("/overview"); other languages are prefixed ("/de/overview").
+ * - If a declared language has no content directory, it is skipped with a warning (falls back to default at runtime).
+ * - Errors if the default language has no content directory or no index.md.
+ *
+ * @param projectRoot - Absolute path to the project's root directory.
+ * @param defaultLanguage - The defaultLanguage value from site.json.
+ * @param languages - Array of declared languages from language.json, or null for single-language projects.
+ * @returns The content manifest with all discovered entries.
+ */
+export async function loadContent(projectRoot, defaultLanguage, languages) {
+    const contentRoot = join(projectRoot, CONTENT_DIR);
+    const langCodes = languages ?? [defaultLanguage];
+    const allEntries = [];
+    const activeLanguages = [];
+    for (const lang of langCodes) {
+        const langDir = join(contentRoot, lang);
+        if (!(await dirExists(langDir))) {
+            if (lang === defaultLanguage) {
+                throw new Error(`Content directory not found: ${langDir}\n` +
+                    `Every Mordoc project requires a content/${defaultLanguage}/ directory.`);
+            }
+            console.warn(`⚠ No content directory for language "${lang}" — ` +
+                `content will fall back to "${defaultLanguage}" at runtime.`);
+            continue;
+        }
+        const mdFiles = await findMarkdownFiles(langDir);
+        if (mdFiles.length === 0) {
+            if (lang === defaultLanguage) {
+                throw new Error(`No markdown files found in ${langDir}.\n` +
+                    `The default language content directory must contain at least an index.md file.`);
+            }
+            console.warn(`⚠ No markdown files in content/${lang}/ — ` +
+                `content will fall back to "${defaultLanguage}" at runtime.`);
+            continue;
+        }
+        const entries = mdFiles.map((file) => buildEntry(file, lang, langDir, defaultLanguage));
+        detectCollisions(entries, lang);
+        const hasIndex = entries.some((e) => e.isIndex && e.segments.length === 0);
+        if (lang === defaultLanguage && !hasIndex) {
+            throw new Error(`Missing content/${defaultLanguage}/index.md.\n` +
+                `The default language must have a root index.md — it serves as the landing page.`);
+        }
+        allEntries.push(...entries);
+        activeLanguages.push(lang);
+    }
+    allEntries.sort((a, b) => a.routePath.localeCompare(b.routePath));
+    return { entries: allEntries, languages: activeLanguages };
+}
+//# sourceMappingURL=content-loader.js.map

package/dist/content/content-loader.js.map

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

package/dist/content/content-parser.d.ts

@@ -0,0 +1,12 @@
+import type { ContentMap, ParsedPage } from '../types/content.js';
+/**
+ * Parses all content files from a ContentMap into ASTs plus frontmatter.
+ * The TOC and the renderable tree are produced in a later stage
+ * (see `content-transformer.ts`) so that anchor IDs stay in sync with
+ * what the renderer emits.
+ *
+ * @param contentMap - The content discovery result from loadContent().
+ * @returns An array of parsed pages, one per content entry.
+ */
+export declare function parseContent(contentMap: ContentMap): Promise<ParsedPage[]>;
+//# sourceMappingURL=content-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-parser.d.ts","sourceRoot":"","sources":["../../src/content/content-parser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAe,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAkC/E;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAoBhF"}

package/dist/content/content-parser.js

@@ -0,0 +1,54 @@
+import { readFile } from 'node:fs/promises';
+import Markdoc from '@markdoc/markdoc';
+import yaml from 'js-yaml';
+/**
+ * Parses the raw frontmatter YAML string extracted by Markdoc.
+ * Validates that at least a title is present.
+ */
+function parseFrontmatter(raw, filePath) {
+    if (!raw || raw.trim() === '') {
+        throw new Error(`${filePath}: missing frontmatter.\n` +
+            `Every content file must have a YAML frontmatter block with at least a "title" field.`);
+    }
+    let parsed;
+    try {
+        parsed = yaml.load(raw);
+    }
+    catch (err) {
+        throw new Error(`${filePath}: invalid frontmatter YAML — ${err.message}`);
+    }
+    if (typeof parsed !== 'object' || parsed === null) {
+        throw new Error(`${filePath}: frontmatter must be a YAML object.`);
+    }
+    const obj = parsed;
+    if (typeof obj['title'] !== 'string' || obj['title'] === '') {
+        throw new Error(`${filePath}: frontmatter "title" is required and must be a non-empty string.`);
+    }
+    return parsed;
+}
+/**
+ * Parses all content files from a ContentMap into ASTs plus frontmatter.
+ * The TOC and the renderable tree are produced in a later stage
+ * (see `content-transformer.ts`) so that anchor IDs stay in sync with
+ * what the renderer emits.
+ *
+ * @param contentMap - The content discovery result from loadContent().
+ * @returns An array of parsed pages, one per content entry.
+ */
+export async function parseContent(contentMap) {
+    const pages = [];
+    for (const entry of contentMap.entries) {
+        let raw;
+        try {
+            raw = await readFile(entry.filePath, 'utf-8');
+        }
+        catch (err) {
+            throw new Error(`Failed to read ${entry.filePath}: ${err.message}`);
+        }
+        const ast = Markdoc.parse(raw);
+        const frontmatter = parseFrontmatter(ast.attributes['frontmatter'], entry.filePath);
+        pages.push({ entry, frontmatter, ast });
+    }
+    return pages;
+}
+//# sourceMappingURL=content-parser.js.map

package/dist/content/content-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-parser.js","sourceRoot":"","sources":["../../src/content/content-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,OAAO,MAAM,kBAAkB,CAAC;AACvC,OAAO,IAAI,MAAM,SAAS,CAAC;AAG3B;;;GAGG;AACH,SAAS,gBAAgB,CAAC,GAAuB,EAAE,QAAgB;IACjE,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACb,GAAG,QAAQ,0BAA0B;YACrC,sFAAsF,CACvF,CAAC;IACJ,CAAC;IAED,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,gCAAiC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACvF,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,sCAAsC,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,GAAG,GAAG,MAAiC,CAAC;IAE9C,IAAI,OAAO,GAAG,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,mEAAmE,CAAC,CAAC;IAClG,CAAC;IAED,OAAO,MAAqB,CAAC;AAC/B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAsB;IACvD,MAAM,KAAK,GAAiB,EAAE,CAAC;IAE/B,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;QACvC,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CACb,kBAAkB,KAAK,CAAC,QAAQ,KAAM,GAAa,CAAC,OAAO,EAAE,CAC9D,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,WAAW,GAAG,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAuB,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;QAE1G,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/content/content-transformer.d.ts

@@ -0,0 +1,17 @@
+import type { ParsedPage, TransformedPage } from '../types/content.js';
+/**
+ * Transforms parsed pages into renderable, JSON-serializable trees.
+ *
+ * For each page:
+ *   1. A fresh slugger is created and attached to a per-page Markdoc config
+ *      as `variables.slugger`. The heading node transform pulls it out to
+ *      generate unique anchor IDs within that page.
+ *   2. `Markdoc.transform()` runs the AST through the default config.
+ *   3. The TOC is derived from the resulting renderable tree so its IDs
+ *      stay in sync with the rendered headings.
+ *
+ * The function is synchronous — no I/O happens here; the AST is already
+ * in memory from the parse stage.
+ */
+export declare function transformContent(pages: ParsedPage[]): TransformedPage[];
+//# sourceMappingURL=content-transformer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"content-transformer.d.ts","sourceRoot":"","sources":["../../src/content/content-transformer.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAY,MAAM,qBAAqB,CAAC;AA+CjF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,eAAe,EAAE,CAmCvE"}

package/dist/content/content-transformer.js

@@ -0,0 +1,94 @@
+import Markdoc from '@markdoc/markdoc';
+import { createSlugger } from './slug.js';
+import { createDefaultMarkdocConfig } from './markdoc-config.js';
+/**
+ * Concatenates the text content of a renderable subtree for TOC display.
+ */
+function extractText(children) {
+    let text = '';
+    for (const child of children) {
+        if (typeof child === 'string')
+            text += child;
+        else if (Markdoc.Tag.isTag(child))
+            text += extractText(child.children);
+    }
+    return text;
+}
+function walk(node, visit) {
+    visit(node);
+    if (Markdoc.Tag.isTag(node)) {
+        for (const child of node.children)
+            walk(child, visit);
+    }
+}
+/**
+ * Walks the transformed renderable tree and extracts Heading component nodes
+ * (level 2–6) into TOC entries. Because this runs after the heading transform,
+ * the IDs it reads are exactly the IDs that will appear in the rendered HTML.
+ */
+function extractToc(root) {
+    const entries = [];
+    walk(root, (node) => {
+        if (!Markdoc.Tag.isTag(node))
+            return;
+        let level = null;
+        if (node.name === 'Heading') {
+            const l = node.attributes['level'];
+            if (typeof l === 'number' && l >= 2 && l <= 6)
+                level = l;
+        }
+        if (level === null)
+            return;
+        const id = typeof node.attributes['id'] === 'string' ? node.attributes['id'] : '';
+        if (id === '')
+            return;
+        const title = extractText(node.children).trim();
+        if (title === '')
+            return;
+        entries.push({ id, title, level });
+    });
+    return entries;
+}
+/**
+ * Transforms parsed pages into renderable, JSON-serializable trees.
+ *
+ * For each page:
+ *   1. A fresh slugger is created and attached to a per-page Markdoc config
+ *      as `variables.slugger`. The heading node transform pulls it out to
+ *      generate unique anchor IDs within that page.
+ *   2. `Markdoc.transform()` runs the AST through the default config.
+ *   3. The TOC is derived from the resulting renderable tree so its IDs
+ *      stay in sync with the rendered headings.
+ *
+ * The function is synchronous — no I/O happens here; the AST is already
+ * in memory from the parse stage.
+ */
+export function transformContent(pages) {
+    const base = createDefaultMarkdocConfig();
+    const out = [];
+    for (const page of pages) {
+        const slugger = createSlugger();
+        const config = {
+            ...base,
+            variables: { ...(base.variables ?? {}), slugger },
+        };
+        const raw = Markdoc.transform(page.ast, config);
+        // `Markdoc.transform` is typed as returning a node-or-array, but when
+        // given a parsed document AST it always yields a single root node.
+        // Fail loudly if that ever changes rather than silently breaking the
+        // TOC and renderer downstream.
+        if (Array.isArray(raw)) {
+            throw new Error(`Unexpected array result from Markdoc.transform for ${page.entry.filePath}`);
+        }
+        const renderable = raw;
+        const toc = extractToc(renderable);
+        out.push({
+            entry: page.entry,
+            frontmatter: page.frontmatter,
+            toc,
+            renderable,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=content-transformer.js.map

package/dist/content/content-transformer.js.map

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

package/dist/content/markdoc-config.d.ts

@@ -0,0 +1,13 @@
+import type { Config } from '@markdoc/markdoc';
+/**
+ * The default Markdoc config used by Mordoc's content transformer.
+ *
+ * Currently minimal:
+ *   - Custom `heading` node (adds stable, deduplicated anchor IDs).
+ *   - Custom `fence` node (routes to CodeBlock for syntax highlighting).
+ *   - Custom `image` node (routes to Image for lightbox support).
+ *   - Custom `callout` tag (routes to Callout for note/warning/danger boxes).
+ *   - Custom `card` / `cardGrid` tags (routes to Card / CardGrid components).
+ */
+export declare function createDefaultMarkdocConfig(): Config;
+//# sourceMappingURL=markdoc-config.d.ts.map

package/dist/content/markdoc-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdoc-config.d.ts","sourceRoot":"","sources":["../../src/content/markdoc-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAA8B,MAAM,kBAAkB,CAAC;AA+M3E;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAKnD"}