@vendure-io/docs-provider 0.5.0 → 0.6.0

package/dist/browser.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./manifest-D8kEDc9X.cjs"),a=require("./slug-utils-DUQgikEz.cjs");exports.BreadcrumbItemSchema=e.BreadcrumbItemSchema;exports.DocPageMetaSchema=e.DocPageMetaSchema;exports.DocPageSchema=e.DocPageSchema;exports.DocsPackageManifestInputSchema=e.DocsPackageManifestInputSchema;exports.DocsPackageManifestSchema=e.DocsPackageManifestSchema;exports.FlatNavigationNodeSchema=e.FlatNavigationNodeSchema;exports.GitHubConfigSchema=e.GitHubConfigSchema;exports.LoadedDocsPackageSchema=e.LoadedDocsPackageSchema;exports.ManifestValidationError=e.ManifestValidationError;exports.NavigationNodeInputSchema=e.NavigationNodeInputSchema;exports.NavigationNodeSchema=e.NavigationNodeSchema;exports.SearchConfigSchema=e.SearchConfigSchema;exports.VendureVersionSchema=e.VendureVersionSchema;exports.buildBreadcrumbs=e.buildBreadcrumbs;exports.findNavigationNode=e.findNavigationNode;exports.flattenNavigation=e.flattenNavigation;exports.getLeafNodes=e.getLeafNodes;exports.getNodesAtDepth=e.getNodesAtDepth;exports.getPrevNextNodes=e.getPrevNextNodes;exports.isNodeActive=e.isNodeActive;exports.validateManifest=e.validateManifest;exports.filterVisibleNavigation=a.filterVisibleNavigation;exports.getAllFilePaths=a.getAllFilePaths;exports.slugFromFilename=a.slugFromFilename;exports.titleFromFilename=a.titleFromFilename;exports.toSlug=a.toSlug;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./manifest-D-EWZlSh.cjs"),a=require("./slug-utils-DUQgikEz.cjs");exports.BreadcrumbItemSchema=e.BreadcrumbItemSchema;exports.DocPageMetaSchema=e.DocPageMetaSchema;exports.DocPageSchema=e.DocPageSchema;exports.DocsPackageManifestInputSchema=e.DocsPackageManifestInputSchema;exports.DocsPackageManifestSchema=e.DocsPackageManifestSchema;exports.FlatNavigationNodeSchema=e.FlatNavigationNodeSchema;exports.GitHubConfigSchema=e.GitHubConfigSchema;exports.LoadedDocsPackageSchema=e.LoadedDocsPackageSchema;exports.ManifestValidationError=e.ManifestValidationError;exports.NavigationNodeInputSchema=e.NavigationNodeInputSchema;exports.NavigationNodeSchema=e.NavigationNodeSchema;exports.SearchConfigSchema=e.SearchConfigSchema;exports.VendureVersionSchema=e.VendureVersionSchema;exports.buildBreadcrumbs=e.buildBreadcrumbs;exports.findNavigationNode=e.findNavigationNode;exports.flattenNavigation=e.flattenNavigation;exports.getLeafNodes=e.getLeafNodes;exports.getNodesAtDepth=e.getNodesAtDepth;exports.getPrevNextNodes=e.getPrevNextNodes;exports.isNodeActive=e.isNodeActive;exports.validateManifest=e.validateManifest;exports.filterVisibleNavigation=a.filterVisibleNavigation;exports.getAllFilePaths=a.getAllFilePaths;exports.slugFromFilename=a.slugFromFilename;exports.titleFromFilename=a.titleFromFilename;exports.toSlug=a.toSlug;

package/dist/browser.js

@@ -1,4 +1,4 @@
-import { B as s, D as t, a as i, b as o, c, F as g, G as m, L as n, M as d, N as r, d as h, S as N, V as l, e as S, f, g as v, h as u, i as D, j as F, k as P, v as b } from "./manifest-B_cvT6F9.js";
+import { B as s, D as t, a as i, b as o, c, F as g, G as m, L as n, M as d, N as r, d as h, S as N, V as l, e as S, f, g as v, h as u, i as D, j as F, k as P, v as b } from "./manifest-ZCrzbFSf.js";
 import { f as p, g as V, s as k, t as x, a as A } from "./slug-utils-DVKYe9h8.js";
 export {
   s as BreadcrumbItemSchema,

package/dist/{frontmatter-8Bwpoi8r.js → frontmatter-C0Wmtdep.js}

@@ -2,7 +2,7 @@ var c = Object.defineProperty;
 var m = (a, t, r) => t in a ? c(a, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : a[t] = r;
 var o = (a, t, r) => m(a, typeof t != "symbol" ? t + "" : t, r);
 import i from "gray-matter";
-import { D as u } from "./manifest-B_cvT6F9.js";
+import { D as u } from "./manifest-ZCrzbFSf.js";
 class s extends Error {
   constructor(r, e, n) {
     super(r);

package/dist/{frontmatter-_wRoVeyd.cjs → frontmatter-CJYZSUYM.cjs}

@@ -1,3 +1,3 @@
-"use strict";var m=Object.defineProperty;var u=(a,t,r)=>t in a?m(a,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):a[t]=r;var s=(a,t,r)=>u(a,typeof t!="symbol"?t+"":t,r);const i=require("gray-matter"),d=require("./manifest-D8kEDc9X.cjs");class o extends Error{constructor(r,e,n){super(r);s(this,"filePath");s(this,"originalError");this.name="FrontmatterParseError",this.filePath=e,this.originalError=n}}function F(a,t){try{const{data:r,content:e}=i(a);return{meta:c(r,t),content:e.trim()}}catch(r){throw r instanceof o?r:new o(`Failed to parse frontmatter${t?` in ${t}`:""}`,t,r)}}function c(a,t){const r=d.DocPageMetaSchema.safeParse(a);if(!r.success){const e=r.error.issues.map(n=>`  - ${n.path.join(".")}: ${n.message}`).join(`
+"use strict";var m=Object.defineProperty;var u=(a,t,r)=>t in a?m(a,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):a[t]=r;var s=(a,t,r)=>u(a,typeof t!="symbol"?t+"":t,r);const i=require("gray-matter"),d=require("./manifest-D-EWZlSh.cjs");class o extends Error{constructor(r,e,n){super(r);s(this,"filePath");s(this,"originalError");this.name="FrontmatterParseError",this.filePath=e,this.originalError=n}}function F(a,t){try{const{data:r,content:e}=i(a);return{meta:c(r,t),content:e.trim()}}catch(r){throw r instanceof o?r:new o(`Failed to parse frontmatter${t?` in ${t}`:""}`,t,r)}}function c(a,t){const r=d.DocPageMetaSchema.safeParse(a);if(!r.success){const e=r.error.issues.map(n=>`  - ${n.path.join(".")}: ${n.message}`).join(`
 `);throw new o(`Invalid frontmatter${t?` in ${t}`:""}:
 ${e}`,t,r.error)}return r.data}function h(a){return a.trimStart().startsWith("---")}function f(a){const{data:t}=i(a);return t}exports.FrontmatterParseError=o;exports.extractFrontmatterData=f;exports.hasFrontmatter=h;exports.parseFrontmatter=F;exports.validateFrontmatter=c;

package/dist/index.cjs

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

package/dist/index.js

@@ -1,9 +1,9 @@
 var A = Object.defineProperty;
 var B = (e, t, i) => t in e ? A(e, t, { enumerable: !0, configurable: !0, writable: !0, value: i }) : e[t] = i;
 var m = (e, t, i) => B(e, typeof t != "symbol" ? t + "" : t, i);
-import { B as _, D as ee, a as te, b as re, c as ie, F as oe, G as ne, L as se, M as ae, N as le, d as ce, S as fe, V as de, e as he, f as ue, g as ge, h as me, i as ve, j as Fe, k as Ne, v as Se } from "./manifest-B_cvT6F9.js";
-import { e as M } from "./frontmatter-8Bwpoi8r.js";
-import { F as xe, h as be, p as $e, v as we } from "./frontmatter-8Bwpoi8r.js";
+import { B as _, D as ee, a as te, b as re, c as ie, F as oe, G as ne, L as se, M as ae, N as le, d as ce, S as fe, V as de, e as he, f as ue, g as ge, h as me, i as ve, j as Fe, k as Ne, v as Se } from "./manifest-ZCrzbFSf.js";
+import { e as M } from "./frontmatter-C0Wmtdep.js";
+import { F as xe, h as be, p as $e, v as we } from "./frontmatter-C0Wmtdep.js";
 import { s as v, t as F } from "./slug-utils-DVKYe9h8.js";
 import { f as Ee, g as Me, a as Ie } from "./slug-utils-DVKYe9h8.js";
 import { readdirSync as I, readFileSync as P, statSync as T } from "fs";

package/dist/loader.cjs

@@ -1 +1 @@
-"use strict";var f=Object.defineProperty;var g=(e,r,t)=>r in e?f(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t;var i=(e,r,t)=>g(e,typeof r!="symbol"?r+"":r,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("fs/promises"),P=require("module"),m=require("./frontmatter-_wRoVeyd.cjs"),p=require("./manifest-D8kEDc9X.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 $(e,r={}){try{const t=r.resolver?await r.resolver(e):u(e),n=await import(e);if(!n.manifest)throw new a(`Package "${e}" does not export a manifest`,e);return{manifest:p.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 u(e){try{return P.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 l(e,r){try{const t=`${e.basePath}/${r}`,n=await h.readFile(t,"utf-8"),{meta:o,content:s}=m.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 v(e,r){const t=d(e.manifest.navigation,r.split("/"));if(t!=null&&t.file)return l(e,t.file)}function d(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 d(o.children,n)}}function y(e,r){if(r.file)return`${e.basePath}/${r.file}`}function w(e){try{return u(e),!0}catch{return!1}}exports.DocsPackageLoadError=a;exports.isDocsPackageInstalled=w;exports.loadDocPage=l;exports.loadDocPageBySlug=v;exports.loadDocsPackage=$;exports.resolveFilePath=y;
+"use strict";var f=Object.defineProperty;var g=(e,r,t)=>r in e?f(e,r,{enumerable:!0,configurable:!0,writable:!0,value:t}):e[r]=t;var i=(e,r,t)=>g(e,typeof r!="symbol"?r+"":r,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("fs/promises"),P=require("module"),m=require("./frontmatter-CJYZSUYM.cjs"),p=require("./manifest-D-EWZlSh.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 $(e,r={}){try{const t=r.resolver?await r.resolver(e):u(e),n=await import(e);if(!n.manifest)throw new a(`Package "${e}" does not export a manifest`,e);return{manifest:p.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 u(e){try{return P.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 l(e,r){try{const t=`${e.basePath}/${r}`,n=await h.readFile(t,"utf-8"),{meta:o,content:s}=m.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 v(e,r){const t=d(e.manifest.navigation,r.split("/"));if(t!=null&&t.file)return l(e,t.file)}function d(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 d(o.children,n)}}function y(e,r){if(r.file)return`${e.basePath}/${r.file}`}function w(e){try{return u(e),!0}catch{return!1}}exports.DocsPackageLoadError=a;exports.isDocsPackageInstalled=w;exports.loadDocPage=l;exports.loadDocPageBySlug=v;exports.loadDocsPackage=$;exports.resolveFilePath=y;

package/dist/loader.js

@@ -3,8 +3,8 @@ var l = (t, e, r) => e in t ? u(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 { p as g } from "./frontmatter-8Bwpoi8r.js";
-import { v as m } from "./manifest-B_cvT6F9.js";
+import { p as g } from "./frontmatter-C0Wmtdep.js";
+import { v as m } from "./manifest-ZCrzbFSf.js";
 class a extends Error {
   constructor(r, n) {
     super(r);

package/dist/{manifest-D8kEDc9X.cjs → manifest-D-EWZlSh.cjs}

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

package/dist/{manifest-B_cvT6F9.js → manifest-ZCrzbFSf.js}

@@ -5,7 +5,7 @@ import { z as n } from "zod";
 const d = n.enum(["v1", "v2", "v3"]), u = n.object({
   indexFields: n.array(n.enum(["title", "description", "content", "keywords"])),
   boosts: n.record(n.string(), n.number()).optional()
-}), h = n.object({
+}), f = n.object({
   repository: n.string().regex(/^[^/]+\/[^/]+$/, 'Repository must be in format "owner/repo"'),
   branch: n.string().optional(),
   docsPath: n.string().optional()
@@ -18,14 +18,14 @@ const d = n.enum(["v1", "v2", "v3"]), u = n.object({
     badge: n.string().optional(),
     hidden: n.boolean().optional()
   })
-), f = n.object({
+), h = n.object({
   id: n.string().min(1, "Package ID is required"),
   name: n.string().min(1, "Package name is required"),
   version: n.string().regex(/^\d+\.\d+\.\d+/, "Version must be valid semver"),
   vendureVersion: d,
   navigation: n.array(c),
   search: u.optional(),
-  github: h.optional(),
+  github: f.optional(),
   basePath: n.string().optional()
 }), y = n.object({
   title: n.string().min(1, "Page title is required"),
@@ -39,7 +39,7 @@ const d = n.enum(["v1", "v2", "v3"]), u = n.object({
   content: n.string(),
   filePath: n.string()
 }), q = n.object({
-  manifest: f,
+  manifest: h,
   basePath: n.string()
 }), B = n.object({
   title: n.string(),
@@ -71,7 +71,7 @@ const d = n.enum(["v1", "v2", "v3"]), u = n.object({
   vendureVersion: d,
   navigation: n.array(m),
   search: u.optional(),
-  github: h.optional(),
+  github: f.optional(),
   basePath: n.string().optional()
 });
 class j extends Error {
@@ -82,7 +82,7 @@ class j extends Error {
   }
 }
 function w(i) {
-  const t = f.safeParse(i);
+  const t = h.safeParse(i);
   if (!t.success) {
     const e = t.error.issues.map((o) => `${o.path.join(".")}: ${o.message}`);
     throw new j("Invalid manifest", e);
@@ -126,7 +126,8 @@ function L(i, t) {
     r = r ? `${r}/${s}` : s, o.push({
       title: l.title,
       slug: l.slug,
-      path: r
+      path: r,
+      file: l.file
     }), a = l.children ?? [];
   }
   return o;
@@ -160,7 +161,7 @@ export {
   B,
   y as D,
   M as F,
-  h as G,
+  f as G,
   q as L,
   j as M,
   m as N,
@@ -168,7 +169,7 @@ export {
   d as V,
   I as a,
   $ as b,
-  f as c,
+  h as c,
   c as d,
   L as e,
   z as f,

package/dist/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACf,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,MAAM,EAAE,MAAM,EAAE,CAAA;gBAEpB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;CAK9C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,mBAAmB,CAWvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,MAAM,GACf,cAAc,GAAG,SAAS,CAG5B;AAqBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,kBAAkB,EAAE,CAIrF;AA4BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,MAAM,GACf,cAAc,EAAE,CAqBlB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,kBAAkB,EAAE,CAEhF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAAC,IAAI,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAY1D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAc/E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,MAAM,GACZ,kBAAkB,EAAE,CAEtB"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACf,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,MAAM,EAAE,MAAM,EAAE,CAAA;gBAEpB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE;CAK9C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,GAAG,mBAAmB,CAWvE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,MAAM,GACf,cAAc,GAAG,SAAS,CAG5B;AAqBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,kBAAkB,EAAE,CAIrF;AA4BD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,MAAM,GACf,cAAc,EAAE,CAsBlB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,mBAAmB,GAAG,kBAAkB,EAAE,CAEhF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAAC,IAAI,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAY1D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAc/E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,MAAM,GACZ,kBAAkB,EAAE,CAEtB"}

package/dist/remark-plugins/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Remark plugins for MDX processing
+ *
+ * These plugins are used by the MDX compiler to transform
+ * documentation content during compilation.
+ */
+export { remarkAdmonitions, default as remarkAdmonitionsDefault } from './remark-admonitions';
+export { remarkCodeMeta } from './remark-code-meta';
+export { remarkStripImports, default as remarkStripImportsDefault } from './remark-strip-imports';
+export { remarkStripHtmlComments, default as remarkStripHtmlCommentsDefault, } from './remark-strip-html-comments';
+//# sourceMappingURL=index.d.ts.map

package/dist/remark-plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/remark-plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,kBAAkB,EAAE,OAAO,IAAI,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AACjG,OAAO,EACL,uBAAuB,EACvB,OAAO,IAAI,8BAA8B,GAC1C,MAAM,8BAA8B,CAAA"}

package/dist/remark-plugins/remark-admonitions.d.ts

@@ -0,0 +1,18 @@
+import { Root } from 'mdast';
+import { Plugin } from 'unified';
+/**
+ * Remark plugin that transforms container directives into Callout JSX components.
+ *
+ * This plugin works with remark-directive to convert markdown like:
+ *
+ * ```md
+ * :::caution
+ * Some warning content
+ * :::
+ * ```
+ *
+ * Into a Callout component that can be rendered by MDX.
+ */
+export declare const remarkAdmonitions: Plugin<[], Root>;
+export default remarkAdmonitions;
+//# sourceMappingURL=remark-admonitions.d.ts.map

package/dist/remark-plugins/remark-admonitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-admonitions.d.ts","sourceRoot":"","sources":["../../src/remark-plugins/remark-admonitions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAEjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAuBrC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,CAwD9C,CAAA;AAED,eAAe,iBAAiB,CAAA"}

package/dist/remark-plugins/remark-code-meta.d.ts

@@ -0,0 +1,15 @@
+import { Root } from 'mdast';
+/**
+ * Remark plugin that extracts title/filename from code fence meta strings
+ * and converts them to `// filename:` comments that CodeBlock can parse.
+ *
+ * Supports:
+ * - ```ts title="path/to/file.ts"
+ * - ```ts filename="path/to/file.ts"
+ *
+ * Converts to:
+ * // filename: path/to/file.ts
+ * <code content>
+ */
+export declare function remarkCodeMeta(): (tree: Root) => void;
+//# sourceMappingURL=remark-code-meta.d.ts.map

package/dist/remark-plugins/remark-code-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-code-meta.d.ts","sourceRoot":"","sources":["../../src/remark-plugins/remark-code-meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,IAAI,EAAE,MAAM,OAAO,CAAA;AAGvC;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,KACpB,MAAM,IAAI,UAkBnB"}

package/dist/remark-plugins/remark-strip-html-comments.d.ts

@@ -0,0 +1,8 @@
+import { Root } from 'mdast';
+import { Plugin } from 'unified';
+/**
+ * Remark plugin that removes HTML comment nodes from the AST.
+ */
+export declare const remarkStripHtmlComments: Plugin<[], Root>;
+export default remarkStripHtmlComments;
+//# sourceMappingURL=remark-strip-html-comments.d.ts.map

package/dist/remark-plugins/remark-strip-html-comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-strip-html-comments.d.ts","sourceRoot":"","sources":["../../src/remark-plugins/remark-strip-html-comments.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAGrC;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,CAsBpD,CAAA;AAED,eAAe,uBAAuB,CAAA"}

package/dist/remark-plugins/remark-strip-imports.d.ts

@@ -0,0 +1,8 @@
+import { Root } from 'mdast';
+import { Plugin } from 'unified';
+/**
+ * Remark plugin that removes import statements for specified modules.
+ */
+export declare const remarkStripImports: Plugin<[], Root>;
+export default remarkStripImports;
+//# sourceMappingURL=remark-strip-imports.d.ts.map

package/dist/remark-plugins/remark-strip-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remark-strip-imports.d.ts","sourceRoot":"","sources":["../../src/remark-plugins/remark-strip-imports.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAEjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAQrC;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,EAAE,EAAE,IAAI,CA0B/C,CAAA;AAED,eAAe,kBAAkB,CAAA"}

package/dist/testing/index.d.ts

@@ -0,0 +1,32 @@
+import { MdxCompilationResult, MdxTestReport } from './types';
+export type { CompileMdxOptions, MdxCompilationResult, MdxTestReport, TestManifestOptions, } from './types';
+export { compileMdx, getDefaultRehypePlugins, getDefaultRemarkPlugins } from './mdx-compiler';
+export { testManifestMdx } from './test-manifest';
+/**
+ * Format a test report for console output.
+ *
+ * @param report - The test report to format
+ * @param verbose - If true, show details for all files. If false, only show failures.
+ * @returns A formatted string suitable for console output
+ *
+ * @example
+ * ```typescript
+ * const report = await testManifestMdx(manifest)
+ * console.log(formatTestReport(report, true))
+ * ```
+ */
+export declare function formatTestReport(report: MdxTestReport, verbose?: boolean): string;
+/**
+ * Create a simple progress reporter for console output.
+ *
+ * @returns A progress callback function for use with testManifestMdx
+ *
+ * @example
+ * ```typescript
+ * const report = await testManifestMdx(manifest, {
+ *   onProgress: createProgressReporter(),
+ * })
+ * ```
+ */
+export declare function createProgressReporter(): (current: number, total: number, result: MdxCompilationResult) => void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAGlE,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,GACpB,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,UAAU,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAA;AAC7F,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,UAAQ,GAAG,MAAM,CA2D/E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,IAAI,CACxC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,oBAAoB,KACzB,IAAI,CAcR"}

package/dist/testing/mdx-compiler.d.ts

@@ -0,0 +1,49 @@
+import { PluggableList } from 'unified';
+import { CompileMdxOptions, MdxCompilationResult } from './types';
+/**
+ * Get the default remark plugins used for MDX compilation.
+ *
+ * These plugins match those used in @apps/docs and provide:
+ * - GitHub Flavored Markdown support
+ * - Directive support (for admonitions)
+ * - Admonition transformation
+ * - Code fence metadata handling
+ * - Import stripping (Docusaurus compatibility)
+ * - HTML comment stripping
+ *
+ * @returns Array of remark plugins
+ */
+export declare function getDefaultRemarkPlugins(): PluggableList;
+/**
+ * Get the default rehype plugins used for MDX compilation.
+ *
+ * These plugins provide:
+ * - Automatic slug generation for headings
+ *
+ * @returns Array of rehype plugins
+ */
+export declare function getDefaultRehypePlugins(): PluggableList;
+/**
+ * Compile an MDX string and return the compilation result.
+ *
+ * This function uses the same plugin configuration as @apps/docs,
+ * allowing documentation packages to validate their MDX content
+ * before publishing.
+ *
+ * @param content - The MDX content to compile
+ * @param filePath - The file path (used for error reporting)
+ * @param options - Optional compilation options
+ * @returns The compilation result with success status and any errors
+ *
+ * @example
+ * ```typescript
+ * const result = await compileMdx('# Hello World', 'example.mdx')
+ * if (result.success) {
+ *   console.log('Compilation successful!')
+ * } else {
+ *   console.error(`Error at line ${result.line}: ${result.error}`)
+ * }
+ * ```
+ */
+export declare function compileMdx(content: string, filePath: string, options?: CompileMdxOptions): Promise<MdxCompilationResult>;
+//# sourceMappingURL=mdx-compiler.d.ts.map

package/dist/testing/mdx-compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mdx-compiler.d.ts","sourceRoot":"","sources":["../../src/testing/mdx-compiler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAO5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAEtE;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,IAAI,aAAa,CASvD;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,IAAI,aAAa,CAEvD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,oBAAoB,CAAC,CAuE/B"}

package/dist/testing/test-manifest.d.ts

@@ -0,0 +1,31 @@
+import { DocsPackageManifest } from '../types';
+import { MdxTestReport, TestManifestOptions } from './types';
+/**
+ * Test all MDX files in a manifest by compiling them.
+ *
+ * This function iterates through all leaf nodes (pages with files) in the
+ * manifest's navigation tree and attempts to compile each MDX file using
+ * the same plugins as @apps/docs.
+ *
+ * @param manifest - The documentation package manifest to test
+ * @param options - Optional configuration for testing
+ * @returns A report containing results for each file
+ *
+ * @example
+ * ```typescript
+ * import { manifest } from '../src/manifest'
+ * import { testManifestMdx, formatTestReport } from '@vendure-io/docs-provider/testing'
+ *
+ * const report = await testManifestMdx(manifest, {
+ *   basePath: __dirname,
+ *   onProgress: (current, total, result) => {
+ *     console.log(`[${current}/${total}] ${result.success ? '✓' : '✗'} ${result.filePath}`)
+ *   },
+ * })
+ *
+ * console.log(formatTestReport(report))
+ * process.exit(report.failed > 0 ? 1 : 0)
+ * ```
+ */
+export declare function testManifestMdx(manifest: DocsPackageManifest, options?: TestManifestOptions): Promise<MdxTestReport>;
+//# sourceMappingURL=test-manifest.d.ts.map

package/dist/testing/test-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-manifest.d.ts","sourceRoot":"","sources":["../../src/testing/test-manifest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAGnD,OAAO,KAAK,EAAwB,aAAa,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAEvF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,mBAAmB,EAC7B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,aAAa,CAAC,CA6ExB"}

package/dist/testing/types.d.ts

@@ -0,0 +1,81 @@
+import { PluggableList } from 'unified';
+/**
+ * Result of compiling a single MDX file
+ */
+export interface MdxCompilationResult {
+    /** Path to the MDX file that was compiled */
+    filePath: string;
+    /** Whether compilation was successful */
+    success: boolean;
+    /** Error message if compilation failed */
+    error?: string;
+    /** Line number where the error occurred (if available) */
+    line?: number;
+    /** Column number where the error occurred (if available) */
+    column?: number;
+    /** Time taken to compile the file in milliseconds */
+    compilationTime: number;
+}
+/**
+ * Report from testing all MDX files in a manifest
+ */
+export interface MdxTestReport {
+    /** Package ID from the manifest */
+    packageId: string;
+    /** Total number of MDX files tested */
+    totalFiles: number;
+    /** Number of files that compiled successfully */
+    passed: number;
+    /** Number of files that failed to compile */
+    failed: number;
+    /** Individual results for each file */
+    results: MdxCompilationResult[];
+    /** Total time taken for all compilations in milliseconds */
+    totalTime: number;
+}
+/**
+ * Options for testing a manifest's MDX files
+ */
+export interface TestManifestOptions {
+    /**
+     * Base path for resolving file paths.
+     * If not provided, uses the manifest's basePath or current working directory.
+     */
+    basePath?: string;
+    /**
+     * Stop on first failure.
+     * @default false
+     */
+    failFast?: boolean;
+    /**
+     * Custom remark plugins to use instead of defaults.
+     * If not provided, uses the standard docs-provider plugins.
+     */
+    remarkPlugins?: PluggableList;
+    /**
+     * Custom rehype plugins to use instead of defaults.
+     * If not provided, uses the standard docs-provider plugins.
+     */
+    rehypePlugins?: PluggableList;
+    /**
+     * Callback invoked after each file is processed.
+     * Useful for progress reporting.
+     */
+    onProgress?: (current: number, total: number, result: MdxCompilationResult) => void;
+}
+/**
+ * Options for compiling a single MDX file
+ */
+export interface CompileMdxOptions {
+    /**
+     * Custom remark plugins to use.
+     * If not provided, uses the standard docs-provider plugins.
+     */
+    remarkPlugins?: PluggableList;
+    /**
+     * Custom rehype plugins to use.
+     * If not provided, uses the standard docs-provider plugins.
+     */
+    rehypePlugins?: PluggableList;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/testing/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAA;IAChB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAA;IAChB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAA;IACd,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAA;IACd,uCAAuC;IACvC,OAAO,EAAE,oBAAoB,EAAE,CAAA;IAC/B,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAA;CACpF;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;CAC9B"}

package/dist/testing.cjs

@@ -0,0 +1,4 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const w=require("@mdx-js/mdx"),F=require("rehype-slug"),M=require("remark-directive"),x=require("remark-gfm"),p=require("unist-util-visit"),R=require("fs/promises"),$=require("path"),D=require("./manifest-D-EWZlSh.cjs"),v={info:"info",note:"note",tip:"tip",warning:"warning",caution:"caution",danger:"danger"},I={info:"Info",note:"Note",tip:"Tip",warning:"Warning",caution:"Caution",danger:"Danger"},b=()=>s=>{p.visit(s,"containerDirective",e=>{var l;const t=e.name.toLowerCase();if(!(t in v))return;const i=v[t];let r;if(e.children.length>0){const a=e.children[0];if(a.type==="paragraph"&&"data"in a&&((l=a.data)==null?void 0:l.directiveLabel)===!0){const c=[];for(const f of a.children)f.type==="text"&&c.push(f.value);c.length>0&&(r=c.join("")),e.children=e.children.slice(1)}}const n=r||I[t],u=e.data||(e.data={});u.hName="Callout",u.hProperties={type:i,title:n}})};function E(){return s=>{p.visit(s,"code",e=>{if(!e.meta)return;const t=e.meta.match(/(?:title|filename)=["']([^"']+)["']/);if(!t)return;const i=t[1];e.value.trim().startsWith("// filename:")||(e.value=`// filename: ${i}
+${e.value}`)})}}const S=()=>s=>{const e=[];p.visit(s,"html",(t,i,r)=>{i!==void 0&&r&&typeof t.value=="string"&&t.value.trim().startsWith("<!--")&&t.value.trim().endsWith("-->")&&e.push(i)});for(const t of e.reverse())s.children.splice(t,1)},q=["@theme/Tabs","@theme/TabItem"],C=()=>s=>{const e=[];p.visit(s,"mdxjsEsm",t=>{const i=t.value;q.some(n=>i.includes(`from '${n}'`)||i.includes(`from "${n}"`))&&e.push(t)});for(const t of e){const i=s.children.indexOf(t);i!==-1&&s.children.splice(i,1)}};function T(){return[x,M,b,E,C,S]}function y(){return[F]}async function k(s,e,t){var u,l,a,c;const i=performance.now(),r=(t==null?void 0:t.remarkPlugins)??T(),n=(t==null?void 0:t.rehypePlugins)??y();try{return await w.compile(s,{remarkPlugins:r,rehypePlugins:n,outputFormat:"function-body",development:!1}),{filePath:e,success:!0,compilationTime:performance.now()-i}}catch(f){const d=performance.now()-i;let o="Unknown compilation error",m,g;if(f instanceof Error){o=f.message;const h=f;if(h.line!==void 0?m=h.line:((l=(u=h.position)==null?void 0:u.start)==null?void 0:l.line)!==void 0&&(m=h.position.start.line),h.column!==void 0?g=h.column:((c=(a=h.position)==null?void 0:a.start)==null?void 0:c.column)!==void 0&&(g=h.position.start.column),m===void 0){const P=o.match(/\((\d+):(\d+)\)/);P&&(m=parseInt(P[1],10),g=parseInt(P[2],10))}}return{filePath:e,success:!1,error:o,line:m,column:g,compilationTime:d}}}async function L(s,e){const t=performance.now(),i=$.resolve((e==null?void 0:e.basePath)??s.basePath??process.cwd()),r=D.getLeafNodes(s),n=[];let u=0,l=0;for(let a=0;a<r.length;a++){const c=r[a];if(!c.file)continue;const f=$.join(i,c.file);try{const d=await R.readFile(f,"utf-8"),o=await k(d,c.file,{remarkPlugins:e==null?void 0:e.remarkPlugins,rehypePlugins:e==null?void 0:e.rehypePlugins});if(n.push(o),o.success?u++:l++,e!=null&&e.onProgress&&e.onProgress(a+1,r.length,o),e!=null&&e.failFast&&!o.success)break}catch(d){const o=d instanceof Error?d.message:"Unknown error reading file",m={filePath:c.file,success:!1,error:`Failed to read file: ${o}`,compilationTime:0};if(n.push(m),l++,e!=null&&e.onProgress&&e.onProgress(a+1,r.length,m),e!=null&&e.failFast)break}}return{packageId:s.id,totalFiles:n.length,passed:u,failed:l,results:n,totalTime:performance.now()-t}}function A(s,e=!1){const t=[];t.push(""),t.push(`MDX Compilation Report: ${s.packageId}`),t.push("=".repeat(50)),t.push("");const i=s.totalFiles>0?(s.passed/s.totalFiles*100).toFixed(1):"0";if(t.push(`Total files: ${s.totalFiles}`),t.push(`Passed: ${s.passed} (${i}%)`),t.push(`Failed: ${s.failed}`),t.push(`Total time: ${s.totalTime.toFixed(2)}ms`),t.push(""),e){t.push("Results:"),t.push("-".repeat(50));for(const r of s.results){const n=r.success?"[PASS]":"[FAIL]",u=`(${r.compilationTime.toFixed(2)}ms)`;if(t.push(`${n} ${r.filePath} ${u}`),!r.success&&r.error){const l=r.line?` (line ${r.line}${r.column?`:${r.column}`:""})`:"";t.push(`       Error${l}: ${r.error}`)}}}else if(s.failed>0){t.push("Failures:"),t.push("-".repeat(50));for(const r of s.results.filter(n=>!n.success))if(t.push(`[FAIL] ${r.filePath}`),r.error){const n=r.line?` (line ${r.line}${r.column?`:${r.column}`:""})`:"";t.push(`       Error${n}: ${r.error}`)}}return t.push(""),s.failed===0?t.push("All MDX files compiled successfully!"):t.push(`${s.failed} file(s) failed to compile.`),t.push(""),t.join(`
+`)}function j(){return(s,e,t)=>{const i=t.success?"✓":"✗",r=(s/e*100).toFixed(0);process.stdout.write(`\r[${s}/${e}] (${r}%) ${i} ${t.filePath}`),process.stdout.write("\x1B[K"),s===e&&process.stdout.write(`
+`)}}exports.compileMdx=k;exports.createProgressReporter=j;exports.formatTestReport=A;exports.getDefaultRehypePlugins=y;exports.getDefaultRemarkPlugins=T;exports.testManifestMdx=L;

package/dist/testing.js

@@ -0,0 +1,202 @@
+import { compile as v } from "@mdx-js/mdx";
+import T from "rehype-slug";
+import w from "remark-directive";
+import F from "remark-gfm";
+import { visit as g } from "unist-util-visit";
+import { readFile as k } from "fs/promises";
+import { resolve as y, join as x } from "path";
+import { h as I } from "./manifest-ZCrzbFSf.js";
+const P = {
+  info: "info",
+  note: "note",
+  tip: "tip",
+  warning: "warning",
+  caution: "caution",
+  danger: "danger"
+}, E = {
+  info: "Info",
+  note: "Note",
+  tip: "Tip",
+  warning: "Warning",
+  caution: "Caution",
+  danger: "Danger"
+}, M = () => (r) => {
+  g(r, "containerDirective", (e) => {
+    var l;
+    const t = e.name.toLowerCase();
+    if (!(t in P))
+      return;
+    const i = P[t];
+    let s;
+    if (e.children.length > 0) {
+      const n = e.children[0];
+      if (n.type === "paragraph" && "data" in n && ((l = n.data) == null ? void 0 : l.directiveLabel) === !0) {
+        const c = [];
+        for (const f of n.children)
+          f.type === "text" && c.push(f.value);
+        c.length > 0 && (s = c.join("")), e.children = e.children.slice(1);
+      }
+    }
+    const a = s || E[t], o = e.data || (e.data = {});
+    o.hName = "Callout", o.hProperties = {
+      type: i,
+      title: a
+    };
+  });
+};
+function D() {
+  return (r) => {
+    g(r, "code", (e) => {
+      if (!e.meta) return;
+      const t = e.meta.match(/(?:title|filename)=["']([^"']+)["']/);
+      if (!t) return;
+      const i = t[1];
+      e.value.trim().startsWith("// filename:") || (e.value = `// filename: ${i}
+${e.value}`);
+    });
+  };
+}
+const R = () => (r) => {
+  const e = [];
+  g(r, "html", (t, i, s) => {
+    i !== void 0 && s && typeof t.value == "string" && t.value.trim().startsWith("<!--") && t.value.trim().endsWith("-->") && e.push(i);
+  });
+  for (const t of e.reverse())
+    r.children.splice(t, 1);
+}, b = ["@theme/Tabs", "@theme/TabItem"], S = () => (r) => {
+  const e = [];
+  g(r, "mdxjsEsm", (t) => {
+    const i = t.value;
+    b.some(
+      (a) => i.includes(`from '${a}'`) || i.includes(`from "${a}"`)
+    ) && e.push(t);
+  });
+  for (const t of e) {
+    const i = r.children.indexOf(t);
+    i !== -1 && r.children.splice(i, 1);
+  }
+};
+function C() {
+  return [
+    F,
+    w,
+    M,
+    D,
+    S,
+    R
+  ];
+}
+function L() {
+  return [T];
+}
+async function A(r, e, t) {
+  var o, l, n, c;
+  const i = performance.now(), s = (t == null ? void 0 : t.remarkPlugins) ?? C(), a = (t == null ? void 0 : t.rehypePlugins) ?? L();
+  try {
+    return await v(r, {
+      remarkPlugins: s,
+      rehypePlugins: a,
+      // Don't output to JS, just compile to check for errors
+      outputFormat: "function-body",
+      // Suppress development warnings about missing 'development' option
+      development: !1
+    }), {
+      filePath: e,
+      success: !0,
+      compilationTime: performance.now() - i
+    };
+  } catch (f) {
+    const d = performance.now() - i;
+    let u = "Unknown compilation error", m, p;
+    if (f instanceof Error) {
+      u = f.message;
+      const h = f;
+      if (h.line !== void 0 ? m = h.line : ((l = (o = h.position) == null ? void 0 : o.start) == null ? void 0 : l.line) !== void 0 && (m = h.position.start.line), h.column !== void 0 ? p = h.column : ((c = (n = h.position) == null ? void 0 : n.start) == null ? void 0 : c.column) !== void 0 && (p = h.position.start.column), m === void 0) {
+        const $ = u.match(/\((\d+):(\d+)\)/);
+        $ && (m = parseInt($[1], 10), p = parseInt($[2], 10));
+      }
+    }
+    return {
+      filePath: e,
+      success: !1,
+      error: u,
+      line: m,
+      column: p,
+      compilationTime: d
+    };
+  }
+}
+async function G(r, e) {
+  const t = performance.now(), i = y((e == null ? void 0 : e.basePath) ?? r.basePath ?? process.cwd()), s = I(r), a = [];
+  let o = 0, l = 0;
+  for (let n = 0; n < s.length; n++) {
+    const c = s[n];
+    if (!c.file)
+      continue;
+    const f = x(i, c.file);
+    try {
+      const d = await k(f, "utf-8"), u = await A(d, c.file, {
+        remarkPlugins: e == null ? void 0 : e.remarkPlugins,
+        rehypePlugins: e == null ? void 0 : e.rehypePlugins
+      });
+      if (a.push(u), u.success ? o++ : l++, e != null && e.onProgress && e.onProgress(n + 1, s.length, u), e != null && e.failFast && !u.success)
+        break;
+    } catch (d) {
+      const u = d instanceof Error ? d.message : "Unknown error reading file", m = {
+        filePath: c.file,
+        success: !1,
+        error: `Failed to read file: ${u}`,
+        compilationTime: 0
+      };
+      if (a.push(m), l++, e != null && e.onProgress && e.onProgress(n + 1, s.length, m), e != null && e.failFast)
+        break;
+    }
+  }
+  return {
+    packageId: r.id,
+    totalFiles: a.length,
+    passed: o,
+    failed: l,
+    results: a,
+    totalTime: performance.now() - t
+  };
+}
+function H(r, e = !1) {
+  const t = [];
+  t.push(""), t.push(`MDX Compilation Report: ${r.packageId}`), t.push("=".repeat(50)), t.push("");
+  const i = r.totalFiles > 0 ? (r.passed / r.totalFiles * 100).toFixed(1) : "0";
+  if (t.push(`Total files: ${r.totalFiles}`), t.push(`Passed: ${r.passed} (${i}%)`), t.push(`Failed: ${r.failed}`), t.push(`Total time: ${r.totalTime.toFixed(2)}ms`), t.push(""), e) {
+    t.push("Results:"), t.push("-".repeat(50));
+    for (const s of r.results) {
+      const a = s.success ? "[PASS]" : "[FAIL]", o = `(${s.compilationTime.toFixed(2)}ms)`;
+      if (t.push(`${a} ${s.filePath} ${o}`), !s.success && s.error) {
+        const l = s.line ? ` (line ${s.line}${s.column ? `:${s.column}` : ""})` : "";
+        t.push(`       Error${l}: ${s.error}`);
+      }
+    }
+  } else if (r.failed > 0) {
+    t.push("Failures:"), t.push("-".repeat(50));
+    for (const s of r.results.filter((a) => !a.success))
+      if (t.push(`[FAIL] ${s.filePath}`), s.error) {
+        const a = s.line ? ` (line ${s.line}${s.column ? `:${s.column}` : ""})` : "";
+        t.push(`       Error${a}: ${s.error}`);
+      }
+  }
+  return t.push(""), r.failed === 0 ? t.push("All MDX files compiled successfully!") : t.push(`${r.failed} file(s) failed to compile.`), t.push(""), t.join(`
+`);
+}
+function K() {
+  return (r, e, t) => {
+    const i = t.success ? "✓" : "✗", s = (r / e * 100).toFixed(0);
+    process.stdout.write(`\r[${r}/${e}] (${s}%) ${i} ${t.filePath}`), process.stdout.write("\x1B[K"), r === e && process.stdout.write(`
+`);
+  };
+}
+export {
+  A as compileMdx,
+  K as createProgressReporter,
+  H as formatTestReport,
+  L as getDefaultRehypePlugins,
+  C as getDefaultRemarkPlugins,
+  G as testManifestMdx
+};

package/dist/types.d.ts

@@ -107,6 +107,8 @@ export interface BreadcrumbItem {
     slug: string;
     /** Full path from root */
     path: string;
+    /** Path to MDX file (indicates this item has an actual page) */
+    file?: string;
 }
 /**
  * Flattened navigation node with full path information

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":"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"}

package/docs/getting-started.md

@@ -153,4 +153,5 @@ Welcome to My Plugin documentation!
 - [Creating a Docs Package](./creating-a-docs-package.md) - Complete guide to building a documentation package
 - [Manifest Reference](./manifest-reference.md) - Full API documentation for manifest configuration
 - [Frontmatter Reference](./frontmatter-reference.md) - All available frontmatter options
+- [MDX Testing](./mdx-testing.md) - Validate MDX files before publishing
 - [Publishing](./publishing.md) - How to publish and integrate with vendure.io

package/docs/mdx-components-reference.md

@@ -88,10 +88,10 @@ An inline link component that automatically prefixes relative URLs with the curr
 
 #### Props
 
-| Prop       | Type        | Required | Description                                            |
-| ---------- | ----------- | -------- | ------------------------------------------------------ |
-| `href`     | `string`    | Yes      | URL to navigate to (relative paths will be prefixed)   |
-| `children` | `ReactNode` | Yes      | Link text content                                      |
+| Prop       | Type        | Required | Description                                          |
+| ---------- | ----------- | -------- | ---------------------------------------------------- |
+| `href`     | `string`    | Yes      | URL to navigate to (relative paths will be prefixed) |
+| `children` | `ReactNode` | Yes      | Link text content                                    |
 
 #### Example
 

package/docs/mdx-testing.md

@@ -0,0 +1,437 @@
+# MDX Compilation Testing
+
+`@vendure-io/docs-provider` includes a testing module that allows you to validate MDX files **before publishing** your documentation package. This catches compilation errors early, reducing the feedback loop between publishing and discovering issues.
+
+## Why Test MDX Files?
+
+MDX compilation errors only surface when the documentation website attempts to render your pages. Without pre-publish testing, this creates a slow feedback loop:
+
+1. Write MDX content
+2. Publish package to npm
+3. Update docs website dependency
+4. Build docs website
+5. Discover compilation errors
+6. Fix and repeat
+
+The testing module lets you catch errors at step 1, before any publishing occurs.
+
+## Installation
+
+The testing module is included in `@vendure-io/docs-provider`. No additional installation is required, but ensure you have the package installed:
+
+```bash
+npm install @vendure-io/docs-provider
+# or
+bun add @vendure-io/docs-provider
+```
+
+## Quick Start
+
+### Testing Your Manifest
+
+The simplest way to test all MDX files in your documentation package:
+
+```typescript
+import { manifest } from './src/manifest'
+import { testManifestMdx, formatTestReport } from '@vendure-io/docs-provider/testing'
+
+async function main() {
+  const report = await testManifestMdx(manifest, {
+    basePath: __dirname,
+  })
+
+  console.log(formatTestReport(report))
+  process.exit(report.failed > 0 ? 1 : 0)
+}
+
+main()
+```
+
+Save this as `scripts/test-mdx.ts` and run it:
+
+```bash
+npx tsx scripts/test-mdx.ts
+# or with bun
+bun run scripts/test-mdx.ts
+```
+
+### Adding to package.json
+
+Add a script to your `package.json` for easy execution:
+
+```json
+{
+  "scripts": {
+    "test:mdx": "tsx scripts/test-mdx.ts",
+    "prepublishOnly": "npm run test:mdx"
+  }
+}
+```
+
+The `prepublishOnly` script ensures MDX validation runs before every npm publish.
+
+## API Reference
+
+### testManifestMdx
+
+Tests all MDX files referenced in a manifest's navigation tree.
+
+```typescript
+async function testManifestMdx(
+  manifest: DocsPackageManifest,
+  options?: TestManifestOptions
+): Promise<MdxTestReport>
+```
+
+**Parameters:**
+
+- `manifest` - The documentation package manifest to test
+- `options` - Optional configuration (see below)
+
+**Options:**
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `basePath` | `string` | `manifest.basePath` or `cwd()` | Base path for resolving file paths |
+| `failFast` | `boolean` | `false` | Stop on first failure |
+| `remarkPlugins` | `PluggableList` | Default plugins | Custom remark plugins |
+| `rehypePlugins` | `PluggableList` | Default plugins | Custom rehype plugins |
+| `onProgress` | `Function` | `undefined` | Progress callback |
+
+**Example with progress reporting:**
+
+```typescript
+const report = await testManifestMdx(manifest, {
+  basePath: __dirname,
+  onProgress: (current, total, result) => {
+    const status = result.success ? '✓' : '✗'
+    console.log(`[${current}/${total}] ${status} ${result.filePath}`)
+  },
+})
+```
+
+### compileMdx
+
+Compiles a single MDX string and returns the result.
+
+```typescript
+async function compileMdx(
+  content: string,
+  filePath: string,
+  options?: CompileMdxOptions
+): Promise<MdxCompilationResult>
+```
+
+**Example:**
+
+```typescript
+import { compileMdx } from '@vendure-io/docs-provider/testing'
+
+const content = `
+---
+title: Test Page
+---
+
+# Hello World
+
+This is a test.
+`
+
+const result = await compileMdx(content, 'test.mdx')
+
+if (result.success) {
+  console.log('Compilation successful!')
+} else {
+  console.error(`Error at line ${result.line}: ${result.error}`)
+}
+```
+
+### formatTestReport
+
+Formats a test report for console output.
+
+```typescript
+function formatTestReport(report: MdxTestReport, verbose?: boolean): string
+```
+
+**Parameters:**
+
+- `report` - The test report to format
+- `verbose` - If `true`, shows all results. If `false`, only shows failures.
+
+**Example output (verbose):**
+
+```
+MDX Compilation Report: my-plugin
+==================================================
+
+Total files: 5
+Passed: 4 (80.0%)
+Failed: 1
+Total time: 156.32ms
+
+Results:
+--------------------------------------------------
+[PASS] docs/getting-started.mdx (45.21ms)
+[PASS] docs/installation.mdx (32.11ms)
+[PASS] docs/configuration.mdx (28.54ms)
+[PASS] docs/api-reference.mdx (35.67ms)
+[FAIL] docs/advanced.mdx (14.79ms)
+       Error (line 42:15): Unexpected token
+
+1 file(s) failed to compile.
+```
+
+### createProgressReporter
+
+Creates a simple progress reporter for console output.
+
+```typescript
+function createProgressReporter(): (
+  current: number,
+  total: number,
+  result: MdxCompilationResult
+) => void
+```
+
+**Example:**
+
+```typescript
+import { testManifestMdx, createProgressReporter } from '@vendure-io/docs-provider/testing'
+
+const report = await testManifestMdx(manifest, {
+  basePath: __dirname,
+  onProgress: createProgressReporter(),
+})
+```
+
+### getDefaultRemarkPlugins / getDefaultRehypePlugins
+
+Get the default plugins used for MDX compilation. Useful for extending the plugin list.
+
+```typescript
+function getDefaultRemarkPlugins(): PluggableList
+function getDefaultRehypePlugins(): PluggableList
+```
+
+**Example (extending plugins):**
+
+```typescript
+import {
+  testManifestMdx,
+  getDefaultRemarkPlugins,
+  getDefaultRehypePlugins,
+} from '@vendure-io/docs-provider/testing'
+import myCustomPlugin from './my-plugin'
+
+const report = await testManifestMdx(manifest, {
+  basePath: __dirname,
+  remarkPlugins: [...getDefaultRemarkPlugins(), myCustomPlugin],
+  rehypePlugins: getDefaultRehypePlugins(),
+})
+```
+
+## Types
+
+### MdxCompilationResult
+
+```typescript
+interface MdxCompilationResult {
+  /** Path to the MDX file that was compiled */
+  filePath: string
+  /** Whether compilation was successful */
+  success: boolean
+  /** Error message if compilation failed */
+  error?: string
+  /** Line number where the error occurred */
+  line?: number
+  /** Column number where the error occurred */
+  column?: number
+  /** Time taken to compile in milliseconds */
+  compilationTime: number
+}
+```
+
+### MdxTestReport
+
+```typescript
+interface MdxTestReport {
+  /** Package ID from the manifest */
+  packageId: string
+  /** Total number of MDX files tested */
+  totalFiles: number
+  /** Number of files that compiled successfully */
+  passed: number
+  /** Number of files that failed to compile */
+  failed: number
+  /** Individual results for each file */
+  results: MdxCompilationResult[]
+  /** Total time taken in milliseconds */
+  totalTime: number
+}
+```
+
+## Integration with Vitest
+
+You can integrate MDX testing into your existing test suite:
+
+```typescript
+// tests/mdx-compilation.test.ts
+import { describe, it, expect } from 'vitest'
+import { manifest } from '../src/manifest'
+import { testManifestMdx } from '@vendure-io/docs-provider/testing'
+
+describe('MDX Compilation', () => {
+  it('should compile all MDX files without errors', async () => {
+    const report = await testManifestMdx(manifest, {
+      basePath: __dirname + '/..',
+    })
+
+    expect(report.failed).toBe(0)
+  }, 30000) // Increase timeout for large doc sets
+})
+```
+
+## Supported MDX Features
+
+The testing module uses the same remark/rehype plugins as the Vendure documentation website:
+
+### Admonitions
+
+```mdx
+:::info
+This is an info callout.
+:::
+
+:::warning Custom Title
+This is a warning with a custom title.
+:::
+```
+
+Supported types: `info`, `note`, `tip`, `warning`, `caution`, `danger`
+
+### Code Fence Metadata
+
+```mdx
+```typescript title="src/example.ts"
+export function example() {
+  return 'Hello'
+}
+```
+```
+
+### GitHub Flavored Markdown
+
+- Tables
+- Task lists
+- Strikethrough
+- Autolinks
+
+### JSX Components
+
+```mdx
+<Callout type="info" title="Note">
+  Custom JSX components work as expected.
+</Callout>
+```
+
+## Common Errors
+
+### Unclosed JSX Tags
+
+```
+Error (line 15): Expected closing tag for `<div>`
+```
+
+Ensure all JSX tags are properly closed:
+
+```mdx
+<!-- Wrong -->
+<div>
+  Content here
+
+<!-- Correct -->
+<div>
+  Content here
+</div>
+```
+
+### Invalid JSX Syntax
+
+```
+Error (line 8:5): Unexpected token
+```
+
+Check for:
+- Missing quotes around attribute values
+- Unescaped special characters (`<`, `>`, `{`, `}`)
+- JavaScript expressions not wrapped in curly braces
+
+### Missing Frontmatter
+
+While the MDX compiler doesn't require frontmatter, the docs website does. Ensure all files have at least a `title`:
+
+```mdx
+---
+title: My Page Title
+---
+
+# Content
+```
+
+## Best Practices
+
+1. **Run tests before commits**: Add MDX testing to your pre-commit hooks
+2. **Use CI/CD**: Include MDX testing in your continuous integration pipeline
+3. **Test incrementally**: Use `failFast: true` during development for faster feedback
+4. **Verbose output for debugging**: Use `formatTestReport(report, true)` when troubleshooting
+
+## Example: Complete Test Script
+
+Here's a complete test script with all features:
+
+```typescript
+// scripts/test-mdx.ts
+import { dirname, join } from 'path'
+import { fileURLToPath } from 'url'
+import { manifest } from '../src/manifest'
+import {
+  testManifestMdx,
+  formatTestReport,
+  createProgressReporter,
+} from '@vendure-io/docs-provider/testing'
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+const projectRoot = join(__dirname, '..')
+
+async function main() {
+  console.log('Testing MDX files...\n')
+
+  const report = await testManifestMdx(manifest, {
+    basePath: projectRoot,
+    onProgress: createProgressReporter(),
+  })
+
+  console.log('\n')
+  console.log(formatTestReport(report, process.argv.includes('--verbose')))
+
+  if (report.failed > 0) {
+    process.exit(1)
+  }
+}
+
+main().catch((error) => {
+  console.error('Test runner error:', error)
+  process.exit(1)
+})
+```
+
+Run with:
+
+```bash
+# Standard output
+bun run scripts/test-mdx.ts
+
+# Verbose output showing all results
+bun run scripts/test-mdx.ts --verbose
+```

package/docs/publishing.md

@@ -319,6 +319,7 @@ Before publishing, verify:
 - [ ] All file paths resolve correctly
 - [ ] All MDX files have valid frontmatter
 - [ ] All MDX files have at least a `title` in frontmatter
+- [ ] All MDX files compile successfully (see [MDX Testing](./mdx-testing.md))
 - [ ] `package.json` includes `src` and `docs` in `files`
 - [ ] `package.json` has correct exports configuration
 - [ ] Manifest validation passes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vendure-io/docs-provider",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Contract types and utilities for Vendure documentation packages",
   "private": false,
   "publishConfig": {
@@ -36,6 +36,16 @@
         "types": "./dist/loader.d.ts",
         "default": "./dist/loader.js"
       }
+    },
+    "./testing": {
+      "import": {
+        "types": "./dist/testing/index.d.ts",
+        "default": "./dist/testing.js"
+      },
+      "require": {
+        "types": "./dist/testing/index.d.ts",
+        "default": "./dist/testing.cjs"
+      }
     }
   },
   "files": [
@@ -53,11 +63,20 @@
     "publish:local": "bun run build && npm publish --registry http://localhost:4873"
   },
   "dependencies": {
+    "@mdx-js/mdx": "^3.0.0",
     "gray-matter": "^4.0.3",
+    "rehype-slug": "^6.0.0",
+    "remark-directive": "^4.0.0",
+    "remark-gfm": "^4.0.1",
+    "unist-util-visit": "^5.0.0",
     "zod": "^3.24.2"
   },
   "devDependencies": {
+    "@types/mdast": "^4.0.4",
     "ajv": "^8.17.1",
+    "mdast-util-directive": "^3.1.0",
+    "mdast-util-mdx": "^3.0.0",
+    "unified": "^11.0.5",
     "vite": "^6.0.0",
     "vite-plugin-dts": "^4.5.4",
     "vitest": "^3.0.0"