allyhub 0.3.0 → 0.5.0

package/dist/node_modules/@allyhub-next/export/dist/export.js

@@ -0,0 +1,7 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{renderDeckPptx as xe}from"./deck-pptx.js";import{readFileSync as be}from"node:fs";import{mkdir as D,readFile as $e,stat as ne,writeFile as R}from"node:fs/promises";import{cpus as ke}from"node:os";import{basename as G,dirname as se,isAbsolute as ye,join as w,posix as oe,relative as ie,sep as Pe}from"node:path";import{parseDoc as Se,markdownOf as je}from"@allyhub-next/doc";import{createPackages as Oe}from"@allyhub-next/runtimes";import{codeOf as Ce,fontsDigest as Ee,readSheetSource as Me,workbookFiles as Ne}from"@allyhub-next/build";import{RenderError as ve,VIDEO_TYPES as Fe,renderCaptions as Te,renderCover as Ae,renderPdf as Ie,renderPng as Le,renderPptx as _e,renderVideo as De,mixSound as Re,requireEncoder as We,requireFfmpeg as Ve}from"@allyhub-next/render";import{docFontsCss as Ye,printPage as ze,renderDoc as Ge,renderWord as He}from"@allyhub-next/render/doc";import{checkWorkbook as Ue,csvOf as qe,jsonOf as Je,markdownOf as re,seededRandom as Be,sheetHtml as Ke}from"@allyhub-next/sheet";import{writeXlsx as Xe}from"@allyhub-next/sheet/xlsx";import{CACHE_DIR as Qe}from"@allyhub-next/formats";import{buildModule as Ze}from"@allyhub-next/model/build";import{graphicsPage as et,stageIdentity as tt}from"@allyhub-next/stage";import{DEFAULT_TYPES as nt,FILE_TYPES as ae,comboKey as H,exportProblem as st,pieceIs as U,pieceNamed as ce}from"@allyhub-next/video-core";import{runCheck as ot}from"@allyhub-next/check";import{batchCsv as it,batchRows as rt}from"./batch.js";import{batchName as at,checkName as ct,exportName as le,exportNames as lt}from"./names.js";import{ConsolePool as dt,mergeConsole as ft,dedupe as de,indexNeeds as pt,makeIndex as mt,CheckSession as ut,OpenedVersion as ht,ProjectError as I,versionLabel as fe}from"@allyhub-next/project";const pe=e=>Fe.includes(e);async function gt(e){const o=Oe(),c=()=>e?.("Getting docx, once, to write Word documents…"),[t,p]=await Promise.all([o.load("docx",{onFetch:c}),o.load("docx",{module:"fflate",onFetch:c})]);return{docx:t,zip:p}}export async function exportVersion(e,o,c,t={}){await D(se(c),{recursive:!0});const p={page:e.graphics(),target:e.target,look:e.look,media:e.media,out:c,...t.steps===!0?{steps:!0}:{},...t.pptx&&t.pptx!=="native"?{pptx:t.pptx}:{}};if(o==="pptx"&&e.piece.kind==="slides"&&(t.pptx??"native")==="native"){const d=await xe(e,c);if(d)return t.onProgress?.(1),d}if(o==="wav"){const d=await Re({timeline:e.timeline,sound:await e.sound(),out:c});return t.onProgress?.(1),{files:[c],duration:Math.round(e.timeline.duration*e.timeline.fps)/e.timeline.fps,...d.loudness?{loudness:d.loudness}:{},master:{...d}}}if(pe(o)&&(o!=="png"||e.piece.kind==="video")){const d=e.prepared,i=await Ee(d.root,d.files,d.fonts),a=await De({target:e.target,look:e.look,media:e.media,pages:[e.graphics()],openPage:async()=>{const m=await e.session.open(e.piece,e.target,"render");return et(m.stage,{gpu:e.session.gpu})},...o==="gif"?{}:{sound:await e.sound()},out:c,type:o,...t.encode?{encode:t.encode}:{},...t.workers===void 0?{}:{workers:t.workers},...t.onProgress?{onProgress:t.onProgress}:{},code:await Ce(d,e.piece,tt(i)),...t.partCache===!1?{partCache:!1}:{},...t.signal?{signal:t.signal}:{}});return{files:a.files??[a.out],duration:a.duration,parts:a.parts,...a.junctions?{junctions:a.junctions}:{},...a.loudness?{loudness:a.loudness}:{},...a.master?{master:{...a.master}}:{},timings:a.timings}}const u=o==="srt"||o==="vtt"?await Te({...p,type:o,...t.captions?{captions:t.captions}:{}}):o==="pdf"?await Ie(p):o==="pptx"?await _e(p):o==="png"?await Le(p):await Ae(p);return t.onProgress?.(1),{files:u.files??[u.out]}}export const exportsAtOnce=e=>Math.max(1,Math.min(e,Math.floor(ke().length/4))),DOC_TYPES=["pdf","docx","png","md"],SHEET_TYPES=["xlsx","pdf","png","csv","md","json"],MODEL_TYPES=["glb"];const q=(e,o)=>`${String(e)} ${o}${e===1?"":"s"}`,J=(e,o)=>U({id:e,path:e},o)||U({id:e,path:e},`content/${o}`);function wt(e){if(e===void 0)return;const o=new Set([...Object.keys(ae),...DOC_TYPES,...SHEET_TYPES,...MODEL_TYPES]);for(const c of e)if(!o.has(c))throw new I("bad-type",`Cannot render ${c}.`,"usage",`Types: ${[...o].join(", ")}.`);return[...e]}export async function exportProject(e){const o=wt(e.types);e.name!==void 0&&ct(e.name);const c=e.items??[],t=c.length>0,p=f=>c.some(P=>J(f,P)),u=[],d=[],i=[],a=()=>ut.open({root:e.root,...e.gpu===void 0?{}:{gpu:e.gpu},...e.consoleLimit===void 0?{}:{consoleLimit:e.consoleLimit}});let m=await a();try{const f=m.prepared,P=f.docs.filter(n=>!t||p(n.place)),b=f.sheets.filter(n=>!t||p(n.place)),L=f.items.filter(n=>n.kind==="model"&&(!t||p(n.dir))),x=c.filter(n=>!f.items.some(s=>s.kind==="model"&&U({id:s.dir,path:s.dir},n))&&!f.docs.some(s=>J(s.place,n))&&!f.sheets.some(s=>J(s.place,n)));for(const n of x)if(!f.pieces.some(s=>ce({id:s.id,path:s.place},n)))throw new I("no-item",`No item ${n}.`,"not-found",`Items: ${[...f.pieces.map(s=>s.id),...f.docs.map(s=>s.place),...f.sheets.map(s=>s.place),...f.items.filter(s=>s.kind==="model").map(s=>s.dir)].join(", ")||"none"}.`);const T=t&&x.length===0,_=o?.filter(n=>n in ae),$=T?[]:f.pieces.filter(n=>x.length===0||x.some(s=>ce({id:n.id,path:n.place},s))),S=o?.includes("csv")===!0?$.filter(n=>n.matrix!==void 0):[];if(o?.includes("csv")===!0&&x.length>0&&S.length===0)throw new I("bad-type",`${x.join(", ")} has no slots (matrix.slots), so there is no table of ads to write as csv.`,"usage","csv is a batch's table of ads, or a sheet's rows.");let g=[...f.problems];const N=new dt(m.consoleLimit),W=new Set([...f.docs.map(n=>n.file),...f.sheets.flatMap(n=>n.files)]),ue=n=>n.where?.file!==void 0&&W.has(n.where.file),B=n=>n.filter(s=>s.level==="error"&&!ue(s)).length;if(!T&&(_?.length!==0||S.length>0)&&(f.pieces.length>0||B(f.problems)>0)){e.log?.("Checking…");const n=()=>bt(m,e.root,x,e.combos);let s=await n();const A=e.index===!1?[]:pt(s.results);if(A.length>0){const r=await mt(f.root,A,$t(e.log),e.signal);i.push(...r.failed.map(l=>({file:l.need.file,error:l.error}))),r.done.length>0&&(await m.close(),m=await a(),s=await n())}g=s.problems,N.addReport(s.console);const F=B(s.problems);if(F>0)throw new I("check-failed",`The check found ${q(F,"must-fix problem")}, so nothing is rendered.`,"failed","allyhub check lists them; fix them, then render.");for(const r of S){const l=performance.now(),j=at(r.id),C=rt(r,s.plans,m.prepared.media,xt(e.root,e.out),e.name);await D(se(w(e.out,j)),{recursive:!0}),await R(w(e.out,j),it(C));const E=s.targets.filter(k=>k.piece===r.id).length;C.length<E&&e.log?.(`${j}: ${q(E-C.length,"ad")} not listed, which did not load (allyhub check says why).`),u.push(await M(e.out,j,r.id,"csv",l))}const O=[],V=new Set;for(const r of s.targets){const l=m.prepared.pieces.find(h=>h.id===r.piece);if(!l)continue;if(!t&&l.options.deliverable===!1){V.add(r.piece);continue}const j=l.kind,C=s.results.find(h=>h.piece===r.piece&&H(h.combo)===r.key&&h.format===r.format),E=s.plans.find(h=>h.piece===r.piece&&H(h.combo)===r.key&&h.format===r.format),k=C?.timeline?(C.timeline.audio.speech?.length??0)>0:E?.parts.some(h=>h.speech!==void 0)??!1,v={piece:r.piece,output:r.output,combo:r.combo,format:r.format,...r.id===void 0?{}:{id:r.id}};for(const h of _??nt[j]){const y=st({kind:j,speech:k},h);if(!(y?.code==="bad_type"&&!t)){if(y&&y.code!=="no_speech")throw new I("bad-type",`${fe(v)}: ${y.message}`,"usage",y.hint);O.push({target:v,type:h,...y?{refused:{name:le(v,h,e),piece:v.piece,type:h,code:"no-speech",message:`${fe(v)}: ${y.message}`,...y.hint?{hint:y.hint}:{}}}:{}})}}}if(V.size>0&&e.log?.(`Not rendered, shown only inside another video (deliverable: false): ${[...V].join(", ")}. Name one to render it.`),O.some(r=>pe(r.type)||r.type==="wav")){await Ve();for(const r of new Set(O.map(l=>l.type)))await We(r,e.encode?.codec)}const Q=lt(O,e.name,e);O.forEach((r,l)=>{r.refused&&(r.refused.name=Q[l]??r.refused.name)});const Z=[],Y=new Array(O.length).fill(0),z=(r,l)=>{Y[r]=Math.max(Y[r]??0,l),e.onProgress?.(Y.reduce((j,C)=>j+C,0)/O.length)};let ee=0,he=0;const ge=async()=>{for(let r=ee++;r<O.length;r=ee++){e.signal?.throwIfAborted();const l=O[r];if(!l)continue;const j=Q[r]??le(l.target,l.type,e);if(l.refused){d.push(l.refused),z(r,1);continue}const C=performance.now(),E=await ht.open({root:e.root,session:m,item:l.target.piece,combos:[l.target.combo],purpose:"render"});try{const k=await exportVersion(E,l.type,w(e.out,j),{...e,onProgress:y=>{z(r,y)}}),v=(await Promise.all(k.files.map(y=>ne(y)))).reduce((y,we)=>y+we.size,0),h=Math.round((performance.now()-C)/10)/100;u.push({...k,name:me(ie(e.out,k.files[0]??"")),path:k.files[0]??w(e.out,j),piece:l.target.piece,type:l.type,combo:l.target.combo,key:H(l.target.combo),format:l.target.format,bytes:v,seconds:h}),e.log?.(`[${String(++he)}/${String(O.length)}] ${j} (${h.toFixed(1)} s)`)}catch(k){if(e.signal?.aborted||!(k instanceof ve))throw k;d.push({name:j,piece:l.target.piece,type:l.type,code:k.code,message:k.message,...k.hint?{hint:k.hint}:{}})}finally{Z.push(...await E.problems()),N.add(l.target,await E.console()),await E.close(),z(r,1)}}};O.length>0&&e.log?.(`Rendering ${q(O.length,"file")}…`);const te=(await Promise.allSettled(Array.from({length:exportsAtOnce(O.length)},ge))).find(r=>r.status==="rejected");if(te)throw te.reason;g=de([...g,...Z])}const K=n=>f.problems.find(s=>s.level==="error"&&s.where?.file!==void 0&&n.includes(s.where.file));for(const n of[...P,...b]){const s=K("files"in n?n.files:[n.file]);s&&d.push({name:n.place,piece:n.place,type:"files"in n?"xlsx":"pdf",code:"check-failed",message:`${s.where?.file??n.place}: ${s.message}`,hint:"Fix it, then render again."})}e.signal?.throwIfAborted();const X=n=>n.filter(s=>K("files"in s?s.files:[s.file])===void 0);if(u.push(...await kt(e.root,X(P),o,e.out,e.log),...await yt(e.root,X(b),o,e.out,e.log)),o===void 0||o.includes("glb"))for(const n of L){e.log?.(`Building ${n.entry}…`);const s=performance.now(),A=`${n.dir}/${G(n.dir)}.glb`;try{await Ze(w(e.root,n.entry),{root:e.root,out:w(e.out,A),cache:w(e.root,Qe,"model"),log:()=>{}}),u.push(await M(e.out,A,n.dir,"glb",s))}catch(F){d.push({name:n.dir,piece:n.dir,type:"glb",code:"model-failed",message:`${n.entry}: ${F instanceof Error?F.message:String(F)}`,hint:"Fix it, then render again."})}}return{out:e.out,files:u,failed:d,problems:g,console:N.report(),unindexed:i}}finally{await m.close()}}const me=e=>e.split(Pe).join("/");function xt(e,o){const c=ie(e,o);return c===""?".":c.startsWith("..")||ye(c)?o:me(c)}async function bt(e,o,c,t){const p=[];for(const a of c.length>0?c:[void 0])p.push(await ot({dir:o,session:e,facts:!1,...a===void 0?{}:{piece:a},...t?{combos:[...t]}:{}}));const u=new Set,d=p.flatMap(a=>a.targets).filter(a=>{const m=`${a.piece}\0${a.key}\0${a.format}`;return u.has(m)?!1:(u.add(m),!0)}),i=de(p.flatMap(a=>a.problems));return{targets:d,results:p.flatMap(a=>a.results),plans:p.flatMap(a=>a.plans),problems:i,errors:i.filter(a=>a.level==="error").length,console:ft(e.consoleLimit,...p.map(a=>a.console))}}function $t(e){let o="";return c=>{const t=c.status==="failed"?`Could not index ${c.file}: ${c.message}`:c.message;c.status==="running"&&c.share!==void 0||t!==o&&(o=t,e?.(t))}}async function M(e,o,c,t,p){const u=w(e,o);return{files:[u],name:o,path:u,piece:c,type:t,bytes:(await ne(u)).size,seconds:Math.round((performance.now()-p)/10)/100}}async function kt(e,o,c,t,p){const u=(c??["pdf"]).filter(i=>DOC_TYPES.includes(i)),d=[];for(const i of o){if(u.length===0)break;p?.(`Rendering ${i.file}…`);const a=performance.now(),m=G(i.place);if(u.includes("md")){const b=await $e(w(e,i.file),"utf8");await D(w(t,i.place),{recursive:!0}),await R(w(t,i.place,`${m}.md`),je(Se(b).blocks)),d.push(await M(t,`${i.place}/${m}.md`,i.place,"md",a))}if(u.includes("docx")){const b=`${i.place}/${m}.docx`;await He({root:e,doc:{file:i.file,dir:i.dir,path:i.place,title:i.title},out:w(t,b),...await gt(p)}),d.push(await M(t,b,i.place,"docx",a))}const f=u.filter(b=>b==="pdf"||b==="png");if(f.length===0)continue;const P=await Ge({root:e,doc:{file:i.file,dir:i.dir,path:i.place,title:i.title},out:w(t,i.place),name:m,types:f});for(const b of P)d.push(await M(t,`${i.place}/${b}`,i.place,b.endsWith(".png")?"png":"pdf",a))}return d}export const PNG_ROWS=700,PNG_COLUMNS=200;async function yt(e,o,c,t,p){const u=(c??["xlsx"]).filter(i=>SHEET_TYPES.includes(i)),d=[];for(const i of o){if(u.length===0)break;p?.(`Writing ${i.file}…`);const a=performance.now(),m=await Me(e,i.dir);if(m.failed){p?.(`${i.file}: its sheet.ts does not run. allyhub check says why.`);continue}const{workbook:f,calc:P}=Ue(Ne(e,m),{random:Be([m.text,...m.csv.values(),m.generated?JSON.stringify(m.generated):""].join(`
+`))});if(!f||!P)continue;const b=$=>{const S=oe.normalize(oe.join(i.dir,$));try{return S.startsWith("..")?void 0:new Uint8Array(be(w(e,S)))}catch{return}};await D(w(t,i.place),{recursive:!0});const L=G(i.place),x=`${i.place}/${L}`,T=f.sheets.length>1,_=async $=>{const S=Ke(P,{css:await Ye(),font:"Commissioner Variable",file:b,...$==="png"?{rows:PNG_ROWS,columns:PNG_COLUMNS,headings:!1}:{}});for(const g of S.cut)p?.(`${x}.png: ${g}`);await ze({html:S.html,out:w(t,i.place),name:L,types:[$]}),d.push(await M(t,`${x}.${$}`,i.place,$,a))};for(const $ of u){if($==="pdf"||$==="png"){await _($);continue}if($==="xlsx"){const{bytes:g,left:N}=Xe(P,{file:b});await R(w(t,`${x}.xlsx`),g);for(const W of N)p?.(`${x}.xlsx does not hold ${W}.`);d.push(await M(t,`${x}.xlsx`,i.place,"xlsx",a));continue}const S=[];if($==="csv")for(const g of f.sheets)S.push([T?`${x}-${g.name.replace(/\W+/gu,"-")}.csv`:`${x}.csv`,qe(P,g)]);else $==="md"?S.push([`${x}.md`,f.sheets.map(g=>T?`## ${g.name}
+
+${re(P,g)}`:re(P,g)).join(`
+`)]):S.push([`${x}.json`,`${JSON.stringify(Je(P),null,2)}
+`]);for(const[g,N]of S)await R(w(t,g),N),d.push(await M(t,g,i.place,$,a))}}return d}

package/dist/node_modules/@allyhub-next/export/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { DOC_TYPES, SHEET_TYPES, exportProject, exportVersion, exportsAtOnce, type DocType, type ExportedFile, type NotExported, type ProjectExport, type ProjectExportOptions, type SheetType, type VersionExportOptions, type VersionFile, } from "./export.js";
+export { batchName, checkName, exportName, exportNames, versionSuffixes, } from "./names.js";
+export { batchCsv, batchOf, batchRows, type Batch, type BatchCombo, type BatchRow, } from "./batch.js";
+export { renderDeckPptx } from "./deck-pptx.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@allyhub-next/export/dist/index.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{DOC_TYPES,SHEET_TYPES,exportProject,exportVersion,exportsAtOnce}from"./export.js";export{batchName,checkName,exportName,exportNames,versionSuffixes}from"./names.js";export{batchCsv,batchOf,batchRows}from"./batch.js";export{renderDeckPptx}from"./deck-pptx.js";

package/dist/node_modules/@allyhub-next/export/dist/names.d.ts

@@ -0,0 +1,36 @@
+import { type Target } from "@allyhub-next/project";
+import { type FileType } from "@allyhub-next/video-core";
+/** How a deck's file was made, which its name says: another way never overwrites it. */
+export interface ExportManner {
+    steps?: boolean;
+    pptx?: "native" | "picture" | "editable";
+}
+/**
+ * Where a version's file goes in the output folder, by the name of the
+ * piece's folder: `film/film.<combo id>.<ext>` for a piece with slots,
+ * `film/film.<its values, in the dimensions' order by name>.<ext>`
+ * (film.en.mp4), or `film/film.<ext>` when the piece has no dimensions.
+ */
+export declare function exportName(t: Target, type: FileType, how?: ExportManner): string;
+/** A name for the files (allyhub render --name), checked: a plain file name without folders or an extension's dot at either end. */
+export declare function checkName(name: string): string;
+/**
+ * What tells apart the versions of one piece that share a name: a chosen
+ * combo's id (c03) for a piece with slots, else the values of the
+ * dimensions that differ among them, in the dimensions' order by name
+ * (en, zh-cn; en.b). Empty when they are all one version.
+ */
+export declare function versionSuffixes(targets: readonly Pick<Target, "combo" | "id">[]): string[];
+/**
+ * Where each of these files goes in the output folder: exportName's,
+ * or with a name, `<piece>/<name>.<ext>` in the piece's folder, and
+ * `<piece>/<name>.<what tells its versions apart>.<ext>` when several
+ * versions of the piece are made (versionSuffixes), so no two collide.
+ */
+export declare function exportNames(items: readonly {
+    target: Target;
+    type: FileType;
+}[], name?: string, how?: ExportManner): string[];
+/** Where a batch's table of ads goes in the output folder: `<piece>/ads.csv`. */
+export declare const batchName: (piece: string) => string;
+//# sourceMappingURL=names.d.ts.map

package/dist/node_modules/@allyhub-next/export/dist/names.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{ProjectError as u}from"@allyhub-next/project";import{FILE_TYPES as i,comboKey as d}from"@allyhub-next/video-core";function s(e,t){return[t?.pptx!==void 0&&t.pptx!=="native"&&e==="pptx"?t.pptx:void 0,t?.steps===!0&&(e==="pdf"||e==="png")?"steps":void 0].flatMap(r=>r===void 0?[]:[`.${r}`]).join("")}export function exportName(e,t,r){const n=e.piece.slice(e.piece.lastIndexOf("/")+1),c=e.id??Object.keys(e.combo).sort().map(o=>e.combo[o]??"").join(".");return`${e.piece}/${n}${c===""?"":`.${c}`}${s(t,r)}.${i[t].ext}`}export function checkName(e){const t=e.trim().replace(/\.+$/u,"");if(t===""||/[/\\]/u.test(t)||t.startsWith("."))throw new u("bad-name",`Cannot name the files ${e}.`,"usage","Give a plain file name without folders or an extension, like --name tidyform-launch; --out chooses the folder.");return t}export function versionSuffixes(e){const t=e.map(n=>n.id??d(n.combo));if(new Set(t).size<=1)return e.map(()=>"");const r=[...new Set(e.flatMap(n=>Object.keys(n.combo)))].filter(n=>new Set(e.map(c=>c.combo[n])).size>1).sort();return e.map(n=>n.id??r.map(c=>n.combo[c]??"").join("."))}export function exportNames(e,t,r){if(t===void 0)return e.map(o=>exportName(o.target,o.type,r));const n=checkName(t),c=new Map;for(const o of new Set(e.map(p=>p.target.piece))){const p=e.map(a=>a.target).filter(a=>a.piece===o),f=versionSuffixes(p);p.forEach((a,m)=>c.set(a,f[m]??""))}return e.map(o=>{const p=c.get(o.target)??"";return`${o.target.piece}/${n}${p===""?"":`.${p}`}${s(o.type,r)}.${i[o.type].ext}`})}export const batchName=e=>`${e}/ads.csv`;

package/dist/node_modules/@allyhub-next/export/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub-next/export",
+  "version": "0.5.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}