allyhub 0.7.0 → 0.8.0

package/dist/node_modules/@allyhub/runtime/dist/player/player.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{decodeKey as J,decodings as Le,MASTER_DEFAULTS as Ne,previewMaster as Oe,renderMix as Be}from"@allyhub/audio";import{partOnScreen as De,subtitleCues as Ue}from"@allyhub/video-core";import{realNow as R,realRaf as Me,realTimeout as Ie}from"../guards.js";import{mixPlan as Ke}from"../mix-plan.js";export const RESUME_WAIT_MS=400;const le=r=>`${String(Math.floor(r/60))}:${String(Math.floor(r%60)).padStart(2,"0")}`;export async function startPlayer(r){const{output:k,stage:d}=r,s=k.timeline,f=s.fps,B=s.duration,M=B-1/f,a=new AudioContext,Q=r.media??{},Se=r.seed??"",V=Ke(s,Q,{seed:Se}),Y=async e=>{if(e)try{const t=await fetch(e);return t.ok?await a.decodeAudioData(await t.arrayBuffer()):void 0}catch{return}},$e=(e,t)=>{const n=Q[e]?.denoisedUrl,i=[...t.denoise?[`db=${t.denoise.toFixed(2)}`]:[],...t.speed===void 0?[]:[`speed=${t.speed.toFixed(6)}`],...t.filter===void 0?[]:[`filter=${encodeURIComponent(t.filter)}`]];return n===void 0||i.length===0?void 0:`${n}?${i.join("&")}`},ee=new Map,D=new Map,te=[],ce=Le(V);for(const{file:e,how:t}of ce){const n=$e(e,t);if(n){const i=await Y(`${n}&wait=0`);i?D.set(J(e,t),i):te.push({key:J(e,t),url:n})}}for(const{file:e,how:t}of ce)ee.has(e)||D.has(J(e,t))||ee.set(e,await Y(Q[e]?.url));const de=e=>{const t=e.getChannelData(0);return[t,e.numberOfChannels>1?e.getChannelData(1):t]},Ae=(e,t)=>{const n=D.get(J(e,t));if(n)return{src:de(n),made:t};const i=ee.get(e);return i?{src:de(i),made:{}}:void 0},Ce=s.audio.master??{...Ne};let S;const ue=()=>{const e=Oe(Be(V,Ae,a.sampleRate),a.sampleRate,Ce);if(!e){S=void 0;return}const[t,n]=e,i=a.createBuffer(2,Math.max(1,t.length),a.sampleRate);i.getChannelData(0).set(t),i.getChannelData(1).set(n),S=i};ue();const $=Ue({lines:k.lines(),fps:s.fps},k.captionOptions()??void 0);let l=!1,x=Math.min(Math.max(r.start??s.parts[0]?.still??0,0),M),b=0,U=0,I=0,F=0,K=[],ne=[],A=!1,H={ctx:0,real:0};const u=()=>l?A?b+(a.currentTime-U):b+(R()-I)/1e3:x,Ee=()=>{if(!A)return;const e=R();if(a.currentTime!==H.ctx)H={ctx:a.currentTime,real:e};else if(e-H.real>300){const t=u();A=!1,b=t,I=e}},pe=r.chrome!==!1,L="#141210",C="#ece6da",Te="#a39a8b",fe='ui-monospace,"SF Mono",Menlo,monospace';document.documentElement.style.background=L,document.body.style.cssText=`margin:0;background:${L};overflow:hidden;font:13px/1 system-ui,-apple-system,"PingFang SC","Noto Sans SC",sans-serif;color:${C}`;const g=document.createElement("div");g.style.cssText=`position:fixed;left:0;right:0;top:0;bottom:${pe?"48px":"0"};overflow:hidden;cursor:pointer`,d.parentElement?.insertBefore(g,d),g.append(d),d.style.position="absolute",d.style.transformOrigin="0 0";const N=document.createElement("div");N.style.cssText=`position:fixed;left:0;right:0;bottom:0;height:48px;display:flex;align-items:center;gap:12px;padding:0 10px;background:${L};border-top:1px solid #2a2622`;const E=document.createElement("button");E.style.cssText=`width:32px;height:32px;border:0;border-radius:4px;background:${C};color:${L};cursor:pointer;display:flex;align-items:center;justify-content:center;flex:none`,E.setAttribute("aria-label","play");const c=document.createElement("input");c.type="range",c.min="0",c.max=String(Math.round(B*f)),c.step="1",c.style.cssText=`flex:1;min-width:0;accent-color:${C};cursor:pointer`;const se=document.createElement("span");se.style.cssText=`font:12px/1 ${fe};font-variant-numeric:tabular-nums;min-width:86px;text-align:right;color:${Te}`;const ge=`height:28px;padding:0 9px;border:1px solid #3a352e;border-radius:4px;background:transparent;color:${C};font:12px/1 ${fe};cursor:pointer;flex:none`,v=document.createElement("button");v.textContent="CC",v.style.cssText=ge,v.setAttribute("aria-label","captions"),v.setAttribute("aria-pressed","false");const m=document.createElement("button");m.textContent="Pages",m.style.cssText=ge,m.setAttribute("aria-label","page by page"),m.setAttribute("aria-pressed","false"),N.setAttribute("role","toolbar"),c.setAttribute("aria-label","seek"),N.append(E,c,se,m),$.length&&N.append(v),pe&&document.body.append(N);const Pe=()=>{const e=Math.min(g.clientWidth/s.width,g.clientHeight/s.height);d.style.transform=`scale(${String(e)})`,d.style.left=`${String((g.clientWidth-s.width*e)/2)}px`,d.style.top=`${String((g.clientHeight-s.height*e)/2)}px`},W=s.width,_=s.height,j=Math.min(W,_)/1080,T=document.createElement("div");T.style.cssText=`position:absolute;left:0;top:0;width:${String(W)}px;height:${String(_)}px;transform-origin:0 0;pointer-events:none`;const h=document.createElement("div");h.setAttribute("role","status"),h.setAttribute("aria-live","polite"),h.style.cssText=`position:absolute;left:50%;transform:translateX(-50%);bottom:${String((_>W?.2:.08)*_)}px;max-width:${String(W*.84)}px;padding:${String(10*j)}px ${String(22*j)}px;border-radius:${String(12*j)}px;background:rgba(0,0,0,.66);color:#fff;font:600 ${String(44*j)}px/1.3 system-ui,-apple-system,"PingFang SC","Noto Sans SC",sans-serif;text-align:center;display:none`,T.append(h),g.append(T);let w=!1;const me=e=>{const t=w?$.find(n=>e>=n.start&&e<n.end):void 0;t?(h.textContent!==t.text&&(h.textContent=t.text),h.style.display="block"):h.style.display="none"},he=()=>{Pe(),T.style.transform=d.style.transform,T.style.left=d.style.left,T.style.top=d.style.top};new ResizeObserver(he).observe(g),he();let p=k.kind==="slides"?"page":"play",o=0,y;const q=e=>Math.max(0,s.parts.findIndex(t=>e>=t.start&&e<t.end));p==="page"&&(o=q(x),m.setAttribute("aria-pressed","true"),m.textContent="Play all");let ie=-1,ye=0,xe=0;const Re=e=>De(s.parts,s.transitions,e,f),z=async(e,t=!1)=>{const n=Math.min(Math.floor(e*f+1e-9),Math.round(M*f));(n!==ie||t)&&(ie=n,await k.seek(n/f),c.value=String(n),c.setAttribute("aria-valuetext",le(e)),se.textContent=`${le(e)} / ${le(B)}`),me(e);const i=R();(t||i-xe>250)&&(xe=i,r.post?.({type:"time",t:e,part:Re(e),playing:l,mode:p}))},be={play:'<svg width="12" height="14" viewBox="0 0 12 14" aria-hidden="true"><path d="M1 1.2v11.6a.6.6 0 0 0 .9.5l9.6-5.8a.6.6 0 0 0 0-1L1.9.7a.6.6 0 0 0-.9.5Z" fill="currentColor"/></svg>',pause:'<svg width="12" height="14" viewBox="0 0 12 14" aria-hidden="true"><rect x="1" y="1" width="3.5" height="12" rx=".6" fill="currentColor"/><rect x="7.5" y="1" width="3.5" height="12" rx=".6" fill="currentColor"/></svg>'},ae=()=>{E.innerHTML=l?be.pause:be.play,E.setAttribute("aria-label",l?"pause":"play")},ve=()=>{for(const e of K)try{e.stop()}catch{}K=[];for(const e of ne)e.disconnect();ne=[]},Fe=e=>U+Math.max(0,e-b);function we(){if(!S||b>=S.duration)return;const e=a.createGain();e.connect(a.destination),ne.push(e);const t=a.createBufferSource();t.buffer=S,t.connect(e),K.push(t),t.start(Fe(b),b)}function P(e=u()){F++,l=!1,k.setPlaying(!1),x=Math.min(Math.max(e,0),M),ve(),ae(),z(x,!0)}async function oe(){const e=++F;if(x>=M&&(x=0),await Promise.race([a.resume().catch(()=>{}),new Promise(n=>{Ie(n,RESUME_WAIT_MS)})]),e!==F)return;b=x,U=a.currentTime+.05,I=R()+50,A=S!==void 0&&a.state==="running",!A&&$.length&&!X&&Z(!0),H={ctx:a.currentTime,real:R()},l=!0,k.setPlaying(!0),ae(),we();const t=()=>{if(ye++,!l||e!==F)return;Ee();const n=u();if(n>=M){P(M);return}if(y!==void 0&&n>=y){const i=s.parts[o]?.still??y;y=void 0,P(i);return}z(n),Me(t)};Me(t)}function G(e){const t=l;y=void 0,P(e),t&&oe()}let X=!1;function Z(e){w=e&&$.length>0,v.setAttribute("aria-pressed",String(w)),v.style.background=w?C:"transparent",v.style.color=w?L:C,me(u())}function ke(e){p=e,m.setAttribute("aria-pressed",String(e==="page")),m.textContent=e==="page"?"Play all":"Pages",y=void 0,e==="page"?O(q(u())):z(u(),!0)}function O(e){o=Math.min(Math.max(e,0),s.parts.length-1),y=void 0,P(s.parts[o]?.still??0)}function re(){if(l){y=void 0,P();return}if(p==="page"){const e=s.parts[o];e&&(x=e.start,y=e.end-1/f)}oe()}return E.addEventListener("click",e=>{e.stopPropagation(),re()}),g.addEventListener("click",re),c.addEventListener("input",()=>{G(Number(c.value)/f),p==="page"&&(o=q(Number(c.value)/f))}),v.addEventListener("click",e=>{e.stopPropagation(),X=!0,Z(!w)}),m.addEventListener("click",e=>{e.stopPropagation(),ke(p==="page"?"play":"page")}),addEventListener("keydown",e=>{if(!(e.metaKey||e.ctrlKey||e.altKey)){if(e.key===" "||e.key==="k")re();else if(e.key==="ArrowRight")p==="page"?O(o+1):G(u()+5);else if(e.key==="ArrowLeft")p==="page"?O(o-1):G(u()-5);else if(e.key==="c"&&$.length)X=!0,Z(!w);else if(e.key==="f")document.fullscreenElement?document.exitFullscreen():document.documentElement.requestFullscreen().catch(()=>{});else return;e.preventDefault()}}),ae(),await z(x,!0),r.post?.({type:"ready",duration:B,parts:s.parts}),te.length>0&&(r.post?.({type:"sound",denoising:!0}),Promise.all(te.map(async({key:e,url:t})=>{const n=await Y(t);if(!n||(D.set(e,n),ue(),!l))return;const i=u();ve(),b=i,U=a.currentTime,I=R(),we()})).then(()=>{r.post?.({type:"sound",denoising:!1})})),{command(e){if(e.type==="play"){if(!l){if(p==="page"){const t=s.parts[o];t&&(y=t.end-1/f)}oe()}}else e.type==="pause"?P():e.type==="seek"&&Number.isFinite(e.t)?(G(e.t),p==="page"&&(o=q(e.t))):e.type==="mode"?ke(e.mode):e.type==="next"?O(o+1):e.type==="prev"?O(o-1):e.type==="captions"&&(X=!0,Z(e.on))},now:u,state:()=>({playing:l,audioClock:A,audio:a.state,t:u(),frame:ie,ticks:ye,generation:F,sounds:K.length,sfx:V.sfx.length,mode:p,page:o,captions:w,caption:h.style.display==="none"?"":h.textContent,cues:$.length})}}

package/dist/node_modules/@allyhub/runtime/dist/reads.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{pathIn as g,asUrlString as l,displayOf as c,fillMessage as f,lineAnchors as m,messageList as A,problem as r,repoPath as u,speakOf as w,textsOf as p,hasMarks as O,withoutMarks as k}from"@allyhub/video-core";import{TEXT_DIR as $}from"@allyhub/formats";const v="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",b=3;export class ReadLog{messages=new Map;media=new Map;data=new Map;keyByText=new Map;missingReads=new Set;missingMedia=new Set;problems=[];texts=new Set;tap;opts;fileOf;constructor(t){this.opts=t,this.fileOf=e=>`${t.text??$}/${e??"en"}.json`}value(t){const{own:e,fallback:i,lang:s,defaultLang:n}=this.opts;return Object.hasOwn(e,t)?{value:e[t],fellBack:!1}:Object.hasOwn(i,t)?{value:i[t],fellBack:s!==n}:{value:void 0,fellBack:!1}}record(t,e,i){if(this.messages.has(t))return;const{value:s,fellBack:n}=this.value(t);if(this.messages.set(t,{key:t,kind:e,fallback:n,...i?{hint:i}:{}}),e!=="list"&&s===void 0){const a=t.slice(t.indexOf(".")+1),h=Object.keys(this.opts.fallback).find(d=>d.endsWith(`.${a}`));this.problems.push(r("AK-S001",`The code reads ${t}, but the default language ${this.opts.defaultLang??"(no messages)"} does not have it. ${h===void 0?`Add it to ${this.fileOf(this.opts.defaultLang)}.`:`It has ${h}: read that, or give the piece the id "${t.slice(0,t.indexOf("."))}".`}`,{where:{file:this.fileOf(this.opts.defaultLang)}}))}}locale(t){return Object.hasOwn(this.opts.own,t)?this.opts.lang:this.opts.defaultLang}text(t,e,i){this.record(t,"text",e);const{value:s}=this.value(t);this.tap?.(`m:${t}`,JSON.stringify(s??null));for(const n of p(s))this.texts.add(n);return c(s,i,this.locale(t))??""}s(t,e){const i=this.text(t,e,{});return i&&this.keyByText.set(i,{key:t,inputs:{}}),i}with(t,e,i){const s=f(this.text(t,i,e),e);return this.texts.add(s),s&&this.keyByText.set(s,{key:t,inputs:e}),s}spokenOf(t){const e=this.keyByText.get(t);if(!e)return;const i=w(this.value(e.key).value,e.inputs,this.locale(e.key)),s=(Object.hasOwn(this.opts.own,e.key)?this.opts.anchors?.own:this.opts.anchors?.fallback)?.[e.key];return{key:e.key,speak:i===void 0?t:f(i,e.inputs),...s&&i!==void 0?{anchors:m(i,s,n=>f(n,e.inputs))}:{}}}list(t,e){const i=[],s=new Set([...Object.keys(this.opts.own),...Object.keys(this.opts.fallback)]),n=A(a=>c(this.value(a).value,{},this.locale(a)),s,t,i);this.record(t,"list",e),i.length===0&&this.problems.push(r("AK-S001",`The code reads the list ${t}, but the default language has no keys like ${t}.0, ${t}.1. Add them to ${this.fileOf(this.opts.defaultLang)}.`,{where:{file:this.fileOf(this.opts.defaultLang)}}));for(const a of i)this.text(a,void 0,{});return n}keysUnder(t){const e=`${t}.`;return[...new Set([...Object.keys(this.opts.own),...Object.keys(this.opts.fallback)])].filter(i=>i.startsWith(e))}peek(t){return this.value(t).value}touch(t){const{value:e,fellBack:i}=this.value(t);return this.tap?.(`m:${t}`,JSON.stringify(e??null)),e!==void 0&&!this.messages.has(t)&&this.messages.set(t,{key:t,kind:"text",fallback:i}),e}mediaAt(t){const e=this.opts.media[t];return e&&this.media.set(t,l(e)),this.tap?.(`f:${t}`,e?.sha256??""),e}missing(t){this.missingReads.add(t)}report(t){this.problems.some(e=>e.code===t.code&&e.message===t.message)||this.problems.push(t)}relativeTo(t){this.base=t}base;get pathBase(){return this.base??this.opts.file}baseOf(t){return t===void 0?this.pathBase:t===""?"the project's root":t}resolve(t,e){return e===void 0?u(this.pathBase,t):g(e,t)}asset(t,e){const i=this.baseOf(e),s=this.resolve(t,e),n=s===void 0?void 0:this.mediaAt(s);if(n)return n;const a=s??t;return this.missingMedia.has(a)||(this.missingMedia.add(a),this.problems.push(r("AK-A001",s===void 0?`"${t}" points outside the project. Put media in the project, with a path relative to ${i}.`:`"${t}" (named in ${i}) cannot find ${s}: the path is wrong, or the file is not in the project yet.`,{where:{file:i}}))),l({path:s??t,sha256:"",kind:"image",url:v,width:1,height:1})}optionalAsset(t){const e=u(this.pathBase,t);if(e===void 0)return;const i=this.mediaAt(e);return i||this.missing(e),i?l(i):void 0}optionalData(t,e){const i=this.resolve(t,e);if(i===void 0)return{found:!1};const s=this.opts.data?.[i];return this.data.set(i,s?.sha256??""),s?s.error===void 0?{full:i,found:!0,value:s.value}:{full:i,found:!0,error:s.error}:{full:i,found:!1}}readData(t){const e=u(this.pathBase,t),i=e===void 0?void 0:this.opts.data?.[e];if(e!==void 0&&i){if(this.data.set(e,i.sha256),this.tap?.(`d:${e}`,i.sha256),i.error===void 0)return i.value;this.missingMedia.has(e)||(this.missingMedia.add(e),this.problems.push(r("AK-R001",`Cannot read the data file ${e}: ${i.error}`,{where:{file:e}})));return}this.missingMedia.has(t)||(this.missingMedia.add(t),this.problems.push(r("AK-A001",e===void 0?`ctx.data("${t}") points outside the project. Put data files in the project, with a path relative to ${this.pathBase}.`:`ctx.data("${t}") cannot find ${e}: the path is wrong, or the file is not CSV, YAML or JSON.`,{where:{file:this.pathBase}})))}reads(t,e){const i=s=>{if(!s.startsWith(`${t}.`))return;const n=s.slice(t.length+1).split(".")[0]??"";return e.includes(n)?n:void 0};return{messages:[...this.messages.values()].map(s=>{const n=i(s.key);return n===void 0?s:{...s,part:n}}).sort((s,n)=>s.key<n.key?-1:s.key>n.key?1:0),media:[...[...this.media.values()].map(s=>({path:s.path,sha256:s.sha256,kind:s.kind})),...[...this.missingReads].filter(s=>!this.media.has(s)).map(s=>({path:s,sha256:"",kind:"audio"}))].sort((s,n)=>s.path<n.path?-1:1),data:[...this.data.entries()].map(([s,n])=>({path:s,sha256:n})).sort((s,n)=>s.path<n.path?-1:1)}}translationProblems(){const t=[];for(const e of this.messages.values())e.fallback&&e.kind==="text"&&t.push(r("AK-S002",`${this.opts.lang??""} is missing a translation: ${e.key}. The ${this.opts.defaultLang??""} text was used.`,{where:{file:this.fileOf(this.opts.lang)}}));return t}keysShowing(t){const e=h=>h.replace(/[\s\p{Cf}]+/gu,""),i=e(t);if(i==="")return[];const s=[],n=[];for(const h of this.messages.values()){const d=p(this.peek(h.key)).flatMap(o=>O(o)?[o,k(o)]:[o]).map(e);d.includes(i)?s.push(h.key):d.some(o=>o.includes(i))&&n.push(h.key)}return s.length>0?s:(i.match(/[\p{L}\p{N}]/gu)?.length??0)>=b?n:[]}get file(){return this.fileOf(this.opts.lang)}}

package/dist/node_modules/@allyhub/runtime/dist/sound.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{resolveMaster as j,resolveMix as I}from"@allyhub/audio";import{BUILTIN_SFX as P,isBuiltinSfx as y,problem as x,toFrame as M}from"@allyhub/video-core";import{voicePlan as B}from"./mix-plan.js";const b=u=>Math.round(u*1e6)/1e6;export function soundPlanner(u,O){const{source:p,log:w,ledger:m}=u,{look:k,fps:$,options:r,dims:S}=O,c=[],l=[],h=[],T=(t,o,d)=>{const i=t.sound;let n,s;if(typeof i=="string"){s=i;const f=k.sfx[i];if(f!==void 0){const e=f.replace(/^\.\//,"");if(n=w.mediaAt(e),!n){w.missing(e),m.problems.push(x("AK-A001",`The look's sound "${i}" is ${e}, which is not in the project. Put the file there, or change look.sfx in allyhub.config.ts.`,{part:o,where:{file:p.file}}));return}}else{if(y(i))return{sound:i};if(/[./]/.test(i))n=u.mediaOf(i,d);else{const e=[...P,...Object.keys(k.sfx)];m.problems.push(x("AK-A001",`The sound "${i}" in part ${o} is not one of the look's sounds (${[...new Set(e)].join(", ")}) and not a file. Name one of them, give a file ("./sfx/${i}.wav" or an import), or add it to look.sfx in allyhub.config.ts.`,{part:o,where:{file:p.file}}));return}}}else n=u.mediaOf(i,d),s=n.path.split("/").pop()??n.path;if(n.sha256!==""){if(n.kind!=="audio"&&!(n.kind==="video"&&n.audio)){m.problems.push(x("AK-A003",`The sound ${n.path} in part ${o} is not audio. Give an audio file (wav, mp3, m4a…) or a video with sound.`,{part:o,where:{file:p.file}}));return}return{sound:s,file:n.path}}};return{addSpeech(t,o){l.push(...t),h.push(...o)},sfx(t,o,d){const i=o.end-o.start;for(const n of t.sounds??[]){const s=T(n,t.key,t.base);if(!s)continue;const f=Math.min(Math.max(d(n.at),0),i);c.push({t:M(o.start+f,$),sound:s.sound,part:o.key,...n.what===void 0?{}:{what:n.what},...s.file===void 0?{}:{file:s.file},...n.gainDb===void 0||n.gainDb===0?{}:{gainDb:n.gainDb},...n.shape?{shape:n.shape}:{}})}},carry(t,o,d,i,n,s){const f=e=>{const a=Math.max(e.at,o),g=Math.min(e.at+e.dur,d);if(g-a<.005)return;const{fadeIn:v,fadeOut:A,...D}=e;return delete D.tone,{...D,part:n,at:b(i+a-o),from:b(e.from+(a-e.at)*(e.speed??1)),dur:b(g-a),...e.gainDb!==void 0||s!==0?{gainDb:(e.gainDb??0)+s}:{},...v!==void 0&&a===e.at?{fadeIn:v}:{},...A!==void 0&&g===e.at+e.dur?{fadeOut:A}:{}}};for(const e of t.timeline.audio.speech??[]){const a=f(e);a&&l.push(a)}for(const e of t.timeline.audio.room??[]){const a=f(e);a&&h.push(a)}for(const e of t.timeline.cues)e.t<o-1e-6||e.t>=d-1e-6||c.push({...e,t:M(i+e.t-o,$),part:n,...e.gainDb!==void 0||s!==0?{gainDb:(e.gainDb??0)+s}:{}})},cues:()=>[...c].sort((t,o)=>t.t-o.t),audio(t,o){const d=S.profile;return{...l.length>0?{speech:l}:{},...h.length>0?{room:h}:{},...t?{music:t}:{},...r.mix?{mix:I(r.mix)}:{},master:j(r.master,d?.loudness),...B(r.mic,o)}}}}

package/dist/node_modules/@allyhub/runtime/dist/speech.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{applyEdits as q,DEFAULT_VOICE_TOOL as J,editedLength as Y,envelopeFrames as H,estimateSpeech as W,parseEditList as Q,speechPads as X,joinWords as Z,LINE_FOUND as j,mediaByStem as ee,nearestPhrases as C,normText as O,problem as c,sayStem as te,removedWords as ne,WordStream as se,WordView as G}from"@allyhub/video-core";export const SAYING_MARGIN=.1;function U(e){return e.envelope===void 0?void 0:H(e.envelope)}function D(e,n,r,h){const u=n[r]??{text:"",start:0,end:0},$=n[h]??u,w=u.start,f=Math.max(.05,$.end-u.start),i=g=>Math.round(g*1e3)/1e3;return{from:i(w),dur:i(f),...X(n,r,h,e.duration,U(e)),words:n.slice(r,h+1).map(g=>({text:g.text,start:i(g.start-w),end:i(g.end-w)}))}}const F=e=>e.map(n=>`"${n}"`).join(", ");export function resolveSpeech(e,n,r,h){const u=ie(e,n,r,h),$=e.tempo??1;return $===1?u:atSpeed(u,$)}const E=e=>Math.round(e*1e3)/1e3;export function atSpeed(e,n){const r=e.speech;return{...e,...e.estimate===void 0?{}:{estimate:e.estimate/n},...r?{speech:{...r,dur:E(r.dur/n),padIn:r.padIn/n,padOut:r.padOut/n,words:r.words.map(h=>({...h,start:E(h.start/n),end:E(h.end/n)})),speed:n}}:{}}}function ie(e,n,r,h){const u={part:n,where:{file:r.file}};if(e.kind==="say"){const s=r.log.spokenOf(e.text),t=s?.speak??e.text,o=e.tool??J,a=te({text:t,voice:e.voice,tool:o,params:e.params}),l=ee(r.media,a),d={shown:e.text,...s?{speechKey:s.key}:{},...s?.anchors?{anchors:s.anchors}:{}},p={part:n,text:t,...e.voice===void 0?{}:{voice:e.voice},tool:o,...e.params===void 0?{}:{params:e.params},stem:a,...l?{file:l.path}:{}};if(!l)return r.log.missing(a),h.push(c("AK-T002",`Part ${n} says "${t.length>80?`${t.slice(0,80)}…`:t}" with ${o}${e.voice===void 0?"":` (voice ${e.voice})`}, and there is no file for it yet (${a}.*). Run allyhub voice in the project: it makes one file per say, after you tell the person the price. A changed text, voice, tool or params needs a new file.`,u)),{estimate:W(t),say:p,script:t,...d};const y=r.log.mediaAt(l.path)??l,k=y.words??[];return k.length===0?(h.push(c("AK-T001",`The say file ${y.path} of part ${n} has no word times beside it. Make it again with allyhub voice, or write them with allyhub words ${y.path}.`,u)),{estimate:y.duration??W(t),say:p,script:t,...d}):{speech:{media:y,...D(y,k,0,k.length-1),script:t,...d},say:p,...d}}const $=e.line===void 0?void 0:r.log.spokenOf(e.line),w=e.line===void 0?{}:{shown:e.line,...$?{speechKey:$.key}:{},...$?.anchors?{anchors:$.anchors}:{}},f=e.line===void 0?void 0:$?.speak??e.line,i=r.mediaOf(e.file,e.fileBase),g=()=>({estimate:f!==void 0?W(f):i.duration??4,...f===void 0?{}:{script:f},...w});if(i.sha256==="")return g();if(i.kind!=="audio"&&i.kind!=="video")return h.push(c("AK-A003",`The take ${i.path} of part ${n} is not audio or video.`,u)),g();const P=i.gen?.input?.text;f!==void 0&&typeof P=="string"&&!O(P).includes(O(f))&&h.push(c("AK-T007",`Part ${n} says "${f.length>80?`${f.slice(0,80)}…`:f}", but its voice ${i.path} was made from other words (its record ${i.gen?.record??""} has the text). Make the voice again from the lines as they are now, or change the line back; a word the voice was given in another spelling is written <shown|said> in the line.`,u));const m=i.words??[];if(m.length===0)return h.push(c("AK-T001",`The take ${i.path} of part ${n} has no word times beside it (${i.path.replace(/\.[^./]+$/,"")}.words.json). Run allyhub words ${i.path} to write them.`,u)),g();let M,I;if(e.editsFile!==void 0){const s=r.log.optionalData(e.editsFile,e.editsBase),t=s.full??e.editsFile;if(s.found&&(I=t),!s.found)h.push(c("AK-T005",`The edits file ${t} of part ${n} is not there (named "${e.editsFile}" in ${r.log.baseOf(e.editsBase)}), so its take would play uncut. Write it (the preview's transcript writes it at the first word struck; { "remove": [] } removes nothing), or fix the path: it is relative to the file that names it.`,{part:n,where:{file:r.log.baseOf(e.editsBase)}}));else if(s.error!==void 0)h.push(c("AK-T005",`The edits file ${t} of part ${n} is not valid JSON: ${s.error}`,{part:n,where:{file:t}}));else{const o=Q(s.value);typeof o=="string"?h.push(c("AK-T005",`The edits file ${t} of part ${n} does not match the format: ${o}.`,{part:n,where:{file:t}})):M=o}}const V=new se(m),{cut:T}=ne(m,M,V),x=new G(m,T),R=T.size>0?new G(m):x,S=m.length-1,B=s=>x.index.filter(t=>t>=s).map(t=>m[t]??{text:"",start:0,end:0}),L=(s,t)=>{const o=[];for(let a=s;a<=t;a++){if(!T.has(a))continue;let l=a;for(;l+1<=t&&T.has(l+1);)l++;const d=Z(m.slice(a,l+1));o.push(`#${String(a)}${l>a?`–#${String(l)}`:""} ("${d.length>60?`${d.slice(0,60)}…`:d}")`),a=l}return o},b=(s,t)=>T.size>0?R.span(O(s),t,S):void 0,v=I??"the edits file";let K=0,A=S,N;if(e.from!==void 0){const s=x.span(O(e.from),0,S);if(!s){const t=b(e.from,0),o=C(B(0),e.from);return h.push(t?c("AK-T006",`The range of part ${n} starts at "${e.from}", which ${i.path} says only in words its edits remove: ${L(t.first,t.last).join(", ")}. Start the range at words the cut keeps${o.length?` (nearest: ${F(o)})`:""}, or keep those words in ${v}.`,u):c("AK-T003",`The range of part ${n} starts at "${e.from}", which ${i.path} does not say.${o.length?` Nearest: ${F(o)}.`:""}`,u)),g()}if(K=s.first,A=S,e.to!==void 0){const t=x.span(O(e.to),s.first,S);if(!t){const o=b(e.to,s.first),a=C(B(s.first),e.to);return h.push(o?c("AK-T006",`The range of part ${n} ends at "${e.to}", which ${i.path} says after "${e.from}" only in words its edits remove: ${L(o.first,o.last).join(", ")}. End the range at words the cut keeps${a.length?` (nearest: ${F(a)})`:""}, or keep those words in ${v}.`,u):c("AK-T003",`The range of part ${n} ends at "${e.to}", which ${i.path} does not say after "${e.from}".${a.length?` Nearest: ${F(a)}.`:""}`,u)),g()}A=Math.max(t.last,s.first)}}else if(f!==void 0){const s=r.cursor.get(i.path)??0;let t=x.findLine(f,s),o=s;if((!t||t.score<j)&&s>0){const d=x.findLine(f,0);d&&d.score>=j&&(t=d,o=0)}const a=f.length>80?`${f.slice(0,80)}…`:f,l=d=>`${String(Math.round(d*100))} %`;if(T.size>0){const d=R.findLine(f,o),p=d?L(d.first,d.last):[];d&&d.score>=j&&p.length>0&&d.score-(t?.score??0)>=SAYING_MARGIN&&h.push(c("AK-T006",`Part ${n} is saying "${a}"${$?` (${$.key})`:""}, which ${i.path} says at #${String(d.first)}–#${String(d.last)} (${l(d.score)} of the line), but its edits remove ${p.join(", ")} there. Among the words the cut keeps, ${t?`#${String(t.first)}–#${String(t.last)} match ${l(t.score)} of it`:"it is not found"}. Make the line what the cut keeps, or keep those words in ${v}.`,u))}if(!t||t.score<j)return h.push(c("AK-T003",`Part ${n} is saying "${a}", which ${i.path} does not say${T.size>0?" in the words its edits keep":""}${t?` (the closest stretch, #${String(t.first)}–#${String(t.last)}, matches ${l(t.score)} of it)`:""}. Check that the line and the recording are the same script${$?` (${$.key})`:""}.`,u)),g();K=t.first,A=t.last,N={score:Math.round(t.score*100)/100,from:o}}r.cursor.set(i.path,A+1);const z=e.denoiseDb!==void 0&&e.denoiseDb>0?{denoise:e.denoiseDb}:{},_={span:[K,A],...N?{match:N}:{},...I===void 0?{}:{edits:I}};if(M){const s=q(m,M,K,A,{levels:U(i),fps:r.fps});for(const k of s.lost)h.push(c("AK-T005",`An edit in ${v} removes words ${String(k.from)}–${String(k.to)}${k.text===void 0?"":` ("${k.text}")`}, which ${i.path} no longer says. Remove that edit, or strike the words again in the transcript.`,{part:n,where:{file:v}}));const t=s.kept[0],o=s.kept.at(-1),a=s.ranges[0];if(t===void 0||o===void 0||!a)return h.push(c("AK-T005",`The edits in ${v} remove every word part ${n} says.`,{part:n,where:{file:v}})),g();const l=D(i,m,t,o),d=s.ranges.at(-1)??a,p=a.from>(m[t]?.start??0)+1e-6,y=d.to<(m[o]?.end??0)-1e-6;return{speech:{media:i,...l,...p?{from:a.from,padIn:0}:{},...y?{padOut:0}:{},dur:Math.round(Y(s.ranges)*1e3)/1e3,words:s.words,...s.ranges.length>1?{ranges:s.ranges}:{},..._,...z,...f===void 0?{}:{script:f},...w},...w}}return{speech:{media:i,...D(i,m,K,A),..._,...z,...f===void 0?{}:{script:f},...w},...w}}

package/dist/node_modules/@allyhub/runtime/dist/stage-kit.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{createEnv,Ledger}from"./env.js";export{LoadFailure,codeOf,messageOf}from"./errors.js";export{consoleAt,consoleAtAsync}from"./console.js";export{loadFaces,loadTextFonts,codePoints,namedFamilies,families,localFamily,pageFaces}from"./fonts.js";export{pictureWaiter,watchPictures}from"./pictures.js";export{watchStyles}from"./styles.js";export{textBlocks}from"./inspect.js";export{inkOfBlock}from"./contrast.js";export{domHash}from"./measure.js";export{realTimers}from"./guards.js";

package/dist/node_modules/@allyhub/runtime/dist/stage.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{addLayerRule as L,lookCss as P,problem as $}from"@allyhub/video-core";import{selectorOf as E}from"./inspect.js";import{pictureHint as x,pictureWaiter as A,watchPictures as H}from"./pictures.js";import{rejectedMessage as K,watchStyles as M}from"./styles.js";const p=c=>c.toString(16).padStart(2,"0");export function createStage(c,n){const{options:m,embed:g}=c,f=m.purpose==="check"&&!g,b=f?M():void 0,v=f?H(n):void 0,h=[],R=A(n,t=>{h.some(o=>o.el===t.el&&o.src===t.src)||h.push(t)}),y=new Set,S=t=>!n.contains(t.target)&&!(t.target instanceof HTMLElement&&t.target.dataset.akHolder===""),w=f?new MutationObserver(t=>{for(const o of t)S(o)&&y.add(o.target.nodeName.toLowerCase())}):void 0;let u=!1;const C=t=>{const o=document.createElement("div");o.style.color=t,n.append(o);const i=getComputedStyle(o).color;o.remove();const s=document.createElement("canvas");s.width=1,s.height=1;const a=s.getContext("2d",{willReadFrequently:!0});if(!a)return"#000000";a.fillStyle=i,a.fillRect(0,0,1,1);const[e=0,r=0,d=0,l=255]=a.getImageData(0,0,1,1).data;return`#${p(e)}${p(r)}${p(d)}${l===255?"":p(l)}`},O=()=>{w?.takeRecords().forEach(t=>{S(t)&&y.add(t.target.nodeName.toLowerCase())})};return{el:n,styles:b,picturesDrawn:R,get clear(){return u},async sweep(){await v?.sweep()},cssColor:C,takeOutside:O,dress(t){const{dims:o,look:i}=t;u=m.purpose==="render"&&!g||t.options.transparent===!0,n.replaceChildren(),L(n.ownerDocument),n.dataset.format=t.format,c.lang!==void 0&&(n.lang=c.lang),Object.assign(n.style,{position:"relative",width:`${String(o.width)}px`,height:`${String(o.height)}px`,overflow:"hidden",background:u?"transparent":"var(--ak-color-bg)",color:"var(--ak-color-fg)",fontFamily:"var(--ak-font-body)"});for(const[e,r]of Object.entries(P(i)))n.style.setProperty(e,r);const a=t.options.transparent===!0?"transparent":C("var(--ak-color-bg)");return u&&m.purpose!=="play"&&!g&&(document.documentElement.style.background="transparent",document.body.style.background="transparent"),w?.observe(document.documentElement,{subtree:!0,childList:!0,attributes:!0,characterData:!0}),a},problems(t){O();const o=[...y].map(e=>$("AK-R003",`Piece code changed <${e}> outside the stage. Draw only inside each layer's own element.`)),i=(b?.rejected()??[]).map(e=>{const r=e.el&&n.contains(e.el)?E(e.el,n):void 0;return $("AK-R004",K(e,r?` on ${r}`:""),{part:e.part,...r?{where:{selector:r}}:{}})}),s=v?.broken()??[],a=[...s,...h.filter(e=>!s.some(r=>r.el===e.el&&r.src===e.src))].map(e=>{const r=t.find(k=>k.el.contains(e.el)),d=r?.layers.find(k=>k.el.contains(e.el)),l=n.contains(e.el)?E(e.el,n):void 0,j=d?`${d.spec.component} (layer ${String(d.index+1)}) in part ${r?.part.key??""}`:r?`Part ${r.part.key}`:"The stage",D=e.via==="img"?`<img src="${e.src}">`:`a background image, url("${e.src}")`;return $("AK-A005",`${j} draws a picture that does not load: ${D}. ${x(e.src)}`,{...r?{part:r.part.key}:{},...l?{where:{selector:l}}:{}})});return[...o,...i,...a]},dispose(){w?.disconnect(),n.replaceChildren()}}}

package/dist/node_modules/@allyhub/runtime/dist/takes.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{cutOnFrame as je,envelopeFrames as We,fact as Ee,joinWords as be,matchRoom as Ke,partAnchorList as Oe,problem as re,ROOM_MATCH as Z,roomTone as Le}from"@allyhub/video-core";import{camerasOf as xe,momentIn as ie,videoLayer as Ae}from"./embed.js";import{messageOf as De}from"./errors.js";import{resolveSpeech as _e}from"./speech.js";const W=c=>Math.round(c*1e6)/1e6,qe=c=>Math.round(c*1e3)/1e3,de=c=>c.__allyhubLayer==="footage";export function noTakes(c,E){const{defaults:S}=E;return{results:c.map(()=>({})),says:[],videoTakes:c.map(()=>{}),specs:c,shownBy:new WeakMap,inputs:c.map(l=>{const y=Oe(l.anchors);return{key:l.key,...y.length>0?{placed:y}:{},dur:l.dur??S.dur,lead:l.lead??S.lead,tail:l.tail??S.tail}}),speechFor:()=>({clips:[],room:[]})}}async function Be(c,E,S,l,y){const{source:B,ledger:K}=c,{fps:G}=E,L=l.layers.find(e=>de(e)&&e.file===void 0&&e.video===void 0),P=document.createElement("div"),k={from:0,to:0,part:l.key,start:0,partStart:0},J=xe(L),j=L?.quality?.scale,h=await S.load(y.piece,P,{frame:!0,shown:k,...J?{cameras:J}:{},...j===void 0?{}:{sceneryScale:j}}),v=h.inner.timeline.duration,N=h.inner.words(),Q=e=>je(e,G,N,v);let i=0,f=v;try{i=y.from===void 0?0:ie(h.inner,y.from),f=y.to===void 0?v:ie(h.inner,y.to)}catch(e){K.problems.push(re("AK-T003",`Part ${l.key} plays a stretch of ${h.id}: ${De(e)}`,{part:l.key,where:{file:B.file}}))}i=Q(i),f=Q(f),f-i>=1/G||(K.problems.push(re("AK-T003",`Part ${l.key} plays ${h.id} from ${i.toFixed(3)} s to ${f.toFixed(3)} s, which is no stretch: its end comes after its start, within its ${v.toFixed(3)} s.`,{part:l.key,where:{file:B.file}})),i=0,f=v),k.from=i,k.to=f;const A=[],ee=[],s=e=>{const t=Math.min(e.end,f)-Math.max(e.start,i),a=e.end-e.start;return a<=1e-9?e.start>=i-1e-6&&e.start<f:t>a/2+1e-9||Math.abs(t-a/2)<=1e-9&&e.start>=i-1e-6};for(const e of h.inner.words()){if(e.end<=i||e.start>=f)continue;for(const[a,M]of[["start",i],["end",f]])e.start<M-1e-6&&e.end>M+1e-6&&K.facts.push(Ee("cut-in-word",{piece:B.piece,part:l.key},{source:h.id,side:a,at:W(M),word:e.text,wordStart:W(e.start),wordEnd:W(e.end)}));const t={...e,start:W(Math.max(e.start,i)-i),end:W(Math.min(e.end,f)-i)};A.push(t),s(e)&&ee.push(t)}const o=[];for(const e of h.inner.timeline.parts)for(const t of e.anchors??[])t.at<i-1e-6||t.at>f+1e-6||o.some(a=>a.name===t.name)||o.push({name:t.name,at:W(t.at-i),...t.end===void 0?{}:{end:W(Math.min(t.end,f)-i)}});const n=[];for(const e of h.inner.lines()){const t=e.words.filter(s);if(t.length!==0)if(t.length===e.words.length)n.push({shown:e.shown,spoken:e.spoken});else{const a=be(t);n.push({shown:a,spoken:a})}}return{...h,host:P,from:i,to:f,words:A,captionWords:ee,line:{shown:n.map(e=>e.shown).join(" "),spoken:n.map(e=>e.spoken).join(" ")},anchors:o,shown:k}}export async function findTakes(c,E,S,l){const{source:y,log:B,ledger:K}=c,{fps:G,defaults:L,dims:P}=E,k=[...S],J=new Map,j=k.map(s=>s.speech&&s.speech.kind!=="video"?_e(s.speech,s.key,{log:B,media:y.media,mediaOf:c.mediaOf,file:y.file,cursor:J,fps:G},K.problems):{}),h=j.flatMap(s=>s.say?[s.say]:[]),v=[];for(const s of k){const o=s.speech;v.push(o?.kind==="video"?await Be(c,E,l,s,o):void 0)}for(const[s,o]of v.entries()){const n=v[s+1];if(!o||n?.id!==o.id||Math.abs(n.from-o.to)>1e-6)continue;const e=o.to-o.from;o.anchors=o.anchors.filter(t=>t.at<e-1e-6||!n.anchors.some(a=>a.name===t.name&&a.at<1e-6))}const N=new WeakMap;for(const[s,o]of k.entries()){const n=v[s];if(!n&&!o.layers.some(t=>de(t)&&t.video))continue;const e=[];for(const t of o.layers){if(!de(t)){e.push(t);continue}if(n&&t.file===void 0&&t.video===void 0){e.push(Ae(P,t,n,d=>n.from+d,{video:n.id,output:n.output,format:n.format,from:n.from,to:n.to}));continue}if(!t.video){e.push(t);continue}const a=document.createElement("div"),M={from:0,to:0,part:o.key,start:0,partStart:0},w=xe(t),g=t.quality?.scale,r=await l.load(t.video,a,{shown:M,...w?{cameras:w}:{},...g===void 0?{}:{sceneryScale:g}});let D=0;try{D=t.from===void 0?0:ie(r.inner,t.from)}catch(d){K.problems.push(re("AK-T003",`A footage of ${r.id} in part ${o.key}: ${De(d)}`,{part:o.key,where:{file:y.file}}))}const u=t.speed??1,_=Ae(P,t,{...r,host:a},(d,R)=>D+(d-R.layer.start)*u,{video:r.id,output:r.output,format:r.format,from:D,speed:u});N.set(_,{inner:r.inner,from:D,speed:u,shown:M,...t.audio===!0?{audio:t.gainDb??0}:{}}),e.push(_)}k[s]={...o,layers:e}}const Q=k.map((s,o)=>{const n=j[o]??{},e=n.speech,t=Oe(s.anchors),a=v[o];if(a){const M=[...t,...a.anchors.filter(w=>!t.some(g=>g.name===w.name))];return{key:s.key,...M.length>0?{placed:M}:{},dur:a.to-a.from,lead:0,tail:0,words:a.words,speechDur:a.to-a.from}}return{key:s.key,...t.length>0?{placed:t}:{},dur:n.estimate??s.dur??L.dur,lead:s.lead??L.lead,tail:s.tail??L.tail,...!e&&n.estimate!==void 0?{pending:!0,...n.script===void 0?{}:{script:n.script},...n.anchors===void 0?{}:{anchors:n.anchors}}:{},...e?{words:e.words,speechDur:e.dur,...e.script===void 0?{}:{script:e.script},...e.anchors===void 0?{}:{anchors:e.anchors},...s.overlap?.before===void 0?{}:{before:s.overlap.before},...s.overlap?.after===void 0?{}:{after:s.overlap.after}}:{}}}),i=new Map,f=s=>{let o=i.get(s.path);if(!o){const n=s.envelope===void 0?void 0:We(s.envelope);o={levels:n,room:n?Le(n):void 0},i.set(s.path,o)}return o};let A;return{results:j,says:h,videoTakes:v,specs:k,shownBy:N,inputs:Q,speechFor:(s,o)=>{const n=k[s],e=j[s]?.speech;if(!n||!e||o.speechAt===void 0)return A=void 0,{clips:[],room:[]};const t=[],a=[],M=o.speechAt-o.start,w=(n.overlap?.before??0)>0?Math.min(e.padIn,.12,Math.max(0,o.speechAt)):Math.min(e.padIn,Math.max(0,M)),g=(n.overlap?.after??0)>0?Math.min(e.padOut,.2):Math.min(e.padOut,Math.max(0,o.end-o.speechAt-e.dur)),r=qe,D=o.speechAt,u=e.speed??1,_=u===1?{}:{speed:u},d={start:r(D-w),end:r(D+e.dur+g),file:e.media.path,from:r(e.from-w*u),..._,...e.edits===void 0?{}:{edits:e.edits},...e.span?{words:e.span}:{},heard:be(e.words),...e.match?{match:e.match}:{}},R=e.denoise===void 0?{}:{denoise:e.denoise},te=n.speech?.kind==="take"?n.speech.room:void 0,b=te===!1?void 0:te,fe=f(e.media),T=te===!1?void 0:b?.from!==void 0&&b.to!==void 0&&b.to>b.from?{from:b.from,to:b.to}:fe.room,ce=Math.max(0,b?.fade??Z.fade),Te=m=>m>=.01?Math.min(ce,m):0,le=(m,O,p,C,H)=>{const $=A;if(A=void 0,!T||p-O<=.02)return 0;const F=T.to-T.from,x=Math.min(Te(C),(p-O)/2),q=Math.min(ce,F/4),$e=m==="lead"&&$?.clip.file===e.media.path&&Math.abs($.end-O)<1e-6,V=$&&$e?Math.min(q,$.clip.dur/2):0;$&&V>0&&($.clip.fadeOut=r(V));const oe=m==="tail"?O-x:O-V,X=m==="lead"?p+x:p,Y=[];for(let I=oe;X-I>.02;I+=F-q)Y.push(I);const se=Math.min(F,X-(Y.at(-1)??oe)),ye=I=>Math.min(Z.near,I),Fe=m==="tail"?{from:T.from,to:T.from+ye(Math.min(F,X-oe))}:{from:T.from+se-ye(se),to:T.from+se},z=Ke(fe.levels,Fe,H,b?.limitDb),ae=b?.gainDb!==void 0?{level:z.level,floor:z.floor,gainDb:b.gainDb,from:"given"}:b?.match===!1?{level:z.level,floor:z.floor,gainDb:0,from:"off"}:z,Ie=m==="tail"?x:V,Se=m==="lead"?x:0,ke=Y.map((I,Me)=>{const we=Me===0?Ie:q,ge=Me===Y.length-1?Se:q;return{file:e.media.path,part:n.key,at:r(I),from:T.from,dur:r(Math.min(F,X-I)),...R,...ae.gainDb===0?{}:{gainDb:ae.gainDb},...we>0?{fadeIn:r(we)}:{},...ge>0?{fadeOut:r(ge)}:{},tone:{part:n.key,side:m,join:r(m==="lead"?p:O),pad:r(C),...ae,fade:r(x)}}}),ve=ke.at(-1);return ve?(a.push(...ke),m==="tail"&&(A={clip:ve,end:p}),x):0},ue=e.ranges?.at(-1)?.to??e.from+e.dur*u;let ne=0;(n.overlap?.before??0)<=0?ne=le("lead",o.start,d.start,w,{from:d.from,to:d.from+Math.min(w*u,Z.near)}):A=void 0;const U=e.ranges;if(U&&U.length>1){const m=[];let O=0;U.forEach((p,C)=>{const H=C===0,$=C===U.length-1,F=H?d.start:r(D+O),x=H?r(p.from-w*u):p.from,q=(p.to-p.from)/u+(H?w:0)+($?g:0);m.push({at:F,from:x}),t.push({file:e.media.path,part:n.key,at:F,from:x,dur:r(q),..._,...R}),O+=(p.to-p.from)/u}),d.cuts=m}else t.push({file:d.file,part:n.key,at:d.start,from:d.from,dur:r(d.end-d.start),..._,...R});const me=(n.overlap?.after??0)<=0?le("tail",d.end,o.end,g,{from:ue+g*u-Math.min(g*u,Z.near),to:ue+g*u}):0,he=t[0],pe=t.at(-1);return he&&ne>0&&(he.fadeIn=r(ne)),pe&&me>0&&(pe.fadeOut=r(me)),{speech:d,clips:t,room:a}}}}

package/dist/node_modules/@allyhub/runtime/dist/transitions.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{pictureCss as g,TRANSITION_DEFAULTS as h,transitionEase as k,transitionKeys as v,transitionSpec as x,transitionState as S}from"@allyhub/video-core";export function timelineTransitions(m,d,u,y,c,e){const{fps:o,options:r}=m,l=[];for(const[p,n]of u){const i=c(p-1),a=c(p),f=y[p]?.transition;if(!i||!a||f===void 0)continue;const t=x(f),s=Math.round(a.start*o),b=t.type==="dip"?t.color:t.type==="custom"?t.color?.value:void 0;l.push({part:a.key,from:i.key,type:t.type,start:(s-n.before)/o,at:a.start,end:(s+n.after)/o,ease:t.ease??k(t.type),keys:v(t,{transparent:r.transparent===!0,background:e,...b===void 0?{}:{color:d.cssColor(b)}}),dur:t.dur??h.dur,...t.type==="slide"||t.type==="push"||t.type==="wipe"?{direction:t.direction??h.direction}:{},...t.type==="zoom"?{scale:t.scale??h.scale}:{}})}return l}export function transitionStage(m,d){const{fps:u,dims:y}=m,c=new Set;let e;return{place(o,r,l,p){const n=S(o,Math.round(p*u),u);for(const[i,a,f,t]of[[r,n.out,"1","4"],[l,n.in,"3","5"]]){const s=g(a,y.width,y.height);i.overlays&&Object.assign(i.overlays.style,{transform:s.transform,opacity:s.opacity,clipPath:s.clipPath,zIndex:t}),Object.assign(i.picture.style,{transform:s.transform,opacity:s.opacity,clipPath:s.clipPath,zIndex:f,background:d.clear?"":"var(--ak-color-bg)",mixBlendMode:n.add&&i===l?"plus-lighter":""}),c.add(i)}n.color?(e||(e=document.createElement("div"),e.className="ak-transition-color",Object.assign(e.style,{position:"absolute",inset:"0",zIndex:"2",pointerEvents:"none"}),d.el.append(e)),Object.assign(e.style,{display:"block",background:n.color.value,opacity:String(Math.round(n.color.opacity*1e4)/1e4)})):e&&(e.style.display="none")},rest(o){if(c.delete(o))for(const r of[o.picture,o.overlays])r&&Object.assign(r.style,{transform:"",opacity:"",clipPath:"",zIndex:"",background:"",mixBlendMode:""})},hideVeil(){e&&(e.style.display="none")}}}

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

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

package/dist/node_modules/@allyhub/runtimes/dist/bundled.d.ts

@@ -0,0 +1,10 @@
+import { type Platform, type RuntimeManifest } from "@allyhub/protocol";
+export interface BundledOptions {
+    env?: Readonly<Record<string, string | undefined>>;
+    platform?: Platform | undefined;
+    manifest?: RuntimeManifest;
+    exists?: (path: string) => boolean;
+}
+/** The variables that name the programs of the runtimes in `folder`. */
+export declare function bundledEnv(folder: string, options?: BundledOptions): Record<string, string>;
+//# sourceMappingURL=bundled.d.ts.map

package/dist/node_modules/@allyhub/runtimes/dist/bundled.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{existsSync as u}from"node:fs";import{join as v}from"node:path";import{binsOf as x,filesFor as O,platformOf as d}from"@allyhub/protocol";import{binVariable as h}from"./runtimes.js";import{shippedManifest as j}from"./manifest.js";import{native as y}from"./unpack.js";export function bundledEnv(s,t={}){const f=t.env??process.env,e="platform"in t?t.platform:d(process.platform,process.arch),m=t.manifest??j(),c=t.exists??u,r={};if(!e)return r;for(const[a,p]of Object.entries(m.runtimes)){const n=O(p,e);if(n)for(const[l,b]of Object.entries(x(n))){const o=h(l),i=v(s,a,y(b));!f[o]&&c(i)&&(r[o]=i)}}return r}

package/dist/node_modules/@allyhub/runtimes/dist/download.d.ts

@@ -0,0 +1,38 @@
+import { RuntimeError } from "./errors.js";
+/** How long a download may go without a byte before that try is given up (ms). */
+export declare const DOWNLOAD_STALL_MS = 30000;
+/** How many times a download that failed on the way is tried again. */
+export declare const DOWNLOAD_RETRIES = 3;
+/** The wait before the first try again, doubled before each next one (ms). */
+export declare const DOWNLOAD_RETRY_DELAY_MS = 1000;
+/** How a download waits and tries again; each default is its constant above. */
+export interface DownloadTimings {
+    /** No byte for this long gives up a try (default: DOWNLOAD_STALL_MS). */
+    stallMs?: number | undefined;
+    /** Tries again after the first (default: DOWNLOAD_RETRIES). */
+    retries?: number | undefined;
+    /** The first wait before trying again (default: DOWNLOAD_RETRY_DELAY_MS). */
+    retryDelayMs?: number | undefined;
+}
+export interface DownloadOptions extends DownloadTimings {
+    size: number;
+    /** Its sha256, hex; or its `integrity` instead. */
+    sha256?: string;
+    /** Its digest as Subresource Integrity writes it, npm's lock with it (`sha512-<base64>`). */
+    integrity?: string;
+    /** What came is kept when it is cancelled or gives up, for the next download to continue. */
+    resume?: boolean;
+    fetch: typeof globalThis.fetch;
+    signal?: AbortSignal | undefined;
+    onProgress?: ((received: number, total: number) => void) | undefined;
+    /** Before each try again: what went wrong, the try that failed and how many there are. */
+    onRetry?: ((error: RuntimeError, attempt: number, attempts: number) => void) | undefined;
+}
+/**
+ * Downloads `url` to `dest`, hashing as it comes; a file of another size or
+ * sha256 is deleted and refused, and nothing longer than its pin is read.
+ */
+export declare function download(url: string, dest: string, options: DownloadOptions): Promise<void>;
+/** A file's sha256. */
+export declare function sha256Of(path: string): Promise<string>;
+//# sourceMappingURL=download.d.ts.map

package/dist/node_modules/@allyhub/runtimes/dist/download.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{createHash as S}from"node:crypto";import{createReadStream as O,createWriteStream as C}from"node:fs";import{rm as h,stat as Y}from"node:fs/promises";import{Readable as H,Transform as I}from"node:stream";import{pipeline as v}from"node:stream/promises";import{setTimeout as P}from"node:timers/promises";import{RuntimeError as r}from"./errors.js";export const DOWNLOAD_STALL_MS=3e4,DOWNLOAD_RETRIES=3,DOWNLOAD_RETRY_DELAY_MS=1e3;const j=e=>e===408||e===425||e===429||e>=500,x=(e,t)=>new r("cancelled",`Stopped downloading ${e}.`,{cause:t}),q=async e=>Y(e).then(t=>t.size,()=>0),B=e=>{const t=/^bytes (\d+)-/u.exec(e??"")?.[1];return t===void 0?void 0:Number(t)};function F(e){if(e.integrity!==void 0){const[t,s]=e.integrity.split("-",2);if((t==="sha256"||t==="sha384"||t==="sha512")&&s!==void 0)return{algorithm:t,encoding:"base64",value:s};throw new r("checksum",`${e.integrity} is not an integrity it can check.`)}if(e.sha256===void 0)throw new r("checksum","A download needs its sha256 or its integrity.");return{algorithm:"sha256",encoding:"hex",value:e.sha256}}export async function download(e,t,s){const{size:d,resume:D=!1,signal:f,onProgress:W,onRetry:E,stallMs:T=DOWNLOAD_STALL_MS,retries:L=DOWNLOAD_RETRIES,retryDelayMs:k=DOWNLOAD_RETRY_DELAY_MS}=s,w=L+1,g=F(s),u=async()=>{D||await h(t,{force:!0})};let y;const M=async()=>{const o=await q(t);if(o>=d)return{received:o,digest:await G(t,g)};const a=new AbortController,c=f?AbortSignal.any([f,a.signal]):a.signal;let p;const $=()=>{clearTimeout(p),p=setTimeout(()=>{a.abort()},T)},_=()=>new r("download",`${e} sent nothing for ${String(T/1e3)} s.`);$();try{const N=o>0?{range:`bytes=${String(o)}-`,...y?{"if-range":y}:{}}:{};let i;try{i=await s.fetch(e,{redirect:"follow",headers:N,signal:c})}catch(n){if(f?.aborted)throw x(e,n);return a.signal.aborted?_():new r("download",`Could not reach ${e}: ${R(n)}`,{cause:n})}if(!i.ok||!i.body){await i.body?.cancel().catch(()=>{});const n=new r("download",`${e} answered ${String(i.status)}.`);if(j(i.status))return n;throw n}const m=i.status===206&&B(i.headers.get("content-range"))===o;if(i.status===206&&!m)return await i.body.cancel().catch(()=>{}),await h(t,{force:!0}),new r("download",`${e} answered another range than bytes=${String(o)}-.`);if(!m){const n=i.headers.get("etag");y=n&&!n.startsWith("W/")?n:i.headers.get("last-modified")??void 0}const b=S(g.algorithm);let l=0;if(m)for await(const n of O(t))b.update(n),l+=n.length;const z=new I({transform(n,J,A){if($(),l+=n.length,l>d){A(new r("checksum",`${e} is larger than its pin (${String(d)} bytes).`));return}b.update(n),W?.(l,d),A(null,n)}});$();try{await v(H.fromWeb(i.body),z,C(t,{flags:m?"a":"w"}),{signal:c})}catch(n){if(n instanceof r)throw n;if(f?.aborted)throw x(e,n);return a.signal.aborted?_():new r("download",`Downloading ${e} failed: ${R(n)}`,{cause:n})}return{received:l,digest:b.digest(g.encoding)}}finally{clearTimeout(p)}};D||await h(t,{force:!0});for(let o=1;;o++){let a;try{a=await M()}catch(c){throw c instanceof r&&c.code==="cancelled"?await u():await h(t,{force:!0}),c}if(!(a instanceof r)){if(a.received!==d||a.digest!==g.value)throw await h(t,{force:!0}),new r("checksum",`${e} came as ${String(a.received)} bytes with ${g.algorithm} ${a.digest}; its pin is ${String(d)} bytes, ${g.value}.`);return}if(o>=w)throw await u(),new r("download",w>1?`${a.message} Tried ${String(w)} times.`:a.message,{cause:a});E?.(a,o,w);try{await P(k*2**(o-1),void 0,f?{signal:f}:{})}catch(c){throw await u(),x(e,c)}}}async function G(e,t){const s=S(t.algorithm);return await v(O(e),s),s.digest(t.encoding)}export async function sha256Of(e){const t=S("sha256");return await v(O(e),t),t.digest("hex")}const R=e=>e instanceof Error?e.message:String(e);

package/dist/node_modules/@allyhub/runtimes/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { binVariable, createRuntimes, type EnsureOptions, type Located, type Progress, type Runtimes, type RuntimesOptions, type Status, } from "./runtimes.js";
+export { createPackages, npmCi, NPM_FETCH_TIMEOUT_MS, NPM_STALL_MS, type EnsurePackageOptions, type InstallOptions, type LoadOptions, type Install, type LocatedPackage, type Packages, type PackagesOptions, } from "./packages.js";
+export { bundledEnv, type BundledOptions } from "./bundled.js";
+export { RuntimeError, type RuntimeErrorCode } from "./errors.js";
+export { cacheHome } from "./home.js";
+export { shippedManifest } from "./manifest.js";
+export { download, sha256Of, DOWNLOAD_RETRIES, DOWNLOAD_RETRY_DELAY_MS, DOWNLOAD_STALL_MS, type DownloadOptions, type DownloadTimings, } from "./download.js";
+export { withLock } from "./lock.js";
+export { unzip, untgz } from "./unpack.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{binVariable,createRuntimes}from"./runtimes.js";export{createPackages,npmCi,NPM_FETCH_TIMEOUT_MS,NPM_STALL_MS}from"./packages.js";export{bundledEnv}from"./bundled.js";export{RuntimeError}from"./errors.js";export{cacheHome}from"./home.js";export{shippedManifest}from"./manifest.js";export{download,sha256Of,DOWNLOAD_RETRIES,DOWNLOAD_RETRY_DELAY_MS,DOWNLOAD_STALL_MS}from"./download.js";export{withLock}from"./lock.js";export{unzip,untgz}from"./unpack.js";

package/dist/node_modules/@allyhub/runtimes/dist/lock.d.ts

@@ -0,0 +1,14 @@
+export interface LockOptions {
+    signal?: AbortSignal | undefined;
+    pollMs?: number;
+    /** Called once, when the lock is another's and this waits for it. */
+    onWait?: () => void;
+}
+export declare function withLock<T>(path: string, run: () => Promise<T>, options?: LockOptions): Promise<T>;
+/** A new staging folder's path for `dir`, owned by this process. */
+export declare const partialOf: (dir: string) => string;
+/** Whether a process of this computer runs by that pid (one of another user's counts). */
+export declare function running(pid: number): boolean;
+/** Removes the staging folders in `root` of any version of `name` whose process has ended. */
+export declare function sweepPartials(root: string, name: string): Promise<void>;
+//# sourceMappingURL=lock.d.ts.map

package/dist/node_modules/@allyhub/runtimes/dist/lock.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{randomBytes as l}from"node:crypto";import{readdir as p,rm as u}from"node:fs/promises";import{join as m}from"node:path";import{setTimeout as d}from"node:timers/promises";import{lock as w}from"proper-lockfile";export async function withLock(r,o,i={}){const{signal:t,pollMs:a=150,onWait:f}=i;let n,c,s=!1;for(;;){t?.throwIfAborted();try{c=await w(r,{lockfilePath:r,realpath:!1,onCompromised:e=>{n=e}});break}catch(e){if(e.code!=="ELOCKED")throw e;s||f?.(),s=!0,await d(a,void 0,t?{signal:t}:{})}}try{const e=await o();if(n)throw n;return e}finally{n||await c()}}const h=/\.partial-(\d+)-[0-9a-f]+$/u;export const partialOf=r=>`${r}.partial-${String(process.pid)}-${l(4).toString("hex")}`;export function running(r){try{return process.kill(r,0),!0}catch(o){return o.code==="EPERM"}}export async function sweepPartials(r,o){let i;try{i=await p(r)}catch{return}for(const t of i){if(!t.startsWith(`${o}@`))continue;const a=h.exec(t)?.[1];a!==void 0&&!running(Number(a))&&await u(m(r,t),{recursive:!0,force:!0})}}

package/dist/node_modules/@allyhub/runtimes/dist/manifest.d.ts

@@ -0,0 +1,3 @@
+import { type RuntimeManifest } from "@allyhub/protocol";
+export declare function shippedManifest(): RuntimeManifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/node_modules/@allyhub/runtimes/dist/manifest.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFileSync as r}from"node:fs";import{RuntimeManifestSchema as t}from"@allyhub/protocol";let e;export function shippedManifest(){return e??=t.parse(JSON.parse(r(new URL("../manifest.json",import.meta.url),"utf8"))),e}

package/dist/node_modules/@allyhub/runtimes/dist/node-program.d.ts

@@ -0,0 +1,12 @@
+/** The program that runs a Node program here. */
+export declare function nodeCommand(env?: Readonly<Record<string, string | undefined>>, versions?: Readonly<Record<string, string | undefined>>): string;
+/**
+ * How to run the worker module `name` beside `from` (an import.meta.url) in
+ * a Node process of its own: from source through tsx while testing, else
+ * its built .js.
+ */
+export declare function workerCommand(from: string, name: string): {
+    command: string;
+    args: string[];
+};
+//# sourceMappingURL=node-program.d.ts.map

package/dist/node_modules/@allyhub/runtimes/dist/node-program.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{fileURLToPath as t}from"node:url";export function nodeCommand(o=process.env,n=process.versions){const e=o.ALLYHUB_NODE;if(e)return e;if(n.electron!==void 0)throw new Error("This Electron app names no Node.js (ALLYHUB_NODE): its own executable is not Node.");return process.execPath}export function workerCommand(o,n){const e=o.endsWith(".ts"),r=t(new URL(`./${n}.${e?"ts":"js"}`,o));return{command:nodeCommand(),args:[...e?["--import","tsx"]:[],r]}}

package/dist/node_modules/@allyhub/runtimes/dist/packages.d.ts

@@ -0,0 +1,84 @@
+export interface PackagesOptions {
+    /** The cache folder (default: the system's, `cacheHome`). */
+    home?: string;
+    /** The folder of pins (default: the ones AllyHub ships). */
+    pins?: string;
+    env?: Readonly<Record<string, string | undefined>>;
+    /** What fills a folder from its package-lock.json (default: `npm ci`). */
+    install?: Install;
+    /** How long npm waits on a quiet connection (default: NPM_FETCH_TIMEOUT_MS). */
+    fetchTimeoutMs?: number | undefined;
+    /** How long an install may go without progress before it is stopped (default: NPM_STALL_MS). */
+    stallMs?: number | undefined;
+}
+export interface InstallOptions {
+    home: string;
+    signal?: AbortSignal | undefined;
+    /** npm's `--fetch-timeout`, its socket's idle limit (default: NPM_FETCH_TIMEOUT_MS). */
+    fetchTimeoutMs?: number | undefined;
+    /** No output and no change in its folders for this long stops it (default: NPM_STALL_MS). */
+    stallMs?: number | undefined;
+    /** Kinds of dependency npm leaves out, beyond dev and peer ones (`optional`). */
+    omit?: readonly string[] | undefined;
+}
+export type Install = (dir: string, options: InstallOptions) => Promise<void>;
+/** npm's `--fetch-timeout`: a connection quiet this long is dropped and tried again by npm (ms). */
+export declare const NPM_FETCH_TIMEOUT_MS = 30000;
+/**
+ * An install with no output and no change in its folder or npm's download
+ * folder for this long is stopped (ms): longer than npm's own timeout and
+ * retry, so npm says what went wrong first when it can.
+ */
+export declare const NPM_STALL_MS = 120000;
+export interface LocatedPackage {
+    name: string;
+    version: string;
+    /** Its folder, the one holding its `node_modules`. */
+    dir: string;
+}
+export interface EnsurePackageOptions {
+    signal?: AbortSignal | undefined;
+    /** Called once if the package has to be fetched, before it is. */
+    onFetch?: (name: string) => void;
+}
+export interface LoadOptions extends EnsurePackageOptions {
+    /** The module to load, for a pin holding several (default: the pin's name). */
+    module?: string;
+}
+export interface Packages {
+    readonly home: string;
+    /** A package if it is there; never fetches, and reads only its record. */
+    locate(name: string): LocatedPackage | undefined;
+    /** What a package takes on this computer, as near as its pin says (bytes). */
+    size(name: string): number;
+    /** The file `import(name)` would load, when the package is there. */
+    entry(name: string): string | undefined;
+    /** The file a module of an ensured package resolves to, which never fetches. */
+    resolve(name: string, module: string): string | undefined;
+    /** A package, fetched and checked first if it is not there. */
+    ensure(name: string, options?: EnsurePackageOptions): Promise<LocatedPackage>;
+    /** A package's module, as `import(name)` would give it, ensured first. */
+    load<T>(name: string, options?: LoadOptions): Promise<T>;
+    /** Takes a package off this computer; it comes back when next ensured. */
+    remove(name: string): Promise<void>;
+}
+/** A setting `npx` puts in the environment about its own install. */
+export declare const NPX_SETTING: RegExp;
+/** What went wrong, from what npm wrote: its reason, not its advice. */
+export declare function npmProblem(stderr: string, code: number | null): string;
+export interface NpmCommand {
+    command: string;
+    /** What comes before npm's own arguments: its script, when Node runs it. */
+    script: string[];
+}
+/**
+ * The npm to install with. An app that brings its own names it (bundled.ts),
+ * and `npx` names the one that runs it; else the computer's; and where it has
+ * none, as a person who only has Studio may not, the runtime manager's Node
+ * and its npm, fetched like any runtime.
+ */
+export declare function findNpm(env: Readonly<Record<string, string | undefined>>, ensureNode: () => Promise<Record<string, string>>): Promise<NpmCommand>;
+/** Runs `npm ci` from the lock, keeping npm's cache in AllyHub's home. */
+export declare const npmCi: Install;
+export declare function createPackages(options?: PackagesOptions): Packages;
+//# sourceMappingURL=packages.d.ts.map

package/dist/node_modules/@allyhub/runtimes/dist/packages.js

@@ -0,0 +1,4 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{spawn as R}from"node:child_process";import{createHash as I}from"node:crypto";import{existsSync as M,readFileSync as T}from"node:fs";import{copyFile as P,mkdir as j,readdir as b,readFile as A,rename as D,rm as $,stat as H,writeFile as C}from"node:fs/promises";import{createRequire as F}from"node:module";import{delimiter as z,join as o}from"node:path";import{fileURLToPath as U,pathToFileURL as J}from"node:url";import{DOWNLOAD_STALL_MS as W}from"./download.js";import{RuntimeError as x}from"./errors.js";import{cacheHome as G}from"./home.js";import{partialOf as q,sweepPartials as B,withLock as K}from"./lock.js";import{nodeCommand as V}from"./node-program.js";import{createRuntimes as X}from"./runtimes.js";const E=".allyhub-package.json",Y=U(new URL("../pins/",import.meta.url));export const NPM_FETCH_TIMEOUT_MS=W,NPM_STALL_MS=12e4;async function Q(n){const s=o(n,"node_modules","onnxruntime-node","bin","napi-v6");for(const i of await b(s)){if(i!==process.platform){await $(o(s,i),{recursive:!0,force:!0});continue}for(const l of await b(o(s,i)))l!==process.arch&&await $(o(s,i,l),{recursive:!0,force:!0})}if(process.platform!=="darwin")return;const a=o(s,"darwin",process.arch);for(const i of await b(a))/^libonnxruntime\.\d+\.\d+\.\d+\.dylib$/u.test(i)&&await $(o(a,i),{force:!0})}const Z={"onnxruntime-node":Q};export const NPX_SETTING=/^npm_config_(global|prefix|location|cache|.*_prefix)/iu;export function npmProblem(n,s){return n.split(`
+`).map(i=>i.replace(/^npm (error|ERR!)\s*/u,"").trim()).find(i=>i!==""&&!/^(code|errno|syscall|path|type|A complete log|Exit handler|This is an error with npm|<https)/u.test(i))??`npm ended with code ${String(s)}`}const tt=(n,s)=>(s.PATH??"").split(z).some(a=>a!==""&&M(o(a,n)));export async function findNpm(n,s){const a=n.ALLYHUB_NPM??n.npm_execpath;if(a?.endsWith(".js"))return{command:V(n),script:[a]};if(tt("npm",n))return{command:"npm",script:[]};const i=await s(),{node:l,npm:d}=i;if(!l||!d)throw new Error("AllyHub's Node has no npm");return{command:l,script:[d]}}async function et(n,s){const a=await b(n,{recursive:!0}).catch(()=>[]);let i=0;for(const l of await b(s).catch(()=>[]))i+=await H(o(s,l)).then(d=>d.size,()=>0);return`${String(a.length)}:${String(i)}`}export const npmCi=async(n,{home:s,signal:a,fetchTimeoutMs:i=NPM_FETCH_TIMEOUT_MS,stallMs:l=NPM_STALL_MS,omit:d})=>{const O=await findNpm(process.env,async()=>(await X({home:s}).ensure("node",{signal:a})).bins),m=Object.fromEntries(Object.entries(process.env).filter(([p])=>!NPX_SETTING.test(p))),w=o(s,"packages",".npm"),h=["ci","--ignore-scripts","--omit=dev","--no-audit","--no-fund","--omit=peer",...(d??[]).map(p=>`--omit=${p}`),"--loglevel=error","--fetch-retries=1",`--fetch-timeout=${String(i)}`];await new Promise((p,g)=>{const v=R(O.command,[...O.script,...h],{cwd:n,env:{...m,npm_config_cache:w},stdio:["ignore","ignore","pipe"],...a?{signal:a}:{}});let k="",y=Date.now(),S="",_=!1,t=!1;const e=setInterval(()=>{_||t||(_=!0,et(n,o(w,"_cacache","tmp")).then(r=>{r!==S?(S=r,y=Date.now()):Date.now()-y>=l&&(t=!0,v.kill(),setTimeout(()=>v.kill("SIGKILL"),5e3).unref())}).finally(()=>{_=!1}))},Math.max(20,Math.min(5e3,l/4)));v.stderr.on("data",r=>{y=Date.now(),k=`${k}${r.toString()}`.slice(-1e3)}),v.on("error",r=>{clearInterval(e),g(r)}),v.on("close",r=>{clearInterval(e),t?g(new x("install",`npm made no progress for ${String(l/1e3)} s and was stopped${k.trim()?`; it said: ${npmProblem(k,r)}`:""}`)):r===0?p():g(new Error(npmProblem(k,r)))})})};export function createPackages(n={}){const s=n.env??process.env,a=n.home??G(s),i=n.pins??Y,l=n.install??npmCi,{fetchTimeoutMs:d,stallMs:O}=n,m=o(a,"packages"),w=t=>{const e=o(i,t);let r,c;try{r=JSON.parse(T(o(e,"package.json"),"utf8")),c=T(o(e,"package-lock.json"),"utf8")}catch{throw new x("unknown-package",`AllyHub has no package "${t}".`)}const u=r.dependencies??{},f=u[t]??r.version;if(!f)throw new x("unknown-package",`The pin of "${t}" does not name it.`);return{version:f,holds:u,lock:I("sha256").update(c).digest("hex"),dir:e,size:r.allyhubSize??0,omit:r.allyhubOmit??[]}},h=(t,e)=>o(m,`${t}@${e.version}`),p=(t,e)=>{try{const r=JSON.parse(T(o(h(t,e),E),"utf8"));return r.version===e.version&&r.lock===e.lock}catch{return!1}},g=(t,e)=>({name:t,version:e.version,dir:h(t,e)}),v=async(t,e,r)=>{const c=h(t,e),u=q(c);await j(u,{recursive:!0});try{await P(o(e.dir,"package.json"),o(u,"package.json")),await P(o(e.dir,"package-lock.json"),o(u,"package-lock.json")),await l(u,{home:a,signal:r,fetchTimeoutMs:d,stallMs:O,omit:e.omit});for(const[f,L]of Object.entries(e.holds)){const N=JSON.parse(await A(o(u,"node_modules",f,"package.json"),"utf8"));if(N.version!==L)throw new Error(`it holds ${f} ${String(N.version)}, not ${L}`)}await Z[t]?.(u),await C(o(u,E),`${JSON.stringify({version:e.version,lock:e.lock,at:new Date().toISOString()})}
+`),await $(c,{recursive:!0,force:!0}),await D(u,c),await k(t,e)}catch(f){throw await $(u,{recursive:!0,force:!0}),r?.aborted?new x("cancelled",`Stopped getting ${t}.`,{cause:f}):new x("install",`Could not get ${t} ${e.version} (${f instanceof Error?f.message:String(f)}). Check the connection and run it again.`,{cause:f})}},k=async(t,e)=>{const r=`${t}@${e.version}`;for(const c of await b(m))c.startsWith(`${t}@`)&&c!==r&&!c.startsWith(`${r}.`)&&await $(o(m,c),{recursive:!0,force:!0})},y=t=>{const e=w(t);return p(t,e)?g(t,e):void 0},S=(t,e)=>F(o(t,"package.json")).resolve(e),_=async(t,e={})=>{const r=w(t);return p(t,r)||(await j(m,{recursive:!0}).catch(c=>{throw new x("install",`Could not get ${t} ${r.version}: AllyHub cannot write to ${m}.`,{cause:c})}),await K(`${h(t,r)}.lock`,async()=>{p(t,r)||(await B(m,t),e.onFetch?.(t),await v(t,r,e.signal))},{signal:e.signal})),g(t,r)};return{home:a,locate:y,ensure:_,size:t=>w(t).size,entry(t){const e=y(t);return e?S(e.dir,t):void 0},resolve(t,e){const r=y(t);return r?S(r.dir,e):void 0},async load(t,e){const{dir:r}=await _(t,e),c=S(r,e?.module??t);return await import(J(c).href)},async remove(t){await $(h(t,w(t)),{recursive:!0,force:!0})}}}

package/dist/node_modules/@allyhub/runtimes/dist/runtimes.d.ts

@@ -0,0 +1,72 @@
+import { type Platform, type RuntimeManifest } from "@allyhub/protocol";
+import { type DownloadTimings } from "./download.js";
+export interface RuntimesOptions {
+    /** The cache folder (default: the system's, `cacheHome`). */
+    home?: string;
+    manifest?: RuntimeManifest;
+    /** The platform (default: this process's). */
+    platform?: Platform | undefined;
+    env?: Readonly<Record<string, string | undefined>>;
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Where a download no `onProgress` follows says how it goes (default:
+     * stderr): most commands get a runtime in passing, and minutes of silence
+     * read as a hang to whoever runs them.
+     */
+    log?: (line: string) => void;
+    /** How a download waits and tries again (defaults: download.ts's constants). */
+    downloads?: DownloadTimings;
+}
+export interface Located {
+    name: string;
+    /** The pinned version; none for programs the environment names, whose version is their own. */
+    version: string | undefined;
+    /** Its folder; for one named by the environment, where its first program is. */
+    dir: string;
+    /** Its programs, by name, at their absolute paths. */
+    bins: Record<string, string>;
+    /** Where it was found. */
+    from: "cache" | "env";
+}
+export interface Status {
+    name: string;
+    about: string;
+    version: string;
+    license: string;
+    /** It has files for this platform. */
+    available: boolean;
+    installed: boolean;
+    /** Where it is, when it is. */
+    from?: "cache" | "env";
+    /** What it downloads, in bytes. */
+    size: number;
+    dir: string;
+}
+export interface Progress {
+    runtime: string;
+    url: string;
+    received: number;
+    total: number;
+}
+export interface EnsureOptions {
+    signal?: AbortSignal | undefined;
+    onProgress?: (progress: Progress) => void;
+}
+export interface Runtimes {
+    readonly home: string;
+    readonly platform: Platform | undefined;
+    /** Every runtime of the manifest, as it stands on this computer. */
+    status(): Promise<Status[]>;
+    /** A runtime if it is there; never downloads. */
+    locate(name: string): Promise<Located | undefined>;
+    /** A runtime, downloaded and checked first if it is not there. */
+    ensure(name: string, options?: EnsureOptions): Promise<Located>;
+    /** One program of a runtime, ensured. */
+    bin(name: string, bin: string, options?: EnsureOptions): Promise<string>;
+    /** Takes a runtime off this computer; it comes back when next ensured. */
+    remove(name: string): Promise<void>;
+}
+/** The variable that names a program on the computer: ALLYHUB_FFMPEG, ALLYHUB_YT_DLP. */
+export declare const binVariable: (bin: string) => string;
+export declare function createRuntimes(options?: RuntimesOptions): Runtimes;
+//# sourceMappingURL=runtimes.d.ts.map

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

@@ -0,0 +1,4 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{chmod as T,mkdir as E,readFile as W,rename as J,rm as z,writeFile as _}from"node:fs/promises";import{dirname as U,join as d}from"node:path";import{binsOf as A,filesFor as C,platformOf as V}from"@allyhub/protocol";import{download as Y,sha256Of as q}from"./download.js";import{RuntimeError as g}from"./errors.js";import{cacheHome as G}from"./home.js";import{partialOf as K,sweepPartials as Q,withLock as X}from"./lock.js";import{shippedManifest as Z}from"./manifest.js";import{inside as D,native as tt,undmg as et,untgz as rt,unzip as nt}from"./unpack.js";const F=".allyhub-runtime.json";export const binVariable=o=>`ALLYHUB_${o.toUpperCase().replaceAll("-","_")}`;const L=o=>`${String(Math.max(1,Math.round(o/1e6)))} MB`;function st(o,$,w,v){v(`Downloading ${o} ${$} (${L(w)}), once…`);let h=0;return u=>{const b=Math.floor(u/w*10)*10;b!==h&&(h=b,v(`  ${String(b)}% (${L(u)} of ${L(w)})`))}}export function createRuntimes(o={}){const $=o.log??(t=>{process.stderr.write(`${t}
+`)}),w=o.env??process.env,v=o.home??G(w),h=o.manifest??Z(),u="platform"in o?o.platform:V(process.platform,process.arch),b=o.fetch??globalThis.fetch,y=d(v,"runtimes"),j=t=>{const e=Object.hasOwn(h.runtimes,t)?h.runtimes[t]:void 0;if(!e)throw new g("unknown-runtime",`AllyHub has no runtime "${t}".`);return e},p=(t,e)=>d(y,`${t}@${e.version}`),k=(t,e)=>{const r=u?C(e,u):void 0;if(!r)throw new g("unsupported",`${t} ${e.version} has no build for ${u??`${process.platform}-${process.arch}`}.`);return r},H=(t,e,r)=>Object.fromEntries(Object.entries(A(k(t,e))).map(([n,s])=>[n,d(r,tt(s))])),N=(t,e)=>{const r=[...new Set(Object.values(e.platforms).flatMap(f=>Object.keys(A(f))))];if(r.length===0)return;const n=r.map(f=>[f,w[binVariable(f)]]);if(n.some(([,f])=>!f))return;const s=Object.fromEntries(n),c=n[0]?.[1]??"";return{name:t,version:void 0,dir:U(c),bins:s,from:"env"}},R=async(t,e)=>{try{const r=JSON.parse(await W(d(p(t,e),F),"utf8")),n=k(t,e).map(s=>s.sha256);return r.version===e.version&&JSON.stringify(r.files)===JSON.stringify(n)}catch{return!1}},M=async t=>{const e=j(t),r=N(t,e);if(r)return r;if(!await R(t,e))return;const n=p(t,e);return{name:t,version:e.version,dir:n,bins:H(t,e,n),from:"cache"}},I=async(t,e,r)=>{const n=k(t,e),s=p(t,e),c=K(s),f=d(c,".downloads");await E(f,{recursive:!0});const B=r.onProgress?void 0:st(t,e.version,n.reduce((l,i)=>l+i.size,0),$);let x=0;try{for(const[l,i]of n.entries()){const O=d(f,String(l));if(await Y(i.url,O,{size:i.size,sha256:i.sha256,fetch:b,signal:r.signal,...o.downloads,onRetry:(a,m,S)=>{$(`  ${a.message} Trying again (${String(m+1)} of ${String(S)})…`)},onProgress:(a,m)=>{B?.(x+a),r.onProgress?.({runtime:t,url:i.url,received:a,total:m})}}),x+=i.size,i.unpack==="zip")await nt(O,c);else if(i.unpack==="tgz")await rt(O,c);else if(i.unpack==="dmg")await et(O,c);else{const a=D(c,i.name??ot(i.url));if(!a)throw new g("unpack",`${i.url} would be kept outside its folder.`);await E(U(a),{recursive:!0}),await J(O,a),i.executable&&await T(a,493)}for(const a of i.check){const m=D(c,a.path),S=m?await q(m).catch(()=>"missing"):"missing";if(S!==a.sha256)throw new g("checksum",`${a.path} from ${i.url} has sha256 ${S}; its pin is ${a.sha256}.`)}}await z(f,{recursive:!0,force:!0}),await _(d(c,F),`${JSON.stringify({version:e.version,files:n.map(l=>l.sha256),at:new Date().toISOString()})}
+`),await z(s,{recursive:!0,force:!0}),await J(c,s)}catch(l){throw await z(c,{recursive:!0,force:!0}),l}},P=async(t,e={})=>{const r=j(t),n=await M(t);if(n)return n;k(t,r),await E(y,{recursive:!0}),await X(`${p(t,r)}.lock`,async()=>{await R(t,r)||(await Q(y,t),await I(t,r,e))},{signal:e.signal,onWait:()=>{$(`Waiting for ${t}, which another command is getting…`)}});const s=await M(t);if(!s)throw new g("download",`${t} was installed but cannot be found in ${y}.`);return s};return{home:v,platform:u,locate:M,ensure:P,async bin(t,e,r){const s=(await P(t,r)).bins[e];if(!s)throw new g("unknown-runtime",`${t} holds no program "${e}".`);return s},async remove(t){const e=j(t);await z(p(t,e),{recursive:!0,force:!0})},async status(){return Promise.all(Object.entries(h.runtimes).map(async([t,e])=>{const r=u?C(e,u):void 0,n=p(t,e),s=N(t,e)!==void 0?"env":r!==void 0&&await R(t,e)?"cache":void 0;return{name:t,about:e.about,version:e.version,license:e.license,available:r!==void 0,installed:s!==void 0,...s?{from:s}:{},size:(r??[]).reduce((c,f)=>c+f.size,0),dir:n}}))}}}const ot=o=>decodeURIComponent(new URL(o).pathname.split("/").pop()??"file");

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

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