allyhub 0.7.0 → 0.8.0

package/dist/node_modules/@allyhub/formats/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@allyhub/formats",
+  "version": "0.8.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./schemas/*": "./schemas/*"
+  },
+  "sideEffects": false,
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub/jobs/dist/index.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{Jobs,JobFailure,failureOf}from"./jobs.js";export{SHOW_AFTER_MS,SHOW_AT_LEAST_MS,Showing,fractionOf,isOpen,isRunning,overallOf,roundLeft}from"./show.js";

package/dist/node_modules/@allyhub/jobs/dist/jobs.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+const u="allyhub/job-stop";function r(o){return Object.assign(new DOMException(o==="pause"?"The job was paused.":o==="quit"?"Studio is closing.":"The job was cancelled.","AbortError"),{[u]:o})}const c=o=>o.aborted?o.reason?.[u]??"cancel":void 0;export class JobFailure extends Error{reason;constructor(e,t,a){super(t,a),this.name="JobFailure",this.reason=e}}const h=new Set(["ENOTFOUND","EAI_AGAIN","ECONNRESET","ECONNREFUSED","ECONNABORTED","ETIMEDOUT","ENETUNREACH","ENETDOWN","EHOSTUNREACH","EPIPE","UND_ERR_CONNECT_TIMEOUT","UND_ERR_HEADERS_TIMEOUT","UND_ERR_BODY_TIMEOUT","UND_ERR_SOCKET"]);function b(o){const e=[];let t=o;for(;t!==void 0&&e.length<8&&!e.includes(t);)e.push(t),t=t instanceof Error?t.cause:void 0;return e}const p=o=>{if(typeof o!="object"||o===null||!("code"in o))return;const{code:e}=o;return typeof e=="string"?e:void 0};export function failureOf(o){const e=b(o),t=e.map(n=>n instanceof Error?n.message:String(n)).filter((n,l,i)=>n!==""&&i.indexOf(n)===l).join(`
+`),a=e.find(n=>n instanceof JobFailure);if(a)return{reason:a.reason,details:t};const s=e.map(p);return s.includes("ENOSPC")?{reason:"no-space",details:t}:s.some(n=>n!==void 0&&h.has(n))||e.some(n=>n instanceof TypeError&&n.message==="fetch failed")?{reason:"offline",details:t}:{reason:"other",details:t}}let m=0;const f=o=>`${o}${Date.now().toString(36)}${(m++).toString(36)}`;export class Jobs{all=new Map;listeners=new Set;emitEveryMs;stallMs;keep;paceMs;paceAtLeastMs;prefix;constructor(e={}){this.prefix=e.prefix??"j",this.emitEveryMs=e.emitEveryMs??250,this.stallMs=e.stallMs??1e4,this.keep=e.keep??20,this.paceMs=e.paceMs??1e4,this.paceAtLeastMs=e.paceAtLeastMs??3e3}on(e){return this.listeners.add(e),()=>{this.listeners.delete(e)}}list(){return[...this.all.values()].map(e=>({...e.job}))}get(e){const t=this.all.get(e);return t===void 0?void 0:{...t.job}}run(e,t){return this.begin(e,t).result}start(e,t){const{id:a,result:s}=this.begin(e,t);return s.catch(()=>{}),a}begin(e,t){const a=f(this.prefix),s={job:this.fresh(a,e),spec:e,task:t,abort:new AbortController,parts:[],samples:[],stall:void 0,emit:void 0,run:0};return this.all.set(a,s),{id:a,result:this.go(s)}}cancel(e){const t=this.all.get(e);if(!t?.job.cancellable)return!1;if(t.job.state==="paused"){t.run+=1;const a=t.run;return Promise.resolve(t.spec.discard?.()).finally(()=>{t.run===a&&this.end(t,"cancelled")}),!0}return t.job.state!=="running"&&t.job.state!=="queued"?!1:(t.abort.abort(r("cancel")),!0)}pause(e){const t=this.all.get(e);return t?.job.state!=="running"||t.job.pausable!==!0?!1:(t.abort.abort(r("pause")),!0)}resume(e){const t=this.all.get(e);return t?.job.state!=="paused"?!1:(this.again(t,{completed:t.job.completed,total:t.job.total}),!0)}retry(e){const t=this.all.get(e);return t?.job.state!=="failed"&&t?.job.state!=="cancelled"||!t.job.retryable?!1:(this.again(t,t.job.pausable===!0&&t.job.state==="failed"?{completed:t.job.completed,total:t.job.total}:void 0),!0)}paused(e,t,a){const s=f(this.prefix),n={job:{...this.fresh(s,{...e,pausable:!0}),state:"paused",completed:t.completed,...t.total===void 0?{}:{total:t.total}},spec:{...e,pausable:!0},task:a,abort:new AbortController,parts:[],samples:[],stall:void 0,emit:void 0,run:0};return this.all.set(s,n),this.tell(n,!0),s}close(){for(const e of this.all.values())(e.job.state==="running"||e.job.state==="queued")&&e.abort.abort(r("quit"))}again(e,t){e.job={...this.fresh(e.job.id,e.spec),...t===void 0?{}:{completed:t.completed,...t.total===void 0?{}:{total:t.total}}},e.abort=new AbortController,e.parts=[],e.samples=[],e.run+=1,this.go(e).catch(()=>{})}fresh(e,t){return{id:e,about:t.about,what:t.what,...t.name===void 0?{}:{name:t.name},state:"running",completed:0,...t.total===void 0?{}:{total:t.total},unit:t.unit??"bytes",...t.step===void 0?{}:{step:t.step},cancellable:t.cancellable??!0,...t.quiet===!0?{quiet:!0}:{},...t.pausable===!0?{pausable:!0}:{},retryable:t.retryable??!0,started:Date.now()}}async go(e){const t=e.run,a=()=>e.run===t&&e.job.state==="running",s={id:e.job.id,signal:e.abort.signal,stopped:()=>c(e.abort.signal),report:(n,l)=>{!a()||e.parts.length>0||this.moved(e,n,l)},step:n=>{!a()||e.job.step===n||(n===void 0?delete e.job.step:e.job.step=n,this.tell(e,!0))},made:n=>{e.run===t&&(e.job.made=n)},part:(n=1)=>{const l={weight:n,completed:0,total:void 0,done:!1};return e.parts.push(l),{report:(i,d)=>{!a()||l.done||(l.completed=i,d!==void 0&&(l.total=d),this.fromParts(e))},done:()=>{!a()||l.done||(l.done=!0,l.total!==void 0&&(l.completed=l.total),this.fromParts(e))}}}};this.tell(e,!0),this.watchStall(e);try{const n=await e.task(s);return e.run===t&&this.end(e,"done"),n}catch(n){if(e.run===t){const l=c(e.abort.signal);l==="pause"?this.hold(e):l!==void 0||n instanceof Error&&n.name==="AbortError"?this.end(e,"cancelled"):this.end(e,"failed",failureOf(n))}throw n}}fromParts(e){if(e.job.unit==="share"){const s=e.parts.reduce((l,i)=>l+i.weight,0),n=e.parts.reduce((l,i)=>{const d=i.done?1:i.total===void 0||i.total===0?0:Math.min(1,i.completed/i.total);return l+i.weight*d},0);this.moved(e,s===0?0:n/s,1);return}const t=e.parts.reduce((s,n)=>s+n.completed,0),a=e.parts.every(s=>s.total!==void 0);this.moved(e,t,a?e.parts.reduce((s,n)=>s+(n.total??0),0):void 0)}moved(e,t,a){const s=e.job,n=t>s.completed;s.completed=Math.max(0,t),a!==void 0&&(s.total=Math.max(a,s.completed));const l=Date.now();for(e.samples.push({at:l,completed:s.completed});e.samples.length>2&&l-(e.samples[1]?.at??l)>this.paceMs;)e.samples.shift();if(this.pace(e,l),n){const i=s.stalled===!0;delete s.stalled,this.watchStall(e),this.tell(e,i)}else this.tell(e,!1)}pace(e,t){const a=e.job,s=e.samples[0];if(a.total===void 0||s===void 0){delete a.left;return}const n=t-s.at,l=a.completed-s.completed;if(n<this.paceAtLeastMs||l<=0){n>=this.paceMs&&delete a.left;return}a.left=Math.max(0,(a.total-a.completed)/l*(n/1e3))}watchStall(e){e.stall!==void 0&&clearTimeout(e.stall),e.stall=setTimeout(()=>{e.stall=void 0,!(e.job.state!=="running"||e.job.stalled===!0)&&(e.job.stalled=!0,delete e.job.left,e.samples=[],this.tell(e,!0))},this.stallMs)}end(e,t,a){e.stall!==void 0&&clearTimeout(e.stall),e.stall=void 0;const s=e.job;s.state=t,s.ended=Date.now(),delete s.left,delete s.stalled,t==="done"&&s.total!==void 0&&(s.completed=s.total),a&&(s.failure=a),this.tell(e,!0),this.trim()}hold(e){e.stall!==void 0&&clearTimeout(e.stall),e.stall=void 0,e.job.state="paused",delete e.job.left,delete e.job.stalled,this.tell(e,!0)}trim(){const e=[...this.all.values()].filter(t=>t.job.state==="done"||t.job.state==="failed"||t.job.state==="cancelled");for(const t of e.slice(0,Math.max(0,e.length-this.keep)))this.all.delete(t.job.id)}tell(e,t){if(t){e.emit!==void 0&&clearTimeout(e.emit),e.emit=void 0,this.send(e);return}e.emit??=setTimeout(()=>{e.emit=void 0,this.send(e)},this.emitEveryMs)}send(e){const t={...e.job};for(const a of this.listeners)a(t)}}

package/dist/node_modules/@allyhub/jobs/dist/show.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const SHOW_AFTER_MS=1e3,SHOW_AT_LEAST_MS=800,isRunning=e=>e.state==="running"||e.state==="queued",isOpen=e=>isRunning(e)||e.state==="paused";export function fractionOf(e){if(e.state==="done")return 1;if(!(e.total===void 0||e.total<=0))return Math.min(1,Math.max(0,e.completed/e.total))}export function overallOf(e){const n=e.filter(i=>isRunning(i)&&i.quiet!==!0),s=n.map(fractionOf).filter(i=>i!==void 0);return s.length===0?{running:n.length}:{running:n.length,fraction:s.reduce((i,r)=>i+r,0)/s.length}}const c=[1,2,3,5,10,15,20,30],d=e=>c.find(n=>e<=n)??e;export function roundLeft(e){const n=Math.max(1,Math.ceil(e));if(n<=30)return{n:d(n),unit:"s"};const s=Math.ceil(n/60);return s<=30?{n:d(s),unit:"min"}:{n:Math.ceil(s/60),unit:"h"}}export class Showing{seen=new Map;shown=new Map;at(n,s){const i=[];let r;const a=t=>{t>s&&(r===void 0||t<r)&&(r=t)},h=new Set(n.map(t=>t.id));for(const t of[...this.seen.keys()])h.has(t)||(this.seen.delete(t),this.shown.delete(t));for(const t of n){const f=this.seen.get(t.id)??s;this.seen.set(t.id,f);const u=this.shown.get(t.id);let o;isRunning(t)?(o=s-f>=1e3,o||a(f+1e3)):t.state==="failed"||t.state==="paused"?o=!0:u!==void 0?(o=s-u<800,o&&a(u+800)):o=!1,o&&(u===void 0&&this.shown.set(t.id,s),i.push(t))}return{jobs:i,next:r}}hasShown(n){return this.shown.has(n)}}

package/dist/node_modules/@allyhub/jobs/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@allyhub/jobs",
+  "version": "0.8.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub/measure/dist/compare.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{blankImage as nt,pasteImage as et,resizeImage as ut,grainSize as yt}from"@allyhub/render";const E=h=>Math.round(h*1e3)/1e3;export const COMPARE_DEFAULTS={tolerance:2.3,background:[255,255,255],gap:4,shift:0,resize:"stretch",heatMax:20,ssimWindow:8,edgeStep:90,edgeSpan:12,grainBlock:48,grainShare:.1};export function grainOf(h,b,k,o=COMPARE_DEFAULTS.grainBlock,r=COMPARE_DEFAULTS.grainShare){const s=Math.max(6,Math.round(o)),e=Math.max(1,Math.floor(s/6)),l=(s-1)/2;let A=0;for(let d=0;d<s;d++)A+=(d-l)**2;A*=s;const t=[];for(let d=0;d+s<=k;d+=s)for(let S=0;S+s<=b;S+=s){let z=0,v=0,B=0;for(let M=0;M<s;M++)for(let y=0;y<s;y++){const U=h[(d+M)*b+S+y]??0;z+=U,v+=(y-l)*U,B+=(M-l)*U}if(z/=s*s,z<12||z>243)continue;const R=v/A,P=B/A,W=new Float32Array(s*s);let J=0;for(let M=0;M<s;M++)for(let y=0;y<s;y++){const U=(h[(d+M)*b+S+y]??0)-z-R*(y-l)-P*(M-l);W[M*s+y]=U,J+=U*U}let N=0;for(let M=0;M+e<=s;M+=e)for(let y=0;y+e<=s;y+=e){let U=0;for(let Q=0;Q<e;Q++)for(let j=0;j<e;j++)U+=W[(M+Q)*s+y+j]??0;N+=(U/(e*e))**2}let D=0;for(let M=0;M<s;M++)for(let y=0;y<s;y++){const U=W[M*s+y]??0;y+1<s&&(D+=U*(W[M*s+y+1]??0)),M+1<s&&(D+=U*(W[(M+1)*s+y]??0))}t.push({content:N,sse:J,across:D})}if(t.length===0)return;t.sort((d,S)=>d.content-S.content);const i=t.slice(0,Math.max(1,Math.round(t.length*Math.min(1,Math.max(0,r))))),f=i.reduce((d,S)=>d+S.sse,0),g=i.reduce((d,S)=>d+S.across,0),I=f/(i.length*(s*s-3)),p=f>0?g/(2*s*(s-1))/(f/(s*s)):0,m=Math.sqrt(I);return{blocks:i.length,of:t.length,sd:E(m),amount:E(m/255),correlation:E(p),size:E(yt(p,Math.min(b,k)))}}function wt(h,b,k){const o=p=>{const m=p/255;return m<=.04045?m/12.92:((m+.055)/1.055)**2.4},r=o(h),s=o(b),e=o(k),l=(.4124564*r+.3575761*s+.1804375*e)/.95047,A=.2126729*r+.7151522*s+.072175*e,t=(.0193339*r+.119192*s+.9503041*e)/1.08883,i=p=>p>216/24389?Math.cbrt(p):(24389/27*p+16)/116,f=i(l),g=i(A),I=i(t);return[116*g-16,500*(f-g),200*(g-I)]}function ft(h,b){const k=h.width*h.height,o=new Float32Array(k*3),r=new Float32Array(k*3),s=new Map;for(let e=0;e<k;e++){const l=(h.data[e*4+3]??0)/255,A=Math.round((h.data[e*4]??0)*l+b[0]*(1-l)),t=Math.round((h.data[e*4+1]??0)*l+b[1]*(1-l)),i=Math.round((h.data[e*4+2]??0)*l+b[2]*(1-l));o[e*3]=A,o[e*3+1]=t,o[e*3+2]=i;const f=A<<16|t<<8|i;let g=s.get(f);g||(g=wt(A,t,i),s.size<1<<20&&s.set(f,g)),r[e*3]=g[0],r[e*3+1]=g[1],r[e*3+2]=g[2]}return{rgb:o,lab:r}}function rt(h,b,k,o,r,s,e){let l=0,A=0;for(let t=Math.max(0,s);t<Math.min(o,o+s);t+=e)for(let i=Math.max(0,r);i<Math.min(k,k+r);i+=e){const f=(t*k+i)*3,g=((t-s)*k+(i-r))*3,I=(h[f]??0)-(b[g]??0),p=(h[f+1]??0)-(b[g+1]??0),m=(h[f+2]??0)-(b[g+2]??0);l+=Math.sqrt(I*I+p*p+m*m),A++}return A?l/A:1/0}function kt(h,b,k,o,r){const s=6.502500000000001,e=(.03*255)**2,l=Math.min(r,k),A=Math.min(r,o),t=Math.max(1,Math.floor(r/2));let i=0,f=0;for(let g=0;g+A<=o;g+=t)for(let I=0;I+l<=k;I+=t){let p=0,m=0;for(let B=g;B<g+A;B++)for(let R=I;R<I+l;R++)p+=h[B*k+R]??0,m+=b[B*k+R]??0;const d=l*A;p/=d,m/=d;let S=0,z=0,v=0;for(let B=g;B<g+A;B++)for(let R=I;R<I+l;R++){const P=(h[B*k+R]??0)-p,W=(b[B*k+R]??0)-m;S+=P*P,z+=W*W,v+=P*W}S/=d-1||1,z/=d-1||1,v/=d-1||1,i+=(2*p*m+s)*(2*v+e)/((p*p+m*m+s)*(S+z+e)),f++}return f?i/f:1}function vt(h,b,k){const o=Math.min(1,Math.max(0,(h-b)/Math.max(1e-6,k-b)));return[255,Math.round(220*(1-o)),0,.55+.45*o]}export function edgeWidths(h,b,k,o){const r=[],s=(t,i)=>{let f=0;for(;f<i-o.span;){if(Math.abs(t(f)-t(f+o.span))<=o.step){f++;continue}let g=f,I=-1;for(let v=f;v<f+o.span;v++){const B=Math.abs(t(v+1)-t(v));B>I&&(I=B,g=v)}const p=t(g+1)>t(g);let m=g;for(;m>0&&g-m<o.span&&(p?t(m-1)<=t(m):t(m-1)>=t(m));)m--;let d=g+1;for(;d<i-1&&d-g-1<o.span&&(p?t(d+1)>=t(d):t(d+1)<=t(d));)d++;const S=t(m),z=t(d);if(Math.abs(z-S)>o.step){const v=[];for(let D=m;D<=d;D++)v.push(p?t(D):-t(D));const B=Math.min(S,z),R=Math.abs(z-S),P=D=>p?B+D*R:-(B+(1-D)*R),W=D=>{for(let M=0;M<v.length-1;M++){const y=v[M]??0,U=v[M+1]??0;if(y<=D&&D<U)return M+(D-y)/(U-y)}},J=W(P(.1)),N=W(P(.9));J!==void 0&&N!==void 0&&N>J&&r.push(N-J)}f=Math.max(f+1,d)}};for(let t=0;t<k;t++)s(i=>h[t*b+i]??0,b);for(let t=0;t<b;t++)s(i=>h[i*b+t]??0,k);r.sort((t,i)=>t-i);const e=t=>r.length===0?void 0:E(r[Math.min(r.length-1,Math.floor(t*r.length))]??0),l=e(.25),A=e(.5);return{edges:r.length,...l===void 0?{}:{p25:l},...A===void 0?{}:{median:A}}}const bt=2.563;export function compareImages(h,b,k={}){const o={...COMPARE_DEFAULTS,...k};let r=b,s;if(r.width!==h.width||r.height!==h.height){if(o.resize==="stretch")r=ut(r,h.width,h.height);else if(o.resize==="width"){const n=Math.max(1,Math.round(r.height*h.width/r.width));r=ut(r,h.width,n)}r!==b&&(s={mode:o.resize,from:[b.width,b.height],to:[r.width,r.height],scale:[E(r.width/b.width),E(r.height/b.height)]})}const e=h.width,l=h.height,A=nt(e,l);et(A,r,0,0);const t=ft(h,o.background);let i=ft(A,o.background),f={x:0,y:0},g;if(o.shift>0){const n=e*l>1e6?2:1,c=rt(t.lab,i.lab,e,l,0,0,1);let a={x:0,y:0,meanDeltaE:rt(t.lab,i.lab,e,l,0,0,n)};for(let x=-o.shift;x<=o.shift;x++)for(let w=-o.shift;w<=o.shift;w++){if(w===0&&x===0)continue;const q=rt(t.lab,i.lab,e,l,w,x,n);q<a.meanDeltaE-1e-9&&(a={x:w,y:x,meanDeltaE:q})}f={x:a.x,y:a.y},g={range:o.shift,unshifted:E(c),best:{...f,meanDeltaE:E(rt(t.lab,i.lab,e,l,a.x,a.y,1))}}}const I=nt(e,l);et(I,r,f.x,f.y),(f.x!==0||f.y!==0)&&(i=ft(I,o.background));const p=Math.max(0,f.x),m=Math.max(0,f.y),d=Math.min(e,r.width+f.x),S=Math.min(l,r.height+f.y),z=Math.max(0,d-p),v=Math.max(0,S-m),B=new Float32Array(e*l),R=(n,c)=>n>=p&&n<d&&c>=m&&c<S;let P=0,W=0,J=0;const N=[0,0,0,0],D=[0,0,0,0],M=new Float32Array(z*v),y=new Float32Array(z*v),U=.05,Q=new Uint32Array(Math.ceil(300/U)+1);for(let n=m;n<S;n++)for(let c=p;c<d;c++){const a=n*e+c,x=(t.lab[a*3]??0)-(i.lab[a*3]??0),w=(t.lab[a*3+1]??0)-(i.lab[a*3+1]??0),q=(t.lab[a*3+2]??0)-(i.lab[a*3+2]??0),u=Math.sqrt(x*x+w*w+q*q);B[a]=u;const O=Math.min(Q.length-1,Math.floor(u/U));Q[O]=(Q[O]??0)+1,P+=u,u>W&&(W=u),u>o.tolerance&&J++;for(let F=0;F<3;F++){const $=Math.abs((t.rgb[a*3+F]??0)-(i.rgb[a*3+F]??0));N[F]=(N[F]??0)+$,$>(D[F]??0)&&(D[F]=$)}const L=Math.abs((h.data[a*4+3]??0)-(I.data[a*4+3]??0));N[3]=(N[3]??0)+L,L>(D[3]??0)&&(D[3]=L);const _=(n-m)*z+(c-p);M[_]=.2126*(t.rgb[a*3]??0)+.7152*(t.rgb[a*3+1]??0)+.0722*(t.rgb[a*3+2]??0),y[_]=.2126*(i.rgb[a*3]??0)+.7152*(i.rgb[a*3+1]??0)+.0722*(i.rgb[a*3+2]??0)}const j=z*v;let dt=0;for(let n=0,c=0;n<Q.length;n++)if(c+=Q[n]??0,c>=j*.95){dt=n*U;break}const X=Math.max(1,Math.round(o.gap)),tt=Math.ceil(e/X),it=Math.ceil(l/X),ot=new Uint8Array(tt*it);for(let n=m;n<S;n++)for(let c=p;c<d;c++)(B[n*e+c]??0)>o.tolerance&&(ot[Math.floor(n/X)*tt+Math.floor(c/X)]=1);const at=new Uint8Array(tt*it),st=[];for(let n=0;n<ot.length;n++){if(!ot[n]||at[n])continue;const c=[n];at[n]=1;let a=1/0,x=1/0,w=-1,q=-1,u=0,O=0,L=0;for(;c.length;){const _=c.pop()??0,F=_%tt,$=Math.floor(_/tt);for(let C=$*X;C<Math.min(l,($+1)*X);C++)for(let G=F*X;G<Math.min(e,(F+1)*X);G++){if(!R(G,C))continue;const V=B[C*e+G]??0;V<=o.tolerance||(u++,O+=V,V>L&&(L=V),G<a&&(a=G),C<x&&(x=C),G>w&&(w=G),C>q&&(q=C))}for(let C=$-1;C<=$+1;C++)for(let G=F-1;G<=F+1;G++){if(G<0||C<0||G>=tt||C>=it)continue;const V=C*tt+G;ot[V]&&!at[V]&&(at[V]=1,c.push(V))}}u>0&&st.push({box:[a,x,w-a+1,q-x+1],pixels:u,meanDeltaE:E(O/u),maxDeltaE:E(L)})}st.sort((n,c)=>c.pixels-n.pixels||n.box[1]-c.box[1]||n.box[0]-c.box[0]);const Y=nt(e,l,[255,255,255,255]);for(let n=0;n<e*l;n++){let a=255-(255-(.2126*(t.rgb[n*3]??0)+.7152*(t.rgb[n*3+1]??0)+.0722*(t.rgb[n*3+2]??0)))*.35,x=a,w=a;const q=B[n]??0;if(q>o.tolerance){const[u,O,L,_]=vt(q,o.tolerance,o.heatMax);a=a*(1-_)+u*_,x=x*(1-_)+O*_,w=w*(1-_)+L*_}Y.data[n*4]=Math.round(a),Y.data[n*4+1]=Math.round(x),Y.data[n*4+2]=Math.round(w)}const mt=n=>{const[c,a,x,w]=n,q=(u,O)=>{if(u<0||O<0||u>=e||O>=l)return;const L=(O*e+u)*4;Y.data[L]=30,Y.data[L+1]=90,Y.data[L+2]=230};for(let u=c-2;u<c+x+2;u++)q(u,a-2),q(u,a+w+1);for(let u=a-2;u<a+w+2;u++)q(c-2,u),q(c+x+1,u)};for(const n of st.slice(0,50))mt(n.box);const Z=Math.max(4,Math.round(Math.min(e,l)/50)),ct=nt(e*3+Z*4,l+Z*2,[128,128,128,255]),ht=n=>{const c=nt(e,l,[...o.background,255]);for(let a=0;a<e*l;a++){const x=(n.data[a*4+3]??0)/255;for(let w=0;w<3;w++)c.data[a*4+w]=Math.round((n.data[a*4+w]??0)*x+(o.background[w]??0)*(1-x))}return c};et(ct,ht(h),Z,Z),et(ct,ht(I),e+Z*2,Z),et(ct,Y,e*2+Z*3,Z);const Mt=()=>{const n={step:o.edgeStep,span:o.edgeSpan},c=edgeWidths(M,z,v,n),a=edgeWidths(y,z,v,n),x=c.p25!==void 0&&a.p25!==void 0?E(Math.sqrt(Math.max(0,(c.p25/bt)**2-(a.p25/bt)**2))*(1080/Math.min(e,l))):void 0;return{...n,reference:c,candidate:a,...x===void 0?{}:{soften:x}}},gt=(n,c)=>{const a=[0,0,0],x=[0,0,0];for(let O=m;O<S;O++)for(let L=p;L<d;L++){const _=O*e+L;for(let F=0;F<3;F++)a[F]=(a[F]??0)+(n.rgb[_*3+F]??0),x[F]=(x[F]??0)+(n.lab[_*3+F]??0)}const w=Float32Array.from(c).sort(),q=O=>w.length?w[Math.min(w.length-1,Math.floor(O*w.length))]??0:0,u=O=>E(j?O/j:0);return{rgb:[u(a[0]??0),u(a[1]??0),u(a[2]??0)],luma:{mean:u(c.reduce((O,L)=>O+L,0)),p5:E(q(.05)),p50:E(q(.5)),p95:E(q(.95))},lab:[u(x[0]??0),u(x[1]??0),u(x[2]??0)]}},T=gt(t,M),H=gt(i,y),K=(n,c)=>E(n-c),xt={reference:T,candidate:H,difference:{rgb:[K(H.rgb[0],T.rgb[0]),K(H.rgb[1],T.rgb[1]),K(H.rgb[2],T.rgb[2])],luma:{mean:K(H.luma.mean,T.luma.mean),p5:K(H.luma.p5,T.luma.p5),p50:K(H.luma.p50,T.luma.p50),p95:K(H.luma.p95,T.luma.p95)},lab:[K(H.lab[0],T.lab[0]),K(H.lab[1],T.lab[1]),K(H.lab[2],T.lab[2])]}},pt=()=>{const n=grainOf(M,z,v,o.grainBlock,o.grainShare),c=grainOf(y,z,v,o.grainBlock,o.grainShare);return{block:o.grainBlock,share:o.grainShare,...n?{reference:n}:{},...c?{candidate:c}:{},...n&&c?{amount:E(Math.sqrt(Math.max(0,n.sd**2-c.sd**2))/255)}:{}}},lt=n=>({mean:E(j?(N[n]??0)/j:0),max:D[n]??0});return{result:{reference:{width:h.width,height:h.height},candidate:{width:b.width,height:b.height},...s?{resized:s}:{},compared:[p,m,z,v],offset:f,...g?{search:g}:{},pixels:j,tolerance:o.tolerance,differing:J,share:j?E(J/j):0,deltaE:{mean:E(j?P/j:0),max:E(W),p95:E(dt)},channels:{r:lt(0),g:lt(1),b:lt(2),alpha:lt(3)},levels:xt,grain:pt(),ssim:E(kt(M,y,z,v,o.ssimWindow)),regions:st,edges:Mt()},heatmap:Y,side:ct,aligned:ht(I)}}

package/dist/node_modules/@allyhub/measure/dist/contrast.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{contrastOptions as b,contrastOver as z,fact as T,hexOf as A,linesRegion as C,overlapArea as D}from"@allyhub/video-core";import{readPng as k}from"@allyhub/render";const E=e=>Math.round(e*1e3)/1e3;function I(e){let t;for(const n of e)if(n){if(!t){t=[n[0],n[1],n[0]+n[2],n[1]+n[3]];continue}t=[Math.min(t[0],n[0]),Math.min(t[1],n[1]),Math.max(t[2],n[0]+n[2]),Math.max(t[3],n[1]+n[3])]}return t?[t[0],t[1],t[2]-t[0],t[3]-t[1]]:void 0}export async function textContrast(e,t,n={},s){const r=e.timeline,l=b(n),u=[],d=r.fps;for(const c of[...new Set(t)].sort((i,o)=>i-o)){const i=Math.round(Math.min(Math.max(c,0),r.duration)*d)/d,o=r.parts.find(a=>i>=a.start-1e-6&&i<a.end-1e-6),p=(await e.inks(i)).filter(a=>(a.text.opacity??1)>=l.opacity-1e-9);if(p.length===0)continue;const g=p.map(a=>C(a.lines,r.width,r.height)),w=I(g),x=async a=>{if(w){await e.hideText(!0,a);try{if(s){const m=await s.still(i);return{pixels:k(m),x:0,y:0,scale:1}}const f=await e.region(i,o?.key,w,l.scale);return{...f,pixels:k(f.png)}}finally{await e.hideText(!1)}}},O=await x(!1),v=p.some(a=>a.stroke===!0||a.shadow===!0)?await x(!0):void 0;p.forEach((a,f)=>{const m=P(a,g[f],O,l,s!==void 0,a.stroke===!0||a.shadow===!0?v:void 0);if(!s&&g[f]){const S=g[f],y=(r.footage??[]).filter(h=>(o===void 0||h.part===o.key)&&i>=h.start-1e-6&&i<h.end-1e-6&&D(h.box,S)>0).map(h=>h.file);y.length>0&&(m.footage=[...new Set(y)])}u.push(T("text-contrast",{piece:e.target.piece,output:e.target.output,combo:e.target.combo,format:e.target.format,...o?{part:o.key}:{},t:E(i)},m))})}return u}const M=(e,t,n)=>z(e.lines,{width:t.pixels.width,height:t.pixels.height,data:t.pixels.data},{x:t.x,y:t.y,scale:t.scale},n.percentile);function P(e,t,n,s,r,l){const u=[...new Set(e.lines.flatMap(o=>o.fill?[A(o.fill)]:[]))],d={text:e.text,fill:u,size:e.size,weight:e.weight,...e.shadow?{shadow:!0}:{},...e.stroke?{stroke:!0}:{},picture:r?"final":"graphics",options:s};if(u.length===0)return{...d,missing:"fill",why:"its glyphs are not filled with a colour (a background clipped to the text, or a transparent fill)"};const c=t&&n?M(e,n,s):void 0;if(!c)return{...d,missing:"pixels",why:"none of its glyphs is inside the frame"};const i=t&&l?M(e,l,s):void 0;return{...d,ratio:{min:c.min,low:c.low,median:c.median},pixels:c.pixels,background:c.background,...i?{under:{ratio:{min:i.min,low:i.low,median:i.median},background:i.background}}:{}}}

package/dist/node_modules/@allyhub/measure/dist/cut-sheet.js

@@ -0,0 +1,46 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{levelCurve as M,silenceBands as v,soundAtCut as j,waveColumns as B}from"@allyhub/audio";import{stripFrames as z,wordsAround as D}from"./cuts.js";export const CUT_REVIEW_DEFAULTS={span:1,threshold:-40},CUT_SHEET_WIDTH=1280;function y(t,s,e,a){const i=new Float32Array(Math.round(a*s)),o=Math.max(0,Math.round(e*s)),p=Math.min(t.length,Math.round((e+a)*s)),d=Math.max(0,-Math.round(e*s));return p>o&&i.set(t.subarray(o,p),d),i}export function reviewCuts(t){const s={...CUT_REVIEW_DEFAULTS,...t.options};return t.cuts.map(e=>{const a=e.t-s.span,i=y(t.samples,t.rate,a,2*s.span),o=v(i,t.rate,{t0:a,threshold:s.threshold}).find(d=>d.start<=e.t+.001&&d.end>=e.t-.001),p=t.words.find(d=>d.start<e.t-.005&&d.end>e.t+.005);return{...e,index:t.all.indexOf(e)+1,said:D(t.words,e.t),...p?{across:p.text}:{},...o?{silence:{...o,before:Math.max(0,Math.round((e.t-o.start)*1e3)/1e3),after:Math.max(0,Math.round((o.end-e.t)*1e3)/1e3)}}:{},...t.samples.length>0?{sound:j(t.samples,t.rate,Math.round(e.t*t.rate))}:{},cues:t.cues.filter(d=>Math.abs(d.t-e.t)<s.span).map(d=>({t:d.t,sound:d.sound})),frames:z(e.t,t.fps,t.frames,e.transition,s)}})}const c=t=>t.replace(/[&<>"]/g,s=>({"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;"})[s]??s),f=(t,s=2)=>`${t<0?"−":"+"}${Math.abs(t).toFixed(s)}`;export const dbText=t=>t<=-120?"−∞":`${t<0?"−":""}${Math.abs(t).toFixed(1)}`;const I={words:"words removed",gap:"no words removed",join:"part join",camera:"camera cut"};export const speechEdgeText=t=>[t.speechOut===void 0?"":`speech before ends at ${f(t.speechOut-t.t)} s`,t.speechIn===void 0?"":`speech after starts at ${f(t.speechIn-t.t)} s`].filter(s=>s!=="").join(", ");export function cutLine(t){const s=t.skip?`${t.skip[0].toFixed(2)}–${t.skip[1].toFixed(2)} s of ${t.file??"the take"}`:"";if(t.kind==="join"){const a=t.removed.length>0?`; between them the take says “${t.removed.join(" ")}” (${s})`:s?`; skips ${s}`:"",i=speechEdgeText(t),o=t.transition?` · ${t.transition.label} over ${t.transition.start.toFixed(2)}–${t.transition.end.toFixed(2)} s`:"";return`${t.previous??""} → ${t.part}${o}${a}${i?` · ${i}`:""}`}if(t.kind==="camera")return`${t.layer??"a scenery"}'s camera cuts to its next shot in ${t.part}`;const e=t.skip?` ${(t.skip[1]-t.skip[0]).toFixed(2)} s`:"";return t.kind==="words"?`removed${e} “${t.removed.join(" ")}” (${s})`:`removed${e}, no words (a pause shortened, or a sound taken out): ${s}`}export function silenceText(t){return t?`${t.before.toFixed(2)} s before it, ${t.after.toFixed(2)} s after it`:"none"}function T(t){const{width:s,height:e}=t,a=n=>(n-t.t0)/(2*t.span)*s,i=n=>n.toFixed(1),o=e/2,p=t.bands.map(n=>`<rect x="${i(a(n.start))}" y="0" width="${i(Math.max(1,a(n.end)-a(n.start)))}" height="${String(e)}" fill="rgba(56,189,248,.22)"/>`).join(""),d=B(t.samples,Math.round(s/2)).map(([n,h],$)=>`M${String($*2+1)} ${i(o-h*o)}V${i(o-n*o+.5)}`).join(""),l=n=>e-(Math.max(-60,n)+60)/60*e,b=M(t.samples,t.rate,{t0:t.t0}).map(n=>`${i(a(n.t))},${i(l(n.db))}`).join(" "),x=(n,h,$,u="")=>`<line x1="${i(a(n))}" x2="${i(a(n))}" y1="0" y2="${String(e)}" stroke="${h}" stroke-width="1.5"${$?` stroke-dasharray="${$}"`:""}/>${u}`,g=Array.from({length:9},(n,h)=>`<line x1="${i(a(t.t+(h-4)*(t.span/4)))}" x2="${i(a(t.t+(h-4)*(t.span/4)))}" y1="${String(e-6)}" y2="${String(e)}" stroke="#71717a"/>`).join("");return`<svg width="${String(s)}" height="${String(e)}" viewBox="0 0 ${String(s)} ${String(e)}" xmlns="http://www.w3.org/2000/svg">
+    <rect width="${String(s)}" height="${String(e)}" fill="#09090b"/>${p}
+    <line x1="0" x2="${String(s)}" y1="${String(o)}" y2="${String(o)}" stroke="#3f3f46"/>
+    <path d="${d}" stroke="#a1a1aa" stroke-width="1.6"/>
+    <line x1="0" x2="${String(s)}" y1="${i(l(t.threshold))}" y2="${i(l(t.threshold))}" stroke="#38bdf8" stroke-dasharray="3 4"/>
+    <polyline points="${b}" fill="none" stroke="#facc15" stroke-width="1.5"/>${g}
+    ${t.others.map(n=>x(n,"#f59e0b","5 4")).join("")}
+    ${t.cues.map(n=>x(n.t,"#c084fc","2 3",`<text x="${i(a(n.t)+4)}" y="14" fill="#c084fc" font-size="12">${c(n.sound)}</text>`)).join("")}
+    ${t.speech.map((n,h)=>x(n.t,"#4ade80","6 3",`<text x="${i(a(n.t)+4)}" y="${String(e-10-h*14)}" fill="#4ade80" font-size="12">${c(n.label)}</text>`)).join("")}
+    <line x1="${i(a(t.t))}" x2="${i(a(t.t))}" y1="0" y2="${String(e)}" stroke="#ef4444" stroke-width="2"/>
+  </svg>`}export function cutSheetHtml(t){const s={...CUT_REVIEW_DEFAULTS,...t.options},e=t.review,a=16,i=6,o=t.width-a*2,p=Math.floor((o-i*(Math.max(1,t.perStrip)-1)-10)/Math.max(1,t.perStrip)),d=Math.round(p/t.aspect),l=e.t-s.span,b=y(t.samples,t.rate,l,2*s.span),x=v(b,t.rate,{t0:l,threshold:s.threshold}),g=r=>(r-l)/(2*s.span)*o,n=t.words.find(r=>r.start<e.t-.005&&r.end>e.t+.005),h=t.words.filter(r=>r.end>l&&r.start<e.t+s.span).map(r=>{const m=Math.max(0,g(r.start)),w=Math.min(o,g(r.end));return`<div class="${r===n?"w across":r.start<e.t?"w before":"w after"}" style="left:${m.toFixed(1)}px;width:${Math.max(2,w-m).toFixed(1)}px">${c(r.text)}</div>`}).join(""),$=e.frames.map((r,m)=>`${r.side==="after"&&e.frames[m-1]?.side==="before"?'<div class="cutbar"></div>':""}<div class="tile ${r.side}${r.window?" window":""}" style="width:${String(p)}px;height:${String(d)}px"><img src="${c(t.picture(r.n))}"><span class="label">${r.t.toFixed(2)} s<br><b>${f(r.t-e.t)}</b></span></div>`).join(""),u=e.sound,k=u?`level at the cut <b>${dbText(u.levelDb)}</b> dBFS (10 ms) · around <b>${dbText(u.aroundDb)}</b> dBFS · peak ±5 ms <b>${dbText(u.peakDb)}</b> dBFS · sample step <b>${f(u.jumpDb,1)}</b> dB vs around`:"no sound",S=[...e.speechOut===void 0?[]:[{t:e.speechOut,label:`${e.previous??""} speech ends`}],...e.speechIn===void 0?[]:[{t:e.speechIn,label:`${e.part} speech starts`}]],F=`Cut ${String(e.index)}/${String(t.total)} · ${e.t.toFixed(3)} s · ${I[e.kind]}${e.transition?` with a transition (${e.transition.label})`:""} · ${e.part}`;return`<!doctype html><html><head><meta charset="utf-8"><style>
+    * { box-sizing: border-box; }
+    body { margin: 0; background: #18181b; color: #f4f4f5; padding: ${String(a)}px; width: ${String(t.width)}px; font: 15px/1.45 -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; }
+    h1 { font-size: 20px; margin: 0 0 2px; font-weight: 650; }
+    .sub { color: #d4d4d8; margin: 0 0 10px; }
+    .strip { display: flex; gap: ${String(i)}px; align-items: stretch; margin-bottom: 10px; }
+    .tile { position: relative; background: #000; flex: none; outline: 2px solid transparent; }
+    .tile.before { outline-color: #3b82f6; } .tile.after { outline-color: #22c55e; }
+    .tile.window { outline-style: dashed; outline-color: #f59e0b; }
+    .tile img { width: 100%; height: 100%; object-fit: contain; display: block; }
+    .label { position: absolute; left: 3px; top: 3px; padding: 1px 5px; border-radius: 3px; background: rgba(0,0,0,.75); font-size: 12px; line-height: 1.3; font-variant-numeric: tabular-nums; }
+    .cutbar { width: 4px; flex: none; background: #ef4444; border-radius: 2px; }
+    .axis { display: flex; justify-content: space-between; color: #a1a1aa; font-size: 12px; font-variant-numeric: tabular-nums; margin: 2px 0 4px; }
+    .words { position: relative; height: 26px; background: #09090b; margin-bottom: 10px; }
+    .w { position: absolute; top: 2px; height: 22px; font-size: 13px; line-height: 22px; padding: 0 3px; overflow: hidden; white-space: nowrap; border-radius: 3px; }
+    .w.before { background: #1e3a8a; } .w.after { background: #14532d; } .w.across { background: #7f1d1d; outline: 1px solid #ef4444; }
+    .wcut { position: absolute; top: 0; bottom: 0; width: 2px; background: #ef4444; }
+    .facts { font-variant-numeric: tabular-nums; color: #e4e4e7; }
+    .facts div { margin: 2px 0; }
+    .key { color: #a1a1aa; font-size: 12px; margin-top: 6px; }
+  </style></head><body>
+    <h1>${c(F)}</h1>
+    <div class="sub">${c(cutLine(e))}</div>
+    <div class="strip">${$}</div>
+    <div>${T({samples:b,rate:t.rate,t0:l,t:e.t,span:s.span,width:o,height:150,bands:x,threshold:s.threshold,others:t.others,cues:e.cues,speech:S})}</div>
+    <div class="axis"><span>${l.toFixed(2)} s</span><span>cut ${e.t.toFixed(3)} s</span><span>${(e.t+s.span).toFixed(2)} s</span></div>
+    <div class="words">${h}<div class="wcut" style="left:${(o/2-1).toFixed(1)}px"></div></div>
+    <div class="facts">
+      <div>silence at the cut (under ${String(s.threshold)} dBFS): <b>${silenceText(e.silence)}</b></div>
+      <div>${k}</div>
+      <div>before: “${c(e.said.before)}” · after: “${c(e.said.after)}”${e.across?` · said across the cut: “${c(e.across)}”`:""}</div>
+      ${e.cues.length>0?`<div>sound cues: ${e.cues.map(r=>`${c(r.sound)} at ${f(r.t-e.t)} s`).join(", ")}</div>`:""}
+    </div>
+    <div class="key">Blue frames before the cut, green after${e.transition?", dashed orange the frames in the transition's window":""}. Waveform grey (full scale = half the height), level yellow (−60 to 0 dBFS), dashed blue the silence threshold, shaded blue the silence bands, red the cut, dashed orange other cuts, dotted purple sound cues, dashed green where a join's speech ends or starts away from the picture cut.</div>
+  </body></html>`}

package/dist/node_modules/@allyhub/measure/dist/cuts.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{transitionLabel as b}from"@allyhub/video-core";const M=t=>Math.round(t*1e3)/1e3;function y(t,s,a){return!t||a<=s?[]:t.filter(e=>e.start>=s-1e-6&&e.start<a-1e-6).map(e=>e.text)}function k(t,s,a,e,h=1){const c=[];for(let r=1;r<t.length;r++){const n=t[r-1],f=t[r];if(!n||!f)continue;const i=M(n.from+(f.at-n.at)*h),u=y(e,i,f.from);c.push({t:f.at,kind:u.length>0?"words":"gap",part:a,file:s,skip:[i,M(f.from)],removed:u})}return c}function x(t){const s=t.cuts?.[0],a=t.cuts?.at(-1),e=t.speed??1;return{start:s?s.from:t.from,end:a?a.from+(t.end-a.at)*e:t.from+(t.end-t.start)*e}}export function listCuts(t,s,a=[]){const e=[];for(const r of t.parts){const n=r.speech;n?.cuts&&e.push(...k(n.cuts,n.file,r.key,s[n.file]?.words,n.speed))}for(const r of t.footage??[])r.cuts&&e.push(...k(r.cuts,r.file,r.part,s[r.file]?.words));t.parts.forEach((r,n)=>{const f=t.parts[n-1];if(!f||r.start<=0)return;const i=f.speech,u=r.speech,p={t:r.start,kind:"join",part:r.key,previous:f.key,removed:[]},d=t.transitions?.find(o=>o.part===r.key);d&&(p.transition={type:d.type,label:b(d),start:d.start,end:d.end});const m=.5/t.fps;if(i&&Math.abs(i.end-r.start)>=m&&(p.speechOut=i.end),u&&Math.abs(u.start-r.start)>=m&&(p.speechIn=u.start),i&&u?.file===i.file){const o=M(x(i).end),l=M(x(u).start);p.file=i.file,p.skip=[o,l],p.removed=y(s[i.file]?.words,o,l)}e.push(p)});for(const r of a){const n=r.part??t.parts.find(f=>f.start<=r.t&&r.t<f.end)?.key??"";e.push({t:r.t,kind:"camera",part:n,layer:r.layer,removed:[]})}const h=.5/t.fps,c=[];for(const r of e)c.some(n=>Math.abs(n.t-r.t)<h)||c.push(r);return c.sort((r,n)=>r.t-n.t)}export async function sceneryCuts(t){return(await t.ask("scenery.cuts",{fps:t.timeline.fps})).flatMap(a=>a.answer)}export function filmWords(t){return t.flatMap(s=>s.words.map(a=>({...a,part:s.part}))).sort((s,a)=>s.start-a.start)}export function wordsAround(t,s,a=6){const e=t.filter(c=>c.start<s-1e-6).slice(-a),h=t.filter(c=>c.start>=s-1e-6).slice(0,a);return{before:e.map(c=>c.text).join(" "),after:h.map(c=>c.text).join(" ")}}export function stripFrames(t,s,a,e,h={}){const c=(h.offsets??[1,.5,.2]).map(o=>-Math.abs(o)),r=h.windowFrames??5,n=Math.max(0,a-1),f=Math.min(Math.max(Math.ceil(t*s-1e-6),0),n),i=e?Math.round(e.start*s):f,u=e?Math.round(e.end*s):f,p=Math.min(r,u-i),d=p>0?Array.from({length:p},(o,l)=>p===1?i:i+Math.round(l*(u-1-i)/(p-1))):[],m=(d.length>0?[...c.slice(0,2).map(o=>Math.round((t+o)*s)),i-1,...d,u,...c.slice(0,2).map(o=>Math.round((t-o)*s))]:[...c.map(o=>Math.round((t+o)*s)),f-1,f,...c.map(o=>Math.round((t-o)*s))]).map(o=>Math.min(Math.max(o,0),n));return[...new Set(m)].sort((o,l)=>o-l).map(o=>({n:o,t:o/s,side:o<f?"before":"after",...o>=i&&o<u?{window:!0}:{}}))}export const partFolder=t=>t.replace(/[^\p{L}\p{N}_-]/gu,"_");

package/dist/node_modules/@allyhub/measure/dist/facts.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as A}from"node:fs/promises";import{join as F}from"node:path";import{contentBox as B,fact as S,freeBandsData as O,indexPath as $,layoutFacts as q,placementAt as j,sourceAt as z,speechShown as T}from"@allyhub/video-core";import{runFfmpegWith as D}from"@allyhub/render";export function matteOutline(i){const o=(t,n)=>t>=0&&n>=0&&t<i.width&&n<i.height&&(i.data[n*i.width+t]??0)>127,f=[];for(let t=0;t<=i.height;t++){let n=-1;for(let s=0;s<=i.width;s++){const a=s<i.width&&o(s,t-1)!==o(s,t);a&&n<0&&(n=s),!a&&n>=0&&(f.push(`M${String(n)} ${String(t)}H${String(s)}`),n=-1)}}for(let t=0;t<=i.width;t++){let n=-1;for(let s=0;s<=i.height;s++){const a=s<i.height&&o(t-1,s)!==o(t,s);a&&n<0&&(n=s),!a&&n>=0&&(f.push(`M${String(t)} ${String(n)}V${String(s)}`),n=-1)}}return f.join("")}async function H(i,o){try{const f=JSON.parse(await A(F(i,$(o,"matte.json")),"utf8"));return f.version===2&&typeof f.width=="number"&&typeof f.height=="number"?{width:f.width,height:f.height}:void 0}catch{return}}export class Mattes{frames=new Map;sizes=new Map;src;constructor(o){this.src=o}has(o){return this.src.media[o]?.matte===!0}frame(o,f){const t=`${o}@${f.toFixed(3)}`;let n=this.frames.get(t);return n||(n=this.read(o,f),this.frames.set(t,n)),n}async read(o,f){const t=this.src.media[o]?.sha256;if(!t)return;let n=this.sizes.get(t);n||(n=H(this.src.root,t),this.sizes.set(t,n));const s=await n;if(s)try{const{out:a}=await D(this.src.ffmpeg,["-v","error","-ss",Math.max(0,f).toFixed(3),"-i",F(this.src.root,$(t,"matte.mp4")),"-frames:v","1","-vf","extractplanes=y","-f","rawvideo","-pix_fmt","gray","-"],void 0,!0);return a.length>=s.width*s.height?{...s,data:a}:void 0}catch{return}}}export function personShare(i,o,f,t,n){const s=j(o,f),a=s.crop??[0,0,t.width,t.height],p=s.picture;if(p[2]<=0||p[3]<=0||i[2]<=0||i[3]<=0)return 0;const c=Math.min(48,Math.max(1,Math.ceil(i[2]/4))),g=Math.min(48,Math.max(1,Math.ceil(i[3]/4))),w=(r,d,u)=>r>=(u[0]??0)&&r<(u[0]??0)+(u[2]??0)&&d>=(u[1]??0)&&d<(u[1]??0)+(u[3]??0);let h=0;for(let r=0;r<g;r++)for(let d=0;d<c;d++){const u=i[0]+(d+.5)*i[2]/c,y=i[1]+(r+.5)*i[3]/g;if(!w(u,y,s.box)||!w(u,y,p))continue;const l=a[0]+(u-p[0])*a[2]/p[2],x=a[1]+(y-p[1])*a[3]/p[3],m=Math.floor(l*n.width/t.width),e=Math.floor(x*n.height/t.height);m<0||e<0||m>=n.width||e>=n.height||(n.data[e*n.width+m]??0)>127&&h++}return Math.round(h/(c*g)*1e3)/1e3}export function matteRows(i,o,f,t,n,s){const a=j(i,o),p=a.crop??[0,0,f.width,f.height],c=a.picture;if(c[2]<=0||c[3]<=0||p[2]<=0||p[3]<=0)return[];const g=Math.max(n[0],a.box[0],c[0]),w=Math.min(n[1],a.box[0]+a.box[2],c[0]+c[2]);if(w<=g)return[];const h=e=>Math.floor((p[0]+(e-c[0])*p[2]/c[2])*t.width/f.width),r=Math.max(0,h(g)),d=Math.min(t.width-1,h(w-1e-6));if(d<r)return[];const u=new Uint8Array(t.height);for(let e=0;e<t.height;e++){const k=e*t.width;for(let M=r;M<=d;M++)if((t.data[k+M]??0)>127){u[e]=1;break}}const y=Math.max(Math.floor(s[0]),Math.floor(a.box[1]),Math.floor(c[1])),l=Math.min(Math.ceil(s[1]),Math.ceil(a.box[1]+a.box[3]),Math.ceil(c[1]+c[3])),x=[];let m=-1;for(let e=y;e<=l;e++){let k=!1;if(e<l){const M=p[1]+(e+.5-c[1])*p[3]/c[3],b=Math.floor(M*t.height/f.height);k=b>=0&&b<t.height&&u[b]===1}k&&m<0&&(m=e),!k&&m>=0&&(x.push([m,e]),m=-1)}return x}async function J(i,o,f,t,n,s){const a=[],p=B(i.width,i.height,i.safe);for(const c of o.parts){const g=(o.footage??[]).filter(e=>e.part===c.key),w=g.filter(e=>t.media[e.file]?.faces),h=g.filter(e=>n.has(e.file));if(w.length===0&&h.length===0)continue;const r=i.moments.filter(e=>e.part===c.key);if(r.length===0)continue;const d=[...new Set(g.map(e=>e.file))],u=e=>[...new Set(e.map(k=>k.file))],y=new Set(w.map(e=>e.speaker??t.media[e.file]?.faces?.speaker)),l=y.size===1?[...y][0]:void 0,x=[];for(const e of r){const k=[];for(const M of h){if(e.t<M.start||e.t>=M.end)continue;const b=t.media[M.file];if(b?.width===void 0||b.height===void 0)continue;const v=await n.frame(M.file,z(M,e.t));v&&k.push(...matteRows(M,e.t,{width:b.width,height:b.height},v,p.x,[0,i.height]))}x.push(k)}const m=O({width:i.width,height:i.height,safe:i.safe,...s?{profile:s}:{},moments:r.map(e=>e.t),face:w.length>0?{files:u(w),...l===void 0?{}:{speaker:l},boxes:r.map(e=>e.face)}:{missing:"face-track",files:d},person:h.length>0?{files:u(h),rows:x}:{missing:"person-matte",files:d}});a.push(S("free-bands",{...f,part:c.key,t:r[0]?.t??c.start},m))}return a}export async function measuredFacts(i,o,f,t,n){const s={piece:f.piece,output:f.output,combo:f.combo,format:f.format},a=q(i,s,n),p=i.reading?.texts??[];for(const h of o.parts){const r=h.speech?.heard;r!==void 0&&a.push(S("speech-on-screen",{...s,part:h.key,t:h.start},T(r,p.filter(d=>d.part===h.key).map(d=>d.text.text))))}const c=new Mattes(t);a.push(...await J(i,o,s,t,c,n));const g=(o.footage??[]).filter(h=>c.has(h.file));if(g.length===0)return a;const w=(h,r)=>h.text===r.text&&h.box.join()===r.box.join();for(const h of i.moments){const r=g.filter(d=>h.t>=d.start&&h.t<d.end);if(!(r.length===0||h.texts.length===0))for(const d of h.texts){let u;for(const l of r){const x=t.media[l.file];if(x?.width===void 0||x.height===void 0)continue;const m=await c.frame(l.file,z(l,h.t));if(!m)continue;const e=personShare(d.box,l,h.t,{width:x.width,height:x.height},m);e>0&&e>(u?.ofText??0)&&(u={ofText:e,file:l.file})}if(!u)continue;const y=a.find(l=>l.kind==="text-speaker"&&l.t===h.t&&l.part===h.part&&w(l.data.text,d));y?.kind==="text-speaker"?y.data.person=u:a.push(S("text-speaker",{...s,part:h.part,t:h.t},{text:d,person:u}))}}return a}export function matrixFacts(i){const o=i.matrix;if(!o)return[];const f=Object.entries(o.space.slots).flatMap(([t,n])=>n.map(s=>({slot:t,candidate:s.name,combos:o.picks.filter(a=>a.combo[t]===s.name).map(a=>a.id)})));return[S("matrix-coverage",{piece:i.id},{choice:o.choice,...o.pick===void 0?{}:{pick:o.pick},...o.valid===void 0?{}:{possible:o.valid},chosen:o.picks.length,candidates:f})]}

package/dist/node_modules/@allyhub/measure/dist/fidelity.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{cropImage as O,readPng as T}from"@allyhub/render";import{compareImages as U}from"./compare.js";import{FIDELITY_DEFAULTS as $,shrinkLinear as B}from"@allyhub/scenery-host/fidelity";import{fact as F}from"@allyhub/video-core";const h=e=>Math.round(e*1e3)/1e3,D=e=>Math.round(e*10)/10,P=(e,s,a)=>e[0]-a<s[0]+s[2]&&s[0]<e[0]+e[2]+a&&e[1]-a<s[1]+s[3]&&s[1]<e[1]+e[3]+a;export function fidelityOf(e,s,a,c,l){const x=B(e,s.width,s.height),{result:i,side:m}=U(x,s,{tolerance:l.tolerance,background:l.backdrop,gap:l.gap,shift:0,resize:"stretch"}),u=a[0]/s.width,p=a[1]/s.height;return{side:m,data:{deltaE:i.deltaE,channels:{r:h(i.channels.r.mean),g:h(i.channels.g.mean),b:h(i.channels.b.mean),alpha:h(i.channels.alpha.mean)},share:i.pixels>0?h(i.differing/i.pixels):0,regions:i.regions.slice(0,l.regions).map(o=>{const w=[D(o.box[0]*u),D(o.box[1]*p),D(o.box[2]*u),D(o.box[3]*p)];return{box:w,share:i.pixels>0?h(o.pixels/i.pixels):0,meanDeltaE:o.meanDeltaE,maxDeltaE:o.maxDeltaE,elements:c.flatMap((M,g)=>P(w,M.box,Math.max(u,p))?[g]:[])}})}}}async function L(e,s,a){return(await e.ask(s,a)).find(l=>l.answer!==null)?.answer}export async function screenFidelity(e,s={},a={}){const c={...$,...s},l=a.at??e.timeline.parts.map(n=>n.still),x=(await e.ask("scenery.fidelity",{times:l,...a.at===void 0?{}:{every:!0}})).flatMap(n=>n.answer),i=[],m=[];if(x.length===0)return{facts:i,sheets:m};const{piece:u,output:p,combo:o,format:w}=e.target,M=`rgb(${c.backdrop.join(", ")})`;let g;try{for(const n of x){const j={piece:u,output:p,combo:o,format:w,...n.part===void 0?{}:{part:n.part},t:Math.round((n.partStart+n.start)*1e6)/1e6};for(const f of n.screens){const z={layer:n.layer,start:n.start,end:n.end,screen:f.mesh,at:n.at,size:f.size,tolerance:c.tolerance,backdrop:[...c.backdrop]},y=b=>{i.push(F("scenery-screen-fidelity",j,{...z,missing:b}))};if(f.missing!==void 0){y(f.missing);continue}g!==n.t&&(await e.seek(n.t),g=n.t);let r,t,d;try{if(r=await L(e,"scenery.fidelity.read",{id:n.id,mesh:f.mesh,most:c.width}),typeof r=="object"&&r!==null&&(t=await L(e,"scenery.fidelity.lift",{id:n.id,mesh:f.mesh,backdrop:M}),typeof t=="object"&&t!==null))try{d=await e.grab(t.box)}finally{await e.ask("scenery.fidelity.restore",void 0)}}catch(b){y(`it could not be compared: ${(b instanceof Error?b.message:String(b)).split(`
+`)[0]??""}`);continue}if(typeof r!="object"||r===null){y(r??"its scenery layer did not answer");continue}if(typeof t!="object"||t===null||!d){y(typeof t=="string"?t:"its element could not be laid flat");continue}const S={width:r.width,height:r.height,data:new Uint8Array(Buffer.from(r.data,"base64"))},k=T(d.png),E=d.x===t.box[0]&&d.y===t.box[1]&&k.width===t.box[2]&&k.height===t.box[3]?k:O(k,[t.box[0]-d.x,t.box[1]-d.y,t.box[2],t.box[3]]);if(!E){y("its element, laid flat, was not in the capture");continue}const I=fidelityOf(E,S,f.size,t.elements,c),A=F("scenery-screen-fidelity",j,{...z,texture:{level:r.level,size:[r.width,r.height],of:r.size,element:t.element},flat:[E.width,E.height],...I.data,...t.elements.length>0?{elements:t.elements}:{}});i.push(A),a.sheet&&m.push(await a.sheet(I.side,A))}}}finally{await e.ask("scenery.fidelity.restore",void 0).catch(()=>[])}return{facts:i,sheets:m}}

package/dist/node_modules/@allyhub/measure/dist/flat.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{fact as k}from"@allyhub/video-core";import{readPng as A}from"@allyhub/render";export const FLAT_DEFAULTS={maxStd:3,minFrames:4,sameLuma:10};const y=t=>({maxStd:t.maxStd??FLAT_DEFAULTS.maxStd,minFrames:Math.max(1,Math.round(t.minFrames??FLAT_DEFAULTS.minFrames)),sameLuma:t.sameLuma??FLAT_DEFAULTS.sameLuma});export const THUMB_WIDTH=160;export function pictureOf(t){const{width:h,height:f,data:r}=A(t),m=Math.max(1,Math.floor(h/THUMB_WIDTH)),l=new Array(64).fill(0);let d=0,s=0,n=0;for(let o=0;o<f;o+=m)for(let i=0;i<h;i+=m){const x=(o*h+i)*4,w=.2126*(r[x]??0)+.7152*(r[x+1]??0)+.0722*(r[x+2]??0);d+=w,s+=w*w,n++;const g=Math.min(63,Math.floor(w/4));l[g]=(l[g]??0)+1}const a=n?d/n:0;let u=0;for(let o=1;o<64;o++)(l[o]??0)>(l[u]??0)&&(u=o);return{mean:a,std:Math.sqrt(Math.max(0,(n?s/n:0)-a*a)),dominant:u*4+2}}export function probeFrames(t,h=FLAT_DEFAULTS.minFrames){const f=Math.max(1,Math.round(h)),r=t.fps,m=Math.round(t.duration*r)-1,l=Math.round(r/2),d=new Set,s=(n,a)=>{const u=Math.ceil(Math.max(1,n)/f)*f;for(let o=u;o<=Math.min(m-1,a);o+=f)d.add(o)};for(const n of t.parts.slice(1)){const a=Math.round(n.start*r);s(a-Math.round(r/4),a+l)}for(const n of t.cues){const a=Math.round(n.t*r);s(a,a+Math.round(r*.4))}return[...d].sort((n,a)=>n-a)}export async function flatRuns(t,h,f,r,m={}){const{maxStd:l,minFrames:d,sameLuma:s}=y(m),n=e=>e.std<=l,a=new Map,u=async e=>{let c=a.get(e);return c||(c=await f(e),a.set(e,c)),c},o=Math.max(d,Math.round(r/4)),i=Math.round(r*2),x=(e,c)=>c!==void 0&&!n(c)&&Math.abs(c.dominant-e)<=s;for(const e of h)await u(e);const w=[];let g=-1;for(const e of h){if(e<=g)continue;const c=a.get(e);if(!c||!n(c))continue;const F=Math.ceil(o/d)*d;if(x(c.mean,a.get(e-F))||x(c.mean,a.get(e+F)))continue;let p=e;for(;p>0&&e-p<i&&n(await u(p-1));)p--;let M=e;for(;M<t-1&&M-e<i&&n(await u(M+1));)M++;if(g=M,p===0||M===t-1||M-p+1<d)continue;const L=await u(Math.max(0,p-o)),S=await u(Math.min(t-1,M+o));x(c.mean,L)||x(c.mean,S)||w.push({from:p,to:M,color:c.mean,longer:e-p>=i||M-e>=i})}return w}const T=t=>t<24?"black":t>232?"white":t<96?"dark":"grey",b=t=>Math.round(t*1e3)/1e3;export async function flatFrames(t,h={}){const f=t.timeline,r=y(h),m=f.fps,l=Math.round(f.duration*m);return(await flatRuns(l,probeFrames(f,r.minFrames),async s=>pictureOf(await t.thumb(s/m,THUMB_WIDTH)),m,r)).map(s=>{const n=b(s.from/m),a=f.parts.find(i=>n>=i.start&&n<i.end)?.key,u=(s.to+1)/m,o=(f.transitions??[]).find(i=>i.start<u-1e-6&&i.end>s.from/m+1e-6);return k("flat-frames",{piece:t.target.piece,output:t.target.output,combo:t.target.combo,format:t.target.format,t:n,...a?{part:a}:{}},{start:n,end:b((s.to+1)/m),frames:s.to-s.from+1,luma:Math.round(s.color),shade:T(s.color),longer:s.longer,options:r,...o?{transition:{type:o.type,from:o.from,to:o.part}}:{}})})}

package/dist/node_modules/@allyhub/measure/dist/loop.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readPng as h}from"@allyhub/render";export function frameChange(c,f){const t=h(c),a=h(f);if(t.width!==a.width||t.height!==a.height)return{mean:255,max:255};let n=0,e=0,s=0;for(let r=0;r<t.data.length;r+=4)for(let o=0;o<3;o++){const i=Math.abs((t.data[r+o]??0)-(a.data[r+o]??0));n+=i,i>e&&(e=i),s++}return{mean:s>0?Math.round(n/s*1e3)/1e3:0,max:e}}export async function loopSeam(c,f){const t=c.fps,a=Math.max(1,Math.round(c.duration*t)),n=i=>f(Math.min(Math.max(i,0),a-1)/t),e=await n(0),s=await n(1),r=await n(a-2),o=await n(a-1);return{frames:a,fps:t,seam:frameChange(o,e),first:frameChange(e,s),last:frameChange(r,o)}}

package/dist/node_modules/@allyhub/measure/dist/overlay.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{deckFacts as R}from"@allyhub/slides-core";import{facesOnFrame as Y,placementAt as C,sourceAt as D}from"@allyhub/video-core";import{matteOutline as F}from"./facts.js";const $=s=>Math.round(s*10)/10,O=s=>[$(s[0]??0),$(s[1]??0),$(s[2]??0),$(s[3]??0)];export async function frameOverlay(s,x,f,w,u){const h=f.width,o=f.height,r=f.safe,g=[[0,0,h,r.top],[0,o-r.bottom,h,r.bottom],[0,r.top,r.left,o-r.top-r.bottom],[h-r.right,r.top,r.right,o-r.top-r.bottom]].filter(e=>e[2]>0&&e[3]>0);let c;for(const e of f.moments)Math.abs(e.t-s)<1/x.fps&&(!c||Math.abs(e.t-s)<Math.abs(c.t-s))&&(c=e);const t={faces:[],person:[],covered:g,texts:(c?.texts??[]).map(e=>({layer:e.layer,text:e.text,box:e.box})),shapes:[],guides:[],missing:[]},p=f.deck?.slides.find(e=>e.slide===c?.part);if(f.deck&&p){t.shapes=p.shapes.map(i=>({name:i.name,box:i.box}));const e=i=>i==="slide"?[0,0,h,o]:p.shapes.find(a=>a.name===i)?.box;for(const i of R({pxPerPt:f.deck.pxPerPt,slides:[p]},{width:h,height:o},{piece:""})){if(i.kind!=="near-alignment")continue;const a=i.data,d=n=>a.line==="left"?n[0]:a.line==="right"?n[0]+n[2]:a.line==="centre-x"?n[0]+n[2]/2:a.line==="top"?n[1]:a.line==="bottom"?n[1]+n[3]:n[1]+n[3]/2,l=["left","right","centre-x"].includes(a.line)?"x":"y";for(const n of[a.a,a.b]){const m=e(n);m&&t.guides.push({axis:l,at:$(d(m)),label:`${a.a}/${a.b} ${String(a.gap)} pt`})}}}for(const e of(x.footage??[]).filter(i=>s>=i.start&&s<i.end)){const i=w[e.file],a=i?.faces;if(a){const A=e.speaker??a.speaker;for(const y of Y(e,a,s))t.faces.push({id:y.id,box:O(y.box),speaker:y.id===A,file:e.file})}else t.missing.push(`face-track ${e.file}`);if(!u.has(e.file)){t.missing.push(`person-matte ${e.file}`);continue}if(i?.width===void 0||i.height===void 0)continue;const d=await u.frame(e.file,D(e,s));if(!d){t.missing.push(`person-matte ${e.file}`);continue}const l=C(e,s),n=l.crop??[0,0,i.width,i.height],m=l.picture[2]/n[2],M=l.picture[3]/n[3];t.person.push({file:e.file,path:F(d),matrix:[i.width/d.width*m,i.height/d.height*M,l.picture[0]-n[0]*m,l.picture[1]-n[1]*M],clip:O(l.box)})}return t.missing=[...new Set(t.missing)],t}const b="#ffd400",P="#00e5ff",v="#ff3b30",k="#5cff5c",S="#ff4fd8",E="#ff9500";export const OVERLAY_KEY=[[b,"face boxes with ids (solid: the speaker the layer follows)"],[P,"person matte outline"],[v,"covered areas"],[k,"text boxes, with their layer"]],DECK_OVERLAY_KEY=[[S,"shapes as drawn, with their names"],[k,"text, with its shape"],[E,"lines nearly in line (near-alignment)"]];const K=s=>s.replace(/[&<>]/g,x=>({"&":"&amp;","<":"&lt;",">":"&gt;"})[x]??x);export function overlaySvg(s,x,f,w,u){const h=u/Math.max(w,1e-6),o=t=>String(Math.round(t*10)/10),r=(t,p)=>`<rect x="${o(t[0])}" y="${o(t[1])}" width="${o(t[2])}" height="${o(t[3])}" vector-effect="non-scaling-stroke" ${p}/>`,g=(t,p,e,i,a=!1)=>{const d=(e.length*.6+.6)*h,l=h*1.3,n=Math.max(0,Math.min(p-l,f-l)),m=Math.max(0,Math.min(a?t-d:t,x-d));return`<rect x="${o(m)}" y="${o(n)}" width="${o(d)}" height="${o(l)}" fill="rgba(0,0,0,.72)"/><text x="${o(m+h*.3)}" y="${o(n+h*1.02)}" font-size="${o(h)}" fill="${i}">${K(e)}</text>`},c=s.covered.map(t=>r(t,`fill="${v}" fill-opacity=".14" stroke="${v}" stroke-width="2" stroke-dasharray="6 4"`));s.person.forEach((t,p)=>{c.push(`<clipPath id="pc${String(p)}">${r(t.clip,"")}</clipPath><g clip-path="url(#pc${String(p)})"><path d="${t.path}" transform="matrix(${String(t.matrix[0])} 0 0 ${String(t.matrix[1])} ${o(t.matrix[2])} ${o(t.matrix[3])})" fill="none" stroke="${P}" stroke-width="2" vector-effect="non-scaling-stroke"/></g>`)});for(const t of s.texts)c.push(r(t.box,`fill="none" stroke="${k}" stroke-width="2"`),g(t.box[0],t.box[1],t.layer,k));for(const t of s.shapes)c.push(r(t.box,`fill="none" stroke="${S}" stroke-width="1" stroke-dasharray="4 3"`),g(t.box[0]+t.box[2],t.box[1]+1.3*h,t.name,S,!0));for(const t of s.guides)c.push(t.axis==="x"?`<line x1="${o(t.at)}" y1="0" x2="${o(t.at)}" y2="${String(f)}" stroke="${E}" stroke-width="1" vector-effect="non-scaling-stroke"/>`:`<line x1="0" y1="${o(t.at)}" x2="${String(x)}" y2="${o(t.at)}" stroke="${E}" stroke-width="1" vector-effect="non-scaling-stroke"/>`);for(const t of s.faces)c.push(r(t.box,`fill="none" stroke="${b}" stroke-width="${t.speaker?"3":"2"}"${t.speaker?"":' stroke-dasharray="8 5"'}`),g(t.box[0],t.box[1],`face ${String(t.id)}${t.speaker?" speaker":""}`,b));return s.missing.length>0&&c.push(g(0,f,`not measured: ${s.missing.join("; ")}`,"#ffffff")),`<svg class="ov" viewBox="0 0 ${String(x)} ${String(f)}" preserveAspectRatio="xMidYMid meet" font-family="sans-serif" font-weight="600">${c.join("")}</svg>`}

package/dist/node_modules/@allyhub/measure/dist/recording-report.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{RECORDING_MEASURE_DEFAULTS as x,SAMPLE_RATE as y,VOICE_FIT_DEFAULTS as A,fitVoice as _,measureRecording as p,recordedSpeech as T}from"@allyhub/audio";import{mkdtemp as j,rm as D}from"node:fs/promises";import{tmpdir as I}from"node:os";import{join as k}from"node:path";import{decodeStereo as E,ffmpegOf as N}from"@allyhub/audio/node";import{ProjectError as $}from"@allyhub/project";import{mixSound as F}from"@allyhub/render";import{recordingDifference as L}from"./sound-measures.js";import{versionVoice as M}from"./version-voice.js";const U=e=>Math.round(e*10)/10;export async function fileRecording(e,i={},o={}){return p(await E(e,{},o),y,{...x,...i})}export async function recordingReport(e){const{voice:i,timeline:o,ask:s}=e,m=e.ffmpeg===void 0?{}:{ffmpeg:e.ffmpeg},n={...x,...s.measure},u=i.rate,S=i.groups.some(t=>t.clips.length>0)||i.plain[0].some(t=>t!==0),f=e.mix&&(s.mix===!0||!S)?e.mix:void 0,h=f?p(f,y,n):p(T(i),u,n),l=o.audio.mic?.video??!1,g=i.groups.findIndex(t=>JSON.stringify(t.voice)===JSON.stringify(l)),w=i.setting??"studio",d=Object.keys(o.audio.mic?.parts??{}),a=[];f&&a.push(s.mix===!0?"The piece is measured whole, its mix as mastered: the music and everything under the voice with it, as a file is.":"The piece says nothing: its mix, as mastered, is measured whole, as a file is.");let c,r;const v={...A,...s.fit,measure:n};return e.file!==void 0&&(c=await fileRecording(e.file,n,m),a.push("The file is measured whole: music or any other sound under its voice is measured with it."),s.fit&&(f?a.push("The fit records the piece's speech, so it fits nothing when the piece is measured whole."):g<0?a.push(l===!1?"The video's voice is played as it is (mic: false): there is no setting to fit.":"No part speaks with the video's own mic setting: there is none to fit."):(r=_(w,t=>T(i,{index:g,voice:t}),c,u,v),d.length>0&&a.push(`The fit sets the video's voice; ${d.join(", ")} keep${d.length===1?"s":""} the setting of ${d.length===1?"its":"their"} own.`)))),{measured:f?"mix":"speech",setting:w,groups:i.groups.map(t=>({setup:t.voice.setup,parts:t.parts,speech:U(t.clips.reduce((R,O)=>R+O.dur,0))})),piece:h,...c?{file:c,difference:L(h,c)}:{},...r?{fit:{setting:r.setting,moved:r.moved,distance:r.distance,limited:r.limited,after:r.after,notes:r.notes}}:{},options:{measure:n,...s.fit?{fit:v}:{}},notes:a}}export async function versionRecording(e,i={}){if(e.target.output!=="video")throw new $("not-video",`${e.target.piece} is not a video, so it has no sound.`,"usage");const o=await N(i),s={ffmpeg:o},m=await j(k(I(),"allyhub-recording-"));try{const n=k(m,"mix.wav");return await F({timeline:e.timeline,sound:await e.sound(s),out:n,ffmpeg:o}),await recordingReport({voice:await M(e,s),timeline:e.timeline,ask:i.ask??{},mix:await E(n,{},s),...i.file===void 0?{}:{file:i.file},ffmpeg:o})}finally{await D(m,{recursive:!0,force:!0})}}

package/dist/node_modules/@allyhub/measure/dist/reference/folder.js

@@ -0,0 +1,4 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{copyFile as C,mkdir as D,readFile as S,readdir as L,rename as M,rm as _,stat as P,writeFile as H}from"node:fs/promises";import{basename as $,dirname as U,extname as R,join as s,resolve as N}from"node:path";import{INTERPRETATION_FILE as v,InterpretationSchema as z,REFERENCE_DIR as j,REFERENCE_FILE as p,ReferenceSchema as J,WordsFileSchema as T}from"@allyhub/formats";import{contactSheets as V,contentHash as W,fetchVideo as B}from"@allyhub/media";import{interpretationProblems as K,referenceSections as q}from"./interpret.js";import{measureVideo as G,wordOf as Q,referenceJson as X}from"./video.js";export class ReferenceError extends Error{code;hint;kind;constructor(e,o,i={}){super(o),this.name="ReferenceError",this.code=e,this.hint=i.hint,this.kind=i.kind??"failed"}}const g=async t=>(await P(t).catch(()=>{}))?.isFile()===!0,Y=async t=>(await P(t).catch(()=>{}))?.isDirectory()===!0;async function F(t,e){await H(`${t}.part`,e),await M(`${t}.part`,t)}export function referenceId(t){const e=t.normalize("NFKD").replace(/\p{M}/gu,"").toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"").slice(0,48).replace(/-+$/,"");return e===""?"reference":e}export const INTERPRETATION_SHAPE=`{ "sections": [{ "start": seconds, "end": seconds, "name"?, "role"?, "picture"?, "onScreen"?: [text], "notes"? }], "captions"?: { "lines"?: [text ids], "style"? }, "watermarks"?: [text ids], "summary"?, "layout"?, "hook"?, "labels"?: { name: text, number, true or false, or [texts] } }: sections in order without overlaps; a text id is reference.json's text[].id`;export async function readInterpretation(t,e){let o;try{o=JSON.parse(await S(t,"utf8"))}catch(l){return{problems:[`not JSON (${l.message})`]}}const i=z.safeParse(o);if(!i.success)return{problems:i.error.issues.slice(0,5).map(l=>`${l.path.join(".")||"(top)"}: ${l.message}`)};const r=K(i.data,e);return r.length>0?{problems:r}:{value:i.data}}export async function referenceDir(t,e,o){const i=N(e,o);if($(i)===p&&await g(i))return U(i);for(const r of[i,s(t,j,o)])if(await g(s(r,p)))return r}export async function readReference(t){const e=s(t,p);let o;try{o=JSON.parse(await S(e,"utf8"))}catch(d){throw new ReferenceError("no-reference",`Cannot read ${e} (${d.message}).`,{kind:"not-found",hint:"Make it with allyhub reference <file or URL>."})}const i=J.safeParse(o);if(!i.success)throw new ReferenceError("bad-reference",`${e} is not a reference.json this AllyHub reads: ${i.error.issues.slice(0,3).map(d=>`${d.path.join(".")}: ${d.message}`).join("; ")}`,{hint:`Measure it again: allyhub reference ${t}`});const r=i.data;let l=[];if(r.words!==void 0){const d=s(t,r.words),w=T.safeParse(JSON.parse(await S(d,"utf8").catch(()=>"null")));if(!w.success)throw new ReferenceError("no-words",`Cannot read ${d}.`,{hint:`Measure it again: allyhub reference ${t}`});l=w.data.words.map(Q)}const a=s(t,v);let c;if(await g(a)){const d=await readInterpretation(a,r);if("problems"in d)throw badInterpretation(a,d.problems);c=d.value}return{dir:t,ref:r,video:s(t,r.source.file),words:l,...c?{interpretation:c}:{}}}export function badInterpretation(t,e){return new ReferenceError("bad-interpretation",`${t} is not an interpretation of this reference: ${e.join("; ")}`,{kind:"usage",hint:`Write ${INTERPRETATION_SHAPE}.`})}export async function makeReference(t,e){const o=/^https?:\/\//i.test(t)?t:void 0;let i,r;if(o===void 0){const n=await referenceDir(e.root,e.cwd,t);if(n!==void 0){const u=JSON.parse(await S(s(n,p),"utf8"));if(typeof u?.source?.file!="string")throw new ReferenceError("bad-reference",`${s(n,p)} does not name its video (source.file).`,{hint:"Pass the video file instead."});i={dir:n,ref:u},r=s(n,u.source.file)}else r=N(e.cwd,t);if(!await g(r))throw new ReferenceError("not-found",await Y(r)?`${r} is a folder without ${p}.`:`There is no file ${r}.`,{kind:"not-found"})}const l=referenceId(o!==void 0?new URL(o).pathname.split("/").filter(Boolean).pop()??"reference":$(r??"",R(r??""))),a=i?.dir??e.dir??s(e.root,j,l);await D(a,{recursive:!0});let c,d=i?.ref.source?.title,w=i?.ref.source?.url;if(o!==void 0){const n=await B(o,a,e);c=n.file,d=n.title,w=n.url}else c=s(a,`video${R(r??"").toLowerCase()||".mp4"}`),N(r??"")!==c&&await C(r??"",c);const f=await G(c,e),h=f.info.hasAudio&&f.wordsMissing===void 0?`${$(c,R(c))}.words.json`:void 0;h!==void 0&&await F(s(a,h),`${JSON.stringify(T.parse({version:1,...e.lang===void 0?{}:{language:e.lang},duration:f.info.duration,...f.asr===void 0?{}:{model:f.asr},words:f.words}),null,1)}
+`);const y=X(f,{id:$(a),file:$(c),sha256:await W(c),url:w,title:d,words:h,sheets:[],all:e.all}),b=s(a,v);let k,x;if(await g(b)){const n=await readInterpretation(b,y);"problems"in n?x={file:b,problems:n.problems}:(k=n.value,x={file:b,sections:n.value.sections.length})}const m=q(y,f.words,k);e.onProgress?.({step:"decode",message:"Drawing contact sheets"});const A=await V(c,{words:f.words,draw:e.draw,title:`${y.id} · ${f.info.duration.toFixed(2)} s · ${m.from==="interpretation"?`${String(m.sections.length)} sections (${v})`:`${String(m.sections.length)} segments (the neutral split: no interpretation yet)`}`,labelOf:n=>m.sections.find(u=>n>=u.start&&n<u.end)?.name,signal:e.signal}),E=[];for(const[n,u]of A.entries()){const O=`sheet-${String(n+1).padStart(2,"0")}.${e.pictures}`;await F(s(a,O),u.picture),E.push(O)}for(const n of await L(a))/^sheet-\d+\.\w+$/u.test(n)&&!E.includes(n)&&await _(s(a,n),{force:!0});const I=J.parse({...y,sheets:E});return await F(s(a,p),`${JSON.stringify(I,null,2)}
+`),{dir:a,reference:I,video:c,...h===void 0?{}:{words:s(a,h)},sheets:E.map(n=>s(a,n)),sections:m,...x?{interpretation:x}:{}}}

package/dist/node_modules/@allyhub/measure/dist/reference/piece.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{mkdtemp as v,rm as B}from"node:fs/promises";import{tmpdir as I}from"node:os";import{join as O}from"node:path";import{SceneScorer as N,beats as D,frameAt as E,pickShots as G,sheetHtml as K}from"@allyhub/media";import{mixSound as X,readPng as q}from"@allyhub/render";import{joinedWords as z}from"@allyhub/video-core";import{filmWords as J,listCuts as Q,sceneryCuts as V}from"../cuts.js";import{MAX_GROUP as A,alignSections as Y,compareSections as Z}from"./compare.js";import{labelsOf as tt,referenceSections as et}from"./interpret.js";import{measurePacing as st,numbersOf as L}from"./sections.js";import{textSeconds as nt}from"./text.js";const _=64,ot=.3,T=8,F=o=>Math.round(o*1e3)/1e3;function rt(o,p){const e=q(o);if(p){const d=e.data;for(let h=0;h<d.length;h+=4){const m=(d[h+3]??255)/255;for(let c=0;c<3;c++)d[h+c]=Math.round((d[h+c]??0)*m+(p[c]??0)*(1-m))}}const r=_,u=Math.max(1,Math.round(e.height*r/e.width)),i=new Uint8Array(r*u*3);for(let d=0;d<u;d++){const h=Math.floor(d*e.height/u),m=Math.max(h+1,Math.floor((d+1)*e.height/u));for(let c=0;c<r;c++){const a=Math.floor(c*e.width/r),g=Math.max(a+1,Math.floor((c+1)*e.width/r)),l=[0,0,0];for(let f=h;f<m;f++)for(let x=a;x<g;x++){const y=(f*e.width+x)*4;for(let w=0;w<3;w++)l[w]=(l[w]??0)+(e.data[y+w]??0)}const n=(m-h)*(g-a);for(let f=0;f<3;f++)i[(d*r+c)*3+f]=Math.round((l[f]??0)/n)}}return{rgb:i,w:r,h:u}}async function at(o,p,e,r,u,i){const d=[],h=1/e,m=Math.round(ot*e);for(const c of o){const a=Math.round(c*e),g=Math.max(0,a-m),l=Math.min(Math.round(r*e)-1,a+m);let n;for(let s=g;s<=l;s++){const t=rt(await p(s*h),i);n??=new N(t.w,t.h),n.push(t.rgb)}if(!n)continue;const f=n.changes(Math.max(1,Math.round(e*.2))),y=G(n.jumps,f,e,u).cuts.some(s=>Math.abs(g*h+s.t-c)<=h*1.5);let w=0;for(let s=a-g-1;s<=a-g+1;s++)w=Math.max(w,n.jumps[s]??0,f[s]??0);d.push({t:F(c),score:F(Math.min(1,w)),cut:y})}return d}export async function measurePiece(o,p){const e=o.timeline,r=1/e.fps,u=z(J(await o.version.stage.lines()),r),i=Q(e,o.prepared.media,await V(o.version)).map(t=>t.t);for(const t of e.footage??[]){const[M,$,S,j]=t.box;if(M>.5||$>.5||M+S<e.width-.5||$+j<e.height-.5)continue;const k=e.parts.find(P=>P.key===t.part);k&&(t.start>k.start+r/2&&i.push(t.start),t.end<k.end-r/2&&i.push(t.end))}const d=[];for(const t of i.sort((M,$)=>M-$)){const M=d.at(-1);M!==void 0&&t-M<r/2||d.push(t)}const h=(e.footage??[]).length===0?/^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i.exec(e.background):null,m=h?[1,2,3].map(t=>parseInt(h[t]??"0",16)):void 0,c=t=>Math.min(t,e.duration-r),a=await at(d,t=>m?o.version.thumb(c(t),_*2):o.still(c(t),{raw:!0}),e.fps,e.duration,p,m),g=a.filter(t=>t.cut).map(t=>({t:t.t,score:1})),l=await o.version.measure(),n=e.duration,f=t=>t.toLowerCase().replace(/[^\p{L}\p{N}]/gu,""),x=new Set(u.map(t=>f(t.text))),y=(l.reading?.texts??[]).filter(t=>t.text.viewport!==!0&&t.spans.length>0).sort((t,M)=>t.first-M.first).map((t,M)=>{const[$,S,j,k]=t.text.box,P=t.text.text.match(/\p{L}/gu)??[],W=t.text.text.split(/\s+/).map(f).filter(Boolean),C=Math.min(...t.spans.map(b=>b[0])),H=Math.max(...t.spans.map(b=>b[1]));return{id:M,text:t.text.text,box:[$/l.width,S/l.height,j/l.width,k/l.height],height:k/l.height,conf:100,words:t.words,upper:P.length===0?0:P.filter(b=>b!==b.toLowerCase()).length/P.length,start:C,end:H,spans:t.spans,seconds:t.seconds,seen:Math.max(1,t.spans.length),frames:n>0?Math.min(1,t.seconds/n):0,spread:n>0?Math.min(1,(H-C)/n):0,said:W.length===0?0:W.filter(b=>x.has(b)).length/W.length}}),w=await v(O(I(),"allyhub-compare-mix-"));let s=0;try{const t=O(w,"mix.wav");await X({timeline:e,sound:await o.sound(),out:t}),s=(await D(t)).onsets.length}finally{await B(w,{recursive:!0,force:!0})}return{m:{duration:n,words:u,cuts:g,text:y},onsets:s,places:a}}export async function comparePiece(o,p){const{ref:e}=p,r=et(e,p.words,p.interpretation),u=o.timeline,{m:i,onsets:d,places:h}=await measurePiece(o,{threshold:e.shots.threshold,minShot:e.shots.minShot,weakFloor:e.shots.weakFloor,prominence:e.shots.prominence}),m=u.parts.map(s=>({key:s.key,labels:tt([s.key,...s.tags??[]]),...L(s.start,s.end,i)})),c=p.by==="time"?[]:Y(r.sections,m),a=p.by??(c.length>0||m.length===0?"parts":"time"),g=p.by===void 0&&a==="time"?`its ${String(m.length)} part${m.length===1?"":"s"} cannot be aligned to the reference's ${String(r.sections.length)} sections (a part matches at most ${String(A)}, and a section at most ${String(A)} parts)`:void 0,l=a==="time"?r.sections.map(s=>{const t=Math.min(s.start,u.duration),M=Math.min(s.end,u.duration);return{key:u.parts.filter(S=>S.start<M&&S.end>t).map(S=>S.key).join("+")||"(after its end)",labels:[],...L(t,M,i)}}):[],n=a==="time"?l:m,f=a==="time"?l.map((s,t)=>({ref:[t],ours:[t],cost:0})):void 0,x=st(i,{onsets:d}),y=Z({from:r.from,sections:r.sections,cuts:e.shots.cuts,totals:{duration:e.duration,cutsPerMinute:e.pacing.cutsPerMinute,wordsPerMinute:e.pacing.wordsPerMinute,timeToFirstWord:e.pacing.timeToFirstWord,textShare:e.duration>0?F(nt(e.text,0,e.duration,r.watermarks)/e.duration):0}},{sections:n,cuts:i.cuts,totals:{duration:i.duration,cutsPerMinute:x.cutsPerMinute,wordsPerMinute:x.wordsPerMinute,timeToFirstWord:x.timeToFirstWord,textShare:x.textShare}},void 0,f),w=await p.draw(...await it(p.video,s=>o.still(Math.min(s,u.duration)),e,r,n,y));return{comparison:{...y,by:a,...g===void 0?{}:{byWhy:g},places:h.map(s=>({...s,threshold:e.shots.threshold,margin:F(s.score-e.shots.threshold)})),parts:m.map(s=>({key:s.key,start:s.start,end:s.end,words:s.words,cutsPerMinute:s.cutsPerMinute,textSeconds:s.textSeconds}))},sheet:w}}const R=o=>`${o>=0?"+":""}${String(Math.round(o*100))}%`,U=o=>o>=0?`+${o.toFixed(2)}`:`−${(-o).toFixed(2)}`;async function it(o,p,e,r,u,i){const d=(a,g)=>a+(g-a)/2,h=[];for(let a=0;a<i.matches.length;a+=T){const g=[],l=[];for(const n of i.matches.slice(a,a+T)){const f=n.ref.indices.map(y=>r.sections[y]?.said??"").join(" ");g.push({image:await E(o,d(n.ref.start,n.ref.end),{width:360,format:"jpeg"}),label:`${n.ref.names.join("+")} · ${n.ref.dur.toFixed(2)} s`,text:f.slice(0,120)});const x=n.ours.indices.map(y=>u[y]?.said??"").join(" ");l.push({image:await p(d(n.ours.start,n.ours.end)),label:`${n.ours.keys.join("+")} · ${n.ours.dur.toFixed(2)} s · ${U(n.diff.seconds)} s (${R(n.diff.share)})`,text:x.slice(0,120)})}h.push({title:"Reference",cells:g},{title:"Piece",cells:l})}const m=Math.min(T,Math.max(1,i.matches.length)),c=Math.max(900,120+m*210);return[K({title:`${e.id}: duration ${U(i.overall.diff.seconds)} s (${R(i.overall.diff.share)}) · ${String(i.summary.sectionsWithin)} of ${String(i.summary.sections)} ${r.from==="interpretation"?"sections":"neutral segments"} within ±${String(Math.round(i.summary.tolerance*100))}%`,rows:h,cols:m,width:c,aspect:e.width/e.height,titleWidth:90}),c]}

package/dist/node_modules/@allyhub/measure/dist/reference/sections.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{cutsWithin as b}from"@allyhub/media";import{linesIn as k,textSeconds as w}from"./text.js";export const SPLIT_DEFAULTS={pause:.5,cutWithin:.15,minLength:2},SEGMENT_RULE="A segment ends where a sentence ends with a pause of `pause` seconds or more after it, or with a cut within `cutWithin` seconds of the gap before the next sentence; without speech, at every cut. Segments shorter than `minLength` seconds join their shorter neighbour. A mechanical split: it says nothing of what a segment is for.";const u=t=>Math.round(t*1e3)/1e3;export function sentences(t,s=SPLIT_DEFAULTS.pause){const a=[];let n=0;return t.forEach((i,o)=>{const e=t[o+1],c=/[.?!]["')\]]*$/.test(i.text),r=e?Math.max(0,e.start-i.end):void 0;!c&&r!==void 0&&r<s||(a.push({index:a.length,start:u(t[n]?.start??i.start),end:u(i.end),words:[n,o],text:t.slice(n,o+1).map(d=>d.text).join(" "),punctuation:c,...r===void 0?{}:{pauseAfter:u(r)}}),n=o+1)}),a}export function gaps(t){const s=[];for(let a=0;a<t.length-1;a++){const n=t[a],i=t[a+1];!n||!i||i.start<=n.end||s.push({after:a,start:u(n.end),end:u(i.start),dur:u(i.start-n.end)})}return s}function P(t,s,a){if(t.length===0)return;let n=0;for(const e of t){if(s<e.start)break;if(s<e.end)return;n=e.end}const i=t.find(e=>e.start>s),o=i?i.start:a;return o>n?{start:u(n),end:u(o),dur:u(o-n)}:void 0}const E=(t,s,a)=>{let n;for(const i of t){const o=Math.abs(i.t-s);o<=a&&(!n||o<Math.abs(n.t-s))&&(n=i)}return n};export function boundaryCandidates(t,s={}){const a=s.pause??SPLIT_DEFAULTS.pause,n=s.cutWithin??SPLIT_DEFAULTS.cutWithin,i=[],o=new Set,e=sentences(t.words,a);for(let c=0;c<e.length-1;c++){const r=e[c],d=e[c+1];if(!r||!d)continue;const h=t.cuts.filter(l=>l.t>=r.end-n&&l.t<=d.start+n),g=(r.end+d.start)/2,f=h.length?h.reduce((l,S)=>Math.abs(S.t-g)<Math.abs(l.t-g)?S:l):void 0,M=f?f.t:Math.max(r.end,d.start-Math.min(.1,(d.start-r.end)/2));f&&o.add(f.t);const x=E(t.weak??[],M,n),p=d.start-r.end;i.push({t:u(M),...f?{cut:{t:u(f.t),score:f.score}}:{},...x?{weak:{t:u(x.t),score:x.score}}:{},...p>0?{pause:{start:r.end,end:d.start,dur:u(p)}}:{},sentence:r.index})}for(const c of t.cuts){if(o.has(c.t))continue;const r=P(t.words,c.t,t.duration);i.push({t:u(c.t),cut:{t:u(c.t),score:c.score},...r?{pause:r}:{}})}return i.filter(c=>c.t>0&&c.t<t.duration).sort((c,r)=>c.t-r.t)}export function saidIn(t,s,a){return t.filter(n=>{const i=(n.start+n.end)/2;return i>=s&&i<a})}const m=(t,s)=>s>0?Math.round(t/s*60*10)/10:0;export function numbersOf(t,s,a,n=new Set){const i=Math.max(0,s-t),o=saidIn(a.words,t,s),e=b(a.cuts,t,s),c=a.text.filter(r=>!n.has(r.id));return{start:u(t),end:u(s),dur:u(i),said:o.map(r=>r.text).join(" "),words:o.length,wordsPerMinute:m(o.length,i),cuts:e.map(r=>u(r.t)),shots:e.length+1,cutsPerMinute:m(e.length,i),text:k(c,t,s),textSeconds:w(c,t,s)}}export function segmentEdges(t,s={}){const a={...SPLIT_DEFAULTS,...s},n=boundaryCandidates(t,a),i=t.words.length===0?n.map(e=>e.t):n.filter(e=>e.sentence!==void 0&&(e.cut!==void 0||(e.pause?.dur??0)>=a.pause)).map(e=>e.t),o=[0,...new Set(i.filter(e=>e>0&&e<t.duration)),t.duration];for(;;){let e=-1;for(let d=0;d<o.length-1;d++){const h=(o[d+1]??0)-(o[d]??0);h<a.minLength&&(e<0||h<(o[e+1]??0)-(o[e]??0))&&(e=d)}if(e<0||o.length<=2)break;const c=e>0?(o[e]??0)-(o[e-1]??0):1/0,r=e<o.length-2?(o[e+2]??0)-(o[e+1]??0):1/0;o.splice(c<=r?e:e+1,1)}return o}export function segments(t,s={}){const a=s.pause??SPLIT_DEFAULTS.pause,n=segmentEdges(t,s),i=sentences(t.words,a);return n.slice(0,-1).map((o,e)=>{const c=n[e+1]??t.duration,r=i.filter(g=>{const f=(g.start+g.end)/2;return f>=o&&f<c}),d=r[0],h=r.at(-1);return{index:e,name:`s${String(e+1)}`,...numbersOf(o,c,t),...d&&h?{sentences:[d.index,h.index]}:{}}})}export function measurePacing(t,s,a=new Set){const{duration:n,words:i,cuts:o}=t,e=[0,...o.map(p=>p.t),n],c=e.slice(1).map((p,l)=>p-(e[l]??0)).filter(p=>p>0),r=[...c].sort((p,l)=>p-l),d=r.length===0?n:r.length%2?r[(r.length-1)/2]??0:((r[r.length/2-1]??0)+(r[r.length/2]??0))/2,h=i[0],g=i[i.length-1],f=h&&g?g.end-h.start:0,M=i.reduce((p,l)=>p+Math.max(0,l.end-l.start),0),x=w(t.text,0,n,a);return{cutsPerMinute:m(o.length,n),meanShot:u(c.length?n/c.length:n),medianShot:u(d),wordsPerMinute:m(i.length,n),speakingRate:m(i.length,f),...h?{timeToFirstWord:u(h.start)}:{},...o[0]?{timeToFirstCut:u(o[0].t)}:{},textShare:n>0?Math.min(1,u(x/n)):0,speechShare:n>0?Math.min(1,u(M/n)):0,...s.tempo?{tempo:{bpm:s.tempo.bpm,confidence:s.tempo.confidence,...s.tempo.candidates?{candidates:s.tempo.candidates}:{},...s.tempo.prior===void 0?{}:{prior:s.tempo.prior}}}:{},onsetsPerMinute:m(s.onsets,n)}}

package/dist/node_modules/@allyhub/measure/dist/reference/sets.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as y,readdir as j,stat as w}from"node:fs/promises";import{join as m}from"node:path";import{INTERPRETATION_FILE as $,REFERENCE_FILE as p,ReferenceSchema as E}from"@allyhub/formats";import{ReferenceError as h}from"./folder.js";const g=[/^version$/,/(^|\.)params\./,/^shots\.(threshold|minShot|weakFloor|prominence)$/,/^speech\.pause$/,/^boundaries\.cutWithin$/,/^ocr\.(confidence\.word|confidence\.short|samePlace|saidWithin)$/,/^sound\.(gap|edge|voiced)$/,/^segments\.(pause|cutWithin|minLength)$/,/^pacing\.tempo\.prior$/,/^served\./],S=[[/^audio\.recording\.spectrum$/,"hz"],[/^audio\.(bandwidth|voice)\.reach$/,"drop"],[/^picture\.(sharpnessBySpeed|noiseByLuma)$/,"from"]];function b(e,t,o){if(typeof e=="number"){Number.isFinite(e)&&(o[t]=e);return}if(!(typeof e=="boolean"||typeof e=="string"||e===null)){if(Array.isArray(e)){o[`${t}#`]=e.length;const n=S.find(([r])=>r.test(t))?.[1];if(n===void 0)return;for(const r of e){const c=r[n];if(typeof c!="number")continue;const a=`${t}[${n}=${String(c)}]`;for(const[f,i]of Object.entries(r))f===n||f==="to"||b(i,`${a}.${f}`,o)}return}if(typeof e=="object")for(const[n,r]of Object.entries(e))b(r,t===""?n:`${t}.${n}`,o)}}export function referenceNumbers(e){const t={};b(e,"",t);const o={};for(const[n,r]of Object.entries(t))g.some(c=>c.test(n))||(o[n]=r);return o}export function referenceParameters(e){const t={};b(e,"",t);const o={};for(const[n,r]of Object.entries(t))g.some(c=>c.test(n))&&(o[n]=r);return o}export function quantileOf(e,t,o){const n=e.map((i,s)=>({v:i,w:o?.[s]??1})).filter(i=>Number.isFinite(i.v)&&i.w>0).sort((i,s)=>i.v-s.v);if(n.length===0)return Number.NaN;const r=Math.min(...n.map(i=>i.w)),a=(n.reduce((i,s)=>i+s.w/r,0)-1)*Math.min(1,Math.max(0,t));let f=0;for(let i=0;i<n.length;i++){const s=n[i];if(!s)continue;const l=f+s.w/r-1;if(a<=l)return s.v;const u=n[i+1];if(u&&a<l+1)return s.v+(u.v-s.v)*(a-l);f=l+1}return n[n.length-1]?.v??Number.NaN}export function statOf(e,t){const o=e.map((c,a)=>t?.[a]??1),n=o.reduce((c,a)=>c+a,0),r=c=>quantileOf(e,c,t);return{n:e.length,min:Math.min(...e),p10:r(.1),p25:r(.25),p50:r(.5),p75:r(.75),p90:r(.9),max:Math.max(...e),mean:n>0?e.reduce((c,a,f)=>c+a*(o[f]??1),0)/n:Number.NaN}}export function percentileOf(e,t,o){let n=0,r=0,c=0;return t.forEach((a,f)=>{const i=o?.[f]??1;c+=i,a<e?n+=i:a===e&&(r+=i)}),c>0?100*(n+r/2)/c:Number.NaN}function N(e){const t=o=>typeof o=="string"||typeof o=="number"||typeof o=="boolean"?[String(o)]:[];return Array.isArray(e)?e.flatMap(t):t(e)}export function labelsMatch(e,t){return t.every(o=>N(e?.[o.key]).includes(o.value))}export function labelShares(e,t){const o={};let n=0;e.forEach((c,a)=>{const f=t?.[a]??1;n+=f;for(const[i,s]of Object.entries(c??{})){if(typeof s=="number")continue;const l=o[i]??={};for(const u of N(s))l[u]=(l[u]??0)+f}});const r={};for(const[c,a]of Object.entries(o))r[c]=Object.fromEntries(Object.entries(a).sort((f,i)=>i[1]-f[1]).map(([f,i])=>[f,n>0?i/n:0]));return r}export function labelNumbers(e){const t={};for(const[o,n]of Object.entries(e??{}))typeof n=="number"&&Number.isFinite(n)&&(t[`labels.${o}`]=n);return t}const x=async e=>(await w(e).catch(()=>{}))?.isDirectory()===!0,k=async e=>await w(m(e,p)).catch(()=>{})!==void 0;async function O(e){let t;try{t=JSON.parse(await y(m(e,p),"utf8"))}catch(r){return`${p} cannot be read (${r.message})`}const o=E.safeParse(t);if(!o.success)return`${p} is not one this AllyHub reads (measure it again)`;let n;try{const r=JSON.parse(await y(m(e,$),"utf8"));r.labels&&typeof r.labels=="object"&&!Array.isArray(r.labels)&&(n=r.labels)}catch{n=void 0}return{dir:e,id:o.data.id,numbers:{...referenceNumbers(o.data),...labelNumbers(n)},parameters:referenceParameters(o.data),...n?{labels:n}:{}}}async function M(e){const t=[];for(const o of e){if(!await x(o))throw new h("not-found",`${o} is not a folder.`,{kind:"not-found"});if(await k(o)){t.push(o);continue}const n=(await j(o,{withFileTypes:!0})).filter(r=>r.isDirectory()).map(r=>m(o,r.name)).sort();for(const r of n)await k(r)&&t.push(r)}return[...new Set(t)]}export async function referenceSet(e,t={}){const o=await M(e),n=[],r=[];for(const s of o){if(t.place!==void 0&&s===t.place)continue;const l=await O(s);if(typeof l=="string")n.push({dir:s,why:l});else{if(t.where?.length&&!labelsMatch(l.labels,t.where))continue;r.push(l)}}if(r.length===0)throw new h("empty-set",`No reference folder ${t.where?.length?`whose labels hold ${t.where.map(s=>`${s.key}=${s.value}`).join(", ")}`:`with a ${p}`} in ${e.join(", ")}.`,{kind:"not-found",hint:`Pass reference folders (allyhub reference), or folders of them; labels are ${$}'s.`});const c=[...new Set(r.flatMap(s=>Object.keys(s.numbers)))].sort();let a;if(t.place!==void 0){const s=await O(t.place);if(typeof s=="string")throw new h("bad-reference",`${t.place}: ${s}.`,{kind:"not-found"});a=s}const f={};for(const s of c){const l=r.flatMap(d=>d.numbers[s]===void 0?[]:[d.numbers[s]]),u=a?.numbers[s];f[s]={...statOf(l),...u===void 0?{}:{value:u,percentile:percentileOf(u,l)}}}const i={};for(const s of r)for(const[l,u]of Object.entries(s.parameters)){const d=i[l]??={};d[String(u)]=(d[String(u)]??0)+1}return{n:r.length,members:r.map(s=>({id:s.id,dir:s.dir})),...n.length>0?{left:n}:{},...t.where?.length?{where:[...t.where]}:{},numbers:f,labels:labelShares(r.map(s=>s.labels)),measuredWith:i,...a?{place:{id:a.id,dir:a.dir,...a.labels?{labels:a.labels}:{},alone:Object.keys(a.numbers).filter(s=>!(s in f))}}:{}}}

package/dist/node_modules/@allyhub/measure/dist/reference/text.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{normText as S}from"@allyhub/video-core";export const TEXT_DEFAULTS={samePlace:.05,saidWithin:1};export function sampleSpans(t,e){return t.map((r,o)=>{const p=o>0?((t[o-1]??0)+r)/2:0,g=o<t.length-1?(r+(t[o+1]??e))/2:e;return[Math.max(0,p),Math.min(e,g)]})}const l=t=>Math.round(t*1e3)/1e3,B=t=>{if(t.length===0)return 0;const e=[...t].sort((o,p)=>o-p),r=Math.floor(e.length/2);return e.length%2?e[r]??0:((e[r-1]??0)+(e[r]??0))/2},A=t=>[t[0]+t[2]/2,t[1]+t[3]/2],D=t=>t.split(/\s+/).map(e=>S(e)).filter(e=>e.length>0);export function observeText(t,e,r,o={}){const p=o.samePlace??TEXT_DEFAULTS.samePlace,g=o.saidWithin??TEXT_DEFAULTS.saidWithin,w=sampleSpans(t.map(u=>u.t),r),c=new Map;for(const u of e){const f=S(u.text);if(!f)continue;const s=c.get(f)??[];s.push(u.start),c.set(f,s)}const a=[],k=new Map;return t.forEach((u,f)=>{for(const s of u.lines){const m=S(s.text);if(!m)continue;const[x,y]=A(s.box),h=k.get(m)??[],M=h.find(T=>{const d=a[T]?.sightings.at(-1);if(!d||d.frame===f)return!1;const[W,E]=A(d.line.box);return Math.hypot(x-W,y-E)<p});M===void 0?(h.push(a.length),k.set(m,h),a.push({key:m,sightings:[{frame:f,line:s}]})):a[M]?.sightings.push({frame:f,line:s})}}),a.map((u,f)=>{const s=u.sightings,m=new Map;for(const n of s)m.set(n.line.text,(m.get(n.line.text)??0)+1);const x=[...m].reduce((n,i)=>i[1]>n[1]?i:n)[0],y=[0,1,2,3].map(n=>l(B(s.map(i=>i.line.box[n]??0)))),h=[];s.forEach((n,i)=>{const[b,I]=w[n.frame]??[0,0],v=h.at(-1);v&&s[i-1]?.frame===n.frame-1?v[1]=I:h.push([b,I])});const M=x.replace(/[^\p{L}]/gu,""),T=M.replace(/[^\p{Lu}]/gu,"").length,d=D(x),W=s.map(n=>t[n.frame]?.t??0),E=d.filter(n=>(c.get(n)??[]).some(i=>W.some(b=>Math.abs(i-b)<=g))).length,P=h[0]?.[0]??0,L=h.at(-1)?.[1]??P;return{id:f,text:x,box:y,height:y[3],conf:Math.round(s.reduce((n,i)=>n+i.line.conf,0)/s.length),words:x.split(/\s+/).filter(Boolean).length,upper:M.length?l(T/M.length):0,start:l(P),end:l(L),spans:h.map(([n,i])=>[l(n),l(i)]),seconds:l(h.reduce((n,[i,b])=>n+(b-i),0)),seen:s.length,frames:t.length?l(s.length/t.length):0,spread:r>0?Math.min(1,l((L-P)/r)):0,said:d.length?l(E/d.length):0}})}export function textSeconds(t,e,r,o=new Set){const p=t.filter(c=>!o.has(c.id)).flatMap(c=>c.spans).map(([c,a])=>[Math.max(c,e),Math.min(a,r)]).filter(([c,a])=>a>c).sort((c,a)=>c[0]-a[0]);let g=0,w=-1/0;for(const[c,a]of p)a<=w||(g+=a-Math.max(c,w),w=a);return l(g)}export function linesIn(t,e,r){return t.filter(o=>o.spans.some(([p,g])=>p<r&&g>e)).map(o=>o.id)}

package/dist/node_modules/@allyhub/measure/dist/reference/video.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{BANDWIDTH_DEFAULTS as w,RECORDING_MEASURE_DEFAULTS as b,SAMPLE_RATE as l,bandwidthOf as E,measureRecording as M}from"@allyhub/audio";import{analyzeSound as T,decodeStereo as x}from"@allyhub/audio/node";import{takeVoice as A}from"@allyhub/build";import{ASR_MODEL as m,MediaError as f,beats as P,cached as D,pictureStats as _,probeVideo as k,screenText as y,shots as L,transcribe as R}from"@allyhub/media";import{soundUnder as v}from"@allyhub/video-core";import{SEGMENT_RULE as F,SPLIT_DEFAULTS as U,boundaryCandidates as W,gaps as I,measurePacing as O,segments as N,sentences as C}from"./sections.js";import{TEXT_DEFAULTS as S,observeText as G}from"./text.js";export const wordOf=({confidence:e,...s})=>e===void 0?s:{...s,confidence:e};const V=.15;async function B(e,s,t){if(!s.hasAudio)return{words:[]};try{return{words:await D(e,"reference-words",{version:1,options:{model:m,lang:t.lang??null}},t,async()=>(await R(e,{...t.lang===void 0?{}:{lang:t.lang},cloud:t.cloud,signal:t.signal,onProgress:t.onProgress})).words.map(wordOf)),asr:m}}catch(n){if(t.signal?.aborted===!0||n instanceof f&&n.code==="cancelled")throw n;return{words:[],wordsMissing:{...n instanceof f?{code:n.code}:{},message:n instanceof Error?n.message:String(n),...n instanceof f&&n.hint!==void 0?{hint:n.hint}:{}}}}}async function z(e,s){const t=await T(e),n=await x(e),o=M(n,l,b),a=E(n,l,w),d=(s??[]).map(i=>[i.start,i.end]),r=d.length>0?E(n,l,{...w,pick:i=>{const c=i/l;return d.some(([h,g])=>c>=h&&c<=g)}}):void 0;return{loudness:{integrated:t.integrated??null,range:t.range??null,truePeak:t.truePeak??null},recording:{params:{...b},...o},bandwidth:{params:{...w},...a},...r?{voice:r}:{}}}export async function measureVideo(e,s={}){const t={signal:s.signal,onProgress:s.onProgress},n={root:s.root,fresh:s.fresh},o=u=>{s.onProgress?.({step:"decode",message:u})},a=await k(e,t);o("Finding cuts");const d=await L(e,{...n,...t,...s.all===!0?{all:!0}:{}});let r,i;a.hasAudio&&(o("Finding onsets and tempo"),r=await P(e,{...n,...t}),o("Measuring the sound's levels"),i=await A(e,s.root??process.cwd(),t));const c=await B(e,a,{...s,...n});o("Reading on-screen text");const h=await y(e,{...n,...t,extra:d.cuts.map(u=>u.t+V),...s.all===!0?{all:!0}:{}});o("Measuring the picture");const g=await _(e,{...n,...t,cuts:d.cuts.map(u=>u.t)});let p;return a.hasAudio&&(o("Measuring the sound as a recording"),p=await z(e,c.wordsMissing?void 0:c.words).catch(()=>{})),{info:a,...c,shots:d,...r?{beats:r}:{},...i?{levels:i}:{},ocr:h,text:G(h.frames,c.words,a.duration,S),picture:g,...p?{audio:p}:{}}}export const WORDS_MISSING_INSTEAD="No words file, sentences or pauses; word counts, words per minute and each text line's `said` share are 0 because nothing was heard. The boundary candidates and the neutral split are the cuts alone; cuts, beats, on-screen text and contact sheets are measured as usual.";export function referenceJson(e,s){const t=U,n={duration:e.info.duration,words:e.words,cuts:e.shots.cuts,weak:e.shots.weak,text:e.text},o=I(e.words),a=e.info,d=a.codec!==void 0||a.bitrate!==void 0||a.audio!==void 0;return{version:1,id:s.id,source:{file:s.file,...s.url===void 0?{}:{url:s.url},...s.title===void 0?{}:{title:s.title},sha256:s.sha256},analysedAt:(s.at??new Date).toISOString(),duration:a.duration,width:a.width,height:a.height,fps:a.fps,...d?{encoding:{...a.codec===void 0?{}:{codec:a.codec},...a.bitrate===void 0?{}:{bitrate:a.bitrate},...a.audio===void 0?{}:{audio:a.audio}}}:{},...s.words===void 0?{}:{words:s.words},wordCount:e.words.length,...e.asr===void 0?{}:{asr:e.asr},...e.wordsMissing?{wordsMissing:{...e.wordsMissing,instead:WORDS_MISSING_INSTEAD}}:{},shots:{threshold:e.shots.threshold,minShot:e.shots.minShot,weakFloor:e.shots.weakFloor,prominence:e.shots.prominence,cuts:e.shots.cuts,weak:e.shots.weak,...e.shots.candidates?{candidates:e.shots.candidates}:{}},speech:{pause:t.pause,sentences:C(e.words,t.pause),pauses:o.filter(r=>r.dur>=t.pause),...s.all===!0?{gaps:o}:{}},boundaries:{cutWithin:t.cutWithin,candidates:W(n,t)},ocr:{engine:e.ocr.engine,confidence:e.ocr.confidence,frames:e.ocr.frames.length,samePlace:S.samePlace,saidWithin:S.saidWithin,...e.ocr.frames.some(r=>r.low)?{low:e.ocr.frames.flatMap(r=>(r.low??[]).map(i=>({t:r.t,...i})))}:{}},text:e.text,pacing:O(n,{onsets:e.beats?.onsets.length??0,tempo:e.beats?.tempo}),...e.levels?{sound:v(e.levels,e.wordsMissing?void 0:e.words,(e.beats?.onsets??[]).map(r=>r.t))}:{},segments:{rule:F,pause:t.pause,cutWithin:t.cutWithin,minLength:t.minLength,list:N(n,t)},sheets:s.sheets,picture:{...e.picture,params:{...e.picture.params}},...e.audio?{audio:e.audio}:{}}}

package/dist/node_modules/@allyhub/measure/dist/seams.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{changeOf as A,fact as z,flashOptions as J,flashRuns as K,pictureMotion as L,seamCarriers as N,seamOptions as Q,seamSide as S}from"@allyhub/video-core";import{readPng as T}from"@allyhub/render";const w=e=>Math.round(e*1e3)/1e3;export function joinsOf(e){const u=e.fps,c=[];for(let a=1;a<e.parts.length;a++){const s=e.parts[a-1],n=e.parts[a];if(!s||!n)continue;const p=Math.round(n.start*u),i=(e.transitions??[]).find(o=>o.part===n.key);c.push({from:s.key,to:n.key,at:p,before:i?Math.round(i.start*u):p,after:i?Math.round(i.end*u):p,first:Math.round(s.start*u),end:Math.round(n.end*u),...i?{transition:{type:i.type,start:w(i.start),end:w(i.end)}}:{}})}return c}const U=e=>{const{width:u,height:c,data:a}=T(e);return{width:u,height:c,data:a}};function D(e,u,c){const a=new Map,s=new Map,n=new Map,p=async o=>(a.has(o)||a.set(o,await e.sign(o/u)),a.get(o)),i=async o=>U(await e.thumb(o/u,c));return{sign:p,async same(o,M){const l=await p(o);return l!==void 0&&l===await p(M)},async picture(o){const M=n.get(o);if(M)return M;const l=await p(o),t=(l===void 0?void 0:s.get(l))??Promise.resolve(await i(o));return n.set(o,t),l!==void 0&&s.set(l,t),t}}}export async function cutSeams(e,u={},c={}){const a=e.timeline,s=Q(u),n=a.fps,p=s.frames,i=[a.width,a.height],o=c.width??160,M=c.picture?D(e,n,o):void 0,l=[];for(const r of joinsOf(a)){const t=r.at/n;if(c.from!==void 0&&t<c.from-1e-6||c.to!==void 0&&t>c.to+1e-6)continue;const m=Math.max(r.first,r.before-p),d=r.before-1,g=r.after,b=Math.min(r.end-1,r.after+p-1);if(d<m||b<g)continue;const y=(h,k)=>Array.from({length:k-h+1},(F,O)=>h+O),f=y(m,d),x=y(g,b),P=await e.tracks(m/n,d/n),B=await e.tracks(g/n,b/n),v=S(P,r.from,f.map(h=>h/n),"last",i,s),j=S(B,r.to,x.map(h=>h/n),"first",i,s);if(M){const h=a.width/o,k=async G=>{const q=[];for(const H of G)q.push(await M.picture(H));return L(q,n,h,8,s.rest)},F=await k(f),O=await k(x);F&&(v.picture=F),O&&(j.picture=O)}const C={...s,top:0},I=S(P,r.from,f.map(h=>h/n),"last",i,C).list,R=S(B,r.to,x.map(h=>h/n),"first",i,C).list,_=h=>h.find(k=>k.moving),E={at:w(t),before:v,after:j,...r.transition?{transition:r.transition}:{},change:{lead:A(_(I),_(R)),overall:A(v.overall,j.overall),...v.picture&&j.picture?{picture:A(v.picture,j.picture)}:{}},carriers:N(I,R,i),options:s};l.push(z("cut-seam",{piece:e.target.piece,output:e.target.output,combo:e.target.combo,format:e.target.format,part:r.to,t:w(t)},E))}return l}export async function flashFrames(e,u={},c={}){const a=e.timeline,s=J(u),n=a.fps,p=Math.max(0,Math.round(a.duration*n)-1),i=joinsOf(a),o=new Set;if(c.from!==void 0||c.to!==void 0){const t=Math.max(1,Math.ceil((c.from??0)*n-1e-6)),m=Math.min(p-1,Math.floor((c.to??1/0)*n+1e-6));for(let d=t;d<=m;d++)o.add(d)}else for(const t of i)for(const m of new Set([t.before,t.at,t.after]))for(let d=m-s.reach;d<m+s.reach;d++)for(let g=1;g<=s.frames;g++){const b=d-g+1;b>=1&&d<=p-1&&o.add(b)}const M=D(e,n,s.width),l=await K([...o].sort((t,m)=>t-m),p,t=>M.picture(t),(t,m)=>M.same(t,m),s,c.all===!0,i.map(t=>t.at)),r=t=>({share:Math.round(t.share*1e5)/1e5,mean:w(t.mean)});return l.map(t=>{const m=w(t.from/n),d=w((t.to+1)/n),g=a.parts.filter(f=>Math.round(f.start*n)<=t.to&&Math.round(f.end*n)>t.from).map(f=>f.key),b=i.map(f=>f.at).filter(f=>Math.abs(f-t.from)<=s.reach+s.frames).sort((f,x)=>Math.abs(f-t.from)-Math.abs(x-t.from))[0],y=(a.transitions??[]).find(f=>Math.round(f.start*n)<=t.to&&Math.round(f.end*n)>t.from);return z("flash",{piece:e.target.piece,output:e.target.output,combo:e.target.combo,format:e.target.format,t:m,...g[0]?{part:g[0]}:{}},{start:m,end:d,frames:t.to-t.from+1,parts:g,foreign:r(t.foreign),before:r(t.before),after:r(t.after),across:r(t.across),...t.own?{own:{side:t.own.side,step:r(t.own.step),usual:r(t.own.usual)}}:{},...b===void 0?{}:{join:w(b/n)},...y?{transition:{type:y.type,from:y.from,to:y.part}}:{},options:s})})}

package/dist/node_modules/@allyhub/measure/dist/sound-measures.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{matchOnsets as i,semitones as p}from"@allyhub/media";export const ONSET_TOLERANCE_MS=50;const c=(t,n)=>Math.round(t*10**n)/10**n;export function voiceStep(t,n){return{...t.pitch&&n.pitch?{pitch:p(t.pitch.median,n.pitch.median)}:{},...t.pace!==void 0&&n.pace!==void 0&&t.pace>0?{pace:c(n.pace/t.pace-1,2)}:{},...t.bright!==void 0&&n.bright!==void 0?{bright:c(n.bright-t.bright,1)}:{}}}export function speechStretches(t){const n=t.speed??1,r=t.cuts;return!r||r.length===0?[{from:t.from,dur:(t.end-t.start)*n}]:r.map((e,d)=>({from:e.from,dur:((r[d+1]?.at??t.end)-e.at)*n}))}export function partAt(t,n){const r=t.at(-1);return t.find(e=>n>=e.start&&n<e.end)?.key??(r&&n>=r.end?r.key:void 0)}export function landings(t,n,r,e=ONSET_TOLERANCE_MS){const d=t.filter(a=>a.start>0),u=i(d.map(a=>a.start),r,e).map((a,s)=>({part:d[s]?.key??"",...a})),o=i(n.map(a=>a.t),r,e).map((a,s)=>({sound:n[s]?.sound??"",part:n[s]?.part??"",...a}));return{cuts:u,cues:o,summary:{toleranceMs:e,cuts:u.length,cutsOnOnset:u.filter(a=>a.near).length,cues:o.length,cuesOnOnset:o.filter(a=>a.near).length}}}export function recordingDifference(t,n){const r=new Map(t.spectrum.map(e=>[e.hz,e.db]));return{spectrum:n.spectrum.flatMap(e=>{const d=r.get(e.hz);return d===void 0?[]:[{hz:e.hz,db:c(e.db-d,1)}]}),..."t60"in t.decay&&"t60"in n.decay?{decay:c(n.decay.t60-t.decay.t60,2)}:{},..."below"in t.tone&&"below"in n.tone?{tone:c(n.tone.below-t.tone.below,1),tilt:c(n.tone.tilt-t.tone.tilt,1)}:{},spread:c(n.dynamics.spread-t.dynamics.spread,1),crest:c(n.dynamics.crest-t.dynamics.crest,1)}}

package/dist/node_modules/@allyhub/measure/dist/sound-report.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{mkdtemp as X,rm as ee}from"node:fs/promises";import{tmpdir as te}from"node:os";import{join as j}from"node:path";import{SAMPLE_RATE as ne,drySpeech as se,integratedLoudness as oe}from"@allyhub/audio";import{ANALYZE_DEFAULTS as N,analyzeSound as ie,decodeMono as T,decodeStereo as ae,ffmpegOf as R,fileLoudness as re,spanLoudness as I}from"@allyhub/audio/node";import{VOICE_RATE as f,VOICE_SHAPE_DEFAULTS as de,estimateTempo as ce,onsetNovelty as le,pickOnsets as ue,voiceShape as C}from"@allyhub/media";import{mixSound as fe}from"@allyhub/render";import{joinedWords as me,measureVoice as pe,paceOf as he,soundUnder as we,speechUnits as ge}from"@allyhub/video-core";import{ONSET_TOLERANCE_MS as be,landings as ve,partAt as ye,speechStretches as Se,voiceStep as G}from"./sound-measures.js";import{ProjectError as Me}from"@allyhub/project";import{versionVoice as ke}from"./version-voice.js";const x=r=>Math.round(r*10)/10,y=r=>Math.round(r*1e3)/1e3,q=.1;async function z(r,o,c,l){const i={noise:c.silence?.noise??N.noise,min:c.silence?.min??N.minSilence},d=await ie(r,{ffmpeg:l,noise:i.noise,minSilence:i.min}),S=le(d.samples,d.rate,c.onsets),M=ue(S,c.onsets),w=ce(S),u=pe(await T(r,f,{ffmpeg:l}),f),$=n=>n===void 0?null:x(n);return{analysis:d,basics:{duration:y(d.duration),loudness:{integrated:d.integrated??null,range:d.range??null,truePeak:d.truePeak??null,samplePeak:$(d.samplePeak),rms:$(d.rms)},clipped:d.clipped,silences:d.silences.map(n=>({start:y(n.start),end:y(n.end),duration:y(n.duration)})),onsets:M,pace:he(d.duration,M.length,w,o??[]),sound:we(u,o,M.map(n=>n.t),c.sound),options:{silence:i,onsets:c.onsets??{}}}}}export async function fileSoundReport(r,o={}){const c=await R(o),{basics:l}=await z(r,void 0,o,c);return{source:{kind:"file",file:r},...l}}export async function soundReport(r,o={}){if(r.target.output!=="video")throw new Me("not-video",`${r.target.piece} is not a video, so it has no sound.`,"usage");const c=await R(o),l={ffmpeg:c},i=r.timeline,d=await r.sound(l),S=await X(j(te(),"allyhub-audio-"));try{const M=async e=>fe({timeline:i,sound:d,out:e,ffmpeg:c});let w=o.file,u;w===void 0&&(w=j(S,"mix.wav"),u=await M(w));const $=me(await r.version.stage.words(),1/i.fps),{basics:n,analysis:L}=await z(w,$,o,c),B=n.sound.words&&n.sound.between&&n.sound.between.seconds>=1?x(n.sound.words.median-n.sound.between.median):null,k=new Map;for(const e of i.audio.speech??[])k.set(e.file,"speech");i.audio.music?.file&&k.set(i.audio.music.file,"music");for(const e of i.footage??[])e.audio&&e.take!==!0&&k.set(e.file,"footage");for(const e of i.cues)e.file!==void 0&&k.set(e.file,"sfx");const F=[];for(const[e,t]of k){const s=d.sources.file(e),a=s===void 0?void 0:await re(s,l).catch(()=>{});F.push({file:e,as:t,lufs:a?x(a.lufs):null,by:a?.by??null})}const H=ve(i.parts,i.cues,n.onsets,o.tolerance),O=new Map,K=e=>{let t=O.get(e);if(!t){const s=d.sources.file(e);t=s===void 0?Promise.resolve(void 0):T(s,f,l).catch(()=>{}),O.set(e,t)}return t},W=async e=>{const t=await K(e.file);if(!t)return null;const s=Se(e).map(({from:g,dur:A})=>t.subarray(Math.max(0,Math.round(g*f)),Math.round((g+A)*f))),a=new Float32Array(s.reduce((g,A)=>g+A.length,0));let p=0;for(const g of s)a.set(g,p),p+=g.length;const m=ge(e.heard??""),h=m.words+m.cjk,D=e.end-e.start;return{...C(a,f,o.voice),...h>0&&D>0?{pace:Math.round(h/D*100)/100}:{}}},P=o.file===void 0?void 0:await T(o.file,f,l).catch(()=>{}),Y=e=>{if(!P)return null;const t=P.subarray(Math.max(0,Math.round(e.start*f)),Math.round(e.end*f));return t.length>0?C(t,f,o.voice):null},U=await ke(r,l),Z=se(U),J=await ae(w,{},l),V=(e,t,s,a)=>{const p=oe(e.map(m=>m.subarray(Math.max(0,Math.round(s*t)),Math.round(a*t))),t);return p===void 0?null:x(p)},b=[];for(const e of i.parts){const t=e.speech;if(!t)continue;const s=I(L.frames,t.start,t.end),a=await W(t),p=b.at(-1)?.voice,m=o.file===void 0?void 0:Y(t);b.push({part:e.key,start:t.start,end:t.end,file:t.file,from:t.from,loudness:s.mean??null,levels:{before:V(Z,U.rate,t.start,t.end),after:V(J,ne,t.start,t.end),...e.speechGainDb===void 0?{}:{gainDb:e.speechGainDb}},gaps:n.silences.filter(h=>h.start<t.end-q&&h.end>t.start+q).map(h=>({start:y(Math.max(h.start,t.start)),end:y(Math.min(h.end,t.end))})),voice:a,...p&&a?{step:G(p,a)}:{},...m===void 0?{}:{fileVoice:m},...a&&m?{fileStep:G(a,m)}:{}})}const v=[];for(const[e,t]of b.entries()){const s=b[e+1];s&&s.start<t.end-.001&&v.push(`The speech of ${t.part} and ${s.part} overlap (${s.start.toFixed(2)} < ${t.end.toFixed(2)} s): words may be heard twice.`),t.gaps.length>0&&v.push(`Silence inside the speech of ${t.part}: ${t.gaps.map(a=>`${a.start.toFixed(2)}–${a.end.toFixed(2)} s`).join(", ")}.`)}o.file!==void 0&&Math.abs(n.duration-i.duration)>1/i.fps+.05&&v.push(`The file is ${n.duration.toFixed(2)} s but the video is ${i.duration.toFixed(2)} s: the cuts and cues are placed on the video's clock.`);for(const e of F)e.by==="level"&&v.push(`${e.file} is too short (or quiet) for integrated loudness: it is levelled by its K-weighted level over its whole length, ${e.lufs===null?"–":e.lufs.toFixed(1)} LUFS.`);const E=u?.target.lufs;u?.loudness&&E!==void 0&&E!==!1&&Math.abs(u.loudness.integrated-E)>.15&&v.push(`The master reached ${u.loudness.integrated.toFixed(1)} LUFS, not the ${String(E)} asked for: its limiter at ${String(u.target.truePeak)} dBTP takes what more gain would add.`);const Q=b.filter(e=>e.levels.before!==null&&e.levels.after!==null),_=e=>{const t=Q.map(s=>s.levels[e]??0);return t.length>1?x(Math.max(...t)-Math.min(...t)):null};return{source:o.file===void 0?{kind:"mix"}:{kind:"file",file:o.file},...u?{master:u}:{},...n,silences:n.silences.map(e=>{const t=ye(i.parts,e.start);return{...e,...t===void 0?{}:{part:t}}}),bedUnderVoice:B,stems:F,speechSpread:{before:_("before"),after:_("after")},...H,parts:i.parts.map(e=>{const t=I(L.frames,e.start,e.end);return{key:e.key,start:e.start,end:e.end,loudness:t.mean??null,peak:t.max??null,onsets:n.onsets.filter(s=>s.t>=e.start&&s.t<e.end).length}}),speech:b,options:{...n.options,voice:{...de,...o.voice},toleranceMs:o.tolerance??be},notes:v}}finally{await ee(S,{recursive:!0,force:!0})}}

package/dist/node_modules/@allyhub/measure/dist/still.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{fact as N}from"@allyhub/video-core";import{readPng as T}from"@allyhub/render";export const STILL_DEFAULTS={every:1,width:320,noise:8,change:.001,minSeconds:3};export function stillOptions(t={}){const a=(r,o)=>{const e=t[r];return e!==void 0&&Number.isFinite(e)&&e>=o?e:STILL_DEFAULTS[r]};return{every:a("every",.001),width:Math.round(a("width",1)),noise:a("noise",0),change:a("change",0),minSeconds:a("minSeconds",0)}}export function readThumb(t){const{width:a,height:r,data:o}=T(t);return{width:a,height:r,data:o}}export function pictureChange(t,a,r){if(t.width!==a.width||t.height!==a.height)return{changed:1,mean:255};const o=t.width*t.height;if(o===0)return{changed:0,mean:0};let e=0,s=0;for(let f=0;f<o*4;f+=4){let u=0;for(let i=0;i<4;i++)u=Math.max(u,Math.abs((t.data[f+i]??0)-(a.data[f+i]??0)));s+=u,u>r&&e++}return{changed:e/o,mean:s/o}}const y={changed:0,mean:0};export async function stillRuns(t,a,r){const o=[];let e=0,s=y,f=y;const u=i=>{i>e&&o.push({from:e,to:i,worst:s,drift:f})};for(let i=1;i<t;i++){const h=await a(e,i);if(h.changed<=r+1e-12){s={changed:Math.max(s.changed,h.changed),mean:Math.max(s.mean,h.mean)},f=h;continue}u(i-1),e=i,s=y,f=y}return u(t-1),o}export function stillFrames(t,a){const r=Math.max(0,Math.round(t.duration*t.fps)-1),o=new Set;for(let e=0;;e++){const s=Math.round(e*a*t.fps);if(s>r)break;o.add(s)}return o.add(r),[...o].sort((e,s)=>e-s)}const M=t=>Math.round(t*1e3)/1e3,D=t=>Math.round(t*1e5)/1e5,E=t=>({change:D(t.changed),mean:M(t.mean)});export async function stillPicture(t,a={},r={}){const o=t.timeline,e=stillOptions(a),s=o.fps,f=Math.max(0,Math.round(o.duration*s)-1),u=r.from===void 0?0:r.from*s-1e-6,i=r.to===void 0?1/0:r.to*s+1e-6,h=stillFrames(o,e.every).filter(n=>n>=u&&n<=i),S=new Map,x=new Map,k=async n=>{let c=x.get(n);return c||(c=readThumb(await t.thumb((h[n]??0)/s,e.width)),x.set(n,c)),c},v=async n=>(S.has(n)||S.set(n,await t.sign((h[n]??0)/s)),S.get(n));let b;const L=await stillRuns(h.length,async(n,c)=>{const l=await v(n),m=await v(c);if(l!==void 0&&l===m)return y;b?.first!==n&&(b={first:n,by:new Map});const p=m===void 0?void 0:b.by.get(m);if(p)return p;const g=pictureChange(await k(n),await k(c),e.noise);m!==void 0&&b.by.set(m,g);for(const w of x.keys())w!==n&&w!==c&&x.delete(w);return g},e.change),O=n=>M((h[n]??0)/s),F=[];for(const n of L){const c=O(n.from),l=O(n.to),m=M(l-c);if(m<e.minSeconds-1e-9)continue;const p=o.parts.filter(d=>d.start<=l+1e-6&&d.end>c+1e-6).map(d=>d.key),g=(o.footage??[]).filter(d=>d.start<=l+1e-6&&d.end>c+1e-6).map(d=>({file:d.file,part:d.part,start:M(d.start),end:M(d.end)})),w={start:c,end:l,seconds:m,frames:n.to-n.from+1,parts:p,...E(n.worst),drift:E(n.drift),...g.length>0?{footage:g}:{},...(h[n.to]??0)>=f?{toEnd:!0}:{},options:e};F.push(N("still-picture",{piece:t.target.piece,output:t.target.output,combo:t.target.combo,format:t.target.format,t:c,...p[0]?{part:p[0]}:{}},w))}return F}

package/dist/node_modules/@allyhub/measure/dist/version-voice.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{voiceTracks as t}from"@allyhub/audio/node";export async function versionVoice(e,n={}){const i=await e.sound(n),s=await t(i.plan,i.sources,n.ffmpeg===void 0?{}:{ffmpeg:n.ffmpeg}),o=e.piece.options.mic;return{...s,...o===void 0?{}:{setting:o}}}

package/dist/node_modules/@allyhub/measure/package.json

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

package/dist/node_modules/@allyhub/media/dist/asr/parakeet.js

@@ -0,0 +1,7 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{execFile as R,spawnSync as L}from"node:child_process";import{createRequire as b}from"node:module";import{join as _}from"node:path";import{pathToFileURL as y}from"node:url";import{createPackages as m}from"@allyhub/runtimes";import{nodeCommand as $,workerCommand as k}from"@allyhub/runtimes/node";import{MediaError as a,oneLine as c}from"../errors.js";import{ensureRuntime as T,runtimesOf as M}from"../tools.js";import{workerEnv as f}from"../worker-process.js";import{PARAKEET_LANGUAGES as S}from"./languages.js";import{ERROR_PREFIX as d,RESULT_PREFIX as u,WORKER_INPUT as g}from"./protocol.js";export{d as ERROR_PREFIX,u as RESULT_PREFIX,g as WORKER_INPUT};export const MODEL="parakeet-tdt-0.6b-v3-int8",MODEL_RUNTIME="parakeet",RUNTIME="sherpa-onnx-node",RUNTIME_VERSION="1.13.8",MODEL_FILES=["encoder.int8.onnx","decoder.int8.onnx","joiner.int8.onnx","tokens.txt"];const h=["darwin-arm64","darwin-x64","linux-x64","linux-arm64","win32-x64","win32-ia32"];function O(){const e=process.report.getReport();return{platform:process.platform,arch:process.arch,glibc:e.header?.glibcVersionRuntime}}export function unsupportedReason(e=O()){const r=`${e.platform}-${e.arch}`;if(!h.includes(r))return`Local speech recognition runs on ${h.join(", ")}; this computer is ${r}.`;if(e.platform!=="linux")return;if(!e.glibc)return"Local speech recognition needs glibc 2.32 or newer; this Linux has none (musl?).";const[n=0,t=0]=e.glibc.split(".").map(Number);if(!(n>2||n===2&&t>=32))return`Local speech recognition needs glibc 2.32 or newer; this computer has glibc ${e.glibc}.`}export function nativePackage(e=process.platform,r=process.arch){return`sherpa-onnx-${e==="win32"?"win":e}-${r}`}export function runtimeInstalled(){const e=m().entry(RUNTIME);if(!e)return!1;try{return b(e).resolve(`${nativePackage()}/package.json`),!0}catch{return!1}}const U=`import(process.env.ALLYHUB_SHERPA_MODULE).catch((e) => {
+  process.stderr.write(String(e && e.message).replace(/\\s+/g, " "));
+  process.exitCode = 1;
+});`;export function runtimeLoadError(){const e=m().entry(RUNTIME);if(!e)return`${RUNTIME} is not installed`;const r=y(e).href,n=L($(),["--input-type=module","-e",U],{env:f({ALLYHUB_SHERPA_MODULE:r}),encoding:"utf8",stdio:["ignore","ignore","pipe"],timeout:6e4});if(n.status===0)return;const t=n.stderr.trim();return t?c(t):n.error?c(n.error):n.signal?`loading it crashed (${n.signal})`:"it does not load"}export async function ensureModel(e={}){return(await T(MODEL_RUNTIME,"model","the Parakeet speech model",e)).dir}export async function status(e={}){const r=unsupportedReason(),n=(await M(e).status()).find(t=>t.name===MODEL_RUNTIME);if(!n)throw new a("install",`The runtime manager has no ${MODEL_RUNTIME} model.`);return{model:MODEL,...r?{unsupported:r}:{},runtime:{name:RUNTIME,installed:runtimeInstalled(),version:RUNTIME_VERSION},modelFiles:{installed:n.installed,dir:n.dir,bytes:n.size},download:n.installed?0:n.size,languages:S}}export function recognizerConfig(e){const[r,n,t,i]=MODEL_FILES.map(o=>_(e,o));return{featConfig:{sampleRate:16e3,featureDim:80},modelConfig:{transducer:{encoder:r,decoder:n,joiner:t},tokens:i,numThreads:4,provider:"cpu",debug:0,modelType:"nemo_transducer"},decodingMethod:"greedy_search"}}const A=e=>Math.max(18e5,e*2e3);function I(e,r){const n=e?e.killed?"was stopped (it took too long)":e.signal?`crashed (${e.signal})`:`exited with code ${String(e.code)}`:"exited without a result",t=r.split(`
+`).map(o=>o.trim()).filter(Boolean),i=t.find(o=>o.startsWith(d))?.slice(d.length)??t.at(-1);return i?`${n}: ${c(i)}`:n}export function decode(e,{seconds:r,signal:n}){const{command:t,args:i}=k(import.meta.url,"worker");return new Promise((o,l)=>{R(t,i,{env:f({[g]:JSON.stringify(e)}),maxBuffer:256*1024*1024,timeout:A(r),...n?{signal:n}:{}},(s,x,w)=>{if(n?.aborted){l(new a("cancelled","Stopped.",{cause:s}));return}const p=x.split(`
+`).find(E=>E.startsWith(u));if(!s&&p){o(JSON.parse(p.slice(u.length)));return}l(new a("decode",`The speech decoder ${I(s,w)}.`,{hint:"If it keeps failing, install AllyHub again: its speech runtime may be broken."}))})})}

package/dist/node_modules/@allyhub/media/dist/asr/transcribe.d.ts

@@ -0,0 +1,50 @@
+import type { Word } from "@allyhub/formats";
+import { type Stretch } from "../audio.js";
+import { type ToolOptions } from "../tools.js";
+/** Word times of a 16 kHz WAV, from a cloud model. */
+export type CloudHearing = (wav: string, o: {
+    lang?: string | undefined;
+    signal?: AbortSignal | undefined;
+}) => Promise<{
+    words: {
+        text: string;
+        start: number;
+        end: number;
+    }[];
+    model: string;
+}>;
+export interface TranscribeOptions extends ToolOptions {
+    /** Hears in the cloud when the local model is not installed. */
+    cloud?: CloudHearing | undefined;
+    /**
+     * The language spoken (BCP 47: "en", "pt-BR"). Local recognition covers
+     * Parakeet's 25 languages; another one fails before anything is
+     * downloaded. Left out, Parakeet tells its languages apart itself.
+     */
+    lang?: string;
+    /**
+     * Only this stretch of the file (seconds), heard on its own: the words'
+     * times stay in the file's seconds.
+     */
+    stretch?: Stretch;
+    /** The module the decoder imports in sherpa-onnx-node's place (a stand-in, in tests). */
+    decoder?: string;
+}
+export interface Transcript {
+    /** Word times in seconds, punctuation kept on its word (the `.words.json` format). */
+    words: Word[];
+    /** Seconds of audio heard. */
+    duration: number;
+    /** The model that heard it. */
+    model: string;
+    /**
+     * Whether the recognizer gave each token's probability, so that every
+     * word has a `confidence`; false when the runtime gives none.
+     */
+    confidence: boolean;
+    /** The stretch heard, seconds of the file, when one was asked for. */
+    stretch?: Stretch;
+}
+/** The words spoken in an audio or video file, with their times. */
+export declare function transcribe(file: string, opts?: TranscribeOptions): Promise<Transcript>;
+//# sourceMappingURL=transcribe.d.ts.map

package/dist/node_modules/@allyhub/media/dist/asr/words.d.ts

@@ -0,0 +1,7 @@
+import type { Word } from "@allyhub/formats";
+import type { Window } from "./windows.js";
+/** The words of decoded windows, in seconds from the start of the audio. */
+export declare function windowsToWords(windows: readonly Window[]): Word[];
+/** Words that are only punctuation, joined to their neighbour. */
+export declare function attachPunctuation<W extends Word>(words: readonly W[]): W[];
+//# sourceMappingURL=words.d.ts.map

package/dist/node_modules/@allyhub/media/dist/cache.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{mkdir as m,readFile as p,stat as v}from"node:fs/promises";import{join as o,resolve as y}from"node:path";import w from"write-file-atomic";import{CACHE_DIR as O}from"@allyhub/formats";import{cacheHome as M,sha256Of as S}from"@allyhub/runtimes";export const INDEX_DIR=`${O}/index`;export function indexDir(t){return t===void 0?o(M(),"index"):o(t,INDEX_DIR)}const h=new Map,l="hashes.json";function x(t){let e=h.get(t);return e||(e=p(o(t,l),"utf8").then(n=>new Map(Object.entries(JSON.parse(n))),()=>new Map),h.set(t,e)),e}async function N(t,e){await m(t,{recursive:!0}),await w(o(t,l),JSON.stringify(Object.fromEntries(e)))}export async function contentHash(t,e){const n=y(t),i=await v(n),c=indexDir(e),r=await x(c),s=r.get(n);if(s?.size===i.size&&s.mtimeMs===i.mtimeMs)return s.sha256;const a=await S(n);return r.set(n,{size:i.size,mtimeMs:i.mtimeMs,sha256:a}),await N(c,r).catch(()=>{}),a}export async function entryDir(t,e){return o(indexDir(e),await contentHash(t,e))}export async function cached(t,e,n,i,c){const r=await entryDir(t,i.root),s=o(r,`${e}.json`),a=JSON.stringify(n.options??null);if(i.fresh!==!0)try{const f=JSON.parse(await p(s,"utf8"));if(f.version===n.version&&f.options===a)return f.value}catch{}const u=await c();await m(r,{recursive:!0});const d={version:n.version,options:a,value:u};return await w(s,JSON.stringify(d)),u}

package/dist/node_modules/@allyhub/media/dist/ocr/text.js

@@ -0,0 +1,4 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{spawn as k}from"node:child_process";import{mkdtemp as R,rm as S,writeFile as N}from"node:fs/promises";import{tmpdir as _}from"node:os";import{join as w}from"node:path";import{workerCommand as v}from"@allyhub/runtimes/node";import{cached as I}from"../cache.js";import{MediaError as M,oneLine as A,stopped as O}from"../errors.js";import{mapLimit as F}from"../run.js";import{frameAt as L,probeVideo as T}from"../video.js";import{workerEnv as $}from"../worker-process.js";import{linesOf as D,OCR_CONFIDENCE_DEFAULTS as x}from"./lines.js";import{ensureOcr as J,ensureOcrEngine as P,OCR_ENGINE as E,OCR_JOB as W,OCR_LINE as y}from"./tesseract.js";const b=720;export function sampleTimes(o,n,g=[]){const c=1/n,r=[];for(let e=c/2;e<o;e+=c)r.push(e);for(const e of g)e>=0&&e<o&&r.push(e);r.sort((e,t)=>e-t);const m=[];for(const e of r){const t=m[m.length-1];(t===void 0||e-t>=.1)&&m.push(Math.round(e*1e3)/1e3)}return m}function B(o,n){const{command:g,args:c}=v(import.meta.url,"worker"),r=new Array(o.files.length);return new Promise((m,e)=>{const t=k(g,c,{env:$({[W]:JSON.stringify(o)}),stdio:["ignore","pipe","pipe"],...n.signal?{signal:n.signal}:{}});let d="",a="",p=0;t.stdout.on("data",i=>{d+=i.toString();const f=d.split(`
+`);d=f.pop()??"";for(const l of f){if(!l.startsWith(y))continue;const s=JSON.parse(l.slice(y.length));r[s.i]=s.read,p++,n.onProgress?.({step:"decode",message:"Reading on-screen text",done:p,total:o.files.length,unit:"frames"})}}),t.stderr.on("data",i=>{a=(a+i.toString()).slice(-4e3)}),t.on("error",i=>{e(O(i,n.signal))}),t.on("close",i=>{if(n.signal?.aborted){e(O(new Error("stopped"),n.signal));return}const f=r.findIndex(s=>s===void 0);if(i===0&&f<0){m(r.map(s=>s??[]));return}const l=/OCR failed: (.*)/.exec(a)?.[1]??a.trim().split(`
+`).pop();e(new M("decode",`OCR stopped${i===0?"":` (exit code ${String(i)})`}: ${A(l??"no reason given",300)}`,{hint:"Run it again; if it keeps failing, measure without on-screen text."}))})})}export async function screenText(o,n={}){const g=n.rate??2,c=await T(o,n),r=sampleTimes(c.duration,g,n.extra),m={word:n.confidence?.word??x.word,short:n.confidence?.short??x.short},e=await I(o,"text",{version:3,options:{engine:E,times:r}},n,async()=>{const t=await J(n),d=await P(n),a=Math.min(b,c.width),p=Math.round(a*c.height/c.width/2)*2,i=await R(w(_(),"allyhub-ocr-"));try{const f=await F(r,4,async(s,u)=>{const C=await L(o,s,{width:a,format:"png",runtimes:n.runtimes,signal:n.signal}),h=w(i,`${String(u).padStart(5,"0")}.png`);return await N(h,C),h}),l=await B({files:f,workers:n.workers??2,langPath:t,engine:d},n);return{engine:E,width:a,height:p,frames:r.map((s,u)=>({t:s,read:l[u]??[]}))}}finally{await S(i,{recursive:!0,force:!0})}});return{engine:e.engine,confidence:m,frames:e.frames.map(t=>{const{lines:d,low:a}=D(t.read,e.width,e.height,m);return{t:t.t,lines:d,...n.all===!0?{low:a}:{}}})}}

package/dist/node_modules/@allyhub/media/dist/sheet.d.ts

@@ -0,0 +1,67 @@
+import type { Word } from "@allyhub/formats";
+import type { ToolOptions } from "./tools.js";
+/** Draws an HTML page `width` pixels wide, as tall as its content, as a picture (the CLI's: a WebP to look at). */
+export type DrawHtml = (html: string, width: number) => Promise<Buffer>;
+export interface SheetCell {
+    /** JPEG or PNG bytes. */
+    image: Buffer;
+    /** Over the picture: time, and what the moment is. */
+    label: string;
+    /** Under the picture: the words said. */
+    text?: string;
+}
+export interface SheetRow {
+    /** A heading for the row, at its left (side-by-side sheets). */
+    title?: string;
+    cells: SheetCell[];
+}
+export interface SheetLayout {
+    title?: string;
+    rows: SheetRow[];
+    /** Columns of pictures per row. */
+    cols: number;
+    /** The page's width in pixels. */
+    width: number;
+    /** Width / height of a picture. */
+    aspect: number;
+    /** Width of the row titles' column; 0 for none. */
+    titleWidth?: number;
+}
+/** A tile's width on a sheet: what its pictures need be drawn at, px. */
+export declare function sheetTile(o: Pick<SheetLayout, "width" | "cols" | "titleWidth">): number;
+/** The sheet as a self-contained HTML page. */
+export declare function sheetHtml(o: SheetLayout): string;
+/** The words that start in [from, to), joined. */
+export declare function wordsBetween(words: readonly Word[], from: number, to: number): string;
+export interface ContactSheetOptions extends ToolOptions {
+    /** The words said, to write under each frame. */
+    words?: readonly Word[];
+    /** Seconds between frames; default about 2, so a minute gives 30. */
+    step?: number;
+    /** Frames per sheet; default 30. */
+    perSheet?: number;
+    /** Columns; default 6 for a tall video, 5 for a square, 4 for a wide one. */
+    cols?: number;
+    /** Page width in pixels; default 1600. */
+    width?: number;
+    /** What a moment is, after its time in the label (a section's role). */
+    labelOf?: (t: number) => string | undefined;
+    title?: string;
+    draw: DrawHtml;
+}
+export interface ContactSheet {
+    /** As the drawer made it. */
+    picture: Buffer;
+    /** The moments on the sheet, and the words under each. */
+    tiles: {
+        t: number;
+        said: string;
+    }[];
+}
+/** "12.5 s". */
+export declare const secondsLabel: (t: number) => string;
+/** Default step: about 2 s, more for long videos so they fit in a few sheets. */
+export declare function defaultStep(duration: number): number;
+/** Contact sheets of a video: frames every `step` seconds with the words said around each. */
+export declare function contactSheets(file: string, opts: ContactSheetOptions): Promise<ContactSheet[]>;
+//# sourceMappingURL=sheet.d.ts.map