docfuse 0.1.0

package/dist/chunk-S36HQTIA.js

@@ -0,0 +1,3 @@
+import{a as h}from"./chunk-GRQDPV4U.js";import{d as a,e as E,f as d,g as u}from"./chunk-JK7ZNBUA.js";import{a as o}from"./chunk-AYDF3IFZ.js";import{randomUUID as b}from"crypto";import{mkdir as B,open as x,readFile as p,rename as S,rm as f,stat as k,writeFile as M}from"fs/promises";import{hostname as O}from"os";import{dirname as v,join as y}from"path";var w=600*1e3,A=Math.floor(w/3);function l(t){return typeof t=="string"&&t.length>0&&!t.startsWith("/")&&!t.includes("\\")&&t.split("/").every(e=>e!==""&&e!=="."&&e!=="..")}o(l,"isSafeOutputPath");function Q(t){return a(t,".docfuse/cache","build cache")}o(Q,"resolveBuildCacheRoot");function Y(t){return a(t,".docfuse/tmp","temporary build files")}o(Y,"resolveBuildTemporaryRoot");function P(t){return y(t,"build-manifest.json")}o(P,"manifestPath");function D(t){if(!t||typeof t!="object")return!1;let e=t;return typeof e.fingerprint=="string"&&l(e.outputPath)&&l(e.markdownOutputPath)&&Array.isArray(e.assetOutputPaths)&&e.assetOutputPaths.every(l)}o(D,"isPageState");function R(t){if(!t||typeof t!="object")return!1;let e=t;return typeof e.fingerprint=="string"&&Number.isSafeInteger(e.size)&&Number(e.size)>=0}o(R,"isOutputState");function j(t){if(!t||typeof t!="object")return!1;let e=t;return e.schemaVersion===3&&e.docfuseVersion===h&&typeof e.buildFingerprint=="string"&&typeof e.sharedFingerprint=="string"&&!!e.pages&&typeof e.pages=="object"&&Object.values(e.pages).every(D)&&!!e.outputs&&typeof e.outputs=="object"&&Object.keys(e.outputs).length>0&&Object.keys(e.outputs).every(l)&&Object.values(e.outputs).every(R)}o(j,"isBuildManifest");async function Z(t){try{let e=JSON.parse(await p(P(t),"utf8"));return j(e)?e:void 0}catch(e){if(e.code==="ENOENT"||e instanceof SyntaxError)return;throw e}}o(Z,"readBuildManifest");async function tt(t,e){await B(t,{recursive:!0});let n=P(t),i=y(t,`.build-manifest.${b()}.tmp`);try{await M(i,`${JSON.stringify(e,null,2)}
+`,{flag:"wx",flush:!0});try{await S(i,n)}catch(r){let s=r.code;if(s!=="EEXIST"&&s!=="EPERM")throw r;await f(n,{force:!0}),await S(i,n)}}finally{await f(i,{force:!0})}}o(tt,"writeBuildManifest");function T(t){try{return process.kill(t,0),!0}catch(e){return e.code!=="ESRCH"}}o(T,"processIsAlive");function F(t,e,n=Date.now()){if(t.hostname===O()&&typeof t.pid=="number"&&Number.isSafeInteger(t.pid)&&t.pid>0&&!T(t.pid))return!0;let i=typeof t.updatedAt=="number"?t.updatedAt:typeof t.createdAt=="number"?t.createdAt:void 0,r=i===void 0?e:Math.max(i,e);return r===void 0||!Number.isFinite(r)||r>n+w||n-r>w}o(F,"lockIsStale");function J(t,e){return JSON.stringify({ownerId:t,pid:process.pid,hostname:O(),createdAt:e})}o(J,"lockContents");async function g(t){try{return JSON.parse(await p(t,"utf8"))}catch(e){if(e.code==="ENOENT")return;throw e}}o(g,"readBuildLock");async function m(t){let e=await x(t,"wx"),n=b(),i=Date.now();try{return await e.writeFile(J(n,i)),{handle:e,path:t,ownerId:n,createdAt:i}}catch(r){throw await e.close(),await f(t,{force:!0}),r}}o(m,"createBuildLock");async function N(t){(await g(t.path))?.ownerId===t.ownerId&&await f(t.path,{force:!0})}o(N,"releaseBuildLock");async function I(t){let e,n;try{let[r,s]=await Promise.all([p(t,"utf8"),k(t)]);e=r,n=s.mtimeMs}catch(r){if(r.code==="ENOENT")return!0;throw r}let i;try{i=F(JSON.parse(e),n)}catch{i=Date.now()-n>w}if(!i)return!1;try{let[r,s]=await Promise.all([p(t,"utf8"),k(t)]);return r!==e||s.mtimeMs!==n?!1:(await f(t),!0)}catch(r){if(r.code==="ENOENT")return!0;throw r}}o(I,"removeStaleLock");async function _(t){try{return await m(t)}catch(e){if(e.code!=="EEXIST")throw e;if(!await I(t))throw new Error("Another Docfuse build is already running for this project");try{return await m(t)}catch(n){throw n.code==="EEXIST"?new Error("Another Docfuse build is already running for this project"):n}}}o(_,"acquireBuildLock");async function C(t){let e=v(t);await B(e,{recursive:!0});let n=y(e,"build.lock"),i=await _(`${n}.reclaim`);try{try{return await m(n)}catch(r){if(r.code!=="EEXIST")throw r;if(!await I(n))throw new Error("Another Docfuse build is already running for this project");return await m(n)}}finally{await i.handle.close(),await N(i)}}o(C,"openBuildLock");async function $(t){if((await g(t.path))?.ownerId!==t.ownerId)return!1;let n=new Date;return await t.handle.utimes(n,n),!0}o($,"refreshBuildLock");async function V(t){if((await g(t.path))?.ownerId!==t.ownerId)throw new Error("Docfuse build lock ownership was lost during the build")}o(V,"assertBuildLockOwned");async function et(t,e){let n=await C(t),i,r=setInterval(()=>{$(n).then(s=>{s||(i=new Error("Docfuse build lock ownership was lost during the build"))}).catch(s=>{i=s})},A);r.unref();try{let s=o(()=>V(n),"assertOwned"),c=await e(s);if(i)throw i;return await s(),c}finally{clearInterval(r),await n.handle.close(),await N(n)}}o(et,"withBuildLock");async function ot(t,e,n){let i=E(t,e.outputDir);await d(t,i,"outputDir"),await d(t,n,"build cache"),await u(i,n,"build cache");for(let r of e.versions.items){let s=a(t,r.docsDir,`versions.items[${r.id}].docsDir`);await d(t,s,`versions.items[${r.id}].docsDir`),await u(i,s,`versions.items[${r.id}].docsDir`),await u(n,s,`versions.items[${r.id}].docsDir`,"build cache")}for(let[r,s]of e.styles.entries()){let c=a(t,s,`styles[${r}]`);await d(t,c,`styles[${r}]`),await u(i,c,`styles[${r}]`),await u(n,c,`styles[${r}]`,"build cache")}return i}o(ot,"resolveSafeOutputRoot");export{Q as a,Y as b,Z as c,tt as d,et as e,ot as f};
+//# sourceMappingURL=chunk-S36HQTIA.js.map

package/dist/chunk-XYJ2OBL3.js

@@ -0,0 +1,2 @@
+import{a as e}from"./chunk-AYDF3IFZ.js";function h(a){let r=a.toLowerCase(),i=r.match(/[a-z0-9]+/g)??[],o=[];for(let f of r.matchAll(new RegExp("\\p{Script=Han}+","gu"))){let t=Array.from(f[0]);o.push(...t);for(let n=0;n<t.length-1;n+=1){let s=t[n],c=t[n+1];s&&c&&o.push(s+c)}}return Array.from(new Set([...i,...o]))}e(h,"tokenize");export{h as a};
+//# sourceMappingURL=chunk-XYJ2OBL3.js.map

package/dist/clean-KTIDWI35.js

@@ -0,0 +1,2 @@
+import{a as m,b as f,e as p,f as l}from"./chunk-S36HQTIA.js";import{j as s}from"./chunk-DOOG32NU.js";import{a as n}from"./chunk-5NTRNUFG.js";import"./chunk-GRQDPV4U.js";import"./chunk-EAYVCA3Z.js";import"./chunk-JK7ZNBUA.js";import{a as c}from"./chunk-AYDF3IFZ.js";import{readdir as R,rm as o}from"fs/promises";import{basename as h,dirname as g,join as b}from"path";async function x({cwd:t}){let i=await s(t),r=m(t),a=await l(t,i,r);await p(r,async()=>{let u=g(a),d=h(a).replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),w=new RegExp(`^\\.${d}\\.(?:backup|(?:tmp|backup)-[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12})$`,"i"),v=await R(u,{withFileTypes:!0}).catch(e=>{if(e.code==="ENOENT")return[];throw e});await Promise.all(v.filter(e=>w.test(e.name)).map(e=>o(b(u,e.name),{recursive:!0,force:!0}))),await o(a,{recursive:!0,force:!0}),await o(r,{recursive:!0,force:!0}),await o(f(t),{recursive:!0,force:!0})}),n(`Removed ${i.outputDir}, .docfuse/cache, and temporary or interrupted build files`)}c(x,"runClean");export{x as runClean};
+//# sourceMappingURL=clean-KTIDWI35.js.map

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import{b as f}from"./chunk-5NTRNUFG.js";import{a as l}from"./chunk-AYDF3IFZ.js";function u(n){let o=n.slice(1),t=o.flatMap((c,s)=>c==="--port"?[s]:[]);if(t.length>1)throw new Error("--port may only be specified once");let r=t[0];if(r===void 0){if(o.length)throw new Error(`Unknown option: ${o[0]}`);return}if(r!==0)throw new Error(`Unknown option: ${o[0]}`);let i=o[r+1];if(!i||i.startsWith("-"))throw new Error("Missing value for --port");if(o.length>2)throw new Error(`Unknown option: ${o[2]}`);let e=Number(i);if(!Number.isInteger(e)||e<1||e>65535)throw new Error(`Invalid port: ${i}`);return e}l(u,"portFromArgs");function d(n){let o=n.slice(1);if(!o.length)return{noCache:!1};if(o[0]!=="--no-cache")throw new Error(`Unknown option: ${o[0]}`);if(o.length>1)throw new Error(`Unknown option: ${o[1]}`);return{noCache:!0}}l(d,"buildOptionsFromArgs");function w(n){try{let o=Intl.getCanonicalLocales(n)[0];if(!o)throw new Error("Missing canonical locale");return o}catch{throw new Error(`Invalid locale: ${n}`)}}l(w,"canonicalLocale");function h(n){let o={},t=n.slice(1),r=new Set;for(let i=0;i<t.length;i+=1){let e=t[i];if(!e)continue;if(!e.startsWith("-")){if(o.targetDir)throw new Error(`Unknown option: ${e}`);o.targetDir=e;continue}if(e!=="--locale"&&e!=="--locales"&&e!=="--docs-dir")throw new Error(`Unknown option: ${e}`);if(r.has(e))throw new Error(`${e} may only be specified once`);r.add(e);let c=t[i+1];if(!c||c.startsWith("-"))throw new Error(`Missing value for ${e}`);if(i+=1,e==="--locale"&&(o.locale=c),e==="--locales"){let s=c.split(",").map(p=>p.trim());if(s.some(p=>!p))throw new Error("--locales must be a comma-separated list of locale identifiers");o.locales=s}e==="--docs-dir"&&(o.docsDir=c)}if(o.locale&&(o.locale=w(o.locale)),o.locales){if(o.locales=o.locales.map(w),new Set(o.locales).size!==o.locales.length)throw new Error("--locales must not contain duplicate locales");if(o.locale&&!o.locales.includes(o.locale))throw new Error(`--locale ${o.locale} must be included in --locales`);o.locale??=o.locales[0]}return o}l(h,"initOptionsFromArgs");function g(){console.log(`docfuse
+
+Commands:
+  init [dir] [--locale <locale>] [--locales <locale,...>] [--docs-dir <path>]
+                 Create or adopt documentation
+  dev [--port <number>]
+                 Start local docs server on a custom local port
+  build [--no-cache]
+                 Build static site, optionally ignoring the persistent cache
+  clean          Remove generated output and the persistent build cache
+  preview [--port <number>]
+                 Preview .docfuse/dist on a custom local port
+  check          Run documentation checks
+  deploy         Generate deployment guidance
+`)}l(g,"printHelp");function a(n,o){let t=n[o];if(t!==void 0)throw new Error(`Unknown option: ${t}`)}l(a,"assertArgumentCount");async function m(n,o=process.cwd()){let t=n[0]??"help";if(t==="help"||t==="--help"||t==="-h"){a(n,1),g();return}if(t==="init"){let{runInit:r}=await import("./init-NJUIADRO.js");return r({cwd:o,...h(n)})}if(t==="build"){let{runBuild:r}=await import("./build-X3KCJUYB.js");return r({cwd:o,...d(n)})}if(t==="clean"){a(n,1);let{runClean:r}=await import("./clean-KTIDWI35.js");return r({cwd:o})}if(t==="dev"){let{runDev:r}=await import("./dev-BMFVSQSM.js");return r({cwd:o,port:u(n)})}if(t==="preview"){let{runPreview:r}=await import("./preview-FI2XY4WS.js"),i=u(n);return r({cwd:o,port:i})}if(t==="check"){a(n,1);let{runCheck:r}=await import("./check-RJPHTGI6.js");return r({cwd:o})}if(t==="deploy"){a(n,1);let{runDeploy:r}=await import("./deploy-UPDSE6GI.js");return r({cwd:o})}throw new Error(`Unknown command: ${t}`)}l(m,"runCli");m(process.argv.slice(2)).catch(n=>{f(n instanceof Error?n.message:String(n)),process.exitCode=1});
+//# sourceMappingURL=cli.js.map

package/dist/deploy-UPDSE6GI.js

@@ -0,0 +1,144 @@
+import{j as g}from"./chunk-DOOG32NU.js";import{a as d}from"./chunk-5NTRNUFG.js";import"./chunk-EAYVCA3Z.js";import{a as i,e as f}from"./chunk-JK7ZNBUA.js";import{a}from"./chunk-AYDF3IFZ.js";import{mkdir as y,readFile as h,writeFile as $}from"fs/promises";import{join as r}from"path";function k(o){return`"${o.replace(/[\\"$]/g,"\\$&")}"`}a(k,"quoteNginxValue");async function b(o){if(await i(r(o,"pnpm-lock.yaml")))return"pnpm";if(await i(r(o,"yarn.lock")))return"yarn";try{let e=JSON.parse(await h(r(o,"package.json"),"utf8"));if(typeof e.packageManager=="string"){if(e.packageManager.startsWith("pnpm@"))return"pnpm";if(e.packageManager.startsWith("yarn@"))return"yarn"}}catch(e){if(e.code!=="ENOENT"&&!(e instanceof SyntaxError))throw e}return"npm"}a(b,"detectPackageManager");function w(o,e,s){let t=o.replaceAll("\\","/"),c=k(`/var/www/docfuse/${t.replace(/^\/+/,"")}`),u=e.replace(/\/$/,"").replace(/[.*+?^${}()|[\]\\]/g,"\\$&"),p=e==="/"?`  location / {
+    try_files $uri $uri/ =404;
+  }`:`  location = ${e.replace(/\/$/,"")} {
+    return 308 ${e};
+  }
+
+  location ${e} {
+    rewrite ^${u}/(.*)$ /$1 break;
+    try_files $uri $uri/ =404;
+  }
+
+  location / {
+    return 404;
+  }`,l=JSON.stringify(t),m={npm:"npm exec -- docfuse build",pnpm:"pnpm exec docfuse build",yarn:"yarn exec docfuse build"}[s],n=`Deploy directory:
+
+\`\`\`txt
+${t}
+\`\`\`
+
+Serve this directory at URL path \`${e}\`.
+
+Docfuse does not provide hosting, permissions, accounts, analytics, or server runtime.
+`;return{"README.md":`# Docfuse Deployment
+
+${n}
+
+Supported static hosts:
+
+- GitHub Pages
+- Cloudflare Pages
+- Vercel
+- Netlify
+- Nginx
+- Object storage
+`,"github-pages.md":`# GitHub Pages
+
+${n}
+
+Use \`${t}\` as the published static artifact.
+`,"github-pages.yml":`name: Deploy Docfuse
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  pages:
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: \${{ steps.deployment.outputs.page_url }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - uses: actions/configure-pages@v5
+      - name: Install dependencies
+        shell: bash
+        run: |
+          if [[ -f pnpm-lock.yaml ]]; then
+            corepack enable
+            pnpm install --frozen-lockfile
+          elif [[ -f yarn.lock ]]; then
+            corepack enable
+            yarn install --immutable
+          elif [[ -f package-lock.json ]]; then
+            npm ci
+          elif [[ -f package.json ]]; then
+            npm install
+          fi
+      - name: Build documentation
+        shell: bash
+        run: |
+          if [[ -f pnpm-lock.yaml ]]; then
+            pnpm exec docfuse build
+          elif [[ -f yarn.lock ]]; then
+            yarn exec docfuse build
+          elif [[ -f package.json ]]; then
+            npm exec -- docfuse build
+          else
+            echo "Add docfuse to package.json before deploying" >&2
+            exit 1
+          fi
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: ${l}
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+`,"cloudflare-pages.md":`# Cloudflare Pages
+
+${n}
+
+Set the output directory to \`${t}\`.
+`,"vercel.md":`# Vercel
+
+${n}
+
+Use \`${t}\` as the output directory.
+`,"vercel.json":`{
+  "outputDirectory": ${l}
+}
+`,"netlify.md":`# Netlify
+
+${n}
+
+Use \`${t}\` as the publish directory.
+`,"netlify.toml":`[build]
+  publish = ${l}
+  command = ${JSON.stringify(m)}
+`,"nginx.md":`# Nginx
+
+${n}
+
+Serve \`${t}\` as a static directory.
+`,"nginx.conf":`# NOTE: Update the 'root' path below to match your server's document root.
+# The default /var/www/docfuse/ is a placeholder \u2014 adjust it to where you
+# copied the built output (the contents of the '${t}' directory).
+server {
+  listen 80;
+  server_name _;
+  root ${c};
+  index index.html;
+  error_page 404 /404.html;
+
+  location = /404.html {
+    internal;
+  }
+
+${p}
+}
+`}}a(w,"createGuides");async function E({cwd:o}){let e=await g(o),s=f(o,e.outputDir);if(!await i(r(s,"index.html")))throw new Error(`Build output not found at ${e.outputDir}. Run docfuse build before docfuse deploy.`);let t=r(o,".docfuse/deploy"),c=await b(o);await y(t,{recursive:!0});for(let[u,p]of Object.entries(w(e.outputDir,e.basePath,c)))await $(r(t,u),p);d(`Wrote deployment guides to ${t}`)}a(E,"runDeploy");export{E as runDeploy};
+//# sourceMappingURL=deploy-UPDSE6GI.js.map

package/dist/dev-BMFVSQSM.js

@@ -0,0 +1,2 @@
+import{a as b}from"./chunk-FF7ZHS4U.js";import{b as g}from"./chunk-N26MW2YK.js";import"./chunk-M47X2MM3.js";import{b as h}from"./chunk-GNYJERGG.js";import"./chunk-XYJ2OBL3.js";import{a as B}from"./chunk-S36HQTIA.js";import"./chunk-DOOG32NU.js";import{a as v,b as f}from"./chunk-5NTRNUFG.js";import"./chunk-GRQDPV4U.js";import"./chunk-EAYVCA3Z.js";import{c as p,e as m}from"./chunk-JK7ZNBUA.js";import{a as o}from"./chunk-AYDF3IFZ.js";import w from"chokidar";import{createMarkdownRenderer as S}from"@docfuse/markdown/server";import{relative as P,resolve as k,sep as R}from"path";function D({build:i,reload:c,onBuildError:l=o(t=>f(t instanceof Error?t.message:String(t)),"onBuildError"),onBuildOk:n,debounceMs:s=80}){let t,u,e=!1,r=!1,a=o(()=>{if(t=void 0,!r){if(u){e=!0;return}u=(async()=>{try{let d=await i();r||(n?.(),c(d))}catch(d){l(d)}finally{u=void 0,e&&!r&&(e=!1,t=setTimeout(a,0))}})()}},"run");return{schedule(){if(!r){if(u){e=!0;return}t&&clearTimeout(t),t=setTimeout(a,s)}},async close(){r=!0,e=!1,t&&clearTimeout(t),t=void 0,await u}}}o(D,"createBuildScheduler");async function y({cwd:i,port:c}){let l=S(),n=await g({cwd:i,renderer:l}),s=await b({root:o(()=>m(i,n.config.outputDir),"root"),port:c,liveReload:!0,basePath:o(()=>n.config.basePath,"basePath")}),t=w.watch(".",{cwd:i,ignoreInitial:!0,ignored:o(e=>{let r=k(i,e),a=P(i,r).split(R);return a.includes("node_modules")||a.includes(".git")||a.includes(".docfuse")||a.some(d=>/^\..+\.(?:tmp|backup)-/.test(d))?!0:p(m(i,n.config.outputDir),r)||p(B(i),r)},"ignored")}),u=D({build:o(async()=>{n=await g({cwd:i,renderer:l});let e=n.changedPages.flatMap(r=>{let a=n.graph.pages.find(d=>d.sourceRelativePath===r);return a?[h(n.config,a.routePath)]:[]});return{protocol:1,type:"update",mode:n.partialReload&&e.length===1?"page":"full",routes:e}},"build"),reload:o(e=>s.reload(e),"reload"),onBuildError:o(e=>{let r=e instanceof Error?e.message:String(e);f("Build error:",r),s.sendBuildError(r)},"onBuildError"),onBuildOk:o(()=>s.sendBuildOk(),"onBuildOk")});return t.on("all",()=>u.schedule()),t.on("error",e=>{let r=e instanceof Error?e.message:String(e);f("File watcher error:",r),s.sendBuildError(r)}),{port:s.port,close:o(async()=>{await t.close(),await u.close(),await s.close()},"close")}}o(y,"startDevServer");async function z({cwd:i,port:c=3333}){let l=await y({cwd:i,port:c});return v(`Dev server running at http://127.0.0.1:${l.port}/`),l}o(z,"runDev");export{z as runDev};
+//# sourceMappingURL=dev-BMFVSQSM.js.map

package/dist/index.d.ts

@@ -0,0 +1,438 @@
+import { MarkdownHtmlPolicy, MarkdownCodeOptions, MarkdownFeatureOptions, MarkdownLabels, MarkdownPlugin } from '@docfuse/markdown';
+import { MarkdownThemeInput } from '@docfuse/markdown/theme';
+import { MarkdownHeading, MarkdownCodeExample } from '@docfuse/markdown/server/analyze';
+
+/** Package version injected by tsup so chunk nesting cannot affect lookup. */
+declare const docfuseVersion: string;
+
+declare const homeIconNames: readonly ["ai", "box", "code", "file", "file-code", "gauge", "globe", "layers", "rocket", "search", "sparkles", "terminal"];
+type HomeIconName = (typeof homeIconNames)[number];
+interface DocfuseFrontmatter {
+    title?: string;
+    description?: string;
+    createdAt?: string;
+    updatedAt?: string;
+    order?: number;
+    group?: string;
+    subgroup?: string;
+    collapsed?: boolean;
+    sidebar?: boolean;
+    layout?: 'document' | 'playground';
+    status?: 'draft' | 'published';
+    search?: boolean;
+    ai?: boolean;
+    tags?: string[];
+    owner?: string;
+    hero?: {
+        accent?: string;
+        tagline?: string;
+        image?: string;
+        imageAlt?: string;
+        actions?: Array<{
+            text: string;
+            link: string;
+            primary?: boolean;
+            icon?: HomeIconName;
+        }>;
+    };
+    features?: Array<{
+        icon?: HomeIconName;
+        image?: string;
+        title: string;
+        details: string;
+    }>;
+    [key: string]: unknown;
+}
+
+interface PageLink {
+    title: string;
+    routePath: string;
+}
+interface SidebarLink {
+    type: 'link';
+    title: string;
+    routePath: string;
+}
+interface SidebarTreeGroup {
+    type: 'group';
+    /** Stable identity among sibling directories; display titles may be translated or duplicated. */
+    segment: string;
+    title: string;
+    collapsed: boolean;
+    items: SidebarItem[];
+}
+type SidebarItem = SidebarLink | SidebarTreeGroup;
+interface SidebarGroup {
+    /** First directory segment under the locale; used to select a section sidebar. */
+    segment: string;
+    /** Section title used by automatic top navigation, not rendered inside the sidebar. */
+    title: string;
+    items: SidebarItem[];
+}
+interface NavItem {
+    title: string;
+    routePath: string;
+}
+interface DocPage {
+    sourcePath: string;
+    /** Complete source after extension transforms, including frontmatter and MDX imports. */
+    transformedSource: string;
+    /** Project-relative source path, including a version-specific docsDir. */
+    sourceRelativePath: string;
+    /** Path relative to this version's docs root. */
+    relativePath: string;
+    version: string;
+    versionBase: string;
+    docsDir: string;
+    locale: string;
+    routePath: string;
+    outputPath: string;
+    markdownOutputPath: string;
+    title: string;
+    description: string;
+    order: number;
+    /** First sub-directory segment under the locale, '' for root-level pages. */
+    group: string;
+    status: 'draft' | 'published';
+    search: boolean;
+    ai: boolean;
+    body: string;
+    headings: MarkdownHeading[];
+    searchText: string;
+    codeExamples: MarkdownCodeExample[];
+    lastUpdated: string;
+    previous?: PageLink;
+    next?: PageLink;
+    frontmatter: DocfuseFrontmatter;
+}
+interface ContentGraph {
+    pages: DocPage[];
+    /** Grouped sidebar entries per version and locale. */
+    sidebar: Record<string, Record<string, SidebarGroup[]>>;
+    /** Top navigation entries per version and locale. */
+    nav: Record<string, Record<string, NavItem[]>>;
+    locales: string[];
+    defaultLocale: string;
+    versions: Array<{
+        id: string;
+        label: string;
+        base: string;
+        docsDir: string;
+    }>;
+    currentVersion: string;
+}
+
+interface SearchProviderContext {
+    cwd: string;
+    config: DocfuseConfig;
+    graph: ContentGraph;
+    outputRoot: string;
+    publicPathFor(routePath: string): string;
+    resolveOutputPath(outputPath: string, label: string): string;
+}
+/**
+ * Whole-site index lifecycle. Unlike a Markdown plugin, a provider consumes the
+ * completed ContentGraph and output root; unlike an Extension, it owns only the
+ * configured search implementation's artifacts.
+ */
+interface SearchProvider {
+    readonly id: string;
+    /** Browser-side query protocol consumed by Docfuse's built-in search modal. */
+    readonly client: 'compact' | 'pagefind';
+    readonly version?: string;
+    /** Resolved JSON options used for build invalidation. Bump `version` when implementation changes. */
+    readonly cacheKey?: DocfuseJsonValue;
+    write(context: SearchProviderContext): Promise<void>;
+}
+
+declare const THEME_BASE_COLORS: readonly ["paper", "neutral", "slate", "zinc", "stone"];
+declare const DOCFUSE_MARKDOWN_ELEMENT_GROUP_IDS: readonly ["headings", "inline", "lists", "callouts", "code", "tables", "media", "diagrams", "disclosure", "extensions", "api", "metadata"];
+
+type ThemeBaseColor = (typeof THEME_BASE_COLORS)[number];
+type DocfuseMarkdownElementGroupId = (typeof DOCFUSE_MARKDOWN_ELEMENT_GROUP_IDS)[number];
+interface DocfuseNavigationItem {
+    text: string;
+    link: string;
+}
+interface DocfuseVersionItem {
+    id: string;
+    label: string;
+    docsDir: string;
+    /** Absolute URL base. The current version normally uses `/`. */
+    base: string;
+}
+interface DocfuseAdvertisement {
+    image: string;
+    href: string;
+    alt: string;
+    label?: string;
+}
+interface DocfuseSearchConfig {
+    enabled: boolean;
+    provider: 'compact' | SearchProvider;
+}
+type DocfuseJsonValue = string | number | boolean | null | DocfuseJsonValue[] | {
+    [key: string]: DocfuseJsonValue;
+};
+interface DocfuseExtensionDescriptor {
+    /** Project-relative TypeScript or JavaScript module. Extensions execute as trusted build code. */
+    resolve: string;
+    /** JSON-serializable factory options; functions and environment-specific values are rejected. */
+    options?: {
+        [key: string]: DocfuseJsonValue;
+    };
+}
+interface DocfuseLayoutLabels {
+    skipToContent: string;
+    search: string;
+    searchEmpty: string;
+    searchUnavailable: string;
+    language: string;
+    primaryNavigation: string;
+    theme: string;
+    openSidebar: string;
+    onThisPage: string;
+    edit: string;
+    updated: string;
+    previous: string;
+    next: string;
+    close: string;
+    source: string;
+    preview: string;
+    copySource: string;
+    sourceCopied: string;
+    quickActions: string;
+    github: string;
+    docsNavigation: string;
+    pageNavigation: string;
+    advertisement: string;
+    version: string;
+}
+interface DocfuseQuickActionMessages {
+    headingsTitle: string;
+    headingsDescription: string;
+    codeTitle: string;
+    codeDescription: string;
+    tableTitle: string;
+    tableDescription: string;
+    diagramTitle: string;
+    diagramDescription: string;
+    sourceDescription: string;
+    themeDescription: string;
+}
+interface DocfuseMarkdownElementGroupMessages {
+    label?: string;
+    detail?: string;
+    hash?: string;
+}
+interface DocfuseNotFoundMessages {
+    title: string;
+    description: string;
+    home: string;
+}
+interface DocfuseLocaleMessages {
+    labels?: Partial<DocfuseLayoutLabels>;
+    brandTagline?: string;
+    quickActions?: Partial<DocfuseQuickActionMessages>;
+    markdownElementGroups?: Partial<Record<DocfuseMarkdownElementGroupId, DocfuseMarkdownElementGroupMessages>>;
+    markdown?: Partial<MarkdownLabels>;
+    notFound?: Partial<DocfuseNotFoundMessages>;
+}
+/** Public authoring contract for docfuse.config.ts. Runtime validation uses the matching strict schema. */
+interface DocfuseConfigInput {
+    title?: string;
+    description?: string;
+    siteUrl?: string;
+    basePath?: string;
+    editUrl?: string;
+    github?: string;
+    requiredVersion?: string;
+    docsDir?: string;
+    outputDir?: string;
+    styles?: string[];
+    layout?: {
+        header?: boolean;
+    };
+    markdown?: {
+        html?: MarkdownHtmlPolicy;
+        code?: Pick<MarkdownCodeOptions, 'themes' | 'fallbackLanguage' | 'unknownLanguage'>;
+        features?: MarkdownFeatureOptions;
+        labels?: Partial<MarkdownLabels>;
+        /**
+         * Compiler plugins imported into docfuse.config.ts, e.g. from
+         * `@docfuse/plugins`. They execute as trusted build code; cache identity
+         * comes from each plugin's `name`, `version` and `cacheKey`.
+         */
+        plugins?: readonly MarkdownPlugin[];
+    };
+    theme?: {
+        logo?: string;
+        logoDark?: string;
+        favicon?: string;
+        accentColor?: string;
+        darkMode?: boolean;
+        radius?: number | string;
+        baseColor?: ThemeBaseColor;
+        sidebarWidth?: number | string;
+        outlineWidth?: number | string;
+        tokens?: MarkdownThemeInput;
+    };
+    search?: {
+        enabled?: boolean;
+        /** Use `compact` or a provider such as `pagefind()` from @docfuse/plugins. */
+        provider?: 'compact' | SearchProvider;
+    };
+    extensions?: DocfuseExtensionDescriptor[];
+    navigation?: Record<string, DocfuseNavigationItem[]>;
+    versions?: {
+        current: string;
+        items: DocfuseVersionItem[];
+    };
+    redirects?: Record<string, string>;
+    advertising?: DocfuseAdvertisement;
+    i18n?: {
+        defaultLocale?: string;
+        locales?: string[];
+        localeNames?: Record<string, string>;
+        messages?: Record<string, DocfuseLocaleMessages>;
+    };
+    ai?: {
+        llmsTxt?: boolean;
+        llmsFullTxt?: boolean;
+        markdownIndex?: boolean;
+        pageSummaries?: boolean;
+        codeExamples?: boolean;
+        /** Maximum encoded size of one ai/content JSONL shard. */
+        chunkSizeBytes?: number;
+        /** Maximum size of the legacy single-file llms-full.txt body. */
+        llmsFullMaxBytes?: number;
+        /** Write a manifest pointer or fail when llms-full.txt exceeds its budget. */
+        llmsFullOverflow?: 'manifest' | 'error';
+        /** Current avoids duplicate historical answers; all publishes every configured version. */
+        versions?: 'current' | 'all';
+    };
+}
+interface DocfuseConfig {
+    title: string;
+    description: string;
+    siteUrl?: string;
+    basePath: string;
+    editUrl?: string;
+    github?: string;
+    requiredVersion?: string;
+    docsDir: string;
+    outputDir: string;
+    styles: string[];
+    layout: {
+        header: boolean;
+    };
+    markdown: {
+        html: MarkdownHtmlPolicy;
+        code: MarkdownCodeOptions;
+        features: MarkdownFeatureOptions;
+        labels: Partial<MarkdownLabels>;
+        plugins: readonly MarkdownPlugin[];
+    };
+    theme: {
+        logo?: string;
+        logoDark?: string;
+        favicon?: string;
+        accentColor: string;
+        darkMode: boolean;
+        radius: number | string;
+        baseColor: ThemeBaseColor;
+        sidebarWidth: number | string;
+        outlineWidth: number | string;
+        tokens: MarkdownThemeInput;
+    };
+    search: DocfuseSearchConfig;
+    extensions: DocfuseExtensionDescriptor[];
+    navigation: Record<string, DocfuseNavigationItem[]>;
+    versions: {
+        current: string;
+        items: DocfuseVersionItem[];
+    };
+    redirects: Record<string, string>;
+    advertising?: DocfuseAdvertisement;
+    i18n: {
+        defaultLocale: string;
+        locales: string[];
+        localeNames?: Record<string, string>;
+        messages?: Record<string, DocfuseLocaleMessages>;
+    };
+    ai: {
+        llmsTxt: boolean;
+        llmsFullTxt: boolean;
+        markdownIndex: boolean;
+        pageSummaries: boolean;
+        codeExamples: boolean;
+        chunkSizeBytes: number;
+        llmsFullMaxBytes: number;
+        llmsFullOverflow: 'manifest' | 'error';
+        versions: 'current' | 'all';
+    };
+}
+
+/** Add contextual typing to docfuse.config.ts without changing its runtime value. */
+declare function defineConfig(config: DocfuseConfigInput): DocfuseConfigInput;
+
+declare function defineSearchProvider<T extends SearchProvider>(provider: T): T;
+
+declare const DOCFUSE_EXTENSION_API_VERSION: 1;
+interface DocfuseExtensionSourceContext {
+    source: string;
+    sourceRelativePath: string;
+    relativePath: string;
+    kind: 'markdown' | 'mdx';
+    version: string;
+    locale: string;
+}
+interface DocfuseExtensionPage {
+    sourceRelativePath: string;
+    relativePath: string;
+    version: string;
+    locale: string;
+    routePath: string;
+    title: string;
+    description: string;
+    status: 'draft' | 'published';
+    search: boolean;
+    ai: boolean;
+    body: string;
+    searchText: string;
+    frontmatter: DocfuseFrontmatter;
+}
+interface DocfuseExtensionPagePatch {
+    title?: string;
+    description?: string;
+    searchText?: string;
+    search?: boolean;
+    ai?: boolean;
+}
+interface DocfuseExtensionGenerateContext {
+    pages: readonly DocfuseExtensionPage[];
+    emitFile(path: string, content: string | Uint8Array): Promise<void>;
+}
+/**
+ * Versioned, semantic site-build contract. Compiler ASTs and internal render
+ * plugins intentionally stay private so upgrades do not depend on pipeline order.
+ * Per-document syntax belongs to MarkdownPlugin; whole-site search indexing
+ * belongs to SearchProvider.
+ */
+interface DocfuseExtension {
+    apiVersion: typeof DOCFUSE_EXTENSION_API_VERSION;
+    name: string;
+    /** Every generated path must be declared up front and is scoped under extensions/{name}/. */
+    outputs?: string[];
+    transformSource?(context: Readonly<DocfuseExtensionSourceContext>): string | Promise<string>;
+    extendPage?(page: Readonly<DocfuseExtensionPage>): DocfuseExtensionPagePatch | void | Promise<DocfuseExtensionPagePatch | void>;
+    generate?(context: DocfuseExtensionGenerateContext): void | Promise<void>;
+}
+type DocfuseExtensionOptions = {
+    [key: string]: DocfuseJsonValue;
+};
+type DocfuseExtensionFactory = (options: Readonly<DocfuseExtensionOptions>) => DocfuseExtension | Promise<DocfuseExtension>;
+declare function defineExtension(extension: DocfuseExtension): DocfuseExtension;
+declare function defineExtension(factory: DocfuseExtensionFactory): DocfuseExtensionFactory;
+
+export { DOCFUSE_EXTENSION_API_VERSION, type DocfuseConfigInput, type DocfuseExtension, type DocfuseExtensionDescriptor, type DocfuseExtensionFactory, type DocfuseExtensionGenerateContext, type DocfuseExtensionPage, type DocfuseExtensionPagePatch, type DocfuseExtensionSourceContext, type DocfuseJsonValue, type SearchProvider, type SearchProviderContext, defineConfig, defineExtension, defineSearchProvider, docfuseVersion };

package/dist/index.js

@@ -0,0 +1,2 @@
+import{c as n,f,g as r}from"./chunk-GNYJERGG.js";import"./chunk-XYJ2OBL3.js";import{a as t}from"./chunk-GRQDPV4U.js";import"./chunk-JK7ZNBUA.js";import{a as e}from"./chunk-AYDF3IFZ.js";function i(o){return o}e(i,"defineConfig");export{f as DOCFUSE_EXTENSION_API_VERSION,i as defineConfig,r as defineExtension,n as defineSearchProvider,t as docfuseVersion};
+//# sourceMappingURL=index.js.map