mordoc 0.1.13 → 1.0.0

package/dist/types/content.d.ts

@@ -1,46 +1,128 @@
-/**
- * Content type definitions for Mordoc
- * These interfaces define the structure of processed markdown content
- */
-import type { RenderableTreeNode } from '@markdoc/markdoc';
+import type { Node, RenderableTreeNode } from '@markdoc/markdoc';
+/** A single content page discovered on disk. */
+export interface ContentEntry {
+    /** Language code derived from the top-level directory (e.g. "en", "de"). */
+    language: string;
+    /** URL path segments after the language prefix (e.g. ["prerequisites", "install-code-editor"]). */
+    segments: string[];
+    /**
+     * Resolved route path for navigation.
+     * Default language has no prefix: "/overview", "/prerequisites/install-code-editor".
+     * Other languages get a prefix: "/de/overview", "/de/prerequisites/install-code-editor".
+     */
+    routePath: string;
+    /** Absolute path to the .md file on disk. */
+    filePath: string;
+    /** Slug of the file (filename without extension, e.g. "install-code-editor"). */
+    slug: string;
+    /** Whether this is an index page (index.md). */
+    isIndex: boolean;
+}
+/** The full result of content discovery: every page and which languages have content. */
+export interface ContentMap {
+    /** All discovered content entries, sorted by routePath for stable ordering. */
+    entries: ContentEntry[];
+    /** Language codes that have actual content directories on disk. */
+    languages: string[];
+}
+/** Parsed YAML frontmatter from a markdown file. Title is required. */
 export interface Frontmatter {
     title: string;
     description?: string;
-    order?: number;
-    draft?: boolean;
-    tags?: string[];
-    date?: string;
-    author?: string;
-    sidenavRef?: string;
+    /** When set to 'landing', the page renders with the full-width landing layout (no sidenav, no TOC). */
+    layout?: 'landing';
     [key: string]: unknown;
 }
+/** A single heading extracted for the table of contents. */
 export interface TocEntry {
+    /** Anchor ID for linking (slugified heading text). */
     id: string;
-    text: string;
+    /** Display text of the heading. */
+    title: string;
+    /** Heading depth: 2 for h2, 3 for h3, etc. */
     level: number;
-    children?: TocEntry[];
 }
-export type TableOfContents = TocEntry[];
-export interface ContentMetadata {
-    slug: string;
-    filePath: string;
-    language: string;
-    path: string;
-    dirPath: string;
+/**
+ * A parsed content page — discovery metadata plus the raw Markdoc AST and
+ * frontmatter. TOC is not computed at this stage; it is derived from the
+ * transformed renderable tree so that anchor IDs always match what is
+ * actually rendered. See {@link TransformedPage}.
+ */
+export interface ParsedPage {
+    /** The original discovery entry (route, file path, language, etc.). */
+    entry: ContentEntry;
+    /** Parsed frontmatter from the YAML block at the top of the file. */
     frontmatter: Frontmatter;
-    toc: TableOfContents;
-    wordCount: number;
-    readingTime: number;
+    /** Markdoc AST node for downstream transformation. */
+    ast: Node;
 }
-export type MarkdocRenderableNode = RenderableTreeNode;
-export interface ProcessedContent {
-    metadata: ContentMetadata;
-    renderable: MarkdocRenderableNode;
-    rawContent?: string;
+/**
+ * A transformed content page — the Markdoc AST has been run through the
+ * default config (heading IDs, future tag transforms, etc.) and converted
+ * into a JSON-serializable renderable tree ready to ship to the client.
+ *
+ * The TOC is derived from the renderable tree after transform, so its IDs
+ * are guaranteed to match the IDs on the rendered heading tags.
+ */
+export interface TransformedPage {
+    /** The original discovery entry (route, file path, language, etc.). */
+    entry: ContentEntry;
+    /** Parsed frontmatter carried through from the parse stage. */
+    frontmatter: Frontmatter;
+    /** Table of contents extracted from the transformed renderable tree. */
+    toc: TocEntry[];
+    /**
+     * Serializable renderable tree produced by `Markdoc.transform()`.
+     * Always a single root node (transformContent normalizes this).
+     */
+    renderable: RenderableTreeNode;
 }
-export interface ContentDataFile {
-    metadata: ContentMetadata;
-    renderable: MarkdocRenderableNode;
+/**
+ * Per-route payload shipped by the lazy `virtual:mordoc/page/<routePath>`
+ * modules — the full content a page component needs to render.
+ *
+ * Only fetched when the user navigates to the route. The eager
+ * `virtual:mordoc/pages-index` carries just the route identity
+ * ({@link PageMeta}); everything visual or title-bar-facing lives here.
+ *
+ * `isIndex` is intentionally excluded — index-ness is already encoded in
+ * the route path shape (e.g. `/flight-manual` vs `/flight-manual/safety`),
+ * and any component that genuinely needs the distinction can derive it
+ * from the path or cross-reference the navigation tree.
+ */
+export interface PageData {
+    /** Serializable renderable tree produced by `Markdoc.transform()`. */
+    renderable: RenderableTreeNode;
+    /** Full parsed frontmatter, including title, description, and any theme-specific keys. */
+    frontmatter: Frontmatter;
+    /** Table of contents extracted from the renderable tree. */
+    toc: TocEntry[];
+}
+/**
+ * Lightweight projection of a `TransformedPage` — just the route identity.
+ *
+ * Shipped eagerly via `virtual:mordoc/pages-index`. Its only job is to let the
+ * shell enumerate which routes exist: the React Router route table on the
+ * client, page enumeration for the SSG build, and "does this path exist in
+ * other languages?" lookups for a language switcher.
+ *
+ * Everything else a page carries — title, description, TOC, frontmatter,
+ * renderable tree, isIndex — lives in the per-route lazy chunk
+ * (`virtual:mordoc/page/<routePath>`) and is only fetched when that route
+ * is actually visited. Human-readable labels for cross-page UI (sidenav
+ * entries, next/prev, breadcrumb ancestors) come from the navigation
+ * config, which already spells out its own labels. Index-ness is encoded
+ * in the `routePath` shape itself, so it doesn't need a flag here either.
+ *
+ * `segments` is excluded because it's derivable from `routePath` and
+ * `language`.
+ */
+export interface PageMeta {
+    /** Resolved route path (same as ContentEntry.routePath). */
+    routePath: string;
+    /** Language code this page belongs to. */
+    language: string;
+    /** Present only when the page opts into the landing layout via `layout: landing` in frontmatter. */
+    layout?: 'landing';
 }
-export type ContentMap = Map<string, ProcessedContent>;
 //# sourceMappingURL=content.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/types/content.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG3D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAGD,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAGD,MAAM,MAAM,eAAe,GAAG,QAAQ,EAAE,CAAC;AAGzC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,WAAW,CAAC;IACzB,GAAG,EAAE,eAAe,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAGvD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,qBAAqB,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,qBAAqB,CAAC;CACnC;AAGD,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/types/content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEjE,gDAAgD;AAChD,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,mGAAmG;IACnG,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,yFAAyF;AACzF,MAAM,WAAW,UAAU;IACzB,+EAA+E;IAC/E,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,mEAAmE;IACnE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uGAAuG;IACvG,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,4DAA4D;AAC5D,MAAM,WAAW,QAAQ;IACvB,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,uEAAuE;IACvE,KAAK,EAAE,YAAY,CAAC;IACpB,qEAAqE;IACrE,WAAW,EAAE,WAAW,CAAC;IACzB,sDAAsD;IACtD,GAAG,EAAE,IAAI,CAAC;CACX;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,uEAAuE;IACvE,KAAK,EAAE,YAAY,CAAC;IACpB,+DAA+D;IAC/D,WAAW,EAAE,WAAW,CAAC;IACzB,wEAAwE;IACxE,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB;;;OAGG;IACH,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,QAAQ;IACvB,sEAAsE;IACtE,UAAU,EAAE,kBAAkB,CAAC;IAC/B,0FAA0F;IAC1F,WAAW,EAAE,WAAW,CAAC;IACzB,4DAA4D;IAC5D,GAAG,EAAE,QAAQ,EAAE,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,QAAQ;IACvB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,oGAAoG;IACpG,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB"}

package/dist/types/content.js

@@ -1,7 +1,2 @@
-"use strict";
-/**
- * Content type definitions for Mordoc
- * These interfaces define the structure of processed markdown content
- */
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=content.js.map

package/dist/types/content.js.map

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

package/dist/types/language.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shape of the config/language.json file.
+ * This file is optional — single-language projects can omit it entirely.
+ * Each entry is a language code matching a folder under content/ (e.g. "en", "de").
+ */
+export interface LanguageConfig {
+    languages: string[];
+}
+//# sourceMappingURL=language.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"language.d.ts","sourceRoot":"","sources":["../../src/types/language.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/types/language.js

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

package/dist/types/language.js.map

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

package/dist/types/navigation.d.ts

@@ -1,45 +1,33 @@
-/**
- * Navigation type definitions for Mordoc
- * These interfaces define routing and navigation structures
- */
-export interface Route {
-    path: string;
-    slug: string;
-    dirPath: string;
-    language: string;
-}
-export type RouteMap = Map<string, Route>;
-export interface NavigationNode {
+/** A single item in the side navigation tree. */
+export interface SidenavItem {
+    /** Display text shown in the sidebar. */
     label: string;
+    /** Route path for this item. Absent when the item is a group-only heading. */
     path?: string;
-    order?: number;
-    active?: boolean;
-    external?: boolean;
-    icon?: string;
-    children?: NavigationNode[];
+    /** Nested child items. Present for both group-only and navigable parents. */
+    children?: SidenavItem[];
 }
-export type NavigationTree = NavigationNode[];
-export interface PageNavigationLink {
+/** Shape of a sidenav YAML file (sidenav.yaml or any topnav-referenced file). */
+export type SidenavConfig = SidenavItem[];
+/** A single item in the top navigation bar. */
+export interface TopnavItem {
+    /** Display text shown in the top navigation bar. */
     label: string;
+    /** Route path prefix for this section. */
     path: string;
+    /** Filename of the sidenav YAML file in config/navigation/ (e.g. "payments.yaml"). */
+    sidenav: string;
 }
-export interface PageNavigation {
-    prev?: PageNavigationLink;
-    next?: PageNavigationLink;
-}
-export interface LanguageAlternative {
-    code: string;
+/** Shape of the config/navigation/topnav.yaml file. */
+export type TopnavConfig = TopnavItem[];
+/**
+ * Resolved top navigation: each item paired with its loaded sidenav tree.
+ * This is the runtime representation after all referenced files are loaded.
+ */
+export interface ResolvedTopnavItem {
     label: string;
-    path?: string;
-    available: boolean;
-}
-export type LanguageSwitcher = LanguageAlternative[];
-export interface NavigationContext {
-    currentPath: string;
-    currentLanguage: string;
-    sidenav: NavigationTree;
-    topnav?: NavigationTree;
-    pageNavigation: PageNavigation;
-    languageSwitcher: LanguageSwitcher;
+    path: string;
+    sidenav: SidenavConfig;
 }
+export type ResolvedTopnavConfig = ResolvedTopnavItem[];
 //# sourceMappingURL=navigation.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/types/navigation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAG1C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAGD,MAAM,MAAM,cAAc,GAAG,cAAc,EAAE,CAAC;AAG9C,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B;AAGD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;CACpB;AAGD,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,EAAE,CAAC;AAGrD,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,cAAc,EAAE,cAAc,CAAC;IAC/B,gBAAgB,EAAE,gBAAgB,CAAC;CACpC"}
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../src/types/navigation.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;CAC1B;AAED,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG,WAAW,EAAE,CAAC;AAE1C,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,uDAAuD;AACvD,MAAM,MAAM,YAAY,GAAG,UAAU,EAAE,CAAC;AAExC;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,EAAE,CAAC"}

package/dist/types/navigation.js

@@ -1,7 +1,2 @@
-"use strict";
-/**
- * Navigation type definitions for Mordoc
- * These interfaces define routing and navigation structures
- */
-Object.defineProperty(exports, "__esModule", { value: true });
+export {};
 //# sourceMappingURL=navigation.js.map

package/dist/types/navigation.js.map

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

package/dist/types/pipeline.d.ts

@@ -0,0 +1,70 @@
+import type { SiteConfig } from './site.js';
+import type { LanguageConfig } from './language.js';
+import type { ResolvedTopnavConfig, SidenavConfig } from './navigation.js';
+import type { ResolvedAssets } from './assets.js';
+import type { PageMeta, TransformedPage } from './content.js';
+/**
+ * Resolved navigation for the site, discriminated by `kind`:
+ *   - `topnav`: project has a top navigation bar; each entry owns its own sidenav.
+ *   - `sidenav`: no topnav.yaml — the project uses a single, site-wide sidenav.
+ *
+ * Downstream consumers (Vite plugin, SSG renderer, React client) branch on
+ * `kind` so the two cases stay explicit and impossible to confuse.
+ */
+export type NavigationConfig = {
+    kind: 'topnav';
+    topnav: ResolvedTopnavConfig;
+} | {
+    kind: 'sidenav';
+    sidenav: SidenavConfig;
+};
+/**
+ * The complete Mordoc data set for a project: every config object plus
+ * every transformed page. This is the single hand-off shape between the
+ * pipeline and its consumers.
+ *
+ * Both consumers — the Vite plugin in dev and the SSG build in prod —
+ * take a `MordocData` and translate it into virtual modules / pre-rendered
+ * HTML respectively. The pipeline itself stays Vite-agnostic; nothing in
+ * this type or its dependencies imports from any delivery framework.
+ *
+ * The shape is JSON-serializable (renderable trees are plain tags + strings),
+ * so it can be ferried across the dev/build boundary without any custom
+ * serialization.
+ */
+export interface MordocData {
+    site: SiteConfig;
+    /** Null when the project ships a single language and omits language.json. */
+    language: LanguageConfig | null;
+    navigation: NavigationConfig;
+    assets: ResolvedAssets;
+    pages: TransformedPage[];
+    /** Nav label translations keyed by language code. Empty for single-language projects. */
+    translations: Record<string, Record<string, string>>;
+}
+/**
+ * The lightweight projection of `MordocData` consumed by the React shell —
+ * everything needed to render the site chrome (header, navigation, link
+ * lists), but none of the per-page content trees.
+ *
+ * Per-page content (`PageData`) is delivered through the route loader → lazy
+ * `virtual:mordoc/page/<routePath>` module on both the client and the server.
+ * Keeping `ShellData` content-free forces all per-page data through that one
+ * channel, which is what makes CSR and SSR symmetric: the server doesn't get
+ * a privileged "all pages already loaded" view that the client doesn't have.
+ *
+ * Three usage sites, one definition:
+ *   1. The value shape of `MordocDataContext` in the React tree.
+ *   2. The `data` parameter of `entry-server.tsx`'s `render()`.
+ *   3. The return type of `toShellData()` in `pipeline.ts`.
+ */
+export interface ShellData {
+    site: SiteConfig;
+    language: LanguageConfig | null;
+    navigation: NavigationConfig;
+    assets: ResolvedAssets;
+    pagesIndex: PageMeta[];
+    /** Nav label translations keyed by language code. Empty for single-language projects. */
+    translations: Record<string, Record<string, string>>;
+}
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/types/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,CAAC;IACjB,6EAA6E;IAC7E,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,yFAAyF;IACzF,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,QAAQ,EAAE,CAAC;IACvB,yFAAyF;IACzF,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACtD"}

package/dist/types/pipeline.js

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

package/dist/types/pipeline.js.map

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

package/dist/types/site.d.ts

@@ -0,0 +1,20 @@
+/** Optional Open Graph and Twitter Card meta tags for social sharing previews. */
+export interface SiteMetadata {
+    ogImage?: string;
+    ogType?: string;
+    twitterCard?: string;
+    twitterSite?: string;
+}
+/**
+ * Top-level configuration for a Mordoc documentation site,
+ * as defined in the project's config/site.json file.
+ */
+export interface SiteConfig {
+    name: string;
+    description: string;
+    /** Fully-qualified base URL with no trailing slash (e.g. "https://docs.example.com"). */
+    baseUrl: string;
+    defaultLanguage: string;
+    metadata?: SiteMetadata;
+}
+//# sourceMappingURL=site.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../src/types/site.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB"}

package/dist/types/site.js

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

package/dist/types/site.js.map

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

package/dist/utils/lang-utils.d.ts

@@ -0,0 +1,23 @@
+import type { LanguageConfig } from '../types/language.js';
+/**
+ * Returns the active language code from the current pathname.
+ *
+ * The default language has no URL prefix, so `/flight-manual/safety` is
+ * English (or whichever `defaultLanguage` is). Only non-default language
+ * codes appear as the first path segment: `/de/flight-manual/safety` → `de`.
+ */
+export declare function detectCurrentLang(pathname: string, language: LanguageConfig | null, defaultLanguage: string): string;
+/** Returns `/<lang>` for non-default languages, or `''` for the default. */
+export declare function buildLangPrefix(lang: string, defaultLanguage: string): string;
+/**
+ * Strips the language prefix from a pathname to get the content-relative path.
+ * e.g. `/de/flight-manual/safety` → `/flight-manual/safety`
+ *      `/flight-manual/safety`    → `/flight-manual/safety` (default lang, unchanged)
+ */
+export declare function stripLangPrefix(pathname: string, lang: string, defaultLanguage: string): string;
+/**
+ * Looks up a translated nav label for `lang`, falling back to `defaultLabel`
+ * when no translation is found (missing file, missing key, or default language).
+ */
+export declare function resolveLabel(defaultLabel: string, lang: string, defaultLanguage: string, translations: Record<string, Record<string, string>>): string;
+//# sourceMappingURL=lang-utils.d.ts.map

package/dist/utils/lang-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lang-utils.d.ts","sourceRoot":"","sources":["../../src/utils/lang-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,cAAc,GAAG,IAAI,EAC/B,eAAe,EAAE,MAAM,GACtB,MAAM,CAKR;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,GACtB,MAAM,CAKR;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACnD,MAAM,CAGR"}

package/dist/utils/lang-utils.js

@@ -0,0 +1,40 @@
+/**
+ * Returns the active language code from the current pathname.
+ *
+ * The default language has no URL prefix, so `/flight-manual/safety` is
+ * English (or whichever `defaultLanguage` is). Only non-default language
+ * codes appear as the first path segment: `/de/flight-manual/safety` → `de`.
+ */
+export function detectCurrentLang(pathname, language, defaultLanguage) {
+    if (!language || language.languages.length <= 1)
+        return defaultLanguage;
+    const firstSegment = pathname.split('/').filter(Boolean)[0] ?? '';
+    const nonDefault = language.languages.filter((l) => l !== defaultLanguage);
+    return nonDefault.includes(firstSegment) ? firstSegment : defaultLanguage;
+}
+/** Returns `/<lang>` for non-default languages, or `''` for the default. */
+export function buildLangPrefix(lang, defaultLanguage) {
+    return lang === defaultLanguage ? '' : `/${lang}`;
+}
+/**
+ * Strips the language prefix from a pathname to get the content-relative path.
+ * e.g. `/de/flight-manual/safety` → `/flight-manual/safety`
+ *      `/flight-manual/safety`    → `/flight-manual/safety` (default lang, unchanged)
+ */
+export function stripLangPrefix(pathname, lang, defaultLanguage) {
+    if (lang === defaultLanguage)
+        return pathname;
+    const prefix = `/${lang}`;
+    const stripped = pathname.startsWith(prefix) ? pathname.slice(prefix.length) : pathname;
+    return stripped || '/';
+}
+/**
+ * Looks up a translated nav label for `lang`, falling back to `defaultLabel`
+ * when no translation is found (missing file, missing key, or default language).
+ */
+export function resolveLabel(defaultLabel, lang, defaultLanguage, translations) {
+    if (lang === defaultLanguage)
+        return defaultLabel;
+    return translations[lang]?.[defaultLabel] ?? defaultLabel;
+}
+//# sourceMappingURL=lang-utils.js.map

package/dist/utils/lang-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lang-utils.js","sourceRoot":"","sources":["../../src/utils/lang-utils.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,QAA+B,EAC/B,eAAuB;IAEvB,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,eAAe,CAAC;IACxE,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAClE,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC;IAC3E,OAAO,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC;AAC5E,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,eAAuB;IACnE,OAAO,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AACpD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAgB,EAChB,IAAY,EACZ,eAAuB;IAEvB,IAAI,IAAI,KAAK,eAAe;QAAE,OAAO,QAAQ,CAAC;IAC9C,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;IAC1B,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxF,OAAO,QAAQ,IAAI,GAAG,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,YAAoB,EACpB,IAAY,EACZ,eAAuB,EACvB,YAAoD;IAEpD,IAAI,IAAI,KAAK,eAAe;QAAE,OAAO,YAAY,CAAC;IAClD,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,YAAY,CAAC;AAC5D,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Resolves the absolute path to mordoc's own package root.
+ *
+ * This file compiles to `dist/utils/paths.js`, which sits two directories
+ * below the package root. Using `import.meta.url` means the resolution
+ * works regardless of where mordoc is installed — in its own repo during
+ * development, or under `node_modules/mordoc/` in a user's project.
+ *
+ * Shared by `cli/dev.ts` and `cli/build.ts` because both Vite invocations
+ * (dev server, production build) point Vite's `root` at mordoc's own
+ * app source folder, not at anything inside the user's project.
+ */
+export declare function getPackageRoot(): string;
+/**
+ * Resolves the absolute path to the app source root that Vite uses as its
+ * `root` for both dev serving and production builds.
+ *
+ * This is where `index.html`, `main.tsx`, and `entry-server.tsx` live
+ * inside the mordoc package — all application source that Vite compiles
+ * in the user's environment. The user's project never points Vite at any
+ * of its own files; everything user-side flows through the mordoc plugin's
+ * virtual modules.
+ */
+export declare function getAppRoot(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}

package/dist/utils/paths.js

@@ -0,0 +1,31 @@
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+/**
+ * Resolves the absolute path to mordoc's own package root.
+ *
+ * This file compiles to `dist/utils/paths.js`, which sits two directories
+ * below the package root. Using `import.meta.url` means the resolution
+ * works regardless of where mordoc is installed — in its own repo during
+ * development, or under `node_modules/mordoc/` in a user's project.
+ *
+ * Shared by `cli/dev.ts` and `cli/build.ts` because both Vite invocations
+ * (dev server, production build) point Vite's `root` at mordoc's own
+ * app source folder, not at anything inside the user's project.
+ */
+export function getPackageRoot() {
+    return path.resolve(fileURLToPath(import.meta.url), '../../..');
+}
+/**
+ * Resolves the absolute path to the app source root that Vite uses as its
+ * `root` for both dev serving and production builds.
+ *
+ * This is where `index.html`, `main.tsx`, and `entry-server.tsx` live
+ * inside the mordoc package — all application source that Vite compiles
+ * in the user's environment. The user's project never points Vite at any
+ * of its own files; everything user-side flows through the mordoc plugin's
+ * virtual modules.
+ */
+export function getAppRoot() {
+    return path.join(getPackageRoot(), 'src', 'app');
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AACnD,CAAC"}