@vercel/geistdocs 1.11.3 → 1.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/cli/index.js CHANGED
@@ -1,3 +1,3 @@
1
1
  #!/usr/bin/env node
2
2
  import{program as T}from"commander";import{access as ce,copyFile as le}from"fs/promises";import{join as pe}from"path";import{cancel as de,intro as ge,isCancel as ue,log as fe,outro as me,spinner as he,text as we}from"@clack/prompts";import{spawn as te}from"child_process";import{readFileSync as se}from"fs";import{cp as ne,readFile as ae,rename as re,writeFile as ie}from"fs/promises";import{join as $}from"path";import{fileURLToPath as oe}from"url";var g="@vercel/geistdocs",m=(e,t=[],s={})=>new Promise((n,a)=>{let r=te(e,t,{stdio:"inherit",...s});r.on("error",a),r.on("close",i=>{if(i===0){n();return}a(new Error(`Command failed with exit code ${i}: ${[e,...t].join(" ")}`))})}),A=["dependencies","devDependencies","optionalDependencies","peerDependencies"],_=()=>JSON.parse(se(new URL("../../package.json",import.meta.url),"utf8")).version,P=async e=>{let t=$(e,"package.json"),s=await ae(t,"utf8");return JSON.parse(s)},x=async(e,t)=>{let s=$(e,"package.json");await ie(s,`${JSON.stringify(t,null,2)}
3
- `,"utf8")},R=(e,t)=>{for(let s of A){let n=e[s];if(n&&t in n)return n[t]}},V=(e,t)=>!!R(e,t),b=(e,t,s)=>{let n=!1;for(let a of A){let r=e[a];r&&t in r&&(r[t]=s,n=!0)}return n},j=()=>oe(new URL("../../template",import.meta.url)),F=async e=>{await ne(j(),e,{recursive:!0});let t=$(e,".gitignore"),s=$(e,"_gitignore");try{await re(s,t)}catch{}};var ye=async e=>{await F(e)},Pe=async e=>{try{return await ce(e),!0}catch{return!1}},ve=async()=>{await Pe(".env.example")&&await le(".env.example",".env.local")},Te=async e=>{let t=await P(e),s=_();return b(t,g,s)?(await x(e,t),!0):!1},ke=async e=>{await m("pnpm",["install"],{cwd:e,env:process.env,stdio:"inherit"})},$e=async e=>{await m("git",["init"],{cwd:e,env:process.env,stdio:"inherit"}),await m("git",["add","."],{cwd:e,env:process.env,stdio:"inherit"}),await m("git",["commit","-m","\u2728 Initial commit"],{cwd:e,env:process.env,stdio:"inherit"})},xe=async()=>{let e=await we({message:"What is your project named?",placeholder:"my-app",validate(t){if(t.length===0)return"Please enter a project name."}});return ue(e)&&(de("Operation cancelled."),process.exit(0)),e.toString()},G=async e=>{try{ge("Let's start a Geistdocs project!");let t=process.cwd(),s=e.name||await xe(),n=he(),a=pe(t,s);n.start("Copying bundled template..."),await ye(s),n.message("Setting up environment variables..."),process.chdir(a),await ve(),n.message("Rewriting package dependency versions..."),await Te(a),n.message("Installing dependencies..."),await ke(a),e.disableGit||(n.message("Initializing Git repository..."),await $e(a)),n.stop("Project initialized successfully!"),me("Run `pnpm dev` to start the development server.")}catch(t){let s=t instanceof Error?t.message:`Failed to initialize project: ${t}`;fe.error(s),process.exit(1)}};import{readFileSync as be,writeFileSync as Fe}from"fs";import{mkdir as De,readFile as N,writeFile as Se}from"fs/promises";import{dirname as Ce,extname as Re,relative as M,resolve as S}from"path";import{intro as je,isCancel as Ee,log as h,multiselect as Ne,outro as D,spinner as Ue}from"@clack/prompts";import{glob as Oe}from"glob";import{Node as v,Project as Ie,SyntaxKind as Je}from"ts-morph";var Le="geistdocs.tsx",Ae="content/docs/**/*.mdx",U=".translation-cache.json",E=8,B=()=>({version:1,entries:{}}),_e=async e=>{let t=await N(e),{createHash:s}=await import("crypto");return s("sha256").update(t).digest("hex")},Ve=e=>{let t=S(process.cwd(),e);return be(t,"utf8")},z=e=>v.isObjectLiteralExpression(e)?e.getProperties().flatMap(t=>{if(v.isPropertyAssignment(t)){let s=t.getNameNode();if(v.isIdentifier(s)||v.isStringLiteral(s))return[s.getText().replaceAll(/['"]/g,"")]}return[]}).filter(Boolean):[],Ge=e=>{try{let t=new Ie({compilerOptions:{allowJs:!0,jsx:4,module:99,target:10},skipAddingFilesFromTsConfig:!0,useInMemoryFileSystem:!0}),s=Ve(e),r=t.createSourceFile(e,s,{overwrite:!0}).getVariableDeclarations().find(l=>l.getName()==="translations")?.getInitializer();if(!r)return[];if(v.isObjectLiteralExpression(r))return z(r);let i=r.getFirstDescendantByKind(Je.ObjectLiteralExpression);return i?z(i):[]}catch(t){let s=t instanceof Error?t.message:`${t}`;return h.warn(`Failed to read locales from ${e}: ${s}`),[]}},Be=async()=>{let e=await Ne({message:"Which locales should be translated?",options:[{value:"cn",label:"Chinese (cn)"},{value:"jp",label:"Japanese (jp)"},{value:"es",label:"Spanish (es)"},{value:"fr",label:"French (fr)"},{value:"de",label:"German (de)"}],required:!0});return Ee(e)&&(D("Translation cancelled"),process.exit(0)),e},ze=async e=>(await Oe(e,{cwd:process.cwd(),absolute:!0,nodir:!0})).sort(),He=async()=>{let e=S(process.cwd(),U);try{let t=await N(e,"utf8"),s=JSON.parse(t);return s.version!==1||!s.entries?B():{version:1,entries:s.entries}}catch{return B()}},H=e=>{let t=S(process.cwd(),U),s=JSON.stringify(e,null,2);Fe(t,s,"utf8")},Me=async e=>{let t=await Promise.all(e.map(async s=>[s,await _e(s)]));return Object.fromEntries(t)},Ke=(e,t)=>{let s=Re(e);return`${e.slice(0,-s.length)}.${t}${s}`},K=(e,t)=>`${M(process.cwd(),e)}::${t}`,qe=(e,t,s,n,a=!1)=>{let r=[],i=0;for(let l of t){let c=s[l];for(let o of e){let d=Ke(l,o),u=K(l,o),f=n.entries[u];if(!a&&f?.hash===c){i+=1;continue}r.push({locale:o,sourceFile:l,sourceHash:c,targetFile:d})}}return{tasks:r,skippedCount:i}},Xe=async e=>{await De(Ce(e),{recursive:!0})},We=async(e,t,s)=>{let n=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({content:t,locale:s})});if(!n.ok){let r=await n.text();throw new Error(`API request failed (${n.status}): ${r}`)}let a=await n.json();if(!a.translation)throw new Error("API response did not include a translation");return a.translation},Ye=async(e,t,s)=>{let n=await N(e.sourceFile,"utf8"),a=await We(t,n,e.locale);await Xe(e.targetFile),await Se(e.targetFile,a,"utf8"),s.entries[K(e.sourceFile,e.locale)]={hash:e.sourceHash,updatedAt:new Date().toISOString()}},q=async(e,t)=>{je("Translate MDX content");let s=e??Ae,n=t.url||process.env.GEISTDOCS_TRANSLATE_URL||"https://geistdocs.com/translate",a=Ge(t.config??Le),r=await ze(s);r.length===0&&(h.error(`No MDX files found matching pattern: ${s}`),D("Translation cancelled"),process.exit(1)),h.info(`Found ${r.length} MDX file(s) matching pattern`),a.length===0&&(a=await Be());let i=S(process.cwd(),U),l=await He();await H(l),h.info(`Using cache: ${i}`);let c=await Me(r),{tasks:o,skippedCount:d}=qe(a,r,c,l,t.force);if(o.length===0){h.success("All translations are up to date!"),D(`Skipped ${d} file(s) (unchanged)`);return}let u=[];for(let y=0;y<o.length;y+=E)u.push(o.slice(y,y+E));h.info(`Processing ${o.length} translation(s) in ${u.length} batch(es) of up to ${E}`),d>0&&h.info(`Skipped ${d} translation(s) (unchanged)`);let f=Ue();f.start("Translating content...");let k=0;for(let y of u)await Promise.all(y.map(async L=>{await Ye(L,n,l),k+=1,f.message(`Translated ${k}/${o.length}: ${M(process.cwd(),L.targetFile)}`)})),await H(l);f.stop("Translation complete!"),D(`Created/updated ${o.length} file(s)`)};import{access as Ze,copyFile as Qe,mkdir as Z,rm as J}from"fs/promises";import{dirname as et,join as w}from"path";import{intro as tt,log as p,outro as C,spinner as Q}from"@clack/prompts";import{glob as st}from"glob";var nt=["**/*"],at=["content/docs/**"],O=".geistdocs-tmp",rt=async(e,t)=>{let s=w(e,t);await J(s,{recursive:!0,force:!0}),await Z(s,{recursive:!0})},I=async e=>await J(e,{recursive:!0,force:!0}),X=async(e,t,s)=>(await st(e,{cwd:s,nodir:!0,dot:!0,ignore:[".git/**",...t]})).sort(),it=async e=>{try{return await Ze(e),!0}catch{return!1}},ot=async(e,t,s)=>{let n=w(t,e),a=w(s,e);return await it(n)?(await Qe(n,a),{success:!0}):{success:!1,error:`Source file not found: ${n}`}},ct=async(e,t)=>{let s=w(t,e);return await J(s,{force:!0}),{success:!0}},W=20,Y=async(e,t,s)=>{let n=[];for(let a=0;a<e.length;a+=s){let r=e.slice(a,a+s),i=await Promise.all(r.map(t));n.push(...i)}return n},lt=async(e,t,s,n,a)=>{let r={success:[],deleted:[],failed:[]},i=[...new Set(e.map(c=>et(w(n,c))))];a.message(`Creating ${i.length} directories...`),await Promise.all(i.map(c=>Z(c,{recursive:!0}))),a.message(`Updating ${e.length} files...`);let l=await Y(e,async c=>{let o=await ot(c,s,n);return{file:c,...o}},W);for(let{file:c,success:o,error:d}of l)o?r.success.push(c):r.failed.push({file:c,error:d??"Unknown error"});if(t.length>0){a.message(`Deleting ${t.length} files...`);let c=await Y(t,async o=>{try{return await ct(o,n),{file:o,success:!0}}catch(d){let u=d instanceof Error?d.message:`${d}`;return{file:o,success:!1,error:u}}},W);for(let o of c)o.success?r.deleted.push(o.file):r.failed.push({file:o.file,error:o.error})}return r},pt=e=>{if(e.success.length>0){p.success(`Successfully updated ${e.success.length} files:`);for(let t of e.success)p.info(` \u2713 ${t}`)}if(e.deleted.length>0){p.success(`Deleted ${e.deleted.length} files:`);for(let t of e.deleted)p.info(` \u{1F5D1} ${t}`)}if(e.failed.length>0){p.warn(`Failed to update ${e.failed.length} files:`);for(let{file:t,error:s}of e.failed)p.error(` \u2717 ${t}: ${s}`)}},dt=e=>e.includes("canary")?"canary":"latest",gt=async e=>{let t=await fetch(`https://registry.npmjs.org/${encodeURIComponent(g)}`);if(!t.ok)throw new Error(`Failed to resolve ${g}@${e}`);let n=(await t.json())["dist-tags"]?.[e];if(!n)throw new Error(`Could not find dist-tag ${e} for ${g}`);return n},ut=async e=>{let t=await P(e),s=R(t,g);if(!s)return{currentVersion:s,nextVersion:void 0,updated:!1};let n=dt(s),a=await gt(n);return s===a?{currentVersion:s,nextVersion:a,updateTag:n,updated:!1}:(b(t,g,a),await x(e,t),{currentVersion:s,nextVersion:a,updateTag:n,updated:!0})},ft=async(e,t,s)=>{let n=await P(e);if(!V(n,g))return!1;t&&t.length>0&&p.warn("Ignoring file patterns for a package-based site. This update will bump the package version instead."),s?.sync&&p.warn("Ignoring --sync for a package-based site. Runtime updates now come from the package version.");let{currentVersion:a,nextVersion:r,updateTag:i,updated:l}=await ut(e);if(!l)return p.success(a?`@vercel/geistdocs is already at ${r} (${i}).`:"No package version update was needed."),C("Package-based site is already up to date."),!0;p.info(`Bumping ${g} from ${a} to ${r} (${i})`);let c=Q();return c.start("Installing updated package version..."),await m("pnpm",["install"],{cwd:e}),c.stop("Package update complete!"),C("Please review and test the upgraded package version."),!0},mt=async(e,t,s,n,a)=>{let r=w(e,O),i=Q(),l=a?.sync?r:t;i.start("Preparing template snapshot..."),a?.sync&&(await rt(e,O),await F(r)),i.message("Scanning for files...");let c=await X(s,n,l),o=[];if(a?.sync){i.message("Comparing with local files...");let u=await X(s,n,e),f=new Set(c);o=u.filter(k=>!f.has(k))}if(i.stop(`Found ${c.length} files to update`),c.length===0&&o.length===0){p.warn("No files matched the patterns. Nothing to update."),a?.sync&&await I(r),C("Update cancelled.");return}p.info(`Patterns: ${s.length}`),p.info(`Files to update: ${c.length}`),a?.sync&&p.info(`Files to delete: ${o.length}`),i.start("Updating files...");let d=await lt(c,o,l,e,i);a?.sync&&(i.message("Cleaning up..."),await I(r)),i.stop("Update complete!"),pt(d),C("Please review and test the changes carefully.")},ee=async(e,t)=>{let s=process.cwd(),n=j(),a=e&&e.length>0?e:nt,r=e&&e.length>0?[]:at;try{if(tt("Let's update your Geistdocs project!"),await ft(s,e,t))return;p.info("Template source: bundled package snapshot"),e&&e.length>0&&p.info(`Updating specific files: ${e.join(", ")}`),t?.sync&&p.info("Sync mode enabled: will delete files removed from template"),await mt(s,n,a,r,t)}catch(i){let l=i instanceof Error?i.message:`${i}`;try{await I(w(s,O))}catch{}p.error(`Failed to update project: ${l}`),process.exit(1)}};T.name("geistdocs").description("CLI for Geistdocs projects").version("1.11.3","-v, --version","Output the current version");T.command("init").description("Initialize a new Geistdocs project").option("--name <name>","Name of the project").option("--disable-git","Disable git initialization").action(G);T.command("update [files...]").description("Update a Geistdocs project (optionally specify files/patterns to update)").option("--sync","Delete local files that no longer exist in the template").action(ee);T.command("translate [pattern]").description("Translate MDX file(s) to one or more locales (default: content/docs/**/*.mdx)").option("--config <path>","Path to config file to load locales from (defaults to geistdocs.tsx)").option("--url <url>","Custom translation API URL (defaults to GEISTDOCS_TRANSLATE_URL or https://geistdocs.com/translate)").option("--force","Force re-translation of all files, ignoring cache").action(q);T.parse(process.argv);
3
+ `,"utf8")},R=(e,t)=>{for(let s of A){let n=e[s];if(n&&t in n)return n[t]}},V=(e,t)=>!!R(e,t),b=(e,t,s)=>{let n=!1;for(let a of A){let r=e[a];r&&t in r&&(r[t]=s,n=!0)}return n},j=()=>oe(new URL("../../template",import.meta.url)),F=async e=>{await ne(j(),e,{recursive:!0});let t=$(e,".gitignore"),s=$(e,"_gitignore");try{await re(s,t)}catch{}};var ye=async e=>{await F(e)},Pe=async e=>{try{return await ce(e),!0}catch{return!1}},ve=async()=>{await Pe(".env.example")&&await le(".env.example",".env.local")},Te=async e=>{let t=await P(e),s=_();return b(t,g,s)?(await x(e,t),!0):!1},ke=async e=>{await m("pnpm",["install"],{cwd:e,env:process.env,stdio:"inherit"})},$e=async e=>{await m("git",["init"],{cwd:e,env:process.env,stdio:"inherit"}),await m("git",["add","."],{cwd:e,env:process.env,stdio:"inherit"}),await m("git",["commit","-m","\u2728 Initial commit"],{cwd:e,env:process.env,stdio:"inherit"})},xe=async()=>{let e=await we({message:"What is your project named?",placeholder:"my-app",validate(t){if(t.length===0)return"Please enter a project name."}});return ue(e)&&(de("Operation cancelled."),process.exit(0)),e.toString()},G=async e=>{try{ge("Let's start a Geistdocs project!");let t=process.cwd(),s=e.name||await xe(),n=he(),a=pe(t,s);n.start("Copying bundled template..."),await ye(s),n.message("Setting up environment variables..."),process.chdir(a),await ve(),n.message("Rewriting package dependency versions..."),await Te(a),n.message("Installing dependencies..."),await ke(a),e.disableGit||(n.message("Initializing Git repository..."),await $e(a)),n.stop("Project initialized successfully!"),me("Run `pnpm dev` to start the development server.")}catch(t){let s=t instanceof Error?t.message:`Failed to initialize project: ${t}`;fe.error(s),process.exit(1)}};import{readFileSync as be,writeFileSync as Fe}from"fs";import{mkdir as De,readFile as N,writeFile as Se}from"fs/promises";import{dirname as Ce,extname as Re,relative as M,resolve as S}from"path";import{intro as je,isCancel as Ee,log as h,multiselect as Ne,outro as D,spinner as Ue}from"@clack/prompts";import{glob as Oe}from"glob";import{Node as v,Project as Ie,SyntaxKind as Je}from"ts-morph";var Le="geistdocs.tsx",Ae="content/docs/**/*.mdx",U=".translation-cache.json",E=8,B=()=>({version:1,entries:{}}),_e=async e=>{let t=await N(e),{createHash:s}=await import("crypto");return s("sha256").update(t).digest("hex")},Ve=e=>{let t=S(process.cwd(),e);return be(t,"utf8")},z=e=>v.isObjectLiteralExpression(e)?e.getProperties().flatMap(t=>{if(v.isPropertyAssignment(t)){let s=t.getNameNode();if(v.isIdentifier(s)||v.isStringLiteral(s))return[s.getText().replaceAll(/['"]/g,"")]}return[]}).filter(Boolean):[],Ge=e=>{try{let t=new Ie({compilerOptions:{allowJs:!0,jsx:4,module:99,target:10},skipAddingFilesFromTsConfig:!0,useInMemoryFileSystem:!0}),s=Ve(e),r=t.createSourceFile(e,s,{overwrite:!0}).getVariableDeclarations().find(l=>l.getName()==="translations")?.getInitializer();if(!r)return[];if(v.isObjectLiteralExpression(r))return z(r);let i=r.getFirstDescendantByKind(Je.ObjectLiteralExpression);return i?z(i):[]}catch(t){let s=t instanceof Error?t.message:`${t}`;return h.warn(`Failed to read locales from ${e}: ${s}`),[]}},Be=async()=>{let e=await Ne({message:"Which locales should be translated?",options:[{value:"cn",label:"Chinese (cn)"},{value:"jp",label:"Japanese (jp)"},{value:"es",label:"Spanish (es)"},{value:"fr",label:"French (fr)"},{value:"de",label:"German (de)"}],required:!0});return Ee(e)&&(D("Translation cancelled"),process.exit(0)),e},ze=async e=>(await Oe(e,{cwd:process.cwd(),absolute:!0,nodir:!0})).sort(),He=async()=>{let e=S(process.cwd(),U);try{let t=await N(e,"utf8"),s=JSON.parse(t);return s.version!==1||!s.entries?B():{version:1,entries:s.entries}}catch{return B()}},H=e=>{let t=S(process.cwd(),U),s=JSON.stringify(e,null,2);Fe(t,s,"utf8")},Me=async e=>{let t=await Promise.all(e.map(async s=>[s,await _e(s)]));return Object.fromEntries(t)},Ke=(e,t)=>{let s=Re(e);return`${e.slice(0,-s.length)}.${t}${s}`},K=(e,t)=>`${M(process.cwd(),e)}::${t}`,qe=(e,t,s,n,a=!1)=>{let r=[],i=0;for(let l of t){let c=s[l];for(let o of e){let d=Ke(l,o),u=K(l,o),f=n.entries[u];if(!a&&f?.hash===c){i+=1;continue}r.push({locale:o,sourceFile:l,sourceHash:c,targetFile:d})}}return{tasks:r,skippedCount:i}},Xe=async e=>{await De(Ce(e),{recursive:!0})},We=async(e,t,s)=>{let n=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({content:t,locale:s})});if(!n.ok){let r=await n.text();throw new Error(`API request failed (${n.status}): ${r}`)}let a=await n.json();if(!a.translation)throw new Error("API response did not include a translation");return a.translation},Ye=async(e,t,s)=>{let n=await N(e.sourceFile,"utf8"),a=await We(t,n,e.locale);await Xe(e.targetFile),await Se(e.targetFile,a,"utf8"),s.entries[K(e.sourceFile,e.locale)]={hash:e.sourceHash,updatedAt:new Date().toISOString()}},q=async(e,t)=>{je("Translate MDX content");let s=e??Ae,n=t.url||process.env.GEISTDOCS_TRANSLATE_URL||"https://geistdocs.com/translate",a=Ge(t.config??Le),r=await ze(s);r.length===0&&(h.error(`No MDX files found matching pattern: ${s}`),D("Translation cancelled"),process.exit(1)),h.info(`Found ${r.length} MDX file(s) matching pattern`),a.length===0&&(a=await Be());let i=S(process.cwd(),U),l=await He();await H(l),h.info(`Using cache: ${i}`);let c=await Me(r),{tasks:o,skippedCount:d}=qe(a,r,c,l,t.force);if(o.length===0){h.success("All translations are up to date!"),D(`Skipped ${d} file(s) (unchanged)`);return}let u=[];for(let y=0;y<o.length;y+=E)u.push(o.slice(y,y+E));h.info(`Processing ${o.length} translation(s) in ${u.length} batch(es) of up to ${E}`),d>0&&h.info(`Skipped ${d} translation(s) (unchanged)`);let f=Ue();f.start("Translating content...");let k=0;for(let y of u)await Promise.all(y.map(async L=>{await Ye(L,n,l),k+=1,f.message(`Translated ${k}/${o.length}: ${M(process.cwd(),L.targetFile)}`)})),await H(l);f.stop("Translation complete!"),D(`Created/updated ${o.length} file(s)`)};import{access as Ze,copyFile as Qe,mkdir as Z,rm as J}from"fs/promises";import{dirname as et,join as w}from"path";import{intro as tt,log as p,outro as C,spinner as Q}from"@clack/prompts";import{glob as st}from"glob";var nt=["**/*"],at=["content/docs/**"],O=".geistdocs-tmp",rt=async(e,t)=>{let s=w(e,t);await J(s,{recursive:!0,force:!0}),await Z(s,{recursive:!0})},I=async e=>await J(e,{recursive:!0,force:!0}),X=async(e,t,s)=>(await st(e,{cwd:s,nodir:!0,dot:!0,ignore:[".git/**",...t]})).sort(),it=async e=>{try{return await Ze(e),!0}catch{return!1}},ot=async(e,t,s)=>{let n=w(t,e),a=w(s,e);return await it(n)?(await Qe(n,a),{success:!0}):{success:!1,error:`Source file not found: ${n}`}},ct=async(e,t)=>{let s=w(t,e);return await J(s,{force:!0}),{success:!0}},W=20,Y=async(e,t,s)=>{let n=[];for(let a=0;a<e.length;a+=s){let r=e.slice(a,a+s),i=await Promise.all(r.map(t));n.push(...i)}return n},lt=async(e,t,s,n,a)=>{let r={success:[],deleted:[],failed:[]},i=[...new Set(e.map(c=>et(w(n,c))))];a.message(`Creating ${i.length} directories...`),await Promise.all(i.map(c=>Z(c,{recursive:!0}))),a.message(`Updating ${e.length} files...`);let l=await Y(e,async c=>{let o=await ot(c,s,n);return{file:c,...o}},W);for(let{file:c,success:o,error:d}of l)o?r.success.push(c):r.failed.push({file:c,error:d??"Unknown error"});if(t.length>0){a.message(`Deleting ${t.length} files...`);let c=await Y(t,async o=>{try{return await ct(o,n),{file:o,success:!0}}catch(d){let u=d instanceof Error?d.message:`${d}`;return{file:o,success:!1,error:u}}},W);for(let o of c)o.success?r.deleted.push(o.file):r.failed.push({file:o.file,error:o.error})}return r},pt=e=>{if(e.success.length>0){p.success(`Successfully updated ${e.success.length} files:`);for(let t of e.success)p.info(` \u2713 ${t}`)}if(e.deleted.length>0){p.success(`Deleted ${e.deleted.length} files:`);for(let t of e.deleted)p.info(` \u{1F5D1} ${t}`)}if(e.failed.length>0){p.warn(`Failed to update ${e.failed.length} files:`);for(let{file:t,error:s}of e.failed)p.error(` \u2717 ${t}: ${s}`)}},dt=e=>e.includes("canary")?"canary":"latest",gt=async e=>{let t=await fetch(`https://registry.npmjs.org/${encodeURIComponent(g)}`);if(!t.ok)throw new Error(`Failed to resolve ${g}@${e}`);let n=(await t.json())["dist-tags"]?.[e];if(!n)throw new Error(`Could not find dist-tag ${e} for ${g}`);return n},ut=async e=>{let t=await P(e),s=R(t,g);if(!s)return{currentVersion:s,nextVersion:void 0,updated:!1};let n=dt(s),a=await gt(n);return s===a?{currentVersion:s,nextVersion:a,updateTag:n,updated:!1}:(b(t,g,a),await x(e,t),{currentVersion:s,nextVersion:a,updateTag:n,updated:!0})},ft=async(e,t,s)=>{let n=await P(e);if(!V(n,g))return!1;t&&t.length>0&&p.warn("Ignoring file patterns for a package-based site. This update will bump the package version instead."),s?.sync&&p.warn("Ignoring --sync for a package-based site. Runtime updates now come from the package version.");let{currentVersion:a,nextVersion:r,updateTag:i,updated:l}=await ut(e);if(!l)return p.success(a?`@vercel/geistdocs is already at ${r} (${i}).`:"No package version update was needed."),C("Package-based site is already up to date."),!0;p.info(`Bumping ${g} from ${a} to ${r} (${i})`);let c=Q();return c.start("Installing updated package version..."),await m("pnpm",["install"],{cwd:e}),c.stop("Package update complete!"),C("Please review and test the upgraded package version."),!0},mt=async(e,t,s,n,a)=>{let r=w(e,O),i=Q(),l=a?.sync?r:t;i.start("Preparing template snapshot..."),a?.sync&&(await rt(e,O),await F(r)),i.message("Scanning for files...");let c=await X(s,n,l),o=[];if(a?.sync){i.message("Comparing with local files...");let u=await X(s,n,e),f=new Set(c);o=u.filter(k=>!f.has(k))}if(i.stop(`Found ${c.length} files to update`),c.length===0&&o.length===0){p.warn("No files matched the patterns. Nothing to update."),a?.sync&&await I(r),C("Update cancelled.");return}p.info(`Patterns: ${s.length}`),p.info(`Files to update: ${c.length}`),a?.sync&&p.info(`Files to delete: ${o.length}`),i.start("Updating files...");let d=await lt(c,o,l,e,i);a?.sync&&(i.message("Cleaning up..."),await I(r)),i.stop("Update complete!"),pt(d),C("Please review and test the changes carefully.")},ee=async(e,t)=>{let s=process.cwd(),n=j(),a=e&&e.length>0?e:nt,r=e&&e.length>0?[]:at;try{if(tt("Let's update your Geistdocs project!"),await ft(s,e,t))return;p.info("Template source: bundled package snapshot"),e&&e.length>0&&p.info(`Updating specific files: ${e.join(", ")}`),t?.sync&&p.info("Sync mode enabled: will delete files removed from template"),await mt(s,n,a,r,t)}catch(i){let l=i instanceof Error?i.message:`${i}`;try{await I(w(s,O))}catch{}p.error(`Failed to update project: ${l}`),process.exit(1)}};T.name("geistdocs").description("CLI for Geistdocs projects").version("1.12.0","-v, --version","Output the current version");T.command("init").description("Initialize a new Geistdocs project").option("--name <name>","Name of the project").option("--disable-git","Disable git initialization").action(G);T.command("update [files...]").description("Update a Geistdocs project (optionally specify files/patterns to update)").option("--sync","Delete local files that no longer exist in the template").action(ee);T.command("translate [pattern]").description("Translate MDX file(s) to one or more locales (default: content/docs/**/*.mdx)").option("--config <path>","Path to config file to load locales from (defaults to geistdocs.tsx)").option("--url <url>","Custom translation API URL (defaults to GEISTDOCS_TRANSLATE_URL or https://geistdocs.com/translate)").option("--force","Force re-translation of all files, ignoring cache").action(q);T.parse(process.argv);
@@ -1,13 +1,17 @@
1
1
  import { type ReactNode } from "react";
2
2
  import type { GeistdocsConfig } from "../config";
3
- interface GeistdocsPageActionsProps {
3
+ interface PageActionsProps {
4
4
  config: Pick<GeistdocsConfig, "ai" | "feedback" | "github" | "pageActions" | "siteId">;
5
- extraActions: ReactNode[];
6
5
  page: {
7
6
  path?: string;
8
7
  url: string;
9
8
  };
10
9
  }
11
- export declare const GeistdocsPageActions: ({ config, extraActions, page, }: GeistdocsPageActionsProps) => import("react/jsx-runtime").JSX.Element;
10
+ interface GeistdocsTableOfContentsActionsProps {
11
+ config: Pick<GeistdocsConfig, "feedback" | "pageActions" | "siteId">;
12
+ extraActions: ReactNode[];
13
+ }
14
+ export declare const GeistdocsPageActions: ({ config, page }: PageActionsProps) => import("react/jsx-runtime").JSX.Element | null;
15
+ export declare const GeistdocsTableOfContentsActions: ({ config, extraActions, }: GeistdocsTableOfContentsActionsProps) => import("react/jsx-runtime").JSX.Element;
12
16
  export {};
13
17
  //# sourceMappingURL=page-actions-client.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"page-actions-client.d.ts","sourceRoot":"","sources":["../../src/internal/page-actions-client.tsx"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,SAAS,EAIf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAcjD,UAAU,yBAAyB;IACjC,MAAM,EAAE,IAAI,CACV,eAAe,EACf,IAAI,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,GAAG,QAAQ,CACxD,CAAC;IACF,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,IAAI,EAAE;QACJ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAiUD,eAAO,MAAM,oBAAoB,GAAI,iCAIlC,yBAAyB,4CAuC3B,CAAC"}
1
+ {"version":3,"file":"page-actions-client.d.ts","sourceRoot":"","sources":["../../src/internal/page-actions-client.tsx"],"names":[],"mappings":"AAgBA,OAAO,EAGL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAmBjD,UAAU,gBAAgB;IACxB,MAAM,EAAE,IAAI,CACV,eAAe,EACf,IAAI,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,GAAG,QAAQ,CACxD,CAAC;IACF,IAAI,EAAE;QACJ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,UAAU,oCAAoC;IAC5C,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAC,CAAC;IACrE,YAAY,EAAE,SAAS,EAAE,CAAC;CAC3B;AA2aD,eAAO,MAAM,oBAAoB,GAAI,kBAAkB,gBAAgB,mDAoItE,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAAI,2BAG7C,oCAAoC,4CAiBtC,CAAC"}
@@ -1,17 +1,19 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
3
- import { SiGithub, SiMarkdown } from "@icons-pack/react-simple-icons";
3
+ import { SiGithub, SiMarkdown, SiV0 } from "@icons-pack/react-simple-icons";
4
4
  import { useCopyButton } from "fumadocs-ui/utils/use-copy-button";
5
- import { ArrowUpCircleIcon, CheckIcon, CopyIcon, ExternalLinkIcon, MessageCircleIcon, ThumbsUpIcon, } from "lucide-react";
5
+ import { ArrowUpCircleIcon, CheckIcon, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, CopyIcon, ExternalLinkIcon, MessageCircleIcon, ThumbsUpIcon, } from "lucide-react";
6
6
  import { usePathname } from "next/navigation";
7
- import { useEffect, useState, useTransition, } from "react";
7
+ import { useEffect, useRef, useState, useTransition, } from "react";
8
8
  import { useGeistdocsChat } from "./chat/context";
9
9
  import { sendFeedback } from "./feedback-action";
10
10
  import { Button } from "./ui/button";
11
- import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuTrigger, } from "./ui/dropdown-menu";
11
+ import { ButtonGroup } from "./ui/button-group";
12
+ import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, } from "./ui/dropdown-menu";
12
13
  import { Popover, PopoverContent, PopoverTrigger } from "./ui/popover";
13
14
  import { Textarea } from "./ui/textarea";
14
- const actionClassName = "group flex min-h-7 w-full min-w-0 items-center gap-2 rounded-md text-left text-gray-800 text-sm leading-5 transition-colors hover:text-gray-1000 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-gray-600 focus-visible:ring-offset-2 focus-visible:ring-offset-background-100 [&_svg]:size-3.5 [&_svg]:shrink-0 [&_span]:min-w-0 [&_span]:truncate";
15
+ import { useIsMobile } from "./use-mobile";
16
+ const actionClassName = "group flex min-h-8 w-full min-w-0 touch-manipulation items-center gap-2 rounded-md text-left text-gray-900 text-label-14 transition-colors hover:text-gray-1000 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-blue-700 focus-visible:ring-offset-2 focus-visible:ring-offset-background-100 motion-reduce:transition-none [&_svg]:size-4 [&_svg]:shrink-0 [&_span]:min-w-0 [&_span]:truncate";
15
17
  const DEFAULT_EDIT_PATH = "content/docs/{path}";
16
18
  const trimSlashes = (value) => value.replace(/^\/+|\/+$/g, "");
17
19
  const resolveEditPath = ({ editPath = DEFAULT_EDIT_PATH, path, }) => {
@@ -43,16 +45,6 @@ const openInProviders = [
43
45
  label: "Open in Claude",
44
46
  getHref: (query) => `https://claude.ai/new?${new URLSearchParams({ q: query }).toString()}`,
45
47
  },
46
- {
47
- id: "t3",
48
- label: "Open in T3 Chat",
49
- getHref: (query) => `https://t3.chat/new?${new URLSearchParams({ q: query }).toString()}`,
50
- },
51
- {
52
- id: "scira",
53
- label: "Open in Scira",
54
- getHref: (query) => `https://scira.ai/?${new URLSearchParams({ q: query }).toString()}`,
55
- },
56
48
  {
57
49
  id: "cursor",
58
50
  label: "Open in Cursor",
@@ -63,52 +55,40 @@ const openInProviders = [
63
55
  },
64
56
  },
65
57
  ];
66
- const EditSourceAction = ({ github, path, }) => {
67
- let url;
58
+ const getEditSourceUrl = ({ github, path, }) => {
68
59
  if (github?.owner && github?.repo && path) {
69
60
  const branch = github.branch ?? "main";
70
61
  const editPath = resolveEditPath({ editPath: github.editPath, path });
71
- url = `https://github.com/${github.owner}/${github.repo}/edit/${branch}/${editPath}`;
62
+ return `https://github.com/${github.owner}/${github.repo}/edit/${branch}/${editPath}`;
72
63
  }
73
- if (!url) {
74
- return null;
75
- }
76
- return (_jsxs("a", { className: actionClassName, href: url, rel: "noopener noreferrer", target: "_blank", children: [_jsx(SiGithub, { className: "size-3.5" }), _jsx("span", { children: "Edit this page on GitHub" })] }));
64
+ return undefined;
77
65
  };
78
66
  const getMarkdownUrl = (url) => url === "/docs" ? "/docs.md" : `${url}.md`;
79
- const CopyPageAction = ({ url }) => {
80
- const pathname = usePathname();
81
- const [checked, handleCopy] = useCopyButton(async () => {
82
- const response = await fetch(getMarkdownUrl(pathname || url));
83
- if (!response.ok) {
84
- throw new Error(`Failed to fetch markdown for ${url}`);
85
- }
86
- await navigator.clipboard.writeText(await response.text());
87
- });
88
- const Icon = checked ? CheckIcon : CopyIcon;
89
- return (_jsxs("button", { className: actionClassName, onClick: handleCopy, type: "button", children: [_jsx(Icon, { className: "size-3.5" }), _jsx("span", { children: "Copy page" })] }));
90
- };
91
- const OpenInChatAction = ({ href }) => {
67
+ const getPageQuery = (href, origin) => {
92
68
  const protocol = process.env.NODE_ENV === "production" ? "https" : "http";
93
- const url = new URL(href, `${protocol}://${process.env.NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL}`).toString();
94
- const query = `Read this page, I want to ask questions about it. ${url}`;
95
- return (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsxs("button", { className: actionClassName, type: "button", children: [_jsx(ExternalLinkIcon, {}), _jsx("span", { children: "Open in chat" })] }) }), _jsx(DropdownMenuContent, { align: "start", side: "top", children: openInProviders.map((provider, index) => (_jsxs("div", { children: [index === 1 ? _jsx(DropdownMenuSeparator, {}) : null, _jsx(DropdownMenuItem, { asChild: true, children: _jsxs("a", { className: "flex items-center gap-2", href: provider.getHref(query), rel: "noopener", target: "_blank", children: [_jsx("span", { className: "flex-1", children: provider.label }), _jsx(ExternalLinkIcon, { className: "size-4 shrink-0" })] }) })] }, provider.id))) })] }));
69
+ const productionHost = process.env.NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL;
70
+ const baseUrl = origin ?? (productionHost ? `${protocol}://${productionHost}` : undefined);
71
+ const url = baseUrl ? new URL(href, baseUrl).toString() : href;
72
+ return `Read this page, I want to ask questions about it. ${url}`;
96
73
  };
97
- const ScrollTopAction = () => (_jsxs("button", { className: actionClassName, onClick: () => window.scrollTo({ top: 0, behavior: "smooth" }), type: "button", children: [_jsx(ArrowUpCircleIcon, { className: "size-3.5" }), _jsx("span", { children: "Scroll to top" })] }));
98
- const AskAIAction = ({ href }) => {
99
- const { enabled, setIsOpen, setPrompt } = useGeistdocsChat();
100
- if (!enabled) {
101
- return null;
102
- }
103
- const protocol = process.env.NODE_ENV === "production" ? "https" : "http";
104
- const url = new URL(href, `${protocol}://${process.env.NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL}`).toString();
105
- const query = `Read this page, I want to ask questions about it. ${url}`;
106
- return (_jsxs("button", { className: actionClassName, onClick: () => {
107
- setPrompt(query);
108
- setIsOpen(true);
109
- }, type: "button", children: [_jsx(MessageCircleIcon, { className: "size-3.5" }), _jsx("span", { children: "Ask AI about this page" })] }));
74
+ const ScrollTopAction = () => (_jsxs("button", { className: actionClassName, onClick: () => {
75
+ const reduceMotion = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
76
+ window.scrollTo({ top: 0, behavior: reduceMotion ? "auto" : "smooth" });
77
+ }, type: "button", children: [_jsx(ArrowUpCircleIcon, { className: "size-3.5" }), _jsx("span", { children: "Scroll to top" })] }));
78
+ const PageActionMenuItemContent = ({ description, icon, title, }) => (_jsxs("span", { className: "grid w-full grid-cols-[20px_minmax(0,1fr)] items-center gap-3 text-left", children: [_jsx("span", { className: "flex size-5 items-center justify-center text-gray-900", children: icon }), _jsxs("span", { className: "flex min-w-0 flex-col items-start gap-0.5", children: [_jsx("span", { className: "text-gray-1000 text-label-14", children: title }), _jsx("span", { className: "text-copy-13 text-gray-900", children: description })] })] }));
79
+ const OpenInProviderItems = ({ providers, query, }) => providers.map((provider) => (_jsx(DropdownMenuItem, { asChild: true, children: _jsxs("a", { className: "flex items-center gap-2 text-label-14", href: provider.getHref(query), rel: "noopener noreferrer", target: "_blank", children: [_jsx("span", { className: "flex-1", translate: "no", children: provider.label }), _jsx(ExternalLinkIcon, { className: "size-4 shrink-0" })] }) }, provider.id)));
80
+ const ProviderMenuView = ({ backRef, onBack, providers, query, }) => (_jsxs(_Fragment, { children: [_jsxs(DropdownMenuItem, { className: "text-label-14", onSelect: (event) => {
81
+ event.preventDefault();
82
+ onBack();
83
+ }, ref: backRef, children: [_jsx(ChevronLeftIcon, { className: "size-4" }), _jsx("span", { children: "Back to page actions" })] }), _jsx(DropdownMenuSeparator, {}), _jsx(OpenInProviderItems, { providers: providers, query: query })] }));
84
+ const PageActionsMainMenu = ({ askAIEnabled, checked, copyEnabled, copyIcon, editSourceEnabled, editSourceUrl, handleCopy, isMobile, markdownUrl, onAskAI, onShowProviders, openInChatEnabled, openInChatRef, otherProviders, query, v0Provider, }) => {
85
+ return (_jsxs(_Fragment, { children: [copyEnabled ? (_jsxs(_Fragment, { children: [_jsx(DropdownMenuItem, { asChild: true, className: "h-auto w-full p-2", children: _jsx("button", { onClick: handleCopy, type: "button", children: _jsx(PageActionMenuItemContent, { description: "Copy page as Markdown for LLMs", icon: copyIcon, title: checked ? "Copied" : "Copy page" }) }) }), _jsx(DropdownMenuItem, { asChild: true, className: "h-auto p-2", children: _jsx("a", { href: markdownUrl, rel: "noopener noreferrer", target: "_blank", children: _jsx(PageActionMenuItemContent, { description: "Open this page as plain text", icon: _jsx(SiMarkdown, { "aria-hidden": "true", className: "size-4" }), title: "View as Markdown" }) }) })] })) : null, openInChatEnabled ? (_jsxs(_Fragment, { children: [_jsx(DropdownMenuItem, { asChild: true, className: "h-auto p-2", children: _jsx("a", { href: v0Provider.getHref(query), rel: "noopener noreferrer", target: "_blank", children: _jsx(PageActionMenuItemContent, { description: "Ask v0 to help apply this page", icon: _jsx(SiV0, { "aria-hidden": "true", className: "size-4" }), title: v0Provider.label }) }) }), isMobile ? (_jsxs(DropdownMenuItem, { className: "h-auto p-2", onSelect: (event) => {
86
+ event.preventDefault();
87
+ onShowProviders();
88
+ }, ref: openInChatRef, children: [_jsx(PageActionMenuItemContent, { description: "Use this page in another AI chat", icon: _jsx(ExternalLinkIcon, { className: "size-4" }), title: "Open in another chat" }), _jsx(ChevronRightIcon, { className: "size-4" })] })) : (_jsxs(DropdownMenuSub, { children: [_jsx(DropdownMenuSubTrigger, { className: "h-auto p-2", children: _jsx(PageActionMenuItemContent, { description: "Use this page in another AI chat", icon: _jsx(ExternalLinkIcon, { className: "size-4" }), title: "Open in another chat" }) }), _jsx(DropdownMenuSubContent, { className: "w-52", sideOffset: 12, children: _jsx(OpenInProviderItems, { providers: otherProviders, query: query }) })] }))] })) : null, askAIEnabled ? (_jsx(DropdownMenuItem, { className: "h-auto p-2", onSelect: onAskAI, children: _jsx(PageActionMenuItemContent, { description: "Chat with this page as context", icon: _jsx(MessageCircleIcon, { className: "size-4" }), title: "Ask AI about this page" }) })) : null, editSourceEnabled ? (_jsx(DropdownMenuItem, { asChild: true, className: "h-auto p-2", children: _jsx("a", { href: editSourceUrl, rel: "noopener noreferrer", target: "_blank", children: _jsx(PageActionMenuItemContent, { description: "Suggest changes to this page", icon: _jsx(SiGithub, { "aria-hidden": "true", className: "size-4" }), title: "Edit this page on GitHub" }) }) })) : null] }));
110
89
  };
111
90
  const FeedbackAction = ({ siteId }) => {
91
+ const isMobile = useIsMobile();
112
92
  const url = usePathname();
113
93
  const [submitted, setSubmitted] = useState(false);
114
94
  const [emotion, setEmotion] = useState(null);
@@ -139,33 +119,68 @@ const FeedbackAction = ({ siteId }) => {
139
119
  });
140
120
  });
141
121
  };
142
- return (_jsxs(Popover, { children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs("button", { className: actionClassName, type: "button", children: [_jsx(ThumbsUpIcon, { className: "size-3.5" }), _jsx("span", { children: "Give feedback" })] }) }), _jsx(PopoverContent, { className: "overflow-hidden p-0", children: _jsx("div", { className: "overflow-visible", children: submitted ? (_jsx("div", { className: "flex flex-col items-center gap-3 rounded-xl bg-background-200 px-3 py-6 text-center text-sm", children: _jsx("p", { children: "Thank you for your feedback!" }) })) : (_jsxs("form", { className: "flex flex-col", onSubmit: submit, children: [_jsx("div", { className: "p-2", children: _jsx(Textarea, { autoFocus: true, className: "max-h-48 min-h-24 shadow-none", onChange: (event) => setMessage(event.target.value), onKeyDown: (event) => {
122
+ return (_jsxs(Popover, { children: [_jsx(PopoverTrigger, { asChild: true, children: _jsxs("button", { className: actionClassName, type: "button", children: [_jsx(ThumbsUpIcon, { className: "size-3.5" }), _jsx("span", { children: "Give feedback" })] }) }), _jsx(PopoverContent, { className: "overflow-hidden p-0", children: _jsx("div", { className: "overflow-visible", children: submitted ? (_jsx("div", { className: "flex flex-col items-center gap-3 rounded-xl bg-background-200 px-3 py-6 text-center text-copy-14", role: "status", children: _jsx("p", { children: "Thank you for your feedback!" }) })) : (_jsxs("form", { className: "flex flex-col", onSubmit: submit, children: [_jsx("div", { className: "p-2", children: _jsx(Textarea, { "aria-label": "Feedback", autoComplete: "off", autoFocus: !isMobile, className: "max-h-48 min-h-24 shadow-none", name: "feedback", onChange: (event) => setMessage(event.target.value), onKeyDown: (event) => {
143
123
  if (!event.shiftKey && event.key === "Enter") {
144
124
  event.currentTarget.form?.requestSubmit();
145
125
  }
146
- }, placeholder: "Leave your feedback...", required: true, value: message }) }), _jsxs("div", { className: "flex items-center justify-end gap-1 px-2 text-gray-800", children: [_jsx(SiMarkdown, { className: "inline size-3" }), _jsx("p", { className: "text-xs", children: " supported" })] }), _jsxs("div", { className: "mt-2 flex items-center justify-between border-t bg-background-200 p-2", children: [_jsx("div", { className: "flex items-center gap-px", children: feedbackEmotions.map((entry) => (_jsxs(Button, { className: emotion === entry.name
126
+ }, placeholder: "Leave your feedback\u2026", required: true, value: message }) }), _jsxs("div", { className: "flex items-center justify-end gap-1 px-2 text-gray-900", children: [_jsx(SiMarkdown, { "aria-hidden": "true", className: "inline size-3" }), _jsx("p", { className: "text-label-12", children: " supported" })] }), _jsxs("div", { className: "mt-2 flex items-center justify-between border-t bg-background-200 p-2", children: [_jsx("div", { className: "flex items-center gap-px", children: feedbackEmotions.map((entry) => (_jsxs(Button, { className: emotion === entry.name
147
127
  ? "bg-gray-100 text-gray-1000"
148
- : "text-gray-800 hover:text-gray-1000", onClick: () => setEmotion(entry.name), size: "sm", type: "button", variant: "ghost", children: [entry.emoji, _jsx("span", { className: "sr-only", children: entry.name })] }, entry.name))) }), _jsx(Button, { disabled: isPending || !emotion || !message, size: "sm", type: "submit", variant: "default", children: "Send" })] })] })) }) })] }));
128
+ : "text-gray-900 hover:text-gray-1000", onClick: () => setEmotion(entry.name), size: "sm", type: "button", variant: "ghost", children: [entry.emoji, _jsx("span", { className: "sr-only", children: entry.name })] }, entry.name))) }), _jsx(Button, { disabled: isPending || !emotion || !message, size: "sm", type: "submit", variant: "default", children: "Send" })] })] })) }) })] }));
149
129
  };
150
- export const GeistdocsPageActions = ({ config, extraActions, page, }) => {
151
- const actions = [];
152
- if (config.pageActions?.editSource !== false) {
153
- actions.push(_jsx(EditSourceAction, { github: config.github, path: page.path }, "edit-source"));
130
+ export const GeistdocsPageActions = ({ config, page }) => {
131
+ const pathname = usePathname();
132
+ const isMobile = useIsMobile();
133
+ const { enabled: chatEnabled, setIsOpen, setPrompt } = useGeistdocsChat();
134
+ const [menuView, setMenuView] = useState("main");
135
+ const openInChatRef = useRef(null);
136
+ const providersBackRef = useRef(null);
137
+ const markdownUrl = getMarkdownUrl(pathname || page.url);
138
+ const [checked, handleCopy] = useCopyButton(async () => {
139
+ const response = await fetch(markdownUrl);
140
+ if (!response.ok) {
141
+ throw new Error(`Failed to fetch markdown from ${markdownUrl}`);
142
+ }
143
+ await navigator.clipboard.writeText(await response.text());
144
+ });
145
+ const editSourceUrl = getEditSourceUrl({
146
+ github: config.github,
147
+ path: page.path,
148
+ });
149
+ const query = getPageQuery(page.url);
150
+ const copyEnabled = config.pageActions?.copyPage !== false;
151
+ const openInChatEnabled = config.pageActions?.openInChat !== false;
152
+ const askAIEnabled = chatEnabled &&
153
+ config.ai?.enabled !== false &&
154
+ config.pageActions?.askAI !== false;
155
+ const editSourceEnabled = config.pageActions?.editSource !== false && Boolean(editSourceUrl);
156
+ if (!(copyEnabled || openInChatEnabled || askAIEnabled || editSourceEnabled)) {
157
+ return null;
154
158
  }
159
+ const v0Provider = openInProviders[0];
160
+ const otherProviders = openInProviders.slice(1);
161
+ const CopyStateIcon = checked ? CheckIcon : CopyIcon;
162
+ return (_jsxs("div", { className: "self-end sm:self-start", children: [_jsxs(ButtonGroup, { children: [copyEnabled ? (_jsxs(Button, { "aria-label": "Copy page", className: "touch-manipulation", onClick: handleCopy, size: "sm", type: "button", variant: "outline", children: [_jsx(CopyStateIcon, { className: "size-4" }), _jsxs("span", { className: "relative hidden sm:inline-block", children: [_jsx("span", { className: "invisible", children: "Copy page" }), _jsx("span", { className: "absolute inset-0", children: checked ? "Copied" : "Copy page" })] })] })) : null, _jsxs(DropdownMenu, { onOpenChange: (open) => {
163
+ if (!open) {
164
+ setMenuView("main");
165
+ }
166
+ }, children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsxs(Button, { "aria-label": copyEnabled ? "Open page actions" : "Page actions", className: copyEnabled ? "touch-manipulation px-2" : undefined, size: "sm", type: "button", variant: "outline", children: [copyEnabled ? null : _jsx("span", { children: "Page actions" }), _jsx(ChevronDownIcon, { className: "size-4" })] }) }), _jsx(DropdownMenuContent, { align: "end", className: "w-80 max-w-[calc(100vw-1rem)]", sideOffset: 8, children: isMobile && menuView === "providers" ? (_jsx(ProviderMenuView, { backRef: providersBackRef, onBack: () => {
167
+ setMenuView("main");
168
+ requestAnimationFrame(() => openInChatRef.current?.focus());
169
+ }, providers: otherProviders, query: query })) : (_jsx(PageActionsMainMenu, { askAIEnabled: askAIEnabled, checked: checked, copyEnabled: copyEnabled, copyIcon: _jsx(CopyStateIcon, { className: "size-4" }), editSourceEnabled: editSourceEnabled, editSourceUrl: editSourceUrl, handleCopy: handleCopy, isMobile: isMobile, markdownUrl: markdownUrl, onAskAI: () => {
170
+ setPrompt(getPageQuery(page.url, window.location.origin));
171
+ setIsOpen(true);
172
+ }, onShowProviders: () => {
173
+ setMenuView("providers");
174
+ requestAnimationFrame(() => providersBackRef.current?.focus());
175
+ }, openInChatEnabled: openInChatEnabled, openInChatRef: openInChatRef, otherProviders: otherProviders, query: query, v0Provider: v0Provider })) })] })] }), _jsx("span", { "aria-live": "polite", className: "sr-only", children: checked ? "Page copied" : "" })] }));
176
+ };
177
+ export const GeistdocsTableOfContentsActions = ({ config, extraActions, }) => {
178
+ const actions = [];
155
179
  if (config.pageActions?.scrollTop !== false) {
156
180
  actions.push(_jsx(ScrollTopAction, {}, "scroll-top"));
157
181
  }
158
182
  if (config.feedback?.enabled !== false) {
159
183
  actions.push(_jsx(FeedbackAction, { siteId: config.siteId }, "feedback"));
160
184
  }
161
- if (config.pageActions?.copyPage !== false) {
162
- actions.push(_jsx(CopyPageAction, { url: page.url }, "copy-page"));
163
- }
164
- if (config.ai?.enabled !== false && config.pageActions?.askAI !== false) {
165
- actions.push(_jsx(AskAIAction, { href: page.url }, "ask-ai"));
166
- }
167
- if (config.pageActions?.openInChat !== false) {
168
- actions.push(_jsx(OpenInChatAction, { href: page.url }, "open-in-chat"));
169
- }
170
185
  return (_jsxs(_Fragment, { children: [actions, extraActions] }));
171
186
  };
@@ -0,0 +1,16 @@
1
+ import { getBreadcrumbItems } from "fumadocs-core/breadcrumb";
2
+ type PageTreeRoot = Parameters<typeof getBreadcrumbItems>[1];
3
+ interface PageBreadcrumbProps {
4
+ tree: PageTreeRoot;
5
+ url: string;
6
+ }
7
+ /**
8
+ * Server-rendered breadcrumb. fumadocs' `<PageBreadcrumb>` derives items from
9
+ * `usePathname()`, which is empty during static prerender, so it mounts only on
10
+ * hydration and drops the title. Computing items from the page URL keeps it in
11
+ * the static HTML. Markup mirrors fumadocs' default options, so output is
12
+ * unchanged.
13
+ */
14
+ export declare const PageBreadcrumb: ({ tree, url }: PageBreadcrumbProps) => import("react/jsx-runtime").JSX.Element | null;
15
+ export {};
16
+ //# sourceMappingURL=page-breadcrumb.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"page-breadcrumb.d.ts","sourceRoot":"","sources":["../../src/internal/page-breadcrumb.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAM9D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7D,UAAU,mBAAmB;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,eAAe,mBAAmB,mDAiChE,CAAC"}
@@ -0,0 +1,23 @@
1
+ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
2
+ import { getBreadcrumbItems } from "fumadocs-core/breadcrumb";
3
+ import Link from "fumadocs-core/link";
4
+ import { ChevronRight } from "lucide-react";
5
+ import { Fragment } from "react";
6
+ import { cn } from "./cn";
7
+ /**
8
+ * Server-rendered breadcrumb. fumadocs' `<PageBreadcrumb>` derives items from
9
+ * `usePathname()`, which is empty during static prerender, so it mounts only on
10
+ * hydration and drops the title. Computing items from the page URL keeps it in
11
+ * the static HTML. Markup mirrors fumadocs' default options, so output is
12
+ * unchanged.
13
+ */
14
+ export const PageBreadcrumb = ({ tree, url }) => {
15
+ const items = getBreadcrumbItems(url, tree, {});
16
+ if (items.length === 0) {
17
+ return null;
18
+ }
19
+ return (_jsx("div", { className: "flex items-center gap-1.5 text-fd-muted-foreground text-sm", children: items.map((item, index) => {
20
+ const className = cn("truncate", index === items.length - 1 && "font-medium text-fd-primary");
21
+ return (_jsxs(Fragment, { children: [index !== 0 && _jsx(ChevronRight, { className: "size-3.5 shrink-0" }), item.url ? (_jsx(Link, { className: cn(className, "transition-opacity hover:opacity-80"), href: item.url, children: item.name })) : (_jsx("span", { className: className, children: item.name }))] }, item.url ?? String(item.name)));
22
+ }) }));
23
+ };
@@ -1 +1 @@
1
- {"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../src/internal/sidebar.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAG1F,OAAO,EAAY,KAAK,SAAS,EAAqB,MAAM,OAAO,CAAC;AAWpE,eAAO,MAAM,gBAAgB,GAAI,SAAS;IAAE,GAAG,CAAC,EAAE,SAAS,CAAA;CAAE,4CAwD5D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,yBAAyB,CAAC,QAAQ,CA2BtE,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,yBAAyB,CAAC,MAAM,CAWlE,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,yBAAyB,CAAC,WAAW,CAM1E,CAAC"}
1
+ {"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../src/internal/sidebar.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAG1F,OAAO,EAGL,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAuDf,eAAO,MAAM,gBAAgB,GAAI,SAAS;IAAE,GAAG,CAAC,EAAE,SAAS,CAAA;CAAE,4CAmE5D,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,yBAAyB,CAAC,QAAQ,CA2BtE,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,yBAAyB,CAAC,MAAM,CAoBlE,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,yBAAyB,CAAC,WAAW,CAM1E,CAAC"}
@@ -1,17 +1,65 @@
1
1
  "use client";
2
2
  import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { searchPath } from "fumadocs-core/breadcrumb";
3
4
  import { SidebarFolder, SidebarFolderContent, SidebarFolderLink, SidebarFolderTrigger, SidebarItem, SidebarSeparator, } from "fumadocs-ui/components/sidebar/base";
4
- import { useTreeContext, useTreePath } from "fumadocs-ui/contexts/tree";
5
- import { usePathname } from "next/navigation";
6
- import { Fragment, useEffect, useRef } from "react";
5
+ import { useTreeContext } from "fumadocs-ui/contexts/tree";
6
+ import { useParams, usePathname } from "next/navigation";
7
+ import { createContext, Fragment, useContext, useEffect, useMemo, useRef, } from "react";
7
8
  import { SearchButton } from "../controls";
8
9
  import { useGeistdocsSidebar } from "../sidebar";
9
10
  import { Sheet, SheetContent, SheetDescription, SheetHeader, SheetTitle, } from "./ui/sheet";
11
+ /**
12
+ * Ancestors of the active page, from route params instead of `usePathname()`
13
+ * (empty during static prerender, so fumadocs' `useTreePath()` leaves the
14
+ * active folder collapsed until hydration — shifting the sidebar). Params
15
+ * resolve at prerender, keeping the active section open in the initial HTML.
16
+ */
17
+ const SidebarActivePathContext = createContext([]);
18
+ const collectPageUrls = (nodes) => {
19
+ const urls = [];
20
+ for (const node of nodes) {
21
+ if (node.type === "page") {
22
+ urls.push(node.url);
23
+ }
24
+ else if (node.type === "folder") {
25
+ if (node.index) {
26
+ urls.push(node.index.url);
27
+ }
28
+ urls.push(...collectPageUrls(node.children));
29
+ }
30
+ }
31
+ return urls;
32
+ };
33
+ /**
34
+ * The active page's URL, found by matching the slug as a URL suffix rather than
35
+ * rebuilding it from a mount base — the base isn't reliably derivable from the
36
+ * tree (a site with all pages under one folder has no shared top-level prefix).
37
+ * The shallowest suffix match is the active page: any deeper match belongs to a
38
+ * page with a longer slug, so it can't be the one these params point to.
39
+ */
40
+ const findActiveUrl = (nodes, slug) => {
41
+ if (!slug) {
42
+ return;
43
+ }
44
+ const suffix = `/${slug}`;
45
+ return collectPageUrls(nodes)
46
+ .filter((url) => url.endsWith(suffix))
47
+ .sort((a, b) => a.split("/").length - b.split("/").length)
48
+ .at(0);
49
+ };
10
50
  export const GeistdocsSidebar = ({ top }) => {
11
- const { root } = useTreeContext();
51
+ const { root, full } = useTreeContext();
12
52
  const { isOpen, setIsOpen } = useGeistdocsSidebar();
13
53
  const pathname = usePathname();
14
54
  const previousPathname = useRef(pathname);
55
+ const params = useParams();
56
+ const slugKey = Array.isArray(params.slug)
57
+ ? params.slug.join("/")
58
+ : (params.slug ?? "");
59
+ const activePath = useMemo(() => {
60
+ const activeUrl = findActiveUrl(full.children, slugKey);
61
+ return activeUrl ? (searchPath(full.children, activeUrl) ?? []) : [];
62
+ }, [full, slugKey]);
15
63
  useEffect(() => {
16
64
  if (pathname !== previousPathname.current) {
17
65
  setIsOpen(false);
@@ -27,12 +75,19 @@ export const GeistdocsSidebar = ({ top }) => {
27
75
  }
28
76
  return _jsx(GeistdocsSidebarItem, { item: item }, item.$id);
29
77
  });
30
- return (_jsxs("div", { className: "pointer-events-none sticky top-(--fd-docs-row-1) z-20 h-[calc(var(--fd-docs-height)-var(--fd-docs-row-1))] [grid-area:sidebar] *:pointer-events-auto max-md:hidden md:layout:[--fd-sidebar-width:268px]", "data-sidebar-placeholder": true, children: [_jsxs("div", { className: "h-full overflow-y-auto px-4 pt-12 pb-4", children: [top ? _jsx("div", { className: "mb-4", children: top }) : null, _jsx(Fragment, { children: renderSidebarList(root.children) }, root.$id)] }), _jsx(Sheet, { onOpenChange: setIsOpen, open: isOpen, children: _jsxs(SheetContent, { className: "gap-0", side: "left", children: [_jsxs(SheetHeader, { className: "mt-8", children: [_jsx(SheetTitle, { className: "sr-only", children: "Mobile Menu" }), _jsx(SheetDescription, { className: "sr-only", children: "Navigation for the documentation." }), _jsx(SearchButton, { onClick: () => setIsOpen(false) })] }), _jsxs("div", { className: "flex-1 overflow-y-auto px-4 pb-4", children: [top ? _jsx("div", { className: "mb-4", children: top }) : null, renderSidebarList(root.children)] })] }) })] }));
78
+ return (_jsx(SidebarActivePathContext.Provider, { value: activePath, children: _jsxs("div", { className: "pointer-events-none sticky top-(--fd-docs-row-1) z-20 h-[calc(var(--fd-docs-height)-var(--fd-docs-row-1))] [grid-area:sidebar] *:pointer-events-auto max-md:hidden md:layout:[--fd-sidebar-width:268px]", "data-sidebar-placeholder": true, children: [_jsxs("div", { className: "h-full overflow-y-auto px-4 pt-12 pb-4", children: [top ? _jsx("div", { className: "mb-4", children: top }) : null, _jsx(Fragment, { children: renderSidebarList(root.children) }, root.$id)] }), _jsx(Sheet, { onOpenChange: setIsOpen, open: isOpen, children: _jsxs(SheetContent, { className: "gap-0", side: "left", children: [_jsxs(SheetHeader, { className: "mt-8", children: [_jsx(SheetTitle, { className: "sr-only", children: "Mobile Menu" }), _jsx(SheetDescription, { className: "sr-only", children: "Navigation for the documentation." }), _jsx(SearchButton, { onClick: () => setIsOpen(false) })] }), _jsxs("div", { className: "flex-1 overflow-y-auto px-4 pb-4", children: [top ? _jsx("div", { className: "mb-4", children: top }) : null, renderSidebarList(root.children)] })] }) })] }) }));
31
79
  };
32
80
  export const GeistdocsSidebarFolder = ({ children, item, }) => {
33
- const path = useTreePath();
34
- const defaultOpen = item.defaultOpen ?? path.includes(item);
81
+ const activePath = useContext(SidebarActivePathContext);
82
+ const defaultOpen = item.defaultOpen ?? activePath.includes(item);
35
83
  return (_jsxs(SidebarFolder, { defaultOpen: defaultOpen, children: [item.index ? (_jsxs(SidebarFolderLink, { className: "flex items-center gap-2 text-pretty py-1.5 text-gray-800 text-sm transition-colors hover:text-gray-1000 data-[active=true]:text-gray-1000 [&_svg]:size-3.5", external: item.index.external, href: item.index.url, children: [item.icon, item.name] })) : (_jsxs(SidebarFolderTrigger, { className: "flex items-center gap-2 text-pretty py-1.5 text-gray-800 text-sm transition-colors hover:text-gray-1000 [&_svg]:size-3.5", children: [item.icon, item.name] })), _jsx(SidebarFolderContent, { className: "ml-2", children: children })] }));
36
84
  };
37
- export const GeistdocsSidebarItem = ({ item, }) => (_jsx(SidebarItem, { className: "block w-full truncate text-pretty py-1.5 text-gray-800 text-sm transition-colors hover:text-gray-1000 data-[active=true]:text-gray-1000", external: item.external, href: item.url, icon: item.icon, children: item.name }));
85
+ export const GeistdocsSidebarItem = ({ item, }) => {
86
+ const activePath = useContext(SidebarActivePathContext);
87
+ // fumadocs' SidebarItem marks active from usePathname() (empty at prerender),
88
+ // so derive it from the params path (active page is its last node) to keep the
89
+ // marker in the static HTML. Overrides fumadocs' value, which is spread last.
90
+ const active = activePath.at(-1) === item;
91
+ return (_jsx(SidebarItem, { className: "block w-full truncate text-pretty py-1.5 text-gray-800 text-sm transition-colors hover:text-gray-1000 data-[active=true]:text-gray-1000", "data-active": active, external: item.external, href: item.url, icon: item.icon, children: item.name }));
92
+ };
38
93
  export const GeistdocsSidebarSeparator = ({ item }) => (_jsxs(SidebarSeparator, { className: "mt-4 mb-2 flex items-center gap-2 px-0 font-medium text-sm first-child:mt-0", children: [item.icon, item.name] }));
@@ -2,8 +2,9 @@ import type { TableOfContents } from "fumadocs-core/toc";
2
2
  import type { ReactNode } from "react";
3
3
  interface GeistdocsTableOfContentsProps {
4
4
  footer?: ReactNode;
5
+ header?: ReactNode;
5
6
  toc: TableOfContents;
6
7
  }
7
- export declare const GeistdocsTableOfContents: ({ footer, toc, }: GeistdocsTableOfContentsProps) => import("react/jsx-runtime").JSX.Element;
8
+ export declare const GeistdocsTableOfContents: ({ footer, header, toc, }: GeistdocsTableOfContentsProps) => import("react/jsx-runtime").JSX.Element;
8
9
  export {};
9
10
  //# sourceMappingURL=table-of-contents.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"table-of-contents.d.ts","sourceRoot":"","sources":["../../src/internal/table-of-contents.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,UAAU,6BAA6B;IACrC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,GAAG,EAAE,eAAe,CAAC;CACtB;AAED,eAAO,MAAM,wBAAwB,GAAI,kBAGtC,6BAA6B,4CAoB/B,CAAC"}
1
+ {"version":3,"file":"table-of-contents.d.ts","sourceRoot":"","sources":["../../src/internal/table-of-contents.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,UAAU,6BAA6B;IACrC,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,GAAG,EAAE,eAAe,CAAC;CACtB;AAED,eAAO,MAAM,wBAAwB,GAAI,0BAItC,6BAA6B,4CAqB/B,CAAC"}
@@ -2,4 +2,4 @@
2
2
  import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
3
3
  import { TOCItems } from "fumadocs-ui/components/toc/clerk";
4
4
  import { TOCScrollArea } from "fumadocs-ui/components/toc/index";
5
- export const GeistdocsTableOfContents = ({ footer, toc, }) => (_jsx("aside", { "aria-label": "Page navigation", className: "sticky top-(--fd-docs-row-1) hidden h-[calc(var(--fd-docs-height)-var(--fd-docs-row-1))] w-(--fd-toc-width) flex-col pt-12 pr-4 pb-2 [grid-area:toc] xl:flex", id: "nd-toc", children: _jsxs("nav", { "aria-label": "On this page", className: "flex min-h-0 flex-1 flex-col", children: [toc.length > 0 ? (_jsxs(_Fragment, { children: [_jsx("p", { className: "mb-2 font-medium text-gray-1000 text-sm", children: "On this page" }), _jsx(TOCScrollArea, { children: _jsx(TOCItems, {}) })] })) : null, footer] }) }));
5
+ export const GeistdocsTableOfContents = ({ footer, header, toc, }) => (_jsx("aside", { "aria-label": "Page navigation", className: "sticky top-(--fd-docs-row-1) hidden h-[calc(var(--fd-docs-height)-var(--fd-docs-row-1))] w-(--fd-toc-width) flex-col pt-12 pr-4 pb-2 [grid-area:toc] xl:flex", id: "nd-toc", children: _jsxs("nav", { "aria-label": "On this page", className: "flex min-h-0 flex-1 flex-col", children: [header, toc.length > 0 ? (_jsxs(_Fragment, { children: [_jsx("p", { className: "mb-2 font-medium text-gray-1000 text-sm", children: "On this page" }), _jsx(TOCScrollArea, { children: _jsx(TOCItems, {}) })] })) : null, footer] }) }));
@@ -1 +1 @@
1
- {"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../src/internal/ui/button.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAG5C,QAAA,MAAM,cAAc;;;8EA6BnB,CAAC;AAEF,KAAK,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC,GACzC,YAAY,CAAC,OAAO,cAAc,CAAC,GAAG;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEJ,wBAAgB,MAAM,CAAC,EACrB,SAAS,EACT,OAAO,EACP,IAAI,EACJ,OAAe,EACf,GAAG,KAAK,EACT,EAAE,WAAW,2CAUb;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}
1
+ {"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../src/internal/ui/button.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAG5C,QAAA,MAAM,cAAc;;;8EA8BnB,CAAC;AAEF,KAAK,WAAW,GAAG,cAAc,CAAC,QAAQ,CAAC,GACzC,YAAY,CAAC,OAAO,cAAc,CAAC,GAAG;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEJ,wBAAgB,MAAM,CAAC,EACrB,SAAS,EACT,OAAO,EACP,IAAI,EACJ,OAAe,EACf,GAAG,KAAK,EACT,EAAE,WAAW,2CAUb;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}
@@ -2,14 +2,14 @@ import { jsx as _jsx } from "react/jsx-runtime";
2
2
  import { cva } from "class-variance-authority";
3
3
  import { Slot as SlotPrimitive } from "radix-ui";
4
4
  import { cn } from "../cn";
5
- const buttonVariants = cva("inline-flex shrink-0 items-center justify-center gap-2 whitespace-nowrap rounded-md font-medium text-sm outline-none transition-all focus-visible:border-gray-600 focus-visible:ring-[3px] focus-visible:ring-gray-600/50 disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-red-800 aria-invalid:ring-red-800/20 dark:aria-invalid:ring-red-800/40 [&_svg:not([class*='size-'])]:size-4 [&_svg]:pointer-events-none [&_svg]:shrink-0", {
5
+ const buttonVariants = cva("inline-flex shrink-0 touch-manipulation items-center justify-center gap-2 whitespace-nowrap rounded-md text-button-14 outline-none transition-[background-color,border-color,box-shadow,color,opacity] focus-visible:ring-2 focus-visible:ring-blue-700 focus-visible:ring-offset-2 focus-visible:ring-offset-background-100 disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:border-red-800 aria-invalid:ring-red-800/20 motion-reduce:transition-none dark:aria-invalid:ring-red-800/40 [&_svg:not([class*='size-'])]:size-4 [&_svg]:pointer-events-none [&_svg]:shrink-0", {
6
6
  variants: {
7
7
  variant: {
8
8
  default: "bg-gray-1000 text-background-100 hover:bg-gray-1000/90",
9
9
  destructive: "bg-red-800 text-white hover:bg-red-800/90 focus-visible:ring-red-800/20 dark:bg-red-800/60 dark:focus-visible:ring-red-800/40",
10
- outline: "border bg-background-100 shadow-xs hover:bg-gray-100 hover:text-gray-1000 dark:border-gray-alpha-400 dark:bg-gray-alpha-400/30 dark:hover:bg-gray-alpha-400/50",
11
- secondary: "bg-gray-100 text-gray-1000 hover:bg-gray-100/80",
12
- ghost: "hover:bg-gray-100 hover:text-gray-1000 dark:hover:bg-gray-100/50",
10
+ outline: "border bg-background-100 shadow-xs hover:bg-gray-100 hover:text-gray-1000 active:border-gray-alpha-600 active:bg-gray-200 dark:border-gray-alpha-400 dark:bg-gray-alpha-400/30 dark:hover:bg-gray-alpha-400/50",
11
+ secondary: "bg-gray-100 text-gray-1000 hover:bg-gray-200 active:bg-gray-300",
12
+ ghost: "hover:bg-gray-100 hover:text-gray-1000 active:bg-gray-200 dark:hover:bg-gray-100/50",
13
13
  link: "text-gray-1000 underline-offset-4 hover:underline",
14
14
  },
15
15
  size: {
@@ -10,10 +10,10 @@ export function DropdownMenuTrigger(props) {
10
10
  return (_jsx(DropdownMenuPrimitive.Trigger, { "data-slot": "dropdown-menu-trigger", ...props }));
11
11
  }
12
12
  export function DropdownMenuContent({ className, sideOffset = 4, ...props }) {
13
- return (_jsx(DropdownMenuPrimitive.Portal, { children: _jsx(DropdownMenuPrimitive.Content, { className: cn("data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 max-h-(--radix-dropdown-menu-content-available-height) min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-y-auto overflow-x-hidden rounded-md bg-background-100 p-1 text-gray-1000 shadow-(--ds-shadow-menu) data-[state=closed]:animate-out data-[state=open]:animate-in", className), "data-slot": "dropdown-menu-content", sideOffset: sideOffset, ...props }) }));
13
+ return (_jsx(DropdownMenuPrimitive.Portal, { children: _jsx(DropdownMenuPrimitive.Content, { className: cn("data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 material-menu z-50 max-h-(--radix-dropdown-menu-content-available-height) min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-y-auto overflow-x-hidden overscroll-contain p-1 text-gray-1000 data-[state=closed]:animate-out data-[state=open]:animate-in motion-reduce:animate-none", className), "data-slot": "dropdown-menu-content", sideOffset: sideOffset, ...props }) }));
14
14
  }
15
15
  export function DropdownMenuItem({ className, inset, variant = "default", ...props }) {
16
- return (_jsx(DropdownMenuPrimitive.Item, { className: cn("data-[variant=destructive]:*:[svg]:!text-red-800 relative flex cursor-default select-none items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden focus:bg-gray-100 focus:text-gray-1000 data-[disabled]:pointer-events-none data-[inset]:pl-8 data-[variant=destructive]:text-red-800 data-[disabled]:opacity-50 data-[variant=destructive]:focus:bg-red-800/10 data-[variant=destructive]:focus:text-red-800 dark:data-[variant=destructive]:focus:bg-red-800/20 [&_svg:not([class*='size-'])]:size-4 [&_svg:not([class*='text-'])]:text-gray-800 [&_svg]:pointer-events-none [&_svg]:shrink-0", className), "data-inset": inset, "data-slot": "dropdown-menu-item", "data-variant": variant, ...props }));
16
+ return (_jsx(DropdownMenuPrimitive.Item, { className: cn("data-[variant=destructive]:*:[svg]:!text-red-800 relative flex cursor-default touch-manipulation select-none items-center gap-2 rounded-sm px-2 py-1.5 text-label-14 outline-hidden focus:bg-gray-100 focus:text-gray-1000 data-[disabled]:pointer-events-none data-[inset]:pl-8 data-[variant=destructive]:text-red-800 data-[disabled]:opacity-50 data-[variant=destructive]:focus:bg-red-800/10 data-[variant=destructive]:focus:text-red-800 dark:data-[variant=destructive]:focus:bg-red-800/20 [&_svg:not([class*='size-'])]:size-4 [&_svg:not([class*='text-'])]:text-gray-900 [&_svg]:pointer-events-none [&_svg]:shrink-0", className), "data-inset": inset, "data-slot": "dropdown-menu-item", "data-variant": variant, ...props }));
17
17
  }
18
18
  export function DropdownMenuLabel({ className, inset, ...props }) {
19
19
  return (_jsx(DropdownMenuPrimitive.Label, { className: cn("px-2 py-1.5 font-medium text-sm data-[inset]:pl-8", className), "data-inset": inset, "data-slot": "dropdown-menu-label", ...props }));
@@ -34,8 +34,8 @@ export function DropdownMenuSub(props) {
34
34
  return _jsx(DropdownMenuPrimitive.Sub, { "data-slot": "dropdown-menu-sub", ...props });
35
35
  }
36
36
  export function DropdownMenuSubTrigger({ className, inset, children, ...props }) {
37
- return (_jsxs(DropdownMenuPrimitive.SubTrigger, { className: cn("flex cursor-default select-none items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-hidden focus:bg-gray-100 focus:text-gray-1000 data-[state=open]:bg-gray-100 data-[inset]:pl-8 data-[state=open]:text-gray-1000 [&_svg:not([class*='size-'])]:size-4 [&_svg:not([class*='text-'])]:text-gray-800 [&_svg]:pointer-events-none [&_svg]:shrink-0", className), "data-inset": inset, "data-slot": "dropdown-menu-sub-trigger", ...props, children: [children, _jsx(ChevronRightIcon, { className: "ml-auto size-4" })] }));
37
+ return (_jsxs(DropdownMenuPrimitive.SubTrigger, { className: cn("flex cursor-default touch-manipulation select-none items-center gap-2 rounded-sm px-2 py-1.5 text-label-14 outline-hidden focus:bg-gray-100 focus:text-gray-1000 data-[state=open]:bg-gray-100 data-[inset]:pl-8 data-[state=open]:text-gray-1000 [&_svg:not([class*='size-'])]:size-4 [&_svg:not([class*='text-'])]:text-gray-900 [&_svg]:pointer-events-none [&_svg]:shrink-0", className), "data-inset": inset, "data-slot": "dropdown-menu-sub-trigger", ...props, children: [children, _jsx(ChevronRightIcon, { className: "ml-auto size-4" })] }));
38
38
  }
39
39
  export function DropdownMenuSubContent({ className, ...props }) {
40
- return (_jsx(DropdownMenuPrimitive.SubContent, { className: cn("data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-hidden rounded-md border bg-background-100 p-1 text-gray-1000 shadow-lg data-[state=closed]:animate-out data-[state=open]:animate-in", className), "data-slot": "dropdown-menu-sub-content", ...props }));
40
+ return (_jsx(DropdownMenuPrimitive.SubContent, { className: cn("data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 material-menu z-50 min-w-[8rem] origin-(--radix-dropdown-menu-content-transform-origin) overflow-hidden overscroll-contain p-1 text-gray-1000 data-[state=closed]:animate-out data-[state=open]:animate-in motion-reduce:animate-none", className), "data-slot": "dropdown-menu-sub-content", ...props }));
41
41
  }
@@ -9,5 +9,5 @@ export function PopoverTrigger(props) {
9
9
  return _jsx(PopoverPrimitive.Trigger, { "data-slot": "popover-trigger", ...props });
10
10
  }
11
11
  export function PopoverContent({ className, align = "center", sideOffset = 4, ...props }) {
12
- return (_jsx(PopoverPrimitive.Portal, { children: _jsx(PopoverPrimitive.Content, { align: align, className: cn("data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 z-50 w-72 origin-(--radix-popover-content-transform-origin) rounded-md border bg-background-100 p-4 text-gray-1000 shadow-md outline-hidden data-[state=closed]:animate-out data-[state=open]:animate-in", className), "data-slot": "popover-content", sideOffset: sideOffset, ...props }) }));
12
+ return (_jsx(PopoverPrimitive.Portal, { children: _jsx(PopoverPrimitive.Content, { align: align, className: cn("data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 material-menu z-50 w-72 origin-(--radix-popover-content-transform-origin) overscroll-contain p-4 text-gray-1000 outline-hidden data-[state=closed]:animate-out data-[state=open]:animate-in motion-reduce:animate-none", className), "data-slot": "popover-content", sideOffset: sideOffset, ...props }) }));
13
13
  }
@@ -9,6 +9,7 @@ type SourceBundle = GeistdocsSourceBundle;
9
9
  type GeistdocsPage = NonNullable<ReturnType<SourceBundle["source"]["getPage"]>>;
10
10
  type PageActionsBundle = ReturnType<typeof createPageActions>;
11
11
  type DocsPageLink = MDXComponents["a"];
12
+ type TableOfContentOptions = NonNullable<ComponentProps<typeof FumadocsDocsPage>["tableOfContent"]>;
12
13
  interface DocsPageParams {
13
14
  lang: string;
14
15
  slug?: string[];
@@ -58,9 +59,10 @@ interface CreateDocsPageOptions {
58
59
  source: SourceBundle;
59
60
  }) => DocsPageLink;
60
61
  source: SourceBundle;
62
+ tableOfContent?: TableOfContentOptions;
61
63
  tableOfContentPopover?: ComponentProps<typeof FumadocsDocsPage>["tableOfContentPopover"];
62
64
  }
63
- export declare const createDocsPage: ({ config, source, mdx, pageActions, filterStaticParams, getPageUrl, metadata, openGraph, renderTop, resolveLink, tableOfContentPopover, }: CreateDocsPageOptions) => {
65
+ export declare const createDocsPage: ({ config, source, mdx, pageActions, filterStaticParams, getPageUrl, metadata, openGraph, renderTop, resolveLink, tableOfContent, tableOfContentPopover, }: CreateDocsPageOptions) => {
64
66
  Page: ({ params, }: {
65
67
  params: Promise<{
66
68
  lang: string;
@@ -1 +1 @@
1
- {"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/pages/docs.tsx"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/pages/docs.tsx"],"names":[],"mappings":"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"}
@@ -1,18 +1,22 @@
1
- import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
1
+ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
2
2
  import { DocsBody as FumadocsDocsBody, DocsDescription as FumadocsDocsDescription, DocsPage as FumadocsDocsPage, DocsTitle as FumadocsDocsTitle, } from "fumadocs-ui/layouts/docs/page";
3
3
  import { createRelativeLink } from "fumadocs-ui/mdx";
4
4
  import { notFound } from "next/navigation";
5
5
  import { cn } from "../internal/cn";
6
6
  import { createPageActions as createInternalPageActions } from "../internal/page-actions";
7
- import { GeistdocsPageActions } from "../internal/page-actions-client";
7
+ import { GeistdocsPageActions, GeistdocsTableOfContentsActions, } from "../internal/page-actions-client";
8
+ import { PageBreadcrumb } from "../internal/page-breadcrumb";
8
9
  import { getPageFooterItems, PageFooter } from "../internal/page-footer";
9
10
  import { getPageRobots, } from "../internal/page-visibility";
10
11
  import { GeistdocsTableOfContents } from "../internal/table-of-contents";
11
12
  import { createMdxComponents } from "../mdx";
12
- const DocsTitle = ({ className, ...props }) => (_jsx(FumadocsDocsTitle, { className: cn("mb-4 text-4xl tracking-tight", className), ...props }));
13
+ const DocsTitle = ({ className, ...props }) => (_jsx(FumadocsDocsTitle, { className: cn("mb-4 text-balance text-4xl tracking-tight", className), ...props }));
13
14
  const DocsDescription = (props) => _jsx(FumadocsDocsDescription, { ...props });
14
15
  const DocsBody = ({ className, ...props }) => (_jsx(FumadocsDocsBody, { className: cn("mx-auto w-full", className), ...props }));
15
- export const createDocsPage = ({ config, source, mdx, pageActions = createInternalPageActions({ config }), filterStaticParams, getPageUrl, metadata, openGraph, renderTop, resolveLink, tableOfContentPopover, }) => {
16
+ const hasTableOfContentsActions = (config, extraActions) => config.pageActions?.scrollTop !== false ||
17
+ config.feedback?.enabled !== false ||
18
+ extraActions.length > 0;
19
+ export const createDocsPage = ({ config, source, mdx, pageActions = createInternalPageActions({ config }), filterStaticParams, getPageUrl, metadata, openGraph, renderTop, resolveLink, tableOfContent, tableOfContentPopover, }) => {
16
20
  const Page = async ({ params, }) => {
17
21
  const resolvedParams = await params;
18
22
  const { slug, lang } = resolvedParams;
@@ -64,15 +68,20 @@ export const createDocsPage = ({ config, source, mdx, pageActions = createIntern
64
68
  },
65
69
  }) ?? [])
66
70
  : [];
67
- const tocFooter = (_jsx("div", { className: "mt-3 border-gray-alpha-400 border-t pt-3", children: _jsx("nav", { "aria-label": "Page actions", className: "flex min-w-0 flex-col gap-1", children: _jsx(GeistdocsPageActions, { config: pageActions.config, extraActions: footerActions, page: {
68
- path: page.path,
69
- url: pageUrl,
70
- } }) }) }));
71
- return (_jsxs(FumadocsDocsPage, { footer: { component: _jsx(PageFooter, { ...resolvedFooterItems }) }, full: data.full, tableOfContent: {
71
+ const hasTocActions = hasTableOfContentsActions(pageActions.config, footerActions);
72
+ const tocFooter = (_jsxs(_Fragment, { children: [tableOfContent?.footer, hasTocActions ? (_jsx("div", { className: "mt-4 border-gray-alpha-400 border-t pt-4", children: _jsx("nav", { "aria-label": "Page actions", className: "flex min-w-0 flex-col gap-1", children: _jsx(GeistdocsTableOfContentsActions, { config: pageActions.config, extraActions: footerActions }) }) })) : null] }));
73
+ const tocComponent = tableOfContent?.component ?? (_jsx(GeistdocsTableOfContents, { footer: tocFooter, header: tableOfContent?.header, toc: data.toc ?? [] }));
74
+ return (_jsxs(FumadocsDocsPage, { breadcrumb: {
75
+ component: (_jsx(PageBreadcrumb, { tree: source.source.getPageTree(lang), url: page.url })),
76
+ }, footer: { component: _jsx(PageFooter, { ...resolvedFooterItems }) }, full: data.full, tableOfContent: {
72
77
  enabled: true,
73
78
  single: true,
74
- component: (_jsx(GeistdocsTableOfContents, { footer: tocFooter, toc: data.toc ?? [] })),
75
- }, tableOfContentPopover: tableOfContentPopover, toc: data.toc, children: [renderTop?.({ data, markdown: markdown ?? "", page, pageUrl }), _jsx(DocsTitle, { children: data.title }), _jsx(DocsDescription, { children: data.description }), _jsx(DocsBody, { children: _jsx(MDX, { components: {
79
+ ...tableOfContent,
80
+ component: tocComponent,
81
+ }, tableOfContentPopover: tableOfContentPopover, toc: data.toc, children: [renderTop?.({ data, markdown: markdown ?? "", page, pageUrl }), _jsxs("div", { className: "flex flex-col-reverse gap-4 sm:flex-row sm:items-start sm:justify-between", children: [_jsx(DocsTitle, { className: "mb-0 min-w-0", children: data.title }), _jsx(GeistdocsPageActions, { config: pageActions.config, page: {
82
+ path: page.path,
83
+ url: pageUrl,
84
+ } })] }), _jsx(DocsDescription, { children: data.description }), _jsx(DocsBody, { children: _jsx(MDX, { components: {
76
85
  ...createMdxComponents({ a: link }),
77
86
  ...resolvedMdx,
78
87
  } }) })] }));
package/docs/agents.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Geistdocs Package Docs
2
2
 
3
- These docs are bundled with `@vercel/geistdocs` 1.11.3 so agents can understand the installed package without web access.
3
+ These docs are bundled with `@vercel/geistdocs` 1.12.0 so agents can understand the installed package without web access.
4
4
  They are generated from `apps/template/content/docs` during the package build.
5
5
 
6
6
  ## How to use these files
@@ -39,6 +39,7 @@ They are generated from `apps/template/content/docs` during the package build.
39
39
  - [Feedback](pages/feedback.md): An interactive feedback widget that collects user sentiment and creates structured GitHub Issues automatically.
40
40
  - [Internationalization](pages/internationalization.md): Serve documentation in multiple languages with automatic translation via the Geistdocs CLI and Fumadocs routing.
41
41
  - [llms.txt](pages/llms-txt.md): A single endpoint that returns all documentation as plain Markdown text following the llms.txt standard.
42
+ - [Nested navigation](pages/guides/nested-navigation.md): How Geistdocs builds breadcrumbs from your page tree.
42
43
  - [Open in Chat](pages/open-in-chat.md): Transfer documentation context to AI chat platforms like ChatGPT, Claude, Cursor, and v0 with a single click.
43
44
  - [RSS](pages/rss.md): An automatically generated RSS 2.0 feed that keeps users informed when documentation is published or updated.
44
45
  - [Theme-Aware Image](pages/theme-aware-image.md): A component that swaps images based on the active theme, built on top of Next.js Image.
package/docs/llms.txt CHANGED
@@ -1,6 +1,6 @@
1
1
  # Geistdocs Package Documentation
2
2
 
3
- These docs are bundled with `@vercel/geistdocs` 1.11.3.
3
+ These docs are bundled with `@vercel/geistdocs` 1.12.0.
4
4
  They describe how to build package-backed Geistdocs sites and how to use the package APIs from generated project adapters.
5
5
 
6
6
  ## Documentation Index
@@ -22,6 +22,7 @@ They describe how to build package-backed Geistdocs sites and how to use the pac
22
22
  - [Feedback](pages/feedback.md): An interactive feedback widget that collects user sentiment and creates structured GitHub Issues automatically.
23
23
  - [Internationalization](pages/internationalization.md): Serve documentation in multiple languages with automatic translation via the Geistdocs CLI and Fumadocs routing.
24
24
  - [llms.txt](pages/llms-txt.md): A single endpoint that returns all documentation as plain Markdown text following the llms.txt standard.
25
+ - [Nested navigation](pages/guides/nested-navigation.md): How Geistdocs builds breadcrumbs from your page tree.
25
26
  - [Open in Chat](pages/open-in-chat.md): Transfer documentation context to AI chat platforms like ChatGPT, Claude, Cursor, and v0 with a single click.
26
27
  - [RSS](pages/rss.md): An automatically generated RSS 2.0 feed that keeps users informed when documentation is published or updated.
27
28
  - [Theme-Aware Image](pages/theme-aware-image.md): A component that swaps images based on the active theme, built on top of Next.js Image.
@@ -934,7 +935,7 @@ To serve docs from the site root, use `route: "/"` in `content` and `baseUrl: "/
934
935
 
935
936
  ## Page actions
936
937
 
937
- Page actions appear below the table of contents. They are enabled by default and can be disabled through `defineConfig` in `lib/geistdocs/config.tsx`:
938
+ Content actions appear in the **Copy page** menu beside the page title. **Scroll to top** and **Give feedback** remain below the table of contents so they stay available while you read. These actions are enabled by default and can be disabled through `defineConfig` in `lib/geistdocs/config.tsx`:
938
939
 
939
940
  ```tsx title="lib/geistdocs/config.tsx"
940
941
  export const config = defineConfig({
@@ -1018,10 +1019,14 @@ const docsPage = createDocsPage({
1018
1019
  },
1019
1020
  metadata: ({ metadata }) => metadata,
1020
1021
  mdx: ({ link }) => getMDXComponents({ a: link }),
1022
+ tableOfContent: {
1023
+ header: <div className="mb-3">Above the table of contents</div>,
1024
+ footer: <div className="mt-3">Below the table of contents</div>,
1025
+ },
1021
1026
  });
1022
1027
  ```
1023
1028
 
1024
- Use `getPageUrl` when the public route differs from the source URL, such as `/v5/docs`. Set `openGraph.images` to `true` only when your site includes the Geistdocs OG route. Use `metadata` to set canonical URLs, `robots`, or custom Open Graph fields for a specific route.
1029
+ Use `getPageUrl` when the public route differs from the source URL, such as `/v5/docs`. Set `openGraph.images` to `true` only when your site includes the Geistdocs OG route. Use `metadata` to set canonical URLs, `robots`, or custom Open Graph fields for a specific route. The `tableOfContent.header` and `tableOfContent.footer` slots render immediately above and below the table of contents.
1025
1030
 
1026
1031
  ## Package-owned runtime
1027
1032
 
@@ -2745,6 +2750,33 @@ The llms.txt standard is a simple convention that makes documentation more acces
2745
2750
  Learn more at [llmstxt.org](https://llmstxt.org/)
2746
2751
 
2747
2752
 
2753
+ ---
2754
+
2755
+ ---
2756
+ title: Nested navigation
2757
+ description: How Geistdocs builds breadcrumbs from your page tree.
2758
+ type: guide
2759
+ url: /docs/guides/nested-navigation
2760
+ source: apps/template/content/docs/guides/nested-navigation.mdx
2761
+ ---
2762
+
2763
+ # Nested navigation
2764
+
2765
+ Any page nested inside a folder shows a breadcrumb above its title, built
2766
+ automatically from the page tree. This page lives under the **Guides** folder,
2767
+ so the breadcrumb above reads _Guides_.
2768
+
2769
+ ## How it works
2770
+
2771
+ The breadcrumb lists the folder ancestors of the current page, in order. It is
2772
+ rendered on the server from the page's URL and the sidebar tree, so it is
2773
+ present in the initial HTML — the page title never shifts once the page
2774
+ hydrates.
2775
+
2776
+ Top-level pages (those not inside a folder) have no ancestors, so no breadcrumb
2777
+ is shown.
2778
+
2779
+
2748
2780
  ---
2749
2781
 
2750
2782
  ---
@@ -161,6 +161,14 @@
161
161
  "type": "conceptual",
162
162
  "url": "/docs/llms-txt"
163
163
  },
164
+ {
165
+ "description": "How Geistdocs builds breadcrumbs from your page tree.",
166
+ "path": "pages/guides/nested-navigation.md",
167
+ "source": "apps/template/content/docs/guides/nested-navigation.mdx",
168
+ "title": "Nested navigation",
169
+ "type": "guide",
170
+ "url": "/docs/guides/nested-navigation"
171
+ },
164
172
  {
165
173
  "description": "Allow users to continue conversations in their preferred AI chat platform with a single click",
166
174
  "path": "pages/open-in-chat.md",
@@ -190,5 +198,5 @@
190
198
  }
191
199
  ],
192
200
  "source": "apps/template/content/docs",
193
- "version": "1.11.3"
201
+ "version": "1.12.0"
194
202
  }
@@ -178,7 +178,7 @@ To serve docs from the site root, use `route: "/"` in `content` and `baseUrl: "/
178
178
 
179
179
  ## Page actions
180
180
 
181
- Page actions appear below the table of contents. They are enabled by default and can be disabled through `defineConfig` in `lib/geistdocs/config.tsx`:
181
+ Content actions appear in the **Copy page** menu beside the page title. **Scroll to top** and **Give feedback** remain below the table of contents so they stay available while you read. These actions are enabled by default and can be disabled through `defineConfig` in `lib/geistdocs/config.tsx`:
182
182
 
183
183
  ```tsx title="lib/geistdocs/config.tsx"
184
184
  export const config = defineConfig({
@@ -262,10 +262,14 @@ const docsPage = createDocsPage({
262
262
  },
263
263
  metadata: ({ metadata }) => metadata,
264
264
  mdx: ({ link }) => getMDXComponents({ a: link }),
265
+ tableOfContent: {
266
+ header: <div className="mb-3">Above the table of contents</div>,
267
+ footer: <div className="mt-3">Below the table of contents</div>,
268
+ },
265
269
  });
266
270
  ```
267
271
 
268
- Use `getPageUrl` when the public route differs from the source URL, such as `/v5/docs`. Set `openGraph.images` to `true` only when your site includes the Geistdocs OG route. Use `metadata` to set canonical URLs, `robots`, or custom Open Graph fields for a specific route.
272
+ Use `getPageUrl` when the public route differs from the source URL, such as `/v5/docs`. Set `openGraph.images` to `true` only when your site includes the Geistdocs OG route. Use `metadata` to set canonical URLs, `robots`, or custom Open Graph fields for a specific route. The `tableOfContent.header` and `tableOfContent.footer` slots render immediately above and below the table of contents.
269
273
 
270
274
  ## Package-owned runtime
271
275
 
@@ -0,0 +1,23 @@
1
+ ---
2
+ title: Nested navigation
3
+ description: How Geistdocs builds breadcrumbs from your page tree.
4
+ type: guide
5
+ url: /docs/guides/nested-navigation
6
+ source: apps/template/content/docs/guides/nested-navigation.mdx
7
+ ---
8
+
9
+ # Nested navigation
10
+
11
+ Any page nested inside a folder shows a breadcrumb above its title, built
12
+ automatically from the page tree. This page lives under the **Guides** folder,
13
+ so the breadcrumb above reads _Guides_.
14
+
15
+ ## How it works
16
+
17
+ The breadcrumb lists the folder ancestors of the current page, in order. It is
18
+ rendered on the server from the page's URL and the sidebar tree, so it is
19
+ present in the initial HTML — the page title never shifts once the page
20
+ hydrates.
21
+
22
+ Top-level pages (those not inside a folder) have no ancestors, so no breadcrumb
23
+ is shown.
package/docs/sitemap.md CHANGED
@@ -20,6 +20,7 @@ Use it to choose focused page files from `docs/pages/` before reading the full `
20
20
  - [Feedback](pages/feedback.md) | URL: /docs/feedback | Type: integration | Summary: An interactive feedback widget that collects user sentiment and creates structured GitHub Issues automatically.
21
21
  - [Internationalization](pages/internationalization.md) | URL: /docs/internationalization | Type: guide | Summary: Serve documentation in multiple languages with automatic translation via the Geistdocs CLI and Fumadocs routing.
22
22
  - [llms.txt](pages/llms-txt.md) | URL: /docs/llms-txt | Type: conceptual | Summary: A single endpoint that returns all documentation as plain Markdown text following the llms.txt standard.
23
+ - [Nested navigation](pages/guides/nested-navigation.md) | URL: /docs/guides/nested-navigation | Type: guide
23
24
  - [Open in Chat](pages/open-in-chat.md) | URL: /docs/open-in-chat | Type: conceptual | Summary: Transfer documentation context to AI chat platforms like ChatGPT, Claude, Cursor, and v0 with a single click.
24
25
  - [RSS](pages/rss.md) | URL: /docs/rss | Type: conceptual | Summary: An automatically generated RSS 2.0 feed that keeps users informed when documentation is published or updated.
25
26
  - [Theme-Aware Image](pages/theme-aware-image.md) | URL: /docs/theme-aware-image | Type: reference | Summary: A component that swaps images based on the active theme, built on top of Next.js Image.
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@vercel/geistdocs",
3
3
  "description": "Runtime and CLI for Geistdocs projects.",
4
- "version": "1.11.3",
4
+ "version": "1.12.0",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
7
7
  "type": "git",
@@ -176,7 +176,7 @@ To serve docs from the site root, use `route: "/"` in `content` and `baseUrl: "/
176
176
 
177
177
  ## Page actions
178
178
 
179
- Page actions appear below the table of contents. They are enabled by default and can be disabled through `defineConfig` in `lib/geistdocs/config.tsx`:
179
+ Content actions appear in the **Copy page** menu beside the page title. **Scroll to top** and **Give feedback** remain below the table of contents so they stay available while you read. These actions are enabled by default and can be disabled through `defineConfig` in `lib/geistdocs/config.tsx`:
180
180
 
181
181
  ```tsx title="lib/geistdocs/config.tsx"
182
182
  export const config = defineConfig({
@@ -260,10 +260,14 @@ const docsPage = createDocsPage({
260
260
  },
261
261
  metadata: ({ metadata }) => metadata,
262
262
  mdx: ({ link }) => getMDXComponents({ a: link }),
263
+ tableOfContent: {
264
+ header: <div className="mb-3">Above the table of contents</div>,
265
+ footer: <div className="mt-3">Below the table of contents</div>,
266
+ },
263
267
  });
264
268
  ```
265
269
 
266
- Use `getPageUrl` when the public route differs from the source URL, such as `/v5/docs`. Set `openGraph.images` to `true` only when your site includes the Geistdocs OG route. Use `metadata` to set canonical URLs, `robots`, or custom Open Graph fields for a specific route.
270
+ Use `getPageUrl` when the public route differs from the source URL, such as `/v5/docs`. Set `openGraph.images` to `true` only when your site includes the Geistdocs OG route. Use `metadata` to set canonical URLs, `robots`, or custom Open Graph fields for a specific route. The `tableOfContent.header` and `tableOfContent.footer` slots render immediately above and below the table of contents.
267
271
 
268
272
  ## Package-owned runtime
269
273
 
@@ -0,0 +1,4 @@
1
+ {
2
+ "title": "Guides",
3
+ "pages": ["nested-navigation"]
4
+ }
@@ -0,0 +1,19 @@
1
+ ---
2
+ title: Nested navigation
3
+ description: How Geistdocs builds breadcrumbs from your page tree.
4
+ type: guide
5
+ ---
6
+
7
+ Any page nested inside a folder shows a breadcrumb above its title, built
8
+ automatically from the page tree. This page lives under the **Guides** folder,
9
+ so the breadcrumb above reads _Guides_.
10
+
11
+ ## How it works
12
+
13
+ The breadcrumb lists the folder ancestors of the current page, in order. It is
14
+ rendered on the server from the page's URL and the sidebar tree, so it is
15
+ present in the initial HTML — the page title never shifts once the page
16
+ hydrates.
17
+
18
+ Top-level pages (those not inside a folder) have no ancestors, so no breadcrumb
19
+ is shown.
@@ -5,6 +5,7 @@
5
5
  "pages": [
6
6
  "index",
7
7
  "getting-started",
8
+ "guides",
8
9
  "env",
9
10
  "deployment",
10
11
  "migration",
@@ -18,7 +18,7 @@
18
18
  "@streamdown/code": "^1.0.1",
19
19
  "@vercel/agent-readability": "^0.2.1",
20
20
  "@vercel/analytics": "^1.6.1",
21
- "@vercel/geistdocs": "1.11.3",
21
+ "@vercel/geistdocs": "1.12.0",
22
22
  "@vercel/speed-insights": "^1.3.1",
23
23
  "ai": "^6.0.132",
24
24
  "class-variance-authority": "^0.7.1",