@specglass/core 0.0.2

package/dist/errors/specglass-error.js

@@ -0,0 +1,19 @@
+/**
+ * Structured error class for all user-facing specglass errors.
+ * Provides actionable context: error code, file path, line number, and remediation hint.
+ */
+export class SpecglassError extends Error {
+    code;
+    filePath;
+    line;
+    hint;
+    constructor(message, code, filePath, line, hint) {
+        super(message);
+        this.code = code;
+        this.filePath = filePath;
+        this.line = line;
+        this.hint = hint;
+        this.name = "SpecglassError";
+    }
+}
+//# sourceMappingURL=specglass-error.js.map

package/dist/errors/specglass-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specglass-error.js","sourceRoot":"","sources":["../../src/errors/specglass-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGrB;IACA;IACA;IACA;IALlB,YACE,OAAe,EACC,IAAY,EACZ,QAAiB,EACjB,IAAa,EACb,IAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,SAAI,GAAJ,IAAI,CAAQ;QACZ,aAAQ,GAAR,QAAQ,CAAS;QACjB,SAAI,GAAJ,IAAI,CAAS;QACb,SAAI,GAAJ,IAAI,CAAS;QAG7B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+export { defineConfig } from "./config/define-config.js";
+export { loadConfig } from "./config/loader.js";
+export { configSchema } from "./config/schema.js";
+export { DEFAULT_CONFIG } from "./config/defaults.js";
+export { specglassIntegration, COMPONENT_IMPORTS } from "./integration.js";
+export { VIRTUAL_MODULE_ID, NAVIGATION_MODULE_ID, OPENAPI_DATA_MODULE_ID, generateConfigModuleContent, generateNavigationModuleContent, generateOpenApiDataModuleContent, } from "./virtual/modules.js";
+export { frontmatterSchema } from "./content/frontmatter-schema.js";
+export type { Frontmatter } from "./content/frontmatter-schema.js";
+export { defineDocsCollection, getSlugFromFilePath, wrapFrontmatterError, } from "./content/mdx-loader.js";
+export type { DocsCollectionOptions } from "./content/mdx-loader.js";
+export type { SpecglassConfig, SpecglassUserConfig } from "./types/config.js";
+export type { NavItem, NavigationTree, MetaJsonEntry, MetaJsonEntryValue, } from "./types/navigation.js";
+export { buildNavigationTree, toTitleCase } from "./navigation/builder.js";
+export { parseMetaJson } from "./navigation/meta-parser.js";
+export { metaJsonSchema, metaJsonEntryValueSchema, metaJsonEntryObjectSchema, } from "./navigation/meta-schema.js";
+export type { MetaJsonSchemaInput } from "./navigation/meta-schema.js";
+export { createNavigationWatcher, isNavigationRelevant, } from "./navigation/watcher.js";
+export type { NavigationWatcherOptions } from "./navigation/watcher.js";
+export { SpecglassError } from "./errors/specglass-error.js";
+export { parseOpenApiSpec } from "./openapi/parser.js";
+export { transformSpec } from "./openapi/transformer.js";
+export { buildEndpointSlug, buildEndpointId } from "./openapi/utils.js";
+export type { ApiEndpoint, ApiEndpointError, ApiExample, ApiMediaType, ApiParameter, ApiRequestBody, ApiResponse, ApiSchema, ApiSecurityRequirement, ParsedOpenApiSpec, } from "./openapi/types.js";
+export { loadOpenApiContent, } from "./content/openapi-loader.js";
+export type { OpenApiLoaderConfig, OpenApiContentEntry, OpenApiLoaderResult, } from "./content/openapi-loader.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":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAG3E,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,+BAA+B,EAC/B,gCAAgC,GACjC,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAGrE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,YAAY,EACV,OAAO,EACP,cAAc,EACd,aAAa,EACb,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAGxE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,SAAS,EACT,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+// @specglass/core — Public API
+// Config system
+export { defineConfig } from "./config/define-config.js";
+export { loadConfig } from "./config/loader.js";
+export { configSchema } from "./config/schema.js";
+export { DEFAULT_CONFIG } from "./config/defaults.js";
+// Integration
+export { specglassIntegration, COMPONENT_IMPORTS } from "./integration.js";
+// Virtual modules
+export { VIRTUAL_MODULE_ID, NAVIGATION_MODULE_ID, OPENAPI_DATA_MODULE_ID, generateConfigModuleContent, generateNavigationModuleContent, generateOpenApiDataModuleContent, } from "./virtual/modules.js";
+// Content
+export { frontmatterSchema } from "./content/frontmatter-schema.js";
+export { defineDocsCollection, getSlugFromFilePath, wrapFrontmatterError, } from "./content/mdx-loader.js";
+// Navigation
+export { buildNavigationTree, toTitleCase } from "./navigation/builder.js";
+export { parseMetaJson } from "./navigation/meta-parser.js";
+export { metaJsonSchema, metaJsonEntryValueSchema, metaJsonEntryObjectSchema, } from "./navigation/meta-schema.js";
+export { createNavigationWatcher, isNavigationRelevant, } from "./navigation/watcher.js";
+// Errors
+export { SpecglassError } from "./errors/specglass-error.js";
+// OpenAPI
+export { parseOpenApiSpec } from "./openapi/parser.js";
+export { transformSpec } from "./openapi/transformer.js";
+export { buildEndpointSlug, buildEndpointId } from "./openapi/utils.js";
+export { loadOpenApiContent, } from "./content/openapi-loader.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,+BAA+B;AAE/B,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,cAAc;AACd,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE3E,kBAAkB;AAClB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,+BAA+B,EAC/B,gCAAgC,GACjC,MAAM,sBAAsB,CAAC;AAE9B,UAAU;AACV,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAYjC,aAAa;AACb,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,yBAAyB,CAAC;AAGjC,SAAS;AACT,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D,UAAU;AACV,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAaxE,OAAO,EACL,kBAAkB,GACnB,MAAM,6BAA6B,CAAC"}

package/dist/integration.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Component import paths for auto-import.
+ *
+ * These components are automatically available in MDX files without
+ * explicit import statements. The paths resolve to Astro components
+ * in `@specglass/theme-default`.
+ */
+export declare const COMPONENT_IMPORTS: readonly ["@specglass/theme-default/components/Callout.astro", "@specglass/theme-default/components/Tabs.astro", "@specglass/theme-default/components/TabItem.astro", "@specglass/theme-default/components/CodeBlock.astro", "@specglass/theme-default/components/CodeBlockGroup.astro", "@specglass/theme-default/components/CodeTabs.astro", "@specglass/theme-default/components/Card.astro"];
+/**
+ * Components that site owners can override by placing a file at
+ * `src/components/overrides/<ComponentName>.astro` in their project.
+ *
+ * This is the third tier of the three-tier customization system:
+ * config options → CSS variables → component overrides.
+ */
+export declare const OVERRIDABLE_COMPONENTS: readonly ["Header", "Footer", "Sidebar", "Logo"];
+/**
+ * The specglass Astro integration.
+ *
+ * Accepts a pre-validated SpecglassConfig (resolved at CLI time via jiti)
+ * and injects it as a virtual module so theme components can import it
+ * at render time via `import { config } from 'virtual:specglass/config'`.
+ *
+ * Also injects a remark plugin that auto-imports built-in MDX components
+ * (Callout, Tabs, TabItem, CodeBlock, Card) into all MDX files.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "astro/config";
+ * import mdx from "@astrojs/mdx";
+ * import { specglassIntegration } from "@specglass/core";
+ *
+ * export default defineConfig({
+ *   integrations: [specglassIntegration({ config }), mdx()],
+ * });
+ * ```
+ */
+export declare const specglassIntegration: (options: {
+    config?: any;
+}) => import("astro").AstroIntegration & {};
+//# sourceMappingURL=integration.d.ts.map

package/dist/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAuBA;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,kYAQpB,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,kDAKzB,CAAC;AA2CX;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,oBAAoB;;2CA6N/B,CAAC"}

package/dist/integration.js

@@ -0,0 +1,276 @@
+import { defineIntegration, addVirtualImports, addVitePlugin, } from "astro-integration-kit";
+import { z } from "zod";
+import { join, parse } from "node:path";
+import { existsSync } from "node:fs";
+import { parse as parseJs } from "acorn";
+import { VIRTUAL_MODULE_ID, NAVIGATION_MODULE_ID, OPENAPI_DATA_MODULE_ID, generateConfigModuleContent, generateNavigationModuleContent, generateOpenApiDataModuleContent, } from "./virtual/modules.js";
+import { buildNavigationTree } from "./navigation/builder.js";
+import { createNavigationWatcher } from "./navigation/watcher.js";
+import { rehypeCodeBlocks } from "./content/rehype-code-blocks.js";
+import { loadOpenApiContent } from "./content/openapi-loader.js";
+/**
+ * Component import paths for auto-import.
+ *
+ * These components are automatically available in MDX files without
+ * explicit import statements. The paths resolve to Astro components
+ * in `@specglass/theme-default`.
+ */
+export const COMPONENT_IMPORTS = [
+    "@specglass/theme-default/components/Callout.astro",
+    "@specglass/theme-default/components/Tabs.astro",
+    "@specglass/theme-default/components/TabItem.astro",
+    "@specglass/theme-default/components/CodeBlock.astro",
+    "@specglass/theme-default/components/CodeBlockGroup.astro",
+    "@specglass/theme-default/components/CodeTabs.astro",
+    "@specglass/theme-default/components/Card.astro",
+];
+/**
+ * Components that site owners can override by placing a file at
+ * `src/components/overrides/<ComponentName>.astro` in their project.
+ *
+ * This is the third tier of the three-tier customization system:
+ * config options → CSS variables → component overrides.
+ */
+export const OVERRIDABLE_COMPONENTS = [
+    "Header",
+    "Footer",
+    "Sidebar",
+    "Logo",
+];
+/**
+ * Build import statements for the auto-import remark plugin.
+ */
+function buildImportStatements(imports) {
+    return imports
+        .map((path) => {
+        const name = parse(path).name.replaceAll(/[^\w\d]/g, "");
+        return `import ${name} from ${JSON.stringify(path)};`;
+    })
+        .join("\n");
+}
+/**
+ * Create a remark plugin that injects component imports into MDX files.
+ * This is the same approach used by astro-auto-import internally.
+ */
+function createAutoImportPlugin(imports) {
+    const js = buildImportStatements(imports);
+    const parsed = parseJs(js, { ecmaVersion: "latest", sourceType: "module" });
+    const importsNode = {
+        type: "mdxjsEsm",
+        value: "",
+        data: {
+            estree: {
+                ...parsed,
+                type: "Program",
+                sourceType: "module",
+            },
+        },
+    };
+    return function remarkAutoImport() {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        return function (tree, vfile) {
+            if (!vfile.basename?.endsWith(".md")) {
+                tree.children.unshift(importsNode);
+            }
+        };
+    };
+}
+/**
+ * The specglass Astro integration.
+ *
+ * Accepts a pre-validated SpecglassConfig (resolved at CLI time via jiti)
+ * and injects it as a virtual module so theme components can import it
+ * at render time via `import { config } from 'virtual:specglass/config'`.
+ *
+ * Also injects a remark plugin that auto-imports built-in MDX components
+ * (Callout, Tabs, TabItem, CodeBlock, Card) into all MDX files.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "astro/config";
+ * import mdx from "@astrojs/mdx";
+ * import { specglassIntegration } from "@specglass/core";
+ *
+ * export default defineConfig({
+ *   integrations: [specglassIntegration({ config }), mdx()],
+ * });
+ * ```
+ */
+export const specglassIntegration = defineIntegration({
+    name: "specglass",
+    optionsSchema: z.object({
+        config: z.any().transform((val) => val),
+    }),
+    setup({ name, options }) {
+        /** Content directory path, resolved in astro:config:setup. */
+        let contentDir = "";
+        /**
+         * Current navigation module content.
+         * Updated by the file watcher during dev and used by the
+         * navigation HMR Vite plugin to serve the latest navigation data.
+         */
+        let currentNavContent = "";
+        return {
+            hooks: {
+                "astro:config:setup": async (params) => {
+                    // Build navigation tree from content directory
+                    contentDir = join(params.config.root.pathname, "src", "content", "docs");
+                    let navTree;
+                    try {
+                        navTree = await buildNavigationTree(contentDir);
+                    }
+                    catch {
+                        navTree = { items: [] };
+                    }
+                    currentNavContent = generateNavigationModuleContent(navTree);
+                    // Parse OpenAPI specs if configured
+                    let openApiModuleContent = generateOpenApiDataModuleContent();
+                    const openApiConfig = options.config.openapi;
+                    if (openApiConfig?.specs && openApiConfig.specs.length > 0) {
+                        try {
+                            const result = await loadOpenApiContent(openApiConfig);
+                            openApiModuleContent = generateOpenApiDataModuleContent(result.specs);
+                        }
+                        catch (error) {
+                            console.warn(`[specglass] Warning: OpenAPI loading failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+                        }
+                    }
+                    addVirtualImports(params, {
+                        name,
+                        imports: {
+                            [VIRTUAL_MODULE_ID]: generateConfigModuleContent(options.config),
+                            [NAVIGATION_MODULE_ID]: currentNavContent,
+                            [OPENAPI_DATA_MODULE_ID]: openApiModuleContent,
+                        },
+                    });
+                    // Add a higher-priority Vite plugin that serves the latest
+                    // navigation content dynamically. The addVirtualImports plugin
+                    // captures content as a static string, so on HMR invalidation
+                    // it would re-serve stale data. This plugin overrides that.
+                    const resolvedNavId = `\0${NAVIGATION_MODULE_ID}`;
+                    addVitePlugin(params, {
+                        warnDuplicated: false,
+                        plugin: {
+                            name: "specglass-nav-hmr",
+                            enforce: "pre",
+                            load(id) {
+                                if (id === resolvedNavId) {
+                                    return currentNavContent;
+                                }
+                            },
+                        },
+                    });
+                    // Component override resolution (Tier 3 of three-tier customization)
+                    // Check for user override files and set up Vite aliases
+                    const srcDir = join(params.config.root.pathname, "src");
+                    const overrideDir = join(srcDir, "components", "overrides");
+                    const overrideAliases = {};
+                    for (const component of OVERRIDABLE_COMPONENTS) {
+                        const overridePath = join(overrideDir, `${component}.astro`);
+                        if (existsSync(overridePath)) {
+                            overrideAliases[`@specglass/theme-default/components/${component}.astro`] = overridePath;
+                        }
+                    }
+                    if (Object.keys(overrideAliases).length > 0) {
+                        addVitePlugin(params, {
+                            warnDuplicated: false,
+                            plugin: {
+                                name: "specglass-component-overrides",
+                                enforce: "pre",
+                                resolveId(id) {
+                                    if (id in overrideAliases) {
+                                        return overrideAliases[id];
+                                    }
+                                },
+                            },
+                        });
+                    }
+                    // Inject auto-import remark plugin directly into markdown config.
+                    // This avoids integration ordering issues — the plugin is added
+                    // to the remark pipeline regardless of where mdx() appears.
+                    params.updateConfig({
+                        markdown: {
+                            remarkPlugins: [createAutoImportPlugin(COMPONENT_IMPORTS)],
+                            rehypePlugins: [rehypeCodeBlocks],
+                        },
+                    });
+                    params.injectRoute({
+                        pattern: "/[...slug]",
+                        entrypoint: "@specglass/core/pages/[...slug].astro",
+                    });
+                    params.injectRoute({
+                        pattern: "/api-reference/[...slug]",
+                        entrypoint: "@specglass/core/pages/api-reference/[...slug].astro",
+                    });
+                },
+                "astro:server:setup": ({ server }) => {
+                    // Guard: contentDir must be set by astro:config:setup first
+                    if (!contentDir) {
+                        return;
+                    }
+                    // The resolved virtual module ID uses Vite's \0 prefix convention
+                    const resolvedNavModuleId = `\0${NAVIGATION_MODULE_ID}`;
+                    // The HMR channel — Vite 6 renamed server.ws → server.hot
+                    const hot = server.hot ?? server.ws;
+                    const watcher = createNavigationWatcher({
+                        contentDir,
+                        onNavigationUpdate: (tree) => {
+                            // Update the cached module content (read by specglass-nav-hmr plugin)
+                            currentNavContent = generateNavigationModuleContent(tree);
+                            // Invalidate the navigation virtual module in Vite's module graph
+                            const mod = server.moduleGraph.getModuleById(resolvedNavModuleId);
+                            if (mod) {
+                                server.moduleGraph.invalidateModule(mod);
+                                // Send HMR update to trigger client-side re-render
+                                hot.send({
+                                    type: "full-reload",
+                                    path: "*",
+                                });
+                            }
+                        },
+                    });
+                    // Listen to the Vite/chokidar file watcher for all change events
+                    server.watcher.on("all", (event, filePath) => {
+                        watcher.handleFileChange(filePath);
+                    });
+                    // Clean up when the server closes
+                    server.httpServer?.on("close", () => {
+                        watcher.cleanup();
+                    });
+                },
+                "astro:build:done": async ({ dir, logger }) => {
+                    // Run Pagefind indexing on the built output
+                    // Architecture: Content → Page generation → Pagefind indexing (build pipeline ordering)
+                    try {
+                        const pagefind = await import("pagefind");
+                        const { index } = await pagefind.createIndex({
+                            forceLanguage: "en",
+                        });
+                        if (!index) {
+                            logger.warn("Pagefind: Failed to create search index");
+                            return;
+                        }
+                        // Index all HTML files in the Astro output directory
+                        const outputPath = dir.pathname;
+                        const { page_count, errors } = await index.addDirectory({
+                            path: outputPath,
+                        });
+                        if (errors && errors.length > 0) {
+                            logger.warn(`Pagefind: Indexing completed with errors: ${errors.join(", ")}`);
+                        }
+                        // Write index files to the output directory
+                        await index.writeFiles({
+                            outputPath: join(outputPath, "pagefind"),
+                        });
+                        logger.info(`Pagefind: Indexed ${page_count} pages → ${outputPath}pagefind/`);
+                        await pagefind.close();
+                    }
+                    catch (error) {
+                        logger.warn(`Pagefind: Search indexing failed — ${error instanceof Error ? error.message : String(error)}`);
+                    }
+                },
+            },
+        };
+    },
+});
+//# sourceMappingURL=integration.js.map

package/dist/integration.js.map

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

package/dist/navigation/builder.d.ts

@@ -0,0 +1,24 @@
+import type { NavigationTree } from "../types/navigation.js";
+/**
+ * Convert a kebab-case filename into Title Case.
+ *
+ * Examples:
+ *   "getting-started" → "Getting Started"
+ *   "api-reference"   → "Api Reference"
+ */
+export declare function toTitleCase(kebab: string): string;
+/**
+ * Build a navigation tree by recursively walking a content directory.
+ *
+ * - Reads `_meta.json` in each directory for ordering and labels
+ * - Falls back to alphabetical ordering when no `_meta.json` exists
+ * - Unlisted items are appended alphabetically after listed ones
+ * - Hidden items (`hidden: true`) are excluded from the tree
+ * - External links (`href`) are included without requiring a file
+ *
+ * @param contentDir - Absolute path to the content directory root
+ * @param slugPrefix - Path prefix for slug generation (used during recursion)
+ * @returns The complete navigation tree
+ */
+export declare function buildNavigationTree(contentDir: string, slugPrefix?: string): Promise<NavigationTree>;
+//# sourceMappingURL=builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/navigation/builder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAW,cAAc,EAAiB,MAAM,wBAAwB,CAAC;AAErF;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,cAAc,CAAC,CAGzB"}

package/dist/navigation/builder.js

@@ -0,0 +1,169 @@
+import { readdir, stat } from "node:fs/promises";
+import { join, parse } from "node:path";
+import { parseMetaJson } from "./meta-parser.js";
+/**
+ * Convert a kebab-case filename into Title Case.
+ *
+ * Examples:
+ *   "getting-started" → "Getting Started"
+ *   "api-reference"   → "Api Reference"
+ */
+export function toTitleCase(kebab) {
+    return kebab
+        .split("-")
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(" ");
+}
+/**
+ * Build a navigation tree by recursively walking a content directory.
+ *
+ * - Reads `_meta.json` in each directory for ordering and labels
+ * - Falls back to alphabetical ordering when no `_meta.json` exists
+ * - Unlisted items are appended alphabetically after listed ones
+ * - Hidden items (`hidden: true`) are excluded from the tree
+ * - External links (`href`) are included without requiring a file
+ *
+ * @param contentDir - Absolute path to the content directory root
+ * @param slugPrefix - Path prefix for slug generation (used during recursion)
+ * @returns The complete navigation tree
+ */
+export async function buildNavigationTree(contentDir, slugPrefix = "") {
+    const items = await buildItems(contentDir, slugPrefix);
+    return { items };
+}
+/**
+ * Recursively build NavItem[] for a single directory.
+ */
+async function buildItems(dirPath, slugPrefix) {
+    // Read directory entries
+    let entries;
+    try {
+        entries = await readdir(dirPath);
+    }
+    catch {
+        return [];
+    }
+    // Classify entries into files and directories
+    const files = [];
+    const dirs = [];
+    for (const entry of entries) {
+        if (entry === "_meta.json")
+            continue;
+        const fullPath = join(dirPath, entry);
+        const info = await stat(fullPath);
+        if (info.isDirectory()) {
+            dirs.push(entry);
+        }
+        else if (entry.endsWith(".mdx") || entry.endsWith(".md")) {
+            // Skip index files — they are section landing pages, not sidebar items
+            const baseName = parse(entry).name;
+            if (baseName !== "index") {
+                files.push(entry);
+            }
+        }
+    }
+    // Parse _meta.json for ordering
+    const meta = await parseMetaJson(dirPath);
+    if (meta === null) {
+        // No valid _meta.json — alphabetical fallback
+        return buildAlphabetical(files, dirs, dirPath, slugPrefix);
+    }
+    // Build items in _meta.json order, then append unlisted
+    const result = [];
+    const listedKeys = new Set(meta.map((m) => m.key));
+    for (const entry of meta) {
+        if (entry.hidden)
+            continue;
+        // External link — no file needed
+        if (entry.href) {
+            result.push({
+                title: entry.title,
+                slug: "",
+                type: "external-link",
+                href: entry.href,
+                ...(entry.icon !== undefined && { icon: entry.icon }),
+            });
+            continue;
+        }
+        // Check if entry matches a directory
+        if (dirs.includes(entry.key)) {
+            const children = await buildItems(join(dirPath, entry.key), slugPrefix ? `${slugPrefix}/${entry.key}` : entry.key);
+            result.push({
+                title: entry.title,
+                slug: slugPrefix ? `${slugPrefix}/${entry.key}` : entry.key,
+                type: "section",
+                children,
+                ...(entry.collapsed !== undefined && { collapsed: entry.collapsed }),
+                ...(entry.icon !== undefined && { icon: entry.icon }),
+            });
+            continue;
+        }
+        // Check if entry matches a file
+        const matchingFile = files.find((f) => parse(f).name === entry.key);
+        if (matchingFile) {
+            const baseName = parse(matchingFile).name;
+            result.push({
+                title: entry.title,
+                slug: slugPrefix ? `${slugPrefix}/${baseName}` : baseName,
+                type: "page",
+                ...(entry.icon !== undefined && { icon: entry.icon }),
+            });
+        }
+        // If no file or directory matches, skip silently (meta references a non-existent item)
+    }
+    // Append unlisted files alphabetically
+    const unlistedFiles = files
+        .filter((f) => !listedKeys.has(parse(f).name))
+        .sort();
+    for (const file of unlistedFiles) {
+        const baseName = parse(file).name;
+        result.push({
+            title: toTitleCase(baseName),
+            slug: slugPrefix ? `${slugPrefix}/${baseName}` : baseName,
+            type: "page",
+        });
+    }
+    // Append unlisted directories alphabetically
+    const unlistedDirs = dirs.filter((d) => !listedKeys.has(d)).sort();
+    for (const dir of unlistedDirs) {
+        const children = await buildItems(join(dirPath, dir), slugPrefix ? `${slugPrefix}/${dir}` : dir);
+        result.push({
+            title: toTitleCase(dir),
+            slug: slugPrefix ? `${slugPrefix}/${dir}` : dir,
+            type: "section",
+            children,
+        });
+    }
+    return result;
+}
+/**
+ * Build NavItem[] from files and dirs in alphabetical order (no _meta.json).
+ */
+async function buildAlphabetical(files, dirs, dirPath, slugPrefix) {
+    const allEntries = [
+        ...files.map((f) => ({ name: parse(f).name, isDir: false })),
+        ...dirs.map((d) => ({ name: d, isDir: true })),
+    ].sort((a, b) => a.name.localeCompare(b.name));
+    const result = [];
+    for (const entry of allEntries) {
+        const slug = slugPrefix ? `${slugPrefix}/${entry.name}` : entry.name;
+        if (entry.isDir) {
+            const children = await buildItems(join(dirPath, entry.name), slug);
+            result.push({
+                title: toTitleCase(entry.name),
+                slug,
+                type: "section",
+                children,
+            });
+        }
+        else {
+            result.push({
+                title: toTitleCase(entry.name),
+                slug,
+                type: "page",
+            });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=builder.js.map

package/dist/navigation/builder.js.map

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

package/dist/navigation/index.d.ts

@@ -0,0 +1,7 @@
+export { buildNavigationTree, toTitleCase } from "./builder.js";
+export { parseMetaJson } from "./meta-parser.js";
+export { metaJsonSchema, metaJsonEntryValueSchema, metaJsonEntryObjectSchema, } from "./meta-schema.js";
+export type { MetaJsonSchemaInput } from "./meta-schema.js";
+export { createNavigationWatcher, isNavigationRelevant, } from "./watcher.js";
+export type { NavigationWatcherOptions } from "./watcher.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EACL,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC"}