allyhub 0.3.0 → 0.5.0

package/dist/commands/reference-text.js

@@ -1,5 +1,5 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{INTERPRETATION_FILE as g}from"@allyhub-next/formats";import{INTERPRETATION_SHAPE as y}from"@allyhub-next/measure";import{formatProblem as j}from"../text/index.js";const m=(e,i)=>`${String(e)} ${i}${e===1?"":"s"}`,d=e=>e.toFixed(2),f=e=>`${e>=0?"+":""}${String(Math.round(e*100))}%`,l=e=>e>=0?`+${e.toFixed(2)}`:`−${(-e).toFixed(2)}`,c=(e,i=2)=>e===null?"—":String(Math.round(e*10**i)/10**i),S=(e,i=70)=>`“${e.slice(0,i)}${e.length>i?"…":""}”`,x=12;function T(e){if(!e)return"";const i=e.bitrate===void 0?"":` at ${String(Math.round(e.bitrate/1e3))} kbps`;return` · ${e.codec??""}${i}`}function P(e){const i=t=>`median ${String(t.median)} dBFS (${String(t.p10)} to ${String(t.p90)})`;return`  sound: ${e.words?`under the words ${i(e.words)}`:`whole ${i(e.whole)}`}${e.between?`; between them ${String(e.between.seconds)} s, ${i(e.between)}, ${String(Math.round(e.between.voicedShare*100))}% voiced, ${String(e.between.onsetsPerMinute)} onsets/min`:""}; floor ${String(e.floor)} dBFS`}function k(e){const i=e.motion;return`  picture: luma ${c(e.luma.p1,1)}/${c(e.luma.p50,1)}/${c(e.luma.p99,1)} (1st/50th/99th), at black ${c(e.blackShare,3)}, grain ${c(e.noise)}, sharpness ${c(e.sharpness)}, saturation ${c(e.saturation,3)}, warmth ${c(e.warmth,3)}; camera speed ${c(i.speed.p50,4)} widths/s, shake ${c(i.shake.p50,5)} widths, still ${c(i.stillShare,3)}`}function E(e){const i=n=>e.recording.spectrum.find(a=>a.hz===n)?.db,t=e.bandwidth.reach.map(n=>`−${String(n.drop)} dB at ${n.hz===null?"—":`${String(n.hz)} Hz`}`).join(", ");return`  loudness: ${c(e.loudness.integrated,1)} LUFS, range ${c(e.loudness.range,1)} LU, true peak ${c(e.loudness.truePeak,1)} dBTP; bands ${[125,500,2e3,8e3].map(n=>`${String(n)} ${String(i(n)??"—")}`).join(", ")} dB against 1 kHz; reach ${t}`}function F(e,i){const t=e.video;return[`  served: ${e.item} (${e.format}), exported as ${e.export.type}${e.export.crf===void 0?"":` crf ${String(e.export.crf)}`}${e.export.maxKbps===void 0?"":` under ${String(e.export.maxKbps)} kbit/s`}, then ${t?`${t.codec} ${String(t.width)}×${String(t.height)} ${String(t.fps)} fps at ${String(t.kbps)} kbit/s (${e.platform??""}'s served encode)`:"as exported"}; sound ${"missing"in e.audio?`${e.audio.missing}; ${e.audio.instead}`:`${e.audio.codec} ${String(e.audio.kbps)} kbit/s`}`,`    joins (where it means to cut; a cut scores ${String(i)} or more): ${e.joins.map(n=>`${d(n.t)} s ${n.kind}${n.part===void 0?"":` ${n.part}`} ${String(n.score)}${n.cut?"":" not a cut"}`).join("; ")||"none"}`,...e.unmeant.length>0?[`    cuts away from every join: ${e.unmeant.map(n=>`${d(n.t)} s ${String(n.score)}`).join("; ")}`]:[]]}export function referenceText(e,i){const t=e.reference,n=t.pacing,a=t.shots,$=e.sections,h=Math.max(4,...$.sections.map(o=>o.name.length)),u=[i(`${e.dir}/reference.json`),`  ${d(t.duration)} s · ${String(t.width)}×${String(t.height)} · ${String(t.fps)} fps${T(t.encoding)} · ${t.wordsMissing?"words missing":m(t.wordCount,"word")} · ${m(a.cuts.length,"cut")} (${String(a.weak.length)} weak; a cut scores ${String(a.threshold)} or more${a.candidates?`, all ${String(a.candidates.length)} peaks in shots.candidates`:""})`,...t.wordsMissing?[`  words: not heard (${t.wordsMissing.message}${t.wordsMissing.hint===void 0?"":` ${t.wordsMissing.hint}`}); ${t.wordsMissing.instead}`]:t.sound===void 0?["  speech: none (no sound)"]:[`  speech: ${m(t.speech.sentences.length,"sentence")}, ${m(t.speech.pauses.length,"pause")} of ${String(t.speech.pause)} s or more`],`  on-screen text: ${m(t.text.length,"line")} read in ${m(t.ocr.frames,"frame")}${t.ocr.low?.length?`; ${m(t.ocr.low.length,"word")} under confidence ${String(t.ocr.confidence.word)} in ocr.low`:""}`,...t.sound?[P(t.sound)]:[],`  pace: ${String(n.cutsPerMinute)} cuts/min, median shot ${d(n.medianShot)} s, ${String(n.wordsPerMinute)} words/min${n.timeToFirstWord===void 0?"":`, first word at ${d(n.timeToFirstWord)} s`}, text on screen ${String(Math.round(n.textShare*100))}%${n.tempo?`, tempo ${String(n.tempo.bpm)} BPM (confidence ${c(n.tempo.confidence)})`:""}`,k(t.picture),...t.audio?[E(t.audio)]:[],...t.served?F(t.served,a.threshold):[],"",$.from==="interpretation"?`  Sections (${g}):`:"  Neutral split, mechanics only (its rule is segments.rule in reference.json):",...$.sections.map(o=>`  ${o.name.padEnd(h)} ${d(o.start).padStart(6)}–${d(o.end).padEnd(6)} ${m(o.cuts.length,"cut").padEnd(7)} ${String(o.wordsPerMinute).padStart(5)} words/min  ${S(o.said)}`)];if(t.text.length>0){const o=[...t.text].sort((r,p)=>p.seconds-r.seconds||r.id-p.id).slice(0,x);u.push("",`  Text on screen, the ${String(o.length)} longest on screen of ${String(t.text.length)} (#id; reference.json's text[] has every line with its box and spans):`,...o.map(r=>`  #${String(r.id).padEnd(4)} ${S(r.text,40).padEnd(44)} y ${d(r.box[1]+r.box[3]/2)}  height ${r.height.toFixed(3)}  ${d(r.seconds).padStart(6)} s  said ${String(Math.round(r.said*100))}%`))}u.push("",`  sheets: ${e.sheets.map(i).join(", ")}`);const s=e.interpretation;return s&&"problems"in s?u.push(`  ${i(s.file)} was not used: ${s.problems.join("; ")}. Fix it and run allyhub reference ${i(e.dir)} again.`):s||u.push(`  No interpretation yet. Read the sheets and reference.json, then write ${i(`${e.dir}/${g}`)}: ${y}. allyhub reference ${i(e.dir)} then labels the sheets with its sections.`),u.join(`
-`)}export function compareText(e,i){const t=e.comparison,n=t.overall,a=n.diff,$=r=>`${r>=0?"+":""}${String(r)}`,h=(r,p,b,M)=>`  ${r.padEnd(16)} ${p.padStart(9)} → ${b.padEnd(9)} ${M}`,u=r=>r===void 0?"none":`${d(r)} s`,s=t.matches.filter(r=>!r.withinTolerance),o=e.problems.filter(r=>r.level==="error");return[`${e.piece} (${e.format}) against ${i(e.reference)}`,t.sections.from==="interpretation"?`The reference's sections are ${g}'s.`:`The reference's sections are its neutral segments (s1, s2…: a mechanical split by pauses and cuts); write ${g} beside reference.json to compare against sections of your own.`,...e.ref.wordsMissing?["The reference's words are missing: its words/min and first word read as none."]:[],t.by==="time"?`Compared by time${t.byWhy===void 0?"":` (${t.byWhy}; --by parts tries anyway)`}: each section against the same seconds of the piece, named by the parts they span.`:"Compared by parts: the piece's parts aligned to the sections (--by time for the same seconds of each).",`The piece measured from its code: ${String(t.places.filter(r=>r.cut).length)} of the ${String(t.places.length)} places its picture may cut are cuts at the reference's threshold (places in --json).`,"Per section, reference → piece (piece − reference):",...t.matches.map(r=>`  ${r.ref.names.join("+").padEnd(14)} ${d(r.ref.dur).padStart(6)} s → ${r.ours.keys.join("+").padEnd(16)} ${d(r.ours.dur).padStart(6)} s  ${l(r.diff.seconds)} s (${f(r.diff.share)})  cuts/min ${String(r.ref.cutsPerMinute)}→${String(r.ours.cutsPerMinute)}  words/min ${String(r.ref.wordsPerMinute)}→${String(r.ours.wordsPerMinute)}  text ${d(r.ref.textSeconds)}→${d(r.ours.textSeconds)} s`),"Overall:",h("duration",`${d(n.reference.duration)} s`,`${d(n.ours.duration)} s`,`${l(a.seconds)} s (${f(a.share)})`),h("cuts/min",String(n.reference.cutsPerMinute),String(n.ours.cutsPerMinute),$(a.cutsPerMinute)),h("words/min",String(n.reference.wordsPerMinute),String(n.ours.wordsPerMinute),$(a.wordsPerMinute)),h("first word",u(n.reference.timeToFirstWord),u(n.ours.timeToFirstWord),a.timeToFirstWord===void 0?"":`${l(a.timeToFirstWord)} s`),h("text on screen",`${String(Math.round(n.reference.textShare*100))}%`,`${String(Math.round(n.ours.textShare*100))}%`,`${$(Math.round(a.textShare*100))} points`),"",t.summary.meanDurationDiff===void 0?"No section matched.":`At ±${String(Math.round(t.summary.tolerance*100))}%: ${String(t.summary.sectionsWithin)} of ${String(t.summary.sections)} reference sections within, mean |duration difference| ${String(Math.round(t.summary.meanDurationDiff*100))}%${s.length?`; outside: ${s.map(r=>r.ref.names.join("+")).join(", ")}`:""}.`,`  sheet: ${i(e.sheet)}`,...o.length>0?["Must fix (the numbers may be missing where they are):",...o.map(j)]:[]].join(`
-`)}const w=e=>e===void 0||!Number.isFinite(e)?"—":String(Number(e.toPrecision(4)));export function setText(e){const i=Object.entries(e.numbers),t=i.filter(([s])=>!s.includes("[")),n=Math.min(48,Math.max(8,...t.map(([s])=>s.length))),a=e.place!==void 0,$=[`${m(e.n,"reference")}${e.where?`, labels ${e.where.map(s=>`${s.key}=${s.value}`).join(", ")}`:""}${a?`; placed: ${e.place?.id??""}`:""}`,...(e.left??[]).map(s=>`  left out: ${s.dir}: ${s.why}`),"",`${"number".padEnd(n)} ${"n".padStart(4)} ${["p10","p25","p50","p75","p90"].map(s=>s.padStart(9)).join(" ")}${a?`  ${"value".padStart(9)}  pct`:""}`,...t.map(([s,o])=>`${(s.length>n?`…${s.slice(s.length-n+1)}`:s).padEnd(n)} ${String(o.n).padStart(4)} ${[o.p10,o.p25,o.p50,o.p75,o.p90].map(p=>w(p).padStart(9)).join(" ")}${a?`  ${w(o.value).padStart(9)}  ${o.percentile===void 0?"  —":String(Math.round(o.percentile)).padStart(3)}`:""}`)];t.length<i.length&&$.push(`  and ${String(i.length-t.length)} numbers by bin (spectra, reaches, sharpness by speed, grain by light) in --json`);const h=Object.entries(e.labels);h.length>0&&$.push("",`Labels (${g}), each value's share:`,...h.map(([s,o])=>`  ${s}: ${Object.entries(o).map(([r,p])=>`${r} ${String(Math.round(p*100))}%`).join(", ")}`));const u=Object.entries(e.measuredWith).filter(([,s])=>Object.keys(s).length>1);return u.length>0&&$.push("","Measured with different parameters:",...u.map(([s,o])=>`  ${s}: ${Object.entries(o).map(([r,p])=>`${r} (${String(p)})`).join(", ")}`)),$.join(`
+import{INTERPRETATION_FILE as l}from"@allyhub-next/formats";import{INTERPRETATION_SHAPE as y}from"@allyhub-next/measure";import{formatProblem as j}from"../text/index.js";const m=(e,s)=>`${String(e)} ${s}${e===1?"":"s"}`,c=e=>e.toFixed(2),f=e=>`${e>=0?"+":""}${String(Math.round(e*100))}%`,g=e=>e>=0?`+${e.toFixed(2)}`:`−${(-e).toFixed(2)}`,d=(e,s=2)=>e===null?"—":String(Math.round(e*10**s)/10**s),S=(e,s=70)=>`“${e.slice(0,s)}${e.length>s?"…":""}”`,T=12;function P(e){if(!e)return"";const s=e.bitrate===void 0?"":` at ${String(Math.round(e.bitrate/1e3))} kbps`;return` · ${e.codec??""}${s}`}function E(e){const s=t=>`median ${String(t.median)} dBFS (${String(t.p10)} to ${String(t.p90)})`;return`  sound: ${e.words?`under the words ${s(e.words)}`:`whole ${s(e.whole)}`}${e.between?`; between them ${String(e.between.seconds)} s, ${s(e.between)}, ${String(Math.round(e.between.voicedShare*100))}% voiced, ${String(e.between.onsetsPerMinute)} onsets/min`:""}; floor ${String(e.floor)} dBFS`}function x(e){const s=e.motion;return`  picture: luma ${d(e.luma.p1,1)}/${d(e.luma.p50,1)}/${d(e.luma.p99,1)} (1st/50th/99th), at black ${d(e.blackShare,3)}, grain ${d(e.noise)}, sharpness ${d(e.sharpness)}, saturation ${d(e.saturation,3)}, warmth ${d(e.warmth,3)}; camera speed ${d(s.speed.p50,4)} widths/s, shake ${d(s.shake.p50,5)} widths, still ${d(s.stillShare,3)}`}function F(e){const s=r=>e.recording.spectrum.find(a=>a.hz===r)?.db,t=e.bandwidth.reach.map(r=>`−${String(r.drop)} dB at ${r.hz===null?"—":`${String(r.hz)} Hz`}`).join(", ");return`  loudness: ${d(e.loudness.integrated,1)} LUFS, range ${d(e.loudness.range,1)} LU, true peak ${d(e.loudness.truePeak,1)} dBTP; bands ${[125,500,2e3,8e3].map(r=>`${String(r)} ${String(s(r)??"—")}`).join(", ")} dB against 1 kHz; reach ${t}`}export function referenceText(e,s){const t=e.reference,r=t.pacing,a=t.shots,$=e.sections,h=Math.max(4,...$.sections.map(o=>o.name.length)),u=[s(`${e.dir}/reference.json`),`  ${c(t.duration)} s · ${String(t.width)}×${String(t.height)} · ${String(t.fps)} fps${P(t.encoding)} · ${t.wordsMissing?"words missing":m(t.wordCount,"word")} · ${m(a.cuts.length,"cut")} (${String(a.weak.length)} weak; a cut scores ${String(a.threshold)} or more${a.candidates?`, all ${String(a.candidates.length)} peaks in shots.candidates`:""})`,...t.wordsMissing?[`  words: not heard (${t.wordsMissing.message}${t.wordsMissing.hint===void 0?"":` ${t.wordsMissing.hint}`}); ${t.wordsMissing.instead}`]:t.sound===void 0?["  speech: none (no sound)"]:[`  speech: ${m(t.speech.sentences.length,"sentence")}, ${m(t.speech.pauses.length,"pause")} of ${String(t.speech.pause)} s or more`],`  on-screen text: ${m(t.text.length,"line")} read in ${m(t.ocr.frames,"frame")}${t.ocr.low?.length?`; ${m(t.ocr.low.length,"word")} under confidence ${String(t.ocr.confidence.word)} in ocr.low`:""}`,...t.sound?[E(t.sound)]:[],`  pace: ${String(r.cutsPerMinute)} cuts/min, median shot ${c(r.medianShot)} s, ${String(r.wordsPerMinute)} words/min${r.timeToFirstWord===void 0?"":`, first word at ${c(r.timeToFirstWord)} s`}, text on screen ${String(Math.round(r.textShare*100))}%${r.tempo?`, tempo ${String(r.tempo.bpm)} BPM (confidence ${d(r.tempo.confidence)})`:""}`,x(t.picture),...t.audio?[F(t.audio)]:[],"",$.from==="interpretation"?`  Sections (${l}):`:"  Neutral split, mechanics only (its rule is segments.rule in reference.json):",...$.sections.map(o=>`  ${o.name.padEnd(h)} ${c(o.start).padStart(6)}–${c(o.end).padEnd(6)} ${m(o.cuts.length,"cut").padEnd(7)} ${String(o.wordsPerMinute).padStart(5)} words/min  ${S(o.said)}`)];if(t.text.length>0){const o=[...t.text].sort((n,p)=>p.seconds-n.seconds||n.id-p.id).slice(0,T);u.push("",`  Text on screen, the ${String(o.length)} longest on screen of ${String(t.text.length)} (#id; reference.json's text[] has every line with its box and spans):`,...o.map(n=>`  #${String(n.id).padEnd(4)} ${S(n.text,40).padEnd(44)} y ${c(n.box[1]+n.box[3]/2)}  height ${n.height.toFixed(3)}  ${c(n.seconds).padStart(6)} s  said ${String(Math.round(n.said*100))}%`))}u.push("",`  sheets: ${e.sheets.map(s).join(", ")}`);const i=e.interpretation;return i&&"problems"in i?u.push(`  ${s(i.file)} was not used: ${i.problems.join("; ")}. Fix it and run allyhub reference ${s(e.dir)} again.`):i||u.push(`  No interpretation yet. Read the sheets and reference.json, then write ${s(`${e.dir}/${l}`)}: ${y}. allyhub reference ${s(e.dir)} then labels the sheets with its sections.`),u.join(`
+`)}export function compareText(e,s){const t=e.comparison,r=t.overall,a=r.diff,$=n=>`${n>=0?"+":""}${String(n)}`,h=(n,p,b,M)=>`  ${n.padEnd(16)} ${p.padStart(9)} → ${b.padEnd(9)} ${M}`,u=n=>n===void 0?"none":`${c(n)} s`,i=t.matches.filter(n=>!n.withinTolerance),o=e.problems.filter(n=>n.level==="error");return[`${e.piece} (${e.format}) against ${s(e.reference)}`,t.sections.from==="interpretation"?`The reference's sections are ${l}'s.`:`The reference's sections are its neutral segments (s1, s2…: a mechanical split by pauses and cuts); write ${l} beside reference.json to compare against sections of your own.`,...e.ref.wordsMissing?["The reference's words are missing: its words/min and first word read as none."]:[],t.by==="time"?`Compared by time${t.byWhy===void 0?"":` (${t.byWhy}; --by parts tries anyway)`}: each section against the same seconds of the piece, named by the parts they span.`:"Compared by parts: the piece's parts aligned to the sections (--by time for the same seconds of each).",`The piece measured from its code: ${String(t.places.filter(n=>n.cut).length)} of the ${String(t.places.length)} places its picture may cut are cuts at the reference's threshold (places in --json).`,"Per section, reference → piece (piece − reference):",...t.matches.map(n=>`  ${n.ref.names.join("+").padEnd(14)} ${c(n.ref.dur).padStart(6)} s → ${n.ours.keys.join("+").padEnd(16)} ${c(n.ours.dur).padStart(6)} s  ${g(n.diff.seconds)} s (${f(n.diff.share)})  cuts/min ${String(n.ref.cutsPerMinute)}→${String(n.ours.cutsPerMinute)}  words/min ${String(n.ref.wordsPerMinute)}→${String(n.ours.wordsPerMinute)}  text ${c(n.ref.textSeconds)}→${c(n.ours.textSeconds)} s`),"Overall:",h("duration",`${c(r.reference.duration)} s`,`${c(r.ours.duration)} s`,`${g(a.seconds)} s (${f(a.share)})`),h("cuts/min",String(r.reference.cutsPerMinute),String(r.ours.cutsPerMinute),$(a.cutsPerMinute)),h("words/min",String(r.reference.wordsPerMinute),String(r.ours.wordsPerMinute),$(a.wordsPerMinute)),h("first word",u(r.reference.timeToFirstWord),u(r.ours.timeToFirstWord),a.timeToFirstWord===void 0?"":`${g(a.timeToFirstWord)} s`),h("text on screen",`${String(Math.round(r.reference.textShare*100))}%`,`${String(Math.round(r.ours.textShare*100))}%`,`${$(Math.round(a.textShare*100))} points`),"",t.summary.meanDurationDiff===void 0?"No section matched.":`At ±${String(Math.round(t.summary.tolerance*100))}%: ${String(t.summary.sectionsWithin)} of ${String(t.summary.sections)} reference sections within, mean |duration difference| ${String(Math.round(t.summary.meanDurationDiff*100))}%${i.length?`; outside: ${i.map(n=>n.ref.names.join("+")).join(", ")}`:""}.`,`  sheet: ${s(e.sheet)}`,...o.length>0?["Must fix (the numbers may be missing where they are):",...o.map(j)]:[]].join(`
+`)}const w=e=>e===void 0||!Number.isFinite(e)?"—":String(Number(e.toPrecision(4)));export function setText(e){const s=Object.entries(e.numbers),t=s.filter(([i])=>!i.includes("[")),r=Math.min(48,Math.max(8,...t.map(([i])=>i.length))),a=e.place!==void 0,$=[`${m(e.n,"reference")}${e.where?`, labels ${e.where.map(i=>`${i.key}=${i.value}`).join(", ")}`:""}${a?`; placed: ${e.place?.id??""}`:""}`,...(e.left??[]).map(i=>`  left out: ${i.dir}: ${i.why}`),"",`${"number".padEnd(r)} ${"n".padStart(4)} ${["p10","p25","p50","p75","p90"].map(i=>i.padStart(9)).join(" ")}${a?`  ${"value".padStart(9)}  pct`:""}`,...t.map(([i,o])=>`${(i.length>r?`…${i.slice(i.length-r+1)}`:i).padEnd(r)} ${String(o.n).padStart(4)} ${[o.p10,o.p25,o.p50,o.p75,o.p90].map(p=>w(p).padStart(9)).join(" ")}${a?`  ${w(o.value).padStart(9)}  ${o.percentile===void 0?"  —":String(Math.round(o.percentile)).padStart(3)}`:""}`)];t.length<s.length&&$.push(`  and ${String(s.length-t.length)} numbers by bin (spectra, reaches, sharpness by speed, grain by light) in --json`);const h=Object.entries(e.labels);h.length>0&&$.push("",`Labels (${l}), each value's share:`,...h.map(([i,o])=>`  ${i}: ${Object.entries(o).map(([n,p])=>`${n} ${String(Math.round(p*100))}%`).join(", ")}`));const u=Object.entries(e.measuredWith).filter(([,i])=>Object.keys(i).length>1);return u.length>0&&$.push("","Measured with different parameters:",...u.map(([i,o])=>`  ${i}: ${Object.entries(o).map(([n,p])=>`${n} (${String(p)})`).join(", ")}`)),$.join(`
 `)}

package/dist/commands/reference.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{join as m,relative as W,resolve as O}from"node:path";import{z as o}from"zod";import{copyFile as _,mkdir as z,rm as J}from"node:fs/promises";import{startBrowser as U}from"@allyhub-next/browser";import{exportVersion as X}from"@allyhub-next/export";import{REFERENCE_DIR as E}from"@allyhub-next/formats";import{ReferenceError as Y,comparePiece as G,listCuts as Q,makeReference as C,readReference as Z,referenceDir as ee,referenceId as D,referenceSet as re,sceneryCuts as oe,servedCuts as te}from"@allyhub-next/measure";import{EXIT as h}from"@allyhub-next/protocol";import{encodeFor as se,encodeServed as ne,servedEncodeOf as S,servedPlatforms as F}from"@allyhub-next/render";import{comboKey as I}from"@allyhub-next/video-core";import{CommandError as k,defineCommand as j}from"../command.js";import{fresh as ie}from"../fields.js";import{fromMedia as ae,progressLines as P}from"../media.js";import{projectOfFile as ce,projectRoot as R}from"../project.js";import{VERSION_FIELDS as T,commandError as de,withVersion as B}from"../version.js";import{drawPage as L,looks as M,save as fe}from"./frames/common.js";import{compareText as le,referenceText as N,setText as me}from"./reference-text.js";function pe(e){return e instanceof Y?new k(e.code,e.message,{exit:e.kind==="usage"?h.usage:e.kind==="not-found"?h.notFound:h.failed,...e.hint===void 0?{}:{hint:e.hint}}):de(ae(e))}async function w(e){try{return await e()}catch(r){throw pe(r)}}async function V(e){let r;try{r=await U();const s=r;return await e((n,t)=>L(s,{html:n,width:t}))}finally{await r?.close()}}const A=(e,r)=>{const s=W(e,r);return s===""||s.startsWith("..")?r:s};export const reference=j({name:"reference",summary:"Measure a reference video into .allyhub/work/reference/<id>/: its words, cuts, on-screen text, pace, sound and picture as numbers, contact sheets, and reference.json; your interpretation.json beside it names its sections",input:o.strictObject({source:o.string().describe("A video file, an address yt-dlp downloads (TikTok, Instagram, YouTube…), or a reference folder (its path or id) to measure again in place"),lang:o.string().optional().describe("The language spoken, one of Parakeet's 25 European languages (en, es, fr, de…); left out, Parakeet tells them apart. One it does not cover leaves the words missing and the rest measured"),all:o.boolean().default(!1).describe("Also keep what the fixed thresholds leave out: every shot peak with its score (shots.candidates), the words OCR read with too little confidence (ocr.low) and every gap between words (speech.gaps)"),fresh:ie,dir:o.string().optional().describe("The project it goes in (default the nearest above the file, else the current folder's)")}),positional:["source"],output:o.looseObject({dir:o.string(),file:o.string(),reference:o.unknown()}),examples:["allyhub reference ~/Downloads/ad.mp4","allyhub reference https://www.tiktok.com/@brand/video/7412345678901234567","allyhub reference ad --all"]},async(e,r)=>{const s=/^https?:\/\//i.test(e.source),n=await ce(s?".":e.source,r.cwd,e.dir);n.warning!==void 0&&r.progress(n.warning);const t=await w(()=>V(c=>C(e.source,{root:n.root,cwd:r.cwd,draw:c,pictures:M(),lang:e.lang,all:e.all,fresh:e.fresh,signal:r.signal,onProgress:P(r)})));return t.reference.wordsMissing!==void 0&&r.progress(`Speech recognition failed, so the words are missing: ${t.reference.wordsMissing.message}`),{value:{dir:t.dir,file:m(t.dir,"reference.json"),video:t.video,...t.words===void 0?{}:{words:t.words},sheets:t.sheets,...t.interpretation?{interpretation:t.interpretation}:{},sections:{from:t.sections.from,list:t.sections.sections},reference:t.reference},text:N(t,c=>A(r.cwd,c))}}),referenceCompare=j({name:"reference compare",summary:"A piece measured from its code, with no render, against a reference's sections (your interpretation.json's, else its neutral segments): per section and overall, the piece's numbers less the reference's, and a side-by-side sheet",input:o.strictObject({reference:o.string().describe("The reference: its folder, its reference.json, or its id under .allyhub/work/reference/"),...T,by:o.enum(["parts","time"]).optional().describe("parts: the piece's parts aligned to the sections, by durations, places and names; time: each section against the same seconds of the piece. Default parts, time when they cannot be aligned")}),positional:["reference","item"],output:o.looseObject({reference:o.string(),sheet:o.string(),matches:o.array(o.unknown())}),examples:["allyhub reference compare ad launch/film","allyhub reference compare .allyhub/work/reference/ad launch/film --by time"]},async(e,r)=>{const s=await R(r.cwd,e.dir),n=await ee(s,r.cwd,e.reference);if(n===void 0)throw new k("no-reference",`There is no reference ${e.reference}: no reference.json at ${O(r.cwd,e.reference)} or in ${m(E,e.reference)}.`,{exit:h.notFound,hint:"Make it with allyhub reference <file or URL>."});const t=await w(()=>Z(n)),c=await B(e,r,"render",async i=>{r.progress(`Measuring ${i.target.piece} from its code`);const{comparison:f,sheet:d}=await w(()=>G(i,{ref:t.ref,video:t.video,words:t.words,interpretation:t.interpretation,by:e.by,draw:(l,g)=>L(i.session.browser,{html:l,width:g})})),a=I(i.target.combo),u=await fe(m(n,`compare.${i.target.piece.replaceAll("/","-")}${a==="default"?"":`.${a}`}.${M()}`),d);return{piece:i.target.piece,combo:i.target.combo,format:i.target.format,sheet:u,comparison:f}}),p=c.result;return{value:{reference:n,...t.ref.wordsMissing?{referenceWordsMissing:t.ref.wordsMissing}:{},piece:p.piece,combo:p.combo,format:p.format,sheet:p.sheet,...p.comparison,problems:c.problems.filter(i=>i.level==="error")},text:le({...p,reference:n,ref:t.ref,problems:c.problems},i=>A(r.cwd,i))}}),referenceServed=j({name:"reference served",summary:"A piece measured as a platform serves it: rendered as its export (through the part cache), encoded as the platform's served encode, and measured as a reference is, with where it means to cut against the cuts found",input:o.strictObject({...T,platform:o.string().optional().describe(`The platform whose served encode it goes through: ${F().join(", ")||"none measured yet"}; none measures the export itself. Default the piece's format's, when AllyHub has measured it`)}),positional:["item"],output:o.looseObject({dir:o.string(),file:o.string(),reference:o.unknown()}),examples:["allyhub reference served launch/film-tiktok","allyhub reference served launch/film --platform tiktok"]},async(e,r)=>{const s=await R(r.cwd,e.dir);if(e.platform!==void 0&&e.platform!=="none"&&S(e.platform)===void 0)throw new k("bad-option",`AllyHub has no served encode for ${e.platform}.`,{exit:h.usage,hint:`Measured: ${F().join(", ")||"none"}; --platform none measures the export itself.`});const n=await B(e,r,"render",async d=>{const a=d.target,u=e.platform==="none"?void 0:e.platform??(S(a.format)===void 0?void 0:a.format),l=u===void 0?void 0:S(u),g=I(a.combo),b=m(s,E,[D(a.piece),...g==="default"?[]:[D(g)],u??"export"].join("-"));await z(b,{recursive:!0});const $=m(b,"export.mp4");r.progress(`Rendering ${a.piece} as exported`);const q=await X(d,"mp4",$),y=m(b,"video.mp4");let x;l?(r.progress(`Encoding it as ${u??""} serves it: h264 ${String(l.video.width)}×${String(l.video.height)} at ${String(l.video.kbps)} kbit/s, ${l.audio.codec} at ${String(l.audio.kbps)} kbit/s`),x=await ne({from:$,to:y,e:l,noSound:q.loudness===void 0,root:s})):(await J(y,{force:!0}),await _($,y),x={missing:"measured as exported (--platform none)",instead:"the export's own sound"});const v=se("mp4",a.format,{},d.timeline),H={item:a.piece,combo:{...a.combo},format:a.format,...u===void 0?{}:{platform:u},export:{type:"mp4",...v.crf===void 0?{}:{crf:v.crf},...v.maxBitrate===void 0?{}:{maxKbps:v.maxBitrate}},...l?{video:{...l.video}}:{},audio:x},K=Q(d.timeline,d.prepared.media,await oe(d.version));return{dir:b,video:y,conditions:H,cuts:K}}),{dir:t,video:c,conditions:p,cuts:i}=n.result,f=await w(()=>V(d=>C(c,{root:s,cwd:r.cwd,dir:t,draw:d,pictures:M(),all:!0,signal:r.signal,onProgress:P(r),served:async a=>({...p,...await te(c,a,i,{root:s})})})));return{value:{dir:f.dir,file:m(f.dir,"reference.json"),video:f.video,export:m(f.dir,"export.mp4"),sheets:f.sheets,sections:{from:f.sections.from,list:f.sections.sections},reference:f.reference},text:N(f,d=>A(r.cwd,d))}});function ue(e){const r=e.indexOf("=");if(r<=0)throw new k("bad-option",`--where takes label=value, not ${JSON.stringify(e)}.`,{exit:h.usage});return{key:e.slice(0,r),value:e.slice(r+1)}}export const referenceSetCommand=j({name:"reference set",summary:"A set of references as statistics: every number their reference.json holds, by its path, with its quantiles; each value's share of their interpretation.json labels; and one folder's percentile among them",input:o.strictObject({folders:o.array(o.string()).optional().describe("Reference folders, or folders of them (default the project's .allyhub/work/reference/)"),where:o.array(o.string()).optional().describe("Only the references whose interpretation.json labels hold this, label=value (a list holds what it contains)"),place:o.string().optional().describe("A reference folder to place among the set: each of its numbers with its percentile (a piece measured with allyhub reference served)"),dir:T.dir}),positional:["folders"],output:o.looseObject({n:o.number(),numbers:o.unknown()}),examples:["allyhub reference set","allyhub reference set --where format=talking-head --place .allyhub/work/reference/film-tiktok"]},async(e,r)=>{const s=e.folders===void 0||e.folders.length===0?await R(r.cwd,e.dir):void 0,n=s===void 0?(e.folders??[]).map(c=>O(r.cwd,c)):[m(s,E)],t=await w(()=>re(n,{place:e.place===void 0?void 0:O(r.cwd,e.place),where:(e.where??[]).map(ue)}));return{value:{...t},text:me(t)}});
+import{join as d,relative as $,resolve as m}from"node:path";import{z as s}from"zod";import{startBrowser as M}from"@allyhub-next/browser";import{REFERENCE_DIR as w}from"@allyhub-next/formats";import{ReferenceError as A,comparePiece as C,makeReference as D,readReference as I,referenceDir as S,referenceSet as F}from"@allyhub-next/measure";import{EXIT as l}from"@allyhub-next/protocol";import{comboKey as P}from"@allyhub-next/video-core";import{cloudHearing as L}from"../cloud-hearing.js";import{CommandError as h,defineCommand as u}from"../command.js";import{fresh as N}from"../fields.js";import{fromMedia as q,progressLines as x}from"../media.js";import{projectOfFile as V,projectRoot as b}from"../project.js";import{VERSION_FIELDS as g,commandError as W,withVersion as _}from"../version.js";import{drawPage as y,looks as k,save as z}from"./frames/common.js";import{compareText as B,referenceText as H,setText as J}from"./reference-text.js";function K(e){return e instanceof A?new h(e.code,e.message,{exit:e.kind==="usage"?l.usage:e.kind==="not-found"?l.notFound:l.failed,...e.hint===void 0?{}:{hint:e.hint}}):W(q(e))}async function f(e){try{return await e()}catch(r){throw K(r)}}async function U(e){let r;try{r=await M();const n=r;return await e((t,o)=>y(n,{html:t,width:o}))}finally{await r?.close()}}const j=(e,r)=>{const n=$(e,r);return n===""||n.startsWith("..")?r:n};export const reference=u({name:"reference",summary:"Measure a reference video into .allyhub/work/reference/<id>/: its words, cuts, on-screen text, pace, sound and picture as numbers, contact sheets, and reference.json; your interpretation.json beside it names its sections",input:s.strictObject({source:s.string().describe("A video file, an address yt-dlp downloads (TikTok, Instagram, YouTube…), or a reference folder (its path or id) to measure again in place"),lang:s.string().optional().describe("The language spoken, one of Parakeet's 25 European languages (en, es, fr, de…); left out, Parakeet tells them apart. One it does not cover leaves the words missing and the rest measured"),all:s.boolean().default(!1).describe("Also keep what the fixed thresholds leave out: every shot peak with its score (shots.candidates), the words OCR read with too little confidence (ocr.low) and every gap between words (speech.gaps)"),fresh:N,dir:s.string().optional().describe("The project it goes in (default the nearest above the file, else the current folder's)")}),positional:["source"],output:s.looseObject({dir:s.string(),file:s.string(),reference:s.unknown()}),examples:["allyhub reference ~/Downloads/ad.mp4","allyhub reference https://www.tiktok.com/@brand/video/7412345678901234567","allyhub reference ad --all"]},async(e,r)=>{const n=/^https?:\/\//i.test(e.source),t=await V(n?".":e.source,r.cwd,e.dir);t.warning!==void 0&&r.progress(t.warning);const o=await f(()=>U(i=>D(e.source,{root:t.root,cwd:r.cwd,draw:i,pictures:k(),lang:e.lang,cloud:L(r,t.root),all:e.all,fresh:e.fresh,signal:r.signal,onProgress:x(r)})));return o.reference.wordsMissing!==void 0&&r.progress(`Speech recognition failed, so the words are missing: ${o.reference.wordsMissing.message}`),{value:{dir:o.dir,file:d(o.dir,"reference.json"),video:o.video,...o.words===void 0?{}:{words:o.words},sheets:o.sheets,...o.interpretation?{interpretation:o.interpretation}:{},sections:{from:o.sections.from,list:o.sections.sections},reference:o.reference},text:H(o,i=>j(r.cwd,i))}}),referenceCompare=u({name:"reference compare",summary:"A piece measured from its code, with no render, against a reference's sections (your interpretation.json's, else its neutral segments): per section and overall, the piece's numbers less the reference's, and a side-by-side sheet",input:s.strictObject({reference:s.string().describe("The reference: its folder, its reference.json, or its id under .allyhub/work/reference/"),...g,by:s.enum(["parts","time"]).optional().describe("parts: the piece's parts aligned to the sections, by durations, places and names; time: each section against the same seconds of the piece. Default parts, time when they cannot be aligned")}),positional:["reference","item"],output:s.looseObject({reference:s.string(),sheet:s.string(),matches:s.array(s.unknown())}),examples:["allyhub reference compare ad launch/film","allyhub reference compare .allyhub/work/reference/ad launch/film --by time"]},async(e,r)=>{const n=await b(r.cwd,e.dir),t=await S(n,r.cwd,e.reference);if(t===void 0)throw new h("no-reference",`There is no reference ${e.reference}: no reference.json at ${m(r.cwd,e.reference)} or in ${d(w,e.reference)}.`,{exit:l.notFound,hint:"Make it with allyhub reference <file or URL>."});const o=await f(()=>I(t)),i=await _(e,r,"render",async a=>{r.progress(`Measuring ${a.target.piece} from its code`);const{comparison:v,sheet:O}=await f(()=>C(a,{ref:o.ref,video:o.video,words:o.words,interpretation:o.interpretation,by:e.by,draw:(R,T)=>y(a.session.browser,{html:R,width:T})})),p=P(a.target.combo),E=await z(d(t,`compare.${a.target.piece.replaceAll("/","-")}${p==="default"?"":`.${p}`}.${k()}`),O);return{piece:a.target.piece,combo:a.target.combo,format:a.target.format,sheet:E,comparison:v}}),c=i.result;return{value:{reference:t,...o.ref.wordsMissing?{referenceWordsMissing:o.ref.wordsMissing}:{},piece:c.piece,combo:c.combo,format:c.format,sheet:c.sheet,...c.comparison,problems:i.problems.filter(a=>a.level==="error")},text:B({...c,reference:t,ref:o.ref,problems:i.problems},a=>j(r.cwd,a))}});function X(e){const r=e.indexOf("=");if(r<=0)throw new h("bad-option",`--where takes label=value, not ${JSON.stringify(e)}.`,{exit:l.usage});return{key:e.slice(0,r),value:e.slice(r+1)}}export const referenceSetCommand=u({name:"reference set",summary:"A set of references as statistics: every number their reference.json holds, by its path, with its quantiles; each value's share of their interpretation.json labels; and one folder's percentile among them",input:s.strictObject({folders:s.array(s.string()).optional().describe("Reference folders, or folders of them (default the project's .allyhub/work/reference/)"),where:s.array(s.string()).optional().describe("Only the references whose interpretation.json labels hold this, label=value (a list holds what it contains)"),place:s.string().optional().describe("A reference folder to place among the set: each of its numbers with its percentile (a piece measured with allyhub reference served)"),dir:g.dir}),positional:["folders"],output:s.looseObject({n:s.number(),numbers:s.unknown()}),examples:["allyhub reference set","allyhub reference set --where format=talking-head --place .allyhub/work/reference/film-tiktok"]},async(e,r)=>{const n=e.folders===void 0||e.folders.length===0?await b(r.cwd,e.dir):void 0,t=n===void 0?(e.folders??[]).map(i=>m(r.cwd,i)):[d(n,w)],o=await f(()=>F(t,{place:e.place===void 0?void 0:m(r.cwd,e.place),where:(e.where??[]).map(X)}));return{value:{...o},text:J(o)}});

package/dist/commands/render.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{join as u,resolve as b}from"node:path";import{z as a}from"zod";import{formatConsole as g,formatProblem as y}from"../text/index.js";import{exportProject as x}from"@allyhub-next/export";import{SHARE_ENCODE as s}from"@allyhub-next/render";import{consoleJson as m}from"@allyhub-next/project";import{OUT_DIR as v}from"@allyhub-next/formats";import{EXIT as d}from"@allyhub-next/protocol";import{defineCommand as w}from"../command.js";import{parameters as $}from"../parameters.js";import{projectRoot as k}from"../project.js";import{combosOf as P,commandError as O}from"../version.js";import{dir as j,indexing as B}from"../fields.js";const S={codec:a.enum(["h264","h265"]).default("h264").describe("The mp4's video codec; h265 is smaller"),crf:a.number().int().min(0).max(63).optional().describe(`Quality, lower is better: default ${String(s.crf)} for an mp4, ready to share (a platform profile's format its own), 30 for a webm`),maxBitrate:a.number().int().min(0).max(5e5).optional().describe(`An mp4's most video bitrate, kbit/s, 0 for none: default ${String(s.maxKbps)} at 1080p ${String(s.fps)} fps, scaled by the frame's pixels and the frames a second (16000 at 1080p 60, 32000 at 4K 30), so the file is ready to share; a platform profile's format its own`),audioBitrate:a.number().int().min(32).max(512).optional().describe("The sound's bitrate, kbit/s: default 192 (AAC in an mp4), 160 (Opus in a webm); a mov keeps PCM")},T=(o,r)=>`${String(o)} ${r}${o===1?"":"s"}`;export const render=w({name:"render",summary:"The files: a video, its frames, subtitles, cover and mastered mix; a batch's table of ads; a deck's PDF, PPTX and PNGs; a doc's PDF and Markdown; a sheet's xlsx, CSV, Markdown and JSON; a 3D model's GLB",input:a.strictObject({items:a.array(a.string()).optional().describe("Only these items: an id, a path into one, or a folder of items; default every one"),combo:a.array(a.string()).optional().describe("Only the combos matching name=value pairs joined with commas (lang=zh-cn,hook=b), or a combo's id (c03)"),type:a.array(a.string()).optional().describe("File types: mp4, mov, webm, gif, png, srt, vtt (cues cut as the piece's captions layer cuts them, else by default), cover, wav (the mix, mastered as the render masters it: 48 kHz, 16 bits, the film's length), pdf, pptx; csv for a piece with slots, its table of ads (<piece>/ads.csv: a row per ad with its combo, picks, length, file, name and generated media); a doc's pdf, png, md; a sheet's xlsx, csv, md, json; a 3D model's glb. Default mp4 for a video, pdf for a deck and a doc, xlsx for a sheet, glb for a model; a type an item does not have is skipped"),out:a.string().optional().describe("The folder the files go in; default .allyhub/out"),name:a.string().optional().describe("Name a video's or deck's files <name>.<ext> in its folder of the output, with what tells its versions apart before the extension when there are several (<name>.zh-cn.mp4, <name>.c03.mp4); default <output>.<combo>.<ext>"),params:$(S),dir:j}),positional:["items"],output:a.looseObject({out:a.string(),files:a.array(a.looseObject({name:a.string(),path:a.string(),type:a.string()})),failed:a.array(a.looseObject({name:a.string(),code:a.string()}))}),examples:["allyhub render","allyhub render launch/film --type mp4,srt","allyhub render launch/film --type wav","allyhub render ads/tidyform --type csv","allyhub render launch/plan --type pdf,md","allyhub render --combo lang=zh-cn --param crf=16","allyhub render launch/film --name launch-film --param max-bitrate=0"]},async(o,r)=>{const n=await k(r.cwd,o.dir),l=b(r.cwd,o.out??u(n,v)),i=o.params,f={codec:i.codec,...i.crf===void 0?{}:{crf:i.crf},...i.maxBitrate===void 0?{}:{maxBitrate:i.maxBitrate},...i.audioBitrate===void 0?{}:{audioBitrate:i.audioBitrate}};let t;try{t=await x({root:n,out:l,...o.items===void 0?{}:{items:o.items},combos:P(o),...o.type===void 0?{}:{types:o.type},...o.name===void 0?{}:{name:o.name},encode:f,index:B(r.env),log:e=>{r.progress(e)},signal:r.signal})}catch(e){throw O(e)}const p=e=>e?` (${e.integrated.toFixed(1)} LUFS, true peak ${e.truePeak===void 0?"–":e.truePeak.toFixed(1)} dBTP)`:"",c=t.problems.filter(e=>e.level==="error"),h=[`${T(t.files.length,"file")} in ${t.out}:`,...t.files.map(e=>`  ${e.path}${p(e.loudness)}`),...t.failed.length>0?["Not made:",...t.failed.map(e=>`  ${e.name}: ${e.message}${e.hint?` ${e.hint}`:""}`)]:[],...t.unindexed.map(e=>`Not indexed, drawn the fallback way: ${e.file} (${e.error})`),...c.map(y),...g(m(t.console))];return{value:{out:t.out,files:t.files.map(e=>({...e})),failed:t.failed.map(e=>({...e})),problems:t.problems,...t.unindexed.length>0?{unindexed:t.unindexed}:{},...m(t.console)},text:h.join(`
-`),exit:t.failed.length>0?d.failed:d.ok}});
+import{join as x,resolve as y}from"node:path";import{z as t}from"zod";import{formatConsole as w,formatProblem as v}from"../text/index.js";import{exportProject as k}from"@allyhub-next/export";import{SHARE_ENCODE as n}from"@allyhub-next/render";import{consoleJson as p}from"@allyhub-next/project";import{OUT_DIR as $}from"@allyhub-next/formats";import{EXIT as c}from"@allyhub-next/protocol";import{defineCommand as P}from"../command.js";import{parameters as O}from"../parameters.js";import{projectRoot as S}from"../project.js";import{combosOf as j,commandError as B}from"../version.js";import{dir as A,indexing as D}from"../fields.js";const N={codec:t.enum(["h264","h265"]).default("h264").describe("The mp4's video codec; h265 is smaller"),crf:t.number().int().min(0).max(63).optional().describe(`Quality, lower is better: default ${String(n.crf)} for an mp4, ready to share (a platform profile's format its own), 30 for a webm`),maxBitrate:t.number().int().min(0).max(5e5).optional().describe(`An mp4's most video bitrate, kbit/s, 0 for none: default ${String(n.maxKbps)} at 1080p ${String(n.fps)} fps, scaled by the frame's pixels and the frames a second (16000 at 1080p 60, 32000 at 4K 30), so the file is ready to share; a platform profile's format its own`),audioBitrate:t.number().int().min(32).max(512).optional().describe("The sound's bitrate, kbit/s: default 192 (AAC in an mp4), 160 (Opus in a webm); a mov keeps PCM"),steps:t.boolean().default(!1).describe("A deck's pdf, png and pptx: a page, a file or a slide per step of each page, not only its last"),pptx:t.enum(["native","picture","editable"]).default("native").describe("A deck's pptx: native, PowerPoint's own model (the deck's masters, layouts, placeholders, shapes, text, pictures, videos and notes, a component as its picture); picture, each slide a picture of the page; or editable, the page's picture without its text under a text box per block of text")},T=(o,i)=>`${String(o)} ${i}${o===1?"":"s"}`;export const render=P({name:"render",summary:"The files: a video, its frames, subtitles, cover and mastered mix; a batch's table of ads; a deck's PDF, PPTX and PNGs; a doc's PDF and Markdown; a sheet's Excel workbook with live formulas, PDF, PNG, CSV, Markdown and JSON; a 3D model's GLB",input:t.strictObject({items:t.array(t.string()).optional().describe("Only these items: an id, a path into one, or a folder of items; default every one"),combo:t.array(t.string()).optional().describe("Only the combos matching name=value pairs joined with commas (lang=zh-cn,hook=b), or a combo's id (c03)"),type:t.array(t.string()).optional().describe("File types: mp4, mov, webm, gif, png, srt, vtt (cues cut as the piece's captions layer cuts them, else by default), cover, wav (the mix, mastered as the render masters it: 48 kHz, 16 bits, the film's length), pdf, pptx; csv for a piece with slots, its table of ads (<piece>/ads.csv: a row per ad with its combo, picks, length, file, name and generated media); a doc's pdf, docx, png, md; a sheet's xlsx (every sheet, formulas live with their values cached), pdf, png, csv, md, json; a 3D model's glb. Default mp4 for a video, pdf for a deck and a doc, xlsx for a sheet, glb for a model; a type an item does not have is skipped"),out:t.string().optional().describe("The folder the files go in; default .allyhub/out"),name:t.string().optional().describe("Name a video's or deck's files <name>.<ext> in its folder of the output, with what tells its versions apart before the extension when there are several (<name>.zh-cn.mp4, <name>.c03.mp4); default <output>.<combo>.<ext>"),params:O(N),dir:A}),positional:["items"],output:t.looseObject({out:t.string(),files:t.array(t.looseObject({name:t.string(),path:t.string(),type:t.string()})),failed:t.array(t.looseObject({name:t.string(),code:t.string()}))}),examples:["allyhub render","allyhub render launch/film --type mp4,srt","allyhub render launch/film --type wav","allyhub render ads/tidyform --type csv","allyhub render launch/plan --type pdf,md","allyhub render finance/budget --type xlsx,pdf","allyhub render launch/deck --type pptx --param pptx=editable","allyhub render --combo lang=zh-cn --param crf=16","allyhub render launch/film --name launch-film --param max-bitrate=0"]},async(o,i)=>{const d=await S(i.cwd,o.dir),f=y(i.cwd,o.out??x(d,$)),r=o.params,h={codec:r.codec,...r.crf===void 0?{}:{crf:r.crf},...r.maxBitrate===void 0?{}:{maxBitrate:r.maxBitrate},...r.audioBitrate===void 0?{}:{audioBitrate:r.audioBitrate}};let l=0,a;try{a=await k({root:d,out:f,...o.items===void 0?{}:{items:o.items},combos:j(o),...o.type===void 0?{}:{types:o.type},...o.name===void 0?{}:{name:o.name},encode:h,...r.steps?{steps:!0}:{},...r.pptx==="native"?{}:{pptx:r.pptx},index:D(i.env),log:e=>{i.progress(e)},onProgress:e=>{const s=Math.floor(e*10);s<=l||s>=10||(l=s,i.progress(`${String(s*10)}%`))},signal:i.signal})}catch(e){throw B(e)}const u=e=>e?` (${e.integrated.toFixed(1)} LUFS, true peak ${e.truePeak===void 0?"–":e.truePeak.toFixed(1)} dBTP)`:"",b=a.problems.filter(e=>e.level==="error"),m=a.files.flatMap(e=>e.files.length>1?e.files.map(s=>`  ${s}`):[`  ${e.path}${u(e.loudness)}`]),g=[`${T(m.length,"file")} in ${a.out}:`,...m,...a.failed.length>0?["Not made:",...a.failed.map(e=>`  ${e.name}: ${e.message}${e.hint?` ${e.hint}`:""}`)]:[],...a.unindexed.map(e=>`Not indexed, drawn the fallback way: ${e.file} (${e.error})`),...new Set(a.files.flatMap(e=>(e.fontsLeft??[]).map(s=>`Not in the file: ${s.font} (${s.why}); PowerPoint shows another font where it is not installed.`))),...b.map(v),...w(p(a.console))];return{value:{out:a.out,files:a.files.map(e=>({...e})),failed:a.failed.map(e=>({...e})),problems:a.problems,...a.unindexed.length>0?{unindexed:a.unindexed}:{},...p(a.console)},text:g.join(`
+`),exit:a.failed.length>0?c.failed:c.ok}});

package/dist/commands/sheet.js

@@ -1,4 +1,8 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{mkdir as M,readFile as b,stat as S,writeFile as k}from"node:fs/promises";import{basename as x,dirname as v,join as l,relative as I,resolve as T}from"node:path";import{z as m}from"zod";import{ITEM_KINDS as N,SHEET_SPEC as E}from"@allyhub-next/formats";import{EXIT as w}from"@allyhub-next/protocol";import{importSheets as V,PROFILE_TOP as L,profileSheet as _,readSheet as j,readSpec as A}from"@allyhub-next/sheet";import{CommandError as p,defineCommand as F}from"../command.js";import{projectRoot as O}from"../project.js";import{dir as C}from"../fields.js";const u=N.sheet.entries[0];async function D(e,n,o){const s=T(n,o);for(const t of[x(s)===u?s:l(s,u),l(e,o,u)])if((await S(t).catch(()=>{}))?.isFile())return t;throw new p("not-found",`There is no sheet ${o}.`,{exit:w.notFound,hint:"Name it by its folder (research/leads) or its sheet.csv."})}const d=e=>e.toLocaleString("en-US"),y=e=>e.toLocaleString("en-US",{maximumFractionDigits:4});function P(e,n){const o=[`${d(e.empty)} empty`,`${d(e.distinct)} distinct`];if(e.unreadable>0&&o.push(`${d(e.unreadable)} unreadable`),e.min!==void 0&&e.max!==void 0){const t=r=>typeof r=="number"?y(r):r;o.push(`${t(e.min)} to ${t(e.max)}`)}e.sum!==void 0&&o.push(`sum ${y(e.sum)}`),e.mean!==void 0&&o.push(`mean ${y(e.mean)}`),e.shortest!==void 0&&e.longest!==void 0&&o.push(`${String(e.shortest)} to ${String(e.longest)} characters`);const s=[`${e.name.padEnd(n)}  ${e.type.padEnd(12)}  ${o.join(", ")}`];return e.values?.some(t=>t.count>1)&&s.push(`${"".padEnd(n+14)}  most: ${e.values.map(t=>`${JSON.stringify(t.value.length>40?`${t.value.slice(0,39)}…`:t.value)} ${d(t.count)}`).join(", ")}`),s}const R=m.string().transform(e=>e.replace(/^\/+|\/+$/gu,"")).refine(e=>e!==""&&!e.split("/").some(n=>n===""||n==="."||n===".."),{message:"a folder from the project's root, such as research/leads"});async function U(){return(await import("exceljs")).default}export const sheet=F({name:"sheet",summary:"A sheet's columns measured: counts, empty, distinct, ranges, frequent values",input:m.strictObject({sheet:m.string().describe("The sheet, by its folder or its sheet.csv"),dir:C}),positional:["sheet"],output:m.looseObject({}),examples:["allyhub sheet research/leads"]},async(e,n)=>{const o=await O(n.cwd,e.dir),s=await D(o,n.cwd,e.sheet),t=j(await b(s,"utf8")),r=await b(l(v(s),E),"utf8").catch(()=>{}),f=r===void 0?{columns:{}}:A(r).spec,c=_(t.data,f),h=I(o,s),a=Math.min(24,Math.max(4,...c.map(i=>i.name.length)));return{value:{file:h,rows:t.data.rows.length,columns:c,problems:t.problems.length},text:[`${h}: ${d(t.data.rows.length)} rows, ${String(c.length)} columns; each column's ${String(L)} most frequent values`,"",...c.flatMap(i=>P(i,a)),...t.problems.length>0?["",`The file has ${String(t.problems.length)} problems: allyhub check lists them.`]:[]].join(`
-`)}}),sheetImport=F({name:"sheet import",summary:"Makes a sheet of a CSV, TSV or workbook: a CSV as it is, a TSV as CSV, a workbook a sheet per worksheet; never over a place that is taken",input:m.strictObject({file:m.string().describe("The file to make a sheet of; a workbook's columns are typed only where it types a whole column"),to:R.optional().describe("The sheet's folder, from the project's root (default the file's name); a workbook's worksheets go at <folder>-<worksheet>"),dir:C}),positional:["file"],output:m.looseObject({}),examples:["allyhub sheet import ~/Downloads/leads.xlsx --to research/leads"]},async(e,n)=>{const o=await O(n.cwd,e.dir),s=T(n.cwd,e.file),t=await b(s).catch(()=>{throw new p("not-found",`There is no file ${s}.`,{exit:w.notFound})}),r=e.to?.includes("/")?v(e.to):"";let f;try{f=await V(s,new Uint8Array(t),{...e.to===void 0?{}:{base:x(e.to)},.../\.xlsx$/iu.test(s)?{excel:await U()}:{}})}catch(a){throw new p("bad-file",a.message,{exit:w.usage})}const c=f.map(a=>r===""?a.name:`${r}/${a.name}`);for(const a of c)if(await S(l(o,a)).catch(()=>{}))throw new p("place-taken",`${a} is already there.`,{exit:w.conflict,hint:"Name another place with --to."});const h=[];for(const[a,i]of f.entries()){const $=c[a]??i.name,g=l(o,$);await M(g,{recursive:!0}),await k(l(g,u),i.csv,{flag:"wx"}),await k(l(g,E),i.spec,{flag:"wx"}),h.push({place:$,file:`${$}/${u}`,title:i.title,rows:j(i.csv).data.rows.length})}return{value:{made:h},text:h.map(a=>`Made ${a.file}: ${d(a.rows)} row${a.rows===1?"":"s"}`).join(`
-`)}});
+import{mkdir as ie,readFile as X,stat as q,writeFile as ce}from"node:fs/promises";import{basename as k,dirname as L,extname as A,join as S,relative as B,resolve as D}from"node:path";import{z as f}from"zod";import{readSheetSource as he,sheetRoot as de,workbookFiles as fe}from"@allyhub-next/build";import{ITEM_KINDS as me}from"@allyhub-next/formats";import{EXIT as $}from"@allyhub-next/protocol";import{CellError as ue,DIFF_DEFAULTS as we,FormulaCell as O,Matrix as pe,PROFILE_TOP as be,SharedFormula as $e,cellName as M,checkWorkbook as z,dataValue as _,diffWorkbooks as ge,importRows as ye,profileTable as xe,rangeName as G,readAddress as ve,readArea as ke,scenarioNames as K,shownValue as j}from"@allyhub-next/sheet";import{CAPABILITIES as Y}from"@allyhub-next/sheet/api";import{COMPARE_TOLERANCE as Se,importXlsx as Q}from"@allyhub-next/sheet/xlsx";import{CommandError as g,defineCommand as E}from"../command.js";import{projectRoot as T}from"../project.js";import{dir as C}from"../fields.js";const x=me.sheet.entries[0];export const CALC_ROWS=50,TRACE_CELLS=50;export async function findSheet(e,o,s){const t=D(o,s);for(const n of[k(t)===x?t:S(t,x),S(e,s,x),S(e,"content",s,x)])if((await q(n).catch(()=>{}))?.isFile())return n}export const sheetFolderName=(e,o)=>B(e,L(o)).replace(/^content\//u,"");export async function sheetAt(e,o,s){const t=await findSheet(e,o,s);if(t!==void 0)return t;throw new g("not-found",`There is no sheet ${s}.`,{exit:$.notFound,hint:"Name it by its folder (research/leads, a folder under content/ with or without content/) or its sheet.yaml."})}export async function sourceOfSheet(e,o){const s=de(e,L(o)),t=await he(s.root,s.dir);return{...s,source:t,files:fe(s.root,t)}}export async function openSheet(e,o,s,t){const n=await sheetAt(e,o,s),{source:a,files:r}=await sourceOfSheet(e,n),{workbook:c,calc:i,problems:l}=z(r,{scenario:t});if(!c||!i)throw new g("bad-file",`${B(e,n)} cannot be read: ${l.map(m=>`${m.line===void 0?"":`line ${String(m.line)}: `}${m.message}`).join("; ")}`,{exit:$.usage,hint:"allyhub check lists what is wrong."});return{file:B(e,n),workbook:c,calc:i,problems:l.length+a.problems.length}}function je(e,o){const s=K(e);if(!s.includes(o))throw new g("not-found",`There is no scenario ${o}.`,{exit:$.notFound,hint:s.length>0?`It has ${s.join(", ")}.`:"sheet.yaml's scenarios holds none."})}const u=e=>e.toLocaleString("en-US"),R=e=>e.toLocaleString("en-US",{maximumFractionDigits:4}),P=e=>e>0?["",`The workbook has ${String(e)} problem${e===1?"":"s"}: allyhub check lists them.`]:[];function Ee(e,o){const s=[`${u(e.empty)} empty`,`${u(e.distinct)} distinct`];e.errors>0&&s.push(`${u(e.errors)} errors`),e.min!==void 0&&e.max!==void 0&&s.push(`${R(e.min)} to ${R(e.max)}`),e.sum!==void 0&&s.push(`sum ${R(e.sum)}`),e.mean!==void 0&&s.push(`mean ${R(e.mean)}`),e.shortest!==void 0&&e.longest!==void 0&&s.push(`${String(e.shortest)} to ${String(e.longest)} characters`);const t=[`${e.name.padEnd(o)}  ${s.join(", ")}`];return e.formula!==void 0&&t.push(`${"".padEnd(o)}  ${e.formula}`),e.top.some(n=>n.count>1)&&t.push(`${"".padEnd(o)}  most: ${e.top.map(n=>`${JSON.stringify(n.value.length>40?`${n.value.slice(0,39)}…`:n.value)} ${u(n.count)}`).join(", ")}`),t}export const sheet=E({name:"sheet",summary:"Each table of a sheet measured: its columns' counts, empty, distinct, ranges and frequent values",input:f.strictObject({sheet:f.string().describe("The sheet, by its folder or its sheet.yaml"),dir:C}),positional:["sheet"],output:f.looseObject({}),examples:["allyhub sheet research/leads"]},async(e,o)=>{const s=await T(o.cwd,e.dir),{file:t,workbook:n,calc:a,problems:r}=await openSheet(s,o.cwd,e.sheet),c=n.tables.map(l=>({name:l.name,rows:l.rows,columns:xe(a,l)})),i=c.flatMap(l=>{const m=Math.min(24,Math.max(4,...l.columns.map(w=>w.name.length)));return["",`${l.name}: ${u(l.rows)} rows, ${String(l.columns.length)} columns; each column's ${String(be)} most frequent values`,...l.columns.flatMap(w=>Ee(w,m))]});return{value:{file:t,tables:c,problems:r},text:[`${t}: ${String(n.sheets.length)} sheet${n.sheets.length===1?"":"s"}, ${String(c.length)} table${c.length===1?"":"s"}`,...i,...P(r)].join(`
+`)}});const Z=e=>{const o=e.sheets[0];if(!o)throw new g("bad-file","The workbook has no sheets.",{exit:$.usage});return o};function ee(e,o){const s=o.lastIndexOf("!");if(s<0)return{sheet:Z(e),address:o};const t=o.slice(0,s).replace(/^'|'$/gu,"").replaceAll("''","'"),n=e.sheet(t);if(!n)throw new g("not-found",`There is no sheet ${t}.`,{exit:$.notFound,hint:`It has ${e.sheets.map(a=>a.name).join(", ")}.`});return{sheet:n,address:o.slice(s+1)}}function N(e,o,s,t){const n=[];for(let a=o.top;a<=o.bottom;a++){const r=[];for(let c=o.left;c<=o.right;c++){const i=t.value(e,a,c),l=e.lookAt(a,c).format,m=e.at(a,c);r.push({address:M({row:a,col:c}),value:_(i,l),shown:j(i,l),...m instanceof O?{formula:m.text}:{}})}n.push(r)}return{sheet:e.name,what:s,area:G(o),rows:n}}function Oe(e,o,s){const t=a=>({address:"",value:_(a,void 0),shown:j(a)});if(!(s instanceof pe))return{sheet:e.name,what:o,rows:[[t(s)]]};const n=[];for(let a=0;a<s.rows;a++){const r=[];for(let c=0;c<s.cols;c++)r.push(t(s.at(a,c)));n.push(r)}return{sheet:e.name,what:o,rows:n}}function te(e,o){const{wb:s}=e;if(o===void 0)return s.sheets.flatMap(l=>{const m=l.used;return m?[N(l,m,l.name,e)]:[]});const t=s.table(o);if(t)return[N(t.sheet,t.area,o,e)];const n=s.name(o);if(n){const l=new $e(n.formula?.text??`=${o}`,0,0,{file:""}),m=Z(s);return[Oe(m,o,e.evaluate(l,m))]}const a=s.sheet(o);if(a){const l=a.used;return[l?N(a,l,o,e):{sheet:a.name,what:o,rows:[]}]}const{sheet:r,address:c}=ee(s,o),i=ke(c);if(!i)throw new g("not-found",`${o} is not a sheet, a table, a name or a range of this workbook.`,{exit:$.notFound,hint:[`Sheets: ${s.sheets.map(l=>l.name).join(", ")}.`,s.tables.length>0?`Tables: ${s.tables.map(l=>l.name).join(", ")}.`:"",s.names.size>0?`Names: ${[...s.names.values()].map(l=>l.name).join(", ")}.`:"","A range is Summary!B3:D3, or B3 on the first sheet."].filter(Boolean).join(" ")});return[N(r,i,o,e)]}function W(e){const o=[];for(const s of e)s.forEach((t,n)=>{o[n]=Math.max(o[n]??0,t.length)});return e.map(s=>s.map((t,n)=>n===s.length-1?t:t.padEnd(o[n]??0)).join("  ").trimEnd())}function Te(e,o){const s=e.area===void 0?e.what:`${e.sheet}!${e.area}`,t=e.rows.slice(0,o),n=e.area!==void 0,a=t.map(c=>[...n?[/\d+$/u.exec(c[0]?.address??"")?.[0]??""]:[],...c.map(i=>i.shown)]),r=(e.rows[0]??[]).map(c=>c.address.replace(/\d+$/u,""));return[s,...W(n?[["",...r],...a]:a),...e.rows.length>t.length?[`… ${u(e.rows.length-t.length)} more rows (--all)`]:[]]}export const sheetCalc=E({name:"sheet calc",summary:"What a sheet computes, without opening anything: a sheet, a range, a table, a name, or every sheet, as an aligned table",input:f.strictObject({sheet:f.string().describe("The sheet, by its folder or its sheet.yaml"),what:f.string().optional().describe("A sheet (its used range), a range (Summary!B3:D3, or B3 on the first sheet), a table or a name; default every sheet"),all:f.boolean().default(!1).describe(`Every row, not the first ${String(CALC_ROWS)}`),scenario:f.string().optional().describe("Compute it with this scenario's inputs (sheet.yaml's scenarios); nothing is written"),scenarios:f.boolean().default(!1).describe("Compare the base case and every scenario: what is names, cells or ranges, apart by commas, a row each; default the names no scenario sets"),dir:C}),positional:["sheet","what"],output:f.looseObject({}),examples:["allyhub sheet calc finance/budget","allyhub sheet calc finance/budget Summary","allyhub sheet calc finance/budget orders","allyhub sheet calc finance/budget 'Summary!B3:M3' --json","allyhub sheet calc finance/budget revenue --scenario high","allyhub sheet calc finance/budget 'revenue,Summary!B4' --scenarios"]},async(e,o)=>{const s=await T(o.cwd,e.dir);if(e.scenarios)return Fe(s,o.cwd,e.sheet,e.what);const{file:t,calc:n,problems:a,workbook:r}=await openSheet(s,o.cwd,e.sheet,e.scenario);e.scenario!==void 0&&je(r,e.scenario);const c=te(n,e.what),i=e.all?1/0:CALC_ROWS;return{value:{file:t,grids:c,problems:a},text:[...c.flatMap((l,m)=>[...m>0?[""]:[],...Te(l,i)]),...P(a)].join(`
+`)}});function Ce(e,o){return te(e,o.trim()).flatMap(s=>s.rows.flat().map(t=>({...t,address:t.address===""?o.trim():`${s.sheet}!${t.address}`})))}async function Fe(e,o,s,t){const n=await openSheet(e,o,s),a=K(n.workbook);if(a.length===0)throw new g("not-found",`${n.file} has no scenarios.`,{exit:$.notFound,hint:"sheet.yaml's scenarios: { high: { growth: 0.2 } } names some."});const r=new Set(a.flatMap(h=>Object.keys(n.workbook.file.scenarios?.[h]??{}).map(b=>b.toLowerCase()))),c=t?.split(",")??[...n.workbook.names.values()].map(h=>h.name).filter(h=>!r.has(h.toLowerCase()));if(c.length===0)throw new g("bad-input","Say what to compare: names, cells or ranges, apart by commas.",{exit:$.usage});const i=["Base case",...a],l=[n,...await Promise.all(a.map(h=>openSheet(e,o,s,h)))],w=c.map(h=>l.map(b=>Ce(b.calc,h))).flatMap(h=>(h[0]??[]).map((b,p)=>({output:b.address,values:Object.fromEntries(i.map((v,y)=>[v,h[y]?.[p]?.value??null])),shown:Object.fromEntries(i.map((v,y)=>[v,h[y]?.[p]?.shown??""]))})));return{value:{file:n.file,scenarios:i,outputs:w},text:[...W([["",...i],...w.map(h=>[h.output,...i.map(b=>h.shown[b]??"")])]),...P(n.problems)].join(`
+`)}}const Ae=(e,o)=>`${e.sheet===o?"":`${e.sheet.name}!`}${G({top:e.top,left:e.left,bottom:Math.min(e.bottom,Math.max(e.top,e.sheet.lastRow)),right:e.right})}`;export const sheetTrace=E({name:"sheet trace",summary:"What a cell depends on and what depends on it: its formula, where it is written, the places it reads and the cells that read it",input:f.strictObject({sheet:f.string().describe("The sheet, by its folder or its sheet.yaml"),cell:f.string().describe("The cell: Summary!B5, or B5 on the first sheet"),all:f.boolean().default(!1).describe(`Every cell that reads it, not the first ${String(TRACE_CELLS)}`),dir:C}),positional:["sheet","cell"],output:f.looseObject({}),examples:["allyhub sheet trace finance/budget 'Summary!B1'"]},async(e,o)=>{const s=await T(o.cwd,e.dir),{file:t,workbook:n,calc:a}=await openSheet(s,o.cwd,e.sheet),{sheet:r,address:c}=ee(n,e.cell),i=ve(c);if(!i)throw new g("bad-input",`${e.cell} is not a cell.`,{exit:$.usage});const{row:l,col:m}=i,w=a.value(r,l,m),h=r.lookAt(l,m).format,b=r.at(l,m),p=n.sourceOf(r,l,m),v=b instanceof O?a.precedents(b).map(d=>{const le=d.single?j(a.value(d.sheet,d.top,d.left),d.sheet.lookAt(d.top,d.left).format):`${u(d.cols)} × ${u(Math.max(0,Math.min(d.bottom,d.sheet.lastRow)-d.top+1))}`,J=d.single?d.sheet.at(d.top,d.left):void 0,H=J instanceof O?J.text:void 0;return{address:Ae(d,r),shown:le,...H===void 0?{}:{formula:H}}}):[],y=a.readers(r,l,m),I=e.all?y:y.slice(0,TRACE_CELLS),V=I.map(d=>({address:`${d.sheet===r?"":`${d.sheet.name}!`}${M(d)}`,shown:j(d.value,d.sheet.lookAt(d.row,d.col).format),formula:d.text})),U=d=>[`  ${d.address}`,d.shown,d.formula].filter(Boolean).join("  "),F=p===void 0?void 0:p.line===void 0?p.file:`${p.file}:${String(p.line)}`;return{value:{file:t,cell:`${r.name}!${M(i)}`,value:_(w,h),shown:j(w,h),...w instanceof ue?{error:w.code}:{},...b instanceof O?{formula:b.text}:{},...F===void 0?{}:{written:F},reads:v,readBy:V,readers:y.length},text:[`${r.name}!${M(i)}  ${j(w,h)}`,...b instanceof O?[`  ${b.text}`]:[],...F===void 0?[]:[`  written in ${F}`],...v.length>0?["reads:",...v.map(U)]:[],...y.length>0?[`read by ${u(y.length)}:`,...V.map(U),...y.length>I.length?[`  … ${u(y.length-I.length)} more (--all)`]:[]]:["read by nothing"]].join(`
+`)}}),sheetCapabilities=E({name:"sheet capabilities",summary:"What @allyhub/sdk/sheets holds of openpyxl's (its classes), how it differs and what it adds, and the worksheet functions, as JSON",input:f.strictObject({}),output:f.looseObject({}),examples:["allyhub sheet capabilities"]},()=>Promise.resolve({value:{...Y},text:JSON.stringify(Y,null,2)}));const se=new Set([".xlsx",".xlsm",".xltx",".xltm"]);export const DIFF_ROWS=50;const oe={value:"Value changed, formula the same",formula:"Formula changed, value the same",both:"Formula and value changed",added:"Added",removed:"Removed"},Me=e=>{const o=(e.now??e.was)?.cell??"",s=e.table===void 0?o:`${e.table}[${e.key??o}]`,t=e.column===void 0?"":` ${e.column}`;return`${e.sheet}!${s}${t}`},Re=e=>{const o=e.was?.formula??"",s=e.now?.formula??"";return[Me(e),e.was?.shown??"","→",e.now?.shown??"",e.kind==="value"?s:e.kind==="formula"||e.kind==="both"?`${o} → ${s}`:s===""?o:s]};function Ne(e,o){const s=[];for(const t of e.sheets)s.push(`Sheet ${t.name} ${t.added?"added":"removed"}`);for(const t of e.tables){const n=[t.rowsAdded.length>0?`rows added: ${t.rowsAdded.slice(0,20).join(", ")}`:"",t.rowsRemoved.length>0?`rows removed: ${t.rowsRemoved.slice(0,20).join(", ")}`:"",t.columnsAdded.length>0?`columns added: ${t.columnsAdded.join(", ")}`:"",t.columnsRemoved.length>0?`columns removed: ${t.columnsRemoved.join(", ")}`:""].filter(Boolean);s.push(`Table ${t.name}, rows lined up by ${t.by==="key"?t.key??"its key":"their place"}${n.length>0?`: ${n.join("; ")}`:""}`)}for(const t of e.names)s.push(`Name ${t.name}: ${t.was??"(none)"} → ${t.now??"(none)"}`);for(const t of e.charts)s.push(`Charts of ${t} changed`);for(const t of Object.keys(oe)){const n=e.cells.filter(r=>r.kind===t);if(n.length===0)continue;const a=o?n:n.slice(0,DIFF_ROWS);s.push("",`${oe[t]}: ${u(n.length)}`,...W(a.map(Re)).map(r=>`  ${r}`),...n.length>a.length?[`  … ${u(n.length-a.length)} more (--all)`]:[])}return s}async function ne(e,o,s){const t=D(o,s);if(se.has(A(t).toLowerCase())){const r=await X(t).catch(()=>{throw new g("not-found",`There is no file ${t}.`,{exit:$.notFound})}),c=Q(new Uint8Array(r),{name:k(t,A(t))}),{calc:i}=z({text:c.files.get(x)??"",read:l=>c.files.get(l)});if(!i)throw new g("bad-file",`${s} cannot be read.`,{exit:$.usage});return{calc:i,file:s}}const{calc:n,file:a}=await openSheet(e,o,s);return{calc:n,file:a}}export const sheetDiff=E({name:"sheet diff",summary:"Two versions of a workbook compared, by value and by formula: two folders, or a folder and an .xlsx. Cells whose formula changed and value did not are apart from those whose value changed; rows of a table line up by its key, else by their place",input:f.strictObject({was:f.string().describe("The version before: a sheet's folder or an .xlsx"),now:f.string().describe("The version after: a sheet's folder or an .xlsx"),tolerance:f.number().min(0).default(we.tolerance).describe("How far apart two numbers may be, as a share of the larger, and be the same"),all:f.boolean().default(!1).describe(`Every cell, not the first ${String(DIFF_ROWS)} of each kind`),dir:C}),positional:["was","now"],output:f.looseObject({}),examples:["allyhub sheet diff finance/budget finance/budget-v2","allyhub sheet diff finance/budget ~/Downloads/budget.xlsx --json"]},async(e,o)=>{const s=await T(o.cwd,e.dir),t=await ne(s,o.cwd,e.was),n=await ne(s,o.cwd,e.now),a=ge(t.calc,n.calc,{tolerance:e.tolerance}),{counts:r}=a,c=a.cells.length;return{value:{was:t.file,now:n.file,...a},text:[`${t.file} → ${n.file}: ${u(c)} cell${c===1?"":"s"} differ (${u(r.value)} value, ${u(r.formula)} formula, ${u(r.both)} both, ${u(r.added)} added, ${u(r.removed)} removed)`,...Ne(a,e.all)].join(`
+`)}});const Ie=f.string().transform(e=>e.replace(/^\/+|\/+$/gu,"")).refine(e=>e!==""&&!e.split("/").some(o=>o===""||o==="."||o===".."),{message:"a folder from the project's root, such as research/leads"});export const IMPORT_DIFFERENCES=50;const ae=e=>e===null?"empty":typeof e=="string"?JSON.stringify(e):String(e);function Le(e,o){const{formulas:s,same:t,uncached:n,moving:a,differences:r}=e,c=[`${u(t)} of ${u(s)} formulas compute what the file holds`,...a>0?[`${u(a)} read the clock or a random number, not compared`]:[],...n>0?[`${u(n)} have no value in the file`]:[]],i=o?r:r.slice(0,IMPORT_DIFFERENCES);return[`Computed here against the file: ${c.join("; ")}.`,...r.length>0?[`${u(r.length)} differ${r.length===1?"s":""}:`,...i.map(l=>`  ${l.sheet}!${l.cell}  ${l.formula}  file ${ae(l.file)}  here ${ae(l.engine)}`),...r.length>i.length?[`  … ${u(r.length-i.length)} more (--all)`]:[]]:[]]}async function re(e,o){for(const[s,t]of o){const n=S(e,s);await ie(L(n),{recursive:!0}),await ce(n,t,{flag:"wx"})}}export const sheetImport=E({name:"sheet import",summary:"Makes a sheet of an Excel, CSV or TSV file: its sheets, tables, formulas, names and looks as sheet.yaml and CSV files, said what could not be carried over, each formula computed here and compared with the value the file holds; never over a place that is taken",input:f.strictObject({file:f.string().describe("The file to make a sheet of: .xlsx, .xlsm, .csv or .tsv"),to:Ie.optional().describe("The sheet's folder, from the project's root (default the file's name)"),tolerance:f.number().min(0).default(Se).describe("How far apart a computed number and the file's may be, as a share of the larger, and count as the same; 0 lists every difference"),all:f.boolean().default(!1).describe(`Every difference, not the first ${String(IMPORT_DIFFERENCES)}`),dir:C}),positional:["file"],output:f.looseObject({}),examples:["allyhub sheet import ~/Downloads/forecast.xlsx --to finance/forecast","allyhub sheet import ~/Downloads/leads.csv --to research/leads"]},async(e,o)=>{const s=await T(o.cwd,e.dir),t=D(o.cwd,e.file),n=A(t).toLowerCase(),a=se.has(n);if(n===".xls"||n===".xlsb")throw new g("bad-file",`${k(t)} is Excel's binary format.`,{exit:$.usage,hint:"Save it as .xlsx, then import that."});if(!a&&n!==".csv"&&n!==".tsv")throw new g("bad-file",`${k(t)} is not an .xlsx, .xlsm, .csv or .tsv file.`,{exit:$.usage});const r=await X(t).catch(()=>{throw new g("not-found",`There is no file ${t}.`,{exit:$.notFound})}),c=k(t,A(t)),i=e.to??c;if(await q(S(s,i)).catch(()=>{}))throw new g("place-taken",`${i} is already there.`,{exit:$.conflict,hint:"Name another place with --to."});const l=S(s,i),m=e.to===void 0?c:k(e.to);if(a){let h;try{h=Q(new Uint8Array(r),{name:m,tolerance:e.tolerance})}catch(p){throw new g("bad-file",`${k(t)} cannot be read: ${p.message}`,{exit:$.usage})}await re(l,h.files);const b=[...h.files.keys()];return{value:{place:i,files:b.map(p=>`${i}/${p}`),sheets:h.sheets,tables:h.tables,lost:h.lost,problems:h.problems,compared:h.compared},text:[`Made ${i}/: ${b.join(", ")}`,...h.lost.length>0?["Not carried over:",...h.lost.map(p=>`  ${p}`)]:["Nothing was left out."],...Le(h.compared,e.all),...h.problems.length>0?["Problems:",...h.problems.map(p=>`  ${p.file}${p.line===void 0?"":`:${String(p.line)}`}: ${p.message}`)]:[],`allyhub sheet calc ${i}, then allyhub frames ${i}, to see it.`].join(`
+`)}}let w;try{w=ye(m,r.toString("utf8"),n===".tsv"?"	":",")}catch(h){throw new g("bad-file",h.message,{exit:$.usage})}return await re(l,new Map([[x,w.text],[w.path,w.csv]])),{value:{place:i,files:[`${i}/${x}`,`${i}/${w.path}`],rows:w.rows,lost:[]},text:`Made ${i}/${x} and ${i}/${w.path}: ${u(w.rows)} row${w.rows===1?"":"s"}`}});

package/dist/commands/slides.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{mkdir as y,readFile as b,stat as k,writeFile as x}from"node:fs/promises";import{basename as p,dirname as $,join as f,resolve as v}from"node:path";import{z as o}from"zod";import{EXIT as l}from"@allyhub-next/protocol";import{CAPABILITIES as h}from"@allyhub-next/slides-core";import{importDeck as j,nameOf as P,readPptx as O}from"@allyhub-next/slides-pptx";import{CommandError as n,defineCommand as u}from"../command.js";import{dir as I}from"../fields.js";import{projectRoot as T}from"../project.js";export const slidesCapabilities=u({name:"slides capabilities",summary:"What a deck's API holds of python-pptx's (its classes and enums), how it differs and what it adds, as JSON",input:o.strictObject({}),output:o.looseObject({}),examples:["allyhub slides capabilities"]},()=>Promise.resolve({value:{...h},text:JSON.stringify(h,null,2)}));const z=o.string().transform(e=>e.replace(/^\/+|\/+$/gu,"")).refine(e=>e!==""&&!e.split("/").some(a=>a===""||a==="."||a===".."),{message:"a folder from the project's root, such as launch/deck"});export const slidesImport=u({name:"slides import",summary:"Makes a deck of a PowerPoint file: its masters and layouts as slides.ts, its slides as slides.yaml, its words and notes as the script, its pictures and videos in media/; says what it could not hold; never over a place that is taken",input:o.strictObject({file:o.string().describe("The .pptx to make a deck of"),to:z.optional().describe("The deck's folder, from the project's root (default the file's name)"),lang:o.string().regex(/^[a-z]{2,3}(-[a-z0-9]+)*$/u).default("en").describe("The language of its words: the script is script.<lang>.yaml"),dir:I}),positional:["file"],output:o.looseObject({}),examples:["allyhub slides import ~/Downloads/q3-review.pptx --to reviews/q3","allyhub slides import 培训.pptx --to training --lang zh-cn"]},async(e,a)=>{const c=await T(a.cwd,e.dir),r=v(a.cwd,e.file),w=await b(r).catch(()=>{throw new n("not-found",`There is no file ${r}.`,{exit:l.notFound})}),t=e.to??P(p(r).replace(/\.pptx$/iu,""),new Set,"deck");if(await k(f(c,t)).catch(()=>{}))throw new n("place-taken",`${t} is already there.`,{exit:l.conflict,hint:"Name another place with --to."});let i;try{i=j(O(new Uint8Array(w)),{lang:e.lang,source:p(r)})}catch(s){throw new n("bad-file",`${r} is not a PowerPoint file this can read: ${s.message}`,{exit:l.usage})}for(const[s,g]of i.files){const m=f(c,t,s);await y($(m),{recursive:!0}),await x(m,g,{flag:"wx"})}const d=[...i.files.keys()];return{value:{place:t,files:d.map(s=>`${t}/${s}`),lost:i.lost},text:[`Made ${t}/: ${d.join(", ")}`,...i.lost.length>0?["Not carried over:",...i.lost.map(s=>`  ${s}`)]:[],`allyhub check, then allyhub frames ${t}, to see it.`].join(`
+`)}});

package/dist/commands/voice.js

@@ -1,4 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as t}from"zod";import{projectSays as f}from"@allyhub-next/project";import{makeSay as u}from"@allyhub-next/cloud";import{EXIT as y}from"@allyhub-next/protocol";import{CommandError as g,defineCommand as $}from"../command.js";import{projectRoot as v}from"../project.js";import{cloudOf as w,cloudWork as b,plural as n}from"./cloud.js";import{dir as j}from"../fields.js";const h=i=>Math.round(i*1e6)/1e6;export const voice=$({name:"voice",summary:"Make the voice files a project's say(text) parts need, with their cloud voice tool, one per say that has none (assets/media/gen/say/<hash>, its words and its record); --dry-run lists them first, with their tool and characters",input:t.strictObject({item:t.string().optional().describe("Only this item's says: its id, a path into it, or a folder of items"),dir:j,dryRun:t.boolean().default(!1).describe("List the says without a file, each with its tool and characters, making nothing")}),positional:["item"],output:t.looseObject({says:t.number(),missing:t.array(t.looseObject({part:t.string(),stem:t.string()})).optional(),made:t.array(t.looseObject({part:t.string(),file:t.string()})).optional(),credits:t.number().optional()}),examples:["allyhub voice --dry-run","allyhub voice launch/film"]},async(i,s)=>{const c=await v(s.cwd,i.dir),o=await f(c,i.item===void 0?{}:{piece:i.item});if(i.item!==void 0&&o.pieces.length===0)throw new g("no-item",`No video ${i.item} in the project.`,{exit:y.notFound});const a=o.says.filter(l=>l.file===void 0),d=`Every say has its file (${n(o.says.length,"say")}). Nothing to make.`;return await b(async()=>{const l=w(s);if(i.dryRun)return{value:{says:o.says.length,missing:a.map(e=>({piece:e.piece,part:e.part,tool:e.tool,...e.voice===void 0?{}:{voice:e.voice},...e.params===void 0?{}:{params:e.params},characters:e.text.length,stem:e.stem}))},text:a.length===0?d:[`${n(a.length,"say")} without a file:`,...a.map(e=>`  ${e.piece} · ${e.part}: ${e.tool}, ${n(e.text.length,"character")}`),"Nothing was made; allyhub voice makes them, priced as each tool's description says."].join(`
-`)};const r=[];for(const e of a){s.progress(`${e.piece} · ${e.part}: ${e.tool}…`);const m=await u(l,c,e,{base:c,signal:s.signal});r.push({piece:e.piece,part:e.part,...m})}const p=h(r.reduce((e,m)=>e+m.credits,0));return{value:{says:o.says.length,made:r,kept:o.says.length-a.length,credits:p},text:r.length===0?d:[`Made ${n(r.length,"file")}:`,...r.map(e=>`  ${e.file} (${e.piece} · ${e.part}, ${String(h(e.seconds))} s)`),`Credits used: ${String(p)}.`].join(`
+import{z as t}from"zod";import{projectSays as h}from"@allyhub-next/project";import{makeSay as u}from"@allyhub-next/cloud";import{EXIT as y}from"@allyhub-next/protocol";import{CommandError as g,defineCommand as $}from"../command.js";import{projectRoot as b}from"../project.js";import{cloudOf as v,cloudWork as w,plural as d}from"./cloud.js";import{dir as j}from"../fields.js";const p=o=>Math.round(o*1e6)/1e6;export const voice=$({name:"voice",summary:"Make the voice files a project's say(text) parts need, with their cloud voice tool, one per say that has none (assets/media/gen/say/<hash>, its words and its record)",input:t.strictObject({item:t.string().optional().describe("Only this item's says: its id, a path into it, or a folder of items"),dir:j}),positional:["item"],output:t.looseObject({says:t.number(),made:t.array(t.looseObject({part:t.string(),file:t.string()})).optional(),credits:t.number().optional()}),examples:["allyhub voice","allyhub voice launch/film"]},async(o,r)=>{const a=await b(r.cwd,o.dir),s=await h(a,o.item===void 0?{}:{piece:o.item});if(o.item!==void 0&&s.pieces.length===0)throw new g("no-item",`No video ${o.item} in the project.`,{exit:y.notFound});const l=s.says.filter(n=>n.file===void 0),f=`Every say has its file (${d(s.says.length,"say")}). Nothing to make.`;return await w(async()=>{const n=v(r),i=[];for(const e of l){r.progress(`${e.piece} · ${e.part}: ${e.tool}…`);const c=await u(n,a,e,{base:a,signal:r.signal});i.push({piece:e.piece,part:e.part,...c})}const m=p(i.reduce((e,c)=>e+c.credits,0));return{value:{says:s.says.length,made:i,kept:s.says.length-l.length,credits:m},text:i.length===0?f:[`Made ${d(i.length,"file")}:`,...i.map(e=>`  ${e.file} (${e.piece} · ${e.part}, ${String(p(e.seconds))} s)`),`Credits used: ${String(m)}.`].join(`
 `)}})});

package/dist/commands/words.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{readFile as k}from"node:fs/promises";import{relative as U,resolve as Y}from"node:path";import{z as f}from"zod";import{parameters as q}from"../parameters.js";import{parse as V}from"yaml";import{makeWords as X,takeVoice as T}from"@allyhub-next/build";import{readDataFile as B,wordsFileFor as A}from"@allyhub-next/formats";import{HEAR_PADS as K,hearAgain as Q,requireLanguage as Z}from"@allyhub-next/media";import{EXIT as F}from"@allyhub-next/protocol";import{LONG_WORD_DEFAULTS as ee,PARAGRAPH_GAP as se,WORD_SHAPE_DEFAULTS as re,cutReport as te,longWords as oe,paragraphs as ne,parseEditList as ae,parseScript as ie,saidOf as de,scriptDiff as le,searchWords as fe,takeLevels as ce,unheardSounds as he,wordLevels as we,wordShapes as me}from"@allyhub-next/video-core";import{CommandError as p,defineCommand as L}from"../command.js";import{existingFile as $,fromMedia as ue,media as P,progressLines as M}from"../media.js";import{projectOfFile as N}from"../project.js";import{fresh as pe}from"../fields.js";const R=f.string().optional().describe("The project whose media index keeps the recording's sound (default the nearest above the file, else the current folder's)");import{CONFIDENCE_MEANS as D,cutText as ge,hearingText as be,transcriptText as ye}from"./words-text.js";const _=f.number().nonnegative(),ve={fps:f.number().positive().default(30).describe("The frame grid cuts are placed on")},I=f.string().describe("The recording: an audio or video file"),Fe=f.strictObject({file:I,lang:f.string().optional().describe("The language spoken, one of Parakeet's 25 European languages (en, es, fr, de…); left out, Parakeet tells them apart"),fresh:pe.describe("Hear the whole file again and write its words file; with --from and --to, only that stretch, writing nothing"),from:_.optional().describe("Show the words of the file from this second on"),to:_.optional().describe("Show the words of the file up to this second"),search:f.array(f.string()).optional().describe("Where these words or phrases are said (case and punctuation ignored; a phrase's last word may be a prefix), instead of the transcript"),script:f.string().optional().describe("A script to compare with: a script.<locale>.yaml (what its parts say) or a text file; marks words it does not have, {like this}, and lines said more than once"),all:f.boolean().default(!1).describe("Also list what the thresholds leave out: every stretch between words above the noise floor, every word's inside, and every script line"),dir:R}),C=(e,s)=>new p("usage",e,{exit:F.usage,...s===void 0?{}:{hint:s}});function $e(e,s,t){const n=e.flatMap((c,a)=>(s===void 0||c.end>s)&&(t===void 0||c.start<t)?[a]:[]),r=n[0],o=n.at(-1);if(r===void 0||o===void 0)throw new p("no-words",`No word is said between ${(s??0).toFixed(2)} s and ${t===void 0?"the end":`${t.toFixed(2)} s`} of the file.`,{exit:F.notFound});return{from:r,to:o}}const g=(e,s)=>{const t=U(e,s);return t===""||t.startsWith("..")?s:t};async function j(e){const s=await k(e,"utf8").catch(()=>{});if(s===void 0)return;let t;try{t=JSON.parse(s)}catch(r){return`not JSON: ${r.message}`}const n=B("words",t);return n.ok?n.value.words.map(({confidence:r,...o})=>r===void 0?o:{...o,confidence:r}):n.problems.map(r=>r.path?`${r.path}: ${r.message}`:r.message).join("; ")}async function ke(e,s){const t=await $(e,s);let n;try{n=JSON.parse(await k(t,"utf8"))}catch(o){throw new p("bad-edits",`${s} is not JSON: ${o.message}`)}const r=ae(n);if(typeof r=="string")throw new p("bad-edits",`${s}: ${r}.`);return r}async function Ae(e,s){const t=await k(await $(e,s),"utf8"),n=c=>c.split(/(?<=[.!?。！？])\s+|\n+/u).map(a=>a.trim()).filter(a=>a!=="");if(!/\.ya?ml$/iu.test(s))return n(t);let r;try{r=V(t)}catch(c){throw new p("bad-script",`${s} is not YAML: ${c.message}`)}const o=ie(r);if("problems"in o)throw new p("bad-script",`${s}: ${o.problems[0]??""}`);return o.script.parts.flatMap(c=>{if(c.say===void 0)return[];const a=de(c.say).value;return n(typeof a=="string"?a:"speak"in a?a.speak:Object.values(a.match).join(" "))})}async function je(e,s,t,n,r){const o=await P(()=>Q(s,{from:n,to:r},K,{...e.lang===void 0?{}:{lang:e.lang},onProgress:M(t),signal:t.signal})),c=Math.min(...o.hearings.map(i=>i.heard.from)),a=Math.max(...o.hearings.map(i=>i.heard.to)),l=A(s),h=await j(l),w=Array.isArray(h)?h.map((i,m)=>({i:m,w:i})).filter(({w:i})=>i.end>c&&i.start<a).map(({i,w:m})=>({i,text:m.text,start:m.start,end:m.end,confidence:m.confidence??null,padding:m.end<=n||m.start>=r})):void 0,b={file:s,asked:{from:n,to:r},model:o.model,confidence:o.confidence?{means:D}:{means:null,missing:"The recognizer gave no token probabilities."},hearings:o.hearings,wordsFile:w?{path:l,words:w,text:w.filter(i=>!i.padding).map(i=>i.text).join(" ")}:null};return{value:b,text:be(b,g(t.cwd,s))}}export const words=L({name:"words",summary:"A recording's words: heard on this computer when it has none (or --fresh), printed by word index with the sounds between them; a stretch by seconds, heard again with --fresh",input:Fe,positional:["file"],output:f.looseObject({file:f.string(),wordsFile:f.unknown()}),examples:["allyhub words talk/host.mp4","allyhub words host.mp4 --from 23 --to 25","allyhub words host.mp4 --from 23 --to 25 --fresh",'allyhub words host.mp4 --search "you know,um"']},async(e,s)=>{const t=await $(s.cwd,e.file);try{Z(e.lang)}catch(d){throw ue(d)}const n=e.from!==void 0||e.to!==void 0;if(e.from!==void 0&&e.to!==void 0&&e.to<=e.from)throw C("--to is a second after --from.");if(n&&e.fresh){if(e.from===void 0||e.to===void 0)throw C("A stretch to hear again needs --from and --to, seconds of the file.",`allyhub words ${e.file} --from 23 --to 25 --fresh`);return je(e,t,s,e.from,e.to)}const r=await N(e.file,s.cwd,e.dir);r.warning!==void 0&&s.progress(r.warning);const o=A(t);let c,a=e.fresh?void 0:await j(o);if(typeof a=="string")throw new p("bad-words",`${g(s.cwd,o)} is not a words file: ${a}.`,{hint:"Fix it, or pass --fresh to hear the recording again."});if(a===void 0){const d=await P(()=>X(t,{root:r.root,...e.lang===void 0?{}:{lang:e.lang},onProgress:M(s),signal:s.signal}));a=d.file.words.map(({confidence:y,...u})=>y===void 0?u:{...u,confidence:y}),c={tightened:d.tightened,model:d.file.model}}const l=a,h=await T(t,r.root,{signal:s.signal}),{from:w,to:b}=n?$e(l,e.from,e.to):{from:0,to:Math.max(0,l.length-1)},i=h&&l.length>0?he(l,h,{all:e.all}):void 0,m=d=>d.after>=w-1&&d.after<=b,H=h?we(l,h):void 0,v=h?me(l,h):void 0,O=(v?.words??[]).filter(d=>d.i>=w&&d.i<=b),J=oe(O),S=e.script===void 0?void 0:await Ae(s.cwd,e.script),E=S?le(l,S):void 0,W=l.filter(d=>d.confidence===void 0).length,z=g(s.cwd,o),x={file:t,wordsFile:z,project:r.root,...c?{made:c}:{},count:l.length,duration:h?Math.round(h.db.length*h.hop*100)/100:l.at(-1)?.end??0,levels:h?{...ce(h),...i?{words:i.speech,soundFloor:i.floor}:{}}:null,...i?{soundOptions:i.options}:{},range:{from:w,to:b},words:l.slice(w,b+1).map((d,y)=>{const u=v?.words[w+y];return{i:w+y,text:d.text,start:d.start,end:d.end,confidence:d.confidence??null,...H?.[w+y]??{},...u?{letters:u.letters,expected:u.expected,ratio:u.ratio,excess:u.excess,voicedRuns:u.voicedRuns,dips:u.dips}:{}}}),rate:v?.rate??null,...v?.rateWhy===void 0?{}:{rateWhy:v.rateWhy},long:J.map(d=>d.i),longOptions:{...ee,dip:re.dip},confidence:{means:W<l.length||l.length===0?D:null,missing:W},paragraphs:ne(l,se,w,b),sounds:i?.sounds.filter(m)??[],...e.all&&i?.stretches?{stretches:i.stretches.filter(m)}:{},...e.search?{matches:e.search.map(d=>({phrase:d,at:fe(l,d)}))}:{},...E?{script:E}:{}},G=ye(x,{file:g(s.cwd,t),words:l,frames:h!==void 0,shapes:O,all:e.all});return{value:x,text:G}});const Oe=f.strictObject({file:I,edits:f.string().describe("The edits file: the cut list (words, sounds, stretches inside words, pauses) to report on"),dir:R,params:q(ve)});export const wordsEdits=L({name:"words edits",summary:"What a cut list keeps of a recording: the stretches kept, every word and sound removed, the room tone at its ends, and every join measured on both sides",input:Oe,positional:["file","edits"],output:f.looseObject({file:f.string(),wordsFile:f.string(),cut:f.unknown()}),examples:["allyhub words edits talk/host.mp4 talk/edits/host.json","allyhub words edits host.mp4 edits.json --param fps=25"]},async(e,s)=>{const t=await $(s.cwd,e.file),n=await N(e.file,s.cwd,e.dir);n.warning!==void 0&&s.progress(n.warning);const r=A(t),o=await j(r);if(o===void 0)throw new p("no-words",`${g(s.cwd,t)} has no words file yet.`,{exit:F.notFound,hint:`allyhub words ${e.file} hears its words and writes ${g(s.cwd,r)}.`});if(typeof o=="string")throw new p("bad-words",`${g(s.cwd,r)} is not a words file: ${o}.`,{hint:"Fix it, or hear the recording again: allyhub words --fresh."});if(o.length===0)throw new p("no-words",`${g(s.cwd,r)} has no words: there is nothing to cut.`,{exit:F.notFound});const c=await ke(s.cwd,e.edits),a=await T(t,n.root,{signal:s.signal}),l=te(o,c,a,{fps:e.params.fps,...a?{duration:a.db.length*a.hop}:{}});return{value:{file:t,wordsFile:g(s.cwd,r),edits:g(s.cwd,Y(s.cwd,e.edits)),project:n.root,count:o.length,cut:l},text:ge(l,o)}});
+import{readFile as k}from"node:fs/promises";import{relative as Y,resolve as q}from"node:path";import{z as f}from"zod";import{parameters as V}from"../parameters.js";import{parse as X}from"yaml";import{makeWords as B,takeVoice as x}from"@allyhub-next/build";import{cloudHearing as L}from"../cloud-hearing.js";import{readDataFile as K,wordsFileFor as A}from"@allyhub-next/formats";import{HEAR_PADS as Q,hearAgain as Z,requireLanguage as ee}from"@allyhub-next/media";import{EXIT as F}from"@allyhub-next/protocol";import{LONG_WORD_DEFAULTS as se,PARAGRAPH_GAP as re,WORD_SHAPE_DEFAULTS as te,cutReport as oe,longWords as ne,paragraphs as ae,parseEditList as ie,parseScript as de,saidOf as le,scriptDiff as fe,searchWords as ce,takeLevels as he,unheardSounds as we,wordLevels as me,wordShapes as ue}from"@allyhub-next/video-core";import{CommandError as p,defineCommand as M}from"../command.js";import{existingFile as $,fromMedia as pe,media as N,progressLines as P}from"../media.js";import{projectOfFile as R}from"../project.js";import{fresh as ge}from"../fields.js";const D=f.string().optional().describe("The project whose media index keeps the recording's sound (default the nearest above the file, else the current folder's)");import{CONFIDENCE_MEANS as _,cutText as be,hearingText as ye,transcriptText as ve}from"./words-text.js";const H=f.number().nonnegative(),Fe={fps:f.number().positive().default(30).describe("The frame grid cuts are placed on")},I=f.string().describe("The recording: an audio or video file"),$e=f.strictObject({file:I,lang:f.string().optional().describe("The language spoken (en, es, fr, de…); left out, the model tells. On this computer, one of Parakeet's 25 European languages"),fresh:ge.describe("Hear the whole file again and write its words file; with --from and --to, only that stretch, writing nothing"),from:H.optional().describe("Show the words of the file from this second on"),to:H.optional().describe("Show the words of the file up to this second"),search:f.array(f.string()).optional().describe("Where these words or phrases are said (case and punctuation ignored; a phrase's last word may be a prefix), instead of the transcript"),script:f.string().optional().describe("A script to compare with: a script.<locale>.yaml (what its parts say) or a text file; marks words it does not have, {like this}, and lines said more than once"),all:f.boolean().default(!1).describe("Also list what the thresholds leave out: every stretch between words above the noise floor, every word's inside, and every script line"),dir:D}),C=(e,s)=>new p("usage",e,{exit:F.usage,...s===void 0?{}:{hint:s}});function ke(e,s,t){const n=e.flatMap((c,a)=>(s===void 0||c.end>s)&&(t===void 0||c.start<t)?[a]:[]),r=n[0],o=n.at(-1);if(r===void 0||o===void 0)throw new p("no-words",`No word is said between ${(s??0).toFixed(2)} s and ${t===void 0?"the end":`${t.toFixed(2)} s`} of the file.`,{exit:F.notFound});return{from:r,to:o}}const g=(e,s)=>{const t=Y(e,s);return t===""||t.startsWith("..")?s:t};async function O(e){const s=await k(e,"utf8").catch(()=>{});if(s===void 0)return;let t;try{t=JSON.parse(s)}catch(r){return`not JSON: ${r.message}`}const n=K("words",t);return n.ok?n.value.words.map(({confidence:r,...o})=>r===void 0?o:{...o,confidence:r}):n.problems.map(r=>r.path?`${r.path}: ${r.message}`:r.message).join("; ")}async function Ae(e,s){const t=await $(e,s);let n;try{n=JSON.parse(await k(t,"utf8"))}catch(o){throw new p("bad-edits",`${s} is not JSON: ${o.message}`)}const r=ie(n);if(typeof r=="string")throw new p("bad-edits",`${s}: ${r}.`);return r}async function Oe(e,s){const t=await k(await $(e,s),"utf8"),n=c=>c.split(/(?<=[.!?。！？])\s+|\n+/u).map(a=>a.trim()).filter(a=>a!=="");if(!/\.ya?ml$/iu.test(s))return n(t);let r;try{r=X(t)}catch(c){throw new p("bad-script",`${s} is not YAML: ${c.message}`)}const o=de(r);if("problems"in o)throw new p("bad-script",`${s}: ${o.problems[0]??""}`);return o.script.parts.flatMap(c=>{if(c.say===void 0)return[];const a=le(c.say).value;return n(typeof a=="string"?a:"speak"in a?a.speak:Object.values(a.match).join(" "))})}async function je(e,s,t,n,r){const o=await N(()=>Z(s,{from:n,to:r},Q,{cloud:L(t,t.cwd),...e.lang===void 0?{}:{lang:e.lang},onProgress:P(t),signal:t.signal})),c=Math.min(...o.hearings.map(i=>i.heard.from)),a=Math.max(...o.hearings.map(i=>i.heard.to)),l=A(s),h=await O(l),w=Array.isArray(h)?h.map((i,m)=>({i:m,w:i})).filter(({w:i})=>i.end>c&&i.start<a).map(({i,w:m})=>({i,text:m.text,start:m.start,end:m.end,confidence:m.confidence??null,padding:m.end<=n||m.start>=r})):void 0,b={file:s,asked:{from:n,to:r},model:o.model,confidence:o.confidence?{means:_}:{means:null,missing:"The recognizer gave no token probabilities."},hearings:o.hearings,wordsFile:w?{path:l,words:w,text:w.filter(i=>!i.padding).map(i=>i.text).join(" ")}:null};return{value:b,text:ye(b,g(t.cwd,s))}}export const words=M({name:"words",summary:"A recording's words: heard on this computer when it has none (or --fresh), printed by word index with the sounds between them; a stretch by seconds, heard again with --fresh",input:$e,positional:["file"],output:f.looseObject({file:f.string(),wordsFile:f.unknown()}),examples:["allyhub words talk/host.mp4","allyhub words host.mp4 --from 23 --to 25","allyhub words host.mp4 --from 23 --to 25 --fresh",'allyhub words host.mp4 --search "you know,um"']},async(e,s)=>{const t=await $(s.cwd,e.file);try{ee(e.lang)}catch(d){throw pe(d)}const n=e.from!==void 0||e.to!==void 0;if(e.from!==void 0&&e.to!==void 0&&e.to<=e.from)throw C("--to is a second after --from.");if(n&&e.fresh){if(e.from===void 0||e.to===void 0)throw C("A stretch to hear again needs --from and --to, seconds of the file.",`allyhub words ${e.file} --from 23 --to 25 --fresh`);return je(e,t,s,e.from,e.to)}const r=await R(e.file,s.cwd,e.dir);r.warning!==void 0&&s.progress(r.warning);const o=A(t);let c,a=e.fresh?void 0:await O(o);if(typeof a=="string")throw new p("bad-words",`${g(s.cwd,o)} is not a words file: ${a}.`,{hint:"Fix it, or pass --fresh to hear the recording again."});if(a===void 0){const d=await N(()=>B(t,{root:r.root,cloud:L(s,r.root),...e.lang===void 0?{}:{lang:e.lang},onProgress:P(s),signal:s.signal}));a=d.file.words.map(({confidence:y,...u})=>y===void 0?u:{...u,confidence:y}),c={tightened:d.tightened,model:d.file.model}}const l=a,h=await x(t,r.root,{signal:s.signal}),{from:w,to:b}=n?ke(l,e.from,e.to):{from:0,to:Math.max(0,l.length-1)},i=h&&l.length>0?we(l,h,{all:e.all}):void 0,m=d=>d.after>=w-1&&d.after<=b,J=h?me(l,h):void 0,v=h?ue(l,h):void 0,j=(v?.words??[]).filter(d=>d.i>=w&&d.i<=b),z=ne(j),S=e.script===void 0?void 0:await Oe(s.cwd,e.script),E=S?fe(l,S):void 0,W=l.filter(d=>d.confidence===void 0).length,G=g(s.cwd,o),T={file:t,wordsFile:G,project:r.root,...c?{made:c}:{},count:l.length,duration:h?Math.round(h.db.length*h.hop*100)/100:l.at(-1)?.end??0,levels:h?{...he(h),...i?{words:i.speech,soundFloor:i.floor}:{}}:null,...i?{soundOptions:i.options}:{},range:{from:w,to:b},words:l.slice(w,b+1).map((d,y)=>{const u=v?.words[w+y];return{i:w+y,text:d.text,start:d.start,end:d.end,confidence:d.confidence??null,...J?.[w+y]??{},...u?{letters:u.letters,expected:u.expected,ratio:u.ratio,excess:u.excess,voicedRuns:u.voicedRuns,dips:u.dips}:{}}}),rate:v?.rate??null,...v?.rateWhy===void 0?{}:{rateWhy:v.rateWhy},long:z.map(d=>d.i),longOptions:{...se,dip:te.dip},confidence:{means:W<l.length||l.length===0?_:null,missing:W},paragraphs:ae(l,re,w,b),sounds:i?.sounds.filter(m)??[],...e.all&&i?.stretches?{stretches:i.stretches.filter(m)}:{},...e.search?{matches:e.search.map(d=>({phrase:d,at:ce(l,d)}))}:{},...E?{script:E}:{}},U=ve(T,{file:g(s.cwd,t),words:l,frames:h!==void 0,shapes:j,all:e.all});return{value:T,text:U}});const Se=f.strictObject({file:I,edits:f.string().describe("The edits file: the cut list (words, sounds, stretches inside words, pauses) to report on"),dir:D,params:V(Fe)});export const wordsEdits=M({name:"words edits",summary:"What a cut list keeps of a recording: the stretches kept, every word and sound removed, the room tone at its ends, and every join measured on both sides",input:Se,positional:["file","edits"],output:f.looseObject({file:f.string(),wordsFile:f.string(),cut:f.unknown()}),examples:["allyhub words edits talk/host.mp4 talk/edits/host.json","allyhub words edits host.mp4 edits.json --param fps=25"]},async(e,s)=>{const t=await $(s.cwd,e.file),n=await R(e.file,s.cwd,e.dir);n.warning!==void 0&&s.progress(n.warning);const r=A(t),o=await O(r);if(o===void 0)throw new p("no-words",`${g(s.cwd,t)} has no words file yet.`,{exit:F.notFound,hint:`allyhub words ${e.file} hears its words and writes ${g(s.cwd,r)}.`});if(typeof o=="string")throw new p("bad-words",`${g(s.cwd,r)} is not a words file: ${o}.`,{hint:"Fix it, or hear the recording again: allyhub words --fresh."});if(o.length===0)throw new p("no-words",`${g(s.cwd,r)} has no words: there is nothing to cut.`,{exit:F.notFound});const c=await Ae(s.cwd,e.edits),a=await x(t,n.root,{signal:s.signal}),l=oe(o,c,a,{fps:e.params.fps,...a?{duration:a.db.length*a.hop}:{}});return{value:{file:t,wordsFile:g(s.cwd,r),edits:g(s.cwd,q(s.cwd,e.edits)),project:n.root,count:o.length,cut:l},text:be(l,o)}});

package/dist/lent/model-three.d.ts

@@ -1,2 +1,2 @@
 // The types of @allyhub-next/model/three, which allyhub's build lends a project by that name.
-export * from "../../node_modules/@allyhub-next/model/dist/three.js";
+export * from "../node_modules/@allyhub-next/model/dist/three.js";

package/dist/lent/model.d.ts

@@ -1,2 +1,2 @@
 // The types of @allyhub-next/model, which allyhub's build lends a project by that name.
-export * from "../../node_modules/@allyhub-next/model/dist/index.js";
+export * from "../node_modules/@allyhub-next/model/dist/index.js";

package/dist/lent/scenery-host-layer.d.ts

@@ -1,2 +1,2 @@
 // The types of @allyhub-next/scenery-host/layer, which allyhub's build lends a project by that name.
-export * from "../../node_modules/@allyhub-next/scenery-host/dist/layer/index.js";
+export * from "../node_modules/@allyhub-next/scenery-host/dist/layer/index.js";

package/dist/main.js

@@ -1,8 +1,8 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{EXIT as m,describeCommand as O}from"@allyhub-next/protocol";import{readArgs as D}from"./args.js";import{CLI_VERSION as S}from"./cli-version.js";import{CommandError as h}from"./command.js";import{COMMAND_SOURCES as M,COMMANDS as N}from"./commands/index.js";import{commandHelp as E,listHelp as T,workHelp as H}from"./help.js";import{sdkDocs as R}from"./sdk-docs.js";import{WORKS as G,cloudNouns as J,workNamed as W,workTitle as j}from"./works.js";const _={stdout:e=>process.stdout.write(e),stderr:e=>process.stderr.write(e),cwd:process.cwd(),env:process.env};export function findCommand(e,s=N){let i;for(const c of s){const l=c.spec.name.split(" ");l.every((o,a)=>e[a]===o)&&l.length>(i?.length??0)&&(i={command:c,length:l.length})}return i?{command:i.command,rest:e.slice(i.length)}:{rest:[...e]}}export async function resolveCommand(e,s,i=N,c=M){const l=findCommand(e,i);if(l.command)return l;for(const o of c){const a=await o.resolve(e,s);if(a)return a}return l}const A=e=>({...O(e.spec),...e.about?.value});export async function main(e,s=_,i=N,c=M){const l=e.includes("--json"),o=e.filter(n=>n!=="--json"),a=(n,t)=>{s.stdout(l?`${JSON.stringify(n,null,2)}
+import{EXIT as m,describeCommand as M}from"@allyhub-next/protocol";import{readArgs as T}from"./args.js";import{CLI_VERSION as N}from"./cli-version.js";import{CommandError as w}from"./command.js";import{COMMAND_SOURCES as E,COMMANDS as C}from"./commands/index.js";import{commandHelp as j,listHelp as H,workHelp as R}from"./help.js";import{sdkDocs as W}from"./sdk-docs.js";import{WORKS as G,cloudNouns as J,workNamed as _,workTitle as A}from"./works.js";const K={stdout:e=>process.stdout.write(e),stderr:e=>process.stderr.write(e),cwd:process.cwd(),env:process.env};export function findCommand(e,s=C){let i;for(const c of s){const l=c.spec.name.split(" ");l.every((o,a)=>e[a]===o)&&l.length>(i?.length??0)&&(i={command:c,length:l.length})}return i?{command:i.command,rest:e.slice(i.length)}:{rest:[...e]}}export async function resolveCommand(e,s,i=C,c=E){const l=findCommand(e,i);if(l.command)return l;for(const o of c){const a=await o.resolve(e,s);if(a)return a}return l}const D=e=>({...M(e.spec),...e.about?.value});export async function main(e,s=K,i=C,c=E){const l=e.includes("--json"),o=e.filter(n=>n!=="--json"),a=(n,t)=>{s.stdout(l?`${JSON.stringify(n,null,2)}
 `:`${t}
-`)},b=i.map(n=>n.spec),v=new AbortController,y={cwd:s.cwd,env:s.env,progress:n=>{s.stderr(`${n}
-`)},signal:v.signal};if(o[0]==="--version"||o[0]==="-v")return a({version:S},S),m.ok;if(o.length===0||o[0]==="help"||o[0]==="--help"||o[0]==="-h"){const n=o.slice(1),t=await R(s.cwd).catch(()=>{}),k=async()=>{const r=await Promise.all(c.map(u=>u.nouns(y).catch(()=>{})));return r.some(u=>u===void 0)?void 0:r.flatMap(u=>u??[])};if(n.length===0){const r=await k();return a({version:S,docs:t?.dir,works:G.map(u=>({...u,title:j(u,r)})),commands:b.map(O),made:[...c.flatMap(u=>u.entries),...r??[]]},T(b,c,r,t?.dir)),m.ok}const d=n.length===1?W(n[0]??""):void 0;if(d){const r=d.cloud===void 0?[]:await k();return a({...d,title:j(d,r),...d.cloud===void 0?{}:{cloudWorks:r&&J(d,r)},docsDir:t?.dir},H(d,b,c,t?.dir,r)),m.ok}let p;try{p=await resolveCommand(n,y,i,c)}catch(r){return g(r)}const{command:f,rest:I}=p;return f&&p.list===!0?await $(f,I):!f||I.length>0?g(new h("unknown-command",`allyhub has no command "${n.join(" ")}".`,{exit:m.usage,hint:"allyhub help lists them and the works."})):(a(A(f),E(f.spec,f.about?.lines)),m.ok)}let C;try{C=await resolveCommand(o,y,i,c)}catch(n){return g(n)}const{command:w,rest:x}=C;if(!w)return g(new h("unknown-command",`allyhub has no command "${o[0]??""}".`,{exit:m.usage,hint:"allyhub help lists them."}));if(x.includes("--help")||x.includes("-h"))return a(A(w),E(w.spec,w.about?.lines)),m.ok;return await $(w,x);async function $(n,t){const k=()=>{v.abort(new h("interrupted","Stopped.",{exit:m.interrupted}))};process.once("SIGINT",k);try{const d=D(n.spec,t),p=await n.run(d,y);return a(p.value,p.text),p.exit??m.ok}catch(d){return g(d)}finally{process.off("SIGINT",k)}}function g(n){const t=n instanceof h?n:v.signal.aborted?new h("interrupted","Stopped.",{exit:m.interrupted}):new h("failed",n instanceof Error?n.message:String(n));return l?s.stdout(`${JSON.stringify({error:{code:t.code,message:t.message,...t.hint?{hint:t.hint}:{}}},null,2)}
+`)},b=i.map(n=>n.spec),x=new AbortController,y={cwd:s.cwd,env:s.env,progress:n=>{s.stderr(`${n}
+`)},signal:x.signal};if(o[0]==="--version"||o[0]==="-v")return a({version:N},N),m.ok;if(o.length===0||o[0]==="help"||o[0]==="--help"||o[0]==="-h"){const n=o.slice(1).findIndex(r=>r.startsWith("-")),t=n<0?o.slice(1):o.slice(1,n+1),f=await W(s.cwd).catch(()=>{}),p=async()=>{const r=await Promise.all(c.map(u=>u.nouns(y).catch(()=>{})));return r.some(u=>u===void 0)?void 0:r.flatMap(u=>u??[])};if(t.length===0){const r=await p();return a({version:N,docs:f?.dir,works:G.map(u=>({...u,title:A(u,r)})),commands:b.map(M),made:[...c.flatMap(u=>u.entries),...r??[]]},H(b,c,r,f?.dir)),m.ok}const d=t.length===1?_(t[0]??""):void 0;if(d){const r=d.cloud===void 0?[]:await p();return a({...d,title:A(d,r),...d.cloud===void 0?{}:{cloudWorks:r&&J(d,r)},docsDir:f?.dir},R(d,b,c,f?.dir,r)),m.ok}let S;try{S=await resolveCommand(t,y,i,c)}catch(r){return k(r)}const{command:h,rest:O}=S;return h&&S.list===!0?await $(h,O):!h||O.length>0?k(new w("unknown-command",`allyhub has no command "${t.join(" ")}".`,{exit:m.usage,hint:"allyhub help lists them and the works."})):(a(D(h),j(h.spec,h.about?.lines)),m.ok)}let I;try{I=await resolveCommand(o,y,i,c)}catch(n){return k(n)}const{command:g,rest:v}=I;if(!g)return k(new w("unknown-command",`allyhub has no command "${o[0]??""}".`,{exit:m.usage,hint:"allyhub help lists them."}));if(v.includes("--help")||v.includes("-h"))return a(D(g),j(g.spec,g.about?.lines)),m.ok;return await $(g,v);async function $(n,t){const f=()=>{x.abort(new w("interrupted","Stopped.",{exit:m.interrupted}))};process.once("SIGINT",f);try{const p=T(n.spec,t),d=await n.run(p,y);return a(d.value,d.text),d.exit??m.ok}catch(p){return k(p)}finally{process.off("SIGINT",f)}}function k(n){const t=n instanceof w?n:x.signal.aborted?new w("interrupted","Stopped.",{exit:m.interrupted}):new w("failed",n instanceof Error?n.message:String(n));return l?s.stdout(`${JSON.stringify({error:{code:t.code,message:t.message,...t.hint?{hint:t.hint}:{}}},null,2)}
 `):s.stderr(`${t.message}${t.hint?`
 ${t.hint}`:""}
 `),t.exit}}

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

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

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

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub-next/browser",
+  "version": "0.5.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/build/dist/content.d.ts

@@ -0,0 +1,45 @@
+import { type Item } from "@allyhub-next/formats";
+import { type GeneratedSheets } from "@allyhub-next/sheet";
+import { type DataFile, type Problem } from "@allyhub-next/video-core";
+import type { MetaLoader } from "./meta.js";
+export interface DocInfo {
+    /** Its folder: launch/plan. */
+    dir: string;
+    /** Its place, the same: launch/plan. */
+    place: string;
+    file: string;
+    /** The first-level heading it opens with. */
+    title?: string;
+    /** The first paragraph under it, as plain text, for a glimpse in a list. */
+    glimpse?: string;
+}
+export interface SheetInfo {
+    dir: string;
+    place: string;
+    file: string;
+    /** What sheet.yaml calls it. */
+    title?: string;
+    /** Its sheets' names. */
+    sheets: string[];
+    /** Its tables' names, each with how many rows it has. */
+    tables: {
+        name: string;
+        rows: number;
+    }[];
+    /** sheet.yaml and the CSV files it names that are there. */
+    files: string[];
+    /** What its sheet.ts makes. */
+    generated?: GeneratedSheets;
+    /** It has a sheet.ts that did not run: what the sheet holds is not all of it. */
+    codeFailed?: true;
+}
+export declare function readDocs(root: string, items: readonly Item[], files: readonly string[]): Promise<{
+    docs: DocInfo[];
+    problems: Problem[];
+}>;
+export declare function readSheets(root: string, items: readonly Item[], meta?: MetaLoader): Promise<{
+    sheets: SheetInfo[];
+    problems: Problem[];
+    data: Record<string, DataFile>;
+}>;
+//# sourceMappingURL=content.d.ts.map

package/dist/node_modules/@allyhub-next/build/dist/content.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as O}from"node:fs/promises";import{join as T,posix as b}from"node:path";import{hasText as D,parseDoc as M,shownBlocks as R,splitTitle as v,titleText as A}from"@allyhub-next/doc";import{createHash as y}from"node:crypto";import{SHEET_CODE as x}from"@allyhub-next/formats";import{GENERATED as z,checkWorkbook as F,seededRandom as K,tableRows as N}from"@allyhub-next/sheet";import{problem as k}from"@allyhub-next/video-core";import{readSheetSource as B,workbookFiles as C}from"./sheet-code.js";const E=180,G=/^([a-z][a-z0-9+.-]*:|\/\/)/iu,S=s=>s;function H(s){for(const i of s){if(i.type!=="paragraph")continue;const r=i.content.map(a=>a.text).join("").replace(/\s+/gu," ").trim();if(r!=="")return r.length>E?`${r.slice(0,E-1)}…`:r}}function*j(s){for(const i of s)yield i,D(i)&&i.children&&(yield*j(i.children))}export async function readDocs(s,i,r){const a=[],l=[],f=new Set(r);for(const e of i){if(e.kind!=="doc")continue;const o=e.entry,n=M(await O(T(s,o),"utf8"));for(const c of n.problems)l.push(k("AK-M008",`${o}: ${c.message}.`,{where:{file:o,...c.line===void 0?{}:{line:c.line}}}));const m=v(R(n.blocks)),d=A(m.title).trim()||void 0,p=H(m.body);for(const c of j(n.blocks)){if(c.type!=="image"||G.test(c.src))continue;const u=b.normalize(b.join(e.dir,decodeURIComponent(c.src)));f.has(u)||l.push(k("AK-M008",`${o} shows the picture ${c.src}, which is not in the project (${u}).`,{where:{file:o}}))}a.push({dir:e.dir,place:S(e.dir),file:o,...d?{title:d}:{},...p?{glimpse:p}:{}})}return{docs:a,problems:l}}function I(s,i,r,a,l){const f={};for(const e of r.tables){const o=N(a,e),n=y("sha256").update(l).update(JSON.stringify(o)).digest("hex");f[`${s}#${e.name}`]={sha256:n,value:o},f[`${i}#${e.name}`]={sha256:n,value:o}}return f}export async function readSheets(s,i,r){const a=[],l=[];let f={};for(const e of i){if(e.kind!=="sheet")continue;const o=e.entry,n=await B(s,e.dir,r?{meta:r}:{}).catch(()=>{});if(!n)continue;l.push(...n.problems);const{csv:m,generated:d}=n,p=y("sha256").update(n.text);for(const t of m.values())p.update(t);d&&p.update(JSON.stringify(d));const c=p.digest("hex"),u=F(C(s,n),{random:K(c)});for(const t of u.problems){const $=b.join(e.dir,t.file.startsWith(z)?x:t.file);l.push(k("AK-M009",`${$}${t.line===void 0?"":`:${String(t.line)}`}: ${t.message}.`,{where:{file:$,...t.line===void 0?{}:{line:t.line}}}))}const{workbook:h,calc:w}=u,g=h?.title?.trim();a.push({dir:e.dir,place:S(e.dir),file:o,...g?{title:g}:{},sheets:h?.sheets.map(t=>t.name)??[],tables:h?.tables.map(t=>({name:t.name,rows:t.rows}))??[],files:[o,...[...m.keys()].map(t=>b.join(e.dir,t)),...d||n.failed?[b.join(e.dir,x)]:[]],...d?{generated:d}:{},...n.failed?{codeFailed:!0}:{}}),h&&w&&(f={...f,...I(e.dir,o,h,w,c)})}return{sheets:a,problems:l,data:f}}

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

@@ -0,0 +1,13 @@
+import type { DataFile } from "@allyhub-next/video-core";
+/** One object per row, keyed by the header; a column whose every value is a number becomes numbers. */
+export declare function parseCsv(text: string): Record<string, string | number>[];
+/** Whether a project path is the project's data; not the shared words in `text`, not a workbook. */
+export declare function isDataFile(path: string, text?: string): boolean;
+/** A sheet's table's computed rows, by <sheet>#<table> from the project's root, for code that runs before the project is read. */
+export declare function readTable(root: string, at: string): unknown;
+/** Larger data files are not read by ctx.data: imported instead. */
+export declare const MAX_DATA_BYTES: number;
+export declare function parseData(path: string, text: string): unknown;
+/** Every data file, parsed; one that does not parse keeps its error, reported when a piece reads it. */
+export declare function readData(root: string, files: readonly string[], text?: string): Promise<Record<string, DataFile>>;
+//# sourceMappingURL=data.d.ts.map

package/dist/node_modules/@allyhub-next/build/dist/data.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{createHash as w}from"node:crypto";import{readFileSync as l}from"node:fs";import{readFile as h}from"node:fs/promises";import{join as m}from"node:path";import{parse as y}from"yaml";import{SHEET_FILE as u,TEXT_DIR as p,baseOf as d,within as b}from"@allyhub-next/formats";import{Calc as g,csvRows as T,readWorkbook as j,tableRows as k}from"@allyhub-next/sheet";const v=/^-?(\d+\.?\d*|\.\d+)(e[+-]?\d+)?$/iu;export function parseCsv(t){const[r,...s]=T(t);if(!r)return[];const a=r.map(e=>e.trim()),n=a.map((e,o)=>s.every(i=>{const c=(i[o]??"").trim();return c===""||v.test(c)})&&s.some(i=>(i[o]??"").trim()!==""));return s.map(e=>{const o={};return a.forEach((i,c)=>{const f=(e[c]??"").trim();o[i]=n[c]&&f!==""?Number(f):f}),o})}const E=/\.(csv|ya?ml|json)$/iu,A=/(^|\/)(package(-lock)?\.json|tsconfig(\.[\w-]+)?\.json|jsconfig\.json|pnpm-(lock|workspace)\.yaml|[^/]+\.(words|elements|gen)\.json|script\.[\w-]+\.ya?ml|slides\.yaml|comments\.json)$/u;export function isDataFile(t,r=p){return E.test(t)&&!A.test(t)&&d(t)!==u&&!b(t,r)}export function readTable(t,r){const[s="",a=""]=r.split("#"),n=m(t,d(s)===u?s.slice(0,-u.length):s),{workbook:e}=j({text:l(m(n,u),"utf8"),read:i=>{try{return l(m(n,i),"utf8")}catch{return}}}),o=e?.table(a);if(!e||!o)throw new Error(`${r} is not a table of a sheet.`);return k(new g(e).calculate(),o)}export const MAX_DATA_BYTES=5*1024*1024;export function parseData(t,r){return/\.csv$/iu.test(t)?parseCsv(r):/\.ya?ml$/iu.test(t)?y(r)??null:JSON.parse(r)}export async function readData(t,r,s=p){const a={};for(const n of r){if(!isDataFile(n,s))continue;const e=await h(m(t,n)).catch(()=>{});if(!e)continue;const o=w("sha256").update(e).digest("hex");if(e.byteLength>MAX_DATA_BYTES){a[n]={sha256:o,error:`larger than ${String(MAX_DATA_BYTES/1024/1024)} MB; import it instead`};continue}try{a[n]={sha256:o,value:parseData(n,e.toString("utf8"))}}catch(i){a[n]={sha256:o,error:i.message.split(`
+`)[0]??""}}}return a}

package/dist/node_modules/@allyhub-next/build/dist/files.d.ts

@@ -0,0 +1,4 @@
+export declare function listFiles(root: string): Promise<string[]>;
+/** The packages a project's package.json declares. */
+export declare function dependenciesOf(root: string): Promise<Set<string>>;
+//# sourceMappingURL=files.d.ts.map

package/dist/node_modules/@allyhub-next/build/dist/files.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readdir as m,readFile as p}from"node:fs/promises";import{join as l}from"node:path";import d from"ignore";import{ITEM_KINDS as w,PACKAGE_FILE as g,unscanned as y}from"@allyhub-next/formats";const E=w.website.entries;export async function listFiles(i){const t=[],o=async(e,c)=>{const u=await m(l(i,e),{withFileTypes:!0}).catch(()=>[]),a=await p(l(i,e,".gitignore"),"utf8").then(n=>[...c,{dir:e,rules:d().add(n)}],()=>c),f=e===""?void 0:u.find(n=>n.isFile()&&E.includes(n.name));if(f){t.push(`${e}/${f.name}`);return}for(const n of u.sort((s,r)=>s.name<r.name?-1:s.name>r.name?1:0)){const s=e===""?n.name:`${e}/${n.name}`;if(y(s))continue;const r=n.isDirectory();!r&&!n.isFile()||h(a,s,r)||(r?await o(s,a):t.push(s))}};return await o("",[]),t.sort()}function h(i,t,o){let e=!1;for(const{dir:c,rules:u}of i){const a=c===""?t:t.slice(c.length+1),f=u.test(o?`${a}/`:a);f.ignored?e=!0:f.unignored&&(e=!1)}return e}export async function dependenciesOf(i){try{const t=JSON.parse(await p(l(i,g),"utf8"));return new Set(["dependencies","devDependencies","peerDependencies","optionalDependencies"].flatMap(o=>Object.keys(t[o]??{})))}catch{return new Set}}

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

@@ -0,0 +1,21 @@
+export { dependenciesOf, listFiles } from "./files.js";
+export { hasSheetCode, readSheetSource, runSheetCode, sheetRoot, workbookFiles, type SheetSource, } from "./sheet-code.js";
+export { moveEdits, movedPath, referencesOf, referringFiles, } from "./move-refs.js";
+export { bundleForStage, compileErrorOf, createModuleLoader, createStageDevServer, loadUserVite, type CompileError, type Handler, type Inline, type ModuleLoader, type Plugin, type StageBundle, type StageChunk, type StageDevServer, type UserVite, } from "./vite.js";
+export { placeFinder, type PlaceFinder, type PlaceOptions, type SourcePlace, } from "./places.js";
+export { mergeScripts, readMessages, type ProjectMessages, type ScriptInfo, type ScriptSource, } from "./messages.js";
+export { MAX_DATA_BYTES, isDataFile, parseCsv, parseData, readData, readTable, } from "./data.js";
+export { readDocs, readSheets, type DocInfo, type SheetInfo, } from "./content.js";
+export { readMedia, type MediaOptions, type MediaTable } from "./media.js";
+export { modelInfo } from "./model-info.js";
+export { makeWords, takeVoice, type MadeWords, type MakeWordsOptions, type TakeVoice, } from "./takes.js";
+export { resolveMatrix, type ResolvedMatrix } from "./matrix.js";
+export { FONTS_MODULE, fontStyles, fontsDigest, fontsModule } from "./fonts.js";
+export { LENT, SDK, SDK_ENTRIES, checkImports, discover, lineAt, packageName, parse, walk, type Discovered, type Node, type Parsed, } from "./scan.js";
+export { allyhubPlugin, boundSdk, lentSdk, type PluginOptions, } from "./plugin.js";
+export { MetaLoader, type MetaResult } from "./meta.js";
+export type { WorkerInit as MetaInit } from "./meta-worker.js";
+export { MESSAGE_TYPES, messageTypes, writeMessageTypes } from "./types.js";
+export { prepare, sourceOf, type PieceInfo, type Prepared, type PrepareOptions, } from "./prepare.js";
+export { codeOf, type PieceCode } from "./code.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{dependenciesOf,listFiles}from"./files.js";export{hasSheetCode,readSheetSource,runSheetCode,sheetRoot,workbookFiles}from"./sheet-code.js";export{moveEdits,movedPath,referencesOf,referringFiles}from"./move-refs.js";export{bundleForStage,compileErrorOf,createModuleLoader,createStageDevServer,loadUserVite}from"./vite.js";export{placeFinder}from"./places.js";export{mergeScripts,readMessages}from"./messages.js";export{MAX_DATA_BYTES,isDataFile,parseCsv,parseData,readData,readTable}from"./data.js";export{readDocs,readSheets}from"./content.js";export{readMedia}from"./media.js";export{modelInfo}from"./model-info.js";export{makeWords,takeVoice}from"./takes.js";export{resolveMatrix}from"./matrix.js";export{FONTS_MODULE,fontStyles,fontsDigest,fontsModule}from"./fonts.js";export{LENT,SDK,SDK_ENTRIES,checkImports,discover,lineAt,packageName,parse,walk}from"./scan.js";export{allyhubPlugin,boundSdk,lentSdk}from"./plugin.js";export{MetaLoader}from"./meta.js";export{MESSAGE_TYPES,messageTypes,writeMessageTypes}from"./types.js";export{prepare,sourceOf}from"./prepare.js";export{codeOf}from"./code.js";

package/dist/node_modules/@allyhub-next/build/dist/meta-worker.d.ts

@@ -0,0 +1,49 @@
+import { type SlidesFile } from "@allyhub-next/formats";
+import { type MediaInfo, type Problem } from "@allyhub-next/video-core";
+export interface WorkerInit {
+    root: string;
+    /** Read the project's vite.config.ts (here: its plugins cannot cross threads). */
+    user?: boolean;
+    media: Record<string, MediaInfo>;
+    dependencies: string[];
+    /** Packages a host lends, by name, with a file each resolves from (PluginOptions.lent). */
+    lent?: Record<string, string>;
+}
+export type WorkerRequest = {
+    id: number;
+    type: "piece";
+    file: string;
+} | {
+    id: number;
+    type: "deck";
+    file: string;
+    /** Its slides.yaml as read; none when it has none or it is not the format. */
+    slides: SlidesFile | undefined;
+    /** The default language's messages, by key: the script's words. */
+    words: Record<string, unknown>;
+    prefix: string;
+    /** The project's sheets' tables as they compute, by <sheet>#<table>. */
+    tables: Record<string, unknown>;
+} | {
+    id: number;
+    type: "sheet";
+    file: string;
+} | {
+    id: number;
+    type: "components";
+    file: string;
+} | {
+    id: number;
+    type: "config";
+    file: string;
+};
+export interface WorkerResponse {
+    id: number;
+    ok: boolean;
+    value?: unknown;
+    error?: string;
+    /** The error's stack: where in the project it was thrown. */
+    stack?: string;
+    problems: Problem[];
+}
+//# sourceMappingURL=meta-worker.d.ts.map