allyhub 0.7.0 → 0.8.0

package/dist/sdk-docs.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{readFile as s}from"node:fs/promises";import{createRequire as a}from"node:module";import{dirname as f,join as t}from"node:path";import{lentSdk as u,SDK as c}from"@allyhub-next/build";import{PACKAGE_FILE as d}from"@allyhub-next/formats";import{projectRoot as m}from"./project.js";async function p(n){const e=await s(t(n,d),"utf8").catch(()=>{});if(e===void 0)return!1;try{const r=JSON.parse(e);return["dependencies","devDependencies"].some(o=>{const i=r[o];return typeof i=="object"&&i!==null&&c in i})}catch{return!1}}export async function sdkDocs(n){const e=await m(n);try{const o=a(t(e,d));return{dir:t(f(o.resolve(`${c}/package.json`)),"docs"),from:"installed"}}catch{}if(await p(e))return;const r=u();return r===void 0?void 0:{dir:t(r,"docs"),from:"lent"}}
+import{readFile as s}from"node:fs/promises";import{createRequire as a}from"node:module";import{dirname as f,join as t}from"node:path";import{lentSdk as u,SDK as c}from"@allyhub/build";import{PACKAGE_FILE as d}from"@allyhub/formats";import{projectRoot as m}from"./project.js";async function p(n){const e=await s(t(n,d),"utf8").catch(()=>{});if(e===void 0)return!1;try{const r=JSON.parse(e);return["dependencies","devDependencies"].some(o=>{const i=r[o];return typeof i=="object"&&i!==null&&c in i})}catch{return!1}}export async function sdkDocs(n){const e=await m(n);try{const o=a(t(e,d));return{dir:t(f(o.resolve(`${c}/package.json`)),"docs"),from:"installed"}}catch{}if(await p(e))return;const r=u();return r===void 0?void 0:{dir:t(r,"docs"),from:"lent"}}

package/dist/text/batch-text.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{ruleText as f}from"@allyhub-next/video-core";import{plural as a}from"./plural.js";export function formatBatches(u){const o=[];for(const e of u){const i=Object.keys(e.structures).length;o.push(`${e.piece} · ${a(e.slots.length,"slot")}, ${a(i,"structure")} · ${String(e.total)} slot combinations, ${e.valid===void 0?"not counted against the rules":`${String(e.valid)} allowed by the rules`}, ${String(new Set(e.combos.map(t=>t.pick)).size)} ${e.choice==="combos"?"named in matrix.combos":`chosen${e.seed===void 0?"":` (seed ${String(e.seed)})`}`}`);for(const t of e.slots){const n=t.candidates.some(s=>s.file!==void 0);o.push(`  ${t.name}: ${t.candidates.map(s=>[s.name,...s.tags.map(h=>`#${h}`)].join(" ")).join(", ")}${n?" (pool)":""}`)}if(i>1)for(const[t,n]of Object.entries(e.structures))o.push(`  structure ${t}: ${n.join(" → ")}`);for(const t of e.rules)o.push(`  rule: ${f(t)}`);const c=t=>[...t.structure===void 0?[]:[`[${t.structure}]`],...Object.entries(t.picks).map(([n,s])=>`${n}=${s}`)].join(" "),p=Math.max(...e.combos.map(t=>t.id.length),3),$=Math.max(...e.combos.map(t=>c(t).length),10);for(const t of e.combos)o.push(`  ${t.id.padEnd(p)}  ${c(t).padEnd($)}  ${t.why.join("; ")}`);const{ads:l,format:m,whole:d,parts:r}=e.cost;o.push(`  Render: ${a(l,"ad")} (${m}): ${String(d)} slot parts if each ad rendered whole; ${String(r)} distinct part renders with the part cache${r>0?` (${(d/r).toFixed(1)}× fewer)`:""}, then a join and a sound mix per ad.`)}return o}
+import{ruleText as f}from"@allyhub/video-core";import{plural as a}from"./plural.js";export function formatBatches(u){const o=[];for(const e of u){const i=Object.keys(e.structures).length;o.push(`${e.piece} · ${a(e.slots.length,"slot")}, ${a(i,"structure")} · ${String(e.total)} slot combinations, ${e.valid===void 0?"not counted against the rules":`${String(e.valid)} allowed by the rules`}, ${String(new Set(e.combos.map(t=>t.pick)).size)} ${e.choice==="combos"?"named in matrix.combos":`chosen${e.seed===void 0?"":` (seed ${String(e.seed)})`}`}`);for(const t of e.slots){const n=t.candidates.some(s=>s.file!==void 0);o.push(`  ${t.name}: ${t.candidates.map(s=>[s.name,...s.tags.map(h=>`#${h}`)].join(" ")).join(", ")}${n?" (pool)":""}`)}if(i>1)for(const[t,n]of Object.entries(e.structures))o.push(`  structure ${t}: ${n.join(" → ")}`);for(const t of e.rules)o.push(`  rule: ${f(t)}`);const c=t=>[...t.structure===void 0?[]:[`[${t.structure}]`],...Object.entries(t.picks).map(([n,s])=>`${n}=${s}`)].join(" "),p=Math.max(...e.combos.map(t=>t.id.length),3),$=Math.max(...e.combos.map(t=>c(t).length),10);for(const t of e.combos)o.push(`  ${t.id.padEnd(p)}  ${c(t).padEnd($)}  ${t.why.join("; ")}`);const{ads:l,format:m,whole:d,parts:r}=e.cost;o.push(`  Render: ${a(l,"ad")} (${m}): ${String(d)} slot parts if each ad rendered whole; ${String(r)} distinct part renders with the part cache${r>0?` (${(d/r).toFixed(1)}× fewer)`:""}, then a join and a sound mix per ad.`)}return o}

package/dist/text/console-text.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{CONSOLE_LIMIT as p,comboKey as u}from"@allyhub-next/video-core";const l=n=>n.toFixed(2);export function consolePlace(n){return n.t===void 0?n.phase:`${n.phase} t=${l(n.t)}${n.until===void 0?"":`–${l(n.until)}`}`}export function formatConsole(n){const t=n.console,o=n.consoleDropped??0;if(t.length===0&&o===0)return[];const c=t.reduce((e,i)=>e+i.count,0)+o,r=[`Printed by piece code (console), ${String(t.length)} message${t.length===1?"":"s"} from ${String(c)} call${c===1?"":"s"}; t is the part's time, as render(t) gets it:`];for(const e of t){const i=[e.piece,u(e.combo),e.format,e.part,e.layer===void 0?void 0:`${e.layer}${e.index===void 0?"":` (layers[${String(e.index)}])`}`,consolePlace(e)].filter(s=>s!==void 0&&s!=="").join(" · "),d=e.count>1?` (×${String(e.count)})`:"",[a="",...f]=e.text.split(`
+import{CONSOLE_LIMIT as p,comboKey as u}from"@allyhub/video-core";const l=n=>n.toFixed(2);export function consolePlace(n){return n.t===void 0?n.phase:`${n.phase} t=${l(n.t)}${n.until===void 0?"":`–${l(n.until)}`}`}export function formatConsole(n){const t=n.console,o=n.consoleDropped??0;if(t.length===0&&o===0)return[];const c=t.reduce((e,i)=>e+i.count,0)+o,r=[`Printed by piece code (console), ${String(t.length)} message${t.length===1?"":"s"} from ${String(c)} call${c===1?"":"s"}; t is the part's time, as render(t) gets it:`];for(const e of t){const i=[e.piece,u(e.combo),e.format,e.part,e.layer===void 0?void 0:`${e.layer}${e.index===void 0?"":` (layers[${String(e.index)}])`}`,consolePlace(e)].filter(s=>s!==void 0&&s!=="").join(" · "),d=e.count>1?` (×${String(e.count)})`:"",[a="",...f]=e.text.split(`
 `);r.push(`  ${e.level} [${i}]${d} ${a}`,...f.map(s=>`      ${s}`))}return o>0&&r.push(`  ${String(o)} more call${o===1?"":"s"} not kept: at most ${String(n.consoleLimit??p)} different messages are kept per version (--console <n> or --console all keeps more).`),r}

package/dist/text/facts-text.js

@@ -1,5 +1,5 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{FACT_KINDS as T,comboKey as H}from"@allyhub-next/video-core";import{plural as u}from"./plural.js";const j=s=>`"${s.length>40?`${s.slice(0,40)}…`:s}"`,p=s=>`[${s.join(",")}]`,m=s=>`${String(Math.round(s*100))}%`,b=s=>`${(s*100).toFixed(1)}%`,k=s=>`${String(Math.round(s*1e4)/100)}%`,$=s=>s.toFixed(2),y=s=>`${s.layer}${s.z==="behind-person"?" (behind)":s.z==="overlay"?" (overlay)":""} ${j(s.text)} ${p(s.box)}${s.opacity===void 0?"":` at ${m(s.opacity)} opacity`}`,O=s=>y({...s,box:s.ink??s.box});function U(s){return s.output===void 0?s.piece:[s.piece,s.combo?H(s.combo):void 0,s.format].filter(e=>e!==void 0&&e!=="").join(" · ")}function z(s,e,t){const n=F(s,e.start),a=s.t===void 0?0:s.t-e.start;return{line:`${e.layer} ${n(e.start)}–${n(e.end)} s: ${t}`,alike:{what:`${e.layer}: ${t}`,span:[e.start+a,e.end+a]}}}const v=s=>`${s.sheet===void 0?"":`${s.sheet}!`}${s.cell??""}`;function J(s){switch(s.kind){case"sheet-error":{const e=s.data;return{key:`${e.sheet}!${e.cell}`,value:e.origin?1:0,line:`${v(e)} ${e.code}${e.formula===void 0?"":` ${e.formula}`}${e.origin?", starts here":", read from another"}`}}case"sheet-number":{const e=s.data;return{key:`${e.sheet}!${e.cell}`,value:e.numbers.length,line:`${v(e)}${e.cells>1?` and ${String(e.cells-1)} more`:""} ${e.formula}: ${e.numbers.map(t=>`${String(t.value)} (${t.in})`).join(", ")}`}}case"sheet-unlike":{const e=s.data;return{key:`${e.sheet}!${e.cell}:${e.along}`,value:e.run,line:`${v(e)} ${e.holds}, its ${e.along} ${e.neighbour} (${String(e.run)} alike)`}}case"sheet-exception":{const e=s.data;return{key:`${e.sheet}!${e.cell}`,value:1,line:`${v(e)} ${e.table}[${e.column}] holds ${JSON.stringify(e.text)}`}}case"sheet-unused":{const e=s.data;return{key:`${e.what}:${e.sheet??""}!${e.name}`,value:1,line:`${e.what} ${e.sheet===void 0?"":`${e.sheet}!`}${e.name}${e.value===void 0?"":` ${e.value}`}`}}case"sheet-invalid":{const e=s.data;return{key:`${e.sheet}!${e.cell}`,value:1,line:`${v(e)} ${JSON.stringify(e.value)} under the ${e.rule} validation on ${e.range}`}}case"sheet-typed":{const e=s.data;return{key:`${e.sheet}!${e.cell}:${String(e.value)}`,value:1,line:`${v(e)} ${String(e.value)}, in neither sheet.ts nor its data`}}case"sheet-ordinary":{const e=s.data;return{key:e.sheet,value:1,line:`${e.sheet}: sheet.ts makes it and sheet.yaml holds it; sheet.yaml's stands`}}case"text-speaker":{const e=s.data,t=[e.face?`covers ${m(e.face.ofFace)} of the face ${p(e.face.box)} (${m(e.face.ofText)} of the text's box)`:"",e.person?`${m(e.person.ofText)} of the text's box over the person (${e.person.file})`:""].filter(Boolean);return{key:`${e.text.layer}|${e.text.text}`,value:Math.max(e.face?.ofFace??0,e.person?.ofText??0),line:`${y(e.text)}: ${t.join("; ")}`}}case"text-off-frame":{const e=s.data;return{key:`${e.text.layer}|${e.text.text}`,value:e.share,line:`${y({...e.text,box:e.glyphs})}: ${k(e.share)} of its glyphs outside the ${String(e.frame[0])}×${String(e.frame[1])} frame (${String(e.outside)} px), ${e.edges.map(t=>`${String(t.px)} px past the ${t.side}`).join(", ")}`}}case"text-contrast":{const e=s.data,t=`${String(e.size)} px, weight ${String(e.weight)}${e.shadow?", a shadow":""}${e.stroke?", a stroke":""}`,n=e.footage?`; footage under it, not drawn here: ${e.footage.join(", ")}`:"";if("missing"in e)return{key:`${e.text.layer}|${e.text.text}`,value:0,line:`${y(e.text)}: not measured (${e.missing}: ${e.why}; ${t})${n}`};const a=r=>`${r.toFixed(2)}:1`;return{key:`${e.text.layer}|${e.text.text}`,value:1/Math.max(1,e.ratio.min),line:`${y(e.text)}: ${a(e.ratio.min)} lowest, ${a(e.ratio.low)} at the ${String(e.options.percentile)}th percentile, ${a(e.ratio.median)} median; ${e.fill.join(", ")} over ${e.background.median} (median; ${e.background.atMin} at the lowest), ${t}${e.under?` (its outline counted behind it; under the outline ${a(e.under.ratio.min)} lowest, ${a(e.under.ratio.median)} median, over ${e.under.background.median})`:""}, ${String(e.pixels)} px${e.picture==="final"?", final picture":""}${n}`}}case"text-covered":{const e=s.data,t=e.covered;return{key:`${e.text.layer}|${e.text.text}`,value:Math.max(...e.edges.map(n=>n.px)),line:`${y(e.text)}: ${e.edges.map(n=>`${String(n.px)} px into the ${n.side}`).join(", ")} (${e.profile??"covered"}: top ${String(t.top)}, bottom ${String(t.bottom)}, left ${String(t.left)}, right ${String(t.right)})`}}case"text-overlap":{const e=s.data;return{key:`${e.a.layer}|${e.a.text}|${e.b.layer}|${e.b.text}`,value:e.share,line:`${y(e.a)} × ${y(e.b)}: ${m(e.share)} of the smaller box`}}case"text-overlap-own":{const e=s.data;return{key:`${e.a.layer}|${e.a.text}|${e.b.text}`,value:e.share,line:`${O(e.a)} × ${O(e.b)}: ${m(e.share)} of the smaller glyph box`}}case"text-outside":{const e=s.data;return{key:`${e.text.layer}|${e.text.text}|${p(e.container.box)}`,value:Math.max(...e.edges.map(t=>t.px)),line:`${O(e.text)}: ${e.edges.map(t=>`${String(t.px)} px past the ${t.side}`).join(", ")} of the box ${p(e.container.box)} (${e.container.paint.join(", ")})`}}case"text-time":{const e=s.data,t=e.seconds>0?`${(e.words/e.seconds).toFixed(1)} words/s`:"never whole",n=e.spans.map(([a,r])=>`${$(a)}–${$(r)}`).join(", ");return{key:`${e.text.layer}|${e.text.text}|${p(e.text.box)}`,value:e.seconds>0?e.words/e.seconds:e.words,line:`${y(e.text)}: ${u(e.words,"word")} (${String(e.chars)} characters) whole for ${$(e.seconds)} s${n?` (${n} s)`:""}, ${t}; on screen ${$(e.onScreen)} s${e.size?`; ${String(e.size.px)} px, ${String(e.size.phone)} pt on a ${String(e.options.phone[0])}-point phone${e.size.lowercase?`, lowercase ${String(e.size.lowercase.px)} px, ${String(e.size.lowercase.phone)} pt`:""}`:""}`}}case"speech-on-screen":{const e=s.data;return{key:s.part??"",value:e.words-e.shown,line:`${String(e.shown)} of ${u(e.words,"word")} said show as text${e.unshown.length>0?`; not shown: ${e.unshown.slice(0,12).join(" ")}`:""}`}}case"words-on-screen":{const e=s.data,t=e.steps.map(n=>`${$(n.t)} s ${String(n.words)}`);return{key:s.part??"",value:e.words,line:`at most ${u(e.words,"word")} (${String(e.chars)} characters) whole at once, in ${u(e.texts,"text")}, ${$(e.from)}–${$(e.until)} s; from each change on: ${t.join(", ")}`}}case"footage-scale":{const e=s.data,t=e.shown[0]===e.source[0]&&e.shown[1]===e.source[1]?"":`, ${String(e.shown[0])}×${String(e.shown[1])} of it shown`,{min:n,max:a}=e,r=n.scale===a.scale?`${String(a.scale)}× throughout (${a.from.join(", ")})`:`${String(n.scale)}×–${String(a.scale)}× (smallest at ${$(n.t)} s: ${n.from.join(", ")}; largest at ${$(a.t)} s: ${a.from.join(", ")})`;return{key:`${e.file}|${s.part??""}`,value:a.scale,line:`${e.file} (${String(e.source[0])}×${String(e.source[1])}${t}): ${r}`}}case"free-bands":{const e=s.data,t=r=>r.length===0?"none":r.map(([i,d])=>`${String(i)}–${String(d)}`).join(", "),n=r=>r.length===0?"none":r.map(i=>`${String(i.y[0])}–${String(i.y[1])} (${String(i.height)} px)`).join(", "),a=(r,i)=>"missing"in i?`        ${r}: not measured (no ${i.missing==="face-track"?"face track":"person matte"} for ${i.files.join(", ")} in the media index)`:`        ${r}${i.speaker===void 0?"":` (face ${String(i.speaker)})`}, seen at ${String(i.seen)} of ${String(e.moments.length)} moments: rows ${t(i.rows)}; free ${n(i.bands)}`;return{key:"bands",value:e.bands.reduce((r,i)=>r+i.height,0),line:[`inside the covered edges: rows ${String(e.content.y[0])}–${String(e.content.y[1])}, columns ${String(e.content.x[0])}–${String(e.content.x[1])}${e.profile?` (${e.profile})`:""}, ${String(e.moments.length)} moments ${$(e.moments[0]??0)}–${$(e.moments.at(-1)??0)} s; free of everything measured: ${n(e.bands)}`,a("face box",e.face),a("person matte",e.person)].join(`
+import{FACT_KINDS as T,comboKey as H}from"@allyhub/video-core";import{plural as u}from"./plural.js";const j=s=>`"${s.length>40?`${s.slice(0,40)}…`:s}"`,p=s=>`[${s.join(",")}]`,m=s=>`${String(Math.round(s*100))}%`,b=s=>`${(s*100).toFixed(1)}%`,k=s=>`${String(Math.round(s*1e4)/100)}%`,$=s=>s.toFixed(2),y=s=>`${s.layer}${s.z==="behind-person"?" (behind)":s.z==="overlay"?" (overlay)":""} ${j(s.text)} ${p(s.box)}${s.opacity===void 0?"":` at ${m(s.opacity)} opacity`}`,O=s=>y({...s,box:s.ink??s.box});function U(s){return s.output===void 0?s.piece:[s.piece,s.combo?H(s.combo):void 0,s.format].filter(e=>e!==void 0&&e!=="").join(" · ")}function z(s,e,t){const n=F(s,e.start),a=s.t===void 0?0:s.t-e.start;return{line:`${e.layer} ${n(e.start)}–${n(e.end)} s: ${t}`,alike:{what:`${e.layer}: ${t}`,span:[e.start+a,e.end+a]}}}const v=s=>`${s.sheet===void 0?"":`${s.sheet}!`}${s.cell??""}`;function J(s){switch(s.kind){case"sheet-error":{const e=s.data;return{key:`${e.sheet}!${e.cell}`,value:e.origin?1:0,line:`${v(e)} ${e.code}${e.formula===void 0?"":` ${e.formula}`}${e.origin?", starts here":", read from another"}`}}case"sheet-number":{const e=s.data;return{key:`${e.sheet}!${e.cell}`,value:e.numbers.length,line:`${v(e)}${e.cells>1?` and ${String(e.cells-1)} more`:""} ${e.formula}: ${e.numbers.map(t=>`${String(t.value)} (${t.in})`).join(", ")}`}}case"sheet-unlike":{const e=s.data;return{key:`${e.sheet}!${e.cell}:${e.along}`,value:e.run,line:`${v(e)} ${e.holds}, its ${e.along} ${e.neighbour} (${String(e.run)} alike)`}}case"sheet-exception":{const e=s.data;return{key:`${e.sheet}!${e.cell}`,value:1,line:`${v(e)} ${e.table}[${e.column}] holds ${JSON.stringify(e.text)}`}}case"sheet-unused":{const e=s.data;return{key:`${e.what}:${e.sheet??""}!${e.name}`,value:1,line:`${e.what} ${e.sheet===void 0?"":`${e.sheet}!`}${e.name}${e.value===void 0?"":` ${e.value}`}`}}case"sheet-invalid":{const e=s.data;return{key:`${e.sheet}!${e.cell}`,value:1,line:`${v(e)} ${JSON.stringify(e.value)} under the ${e.rule} validation on ${e.range}`}}case"sheet-typed":{const e=s.data;return{key:`${e.sheet}!${e.cell}:${String(e.value)}`,value:1,line:`${v(e)} ${String(e.value)}, in neither sheet.ts nor its data`}}case"sheet-ordinary":{const e=s.data;return{key:e.sheet,value:1,line:`${e.sheet}: sheet.ts makes it and sheet.yaml holds it; sheet.yaml's stands`}}case"text-speaker":{const e=s.data,t=[e.face?`covers ${m(e.face.ofFace)} of the face ${p(e.face.box)} (${m(e.face.ofText)} of the text's box)`:"",e.person?`${m(e.person.ofText)} of the text's box over the person (${e.person.file})`:""].filter(Boolean);return{key:`${e.text.layer}|${e.text.text}`,value:Math.max(e.face?.ofFace??0,e.person?.ofText??0),line:`${y(e.text)}: ${t.join("; ")}`}}case"text-off-frame":{const e=s.data;return{key:`${e.text.layer}|${e.text.text}`,value:e.share,line:`${y({...e.text,box:e.glyphs})}: ${k(e.share)} of its glyphs outside the ${String(e.frame[0])}×${String(e.frame[1])} frame (${String(e.outside)} px), ${e.edges.map(t=>`${String(t.px)} px past the ${t.side}`).join(", ")}`}}case"text-contrast":{const e=s.data,t=`${String(e.size)} px, weight ${String(e.weight)}${e.shadow?", a shadow":""}${e.stroke?", a stroke":""}`,n=e.footage?`; footage under it, not drawn here: ${e.footage.join(", ")}`:"";if("missing"in e)return{key:`${e.text.layer}|${e.text.text}`,value:0,line:`${y(e.text)}: not measured (${e.missing}: ${e.why}; ${t})${n}`};const a=r=>`${r.toFixed(2)}:1`;return{key:`${e.text.layer}|${e.text.text}`,value:1/Math.max(1,e.ratio.min),line:`${y(e.text)}: ${a(e.ratio.min)} lowest, ${a(e.ratio.low)} at the ${String(e.options.percentile)}th percentile, ${a(e.ratio.median)} median; ${e.fill.join(", ")} over ${e.background.median} (median; ${e.background.atMin} at the lowest), ${t}${e.under?` (its outline counted behind it; under the outline ${a(e.under.ratio.min)} lowest, ${a(e.under.ratio.median)} median, over ${e.under.background.median})`:""}, ${String(e.pixels)} px${e.picture==="final"?", final picture":""}${n}`}}case"text-covered":{const e=s.data,t=e.covered;return{key:`${e.text.layer}|${e.text.text}`,value:Math.max(...e.edges.map(n=>n.px)),line:`${y(e.text)}: ${e.edges.map(n=>`${String(n.px)} px into the ${n.side}`).join(", ")} (${e.profile??"covered"}: top ${String(t.top)}, bottom ${String(t.bottom)}, left ${String(t.left)}, right ${String(t.right)})`}}case"text-overlap":{const e=s.data;return{key:`${e.a.layer}|${e.a.text}|${e.b.layer}|${e.b.text}`,value:e.share,line:`${y(e.a)} × ${y(e.b)}: ${m(e.share)} of the smaller box`}}case"text-overlap-own":{const e=s.data;return{key:`${e.a.layer}|${e.a.text}|${e.b.text}`,value:e.share,line:`${O(e.a)} × ${O(e.b)}: ${m(e.share)} of the smaller glyph box`}}case"text-outside":{const e=s.data;return{key:`${e.text.layer}|${e.text.text}|${p(e.container.box)}`,value:Math.max(...e.edges.map(t=>t.px)),line:`${O(e.text)}: ${e.edges.map(t=>`${String(t.px)} px past the ${t.side}`).join(", ")} of the box ${p(e.container.box)} (${e.container.paint.join(", ")})`}}case"text-time":{const e=s.data,t=e.seconds>0?`${(e.words/e.seconds).toFixed(1)} words/s`:"never whole",n=e.spans.map(([a,r])=>`${$(a)}–${$(r)}`).join(", ");return{key:`${e.text.layer}|${e.text.text}|${p(e.text.box)}`,value:e.seconds>0?e.words/e.seconds:e.words,line:`${y(e.text)}: ${u(e.words,"word")} (${String(e.chars)} characters) whole for ${$(e.seconds)} s${n?` (${n} s)`:""}, ${t}; on screen ${$(e.onScreen)} s${e.size?`; ${String(e.size.px)} px, ${String(e.size.phone)} pt on a ${String(e.options.phone[0])}-point phone${e.size.lowercase?`, lowercase ${String(e.size.lowercase.px)} px, ${String(e.size.lowercase.phone)} pt`:""}`:""}`}}case"speech-on-screen":{const e=s.data;return{key:s.part??"",value:e.words-e.shown,line:`${String(e.shown)} of ${u(e.words,"word")} said show as text${e.unshown.length>0?`; not shown: ${e.unshown.slice(0,12).join(" ")}`:""}`}}case"words-on-screen":{const e=s.data,t=e.steps.map(n=>`${$(n.t)} s ${String(n.words)}`);return{key:s.part??"",value:e.words,line:`at most ${u(e.words,"word")} (${String(e.chars)} characters) whole at once, in ${u(e.texts,"text")}, ${$(e.from)}–${$(e.until)} s; from each change on: ${t.join(", ")}`}}case"footage-scale":{const e=s.data,t=e.shown[0]===e.source[0]&&e.shown[1]===e.source[1]?"":`, ${String(e.shown[0])}×${String(e.shown[1])} of it shown`,{min:n,max:a}=e,r=n.scale===a.scale?`${String(a.scale)}× throughout (${a.from.join(", ")})`:`${String(n.scale)}×–${String(a.scale)}× (smallest at ${$(n.t)} s: ${n.from.join(", ")}; largest at ${$(a.t)} s: ${a.from.join(", ")})`;return{key:`${e.file}|${s.part??""}`,value:a.scale,line:`${e.file} (${String(e.source[0])}×${String(e.source[1])}${t}): ${r}`}}case"free-bands":{const e=s.data,t=r=>r.length===0?"none":r.map(([i,d])=>`${String(i)}–${String(d)}`).join(", "),n=r=>r.length===0?"none":r.map(i=>`${String(i.y[0])}–${String(i.y[1])} (${String(i.height)} px)`).join(", "),a=(r,i)=>"missing"in i?`        ${r}: not measured (no ${i.missing==="face-track"?"face track":"person matte"} for ${i.files.join(", ")} in the media index)`:`        ${r}${i.speaker===void 0?"":` (face ${String(i.speaker)})`}, seen at ${String(i.seen)} of ${String(e.moments.length)} moments: rows ${t(i.rows)}; free ${n(i.bands)}`;return{key:"bands",value:e.bands.reduce((r,i)=>r+i.height,0),line:[`inside the covered edges: rows ${String(e.content.y[0])}–${String(e.content.y[1])}, columns ${String(e.content.x[0])}–${String(e.content.x[1])}${e.profile?` (${e.profile})`:""}, ${String(e.moments.length)} moments ${$(e.moments[0]??0)}–${$(e.moments.at(-1)??0)} s; free of everything measured: ${n(e.bands)}`,a("face box",e.face),a("person matte",e.person)].join(`
 `)}}case"flat-frames":{const e=s.data;return{key:String(e.start),value:e.frames,line:`${String(e.frames)}${e.longer?" or more":""} frames of flat ${e.shade} (luma ${String(e.luma)}) to ${$(e.end)} s (flat: luminance deviation at most ${String(e.options.maxStd)}; runs of ${String(e.options.minFrames)} frames or more, more than ${String(e.options.sameLuma)} levels from the picture around)`}}case"still-picture":{const e=s.data,t=e.footage?`; footage not compared: ${e.footage.map(n=>`${n.file} ${$(n.start)}–${$(n.end)} s`).join(", ")}`:"";return{key:String(e.start),value:e.seconds,line:`${$(e.seconds)} s still, ${$(e.start)}–${$(e.end)} s${e.toEnd?" (to the last frame)":""}, through ${e.parts.join(", ")}: at most ${k(e.change)} of the picture changed from its start (mean ${String(e.mean)} of 255), ${k(e.drift.change)} at its end${t}`}}case"cut-seam":{const e=s.data,t=r=>`${r.turn===void 0?"":`turns ${String(r.turn)}°, `}${String(r.speed[0])} → ${String(r.speed[1])} px/s`,n=e.transition?`, a ${e.transition.type} ${$(e.transition.start)}–${$(e.transition.end)} s between`:"",a=[`${e.before.part} → ${e.after.part}${n}: the largest moving thing ${t(e.change.lead)}; everything moving ${t(e.change.overall)}${e.change.picture?`; the picture ${t(e.change.picture)}`:""}`,B("before",e.before),B("after",e.after),...e.carriers.map(r=>`        named alike: ${r.name} ${p(r.before)} → ${p(r.after)}, ${String(r.distance)} px apart, size ×${String(r.size)}, ${String(r.speed[0])} → ${String(r.speed[1])} px/s`)];return{key:String(e.at),value:Math.abs(e.change.lead.turn??0),line:a.join(`
 `)}}case"flash":{const e=s.data,t=n=>`${k(n.share)} (mean ${String(n.mean)})`;return{key:String(e.start),value:e.foreign.share,line:`${u(e.frames,"frame")} ${$(e.start)}–${$(e.end)} s${e.join===void 0?"":` (the join at ${$(e.join)} s)`}${e.transition?` in a ${e.transition.type} from ${e.transition.from} to ${e.transition.to}`:""}: ${t(e.foreign)} of its pixels outside what the frames beside it span; against the frame before ${t(e.before)}, the frame after ${t(e.after)}, those two against each other ${t(e.across)}${e.own?`; on its own side of the cut (${e.own.side} it), against the next frame of its shot ${t(e.own.step)}, while that shot changes ${t(e.own.usual)} a frame`:""}`}}case"music-length":{const e=s.data;return{key:e.file,value:e.without,line:`${e.file}: ${e.music.toFixed(1)} s of music${e.from===void 0?"":` (from ${e.from.toFixed(1)} s in)`}${e.loop?", looped":""}, ${e.video.toFixed(1)} s of video${e.without>0?`, the last ${e.without.toFixed(1)} s without music`:""}${e.estimated?" (put together from its parts)":""}`}}case"join-loudness":{const e=s.data,t=e.estimated?" (put together from its parts)":"";return"missing"in e?{key:`${e.before}|${e.after}`,value:0,line:`${e.before} → ${e.after}: not measured (${e.missing}: ${e.why})${t}`}:{key:`${e.before}|${e.after}`,value:Math.abs(e.difference),line:`${e.before} → ${e.after}: ${e.beforeLufs.toFixed(1)} → ${e.afterLufs.toFixed(1)} LUFS (${e.difference>0?"+":""}${e.difference.toFixed(1)} LU)${t}`}}case"matrix-coverage":{const e=s.data;return{key:"matrix",value:e.candidates.filter(n=>n.combos.length===0).length,line:[`${e.choice==="combos"?"named in matrix.combos":e.pick===void 0?"every combo asked for":`pick ${String(e.pick)}`}; ${e.possible===void 0?"possible not counted":`${String(e.possible)} possible`}, ${String(e.chosen)} chosen`,...e.candidates.map(n=>`    ${n.slot}=${n.candidate}: ${n.combos.length>0?n.combos.join(", "):"in no combo"}`)].join(`
 `)}}case"generated-media":{const e=s.data,t=n=>n.start===void 0?"":n.end===void 0||n.end===n.start?` at ${$(n.start)} s`:` ${$(n.start)}–${$(n.end)} s`;return{key:"generated",value:e.files.length,line:[`${u(e.files.length,"generated file")}${e.duration===void 0?"":` in ${e.duration.toFixed(1)} s of video`}${e.estimated?" (put together from its parts)":""}`,...e.files.map(n=>`        ${n.file} (${[n.kind,n.tool,n.model,n.at].filter(Boolean).join(", ")}${n.mismatch?"; its record is another file's":""})${n.seconds===void 0?"":`, ${n.seconds.toFixed(1)} s`}: ${n.uses.map(a=>`${a.as}${a.part?` in ${a.part}`:""}${t(a)}`).join("; ")}`)].join(`

package/dist/text/format.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{comboKey as $,factsOf as m}from"@allyhub-next/video-core";import{plural as r}from"./plural.js";import{consoleJson as w}from"@allyhub-next/project";import{formatConsole as g}from"./console-text.js";export function formatStats(t){const{total:s,checked:o,reused:n,covered:a}=t.outputs;return n===0&&a===0?`${r(s,"version")}, all checked this time`:o===0&&a===0?`${r(s,"version")} unchanged, results reused from the last check`:`${r(s,"version")}: ${[o>0?`${String(o)} checked this time`:"",n>0?`${String(n)} unchanged with results reused from the last check`:"",a>0?`${String(a)} made of parts checked in the others`:""].filter(Boolean).join(", ")}`}const x={error:"✖",warn:"⚠"};export function formatProblem(t){const s=[t.piece,t.combo?$(t.combo):void 0,t.format,t.part,t.t===void 0?void 0:`${t.t.toFixed(2)} s`].filter(Boolean).join(" · "),o=t.where?.file?` (${t.where.file}${t.where.line?`:${String(t.where.line)}`:""})`:"";return`${x[t.level]} ${t.code}${s?` [${s}]`:""} ${t.message}${o}`}export function formatReading(t){const s=m(t,"text-time").filter(e=>e.data.words>0);if(s.length===0)return;const o=e=>[e.piece,e.combo?$(e.combo):void 0,e.format,e.part,e.t===void 0?void 0:`${e.t.toFixed(2)} s`].filter(i=>i!==void 0&&i!=="").join(" · "),n=e=>e.length>40?`${e.slice(0,40)}…`:e,a=s.filter(e=>e.data.seconds>0),h=e=>e.data.seconds/e.data.words,d=a.reduce((e,i)=>!e||h(i)<h(e)?i:e,void 0),l=m(t,"words-on-screen").reduce((e,i)=>!e||i.data.words>e.data.words?i:e,void 0),c=a.reduce((e,i)=>i.data.size&&(!e?.data.size||i.data.size.phone<e.data.size.phone)?i:e,void 0),u=a.reduce((e,i)=>i.data.size?.lowercase&&(!e?.data.size?.lowercase||i.data.size.lowercase.phone<e.data.size.lowercase.phone)?i:e,void 0),f=s.length-a.length,p=[d?`least time per word ${h(d).toFixed(2)} s ("${n(d.data.text.text)}", ${r(d.data.words,"word")} whole for ${d.data.seconds.toFixed(2)} s; ${o(d)})`:void 0,c?.data.size?`smallest on a ${String(c.data.options.phone[0])}-point phone ${String(c.data.size.phone)} pt ("${n(c.data.text.text)}", ${String(c.data.size.px)} px; ${o(c)})`:void 0,u?.data.size?.lowercase?`smallest lowercase on a phone ${String(u.data.size.lowercase.phone)} pt ("${n(u.data.text.text)}", ${String(u.data.size.lowercase.px)} px; ${o(u)})`:void 0,f>0?`${r(f,"text")} never whole`:void 0,l?`most words whole at once ${String(l.data.words)} (${l.data.from.toFixed(2)}–${l.data.until.toFixed(2)} s; ${o(l)})`:void 0].filter(e=>e!==void 0);return`Text on screen, ${r(s.length,"text")} timed: ${p.join("; ")}. Each one: allyhub inspect --kind text-time,words-on-screen`}function z(t){const s=new Map;for(const n of t)s.set(n.kind,(s.get(n.kind)??0)+1);const o=[...s.entries()].sort((n,a)=>a[1]-n[1]).map(([n])=>n);return`${o.slice(0,4).join(", ")}${o.length>4?"…":""}`}export function formatCheck(t){const s=new Set(t.targets.map(n=>n.piece)).size,o=[`${r(s,"piece")} · ${formatStats(t.stats)}`];o.push(...g(w(t.console)));for(const n of t.problems)o.push(formatProblem(n));if(t.facts.length>0){o.push(`${r(t.facts.length,"measurement")} for you to judge (${z(t.facts)}): allyhub inspect`);const n=formatReading(t.facts);n!==void 0&&o.push(n)}return o.push(formatCounts(t.check)),o.join(`
+import{comboKey as $,factsOf as m}from"@allyhub/video-core";import{plural as r}from"./plural.js";import{consoleJson as w}from"@allyhub/project";import{formatConsole as g}from"./console-text.js";export function formatStats(t){const{total:s,checked:o,reused:n,covered:a}=t.outputs;return n===0&&a===0?`${r(s,"version")}, all checked this time`:o===0&&a===0?`${r(s,"version")} unchanged, results reused from the last check`:`${r(s,"version")}: ${[o>0?`${String(o)} checked this time`:"",n>0?`${String(n)} unchanged with results reused from the last check`:"",a>0?`${String(a)} made of parts checked in the others`:""].filter(Boolean).join(", ")}`}const x={error:"✖",warn:"⚠"};export function formatProblem(t){const s=[t.piece,t.combo?$(t.combo):void 0,t.format,t.part,t.t===void 0?void 0:`${t.t.toFixed(2)} s`].filter(Boolean).join(" · "),o=t.where?.file?` (${t.where.file}${t.where.line?`:${String(t.where.line)}`:""})`:"";return`${x[t.level]} ${t.code}${s?` [${s}]`:""} ${t.message}${o}`}export function formatReading(t){const s=m(t,"text-time").filter(e=>e.data.words>0);if(s.length===0)return;const o=e=>[e.piece,e.combo?$(e.combo):void 0,e.format,e.part,e.t===void 0?void 0:`${e.t.toFixed(2)} s`].filter(i=>i!==void 0&&i!=="").join(" · "),n=e=>e.length>40?`${e.slice(0,40)}…`:e,a=s.filter(e=>e.data.seconds>0),h=e=>e.data.seconds/e.data.words,d=a.reduce((e,i)=>!e||h(i)<h(e)?i:e,void 0),l=m(t,"words-on-screen").reduce((e,i)=>!e||i.data.words>e.data.words?i:e,void 0),c=a.reduce((e,i)=>i.data.size&&(!e?.data.size||i.data.size.phone<e.data.size.phone)?i:e,void 0),u=a.reduce((e,i)=>i.data.size?.lowercase&&(!e?.data.size?.lowercase||i.data.size.lowercase.phone<e.data.size.lowercase.phone)?i:e,void 0),f=s.length-a.length,p=[d?`least time per word ${h(d).toFixed(2)} s ("${n(d.data.text.text)}", ${r(d.data.words,"word")} whole for ${d.data.seconds.toFixed(2)} s; ${o(d)})`:void 0,c?.data.size?`smallest on a ${String(c.data.options.phone[0])}-point phone ${String(c.data.size.phone)} pt ("${n(c.data.text.text)}", ${String(c.data.size.px)} px; ${o(c)})`:void 0,u?.data.size?.lowercase?`smallest lowercase on a phone ${String(u.data.size.lowercase.phone)} pt ("${n(u.data.text.text)}", ${String(u.data.size.lowercase.px)} px; ${o(u)})`:void 0,f>0?`${r(f,"text")} never whole`:void 0,l?`most words whole at once ${String(l.data.words)} (${l.data.from.toFixed(2)}–${l.data.until.toFixed(2)} s; ${o(l)})`:void 0].filter(e=>e!==void 0);return`Text on screen, ${r(s.length,"text")} timed: ${p.join("; ")}. Each one: allyhub inspect --kind text-time,words-on-screen`}function z(t){const s=new Map;for(const n of t)s.set(n.kind,(s.get(n.kind)??0)+1);const o=[...s.entries()].sort((n,a)=>a[1]-n[1]).map(([n])=>n);return`${o.slice(0,4).join(", ")}${o.length>4?"…":""}`}export function formatCheck(t){const s=new Set(t.targets.map(n=>n.piece)).size,o=[`${r(s,"piece")} · ${formatStats(t.stats)}`];o.push(...g(w(t.console)));for(const n of t.problems)o.push(formatProblem(n));if(t.facts.length>0){o.push(`${r(t.facts.length,"measurement")} for you to judge (${z(t.facts)}): allyhub inspect`);const n=formatReading(t.facts);n!==void 0&&o.push(n)}return o.push(formatCounts(t.check)),o.join(`
 `)}export function formatCounts(t){return`Result: ${String(t.errors)} must-fix, ${r(t.warnings,"suggestion")}`}

package/dist/text/timeline-text.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{stackOf as m,transitionLabel as u}from"@allyhub-next/video-core";import{plural as h}from"./plural.js";const c=t=>t===null?"not measured":`${t<0?"−":""}${Math.abs(t).toFixed(1)} dBFS`;export function roomToneLines(t,i){const o=[];for(const a of["lead","tail"]){const e=i.filter(f=>f.tone?.part===t&&f.tone.side===a),d=e[0],r=e.at(-1),n=d?.tone;if(!d||!r||!n)continue;const s=`${n.gainDb<0?"−":"+"}${Math.abs(n.gainDb).toFixed(1)} dB`,$={matched:`matched${n.limited?", held at the limit":""}`,given:"the take's roomTone({ gainDb })",off:"matching off",unmeasured:`as recorded: ${n.floor===null?`no floor of the take's own room at the join to match (it keeps ${n.pad.toFixed(2)} s there, and a floor needs 0.1 s; or its levels are unknown)`:"the fill's level was not measured"}`}[n.from],l=n.level!==null&&n.level<-90?"; the fill is digital silence, under −90 dBFS":"",p=`         room tone, ${a}: ${d.at.toFixed(2)} – ${(r.at+r.dur).toFixed(2)} from ${d.from.toFixed(2)} s of the file`;if(n.from==="unmeasured"&&n.floor===null&&n.pad<.1){o.push(`${p}, as recorded: no room of its own beside the words to match it to${l}`);continue}o.push(`${p} at ${s} (${$}; the fill's floor ${c(n.level)}, the take's over the ${n.pad.toFixed(2)} s of its own room at the join ${c(n.floor)}; cross-fade ${n.fade.toFixed(3)} s${l})`)}return o}export function stackLine(t,i){const o=i.filter(a=>a.part===t.key);if(!(t.planes.length<=1&&o.every(a=>!a.over)))return m(t,i).map(a=>a.kind==="footage"?`footage ${a.footage.file}`:a.kind==="person"?`the speaker of ${a.footage.file}, cut out`:`${a.layers.map(e=>e.component).join(" + ")||"nothing"}${t.planes[a.plane]?.behindPerson?" (behind the person)":""}`).join(" → ")}export function formatTimeline(t){const i=[`${t.label} · ${t.timeline.duration.toFixed(2)} s · ${h(t.timeline.parts.length,"part")}${t.timeline.transitions?.length?` · ${h(t.timeline.transitions.length,"transition")}`:""}`];for(const e of t.timeline.parts){const d=t.text.find(s=>s.key===e.key);i.push(`${e.start.toFixed(2).padStart(6)} – ${e.end.toFixed(2).padEnd(6)} ${e.key} (${e.layers.join(", ")||"no layers"})${e.plays?` plays ${e.plays.video} ${e.plays.from.toFixed(2)} – ${e.plays.to.toFixed(2)} s`:e.speech?"":" no speech"}`);const r=stackLine(e,t.timeline.footage??[]);r&&i.push(`         drawn back to front: ${r}`);const n=t.timeline.transitions?.find(s=>s.part===e.key);if(n&&i.push(`         comes in: ${u(n)} from ${n.from}, over ${n.start.toFixed(2)} – ${n.end.toFixed(2)}${n.ease==="linear"?"":` (${n.ease})`}`),e.speech&&(i.push(`         speech: ${e.speech.start.toFixed(2)} – ${e.speech.end.toFixed(2)} from ${e.speech.file} at ${e.speech.from.toFixed(2)} s${e.speech.speed===void 0?"":`, ×${String(e.speech.speed)}`}`),i.push(...roomToneLines(e.key,t.timeline.audio.room??[]))),d?.spoken){const s=e.speech?.match,$=s===void 0||s.score>=1?"":`; ${String(Math.round(s.score*100))} % of the line found in the take${s.from>0?` after word #${String(s.from)}`:""}`;i.push(`         says: ${d.spoken}${d.speechKey?` (${d.speechKey}${$})`:$?` (${$.slice(2)})`:""}`)}if(e.anchors&&e.anchors.length>0&&i.push(`         anchors: ${e.anchors.map(s=>`@${s.name} ${s.at.toFixed(2)}${s.end===void 0?"":` – ${s.end.toFixed(2)}`}`).join(", ")}`),e.speech?.heard!==void 0){const s=e.speech.words;i.push(`         heard: ${e.speech.heard}${s?` (#${String(s[0])}–#${String(s[1])}${e.speech.edits?`, cut by ${e.speech.edits}`:""})`:""}`)}d?.notes&&i.push(`         notes: ${d.notes}`),d&&d.onScreen.length>0&&i.push(`         on screen: ${d.onScreen.join(" · ")}`)}t.timeline.cues.length>0&&i.push(`Sound effects: ${t.timeline.cues.map(e=>`${e.t.toFixed(2)} ${e.sound}${e.gainDb===void 0?"":` (${e.gainDb>0?"+":""}${String(e.gainDb)} dB)`}${e.what?` (${e.what})`:""}`).join(", ")}`);const o=t.timeline.audio.music;if(o){const e=o.tempo?`${String(o.tempo.bpm)} bpm (${o.tempo.source==="given"?"given":`measured, confidence ${String(o.tempo.confidence??0)}`})`:"no tempo known",d=o.play?`, ${o.play.map(r=>`${r.from.toFixed(2)}–${r.to.toFixed(2)} s at ${r.at.toFixed(2)}`).join(", ")}`:"";i.push(`Music: ${o.file??"none in this combo"}${o.from>0&&!o.play?` from ${o.from.toFixed(2)} s`:""}${o.loop?", looped":", played once"}${d}${o.until===void 0?"":`, ending at ${o.until.toFixed(2)} s`}; ${e}${o.downbeat===void 0?"":`, bar 0 at ${o.downbeat.toFixed(2)} s of the file, ${String(o.meter??4)} beats a bar`}; ${o.snapped?"parts without speech end on the beat":"nothing snapped to the beat"}${o.shape||o.gain?"; shaped in the piece":""}`)}const a=[...new Set((t.timeline.audio.speech??[]).map(e=>e.file))];return a.length>0&&i.push(`Speech files: ${a.join(", ")}`),t.generated.length>0&&i.push(`Generated media (.gen.json): ${t.generated.map(e=>`${e.file}${e.gen.tool?` by ${e.gen.tool}`:""}${e.parts.length?` in ${e.parts.join(", ")}`:""}`).join("; ")}`),i}
+import{stackOf as m,transitionLabel as u}from"@allyhub/video-core";import{plural as h}from"./plural.js";const c=t=>t===null?"not measured":`${t<0?"−":""}${Math.abs(t).toFixed(1)} dBFS`;export function roomToneLines(t,i){const o=[];for(const a of["lead","tail"]){const e=i.filter(f=>f.tone?.part===t&&f.tone.side===a),d=e[0],r=e.at(-1),n=d?.tone;if(!d||!r||!n)continue;const s=`${n.gainDb<0?"−":"+"}${Math.abs(n.gainDb).toFixed(1)} dB`,$={matched:`matched${n.limited?", held at the limit":""}`,given:"the take's roomTone({ gainDb })",off:"matching off",unmeasured:`as recorded: ${n.floor===null?`no floor of the take's own room at the join to match (it keeps ${n.pad.toFixed(2)} s there, and a floor needs 0.1 s; or its levels are unknown)`:"the fill's level was not measured"}`}[n.from],l=n.level!==null&&n.level<-90?"; the fill is digital silence, under −90 dBFS":"",p=`         room tone, ${a}: ${d.at.toFixed(2)} – ${(r.at+r.dur).toFixed(2)} from ${d.from.toFixed(2)} s of the file`;if(n.from==="unmeasured"&&n.floor===null&&n.pad<.1){o.push(`${p}, as recorded: no room of its own beside the words to match it to${l}`);continue}o.push(`${p} at ${s} (${$}; the fill's floor ${c(n.level)}, the take's over the ${n.pad.toFixed(2)} s of its own room at the join ${c(n.floor)}; cross-fade ${n.fade.toFixed(3)} s${l})`)}return o}export function stackLine(t,i){const o=i.filter(a=>a.part===t.key);if(!(t.planes.length<=1&&o.every(a=>!a.over)))return m(t,i).map(a=>a.kind==="footage"?`footage ${a.footage.file}`:a.kind==="person"?`the speaker of ${a.footage.file}, cut out`:`${a.layers.map(e=>e.component).join(" + ")||"nothing"}${t.planes[a.plane]?.behindPerson?" (behind the person)":""}`).join(" → ")}export function formatTimeline(t){const i=[`${t.label} · ${t.timeline.duration.toFixed(2)} s · ${h(t.timeline.parts.length,"part")}${t.timeline.transitions?.length?` · ${h(t.timeline.transitions.length,"transition")}`:""}`];for(const e of t.timeline.parts){const d=t.text.find(s=>s.key===e.key);i.push(`${e.start.toFixed(2).padStart(6)} – ${e.end.toFixed(2).padEnd(6)} ${e.key} (${e.layers.join(", ")||"no layers"})${e.plays?` plays ${e.plays.video} ${e.plays.from.toFixed(2)} – ${e.plays.to.toFixed(2)} s`:e.speech?"":" no speech"}`);const r=stackLine(e,t.timeline.footage??[]);r&&i.push(`         drawn back to front: ${r}`);const n=t.timeline.transitions?.find(s=>s.part===e.key);if(n&&i.push(`         comes in: ${u(n)} from ${n.from}, over ${n.start.toFixed(2)} – ${n.end.toFixed(2)}${n.ease==="linear"?"":` (${n.ease})`}`),e.speech&&(i.push(`         speech: ${e.speech.start.toFixed(2)} – ${e.speech.end.toFixed(2)} from ${e.speech.file} at ${e.speech.from.toFixed(2)} s${e.speech.speed===void 0?"":`, ×${String(e.speech.speed)}`}`),i.push(...roomToneLines(e.key,t.timeline.audio.room??[]))),d?.spoken){const s=e.speech?.match,$=s===void 0||s.score>=1?"":`; ${String(Math.round(s.score*100))} % of the line found in the take${s.from>0?` after word #${String(s.from)}`:""}`;i.push(`         says: ${d.spoken}${d.speechKey?` (${d.speechKey}${$})`:$?` (${$.slice(2)})`:""}`)}if(e.anchors&&e.anchors.length>0&&i.push(`         anchors: ${e.anchors.map(s=>`@${s.name} ${s.at.toFixed(2)}${s.end===void 0?"":` – ${s.end.toFixed(2)}`}`).join(", ")}`),e.speech?.heard!==void 0){const s=e.speech.words;i.push(`         heard: ${e.speech.heard}${s?` (#${String(s[0])}–#${String(s[1])}${e.speech.edits?`, cut by ${e.speech.edits}`:""})`:""}`)}d?.notes&&i.push(`         notes: ${d.notes}`),d&&d.onScreen.length>0&&i.push(`         on screen: ${d.onScreen.join(" · ")}`)}t.timeline.cues.length>0&&i.push(`Sound effects: ${t.timeline.cues.map(e=>`${e.t.toFixed(2)} ${e.sound}${e.gainDb===void 0?"":` (${e.gainDb>0?"+":""}${String(e.gainDb)} dB)`}${e.what?` (${e.what})`:""}`).join(", ")}`);const o=t.timeline.audio.music;if(o){const e=o.tempo?`${String(o.tempo.bpm)} bpm (${o.tempo.source==="given"?"given":`measured, confidence ${String(o.tempo.confidence??0)}`})`:"no tempo known",d=o.play?`, ${o.play.map(r=>`${r.from.toFixed(2)}–${r.to.toFixed(2)} s at ${r.at.toFixed(2)}`).join(", ")}`:"";i.push(`Music: ${o.file??"none in this combo"}${o.from>0&&!o.play?` from ${o.from.toFixed(2)} s`:""}${o.loop?", looped":", played once"}${d}${o.until===void 0?"":`, ending at ${o.until.toFixed(2)} s`}; ${e}${o.downbeat===void 0?"":`, bar 0 at ${o.downbeat.toFixed(2)} s of the file, ${String(o.meter??4)} beats a bar`}; ${o.snapped?"parts without speech end on the beat":"nothing snapped to the beat"}${o.shape||o.gain?"; shaped in the piece":""}`)}const a=[...new Set((t.timeline.audio.speech??[]).map(e=>e.file))];return a.length>0&&i.push(`Speech files: ${a.join(", ")}`),t.generated.length>0&&i.push(`Generated media (.gen.json): ${t.generated.map(e=>`${e.file}${e.gen.tool?` by ${e.gen.tool}`:""}${e.parts.length?` in ${e.parts.join(", ")}`:""}`).join("; ")}`),i}

package/dist/version.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as m}from"zod";import{EXIT as s}from"@allyhub-next/protocol";import{runCheck as l}from"@allyhub-next/check";import{ConsolePool as p,OpenedVersion as g,StuckError as x,ProjectError as b,indexNeeds as u,makeIndex as y,parseCombo as E}from"@allyhub-next/project";import{RenderError as k}from"@allyhub-next/render";import{MediaError as I}from"@allyhub-next/media";import{CommandError as c}from"./command.js";import{projectRoot as v}from"./project.js";import{dir as C,indexing as h}from"./fields.js";export const VERSION_FIELDS={item:m.string().optional().describe("The piece: its id, or a path into it; default the project's only one"),combo:m.array(m.string()).optional().describe("The first combo matching name=value pairs joined with commas (lang=zh-cn,hook=b), or a combo's id (c03); default the first combo"),dir:C};export function combosOf(e){return(e.combo??[]).map(t=>known(()=>E(t)))}const j={usage:s.usage,"not-found":s.notFound,failed:s.failed};export function commandError(e){return e instanceof c?e:e instanceof b?new c(e.code,e.message,{exit:j[e.kind],...e.hint===void 0?{}:{hint:e.hint}}):e instanceof k?new c(e.code,e.message,{exit:e.exit,...e.hint===void 0?{}:{hint:e.hint}}):e instanceof I?new c(e.code,e.message,{exit:s.failed,...e.hint===void 0?{}:{hint:e.hint}}):e instanceof x?new c("stuck",e.message,{exit:s.failed,hint:"A layer's render may run forever at that moment."}):e}export function known(e){try{return e()}catch(t){throw commandError(t)}}export async function withVersion(e,t,i,a){const o=await v(t.cwd,e.dir),w=combosOf(e),d=()=>g.open({root:o,...e.item===void 0?{}:{item:e.item},combos:w,purpose:i});let n;try{n=await d();const r=h(t.env)?u([{timeline:n.timeline}]):[];r.length>0&&await indexed(o,r,t)&&(await n.close(),n=await d())}catch(r){throw commandError(r)}try{const r=await a(n),f=new p(n.session.consoleLimit);return f.add(n.target,await n.console()),{result:r,problems:await n.problems(),console:f.report()}}catch(r){throw commandError(r)}finally{await n.close()}}export async function indexed(e,t,i){return(await y(e,t,o=>{(o.status!=="running"||o.share===void 0)&&i.progress(o.status==="failed"?`Could not index ${o.file}: ${o.message}`:o.message)},i.signal)).done.length>0}export async function checkIndexed(e,t){const i=await l(e),a=h(t.env)?u(i.results):[];return a.length===0||!await indexed(e.dir,a,t)?i:l({...e,fresh:!1})}
+import{z as m}from"zod";import{EXIT as s}from"@allyhub/protocol";import{runCheck as l}from"@allyhub/check";import{ConsolePool as p,OpenedVersion as g,StuckError as x,ProjectError as b,indexNeeds as u,makeIndex as y,parseCombo as E}from"@allyhub/project";import{RenderError as k}from"@allyhub/render";import{MediaError as I}from"@allyhub/media";import{CommandError as c}from"./command.js";import{projectRoot as v}from"./project.js";import{dir as C,indexing as h}from"./fields.js";export const VERSION_FIELDS={item:m.string().optional().describe("The piece: its id, or a path into it; default the project's only one"),combo:m.array(m.string()).optional().describe("The first combo matching name=value pairs joined with commas (lang=zh-cn,hook=b), or a combo's id (c03); default the first combo"),dir:C};export function combosOf(e){return(e.combo??[]).map(t=>known(()=>E(t)))}const j={usage:s.usage,"not-found":s.notFound,failed:s.failed};export function commandError(e){return e instanceof c?e:e instanceof b?new c(e.code,e.message,{exit:j[e.kind],...e.hint===void 0?{}:{hint:e.hint}}):e instanceof k?new c(e.code,e.message,{exit:e.exit,...e.hint===void 0?{}:{hint:e.hint}}):e instanceof I?new c(e.code,e.message,{exit:s.failed,...e.hint===void 0?{}:{hint:e.hint}}):e instanceof x?new c("stuck",e.message,{exit:s.failed,hint:"A layer's render may run forever at that moment."}):e}export function known(e){try{return e()}catch(t){throw commandError(t)}}export async function withVersion(e,t,i,a){const o=await v(t.cwd,e.dir),w=combosOf(e),d=()=>g.open({root:o,...e.item===void 0?{}:{item:e.item},combos:w,purpose:i});let n;try{n=await d();const r=h(t.env)?u([{timeline:n.timeline}]):[];r.length>0&&await indexed(o,r,t)&&(await n.close(),n=await d())}catch(r){throw commandError(r)}try{const r=await a(n),f=new p(n.session.consoleLimit);return f.add(n.target,await n.console()),{result:r,problems:await n.problems(),console:f.report()}}catch(r){throw commandError(r)}finally{await n.close()}}export async function indexed(e,t,i){return(await y(e,t,o=>{(o.status!=="running"||o.share===void 0)&&i.progress(o.status==="failed"?`Could not index ${o.file}: ${o.message}`:o.message)},i.signal)).done.length>0}export async function checkIndexed(e,t){const i=await l(e),a=h(t.env)?u(i.results):[];return a.length===0||!await indexed(e.dir,a,t)?i:l({...e,fresh:!1})}

package/dist/works.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-export const WORKS=[{name:"video",title:"Making a video (one piece, or a batch of ads in combos)",commands:["check","frames","inspect","inspect layout","inspect timeline","inspect motion","inspect still","inspect contrast","inspect seams","inspect flash","inspect loop","inspect combos","audio","add search","add","dev","render"],docs:["video.md","layers.md","speech.md","sound.md","batches.md","scenery.md"]},{name:"footage",title:"Cutting recorded footage: a talking head, an interview",commands:["words","words edits","align","frames cuts","audio recording","render"],docs:["footage.md","speech.md"]},{name:"decks",title:"Making a deck",commands:["slides capabilities","slides import","check","frames","inspect layout","inspect contrast","dev","render"],docs:["slides.md","layers.md"]},{name:"docs",title:"Writing a doc",commands:["check","dev","render"],docs:["docs.md"]},{name:"sheets",title:"Making a sheet",commands:["sheet capabilities","sheet import","sheet calc","sheet trace","sheet diff","inspect sheet","sheet","frames","check","dev","render"],docs:["sheets.md"]},{name:"websites",title:"Making a website: any web project, with its website.json",commands:["check","render","frames web","frames compare","site deploy","site status","site live"],docs:["websites.md"]},{name:"generating",title:"Making media with AI models",commands:["<work>","<work> <tool>","upload","voice"],cloud:{works:["ai-media"]}},{name:"researching",title:"Researching a market online",commands:["<work>","<work> <tool>","frames web"],cloud:{}},{name:"references",title:"Studying reference videos, and a piece against them",commands:["reference","reference compare","reference set","frames","frames compare","words","audio","align"]},{name:"3d",title:"Building a 3D scenery and its cameras",commands:["add search","add","scenery","scenery view","scenery map","scenery see","scenery measure","scenery motion","scenery solve","scenery bake","inspect fidelity","dev"],docs:["scenery.md"]},{name:"modeling",title:"Modelling a prop in code, or adding one from a library",commands:["add search","add","3d-model","3d-model capabilities"],docs:["modeling.md","scenery.md"]},{name:"setup",title:"This computer, the account and AllyHub's skills",commands:["skills","skills show","auth login","auth status","orgs list","doctor"]}],workNamed=e=>WORKS.find(s=>s.name===e);export function cloudNouns(e,s){if(e.cloud===void 0)return[];const t=new Set(WORKS.flatMap(d=>d.cloud?.works??[])),n=e.cloud.works;return s.filter(d=>n===void 0?!t.has(d.name):n.includes(d.name))}export function workTitle(e,s){if(e.cloud===void 0)return e.title;if(s===void 0)return`${e.title} (the cloud catalog could not be read)`;const t=cloudNouns(e,s);return t.length===0?`${e.title}: no cloud tools yet`:`${e.title}: ${t.map(n=>n.name).join(", ")}`}
+export const WORKS=[{name:"video",title:"Making a video (one piece, or a batch of ads in combos)",commands:["check","frames","inspect","inspect layout","inspect timeline","inspect motion","inspect still","inspect contrast","inspect seams","inspect flash","inspect loop","inspect combos","audio","add search","add","dev","render"],docs:["video.md","layers.md","speech.md","sound.md","batches.md","scenery.md"]},{name:"footage",title:"Cutting recorded footage: a talking head, an interview",commands:["words","words edits","align","frames cuts","audio recording","render"],docs:["footage.md","speech.md"]},{name:"decks",title:"Making a deck",commands:["slides capabilities","slides import","check","frames","inspect layout","inspect contrast","dev","render"],docs:["slides.md","layers.md"]},{name:"docs",title:"Writing a doc",commands:["check","frames","dev","render"],docs:["docs.md"]},{name:"sheets",title:"Making a sheet",commands:["sheet capabilities","sheet import","sheet calc","sheet trace","sheet diff","inspect sheet","sheet","frames","check","dev","render"],docs:["sheets.md"]},{name:"websites",title:"Making a website: any web project, with its website.json",commands:["check","render","frames web","frames compare","site deploy","site status","site live"],docs:["websites.md"]},{name:"generating",title:"Making media with AI models",commands:["<work>","<work> <tool>","upload","voice"],cloud:{works:["ai-media"]}},{name:"researching",title:"Researching a market online",commands:["<work>","<work> <tool>","frames web"],cloud:{}},{name:"references",title:"Studying reference videos, and a piece against them",commands:["reference","reference compare","reference set","frames","frames compare","words","audio","align"]},{name:"3d",title:"Building a 3D scenery and its cameras",commands:["add search","add","scenery","scenery view","scenery map","scenery see","scenery measure","scenery motion","scenery solve","scenery bake","inspect fidelity","dev"],docs:["scenery.md"]},{name:"modeling",title:"Modelling a prop in code, or adding one from a library",commands:["add search","add","3d-model","3d-model capabilities"],docs:["modeling.md","scenery.md"]},{name:"setup",title:"This computer, the account and AllyHub's skills",commands:["skills","skills show","auth login","auth status","orgs list","doctor"]}],workNamed=e=>WORKS.find(s=>s.name===e);export function cloudNouns(e,s){if(e.cloud===void 0)return[];const t=new Set(WORKS.flatMap(a=>a.cloud?.works??[])),n=e.cloud.works;return s.filter(a=>n===void 0?!t.has(a.name):n.includes(a.name))}export function workTitle(e,s){if(e.cloud===void 0)return e.title;if(s===void 0)return`${e.title} (the cloud catalog could not be read)`;const t=cloudNouns(e,s);return t.length===0?`${e.title}: no cloud tools yet`:`${e.title}: ${t.map(n=>n.name).join(", ")}`}

package/editor-web/assets/abnfDiagram-WEYOIA3C-B9SmmTJt.js

@@ -0,0 +1 @@
+import{m as e,t}from"./mermaid-parser.core-KGVt2icR.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{n as r}from"./d3-selection-COWvaQNI.js";import"./chunk-DSNLSHJZ-Ror_NzZx.js";import{n as i,r as a,t as o}from"./chunk-2E7WHVMD-CoQrt8De.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-CVH2hRmI.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=n(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=n(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};

package/editor-web/assets/architecture-WOLXFQ4H-m-T100yu.js

@@ -0,0 +1 @@
+import"./chunk-NGNAAXSQ-Bw6tHVuc.js";export{M as createArchitectureServices}from"./mermaid-parser.core-KGVt2icR.js";