@zudojs/docs 0.0.1

package/dist/generator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @zudojs/docs
+ *
+ * Documentation infrastructure for the Zudojs framework.
+ *
+ * Provides a structured document model, registry, validation,
+ * navigation, examples, frontmatter parsing, and output generation
+ * for building and maintaining documentation.
+ */
+export * from "./docsTypes/index.js";
+export * from "./document/index.js";
+export * from "./frontmatter/index.js";
+export * from "./registry/index.js";
+export * from "./validator/index.js";
+export * from "./navigation/index.js";
+export * from "./examples/index.js";
+export * from "./generator/index.js";
+export * from "./utils/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,cAAc,sBAAsB,CAAC;AAGrC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,wBAAwB,CAAC;AAGvC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,28 @@
+/**
+ * @zudojs/docs
+ *
+ * Documentation infrastructure for the Zudojs framework.
+ *
+ * Provides a structured document model, registry, validation,
+ * navigation, examples, frontmatter parsing, and output generation
+ * for building and maintaining documentation.
+ */
+// Types
+export * from "./docsTypes/index.js";
+// Document builder
+export * from "./document/index.js";
+// Frontmatter
+export * from "./frontmatter/index.js";
+// Registry
+export * from "./registry/index.js";
+// Validator
+export * from "./validator/index.js";
+// Navigation
+export * from "./navigation/index.js";
+// Examples
+export * from "./examples/index.js";
+// Generator
+export * from "./generator/index.js";
+// Utils
+export * from "./utils/index.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;;;;;;;;GAQG;AAEH,QAAQ;AACR,cAAc,sBAAsB,CAAC;AAErC,mBAAmB;AACnB,cAAc,qBAAqB,CAAC;AAEpC,cAAc;AACd,cAAc,wBAAwB,CAAC;AAEvC,WAAW;AACX,cAAc,qBAAqB,CAAC;AAEpC,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,aAAa;AACb,cAAc,uBAAuB,CAAC;AAEtC,WAAW;AACX,cAAc,qBAAqB,CAAC;AAEpC,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,QAAQ;AACR,cAAc,kBAAkB,CAAC"}

package/dist/navigation/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/docs/navigation
+ *
+ * Navigation tree utilities — breadcrumbs, flattening, sibling resolution.
+ */
+export { getBreadcrumbs, flattenNavigation, findNavigationItem, getSiblings, } from "./navigation.core.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":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,GACZ,MAAM,sBAAsB,CAAC"}

package/dist/navigation/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/docs/navigation
+ *
+ * Navigation tree utilities — breadcrumbs, flattening, sibling resolution.
+ */
+export { getBreadcrumbs, flattenNavigation, findNavigationItem, getSiblings, } from "./navigation.core.js";
+//# sourceMappingURL=index.js.map

package/dist/navigation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,GACZ,MAAM,sBAAsB,CAAC"}

package/dist/navigation/navigation.core.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Navigation model for documentation.
+ *
+ * Provides breadcrumb generation, tree flattening, and
+ * link resolution for documentation navigation structures.
+ */
+import type { DocumentationBreadcrumb, DocumentationNavigationItem } from "../docsTypes/index.js";
+/**
+ * Generates breadcrumbs for a given document ID
+ * by walking the navigation tree.
+ */
+export declare function getBreadcrumbs(documentId: string, items: readonly DocumentationNavigationItem[]): readonly DocumentationBreadcrumb[];
+/**
+ * Flattens a navigation tree into a list of all document IDs in order.
+ */
+export declare function flattenNavigation(items: readonly DocumentationNavigationItem[]): readonly string[];
+/**
+ * Finds a navigation item by document ID.
+ */
+export declare function findNavigationItem(documentId: string, items: readonly DocumentationNavigationItem[]): DocumentationNavigationItem | undefined;
+/**
+ * Gets sibling document IDs for a given document.
+ */
+export declare function getSiblings(documentId: string, items: readonly DocumentationNavigationItem[]): readonly string[];
+//# sourceMappingURL=navigation.core.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.core.d.ts","sourceRoot":"","sources":["../../src/navigation/navigation.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,uBAAuB,EACvB,2BAA2B,EAC5B,MAAM,uBAAuB,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,2BAA2B,EAAE,GAC5C,SAAS,uBAAuB,EAAE,CAwBpC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,2BAA2B,EAAE,GAC5C,SAAS,MAAM,EAAE,CAiBnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,2BAA2B,EAAE,GAC5C,2BAA2B,GAAG,SAAS,CAazC;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS,2BAA2B,EAAE,GAC5C,SAAS,MAAM,EAAE,CAmBnB"}

package/dist/navigation/navigation.core.js

@@ -0,0 +1,85 @@
+/**
+ * Navigation model for documentation.
+ *
+ * Provides breadcrumb generation, tree flattening, and
+ * link resolution for documentation navigation structures.
+ */
+/**
+ * Generates breadcrumbs for a given document ID
+ * by walking the navigation tree.
+ */
+export function getBreadcrumbs(documentId, items) {
+    const path = [];
+    function walk(nodes) {
+        for (const node of nodes) {
+            if (node.documentId === documentId) {
+                path.push({ title: node.title, documentId: node.documentId });
+                return true;
+            }
+            if (node.children) {
+                path.push({ title: node.title });
+                if (walk(node.children)) {
+                    return true;
+                }
+                path.pop();
+            }
+        }
+        return false;
+    }
+    walk(items);
+    return Object.freeze(path);
+}
+/**
+ * Flattens a navigation tree into a list of all document IDs in order.
+ */
+export function flattenNavigation(items) {
+    const result = [];
+    function walk(nodes) {
+        for (const node of nodes) {
+            if (node.documentId) {
+                result.push(node.documentId);
+            }
+            if (node.children) {
+                walk(node.children);
+            }
+        }
+    }
+    walk(items);
+    return Object.freeze(result);
+}
+/**
+ * Finds a navigation item by document ID.
+ */
+export function findNavigationItem(documentId, items) {
+    for (const node of items) {
+        if (node.documentId === documentId) {
+            return node;
+        }
+        if (node.children) {
+            const found = findNavigationItem(documentId, node.children);
+            if (found)
+                return found;
+        }
+    }
+    return undefined;
+}
+/**
+ * Gets sibling document IDs for a given document.
+ */
+export function getSiblings(documentId, items) {
+    function walk(nodes) {
+        for (const node of nodes) {
+            if (node.documentId === documentId) {
+                return nodes.filter((n) => n.documentId).map((n) => n.documentId);
+            }
+            if (node.children) {
+                const result = walk(node.children);
+                if (result)
+                    return result;
+            }
+        }
+        return undefined;
+    }
+    return Object.freeze(walk(items) ?? []);
+}
+//# sourceMappingURL=navigation.core.js.map

package/dist/navigation/navigation.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.core.js","sourceRoot":"","sources":["../../src/navigation/navigation.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,UAAkB,EAClB,KAA6C;IAE7C,MAAM,IAAI,GAA8B,EAAE,CAAC;IAE3C,SAAS,IAAI,CAAC,KAA6C;QACzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACnC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC9D,OAAO,IAAI,CAAC;YACd,CAAC;YAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;gBACjC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACxB,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,CAAC;IACZ,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAA6C;IAE7C,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,SAAS,IAAI,CAAC,KAA6C;QACzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/B,CAAC;YAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,CAAC;IACZ,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAkB,EAClB,KAA6C;IAE7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,KAAK,GAAG,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC5D,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,UAAkB,EAClB,KAA6C;IAE7C,SAAS,IAAI,CACX,KAA6C;QAE7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACnC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAW,CAAC,CAAC;YACrE,CAAC;YAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACnC,IAAI,MAAM;oBAAE,OAAO,MAAM,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/registry/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/docs/registry
+ *
+ * Document registry for storing, retrieving, and filtering documentation.
+ */
+export { DocumentRegistry, createDocumentRegistry } from "./registry.core.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/registry/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/docs/registry
+ *
+ * Document registry for storing, retrieving, and filtering documentation.
+ */
+export { DocumentRegistry, createDocumentRegistry } from "./registry.core.js";
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/registry/registry.core.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Document registry with O(1) lookup by ID.
+ *
+ * Provides registration, retrieval, and iteration over
+ * documentation documents. Prevents duplicate IDs.
+ */
+import type { DocumentationDocument, DocumentationProvider } from "../docsTypes/index.js";
+/**
+ * Registry for managing documentation documents.
+ */
+export declare class DocumentRegistry implements DocumentationProvider {
+    private readonly documents;
+    /**
+     * Registers a document. Throws if the ID is already registered.
+     */
+    register(document: DocumentationDocument): void;
+    /**
+     * Registers multiple documents.
+     */
+    registerAll(documents: readonly DocumentationDocument[]): void;
+    /**
+     * Retrieves a document by ID. Returns undefined if not found.
+     */
+    get(id: string): DocumentationDocument | undefined;
+    /**
+     * Returns all registered documents.
+     */
+    getAll(): readonly DocumentationDocument[];
+    /**
+     * Returns the number of registered documents.
+     */
+    get size(): number;
+    /**
+     * Checks if a document ID is registered.
+     */
+    has(id: string): boolean;
+    /**
+     * Removes a document by ID. Returns true if it existed.
+     */
+    delete(id: string): boolean;
+    /**
+     * Clears all registered documents.
+     */
+    clear(): void;
+    /**
+     * Returns all document IDs.
+     */
+    ids(): readonly string[];
+    /**
+     * Filters documents by category.
+     */
+    byCategory(category: string): readonly DocumentationDocument[];
+    /**
+     * Filters documents by tag.
+     */
+    byTag(tag: string): readonly DocumentationDocument[];
+}
+/**
+ * Creates a new document registry.
+ */
+export declare function createDocumentRegistry(): DocumentRegistry;
+//# sourceMappingURL=registry.core.d.ts.map

package/dist/registry/registry.core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.core.d.ts","sourceRoot":"","sources":["../../src/registry/registry.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,qBAAa,gBAAiB,YAAW,qBAAqB;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IAEtE;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAQ/C;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,qBAAqB,EAAE,GAAG,IAAI;IAM9D;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAIlD;;OAEG;IACH,MAAM,IAAI,SAAS,qBAAqB,EAAE;IAI1C;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,GAAG,IAAI,SAAS,MAAM,EAAE;IAIxB;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,qBAAqB,EAAE;IAM9D;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,qBAAqB,EAAE;CAKrD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD"}

package/dist/registry/registry.core.js

@@ -0,0 +1,90 @@
+/**
+ * Document registry with O(1) lookup by ID.
+ *
+ * Provides registration, retrieval, and iteration over
+ * documentation documents. Prevents duplicate IDs.
+ */
+/**
+ * Registry for managing documentation documents.
+ */
+export class DocumentRegistry {
+    documents = new Map();
+    /**
+     * Registers a document. Throws if the ID is already registered.
+     */
+    register(document) {
+        if (this.documents.has(document.id)) {
+            throw new Error(`Duplicate document ID: "${document.id}".`);
+        }
+        this.documents.set(document.id, Object.freeze(document));
+    }
+    /**
+     * Registers multiple documents.
+     */
+    registerAll(documents) {
+        for (const doc of documents) {
+            this.register(doc);
+        }
+    }
+    /**
+     * Retrieves a document by ID. Returns undefined if not found.
+     */
+    get(id) {
+        return this.documents.get(id);
+    }
+    /**
+     * Returns all registered documents.
+     */
+    getAll() {
+        return Object.freeze([...this.documents.values()]);
+    }
+    /**
+     * Returns the number of registered documents.
+     */
+    get size() {
+        return this.documents.size;
+    }
+    /**
+     * Checks if a document ID is registered.
+     */
+    has(id) {
+        return this.documents.has(id);
+    }
+    /**
+     * Removes a document by ID. Returns true if it existed.
+     */
+    delete(id) {
+        return this.documents.delete(id);
+    }
+    /**
+     * Clears all registered documents.
+     */
+    clear() {
+        this.documents.clear();
+    }
+    /**
+     * Returns all document IDs.
+     */
+    ids() {
+        return Object.freeze([...this.documents.keys()]);
+    }
+    /**
+     * Filters documents by category.
+     */
+    byCategory(category) {
+        return Object.freeze([...this.documents.values()].filter((doc) => doc.category === category));
+    }
+    /**
+     * Filters documents by tag.
+     */
+    byTag(tag) {
+        return Object.freeze([...this.documents.values()].filter((doc) => doc.tags?.includes(tag)));
+    }
+}
+/**
+ * Creates a new document registry.
+ */
+export function createDocumentRegistry() {
+    return new DocumentRegistry();
+}
+//# sourceMappingURL=registry.core.js.map

package/dist/registry/registry.core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.core.js","sourceRoot":"","sources":["../../src/registry/registry.core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACV,SAAS,GAAG,IAAI,GAAG,EAAiC,CAAC;IAEtE;;OAEG;IACH,QAAQ,CAAC,QAA+B;QACtC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;QAC9D,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,SAA2C;QACrD,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,QAAgB;QACzB,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC,CACxE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAW;QACf,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CACtE,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,gBAAgB,EAAE,CAAC;AAChC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/docs/utils
+ *
+ * Utility helpers for document ID normalization, link resolution, and markdown parsing.
+ */
+export { normalizeDocumentId, documentIdFromPath, resolveDocumentLink, extractTitleFromMarkdown, extractHeadings, stripMarkdown, } from "./utils.helper.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,aAAa,GACd,MAAM,mBAAmB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,7 @@
+/**
+ * @zudojs/docs/utils
+ *
+ * Utility helpers for document ID normalization, link resolution, and markdown parsing.
+ */
+export { normalizeDocumentId, documentIdFromPath, resolveDocumentLink, extractTitleFromMarkdown, extractHeadings, stripMarkdown, } from "./utils.helper.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,eAAe,EACf,aAAa,GACd,MAAM,mBAAmB,CAAC"}

package/dist/utils/utils.helper.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Utility helpers for the documentation package.
+ */
+/**
+ * Normalizes a document ID to a consistent format.
+ * Strips leading/trailing dots, collapses consecutive dots.
+ */
+export declare function normalizeDocumentId(id: string): string;
+/**
+ * Generates a document ID from a file path.
+ * Converts path separators to dots and removes extension.
+ */
+export declare function documentIdFromPath(path: string): string;
+/**
+ * Resolves a relative document link against a base ID.
+ * "guides.http" + "./routing" → "guides.http.routing"
+ */
+export declare function resolveDocumentLink(baseId: string, link: string): string;
+/**
+ * Extracts the title from markdown content (first heading).
+ */
+export declare function extractTitleFromMarkdown(markdown: string): string | undefined;
+/**
+ * Extracts headings from markdown content.
+ */
+export declare function extractHeadings(markdown: string): readonly {
+    level: number;
+    text: string;
+}[];
+/**
+ * Strips markdown formatting to plain text.
+ */
+export declare function stripMarkdown(markdown: string): string;
+//# sourceMappingURL=utils.helper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.helper.d.ts","sourceRoot":"","sources":["../../src/utils/utils.helper.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAKtD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBxE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GACf,SAAS;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAkB5C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUtD"}

package/dist/utils/utils.helper.js

@@ -0,0 +1,82 @@
+/**
+ * Utility helpers for the documentation package.
+ */
+/**
+ * Normalizes a document ID to a consistent format.
+ * Strips leading/trailing dots, collapses consecutive dots.
+ */
+export function normalizeDocumentId(id) {
+    return id
+        .replace(/\.+/g, ".")
+        .replace(/^\.|\.$/g, "")
+        .trim();
+}
+/**
+ * Generates a document ID from a file path.
+ * Converts path separators to dots and removes extension.
+ */
+export function documentIdFromPath(path) {
+    return normalizeDocumentId(path.replace(/\.[^.]+$/, "").replace(/[/\\]/g, "."));
+}
+/**
+ * Resolves a relative document link against a base ID.
+ * "guides.http" + "./routing" → "guides.http.routing"
+ */
+export function resolveDocumentLink(baseId, link) {
+    if (link.startsWith("/")) {
+        return normalizeDocumentId(link.slice(1));
+    }
+    const baseParts = baseId.split(".");
+    baseParts.pop();
+    const linkParts = link.split("/");
+    for (const part of linkParts) {
+        if (part === "..") {
+            baseParts.pop();
+        }
+        else if (part !== "." && part !== "") {
+            baseParts.push(part);
+        }
+    }
+    return normalizeDocumentId(baseParts.join("."));
+}
+/**
+ * Extracts the title from markdown content (first heading).
+ */
+export function extractTitleFromMarkdown(markdown) {
+    const match = markdown.match(/^# ([^\n]+)$/m);
+    return match?.[1]?.trim();
+}
+/**
+ * Extracts headings from markdown content.
+ */
+export function extractHeadings(markdown) {
+    const results = [];
+    const pattern = /^(#{1,6}) ([^\n]+)$/gm;
+    let match;
+    while ((match = pattern.exec(markdown)) !== null) {
+        const hashes = match[1];
+        const headingText = match[2];
+        if (hashes && headingText) {
+            results.push({
+                level: hashes.length,
+                text: headingText.trim(),
+            });
+        }
+    }
+    return Object.freeze(results);
+}
+/**
+ * Strips markdown formatting to plain text.
+ */
+export function stripMarkdown(markdown) {
+    return markdown
+        .replace(/^#{1,6}\s+/gm, "")
+        .replace(/\*\*([^*]+)\*\*/g, "$1")
+        .replace(/\*([^*]+)\*/g, "$1")
+        .replace(/`([^`]+)`/g, "$1")
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1")
+        .replace(/^\s*[-*+]\s+/gm, "")
+        .replace(/^\s*\d+\.\s+/gm, "")
+        .trim();
+}
+//# sourceMappingURL=utils.helper.js.map

package/dist/utils/utils.helper.js.map

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

package/dist/validator/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @zudojs/docs/validator
+ *
+ * Document validation for IDs, links, metadata, and navigation.
+ */
+export { validateDocument } from "./validatorDocument.core.js";
+export { validateNoDuplicateIds } from "./validatorDuplicates.core.js";
+export { validateLinks } from "./validatorLinks.core.js";
+export { validateAll, validateNavigation } from "./validatorAll/index.js";
+export type { ValidationIssue, ValidationResult } from "./validator.types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validator/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE1E,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/validator/index.js

@@ -0,0 +1,10 @@
+/**
+ * @zudojs/docs/validator
+ *
+ * Document validation for IDs, links, metadata, and navigation.
+ */
+export { validateDocument } from "./validatorDocument.core.js";
+export { validateNoDuplicateIds } from "./validatorDuplicates.core.js";
+export { validateLinks } from "./validatorLinks.core.js";
+export { validateAll, validateNavigation } from "./validatorAll/index.js";
+//# sourceMappingURL=index.js.map

package/dist/validator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validator/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/validator/validator.types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Type definitions for document validation.
+ */
+/**
+ * A single validation issue found in documentation.
+ */
+export interface ValidationIssue {
+    readonly severity: "error" | "warning";
+    readonly code: string;
+    readonly message: string;
+    readonly documentId?: string;
+}
+/**
+ * Result of validating documentation.
+ */
+export interface ValidationResult {
+    readonly valid: boolean;
+    readonly issues: readonly ValidationIssue[];
+}
+//# sourceMappingURL=validator.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validator.types.d.ts","sourceRoot":"","sources":["../../src/validator/validator.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C"}

package/dist/validator/validator.types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for document validation.
+ */
+export {};
+//# sourceMappingURL=validator.types.js.map

package/dist/validator/validator.types.js.map

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

package/dist/validator/validatorAll/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/docs/validator/validatorAll
+ *
+ * Aggregate validators for complete documentation sets.
+ */
+export { validateAll } from "./validatorAll.core.js";
+export { validateNavigation } from "./validatorNavigation.core.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/validator/validatorAll/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validator/validatorAll/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/validator/validatorAll/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/docs/validator/validatorAll
+ *
+ * Aggregate validators for complete documentation sets.
+ */
+export { validateAll } from "./validatorAll.core.js";
+export { validateNavigation } from "./validatorNavigation.core.js";
+//# sourceMappingURL=index.js.map

package/dist/validator/validatorAll/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/validator/validatorAll/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC"}