allyhub 0.4.0 → 0.6.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 be}from"./deck-pptx.js";import{readFileSync as xe}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 Fe,VIDEO_TYPES as ve,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=>ve.includes(e);async function gt(e){const o=Oe(),c=()=>e?.("Getting docx, once, to write Word documents…"),[n,p]=await Promise.all([o.load("docx",{onFetch:c}),o.load("docx",{module:"fflate",onFetch:c})]);return{docx:n,zip:p}}export async function exportVersion(e,o,c,n={}){await D(se(c),{recursive:!0});const p={page:e.graphics(),target:e.target,look:e.look,media:e.media,out:c,...n.steps===!0?{steps:!0}:{}};if(o==="pptx"&&e.piece.kind==="slides"&&(n.pptx??"native")==="native"){const d=await be(e,c);if(d)return n.onProgress?.(1),d}if(o==="wav"){const d=await Re({timeline:e.timeline,sound:await e.sound(),out:c});return n.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,...n.encode?{encode:n.encode}:{},...n.workers===void 0?{}:{workers:n.workers},...n.onProgress?{onProgress:n.onProgress}:{},code:await Ce(d,e.piece,tt(i)),...n.partCache===!1?{partCache:!1}:{},...n.signal?{signal:n.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,...n.captions?{captions:n.captions}:{}}):o==="pdf"?await Ie(p):o==="pptx"?await _e(p):o==="png"?await Le(p):await Ae(p);return n.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??[],n=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(t=>!n||p(t.place)),x=f.sheets.filter(t=>!n||p(t.place)),L=f.items.filter(t=>t.kind==="model"&&(!n||p(t.dir))),b=c.filter(t=>!f.items.some(s=>s.kind==="model"&&U({id:s.dir,path:s.dir},t))&&!f.docs.some(s=>J(s.place,t))&&!f.sheets.some(s=>J(s.place,t)));for(const t of b)if(!f.pieces.some(s=>ce({id:s.id,path:s.place},t)))throw new I("no-item",`No item ${t}.`,"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=n&&b.length===0,_=o?.filter(t=>t in ae),$=T?[]:f.pieces.filter(t=>b.length===0||b.some(s=>ce({id:t.id,path:t.place},s))),S=o?.includes("csv")===!0?$.filter(t=>t.matrix!==void 0):[];if(o?.includes("csv")===!0&&b.length>0&&S.length===0)throw new I("bad-type",`${b.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(t=>t.file),...f.sheets.flatMap(t=>t.files)]),ue=t=>t.where?.file!==void 0&&W.has(t.where.file),B=t=>t.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 t=()=>xt(m,e.root,b,e.combos);let s=await t();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 t())}g=s.problems,N.addReport(s.console);const v=B(s.problems);if(v>0)throw new I("check-failed",`The check found ${q(v,"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,bt(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(!n&&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,F={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"&&!n)){if(y&&y.code!=="no_speech")throw new I("bad-type",`${fe(F)}: ${y.message}`,"usage",y.hint);O.push({target:F,type:h,...y?{refused:{name:le(F,h,e),piece:F.piece,type:h,code:"no-speech",message:`${fe(F)}: ${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)}}),F=(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:F,seconds:h}),e.log?.(`[${String(++he)}/${String(O.length)}] ${j} (${h.toFixed(1)} s)`)}catch(k){if(e.signal?.aborted||!(k instanceof Fe))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=t=>f.problems.find(s=>s.level==="error"&&s.where?.file!==void 0&&t.includes(s.where.file));for(const t of[...P,...x]){const s=K("files"in t?t.files:[t.file]);s&&d.push({name:t.place,piece:t.place,type:"files"in t?"xlsx":"pdf",code:"check-failed",message:`${s.where?.file??t.place}: ${s.message}`,hint:"Fix it, then render again."})}e.signal?.throwIfAborted();const X=t=>t.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(x),o,e.out,e.log)),o===void 0||o.includes("glb"))for(const t of L){e.log?.(`Building ${t.entry}…`);const s=performance.now(),A=`${t.dir}/${G(t.dir)}.glb`;try{await Ze(w(e.root,t.entry),{root:e.root,out:w(e.out,A),cache:w(e.root,Qe,"model"),log:()=>{}}),u.push(await M(e.out,A,t.dir,"glb",s))}catch(v){d.push({name:t.dir,piece:t.dir,type:"glb",code:"model-failed",message:`${t.entry}: ${v instanceof Error?v.message:String(v)}`,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 bt(e,o){const c=ie(e,o);return c===""?".":c.startsWith("..")||ye(c)?o:me(c)}async function xt(e,o,c,n){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},...n?{combos:[...n]}:{}}));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 n=c.status==="failed"?`Could not index ${c.file}: ${c.message}`:c.message;c.status==="running"&&c.share!==void 0||n!==o&&(o=n,e?.(n))}}async function M(e,o,c,n,p){const u=w(e,o);return{files:[u],name:o,path:u,piece:c,type:n,bytes:(await ne(u)).size,seconds:Math.round((performance.now()-p)/10)/100}}async function kt(e,o,c,n,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 x=await $e(w(e,i.file),"utf8");await D(w(n,i.place),{recursive:!0}),await R(w(n,i.place,`${m}.md`),je(Se(x).blocks)),d.push(await M(n,`${i.place}/${m}.md`,i.place,"md",a))}if(u.includes("docx")){const x=`${i.place}/${m}.docx`;await He({root:e,doc:{file:i.file,dir:i.dir,path:i.place,title:i.title},out:w(n,x),...await gt(p)}),d.push(await M(n,x,i.place,"docx",a))}const f=u.filter(x=>x==="pdf"||x==="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(n,i.place),name:m,types:f});for(const x of P)d.push(await M(n,`${i.place}/${x}`,i.place,x.endsWith(".png")?"png":"pdf",a))}return d}export const PNG_ROWS=700,PNG_COLUMNS=200;async function yt(e,o,c,n,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 x=$=>{const S=oe.normalize(oe.join(i.dir,$));try{return S.startsWith("..")?void 0:new Uint8Array(xe(w(e,S)))}catch{return}};await D(w(n,i.place),{recursive:!0});const L=G(i.place),b=`${i.place}/${L}`,T=f.sheets.length>1,_=async $=>{const S=Ke(P,{css:await Ye(),font:"Commissioner Variable",file:x,...$==="png"?{rows:PNG_ROWS,columns:PNG_COLUMNS,headings:!1}:{}});for(const g of S.cut)p?.(`${b}.png: ${g}`);await ze({html:S.html,out:w(n,i.place),name:L,types:[$]}),d.push(await M(n,`${b}.${$}`,i.place,$,a))};for(const $ of u){if($==="pdf"||$==="png"){await _($);continue}if($==="xlsx"){const{bytes:g,left:N}=Xe(P,{file:x});await R(w(n,`${b}.xlsx`),g);for(const W of N)p?.(`${b}.xlsx does not hold ${W}.`);d.push(await M(n,`${b}.xlsx`,i.place,"xlsx",a));continue}const S=[];if($==="csv")for(const g of f.sheets)S.push([T?`${b}-${g.name.replace(/\W+/gu,"-")}.csv`:`${b}.csv`,qe(P,g)]);else $==="md"?S.push([`${b}.md`,f.sheets.map(g=>T?`## ${g.name}
+
+${re(P,g)}`:re(P,g)).join(`
+`)]):S.push([`${b}.json`,`${JSON.stringify(Je(P),null,2)}
+`]);for(const[g,N]of S)await R(w(n,g),N),d.push(await M(n,g,i.place,$,a))}}return d}

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";
+}
+/**
+ * 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/package.json

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

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

@@ -0,0 +1,590 @@
+import { z } from "zod";
+/** Words up to a full stop, a question or exclamation mark, or a pause. */
+export declare const ReferenceSentenceSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+    words: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+    text: z.ZodString;
+    punctuation: z.ZodBoolean;
+    pauseAfter: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ReferenceSentence = z.infer<typeof ReferenceSentenceSchema>;
+/** A gap between two words. */
+export declare const ReferenceGapSchema: z.ZodObject<{
+    after: z.ZodNumber;
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+    dur: z.ZodNumber;
+}, z.core.$strip>;
+export type ReferenceGap = z.infer<typeof ReferenceGapSchema>;
+/** A moment a section could start at, and what was measured there. */
+export declare const ReferenceBoundarySchema: z.ZodObject<{
+    t: z.ZodNumber;
+    cut: z.ZodOptional<z.ZodObject<{
+        t: z.ZodNumber;
+        score: z.ZodNumber;
+    }, z.core.$strip>>;
+    weak: z.ZodOptional<z.ZodObject<{
+        t: z.ZodNumber;
+        score: z.ZodNumber;
+    }, z.core.$strip>>;
+    pause: z.ZodOptional<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        dur: z.ZodNumber;
+    }, z.core.$strip>>;
+    sentence: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type ReferenceBoundary = z.infer<typeof ReferenceBoundarySchema>;
+/** One line of text read on screen, as observed: the same text at about the same place in several sampled frames. */
+export declare const ReferenceTextSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    text: z.ZodString;
+    box: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+    height: z.ZodNumber;
+    conf: z.ZodNumber;
+    words: z.ZodNumber;
+    upper: z.ZodNumber;
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+    spans: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+    seconds: z.ZodNumber;
+    seen: z.ZodNumber;
+    frames: z.ZodNumber;
+    spread: z.ZodNumber;
+    said: z.ZodNumber;
+}, z.core.$strip>;
+export type ReferenceText = z.infer<typeof ReferenceTextSchema>;
+/** The numbers of a stretch of a video. */
+export declare const SectionNumbersSchema: z.ZodObject<{
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+    dur: z.ZodNumber;
+    said: z.ZodString;
+    words: z.ZodNumber;
+    wordsPerMinute: z.ZodNumber;
+    cuts: z.ZodArray<z.ZodNumber>;
+    shots: z.ZodNumber;
+    cutsPerMinute: z.ZodNumber;
+    text: z.ZodArray<z.ZodNumber>;
+    textSeconds: z.ZodNumber;
+}, z.core.$strip>;
+export type SectionNumbers = z.infer<typeof SectionNumbersSchema>;
+/** A segment of the neutral split, named by its place: s1, s2… */
+export declare const ReferenceSegmentSchema: z.ZodObject<{
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+    dur: z.ZodNumber;
+    said: z.ZodString;
+    words: z.ZodNumber;
+    wordsPerMinute: z.ZodNumber;
+    cuts: z.ZodArray<z.ZodNumber>;
+    shots: z.ZodNumber;
+    cutsPerMinute: z.ZodNumber;
+    text: z.ZodArray<z.ZodNumber>;
+    textSeconds: z.ZodNumber;
+    index: z.ZodNumber;
+    name: z.ZodString;
+    sentences: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+}, z.core.$strip>;
+export type ReferenceSegment = z.infer<typeof ReferenceSegmentSchema>;
+export declare const ReferencePacingSchema: z.ZodObject<{
+    cutsPerMinute: z.ZodNumber;
+    meanShot: z.ZodNumber;
+    medianShot: z.ZodNumber;
+    wordsPerMinute: z.ZodNumber;
+    speakingRate: z.ZodNumber;
+    timeToFirstWord: z.ZodOptional<z.ZodNumber>;
+    timeToFirstCut: z.ZodOptional<z.ZodNumber>;
+    textShare: z.ZodNumber;
+    speechShare: z.ZodNumber;
+    tempo: z.ZodOptional<z.ZodObject<{
+        bpm: z.ZodNumber;
+        confidence: z.ZodNumber;
+        candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            bpm: z.ZodNumber;
+            r: z.ZodNumber;
+            score: z.ZodNumber;
+        }, z.core.$strip>>>;
+        prior: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    onsetsPerMinute: z.ZodNumber;
+}, z.core.$strip>;
+export type ReferencePacing = z.infer<typeof ReferencePacingSchema>;
+/** The sound under and between the words, in dBFS: whether a bed of music runs under the voice is the agent's to conclude. */
+export declare const ReferenceSoundSchema: z.ZodObject<{
+    gap: z.ZodNumber;
+    edge: z.ZodNumber;
+    voiced: z.ZodNumber;
+    whole: z.ZodObject<{
+        seconds: z.ZodNumber;
+        p10: z.ZodNumber;
+        median: z.ZodNumber;
+        p90: z.ZodNumber;
+    }, z.core.$strip>;
+    words: z.ZodOptional<z.ZodObject<{
+        seconds: z.ZodNumber;
+        p10: z.ZodNumber;
+        median: z.ZodNumber;
+        p90: z.ZodNumber;
+    }, z.core.$strip>>;
+    between: z.ZodOptional<z.ZodObject<{
+        seconds: z.ZodNumber;
+        p10: z.ZodNumber;
+        median: z.ZodNumber;
+        p90: z.ZodNumber;
+        voicedShare: z.ZodNumber;
+        onsetsPerMinute: z.ZodNumber;
+    }, z.core.$strip>>;
+    floor: z.ZodNumber;
+}, z.core.$strip>;
+export type ReferenceSound = z.infer<typeof ReferenceSoundSchema>;
+/** The picture as numbers (the media package's pictureStats), its parameters in `params`. */
+export declare const ReferencePictureSchema: z.ZodObject<{
+    params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    frames: z.ZodObject<{
+        tone: z.ZodNumber;
+        color: z.ZodNumber;
+        motion: z.ZodNumber;
+    }, z.core.$strip>;
+    luma: z.ZodObject<{
+        p1: z.ZodNullable<z.ZodNumber>;
+        p50: z.ZodNullable<z.ZodNumber>;
+        p99: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    blackShare: z.ZodNullable<z.ZodNumber>;
+    noise: z.ZodNullable<z.ZodNumber>;
+    sharpness: z.ZodNullable<z.ZodNumber>;
+    saturation: z.ZodNullable<z.ZodNumber>;
+    warmth: z.ZodNullable<z.ZodNumber>;
+    motion: z.ZodObject<{
+        speed: z.ZodObject<{
+            p50: z.ZodNullable<z.ZodNumber>;
+            p90: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        shake: z.ZodObject<{
+            p50: z.ZodNullable<z.ZodNumber>;
+            p90: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        stillShare: z.ZodNullable<z.ZodNumber>;
+        runs: z.ZodNumber;
+    }, z.core.$strip>;
+    sharpnessBySpeed: z.ZodArray<z.ZodObject<{
+        from: z.ZodNumber;
+        to: z.ZodNullable<z.ZodNumber>;
+        frames: z.ZodNumber;
+        sharpness: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    noiseByLuma: z.ZodArray<z.ZodObject<{
+        from: z.ZodNumber;
+        to: z.ZodNumber;
+        blocks: z.ZodNumber;
+        noise: z.ZodNullable<z.ZodNumber>;
+        median: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>>;
+    shake: z.ZodArray<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        rms: z.ZodNumber;
+        peaks: z.ZodArray<z.ZodObject<{
+            hz: z.ZodNumber;
+            share: z.ZodNumber;
+        }, z.core.$strip>>;
+        flatness: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ReferencePicture = z.infer<typeof ReferencePictureSchema>;
+/** The whole sound as a recording: loudness, spectrum, room, room tone, dynamics, and how high it reaches. */
+export declare const ReferenceAudioSchema: z.ZodObject<{
+    loudness: z.ZodObject<{
+        integrated: z.ZodNullable<z.ZodNumber>;
+        range: z.ZodNullable<z.ZodNumber>;
+        truePeak: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    recording: z.ZodObject<{
+        params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        spectrum: z.ZodArray<z.ZodObject<{
+            hz: z.ZodNumber;
+            db: z.ZodNumber;
+        }, z.core.$strip>>;
+        dynamics: z.ZodObject<{
+            spread: z.ZodNumber;
+            crest: z.ZodNumber;
+        }, z.core.$strip>;
+    }, z.core.$loose>;
+    bandwidth: z.ZodObject<{
+        frames: z.ZodNumber;
+        reach: z.ZodArray<z.ZodObject<{
+            drop: z.ZodNumber;
+            hz: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rolloff95: z.ZodNullable<z.ZodNumber>;
+        rolloff99: z.ZodNullable<z.ZodNumber>;
+        steps: z.ZodArray<z.ZodObject<{
+            hz: z.ZodNumber;
+            db: z.ZodNumber;
+        }, z.core.$strip>>;
+        params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, z.core.$strip>;
+    voice: z.ZodOptional<z.ZodObject<{
+        frames: z.ZodNumber;
+        reach: z.ZodArray<z.ZodObject<{
+            drop: z.ZodNumber;
+            hz: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        rolloff95: z.ZodNullable<z.ZodNumber>;
+        rolloff99: z.ZodNullable<z.ZodNumber>;
+        steps: z.ZodArray<z.ZodObject<{
+            hz: z.ZodNumber;
+            db: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ReferenceAudio = z.infer<typeof ReferenceAudioSchema>;
+export declare const ReferenceSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    id: z.ZodString;
+    source: z.ZodObject<{
+        file: z.ZodString;
+        url: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        sha256: z.ZodString;
+    }, z.core.$strip>;
+    analysedAt: z.ZodString;
+    duration: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fps: z.ZodNumber;
+    encoding: z.ZodOptional<z.ZodObject<{
+        codec: z.ZodOptional<z.ZodString>;
+        bitrate: z.ZodOptional<z.ZodNumber>;
+        audio: z.ZodOptional<z.ZodObject<{
+            codec: z.ZodOptional<z.ZodString>;
+            profile: z.ZodOptional<z.ZodString>;
+            bitrate: z.ZodOptional<z.ZodNumber>;
+            rate: z.ZodOptional<z.ZodNumber>;
+            channels: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+    words: z.ZodOptional<z.ZodString>;
+    wordCount: z.ZodNumber;
+    asr: z.ZodOptional<z.ZodString>;
+    wordsMissing: z.ZodOptional<z.ZodObject<{
+        code: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        hint: z.ZodOptional<z.ZodString>;
+        instead: z.ZodString;
+    }, z.core.$strip>>;
+    shots: z.ZodObject<{
+        threshold: z.ZodNumber;
+        minShot: z.ZodNumber;
+        weakFloor: z.ZodNumber;
+        prominence: z.ZodNumber;
+        cuts: z.ZodArray<z.ZodObject<{
+            t: z.ZodNumber;
+            score: z.ZodNumber;
+        }, z.core.$strip>>;
+        weak: z.ZodArray<z.ZodObject<{
+            t: z.ZodNumber;
+            score: z.ZodNumber;
+        }, z.core.$strip>>;
+        candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            t: z.ZodNumber;
+            score: z.ZodNumber;
+            source: z.ZodEnum<{
+                jump: "jump";
+                change: "change";
+            }>;
+            around: z.ZodNumber;
+            passes: z.ZodBoolean;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    speech: z.ZodObject<{
+        pause: z.ZodNumber;
+        sentences: z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            words: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+            text: z.ZodString;
+            punctuation: z.ZodBoolean;
+            pauseAfter: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        pauses: z.ZodArray<z.ZodObject<{
+            after: z.ZodNumber;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            dur: z.ZodNumber;
+        }, z.core.$strip>>;
+        gaps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            after: z.ZodNumber;
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            dur: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    boundaries: z.ZodObject<{
+        cutWithin: z.ZodNumber;
+        candidates: z.ZodArray<z.ZodObject<{
+            t: z.ZodNumber;
+            cut: z.ZodOptional<z.ZodObject<{
+                t: z.ZodNumber;
+                score: z.ZodNumber;
+            }, z.core.$strip>>;
+            weak: z.ZodOptional<z.ZodObject<{
+                t: z.ZodNumber;
+                score: z.ZodNumber;
+            }, z.core.$strip>>;
+            pause: z.ZodOptional<z.ZodObject<{
+                start: z.ZodNumber;
+                end: z.ZodNumber;
+                dur: z.ZodNumber;
+            }, z.core.$strip>>;
+            sentence: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    ocr: z.ZodObject<{
+        engine: z.ZodString;
+        confidence: z.ZodObject<{
+            word: z.ZodNumber;
+            short: z.ZodNumber;
+        }, z.core.$strip>;
+        frames: z.ZodNumber;
+        samePlace: z.ZodNumber;
+        saidWithin: z.ZodNumber;
+        low: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            t: z.ZodNumber;
+            text: z.ZodString;
+            conf: z.ZodNumber;
+            box: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    text: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        text: z.ZodString;
+        box: z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>;
+        height: z.ZodNumber;
+        conf: z.ZodNumber;
+        words: z.ZodNumber;
+        upper: z.ZodNumber;
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        spans: z.ZodArray<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        seconds: z.ZodNumber;
+        seen: z.ZodNumber;
+        frames: z.ZodNumber;
+        spread: z.ZodNumber;
+        said: z.ZodNumber;
+    }, z.core.$strip>>;
+    pacing: z.ZodObject<{
+        cutsPerMinute: z.ZodNumber;
+        meanShot: z.ZodNumber;
+        medianShot: z.ZodNumber;
+        wordsPerMinute: z.ZodNumber;
+        speakingRate: z.ZodNumber;
+        timeToFirstWord: z.ZodOptional<z.ZodNumber>;
+        timeToFirstCut: z.ZodOptional<z.ZodNumber>;
+        textShare: z.ZodNumber;
+        speechShare: z.ZodNumber;
+        tempo: z.ZodOptional<z.ZodObject<{
+            bpm: z.ZodNumber;
+            confidence: z.ZodNumber;
+            candidates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                bpm: z.ZodNumber;
+                r: z.ZodNumber;
+                score: z.ZodNumber;
+            }, z.core.$strip>>>;
+            prior: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        onsetsPerMinute: z.ZodNumber;
+    }, z.core.$strip>;
+    sound: z.ZodOptional<z.ZodObject<{
+        gap: z.ZodNumber;
+        edge: z.ZodNumber;
+        voiced: z.ZodNumber;
+        whole: z.ZodObject<{
+            seconds: z.ZodNumber;
+            p10: z.ZodNumber;
+            median: z.ZodNumber;
+            p90: z.ZodNumber;
+        }, z.core.$strip>;
+        words: z.ZodOptional<z.ZodObject<{
+            seconds: z.ZodNumber;
+            p10: z.ZodNumber;
+            median: z.ZodNumber;
+            p90: z.ZodNumber;
+        }, z.core.$strip>>;
+        between: z.ZodOptional<z.ZodObject<{
+            seconds: z.ZodNumber;
+            p10: z.ZodNumber;
+            median: z.ZodNumber;
+            p90: z.ZodNumber;
+            voicedShare: z.ZodNumber;
+            onsetsPerMinute: z.ZodNumber;
+        }, z.core.$strip>>;
+        floor: z.ZodNumber;
+    }, z.core.$strip>>;
+    segments: z.ZodObject<{
+        rule: z.ZodString;
+        pause: z.ZodNumber;
+        cutWithin: z.ZodNumber;
+        minLength: z.ZodNumber;
+        list: z.ZodArray<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            dur: z.ZodNumber;
+            said: z.ZodString;
+            words: z.ZodNumber;
+            wordsPerMinute: z.ZodNumber;
+            cuts: z.ZodArray<z.ZodNumber>;
+            shots: z.ZodNumber;
+            cutsPerMinute: z.ZodNumber;
+            text: z.ZodArray<z.ZodNumber>;
+            textSeconds: z.ZodNumber;
+            index: z.ZodNumber;
+            name: z.ZodString;
+            sentences: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    sheets: z.ZodArray<z.ZodString>;
+    picture: z.ZodObject<{
+        params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        frames: z.ZodObject<{
+            tone: z.ZodNumber;
+            color: z.ZodNumber;
+            motion: z.ZodNumber;
+        }, z.core.$strip>;
+        luma: z.ZodObject<{
+            p1: z.ZodNullable<z.ZodNumber>;
+            p50: z.ZodNullable<z.ZodNumber>;
+            p99: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        blackShare: z.ZodNullable<z.ZodNumber>;
+        noise: z.ZodNullable<z.ZodNumber>;
+        sharpness: z.ZodNullable<z.ZodNumber>;
+        saturation: z.ZodNullable<z.ZodNumber>;
+        warmth: z.ZodNullable<z.ZodNumber>;
+        motion: z.ZodObject<{
+            speed: z.ZodObject<{
+                p50: z.ZodNullable<z.ZodNumber>;
+                p90: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+            shake: z.ZodObject<{
+                p50: z.ZodNullable<z.ZodNumber>;
+                p90: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+            stillShare: z.ZodNullable<z.ZodNumber>;
+            runs: z.ZodNumber;
+        }, z.core.$strip>;
+        sharpnessBySpeed: z.ZodArray<z.ZodObject<{
+            from: z.ZodNumber;
+            to: z.ZodNullable<z.ZodNumber>;
+            frames: z.ZodNumber;
+            sharpness: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        noiseByLuma: z.ZodArray<z.ZodObject<{
+            from: z.ZodNumber;
+            to: z.ZodNumber;
+            blocks: z.ZodNumber;
+            noise: z.ZodNullable<z.ZodNumber>;
+            median: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>>;
+        shake: z.ZodArray<z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            rms: z.ZodNumber;
+            peaks: z.ZodArray<z.ZodObject<{
+                hz: z.ZodNumber;
+                share: z.ZodNumber;
+            }, z.core.$strip>>;
+            flatness: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    audio: z.ZodOptional<z.ZodObject<{
+        loudness: z.ZodObject<{
+            integrated: z.ZodNullable<z.ZodNumber>;
+            range: z.ZodNullable<z.ZodNumber>;
+            truePeak: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        recording: z.ZodObject<{
+            params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            spectrum: z.ZodArray<z.ZodObject<{
+                hz: z.ZodNumber;
+                db: z.ZodNumber;
+            }, z.core.$strip>>;
+            dynamics: z.ZodObject<{
+                spread: z.ZodNumber;
+                crest: z.ZodNumber;
+            }, z.core.$strip>;
+        }, z.core.$loose>;
+        bandwidth: z.ZodObject<{
+            frames: z.ZodNumber;
+            reach: z.ZodArray<z.ZodObject<{
+                drop: z.ZodNumber;
+                hz: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>>;
+            rolloff95: z.ZodNullable<z.ZodNumber>;
+            rolloff99: z.ZodNullable<z.ZodNumber>;
+            steps: z.ZodArray<z.ZodObject<{
+                hz: z.ZodNumber;
+                db: z.ZodNumber;
+            }, z.core.$strip>>;
+            params: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, z.core.$strip>;
+        voice: z.ZodOptional<z.ZodObject<{
+            frames: z.ZodNumber;
+            reach: z.ZodArray<z.ZodObject<{
+                drop: z.ZodNumber;
+                hz: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>>;
+            rolloff95: z.ZodNullable<z.ZodNumber>;
+            rolloff99: z.ZodNullable<z.ZodNumber>;
+            steps: z.ZodArray<z.ZodObject<{
+                hz: z.ZodNumber;
+                db: z.ZodNumber;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type Reference = z.infer<typeof ReferenceSchema>;
+export type WordsMissing = NonNullable<Reference["wordsMissing"]>;
+/** The file a reference folder's measurements are in. */
+export declare const REFERENCE_FILE = "reference.json";
+/** The file the agent's interpretation is in, beside reference.json. */
+export declare const INTERPRETATION_FILE = "interpretation.json";
+export declare const InterpretedSectionSchema: z.ZodObject<{
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+    name: z.ZodOptional<z.ZodString>;
+    role: z.ZodOptional<z.ZodString>;
+    picture: z.ZodOptional<z.ZodString>;
+    onScreen: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type InterpretedSection = z.infer<typeof InterpretedSectionSchema>;
+export declare const InterpretationSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    version: z.ZodDefault<z.ZodLiteral<1>>;
+    summary: z.ZodOptional<z.ZodString>;
+    layout: z.ZodOptional<z.ZodString>;
+    hook: z.ZodOptional<z.ZodString>;
+    sections: z.ZodArray<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+        name: z.ZodOptional<z.ZodString>;
+        role: z.ZodOptional<z.ZodString>;
+        picture: z.ZodOptional<z.ZodString>;
+        onScreen: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    captions: z.ZodOptional<z.ZodObject<{
+        lines: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        style: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    watermarks: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    notes: z.ZodOptional<z.ZodString>;
+    labels: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
+}, z.core.$strict>;
+export type Interpretation = z.infer<typeof InterpretationSchema>;
+//# sourceMappingURL=reference.d.ts.map