allyhub 0.7.0 → 0.8.0

package/dist/commands/frames/file.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{basename as O,extname as z,resolve as x}from"node:path";import{startBrowser as B}from"@allyhub-next/browser";import{GRID_WIDTH as K,defaultCols as L,gridHtml as N,gridLayout as R,pixelGridHtml as U,probeVideo as V,stretchFrames as W}from"@allyhub-next/media";import{EXIT as X}from"@allyhub-next/protocol";import{videoFrame as C,writeClip as _}from"@allyhub-next/render";import{CommandError as j}from"../../command.js";import{drawPage as E,gridError as H,isFile as q,looks as J,pictureUrl as I,picturePath as b,save as $,secondsName as p,secondsOf as Q,usage as m,workPath as S}from"./common.js";import{clipKind as Y}from"./piece.js";const F=t=>Math.round(t*1e3)/1e3;export async function fileFrames(t){const s=x(t.cwd,t.file);if(!await q(s))throw new j("not-found",`There is no file ${t.file}.`,{exit:X.notFound});const w=t.from!==void 0||t.to!==void 0;if(w&&(t.from===void 0||t.to===void 0))throw m("bad-option","A stretch needs --from and --to.");if(!w&&t.at===void 0)throw m("missing-moment","A video file needs moments: --at, or --from and --to.","For example --at 1,2.5 or --from 3 --to 4.");if(t.clip!==void 0&&!w)throw m("bad-option","--clip needs --from and --to.");const v=t.clip===void 0?void 0:Y(t.clip),i=await V(s),o=i.fps,M=t.clip===void 0||t.out!==void 0;let r;try{r=t.from!==void 0&&t.to!==void 0?W({from:t.from,to:t.to},{fps:o,duration:i.duration,grid:M}):void 0}catch(e){throw H(e)}const n=r?r.times:Q(t.at??[]);for(const e of n)if(e<0||e>i.duration+1/o)throw m("bad-time",`${e.toFixed(2)} s is outside ${t.file}, which is ${i.duration.toFixed(2)} s long.`);if(t.grid!==void 0&&(n.length!==1||r))throw m("bad-option","--grid draws one moment (one --at) at the file's own size.");const P=Math.max(1,Math.round(i.duration*o)),T=e=>Math.min(Math.round(e*o),Math.max(0,P-1)),h={source:"file",file:s,video:{duration:i.duration,width:i.width,height:i.height,fps:o},...r?{stretch:{from:r.from,to:r.to,every:r.every,frames:r.times.length}}:{}},A=O(s,z(s)),g=e=>x(S(t.root,"frames",A),`${e}.png`);if(n.length===1&&!r&&t.grid===void 0){const e=n[0]??0,a=await $(b(t.cwd,t.out,g(p(e))),await C(s,T(e),o,J()));return{mode:"frame",...h,out:a,t:F(e)}}const u=[];for(const e of n)u.push(await C(s,T(e),o));const y=t.clip!==void 0&&v?await _(u,{file:x(t.cwd,t.clip),type:v,fps:o/(r?.every??1)}):void 0;if(!M)return{mode:"clip",...h,clip:y};let l;try{if(l=await B(t.gpu===void 0?{}:{gpu:t.gpu}),t.grid!==void 0){const d=n[0]??0,c=await E(l,{html:U({src:I(0),width:i.width,height:i.height,step:t.grid}),width:i.width,height:i.height,pictures:u}),f=await $(b(t.cwd,t.out,g(`${p(d)}-grid`)),c);return{mode:"grid",...h,out:f,t:F(d),grid:t.grid}}const e=i.width/i.height;let a;try{a=R({count:n.length,cols:L(n.length,e),width:K,aspect:e})}catch(d){throw H(d)}const D=await E(l,{html:N({layout:a,cells:n.map((d,c)=>({pictures:[{src:I(c),label:`${d.toFixed(r?3:2)} s`}]}))}),width:a.width,pictures:u}),k=n[0]??0,G=await $(b(t.cwd,t.out,g(`${r?"stretch":"moments"}-${p(k)}-${p(n.at(-1)??k)}`)),D);return{mode:"grid",...h,out:G,cols:a.cols,tiles:n.map((d,c)=>{const f=a.tiles[c];return{t:F(d),...f?{box:[f.x,f.y,f.width,f.height]}:{}}}),...y?{clip:y}:{}}}finally{await l?.close()}}
+import{basename as O,extname as z,resolve as x}from"node:path";import{startBrowser as B}from"@allyhub/browser";import{GRID_WIDTH as K,defaultCols as L,gridHtml as N,gridLayout as R,pixelGridHtml as U,probeVideo as V,stretchFrames as W}from"@allyhub/media";import{EXIT as X}from"@allyhub/protocol";import{videoFrame as C,writeClip as _}from"@allyhub/render";import{CommandError as j}from"../../command.js";import{drawPage as E,gridError as H,isFile as q,looks as J,pictureUrl as I,picturePath as b,save as $,secondsName as p,secondsOf as Q,usage as m,workPath as S}from"./common.js";import{clipKind as Y}from"./piece.js";const F=t=>Math.round(t*1e3)/1e3;export async function fileFrames(t){const s=x(t.cwd,t.file);if(!await q(s))throw new j("not-found",`There is no file ${t.file}.`,{exit:X.notFound});const w=t.from!==void 0||t.to!==void 0;if(w&&(t.from===void 0||t.to===void 0))throw m("bad-option","A stretch needs --from and --to.");if(!w&&t.at===void 0)throw m("missing-moment","A video file needs moments: --at, or --from and --to.","For example --at 1,2.5 or --from 3 --to 4.");if(t.clip!==void 0&&!w)throw m("bad-option","--clip needs --from and --to.");const v=t.clip===void 0?void 0:Y(t.clip),i=await V(s),o=i.fps,M=t.clip===void 0||t.out!==void 0;let r;try{r=t.from!==void 0&&t.to!==void 0?W({from:t.from,to:t.to},{fps:o,duration:i.duration,grid:M}):void 0}catch(e){throw H(e)}const n=r?r.times:Q(t.at??[]);for(const e of n)if(e<0||e>i.duration+1/o)throw m("bad-time",`${e.toFixed(2)} s is outside ${t.file}, which is ${i.duration.toFixed(2)} s long.`);if(t.grid!==void 0&&(n.length!==1||r))throw m("bad-option","--grid draws one moment (one --at) at the file's own size.");const P=Math.max(1,Math.round(i.duration*o)),T=e=>Math.min(Math.round(e*o),Math.max(0,P-1)),h={source:"file",file:s,video:{duration:i.duration,width:i.width,height:i.height,fps:o},...r?{stretch:{from:r.from,to:r.to,every:r.every,frames:r.times.length}}:{}},A=O(s,z(s)),g=e=>x(S(t.root,"frames",A),`${e}.png`);if(n.length===1&&!r&&t.grid===void 0){const e=n[0]??0,a=await $(b(t.cwd,t.out,g(p(e))),await C(s,T(e),o,J()));return{mode:"frame",...h,out:a,t:F(e)}}const u=[];for(const e of n)u.push(await C(s,T(e),o));const y=t.clip!==void 0&&v?await _(u,{file:x(t.cwd,t.clip),type:v,fps:o/(r?.every??1)}):void 0;if(!M)return{mode:"clip",...h,clip:y};let l;try{if(l=await B(t.gpu===void 0?{}:{gpu:t.gpu}),t.grid!==void 0){const d=n[0]??0,c=await E(l,{html:U({src:I(0),width:i.width,height:i.height,step:t.grid}),width:i.width,height:i.height,pictures:u}),f=await $(b(t.cwd,t.out,g(`${p(d)}-grid`)),c);return{mode:"grid",...h,out:f,t:F(d),grid:t.grid}}const e=i.width/i.height;let a;try{a=R({count:n.length,cols:L(n.length,e),width:K,aspect:e})}catch(d){throw H(d)}const D=await E(l,{html:N({layout:a,cells:n.map((d,c)=>({pictures:[{src:I(c),label:`${d.toFixed(r?3:2)} s`}]}))}),width:a.width,pictures:u}),k=n[0]??0,G=await $(b(t.cwd,t.out,g(`${r?"stretch":"moments"}-${p(k)}-${p(n.at(-1)??k)}`)),D);return{mode:"grid",...h,out:G,cols:a.cols,tiles:n.map((d,c)=>{const f=a.tiles[c];return{t:F(d),...f?{box:[f.x,f.y,f.width,f.height]}:{}}}),...y?{clip:y}:{}}}finally{await l?.close()}}

package/dist/commands/frames/page.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{extname as m,resolve as u}from"node:path";import{pathToFileURL as p}from"node:url";import{CaptureError as f,capturePage as d,startBrowser as g}from"@allyhub-next/browser";import{EXIT as c}from"@allyhub-next/protocol";import{CommandError as w}from"../../command.js";import{looks as b,picturePath as x,save as h,usage as k,workPath as $}from"./common.js";function y(e){return(e.protocol==="file:"?(e.pathname.split("/").at(-1)??"page").replace(/\.[^.]*$/u,""):e.hostname).replace(/[^\p{L}\p{N}._-]/gu,"_")||"page"}export async function pageShot(e){const r={};for(const t of e.el??[]){const s=t.indexOf("=");if(s<1)throw k("bad-element",`Write --el ${t} as name=selector.`,'For example --el share="button[aria-label=Share]" or --el menu=text=Settings.');r[t.slice(0,s)]=t.slice(s+1)}const a=/^(https?|file):/u.test(e.url)?new URL(e.url):p(u(e.cwd,e.url)),l=await g(e.gpu===void 0?{}:{gpu:e.gpu});let n;try{n=await d(l,{url:a.href,elements:r,full:e.full,format:b(),...e.click===void 0?{}:{click:e.click},...e.width===void 0?{}:{width:e.width},...e.height===void 0?{}:{height:e.height},...e.scale===void 0?{}:{scale:e.scale},...e.wait===void 0?{}:{wait:e.wait}})}catch(t){throw t instanceof f?new w(t.code,t.message,{exit:t.code==="bad-option"?c.usage:c.notFound,...t.code==="no-element"?{hint:"The selector is wrong, or something must be opened first."}:{}}):t}finally{await l.close()}const i=await h(x(e.cwd,e.out,$(e.root,"pages",`${y(a)}.png`)),n.picture),o=`${i.slice(0,i.length-m(i).length)}.elements.json`;return await h(o,`${JSON.stringify(n.elements,null,2)}
+import{extname as m,resolve as u}from"node:path";import{pathToFileURL as p}from"node:url";import{CaptureError as f,capturePage as d,startBrowser as g}from"@allyhub/browser";import{EXIT as c}from"@allyhub/protocol";import{CommandError as w}from"../../command.js";import{looks as b,picturePath as x,save as h,usage as k,workPath as $}from"./common.js";function y(e){return(e.protocol==="file:"?(e.pathname.split("/").at(-1)??"page").replace(/\.[^.]*$/u,""):e.hostname).replace(/[^\p{L}\p{N}._-]/gu,"_")||"page"}export async function pageShot(e){const r={};for(const t of e.el??[]){const s=t.indexOf("=");if(s<1)throw k("bad-element",`Write --el ${t} as name=selector.`,'For example --el share="button[aria-label=Share]" or --el menu=text=Settings.');r[t.slice(0,s)]=t.slice(s+1)}const a=/^(https?|file):/u.test(e.url)?new URL(e.url):p(u(e.cwd,e.url)),l=await g(e.gpu===void 0?{}:{gpu:e.gpu});let n;try{n=await d(l,{url:a.href,elements:r,full:e.full,format:b(),...e.click===void 0?{}:{click:e.click},...e.width===void 0?{}:{width:e.width},...e.height===void 0?{}:{height:e.height},...e.scale===void 0?{}:{scale:e.scale},...e.wait===void 0?{}:{wait:e.wait}})}catch(t){throw t instanceof f?new w(t.code,t.message,{exit:t.code==="bad-option"?c.usage:c.notFound,...t.code==="no-element"?{hint:"The selector is wrong, or something must be opened first."}:{}}):t}finally{await l.close()}const i=await h(x(e.cwd,e.out,$(e.root,"pages",`${y(a)}.png`)),n.picture),o=`${i.slice(0,i.length-m(i).length)}.elements.json`;return await h(o,`${JSON.stringify(n.elements,null,2)}
 `),{url:a.href,out:i,elementsFile:o,width:n.width,height:n.height,scale:n.scale,elements:n.elements,missing:n.missing}}

package/dist/commands/frames/piece.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{basename as q,resolve as x}from"node:path";import{Mattes as J,DECK_OVERLAY_KEY as Q,OVERLAY_KEY as Z,frameOverlay as v,overlaySvg as tt}from"@allyhub-next/measure";import{DeckPool as et,filmTimes as it,partOf as st}from"@allyhub-next/project";import{GRID_WIDTH as nt,MAX_TILES as H,defaultCols as ot,gridHtml as rt,gridLayout as at,labelSize as dt,probeVideo as ct,sheetHtml as lt,sheetTile as ft,stretchFrames as pt}from"@allyhub-next/media";import{clipTypeOf as ht,ffmpegOf as mt,hasFinalLook as ut,videoFrame as wt,writeClip as gt}from"@allyhub-next/render";import{EXIT as yt}from"@allyhub-next/protocol";import{CommandError as $t}from"../../command.js";import{drawPage as R,gridError as V,isFile as bt,looks as kt,momentOf as xt,pictureUrl as W,picturePath as L,save as P,secondsName as _,usage as F,withCombo as D,workPath as Ft}from"./common.js";const T=t=>Math.round(t*1e3)/1e3,j=t=>({source:"piece",piece:t.target.piece,combo:t.target.combo,...t.target.id===void 0?{}:{id:t.target.id},format:t.target.format}),I=(t,e)=>Ft(e,"frames",t.target.piece);function C(t,e){const i=t.at(-1);return t.find(n=>e>=n.start&&e<n.end)??(i&&e>=i.end?i:void 0)}export async function stillsSheet(t,e){const i=t.timeline,n=t.version.summary?.text??[],h=i.parts.flatMap((a,l)=>{const p=a.steps??[a.still];return p.map(($,d)=>({p:a,t:$,slide:l,step:d,of:p.length}))}),m=i.width/i.height,u=m<1?4:3,y=m<1?1320:1600,r=t.piece.kind==="slides",b=[];if(r){const a=await et.on(t.session,t.piece,t.target,t.version.stage),l=ft({width:y,cols:u});b.push(...await a.stills(h.map(p=>({slide:p.p.key,step:p.step,width:l,format:"webp"}))))}else for(const a of h)b.push(await t.still(a.t));const o=[];for(let a=0;a<h.length;a+=u)o.push({cells:h.slice(a,a+u).map(({p:l,slide:p,step:$,of:d},S)=>{const k=n.find(g=>g.key===l.key);return{image:b[a+S]??Buffer.alloc(0),label:r?`${String(p+1)}${d>1?`.${String($)}`:""} · ${l.key}${l.hidden?" · hidden":""}`:`${l.key} · ${l.still.toFixed(2)} s`,text:k?.notes??k?.spoken??k?.onScreen.join(" · ")??""}})});const E=await R(t.session.browser,{html:lt({title:r?`${t.target.piece} · ${i.parts.length===1?"1 slide":`${String(i.parts.length)} slides`}`:`${t.target.piece} · ${i.parts.length===1?"1 part":`${String(i.parts.length)} parts`} · ${i.duration.toFixed(2)} s`,rows:o,cols:u,width:y,aspect:m}),width:y}),M=await P(L(e.cwd,e.out,x(I(t,e.root),`${D("sheet",t.target)}.png`)),E);return{mode:"sheet",...r?{slides:!0}:{},...j(t),out:M,parts:i.parts.map(a=>({key:a.key,t:T(a.still)}))}}export function clipKind(t){const e=ht(t);if(!e)throw F("bad-clip",`Cannot tell what kind of video ${t} is.`,"End --clip with .gif, .mp4 or .webm.");return e}async function Mt(t,e){if(!await bt(t))throw new $t("not-found",`There is no file ${t} (--beside).`,{exit:yt.notFound});const i=await ct(t),n=Math.max(1,Math.round(i.duration*i.fps)),h=[];for(const m of e){const u=Math.round(m*i.fps);h.push(m<0||u>n-1?void 0:await wt(t,u,i.fps))}return{info:i,shots:h}}export async function pieceMoments(t,e){const i=t.timeline,n=e.part===void 0?void 0:st(i,e.part),h=n?.start??0,m=e.from!==void 0||e.to!==void 0;if(m&&e.at!==void 0)throw F("bad-option","Give --at or --from and --to, not both.");if(m&&(e.from===void 0||e.to===void 0))throw F("bad-option","A stretch needs --from and --to.");if(e.clip!==void 0&&!m)throw F("bad-option","--clip needs --from and --to.","For example --from 3.2 --to 4.4 --clip move.gif.");const u=e.clip===void 0?void 0:clipKind(e.clip),y=e.clip===void 0||e.out!==void 0;let r;try{r=e.from!==void 0&&e.to!==void 0?pt({from:h+e.from,to:h+e.to},{fps:i.fps,duration:i.duration,grid:y}):void 0}catch(s){throw V(s)}const b=(e.at??[]).map(xt),o=r?r.times:b.length===0&&n?[n.still]:it(b,i.parts,n);if(o.length>H&&y)throw F("bad-time",`${String(o.length)} moments; one picture holds at most ${String(H)}.`);for(const s of o)if(s<0||s>i.duration+1/i.fps)throw F("bad-time",`${s.toFixed(2)} s is outside ${t.target.piece}, which is ${i.duration.toFixed(2)} s long.`,n?`With --part, --at counts from the part's start; ${n.key} runs ${n.start.toFixed(2)}–${n.end.toFixed(2)} s.`:`Parts: ${i.parts.map(c=>`${c.key} ${c.start.toFixed(2)}–${c.end.toFixed(2)}`).join(", ")}.`);const E=s=>Math.min(s,i.duration),M={...j(t),final:ut(t.look,i),...r?{stretch:{from:r.from,to:r.to,every:r.every,frames:r.times.length}}:{}};if(o.length===1&&!r&&!e.overlay&&e.beside===void 0){const s=o[0]??0,c=n?.key??C(i.parts,s)?.key??"",f=await P(L(e.cwd,e.out,x(I(t,e.root),`${D(e.at===void 0&&n?n.key:_(s),t.target)}.png`)),await t.still(E(s),{format:kt()}));return{mode:"frame",...M,out:f,t:T(s),part:c,width:i.width,height:i.height}}const l=[];for(const s of o)l.push(await t.still(E(s)));const p=e.clip!==void 0&&u?await gt(l,{file:x(e.cwd,e.clip),type:u,fps:i.fps/(r?.every??1)}):void 0;if(!y)return{mode:"clip",...M,clip:p};const $=[];if(e.overlay){const s=i.duration-1/i.fps,c=await t.version.measure(o.map(w=>Math.min(w,s))),f=new J({root:t.prepared.root,media:t.prepared.media,ffmpeg:await mt()});for(const w of o)$.push(await v(Math.min(w,s),i,c,t.prepared.media,f))}const d=e.beside===void 0?void 0:await Mt(x(e.cwd,e.beside),o),S=d?2:1,k=i.width/i.height;let g;try{g=at({count:o.length,cols:ot(o.length,k*S),width:nt,aspect:k*S})}catch(s){throw V(s)}const K=(g.tiles[0]?.width??i.width)/S,G=Math.max(11,dt(K)-4),A=[...l],X=d?q(e.beside??""):"",z=o.map((s,c)=>{const f=$[c],w={src:W(c),label:t.piece.kind==="slides"?C(i.parts,s)?.key??"":`${s.toFixed(r?3:2)} s · ${C(i.parts,s)?.key??""}`,...f?{over:tt(f,i.width,i.height,K/i.width,G)}:{}};if(!d)return{pictures:[w]};const O=d.shots[c];return O&&A.push(O),{pictures:[{src:O?W(A.length-1):void 0,label:`${X} · ${s.toFixed(2)} s${O?"":" · past its end"}`},w]}}),B=await R(t.session.browser,{html:rt({layout:g,cells:z,...e.overlay?{legend:t.piece.kind==="slides"?Q:Z}:{}}),width:g.width,pictures:A}),Y=o[0]??0,N=o.at(-1)??Y,U=await P(L(e.cwd,e.out,x(I(t,e.root),`${D(`${r?"stretch":"moments"}-${_(Y)}-${_(N)}`,t.target)}.png`)),B);return{mode:"grid",...M,out:U,cols:g.cols,tiles:o.map((s,c)=>{const f=g.tiles[c],w=$[c];return{t:T(s),part:C(i.parts,s)?.key??"",...f?{box:[f.x,f.y,f.width,f.height]}:{},...w?{overlay:w}:{},...d?{beside:{t:T(s),shown:d.shots[c]!==void 0}}:{}}}),...d?{beside:{file:x(e.cwd,e.beside??""),video:{duration:d.info.duration,width:d.info.width,height:d.info.height,fps:d.info.fps}}}:{},...p?{clip:p}:{}}}
+import{basename as q,resolve as x}from"node:path";import{Mattes as J,DECK_OVERLAY_KEY as Q,OVERLAY_KEY as Z,frameOverlay as v,overlaySvg as tt}from"@allyhub/measure";import{DeckPool as et,filmTimes as it,partOf as st}from"@allyhub/project";import{GRID_WIDTH as nt,MAX_TILES as H,defaultCols as ot,gridHtml as rt,gridLayout as at,labelSize as dt,probeVideo as ct,sheetHtml as lt,sheetTile as ft,stretchFrames as pt}from"@allyhub/media";import{clipTypeOf as ht,ffmpegOf as mt,hasFinalLook as ut,videoFrame as wt,writeClip as gt}from"@allyhub/render";import{EXIT as yt}from"@allyhub/protocol";import{CommandError as $t}from"../../command.js";import{drawPage as R,gridError as V,isFile as bt,looks as kt,momentOf as xt,pictureUrl as W,picturePath as L,save as P,secondsName as _,usage as F,withCombo as D,workPath as Ft}from"./common.js";const T=t=>Math.round(t*1e3)/1e3,j=t=>({source:"piece",piece:t.target.piece,combo:t.target.combo,...t.target.id===void 0?{}:{id:t.target.id},format:t.target.format}),I=(t,e)=>Ft(e,"frames",t.target.piece);function C(t,e){const i=t.at(-1);return t.find(n=>e>=n.start&&e<n.end)??(i&&e>=i.end?i:void 0)}export async function stillsSheet(t,e){const i=t.timeline,n=t.version.summary?.text??[],h=i.parts.flatMap((a,l)=>{const p=a.steps??[a.still];return p.map(($,d)=>({p:a,t:$,slide:l,step:d,of:p.length}))}),m=i.width/i.height,u=m<1?4:3,y=m<1?1320:1600,r=t.piece.kind==="slides",b=[];if(r){const a=await et.on(t.session,t.piece,t.target,t.version.stage),l=ft({width:y,cols:u});b.push(...await a.stills(h.map(p=>({slide:p.p.key,step:p.step,width:l,format:"webp"}))))}else for(const a of h)b.push(await t.still(a.t));const o=[];for(let a=0;a<h.length;a+=u)o.push({cells:h.slice(a,a+u).map(({p:l,slide:p,step:$,of:d},S)=>{const k=n.find(g=>g.key===l.key);return{image:b[a+S]??Buffer.alloc(0),label:r?`${String(p+1)}${d>1?`.${String($)}`:""} · ${l.key}${l.hidden?" · hidden":""}`:`${l.key} · ${l.still.toFixed(2)} s`,text:k?.notes??k?.spoken??k?.onScreen.join(" · ")??""}})});const E=await R(t.session.browser,{html:lt({title:r?`${t.target.piece} · ${i.parts.length===1?"1 slide":`${String(i.parts.length)} slides`}`:`${t.target.piece} · ${i.parts.length===1?"1 part":`${String(i.parts.length)} parts`} · ${i.duration.toFixed(2)} s`,rows:o,cols:u,width:y,aspect:m}),width:y}),M=await P(L(e.cwd,e.out,x(I(t,e.root),`${D("sheet",t.target)}.png`)),E);return{mode:"sheet",...r?{slides:!0}:{},...j(t),out:M,parts:i.parts.map(a=>({key:a.key,t:T(a.still)}))}}export function clipKind(t){const e=ht(t);if(!e)throw F("bad-clip",`Cannot tell what kind of video ${t} is.`,"End --clip with .gif, .mp4 or .webm.");return e}async function Mt(t,e){if(!await bt(t))throw new $t("not-found",`There is no file ${t} (--beside).`,{exit:yt.notFound});const i=await ct(t),n=Math.max(1,Math.round(i.duration*i.fps)),h=[];for(const m of e){const u=Math.round(m*i.fps);h.push(m<0||u>n-1?void 0:await wt(t,u,i.fps))}return{info:i,shots:h}}export async function pieceMoments(t,e){const i=t.timeline,n=e.part===void 0?void 0:st(i,e.part),h=n?.start??0,m=e.from!==void 0||e.to!==void 0;if(m&&e.at!==void 0)throw F("bad-option","Give --at or --from and --to, not both.");if(m&&(e.from===void 0||e.to===void 0))throw F("bad-option","A stretch needs --from and --to.");if(e.clip!==void 0&&!m)throw F("bad-option","--clip needs --from and --to.","For example --from 3.2 --to 4.4 --clip move.gif.");const u=e.clip===void 0?void 0:clipKind(e.clip),y=e.clip===void 0||e.out!==void 0;let r;try{r=e.from!==void 0&&e.to!==void 0?pt({from:h+e.from,to:h+e.to},{fps:i.fps,duration:i.duration,grid:y}):void 0}catch(s){throw V(s)}const b=(e.at??[]).map(xt),o=r?r.times:b.length===0&&n?[n.still]:it(b,i.parts,n);if(o.length>H&&y)throw F("bad-time",`${String(o.length)} moments; one picture holds at most ${String(H)}.`);for(const s of o)if(s<0||s>i.duration+1/i.fps)throw F("bad-time",`${s.toFixed(2)} s is outside ${t.target.piece}, which is ${i.duration.toFixed(2)} s long.`,n?`With --part, --at counts from the part's start; ${n.key} runs ${n.start.toFixed(2)}–${n.end.toFixed(2)} s.`:`Parts: ${i.parts.map(c=>`${c.key} ${c.start.toFixed(2)}–${c.end.toFixed(2)}`).join(", ")}.`);const E=s=>Math.min(s,i.duration),M={...j(t),final:ut(t.look,i),...r?{stretch:{from:r.from,to:r.to,every:r.every,frames:r.times.length}}:{}};if(o.length===1&&!r&&!e.overlay&&e.beside===void 0){const s=o[0]??0,c=n?.key??C(i.parts,s)?.key??"",f=await P(L(e.cwd,e.out,x(I(t,e.root),`${D(e.at===void 0&&n?n.key:_(s),t.target)}.png`)),await t.still(E(s),{format:kt()}));return{mode:"frame",...M,out:f,t:T(s),part:c,width:i.width,height:i.height}}const l=[];for(const s of o)l.push(await t.still(E(s)));const p=e.clip!==void 0&&u?await gt(l,{file:x(e.cwd,e.clip),type:u,fps:i.fps/(r?.every??1)}):void 0;if(!y)return{mode:"clip",...M,clip:p};const $=[];if(e.overlay){const s=i.duration-1/i.fps,c=await t.version.measure(o.map(w=>Math.min(w,s))),f=new J({root:t.prepared.root,media:t.prepared.media,ffmpeg:await mt()});for(const w of o)$.push(await v(Math.min(w,s),i,c,t.prepared.media,f))}const d=e.beside===void 0?void 0:await Mt(x(e.cwd,e.beside),o),S=d?2:1,k=i.width/i.height;let g;try{g=at({count:o.length,cols:ot(o.length,k*S),width:nt,aspect:k*S})}catch(s){throw V(s)}const K=(g.tiles[0]?.width??i.width)/S,G=Math.max(11,dt(K)-4),A=[...l],X=d?q(e.beside??""):"",z=o.map((s,c)=>{const f=$[c],w={src:W(c),label:t.piece.kind==="slides"?C(i.parts,s)?.key??"":`${s.toFixed(r?3:2)} s · ${C(i.parts,s)?.key??""}`,...f?{over:tt(f,i.width,i.height,K/i.width,G)}:{}};if(!d)return{pictures:[w]};const O=d.shots[c];return O&&A.push(O),{pictures:[{src:O?W(A.length-1):void 0,label:`${X} · ${s.toFixed(2)} s${O?"":" · past its end"}`},w]}}),B=await R(t.session.browser,{html:rt({layout:g,cells:z,...e.overlay?{legend:t.piece.kind==="slides"?Q:Z}:{}}),width:g.width,pictures:A}),Y=o[0]??0,N=o.at(-1)??Y,U=await P(L(e.cwd,e.out,x(I(t,e.root),`${D(`${r?"stretch":"moments"}-${_(Y)}-${_(N)}`,t.target)}.png`)),B);return{mode:"grid",...M,out:U,cols:g.cols,tiles:o.map((s,c)=>{const f=g.tiles[c],w=$[c];return{t:T(s),part:C(i.parts,s)?.key??"",...f?{box:[f.x,f.y,f.width,f.height]}:{},...w?{overlay:w}:{},...d?{beside:{t:T(s),shown:d.shots[c]!==void 0}}:{}}}),...d?{beside:{file:x(e.cwd,e.beside??""),video:{duration:d.info.duration,width:d.info.width,height:d.info.height,fps:d.info.fps}}}:{},...p?{clip:p}:{}}}

package/dist/commands/frames/sheet.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{readFileSync as w}from"node:fs";import{dirname as $,join as l}from"node:path";import{startBrowser as x}from"@allyhub-next/browser";import{EXIT as b}from"@allyhub-next/protocol";import{SHEET_FONT as y,sheetFontsCss as S}from"@allyhub-next/render/doc";import{columnIndex as p,readArea as A,sheetHtml as E}from"@allyhub-next/sheet";import{CommandError as M}from"../../command.js";import{openSheet as N}from"../sheet.js";import{drawPage as k,picturePath as I,save as T,workPath as C}from"./common.js";export const SHEET_ROWS=200,SHEET_COLUMNS=60;const g=12;function F(e,a){const c=e.used;if(!c)return;const u=/^\$?([A-Za-z]{1,3}):\$?([A-Za-z]{1,3})$/u.exec(a);if(u){const t=p(u[1]??""),n=p(u[2]??"");return t===void 0||n===void 0?void 0:{...c,left:Math.min(t,n),right:Math.max(t,n)}}const o=/^\$?(\d+):\$?(\d+)$/u.exec(a);if(!o)return;const m=Number(o[1])-1,s=Number(o[2])-1;return{...c,top:Math.min(m,s),bottom:Math.max(m,s)}}const H=e=>e.replace(/^'|'$/gu,"").replaceAll("''","'");export async function sheetPicture(e){const{workbook:a,calc:c,file:u}=await N(e.root,e.cwd,e.item),o=$(u),m=r=>{throw new M("not-found",`${r} is not a sheet or a range of this workbook.`,{exit:b.notFound,hint:`Sheets: ${a.sheets.map(i=>i.name).join(", ")}. A range is Summary!B3:D9, or B3:D9 on the first sheet.`})};let s,t;if(e.range!==void 0){const r=a.sheet(e.range);if(r)s=[r];else{const i=e.range.lastIndexOf("!"),f=i<0?a.sheets[0]:a.sheet(H(e.range.slice(0,i))),h=e.range.slice(i+1);if(!f||(t=A(h)??F(f,h),!t))return m(e.range);s=[f]}}const n=E(c,{...s?{sheets:s}:{},...t?{area:t}:{rows:SHEET_ROWS,columns:SHEET_COLUMNS},headings:!0,css:`body{padding:${String(g)}px}`,font:y,file:r=>{try{return new Uint8Array(w(l(e.root,o,r)))}catch{return}}}),d=await x({gpu:!1,htmlInCanvas:!1});try{const r=await k(d,{html:n.html.replace("<style>",`<style>${await S(n.html)}`),width:n.width+2*g}),i=e.range===void 0?"sheet":e.range.replace(/[^\p{L}\p{N}]+/gu,"-").replace(/^-+|-+$/gu,""),f=await T(I(e.cwd,e.out,l(C(e.root,"frames",o),`${i||"sheet"}.png`)),r);return{mode:"frame",source:"sheet",sheet:o,out:f,...e.range===void 0?{}:{range:e.range},cut:n.cut}}finally{await d.close()}}
+import{readFileSync as w}from"node:fs";import{dirname as $,join as l}from"node:path";import{startBrowser as x}from"@allyhub/browser";import{EXIT as b}from"@allyhub/protocol";import{SHEET_FONT as y,sheetFontsCss as S}from"@allyhub/render/doc";import{columnIndex as p,readArea as A,sheetHtml as E}from"@allyhub/sheet";import{CommandError as M}from"../../command.js";import{openSheet as N}from"../sheet.js";import{drawPage as k,picturePath as I,save as T,workPath as C}from"./common.js";export const SHEET_ROWS=200,SHEET_COLUMNS=60;const g=12;function F(e,a){const c=e.used;if(!c)return;const u=/^\$?([A-Za-z]{1,3}):\$?([A-Za-z]{1,3})$/u.exec(a);if(u){const t=p(u[1]??""),n=p(u[2]??"");return t===void 0||n===void 0?void 0:{...c,left:Math.min(t,n),right:Math.max(t,n)}}const o=/^\$?(\d+):\$?(\d+)$/u.exec(a);if(!o)return;const m=Number(o[1])-1,s=Number(o[2])-1;return{...c,top:Math.min(m,s),bottom:Math.max(m,s)}}const H=e=>e.replace(/^'|'$/gu,"").replaceAll("''","'");export async function sheetPicture(e){const{workbook:a,calc:c,file:u}=await N(e.root,e.cwd,e.item),o=$(u),m=r=>{throw new M("not-found",`${r} is not a sheet or a range of this workbook.`,{exit:b.notFound,hint:`Sheets: ${a.sheets.map(i=>i.name).join(", ")}. A range is Summary!B3:D9, or B3:D9 on the first sheet.`})};let s,t;if(e.range!==void 0){const r=a.sheet(e.range);if(r)s=[r];else{const i=e.range.lastIndexOf("!"),f=i<0?a.sheets[0]:a.sheet(H(e.range.slice(0,i))),h=e.range.slice(i+1);if(!f||(t=A(h)??F(f,h),!t))return m(e.range);s=[f]}}const n=E(c,{...s?{sheets:s}:{},...t?{area:t}:{rows:SHEET_ROWS,columns:SHEET_COLUMNS},headings:!0,css:`body{padding:${String(g)}px}`,font:y,file:r=>{try{return new Uint8Array(w(l(e.root,o,r)))}catch{return}}}),d=await x({gpu:!1,htmlInCanvas:!1});try{const r=await k(d,{html:n.html.replace("<style>",`<style>${await S(n.html)}`),width:n.width+2*g}),i=e.range===void 0?"sheet":e.range.replace(/[^\p{L}\p{N}]+/gu,"-").replace(/^-+|-+$/gu,""),f=await T(I(e.cwd,e.out,l(C(e.root,"frames",o),`${i||"sheet"}.png`)),r);return{mode:"frame",source:"sheet",sheet:o,out:f,...e.range===void 0?{}:{range:e.range},cut:n.cut}}finally{await d.close()}}

package/dist/commands/frames.js

@@ -1,9 +1,10 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as t}from"zod";import{formatConsole as z,formatProblem as W}from"../text/index.js";import{COMPARE_DEFAULTS as M,CUT_REVIEW_DEFAULTS as I,cutLine as L,dbText as $,silenceText as _}from"@allyhub-next/measure";import{consoleJson as j}from"@allyhub-next/project";import{PAGE_CAPTURE_DEFAULTS as y}from"@allyhub-next/browser";import{EXIT as k}from"@allyhub-next/protocol";import{defineCommand as f}from"../command.js";import{dir as T}from"../fields.js";import{parameters as A}from"../parameters.js";import{projectRoot as u}from"../project.js";import{VERSION_FIELDS as v,commandError as F,withVersion as h}from"../version.js";import{compareText as O,comparePictures as C}from"./frames/compare.js";import{isPicture as R,isVideo as E,usage as p}from"./frames/common.js";import{cutSheets as B}from"./frames/cuts.js";import{fileFrames as H}from"./frames/file.js";import{pageShot as N}from"./frames/page.js";import{pieceMoments as U,stillsSheet as G}from"./frames/piece.js";import{sheetPicture as V}from"./frames/sheet.js";import{findSheet as J}from"./sheet.js";import{sizeOf as q}from"./scenery-input.js";function g(e){return[...e.problems.filter(a=>a.level==="error").map(W),...z(j(e.console))]}const b=e=>({problems:e.problems,...j(e.console)}),S=(e,l)=>u(e,l),X=t.strictObject({...v,item:t.string().optional().describe("The piece (its id, or a path into it; default the project's only one), a sheet, or a video file: a path ending in .mp4, .mov, .webm, .m4v, .qt, .mkv or .avi is a file"),range:t.string().optional().describe("A sheet's: what to draw, a sheet (Summary), a range (Summary!B3:D9, or B3:D9 on the first sheet), columns (A:C) or rows (1:20); default its sheets, from A1"),at:t.array(t.string()).optional().describe("Moments: seconds (from the start of --part when given) or anchors (@press, @/map a stretch's end, @press+0.2); a video file's are seconds. One is written as the frame itself, several are tiled. Without it, --part's still, or every part's still on one sheet"),part:t.string().optional().describe("The part --at, --from and --to count from; alone, its still"),from:t.number().optional().describe("A stretch of consecutive frames from this second (with --to), instead of --at"),to:t.number().optional().describe("The stretch's last second"),clip:t.string().optional().describe("Write the stretch as a small silent video, .gif, .mp4 or .webm by its extension; with --out, the grid too"),overlay:t.boolean().default(!1).describe("Draw over each tile the face boxes with ids, the person matte's outline, the covered areas and the text boxes (a deck's: each shape's box and name, and the lines nearly in line); places nothing. Alone, over every part's still"),beside:t.string().optional().describe("Another video file (a reference) whose frame at the same time goes on each tile's left"),grid:t.number().int().min(4).optional().describe("A video file at one --at: the frame at its own size with numbered lines every this many pixels"),out:t.string().optional().describe("Where the picture goes, always a WebP whatever the extension; default under .allyhub/work/frames/")});function K(e){const l=[["--combo",e.combo!==void 0],["--part",e.part!==void 0],["--beside",e.beside!==void 0],["--overlay",e.overlay]].filter(([,a])=>a).map(([a])=>a);if(l.length>0)throw p("bad-option",`${l.join(" and ")} ${l.length===1?"is":"are"} a piece's: a video file has no combos or parts.`)}export const frames=f({name:"frames",summary:"Pictures of a piece over time, drawn as the render draws them: every part's still on a sheet (default), a moment, a stretch tiled or as a clip, overlays; a sheet's cells, or a range of them; or any video file's frames",input:X,positional:["item"],output:t.looseObject({mode:t.enum(["sheet","frame","grid","clip"])}),examples:["allyhub frames launch/film","allyhub frames launch/film --at 2.5","allyhub frames launch/film --part hook --from 0 --to 1 --clip hook.gif","allyhub frames launch/film --at 1,2,3 --overlay","allyhub frames reference.mp4 --at 0,1,2","allyhub frames reference.mp4 --at 3 --grid 50","allyhub frames finance/budget --range 'Summary!A1:F20'"]},async(e,l)=>{const a=l.cwd;if(e.item!==void 0&&E(e.item)){K(e);const r=await H({cwd:a,root:await S(a,e.dir),file:e.item,at:e.at,from:e.from,to:e.to,clip:e.clip,out:e.out,grid:e.grid}).catch(P=>{throw F(P)}),c=r.video,w=`${r.file} · ${c.duration.toFixed(2)} s · ${String(c.width)}×${String(c.height)} · ${String(c.fps)} fps`,x="clip"in r&&r.clip?`${r.clip.out} (${r.clip.type}, ${String(r.clip.frames)} frames at ${String(r.clip.fps)} fps, no sound)`:void 0;return{value:r,text:[w,..."out"in r?[`${r.out}${"tiles"in r?` (${String(r.tiles.length)} moments in ${String(r.cols)} columns)`:""}`]:[],...x?[x]:[]].join(`
-`)}}if(e.grid!==void 0)throw p("bad-option","--grid draws a video file's frame at its own size: give the file.");const d=await u(a,e.dir);if(e.item!==void 0&&await J(d,a,e.item)!==void 0){const r=await V({cwd:a,root:d,item:e.item,range:e.range,out:e.out});return{value:r,text:[r.out,...r.cut].join(`
-`)}}if(e.range!==void 0)throw p("bad-option","--range is a sheet's: name the sheet.");const i=e.at!==void 0||e.part!==void 0||e.from!==void 0||e.to!==void 0;if(!i&&(e.clip!==void 0||e.beside!==void 0))throw p("bad-option","--clip and --beside draw moments: give --at, --part, or --from and --to.");if(!i&&!e.overlay){const{result:r,...c}=await h(e,l,"render",w=>G(w,{cwd:a,root:d,out:e.out}));return{value:{...r,...b(c)},text:[`${r.out} (${r.piece} · ${r.format} · ${String(r.parts.length)} ${"slides"in r?"slide":"part"}${r.parts.length===1?"":"s"})`,...g(c)].join(`
-`)}}const n=!i&&e.overlay,{result:o,...m}=await h(e,l,"render",r=>U(r,{cwd:a,root:d,at:n?r.timeline.parts.map(c=>String(c.still)):e.at,part:e.part,from:e.from,to:e.to,clip:e.clip,out:e.out,overlay:e.overlay,beside:e.beside})),s=[];if(o.mode==="frame"&&s.push(`${o.out} (${o.piece} · ${o.format} · ${o.part} · ${o.t.toFixed(2)} s)`),o.mode==="grid"){s.push(`${o.out} (${o.piece} · ${String(o.tiles.length)} moments in ${String(o.cols)} columns)`,`  ${o.tiles.map(c=>`${c.t.toFixed(o.stretch?3:2)} ${c.part}`).join(" · ")}`);const r=[...new Set(o.tiles.flatMap(c=>c.overlay?.missing??[]))];r.length>0&&s.push(`  Not measured: ${r.join(", ")}.`)}return o.stretch&&s.push(`  Stretch ${o.stretch.from.toFixed(3)}–${o.stretch.to.toFixed(3)} s, one frame in ${String(o.stretch.every)}: ${String(o.stretch.frames)} frames.`),"clip"in o&&o.clip&&s.push(`${o.clip.out} (${o.clip.type}, ${String(o.clip.frames)} frames at ${String(o.clip.fps)} fps, no sound)`),{value:{...o,...b(m)},text:[...s,...g(m)].join(`
-`)}}),framesCuts=f({name:"frames cuts",summary:"A review sheet per cut of a video (a cut take's jumps, part joins, a scenery camera's cuts): frames around it, waveform and level, the words each side, the sound at it",input:t.strictObject({...v,part:t.string().optional().describe("Only this part's cuts and its joins"),out:t.string().optional().describe("The folder the sheets go in; default .allyhub/work/cuts/"),params:A({span:t.number().positive().max(10).default(I.span).describe("Seconds shown on each side of a cut")})}),positional:["item"],output:t.looseObject({out:t.string(),cuts:t.array(t.looseObject({sheet:t.string()}))}),examples:["allyhub frames cuts launch/film","allyhub frames cuts launch/film --part hook"]},async(e,l)=>{const a=l.cwd,d=await u(a,e.dir),{result:i,...n}=await h(e,l,"render",s=>B(s,{cwd:a,root:d,part:e.part,out:e.out,review:{span:e.params.span}})),o=i.part===void 0?`${String(i.cuts.length)} cut${i.cuts.length===1?"":"s"}`:`${String(i.cuts.length)} of ${String(i.total)} cuts (part ${i.part} and its joins)`,m=[`${i.piece} · ${i.format} · ${o}; silence is sound under ${String(i.threshold)} dBFS`];for(const s of i.cuts){const r=s.sound?`level ${$(s.sound.levelDb)} / around ${$(s.sound.aroundDb)} dBFS, peak ${$(s.sound.peakDb)}, step ${s.sound.jumpDb<0?"−":"+"}${Math.abs(s.sound.jumpDb).toFixed(1)} dB`:"no sound";m.push(`${String(s.index).padStart(3)}  ${s.t.toFixed(3).padStart(7)} s  ${s.kind.padEnd(6)}  ${L(s)}`,`       silence at the cut: ${_(s.silence)} · ${r}`,`       “${s.said.before}” | “${s.said.after}”${s.across?` · across the cut: “${s.across}”`:""}`,`       ${s.sheet}`)}return{value:{...i,...b(n)},text:[...m,...g(n)].join(`
-`)}});const D=M;export const framesCompare=f({name:"frames compare",summary:"How a candidate picture differs from a reference, as numbers (ΔE, channels, SSIM, levels, grain, edges, regions) with a heatmap and a side-by-side: a piece's moment, a picture file or a video file's frame",input:t.strictObject({reference:t.string().describe("The reference picture (PNG, WebP, JPEG…)"),candidate:t.string().optional().describe("A piece (its id, or a path into it; default the project's only one) at --at or --part's still; or a file by its extension: a picture (.png, .jpg, .webp…), or a video file's frame at --at (.mp4, .mov, .webm…)"),combo:v.combo,dir:T,at:t.string().optional().describe("The moment: seconds (from the start of --part when given) or an anchor of the piece; a video file's are seconds (default 0)"),part:t.string().optional().describe("The piece's part --at counts from; alone, its still"),refCrop:t.string().optional().describe("Cut the reference to x,y,width,height, or to an element of the elements.json beside it (frames web writes one)"),crop:t.string().optional().describe("Cut the candidate to x,y,width,height before any resize"),encode:t.string().optional().describe("Draw the candidate through this encode first, as a platform serves it: codec:kbps, h264 or hevc (hevc:618)"),out:t.string().optional().describe("Where its files go, a path without extension; default under .allyhub/work/compare/"),params:A({resize:t.enum(["stretch","width","none"]).default(D.resize).describe("When sizes differ: stretch the candidate to the reference, scale it to its width, or compare the common area"),shift:t.number().int().min(0).max(32).default(D.shift).describe("Search the best offset within this many pixels each way")})}),positional:["reference","candidate"],output:t.looseObject({reference:t.string(),files:t.looseObject({side:t.string(),heatmap:t.string()})}),examples:["allyhub frames compare reference.png launch/film --at 2.5 --encode hevc:618","allyhub frames compare reference.png shot.webp --ref-crop cta","allyhub frames compare reference.png theirs.mp4 --at 3"]},async(e,l)=>{const a=l.cwd,d=e.params,i=e.candidate!==void 0&&(R(e.candidate)||E(e.candidate))?e.candidate:void 0,n=r=>({cwd:a,root:r,reference:e.reference,file:i,at:e.at===void 0?void 0:[e.at],part:e.part,refCrop:e.refCrop,crop:e.crop,encode:e.encode,out:e.out,options:{shift:d.shift,resize:d.resize}});if(i!==void 0){if(e.combo!==void 0||e.part!==void 0)throw p("bad-option","--combo and --part are a piece's: the candidate is a file.");const r=await C(n(await S(a,e.dir)),void 0).catch(c=>{throw F(c)});return{value:r,text:O(r)}}const o=await u(a,e.dir),{result:m,...s}=await h({...e,item:e.candidate},l,"render",r=>C(n(o),r));return{value:{...m,...b(s)},text:[O(m),...g(s)].join(`
-`)}}),framesWeb=f({name:"frames web",summary:"A web page's screenshot with its named elements' boxes in the image's pixels, for a screen demo",input:t.strictObject({url:t.string().describe("The page: an address, or an HTML file on this computer"),el:t.array(t.string()).optional().describe("An element to locate, name=selector (CSS, or text=<words>); [data-el] elements are found too"),click:t.array(t.string()).optional().describe("Selectors clicked in order before the shot (close a banner, open a dialog)"),full:t.boolean().default(!1).describe("The whole page, not one viewport"),out:t.string().optional().describe("Where the picture goes (a WebP), its boxes in <out>.elements.json beside it; default under .allyhub/work/pages/"),dir:T,size:t.string().default(`${String(y.width)}x${String(y.height)}`).describe("The viewport, WIDTHxHEIGHT in CSS pixels"),scale:t.number().min(1).max(4).default(y.scale).describe("Image pixels per CSS pixel; 2 draws a high-density screen, sharp when a camera goes in"),wait:t.number().int().min(0).optional().describe("Milliseconds to wait after loading and clicking")}),positional:["url"],output:t.looseObject({out:t.string(),elementsFile:t.string()}),examples:["allyhub frames web https://example.com --el cta=text=Sign\\ up --scale 2 --out assets/media/home","allyhub frames web page.html --click '#accept' --full"]},async(e,l)=>{const a=l.cwd,[d,i]=q(e.size),n=await N({cwd:a,root:await S(a,e.dir),url:e.url,out:e.out,el:e.el,click:e.click,width:d,height:i,scale:e.scale,full:e.full,wait:e.wait});return{value:n,text:[`${n.out}: ${String(n.width)}×${String(n.height)}${n.scale===1?"":` (${String(n.scale)} image pixels per CSS pixel)`}, ${String(Object.keys(n.elements).length)} elements (${Object.keys(n.elements).join(", ")||"none"}) in ${n.elementsFile}`,...n.missing.length>0?[`Not found: ${n.missing.join(", ")} (the selector is wrong, or something must be opened with --click first).`]:[]].join(`
-`),exit:n.missing.length>0?k.failed:k.ok}}),FRAMES_COMMANDS=[frames,framesCuts,framesCompare,framesWeb];
+import{z as t}from"zod";import{formatConsole as W,formatProblem as M}from"../text/index.js";import{COMPARE_DEFAULTS as I,CUT_REVIEW_DEFAULTS as L,cutLine as _,dbText as y,silenceText as R}from"@allyhub/measure";import{consoleJson as k}from"@allyhub/project";import{PAGE_CAPTURE_DEFAULTS as v}from"@allyhub/browser";import{EXIT as T}from"@allyhub/protocol";import{defineCommand as h}from"../command.js";import{dir as A}from"../fields.js";import{parameters as F}from"../parameters.js";import{projectRoot as g}from"../project.js";import{VERSION_FIELDS as S,commandError as O,withVersion as b}from"../version.js";import{compareText as C,comparePictures as D}from"./frames/compare.js";import{isPicture as B,isVideo as E,usage as m}from"./frames/common.js";import{cutSheets as H}from"./frames/cuts.js";import{fileFrames as N}from"./frames/file.js";import{pageShot as U}from"./frames/page.js";import{pieceMoments as G,stillsSheet as V}from"./frames/piece.js";import{docPicture as J,findDoc as q}from"./frames/doc.js";import{sheetPicture as X}from"./frames/sheet.js";import{findSheet as K}from"./sheet.js";import{sizeOf as Q}from"./scenery-input.js";function w(e){return[...e.problems.filter(a=>a.level==="error").map(M),...W(k(e.console))]}const $=e=>({problems:e.problems,...k(e.console)}),x=(e,s)=>g(e,s),Y=t.strictObject({...S,item:t.string().optional().describe("The piece (its id, or a path into it; default the project's only one), a sheet, a doc, or a video file: a path ending in .mp4, .mov, .webm, .m4v, .qt, .mkv or .avi is a file"),range:t.string().optional().describe("A sheet's: what to draw, a sheet (Summary), a range (Summary!B3:D9, or B3:D9 on the first sheet), columns (A:C) or rows (1:20); default its sheets, from A1"),page:t.string().optional().describe("A doc's: the pages to draw large, counted from 1 (2, 2-4, 1,5); default every page, small, tiled"),at:t.array(t.string()).optional().describe("Moments: seconds (from the start of --part when given) or anchors (@press, @/map a stretch's end, @press+0.2); a video file's are seconds. One is written as the frame itself, several are tiled. Without it, --part's still, or every part's still on one sheet"),part:t.string().optional().describe("The part --at, --from and --to count from; alone, its still"),from:t.number().optional().describe("A stretch of consecutive frames from this second (with --to), instead of --at"),to:t.number().optional().describe("The stretch's last second"),clip:t.string().optional().describe("Write the stretch as a small silent video, .gif, .mp4 or .webm by its extension; with --out, the grid too"),overlay:t.boolean().default(!1).describe("Draw over each tile the face boxes with ids, the person matte's outline, the covered areas and the text boxes (a deck's: each shape's box and name, and the lines nearly in line); places nothing. Alone, over every part's still"),beside:t.string().optional().describe("Another video file (a reference) whose frame at the same time goes on each tile's left"),grid:t.number().int().min(4).optional().describe("A video file at one --at: the frame at its own size with numbered lines every this many pixels"),out:t.string().optional().describe("Where the picture goes, always a WebP whatever the extension; default under .allyhub/work/frames/")});function Z(e){const s=[["--combo",e.combo!==void 0],["--part",e.part!==void 0],["--beside",e.beside!==void 0],["--overlay",e.overlay]].filter(([,a])=>a).map(([a])=>a);if(s.length>0)throw m("bad-option",`${s.join(" and ")} ${s.length===1?"is":"are"} a piece's: a video file has no combos or parts.`)}function ee(e){const s=[["--at",e.at!==void 0],["--part",e.part!==void 0],["--from",e.from!==void 0],["--to",e.to!==void 0],["--clip",e.clip!==void 0],["--overlay",e.overlay],["--beside",e.beside!==void 0],["--range",e.range!==void 0],["--combo",e.combo!==void 0]].filter(([,a])=>a).map(([a])=>a);if(s.length>0)throw m("bad-option",`${s.join(" and ")} ${s.length===1?"is":"are"} not a doc's: a doc has pages (--page), not moments.`)}export const frames=h({name:"frames",summary:"Pictures of a piece over time, drawn as the render draws them: every part's still on a sheet (default), a moment, a stretch tiled or as a clip, overlays; a sheet's cells, or a range of them; a doc's pages as they print, with how many; or any video file's frames",input:Y,positional:["item"],output:t.looseObject({mode:t.enum(["sheet","frame","grid","clip"])}),examples:["allyhub frames launch/film","allyhub frames launch/film --at 2.5","allyhub frames launch/film --part hook --from 0 --to 1 --clip hook.gif","allyhub frames launch/film --at 1,2,3 --overlay","allyhub frames reference.mp4 --at 0,1,2","allyhub frames reference.mp4 --at 3 --grid 50","allyhub frames finance/budget --range 'Summary!A1:F20'","allyhub frames launch/plan","allyhub frames launch/plan --page 2-3"]},async(e,s)=>{const a=s.cwd;if(e.item!==void 0&&E(e.item)){Z(e);const r=await N({cwd:a,root:await x(a,e.dir),file:e.item,at:e.at,from:e.from,to:e.to,clip:e.clip,out:e.out,grid:e.grid}).catch(z=>{throw O(z)}),c=r.video,u=`${r.file} · ${c.duration.toFixed(2)} s · ${String(c.width)}×${String(c.height)} · ${String(c.fps)} fps`,j="clip"in r&&r.clip?`${r.clip.out} (${r.clip.type}, ${String(r.clip.frames)} frames at ${String(r.clip.fps)} fps, no sound)`:void 0;return{value:r,text:[u,..."out"in r?[`${r.out}${"tiles"in r?` (${String(r.tiles.length)} moments in ${String(r.cols)} columns)`:""}`]:[],...j?[j]:[]].join(`
+`)}}if(e.grid!==void 0)throw m("bad-option","--grid draws a video file's frame at its own size: give the file.");const p=await g(a,e.dir);if(e.item!==void 0&&await K(p,a,e.item)!==void 0){const r=await X({cwd:a,root:p,item:e.item,range:e.range,out:e.out});return{value:r,text:[r.out,...r.cut].join(`
+`)}}const l=e.item===void 0?void 0:await q(p,a,e.item);if(l!==void 0){ee(e);const r=await J({cwd:a,root:p,file:l,page:e.page,out:e.out,progress:u=>{s.progress(u)}}),c=r.drawn.length===r.pages?"every page":`page${r.drawn.length===1?"":"s"} ${r.drawn.join(", ")}`;return{value:r,text:[r.out,`${r.doc}: ${String(r.pages)} page${r.pages===1?"":"s"} on ${String(r.paper.width)} × ${String(r.paper.height)} mm paper; ${c} drawn`].join(`
+`)}}if(e.page!==void 0)throw m("bad-option","--page is a doc's: name the doc.");if(e.range!==void 0)throw m("bad-option","--range is a sheet's: name the sheet.");const i=e.at!==void 0||e.part!==void 0||e.from!==void 0||e.to!==void 0;if(!i&&(e.clip!==void 0||e.beside!==void 0))throw m("bad-option","--clip and --beside draw moments: give --at, --part, or --from and --to.");if(!i&&!e.overlay){const{result:r,...c}=await b(e,s,"render",u=>V(u,{cwd:a,root:p,out:e.out}));return{value:{...r,...$(c)},text:[`${r.out} (${r.piece} · ${r.format} · ${String(r.parts.length)} ${"slides"in r?"slide":"part"}${r.parts.length===1?"":"s"})`,...w(c)].join(`
+`)}}const f=!i&&e.overlay,{result:o,...n}=await b(e,s,"render",r=>G(r,{cwd:a,root:p,at:f?r.timeline.parts.map(c=>String(c.still)):e.at,part:e.part,from:e.from,to:e.to,clip:e.clip,out:e.out,overlay:e.overlay,beside:e.beside})),d=[];if(o.mode==="frame"&&d.push(`${o.out} (${o.piece} · ${o.format} · ${o.part} · ${o.t.toFixed(2)} s)`),o.mode==="grid"){d.push(`${o.out} (${o.piece} · ${String(o.tiles.length)} moments in ${String(o.cols)} columns)`,`  ${o.tiles.map(c=>`${c.t.toFixed(o.stretch?3:2)} ${c.part}`).join(" · ")}`);const r=[...new Set(o.tiles.flatMap(c=>c.overlay?.missing??[]))];r.length>0&&d.push(`  Not measured: ${r.join(", ")}.`)}return o.stretch&&d.push(`  Stretch ${o.stretch.from.toFixed(3)}–${o.stretch.to.toFixed(3)} s, one frame in ${String(o.stretch.every)}: ${String(o.stretch.frames)} frames.`),"clip"in o&&o.clip&&d.push(`${o.clip.out} (${o.clip.type}, ${String(o.clip.frames)} frames at ${String(o.clip.fps)} fps, no sound)`),{value:{...o,...$(n)},text:[...d,...w(n)].join(`
+`)}}),framesCuts=h({name:"frames cuts",summary:"A review sheet per cut of a video (a cut take's jumps, part joins, a scenery camera's cuts): frames around it, waveform and level, the words each side, the sound at it",input:t.strictObject({...S,part:t.string().optional().describe("Only this part's cuts and its joins"),out:t.string().optional().describe("The folder the sheets go in; default .allyhub/work/cuts/"),params:F({span:t.number().positive().max(10).default(L.span).describe("Seconds shown on each side of a cut")})}),positional:["item"],output:t.looseObject({out:t.string(),cuts:t.array(t.looseObject({sheet:t.string()}))}),examples:["allyhub frames cuts launch/film","allyhub frames cuts launch/film --part hook"]},async(e,s)=>{const a=s.cwd,p=await g(a,e.dir),{result:l,...i}=await b(e,s,"render",n=>H(n,{cwd:a,root:p,part:e.part,out:e.out,review:{span:e.params.span}})),f=l.part===void 0?`${String(l.cuts.length)} cut${l.cuts.length===1?"":"s"}`:`${String(l.cuts.length)} of ${String(l.total)} cuts (part ${l.part} and its joins)`,o=[`${l.piece} · ${l.format} · ${f}; silence is sound under ${String(l.threshold)} dBFS`];for(const n of l.cuts){const d=n.sound?`level ${y(n.sound.levelDb)} / around ${y(n.sound.aroundDb)} dBFS, peak ${y(n.sound.peakDb)}, step ${n.sound.jumpDb<0?"−":"+"}${Math.abs(n.sound.jumpDb).toFixed(1)} dB`:"no sound";o.push(`${String(n.index).padStart(3)}  ${n.t.toFixed(3).padStart(7)} s  ${n.kind.padEnd(6)}  ${_(n)}`,`       silence at the cut: ${R(n.silence)} · ${d}`,`       “${n.said.before}” | “${n.said.after}”${n.across?` · across the cut: “${n.across}”`:""}`,`       ${n.sheet}`)}return{value:{...l,...$(i)},text:[...o,...w(i)].join(`
+`)}});const P=I;export const framesCompare=h({name:"frames compare",summary:"How a candidate picture differs from a reference, as numbers (ΔE, channels, SSIM, levels, grain, edges, regions) with a heatmap and a side-by-side: a piece's moment, a picture file or a video file's frame",input:t.strictObject({reference:t.string().describe("The reference picture (PNG, WebP, JPEG…)"),candidate:t.string().optional().describe("A piece (its id, or a path into it; default the project's only one) at --at or --part's still; or a file by its extension: a picture (.png, .jpg, .webp…), or a video file's frame at --at (.mp4, .mov, .webm…)"),combo:S.combo,dir:A,at:t.string().optional().describe("The moment: seconds (from the start of --part when given) or an anchor of the piece; a video file's are seconds (default 0)"),part:t.string().optional().describe("The piece's part --at counts from; alone, its still"),refCrop:t.string().optional().describe("Cut the reference to x,y,width,height, or to an element of the elements.json beside it (frames web writes one)"),crop:t.string().optional().describe("Cut the candidate to x,y,width,height before any resize"),encode:t.string().optional().describe("Draw the candidate through this encode first, as a platform serves it: codec:kbps, h264 or hevc (hevc:618)"),out:t.string().optional().describe("Where its files go, a path without extension; default under .allyhub/work/compare/"),params:F({resize:t.enum(["stretch","width","none"]).default(P.resize).describe("When sizes differ: stretch the candidate to the reference, scale it to its width, or compare the common area"),shift:t.number().int().min(0).max(32).default(P.shift).describe("Search the best offset within this many pixels each way")})}),positional:["reference","candidate"],output:t.looseObject({reference:t.string(),files:t.looseObject({side:t.string(),heatmap:t.string()})}),examples:["allyhub frames compare reference.png launch/film --at 2.5 --encode hevc:618","allyhub frames compare reference.png shot.webp --ref-crop cta","allyhub frames compare reference.png theirs.mp4 --at 3"]},async(e,s)=>{const a=s.cwd,p=e.params,l=e.candidate!==void 0&&(B(e.candidate)||E(e.candidate))?e.candidate:void 0,i=d=>({cwd:a,root:d,reference:e.reference,file:l,at:e.at===void 0?void 0:[e.at],part:e.part,refCrop:e.refCrop,crop:e.crop,encode:e.encode,out:e.out,options:{shift:p.shift,resize:p.resize}});if(l!==void 0){if(e.combo!==void 0||e.part!==void 0)throw m("bad-option","--combo and --part are a piece's: the candidate is a file.");const d=await D(i(await x(a,e.dir)),void 0).catch(r=>{throw O(r)});return{value:d,text:C(d)}}const f=await g(a,e.dir),{result:o,...n}=await b({...e,item:e.candidate},s,"render",d=>D(i(f),d));return{value:{...o,...$(n)},text:[C(o),...w(n)].join(`
+`)}}),framesWeb=h({name:"frames web",summary:"A web page's screenshot with its named elements' boxes in the image's pixels, for a screen demo",input:t.strictObject({url:t.string().describe("The page: an address, or an HTML file on this computer"),el:t.array(t.string()).optional().describe("An element to locate, name=selector (CSS, or text=<words>); [data-el] elements are found too"),click:t.array(t.string()).optional().describe("Selectors clicked in order before the shot (close a banner, open a dialog)"),full:t.boolean().default(!1).describe("The whole page, not one viewport"),out:t.string().optional().describe("Where the picture goes (a WebP), its boxes in <out>.elements.json beside it; default under .allyhub/work/pages/"),dir:A,size:t.string().default(`${String(v.width)}x${String(v.height)}`).describe("The viewport, WIDTHxHEIGHT in CSS pixels"),scale:t.number().min(1).max(4).default(v.scale).describe("Image pixels per CSS pixel; 2 draws a high-density screen, sharp when a camera goes in"),wait:t.number().int().min(0).optional().describe("Milliseconds to wait after loading and clicking")}),positional:["url"],output:t.looseObject({out:t.string(),elementsFile:t.string()}),examples:["allyhub frames web https://example.com --el cta=text=Sign\\ up --scale 2 --out assets/media/home","allyhub frames web page.html --click '#accept' --full"]},async(e,s)=>{const a=s.cwd,[p,l]=Q(e.size),i=await U({cwd:a,root:await x(a,e.dir),url:e.url,out:e.out,el:e.el,click:e.click,width:p,height:l,scale:e.scale,full:e.full,wait:e.wait});return{value:i,text:[`${i.out}: ${String(i.width)}×${String(i.height)}${i.scale===1?"":` (${String(i.scale)} image pixels per CSS pixel)`}, ${String(Object.keys(i.elements).length)} elements (${Object.keys(i.elements).join(", ")||"none"}) in ${i.elementsFile}`,...i.missing.length>0?[`Not found: ${i.missing.join(", ")} (the selector is wrong, or something must be opened with --click first).`]:[]].join(`
+`),exit:i.missing.length>0?T.failed:T.ok}}),FRAMES_COMMANDS=[frames,framesCuts,framesCompare,framesWeb];

package/dist/commands/inspect/combos.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as s}from"zod";import{prepare as p}from"@allyhub-next/build";import{batchOf as d}from"@allyhub-next/export";import{EXIT as n}from"@allyhub-next/protocol";import{pieceNamed as l}from"@allyhub-next/video-core";import{CommandError as f,defineCommand as h}from"../../command.js";import{dir as b}from"../../fields.js";import{projectRoot as u}from"../../project.js";import{formatBatches as w,formatProblem as y}from"../../text/index.js";import{commandError as x}from"../../version.js";export const inspectCombos=h({name:"inspect combos",summary:"A batch's matrix, read without a browser: its slots, rules, the combos chosen and why, the render's cost",input:s.strictObject({item:s.string().optional().describe("The piece: its id, or a path into it; default every piece with slots"),dir:b}),positional:["item"],output:s.looseObject({}),examples:["allyhub inspect combos","allyhub inspect combos ads/tidyform"]},async(t,a)=>{try{const o=await u(a.cwd,t.dir),i=await p(o),c=i.pieces.filter(e=>t.item===void 0?e.matrix!==void 0:l({id:e.id,path:e.place},t.item));if(t.item!==void 0&&c.length===0)throw new f("no-piece",`No piece ${t.item}.`,{exit:n.notFound,hint:`Pieces: ${i.pieces.map(e=>e.id).join(", ")||"none"}.`});const r=c.flatMap(e=>d(e)??[]),m=i.problems.filter(e=>e.code.startsWith("AK-X"));return{value:{batches:r,problems:m},text:[...r.length===0?[t.item===void 0?"No piece has slots (matrix.slots).":`${t.item} has no slots: every combo of its dimensions is made.`]:w(r),...m.map(y)].join(`
+import{z as s}from"zod";import{prepare as p}from"@allyhub/build";import{batchOf as d}from"@allyhub/export";import{EXIT as n}from"@allyhub/protocol";import{pieceNamed as l}from"@allyhub/video-core";import{CommandError as f,defineCommand as h}from"../../command.js";import{dir as b}from"../../fields.js";import{projectRoot as u}from"../../project.js";import{formatBatches as w,formatProblem as y}from"../../text/index.js";import{commandError as x}from"../../version.js";export const inspectCombos=h({name:"inspect combos",summary:"A batch's matrix, read without a browser: its slots, rules, the combos chosen and why, the render's cost",input:s.strictObject({item:s.string().optional().describe("The piece: its id, or a path into it; default every piece with slots"),dir:b}),positional:["item"],output:s.looseObject({}),examples:["allyhub inspect combos","allyhub inspect combos ads/tidyform"]},async(t,a)=>{try{const o=await u(a.cwd,t.dir),i=await p(o),c=i.pieces.filter(e=>t.item===void 0?e.matrix!==void 0:l({id:e.id,path:e.place},t.item));if(t.item!==void 0&&c.length===0)throw new f("no-piece",`No piece ${t.item}.`,{exit:n.notFound,hint:`Pieces: ${i.pieces.map(e=>e.id).join(", ")||"none"}.`});const r=c.flatMap(e=>d(e)??[]),m=i.problems.filter(e=>e.code.startsWith("AK-X"));return{value:{batches:r,problems:m},text:[...r.length===0?[t.item===void 0?"No piece has slots (matrix.slots).":`${t.item} has no slots: every combo of its dimensions is made.`]:w(r),...m.map(y)].join(`
 `),exit:m.some(e=>e.level==="error")?n.failed:n.ok}}catch(o){throw x(o)}});

package/dist/commands/inspect/common.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as t}from"zod";import{consoleJson as m,momentsIn as p,versionLabel as l}from"@allyhub-next/project";import{EXIT as i}from"@allyhub-next/protocol";import{FACT_KINDS as d,countFacts as f,isFactKind as c}from"@allyhub-next/video-core";import{CommandError as s}from"../../command.js";import{formatConsole as u,formatFacts as h,formatProblem as b}from"../../text/index.js";import{known as x}from"../../version.js";export const plural=(e,o)=>`${String(e)} ${o}${e===1?"":"s"}`,sec=e=>e.toFixed(2),boxText=e=>`[${e.join(",")}]`,HEAD="measurements for you to judge, not problems. Boxes are [x,y,w,h], in pixels (a deck's in points); --json has every one.",STRETCH={part:t.string().optional().describe("Only this part"),from:t.number().min(0).optional().describe("From this second of the video"),to:t.number().min(0).optional().describe("Up to this second of the video")},MOMENTS={at:t.array(t.string()).optional().describe("At these moments: seconds (from --part's start when given) or anchors (@press, @/map, @press+0.2)"),every:t.number().positive().optional().describe("Every this many seconds through the stretch (--part, or --from to --to, else all of it)")},kind=t.array(t.string()).optional().describe(`Only facts of these kinds: ${Object.keys(d).join(", ")}`),all=e=>t.boolean().default(!1).describe(`Every finding on a line of its own${e===void 0?"":`, and ${e}`}`);export function kindsOf(e){if(e!==void 0)return e.map(o=>{if(!c(o))throw new s("bad-kind",`There is no kind of fact ${o}.`,{exit:i.usage,hint:`Kinds: ${Object.keys(d).join(", ")}.`});return o})}export function momentsOf(e,o){if(e.at!==void 0&&e.every!==void 0)throw new s("bad-option","--at and --every do not go together.",{exit:i.usage});const n=e.at?.map(r=>{const a=Number(r.replace(/s$/u,""));return r.trim().startsWith("@")||!Number.isFinite(a)?r:a});return x(()=>p(o.timeline,{...n===void 0?{}:{at:n},...e.every===void 0?{}:{every:e.every},part:e.part,from:e.from,to:e.to},o.target))}export function mustBeVideo(e,o){if(e.piece.kind!=="video")throw new s("bad-option",`${l(e.target)} is not a video: ${o}.`,{exit:i.usage})}export function pageLines(e){const o=e.problems.filter(n=>n.level==="error");return[...o.length>0?["Must fix (facts may be missing where they are):",...o.map(b)]:[],...u(m(e.console))]}export const pageJson=e=>({problems:e.problems.filter(o=>o.level==="error"),...m(e.console)});export function factsResult(e,o,n,r=[]){return{value:{facts:e,counts:f(e),total:n.total??e.length,...n.extra,...pageJson(o)},text:[`${plural(e.length,"fact")} measured now: ${HEAD}`,...h(e,{all:n.all}),...r,...pageLines(o)].join(`
+import{z as t}from"zod";import{consoleJson as m,momentsIn as p,versionLabel as l}from"@allyhub/project";import{EXIT as i}from"@allyhub/protocol";import{FACT_KINDS as d,countFacts as f,isFactKind as c}from"@allyhub/video-core";import{CommandError as s}from"../../command.js";import{formatConsole as u,formatFacts as h,formatProblem as b}from"../../text/index.js";import{known as x}from"../../version.js";export const plural=(e,o)=>`${String(e)} ${o}${e===1?"":"s"}`,sec=e=>e.toFixed(2),boxText=e=>`[${e.join(",")}]`,HEAD="measurements for you to judge, not problems. Boxes are [x,y,w,h], in pixels (a deck's in points); --json has every one.",STRETCH={part:t.string().optional().describe("Only this part"),from:t.number().min(0).optional().describe("From this second of the video"),to:t.number().min(0).optional().describe("Up to this second of the video")},MOMENTS={at:t.array(t.string()).optional().describe("At these moments: seconds (from --part's start when given) or anchors (@press, @/map, @press+0.2)"),every:t.number().positive().optional().describe("Every this many seconds through the stretch (--part, or --from to --to, else all of it)")},kind=t.array(t.string()).optional().describe(`Only facts of these kinds: ${Object.keys(d).join(", ")}`),all=e=>t.boolean().default(!1).describe(`Every finding on a line of its own${e===void 0?"":`, and ${e}`}`);export function kindsOf(e){if(e!==void 0)return e.map(o=>{if(!c(o))throw new s("bad-kind",`There is no kind of fact ${o}.`,{exit:i.usage,hint:`Kinds: ${Object.keys(d).join(", ")}.`});return o})}export function momentsOf(e,o){if(e.at!==void 0&&e.every!==void 0)throw new s("bad-option","--at and --every do not go together.",{exit:i.usage});const n=e.at?.map(r=>{const a=Number(r.replace(/s$/u,""));return r.trim().startsWith("@")||!Number.isFinite(a)?r:a});return x(()=>p(o.timeline,{...n===void 0?{}:{at:n},...e.every===void 0?{}:{every:e.every},part:e.part,from:e.from,to:e.to},o.target))}export function mustBeVideo(e,o){if(e.piece.kind!=="video")throw new s("bad-option",`${l(e.target)} is not a video: ${o}.`,{exit:i.usage})}export function pageLines(e){const o=e.problems.filter(n=>n.level==="error");return[...o.length>0?["Must fix (facts may be missing where they are):",...o.map(b)]:[],...u(m(e.console))]}export const pageJson=e=>({problems:e.problems.filter(o=>o.level==="error"),...m(e.console)});export function factsResult(e,o,n,r=[]){return{value:{facts:e,counts:f(e),total:n.total??e.length,...n.extra,...pageJson(o)},text:[`${plural(e.length,"fact")} measured now: ${HEAD}`,...h(e,{all:n.all}),...r,...pageLines(o)].join(`
 `)}}

package/dist/commands/inspect/contrast.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as i}from"zod";import{textContrast as p}from"@allyhub-next/measure";import{stretchOf as u}from"@allyhub-next/project";import{CONTRAST_DEFAULTS as f}from"@allyhub-next/video-core";import{defineCommand as h}from"../../command.js";import{VERSION_FIELDS as d,known as b,withVersion as w}from"../../version.js";import{MOMENTS as y,STRETCH as x,all as O,factsResult as k,momentsOf as g}from"./common.js";export const inspectContrast=h({name:"inspect contrast",summary:"The text against the pixels behind its glyphs now, as WCAG contrast ratios (the check does not measure it)",input:i.strictObject({...d,...y,...x,final:i.boolean().default(!1).describe("Over the final picture, footage composited (slower), not the check's graphics"),below:i.number().min(1).max(21).optional().describe("Only texts whose lowest ratio is under this one, and those not measured (default every text)"),all:O(`every block, however faint (without it, those at ${String(f.opacity*100)} % opacity or more)`)}),positional:["item"],output:i.looseObject({}),examples:["allyhub inspect contrast launch/film --part hook","allyhub inspect contrast launch/film --at 1.5 --final","allyhub inspect contrast launch/deck --below 4.5"]},async(e,r)=>{const n=await w(e,r,e.final?"render":"check",async t=>{const{from:l,to:c}=b(()=>u(t.timeline,e)),m=g(e,t)??(await t.version.measure()).moments.map(o=>o.t).filter(o=>o>=l-1e-6&&o<=c+1e-6);return p(t.version,m,e.all?{opacity:0}:{},e.final?{still:o=>t.still(o,{raw:!0})}:void 0)}),{below:s}=e,a=s===void 0?n.result:n.result.filter(t=>t.kind!=="text-contrast"||"missing"in t.data||t.data.ratio.min<s);return k(a,n,{all:e.all,total:n.result.length})});
+import{z as i}from"zod";import{textContrast as p}from"@allyhub/measure";import{stretchOf as u}from"@allyhub/project";import{CONTRAST_DEFAULTS as f}from"@allyhub/video-core";import{defineCommand as h}from"../../command.js";import{VERSION_FIELDS as d,known as b,withVersion as w}from"../../version.js";import{MOMENTS as y,STRETCH as x,all as O,factsResult as k,momentsOf as g}from"./common.js";export const inspectContrast=h({name:"inspect contrast",summary:"The text against the pixels behind its glyphs now, as WCAG contrast ratios (the check does not measure it)",input:i.strictObject({...d,...y,...x,final:i.boolean().default(!1).describe("Over the final picture, footage composited (slower), not the check's graphics"),below:i.number().min(1).max(21).optional().describe("Only texts whose lowest ratio is under this one, and those not measured (default every text)"),all:O(`every block, however faint (without it, those at ${String(f.opacity*100)} % opacity or more)`)}),positional:["item"],output:i.looseObject({}),examples:["allyhub inspect contrast launch/film --part hook","allyhub inspect contrast launch/film --at 1.5 --final","allyhub inspect contrast launch/deck --below 4.5"]},async(e,r)=>{const n=await w(e,r,e.final?"render":"check",async t=>{const{from:l,to:c}=b(()=>u(t.timeline,e)),m=g(e,t)??(await t.version.measure()).moments.map(o=>o.t).filter(o=>o>=l-1e-6&&o<=c+1e-6);return p(t.version,m,e.all?{opacity:0}:{},e.final?{still:o=>t.still(o,{raw:!0})}:void 0)}),{below:s}=e,a=s===void 0?n.result:n.result.filter(t=>t.kind!=="text-contrast"||"missing"in t.data||t.data.ratio.min<s);return k(a,n,{all:e.all,total:n.result.length})});

package/dist/commands/inspect/facts.js

@@ -1,4 +1,4 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as i}from"zod";import{consoleJson as y}from"@allyhub-next/project";import{countFacts as d,filterFacts as h}from"@allyhub-next/video-core";import{defineCommand as k}from"../../command.js";import{dir as w}from"../../fields.js";import{projectRoot as j}from"../../project.js";import{formatFacts as u}from"../../text/index.js";import{checkIndexed as v,combosOf as O,commandError as $}from"../../version.js";import{findSheet as x}from"../sheet.js";import{HEAD as b,STRETCH as F,all as S,kind as E,kindsOf as T,pageLines as z,plural as m}from"./common.js";import{projectSheetFacts as C,sheetFacts as H}from"./sheet.js";export const inspect=k({name:"inspect",summary:"The check's facts, for you to judge, never problems: by kind, part and time",input:i.strictObject({item:i.string().optional().describe("Only this item: its id, a path into it, or a folder of items"),combo:i.array(i.string()).optional().describe("Only combos matching name=value pairs joined with commas (lang=zh-cn,hook=b), or a combo's id (c03)"),kind:E,...F,all:S(),dir:w}),positional:["item"],output:i.looseObject({}),examples:["allyhub inspect","allyhub inspect launch/film --kind text-time,text-covered","allyhub inspect launch/film --part hook --all"]},async(t,c)=>{try{const o=await j(c.cwd,t.dir),a=T(t.kind),p=t.item===void 0?void 0:await x(o,c.cwd,t.item);if(p){const l=await H(o,p,{all:t.all}),s=h(l,{kinds:a});return{value:{facts:s,counts:d(s),total:l.length,problems:[]},text:[`${m(s.length,"fact")}: ${b}`,...u(s,{all:t.all})].join(`
+import{z as i}from"zod";import{consoleJson as y}from"@allyhub/project";import{countFacts as d,filterFacts as h}from"@allyhub/video-core";import{defineCommand as k}from"../../command.js";import{dir as w}from"../../fields.js";import{projectRoot as j}from"../../project.js";import{formatFacts as u}from"../../text/index.js";import{checkIndexed as v,combosOf as O,commandError as $}from"../../version.js";import{findSheet as x}from"../sheet.js";import{HEAD as b,STRETCH as F,all as S,kind as E,kindsOf as T,pageLines as z,plural as m}from"./common.js";import{projectSheetFacts as C,sheetFacts as H}from"./sheet.js";export const inspect=k({name:"inspect",summary:"The check's facts, for you to judge, never problems: by kind, part and time",input:i.strictObject({item:i.string().optional().describe("Only this item: its id, a path into it, or a folder of items"),combo:i.array(i.string()).optional().describe("Only combos matching name=value pairs joined with commas (lang=zh-cn,hook=b), or a combo's id (c03)"),kind:E,...F,all:S(),dir:w}),positional:["item"],output:i.looseObject({}),examples:["allyhub inspect","allyhub inspect launch/film --kind text-time,text-covered","allyhub inspect launch/film --part hook --all"]},async(t,c)=>{try{const o=await j(c.cwd,t.dir),a=T(t.kind),p=t.item===void 0?void 0:await x(o,c.cwd,t.item);if(p){const l=await H(o,p,{all:t.all}),s=h(l,{kinds:a});return{value:{facts:s,counts:d(s),total:l.length,problems:[]},text:[`${m(s.length,"fact")}: ${b}`,...u(s,{all:t.all})].join(`
 `)}}const r=await v({dir:o,...t.item===void 0?{}:{piece:t.item},combos:O(t)},c),e=[...r.facts,...t.item===void 0?await C(o,{all:t.all}):[]],n=h(e,{kinds:a,part:t.part,from:t.from,to:t.to}),f=r.problems.filter(l=>l.level==="error"),g=n.length===e.length?m(e.length,"fact"):`${m(n.length,"fact")} of ${String(e.length)}`;return{value:{facts:n,counts:d(n),total:e.length,problems:f,...y(r.console)},text:[`${g}: ${b}`,...u(n,{all:t.all}),...z({problems:f,console:r.console})].join(`
 `)}}catch(o){throw $(o)}});

package/dist/commands/inspect/fidelity.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{mkdir as u,writeFile as w}from"node:fs/promises";import{join as l}from"node:path";import{z as m}from"zod";import{WORK_DIR as h}from"@allyhub-next/formats";import{screenFidelity as b}from"@allyhub-next/measure";import{webp as O,writePng as k}from"@allyhub-next/render";import{defineCommand as x}from"../../command.js";import{VERSION_FIELDS as E,withVersion as F}from"../../version.js";import{MOMENTS as R,STRETCH as $,all as g,factsResult as j,momentsOf as S}from"./common.js";export const inspectFidelity=x({name:"inspect fidelity",summary:"A scenery's screens drawn in the world against their own elements, now; each comparison side by side in .allyhub/work/fidelity/",input:m.strictObject({...E,...R,...$,all:g()}),positional:["item"],output:m.looseObject({}),examples:["allyhub inspect fidelity launch/desk --at 2"]},async(i,d)=>{const s=await F(i,d,"check",async n=>{const o=S(i,n),a=l(n.prepared.root,h,"fidelity");return await u(a,{recursive:!0}),b(n.version,{},{...o===void 0?{}:{at:o},sheet:async(f,e)=>{const t=e.kind==="scenery-screen-fidelity"?e.data:void 0,y=((e.t??0)-(t?.start??0)+(t?.at??0)).toFixed(2),c=l(a,`${e.piece}-${t?.layer??"scenery"}-${t?.screen??"screen"}-${y}.webp`.replace(/[^\w.-]+/gu,"_"));return await w(c,await O(k(f),90)),c}})}),{facts:p,sheets:r}=s.result;return j(p,s,{all:i.all,extra:{sheets:r}},r.length>0?[`Each comparison side by side (the element drawn flat, its texture, where they differ): ${r.join(", ")}`]:[])});
+import{mkdir as u,writeFile as w}from"node:fs/promises";import{join as l}from"node:path";import{z as m}from"zod";import{WORK_DIR as h}from"@allyhub/formats";import{screenFidelity as b}from"@allyhub/measure";import{webp as O,writePng as k}from"@allyhub/render";import{defineCommand as x}from"../../command.js";import{VERSION_FIELDS as E,withVersion as F}from"../../version.js";import{MOMENTS as R,STRETCH as $,all as g,factsResult as j,momentsOf as S}from"./common.js";export const inspectFidelity=x({name:"inspect fidelity",summary:"A scenery's screens drawn in the world against their own elements, now; each comparison side by side in .allyhub/work/fidelity/",input:m.strictObject({...E,...R,...$,all:g()}),positional:["item"],output:m.looseObject({}),examples:["allyhub inspect fidelity launch/desk --at 2"]},async(i,d)=>{const s=await F(i,d,"check",async n=>{const o=S(i,n),a=l(n.prepared.root,h,"fidelity");return await u(a,{recursive:!0}),b(n.version,{},{...o===void 0?{}:{at:o},sheet:async(f,e)=>{const t=e.kind==="scenery-screen-fidelity"?e.data:void 0,y=((e.t??0)-(t?.start??0)+(t?.at??0)).toFixed(2),c=l(a,`${e.piece}-${t?.layer??"scenery"}-${t?.screen??"screen"}-${y}.webp`.replace(/[^\w.-]+/gu,"_"));return await w(c,await O(k(f),90)),c}})}),{facts:p,sheets:r}=s.result;return j(p,s,{all:i.all,extra:{sheets:r}},r.length>0?[`Each comparison side by side (the element drawn flat, its texture, where they differ): ${r.join(", ")}`]:[])});

package/dist/commands/inspect/joins.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as s}from"zod";import{cutSeams as y,flashFrames as w}from"@allyhub-next/measure";import{stretchOf as l}from"@allyhub-next/project";import{SEAM_DEFAULTS as S}from"@allyhub-next/video-core";import{defineCommand as n}from"../../command.js";import{VERSION_FIELDS as m,known as c,withVersion as p}from"../../version.js";import{STRETCH as f,all as u,factsResult as h,mustBeVideo as d}from"./common.js";export const inspectSeams=n({name:"inspect seams",summary:"A video's joins measured now, the picture's own shift too",input:s.strictObject({...m,...f,all:u(`every thing at each join (without it, the ${String(S.top)} largest each side)`)}),positional:["item"],output:s.looseObject({}),examples:["allyhub inspect seams launch/film --part hook"]},async(t,i)=>{const o=await p(t,i,"check",e=>{d(e,"it has no joins");const{from:r,to:a}=c(()=>l(e.timeline,t));return y(e.version,t.all?{top:0}:{},{picture:!0,from:r,to:a})});return h(o.result,o,{all:t.all})}),inspectFlash=n({name:"inspect flash",summary:"Every frame of a video against the frames beside it, now",input:s.strictObject({...m,...f,all:u("every frame a flash is looked for in")}),positional:["item"],output:s.looseObject({}),examples:["allyhub inspect flash launch/film --from 2 --to 6"]},async(t,i)=>{const o=await p(t,i,"check",e=>{d(e,"a page has no frames either side");const{from:r,last:a}=c(()=>l(e.timeline,t));return w(e.version,{},{from:r,to:a,all:t.all})});return h(o.result,o,{all:t.all})});
+import{z as s}from"zod";import{cutSeams as y,flashFrames as w}from"@allyhub/measure";import{stretchOf as l}from"@allyhub/project";import{SEAM_DEFAULTS as S}from"@allyhub/video-core";import{defineCommand as n}from"../../command.js";import{VERSION_FIELDS as m,known as c,withVersion as p}from"../../version.js";import{STRETCH as f,all as u,factsResult as h,mustBeVideo as d}from"./common.js";export const inspectSeams=n({name:"inspect seams",summary:"A video's joins measured now, the picture's own shift too",input:s.strictObject({...m,...f,all:u(`every thing at each join (without it, the ${String(S.top)} largest each side)`)}),positional:["item"],output:s.looseObject({}),examples:["allyhub inspect seams launch/film --part hook"]},async(t,i)=>{const o=await p(t,i,"check",e=>{d(e,"it has no joins");const{from:r,to:a}=c(()=>l(e.timeline,t));return y(e.version,t.all?{top:0}:{},{picture:!0,from:r,to:a})});return h(o.result,o,{all:t.all})}),inspectFlash=n({name:"inspect flash",summary:"Every frame of a video against the frames beside it, now",input:s.strictObject({...m,...f,all:u("every frame a flash is looked for in")}),positional:["item"],output:s.looseObject({}),examples:["allyhub inspect flash launch/film --from 2 --to 6"]},async(t,i)=>{const o=await p(t,i,"check",e=>{d(e,"a page has no frames either side");const{from:r,last:a}=c(()=>l(e.timeline,t));return w(e.version,{},{from:r,to:a,all:t.all})});return h(o.result,o,{all:t.all})});

package/dist/commands/inspect/layout.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as r}from"zod";import{measuredFacts as u}from"@allyhub-next/measure";import{DECK_FACT_DEFAULTS as c,deckFacts as h}from"@allyhub-next/slides-core";import{stretchOf as y}from"@allyhub-next/project";import{ffmpegOf as b}from"@allyhub-next/render";import{filterFacts as k}from"@allyhub-next/video-core";import{defineCommand as w}from"../../command.js";import{textOnScreen as g}from"../../text/index.js";import{VERSION_FIELDS as x,known as v,withVersion as O}from"../../version.js";import{MOMENTS as S,STRETCH as $,all as A,boxText as E,factsResult as F,kind as T,kindsOf as C,momentsOf as L,sec as N}from"./common.js";export const inspectLayout=w({name:"inspect layout",summary:"One version's layout measured now, at its measured moments or at --at / --every; --texts lists every text block with its fonts",input:r.strictObject({...x,...S,...$,texts:r.boolean().default(!1).describe("List every text block at every moment, with its box and fonts"),within:r.number().positive().optional().describe(`A deck: lines up to this many points apart and not in line are near-alignment (default ${String(c.within)})`),drift:r.number().nonnegative().optional().describe(`A deck: places further apart than this, in points, are placement-drift (default ${String(c.drift)})`),level:r.array(r.enum(["master","layout","slide"])).optional().describe("A deck: measure only shapes of these levels (default every one): slide leaves out what a master or a layout draws on every slide"),except:r.array(r.string()).optional().describe("A deck: leave shapes of these names out of every fact, * for any letters (tick-*)"),room:r.string().regex(/^[\d.]+,[\d.]+$/u).optional().describe("A deck's read-size: a room as its screen's width and its farthest seat, in metres (3,12); without it no room is measured"),kind:T,all:A()}),positional:["item"],output:r.looseObject({}),examples:["allyhub inspect layout launch/film --at 1.5,@press --texts","allyhub inspect layout launch/film --every 0.5 --part hook","allyhub inspect layout launch/deck --kind near-alignment --within 10","allyhub inspect layout launch/deck --level slide --except 'tick-*'"]},async(e,d)=>{const s=await O(e,d,"render",async t=>{const n=t.timeline,{part:l}=v(()=>y(n,e)),o=await t.version.measure(L(e,t)),m=[...t.version.summary?.facts??[],...o.deck?h(o.deck,{width:o.width,height:o.height},{piece:t.target.piece,output:t.target.output,combo:t.target.combo,format:t.target.format},{...e.within===void 0?{}:{within:e.within},...e.drift===void 0?{}:{drift:e.drift},...e.level===void 0?{}:{levels:e.level},...e.except===void 0?{}:{except:e.except},...e.room===void 0?{}:{room:{screen:Number(e.room.split(",")[0]),distance:Number(e.room.split(",")[1])}}}):await u(o,n,t.target,{root:t.prepared.root,media:t.prepared.media,ffmpeg:await b()},n.profile?.label)];return{facts:k(m,{kinds:C(e.kind),part:e.part}),total:m.length,moments:e.texts?o.moments.filter(i=>!l||i.part===l.key).map(i=>({t:i.t,part:i.part,...i.face?{face:i.face}:{},texts:i.texts})):void 0}}),{facts:p,total:f,moments:a}=s.result;return F(p,s,{all:e.all,total:f,...a?{extra:{moments:a}}:{}},(a??[]).map(t=>`  ${N(t.t)} ${t.part}${t.face?` face ${E(t.face)}`:""}: ${t.texts.map(g).join("; ")||"(no text)"}`))});
+import{z as r}from"zod";import{measuredFacts as u}from"@allyhub/measure";import{DECK_FACT_DEFAULTS as c,deckFacts as h}from"@allyhub/slides-core";import{stretchOf as y}from"@allyhub/project";import{ffmpegOf as b}from"@allyhub/render";import{filterFacts as k}from"@allyhub/video-core";import{defineCommand as w}from"../../command.js";import{textOnScreen as g}from"../../text/index.js";import{VERSION_FIELDS as x,known as v,withVersion as O}from"../../version.js";import{MOMENTS as S,STRETCH as $,all as A,boxText as E,factsResult as F,kind as T,kindsOf as C,momentsOf as L,sec as N}from"./common.js";export const inspectLayout=w({name:"inspect layout",summary:"One version's layout measured now, at its measured moments or at --at / --every; --texts lists every text block with its fonts",input:r.strictObject({...x,...S,...$,texts:r.boolean().default(!1).describe("List every text block at every moment, with its box and fonts"),within:r.number().positive().optional().describe(`A deck: lines up to this many points apart and not in line are near-alignment (default ${String(c.within)})`),drift:r.number().nonnegative().optional().describe(`A deck: places further apart than this, in points, are placement-drift (default ${String(c.drift)})`),level:r.array(r.enum(["master","layout","slide"])).optional().describe("A deck: measure only shapes of these levels (default every one): slide leaves out what a master or a layout draws on every slide"),except:r.array(r.string()).optional().describe("A deck: leave shapes of these names out of every fact, * for any letters (tick-*)"),room:r.string().regex(/^[\d.]+,[\d.]+$/u).optional().describe("A deck's read-size: a room as its screen's width and its farthest seat, in metres (3,12); without it no room is measured"),kind:T,all:A()}),positional:["item"],output:r.looseObject({}),examples:["allyhub inspect layout launch/film --at 1.5,@press --texts","allyhub inspect layout launch/film --every 0.5 --part hook","allyhub inspect layout launch/deck --kind near-alignment --within 10","allyhub inspect layout launch/deck --level slide --except 'tick-*'"]},async(e,d)=>{const s=await O(e,d,"render",async t=>{const n=t.timeline,{part:l}=v(()=>y(n,e)),o=await t.version.measure(L(e,t)),m=[...t.version.summary?.facts??[],...o.deck?h(o.deck,{width:o.width,height:o.height},{piece:t.target.piece,output:t.target.output,combo:t.target.combo,format:t.target.format},{...e.within===void 0?{}:{within:e.within},...e.drift===void 0?{}:{drift:e.drift},...e.level===void 0?{}:{levels:e.level},...e.except===void 0?{}:{except:e.except},...e.room===void 0?{}:{room:{screen:Number(e.room.split(",")[0]),distance:Number(e.room.split(",")[1])}}}):await u(o,n,t.target,{root:t.prepared.root,media:t.prepared.media,ffmpeg:await b()},n.profile?.label)];return{facts:k(m,{kinds:C(e.kind),part:e.part}),total:m.length,moments:e.texts?o.moments.filter(i=>!l||i.part===l.key).map(i=>({t:i.t,part:i.part,...i.face?{face:i.face}:{},texts:i.texts})):void 0}}),{facts:p,total:f,moments:a}=s.result;return F(p,s,{all:e.all,total:f,...a?{extra:{moments:a}}:{}},(a??[]).map(t=>`  ${N(t.t)} ${t.part}${t.face?` face ${E(t.face)}`:""}: ${t.texts.map(g).join("; ")||"(no text)"}`))});

package/dist/commands/inspect/motion.js

@@ -1,4 +1,4 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as r}from"zod";import{STILL_DEFAULTS as O,loopSeam as E,stillPicture as I}from"@allyhub-next/measure";import{stretchOf as x}from"@allyhub-next/project";import{largestSteps as D}from"@allyhub-next/video-core";import{defineCommand as m}from"../../command.js";import{VERSION_FIELDS as c,known as v,withVersion as p}from"../../version.js";import{STRETCH as k,all as F,boxText as f,factsResult as R,mustBeVideo as T,pageJson as j,pageLines as L,plural as h,sec as d}from"./common.js";const g=12;export const inspectMotion=m({name:"inspect motion",summary:"Follow everything on screen frame by frame and list each thing's largest step, a move or a fade",input:r.strictObject({...c,...k,all:r.boolean().default(!1).describe(`Every step, not only the ${String(g)} largest of each kind`)}),positional:["item"],output:r.looseObject({}),examples:["allyhub inspect motion launch/film --part hook"]},async(o,l)=>{const n=await p(o,l,"check",async t=>{const{from:s,to:u}=v(()=>x(t.timeline,o)),$=await t.version.tracks(s,u),S=D($),w=S.filter(a=>a.kind==="move"),y=S.filter(a=>a.kind==="fade"),b=a=>o.all?a:a.slice(0,g);return{from:s,to:u,things:$.length,steps:[...b(w),...b(y)],moves:w.length,fades:y.length}}),e=n.result,i=t=>String(e.steps.filter(s=>s.kind===t).length);return{value:{...e,...j(n)},text:[`Motion ${d(e.from)}–${d(e.to)} s (${h(e.things,"thing")} followed: text, painted boxes, pictures): each thing's largest step from one frame to the next, over the larger of the steps beside it. ${i("move")} of ${h(e.moves,"move")} and ${i("fade")} of ${h(e.fades,"fade")} listed (the ${String(g)} largest of each kind; --all lists every one).`,...e.steps.map(t=>{const s=`  ${d(t.t)} s ${t.part}: ${t.layer} ${t.what}`;return t.kind==="move"?`${s} moved ${String(t.px)} px${t.grew>0?`, grew ${String(t.grew)} px`:""} in one frame (${String(t.around)} px beside it): ${t.from?f(t.from):"nothing"} → ${t.to?f(t.to):"nothing"}`:`${s} opacity ${String(t.opacity[0])} → ${String(t.opacity[1])} in one frame (${String(t.around)} beside it)${t.to?` at ${f(t.to)}`:""}`}),...L(n)].join(`
+import{z as r}from"zod";import{STILL_DEFAULTS as O,loopSeam as E,stillPicture as I}from"@allyhub/measure";import{stretchOf as x}from"@allyhub/project";import{largestSteps as D}from"@allyhub/video-core";import{defineCommand as m}from"../../command.js";import{VERSION_FIELDS as c,known as v,withVersion as p}from"../../version.js";import{STRETCH as k,all as F,boxText as f,factsResult as R,mustBeVideo as T,pageJson as j,pageLines as L,plural as h,sec as d}from"./common.js";const g=12;export const inspectMotion=m({name:"inspect motion",summary:"Follow everything on screen frame by frame and list each thing's largest step, a move or a fade",input:r.strictObject({...c,...k,all:r.boolean().default(!1).describe(`Every step, not only the ${String(g)} largest of each kind`)}),positional:["item"],output:r.looseObject({}),examples:["allyhub inspect motion launch/film --part hook"]},async(o,l)=>{const n=await p(o,l,"check",async t=>{const{from:s,to:u}=v(()=>x(t.timeline,o)),$=await t.version.tracks(s,u),S=D($),w=S.filter(a=>a.kind==="move"),y=S.filter(a=>a.kind==="fade"),b=a=>o.all?a:a.slice(0,g);return{from:s,to:u,things:$.length,steps:[...b(w),...b(y)],moves:w.length,fades:y.length}}),e=n.result,i=t=>String(e.steps.filter(s=>s.kind===t).length);return{value:{...e,...j(n)},text:[`Motion ${d(e.from)}–${d(e.to)} s (${h(e.things,"thing")} followed: text, painted boxes, pictures): each thing's largest step from one frame to the next, over the larger of the steps beside it. ${i("move")} of ${h(e.moves,"move")} and ${i("fade")} of ${h(e.fades,"fade")} listed (the ${String(g)} largest of each kind; --all lists every one).`,...e.steps.map(t=>{const s=`  ${d(t.t)} s ${t.part}: ${t.layer} ${t.what}`;return t.kind==="move"?`${s} moved ${String(t.px)} px${t.grew>0?`, grew ${String(t.grew)} px`:""} in one frame (${String(t.around)} px beside it): ${t.from?f(t.from):"nothing"} → ${t.to?f(t.to):"nothing"}`:`${s} opacity ${String(t.opacity[0])} → ${String(t.opacity[1])} in one frame (${String(t.around)} beside it)${t.to?` at ${f(t.to)}`:""}`}),...L(n)].join(`
 `)}}),inspectLoop=m({name:"inspect loop",summary:"A video's last frame against its first, and two frames in a row at each end for scale",input:r.strictObject(c),positional:["item"],output:r.looseObject({}),examples:["allyhub inspect loop launch/film"]},async(o,l)=>{const n=await p(o,l,"render",async t=>(T(t,"it has no loop"),E(t.timeline,s=>t.still(s)))),e=n.result,i=t=>`mean ${String(t.mean)} of 255, largest ${String(t.max)}`;return{value:{loop:e,...j(n)},text:[`Loop seam (${String(e.frames)} frames at ${String(e.fps)} fps): the last frame against the first differs by ${i(e.seam)}.`,`  Two frames in a row, for scale: the first two ${i(e.first)}; the last two ${i(e.last)}.`,...L(n)].join(`
 `)}}),inspectStill=m({name:"inspect still",summary:"The stretches where a video's picture holds, measured now",input:r.strictObject({...c,...k,all:F(`every stretch that holds, however short (without it, ${String(O.minSeconds)} s or longer)`)}),positional:["item"],output:r.looseObject({}),examples:["allyhub inspect still launch/film --all"]},async(o,l)=>{const n=await p(o,l,"check",e=>{T(e,"a page holds still");const{from:i,last:t}=v(()=>x(e.timeline,o));return I(e.version,o.all?{minSeconds:0}:{},{from:i,to:t})});return R(n.result,n,{all:o.all})});

package/dist/commands/inspect/sheet.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{join as m,relative as u}from"node:path";import{z as a}from"zod";import{scanItems as d}from"@allyhub-next/formats";import{EXIT as p}from"@allyhub-next/protocol";import{INSPECT_DEFAULTS as c,SHEET_FACT_KINDS as f,checkWorkbook as h,inspectWorkbook as b,seededRandom as y}from"@allyhub-next/sheet";import{countFacts as k,fact as g,filterFacts as w}from"@allyhub-next/video-core";import{listFiles as F}from"@allyhub-next/build";import{CommandError as j,defineCommand as N}from"../../command.js";import{dir as v}from"../../fields.js";import{projectRoot as E}from"../../project.js";import{formatFacts as S}from"../../text/index.js";import{sheetAt as x,sheetFolderName as T,sourceOfSheet as A}from"../sheet.js";import{HEAD as O,all as C,kindsOf as I,plural as $}from"./common.js";const D=(e,t)=>g(t.kind,{piece:e},t.data);export async function sheetFacts(e,t,o){const{source:n,files:s}=await A(e,t),{calc:i}=h(s,{random:y(n.text)});if(!i)return[];const r=T(e,t);return b(i,o).map(l=>D(r,l))}export async function projectSheetFacts(e,t){const{items:o}=d(await F(e)),n=[];for(const s of o)s.kind==="sheet"&&n.push(...await sheetFacts(e,m(e,s.entry),t));return n}const H=e=>e.split(",").map(t=>Number(t.trim()));export const inspectSheet=N({name:"inspect sheet",summary:"A workbook's facts, for you to judge, never problems: error values by cell, numbers written into formulas, a cell unlike its neighbours, what nothing reads, exceptions in calculated columns, values under a validation that breaks them",input:a.strictObject({sheet:a.string().describe("The sheet, by its folder or its sheet.yaml"),kind:a.array(a.string()).optional().describe(`Only facts of these kinds: ${f.join(", ")}`),plain:a.string().default(c.plain.join(",")).describe("Numbers a formula may hold and not be said, by commas; --all says them too"),around:a.number().int().min(1).default(c.around).describe("How many neighbours each side must read alike for a cell to be unlike them"),all:C("every number in every formula, and a table's columns nothing reads"),dir:v}),positional:["sheet"],output:a.looseObject({}),examples:["allyhub inspect sheet finance/budget","allyhub inspect sheet finance/budget --kind sheet-error,sheet-number","allyhub inspect sheet finance/budget --plain 0,1,100 --all"]},async(e,t)=>{const o=await E(t.cwd,e.dir),n=await x(o,t.cwd,e.sheet),s=H(e.plain);if(s.some(l=>Number.isNaN(l)))throw new j("bad-option",`${e.plain} is not numbers.`,{exit:p.usage});const i=await sheetFacts(o,n,{plain:s,around:e.around,all:e.all}),r=w(i,{kinds:I(e.kind)});return{value:{file:u(o,n),facts:r,counts:k(r),total:i.length},text:[`${$(r.length,"fact")}: ${O}`,...S(r,{all:e.all})].join(`
+import{join as m,relative as u}from"node:path";import{z as a}from"zod";import{scanItems as d}from"@allyhub/formats";import{EXIT as p}from"@allyhub/protocol";import{INSPECT_DEFAULTS as c,SHEET_FACT_KINDS as f,checkWorkbook as h,inspectWorkbook as b,seededRandom as y}from"@allyhub/sheet";import{countFacts as k,fact as g,filterFacts as w}from"@allyhub/video-core";import{listFiles as F}from"@allyhub/build";import{CommandError as j,defineCommand as N}from"../../command.js";import{dir as v}from"../../fields.js";import{projectRoot as E}from"../../project.js";import{formatFacts as S}from"../../text/index.js";import{sheetAt as x,sheetFolderName as T,sourceOfSheet as A}from"../sheet.js";import{HEAD as O,all as C,kindsOf as I,plural as $}from"./common.js";const D=(e,t)=>g(t.kind,{piece:e},t.data);export async function sheetFacts(e,t,o){const{source:n,files:s}=await A(e,t),{calc:i}=h(s,{random:y(n.text)});if(!i)return[];const r=T(e,t);return b(i,o).map(l=>D(r,l))}export async function projectSheetFacts(e,t){const{items:o}=d(await F(e)),n=[];for(const s of o)s.kind==="sheet"&&n.push(...await sheetFacts(e,m(e,s.entry),t));return n}const H=e=>e.split(",").map(t=>Number(t.trim()));export const inspectSheet=N({name:"inspect sheet",summary:"A workbook's facts, for you to judge, never problems: error values by cell, numbers written into formulas, a cell unlike its neighbours, what nothing reads, exceptions in calculated columns, values under a validation that breaks them",input:a.strictObject({sheet:a.string().describe("The sheet, by its folder or its sheet.yaml"),kind:a.array(a.string()).optional().describe(`Only facts of these kinds: ${f.join(", ")}`),plain:a.string().default(c.plain.join(",")).describe("Numbers a formula may hold and not be said, by commas; --all says them too"),around:a.number().int().min(1).default(c.around).describe("How many neighbours each side must read alike for a cell to be unlike them"),all:C("every number in every formula, and a table's columns nothing reads"),dir:v}),positional:["sheet"],output:a.looseObject({}),examples:["allyhub inspect sheet finance/budget","allyhub inspect sheet finance/budget --kind sheet-error,sheet-number","allyhub inspect sheet finance/budget --plain 0,1,100 --all"]},async(e,t)=>{const o=await E(t.cwd,e.dir),n=await x(o,t.cwd,e.sheet),s=H(e.plain);if(s.some(l=>Number.isNaN(l)))throw new j("bad-option",`${e.plain} is not numbers.`,{exit:p.usage});const i=await sheetFacts(o,n,{plain:s,around:e.around,all:e.all}),r=w(i,{kinds:I(e.kind)});return{value:{file:u(o,n),facts:r,counts:k(r),total:i.length},text:[`${$(r.length,"fact")}: ${O}`,...S(r,{all:e.all})].join(`
 `)}});

package/dist/commands/inspect/timeline.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as r}from"zod";import{generatedReads as m,versionLabel as a}from"@allyhub-next/project";import{defineCommand as l}from"../../command.js";import{formatTimeline as c}from"../../text/index.js";import{VERSION_FIELDS as p,withVersion as u}from"../../version.js";import{pageJson as d,pageLines as f}from"./common.js";export const inspectTimeline=l({name:"inspect timeline",summary:"One version's timeline, drawn nowhere: each part's stretch, layers and their stacking, speech, anchors, room tone, transitions, sound effects, music, generated media",input:r.strictObject(p),positional:["item"],output:r.looseObject({}),examples:["allyhub inspect timeline launch/film","allyhub inspect timeline ads/tidyform --combo c03"]},async(o,s)=>{const t=await u(o,s,"play",e=>Promise.resolve({target:e.target,timeline:e.timeline,text:e.version.summary?.text??[],generated:m(e)})),{target:i,...n}=t.result;return{value:{...i,...n,...d(t)},text:[...c({label:a(i),...n}),...f(t)].join(`
+import{z as r}from"zod";import{generatedReads as m,versionLabel as a}from"@allyhub/project";import{defineCommand as l}from"../../command.js";import{formatTimeline as c}from"../../text/index.js";import{VERSION_FIELDS as p,withVersion as u}from"../../version.js";import{pageJson as d,pageLines as f}from"./common.js";export const inspectTimeline=l({name:"inspect timeline",summary:"One version's timeline, drawn nowhere: each part's stretch, layers and their stacking, speech, anchors, room tone, transitions, sound effects, music, generated media",input:r.strictObject(p),positional:["item"],output:r.looseObject({}),examples:["allyhub inspect timeline launch/film","allyhub inspect timeline ads/tidyform --combo c03"]},async(o,s)=>{const t=await u(o,s,"play",e=>Promise.resolve({target:e.target,timeline:e.timeline,text:e.version.summary?.text??[],generated:m(e)})),{target:i,...n}=t.result;return{value:{...i,...n,...d(t)},text:[...c({label:a(i),...n}),...f(t)].join(`
 `)}});

package/dist/commands/model.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{stat as j}from"node:fs/promises";import{basename as c,dirname as u,join as f,resolve as p}from"node:path";import{z as i}from"zod";import{CACHE_DIR as y,OUT_DIR as h}from"@allyhub-next/formats";import{BUILD_DEFAULTS as x,ModelError as S,buildModule as O,capabilities as b}from"@allyhub-next/model/build";import{EXIT as m}from"@allyhub-next/protocol";import{CommandError as n,defineCommand as g}from"../command.js";import{projectAt as v,projectRoot as w}from"../project.js";import{parameters as A}from"../parameters.js";const $=`${y}/model`,T=t=>t.toFixed(3);function C(t){const r=c(t).replace(/\.[^.]+$/u,"");return r==="model"?c(u(t)):r}function B(t,r){const a=t.objects.filter(e=>e.triangles===0&&!e.curve);return[`${r}: ${String(t.objects.length)} objects, ${String(t.triangles)} triangles (${t.upAxis} up, ${t.units}s).`,...t.objects.map(e=>{const l=e.bounds?e.bounds.max.map((s,d)=>T(s-(e.bounds?.min[d]??0))).join(" × "):void 0,o=e.materials.flatMap(s=>s?[s.name]:[]);return`  ${e.name}${e.parent?` (in ${e.parent})`:""}: ${String(e.triangles)} triangles${l?`, ${l} m`:""}${o.length>0?`, ${o.join(", ")}`:""}${e.curve?`, a curve of ${String(e.curve.splines.length)} splines`:""}${e.instance?`, an instance of ${e.instance.object}`:""}`}),...a.length>0?[`No triangles after their modifiers: ${a.map(e=>e.name).join(", ")}.`]:[]].join(`
+import{stat as j}from"node:fs/promises";import{basename as c,dirname as u,join as f,resolve as p}from"node:path";import{z as i}from"zod";import{CACHE_DIR as y,OUT_DIR as h}from"@allyhub/formats";import{BUILD_DEFAULTS as x,ModelError as S,buildModule as O,capabilities as b}from"@allyhub/model/build";import{EXIT as m}from"@allyhub/protocol";import{CommandError as n,defineCommand as g}from"../command.js";import{projectAt as v,projectRoot as w}from"../project.js";import{parameters as A}from"../parameters.js";const $=`${y}/model`,T=t=>t.toFixed(3);function C(t){const r=c(t).replace(/\.[^.]+$/u,"");return r==="model"?c(u(t)):r}function B(t,r){const a=t.objects.filter(e=>e.triangles===0&&!e.curve);return[`${r}: ${String(t.objects.length)} objects, ${String(t.triangles)} triangles (${t.upAxis} up, ${t.units}s).`,...t.objects.map(e=>{const l=e.bounds?e.bounds.max.map((s,d)=>T(s-(e.bounds?.min[d]??0))).join(" × "):void 0,o=e.materials.flatMap(s=>s?[s.name]:[]);return`  ${e.name}${e.parent?` (in ${e.parent})`:""}: ${String(e.triangles)} triangles${l?`, ${l} m`:""}${o.length>0?`, ${o.join(", ")}`:""}${e.curve?`, a curve of ${String(e.curve.splines.length)} splines`:""}${e.instance?`, an instance of ${e.instance.object}`:""}`}),...a.length>0?[`No triangles after their modifiers: ${a.map(e=>e.name).join(", ")}.`]:[]].join(`
 `)}export const model=g({name:"3d-model",summary:"Builds a 3D model's TypeScript module (defineModel) into a GLB; --inspect measures it without writing one",input:i.strictObject({file:i.string().describe("The model module, a .ts, .mts, .js or .mjs file whose default export is defineModel(build)"),inspect:i.boolean().default(!1).describe("Measure it without writing a GLB: each object's parent, matrix, bounds (Blender Z-up metres), triangles, materials as glTF reads them, UV layers, a curve's splines"),args:i.string().default("{}").describe("What the module's build is given (defineModel's parameters), a JSON object"),out:i.string().optional().describe(`The GLB to write (default ${h}/<module>.glb, the folder's name for a model.ts); one there is replaced only after the build succeeds`),dir:i.string().optional().describe("The project, where the module's image paths start (default the one the module is in, else the folder it is run in)"),fresh:i.boolean().default(!1).describe(`Build anew instead of reusing the build kept in ${$} (one is reused while the module, the files it read, its parameters, seed and the modelling runtime are unchanged); the new build is kept too`),params:A({seed:i.int().default(x.seed).describe("Seed of the build's random generator (bpy.random, 32 bits)")})}),positional:["file"],output:i.looseObject({}),examples:["allyhub 3d-model table/model.ts",`allyhub 3d-model table/model.ts --inspect --args '{"width":1.8}'`]},async(t,r)=>{const a=p(r.cwd,t.file);if(!(await j(a).catch(()=>{}))?.isFile())throw new n("not-found",`There is no file ${t.file}.`,{exit:m.notFound});if(!/\.(?:ts|mts|js|mjs)$/u.test(a))throw new n("usage","A model module is a .ts, .mts, .js or .mjs file.",{exit:m.usage});let e;try{e=JSON.parse(t.args)}catch{e=void 0}if(typeof e!="object"||e===null||Array.isArray(e))throw new n("usage","--args is a JSON object.",{exit:m.usage});const l=t.dir===void 0?await v(u(a))??await w(r.cwd):await w(r.cwd,t.dir),o=t.inspect?void 0:p(r.cwd,t.out??f(l,h,`${C(a)}.glb`));if(o&&!o.toLowerCase().endsWith(".glb"))throw new n("usage","--out is a .glb file.",{exit:m.usage});try{const s=await O(a,{parameters:e,seed:t.params.seed,root:l,...o?{out:o}:{},cache:f(l,$),fresh:t.fresh}),d=s.cache==="hit"?" (cached)":"";return{value:{...s.report,...s.glb?{glb:s.glb}:{},cache:s.cache},text:B(s.report,s.glb?`Wrote ${s.glb}${d}`:`${t.file}${d}`)}}catch(s){throw s instanceof S?new n(`model-${s.code.toLowerCase().replace(/^model[-_]/u,"").replaceAll(/[^a-z0-9]+/gu,"-")}`,s.message):s}}),modelCapabilities=g({name:"3d-model capabilities",summary:"What the modelling API supports (the Blender subset, its limits and deliberate differences), as JSON",input:i.strictObject({}),output:i.looseObject({}),examples:["allyhub 3d-model capabilities"]},()=>Promise.resolve({value:b,text:JSON.stringify(b,null,2)}));

package/dist/commands/orgs.js

@@ -1,3 +1,3 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as n}from"zod";import{organizations as l,readCredentials as c}from"@allyhub-next/cloud";import{defineCommand as u}from"../command.js";import{cloudOf as m,cloudWork as d}from"./cloud.js";const g=n.looseObject({id:n.string(),name:n.string(),slug:n.string(),role:n.string(),current:n.boolean()});export const orgsList=u({name:"orgs list",summary:"The organizations you are in, with your role; the one this computer acts in and pays from is marked",input:n.strictObject({}),output:n.looseObject({organizations:n.array(g)})},(p,e)=>d(async()=>{const o=m(e),a=await l(o),r=(await c(o.config))?.account.organization?.id,i=a.filter(t=>t.dissolvedAt===null).map((t,s)=>({id:t.id,name:t.name,slug:t.slug,role:t.role,current:r===void 0?s===0:t.id===r}));return{value:{organizations:i},text:i.map(t=>`${t.current?"*":" "} ${t.slug}  ${t.name}  ${t.role}`).join(`
+import{z as n}from"zod";import{organizations as l,readCredentials as c}from"@allyhub/cloud";import{defineCommand as u}from"../command.js";import{cloudOf as m,cloudWork as d}from"./cloud.js";const g=n.looseObject({id:n.string(),name:n.string(),slug:n.string(),role:n.string(),current:n.boolean()});export const orgsList=u({name:"orgs list",summary:"The organizations you are in, with your role; the one this computer acts in and pays from is marked",input:n.strictObject({}),output:n.looseObject({organizations:n.array(g)})},(p,e)=>d(async()=>{const o=m(e),a=await l(o),r=(await c(o.config))?.account.organization?.id,i=a.filter(t=>t.dissolvedAt===null).map((t,s)=>({id:t.id,name:t.name,slug:t.slug,role:t.role,current:r===void 0?s===0:t.id===r}));return{value:{organizations:i},text:i.map(t=>`${t.current?"*":" "} ${t.slug}  ${t.name}  ${t.role}`).join(`
 `)}}));

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 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(`
+import{INTERPRETATION_FILE as l}from"@allyhub/formats";import{INTERPRETATION_SHAPE as y}from"@allyhub/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 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)}});
+import{join as d,relative as $,resolve as m}from"node:path";import{z as s}from"zod";import{startBrowser as M}from"@allyhub/browser";import{REFERENCE_DIR as w}from"@allyhub/formats";import{ReferenceError as A,comparePiece as C,makeReference as D,readReference as I,referenceDir as S,referenceSet as F}from"@allyhub/measure";import{EXIT as l}from"@allyhub/protocol";import{comboKey as P}from"@allyhub/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 y,resolve as x}from"node:path";import{z as t}from"zod";import{formatConsole as v,formatProblem as w}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 j}from"../parameters.js";import{projectRoot as O}from"../project.js";import{combosOf as S,commandError as A}from"../version.js";import{dir as B,indexing as N}from"../fields.js";const T={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"),values:t.enum(["data","shown"]).optional().describe("A sheet's csv, json and md: each value as data (a date 2026-01-15, a time 09:30, a duration 36:00, a number to 15 digits; csv's and json's default) or as its format shows it (15 Jan 2026, $1,200.00; md's default)"),bom:t.boolean().default(!0).describe("A sheet's csv starts with a UTF-8 byte-order mark, by which Excel reads its letters right (é, €, 中文); false for a tool that does not expect one"),pptx:t.enum(["native","picture"]).default("native").describe("A deck's pptx: native, PowerPoint's own model, editable there (the deck's masters, layouts, placeholders, shapes, text, pictures, videos and notes, a component as its picture); or picture, each slide a picture of the page")},D=(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:j(T),dir:B}),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 finance/budget --type csv --param bom=false","allyhub render launch/deck --type pptx --param pptx=picture","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 O(i.cwd,o.dir),f=x(i.cwd,o.out??y(d,$)),s=o.params,h={codec:s.codec,...s.crf===void 0?{}:{crf:s.crf},...s.maxBitrate===void 0?{}:{maxBitrate:s.maxBitrate},...s.audioBitrate===void 0?{}:{audioBitrate:s.audioBitrate}};let l=0,a;try{a=await k({root:d,out:f,...o.items===void 0?{}:{items:o.items},combos:S(o),...o.type===void 0?{}:{types:o.type},...o.name===void 0?{}:{name:o.name},encode:h,...s.steps?{steps:!0}:{},...s.pptx==="native"?{}:{pptx:s.pptx},sheet:{bom:s.bom,...s.values===void 0?{}:{values:s.values}},index:N(i.env),log:e=>{i.progress(e)},onProgress:e=>{const r=Math.floor(e*10);r<=l||r>=10||(l=r,i.progress(`${String(r*10)}%`))},signal:i.signal})}catch(e){throw A(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(r=>`  ${r}`):[`  ${e.path}${u(e.loudness)}`]),g=[`${D(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})`),...a.files.flatMap(e=>(e.missing??[]).map(r=>`Not measured: ${r}`)),...new Set(a.files.flatMap(e=>(e.fontsLeft??[]).map(r=>`Not in the file: ${r.font} (${r.why}); PowerPoint shows another font where it is not installed.`))),...b.map(w),...v(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(`
+import{join as y,resolve as x}from"node:path";import{z as t}from"zod";import{formatConsole as v,formatProblem as w}from"../text/index.js";import{exportProject as k}from"@allyhub/export";import{SHARE_ENCODE as n}from"@allyhub/render";import{consoleJson as p}from"@allyhub/project";import{OUT_DIR as $}from"@allyhub/formats";import{EXIT as c}from"@allyhub/protocol";import{defineCommand as P}from"../command.js";import{parameters as j}from"../parameters.js";import{projectRoot as O}from"../project.js";import{combosOf as S,commandError as A}from"../version.js";import{dir as B,indexing as N}from"../fields.js";const T={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"),values:t.enum(["data","shown"]).optional().describe("A sheet's csv, json and md: each value as data (a date 2026-01-15, a time 09:30, a duration 36:00, a number to 15 digits; csv's and json's default) or as its format shows it (15 Jan 2026, $1,200.00; md's default)"),bom:t.boolean().default(!0).describe("A sheet's csv starts with a UTF-8 byte-order mark, by which Excel reads its letters right (é, €, 中文); false for a tool that does not expect one"),pptx:t.enum(["native","picture"]).default("native").describe("A deck's pptx: native, PowerPoint's own model, editable there (the deck's masters, layouts, placeholders, shapes, text, pictures, videos and notes, a component as its picture); or picture, each slide a picture of the page")},D=(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:j(T),dir:B}),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 finance/budget --type csv --param bom=false","allyhub render launch/deck --type pptx --param pptx=picture","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 O(i.cwd,o.dir),f=x(i.cwd,o.out??y(d,$)),s=o.params,h={codec:s.codec,...s.crf===void 0?{}:{crf:s.crf},...s.maxBitrate===void 0?{}:{maxBitrate:s.maxBitrate},...s.audioBitrate===void 0?{}:{audioBitrate:s.audioBitrate}};let l=0,a;try{a=await k({root:d,out:f,...o.items===void 0?{}:{items:o.items},combos:S(o),...o.type===void 0?{}:{types:o.type},...o.name===void 0?{}:{name:o.name},encode:h,...s.steps?{steps:!0}:{},...s.pptx==="native"?{}:{pptx:s.pptx},sheet:{bom:s.bom,...s.values===void 0?{}:{values:s.values}},index:N(i.env),log:e=>{i.progress(e)},onProgress:e=>{const r=Math.floor(e*10);r<=l||r>=10||(l=r,i.progress(`${String(r*10)}%`))},signal:i.signal})}catch(e){throw A(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(r=>`  ${r}`):[`  ${e.path}${u(e.loudness)}`]),g=[`${D(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})`),...a.files.flatMap(e=>(e.missing??[]).map(r=>`Not measured: ${r}`)),...new Set(a.files.flatMap(e=>(e.fontsLeft??[]).map(r=>`Not in the file: ${r.font} (${r.why}); PowerPoint shows another font where it is not installed.`))),...b.map(w),...v(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/scenery-input.js

@@ -1,2 +1,2 @@
 /*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{z as e}from"zod";import{EXIT as l}from"@allyhub-next/protocol";import{CAMERA_DEFAULTS as m,cameraProblems as h}from"@allyhub-next/scenery";import{CommandError as b}from"../command.js";import{dir as g}from"../fields.js";const s=(t,o)=>new b("usage",t,{exit:l.usage,...o===void 0?{}:{hint:o}});export const SCENERY_FIELDS={item:e.string().describe("The scenery: a path to its folder or its scenery.ts"),dir:g,times:e.array(e.string()).optional().describe("Seconds of scenery time for the word and anchor references the scenery's moves and its update (w.time) are timed by, as a video's part gives them: @turn=3.2,@show=5.1 (@turn+0.2 is found from @turn); over --piece's"),piece:e.string().optional().describe("The video whose scenery layers give those times (default, when one is needed and --times gives none: the one video of the project that draws this scenery)")};const c=e.tuple([e.number(),e.number(),e.number()]);export const LENS_FRAME=e.enum(["diagonal","long","short","phone"]);const f=e.strictObject({position:c,target:e.union([c,e.string()]).exactOptional(),direction:c.exactOptional(),yaw:e.number().exactOptional(),pitch:e.number().exactOptional(),up:c.exactOptional(),roll:e.number().exactOptional(),lens:e.number().exactOptional(),lensFrame:e.union([LENS_FRAME,e.strictObject({aspect:e.number().positive(),keep:e.enum(["long","short"])})]).exactOptional(),fov:e.number().exactOptional(),near:e.number().exactOptional(),far:e.number().exactOptional(),aperture:e.number().exactOptional(),focus:e.union([e.number(),c,e.string()]).exactOptional(),ev:e.number().exactOptional()}),u=e.union([e.string(),f]),p=`as a scenery's code writes a CameraState: {"position":[0,1.6,3],"target":"crate","lens":26}; its fields position, target, direction, yaw, pitch, up, roll, lens (default ${String(m.lens)}), lensFrame, fov, near (default ${String(m.near)}), far (default ${String(m.far)}), aperture, focus, ev`;export const NAMED_FIELDS={camera:e.array(u).optional().describe(`Cameras to look from: each a named camera of the scenery, or one written in JSON ${p}`),move:e.array(e.string()).optional().describe("The scenery's named moves to look from, at each moment")},ONE_CAMERA_FIELDS={camera:u.optional().describe(`The camera: a named camera of the scenery, or one written in JSON ${p}`),move:e.string().optional().describe("The scenery's named move")};const d=`--camera '{"position":[0,1.6,3],"target":"crate"}'`;export function cameraOf(t){let o=t;if(typeof t=="string"){if(!t.trimStart().startsWith("{"))return{name:t};try{o=JSON.parse(t)}catch(n){throw s(`--camera ${t}: not JSON (${n.message}).`,`Write it as ${d}.`)}}const r=f.safeParse(o);if(!r.success){const n=r.error.issues.map(i=>`${i.path.length>0?`${i.path.join(".")}: `:""}${i.message}`);throw s(`--camera ${JSON.stringify(o)}: ${n.join("; ")}.`,`Write it as ${d}.`)}const a=h(r.data);if(a.length>0)throw s(`--camera ${JSON.stringify(o)}: ${a.join("; ")}.`);return{state:r.data}}export function sourcesOf(t){const o=(t.camera??[]).map(cameraOf),r=o.filter(n=>"state"in n).length;let a=0;return[...o.map(n=>"name"in n?{source:n}:(a++,{source:n,label:r>1?`camera ${String(a)}`:"camera"})),...(t.move??[]).map(n=>({source:{move:n}}))]}export function timesOf(t){if(!t||t.length===0)return{};const o={};for(const r of t){const a=r.lastIndexOf("="),n=r.slice(0,a).trim(),i=Number(r.slice(a+1));if(a<=0||n===""||!Number.isFinite(i))throw s(`--times takes reference=seconds pairs (@turn=3.2), not "${r}".`);o[n]=i}return{times:o}}export function sizeOf(t,o="size"){const r=/^(\d+)x(\d+)$/u.exec(t.trim()),a=Number(r?.[1]),n=Number(r?.[2]);if(!r||a<16||n<16||a>8192||n>8192)throw s(`--${o} is WIDTHxHEIGHT in pixels, 16 to 8192 a side, not ${t}.`);return[a,n]}export function momentsOf(t){if(t.at&&t.every!==void 0)throw s("--at lists moments; --every spreads them over --from…--to: give one way.");if(t.at&&t.at.length>0)return t.at;if(t.every===void 0)return[t.from];const{from:o,to:r}=t;if(r===void 0||!(r>o))throw s("--every needs --to, after --from (default 0).");const a=[];for(let n=o;n<=r+1e-9;n+=t.every)a.push(Math.round(n*1e6)/1e6);return a}export function pairOf(t,o){if(!t)return;const[r,a]=t;if(t.length!==2||r===void 0||a===void 0)throw s(`--${o} is two names joined with a comma.`);return[r,a]}
+import{z as e}from"zod";import{EXIT as l}from"@allyhub/protocol";import{CAMERA_DEFAULTS as m,cameraProblems as h}from"@allyhub/scenery";import{CommandError as b}from"../command.js";import{dir as g}from"../fields.js";const s=(t,o)=>new b("usage",t,{exit:l.usage,...o===void 0?{}:{hint:o}});export const SCENERY_FIELDS={item:e.string().describe("The scenery: a path to its folder or its scenery.ts"),dir:g,times:e.array(e.string()).optional().describe("Seconds of scenery time for the word and anchor references the scenery's moves and its update (w.time) are timed by, as a video's part gives them: @turn=3.2,@show=5.1 (@turn+0.2 is found from @turn); over --piece's"),piece:e.string().optional().describe("The video whose scenery layers give those times (default, when one is needed and --times gives none: the one video of the project that draws this scenery)")};const c=e.tuple([e.number(),e.number(),e.number()]);export const LENS_FRAME=e.enum(["diagonal","long","short","phone"]);const f=e.strictObject({position:c,target:e.union([c,e.string()]).exactOptional(),direction:c.exactOptional(),yaw:e.number().exactOptional(),pitch:e.number().exactOptional(),up:c.exactOptional(),roll:e.number().exactOptional(),lens:e.number().exactOptional(),lensFrame:e.union([LENS_FRAME,e.strictObject({aspect:e.number().positive(),keep:e.enum(["long","short"])})]).exactOptional(),fov:e.number().exactOptional(),near:e.number().exactOptional(),far:e.number().exactOptional(),aperture:e.number().exactOptional(),focus:e.union([e.number(),c,e.string()]).exactOptional(),ev:e.number().exactOptional()}),u=e.union([e.string(),f]),p=`as a scenery's code writes a CameraState: {"position":[0,1.6,3],"target":"crate","lens":26}; its fields position, target, direction, yaw, pitch, up, roll, lens (default ${String(m.lens)}), lensFrame, fov, near (default ${String(m.near)}), far (default ${String(m.far)}), aperture, focus, ev`;export const NAMED_FIELDS={camera:e.array(u).optional().describe(`Cameras to look from: each a named camera of the scenery, or one written in JSON ${p}`),move:e.array(e.string()).optional().describe("The scenery's named moves to look from, at each moment")},ONE_CAMERA_FIELDS={camera:u.optional().describe(`The camera: a named camera of the scenery, or one written in JSON ${p}`),move:e.string().optional().describe("The scenery's named move")};const d=`--camera '{"position":[0,1.6,3],"target":"crate"}'`;export function cameraOf(t){let o=t;if(typeof t=="string"){if(!t.trimStart().startsWith("{"))return{name:t};try{o=JSON.parse(t)}catch(n){throw s(`--camera ${t}: not JSON (${n.message}).`,`Write it as ${d}.`)}}const r=f.safeParse(o);if(!r.success){const n=r.error.issues.map(i=>`${i.path.length>0?`${i.path.join(".")}: `:""}${i.message}`);throw s(`--camera ${JSON.stringify(o)}: ${n.join("; ")}.`,`Write it as ${d}.`)}const a=h(r.data);if(a.length>0)throw s(`--camera ${JSON.stringify(o)}: ${a.join("; ")}.`);return{state:r.data}}export function sourcesOf(t){const o=(t.camera??[]).map(cameraOf),r=o.filter(n=>"state"in n).length;let a=0;return[...o.map(n=>"name"in n?{source:n}:(a++,{source:n,label:r>1?`camera ${String(a)}`:"camera"})),...(t.move??[]).map(n=>({source:{move:n}}))]}export function timesOf(t){if(!t||t.length===0)return{};const o={};for(const r of t){const a=r.lastIndexOf("="),n=r.slice(0,a).trim(),i=Number(r.slice(a+1));if(a<=0||n===""||!Number.isFinite(i))throw s(`--times takes reference=seconds pairs (@turn=3.2), not "${r}".`);o[n]=i}return{times:o}}export function sizeOf(t,o="size"){const r=/^(\d+)x(\d+)$/u.exec(t.trim()),a=Number(r?.[1]),n=Number(r?.[2]);if(!r||a<16||n<16||a>8192||n>8192)throw s(`--${o} is WIDTHxHEIGHT in pixels, 16 to 8192 a side, not ${t}.`);return[a,n]}export function momentsOf(t){if(t.at&&t.every!==void 0)throw s("--at lists moments; --every spreads them over --from…--to: give one way.");if(t.at&&t.at.length>0)return t.at;if(t.every===void 0)return[t.from];const{from:o,to:r}=t;if(r===void 0||!(r>o))throw s("--every needs --to, after --from (default 0).");const a=[];for(let n=o;n<=r+1e-9;n+=t.every)a.push(Math.round(n*1e6)/1e6);return a}export function pairOf(t,o){if(!t)return;const[r,a]=t;if(t.length!==2||r===void 0||a===void 0)throw s(`--${o} is two names joined with a comma.`);return[r,a]}