@vendure-io/docs-provider 0.3.0 → 0.4.0

package/README.md

@@ -23,7 +23,69 @@ bun add @vendure-io/docs-provider
 
 ### Defining a Documentation Package Manifest
 
-Documentation packages export a manifest that describes their structure. **Important**: File paths must be absolute paths. Use a helper pattern to resolve paths relative to your package root:
+Documentation packages export a manifest that describes their structure. **Important**: File paths must be absolute paths. Use a helper pattern to resolve paths relative to your package root.
+
+#### Quick Start (Minimal Config)
+
+```typescript
+import { resolveManifest, type DocsPackageManifestInput } from '@vendure-io/docs-provider'
+import { dirname, join } from 'path'
+import { fileURLToPath } from 'url'
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)))
+const file = (relativePath: string) => join(packageRoot, relativePath)
+
+// Minimal: title/slug auto-derived from files
+const manifestInput: DocsPackageManifestInput = {
+  id: 'my-plugin',
+  name: 'My Plugin',
+  version: '1.0.0',
+  vendureVersion: 'v3',
+  basePath: packageRoot,
+  navigation: [
+    { file: file('docs/getting-started.mdx') },
+    { file: file('docs/installation.mdx') },
+    { file: file('docs/configuration.mdx') },
+  ],
+}
+
+export const manifest = resolveManifest(manifestInput)
+```
+
+#### Using Folder Discovery
+
+```typescript
+import {
+  createNavigationFromFolder,
+  resolveManifest,
+  type DocsPackageManifestInput,
+} from '@vendure-io/docs-provider'
+import { dirname, join } from 'path'
+import { fileURLToPath } from 'url'
+
+const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)))
+const file = (relativePath: string) => join(packageRoot, relativePath)
+
+const manifestInput: DocsPackageManifestInput = {
+  id: 'my-plugin',
+  name: 'My Plugin',
+  version: '1.0.0',
+  vendureVersion: 'v3',
+  basePath: packageRoot,
+  navigation: [
+    { file: file('docs/getting-started.mdx') },
+    {
+      title: 'Guides',
+      slug: 'guides',
+      children: createNavigationFromFolder(join(packageRoot, 'docs/guides')),
+    },
+  ],
+}
+
+export const manifest = resolveManifest(manifestInput)
+```
+
+#### Explicit Navigation (Full Control)
 
 ```typescript
 import type { DocsPackageManifest } from '@vendure-io/docs-provider'
@@ -158,19 +220,22 @@ if (hasFrontmatter(mdxContent)) {
 
 ### Types
 
-| Type                  | Description                                           |
-| --------------------- | ----------------------------------------------------- |
-| `DocsPackageManifest` | Main manifest describing a documentation package      |
-| `NavigationNode`      | A node in the navigation tree                         |
-| `DocPage`             | A loaded documentation page with metadata and content |
-| `DocPageMeta`         | Frontmatter metadata for a page                       |
-| `ParsedFrontmatter`   | Result of parsing frontmatter (meta + content)        |
-| `SearchConfig`        | Search indexing configuration                         |
-| `VendureVersion`      | Supported Vendure versions (`'v1' \| 'v2' \| 'v3'`)   |
-| `FlatNavigationNode`  | Flattened navigation node with path info              |
-| `BreadcrumbItem`      | Breadcrumb navigation item                            |
-| `LoadedDocsPackage`   | Result of loading a docs package                      |
-| `GitHubConfig`        | GitHub repository configuration for edit links        |
+| Type                       | Description                                            |
+| -------------------------- | ------------------------------------------------------ |
+| `DocsPackageManifest`      | Main manifest describing a documentation package       |
+| `DocsPackageManifestInput` | Manifest input with optional title/slug in navigation  |
+| `NavigationNode`           | A node in the navigation tree                          |
+| `NavigationNodeInput`      | Navigation node input with optional title/slug         |
+| `DocPage`                  | A loaded documentation page with metadata and content  |
+| `DocPageMeta`              | Frontmatter metadata for a page                        |
+| `ParsedFrontmatter`        | Result of parsing frontmatter (meta + content)         |
+| `SearchConfig`             | Search indexing configuration                          |
+| `VendureVersion`           | Supported Vendure versions (`'v1' \| 'v2' \| 'v3'`)    |
+| `FlatNavigationNode`       | Flattened navigation node with path info               |
+| `BreadcrumbItem`           | Breadcrumb navigation item                             |
+| `LoadedDocsPackage`        | Result of loading a docs package                       |
+| `GitHubConfig`             | GitHub repository configuration for edit links         |
+| `FileInfo`                 | Information about a discovered file (for folder utils) |
 
 ### MDX Component Props
 
@@ -188,7 +253,9 @@ if (hasFrontmatter(mdxContent)) {
 All types have corresponding Zod schemas for runtime validation:
 
 - `DocsPackageManifestSchema`
+- `DocsPackageManifestInputSchema`
 - `NavigationNodeSchema`
+- `NavigationNodeInputSchema`
 - `DocPageSchema`
 - `DocPageMetaSchema`
 - `SearchConfigSchema`
@@ -205,6 +272,8 @@ All types have corresponding Zod schemas for runtime validation:
 | Function                                 | Description                               |
 | ---------------------------------------- | ----------------------------------------- |
 | `validateManifest(data)`                 | Validate raw data against manifest schema |
+| `resolveManifest(input, options?)`       | Resolve manifest input to full manifest   |
+| `manifestNeedsResolution(input)`         | Check if manifest input needs resolution  |
 | `findNavigationNode(manifest, slugPath)` | Find a node by slug path                  |
 | `flattenNavigation(manifest)`            | Flatten navigation tree to array          |
 | `buildBreadcrumbs(manifest, slugPath)`   | Build breadcrumb trail                    |
@@ -215,9 +284,19 @@ All types have corresponding Zod schemas for runtime validation:
 
 #### Navigation Utilities
 
-| Function                    | Description                      |
-| --------------------------- | -------------------------------- |
-| `getAllFilePaths(manifest)` | Get all file paths from manifest |
+| Function                                        | Description                            |
+| ----------------------------------------------- | -------------------------------------- |
+| `getAllFilePaths(manifest)`                     | Get all file paths from manifest       |
+| `createNavigationFromFolder(path, options?)`    | Create navigation from folder contents |
+| `createNestedNavigationFromFolder(path, opts?)` | Create nested navigation from folders  |
+
+#### Slug Utilities
+
+| Function                  | Description                     |
+| ------------------------- | ------------------------------- |
+| `toSlug(text)`            | Convert text to kebab-case slug |
+| `slugFromFilename(file)`  | Extract slug from filename      |
+| `titleFromFilename(file)` | Generate title from filename    |
 
 #### Frontmatter Utilities
 
@@ -233,6 +312,7 @@ All types have corresponding Zod schemas for runtime validation:
 | Class                     | Description                           |
 | ------------------------- | ------------------------------------- |
 | `ManifestValidationError` | Thrown when manifest validation fails |
+| `ManifestResolutionError` | Thrown when manifest resolution fails |
 | `FrontmatterParseError`   | Thrown when frontmatter parsing fails |
 
 ## Development

package/dist/folder-utils.d.ts

@@ -0,0 +1,136 @@
+import { NavigationNodeInput } from './types';
+/**
+ * Information about a discovered file for sorting and filtering
+ */
+export interface FileInfo {
+    /** Absolute path to the file */
+    path: string;
+    /** Filename without path */
+    filename: string;
+    /** File extension (e.g., '.mdx') */
+    extension: string;
+    /** Parsed frontmatter data (may be empty if no frontmatter) */
+    frontmatter: Record<string, unknown>;
+    /** Order number from frontmatter (defaults to Infinity for sorting) */
+    order: number;
+    /** Title from frontmatter or derived from filename */
+    title: string;
+    /** Slug derived from filename */
+    slug: string;
+}
+/**
+ * Options for createNavigationFromFolder
+ */
+export interface CreateNavigationFromFolderOptions {
+    /**
+     * File extensions to include
+     * @default ['.mdx', '.md']
+     */
+    extensions?: string[];
+    /**
+     * Filter function to exclude files
+     * Return false to exclude a file
+     * @default undefined (include all files)
+     */
+    filter?: (info: FileInfo) => boolean;
+    /**
+     * Sort function for ordering files
+     * @default Sort by frontmatter `order`, then alphabetically by title
+     */
+    sort?: (a: FileInfo, b: FileInfo) => number;
+}
+/**
+ * Options for createNestedNavigationFromFolder
+ */
+export interface CreateNestedNavigationFromFolderOptions extends CreateNavigationFromFolderOptions {
+    /**
+     * Maximum depth to recurse into subfolders
+     * @default Infinity (no limit)
+     */
+    maxDepth?: number;
+    /**
+     * Filter function to exclude folders
+     * Return false to exclude a folder
+     * @default undefined (include all folders)
+     */
+    folderFilter?: (folderName: string, folderPath: string) => boolean;
+}
+/**
+ * Create navigation nodes by discovering MDX files in a folder.
+ *
+ * This function scans a folder for MDX/MD files and creates navigation nodes
+ * with titles and slugs automatically derived from frontmatter and filenames.
+ *
+ * @param folderPath - Absolute path to the folder to scan
+ * @param options - Discovery and sorting options
+ * @returns Array of NavigationNodeInput objects
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - scan a folder
+ * const guides = createNavigationFromFolder(join(packageRoot, 'docs/guides'))
+ *
+ * // With filtering
+ * const guides = createNavigationFromFolder(join(packageRoot, 'docs/guides'), {
+ *   filter: (info) => info.frontmatter.hidden !== true,
+ * })
+ *
+ * // Custom sorting
+ * const guides = createNavigationFromFolder(join(packageRoot, 'docs/guides'), {
+ *   sort: (a, b) => a.filename.localeCompare(b.filename),
+ * })
+ * ```
+ */
+export declare function createNavigationFromFolder(folderPath: string, options?: CreateNavigationFromFolderOptions): NavigationNodeInput[];
+/**
+ * Create nested navigation by recursively scanning a folder and its subfolders.
+ *
+ * Each subfolder becomes a navigation section, and files within become pages.
+ * The folder structure is preserved in the navigation hierarchy.
+ *
+ * @param folderPath - Absolute path to the folder to scan
+ * @param options - Discovery, sorting, and recursion options
+ * @returns Array of NavigationNodeInput objects with nested children
+ *
+ * @example
+ * ```typescript
+ * // Given folder structure:
+ * // docs/
+ * //   getting-started/
+ * //     introduction.mdx
+ * //     installation.mdx
+ * //   guides/
+ * //     basic-usage.mdx
+ * //     advanced/
+ * //       custom-plugins.mdx
+ *
+ * const nav = createNestedNavigationFromFolder(join(packageRoot, 'docs'))
+ * // Returns:
+ * // [
+ * //   {
+ * //     title: 'Getting Started',
+ * //     slug: 'getting-started',
+ * //     children: [
+ * //       { title: 'Introduction', slug: 'introduction', file: '...' },
+ * //       { title: 'Installation', slug: 'installation', file: '...' },
+ * //     ],
+ * //   },
+ * //   {
+ * //     title: 'Guides',
+ * //     slug: 'guides',
+ * //     children: [
+ * //       { title: 'Basic Usage', slug: 'basic-usage', file: '...' },
+ * //       {
+ * //         title: 'Advanced',
+ * //         slug: 'advanced',
+ * //         children: [
+ * //           { title: 'Custom Plugins', slug: 'custom-plugins', file: '...' },
+ * //         ],
+ * //       },
+ * //     ],
+ * //   },
+ * // ]
+ * ```
+ */
+export declare function createNestedNavigationFromFolder(folderPath: string, options?: CreateNestedNavigationFromFolderOptions): NavigationNodeInput[];
+//# sourceMappingURL=folder-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folder-utils.d.ts","sourceRoot":"","sources":["../src/folder-utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAElD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAA;IACb,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IAErB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAA;IAEpC;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,KAAK,MAAM,CAAA;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,uCAAwC,SAAQ,iCAAiC;IAChG;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAA;CACnE;AAcD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,iCAAsC,GAC9C,mBAAmB,EAAE,CAYvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,uCAA4C,GACpD,mBAAmB,EAAE,CAEvB"}

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./manifest-CNnJGNwK.cjs");function i(o){const a=[];return r(o.navigation,a),a}function r(o,a){for(const t of o)t.file&&a.push(t.file),t.children&&r(t.children,a)}exports.BreadcrumbItemSchema=e.BreadcrumbItemSchema;exports.DocPageMetaSchema=e.DocPageMetaSchema;exports.DocPageSchema=e.DocPageSchema;exports.DocsPackageManifestSchema=e.DocsPackageManifestSchema;exports.FlatNavigationNodeSchema=e.FlatNavigationNodeSchema;exports.FrontmatterParseError=e.FrontmatterParseError;exports.GitHubConfigSchema=e.GitHubConfigSchema;exports.LoadedDocsPackageSchema=e.LoadedDocsPackageSchema;exports.ManifestValidationError=e.ManifestValidationError;exports.NavigationNodeSchema=e.NavigationNodeSchema;exports.SearchConfigSchema=e.SearchConfigSchema;exports.VendureVersionSchema=e.VendureVersionSchema;exports.buildBreadcrumbs=e.buildBreadcrumbs;exports.extractFrontmatterData=e.extractFrontmatterData;exports.findNavigationNode=e.findNavigationNode;exports.flattenNavigation=e.flattenNavigation;exports.getLeafNodes=e.getLeafNodes;exports.getNodesAtDepth=e.getNodesAtDepth;exports.getPrevNextNodes=e.getPrevNextNodes;exports.hasFrontmatter=e.hasFrontmatter;exports.isNodeActive=e.isNodeActive;exports.parseFrontmatter=e.parseFrontmatter;exports.validateFrontmatter=e.validateFrontmatter;exports.validateManifest=e.validateManifest;exports.getAllFilePaths=i;
+"use strict";var A=Object.defineProperty;var R=(e,t,i)=>t in e?A(e,t,{enumerable:!0,configurable:!0,writable:!0,value:i}):e[t]=i;var S=(e,t,i)=>R(e,typeof t!="symbol"?t+"":t,i);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./manifest-BYUKRuRu.cjs"),N=require("fs"),x=require("path");function j(e){const t=[];return $(e.navigation,t),t}function $(e,t){for(const i of e)i.file&&t.push(i.file),i.children&&$(i.children,t)}function C(e){return e.toLowerCase().trim().replace(/[^\w\s-]/g,"").replace(/\s+/g,"-").replace(/-+/g,"-").replace(/^-|-$/g,"")}function F(e){const r=(e.split("/").pop()||e).replace(/\.(mdx?|md)$/i,"").replace(/^\d+-/,"");return C(r)}function v(e){return(e.split("/").pop()||e).replace(/\.(mdx?|md)$/i,"").replace(/^\d+-/,"").replace(/[-_]+/g," ").toLowerCase().replace(/\b\w/g,o=>o.toUpperCase()).trim()}const I=(e,t)=>e.order!==t.order?e.order-t.order:e.title.localeCompare(t.title);function B(e,t={}){const{extensions:i=[".mdx",".md"],filter:r,sort:o=I}=t,a=V(e,i);return(r?a.filter(r):a).sort(o).map(d=>({title:d.title,slug:d.slug,file:d.path}))}function T(e,t={}){return L(e,t,0)}function L(e,t,i){const{extensions:r=[".mdx",".md"],filter:o,sort:a=I,maxDepth:l=1/0,folderFilter:u}=t,d=N.readdirSync(e,{withFileTypes:!0}),m=[],D=V(e,r),P=(o?D.filter(o):D).sort(a);for(const f of P)m.push({title:f.title,slug:f.slug,file:f.path});if(i<l){const f=d.filter(c=>c.isDirectory());for(const c of f){if(u){const s=x.join(e,c.name);if(!u(c.name,s))continue}const g=x.join(e,c.name),h=L(g,t,i+1);if(h.length>0){const s=q(g,r);m.push({title:(s==null?void 0:s.title)||v(c.name),slug:F(c.name),file:s==null?void 0:s.path,children:h.filter(p=>!(s&&p.file===s.path))})}}}return m.sort((f,c)=>{var E,M;const g=P.find(y=>y.slug===f.slug),h=P.find(y=>y.slug===c.slug);if(g&&h)return a(g,h);const s=!!f.file&&!((E=f.children)!=null&&E.length),p=!!c.file&&!((M=c.children)!=null&&M.length);return s!==p?s?-1:1:(f.title||"").localeCompare(c.title||"")})}function V(e,t){try{const i=N.readdirSync(e,{withFileTypes:!0}),r=[];for(const o of i){if(!o.isFile())continue;const a=t.find(m=>o.name.toLowerCase().endsWith(m));if(!a||o.name.slice(0,-a.length).toLowerCase()==="index")continue;const u=x.join(e,o.name),d=k(u,o.name,a);r.push(d)}return r}catch{return[]}}function k(e,t,i){let r={},o=v(t),a=1/0;try{const l=N.readFileSync(e,"utf-8");r=n.extractFrontmatterData(l),r.title&&typeof r.title=="string"&&(o=r.title),typeof r.order=="number"&&(a=r.order)}catch{}return{path:e,filename:t,extension:i,frontmatter:r,order:a,title:o,slug:F(t)}}function q(e,t){for(const i of t){const r=x.join(e,`index${i}`);try{if(N.statSync(r).isFile())return k(r,`index${i}`,i)}catch{}}}class b extends Error{constructor(i,r,o,a){super(i);S(this,"nodePath");S(this,"filePath");S(this,"originalError");this.name="ManifestResolutionError",this.nodePath=r,this.filePath=o,this.originalError=a}}function U(e,t={}){const{strict:i=!0}=t,r=w(e.navigation,"",i);return{id:e.id,name:e.name,version:e.version,vendureVersion:e.vendureVersion,navigation:r,search:e.search,github:e.github,basePath:e.basePath}}function w(e,t,i){return e.map((r,o)=>G(r,t,o,i))}function G(e,t,i,r){const o=t?`${t}[${i}]`:`navigation[${i}]`;if(e.title&&e.slug)return{title:e.title,slug:e.slug,file:e.file,children:e.children?w(e.children,`${o}.children`,r):void 0,badge:e.badge};let a=e.title,l=e.slug;if(e.file&&(l||(l=F(e.file)),a||(a=H(e.file,o,r))),!a){if(r)throw new b(`Navigation node at ${o} is missing title and has no file to derive it from`,o,e.file);a=l||`Unknown (${i})`}if(!l){if(r)throw new b(`Navigation node at ${o} is missing slug and has no file to derive it from`,o,e.file);l=a?F(a):`node-${i}`}return{title:a,slug:l,file:e.file,children:e.children?w(e.children,`${o}.children`,r):void 0,badge:e.badge}}function H(e,t,i){try{const r=N.readFileSync(e,"utf-8"),o=n.extractFrontmatterData(r);return o.title&&typeof o.title=="string"?o.title:v(e)}catch(r){if(i)throw new b(`Failed to read file for title derivation at ${t}: ${e}`,t,e,r);return v(e)}}function O(e){return W(e.navigation)}function W(e){for(const t of e)if(!t.title||!t.slug||t.children&&W(t.children))return!0;return!1}exports.BreadcrumbItemSchema=n.BreadcrumbItemSchema;exports.DocPageMetaSchema=n.DocPageMetaSchema;exports.DocPageSchema=n.DocPageSchema;exports.DocsPackageManifestInputSchema=n.DocsPackageManifestInputSchema;exports.DocsPackageManifestSchema=n.DocsPackageManifestSchema;exports.FlatNavigationNodeSchema=n.FlatNavigationNodeSchema;exports.FrontmatterParseError=n.FrontmatterParseError;exports.GitHubConfigSchema=n.GitHubConfigSchema;exports.LoadedDocsPackageSchema=n.LoadedDocsPackageSchema;exports.ManifestValidationError=n.ManifestValidationError;exports.NavigationNodeInputSchema=n.NavigationNodeInputSchema;exports.NavigationNodeSchema=n.NavigationNodeSchema;exports.SearchConfigSchema=n.SearchConfigSchema;exports.VendureVersionSchema=n.VendureVersionSchema;exports.buildBreadcrumbs=n.buildBreadcrumbs;exports.extractFrontmatterData=n.extractFrontmatterData;exports.findNavigationNode=n.findNavigationNode;exports.flattenNavigation=n.flattenNavigation;exports.getLeafNodes=n.getLeafNodes;exports.getNodesAtDepth=n.getNodesAtDepth;exports.getPrevNextNodes=n.getPrevNextNodes;exports.hasFrontmatter=n.hasFrontmatter;exports.isNodeActive=n.isNodeActive;exports.parseFrontmatter=n.parseFrontmatter;exports.validateFrontmatter=n.validateFrontmatter;exports.validateManifest=n.validateManifest;exports.ManifestResolutionError=b;exports.createNavigationFromFolder=B;exports.createNestedNavigationFromFolder=T;exports.getAllFilePaths=j;exports.manifestNeedsResolution=O;exports.resolveManifest=U;exports.slugFromFilename=F;exports.titleFromFilename=v;exports.toSlug=C;

package/dist/index.d.ts

@@ -1,8 +1,13 @@
-export type { BreadcrumbItem, DocPage, DocPageMeta, DocsPackageManifest, FlatNavigationNode, GitHubConfig, LoadedDocsPackage, NavigationNode, SearchConfig, VendureVersion, } from './types';
-export { BreadcrumbItemSchema, DocPageMetaSchema, DocPageSchema, DocsPackageManifestSchema, FlatNavigationNodeSchema, GitHubConfigSchema, LoadedDocsPackageSchema, NavigationNodeSchema, SearchConfigSchema, VendureVersionSchema, } from './schema';
+export type { BreadcrumbItem, DocPage, DocPageMeta, DocsPackageManifest, DocsPackageManifestInput, FlatNavigationNode, GitHubConfig, LoadedDocsPackage, NavigationNode, NavigationNodeInput, SearchConfig, VendureVersion, } from './types';
+export { BreadcrumbItemSchema, DocPageMetaSchema, DocPageSchema, DocsPackageManifestInputSchema, DocsPackageManifestSchema, FlatNavigationNodeSchema, GitHubConfigSchema, LoadedDocsPackageSchema, NavigationNodeInputSchema, NavigationNodeSchema, SearchConfigSchema, VendureVersionSchema, } from './schema';
 export { FrontmatterParseError, extractFrontmatterData, hasFrontmatter, parseFrontmatter, validateFrontmatter, } from './frontmatter';
 export type { ParsedFrontmatter } from './frontmatter';
 export { ManifestValidationError, buildBreadcrumbs, findNavigationNode, flattenNavigation, getLeafNodes, getNodesAtDepth, getPrevNextNodes, isNodeActive, validateManifest, } from './manifest';
 export { getAllFilePaths } from './navigation-utils';
-export type { CustomFieldPropertyProps, GenerationInfoProps, GraphQLDocProps, MdxComponentProps, MemberDescriptionProps, MemberInfoProps, StackblitzProps, } from './mdx-components';
+export type { CustomFieldPropertyProps, GenerationInfoProps, GraphQLDocProps, LinkCardProps, MdxComponentProps, MemberDescriptionProps, MemberInfoProps, StackblitzProps, } from './mdx-components';
+export { slugFromFilename, titleFromFilename, toSlug } from './slug-utils';
+export { createNavigationFromFolder, createNestedNavigationFromFolder } from './folder-utils';
+export type { CreateNavigationFromFolderOptions, CreateNestedNavigationFromFolderOptions, FileInfo, } from './folder-utils';
+export { ManifestResolutionError, manifestNeedsResolution, resolveManifest, } from './manifest-resolver';
+export type { ResolveManifestOptions } from './manifest-resolver';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,cAAc,EACd,OAAO,EACP,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAGtD,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGpD,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,cAAc,EACd,OAAO,EACP,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,cAAc,GACf,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,8BAA8B,EAC9B,yBAAyB,EACzB,wBAAwB,EACxB,kBAAkB,EAClB,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,UAAU,CAAA;AAGjB,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAGtD,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAGpD,YAAY,EACV,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EACtB,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAG1E,OAAO,EAAE,0BAA0B,EAAE,gCAAgC,EAAE,MAAM,gBAAgB,CAAA;AAC7F,YAAY,EACV,iCAAiC,EACjC,uCAAuC,EACvC,QAAQ,GACT,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/index.js

@@ -1,36 +1,245 @@
-import { B as n, D as c, a as d, b as m, F as h, c as f, G as l, L as g, M as N, N as S, S as v, V as u, d as F, e as P, f as D, g as p, i as b, j as M, k as x, h as V, l as k, p as A, v as B, m as L } from "./manifest-BJ3t6hu2.js";
-function o(t) {
-  const a = [];
-  return s(t.navigation, a), a;
+var R = Object.defineProperty;
+var A = (e, t, r) => t in e ? R(e, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : e[t] = r;
+var g = (e, t, r) => A(e, typeof t != "symbol" ? t + "" : t, r);
+import { e as P } from "./manifest-CVIfw0ha.js";
+import { B as te, D as ie, a as re, b as ne, c as oe, F as se, f as ae, G as le, L as ce, M as fe, N as de, d as ue, S as me, V as he, g as ge, i as ve, j as Fe, k as Ne, l as xe, m as pe, h as Se, n as we, p as be, v as ye, o as $e } from "./manifest-CVIfw0ha.js";
+import { readdirSync as C, readFileSync as D, statSync as B } from "fs";
+import { join as v } from "path";
+function K(e) {
+  const t = [];
+  return M(e.navigation, t), t;
 }
-function s(t, a) {
-  for (const e of t)
-    e.file && a.push(e.file), e.children && s(e.children, a);
+function M(e, t) {
+  for (const r of e)
+    r.file && t.push(r.file), r.children && M(r.children, t);
+}
+function T(e) {
+  return e.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+function F(e) {
+  const i = (e.split("/").pop() || e).replace(/\.(mdx?|md)$/i, "").replace(/^\d+-/, "");
+  return T(i);
+}
+function N(e) {
+  return (e.split("/").pop() || e).replace(/\.(mdx?|md)$/i, "").replace(/^\d+-/, "").replace(/[-_]+/g, " ").toLowerCase().replace(/\b\w/g, (n) => n.toUpperCase()).trim();
+}
+const I = (e, t) => e.order !== t.order ? e.order - t.order : e.title.localeCompare(t.title);
+function O(e, t = {}) {
+  const { extensions: r = [".mdx", ".md"], filter: i, sort: n = I } = t, o = W(e, r);
+  return (i ? o.filter(i) : o).sort(n).map((f) => ({
+    title: f.title,
+    slug: f.slug,
+    file: f.path
+  }));
+}
+function Q(e, t = {}) {
+  return L(e, t, 0);
+}
+function L(e, t, r) {
+  const {
+    extensions: i = [".mdx", ".md"],
+    filter: n,
+    sort: o = I,
+    maxDepth: a = 1 / 0,
+    folderFilter: d
+  } = t, f = C(e, { withFileTypes: !0 }), u = [], y = W(e, i), x = (n ? y.filter(n) : y).sort(o);
+  for (const c of x)
+    u.push({
+      title: c.title,
+      slug: c.slug,
+      file: c.path
+    });
+  if (r < a) {
+    const c = f.filter((l) => l.isDirectory());
+    for (const l of c) {
+      if (d) {
+        const s = v(e, l.name);
+        if (!d(l.name, s))
+          continue;
+      }
+      const m = v(e, l.name), h = L(m, t, r + 1);
+      if (h.length > 0) {
+        const s = U(m, i);
+        u.push({
+          title: (s == null ? void 0 : s.title) || N(l.name),
+          slug: F(l.name),
+          file: s == null ? void 0 : s.path,
+          children: h.filter((p) => !(s && p.file === s.path))
+        });
+      }
+    }
+  }
+  return u.sort((c, l) => {
+    var $, E;
+    const m = x.find((S) => S.slug === c.slug), h = x.find((S) => S.slug === l.slug);
+    if (m && h)
+      return o(m, h);
+    const s = !!c.file && !(($ = c.children) != null && $.length), p = !!l.file && !((E = l.children) != null && E.length);
+    return s !== p ? s ? -1 : 1 : (c.title || "").localeCompare(l.title || "");
+  });
+}
+function W(e, t) {
+  try {
+    const r = C(e, { withFileTypes: !0 }), i = [];
+    for (const n of r) {
+      if (!n.isFile()) continue;
+      const o = t.find((u) => n.name.toLowerCase().endsWith(u));
+      if (!o || n.name.slice(0, -o.length).toLowerCase() === "index") continue;
+      const d = v(e, n.name), f = V(d, n.name, o);
+      i.push(f);
+    }
+    return i;
+  } catch {
+    return [];
+  }
+}
+function V(e, t, r) {
+  let i = {}, n = N(t), o = 1 / 0;
+  try {
+    const a = D(e, "utf-8");
+    i = P(a), i.title && typeof i.title == "string" && (n = i.title), typeof i.order == "number" && (o = i.order);
+  } catch {
+  }
+  return {
+    path: e,
+    filename: t,
+    extension: r,
+    frontmatter: i,
+    order: o,
+    title: n,
+    slug: F(t)
+  };
+}
+function U(e, t) {
+  for (const r of t) {
+    const i = v(e, `index${r}`);
+    try {
+      if (B(i).isFile())
+        return V(i, `index${r}`, r);
+    } catch {
+    }
+  }
+}
+class w extends Error {
+  constructor(r, i, n, o) {
+    super(r);
+    g(this, "nodePath");
+    g(this, "filePath");
+    g(this, "originalError");
+    this.name = "ManifestResolutionError", this.nodePath = i, this.filePath = n, this.originalError = o;
+  }
+}
+function X(e, t = {}) {
+  const { strict: r = !0 } = t, i = b(e.navigation, "", r);
+  return {
+    id: e.id,
+    name: e.name,
+    version: e.version,
+    vendureVersion: e.vendureVersion,
+    navigation: i,
+    search: e.search,
+    github: e.github,
+    basePath: e.basePath
+  };
+}
+function b(e, t, r) {
+  return e.map((i, n) => j(i, t, n, r));
+}
+function j(e, t, r, i) {
+  const n = t ? `${t}[${r}]` : `navigation[${r}]`;
+  if (e.title && e.slug)
+    return {
+      title: e.title,
+      slug: e.slug,
+      file: e.file,
+      children: e.children ? b(e.children, `${n}.children`, i) : void 0,
+      badge: e.badge
+    };
+  let o = e.title, a = e.slug;
+  if (e.file && (a || (a = F(e.file)), o || (o = G(e.file, n, i))), !o) {
+    if (i)
+      throw new w(
+        `Navigation node at ${n} is missing title and has no file to derive it from`,
+        n,
+        e.file
+      );
+    o = a || `Unknown (${r})`;
+  }
+  if (!a) {
+    if (i)
+      throw new w(
+        `Navigation node at ${n} is missing slug and has no file to derive it from`,
+        n,
+        e.file
+      );
+    a = o ? F(o) : `node-${r}`;
+  }
+  return {
+    title: o,
+    slug: a,
+    file: e.file,
+    children: e.children ? b(e.children, `${n}.children`, i) : void 0,
+    badge: e.badge
+  };
+}
+function G(e, t, r) {
+  try {
+    const i = D(e, "utf-8"), n = P(i);
+    return n.title && typeof n.title == "string" ? n.title : N(e);
+  } catch (i) {
+    if (r)
+      throw new w(
+        `Failed to read file for title derivation at ${t}: ${e}`,
+        t,
+        e,
+        i
+      );
+    return N(e);
+  }
+}
+function Y(e) {
+  return k(e.navigation);
+}
+function k(e) {
+  for (const t of e)
+    if (!t.title || !t.slug || t.children && k(t.children))
+      return !0;
+  return !1;
 }
 export {
-  n as BreadcrumbItemSchema,
-  c as DocPageMetaSchema,
-  d as DocPageSchema,
-  m as DocsPackageManifestSchema,
-  h as FlatNavigationNodeSchema,
-  f as FrontmatterParseError,
-  l as GitHubConfigSchema,
-  g as LoadedDocsPackageSchema,
-  N as ManifestValidationError,
-  S as NavigationNodeSchema,
-  v as SearchConfigSchema,
-  u as VendureVersionSchema,
-  F as buildBreadcrumbs,
+  te as BreadcrumbItemSchema,
+  ie as DocPageMetaSchema,
+  re as DocPageSchema,
+  ne as DocsPackageManifestInputSchema,
+  oe as DocsPackageManifestSchema,
+  se as FlatNavigationNodeSchema,
+  ae as FrontmatterParseError,
+  le as GitHubConfigSchema,
+  ce as LoadedDocsPackageSchema,
+  w as ManifestResolutionError,
+  fe as ManifestValidationError,
+  de as NavigationNodeInputSchema,
+  ue as NavigationNodeSchema,
+  me as SearchConfigSchema,
+  he as VendureVersionSchema,
+  ge as buildBreadcrumbs,
+  O as createNavigationFromFolder,
+  Q as createNestedNavigationFromFolder,
   P as extractFrontmatterData,
-  D as findNavigationNode,
-  p as flattenNavigation,
-  o as getAllFilePaths,
-  b as getLeafNodes,
-  M as getNodesAtDepth,
-  x as getPrevNextNodes,
-  V as hasFrontmatter,
-  k as isNodeActive,
-  A as parseFrontmatter,
-  B as validateFrontmatter,
-  L as validateManifest
+  ve as findNavigationNode,
+  Fe as flattenNavigation,
+  K as getAllFilePaths,
+  Ne as getLeafNodes,
+  xe as getNodesAtDepth,
+  pe as getPrevNextNodes,
+  Se as hasFrontmatter,
+  we as isNodeActive,
+  Y as manifestNeedsResolution,
+  be as parseFrontmatter,
+  X as resolveManifest,
+  F as slugFromFilename,
+  N as titleFromFilename,
+  T as toSlug,
+  ye as validateFrontmatter,
+  $e as validateManifest
 };

package/dist/loader.cjs

@@ -1 +1 @@
-"use strict";var g=Object.defineProperty;var h=(e,r,t)=>r in e?g(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t;var i=(e,r,t)=>h(e,typeof r!="symbol"?r+"":r,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const P=require("fs/promises"),m=require("module"),u=require("./manifest-CNnJGNwK.cjs");var c=typeof document<"u"?document.currentScript:null;class a extends Error{constructor(t,n){super(t);i(this,"packageName");this.name="DocsPackageLoadError",this.packageName=n}}async function p(e,r={}){try{const t=r.resolver?await r.resolver(e):l(e),n=await import(e);if(!n.manifest)throw new a(`Package "${e}" does not export a manifest`,e);return{manifest:u.validateManifest(n.manifest),basePath:t}}catch(t){throw t instanceof a?t:new a(`Failed to load docs package "${e}": ${t instanceof Error?t.message:String(t)}`,e)}}function l(e){try{return m.createRequire(typeof document>"u"?require("url").pathToFileURL(__filename).href:c&&c.tagName.toUpperCase()==="SCRIPT"&&c.src||new URL("loader.cjs",document.baseURI).href).resolve(`${e}/package.json`).replace(/\/package\.json$/,"")}catch{throw new a(`Cannot resolve package "${e}". Make sure it is installed.`,e)}}async function d(e,r){try{const t=`${e.basePath}/${r}`,n=await P.readFile(t,"utf-8"),{meta:o,content:s}=u.parseFrontmatter(n,r);return{meta:o,content:s,filePath:r}}catch(t){throw new a(`Failed to load doc page "${r}": ${t instanceof Error?t.message:String(t)}`,e.manifest.id)}}async function $(e,r){const t=f(e.manifest.navigation,r.split("/"));if(t!=null&&t.file)return d(e,t.file)}function f(e,r){if(r.length===0)return;const[t,...n]=r,o=e.find(s=>s.slug===t);if(o){if(n.length===0)return o;if(o.children)return f(o.children,n)}}function v(e,r){if(r.file)return`${e.basePath}/${r.file}`}function y(e){try{return l(e),!0}catch{return!1}}exports.DocsPackageLoadError=a;exports.isDocsPackageInstalled=y;exports.loadDocPage=d;exports.loadDocPageBySlug=$;exports.loadDocsPackage=p;exports.resolveFilePath=v;
+"use strict";var g=Object.defineProperty;var h=(e,r,t)=>r in e?g(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t;var i=(e,r,t)=>h(e,typeof r!="symbol"?r+"":r,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const P=require("fs/promises"),m=require("module"),u=require("./manifest-BYUKRuRu.cjs");var c=typeof document<"u"?document.currentScript:null;class a extends Error{constructor(t,n){super(t);i(this,"packageName");this.name="DocsPackageLoadError",this.packageName=n}}async function p(e,r={}){try{const t=r.resolver?await r.resolver(e):l(e),n=await import(e);if(!n.manifest)throw new a(`Package "${e}" does not export a manifest`,e);return{manifest:u.validateManifest(n.manifest),basePath:t}}catch(t){throw t instanceof a?t:new a(`Failed to load docs package "${e}": ${t instanceof Error?t.message:String(t)}`,e)}}function l(e){try{return m.createRequire(typeof document>"u"?require("url").pathToFileURL(__filename).href:c&&c.tagName.toUpperCase()==="SCRIPT"&&c.src||new URL("loader.cjs",document.baseURI).href).resolve(`${e}/package.json`).replace(/\/package\.json$/,"")}catch{throw new a(`Cannot resolve package "${e}". Make sure it is installed.`,e)}}async function d(e,r){try{const t=`${e.basePath}/${r}`,n=await P.readFile(t,"utf-8"),{meta:o,content:s}=u.parseFrontmatter(n,r);return{meta:o,content:s,filePath:r}}catch(t){throw new a(`Failed to load doc page "${r}": ${t instanceof Error?t.message:String(t)}`,e.manifest.id)}}async function $(e,r){const t=f(e.manifest.navigation,r.split("/"));if(t!=null&&t.file)return d(e,t.file)}function f(e,r){if(r.length===0)return;const[t,...n]=r,o=e.find(s=>s.slug===t);if(o){if(n.length===0)return o;if(o.children)return f(o.children,n)}}function v(e,r){if(r.file)return`${e.basePath}/${r.file}`}function y(e){try{return l(e),!0}catch{return!1}}exports.DocsPackageLoadError=a;exports.isDocsPackageInstalled=y;exports.loadDocPage=d;exports.loadDocPageBySlug=$;exports.loadDocsPackage=p;exports.resolveFilePath=v;

package/dist/loader.js

@@ -3,7 +3,7 @@ var l = (t, e, r) => e in t ? f(t, e, { enumerable: !0, configurable: !0, writab
 var i = (t, e, r) => l(t, typeof e != "symbol" ? e + "" : e, r);
 import { readFile as d } from "fs/promises";
 import { createRequire as h } from "module";
-import { m as g, p as m } from "./manifest-BJ3t6hu2.js";
+import { o as g, p as m } from "./manifest-CVIfw0ha.js";
 class a extends Error {
   constructor(r, n) {
     super(r);

package/dist/manifest-BYUKRuRu.cjs

@@ -0,0 +1,3 @@
+"use strict";var $=Object.defineProperty;var k=(r,e,n)=>e in r?$(r,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):r[e]=n;var l=(r,e,n)=>k(r,typeof e!="symbol"?e+"":e,n);const b=require("gray-matter"),t=require("zod"),u=t.z.enum(["v1","v2","v3"]),m=t.z.object({indexFields:t.z.array(t.z.enum(["title","description","content","keywords"])),boosts:t.z.record(t.z.string(),t.z.number()).optional()}),h=t.z.object({repository:t.z.string().regex(/^[^/]+\/[^/]+$/,'Repository must be in format "owner/repo"'),branch:t.z.string().optional(),docsPath:t.z.string().optional()}),g=t.z.lazy(()=>t.z.object({title:t.z.string().min(1,"Navigation title is required"),slug:t.z.string().min(1,"Navigation slug is required"),file:t.z.string().optional(),children:t.z.array(g).optional(),badge:t.z.string().optional()})),f=t.z.object({id:t.z.string().min(1,"Package ID is required"),name:t.z.string().min(1,"Package name is required"),version:t.z.string().regex(/^\d+\.\d+\.\d+/,"Version must be valid semver"),vendureVersion:u,navigation:t.z.array(g),search:m.optional(),github:h.optional(),basePath:t.z.string().optional()}),z=t.z.object({title:t.z.string().min(1,"Page title is required"),description:t.z.string().optional(),keywords:t.z.array(t.z.string()).optional(),sidebarLabel:t.z.string().optional(),hidden:t.z.boolean().optional(),order:t.z.number().int().optional()}),x=t.z.object({meta:z,content:t.z.string(),filePath:t.z.string()}),M=t.z.object({manifest:f,basePath:t.z.string()}),I=t.z.object({title:t.z.string(),slug:t.z.string(),path:t.z.string()}),V=t.z.object({title:t.z.string(),slug:t.z.string(),file:t.z.string().optional(),children:t.z.array(t.z.lazy(()=>g)).optional(),badge:t.z.string().optional(),path:t.z.string(),depth:t.z.number().int().min(0),parentPath:t.z.string().optional()}),p=t.z.lazy(()=>t.z.object({title:t.z.string().min(1).optional(),slug:t.z.string().min(1).optional(),file:t.z.string().optional(),children:t.z.array(p).optional(),badge:t.z.string().optional()})),w=t.z.object({id:t.z.string().min(1,"Package ID is required"),name:t.z.string().min(1,"Package name is required"),version:t.z.string().regex(/^\d+\.\d+\.\d+/,"Version must be valid semver"),vendureVersion:u,navigation:t.z.array(p),search:m.optional(),github:h.optional(),basePath:t.z.string().optional()});class d extends Error{constructor(n,i,a){super(n);l(this,"filePath");l(this,"originalError");this.name="FrontmatterParseError",this.filePath=i,this.originalError=a}}function E(r,e){try{const{data:n,content:i}=b(r);return{meta:N(n,e),content:i.trim()}}catch(n){throw n instanceof d?n:new d(`Failed to parse frontmatter${e?` in ${e}`:""}`,e,n)}}function N(r,e){const n=z.safeParse(r);if(!n.success){const i=n.error.issues.map(a=>`  - ${a.path.join(".")}: ${a.message}`).join(`
+`);throw new d(`Invalid frontmatter${e?` in ${e}`:""}:
+${i}`,e,n.error)}return n.data}function q(r){return r.trimStart().startsWith("---")}function B(r){const{data:e}=b(r);return e}class S extends Error{constructor(n,i){super(n);l(this,"issues");this.name="ManifestValidationError",this.issues=i}}function L(r){const e=f.safeParse(r);if(!e.success){const n=e.error.issues.map(i=>`${i.path.join(".")}: ${i.message}`);throw new S("Invalid manifest",n)}return e.data}function A(r,e){const n=e.split("/").filter(Boolean);return P(r.navigation,n)}function P(r,e){if(e.length===0)return;const[n,...i]=e,a=r.find(o=>o.slug===n);if(a){if(i.length===0)return a;if(a.children)return P(a.children,i)}}function v(r){const e=[];return y(r.navigation,"",0,void 0,e),e}function y(r,e,n,i,a){for(const o of r){const s=e?`${e}/${o.slug}`:o.slug;a.push({...o,path:s,depth:n,parentPath:i}),o.children&&o.children.length>0&&y(o.children,s,n+1,s,a)}}function C(r,e){const n=e.split("/").filter(Boolean),i=[];let a=r.navigation,o="";for(const s of n){const c=a.find(F=>F.slug===s);if(!c)break;o=o?`${o}/${s}`:s,i.push({title:c.title,slug:c.slug,path:o}),a=c.children??[]}return i}function D(r){return v(r).filter(e=>e.file!==void 0)}function G(r,e){const n=D(r),i=n.findIndex(a=>a.path===e);return i===-1?{}:{prev:i>0?n[i-1]:void 0,next:i<n.length-1?n[i+1]:void 0}}function j(r,e){const n=e.split("/").filter(Boolean);if(n.length===0)return!1;if(r.slug===n[0]){if(n.length===1)return!0;if(r.children){const i=n.slice(1).join("/");return r.children.some(a=>j(a,i))}}return!1}function H(r,e){return v(r).filter(n=>n.depth===e)}exports.BreadcrumbItemSchema=I;exports.DocPageMetaSchema=z;exports.DocPageSchema=x;exports.DocsPackageManifestInputSchema=w;exports.DocsPackageManifestSchema=f;exports.FlatNavigationNodeSchema=V;exports.FrontmatterParseError=d;exports.GitHubConfigSchema=h;exports.LoadedDocsPackageSchema=M;exports.ManifestValidationError=S;exports.NavigationNodeInputSchema=p;exports.NavigationNodeSchema=g;exports.SearchConfigSchema=m;exports.VendureVersionSchema=u;exports.buildBreadcrumbs=C;exports.extractFrontmatterData=B;exports.findNavigationNode=A;exports.flattenNavigation=v;exports.getLeafNodes=D;exports.getNodesAtDepth=H;exports.getPrevNextNodes=G;exports.hasFrontmatter=q;exports.isNodeActive=j;exports.parseFrontmatter=E;exports.validateFrontmatter=N;exports.validateManifest=L;