@vercel/geistdocs 1.0.6 → 1.0.8

package/dist/index.js

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-import{program as O}from"commander";import{copyFile as nt,rm as rt}from"fs/promises";import{join as _}from"path";import{cancel as at,intro as it,isCancel as ct,log as lt,outro as pt,spinner as gt,text as ft}from"@clack/prompts";import{exec as st}from"child_process";import{promisify as ot}from"util";var A="https://github.com/vercel/geistdocs";var m={stdio:"ignore"};var j="geistdocs-update",g=ot(st);var dt="https://github.com/vercel/geistdocs.git",mt=async t=>{await g(`git clone --depth 1 --filter=blob:none --sparse ${dt} ${t}`,m),await g("git sparse-checkout set apps/template",{...m,cwd:t}),await g("mv apps/template/* apps/template/.[!.]* . 2>/dev/null || true",{...m,cwd:t,shell:"/bin/bash"}),await g("rm -rf apps .git",{...m,cwd:t})},ut=async()=>{await nt(".env.example",".env.local")},ht=async()=>{await rt(_("content","docs"),{recursive:!0,force:!0})},wt=async()=>{await g("pnpm install",m)},yt=async()=>{await g("git init",m),await g("git add .",m),await g('git commit -m "\u2728 Initial commit"',m)},Tt=async()=>{let t=await ft({message:"What is your project named?",placeholder:"my-app",validate(s){if(s.length===0)return"Please enter a project name."}});return ct(t)&&(at("Operation cancelled."),process.exit(0)),t.toString()},H=async t=>{try{it("Let's start a Geistdocs project!");let s=process.cwd(),e=t.name||await Tt(),o=gt(),r=_(s,e);o.start("Cloning template..."),await mt(e),o.message("Moving into project..."),process.chdir(r),o.message("Setting up environment variables..."),await ut(),o.message("Deleting demo content..."),await ht(),o.message("Installing dependencies..."),await wt(),t.disableGit||(o.message("Initializing Git repository..."),await yt()),o.stop("Project initialized successfully!"),pt("Run `pnpm dev` to start the development server.")}catch(s){let e=s instanceof Error?s.message:`Failed to initialize project: ${s}`;lt.error(e),process.exit(1)}};import{createHash as $t}from"crypto";import{existsSync as J}from"fs";import{readFile as U,writeFile as K}from"fs/promises";import{dirname as xt,parse as N,resolve as C}from"path";import{intro as Pt,isCancel as bt,log as d,outro as P,spinner as vt,text as St}from"@clack/prompts";import{glob as Ft}from"glob";import{Project as Ct,SyntaxKind as D}from"ts-morph";var k=10,Et="content/docs/**/*.mdx",L=".translation-cache.json",jt=/\.[a-z]{2}\.mdx$/,Dt=async t=>(await Ft(t,{cwd:process.cwd(),absolute:!0,nodir:!0})).filter(e=>e.endsWith(".mdx")).filter(e=>!jt.test(e)),Ot=t=>{let s=C(process.cwd(),t),r=new Ct({skipAddingFilesFromTsConfig:!0}).addSourceFileAtPath(s).getVariableDeclaration("translations");if(!r)throw new Error("Could not find translations export in config file");let a=r.getInitializer();if(!a||a.getKind()!==D.ObjectLiteralExpression)throw new Error("translations must be an object literal");let i=a.asKind(D.ObjectLiteralExpression);if(!i)throw new Error("Could not parse translations object");let l=i.getProperties().filter(p=>p.getKind()===D.PropertyAssignment).map(p=>p.asKind(D.PropertyAssignment)?.getName()).filter(p=>p!==void 0);if(l.length===0)throw new Error("No locales found in translations object");let[w,...y]=l;return y},Rt=t=>$t("sha256").update(t).digest("hex"),At=async()=>{let t=C(process.cwd(),L);if(!J(t))return{};try{let s=await U(t,"utf-8");return JSON.parse(s)}catch{return d.warn("Failed to load translation cache, starting fresh"),{}}},X=async t=>{let s=C(process.cwd(),L);await K(s,JSON.stringify(t,null,2),"utf-8")},kt=(t,s,e,o)=>{let r=t[s];if(!r)return!0;let a=r[e];return a?a.hash!==o:!0},Nt=async(t,s,e)=>{let o=await U(t,"utf-8"),r=await fetch(e,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({content:o,locales:s})}),a=await r.text();if(!r.ok){let i=`Translation failed with status ${r.status}`;try{let l=JSON.parse(a);i=l.error||l.message||i}catch{i=a||i}throw new Error(i)}try{return JSON.parse(a)}catch{throw new Error(`Failed to parse response: ${a.slice(0,200)}`)}},Ut=async(t,s,e,o)=>{let r=xt(t),{name:a,ext:i}=N(t);for(let[l,w]of Object.entries(s)){let y=C(r,`${a}.${l}${i}`);await K(y,w,"utf-8"),e[t]||(e[t]={}),e[t][l]={hash:o,translatedAt:new Date().toISOString()},await X(e)}},V=async(t,s)=>{Pt("Translate MDX content");let e=t??Et,o=[],r=s.url||process.env.GEISTDOCS_TRANSLATE_URL||"https://geistdocs.com/translate",a=s.config??"geistdocs.tsx";if(a)try{o=Ot(a),d.info(`Loaded ${o.length} locale(s) from config: ${o.join(", ")}`)}catch(n){d.error(`Failed to load config: ${n instanceof Error?n.message:String(n)}`),P("Translation cancelled"),process.exit(1)}let i=await Dt(e);if(i.length===0&&(d.error(`No MDX files found matching pattern: ${e}`),P("Translation cancelled"),process.exit(1)),d.info(`Found ${i.length} MDX file(s) matching pattern`),o.length===0){let n=await St({message:"Enter target locales (comma-separated):",placeholder:"cn,fr,es",validate:c=>{if(!c)return"At least one locale is required"}});bt(n)&&(P("Translation cancelled"),process.exit(0)),o=n.split(",").map(c=>c.trim())}let l=C(process.cwd(),L),w=await At();J(l)||await X(w),d.info(`Using cache: ${l}`);let y=new Map;for(let n of i){let c=await U(n,"utf-8");y.set(n,Rt(c))}let p=[],T=0;for(let n of o)for(let c of i){let x=y.get(c);if(!x)throw new Error(`Hash not found for file: ${c}`);s.force||kt(w,c,n,x)?p.push({filePath:c,locale:n,hash:x}):T+=1}if(p.length===0){d.success("All translations are up to date!"),P(`Skipped ${T} file(s) (unchanged)`);return}let b=new Map;for(let n of p)b.has(n.filePath)||b.set(n.filePath,[]),b.get(n.filePath)?.push(n);let z=Array.from(b.keys()),$=[];for(let n=0;n<z.length;n+=k)$.push(z.slice(n,n+k));d.info(`Processing ${p.length} file(s) (${i.length} \xD7 ${o.length} locales) in ${$.length} batch(es) of up to ${k}`),T>0&&d.info(`Skipped ${T} file(s) (unchanged)`);let v=vt();try{let n=new Map;v.start("Starting translation...");let c=0;for(let h=0;h<$.length;h++){let R=$[h];for(let f of R){let S=b.get(f);if(!S)throw new Error(`Tasks not found for file: ${f}`);let F=S.map(et=>et.locale),tt=S[0].hash;v.message(`Translating ${N(f).name} (${F.length} locales) - ${c}/${p.length} complete`);let M=await Nt(f,F,r);n.set(f,M),await Ut(f,M,w,tt),c+=F.length}h<$.length-1&&(v.message(`Batch ${h+1}/${$.length} complete. Pausing...`),await new Promise(f=>setTimeout(f,1e3)))}v.stop("Translation complete!");let x=0;for(let[h,R]of n){let{name:f,ext:S}=N(h);for(let F of Object.keys(R))d.success(`Saved: ${f}.${F}${S}`),x+=1}let G=[`Translated ${x} file(s)`];T>0&&G.push(`Skipped ${T} unchanged`),P(G.join(" \u2022 "))}catch(n){let c=n instanceof Error?n.message:String(n);v.stop(`Translation failed: ${c}`),P("Exiting"),process.exit(1)}};import{copyFile as Lt,mkdir as q,rm as Z}from"fs/promises";import{dirname as It,join as E}from"path";import{intro as zt,log as u,outro as B,spinner as Gt}from"@clack/prompts";import{glob as Mt}from"glob";var Q="apps/template",W=["**/*","!content/docs/**"],_t=async t=>{let s=process.cwd(),e=E(s,t);await Z(e,{recursive:!0,force:!0}),await q(e,{recursive:!0})},Ht=async t=>await g(`git clone --depth 1 ${A} ${t}`),I=async t=>await Z(t,{recursive:!0,force:!0}),Jt=async(t,s)=>(await Mt(t,{cwd:s,nodir:!0,dot:!0,ignore:".git/**"})).sort(),Kt=async(t,s)=>{let e=process.cwd(),o=E(s,Q,t),r=E(e,t);await q(It(r),{recursive:!0}),await Lt(o,r)},Xt=async(t,s,e)=>{let o={success:[],failed:[]};for(let r of t)try{e.message(`Updating ${r}...`),await Kt(r,s),o.success.push(r)}catch(a){let i=a instanceof Error?a.message:`${a}`;o.failed.push({file:r,error:i})}return o},Vt=t=>{if(t.success.length>0){u.success(`Successfully updated ${t.success.length} files:`);for(let s of t.success)u.info(`  \u2713 ${s}`)}if(t.failed.length>0){u.warn(`Failed to update ${t.failed.length} files:`);for(let{file:s,error:e}of t.failed)u.error(`  \u2717 ${s}: ${e}`)}},Y=async()=>{let t=process.cwd(),s=E(t,j);try{zt("Let's update your Geistdocs project!"),u.info(`Repository: ${A}`);let e=Gt();e.start("Creating temporary directory..."),await _t(j),e.message("Cloning repository..."),await Ht(j),e.message("Scanning for files...");let o=E(s,Q),r=await Jt(W,o);if(e.stop(`Found ${r.length} files to update`),r.length===0){u.warn("No files matched the patterns. Nothing to update."),await I(s),B("Update cancelled.");return}u.info(`Patterns: ${W.length}`),u.info(`Files to update: ${r.length}`),e.start("Updating files...");let a=await Xt(r,s,e);e.message("Cleaning up..."),await I(s),e.stop("Update complete!"),Vt(a),B("Please review and test the changes carefully.")}catch(e){let o=e instanceof Error?e.message:`${e}`;try{await I(s)}catch{}u.error(`Failed to update project: ${o}`),process.exit(1)}};O.command("init").description("Initialize a new Geistdocs project").option("--name <name>","Name of the project").option("--disable-git","Disable git initialization").action(H);O.command("update").description("Update a Geistdocs project").action(Y);O.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(V);O.parse(process.argv);
+import{program as C}from"commander";import{copyFile as Y,rm as tt}from"fs/promises";import{join as R}from"path";import{cancel as et,intro as st,isCancel as ot,log as nt,outro as rt,spinner as at,text as it}from"@clack/prompts";import{exec as Z}from"child_process";import{promisify as Q}from"util";var D="https://github.com/vercel/geistdocs";var m={stdio:"ignore"};var F="geistdocs-update",g=Q(Z);var ct="https://github.com/vercel/geistdocs.git",lt=async t=>{await g(`git clone --depth 1 --filter=blob:none --sparse ${ct} ${t}`,m),await g("git sparse-checkout set apps/template",{...m,cwd:t}),await g("mv apps/template/* apps/template/.[!.]* . 2>/dev/null || true",{...m,cwd:t,shell:"/bin/bash"}),await g("rm -rf apps .git",{...m,cwd:t})},pt=async()=>{await Y(".env.example",".env.local")},gt=async()=>{await tt(R("content","docs"),{recursive:!0,force:!0})},dt=async()=>{await g("pnpm install",m)},ft=async()=>{await g("git init",m),await g("git add .",m),await g('git commit -m "\u2728 Initial commit"',m)},mt=async()=>{let t=await it({message:"What is your project named?",placeholder:"my-app",validate(e){if(e.length===0)return"Please enter a project name."}});return ot(t)&&(et("Operation cancelled."),process.exit(0)),t.toString()},k=async t=>{try{st("Let's start a Geistdocs project!");let e=process.cwd(),s=t.name||await mt(),o=at(),n=R(e,s);o.start("Cloning template..."),await lt(s),o.message("Moving into project..."),process.chdir(n),o.message("Setting up environment variables..."),await pt(),o.message("Deleting demo content..."),await gt(),o.message("Installing dependencies..."),await dt(),t.disableGit||(o.message("Initializing Git repository..."),await ft()),o.stop("Project initialized successfully!"),rt("Run `pnpm dev` to start the development server.")}catch(e){let s=e instanceof Error?e.message:`Failed to initialize project: ${e}`;nt.error(s),process.exit(1)}};import{createHash as ut}from"crypto";import{existsSync as I}from"fs";import{readFile as N,writeFile as z}from"fs/promises";import{dirname as ht,parse as G,resolve as v}from"path";import{intro as wt,isCancel as yt,log as f,outro as $,spinner as Tt,text as xt}from"@clack/prompts";import{glob as $t}from"glob";import{Project as Pt,SyntaxKind as E}from"ts-morph";var A=10,vt="content/docs/**/*.mdx",O=".translation-cache.json",St=/\.[a-z]{2}\.mdx$/,bt=async t=>(await $t(t,{cwd:process.cwd(),absolute:!0,nodir:!0})).filter(s=>s.endsWith(".mdx")).filter(s=>!St.test(s)),Ft=t=>{let e=v(process.cwd(),t),n=new Pt({skipAddingFilesFromTsConfig:!0}).addSourceFileAtPath(e).getVariableDeclaration("translations");if(!n)throw new Error("Could not find translations export in config file");let a=n.getInitializer();if(!a||a.getKind()!==E.ObjectLiteralExpression)throw new Error("translations must be an object literal");let i=a.asKind(E.ObjectLiteralExpression);if(!i)throw new Error("Could not parse translations object");let d=i.getProperties().filter(l=>l.getKind()===E.PropertyAssignment).map(l=>l.asKind(E.PropertyAssignment)?.getName()).filter(l=>l!==void 0);if(d.length===0)throw new Error("No locales found in translations object");let[w,...b]=d;return b},Et=t=>ut("sha256").update(t).digest("hex"),Ct=async()=>{let t=v(process.cwd(),O);if(!I(t))return{};try{let e=await N(t,"utf-8");return JSON.parse(e)}catch{return f.warn("Failed to load translation cache, starting fresh"),{}}},_=async t=>{let e=v(process.cwd(),O);await z(e,JSON.stringify(t,null,2),"utf-8")},jt=(t,e,s,o)=>{let n=t[e];if(!n)return!0;let a=n[s];return a?a.hash!==o:!0},Dt=async(t,e,s)=>{let o=await N(t,"utf-8"),n=await fetch(s,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({content:o,locale:e})}),a=await n.text();if(!n.ok){let i=`Translation failed with status ${n.status}`;try{let d=JSON.parse(a);i=d.error||d.message||i}catch{i=a||i}throw new Error(i)}try{return JSON.parse(a).translation}catch{throw new Error(`Failed to parse response: ${a.slice(0,200)}`)}},At=async(t,e,s,o,n)=>{let a=ht(t),{name:i,ext:d}=G(t),w=v(a,`${i}.${e}${d}`);await z(w,s,"utf-8"),o[t]||(o[t]={}),o[t][e]={hash:n,translatedAt:new Date().toISOString()},await _(o)},M=async(t,e)=>{wt("Translate MDX content");let s=t??vt,o=[],n=e.url||process.env.GEISTDOCS_TRANSLATE_URL||"https://geistdocs.com/translate",a=e.config??"geistdocs.tsx";if(a)try{o=Ft(a),f.info(`Loaded ${o.length} locale(s) from config: ${o.join(", ")}`)}catch(r){f.error(`Failed to load config: ${r instanceof Error?r.message:String(r)}`),$("Translation cancelled"),process.exit(1)}let i=await bt(s);if(i.length===0&&(f.error(`No MDX files found matching pattern: ${s}`),$("Translation cancelled"),process.exit(1)),f.info(`Found ${i.length} MDX file(s) matching pattern`),o.length===0){let r=await xt({message:"Enter target locales (comma-separated):",placeholder:"cn,fr,es",validate:c=>{if(!c)return"At least one locale is required"}});yt(r)&&($("Translation cancelled"),process.exit(0)),o=r.split(",").map(c=>c.trim())}let d=v(process.cwd(),O),w=await Ct();I(d)||await _(w),f.info(`Using cache: ${d}`);let b=new Map;for(let r of i){let c=await N(r,"utf-8");b.set(r,Et(c))}let l=[],y=0;for(let r of o)for(let c of i){let x=b.get(c);if(!x)throw new Error(`Hash not found for file: ${c}`);e.force||jt(w,c,r,x)?l.push({filePath:c,locale:r,hash:x}):y+=1}if(l.length===0){f.success("All translations are up to date!"),$(`Skipped ${y} file(s) (unchanged)`);return}let T=[];for(let r=0;r<l.length;r+=A)T.push(l.slice(r,r+A));f.info(`Processing ${l.length} translation(s) in ${T.length} batch(es) of up to ${A}`),y>0&&f.info(`Skipped ${y} translation(s) (unchanged)`);let P=Tt();try{let r=[];P.start("Starting translation...");let c=0;for(let h=0;h<T.length;h++){let j=T[h];for(let p of j){let{name:L,ext:W}=G(p.filePath);P.message(`Translating ${L} to ${p.locale} - ${c}/${l.length} complete`);let q=await Dt(p.filePath,p.locale,n);await At(p.filePath,p.locale,q,w,p.hash),r.push({name:L,locale:p.locale,ext:W}),c+=1}h<T.length-1&&(P.message(`Batch ${h+1}/${T.length} complete. Pausing...`),await new Promise(p=>setTimeout(p,1e3)))}P.stop("Translation complete!");for(let{name:h,locale:j,ext:p}of r)f.success(`Saved: ${h}.${j}${p}`);let x=[`Translated ${r.length} file(s)`];y>0&&x.push(`Skipped ${y} unchanged`),$(x.join(" \u2022 "))}catch(r){let c=r instanceof Error?r.message:String(r);P.stop(`Translation failed: ${c}`),$("Exiting"),process.exit(1)}};import{copyFile as Nt,mkdir as K,rm as X}from"fs/promises";import{dirname as Ot,join as S}from"path";import{intro as Ut,log as u,outro as H,spinner as Lt}from"@clack/prompts";import{glob as Rt}from"glob";var V="apps/template",J=["**/*"],kt=["content/docs/**"],It=async t=>{let e=process.cwd(),s=S(e,t);await X(s,{recursive:!0,force:!0}),await K(s,{recursive:!0})},zt=async t=>await g(`git clone --depth 1 ${D} ${t}`),U=async t=>await X(t,{recursive:!0,force:!0}),Gt=async(t,e,s)=>(await Rt(t,{cwd:s,nodir:!0,dot:!0,ignore:[".git/**",...e]})).sort(),_t=async(t,e)=>{let s=process.cwd(),o=S(e,V,t),n=S(s,t);await K(Ot(n),{recursive:!0}),await Nt(o,n)},Mt=async(t,e,s)=>{let o={success:[],failed:[]};for(let n of t)try{s.message(`Updating ${n}...`),await _t(n,e),o.success.push(n)}catch(a){let i=a instanceof Error?a.message:`${a}`;o.failed.push({file:n,error:i})}return o},Ht=t=>{if(t.success.length>0){u.success(`Successfully updated ${t.success.length} files:`);for(let e of t.success)u.info(`  \u2713 ${e}`)}if(t.failed.length>0){u.warn(`Failed to update ${t.failed.length} files:`);for(let{file:e,error:s}of t.failed)u.error(`  \u2717 ${e}: ${s}`)}},B=async()=>{let t=process.cwd(),e=S(t,F);try{Ut("Let's update your Geistdocs project!"),u.info(`Repository: ${D}`);let s=Lt();s.start("Creating temporary directory..."),await It(F),s.message("Cloning repository..."),await zt(F),s.message("Scanning for files...");let o=S(e,V),n=await Gt(J,kt,o);if(s.stop(`Found ${n.length} files to update`),n.length===0){u.warn("No files matched the patterns. Nothing to update."),await U(e),H("Update cancelled.");return}u.info(`Patterns: ${J.length}`),u.info(`Files to update: ${n.length}`),s.start("Updating files...");let a=await Mt(n,e,s);s.message("Cleaning up..."),await U(e),s.stop("Update complete!"),Ht(a),H("Please review and test the changes carefully.")}catch(s){let o=s instanceof Error?s.message:`${s}`;try{await U(e)}catch{}u.error(`Failed to update project: ${o}`),process.exit(1)}};C.command("init").description("Initialize a new Geistdocs project").option("--name <name>","Name of the project").option("--disable-git","Disable git initialization").action(k);C.command("update").description("Update a Geistdocs project").action(B);C.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(M);C.parse(process.argv);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vercel/geistdocs",
   "description": "CLI for Geistdocs projects, including initialization and updating.",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "type": "module",
   "bin": {
     "geistdocs": "dist/index.js"