allyhub 0.3.0 → 0.4.0

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

@@ -10,8 +10,14 @@ export interface VersionExportOptions {
     captions?: CaptionCueOptions;
     /** false renders every part again and keeps nothing in the part cache. */
     partCache?: false;
+    /** A deck's pdf, png and pptx: a page, a file or a slide per step, not only each page's last. */
+    steps?: boolean;
+    /** A deck's pptx: PowerPoint's own model (the default), each slide a picture, or its text boxes over the picture. */
+    pptx?: "native" | "picture" | "editable";
     /** 0–1. */
     onProgress?: (p: number) => void;
+    /** Aborting it stops the export: what runs stops, and no part of a file stays. */
+    signal?: AbortSignal;
 }
 /** What one export wrote. */
 export interface VersionFile {
@@ -34,8 +40,12 @@ export interface VersionFile {
     };
     master?: Record<string, unknown>;
     timings?: RenderTimings;
+    /** A deck's PowerPoint file: the fonts it names and does not carry, and why. */
+    fontsLeft?: {
+        font: string;
+        why: string;
+    }[];
 }
-/** One version as one file type, written to `out` (its first file's path). */
 export declare function exportVersion(v: OpenedVersion, type: FileType, out: string, o?: VersionExportOptions): Promise<VersionFile>;
 /** Exports made at once: a quarter of the CPUs. */
 export declare const exportsAtOnce: (n: number) => number;
@@ -62,7 +72,7 @@ export interface NotExported {
     hint?: string;
 }
 /** A doc's and a sheet's own file types. */
-export declare const DOC_TYPES: readonly ["pdf", "png", "md"];
+export declare const DOC_TYPES: readonly ["pdf", "docx", "png", "md"];
 export declare const SHEET_TYPES: readonly ["xlsx", "csv", "md", "json"];
 export type DocType = (typeof DOC_TYPES)[number];
 export type SheetType = (typeof SHEET_TYPES)[number];
@@ -90,7 +100,6 @@ export interface ProjectExportOptions extends VersionExportOptions {
     /** Make what the media index lacks first (default true). */
     index?: boolean;
     log?: (line: string) => void;
-    signal?: AbortSignal;
 }
 export interface ProjectExport {
     out: string;

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

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

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

@@ -1,4 +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/node_modules/@allyhub-next/export/dist/index.js

@@ -1,2 +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{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/node_modules/@allyhub-next/export/dist/names.d.ts

@@ -1,12 +1,17 @@
 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:
- * `<piece>/video.<combo id>.<ext>` for a piece with slots,
- * `<piece>/video.<combo key>.<ext>`, or `<piece>/video.<ext>` when the
- * piece has no dimensions.
+ * 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): string;
+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;
 /**
@@ -25,7 +30,7 @@ export declare function versionSuffixes(targets: readonly Pick<Target, "combo" |
 export declare function exportNames(items: readonly {
     target: Target;
     type: FileType;
-}[], name?: string): string[];
+}[], 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/node_modules/@allyhub-next/export/dist/names.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{ProjectError as m}from"@allyhub-next/project";import{FILE_TYPES as s,comboKey as i}from"@allyhub-next/video-core";export function exportName(e,n){const a=i(e.combo),t=e.id??(a==="default"?"":a);return`${e.piece}/${e.output}${t===""?"":`.${t}`}.${s[n].ext}`}export function checkName(e){const n=e.trim().replace(/\.+$/u,"");if(n===""||/[/\\]/u.test(n)||n.startsWith("."))throw new m("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 n}export function versionSuffixes(e){const n=e.map(t=>t.id??i(t.combo));if(new Set(n).size<=1)return e.map(()=>"");const a=[...new Set(e.flatMap(t=>Object.keys(t.combo)))].filter(t=>new Set(e.map(o=>o.combo[t])).size>1).sort();return e.map(t=>t.id??a.map(o=>t.combo[o]??"").join("."))}export function exportNames(e,n){if(n===void 0)return e.map(o=>exportName(o.target,o.type));const a=checkName(n),t=new Map;for(const o of new Set(e.map(r=>r.target.piece))){const r=e.map(c=>c.target).filter(c=>c.piece===o),p=versionSuffixes(r);r.forEach((c,f)=>t.set(c,p[f]??""))}return e.map(o=>{const r=t.get(o.target)??"";return`${o.target.piece}/${a}${r===""?"":`.${r}`}.${s[o.type].ext}`})}export const batchName=e=>`${e}/ads.csv`;
+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/node_modules/@allyhub-next/export/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allyhub-next/export",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "exports": {
     ".": {

package/node_modules/@allyhub-next/formats/dist/data/script.d.ts

@@ -16,6 +16,19 @@ export declare const ScriptPartSchema: z.ZodObject<{
     }, z.core.$strict>]>>;
     screen: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<ScriptText, unknown, z.core.$ZodTypeInternals<ScriptText, unknown>>>>;
 }, z.core.$strict>;
+/**
+ * A deck's slide in its script: the words of its shapes by their names
+ * (a list is a shape's paragraphs) and its speaker notes.
+ */
+export declare const ScriptSlideSchema: z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<ScriptText, unknown, z.core.$ZodTypeInternals<ScriptText, unknown>>>>;
+    notes: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        declarations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        selectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        match: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>]>>;
+}, z.core.$strict>;
 export declare const ScriptFileSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
     text: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<ScriptText, unknown, z.core.$ZodTypeInternals<ScriptText, unknown>>>>;
@@ -28,6 +41,15 @@ export declare const ScriptFileSchema: z.ZodObject<{
         }, z.core.$strict>]>>;
         screen: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<ScriptText, unknown, z.core.$ZodTypeInternals<ScriptText, unknown>>>>;
     }, z.core.$strict>>>;
+    slides: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<ScriptText, unknown, z.core.$ZodTypeInternals<ScriptText, unknown>>>>;
+        notes: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            declarations: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            selectors: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            match: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strict>]>>;
+    }, z.core.$strict>>>;
 }, z.core.$strict>;
 export type ScriptFile = z.infer<typeof ScriptFileSchema>;
 /** The script of an item in a language. */

package/node_modules/@allyhub-next/formats/dist/data/script.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as t}from"zod";import{SpokenSchema as n,VariantsSchema as s}from"./messages.js";export const SCRIPT_NAME=/^[A-Za-z0-9_-]+$/u;const r=t.string().regex(SCRIPT_NAME,"A name is letters, digits, _ and -.");export const ScriptTextSchema=t.lazy(()=>t.union([t.string(),n,s,t.array(ScriptTextSchema),t.record(r,ScriptTextSchema)])),ScriptPartSchema=t.strictObject({id:r,say:t.union([t.string(),s]).optional(),screen:t.record(r,ScriptTextSchema).optional()}),ScriptFileSchema=t.strictObject({title:t.string().optional(),text:t.record(r,ScriptTextSchema).optional(),parts:t.array(ScriptPartSchema).default([])}).superRefine((e,a)=>{const i=new Set;e.parts.forEach((o,c)=>{i.has(o.id)&&a.addIssue({code:"custom",path:["parts",c,"id"],message:`Two parts are "${o.id}".`}),i.add(o.id)})}),scriptFileFor=(e,a)=>`${e}/script.${a}.yaml`;export function scriptLocale(e){return/(?:^|\/)script\.([A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*)\.yaml$/u.exec(e)?.[1]}
+import{z as t}from"zod";import{SpokenSchema as d,VariantsSchema as i}from"./messages.js";export const SCRIPT_NAME=/^[A-Za-z0-9_-]+$/u;const s=t.string().regex(SCRIPT_NAME,"A name is letters, digits, _ and -.");export const ScriptTextSchema=t.lazy(()=>t.union([t.string(),d,i,t.array(ScriptTextSchema),t.record(s,ScriptTextSchema)])),ScriptPartSchema=t.strictObject({id:s,say:t.union([t.string(),i]).optional(),screen:t.record(s,ScriptTextSchema).optional()}),ScriptSlideSchema=t.strictObject({id:s,text:t.record(s,ScriptTextSchema).optional(),notes:t.union([t.string(),i]).optional()}),ScriptFileSchema=t.strictObject({title:t.string().optional(),text:t.record(s,ScriptTextSchema).optional(),parts:t.array(ScriptPartSchema).default([]),slides:t.array(ScriptSlideSchema).default([])}).superRefine((r,o)=>{const c=new Set;r.parts.forEach((e,a)=>{c.has(e.id)&&o.addIssue({code:"custom",path:["parts",a,"id"],message:`Two parts are "${e.id}".`}),c.add(e.id)});const n=new Set;r.slides.forEach((e,a)=>{n.has(e.id)&&o.addIssue({code:"custom",path:["slides",a,"id"],message:`Two slides are "${e.id}".`}),n.add(e.id)})}),scriptFileFor=(r,o)=>`${r}/script.${o}.yaml`;export function scriptLocale(r){return/(?:^|\/)script\.([A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*)\.yaml$/u.exec(r)?.[1]}