mordoc 0.1.13 → 1.0.0

package/dist/content/markdoc-config.js

@@ -0,0 +1,210 @@
+import Markdoc from '@markdoc/markdoc';
+/**
+ * Walks a renderable subtree and concatenates its text content.
+ * Used to derive the default heading text for slug generation.
+ *
+ * Note: we use `Markdoc.Tag.isTag` rather than a named `Tag` import because
+ * the published `@markdoc/markdoc` package is CommonJS and only exposes Tag
+ * as a static member of its default export. Named imports fail at runtime
+ * in Node's ESM loader even though the .d.ts claims they exist.
+ */
+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;
+}
+/**
+ * Custom heading node.
+ *
+ * Renders a standard `<h{level}>` tag and guarantees every heading has a
+ * stable `id` attribute:
+ *   - If the author supplied `{% #explicit-id %}`, that wins.
+ *   - Otherwise a per-page slugger (passed via config.variables.slugger)
+ *     generates one, deduplicating within the page.
+ *
+ * The slugger instance is the same one the transformer uses to derive the
+ * TOC, so TOC anchor IDs are guaranteed to match rendered heading IDs.
+ */
+const heading = {
+    children: ['inline'],
+    attributes: {
+        id: { type: String },
+        level: { type: Number, required: true, default: 1 },
+    },
+    transform(node, config) {
+        const attributes = node.transformAttributes(config);
+        const children = node.transformChildren(config);
+        const slugger = config.variables?.slugger;
+        const explicitId = typeof attributes['id'] === 'string' && attributes['id'] !== ''
+            ? attributes['id']
+            : undefined;
+        const text = extractText(children);
+        const id = explicitId ?? (slugger ? slugger(text) : text);
+        const { level, id: _ignored, ...rest } = attributes;
+        void _ignored;
+        return new Markdoc.Tag('Heading', { ...rest, id, level }, children);
+    },
+};
+/**
+ * Custom link node — routes all Markdoc inline links to the ContentLink
+ * React component, which uses React Router <Link> for internal paths and
+ * a plain <a target="_blank"> for external URLs. Anchor-only links (#id)
+ * pass through as plain <a> elements (in-page scroll, no routing needed).
+ *
+ * Without this override Markdoc emits a plain <a href="..."> for every
+ * markdown link, which triggers a full browser navigation instead of
+ * client-side routing.
+ */
+const link = {
+    render: 'ContentLink',
+    children: ['strong', 'em', 'code', 's', 'html', 'text'],
+    attributes: {
+        href: { type: String, required: true },
+        title: { type: String },
+    },
+};
+/**
+ * Routes fenced code blocks to the CodeBlock React component.
+ * Markdoc's built-in fence node provides `language` and `content` attributes.
+ */
+const fence = {
+    render: 'CodeBlock',
+    attributes: {
+        language: { type: String },
+        content: { type: String, render: true },
+    },
+};
+/**
+ * Routes inline images to the Image React component, which adds a lightbox.
+ * Markdoc's built-in image node provides `src`, `alt`, and `title` attributes.
+ */
+const image = {
+    render: 'Image',
+    attributes: {
+        src: { type: String },
+        alt: { type: String },
+        title: { type: String },
+    },
+};
+/**
+ * Callout block tag — renders note, warning, danger, and tip callout boxes.
+ *
+ * Authors use: {% callout type="note" title="..." %}...{% /callout %}
+ * The `children` array lists the Markdoc node types allowed inside, keeping
+ * callout content intentionally limited (no nested headings or images).
+ */
+const callout = {
+    render: 'Callout',
+    children: ['paragraph', 'list', 'fence', 'blockquote'],
+    attributes: {
+        type: { type: String, default: 'note', matches: ['note', 'warning', 'danger', 'tip'] },
+        title: { type: String },
+    },
+};
+/**
+ * Card tag — a single card with optional icon, image, link, and badge.
+ *
+ * Variant is inferred from attributes: `image` → image card, `icon` → icon
+ * card, neither → plain. Self-closing (no body) → compact mode.
+ * Authors use: {% card title="..." path="..." icon="..." %}Description{% /card %}
+ * Must be used inside {% cardGrid %}.
+ */
+const card = {
+    render: 'Card',
+    children: ['paragraph', 'inline', 'list'],
+    attributes: {
+        title: { type: String, required: true },
+        path: { type: String },
+        icon: { type: String },
+        image: { type: String },
+        tag: { type: String },
+    },
+};
+/**
+ * CardGrid tag — responsive grid container for card tags.
+ *
+ * `cols` controls the number of columns (1–4, default 3). The grid
+ * collapses responsively: 2-col at medium viewports, 1-col at small.
+ * Authors use: {% cardGrid cols="3" %}...{% /cardGrid %}
+ */
+const cardGrid = {
+    render: 'CardGrid',
+    children: ['tag'],
+    attributes: {
+        cols: { type: String, default: '3' },
+    },
+};
+/**
+ * Hero tag — full-width landing page hero section.
+ *
+ * Layout is inferred: `image` present → split (text + image), absent → centered.
+ * `background` accepts an image path or any CSS color value.
+ * CTA buttons are passed as children ({% button %} tags).
+ * Authors use: {% hero title="..." description="..." image="..." background="..." %}
+ *   {% button path="..." %}Label{% /button %}
+ * {% /hero %}
+ */
+const hero = {
+    render: 'Hero',
+    children: ['tag', 'paragraph'],
+    attributes: {
+        title: { type: String, required: true },
+        titleAccent: { type: String },
+        description: { type: String },
+        image: { type: String },
+        background: { type: String },
+        titleColor: { type: String },
+        titleAccentColor: { type: String },
+        descriptionColor: { type: String },
+    },
+};
+/**
+ * Section tag — full-width landing page content block.
+ *
+ * Optional `title` renders an <h2>. `background` accepts "subtle",
+ * an image path, or any CSS color value.
+ * Authors use: {% section title="..." background="subtle" %}...{% /section %}
+ */
+const section = {
+    render: 'Section',
+    children: ['heading', 'paragraph', 'list', 'fence', 'blockquote', 'tag', 'hr'],
+    attributes: {
+        title: { type: String },
+        background: { type: String },
+    },
+};
+/**
+ * Button tag — styled CTA link, usable in landing pages and content pages.
+ *
+ * Internal paths use React Router Link; external URLs open in a new tab.
+ * Authors use: {% button path="..." %}Label{% /button %}
+ */
+const button = {
+    render: 'Button',
+    children: ['paragraph', 'inline', 'text', 'strong', 'em'],
+    attributes: {
+        path: { type: String, required: true },
+    },
+};
+/**
+ * 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 function createDefaultMarkdocConfig() {
+    return {
+        nodes: { heading, link, fence, image },
+        tags: { callout, card, cardGrid, hero, section, button },
+    };
+}
+//# sourceMappingURL=markdoc-config.js.map

package/dist/content/markdoc-config.js.map

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

package/dist/content/slug.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Normalizes a string into a URL-safe slug.
+ * Lowercases, strips diacritics, collapses non-alphanumeric runs to hyphens,
+ * and trims leading/trailing hyphens.
+ *
+ * This is the pure form — no collision handling. For heading anchors within
+ * a single page, use {@link createSlugger} instead so duplicate headings
+ * produce distinct IDs.
+ */
+export declare function slugify(text: string): string;
+/**
+ * A stateful slugger that remembers IDs it has already issued and appends
+ * a numeric suffix to disambiguate duplicates.
+ *
+ * Each call returns a unique slug within the lifetime of this instance.
+ * The first occurrence of a base slug is returned as-is; subsequent
+ * occurrences are suffixed: `overview`, `overview-2`, `overview-3`, …
+ *
+ * Intended usage: one slugger per page. Both the TOC extractor and the
+ * Markdoc heading transform for a given page must share the same instance
+ * (or apply the same sequence in the same order) so anchor IDs in the
+ * rendered HTML match the IDs in the TOC.
+ */
+export type Slugger = (text: string) => string;
+export declare function createSlugger(): Slugger;
+//# sourceMappingURL=slug.d.ts.map

package/dist/content/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../src/content/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAE/C,wBAAgB,aAAa,IAAI,OAAO,CAavC"}

package/dist/content/slug.js

@@ -0,0 +1,31 @@
+/**
+ * Normalizes a string into a URL-safe slug.
+ * Lowercases, strips diacritics, collapses non-alphanumeric runs to hyphens,
+ * and trims leading/trailing hyphens.
+ *
+ * This is the pure form — no collision handling. For heading anchors within
+ * a single page, use {@link createSlugger} instead so duplicate headings
+ * produce distinct IDs.
+ */
+export function slugify(text) {
+    return text
+        .toLowerCase()
+        .normalize('NFD').replace(/[\u0300-\u036f]/g, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+export function createSlugger() {
+    const used = new Set();
+    return (text) => {
+        const base = slugify(text);
+        let candidate = base;
+        let n = 2;
+        while (used.has(candidate)) {
+            candidate = `${base}-${n}`;
+            n += 1;
+        }
+        used.add(candidate);
+        return candidate;
+    };
+}
+//# sourceMappingURL=slug.js.map

package/dist/content/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/content/slug.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAChD,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAiBD,MAAM,UAAU,aAAa;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,OAAO,CAAC,IAAY,EAAU,EAAE;QAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,IAAI,SAAS,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,OAAO,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,SAAS,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;YAC3B,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;AACJ,CAAC"}

package/dist/pipeline.d.ts

@@ -0,0 +1,61 @@
+import { loadNavTranslations } from './config/translations-loader.js';
+export { loadNavTranslations };
+import type { ContentEntry, TransformedPage } from './types/content.js';
+import type { MordocData, NavigationConfig, ShellData } from './types/pipeline.js';
+/**
+ * Loads the project's navigation configuration.
+ *
+ * If `config/navigation/topnav.yaml` exists, every sidenav file it
+ * references is loaded and the resolved tree is returned. Otherwise the
+ * single `config/navigation/sidenav.yaml` is loaded as a site-wide sidenav.
+ *
+ * Exported separately from `runPipeline` because the Vite plugin's HMR
+ * handler will need to re-resolve navigation independently when any nav
+ * file changes — without re-reading site.json or re-transforming content.
+ */
+export declare function loadNavigation(projectRoot: string): Promise<NavigationConfig>;
+/**
+ * Runs the full Mordoc data pipeline for a project.
+ *
+ * Stages, in order:
+ *   1. Load every config file (site, language, navigation, assets).
+ *   2. Discover content files and build the route manifest.
+ *   3. Parse each markdown file into frontmatter + Markdoc AST.
+ *   4. Transform each AST into a renderable tree with TOC.
+ *
+ * Returns a single, JSON-serializable `MordocData`. This is the canonical
+ * hand-off shape consumed by both the Vite plugin (in dev) and the SSG
+ * build (in prod). The pipeline itself knows nothing about either —
+ * keeping it framework-agnostic means new consumers (a CI checker, a
+ * different bundler) can be added without touching this code.
+ *
+ * @param projectRoot - Absolute path to the user's project root.
+ */
+export declare function runPipeline(projectRoot: string): Promise<MordocData>;
+/**
+ * Re-runs the parse + transform stages for a single content entry.
+ *
+ * This is the per-file granular update primitive the Vite plugin's
+ * `handleHotUpdate` will call when one markdown file changes — it returns
+ * a fresh `TransformedPage` for that entry alone, without touching any
+ * other page or any config.
+ *
+ * The wrapping `ContentMap` is synthetic; `parseContent` only iterates
+ * `entries`, so a one-element list is sufficient.
+ */
+export declare function reparsePage(entry: ContentEntry): Promise<TransformedPage>;
+/**
+ * Stable fingerprint of which routes exist — used to decide whether a
+ * config or content-tree edit requires a full browser reload (v1 skips
+ * mutating the route table client-side when pages are added or removed).
+ */
+export declare function pagesRouteSignature(pages: TransformedPage[]): string;
+/** Projects `MordocData` to the `ShellData` consumed by the React shell and SSR renderer. */
+export declare function toShellData(data: MordocData): ShellData;
+/**
+ * Replaces one page in an in-memory `MordocData` after `reparsePage`.
+ * Matches by normalized absolute `filePath` so Windows drives and
+ * separators stay consistent with the dev watcher.
+ */
+export declare function replaceTransformedPage(data: MordocData, page: TransformedPage): void;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAItE,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAC/B,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEnF;;;;;;;;;;GAUG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAOnF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAsB1E;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAa/E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAKpE;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,CAYvD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI,CAQpF"}

package/dist/pipeline.js

@@ -0,0 +1,123 @@
+import { loadSiteConfig } from './config/site-loader.js';
+import { loadLanguageConfig } from './config/language-loader.js';
+import { loadTopnavConfig } from './config/topnav-loader.js';
+import { loadSidenavConfig } from './config/sidenav-loader.js';
+import { loadAssets } from './config/assets-loader.js';
+import { loadContent } from './content/content-loader.js';
+import { loadNavTranslations } from './config/translations-loader.js';
+import { parseContent } from './content/content-parser.js';
+import { transformContent } from './content/content-transformer.js';
+import path from 'node:path';
+export { loadNavTranslations };
+/**
+ * Loads the project's navigation configuration.
+ *
+ * If `config/navigation/topnav.yaml` exists, every sidenav file it
+ * references is loaded and the resolved tree is returned. Otherwise the
+ * single `config/navigation/sidenav.yaml` is loaded as a site-wide sidenav.
+ *
+ * Exported separately from `runPipeline` because the Vite plugin's HMR
+ * handler will need to re-resolve navigation independently when any nav
+ * file changes — without re-reading site.json or re-transforming content.
+ */
+export async function loadNavigation(projectRoot) {
+    const topnav = await loadTopnavConfig(projectRoot);
+    if (topnav) {
+        return { kind: 'topnav', topnav };
+    }
+    const sidenav = await loadSidenavConfig(projectRoot);
+    return { kind: 'sidenav', sidenav };
+}
+/**
+ * Runs the full Mordoc data pipeline for a project.
+ *
+ * Stages, in order:
+ *   1. Load every config file (site, language, navigation, assets).
+ *   2. Discover content files and build the route manifest.
+ *   3. Parse each markdown file into frontmatter + Markdoc AST.
+ *   4. Transform each AST into a renderable tree with TOC.
+ *
+ * Returns a single, JSON-serializable `MordocData`. This is the canonical
+ * hand-off shape consumed by both the Vite plugin (in dev) and the SSG
+ * build (in prod). The pipeline itself knows nothing about either —
+ * keeping it framework-agnostic means new consumers (a CI checker, a
+ * different bundler) can be added without touching this code.
+ *
+ * @param projectRoot - Absolute path to the user's project root.
+ */
+export async function runPipeline(projectRoot) {
+    const site = await loadSiteConfig(projectRoot);
+    const language = await loadLanguageConfig(projectRoot, site.defaultLanguage);
+    const navigation = await loadNavigation(projectRoot);
+    const assets = await loadAssets(projectRoot);
+    const contentMap = await loadContent(projectRoot, site.defaultLanguage, language?.languages ?? null);
+    const translations = await loadNavTranslations(projectRoot, language?.languages ?? [site.defaultLanguage], site.defaultLanguage);
+    const parsedContent = await parseContent(contentMap);
+    const transformedContent = transformContent(parsedContent);
+    return { site, language, navigation, assets, pages: transformedContent, translations };
+}
+/**
+ * Re-runs the parse + transform stages for a single content entry.
+ *
+ * This is the per-file granular update primitive the Vite plugin's
+ * `handleHotUpdate` will call when one markdown file changes — it returns
+ * a fresh `TransformedPage` for that entry alone, without touching any
+ * other page or any config.
+ *
+ * The wrapping `ContentMap` is synthetic; `parseContent` only iterates
+ * `entries`, so a one-element list is sufficient.
+ */
+export async function reparsePage(entry) {
+    const parsed = await parseContent({
+        entries: [entry],
+        languages: [entry.language],
+    });
+    const [transformed] = transformContent(parsed);
+    if (!transformed) {
+        // parseContent + transformContent both produce one output per input
+        // entry, so this branch should be unreachable. Guarded so a future
+        // refactor can't silently return undefined.
+        throw new Error(`reparsePage produced no result for ${entry.filePath}`);
+    }
+    return transformed;
+}
+/**
+ * Stable fingerprint of which routes exist — used to decide whether a
+ * config or content-tree edit requires a full browser reload (v1 skips
+ * mutating the route table client-side when pages are added or removed).
+ */
+export function pagesRouteSignature(pages) {
+    return pages
+        .map((p) => `${p.entry.language}\t${p.entry.routePath}`)
+        .sort()
+        .join('|');
+}
+/** Projects `MordocData` to the `ShellData` consumed by the React shell and SSR renderer. */
+export function toShellData(data) {
+    return {
+        site: data.site,
+        language: data.language,
+        navigation: data.navigation,
+        assets: data.assets,
+        pagesIndex: data.pages.map((p) => ({
+            routePath: p.entry.routePath,
+            language: p.entry.language,
+        })),
+        translations: data.translations,
+    };
+}
+/**
+ * Replaces one page in an in-memory `MordocData` after `reparsePage`.
+ * Matches by normalized absolute `filePath` so Windows drives and
+ * separators stay consistent with the dev watcher.
+ */
+export function replaceTransformedPage(data, page) {
+    const target = path.normalize(page.entry.filePath);
+    const idx = data.pages.findIndex((p) => path.normalize(p.entry.filePath) === target);
+    if (idx === -1) {
+        throw new Error(`replaceTransformedPage: no page for ${page.entry.filePath}`);
+    }
+    data.pages[idx] = page;
+    data.pages.sort((a, b) => a.entry.routePath.localeCompare(b.entry.routePath));
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

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

package/dist/types/assets.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Resolved asset references discovered from config/assets/.
+ * Values are absolute disk paths in the pipeline; the Vite plugin and build
+ * step rewrite them to `/_assets/<basename>` web URLs before they reach the
+ * browser. All fields are optional — the UI renders gracefully without them.
+ */
+export interface ResolvedAssets {
+    /** Favicon path or URL, or null if not present. */
+    favicon: string | null;
+    /** Light-mode logo path or URL, or null if not present. */
+    logo: string | null;
+    /** Dark-mode logo path or URL. Falls back to logo if not present. */
+    logoDark: string | null;
+}
+//# sourceMappingURL=assets.d.ts.map

package/dist/types/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../src/types/assets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,2DAA2D;IAC3D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB"}

package/dist/types/assets.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=assets.js.map

package/dist/types/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../src/types/assets.ts"],"names":[],"mappings":""}