allyhub 0.4.0 → 0.6.0

package/node_modules/@allyhub-next/render/dist/page.d.ts

@@ -1,186 +0,0 @@
-import type { TextInk, CaptionLine, CaptionOptions, CaptureOptions, Combo, MediaInfo, Problem, Timeline } from "@allyhub-next/video-core";
-/** Which output a render is of: a piece's output in one combo and format. */
-export interface RenderTarget {
-    piece: string;
-    output: string;
-    combo: Combo;
-    format: string;
-}
-/** What a page is asked to capture at a moment (GraphicsPage.frame). */
-export interface FrameOptions {
-    format: "jpeg" | "png";
-    quality?: number;
-    /** Draw this much after the frame's moment, seconds (motion blur's sub-frame samples). */
-    offset?: number;
-    /** Keep the stage's transparency (PNG only). */
-    alpha?: boolean;
-    /**
-     * Only the graphic layers of this plane of the part (its number in
-     * Part.planes): a part whose graphics are in several planes is drawn a
-     * plane at a time.
-     */
-    plane?: number;
-    /**
-     * This part alone (its key), as a cut would show it, held at its first
-     * or last frame outside its own time: the two pictures of a transition
-     * are captured one by one and composited by ffmpeg. Without it, a moment
-     * in a transition's window has both parts, placed with CSS.
-     */
-    part?: string;
-    /**
-     * Frames captured (or being captured), by the stage's signature: a
-     * moment whose DOM is the same as one in here is not captured again.
-     */
-    reuse?: Map<string, Promise<Buffer>>;
-    /** Counts what the call did: a capture, or a frame from `reuse`. */
-    stats?: {
-        captured: number;
-        reused: number;
-    };
-}
-/**
- * What a part draws at each of a list of moments, as one hash, for a part
- * drawn by code the part cache cannot see into (a custom() layer, a
- * scenery, a component of the piece's own file): `sign` and the
- * components (`owners`) that drew a canvas in it; or why it cannot be
- * said (`unknown`: a canvas the piece's own code paints, a video, an
- * iframe, a GIF).
- */
-export type PartSignature = {
-    sign: string;
-    owners: string[];
-    unknown?: undefined;
-} | {
-    unknown: string;
-};
-/** What the output read while it was drawn: message keys and project paths. */
-export interface OutputReads {
-    messages: readonly string[];
-    media: readonly string[];
-    data: readonly string[];
-}
-/**
- * A page holding a loaded output, drawing its graphics plane: transparent,
- * without footage (the render's ffmpeg draws the footage). A render may be
- * given several, which draw different frames at once.
- */
-export interface GraphicsPage {
-    /** The output's timeline as the page loaded it. */
-    readonly timeline: Timeline;
-    /**
-     * Each part's identity as JSON, by part key (the runtime's signs): its
-     * layers and their props and windows, its words, what its layers read,
-     * the look, the format, its length in frames. The part cache's key.
-     */
-    readonly signs: Readonly<Record<string, string>>;
-    /** What the output read while it loaded and drew its stills. */
-    readonly reads: OutputReads;
-    /** Drawn on this computer's GPU, not on the CPU: other pixels, another cache key. */
-    readonly gpu?: boolean;
-    /**
-     * One picture of the graphics at film time t, drawn as the render draws
-     * it: a PNG with alpha (`alpha`), or opaque, of the timeline's size.
-     */
-    frame(t: number, options: FrameOptions): Promise<Buffer>;
-    /** What part `key` draws at each of `times` (seconds), as one hash. */
-    partSign(key: string, times: readonly number[]): Promise<PartSignature>;
-    /**
-     * Every problem the page has seen so far: loading's, and what went
-     * wrong at any moment drawn since. A render fails a part whose drawing
-     * raised an error.
-     */
-    problems(): Promise<Problem[]>;
-    /**
-     * Problems found outside the page about what it drew (a post chain of a
-     * still), kept with the page's own; absent: they are dropped.
-     */
-    report?(problems: readonly Problem[]): void;
-    /** Closes the page. A render closes only the pages it opened (`RenderOptions.openPage`). */
-    close?(): Promise<void>;
-}
-/** A part's text, for a slide's speaker notes. */
-export interface PartText {
-    key: string;
-    /** A page's notes (`<prefix>.<page>.notes`). */
-    notes?: string;
-    /** What the part says. */
-    spoken?: string;
-    /** The text it shows. */
-    onScreen: readonly string[];
-}
-/** A page of a printed handout (ExportPage.print). */
-export interface PrintPage {
-    /** The moment the page shows: the part's still. */
-    still: number;
-    /** The page's title, its heading in the PDF's outline. */
-    title: string;
-    /** CSS for what is under the graphics: the footage plane as an image, or the background colour. */
-    background: string;
-}
-/** What the other export files need of the page beyond its frames. */
-export interface ExportPage extends GraphicsPage {
-    /**
-     * Each voiced part's line as shown and as said, with its words on the
-     * film clock, whatever says them (a take, a `say` line, a stretch of
-     * another video): the subtitles.
-     */
-    lines(): Promise<CaptionLine[]>;
-    /** The options the first layer that read its captions asked (ctx.captions): the subtitles follow them. */
-    captionOptions(): Promise<CaptionOptions | undefined>;
-    /** Each part's notes and text, for a deck's speaker notes. */
-    text(): Promise<readonly PartText[]>;
-    /**
-     * Each text block drawn at film time t, with its lines' glyph boxes and
-     * fills, its size and weight (LoadedOutput.inks): an editable PPTX's
-     * text boxes. Absent where the page cannot measure.
-     */
-    inks?(t: number): Promise<TextInk[]>;
-    /** A deck as it was drawn (slides-core's DrawnDeck): its PowerPoint file's model. Absent on a video. */
-    deck?(): Promise<unknown>;
-    /** Hides every text's fill while on (HIDE_TEXT_CSS): the picture behind an editable PPTX's text boxes. */
-    hideText?(on: boolean): Promise<void>;
-    /** How many covers the output has (video(…, { covers })). */
-    covers(): Promise<number>;
-    /**
-     * Cover `i`'s graphic layers as a PNG with alpha, the timeline's size,
-     * drawn outside the film's clock.
-     */
-    cover(i: number): Promise<Buffer>;
-    /**
-     * The output printed to a PDF, a sheet per page: at each page's still,
-     * the stage's DOM cloned onto a sheet of `paper` (CSS `@page` size: "W H"
-     * in pixels, or A4 and Letter at their size, the frame scaled onto it),
-     * over its `background`, so the text stays text; canvases frozen to
-     * pictures; a sheet without headings of its own given an invisible
-     * one, its title, so the outline lists every page; printed tagged, with
-     * the outline, backgrounds drawn.
-     */
-    print(pages: readonly PrintPage[], paper: string): Promise<Buffer>;
-}
-/** Where the project's media are, and what the build measured of them. */
-export interface ProjectMedia {
-    /** The project's folder: the media index (mattes, LUTs) is under it. */
-    root: string;
-    /** What the build measured of each media file, by project path. */
-    media: Readonly<Record<string, MediaInfo>>;
-    /** A media file's path on this computer, by its project path; undefined when it is not there. */
-    path(file: string): string | undefined;
-}
-/** What of an output's options (video({ … })) changes its picture once rendered. */
-export interface VideoLook {
-    /** A transparent video: its alpha kept where the file type has one. */
-    transparent?: boolean;
-    /** Motion blur: samples a frame (2–16) over `shutter` of a frame (default 0.5). */
-    motionBlur?: {
-        samples: number;
-        shutter?: number;
-    };
-    /** What a camera filming the picture does to it, before post. */
-    capture?: CaptureOptions;
-    /** A post filter chain and a .cube LUT, a project path. */
-    post?: {
-        filter?: string;
-        lut?: string;
-    };
-}
-//# sourceMappingURL=page.d.ts.map

package/node_modules/@allyhub-next/render/dist/served.d.ts

@@ -1,27 +0,0 @@
-import { type ServedEncode } from "@allyhub-next/video-core";
-import { type Tools } from "./tools.js";
-/** The served sound as encoded, or why it is missing and what is there instead. */
-export type ServedAudio = {
-    codec: string;
-    kbps: number;
-    rate: number;
-    channels: number;
-} | {
-    missing: string;
-    instead: string;
-};
-/** The platforms whose served encode AllyHub has measured. */
-export declare const servedPlatforms: () => string[];
-/** A platform's served encode, or undefined when AllyHub has not measured it. */
-export declare const servedEncodeOf: (platform: string) => ServedEncode | undefined;
-/** Encodes `from` as `e` serves it into `to`; what its sound is. */
-export declare function encodeServed(o: Tools & {
-    from: string;
-    to: string;
-    e: ServedEncode;
-    /** The export has no sound. */
-    noSound: boolean;
-    /** The project, whose part cache keeps the served file; absent: made every time. */
-    root?: string | undefined;
-}): Promise<ServedAudio>;
-//# sourceMappingURL=served.d.ts.map

package/node_modules/@allyhub-next/render/dist/served.js

@@ -1,2 +0,0 @@
-/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{createHash as d}from"node:crypto";import{copyFile as v,readFile as b,rm as S}from"node:fs/promises";import{PROFILES as w,profileOf as f}from"@allyhub-next/video-core";import{ffmpegVersion as x}from"./ffmpeg.js";import{PartCache as _}from"./parts.js";import{ffmpegOf as y,runFfmpegWith as p}from"./tools.js";export const servedPlatforms=()=>w.filter(t=>f(t)?.served!==void 0),servedEncodeOf=t=>f(t)?.served;async function k(t){try{const{out:o}=await p(t,["-hide_banner","-encoders"],void 0,!0);return/\baac_at\b/.test(o.toString())}catch{return!1}}export async function encodeServed(t){const o=await y(t),{e}=t,a=e.video,u=`scale=${String(a.width)}:${String(a.height)}:force_original_aspect_ratio=decrease,pad=${String(a.width)}:${String(a.height)}:(ow-iw)/2:(oh-ih)/2,fps=${String(a.fps)}`,i=e.audio.codec==="aac"||await k(o),r=t.noSound?{missing:"the export has no sound",instead:"no sound is measured"}:i?{codec:e.audio.codec,kbps:e.audio.kbps,rate:e.audio.rate,channels:e.audio.channels}:{missing:`this ffmpeg has no HE-AAC encoder (aac_at, macOS's AudioToolbox), so the sound is not ${e.audio.codec} at ${String(e.audio.kbps)} kbit/s`,instead:"the export's own sound (AAC-LC), copied: what is measured of the sound is the export's"},s=["-b:a",`${String(e.audio.kbps)}k`,"-ar",String(e.audio.rate),"-ac",String(e.audio.channels)],m=t.noSound?["-an"]:i?e.audio.codec==="aac"?["-c:a","aac",...s]:["-c:a","aac_at","-profile:a",e.audio.codec==="he-aac-v2"?"28":"4",...s]:["-c:a","copy"],n=["-map","0:v:0",...t.noSound?[]:["-map","0:a:0"],"-vf",u,"-c:v","libx264","-profile:v",a.profile,"-preset",a.preset,"-b:v",`${String(a.kbps)}k`,"-pix_fmt","yuv420p",...m,"-map_metadata","-1","-fflags","+bitexact","-flags:v","+bitexact","-flags:a","+bitexact","-movflags","+faststart"],c=async l=>{await p(o,["-v","error","-y","-i",t.from,...n,l])};if(t.root===void 0||process.env.ALLYHUB_PART_CACHE==="off")return await c(t.to),r;const g=d("sha256").update(JSON.stringify(["served",d("sha256").update(await b(t.from)).digest("hex"),n,await x(o)])).digest("hex"),h=await _.of(t.root).segment(g,"mp4",c);return await S(t.to,{force:!0}),await v(h.file,t.to),r}

package/node_modules/@allyhub-next/render/package.json

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

package/node_modules/@allyhub-next/runtime/dist/compose.js

@@ -1,2 +0,0 @@
-/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{contentEdges as Se,fact as ye,intersect as ze,problem as ge,RULES as Ne,STRUCTURE as be,toFrame as Re,showLayer as we}from"@allyhub-next/video-core";import{realTimers as Ce}from"./guards.js";export const isFootage=t=>t.__allyhubLayer==="footage",zOf=t=>t.z==="behind-person"||t.z==="overlay"?t.z:"front",layerNames=t=>t.map(u=>isFootage(u)?"footage":u.component);export function resolveTimes(t,u,b){if(Array.isArray(t))return t.map(c=>resolveTimes(c,u,b));if(u===!0)return typeof t=="string"||typeof t=="number"?b(t):t;if(typeof t!="object"||t===null)return t;const p={...t};for(const[c,m]of Object.entries(u))c in p&&p[c]!==void 0&&(p[c]=resolveTimes(p[c],m,b));return p}export function windowOf(t,u,b){const p=x=>Math.min(Math.max(x,0),u),c=p(t.at===void 0?0:b(t.at)),m=t.until!==void 0?p(b(t.until)):t.dur!==void 0?p(c+t.dur):u;return[c,m]}export function planStack(t){const u=t.some(n=>!isFootage(n)&&zOf(n)==="behind-person"),b=u?t.findIndex(n=>isFootage(n)&&n.file===void 0):-1,p=n=>b>=0&&!isFootage(n)&&zOf(n)==="behind-person",c=n=>n!==void 0&&!isFootage(n)&&zOf(n)==="overlay",m=[];t.forEach((n,r)=>{isFootage(n)?(m.push(r),r===b&&t.forEach((v,E)=>{p(v)&&m.push(E)})):!p(n)&&!c(n)&&m.push(r)}),t.forEach((n,r)=>{c(n)&&m.push(r)});const x=[],y=new Map,j=new Map;let S;for(const n of m){const r=t[n];if(!r)continue;if(isFootage(r)){S=void 0,j.set(n,x.length);continue}const v=p(r)?"behind":c(r)?"overlay":"front";S!==v&&(x.push({layers:[],...v==="behind"?{behindPerson:!0}:{},...v==="overlay"?{overlay:!0}:{}}),S=v),y.set(n,x.length-1)}return{takeAt:b,hasBehind:u,order:m,planes:x,planeOf:y,overOf:j,overlaid:n=>c(t[n])}}const Le={captions:()=>[],face:()=>{},faces:()=>[],texts:()=>[]};export function layerContexts(t,u,b,p,c){const{log:m,ledger:x,embed:y,combo:j}=t,{look:S,format:n,dims:r}=u,v=[[0,0,r.width,r.safe.top],[0,r.height-r.safe.bottom,r.width,r.safe.bottom],[0,0,r.safe.left,r.height],[r.width-r.safe.right,0,r.safe.right,r.height]].filter(i=>i[2]>0&&i[3]>0),E=Se(r),U=[E.left,E.top,E.right-E.left,E.bottom-E.top],ee=i=>{if(!c)throw new Error(`"${i}": a page has no film to find it in.`);return c.filmAt(i)};return i=>{const D=i.reads??Le,B=i.record??(()=>{}),z=i.place,H=i.answers,I={look:S,format:n,dims:r,combo:i.combo??j,dur:i.dur,asset:a=>m.asset(a),optionalAsset:a=>m.optionalAsset(a),words:i.words,at:i.at,layer:{start:i.start,end:i.end},wait:a=>{x.wait(a)},report:a=>{const A=x.running,W=a.code in Ne?a.code:"AK-R001",_=A?.part??z?.part;x.ran(ge(W,a.message,{...a.level?{level:a.level}:{},..._?{part:_}:{},...A?.t===void 0?{}:{t:A.t}}))},captions:a=>D.captions(a),face:(a,A)=>D.face(a,A),faces:a=>D.faces(a),texts:a=>D.texts(a),covered:v,content:U,video:(a,A)=>b.video(a,A,B),cameraFor:a=>y?.cameras?.[a]??y?.cameras?.["*"],...y?.sceneryScale===void 0?{}:{sceneryScale:y.sceneryScale},embedded:y!==void 0,get layoutOnly(){return p.mode==="layout"},realTimers:Ce,...H?{answer:(a,A)=>{H.set(a,A)}}:{}};return z&&Object.defineProperty(I,"film",{enumerable:!0,get:()=>(B("film",String(z.start)),{start:z.start,part:z.part,at:ee,...y?.shown?{outer:y.shown}:{}})}),I}}const Te=t=>Math.max(0,t-.4),ae=t=>Math.round(t*1e3)/1e3,ke=t=>Math.round(t*1e6)/1e6;export function compose(t){const{env:u,piece:b,stage:p,takes:c,film:m,captions:x,footage:y,sound:j}=t,{source:S,options:n,combo:r,picked:v,ledger:E}=u,{fps:U,format:ee,dims:i}=b,{specs:D}=c,{timing:B,windows:z}=m,H=[],I=[],a=[],A=n.purpose==="play",W=new Set,_=(w,o)=>{const d={};for(const[g,M]of Object.entries(r)){if(!v.has(g)||g===o){d[g]=M;continue}Object.defineProperty(d,g,{enumerable:!0,get:()=>(W.has(`${w}:${g}`)||(W.add(`${w}:${g}`),E.problems.push(ge("AK-X005",`A layer of part ${w} reads ctx.combo.${g}, ${g===be?"the combo's structure":`the pick of the slot ${g}`}. A part is rendered once and reused in every combo that has it, so it may read only the dimensions${o===void 0?"":` and its own slot (${o})`}. Choose in the output's function instead, and pass the result as a prop.`,{part:w,where:{file:S.file}}))),M)})}return d};for(const[w,o]of D.entries()){const d=B.parts[w];if(!d)continue;const g=d.end-d.start,M=e=>B.at(w,e),xe=x.partWords(o.key),ve=c.results[w]?.speech,ce=c.inputs[w],ie=ce?.placed??[],de=[...ie,...(ce?.anchors??[]).filter(e=>!ie.some(s=>s.name===e.name))],X=c.speechFor(w,d);let F;if(typeof o.still=="function")F=o.still(g);else if(o.still===void 0){F=Te(g);const e=z.get(w),s=z.get(w+1);if(e||s){const l=(e?.after??0)/U,k=g-((s?.before??0)+1)/U;F=Math.max(l,Math.min(F,k))}}else F=M(o.still);let q=Re(d.start+F,U);(q<d.start||q>=d.end)&&(q=d.start);const te=o.slot??(v.has(o.key)&&o.key!==be?o.key:void 0),Ee=v.size>0?_(o.key,te):r,se={reads:new Map,captioned:!1},oe=planStack(o.layers),{takeAt:ne,planes:K,planeOf:re,overOf:fe,order:pe}=oe,J=o.layers,N=c.videoTakes[w],h={key:o.key,...o.title===void 0?{}:{title:o.title},...te===void 0?{}:{slot:te},layers:layerNames(J),start:d.start,end:d.end,planes:K,still:q,...X.speech?{speech:X.speech}:{},...de.length>0?{anchors:de.map(e=>({name:e.name,at:ae(d.start+M(`@${e.name}`)),...e.end===void 0?{}:{end:ae(d.start+M(`@/${e.name}`))}}))}:{},...o.tags?.length?{tags:[...o.tags]}:{},...o.post?{post:{filter:o.post.filter}}:{},...o.speechGainDb!==void 0&&o.speechGainDb!==0?{speechGainDb:o.speechGainDb}:{},...N?{plays:{video:N.id,from:N.from,to:N.to}}:{}};H.push(h),j.addSpeech(X.clips,X.room);const $=document.createElement("section");$.className="ak-part",$.dataset.key=o.key,$.dataset.format=ee,Object.assign($.style,{position:"absolute",inset:"0",overflow:"hidden"}),we($,!1),p.el.append($);const Q=new Map;A&&J.forEach((e,s)=>{if(!isFootage(e))return;const l=document.createElement("div");l.className="ak-footage-plane",Object.assign(l.style,{position:"absolute",inset:"0",...(fe.get(s)??0)>0?{pointerEvents:"none"}:{}}),Q.set(s,l)});let R;Q.size>0&&ne>=0&&(R=document.createElement("div"),R.className="ak-cutout-plane",Object.assign(R.style,{position:"absolute",inset:"0",pointerEvents:"none"}));const Ae={captions:e=>(se.captioned=!0,x.partCues(d.start,d.end,e)),face:(e,s)=>y.faceAt(o.key,d.start+e,s),faces:e=>y.facesAt(o.key,d.start+e)},V=[],le=new Map,Oe=J.some(e=>!isFootage(e));for(const[e,s]of J.entries()){const[l,k]=windowOf(s,g,M);if(isFootage(s)){const P=e===ne,Z=y.plan(s,h,ve,d.speechAt,l,k,{at:M,cutout:P,over:fe.get(e)??0,graphics:Oe,person:P&&R!==void 0});if(Z&&A){const he=Q.get(e)??$,{matteUrl:me,personOver:$e,...je}=Z;a.push({...je,host:he,...me===void 0?{}:{cutoutIn:{host:$e&&R?R:he,matte:me}}})}continue}const f=zOf(s),C=re.get(e)??0;K[C]?.layers.push({component:s.component,start:ke(h.start+l),end:ke(h.start+Math.max(l,k))});const O=document.createElement("div");O.className="ak-layer",O.dataset.component=s.component,Object.assign(O.style,{position:"absolute",inset:"0"}),we(O,!1),le.set(e,O);const T=s.times?resolveTimes(s.props,s.times,M):s.props,Y=V.slice(),ue=new Map,Me=t.contexts({dur:g,words:()=>xe,at:M,start:l,end:k,combo:Ee,reads:{...Ae,texts:P=>t.texts({part:h,el:$},Y,P)},record:(P,Z)=>se.reads.set(P,Z),place:{start:h.start,part:o.key},answers:ue});V.push({spec:s,index:e,props:T,el:O,ctx:Me,start:l,end:k,z:f,plane:C,answers:ue})}let G=$,L;if(K.some(e=>e.overlay===!0)){G=document.createElement("div"),L=document.createElement("div"),G.className="ak-picture",L.className="ak-overlays";for(const e of[G,L])Object.assign(e.style,{position:"absolute",inset:"0",overflow:"hidden"}),$.append(e)}pe.forEach((e,s)=>{const l=Q.get(e)??le.get(e);l&&(L&&oe.overlaid(e)?L:G).append(l);const k=re.get(e),f=pe[s+1];R&&k!==void 0&&K[k]?.behindPerson===!0&&(f===void 0||re.get(f)!==k)&&G.append(R)}),j.sfx(o,h,M),N&&j.carry(N.inner,N.from,N.to,h.start,h.key,0);for(const e of V){const s=c.shownBy.get(e.spec);s&&(s.shown.start=h.start+e.start,s.shown.partStart=h.start,s.shown.from=s.from,s.shown.to=s.from+(e.end-e.start)*s.speed,s.shown.speed=s.speed,s.audio!==void 0&&s.speed===1&&j.carry(s.inner,s.from,s.shown.to,h.start+e.start,h.key,s.audio))}K.forEach((e,s)=>{const l=e.layers.filter(f=>f.end>f.start),k=y.placed.flatMap(f=>{if(f.part!==h.key||(f.over??0)<=s)return[];if(!l.some(O=>O.end>f.start&&O.start<f.end))return[];let C;for(const O of f.boxes?f.boxes.map(T=>T.box):[f.box]){const T=ze(O,[0,0,i.width,i.height]),Y=T?ae(T[2]*T[3]/(i.width*i.height)):0;(!C||Y>C.frame)&&(C={box:O,frame:Y})}return C?[{file:f.file,start:f.start,end:f.end,...C}]:[]});k.length!==0&&E.facts.push(ye("graphics-under-footage",{piece:S.piece,part:o.key,t:h.start},{layers:l,footage:k,covered:Math.max(...k.map(f=>f.frame))}))}),oe.hasBehind&&ne<0&&E.facts.push(ye("fallback",{piece:S.piece,part:o.key},{missing:"own-footage",for:"behind-person",fallback:"in-front"})),I.push({part:h,spec:o,n:w,el:$,picture:G,...L?{overlays:L}:{},layers:V,record:se})}return{parts:H,mounted:I,clips:a}}

package/node_modules/@allyhub-next/runtime/dist/footage.d.ts

@@ -1,54 +0,0 @@
-import { type FaceOnFrame, type FootageLayer, type IndexNeed, type Part, type PixelRect, type TimelineFootage } from "@allyhub-next/video-core";
-import type { CaptionTrack } from "./captions.js";
-import type { Env } from "./env.js";
-import type { ResolvedPiece } from "./piece.js";
-import type { ResolvedSpeech } from "./speech.js";
-/** A footage layer as planned: the timeline's entry and what the player needs to draw it. */
-export interface FootagePlan extends TimelineFootage {
-    /** Where the stage loads the video. */
-    url: string;
-    /** The video's length, seconds, if known. */
-    duration?: number;
-    /** The video's pixels, if known. */
-    source?: {
-        width: number;
-        height: number;
-    };
-    /** Where the stage loads the background's image. */
-    imageUrl?: string;
-    /** The file's person matte, when the player draws the person cut out (over graphics behind them, or over a treated background). */
-    matteUrl?: string;
-    /** The person is drawn over the part's graphics behind them, not over the layer's own background. */
-    personOver?: boolean;
-}
-export interface FootageLayerPlace {
-    /** A word reference of the part, in seconds from its start. */
-    at: (ref: unknown) => number;
-    /** The part's own take, whose speaker is drawn again over the behind-person graphics. */
-    cutout: boolean;
-    /** How many of the part's graphics planes are under it. */
-    over: number;
-    /** The part draws graphics: over its own take they need the face. */
-    graphics: boolean;
-    /** The player draws the speaker cut out over the behind-person graphics. */
-    person: boolean;
-}
-export interface FootagePlanner {
-    /** Plans a footage layer of a part; undefined, with its problem, when it shows nothing. */
-    plan(l: FootageLayer, part: Part, sp: ResolvedSpeech | undefined, speechAt: number | undefined, start: number, end: number, more: FootageLayerPlace): FootagePlan | undefined;
-    /** Every footage layer planned, in film order. */
-    readonly placed: readonly FootagePlan[];
-    /** What the media index lacks for this output (Timeline.index). */
-    needs(): IndexNeed[];
-    /** Whether a part shows footage whose speaker moves: a face track or a person matte. */
-    speakerIn(partKey: string): boolean;
-    /** A face on the frame at film time t, from the topmost footage showing then: face `id`, by default that layer's speaker. */
-    faceAt(partKey: string, t: number, id?: number): PixelRect | undefined;
-    /** Every face on the frame at film time t, from the topmost footage showing then with any. */
-    facesAt(partKey: string, t: number): FaceOnFrame[];
-}
-/** The footage planner; `cssColor` resolves a colour as the stage draws it. */
-export declare function footagePlanner(env: Env, piece: ResolvedPiece, captions: CaptionTrack, cssColor: (color: string) => string): FootagePlanner;
-/** The footage plan as the timeline holds it: without what only the player reads. */
-export declare function timelineFootage(p: FootagePlan): TimelineFootage;
-//# sourceMappingURL=footage.d.ts.map

package/node_modules/@allyhub-next/runtime/dist/footage.js

@@ -1,2 +0,0 @@
-/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{backdropUnit as he,fact as Ue,faceAt as $e,faceOnFrame as pe,facesOnFrame as Ce,forOrient as le,fromEdited as Fe,hasFace as Pe,keyAt as me,MATTE_FEATHER as Oe,MATTE_SHRINK as Se,parsePunch as Ke,pixelRect as Le,placeFootage as Re,problem as Q,pullbackKeys as _e,PULLBACK_DUR as je,PULLBACK_SCALE as Te,PUNCH_CENTER as ke,PUNCH_SCALE as Be,punchKeys as De,REFRAME_FALLBACK as Ne,reframePath as Ge,reframeWindow as ze,sourceAt as He,toFrame as V}from"@allyhub-next/video-core";import{isBoxKeys as Ie}from"./embed.js";import{LoadFailure as We}from"./errors.js";const Je=/\.(png|jpe?g|webp)$/i,Ye=t=>(t.blur??0)>0||(t.dim??0)>0||(t.desaturate??0)>0||t.color!==void 0||t.image!==void 0,S=t=>Math.round(t*1e3)/1e3;export function footagePlanner(t,ge,be,xe){const{source:$,ledger:K,embed:ye}=t,{dims:f,fps:G}=ge,b=[],L=new Map,X=new Set,z=new Map,R=(e,n)=>{const o=z.get(e)??{file:e};o[n]=!0,z.set(e,o)},_=(e,n)=>{K.facts.push(Ue("fallback",{piece:$.piece,part:e},n))},we=(e,n,o)=>{const d=he(f.width,f.height),c=l=>Math.round(l*d*1e3)/1e3;let r;if(e.image!==void 0){if(r=t.mediaOf(e.image,o),r.sha256==="")return;if(r.kind!=="image"||!Je.test(r.path)){K.problems.push(Q("AK-A003",`The background image ${r.path} of footage() in part ${n} is not a PNG, JPEG or WebP image.`,{part:n,where:{file:$.file}}));return}}let u;if(e.color!==void 0){const l=CSS.supports("color",e.color)?xe(e.color):void 0;if(l===void 0)throw new Error(`footage() background color ${JSON.stringify(e.color)} in part ${n} is not a CSS color.`);u=l.length===9&&l.endsWith("00")?"transparent":l}return{backdrop:{...e.blur?{blur:c(e.blur)}:{},...e.dim?{dim:e.dim}:{},...e.desaturate?{desaturate:e.desaturate}:{},...u===void 0?{}:{color:u},...r?{image:r.path}:{},feather:c(e.feather??Oe),shrink:c(e.shrink??Se)},...r?{imageUrl:r.url}:{}}};return{plan:(e,n,o,d,c,r,u)=>{const l=e.file,x=l===void 0;let a;if(x){if(!o){K.problems.push(Q("AK-A001",`footage() in part ${n.key} names no file, so it shows the part's take, and the part has no take. Give footage a file, or give the part speech: take("./clip.mp4").`,{part:n.key,where:{file:$.file}}));return}a=o.media}else a=t.mediaOf(l,e.base);if(a.sha256==="")return;if(a.kind!=="video"){K.problems.push(Q("AK-A003",x?`footage() in part ${n.key} shows the part's take, and ${a.path} is not a video. Give footage a file, or take a video.`:`The footage ${a.path} in part ${n.key} is not a video (mp4, webm or mov).`,{part:n.key,where:{file:$.file}}));return}const k=V(n.start+c,G),j=V(n.start+r,G);if(j<=k)return;a.faces&&L.set(a.path,a.faces),a.matte===!0&&X.add(a.path);let C,F;if(x&&o&&d!==void 0){const i=o.ranges??[{from:o.from,to:o.from+o.dur}];if(C=S(Fe(i,k-d)),o.ranges&&o.ranges.length>1){const h=[{at:k,from:C}];let U=0;for(const v of o.ranges){const p=S(d+U);U>0&&p>k+1e-6&&p<j&&h.push({at:p,from:v.from}),U+=v.to-v.from}h.length>1&&(F=h)}}else C=Math.max(0,typeof e.from=="number"?e.from:0);const y=a.width!==void 0&&a.height!==void 0?{width:a.width,height:a.height}:void 0,Z=e.fit??"cover",H=le(e.box,f.orient),ee=le(e.crop,f.orient),te=Ie(H)?H:void 0,T=te?.map(i=>({t:V(n.start+Math.min(Math.max(u.at(i.t),c),r),G),box:i.box==="full"?[0,0,f.width,f.height]:Le(i.box,f.width,f.height),...i.ease?{ease:i.ease}:{}})).sort((i,h)=>i.t-h.t),Ae=te?"full":H??"full",P=T?.[0],M=Re({box:P?[P.box[0]/f.width,P.box[1]/f.height,P.box[2]/f.width,P.box[3]/f.height]:Ae,fit:Z,...ee?{crop:ee}:{},...y?{source:y}:{},frame:f}),ne=e.shape==="circle"||!e.radius?0:S(Math.min(e.radius*he(f.width,f.height),M.box[2]/2,M.box[3]/2));let I=M.crop,ae=M.picture,w,W;const oe=e.punchIn??[],A=e.pullback===void 0||e.pullback===!1?void 0:e.pullback===!0?{}:e.pullback;if((e.reframe!==void 0||oe.length>0||A)&&y){const i=M.box,h=ze(y,{w:i[2],h:i[3]}),U=typeof e.reframe=="object"&&"face"in e.reframe?e.reframe:void 0,v=e.reframe==="face"||U!==void 0;v&&!a.faces&&(R(a.path,"faces"),_(n.key,{file:a.path,missing:"face-track",for:"reframe",fallback:"centred"}));const p=a.faces,ie=e.speaker??p?.speaker;p&&e.speaker!==void 0&&!Pe(p,e.speaker)&&_(n.key,{file:a.path,missing:"face",face:e.speaker,for:"speaker",fallback:"centred"});const ve=typeof e.reframe=="object"&&"x"in e.reframe?e.reframe:v?Ne:{x:.5,y:.5},ce={start:k,end:j,from:C,speed:x?1:e.speed??1,...F?{cuts:F}:{}};w=Ge({track:v?p:void 0,speaker:ie,faceY:U?.faceY,focus:ve,window:h,source:y,layer:ce});const B=w[0]??{x:0,y:0};I=[B.x,B.y,h.w,h.h],ae=[...i],w.length<=1&&(w=void 0);const D=w,fe=(s,g)=>{if(g)return{cx:g.x,cy:g.y};const m=p?$e(p,He(ce,s),ie):void 0;if(!m)return{cx:ke.x,cy:ke.y};const q=D?me(D.map(O=>({t:O.t,v:O.x})),s):B.x,N=D?me(D.map(O=>({t:O.t,v:O.y})),s):B.y,Me=(m[0]+m[2]/2-q)/h.w,Ee=(m[1]+m[3]/2-N)/h.h;return{cx:S(Math.min(Math.max(Me,0),1)),cy:S(Math.min(Math.max(Ee,0),1))}},Y=[];for(const s of oe){const g=typeof s=="object"?{...s,ref:s.at}:{...Ke(String(s)),until:void 0},m=u.at(g.ref),q=g.until!==void 0?u.at(g.until):be.wordEnd(n.key,m),N=n.start+m;Y.push({start:N,end:n.start+Math.max(q,m),scale:g.scale??Be,...fe(N,typeof s=="object"?s.center:void 0),...typeof s=="object"&&s.in!==void 0?{in:s.in}:{},...typeof s=="object"&&s.out!==void 0?{out:s.out}:{},...typeof s=="object"&&s.ease!==void 0?{ease:s.ease}:{}})}const de=Y.length>0?De(Y):[],ue=A?_e(k,{scale:A.scale??Te,dur:A.dur??je,...fe(k,A.center),...A.ease?{ease:A.ease}:{}},de):de;ue.length>0&&(W=ue)}x&&u.graphics&&!a.faces&&R(a.path,"faces");let J=!1;u.cutout&&(a.matte===!0?J=!0:(R(a.path,"matte"),_(n.key,{file:a.path,missing:"person-matte",for:"behind-person",fallback:"in-front"})));let E;if(e.background&&Ye(e.background)){const i=we(e.background,n.key,e.base);i&&a.matte===!0?E=i:i&&(R(a.path,"matte"),_(n.key,{file:a.path,missing:"person-matte",for:"background",fallback:"unprocessed"}))}if(ye)throw new We("embedded_footage",`${$.piece}'s part ${n.key} plays ${a.path}: a video shown inside another (a scenery's screen, a part's video take, a footage of a video item) draws its graphic layers only, not footage yet.`);const re=J&&u.person,se={part:n.key,file:a.path,start:k,end:j,from:C,speed:x?1:e.speed??1,gainDb:e.gainDb??0,audio:(e.audio??!1)&&a.audio===!0,...x?{take:!0}:{},fit:Z,box:M.box,...I?{crop:I}:{},picture:ae,...F?{cuts:F}:{},...w?{pan:w}:{},...W?{zoom:W}:{},...T&&T.length>1?{boxes:T}:{},...u.over>0?{over:u.over}:{},...J?{cutout:!0}:{},...e.sharpen?{sharpen:e.sharpen}:{},...E?{background:E.backdrop}:{},...E?.imageUrl?{imageUrl:E.imageUrl}:{},...(re||E)&&a.matteUrl?{matteUrl:a.matteUrl}:{},...re?{personOver:!0}:{},...e.shape==="circle"?{shape:"circle"}:{},...ne>0?{radius:ne}:{},...e.speaker===void 0?{}:{speaker:e.speaker},url:a.url,...a.duration===void 0?{}:{duration:a.duration},...y?{source:y}:{}};return b.push(se),se},placed:b,needs:()=>[...z.values()],speakerIn:e=>b.some(n=>n.part===e&&(L.has(n.file)||X.has(n.file))),faceAt(e,n,o){for(let d=b.length-1;d>=0;d--){const c=b[d];if(c?.part!==e||n<c.start||n>=c.end)continue;const r=L.get(c.file);if(!r)continue;const u=o===void 0?pe(c,r,n):pe(c,r,n,o);if(u)return u}},facesAt(e,n){for(let o=b.length-1;o>=0;o--){const d=b[o];if(d?.part!==e||n<d.start||n>=d.end)continue;const c=L.get(d.file);if(!c)continue;const r=Ce(d,c,n);if(r.length>0)return r}return[]}}}export function timelineFootage(t){return{part:t.part,file:t.file,start:t.start,end:t.end,from:t.from,speed:t.speed,gainDb:t.gainDb,audio:t.audio,...t.take?{take:!0}:{},fit:t.fit,box:t.box,...t.crop?{crop:t.crop}:{},picture:t.picture,...t.cuts?{cuts:t.cuts}:{},...t.pan?{pan:t.pan}:{},...t.zoom?{zoom:t.zoom}:{},...t.boxes?{boxes:t.boxes}:{},...t.over?{over:t.over}:{},...t.cutout?{cutout:!0}:{},...t.sharpen?{sharpen:t.sharpen}:{},...t.background?{background:t.background}:{},...t.shape?{shape:t.shape}:{},...t.radius?{radius:t.radius}:{},...t.speaker===void 0?{}:{speaker:t.speaker}}}

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

@@ -1,2 +0,0 @@
-/*! 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 d,lineAnchors as m,messageList as A,problem as h,repoPath as u,speakOf as w,textsOf as p,hasMarks as k,withoutMarks as O}from"@allyhub-next/video-core";import{TEXT_DIR as v}from"@allyhub-next/formats";const $="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??v}/${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);this.messages.set(t,{key:t,kind:e,fallback:n,...i?{hint:i}:{}}),e!=="list"&&s===void 0&&this.problems.push(h("AK-S001",`The code reads ${t}, but the default language ${this.opts.defaultLang??"(no messages)"} does not have it. Add it to ${this.fileOf(this.opts.defaultLang)}.`,{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=d(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:d(i,e.inputs),...s&&i!==void 0?{anchors:m(i,s,n=>d(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(h("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(h("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:$,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(h("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(h("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(h("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=r=>r.replace(/[\s\p{Cf}]+/gu,""),i=e(t);if(i==="")return[];const s=[],n=[];for(const r of this.messages.values()){const f=p(this.peek(r.key)).flatMap(o=>k(o)?[o,O(o)]:[o]).map(e);f.includes(i)?s.push(r.key):f.some(o=>o.includes(i))&&n.push(r.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/node_modules/@allyhub-next/runtime/package.json

@@ -1,21 +0,0 @@
-{
-  "name": "@allyhub-next/runtime",
-  "version": "0.4.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/node_modules/@allyhub-next/runtimes/dist/lock.d.ts

@@ -1,6 +0,0 @@
-export interface LockOptions {
-    signal?: AbortSignal | undefined;
-    pollMs?: number;
-}
-export declare function withLock<T>(path: string, run: () => Promise<T>, options?: LockOptions): Promise<T>;
-//# sourceMappingURL=lock.d.ts.map

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

@@ -1,2 +0,0 @@
-/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
-import{setTimeout as s}from"node:timers/promises";import{lock as c}from"proper-lockfile";export async function withLock(r,i,l={}){const{signal:e,pollMs:f=150}=l;let t,a;for(;;){e?.throwIfAborted();try{a=await c(r,{lockfilePath:r,realpath:!1,onCompromised:o=>{t=o}});break}catch(o){if(o.code!=="ELOCKED")throw o;await s(f,void 0,e?{signal:e}:{})}}try{const o=await i();if(t)throw t;return o}finally{t||await a()}}

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

@@ -1,63 +0,0 @@
-import { type Platform, type RuntimeManifest } from "@allyhub-next/protocol";
-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;
-}
-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/node_modules/@allyhub-next/runtimes/dist/runtimes.js

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

package/node_modules/@allyhub-next/runtimes/package.json

@@ -1,18 +0,0 @@
-{
-  "name": "@allyhub-next/runtimes",
-  "version": "0.4.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"
-}