allyhub 0.3.0 → 0.5.0

package/dist/node_modules/@allyhub-next/media/dist/index.d.ts

@@ -0,0 +1,37 @@
+export { MediaError, type MediaErrorCode } from "./errors.js";
+export type { Progress } from "./progress.js";
+export { ensureRuntime, ffmpegPath, ffprobePath, formatBytes, programPath, runtimesOf, type ToolOptions, } from "./tools.js";
+export { INDEX_DIR, cached, contentHash, entryDir, indexDir, type CacheOptions, } from "./cache.js";
+export { mapLimit } from "./run.js";
+export { mediaKindOf, probeMedia, readStreams, type AudioStream, type MediaKind, type MediaProbe, } from "./probe.js";
+export { frameAt, framesAt, probeVideo, type FrameOptions, type VideoInfo, } from "./video.js";
+export { toSpeechWav, type Stretch } from "./audio.js";
+export { fetchVideo, type Fetched } from "./fetch.js";
+export { VOICE_RATE, VOICE_SHAPE_DEFAULTS, semitones, voiceShape, type VoiceShape, type VoiceShapeOptions, } from "./voice-shape.js";
+export { transcribe, type CloudHearing, type TranscribeOptions, type Transcript, } from "./asr/transcribe.js";
+export { HEAR_PADS, hearAgain, type HeardWord, type Hearing, type Hearings, } from "./asr/hear.js";
+export { PARAKEET_LANGUAGES, requireLanguage, speaks, } from "./asr/languages.js";
+export { MODEL as ASR_MODEL, runtimeLoadError as asrRuntimeLoadError, status as asrStatus, type Status as AsrStatus, } from "./asr/parakeet.js";
+export { attachPunctuation, windowsToWords } from "./asr/words.js";
+export type { Window } from "./asr/windows.js";
+export { PICTURE_DEFAULTS, pictureStats, type PictureParams, type PictureStats, type ShakeSpectrum, } from "./picture.js";
+export { SHOT_DEFAULTS, SceneScorer, cutsWithin, pickShots, shotCurves, shotScoreAt, shots, type ShotCandidate, type ShotCurves, type ShotOptions, type ShotParams, type ShotPeak, type Shots, } from "./shots.js";
+export { ONSET_RATE, beats, decodeMono, detectOnsets, estimateTempo, matchOnsets, onsetNovelty, pickOnsets, type BeatOptions, type Beats, type Novelty, type Onset, type OnsetMatch, type OnsetOptions, type Tempo, } from "./beats.js";
+export { SECOND_PEAK_GUARD, SYNC_DEFAULTS, SYNC_RATE, soundLevel, syncOffset, syncSignals, type SoundLevel, type SyncFile, type SyncMeasure, type SyncOptions, type SyncParams, type SyncResult, type SyncWindow, } from "./sync.js";
+export { OCR_ENGINE, OCR_MODEL, ensureOcr, ocrStatus, } from "./ocr/tesseract.js";
+export { sampleTimes, screenText, type ScreenText, type ScreenTextOptions, type LowWord, type OcrConfidence, type TextFrame, type TextLine, } from "./ocr/text.js";
+export { OCR_CONFIDENCE_DEFAULTS } from "./ocr/lines.js";
+export { contactSheets, sheetHtml, secondsLabel, wordsBetween, type ContactSheet, type ContactSheetOptions, type DrawHtml, type SheetCell, type SheetLayout, type SheetRow, } from "./sheet.js";
+export { GridError, GRID_WIDTH, MAX_TILES, defaultCols, gridHtml, gridLayout, labelSize, pixelGridHtml, pixelGridSvg, stretchFrames, type FrameStretch, type GridCell, type GridPicture, type Tile, } from "./grid.js";
+export { trackFaces, type FacesOptions } from "./vision/faces.js";
+export { personMatte, MATTE_LONG_SIDE } from "./vision/matte.js";
+export { indexMedia, type IndexOptions, type FaceExtent, type IndexResult, } from "./vision/index-media.js";
+export { facesPath, hasMatte, mediaIndexDir, matteInfoPath, mattePath, readFaceTrack, readMatteInfo, type MatteInfo, } from "./vision/cache.js";
+export type { FaceSample, FaceTrack, TrackedFace } from "./vision/types.js";
+export { visionStatus, type VisionStatus } from "./vision/status.js";
+export { runtimeLoadError as visionRuntimeLoadError } from "./vision/runtime.js";
+export { DEFAULT_SAMPLE_FPS, type VisionOptions } from "./vision/common.js";
+export type { Provider as VisionProvider } from "./vision/protocol.js";
+export { FACE_MODEL, MATTE_MODEL, type VisionModel } from "./vision/models.js";
+export { LOCAL_PACKS, PACK_RUNTIMES, installPack, localPacks, removePack, type InstallOptions as PackInstallOptions, type LocalPack, type LocalPackId, type PackProgress, } from "./local.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/node_modules/@allyhub-next/media/dist/local.d.ts

@@ -0,0 +1,39 @@
+import { type ToolOptions } from "./tools.js";
+export declare const LOCAL_PACKS: readonly ["speech", "people", "reference"];
+export type LocalPackId = (typeof LOCAL_PACKS)[number];
+/** Each pack's runtimes in the runtime manager's manifest. */
+export declare const PACK_RUNTIMES: Readonly<Record<LocalPackId, readonly string[]>>;
+/** What runs each pack's models, which AllyHub does not install with itself. */
+export declare const PACK_ENGINES: Readonly<Record<LocalPackId, string>>;
+export interface LocalPack {
+    id: LocalPackId;
+    /** Every part of it is on this computer. */
+    installed: boolean;
+    /** What its downloads take on disk once installed (bytes). */
+    bytes: number;
+    /** What installing it would download now (bytes). */
+    download: number;
+    /** The folders it lives in; removing it removes them. */
+    dirs: string[];
+    /** Why it cannot run on this computer, if it cannot. */
+    unsupported?: string;
+}
+/** Each pack, what of it is installed and where; reads no model file, so it is quick. */
+export declare function localPacks(opts?: ToolOptions): Promise<LocalPack[]>;
+/** How far an install has come: what it is doing, and its bytes when it counts them. */
+export interface PackProgress {
+    message: string;
+    done?: number;
+    total?: number;
+}
+export interface InstallOptions {
+    runtimes?: ToolOptions["runtimes"];
+    packages?: ToolOptions["packages"];
+    signal?: AbortSignal;
+    onProgress?: (p: PackProgress) => void;
+}
+/** Downloads what of a pack is missing, as its analyses would on first use. */
+export declare function installPack(id: LocalPackId, opts?: InstallOptions): Promise<void>;
+/** Takes a pack's downloads off this computer; its analyses fetch them again when next needed. */
+export declare function removePack(id: LocalPackId, opts?: ToolOptions): Promise<void>;
+//# sourceMappingURL=local.d.ts.map

package/dist/node_modules/@allyhub-next/media/dist/local.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{MODEL_RUNTIME as f,RUNTIME as E,unsupportedReason as g}from"./asr/parakeet.js";import{OCR_MODEL as N,OCR_PACKAGE as A}from"./ocr/tesseract.js";import{ensureEngine as O,ensureRuntime as R,packagesOf as m,runtimesOf as d}from"./tools.js";import{FACE_MODEL as _,MATTE_MODEL as I}from"./vision/models.js";import{RUNTIME as M,unsupportedReason as h}from"./vision/runtime.js";export const LOCAL_PACKS=["speech","people","reference"],PACK_RUNTIMES={speech:[f],people:[_.runtime,I.runtime],reference:[N,"yt-dlp"]},PACK_ENGINES={speech:E,people:M,reference:A};const P={speech:{unsupported:g},people:{unsupported:h},reference:{unsupported:()=>{}}};export async function localPacks(o={}){const r=await d(o).status(),s=m(o);return LOCAL_PACKS.map(e=>{const a=PACK_RUNTIMES[e].map(n=>{const t=r.find(l=>l.name===n);if(!t)throw new Error(`The runtime manager has no runtime "${n}".`);return t}),u=a.find(n=>!n.available),c=P[e].unsupported()??(u?`${u.name} has no build for this computer.`:void 0),i=s.locate(PACK_ENGINES[e]),p=s.size(PACK_ENGINES[e]);return{id:e,installed:i!==void 0&&a.every(n=>n.installed),bytes:p+a.reduce((n,t)=>n+t.size,0),download:(i?0:p)+a.reduce((n,t)=>n+(t.installed?0:t.size),0),dirs:[...i?[i.dir]:[],...a.map(n=>n.dir)],...c?{unsupported:c}:{}}})}export async function installPack(o,r={}){const s={runtimes:r.runtimes,packages:r.packages,signal:r.signal,onProgress:e=>{r.onProgress?.({message:e.message,...e.done===void 0?{}:{done:e.done},...e.total===void 0?{}:{total:e.total}})}};await O(PACK_ENGINES[o],PACK_ENGINES[o],s);for(const e of PACK_RUNTIMES[o])await R(e,"model",e,s)}export async function removePack(o,r={}){const s=d(r);for(const e of PACK_RUNTIMES[o])await s.remove(e);await m(r).remove(PACK_ENGINES[o])}

package/dist/node_modules/@allyhub-next/media/dist/ocr/tesseract.d.ts

@@ -0,0 +1,62 @@
+import { type ToolOptions } from "../tools.js";
+export declare const OCR_ENGINE = "tesseract-5-eng-best-int";
+/** The model's runtime in the runtime manager's manifest. */
+export declare const OCR_MODEL = "tesseract-eng";
+/** What reads with that model, which AllyHub does not install with itself. */
+export declare const OCR_PACKAGE = "tesseract.js";
+/** A word as tesseract.js reports it. */
+export interface TesseractWord {
+    text: string;
+    confidence: number;
+    bbox: {
+        x0: number;
+        y0: number;
+        x1: number;
+        y1: number;
+    };
+}
+interface TesseractLine {
+    words: TesseractWord[];
+}
+export interface TesseractResult {
+    data: {
+        blocks: {
+            paragraphs: {
+                lines: TesseractLine[];
+            }[];
+        }[] | null;
+    };
+}
+/** The OCR child process's job (an environment variable) and its output lines. */
+export declare const OCR_JOB = "ALLYHUB_OCR_JOB";
+export declare const OCR_LINE = "@@allyhub-ocr ";
+export interface OcrJob {
+    /** PNG frames to read, in order. */
+    files: string[];
+    /** Tesseract workers at once. */
+    workers: number;
+    /** The folder holding eng.traineddata.gz. */
+    langPath: string;
+    /** The file tesseract.js loads from. */
+    engine: string;
+}
+export interface TesseractWorker {
+    setParameters(params: Record<string, string>): Promise<unknown>;
+    recognize(image: Buffer, options: Record<string, never>, output: {
+        blocks: true;
+        text: false;
+    }): Promise<TesseractResult>;
+    terminate(): Promise<unknown>;
+}
+/** Whether the English model is here. */
+export declare function ocrStatus(opts?: ToolOptions): Promise<{
+    model: boolean;
+}>;
+/** The file tesseract.js loads from, fetched first when missing. */
+export declare const ensureOcrEngine: (opts?: ToolOptions) => Promise<string>;
+/** The English model's folder, downloaded first when missing. */
+export declare function ensureOcr(opts?: ToolOptions): Promise<string>;
+/** Starts one OCR worker over the model in `langPath`. */
+export declare function startOcrWorker(engine: string, langPath: string): Promise<TesseractWorker>;
+export {};
+//# sourceMappingURL=tesseract.d.ts.map

package/dist/node_modules/@allyhub-next/media/dist/ocr/tesseract.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{pathToFileURL as s}from"node:url";import{MediaError as a,oneLine as i}from"../errors.js";import{ensureEngine as c,ensureRuntime as u,runtimesOf as l}from"../tools.js";export const OCR_ENGINE="tesseract-5-eng-best-int",OCR_MODEL="tesseract-eng",OCR_PACKAGE="tesseract.js",OCR_JOB="ALLYHUB_OCR_JOB",OCR_LINE="@@allyhub-ocr ";export async function ocrStatus(e={}){return{model:await l(e).locate(OCR_MODEL)!==void 0}}export const ensureOcrEngine=(e={})=>c(OCR_PACKAGE,"the OCR engine",e);export async function ensureOcr(e={}){return(await u(OCR_MODEL,"model","the English OCR model",e)).dir}export async function startOcrWorker(e,o){let r;try{const t=await import(s(e).href);r=t.default??t}catch(t){throw new a("install",`The OCR runtime (tesseract.js) does not load (${i(t)}).`,{hint:"Install AllyHub again.",cause:t})}const n=await r.createWorker("eng",1,{langPath:o,cacheMethod:"none",gzip:!0});return await n.setParameters({tessedit_pageseg_mode:"11",debug_file:"/dev/null"}),n}

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

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

package/dist/node_modules/@allyhub-next/media/dist/ocr/worker.js

@@ -0,0 +1,5 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{readFile as l}from"node:fs/promises";import{readWords as f}from"./lines.js";import{OCR_JOB as m,OCR_LINE as p,startOcrWorker as d}from"./tesseract.js";async function w(){const t=JSON.parse(process.env[m]??"{}"),s=[];try{const a=Math.max(1,Math.min(t.workers,t.files.length));for(let e=0;e<a;e++)s.push(await d(t.engine,t.langPath));let i=0;await Promise.all(s.map(async e=>{for(let r=i++;r<t.files.length;r=i++){const n=t.files[r];if(n===void 0)continue;const o=await e.recognize(await l(n),{},{blocks:!0,text:!1}),c=f(o);process.stdout.write(`${p}${JSON.stringify({i:r,read:c})}
+`)}}))}finally{await Promise.all(s.map(a=>a.terminate().catch(()=>0)))}}w().catch(t=>{process.stderr.write(`
+OCR failed: ${t instanceof Error?t.message:String(t)}
+`),process.exitCode=1});

package/dist/node_modules/@allyhub-next/media/dist/sheet.js

@@ -0,0 +1,14 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{framesAt as M,probeVideo as j}from"./video.js";const m=t=>t.replace(/[&<>"]/g,e=>({"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;"})[e]??e),k=t=>t[0]===137&&t[1]===80?"image/png":"image/jpeg";export function sheetHtml(t){const i=t.titleWidth??0,a=t.width-16-(i?i+8:0),s=Math.floor((a-8*(t.cols-1))/t.cols),d=Math.round(s/t.aspect),o=Math.max(11,Math.min(16,Math.round(s/18))),c=Math.max(11,Math.min(15,Math.round(s/19))),p=t.rows.map(g=>{const h=g.cells.map(r=>`<div class="cell"><div class="pic" style="height:${String(d)}px"><img src="data:${k(r.image)};base64,${r.image.toString("base64")}"></div><span class="label">${m(r.label)}</span>${r.text===void 0?"":`<div class="said">${m(r.text)||"&nbsp;"}</div>`}</div>`).join("");return`<div class="row">${i?`<div class="rowtitle" style="width:${String(i)}px">${m(g.title??"")}</div>`:""}<div class="cells" style="grid-template-columns:repeat(${String(t.cols)},${String(s)}px)">${h}</div></div>`}).join("");return`<!doctype html><html><head><meta charset="utf-8"><style>
+    * { box-sizing: border-box; }
+    body { margin: 0; padding: ${String(8)}px; width: ${String(t.width)}px; background: #18181b; color: #f4f4f5; font: ${String(c)}px/1.35 -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif; }
+    h1 { margin: 2px 0 ${String(8)}px; font-size: ${String(o+2)}px; font-weight: 600; }
+    .row { display: flex; gap: ${String(8)}px; margin-bottom: ${String(8)}px; align-items: flex-start; }
+    .rowtitle { flex: none; font-weight: 600; padding-top: 4px; }
+    .cells { display: grid; gap: ${String(8)}px; }
+    .cell { background: #27272a; border-radius: 4px; overflow: hidden; }
+    .pic { position: relative; background: #000; }
+    .pic img { width: 100%; height: 100%; object-fit: contain; display: block; }
+    .label { display: block; padding: 3px 6px; font-size: ${String(o)}px; font-weight: 600; font-variant-numeric: tabular-nums; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
+    .said { padding: 4px 6px 6px; min-height: ${String(Math.round(c*1.35*2+10))}px; color: #d4d4d8; }
+  </style></head><body>${t.title?`<h1>${m(t.title)}</h1>`:""}${p}</body></html>`}export function wordsBetween(t,e,i){return t.filter(a=>a.start>=e&&a.start<i).map(a=>a.text).join(" ")}export const secondsLabel=t=>`${t.toFixed(1)} s`;export function defaultStep(t){return t<=90?2:Math.ceil(t/90)*2}export async function contactSheets(t,e){const i=await j(t,e),a=e.step??defaultStep(i.duration),s=[];for(let l=a/2;l<i.duration;l+=a)s.push(l);s.length===0&&s.push(i.duration/2);const d=i.width/i.height,o=e.cols??(d<.8?6:d<=1.25?5:4),c=e.perSheet??30,p=e.width??1600,g=Math.floor((p-16-8*(o-1))/o),h=[];for(let l=0;l<s.length;l+=c){const r=s.slice(l,l+c),b=await M(t,r,{width:Math.min(i.width,Math.max(160,g*2)),format:"jpeg",runtimes:e.runtimes,signal:e.signal}),x=r.map(n=>({t:n,said:e.words?wordsBetween(e.words,n-a/2,n+a/2):""})),f=x.map((n,y)=>{const $=e.labelOf?.(n.t);return{image:b[y]??Buffer.alloc(0),label:`${secondsLabel(n.t)}${$?` · ${$}`:""}`,...e.words?{text:n.said}:{}}}),u=[];for(let n=0;n<f.length;n+=o)u.push({cells:f.slice(n,n+o)});const S=Math.floor(l/c)+1,w=Math.ceil(s.length/c),v=sheetHtml({...e.title?{title:w>1?`${e.title} (${String(S)}/${String(w)})`:e.title}:{},rows:u,cols:o,width:p,aspect:d});h.push({picture:await e.draw(v,p),tiles:x})}return h}

package/dist/node_modules/@allyhub-next/media/dist/tools.d.ts

@@ -0,0 +1,35 @@
+import { type Located, type Packages, type Runtimes } from "@allyhub-next/runtimes";
+import type { Progress } from "./progress.js";
+export interface ToolOptions {
+    /** The runtime manager to take programs and models from (default: the system's). */
+    runtimes?: Runtimes | undefined;
+    /** Where the engines come from (default: the system's). */
+    packages?: Packages | undefined;
+    signal?: AbortSignal | undefined;
+    onProgress?: ((p: Progress) => void) | undefined;
+}
+/** The runtime manager an analysis uses. */
+export declare const runtimesOf: (opts?: ToolOptions) => Runtimes;
+/** The packages an analysis takes its engines from. */
+export declare const packagesOf: (opts?: ToolOptions) => Packages;
+/** "670 MB", "35 MB", "94 kB". */
+export declare function formatBytes(bytes: number): string;
+/**
+ * A runtime of the manifest, downloaded and checked the first time: says
+ * what it fetches (`step`, `what`, its size and where it goes), then how
+ * far the download has come.
+ */
+export declare function ensureRuntime(name: string, step: Progress["step"], what: string, opts?: ToolOptions): Promise<Located>;
+/**
+ * What runs a model (onnxruntime-node, sherpa-onnx-node, tesseract.js), which
+ * AllyHub does not install with itself: fetched the first time, saying so.
+ * The file its name loads, for a worker to import.
+ */
+export declare function ensureEngine(name: string, what: string, opts?: ToolOptions): Promise<string>;
+/** One program of a runtime (ffmpeg's ffprobe), its path, the runtime got first when it is not here. */
+export declare function programPath(runtime: string, bin: string, opts?: ToolOptions): Promise<string>;
+/** ffmpeg, from the runtime manager. */
+export declare const ffmpegPath: (opts?: ToolOptions) => Promise<string>;
+/** ffprobe, from the runtime manager. */
+export declare const ffprobePath: (opts?: ToolOptions) => Promise<string>;
+//# sourceMappingURL=tools.d.ts.map

package/dist/node_modules/@allyhub-next/media/dist/tools.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{RuntimeError as w,createPackages as h,createRuntimes as $}from"@allyhub-next/runtimes";import{MediaError as s,oneLine as d}from"./errors.js";export const runtimesOf=(e={})=>e.runtimes??$(),packagesOf=(e={})=>e.packages??h();export function formatBytes(e){return e>=1e9?`${(e/1e9).toFixed(1)} GB`:e>=1e6?`${String(Math.round(e/1e6))} MB`:`${String(Math.max(1,Math.round(e/1e3)))} kB`}function g(e,o,n){return n instanceof s?n:n instanceof w?n.code==="cancelled"?new s("cancelled","Stopped.",{cause:n}):n.code==="unsupported"?new s("unsupported_platform",n.message,{cause:n}):n.code==="install"?new s("install",n.message,{cause:n}):new s("install",`Could not get ${o} (${d(n,300)}).`,{hint:n.code==="checksum"?"What was downloaded is not the pinned file; run it again, and report it if it keeps failing.":"Check the connection and run it again.",cause:n}):n instanceof Error&&n.name==="AbortError"?new s("cancelled","Stopped.",{cause:n}):new s("install",`Could not get ${e}: ${d(n)}`,{cause:n})}export async function ensureRuntime(e,o,n,a={}){const t=runtimesOf(a);try{const i=await t.locate(e);if(i)return i;const r=(await t.status()).find(c=>c.name===e);r&&a.onProgress?.({step:o,message:`Downloading ${n} (${formatBytes(r.size)}) into ${r.dir}, once.`,done:0,total:r.size,unit:"bytes"});let u=0,f=r?.size??0;const l=new Map;return await t.ensure(e,{signal:a.signal,onProgress:c=>{l.set(c.url,c.received),u=[...l.values()].reduce((p,m)=>p+m,0),f=Math.max(f,u),a.onProgress?.({step:o,message:`Downloading ${n}`,done:u,total:f,unit:"bytes"})}})}catch(i){throw g(e,n,i)}}export async function ensureEngine(e,o,n={}){const a=packagesOf(n);try{await a.ensure(e,{signal:n.signal,onFetch:()=>{const i=a.size(e);n.onProgress?.({step:"runtime",message:`Getting ${o}${i>0?` (${formatBytes(i)})`:""}, once.`})}});const t=a.entry(e);if(t)return t;throw new s("install",`${e} was installed but cannot be found.`)}catch(t){throw g(e,o,t)}}export async function programPath(e,o,n={}){const t=(await ensureRuntime(e,"runtime",e,n)).bins[o];if(!t)throw new s("install",`${e} holds no program "${o}".`);return t}export const ffmpegPath=(e={})=>programPath("ffmpeg","ffmpeg",e),ffprobePath=(e={})=>programPath("ffmpeg","ffprobe",e);

package/dist/node_modules/@allyhub-next/media/dist/vision/faces.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{ensureEngine as g,ffmpegPath as u}from"../tools.js";import{formatSeconds as p,prepare as l,providerOf as w,sampleFpsOf as k}from"./common.js";import{ensureModel as F,FACE_MODEL as d}from"./models.js";import{runWorker as M}from"./run.js";import{RUNTIME as v}from"./runtime.js";import{buildTrack as E}from"./track.js";export async function runFaces(a,e={}){const t=k(e),{path:o,probe:r}=await l(a,e),f=await F(d,e),c=e.runtimeModule??await g(v,"the vision engine",e),h=await u(e),i=Math.max(1,Math.round(r.duration*t)),s=`Finding the face in ${String(i)} frames of ${o} (${p(r.duration)} at ${String(t)} per second)`;e.onProgress?.({step:"decode",message:s});const n=await M({task:"faces",file:o,ffmpeg:h,module:c,model:f,sampleFps:t,width:r.width,height:r.height,provider:w(e)},{seconds:r.duration,signal:e.signal,onFrames:m=>{e.onProgress?.({step:"decode",message:s,done:m,total:Math.max(m,i),unit:"frames"})}});if(n.task!=="faces")throw new Error("the worker answered another task");return{track:E({frames:n.frames,fps:t,width:r.width,height:r.height,model:d.name,...e.smoothing===void 0?{}:{smoothing:e.smoothing}}),provider:n.provider}}export async function trackFaces(a,e={}){return(await runFaces(a,e)).track}

package/dist/node_modules/@allyhub-next/media/dist/vision/matte.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{spawn as L}from"node:child_process";import{mkdir as k,mkdtemp as U,open as O,rename as N,rm as _,stat as D}from"node:fs/promises";import{tmpdir as I}from"node:os";import{dirname as R,join as T,resolve as z}from"node:path";import{MediaError as F,oneLine as B,stopped as x}from"../errors.js";import{ensureEngine as C,ffmpegPath as G}from"../tools.js";import{tempFor as W}from"./cache.js";import{formatSeconds as Y,prepare as j,providerOf as H,sampleFpsOf as X}from"./common.js";import{DEFAULT_BURST as Z,DEFAULT_MAX_SAMPLE_FPS as q,DEFAULT_MOTION as J,encodeRate as K,frameCount as Q,matteSize as V,sampleAt as ee,tween as te,U2NET_SIZE as $}from"./mattes.js";import{ensureModel as re,MATTE_MODEL as b}from"./models.js";import{runWorker as ne}from"./run.js";import{RUNTIME as oe}from"./runtime.js";export const MATTE_LONG_SIDE=480;const E=$*$;async function ie(h,u,e,{ffmpeg:p,rate:c,frames:o,width:y,height:S,signal:n,onFrames:m}){const r=L(p,["-v","error","-nostdin","-y","-f","rawvideo","-pix_fmt","gray","-s",`${String($)}x${String($)}`,"-framerate",`${String(c.num)}/${String(c.den)}`,"-i","-","-vf",`scale=${String(y)}:${String(S)}:flags=bicubic:in_range=full:out_range=full,format=yuv420p`,"-c:v","libx264","-preset","medium","-crf","18","-g",String(Math.max(1,Math.round(c.value*2))),"-color_range","pc","-movflags","+faststart","-an","-f","mp4",e],{stdio:["pipe","ignore","pipe"],...n?{signal:n}:{}});let v="";r.stderr.on("data",s=>v+=s.toString());const l=new Promise((s,i)=>{r.on("error",t=>{i(x(t.code==="ENOENT"?new F("ffmpeg",`Cannot run ffmpeg (${p}).`,{hint:"Run it again to fetch ffmpeg, or unset ALLYHUB_FFMPEG if it names a program that is not there."}):t,n))}),r.on("close",s)});l.catch(()=>{}),r.stdin.on("error",()=>{});const w=await O(h,"r");try{const s=new Map,i=async t=>{const g=s.get(t);if(g)return g;const d=new Uint8Array(E);await w.read(d,0,E,t*E);for(const a of s.keys())a<t-1&&s.delete(a);return s.set(t,d),d};for(let t=0;t<o&&!(r.exitCode!==null||r.stdin.destroyed);t++){const{a:g,b:d,f:a}=ee(t,u),A=te(await i(g),await i(d),a);r.stdin.write(A)||await new Promise(P=>{const M=()=>{r.stdin.off("drain",M),r.stdin.off("close",M),P()};r.stdin.on("drain",M),r.stdin.on("close",M)}),(t%10===9||t===o-1)&&m(t+1)}}finally{await w.close(),r.stdin.end()}const f=await l;if(n?.aborted)throw x(new Error("ffmpeg stopped"),n);if(f!==0)throw new F("ffmpeg",`ffmpeg could not write the matte: ${B(v||`it exited with code ${String(f)}`,300)}`)}export async function runMatte(h,u,e={}){const p=X(e),{path:c,probe:o}=await j(h,e),y=await re(b,e),S=await G(e),n=K(o.fps),m=Q(o.duration,n),r=await U(T(I(),"allyhub-matte-"));try{const v=e.runtimeModule??await C(oe,"the vision engine",e),l=T(r,"samples.raw"),w=`Finding the person in ${String(m)} frames of ${c} (${Y(o.duration)}; the model looks ${String(p)} times a second, more where the picture moves)`;e.onProgress?.({step:"decode",message:w});const f=await ne({task:"matte",file:c,ffmpeg:S,module:v,model:y,sampleFps:p,width:o.width,height:o.height,provider:H(e),matte:{out:l,rate:`${String(n.num)}/${String(n.den)}`,sampling:{fps:n.value,maxSampleFps:e.sampling?.maxSampleFps??q,burst:e.sampling?.burst??Z,motion:e.sampling?.motion??J}}},{seconds:o.duration,signal:e.signal,onFrames:a=>{e.onProgress?.({step:"decode",message:w,done:a,total:Math.max(a,m),unit:"frames"})}});if(f.task!=="matte")throw new Error("the worker answered another task");const s=(await D(l)).size/E;if(f.frames.length===0||s<f.frames.length)throw new F("decode",`ffmpeg gave no frames of ${c} to the person matte.`);const i=V(o.width,o.height,MATTE_LONG_SIDE),t=z(u),g=`Writing the matte (${String(i.width)}×${String(i.height)}, ${String(m)} frames at ${String(Math.round(n.value*1e3)/1e3)} fps) to ${t}`;e.onProgress?.({step:"encode",message:g}),await k(R(t),{recursive:!0});const d=W(t);try{await ie(l,f.frames,d,{ffmpeg:S,rate:n,frames:m,width:i.width,height:i.height,signal:e.signal,onFrames:a=>{e.onProgress?.({step:"encode",message:g,done:a,total:m,unit:"frames"})}}),await N(d,t)}finally{await _(d,{force:!0})}return{info:{version:2,model:b.name,width:i.width,height:i.height,fps:Math.round(n.value*1e6)/1e6,sampleFps:p,duration:Math.round(m/n.value*1e6)/1e6,frames:f.frames.filter(a=>a<m)},provider:f.provider}}finally{await _(r,{recursive:!0,force:!0})}}export async function personMatte(h,u,e={}){return(await runMatte(h,u,e)).info}

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

@@ -0,0 +1,16 @@
+export declare const RUNTIME = "onnxruntime-node";
+export declare const RUNTIME_VERSION = "1.30.0";
+/** The systems onnxruntime-node 1.30.0 carries a native library for (bin/napi-v6/<platform>/<arch>). */
+export declare const TARGETS: string[];
+export interface Host {
+    platform: string;
+    arch: string;
+    glibc?: string | undefined;
+}
+/** Why the runtime cannot run here, or undefined. On Linux it needs glibc 2.28 (manylinux_2_28; so not musl). */
+export declare function unsupportedReason(host?: Host): string | undefined;
+/** Whether the runtime is on this computer; loads nothing, so it is quick. */
+export declare function runtimeInstalled(): boolean;
+/** Loads the runtime in a child, as the worker does: undefined when it loads, else why not. */
+export declare function runtimeLoadError(): string | undefined;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/node_modules/@allyhub-next/media/dist/vision/runtime.js

@@ -0,0 +1,8 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{spawnSync as s}from"node:child_process";import{pathToFileURL as c}from"node:url";import{createPackages as o}from"@allyhub-next/runtimes";import{oneLine as i}from"../errors.js";import{nodeCommand as a}from"@allyhub-next/runtimes/node";import{workerEnv as u}from"../worker-process.js";export const RUNTIME="onnxruntime-node",RUNTIME_VERSION="1.30.0",TARGETS=["darwin-arm64","linux-x64","linux-arm64","win32-x64","win32-arm64"];function p(){const r=process.report.getReport();return{platform:process.platform,arch:process.arch,glibc:r.header?.glibcVersionRuntime}}export function unsupportedReason(r=p()){const n=`${r.platform}-${r.arch}`;if(!TARGETS.includes(n))return`Face tracking and person mattes run on ${TARGETS.join(", ")}; this computer is ${n}.`;if(r.platform!=="linux")return;if(!r.glibc)return"Face tracking and person mattes need glibc 2.28 or newer; this Linux has none (musl?).";const[e=0,t=0]=r.glibc.split(".").map(Number);if(!(e>2||e===2&&t>=28))return`Face tracking and person mattes need glibc 2.28 or newer; this computer has glibc ${r.glibc}.`}export function runtimeInstalled(){return o().entry(RUNTIME)!==void 0}const m=`import(process.env.ALLYHUB_ORT_MODULE).then((m) => {
+  const ort = m.default ?? m;
+  if (typeof ort.InferenceSession?.create !== "function") throw new Error("it has no InferenceSession");
+}).catch((e) => {
+  process.stderr.write(String(e && e.message).replace(/\\s+/g, " "));
+  process.exitCode = 1;
+});`;export function runtimeLoadError(){const r=o().entry(RUNTIME);if(!r)return`${RUNTIME} is not installed`;const n=c(r).href,e=s(a(),["--input-type=module","-e",m],{env:u({ALLYHUB_ORT_MODULE:n}),encoding:"utf8",stdio:["ignore","ignore","pipe"],timeout:6e4});if(e.status===0)return;const t=e.stderr.trim();return t?i(t):e.error?i(e.error):e.signal?`loading it crashed (${e.signal})`:"it does not load"}

package/dist/node_modules/@allyhub-next/media/dist/worker-process.d.ts

@@ -0,0 +1,8 @@
+/** How to run the worker module `name` beside `from` (an import.meta.url). */
+export declare function workerCommand(from: string, name: string): {
+    command: string;
+    args: string[];
+};
+/** The worker's environment: this process's, with `more`. */
+export declare function workerEnv(more: Record<string, string>): NodeJS.ProcessEnv;
+//# sourceMappingURL=worker-process.d.ts.map

package/dist/node_modules/@allyhub-next/media/dist/worker-process.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{fileURLToPath as e}from"node:url";import{nodeCommand as m}from"@allyhub-next/runtimes/node";export function workerCommand(o,n){const r=o.endsWith(".ts"),t=e(new URL(`./${n}.${r?"ts":"js"}`,o));return{command:m(),args:[...r?["--import","tsx"]:[],t]}}export function workerEnv(o){return{...process.env,...o}}

package/dist/node_modules/@allyhub-next/media/package.json

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

package/dist/node_modules/@allyhub-next/model/dist/build-job.d.ts

@@ -0,0 +1,32 @@
+/** What `buildModule` and its child say to each other. */
+import type { ModelParameters } from "./data.js";
+import type { ModelReport } from "./report.js";
+/** The name a model program imports this package by. */
+export declare const PACKAGE = "@allyhub-next/model";
+export interface WorkerJob {
+    file: string;
+    parameters: ModelParameters;
+    seed: number;
+    maxPatternVertices: number;
+    maxSurfaceVertices: number;
+    maxInstances: number;
+    /** The project's root: image paths start there. */
+    root: string;
+    /** Where the child writes the GLB; the parent publishes it. */
+    out?: string;
+    /** The file `manifold-3d/manifold` resolves to, which AllyHub does not install with itself. */
+    manifold: string;
+}
+export type WorkerAnswer = {
+    report: ModelReport;
+    /** The files the build read, for the cache. */
+    inputs: string[];
+} | {
+    error: {
+        code: string;
+        message: string;
+    };
+};
+/** A message from the child, if it is one. */
+export declare function answerOf(value: unknown): WorkerAnswer | undefined;
+//# sourceMappingURL=build-job.d.ts.map

package/dist/node_modules/@allyhub-next/model/dist/build-worker.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{realpathSync as h}from"node:fs";import{registerHooks as g}from"node:module";import{dirname as c,join as w,relative as x}from"node:path";import{fileURLToPath as l,pathToFileURL as S}from"node:url";import{buildModel as v,modelImages as L,ModelError as $}from"./index.js";import{exportGLB as j}from"./export.js";import{modelReport as E}from"./report.js";import{programLocation as M}from"./program-location.js";import{PACKAGE as n}from"./build-job.js";const P=new Map([[n,import.meta.resolve("./index.js")],[`${n}/export`,import.meta.resolve("./export.js")],[`${n}/three`,import.meta.resolve("./three.js")]]),k=l(new URL(".",import.meta.url)),y="manifold-3d/manifold";let m;const d=new Set,f=e=>!e.includes("/node_modules/")&&!e.startsWith(k);g({resolve(e,t,s){const r=P.get(e);return r?{url:r,shortCircuit:!0}:e===y&&m?{url:m,shortCircuit:!0}:s(e,t)},load(e,t,s){if(e.startsWith("file:")){const r=l(e);f(r)&&d.add(r)}return s(e,t)}}),Error.stackTraceLimit=64;const p=e=>new Promise(t=>{process.send?process.send(e,void 0,void 0,()=>{t()}):t()});let o;try{o=JSON.parse(process.argv[2]??""),m=o.manifold;const{file:e,root:t,seed:s}=o,r=await import(S(e).href),i=await v(r.default,o.parameters,{seed:s,maxPatternVertices:o.maxPatternVertices,maxSurfaceVertices:o.maxSurfaceVertices,maxInstances:o.maxInstances});o.out&&await j(i,o.out,{root:t,base:c(e)});const u=L(i).flatMap(a=>a.file?[w(/^\.\.?\//u.test(a.file)?c(e):t,a.file)]:[]);await p({report:E(i,e,s),inputs:[...d,...u]})}catch(e){const t=o?.root??process.cwd();let s=t;try{s=h(t)}catch{}const r=e instanceof Error&&e.stack?M(e.stack,f):void 0,i=e instanceof Error?e.message:String(e);await p({error:{code:e instanceof $?e.code:"model_failed",message:r?`${i} (at ${x(s,r.path)}:${String(r.line)}:${String(r.column)})`:i}}),process.exitCode=1}finally{process.disconnect?.()}

package/dist/node_modules/@allyhub-next/model/dist/build.d.ts

@@ -0,0 +1,67 @@
+import { type ModelParameters } from "./data.js";
+import type { ModelReport } from "./report.js";
+export { buildInputs, cacheKey, readModelCache, runtimeDigest, sweepModelCache, writeModelCache, type BuildInputs, type CachedBuild, type ModelCacheKey, type ModelCacheLocation, } from "./build-cache.js";
+export { programLocation } from "./program-location.js";
+export { capabilities } from "./capabilities.js";
+export { ModelError, type ModelParameters } from "./data.js";
+export { modelReport, type MaterialReport, type ModelReport, type ObjectReport, type TextureReport, } from "./report.js";
+/** `buildModule`'s defaults: the seed, the budgets a build is held to, and the seconds before it is stopped. */
+export declare const BUILD_DEFAULTS: {
+    readonly seed: 0;
+    readonly maxPatternVertices: 1000000;
+    readonly maxSurfaceVertices: 1000000;
+    readonly maxInstances: 100000;
+    /** Seconds. */
+    readonly timeout: 60;
+};
+export interface BuildModuleOptions {
+    parameters?: ModelParameters;
+    /** Reduced to 32 bits for the context's `bpy.random()`. */
+    seed?: number;
+    maxPatternVertices?: number;
+    maxSurfaceVertices?: number;
+    maxInstances?: number;
+    /** The project's root: image paths start there. */
+    root: string;
+    /**
+     * Where to write the GLB. The child writes it into a folder of its own
+     * beside it, and it is moved into place only after the child exited
+     * cleanly: a failure or a timeout, even one after the child wrote it,
+     * leaves the file that was there.
+     */
+    out?: string;
+    /** Seconds before the child is killed. */
+    timeout?: number;
+    /** The cache's folder (the CLI's is `.allyhub/cache/model`); without it nothing is cached. */
+    cache?: string;
+    /** Build anew instead of reusing a kept build; the build is still kept for next time. */
+    fresh?: boolean;
+    /** What the program prints, both streams; process.stderr by default, so it never mixes with a caller's stdout. */
+    log?: (bytes: Uint8Array) => void;
+}
+export interface ModuleBuild {
+    report: ModelReport;
+    /** The GLB written, as `out` named it. */
+    glb?: string;
+    /** hit: from the cache; stored: built and kept; unstored: built, not kept (an input changed meanwhile); off: no cache. */
+    cache: "hit" | "stored" | "unstored" | "off";
+}
+export interface ManifoldFiles {
+    /** Its module, what `manifold-3d/manifold` resolves to. */
+    js: string;
+    wasm: string;
+}
+/**
+ * Manifold's files. A workspace has them beside this package; AllyHub
+ * installed from npm does not, and fetches them the first time.
+ */
+export declare function manifoldFiles(): Promise<ManifoldFiles>;
+/** A digest of the modelling runtime a build runs: this package's files and Manifold's code and WebAssembly. */
+export declare function modelRuntimeDigest(): Promise<string>;
+/**
+ * Builds a model module in a child process and reports it, writing its GLB
+ * when `out` is given. Fails with a ModelError: the program's own code (with
+ * the place in its files it failed at), `model_timeout` or `model_failed`.
+ */
+export declare function buildModule(module: string, options: BuildModuleOptions): Promise<ModuleBuild>;
+//# sourceMappingURL=build.d.ts.map

package/dist/node_modules/@allyhub-next/model/dist/build.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{spawn as V}from"node:child_process";import{copyFile as M,mkdir as R,mkdtemp as y,rename as p,rm as I}from"node:fs/promises";import{createRequire as S}from"node:module";import{dirname as w,join as h,resolve as f}from"node:path";import{fileURLToPath as x,pathToFileURL as _}from"node:url";import{createPackages as j}from"@allyhub-next/runtimes";import{nodeCommand as L}from"@allyhub-next/runtimes/node";import{ModelError as u}from"./data.js";import{answerOf as P}from"./build-job.js";import{buildInputs as k,cacheKey as v,readModelCache as C,runtimeDigest as O,sweepModelCache as T,writeModelCache as D}from"./build-cache.js";export{buildInputs,cacheKey,readModelCache,runtimeDigest,sweepModelCache,writeModelCache}from"./build-cache.js";export{programLocation}from"./program-location.js";export{capabilities}from"./capabilities.js";export{ModelError}from"./data.js";export{modelReport}from"./report.js";export const BUILD_DEFAULTS={seed:0,maxPatternVertices:1e6,maxSurfaceVertices:1e6,maxInstances:1e5,timeout:60};const E=new URL(`./build-worker.${import.meta.url.endsWith(".ts")?"ts":"js"}`,import.meta.url),F=import.meta.url.endsWith(".ts")?["--import","tsx"]:[];let g;export function manifoldFiles(){return g??=(async()=>{try{const t=S(import.meta.url);return{js:t.resolve("manifold-3d/manifold.js"),wasm:t.resolve("manifold-3d/manifold.wasm")}}catch{}const o=j();await o.ensure("manifold-3d",{onFetch:()=>{process.stderr.write(`Getting Manifold, once, to build 3D models…
+`)}});const e=o.resolve("manifold-3d","manifold-3d/manifold.js"),n=o.resolve("manifold-3d","manifold-3d/manifold.wasm");if(!e||!n)throw new Error("manifold-3d holds no manifold.js");return{js:e,wasm:n}})().catch(o=>{throw g=void 0,o})}let U;export function modelRuntimeDigest(){return U??=manifoldFiles().then(({js:o,wasm:e})=>O([x(new URL(".",import.meta.url))],[o,e]))}export async function buildModule(o,e){const n=f(o),t={file:n,parameters:e.parameters??{},seed:e.seed??BUILD_DEFAULTS.seed,maxPatternVertices:e.maxPatternVertices??BUILD_DEFAULTS.maxPatternVertices,maxSurfaceVertices:e.maxSurfaceVertices??BUILD_DEFAULTS.maxSurfaceVertices,maxInstances:e.maxInstances??BUILD_DEFAULTS.maxInstances,root:f(e.root),manifold:_((await manifoldFiles()).js).href},m=e.timeout??BUILD_DEFAULTS.timeout;if(!Number.isFinite(m)||m<=0)throw new u("bad_timeout","The timeout must be positive seconds.");const r=e.out===void 0?void 0:f(e.out),s=e.log??(a=>{process.stderr.write(a)});let c;r&&(await R(w(r),{recursive:!0}),c=await y(h(w(r),".allyhub-model-")),t.out=h(c,"model.glb"));const i=e.cache?{root:t.root,dir:e.cache}:void 0;try{const a=v({file:n,parameters:t.parameters,seed:t.seed,maxPatternVertices:t.maxPatternVertices,maxSurfaceVertices:t.maxSurfaceVertices,maxInstances:t.maxInstances,runtime:await modelRuntimeDigest()});if(i&&await T(i.dir),i&&e.fresh!==!0){const l=await C(i,a,r!==void 0);if(l)return r&&t.out&&l.glb&&(await M(l.glb,t.out),await p(t.out,r)),{report:l.result,...r?{glb:r}:{},cache:"hit"}}const d=await K(t,m,s),b=i&&await D(i,a,await k(t.root,n,d.inputs),d.report,t.out);return r&&t.out&&await p(t.out,r),{report:d.report,...r?{glb:r}:{},cache:b?"stored":i?"unstored":"off"}}finally{c&&await I(c,{recursive:!0,force:!0})}}function K(o,e,n){return new Promise((t,m)=>{const r=V(L(),[...F,x(E),JSON.stringify(o)],{stdio:["ignore","pipe","pipe","ipc"]});r.stdout?.on("data",n),r.stderr?.on("data",n);let s,c=!1;const i=setTimeout(()=>{c=!0,r.kill("SIGKILL")},e*1e3);r.on("message",a=>{s=P(a)}),r.on("error",a=>{clearTimeout(i),m(a)}),r.on("close",(a,d)=>{clearTimeout(i),c?m(new u("model_timeout",`Model exceeded ${String(e)} seconds.`)):s&&"error"in s?m(new u(s.error.code,s.error.message)):a!==0||!s?m(new u("model_failed",`Model worker exited with ${String(a??d)}.`)):t(s)})})}

package/dist/node_modules/@allyhub-next/model/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@allyhub-next/model",
+  "version": "0.5.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./export": {
+      "types": "./dist/export.d.ts",
+      "default": "./dist/export.js"
+    },
+    "./three": {
+      "types": "./dist/three.d.ts",
+      "default": "./dist/three.js"
+    },
+    "./build": {
+      "types": "./dist/build.d.ts",
+      "default": "./dist/build.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub-next/project/dist/digest.d.ts

@@ -0,0 +1,9 @@
+import { type PieceInfo, type Prepared } from "@allyhub-next/build";
+import { type Combo, type Reads } from "@allyhub-next/video-core";
+/** The piece's part of every version's digest. */
+export declare function baseDigest(prepared: Pick<Prepared, "bundle" | "root" | "files" | "fonts">, piece: PieceInfo, 
+/** sha256 of the runtime bundle the stage loads. */
+runtime: string): Promise<string>;
+/** The digest of one version, given its piece's base and what it read. */
+export declare function outputDigest(prepared: Pick<Prepared, "messages" | "media" | "data">, base: string, piece: PieceInfo, combo: Combo, reads: Reads): string;
+//# sourceMappingURL=digest.d.ts.map

package/dist/node_modules/@allyhub-next/project/dist/digest.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{createHash as m}from"node:crypto";import{readFile as A}from"node:fs/promises";import{join as B}from"node:path";import{fontsDigest as H}from"@allyhub-next/build";import{comboKey as J,mediaByStem as N,messagePrefix as W}from"@allyhub-next/video-core";const b="allyhub-digest-v4",h=s=>s.digest("hex");async function _(s,o){const n=s.bundle,u=n?.chunks.entries[o.id.replaceAll("/","__")];if(!n||!u)return null;const i=new Set,d=a=>{if(i.has(a))return;i.add(a);const r=n.chunks.chunks[a];if(r){for(const l of r.css)i.add(l);for(const l of r.imports)d(l)}};d(u.file);const c=m("sha256");for(const a of[...i].sort())c.update(`${a}\0`),c.update(await A(B(n.dir,a)).catch(()=>Buffer.alloc(0))),c.update("\0");return h(c)}export async function baseDigest(s,o,n){const u=await H(s.root,s.files,s.fonts),i=m("sha256");return i.update(`${b}\0piece\0`),i.update(JSON.stringify([n,o.id,o.file,o.dims,o.matrix?{space:o.matrix.space,rules:o.matrix.rules}:null,o.format,await _(s,o),...u===void 0?[]:[u]])),`sha256:${h(i)}`}function w(s,o){return s?Object.keys(s).filter(n=>n.startsWith(`${o}.`)).sort().map(n=>[n,s[n]]):[]}export function outputDigest(s,o,n,u,i){const d=s.messages.locales,c=d[0],a=u.lang,r=a===void 0?void 0:s.messages.messages[a],l=c===void 0?void 0:s.messages.messages[c],g=(t,e)=>t&&Object.hasOwn(t,e)?t[e]:null,k=(t,e)=>(t===void 0?void 0:s.messages.anchors[t]?.[e])??[],y=t=>{const e=g(r,t);return e!==null?[e,...k(a,t)]:[null,g(l,t),...k(c,t)]},S=t=>{const e=w(r,t);return e.length>0?[e]:[[],w(l,t)]},$=[...i.messages].sort((t,e)=>t.key===e.key?t.kind<e.kind?-1:1:t.key<e.key?-1:1).map(t=>t.kind==="list"?[t.key,"list",...S(t.key)]:[t.key,"text",...y(t.key)]),O=`${W(n.id)}.`,j=n.kind==="slides"?[n.deck?.file??null,...[...new Set([...Object.keys(r??{}),...Object.keys(l??{})])].filter(t=>t.startsWith(O)).sort().map(t=>[t,...y(t)])]:[],D=[...new Set(i.media.map(t=>t.path))].sort().map(t=>{const e=s.media[t]??N(s.media,t);if(!e)return[t,null];const x={...e};return delete x.url,[t,x]}),v=[...new Set(i.data.map(t=>t.path))].sort().map(t=>[t,s.data[t]?.sha256??null]),f=m("sha256");return f.update(`${b}\0output\0${o}\0`),f.update(JSON.stringify([n.kind,n.options,J(u),d,$,j,D,v])),`sha256:${h(f)}`}

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

@@ -0,0 +1,119 @@
+import type { LoadedSummary } from "@allyhub-next/runtime/bridge";
+import type { SourcePlace } from "@allyhub-next/build";
+import { type StagePage } from "@allyhub-next/stage";
+import { type Box, type Combo, type ConsoleLog, type LayerAnswer, type LayerQueries, type LayoutReport, type Problem, type TextInk, type Timeline, type Track } from "@allyhub-next/video-core";
+/** One version: what to load. */
+export interface Target {
+    piece: string;
+    /** Its output, named by its kind: `video` or `slides`. */
+    output: string;
+    combo: Combo;
+    /** The piece's one format. */
+    format: string;
+    /** The combo's id (c01), when the piece has slots and chose it. */
+    id?: string;
+}
+/**
+ * A moment that never finished drawing: AK-P003, which ends the passes on
+ * its page. `kept`: the page said so and keeps it among its problems; else
+ * the page never answered.
+ */
+export declare class StuckError extends Error {
+    readonly code = "AK-P003";
+    readonly kept: boolean;
+    constructor(message: string, kept: boolean);
+}
+/** What the passes ask of a loaded version; a test may give its own. */
+export interface VersionPage {
+    readonly target: Target;
+    readonly timeline: Timeline;
+    /** Draws film time t, `part` alone when given; a moment that did not finish drawing throws StuckError. */
+    seek(t: number, part?: string): Promise<void>;
+    /** What moment t shows, as a string two equal moments share (drawn for its layout alone). */
+    sign(t: number): Promise<string | undefined>;
+    /** A PNG of the whole frame at t. */
+    shot(t: number): Promise<Buffer>;
+    /** A small PNG of the frame at t, about `width` px wide. */
+    thumb(t: number, width: number): Promise<Buffer>;
+    /**
+     * A PNG of `region` of the frame at t (frame px) at `scale`, `part`
+     * drawn alone, and where its pixel (0, 0) is in the frame and how many
+     * frame px one of its px is.
+     */
+    region(t: number, part: string | undefined, region: Box, scale: number): Promise<{
+        png: Buffer;
+        x: number;
+        y: number;
+        scale: number;
+    }>;
+    /** A PNG of `box` of the page as it is now (viewport px), nothing drawn first, and where its pixel (0, 0) is. */
+    grab(box: Box): Promise<{
+        png: Buffer;
+        x: number;
+        y: number;
+    }>;
+    /** Hides every text's fill (and with `outlines` its stroke and shadow), or shows them again. */
+    hideText(on: boolean, outlines?: boolean): Promise<void>;
+    measure(times?: readonly number[]): Promise<LayoutReport>;
+    tracks(from: number, to: number): Promise<Track[]>;
+    inks(t: number): Promise<TextInk[]>;
+    ask<K extends keyof LayerQueries>(name: K, args: LayerQueries[K]["args"]): Promise<LayerAnswer<LayerQueries[K]["answer"]>[]>;
+}
+/** A version loaded in a stage page; `summary` is undefined when it did not load. */
+export declare class LoadedVersion implements VersionPage {
+    readonly target: Target;
+    readonly stage: StagePage;
+    readonly summary: LoadedSummary | undefined;
+    /** Why it did not load, as problems. */
+    private readonly failed;
+    /** The page stopped answering: nothing more is asked of it. */
+    private hung;
+    private constructor();
+    /**
+     * Loads a version in a stage page opened for it; a piece that cannot load
+     * at all is kept as its problem (its file's `where`), the page left open
+     * for its console.
+     */
+    static load(stage: StagePage, target: Target, load: () => Promise<LoadedSummary>, file: string, 
+    /** The project file and line a stack names, through the bundles' source maps. */
+    placeOf?: (stack: string) => Promise<SourcePlace | undefined>): Promise<LoadedVersion>;
+    get timeline(): Timeline;
+    /** The longest a moment may wait, ms, before the page is taken to run forever. */
+    private get backstop();
+    /**
+     * A moment the page never answers for (a layer's render in a loop that
+     * never ends: the page's own deadline cannot run) is AK-P003, well after
+     * the page's own deadline would have been.
+     */
+    private answered;
+    seek(t: number, part?: string): Promise<void>;
+    sign(t: number): Promise<string | undefined>;
+    shot(t: number): Promise<Buffer>;
+    thumb(t: number, width: number): Promise<Buffer>;
+    region(t: number, part: string | undefined, box: Box, scale: number): Promise<{
+        png: Buffer;
+        x: number;
+        y: number;
+        scale: number;
+    }>;
+    grab(box: Box): Promise<{
+        png: Buffer;
+        x: number;
+        y: number;
+    }>;
+    hideText(on: boolean, outlines?: boolean): Promise<void>;
+    measure(times?: readonly number[]): Promise<LayoutReport>;
+    tracks(from: number, to: number): Promise<Track[]>;
+    inks(t: number): Promise<TextInk[]>;
+    ask<K extends keyof LayerQueries>(name: K, args: LayerQueries[K]["args"]): Promise<LayerAnswer<LayerQueries[K]["answer"]>[]>;
+    /**
+     * Every problem of the page, each once: why it did not load, what
+     * loading and every moment drawn since found, the requests the server
+     * did not allow (AK-N003) and what the page threw and did not catch.
+     */
+    problems(): Promise<Problem[]>;
+    /** What piece code printed on this page. */
+    console(): Promise<ConsoleLog>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=page.d.ts.map

package/dist/node_modules/@allyhub-next/project/dist/page.js

@@ -0,0 +1,4 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{LoadError as h}from"@allyhub-next/stage";import{comboKey as g,problem as o,RULES as p}from"@allyhub-next/video-core";import{dedupe as l}from"./ledger.js";export class StuckError extends Error{code="AK-P003";kept;constructor(e,t){super(e),this.name="StuckError",this.kept=t}}export class LoadedVersion{target;stage;summary;failed;hung=!1;constructor(e,t,s,a){this.target=e,this.stage=t,this.summary=s,this.failed=a}static async load(e,t,s,a,i){try{return new LoadedVersion(t,e,await s(),[])}catch(r){const c=r instanceof h?r.detail:r instanceof Error?r.message:String(r),n=await i?.(c).catch(()=>{}),m={piece:t.piece,output:t.output,combo:t.combo,format:t.format,where:n?{file:n.file,line:n.line}:{file:a}},u=r instanceof h&&r.code in p?r.code:"AK-R001",d=r instanceof Error?r.message.split(`
+`)[0]??"":String(r).split(`
+`)[0];return new LoadedVersion(t,e,void 0,[o(u,`Failed to load ${t.output} of ${t.piece} (${g(t.combo)}, ${t.format}): ${d??""}`,m)])}}get timeline(){if(!this.summary)throw new Error("The version did not load.");return this.summary.timeline}get backstop(){return((this.summary?.seekLimit??10)*2+30)*1e3}async answered(e,t){let s;try{return await Promise.race([e,new Promise((a,i)=>{s=setTimeout(()=>{this.hung=!0,i(new StuckError(`The page drawing ${this.target.piece} did not answer for the moment ${t.toFixed(2)} s in ${String(this.backstop/1e3)} s: piece code may run forever there (a loop that never ends, in a layer's render).`,!1))},this.backstop)})])}finally{clearTimeout(s)}}async seek(e,t){await this.answered(this.stage.seek(e,t===void 0?{}:{part:t}),e);const s=await this.stage.stuck();if(s!==void 0)throw new StuckError(s,!0)}sign(e){return this.answered(this.stage.signatureAt(e),e)}async shot(e){return await this.seek(e),this.stage.capture({format:"png"})}async thumb(e,t){return await this.seek(e),this.stage.drawing.frame({format:"png",scale:Math.min(1,t/this.stage.page.width)})}async region(e,t,s,a){return await this.seek(e,t),{png:await this.stage.drawing.frame({format:"png",clip:{x:s[0],y:s[1],width:s[2],height:s[3]},scale:a}),x:s[0],y:s[1],scale:1/a}}async grab(e){return{png:await this.stage.drawing.frame({format:"png",clip:{x:e[0],y:e[1],width:e[2],height:e[3]}}),x:e[0],y:e[1]}}hideText(e,t=!1){return this.stage.hideText(e,t)}measure(e){return this.stage.measure(e)}tracks(e,t){return this.stage.tracks(e,t)}inks(e){return this.stage.inks(e)}ask(e,t){return this.stage.ask(e,t)}async problems(){const e={piece:this.target.piece,output:this.target.output,combo:this.target.combo,format:this.target.format};let t=[];if(this.summary&&!this.hung)try{t=await this.stage.problems()}catch{t=this.summary.problems}return l([...this.failed,...this.stage.refused().map(s=>o("AK-N003",`The sandbox blocked a request: ${s}. Piece code has no network.`,e)),...this.stage.page.errors().map(s=>o("AK-R001",`The runtime threw an unhandled exception: ${s.text}`,e)),...t])}async console(){if(this.hung)return{messages:[],dropped:0};try{return await this.stage.console()}catch{return{messages:[],dropped:0}}}close(){return this.stage.close()}}