@vendure-io/docs-provider 0.4.0 → 0.5.0

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAE/C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,WAAW,EAAE,CAAC,OAAO,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,CAAC,EAAE,CAAA;IACjE,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oCAAoC;IACpC,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAA;IAC3B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAA;IACV,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,cAAc,EAAE,cAAc,CAAA;IAC9B,2CAA2C;IAC3C,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,kFAAkF;IAClF,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,iDAAiD;IACjD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,kCAAkC;IAClC,IAAI,EAAE,WAAW,CAAA;IACjB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,eAAe;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAA;IACb,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oCAAoC;IACpC,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAA;IAChC,+DAA+D;IAC/D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAA;IACV,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,cAAc,EAAE,cAAc,CAAA;IAC9B,sEAAsE;IACtE,UAAU,EAAE,mBAAmB,EAAE,CAAA;IACjC,0CAA0C;IAC1C,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,kFAAkF;IAClF,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB"}

package/docs/manifest-reference.md

@@ -73,18 +73,39 @@ interface NavigationNode {
   file?: string
   children?: NavigationNode[]
   badge?: string
+  hidden?: boolean
 }
 ```
 
 ### Properties
 
-| Property   | Type               | Required | Description                                          |
-| ---------- | ------------------ | -------- | ---------------------------------------------------- |
-| `title`    | `string`           | Yes      | Display title shown in navigation                    |
-| `slug`     | `string`           | Yes      | URL slug for this node                               |
-| `file`     | `string`           | No       | Absolute path to MDX file (leaf nodes only)          |
-| `children` | `NavigationNode[]` | No       | Nested child navigation nodes                        |
-| `badge`    | `string`           | No       | Optional badge label (e.g., `"New"`, `"Deprecated"`) |
+| Property   | Type               | Required | Description                                                          |
+| ---------- | ------------------ | -------- | -------------------------------------------------------------------- |
+| `title`    | `string`           | Yes      | Display title shown in navigation                                    |
+| `slug`     | `string`           | Yes      | URL slug for this node                                               |
+| `file`     | `string`           | No       | Absolute path to MDX file (leaf nodes only)                          |
+| `children` | `NavigationNode[]` | No       | Nested child navigation nodes                                        |
+| `badge`    | `string`           | No       | Optional badge label (e.g., `"New"`, `"Deprecated"`)                 |
+| `hidden`   | `boolean`          | No       | Hide this node from sidebar navigation (page remains URL-accessible) |
+
+### Hidden Pages
+
+Use the `hidden` property to exclude pages from the sidebar while keeping them accessible via direct URL. This is useful for:
+
+- Draft or work-in-progress pages
+- Pages that should only be linked to from specific contexts
+- Decluttering the navigation while keeping content accessible
+
+```typescript
+{
+  title: 'Internal Notes',
+  slug: 'internal-notes',
+  file: file('docs/internal-notes.mdx'),
+  hidden: true,  // Won't appear in sidebar, but /docs/internal-notes still works
+}
+```
+
+When a parent node is hidden, all its children are also hidden from the sidebar.
 
 ---
 
@@ -99,6 +120,7 @@ interface NavigationNodeInput {
   file?: string
   children?: NavigationNodeInput[]
   badge?: string
+  hidden?: boolean // Hide from sidebar navigation
 }
 ```
 
@@ -479,6 +501,7 @@ interface FlatNavigationNode extends NavigationNode {
   path: string // Full path from root (e.g., "getting-started/installation")
   depth: number // Depth level (0 = root)
   parentPath?: string // Parent node's path, if any
+  // Also inherits: title, slug, file?, children?, badge?, hidden?
 }
 ```
 
@@ -649,6 +672,61 @@ const files = getAllFilePaths(manifest)
 
 ---
 
+### filterVisibleNavigation
+
+Filter navigation nodes to only include visible items (not hidden). Use this when rendering sidebar navigation to exclude hidden pages while keeping them URL-accessible.
+
+```typescript
+function filterVisibleNavigation(nodes: NavigationNode[]): NavigationNode[]
+```
+
+**Parameters:**
+
+- `nodes` - Array of navigation nodes to filter
+
+**Returns:** Filtered array with hidden nodes (and their children) removed
+
+**Example:**
+
+```typescript
+import { filterVisibleNavigation } from '@vendure-io/docs-provider/browser'
+
+// Filter out hidden nodes before rendering sidebar
+const visibleNavigation = filterVisibleNavigation(manifest.navigation)
+
+// Use visibleNavigation for sidebar rendering
+// Hidden pages remain accessible via direct URL
+```
+
+**Behavior Notes:**
+
+- Hidden nodes are completely removed from the result
+- When a parent node is hidden, all its children are also excluded
+- The original navigation structure is unmodified (returns a new array)
+- Use the `/browser` entry point for client components to avoid bundling Node.js modules
+
+---
+
+## Browser Entry Point
+
+For client-side components (React components with `'use client'`), import from the `/browser` entry point to avoid bundling Node.js modules:
+
+```typescript
+// In client components
+import { filterVisibleNavigation, type NavigationNode } from '@vendure-io/docs-provider/browser'
+
+// The /browser entry exports all browser-safe utilities:
+// - Types (NavigationNode, DocsPackageManifest, etc.)
+// - Schemas (NavigationNodeSchema, etc.)
+// - filterVisibleNavigation, getAllFilePaths
+// - Manifest utilities (findNavigationNode, flattenNavigation, etc.)
+// - Slug utilities (toSlug, slugFromFilename, etc.)
+```
+
+The main entry point (`@vendure-io/docs-provider`) includes Node.js-only utilities like `resolveManifest` and `createNavigationFromFolder` which require `fs` access.
+
+---
+
 ## Error Classes
 
 ### ManifestValidationError

package/docs/mdx-components-reference.md

@@ -75,6 +75,51 @@ A card-style link that provides more visual prominence than a standard link. Use
 </LinkCard>
 ```
 
+### DocsLink
+
+An inline link component that automatically prefixes relative URLs with the current documentation version and package ID. This is the recommended way to create cross-references in generated documentation.
+
+**Key features:**
+
+- Relative paths (starting with `/`) are automatically prefixed with `/{version}/{packageId}`
+- Uses Next.js `Link` for client-side navigation (no full page reload)
+- External links (`http://`, `https://`) open in a new tab
+- Ideal for documentation generators that don't know the runtime context
+
+#### Props
+
+| Prop       | Type        | Required | Description                                            |
+| ---------- | ----------- | -------- | ------------------------------------------------------ |
+| `href`     | `string`    | Yes      | URL to navigate to (relative paths will be prefixed)   |
+| `children` | `ReactNode` | Yes      | Link text content                                      |
+
+#### Example
+
+```mdx
+{/* Simple type reference - will become /current/core/reference/typescript-api/request/request-context */}
+See the <DocsLink href="/reference/typescript-api/request/request-context">RequestContext</DocsLink> documentation.
+
+{/* With anchor */}
+Check the <DocsLink href="/reference/typescript-api/entities/product#variants">Product.variants</DocsLink> property.
+
+{/* External links work as expected */}
+Visit the <DocsLink href="https://github.com/vendure-ecommerce/vendure">GitHub repository</DocsLink>.
+```
+
+#### Usage in Generators
+
+When generating documentation, use `DocsLink` for all cross-references instead of raw HTML anchor tags:
+
+```typescript
+// Instead of:
+const typeHtml = `<a href='/reference/typescript-api/request/request-context'>RequestContext</a>`
+
+// Generate:
+const typeMdx = `<DocsLink href="/reference/typescript-api/request/request-context">RequestContext</DocsLink>`
+```
+
+The `DocsLink` component handles URL prefixing at render time, so generators don't need to know the version or package context.
+
 ---
 
 ## Reference Documentation Components
@@ -368,6 +413,7 @@ import type {
   GenerationInfoProps,
   GraphQLDocProps,
   LinkCardProps,
+  DocsLinkProps,
   MemberInfoProps,
   MemberDescriptionProps,
   CustomFieldPropertyProps,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vendure-io/docs-provider",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Contract types and utilities for Vendure documentation packages",
   "private": false,
   "publishConfig": {
@@ -21,6 +21,16 @@
         "default": "./dist/index.cjs"
       }
     },
+    "./browser": {
+      "import": {
+        "types": "./dist/browser.d.ts",
+        "default": "./dist/browser.js"
+      },
+      "require": {
+        "types": "./dist/browser.d.ts",
+        "default": "./dist/browser.cjs"
+      }
+    },
     "./loader": {
       "import": {
         "types": "./dist/loader.d.ts",

package/dist/manifest-BYUKRuRu.cjs

@@ -1,3 +0,0 @@
-"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;

package/dist/manifest-CVIfw0ha.js

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