allyhub 0.3.0 → 0.5.0

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

@@ -1,110 +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;
-    /** 0–1. */
-    onProgress?: (p: number) => void;
-}
-/** 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;
-}
-/** 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;
-/** 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", "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;
-    signal?: AbortSignal;
-}
-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{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}

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

@@ -1,4 +0,0 @@
-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";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1,2 +0,0 @@
-/*! 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";

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

@@ -1,31 +0,0 @@
-import { type Target } from "@allyhub-next/project";
-import { type FileType } from "@allyhub-next/video-core";
-/**
- * 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.
- */
-export declare function exportName(t: Target, type: FileType): 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): 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 +0,0 @@
-/*! 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`;

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

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