allyhub 0.4.0 → 0.5.0

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

@@ -1,119 +0,0 @@
-import { type EncodeOptions, type RenderTimings } from "@allyhub-next/render";
-import { type CaptionCueOptions, type Combo, type ConsoleReport, type FileType, type Problem } from "@allyhub-next/video-core";
-import { OpenedVersion } from "@allyhub-next/project";
-/** How a version's files are made. */
-export interface VersionExportOptions {
-    encode?: EncodeOptions;
-    /** Pages drawing a video's graphics, shared by the parts it renders at once. */
-    workers?: number;
-    /** srt and vtt: how cues are cut and timed; default as the piece's own captions are (subtitleCues). */
-    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 {
-    /** Every file written; one, or a PNG per page or frame. */
-    files: string[];
-    /** A video's seconds. */
-    duration?: number;
-    parts?: {
-        total: number;
-        cached: number;
-    };
-    junctions?: {
-        total: number;
-        cached: number;
-    };
-    loudness?: {
-        integrated: number;
-        range?: number;
-        truePeak?: number;
-    };
-    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;
-    }[];
-}
-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;
-/** A file a project's export made. */
-export interface ExportedFile extends VersionFile {
-    /** Its path in the output folder, with / between folders. */
-    name: string;
-    path: string;
-    piece: string;
-    type: FileType | DocType | SheetType | ModelType;
-    combo?: Combo;
-    key?: string;
-    format?: string;
-    bytes: number;
-    seconds: number;
-}
-/** A file that could not be made, and why; the others are made. */
-export interface NotExported {
-    name: string;
-    piece: string;
-    type: FileType | DocType | SheetType | ModelType;
-    code: string;
-    message: string;
-    hint?: string;
-}
-/** A doc's and a sheet's own file types. */
-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];
-/** What a 3D model renders to: its GLB, as `allyhub 3d-model` builds it. */
-export declare const MODEL_TYPES: readonly ["glb"];
-export type ModelType = (typeof MODEL_TYPES)[number];
-export interface ProjectExportOptions extends VersionExportOptions {
-    root: string;
-    /** Only these items (a piece, a doc or a sheet by id or place, a path into it, a folder of items); default every one. */
-    items?: readonly string[];
-    /** Only the combos matching one of these. */
-    combos?: readonly Combo[];
-    /** File types; default each kind's own (mp4, pdf; a doc's pdf; a sheet's xlsx). A type a kind does not have is skipped. */
-    types?: readonly string[];
-    /** The output folder. */
-    out: string;
-    /**
-     * A name for the versions' files: `<piece>/<name>.<ext>`, with what
-     * tells the versions apart before the extension when there are several
-     * (exportNames). Default each one's own (exportName).
-     */
-    name?: string;
-    gpu?: boolean;
-    consoleLimit?: number;
-    /** Make what the media index lacks first (default true). */
-    index?: boolean;
-    log?: (line: string) => void;
-}
-export interface ProjectExport {
-    out: string;
-    files: ExportedFile[];
-    failed: NotExported[];
-    /** The check's problems and what the pages found drawing. */
-    problems: Problem[];
-    console: ConsoleReport;
-    /** Videos the media index could not be made for, and why. */
-    unindexed: {
-        file: string;
-        error: string;
-    }[];
-}
-/** Every file the project's items make, as asked. */
-export declare function exportProject(o: ProjectExportOptions): Promise<ProjectExport>;
-//# sourceMappingURL=export.d.ts.map

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

@@ -1,3 +0,0 @@
-/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-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/package.json

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