@vercel/geistdocs 1.13.0 → 1.14.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 +1 -1
- package/dist/config.d.ts +5 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +35 -0
- package/dist/footer.d.ts +1 -1
- package/dist/footer.d.ts.map +1 -1
- package/dist/footer.js +1 -1
- package/dist/internal/chat/shell.d.ts.map +1 -1
- package/dist/internal/chat/shell.js +2 -1
- package/dist/internal/footer/rss-button.d.ts +3 -1
- package/dist/internal/footer/rss-button.d.ts.map +1 -1
- package/dist/internal/footer/rss-button.js +2 -1
- package/dist/internal/localized-link.d.ts.map +1 -1
- package/dist/internal/localized-link.js +9 -4
- package/dist/internal/page-actions-client.d.ts +1 -0
- package/dist/internal/page-actions-client.d.ts.map +1 -1
- package/dist/internal/page-actions-client.js +1 -3
- package/dist/internal/search.d.ts.map +1 -1
- package/dist/internal/search.js +2 -1
- package/dist/internal/version-paths.d.ts +49 -0
- package/dist/internal/version-paths.d.ts.map +1 -0
- package/dist/internal/version-paths.js +57 -0
- package/dist/pages/docs.d.ts +25 -7
- package/dist/pages/docs.d.ts.map +1 -1
- package/dist/pages/docs.js +40 -8
- package/dist/proxy.d.ts +4 -3
- package/dist/proxy.d.ts.map +1 -1
- package/dist/proxy.js +124 -46
- package/dist/routes/agents.d.ts +1 -1
- package/dist/routes/agents.d.ts.map +1 -1
- package/dist/routes/agents.js +27 -16
- package/dist/routes/chat.d.ts +1 -1
- package/dist/routes/chat.d.ts.map +1 -1
- package/dist/routes/chat.js +18 -11
- package/dist/routes/discovery.d.ts +6 -2
- package/dist/routes/discovery.d.ts.map +1 -1
- package/dist/routes/discovery.js +6 -12
- package/dist/routes/sitemap.d.ts +3 -2
- package/dist/routes/sitemap.d.ts.map +1 -1
- package/dist/routes/sitemap.js +18 -5
- package/dist/source.d.ts +39 -2
- package/dist/source.d.ts.map +1 -1
- package/dist/source.js +111 -13
- package/dist/versions.d.ts +22 -2
- package/dist/versions.d.ts.map +1 -1
- package/dist/versions.js +26 -3
- package/docs/agents.md +1 -1
- package/docs/llms.txt +117 -2
- package/docs/manifest.json +1 -1
- package/docs/pages/configuration.md +23 -1
- package/docs/pages/md.md +4 -0
- package/docs/pages/migration.md +4 -0
- package/docs/pages/proxy.md +15 -0
- package/docs/pages/rss.md +2 -0
- package/docs/pages/versioned-docs.md +68 -0
- package/package.json +1 -1
- package/template/AGENTS.md +2 -0
- package/template/app/[lang]/rss.xml/route.ts +7 -3
- package/template/content/docs/configuration.mdx +23 -1
- package/template/content/docs/md.mdx +4 -0
- package/template/content/docs/migration.mdx +4 -0
- package/template/content/docs/proxy.mdx +15 -0
- package/template/content/docs/rss.mdx +2 -0
- package/template/content/docs/versioned-docs.mdx +68 -0
- package/template/package.json +1 -1
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.13.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);
|
|
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.14.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);
|
package/dist/config.d.ts
CHANGED
|
@@ -1,4 +1,9 @@
|
|
|
1
1
|
import type { ReactNode } from "react";
|
|
2
|
+
export declare const normalizeBasePath: (basePath: string | undefined) => string;
|
|
3
|
+
/** Convert an app-local path to the URL exposed by a Next.js base-path app. */
|
|
4
|
+
export declare const getPublicPath: (href: string, basePath: string | undefined) => string;
|
|
5
|
+
/** Keep public paths stable while adding a base path to app-local paths. */
|
|
6
|
+
export declare const withBasePath: (href: string, basePath: string | undefined) => string;
|
|
2
7
|
export interface GeistdocsNavItem {
|
|
3
8
|
external?: boolean;
|
|
4
9
|
href: string;
|
package/dist/config.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;
|
|
1
|
+
{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
|
package/dist/config.js
CHANGED
|
@@ -1 +1,36 @@
|
|
|
1
|
+
const ABSOLUTE_URL_PATTERN = /^[a-z][a-z\d+.-]*:/i;
|
|
2
|
+
const TRAILING_SLASH_PATTERN = /\/$/;
|
|
3
|
+
export const normalizeBasePath = (basePath) => {
|
|
4
|
+
if (!basePath || basePath === "/") {
|
|
5
|
+
return "";
|
|
6
|
+
}
|
|
7
|
+
const normalized = basePath.startsWith("/") ? basePath : `/${basePath}`;
|
|
8
|
+
return normalized.replace(TRAILING_SLASH_PATTERN, "");
|
|
9
|
+
};
|
|
10
|
+
/** Convert an app-local path to the URL exposed by a Next.js base-path app. */
|
|
11
|
+
export const getPublicPath = (href, basePath) => {
|
|
12
|
+
const normalizedBasePath = normalizeBasePath(basePath);
|
|
13
|
+
if (!normalizedBasePath) {
|
|
14
|
+
return href;
|
|
15
|
+
}
|
|
16
|
+
if (!href.startsWith("/") ||
|
|
17
|
+
href.startsWith("//") ||
|
|
18
|
+
ABSOLUTE_URL_PATTERN.test(href)) {
|
|
19
|
+
return href;
|
|
20
|
+
}
|
|
21
|
+
if (href === "/") {
|
|
22
|
+
return normalizedBasePath;
|
|
23
|
+
}
|
|
24
|
+
return `${normalizedBasePath}${href}`;
|
|
25
|
+
};
|
|
26
|
+
/** Keep public paths stable while adding a base path to app-local paths. */
|
|
27
|
+
export const withBasePath = (href, basePath) => {
|
|
28
|
+
const normalizedBasePath = normalizeBasePath(basePath);
|
|
29
|
+
if (!normalizedBasePath ||
|
|
30
|
+
href === normalizedBasePath ||
|
|
31
|
+
href.startsWith(`${normalizedBasePath}/`)) {
|
|
32
|
+
return href;
|
|
33
|
+
}
|
|
34
|
+
return getPublicPath(href, normalizedBasePath);
|
|
35
|
+
};
|
|
1
36
|
export const defineConfig = (config) => config;
|
package/dist/footer.d.ts
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { GeistdocsConfig } from "./config";
|
|
2
2
|
interface FooterProps {
|
|
3
|
-
config: Pick<GeistdocsConfig, "github">;
|
|
3
|
+
config: Pick<GeistdocsConfig, "basePath" | "github">;
|
|
4
4
|
copyright?: string;
|
|
5
5
|
}
|
|
6
6
|
export declare const Footer: ({ config, copyright, }: FooterProps) => import("react/jsx-runtime").JSX.Element;
|
package/dist/footer.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"footer.d.ts","sourceRoot":"","sources":["../src/footer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAKhD,UAAU,WAAW;IACnB,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"footer.d.ts","sourceRoot":"","sources":["../src/footer.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAKhD,UAAU,WAAW;IACnB,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,QAAQ,CAAC,CAAC;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,MAAM,GAAI,wBAGpB,WAAW,4CAiBb,CAAC"}
|
package/dist/footer.js
CHANGED
|
@@ -3,4 +3,4 @@ import { SiVercel } from "@icons-pack/react-simple-icons";
|
|
|
3
3
|
import { LanguageSelector, ThemeToggle } from "./controls";
|
|
4
4
|
import { RSSButton } from "./internal/footer/rss-button";
|
|
5
5
|
import { GitHubButton } from "./internal/github-button";
|
|
6
|
-
export const Footer = ({ config, copyright = `Copyright Vercel ${new Date().getFullYear()}. All rights reserved.`, }) => (_jsx("footer", { className: "border-t px-4 py-5 md:px-6", children: _jsxs("div", { className: "mx-auto flex max-w-[1448px] flex-col items-center justify-between gap-4 sm:flex-row", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(SiVercel, { className: "size-4 shrink-0" }), _jsx("p", { className: "text-center text-gray-800 text-sm sm:text-left", children: copyright })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(LanguageSelector, {}), _jsx(RSSButton, {}), _jsx(GitHubButton, { github: config.github }), _jsx(ThemeToggle, {})] })] }) }));
|
|
6
|
+
export const Footer = ({ config, copyright = `Copyright Vercel ${new Date().getFullYear()}. All rights reserved.`, }) => (_jsx("footer", { className: "border-t px-4 py-5 md:px-6", children: _jsxs("div", { className: "mx-auto flex max-w-[1448px] flex-col items-center justify-between gap-4 sm:flex-row", children: [_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(SiVercel, { className: "size-4 shrink-0" }), _jsx("p", { className: "text-center text-gray-800 text-sm sm:text-left", children: copyright })] }), _jsxs("div", { className: "flex items-center gap-2", children: [_jsx(LanguageSelector, {}), _jsx(RSSButton, { basePath: config.basePath }), _jsx(GitHubButton, { github: config.github }), _jsx(ThemeToggle, {})] })] }) }));
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/internal/chat/shell.tsx"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/internal/chat/shell.tsx"],"names":[],"mappings":"AAsUA,eAAO,MAAM,kBAAkB,sDAwD9B,CAAC"}
|
|
@@ -8,6 +8,7 @@ import { usePathname } from "next/navigation";
|
|
|
8
8
|
import { Portal } from "radix-ui";
|
|
9
9
|
import { useCallback, useEffect, useMemo, useRef, useState } from "react";
|
|
10
10
|
import { toast } from "sonner";
|
|
11
|
+
import { getPublicPath } from "../../config";
|
|
11
12
|
import { cn } from "../cn";
|
|
12
13
|
import { Button } from "../ui/button";
|
|
13
14
|
import { ButtonGroup } from "../ui/button-group";
|
|
@@ -96,7 +97,7 @@ const GeistdocsChatInner = ({ isOpen }) => {
|
|
|
96
97
|
const { initialMessages, isLoading, saveMessages, clearMessages } = useChatPersistence(title);
|
|
97
98
|
const { messages, sendMessage, status, setMessages, stop } = useChat({
|
|
98
99
|
transport: new DefaultChatTransport({
|
|
99
|
-
api:
|
|
100
|
+
api: getPublicPath("/api/chat", basePath),
|
|
100
101
|
prepareSendMessagesRequest: ({ body, messages }) => ({
|
|
101
102
|
body: {
|
|
102
103
|
...body,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"rss-button.d.ts","sourceRoot":"","sources":["../../../src/internal/footer/rss-button.tsx"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"rss-button.d.ts","sourceRoot":"","sources":["../../../src/internal/footer/rss-button.tsx"],"names":[],"mappings":"AAIA,eAAO,MAAM,SAAS,GAAI,cAAc;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,4CAW5D,CAAC"}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { jsx as _jsx } from "react/jsx-runtime";
|
|
2
2
|
import { RssIcon } from "lucide-react";
|
|
3
|
+
import { getPublicPath } from "../../config";
|
|
3
4
|
import { Button } from "../ui/button";
|
|
4
|
-
export const RSSButton = () => (_jsx(Button, { asChild: true, size: "icon-sm", type: "button", variant: "ghost", children: _jsx("a", { href: "/rss.xml", rel: "noopener", target: "_blank", children: _jsx(RssIcon, { className: "size-4" }) }) }));
|
|
5
|
+
export const RSSButton = ({ basePath }) => (_jsx(Button, { asChild: true, size: "icon-sm", type: "button", variant: "ghost", children: _jsx("a", { "aria-label": "RSS feed", href: getPublicPath("/rss.xml", basePath), rel: "noopener", target: "_blank", children: _jsx(RssIcon, { className: "size-4" }) }) }));
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"localized-link.d.ts","sourceRoot":"","sources":["../../src/internal/localized-link.tsx"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"localized-link.d.ts","sourceRoot":"","sources":["../../src/internal/localized-link.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAG7D,UAAU,kBAAmB,SAAQ,oBAAoB,CAAC,iBAAiB,CAAC;IAC1E,QAAQ,EAAE,SAAS,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,aAAa,GAAI,oBAAoB,kBAAkB,4CAgBnE,CAAC"}
|
|
@@ -1,13 +1,18 @@
|
|
|
1
1
|
"use client";
|
|
2
2
|
import { jsx as _jsx } from "react/jsx-runtime";
|
|
3
|
-
import DynamicLink from "fumadocs-core/dynamic-link";
|
|
4
3
|
import Link from "next/link";
|
|
5
4
|
import { useParams } from "next/navigation";
|
|
5
|
+
import { useGeistdocsConfig } from "./config-context";
|
|
6
6
|
export const LocalizedLink = ({ href, ...props }) => {
|
|
7
7
|
const params = useParams();
|
|
8
|
-
const
|
|
9
|
-
|
|
10
|
-
|
|
8
|
+
const { defaultLanguage = "en" } = useGeistdocsConfig();
|
|
9
|
+
const language = typeof params.lang === "string" ? params.lang : undefined;
|
|
10
|
+
if (language &&
|
|
11
|
+
language !== defaultLanguage &&
|
|
12
|
+
href.startsWith("/") &&
|
|
13
|
+
!href.startsWith("//")) {
|
|
14
|
+
const localizedHref = href === "/" ? `/${language}` : `/${language}${href}`;
|
|
15
|
+
return _jsx(Link, { href: localizedHref, ...props });
|
|
11
16
|
}
|
|
12
17
|
return _jsx(Link, { href: href, ...props });
|
|
13
18
|
};
|
|
@@ -1 +1 @@
|
|
|
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;
|
|
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,WAAW,EAAE,MAAM,CAAC;QACpB,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;AAwaD,eAAO,MAAM,oBAAoB,GAAI,kBAAkB,gBAAgB,mDAmItE,CAAC;AAEF,eAAO,MAAM,+BAA+B,GAAI,2BAG7C,oCAAoC,4CAiBtC,CAAC"}
|
|
@@ -63,7 +63,6 @@ const getEditSourceUrl = ({ github, path, }) => {
|
|
|
63
63
|
}
|
|
64
64
|
return undefined;
|
|
65
65
|
};
|
|
66
|
-
const getMarkdownUrl = (url) => url === "/docs" ? "/docs.md" : `${url}.md`;
|
|
67
66
|
const getPageQuery = (href, origin) => {
|
|
68
67
|
const protocol = process.env.NODE_ENV === "production" ? "https" : "http";
|
|
69
68
|
const productionHost = process.env.NEXT_PUBLIC_VERCEL_PROJECT_PRODUCTION_URL;
|
|
@@ -128,13 +127,12 @@ const FeedbackAction = ({ siteId }) => {
|
|
|
128
127
|
: "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" })] })] })) }) })] }));
|
|
129
128
|
};
|
|
130
129
|
export const GeistdocsPageActions = ({ config, page }) => {
|
|
131
|
-
const pathname = usePathname();
|
|
132
130
|
const isMobile = useIsMobile();
|
|
133
131
|
const { enabled: chatEnabled, setIsOpen, setPrompt } = useGeistdocsChat();
|
|
134
132
|
const [menuView, setMenuView] = useState("main");
|
|
135
133
|
const openInChatRef = useRef(null);
|
|
136
134
|
const providersBackRef = useRef(null);
|
|
137
|
-
const markdownUrl =
|
|
135
|
+
const markdownUrl = page.markdownUrl;
|
|
138
136
|
const [checked, handleCopy] = useCopyButton(async () => {
|
|
139
137
|
const response = await fetch(markdownUrl);
|
|
140
138
|
if (!response.ok) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/internal/search.tsx"],"names":[],"mappings":"AAGA,OAAO,EASL,KAAK,WAAW,EACjB,MAAM,sCAAsC,CAAC;
|
|
1
|
+
{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/internal/search.tsx"],"names":[],"mappings":"AAGA,OAAO,EASL,KAAK,WAAW,EACjB,MAAM,sCAAsC,CAAC;AAI9C,eAAO,MAAM,qBAAqB,GAAI,wBAGnC,WAAW,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,4CA0BrC,CAAC"}
|
package/dist/internal/search.js
CHANGED
|
@@ -3,12 +3,13 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
|
3
3
|
import { useDocsSearch } from "fumadocs-core/search/client";
|
|
4
4
|
import { SearchDialog as FumadocsSearchDialog, SearchDialogClose, SearchDialogContent, SearchDialogHeader, SearchDialogIcon, SearchDialogInput, SearchDialogList, SearchDialogOverlay, } from "fumadocs-ui/components/dialog/search";
|
|
5
5
|
import { useI18n } from "fumadocs-ui/contexts/i18n";
|
|
6
|
+
import { getPublicPath } from "../config";
|
|
6
7
|
export const GeistdocsSearchDialog = ({ basePath, ...props }) => {
|
|
7
8
|
const { locale } = useI18n();
|
|
8
9
|
const { search, setSearch, query } = useDocsSearch({
|
|
9
10
|
type: "fetch",
|
|
10
11
|
locale,
|
|
11
|
-
api:
|
|
12
|
+
api: getPublicPath("/api/search", basePath),
|
|
12
13
|
});
|
|
13
14
|
return (_jsxs(FumadocsSearchDialog, { isLoading: query.isLoading, onSearchChange: setSearch, search: search, ...props, children: [_jsx(SearchDialogOverlay, {}), _jsxs(SearchDialogContent, { children: [_jsxs(SearchDialogHeader, { children: [_jsx(SearchDialogIcon, {}), _jsx(SearchDialogInput, {}), _jsx(SearchDialogClose, {})] }), _jsx(SearchDialogList, { items: query.data === "empty" ? null : query.data })] })] }));
|
|
14
15
|
};
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pure helpers for version-switch fallback resolution.
|
|
3
|
+
*
|
|
4
|
+
* The version switcher swaps a version's route prefix onto the current
|
|
5
|
+
* pathname. When the resulting page doesn't exist in the target version's
|
|
6
|
+
* content tree, these helpers resolve the nearest existing ancestor instead
|
|
7
|
+
* so the switch never lands on a 404.
|
|
8
|
+
*
|
|
9
|
+
* Kept free of React / Next.js imports so the logic can be unit tested from
|
|
10
|
+
* dist with `node --test` (matching `internal/sidebar-tree.ts`).
|
|
11
|
+
*/
|
|
12
|
+
/**
|
|
13
|
+
* The set of paths that exist for one version, expressed relative to the
|
|
14
|
+
* version's route prefix (e.g. `/docs/getting-started`, never
|
|
15
|
+
* `/v5/docs/getting-started`).
|
|
16
|
+
*/
|
|
17
|
+
export interface GeistdocsVersionPaths {
|
|
18
|
+
/**
|
|
19
|
+
* Where to land when neither the switched path nor any of its ancestors
|
|
20
|
+
* exist in the target version — typically the version's docs root.
|
|
21
|
+
*/
|
|
22
|
+
fallbackPath?: string;
|
|
23
|
+
paths: readonly string[];
|
|
24
|
+
}
|
|
25
|
+
/** Ensure a leading slash and strip trailing slashes; `""` becomes `/`. */
|
|
26
|
+
export declare const normalizeVersionPath: (path: string) => string;
|
|
27
|
+
/**
|
|
28
|
+
* Strip a version's public route prefix from a path when present. Loader URLs
|
|
29
|
+
* may already include the prefix (`baseUrl: "/v1/docs"`) or not
|
|
30
|
+
* (`baseUrl: "/docs"` with the prefix applied at render time), so this
|
|
31
|
+
* normalizes both shapes to prefix-relative paths.
|
|
32
|
+
*/
|
|
33
|
+
export declare const stripVersionRoutePrefix: (path: string, routePrefix?: string) => string;
|
|
34
|
+
export interface ResolveVersionSwitchPathOptions {
|
|
35
|
+
/** The prefix-relative path being switched to. */
|
|
36
|
+
candidate: string;
|
|
37
|
+
/** Landing path when no ancestor of the candidate exists. */
|
|
38
|
+
fallbackPath?: string;
|
|
39
|
+
/** Prefix-relative paths that exist in the target version. */
|
|
40
|
+
paths: readonly string[];
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Resolve the best existing path for a version switch: the candidate itself
|
|
44
|
+
* when it exists, otherwise its nearest existing ancestor, otherwise
|
|
45
|
+
* `fallbackPath`. Returns `null` when nothing matches, in which case callers
|
|
46
|
+
* should keep the plain prefix-swap behavior.
|
|
47
|
+
*/
|
|
48
|
+
export declare const resolveVersionSwitchPath: ({ candidate, fallbackPath, paths, }: ResolveVersionSwitchPathOptions) => string | null;
|
|
49
|
+
//# sourceMappingURL=version-paths.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"version-paths.d.ts","sourceRoot":"","sources":["../../src/internal/version-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED,2EAA2E;AAC3E,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,MAGnD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,cAAc,MAAM,KACnB,MAgBF,CAAC;AAEF,MAAM,WAAW,+BAA+B;IAC9C,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,qCAItC,+BAA+B,KAAG,MAAM,GAAG,IAkB7C,CAAC"}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Pure helpers for version-switch fallback resolution.
|
|
3
|
+
*
|
|
4
|
+
* The version switcher swaps a version's route prefix onto the current
|
|
5
|
+
* pathname. When the resulting page doesn't exist in the target version's
|
|
6
|
+
* content tree, these helpers resolve the nearest existing ancestor instead
|
|
7
|
+
* so the switch never lands on a 404.
|
|
8
|
+
*
|
|
9
|
+
* Kept free of React / Next.js imports so the logic can be unit tested from
|
|
10
|
+
* dist with `node --test` (matching `internal/sidebar-tree.ts`).
|
|
11
|
+
*/
|
|
12
|
+
const TRAILING_SLASHES_PATTERN = /\/+$/;
|
|
13
|
+
/** Ensure a leading slash and strip trailing slashes; `""` becomes `/`. */
|
|
14
|
+
export const normalizeVersionPath = (path) => {
|
|
15
|
+
const withLeadingSlash = path.startsWith("/") ? path : `/${path}`;
|
|
16
|
+
return withLeadingSlash.replace(TRAILING_SLASHES_PATTERN, "") || "/";
|
|
17
|
+
};
|
|
18
|
+
/**
|
|
19
|
+
* Strip a version's public route prefix from a path when present. Loader URLs
|
|
20
|
+
* may already include the prefix (`baseUrl: "/v1/docs"`) or not
|
|
21
|
+
* (`baseUrl: "/docs"` with the prefix applied at render time), so this
|
|
22
|
+
* normalizes both shapes to prefix-relative paths.
|
|
23
|
+
*/
|
|
24
|
+
export const stripVersionRoutePrefix = (path, routePrefix) => {
|
|
25
|
+
const normalized = normalizeVersionPath(path);
|
|
26
|
+
if (!routePrefix || routePrefix === "/") {
|
|
27
|
+
return normalized;
|
|
28
|
+
}
|
|
29
|
+
const normalizedPrefix = normalizeVersionPath(routePrefix);
|
|
30
|
+
if (normalized === normalizedPrefix) {
|
|
31
|
+
return "/";
|
|
32
|
+
}
|
|
33
|
+
return normalized.startsWith(`${normalizedPrefix}/`)
|
|
34
|
+
? normalized.slice(normalizedPrefix.length)
|
|
35
|
+
: normalized;
|
|
36
|
+
};
|
|
37
|
+
/**
|
|
38
|
+
* Resolve the best existing path for a version switch: the candidate itself
|
|
39
|
+
* when it exists, otherwise its nearest existing ancestor, otherwise
|
|
40
|
+
* `fallbackPath`. Returns `null` when nothing matches, in which case callers
|
|
41
|
+
* should keep the plain prefix-swap behavior.
|
|
42
|
+
*/
|
|
43
|
+
export const resolveVersionSwitchPath = ({ candidate, fallbackPath, paths, }) => {
|
|
44
|
+
const existing = new Set(paths.map(normalizeVersionPath));
|
|
45
|
+
let current = normalizeVersionPath(candidate);
|
|
46
|
+
for (;;) {
|
|
47
|
+
if (existing.has(current)) {
|
|
48
|
+
return current;
|
|
49
|
+
}
|
|
50
|
+
if (current === "/") {
|
|
51
|
+
break;
|
|
52
|
+
}
|
|
53
|
+
const lastSlashIndex = current.lastIndexOf("/");
|
|
54
|
+
current = lastSlashIndex <= 0 ? "/" : current.slice(0, lastSlashIndex);
|
|
55
|
+
}
|
|
56
|
+
return fallbackPath ? normalizeVersionPath(fallbackPath) : null;
|
|
57
|
+
};
|
package/dist/pages/docs.d.ts
CHANGED
|
@@ -2,7 +2,7 @@ import { DocsPage as FumadocsDocsPage } from "fumadocs-ui/layouts/docs/page";
|
|
|
2
2
|
import type { MDXComponents } from "mdx/types";
|
|
3
3
|
import type { Metadata } from "next";
|
|
4
4
|
import type { ComponentProps, ComponentType, ReactNode } from "react";
|
|
5
|
-
import type
|
|
5
|
+
import { type GeistdocsConfig } from "../config";
|
|
6
6
|
import { type GeistdocsPageVisibilityData } from "../internal/page-visibility";
|
|
7
7
|
import type { GeistdocsSourceBundle } from "../source";
|
|
8
8
|
type SourceBundle = GeistdocsSourceBundle;
|
|
@@ -23,6 +23,23 @@ type OpenGraphImages = NonNullable<Metadata["openGraph"]>["images"];
|
|
|
23
23
|
interface DocsPageOpenGraphOptions {
|
|
24
24
|
images?: boolean | OpenGraphImages;
|
|
25
25
|
}
|
|
26
|
+
interface PageUrlContext {
|
|
27
|
+
page: GeistdocsPage;
|
|
28
|
+
params: DocsPageParams;
|
|
29
|
+
}
|
|
30
|
+
interface PublicPageUrlContext extends PageUrlContext {
|
|
31
|
+
pageUrl: string;
|
|
32
|
+
}
|
|
33
|
+
interface MarkdownUrlContext extends PublicPageUrlContext {
|
|
34
|
+
publicPageUrl: string;
|
|
35
|
+
}
|
|
36
|
+
export interface ResolvePageMarkdownUrlOptions {
|
|
37
|
+
basePath?: string;
|
|
38
|
+
isRootMountedPage?: boolean;
|
|
39
|
+
pageUrl: string;
|
|
40
|
+
publicPageUrl?: string;
|
|
41
|
+
}
|
|
42
|
+
export declare const resolvePageMarkdownUrl: ({ basePath, pageUrl, isRootMountedPage, publicPageUrl, }: ResolvePageMarkdownUrlOptions) => string;
|
|
26
43
|
interface DocsPageData extends GeistdocsPageVisibilityData {
|
|
27
44
|
body: ComponentType<{
|
|
28
45
|
components?: MDXComponents;
|
|
@@ -33,12 +50,11 @@ interface DocsPageData extends GeistdocsPageVisibilityData {
|
|
|
33
50
|
toc: ComponentProps<typeof FumadocsDocsPage>["toc"];
|
|
34
51
|
}
|
|
35
52
|
interface CreateDocsPageOptions {
|
|
36
|
-
config: Pick<GeistdocsConfig, "ai" | "feedback" | "github" | "pageActions" | "siteId">;
|
|
53
|
+
config: Pick<GeistdocsConfig, "ai" | "basePath" | "feedback" | "github" | "pageActions" | "siteId">;
|
|
37
54
|
filterStaticParams?: (params: DocsPageParams) => boolean;
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
}) => string;
|
|
55
|
+
getMarkdownUrl?: (context: MarkdownUrlContext) => string;
|
|
56
|
+
getPageUrl?: (context: PageUrlContext) => string;
|
|
57
|
+
getPublicPageUrl?: (context: PublicPageUrlContext) => string;
|
|
42
58
|
mdx?: DocsPageMdx;
|
|
43
59
|
metadata?: (context: {
|
|
44
60
|
metadata: Metadata;
|
|
@@ -50,8 +66,10 @@ interface CreateDocsPageOptions {
|
|
|
50
66
|
renderTop?: (context: {
|
|
51
67
|
data: DocsPageData;
|
|
52
68
|
markdown: string;
|
|
69
|
+
markdownUrl: string;
|
|
53
70
|
page: GeistdocsPage;
|
|
54
71
|
pageUrl: string;
|
|
72
|
+
publicPageUrl: string;
|
|
55
73
|
}) => ReactNode;
|
|
56
74
|
resolveLink?: (context: {
|
|
57
75
|
link: DocsPageLink;
|
|
@@ -62,7 +80,7 @@ interface CreateDocsPageOptions {
|
|
|
62
80
|
tableOfContent?: TableOfContentOptions;
|
|
63
81
|
tableOfContentPopover?: ComponentProps<typeof FumadocsDocsPage>["tableOfContentPopover"];
|
|
64
82
|
}
|
|
65
|
-
export declare const createDocsPage: ({ config, source, mdx, pageActions, filterStaticParams, getPageUrl, metadata, openGraph, renderTop, resolveLink, tableOfContent, tableOfContentPopover, }: CreateDocsPageOptions) => {
|
|
83
|
+
export declare const createDocsPage: ({ config, source, mdx, pageActions, filterStaticParams, getMarkdownUrl, getPageUrl, getPublicPageUrl, metadata, openGraph, renderTop, resolveLink, tableOfContent, tableOfContentPopover, }: CreateDocsPageOptions) => {
|
|
66
84
|
Page: ({ params, }: {
|
|
67
85
|
params: Promise<{
|
|
68
86
|
lang: string;
|
package/dist/pages/docs.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/pages/docs.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,QAAQ,IAAI,gBAAgB,EAE7B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAErC,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtE,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/pages/docs.tsx"],"names":[],"mappings":"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"}
|
package/dist/pages/docs.js
CHANGED
|
@@ -2,6 +2,7 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
|
|
|
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
|
+
import { getPublicPath, withBasePath } from "../config";
|
|
5
6
|
import { cn } from "../internal/cn";
|
|
6
7
|
import { createPageActions as createInternalPageActions } from "../internal/page-actions";
|
|
7
8
|
import { GeistdocsPageActions, GeistdocsTableOfContentsActions, } from "../internal/page-actions-client";
|
|
@@ -10,13 +11,34 @@ import { getPageFooterItems, PageFooter } from "../internal/page-footer";
|
|
|
10
11
|
import { getPageRobots, } from "../internal/page-visibility";
|
|
11
12
|
import { GeistdocsTableOfContents } from "../internal/table-of-contents";
|
|
12
13
|
import { createMdxComponents } from "../mdx";
|
|
14
|
+
const TRAILING_SLASH_PATTERN = /\/$/;
|
|
15
|
+
export const resolvePageMarkdownUrl = ({ basePath, pageUrl, isRootMountedPage = pageUrl === "/", publicPageUrl = getPublicPath(pageUrl, basePath), }) => {
|
|
16
|
+
const normalizedPublicPageUrl = publicPageUrl.replace(TRAILING_SLASH_PATTERN, "");
|
|
17
|
+
if (isRootMountedPage) {
|
|
18
|
+
return `${normalizedPublicPageUrl}/index.md`;
|
|
19
|
+
}
|
|
20
|
+
return `${normalizedPublicPageUrl}.md`;
|
|
21
|
+
};
|
|
13
22
|
const DocsTitle = ({ className, ...props }) => (_jsx(FumadocsDocsTitle, { className: cn("mb-4 text-balance text-4xl tracking-tight", className), ...props }));
|
|
14
23
|
const DocsDescription = (props) => _jsx(FumadocsDocsDescription, { ...props });
|
|
15
24
|
const DocsBody = ({ className, ...props }) => (_jsx(FumadocsDocsBody, { className: cn("mx-auto w-full", className), ...props }));
|
|
16
25
|
const hasTableOfContentsActions = (config, extraActions) => config.pageActions?.scrollTop !== false ||
|
|
17
26
|
config.feedback?.enabled !== false ||
|
|
18
27
|
extraActions.length > 0;
|
|
19
|
-
export const createDocsPage = ({ config, source, mdx, pageActions = createInternalPageActions({ config }), filterStaticParams, getPageUrl, metadata, openGraph, renderTop, resolveLink, tableOfContent, tableOfContentPopover, }) => {
|
|
28
|
+
export const createDocsPage = ({ config, source, mdx, pageActions = createInternalPageActions({ config }), filterStaticParams, getMarkdownUrl, getPageUrl, getPublicPageUrl, metadata, openGraph, renderTop, resolveLink, tableOfContent, tableOfContentPopover, }) => {
|
|
29
|
+
const resolvePageUrls = (page, params) => {
|
|
30
|
+
const pageUrl = getPageUrl?.({ page, params }) ?? page.url;
|
|
31
|
+
const publicPageUrl = getPublicPageUrl?.({ page, params, pageUrl }) ??
|
|
32
|
+
getPublicPath(pageUrl, config.basePath);
|
|
33
|
+
const markdownUrl = getMarkdownUrl?.({ page, params, pageUrl, publicPageUrl }) ??
|
|
34
|
+
resolvePageMarkdownUrl({
|
|
35
|
+
basePath: config.basePath,
|
|
36
|
+
isRootMountedPage: source.baseUrl === "/" && page.slugs.length === 0,
|
|
37
|
+
pageUrl,
|
|
38
|
+
publicPageUrl,
|
|
39
|
+
});
|
|
40
|
+
return { markdownUrl, pageUrl, publicPageUrl };
|
|
41
|
+
};
|
|
20
42
|
const Page = async ({ params, }) => {
|
|
21
43
|
const resolvedParams = await params;
|
|
22
44
|
const { slug, lang } = resolvedParams;
|
|
@@ -31,7 +53,7 @@ export const createDocsPage = ({ config, source, mdx, pageActions = createIntern
|
|
|
31
53
|
? resolveLink({ link: defaultLink, page, source })
|
|
32
54
|
: defaultLink;
|
|
33
55
|
const resolvedMdx = typeof mdx === "function" ? mdx({ link, page, source }) : mdx;
|
|
34
|
-
const pageUrl =
|
|
56
|
+
const { markdownUrl, pageUrl, publicPageUrl } = resolvePageUrls(page, resolvedParams);
|
|
35
57
|
const footerItems = getPageFooterItems(source.source.getPageTree(lang), page.url);
|
|
36
58
|
const pagesByUrl = getPageUrl
|
|
37
59
|
? new Map(source.source.getPages(lang).map((entry) => [entry.url, entry]))
|
|
@@ -64,7 +86,7 @@ export const createDocsPage = ({ config, source, mdx, pageActions = createIntern
|
|
|
64
86
|
markdown,
|
|
65
87
|
page: {
|
|
66
88
|
path: page.path,
|
|
67
|
-
url:
|
|
89
|
+
url: publicPageUrl,
|
|
68
90
|
},
|
|
69
91
|
}) ?? [])
|
|
70
92
|
: [];
|
|
@@ -78,9 +100,17 @@ export const createDocsPage = ({ config, source, mdx, pageActions = createIntern
|
|
|
78
100
|
single: true,
|
|
79
101
|
...tableOfContent,
|
|
80
102
|
component: tocComponent,
|
|
81
|
-
}, tableOfContentPopover: tableOfContentPopover, toc: data.toc, children: [renderTop?.({
|
|
103
|
+
}, tableOfContentPopover: tableOfContentPopover, toc: data.toc, children: [renderTop?.({
|
|
104
|
+
data,
|
|
105
|
+
markdown: markdown ?? "",
|
|
106
|
+
markdownUrl,
|
|
107
|
+
page,
|
|
108
|
+
pageUrl,
|
|
109
|
+
publicPageUrl,
|
|
110
|
+
}), _jsxs("div", { className: "flex flex-col-reverse gap-4 sm:flex-row sm:items-end sm:justify-between", children: [_jsx(DocsTitle, { className: "mb-0 min-w-0", children: data.title }), _jsx(GeistdocsPageActions, { config: pageActions.config, page: {
|
|
111
|
+
markdownUrl,
|
|
82
112
|
path: page.path,
|
|
83
|
-
url:
|
|
113
|
+
url: publicPageUrl,
|
|
84
114
|
} })] }), _jsx(DocsDescription, { children: data.description }), _jsx(DocsBody, { children: _jsx(MDX, { components: {
|
|
85
115
|
...createMdxComponents({ a: link }),
|
|
86
116
|
...resolvedMdx,
|
|
@@ -98,7 +128,7 @@ export const createDocsPage = ({ config, source, mdx, pageActions = createIntern
|
|
|
98
128
|
notFound();
|
|
99
129
|
}
|
|
100
130
|
const data = page.data;
|
|
101
|
-
const
|
|
131
|
+
const { markdownUrl } = resolvePageUrls(page, resolvedParams);
|
|
102
132
|
const openGraphImages = openGraph?.images === true
|
|
103
133
|
? source.getPageImage(page).url
|
|
104
134
|
: openGraph?.images;
|
|
@@ -109,9 +139,11 @@ export const createDocsPage = ({ config, source, mdx, pageActions = createIntern
|
|
|
109
139
|
robots: getPageRobots(page),
|
|
110
140
|
...(openGraphImages ? { openGraph: { images: openGraphImages } } : {}),
|
|
111
141
|
alternates: {
|
|
112
|
-
canonical: data.canonical
|
|
142
|
+
canonical: data.canonical
|
|
143
|
+
? withBasePath(data.canonical, config.basePath)
|
|
144
|
+
: undefined,
|
|
113
145
|
types: {
|
|
114
|
-
"text/markdown":
|
|
146
|
+
"text/markdown": markdownUrl,
|
|
115
147
|
},
|
|
116
148
|
},
|
|
117
149
|
};
|