@zudojs/docs 1.0.5 → 1.1.0

package/README.md

@@ -58,7 +58,10 @@ const index = generateIndex(registry.getAll()); // SERVER-only docs excluded
 - Markdown and JSON generation with escaping for untrusted content: structured text is HTML-escaped and links are limited to http, https, mailto, tel, ftp and ftps (others are written as plain text)
 - Fail-closed `visibility` filtering: only an unset or exactly `"CLIENT"` visibility reaches a client index
 - `stripMarkdown` and link validation run in linear time on untrusted input
-- Document, link and navigation validation with a single `valid` rule (errors only); `javascript:` and other non-allow-listed link schemes are `UNSAFE_LINK` errors
+- Document, link and navigation validation with a single `valid` rule (errors only); `javascript:` and other non-allow-listed link schemes are `UNSAFE_LINK` errors in every link form — inline `[x](…)` (including targets with parentheses or a title), reference definitions `[x]: …`, raw `<a href="…">` and `<scheme:…>` autolinks
+- `BROKEN_LINK` and `NAVIGATION_ORPHAN_DOCUMENT` are warnings by default; pass `{ brokenLinkSeverity: "error", orphanSeverity: "error" }` to `validateAll` (or `brokenLinkSeverity` to `validateLinks`) to fail on dead links or unreachable documents
+- `createDocument({ …, strict: true })` rejects an unknown `category`, `status` or `visibility` at creation instead of leaving it to `validateDocument`; documents never carry explicit `undefined` keys
+- `getAdjacent(id, nav, { scope: "tree" })` walks previous/next across section boundaries in reading order (the default stays within one level)
 - Documentation error classes re-exported from `@zudojs/errors`
 
 ## Use Cases

package/dist/docsTypes/documentationContent.d.ts

@@ -77,4 +77,3 @@ export interface StructuredContent {
  * A document can use any of these formats.
  */
 export type DocumentationContent = MarkdownContent | MDXContent | HTMLContent | StructuredContent;
-//# sourceMappingURL=documentationContent.d.ts.map

package/dist/docsTypes/documentationContent.js

@@ -5,4 +5,3 @@
  * and structured AST nodes for multi-format rendering.
  */
 export {};
-//# sourceMappingURL=documentationContent.js.map

package/dist/docsTypes/documentationDocument.d.ts

@@ -26,4 +26,3 @@ export interface DocumentationDocument {
     readonly deprecatedMessage?: string;
     readonly visibility?: "SERVER" | "CLIENT";
 }
-//# sourceMappingURL=documentationDocument.d.ts.map

package/dist/docsTypes/documentationDocument.js

@@ -5,4 +5,3 @@
  * Each document has a stable ID, structured content, and metadata.
  */
 export {};
-//# sourceMappingURL=documentationDocument.js.map

package/dist/docsTypes/documentationMetadata.d.ts

@@ -50,11 +50,14 @@ export interface DocumentationMetadata {
     readonly ticket?: string;
     readonly tags?: readonly string[];
 }
-/** A version entry for versioned documentation. */
+/**
+ * A version entry for versioned documentation. A contract only: the
+ * package provides no version switcher; hosts list their versions with
+ * this shape and select a registry per version.
+ */
 export interface DocumentationVersion {
     readonly version: string;
     readonly label?: string;
     readonly deprecated?: boolean;
     readonly latest?: boolean;
 }
-//# sourceMappingURL=documentationMetadata.d.ts.map

package/dist/docsTypes/documentationMetadata.js

@@ -2,4 +2,3 @@
  * Metadata and classification types for documentation.
  */
 export {};
-//# sourceMappingURL=documentationMetadata.js.map

package/dist/docsTypes/documentationNavigation.d.ts

@@ -15,7 +15,11 @@ export interface DocumentationBreadcrumb {
     readonly title: string;
     readonly documentId?: string;
 }
-/** Search document for indexing. */
+/**
+ * Search document for indexing. A contract only: this package ships no
+ * search index; build `SearchDocument`s from a registry (for example with
+ * `stripMarkdown`) and feed them to the search engine of your choice.
+ */
 export interface SearchDocument {
     readonly id: string;
     readonly title: string;
@@ -23,7 +27,10 @@ export interface SearchDocument {
     readonly tags: readonly string[];
     readonly path: string;
 }
-/** Search result returned from a search query. */
+/**
+ * Search result returned from a search query. A contract only; see
+ * `SearchDocument`.
+ */
 export interface SearchResult {
     readonly id: string;
     readonly title: string;
@@ -31,4 +38,3 @@ export interface SearchResult {
     readonly excerpt?: string;
     readonly score?: number;
 }
-//# sourceMappingURL=documentationNavigation.d.ts.map

package/dist/docsTypes/documentationNavigation.js

@@ -5,4 +5,3 @@
  * structure can be controlled independently of content.
  */
 export {};
-//# sourceMappingURL=documentationNavigation.js.map

package/dist/docsTypes/documentationProvider.d.ts

@@ -10,7 +10,11 @@ export interface DocumentationProvider {
     get(id: string): DocumentationDocument | undefined;
     getAll(): readonly DocumentationDocument[];
 }
-/** Loads content from a documentation source. */
+/**
+ * Loads content from a documentation source. A contract only: no loader
+ * ships with the package; implement it over the file system, a fetch or
+ * a database and pass the result to `parseFrontmatter` / `createDocument`.
+ */
 export interface DocumentationSourceLoader {
     load(source: string): Promise<string>;
 }
@@ -18,4 +22,3 @@ export interface DocumentationSourceLoader {
 export interface DocumentationSanitizer {
     sanitize(content: string): string;
 }
-//# sourceMappingURL=documentationProvider.d.ts.map

package/dist/docsTypes/documentationProvider.js

@@ -5,4 +5,3 @@
  * Source loaders abstract how documentation is read.
  */
 export {};
-//# sourceMappingURL=documentationProvider.js.map

package/dist/docsTypes/index.d.ts

@@ -8,4 +8,3 @@ export type { DocumentationCategory, DocumentationStatus, APISymbolKind, SourceL
 export type { DocumentationDocument } from "./documentationDocument.js";
 export type { DocumentationNavigationItem, DocumentationBreadcrumb, SearchDocument, SearchResult, } from "./documentationNavigation.js";
 export type { DocumentationProvider, DocumentationSourceLoader, DocumentationSanitizer, } from "./documentationProvider.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/docsTypes/index.js

@@ -4,4 +4,3 @@
  * Core type definitions for the documentation model.
  */
 export {};
-//# sourceMappingURL=index.js.map

package/dist/document/documentBuilder.convenience.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Convenience builders for markdown and structured documents.
+ *
+ * @module document/documentBuilder.convenience
+ */
+import type { DocumentationDocument, DocumentationNode } from "../docsTypes/index.js";
+import { type DocumentBuilderExtras } from "./documentBuilder.core.js";
+/**
+ * Creates a markdown document.
+ */
+export declare function createMarkdownDocument(id: string, title: string, markdown: string, options?: DocumentBuilderExtras): DocumentationDocument;
+/**
+ * Creates a structured document from AST nodes.
+ */
+export declare function createStructuredDocument(id: string, title: string, nodes: readonly DocumentationNode[], options?: DocumentBuilderExtras): DocumentationDocument;

package/dist/document/documentBuilder.convenience.js

@@ -0,0 +1,28 @@
+/**
+ * Convenience builders for markdown and structured documents.
+ *
+ * @module document/documentBuilder.convenience
+ */
+import { createDocument, } from "./documentBuilder.core.js";
+/**
+ * Creates a markdown document.
+ */
+export function createMarkdownDocument(id, title, markdown, options) {
+    return createDocument({
+        ...options,
+        id,
+        title,
+        content: { type: "markdown", value: markdown },
+    });
+}
+/**
+ * Creates a structured document from AST nodes.
+ */
+export function createStructuredDocument(id, title, nodes, options) {
+    return createDocument({
+        ...options,
+        id,
+        title,
+        content: { type: "structured", nodes },
+    });
+}

package/dist/document/documentBuilder.core.d.ts

@@ -4,7 +4,7 @@
  * Provides a chainable API that validates inputs and
  * produces immutable DocumentationDocument objects.
  */
-import type { DocumentationContent, DocumentationDocument, DocumentationCategory, DocumentationMetadata, DocumentationNode, DocumentationStatus } from "../docsTypes/index.js";
+import type { DocumentationContent, DocumentationDocument, DocumentationCategory, DocumentationMetadata, DocumentationStatus } from "../docsTypes/index.js";
 /**
  * Options for creating a document via the builder.
  */
@@ -21,6 +21,14 @@ export interface DocumentBuilderOptions {
     readonly deprecated?: boolean;
     readonly deprecatedMessage?: string;
     readonly visibility?: "SERVER" | "CLIENT";
+    /**
+     * When true, the built document is also run through `validateDocument`
+     * and any error issue (unknown `category`, `status`, `visibility`,
+     * content type or structured node) throws a `DocumentValidationError`.
+     * Defaults to false: the builder checks only `id`, `title` and the
+     * presence of `content`, matching earlier releases.
+     */
+    readonly strict?: boolean;
 }
 /**
  * Options accepted by the convenience builders. The positional
@@ -32,10 +40,16 @@ export type DocumentBuilderExtras = Omit<Partial<DocumentBuilderOptions>, "id" |
  *
  * The returned document is a deep-frozen copy: later mutation of the
  * options object (or of nested `content`, `metadata`, `tags`) does not
- * affect it.
+ * affect it. Optional fields that were not supplied are absent from the
+ * document rather than present as `undefined`.
  *
- * @throws {DocumentValidationError} when `id`, `title` or `content` is missing
- *   or the ID is not a valid dot-separated identifier.
+ * Only `id`, `title` and `content` are checked here; `category`, `status`
+ * and the other enums are checked by `validateDocument`, or at creation
+ * time when `strict: true` is passed.
+ *
+ * @throws {DocumentValidationError} when `id`, `title` or `content` is missing,
+ *   the ID is not a valid dot-separated identifier, or (`strict: true`)
+ *   `validateDocument` reports an error.
  *
  * @example
  * ```ts
@@ -49,12 +63,3 @@ export type DocumentBuilderExtras = Omit<Partial<DocumentBuilderOptions>, "id" |
  * ```
  */
 export declare function createDocument(options: DocumentBuilderOptions): DocumentationDocument;
-/**
- * Creates a markdown document.
- */
-export declare function createMarkdownDocument(id: string, title: string, markdown: string, options?: DocumentBuilderExtras): DocumentationDocument;
-/**
- * Creates a structured document from AST nodes.
- */
-export declare function createStructuredDocument(id: string, title: string, nodes: readonly DocumentationNode[], options?: DocumentBuilderExtras): DocumentationDocument;
-//# sourceMappingURL=documentBuilder.core.d.ts.map

package/dist/document/documentBuilder.core.js

@@ -4,19 +4,24 @@
  * Provides a chainable API that validates inputs and
  * produces immutable DocumentationDocument objects.
  */
-import { DocumentValidationError } from "@zudojs/errors";
 import { deepFreezeClone } from "../utils/utils.freeze.js";
-import { isValidDocumentId } from "../utils/utils.helper.js";
-import { toTagList } from "./documentBuilder.normalize.js";
+import { toTagList, withoutUndefined } from "./documentBuilder.normalize.js";
+import { assertValid, validateDocumentOptions } from "./documentBuilder.validate.js";
 /**
  * Creates a documentation document from structured options.
  *
  * The returned document is a deep-frozen copy: later mutation of the
  * options object (or of nested `content`, `metadata`, `tags`) does not
- * affect it.
+ * affect it. Optional fields that were not supplied are absent from the
+ * document rather than present as `undefined`.
  *
- * @throws {DocumentValidationError} when `id`, `title` or `content` is missing
- *   or the ID is not a valid dot-separated identifier.
+ * Only `id`, `title` and `content` are checked here; `category`, `status`
+ * and the other enums are checked by `validateDocument`, or at creation
+ * time when `strict: true` is passed.
+ *
+ * @throws {DocumentValidationError} when `id`, `title` or `content` is missing,
+ *   the ID is not a valid dot-separated identifier, or (`strict: true`)
+ *   `validateDocument` reports an error.
  *
  * @example
  * ```ts
@@ -31,7 +36,7 @@ import { toTagList } from "./documentBuilder.normalize.js";
  */
 export function createDocument(options) {
     validateDocumentOptions(options);
-    const document = {
+    const document = withoutUndefined({
         id: options.id,
         title: options.title,
         description: options.description,
@@ -44,48 +49,9 @@ export function createDocument(options) {
         deprecated: options.deprecated,
         deprecatedMessage: options.deprecatedMessage,
         visibility: options.visibility,
-    };
-    return deepFreezeClone(document);
-}
-/**
- * Validates document builder options.
- * Throws on invalid input.
- */
-function validateDocumentOptions(options) {
-    if (typeof options.id !== "string" || options.id.trim().length === 0) {
-        throw new DocumentValidationError("Document ID is required.");
-    }
-    if (!isValidDocumentId(options.id)) {
-        throw new DocumentValidationError(`Document ID "${options.id}" is invalid. Use dot-separated segments of letters, digits, "_" and "-".`, options.id);
-    }
-    if (typeof options.title !== "string" ||
-        options.title.trim().length === 0) {
-        throw new DocumentValidationError("Document title is required.", options.id);
-    }
-    if (!options.content || typeof options.content !== "object") {
-        throw new DocumentValidationError("Document content is required.", options.id);
-    }
-}
-/**
- * Creates a markdown document.
- */
-export function createMarkdownDocument(id, title, markdown, options) {
-    return createDocument({
-        ...options,
-        id,
-        title,
-        content: { type: "markdown", value: markdown },
-    });
-}
-/**
- * Creates a structured document from AST nodes.
- */
-export function createStructuredDocument(id, title, nodes, options) {
-    return createDocument({
-        ...options,
-        id,
-        title,
-        content: { type: "structured", nodes },
     });
+    if (options.strict) {
+        assertValid(document);
+    }
+    return deepFreezeClone(document);
 }
-//# sourceMappingURL=documentBuilder.core.js.map

package/dist/document/documentBuilder.normalize.d.ts

@@ -9,4 +9,8 @@
  * one-character tags.
  */
 export declare function toTagList(tags: readonly string[] | string | undefined): string[] | undefined;
-//# sourceMappingURL=documentBuilder.normalize.d.ts.map
+/**
+ * Shallow copy of `value` without the keys whose value is `undefined`, so
+ * an optional field that was not supplied is absent instead of present.
+ */
+export declare function withoutUndefined<T extends object>(value: T): T;

package/dist/document/documentBuilder.normalize.js

@@ -15,4 +15,15 @@ export function toTagList(tags) {
         return tags === "" ? [] : [tags];
     return [...tags];
 }
-//# sourceMappingURL=documentBuilder.normalize.js.map
+/**
+ * Shallow copy of `value` without the keys whose value is `undefined`, so
+ * an optional field that was not supplied is absent instead of present.
+ */
+export function withoutUndefined(value) {
+    const copy = {};
+    for (const [key, item] of Object.entries(value)) {
+        if (item !== undefined)
+            copy[key] = item;
+    }
+    return copy;
+}

package/dist/document/documentBuilder.validate.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Input and strict-mode checks for `createDocument`.
+ *
+ * @module document/documentBuilder.validate
+ */
+import type { DocumentationDocument } from "../docsTypes/index.js";
+import type { DocumentBuilderOptions } from "./documentBuilder.core.js";
+/**
+ * Validates document builder options.
+ * Throws on invalid input.
+ */
+export declare function validateDocumentOptions(options: DocumentBuilderOptions): void;
+/**
+ * Throws when `validateDocument` reports an error issue for `document`.
+ */
+export declare function assertValid(document: DocumentationDocument): void;

package/dist/document/documentBuilder.validate.js

@@ -0,0 +1,36 @@
+/**
+ * Input and strict-mode checks for `createDocument`.
+ *
+ * @module document/documentBuilder.validate
+ */
+import { DocumentValidationError } from "@zudojs/errors";
+import { isValidDocumentId } from "../utils/utils.helper.js";
+import { validateDocument } from "../validator/validatorDocument.core.js";
+/**
+ * Validates document builder options.
+ * Throws on invalid input.
+ */
+export function validateDocumentOptions(options) {
+    if (typeof options.id !== "string" || options.id.trim().length === 0) {
+        throw new DocumentValidationError("Document ID is required.");
+    }
+    if (!isValidDocumentId(options.id)) {
+        throw new DocumentValidationError(`Document ID "${options.id}" is invalid. Use dot-separated segments of letters, digits, "_" and "-".`, options.id);
+    }
+    if (typeof options.title !== "string" ||
+        options.title.trim().length === 0) {
+        throw new DocumentValidationError("Document title is required.", options.id);
+    }
+    if (!options.content || typeof options.content !== "object") {
+        throw new DocumentValidationError("Document content is required.", options.id);
+    }
+}
+/**
+ * Throws when `validateDocument` reports an error issue for `document`.
+ */
+export function assertValid(document) {
+    const failure = validateDocument(document).issues.find((issue) => issue.severity === "error");
+    if (failure) {
+        throw new DocumentValidationError(failure.message, document.id);
+    }
+}

package/dist/document/index.d.ts

@@ -3,6 +3,6 @@
  *
  * Document model and builder for creating documentation pages.
  */
-export { createDocument, createMarkdownDocument, createStructuredDocument, } from "./documentBuilder.core.js";
+export { createDocument } from "./documentBuilder.core.js";
+export { createMarkdownDocument, createStructuredDocument, } from "./documentBuilder.convenience.js";
 export type { DocumentBuilderOptions, DocumentBuilderExtras, } from "./documentBuilder.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/document/index.js

@@ -3,5 +3,5 @@
  *
  * Document model and builder for creating documentation pages.
  */
-export { createDocument, createMarkdownDocument, createStructuredDocument, } from "./documentBuilder.core.js";
-//# sourceMappingURL=index.js.map
+export { createDocument } from "./documentBuilder.core.js";
+export { createMarkdownDocument, createStructuredDocument, } from "./documentBuilder.convenience.js";

package/dist/errors/index.d.ts

@@ -13,4 +13,3 @@ export type { DocumentationErrorOptions } from "@zudojs/errors";
 export declare function createDocumentationError(message: string, options?: DocumentationErrorOptions): DocumentationError;
 /** Determines whether an unknown value is a `DocumentationError`. */
 export declare function isDocumentationError(value: unknown): value is DocumentationError;
-//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.js

@@ -15,4 +15,3 @@ export function createDocumentationError(message, options) {
 export function isDocumentationError(value) {
     return value instanceof DocumentationError;
 }
-//# sourceMappingURL=index.js.map

package/dist/examples/examples.core.d.ts

@@ -39,4 +39,3 @@ export declare function renderExampleMarkdown(example: DocumentationExample): st
  * Renders an example as a JSON-serializable object.
  */
 export declare function exampleToJSON(example: DocumentationExample): Record<string, unknown>;
-//# sourceMappingURL=examples.core.d.ts.map

package/dist/examples/examples.core.js

@@ -62,4 +62,3 @@ export function exampleToJSON(example) {
         description: example.description,
     };
 }
-//# sourceMappingURL=examples.core.js.map

package/dist/examples/index.d.ts

@@ -5,4 +5,3 @@
  */
 export { validateExample, renderExampleMarkdown, exampleToJSON, } from "./examples.core.js";
 export type { DocumentationExample, ExampleValidationResult, } from "./examples.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/examples/index.js

@@ -4,4 +4,3 @@
  * Code example modeling, validation, and rendering for documentation.
  */
 export { validateExample, renderExampleMarkdown, exampleToJSON, } from "./examples.core.js";
-//# sourceMappingURL=index.js.map

package/dist/frontmatter/frontmatter.core.d.ts

@@ -4,4 +4,3 @@
 export { parseFrontmatter } from "./frontmatter.parser.js";
 export { serializeFrontmatter } from "./frontmatter.serializer.js";
 export type { ParsedFrontmatter, FrontmatterMetadata, FrontmatterScalar, FrontmatterValue, } from "./frontmatter.types.js";
-//# sourceMappingURL=frontmatter.core.d.ts.map

package/dist/frontmatter/frontmatter.core.js

@@ -3,4 +3,3 @@
  */
 export { parseFrontmatter } from "./frontmatter.parser.js";
 export { serializeFrontmatter } from "./frontmatter.serializer.js";
-//# sourceMappingURL=frontmatter.core.js.map

package/dist/frontmatter/frontmatter.parser.d.ts

@@ -26,4 +26,3 @@ import type { ParsedFrontmatter } from "./frontmatter.types.js";
  * empty metadata.
  */
 export declare function parseFrontmatter(raw: string): ParsedFrontmatter;
-//# sourceMappingURL=frontmatter.parser.d.ts.map

package/dist/frontmatter/frontmatter.parser.js

@@ -238,4 +238,3 @@ function unescapeDoubleQuoted(value) {
         }
     });
 }
-//# sourceMappingURL=frontmatter.parser.js.map

package/dist/frontmatter/frontmatter.serializer.d.ts

@@ -18,4 +18,3 @@ import type { FrontmatterMetadata } from "./frontmatter.types.js";
 export declare function serializeFrontmatter(metadata: FrontmatterMetadata | Readonly<Record<string, unknown>>, content: string): string;
 /** Formats a single scalar, quoting whenever the parser could misread it. */
 export declare function formatScalar(value: unknown): string;
-//# sourceMappingURL=frontmatter.serializer.d.ts.map

package/dist/frontmatter/frontmatter.serializer.js

@@ -124,4 +124,3 @@ function isPlainObject(value) {
     const proto = Object.getPrototypeOf(value);
     return proto === Object.prototype || proto === null;
 }
-//# sourceMappingURL=frontmatter.serializer.js.map

package/dist/frontmatter/frontmatter.types.d.ts

@@ -32,4 +32,3 @@ export interface FrontmatterMetadata {
     readonly visibility?: string;
     readonly [key: string]: FrontmatterValue | undefined;
 }
-//# sourceMappingURL=frontmatter.types.d.ts.map

package/dist/frontmatter/frontmatter.types.js

@@ -2,4 +2,3 @@
  * Type definitions for frontmatter parsing.
  */
 export {};
-//# sourceMappingURL=frontmatter.types.js.map

package/dist/frontmatter/frontmatter.values.d.ts

@@ -22,4 +22,3 @@ export declare function emptyCollection(value: string): readonly never[] | Reado
  * list; anything else is a single item. Items go through `parseItem`.
  */
 export declare function parseInlineList(value: string, parseItem: (item: string) => string): readonly string[];
-//# sourceMappingURL=frontmatter.values.d.ts.map

package/dist/frontmatter/frontmatter.values.js

@@ -67,4 +67,3 @@ export function parseInlineList(value, parseItem) {
         .filter((item) => item !== "")
         .map(parseItem));
 }
-//# sourceMappingURL=frontmatter.values.js.map

package/dist/frontmatter/index.d.ts

@@ -5,4 +5,3 @@
  */
 export { parseFrontmatter, serializeFrontmatter } from "./frontmatter.core.js";
 export type { ParsedFrontmatter, FrontmatterMetadata, FrontmatterScalar, FrontmatterValue, } from "./frontmatter.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/frontmatter/index.js

@@ -4,4 +4,3 @@
  * YAML frontmatter parsing and serialization for markdown documentation.
  */
 export { parseFrontmatter, serializeFrontmatter } from "./frontmatter.core.js";
-//# sourceMappingURL=index.js.map

package/dist/generator/generator.types.d.ts

@@ -26,4 +26,3 @@ export interface IndexGeneratorOptions {
      */
     readonly visibility?: DocumentVisibilityFilter;
 }
-//# sourceMappingURL=generator.types.d.ts.map

package/dist/generator/generator.types.js

@@ -2,4 +2,3 @@
  * Type definitions for documentation generators.
  */
 export {};
-//# sourceMappingURL=generator.types.js.map

package/dist/generator/generatorJson.core.d.ts

@@ -15,4 +15,3 @@ export declare function generateJSON(document: DocumentationDocument): Record<st
  * `IndexGeneratorOptions.visibility`).
  */
 export declare function generateIndex(documents: readonly DocumentationDocument[], options?: IndexGeneratorOptions): Record<string, unknown>[];
-//# sourceMappingURL=generatorJson.core.d.ts.map

package/dist/generator/generatorJson.core.js

@@ -45,4 +45,3 @@ export function generateIndex(documents, options = {}) {
         deprecatedMessage: doc.deprecatedMessage,
     }));
 }
-//# sourceMappingURL=generatorJson.core.js.map

package/dist/generator/generatorMarkdown.core.d.ts

@@ -11,4 +11,3 @@ import type { MarkdownGeneratorOptions } from "./generator.types.js";
  * and tags cannot inject metadata keys or terminate the block.
  */
 export declare function generateMarkdown(document: DocumentationDocument, options?: MarkdownGeneratorOptions): string;
-//# sourceMappingURL=generatorMarkdown.core.d.ts.map

package/dist/generator/generatorMarkdown.core.js

@@ -93,4 +93,3 @@ function contentToMarkdown(content, sanitizer) {
 function escapeInline(value) {
     return escapeHtmlText(value.replace(/\r?\n/g, " "));
 }
-//# sourceMappingURL=generatorMarkdown.core.js.map

package/dist/generator/generatorMarkdownNodes.d.ts

@@ -29,4 +29,3 @@ export declare function fenceFor(value: string): string;
 export declare function sanitizeLanguage(language: string | undefined): string;
 /** Escapes `|` and newlines so a value stays inside its table cell. */
 export declare function tableCell(value: string): string;
-//# sourceMappingURL=generatorMarkdownNodes.d.ts.map

package/dist/generator/generatorMarkdownNodes.js

@@ -144,4 +144,3 @@ function escapeLinkHref(href) {
     const clean = href.replace(/[\r\n]/g, "").replace(/&/g, "&");
     return /[\s()]/.test(clean) ? `<${clean.replace(/[<>]/g, "")}>` : clean;
 }
-//# sourceMappingURL=generatorMarkdownNodes.js.map

package/dist/generator/index.d.ts

@@ -7,4 +7,3 @@ export { generateMarkdown } from "./generatorMarkdown.core.js";
 export { nodesToMarkdown, clampHeadingLevel, fenceFor, sanitizeLanguage, tableCell, } from "./generatorMarkdownNodes.js";
 export { generateJSON, generateIndex } from "./generatorJson.core.js";
 export type { MarkdownGeneratorOptions, IndexGeneratorOptions, } from "./generator.types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/generator/index.js

@@ -6,4 +6,3 @@
 export { generateMarkdown } from "./generatorMarkdown.core.js";
 export { nodesToMarkdown, clampHeadingLevel, fenceFor, sanitizeLanguage, tableCell, } from "./generatorMarkdownNodes.js";
 export { generateJSON, generateIndex } from "./generatorJson.core.js";
-//# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -17,4 +17,3 @@ export * from "./examples/index.js";
 export * from "./generator/index.js";
 export * from "./utils/index.js";
 export * from "./errors/index.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -27,4 +27,3 @@ export * from "./generator/index.js";
 export * from "./utils/index.js";
 // Errors (re-exported from @zudojs/errors)
 export * from "./errors/index.js";
-//# sourceMappingURL=index.js.map

package/dist/navigation/index.d.ts

@@ -3,5 +3,6 @@
  *
  * Navigation tree utilities — breadcrumbs, flattening, sibling resolution.
  */
-export { getBreadcrumbs, flattenNavigation, findNavigationItem, getSiblings, getAdjacent, } from "./navigation.core.js";
-//# sourceMappingURL=index.d.ts.map
+export { getBreadcrumbs, flattenNavigation, findNavigationItem, } from "./navigation.core.js";
+export { getSiblings, getAdjacent } from "./navigation.adjacent.js";
+export type { GetAdjacentOptions } from "./navigation.adjacent.js";