allyhub 0.3.0 → 0.5.0

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{RenderError}from"./errors.js";export{ffmpegOf,ffprobeOf,runFfmpegWith,toolsOf,write}from"./tools.js";export{ENCODERS,FFMPEG_MINIMUM,FFMPEG_PINNED,compareReleases,ffmpegEncoders,ffmpegHint,ffmpegRelease,ffmpegVersion,findFfmpeg,judgeFfmpeg,requireEncoder,requireFfmpeg,versionIn}from"./ffmpeg.js";export{renderVideo}from"./render.js";export{MAX_WORKERS,SHARE_ENCODE,VIDEO_TYPES,autoWorkers,encodeFor,shareKbps}from"./encode.js";export{segmentsOf}from"./segments.js";export{masterOf,mixSound}from"./sound.js";export{backgroundStill,finalStill,footageStill,videoFrame}from"./stills.js";export{hasFinalLook,lutFile}from"./look.js";export{compositeArgs,compositeStill,finishGraph,frameAt,partAt,planSources,stillOutput,transparentPng}from"./composite.js";export{ffmpegColor,footagePlane,insetEllipse,keyedGeometry,layersIn,linearExpr,probeSource,roundedBox}from"./footage.js";export{junctionArgs,junctionGroups,junctionStill}from"./junction.js";export{PipeFormat,pngColorType,rgbaPng}from"./png.js";export{CAPTURE_DEFAULTS,GRAIN_MOST,blurredNoise,captureGraph,captureProblem,capturesAnything,exposureStops,grainAt,grainSize,grainWeight}from"./capture.js";export{postFilterProblem,postGraph,postReadsTime}from"./post.js";export{ffmpegRuns,postPlaces,postProblems,tryPost}from"./post-probe.js";export{CAP_START,breaksCap,capOf,capRun,overCap,packetSizes}from"./cap.js";export{PartCache,closedPart,drawnKey,junctionDigest,partCacheLimit,partDigest}from"./parts.js";export{MAX_PARTS,PagePool,Slots,drawInOrder,encoderSlots,partsAtOnce,renderSerial}from"./pool.js";export{renderCaptions,renderCover,renderPdf,renderPng,renderPptx}from"./exports.js";export{lookFormat,webp,webpPath}from"./webp.js";export{blankImage,cropImage,pasteImage,readPng,resizeImage,writePng}from"./image.js";export{CLIP_TYPES,clipTypeOf,writeClip}from"./clip.js";export{DELIVERY_LEAD,parseEncode,throughEncode}from"./delivery.js";

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

@@ -0,0 +1,186 @@
+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/dist/node_modules/@allyhub-next/render/dist/render.d.ts

@@ -0,0 +1,151 @@
+import type { Mastered } from "@allyhub-next/audio/node";
+import { type EncodeOptions, type VideoType } from "./encode.js";
+import type { GraphicsPage, ProjectMedia, RenderTarget, VideoLook } from "./page.js";
+import { PartCache, type PieceCode } from "./parts.js";
+import { type SoundInput } from "./sound.js";
+import { type Tools } from "./tools.js";
+export interface RenderOptions extends Tools {
+    /** The output rendered. */
+    target: RenderTarget;
+    /** Its options that change the picture: transparency, motion blur, the camera's marks, post. */
+    look: VideoLook;
+    /** The project's media: its footage, mattes and LUT. */
+    media: ProjectMedia;
+    /**
+     * Pages holding the output, drawing its graphics plane (at least one);
+     * the first one's timeline is the one rendered. The caller opens and
+     * closes them.
+     */
+    pages: readonly GraphicsPage[];
+    /**
+     * Opens another page of the same output, when more would draw the
+     * frames faster (up to `workers`); the render closes the pages it
+     * opened. Absent: it draws with `pages` alone.
+     */
+    openPage?: () => Promise<GraphicsPage>;
+    /** The sound muxed in; absent: a file without sound. A gif has none. */
+    sound?: SoundInput;
+    out: string;
+    /** The file type; default mp4. */
+    type?: VideoType;
+    encode?: EncodeOptions;
+    /** 0–1 */
+    onProgress?: (progress: number) => void;
+    /**
+     * Pages drawing the graphics plane, shared by the parts rendered at
+     * once; default from the CPUs and length (autoWorkers). How many parts
+     * render at once is partsAtOnce's.
+     */
+    workers?: number;
+    /** What the build knows of the piece's code: without it, nothing is kept in the part cache. */
+    code?: PieceCode;
+    /**
+     * The part cache (default: the project's, .allyhub/cache/parts/); false
+     * renders every part again and keeps nothing.
+     */
+    partCache?: PartCache | false;
+    /** Aborting it stops the render: its pages and ffmpeg runs, and no part of its file stays. */
+    signal?: AbortSignal;
+}
+/** Where one part's time went (RenderTimings.part), in seconds. */
+export interface PartTimings {
+    /** The part's key; a junction's is `<outgoing>><incoming>`. */
+    key: string;
+    /** A transition's window between two parts. */
+    junction?: true;
+    frames: number;
+    /** The part cache had its segment. */
+    cached: boolean;
+    /** Graphics images sent to ffmpeg (frames × motion blur samples × planes); 0 without graphics. */
+    images: number;
+    /** Images a page captured. */
+    captured: number;
+    /** Images whose DOM was the same as one captured already. */
+    reused: number;
+    /** Images where no graphic layer shows: the cached transparent PNG. */
+    clear: number;
+    /** Seconds pages spent seeking and capturing its images, summed over pages. */
+    capture: number;
+    /** Seconds from its ffmpeg's start to its exit. */
+    ffmpeg: number;
+    /** Seconds ffmpeg's input waited for the next image from the pages. */
+    waitFrames: number;
+    /** Seconds the pages' images waited for ffmpeg to take them (the pipe full). */
+    waitPipe: number;
+    /**
+     * Its video overran the bitrate cap: the file kept is the one the
+     * encoder that held the cap made of the same frames (on one thread,
+     * beside the encoder without the cap, in the same run).
+     */
+    held?: true;
+    /**
+     * A part drawn by code the part cache cannot see into: keyed by what its
+     * frames draw ("frames"), or, where a frame shows what its signature
+     * cannot say, by the piece's whole bundle, with why ("bundle: …").
+     */
+    keyed?: string;
+    /** When it started and ended, in seconds from the render's start. */
+    start: number;
+    end: number;
+}
+/**
+ * Where a render's time went, in seconds (RenderResult.timings;
+ * allyhub render --json prints it with ALLYHUB_RENDER_TIMINGS=1).
+ */
+export interface RenderTimings {
+    /** Opening the pages the render opened (RenderOptions.openPage). */
+    pages: number;
+    /** Pages drawing the graphics plane, and parts rendered at once. */
+    workers: number;
+    concurrency: number;
+    /** Probing the footage, the part digests and the cache lookups. */
+    plan: number;
+    /** From the first part's start to the last part's end. */
+    parts: number;
+    /** Mixing and mastering the sound (it may run alongside the parts). */
+    mix: number;
+    /** Joining the segments and adding the sound (gif: the palette pass; png: copying). */
+    mux: number;
+    /** Segments encoded again so the cap holds across the joins (mp4 with a cap). */
+    capped?: number;
+    /**
+     * Signing the frames of the parts drawn by code the part cache cannot
+     * see into (a custom() layer, a scenery), which it keys them by.
+     */
+    signs?: number;
+    total: number;
+    part: PartTimings[];
+}
+export interface RenderResult {
+    out: string;
+    frames: number;
+    duration: number;
+    bytes: number;
+    /**
+     * The sound as written, measured: integrated loudness (LUFS), its range
+     * (LU) and true peak (dBTP). Absent for a silent film or a gif.
+     */
+    loudness?: {
+        integrated: number;
+        range?: number;
+        truePeak?: number;
+    };
+    /** What the master did: its gain and what its limiter took, dB, and its targets. */
+    master?: Omit<Mastered, "loudness">;
+    /** Every file written, when there are several (a PNG sequence). */
+    files?: string[];
+    /** Its parts: how many, and how many came from the part cache. */
+    parts: {
+        total: number;
+        cached: number;
+    };
+    /** Its transitions' windows, when it has any: how many, and how many came from the cache. */
+    junctions?: {
+        total: number;
+        cached: number;
+    };
+    timings: RenderTimings;
+}
+/** allyhub render's video file types: mp4, mov, webm, gif and PNG frames. */
+export declare function renderVideo(opts: RenderOptions): Promise<RenderResult>;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{copyFile as Ne,mkdir as yt,mkdtemp as kt,readdir as bt,readFile as vt,rename as Pt,rm as re,stat as xt,writeFile as Mt}from"node:fs/promises";import{createHash as $t}from"node:crypto";import{tmpdir as jt}from"node:os";import{join as S}from"node:path";import{EXIT as St}from"@allyhub-next/protocol";import{ALPHA_TYPES as At,comboKey as _t,fpsRational as Ft,heldTime as Ot,planeAt as Tt}from"@allyhub-next/video-core";import{CAP_START as Bt,capOf as Et,capRun as qe,overCap as Ct,packetSizes as Ge}from"./cap.js";import{capturesAnything as Dt}from"./capture.js";import{compositeArgs as Rt,planSources as It,transparentPng as Ht}from"./composite.js";import{MAX_WORKERS as Kt,autoWorkers as zt,encodeFor as Wt,encoderOf as Qe,gopArgs as Lt,HELD_OUT as Vt,twoOutputs as Jt}from"./encode.js";import{RenderError as Ut}from"./errors.js";import{ffmpegVersion as Xt}from"./ffmpeg.js";import{junctionArgs as Yt}from"./junction.js";import{lutFile as Nt,pagePlane as qt}from"./look.js";import{PartCache as Gt,closedPart as Qt,drawnKey as Zt,junctionDigest as en,partDigest as tn,place as nn}from"./parts.js";import{PipeFormat as Ze}from"./png.js";import{PagePool as rn,drawInOrder as on,encoderSlots as an,renderSerial as sn}from"./pool.js";import{postReadsTime as et}from"./post.js";import{segmentsOf as cn}from"./segments.js";import{mixSound as fn}from"./sound.js";import{runFfmpegWith as tt,toolsOf as un,write as dn}from"./tools.js";const A=a=>Math.round(performance.now()-a)/1e3,de=async(a,y,w,T)=>{await tt(a,y,w,!1,T)};function ln(a){const y=new Set;return a.filter(w=>{const T=[w.code,w.message,w.piece,w.output,w.combo?_t(w.combo):"",w.format,w.part,w.where?.file,w.where?.line].join("|");return y.has(T)?!1:(y.add(T),!0)})}const nt=a=>$t("sha256").update(a).digest("hex");export async function renderVideo(a){const{ffmpeg:y,ffprobe:w}=await un(a),T={ffmpeg:y,ffprobe:w},{target:Se,media:X}=a,[B]=a.pages;if(!B)throw new Error("renderVideo draws with at least one page.");const d=a.type??"mp4",I=Wt(d,Se.format,a.encode??{},B.timeline),M=a.look,Y=M.transparent===!0&&At.includes(d),Ae=Qe(d,I,Y),oe=await Nt(X.root,M.post?.lut),H=await kt(S(jt(),"allyhub-render-")),L=[...a.pages],_e=[],rt=()=>Promise.all(_e.splice(0).map(q=>q.close?.()??Promise.resolve())),le=[];let N;const V=[],me=performance.now(),h={pages:0,workers:1,concurrency:1,plan:0,parts:0,mix:0,mux:0,total:0,part:[]};try{const q=performance.now(),b=B.timeline,l=b.fps,pe=Ft(l),Fe=Math.round(b.duration*l),we=M.motionBlur,_=we?we.samples:1,he=we?.shutter??.5,Oe=await It(X,b,w),P=d==="gif"||d==="png"?"png":d,ge=d==="webm"?["-fflags","+bitexact"]:[],ot=P!=="png"&&!(d==="mp4"&&I.codec==="h265"),E=cn(b,ot),ae=[];Ae.rgb?ae.push(`format=${Ae.pixFmt}`):ae.push("scale=out_color_matrix=bt709:out_range=tv:flags=neighbor");const G=(e,t=!1,n)=>["-r",pe.text,...Qe(d,I,Y,e,t,n).args,...Lt(d,I.codec,e),...d==="mp4"||d==="mov"?["-video_track_timescale","90000"]:[],...ge],C=d==="mp4"&&I.maxBitrate!==void 0&&I.maxBitrate>0?Et(I.maxBitrate):void 0,at=e=>[...G(e),...C?["over the cap",...G(e,!0)]:[],...ae],Q=a.code,K=P!=="png"&&Q!==void 0&&a.partCache!==!1&&process.env.ALLYHUB_PART_CACHE!=="off"?a.partCache??Gt.of(X.root):void 0,Z=[],Te=new Map;if(K&&Q){const e=await Xt(y),t=oe?nt(await vt(oe)):null,n=B.reads,o={alpha:Y,samples:_,shutter:he,capture:Dt(M.capture)?M.capture??null:null,post:M.post?.filter??null,lut:t},i=r=>{const u=r.post?.filter,g=o.capture!==null||o.post!==null&&et(o.post)||u!==void 0&&et(u);return{...o,...u===void 0?{}:{partPost:u},...g?{at:Math.round(r.start*l)}:{}}},s=Math.round(b.duration*l),k=b.parts.at(-1)?.key,m=new Map,O=r=>{const u=B.signs[r.key];if(u===void 0||Qt(Q,u))return Promise.resolve(void 0);let g=m.get(r.key);if(!g){const j=Math.round(r.start*l),c=r.key===k?s:Math.min(s,Math.round(r.end*l)),f=[];for(let z=j;z<c;z++)for(let R=0;R<_;R++)f.push(z/l+(R>0?R*he/(l*_):0));const Me=performance.now();g=B.partSign(r.key,f).then(z=>(h.signs=Math.round(((h.signs??0)+A(Me))*1e3)/1e3,z)),m.set(r.key,g)}return g},x=async(r,u,g,j)=>{const c=B.signs[r.key];if(c===void 0)return;const f=await O(r);return f&&Te.set(r.key,Zt(Q,f)?"frames":`bundle: ${f.unknown??`a canvas drawn by ${f.owners.join(", ")}, in the piece's own file`}`),tn({root:X.root,code:Q,combo:Se.combo,timeline:b,part:r,sign:c,...f?{drawn:f}:{},media:X.media,reads:n,frames:u,encode:g,look:i(r),ffmpeg:e,...j?{trim:j}:{},...B.gpu===!0?{gpu:!0}:{}})},p=new Map,v=r=>{let u=p.get(r.key);return u||(u=x(r,Math.round(r.end*l)-Math.round(r.start*l),[]),p.set(r.key,u)),u};for(const r of E){const u=at(r.frames);if(!r.junction){Z.push(await x(r.part,r.frames,u,r.trim));continue}const[g,j]=[await v(r.junction.from),await v(r.part)];Z.push(g===void 0||j===void 0?void 0:await en({out:g,in:j,transition:r.junction.transition,fps:l,frames:r.frames,encode:u,ffmpeg:e}))}}const Be=await Promise.all(E.map((e,t)=>{const n=Z[t];return K&&n?K.get(n,P):Promise.resolve(void 0)})),Ee=e=>e>0?e*he/(l*_):0,st=(e,t,n)=>e.junction?Ot(t,n/l,l):n/l,Ce=(e,t,n,o)=>Tt(t.part,t.plane,st(e,t.part,n)+Ee(o)),ye=E.map(e=>{const t=(e.junction?[e.junction.from,e.part]:[e.part]).map(i=>{const s=[];let k=0;return i.planes.forEach((m,O)=>{const x={part:i,plane:O,images:m.overlay===!0?1:_};let p=0;for(let v=e.first;v<e.first+e.frames;v++)for(let r=0;r<x.images;r++)Ce(e,x,v,r)&&p++;p!==0&&(s.push(x),k+=p)}),{part:i,planes:s.map(m=>m.plane),overlays:s.flatMap(m=>i.planes[m.plane]?.overlay===!0?[m.plane]:[]),groups:s,drawn:k,graphics:k>0}}),n=t.flatMap(i=>i.groups),o=n.length===0?_:n.reduce((i,s)=>i+s.images,0);return{pictures:t,groups:n,per:o,graphics:t.some(i=>i.graphics),drawn:t.reduce((i,s)=>i+s.drawn,0),images:e.frames*o}}),De=(e,t,n)=>{let o=n%e.per,i={part:t.part,plane:0,images:_};for(const s of e.groups){if(o<s.images){i=s;break}o-=s.images}return{f:t.first+Math.floor(n/e.per),k:o,group:i}},it=(e,t,n)=>{const o=De(e,t,n);return Ce(t,o.group,o.f,o.k)};let ke=0;ye.forEach((e,t)=>{Be[t]===void 0&&(ke+=e.drawn)}),h.plan=A(q);const Re=a.openPage===void 0?L.length:Math.max(L.length,ke===0?1:Math.min(a.workers??zt(ke),Kt));h.workers=Re;const se=new rn;for(const e of L)se.add(e);const ct=async e=>{const t=[];for(const n of L)for(const o of await n.problems())o.level!=="error"||o.code==="AK-P002"||o.part!==void 0&&!e.has(o.part)||t.push(o);return ln(t)},ft=performance.now(),Ie=a.openPage;for(let e=L.length;Ie&&e<Re;e++){const t=Ie().then(n=>{_e.push(n),L.push(n),se.add(n),h.pages=A(ft)});t.catch(()=>{}),le.push(t)}const ut=sn(),be=a.sound,D=d==="gif"||be===void 0?void 0:S(H,"audio.wav"),He=async()=>{if(D===void 0||be===void 0)return;const e=performance.now(),t=await fn({timeline:b,sound:be,out:D,ffmpeg:y});return h.mix=A(e),t};ut||(N=He(),N.catch(()=>{}));const dt=Ht(b.width,b.height),Ke=ye.reduce((e,t)=>e+t.images,0);let J=0,ze=-1;const ve=()=>{const e=Math.floor(90*J/Ke);e<=ze||(ze=e,a.onProgress?.(.9*J/Ke))},ee=S(H,"frames");P==="png"&&await yt(ee,{recursive:!0});const ie=E.map((e,t)=>S(H,`segment.${String(t).padStart(4,"0")}.${P}`));let We=0,Le=0;const Pe=new AbortController,F=a.signal?AbortSignal.any([Pe.signal,a.signal]):Pe.signal,Ve=an();h.concurrency=Math.max(1,Math.min(Ve.limit,Be.filter(e=>e===void 0).length));const lt=performance.now(),Je=(e,t,n)=>de(y,["-v","error","-y","-i",e,"-map","0:v","-c","copy","-frames:v",String(n),...ge,t]),mt=async(e,t)=>{const n=ye[e];if(!n)return;const o=n.graphics,i=n.images,s={key:t.junction?`${t.junction.from.key}>${t.part.key}`:t.part.key,...t.junction?{junction:!0}:{},frames:t.frames,cached:!1,images:o?i:0,captured:0,reused:0,clear:0,capture:0,ffmpeg:0,waitFrames:0,waitPipe:0,start:0,end:0},k=t.junction?void 0:Te.get(t.part.key);k!==void 0&&(s.keyed=k),h.part[e]=s;const m={captured:0,reused:0},O=new Map,x=c=>{let f=O.get(c);return f||(f=new Map,O.set(c,f)),f},p=P==="png"?S(ee,"frame.%05d.png"):ie[e]??"",v={...M.capture?{capture:M.capture}:{},...M.post?.filter?{post:M.post.filter}:{},...oe?{lut:oe}:{},tail:ae},r=c=>({planes:n.pictures[c]?.planes??[],overlays:n.pictures[c]?.overlays??[]}),u=c=>Ve.run(async()=>{F.throwIfAborted(),s.start=A(me);const f=C?`${c}.held.${P}`:void 0,Me=()=>["-v","error","-y",...Jt(t.junction?Yt({timeline:b,transition:t.junction.transition,first:t.first,frames:t.frames,sources:Oe,alpha:Y,out:r(0),in:r(1),samples:_,...v}):Rt({timeline:b,first:t.first,frames:t.frames,sources:Oe,alpha:Y,planes:n.pictures[0]?.planes??[],overlays:n.pictures[0]?.overlays??[],samples:_,part:t.part,...v}),f!==void 0),...G(t.frames),...P==="png"?["-start_number",String(t.first+1)]:[],c,...f===void 0?[]:["-map",`[${Vt}]`,"-frames:v",String(t.frames),...G(t.frames,!0),f]],z=performance.now();let R=n.drawn<i||n.groups.length>1;for(;;){const $e=new Ze(R);let te=0,W=0;try{await tt(y,Me(),o?async ce=>{await on({count:i,ahead:Math.max(8,se.size*4),draw:ne=>{if(!it(n,t,ne))return s.clear++,W++,Promise.resolve(dt);const{f:je,k:fe,group:ue}=De(n,t,ne);return se.use([e,ne],async wt=>{F.throwIfAborted();const ht=performance.now(),gt=await wt.frame(je/l,{format:"png",alpha:!0,...qt(ue.part,ue.plane),...t.junction?{part:ue.part.key}:{},reuse:x(ue.part.key),stats:m,...fe>0?{offset:Ee(fe)}:{}});return s.capture+=(performance.now()-ht)/1e3,gt})},emit:async ne=>{const je=$e.next(ne),fe=performance.now();await dn(ce,je),s.waitPipe+=(performance.now()-fe)/1e3,J++,te++,ve()},waits:s,signal:F})}:void 0,!1,F);break}catch(ce){if(!(ce instanceof Ze.Mixed)||R)throw f!==void 0&&await re(f,{force:!0}),ce;R=!0}J-=te,s.clear-=W}if(C&&f!==void 0&&(await Ct(c,C,l,T)?(await Pt(f,c),s.held=!0):await re(f,{force:!0})),s.ffmpeg=A(z),o||(J+=i,ve()),o){const $e=new Set(t.junction?[t.junction.from.key,t.part.key]:[t.part.key]),te=await ct($e);if(te.length>0)throw new Ut("draw-failed",`Drawing ${s.key} failed, so it is not rendered: ${te.map(W=>`${W.code} ${W.message}${W.t===void 0?"":` (at ${W.t.toFixed(2)} s)`}`).join("; ")}`,{exit:St.failed,hint:"allyhub frames --at and allyhub inspect layout --at draw that moment; fix what failed and render again."})}}),g=t.keep<t.frames,j=Z[e];if(K&&j){const c=await K.segment(j,P,u);g?await Je(c.file,p,t.keep):await nn(c.file,p),c.cached&&(t.junction?Le++:We++,s.cached=!0,J+=i,ve())}else if(g){const c=S(H,`whole.${String(e).padStart(4,"0")}.${P}`);await u(c),await Je(c,p,t.keep),await re(c,{force:!0})}else await u(p);s.captured=m.captured,s.reused=m.reused,s.end=A(me)},Ue=(await Promise.allSettled(E.map((e,t)=>mt(t,e).catch(n=>{throw Pe.abort(n),n})))).find(e=>e.status==="rejected");if(Ue)throw Ue.reason;await Promise.all(le),h.parts=A(lt);const $=await(N??He()),xe=$?.loudness;a.onProgress?.(.95),F.throwIfAborted();const pt=performance.now();let U;if(d==="png"){const e=a.out.replace(/\.png$/,"");U=[];const t=(await bt(ee)).filter(n=>/^frame\.\d+\.png$/.test(n)).sort();for(const n of t){F.throwIfAborted();const o=`${e}.${n.slice(6)}`;V.push(o),await Ne(S(ee,n),o),U.push(o)}D&&xe&&(V.push(`${e}.wav`),await Ne(D,`${e}.wav`),U.push(`${e}.wav`))}else if(d==="gif")V.push(a.out),await de(y,["-v","error","-y","-framerate",pe.text,"-start_number","1","-i",S(ee,"frame.%05d.png"),"-filter_complex","split[a][b];[a]palettegen=stats_mode=diff[p];[b][p]paletteuse=dither=sierra2_4a","-r",pe.text,"-loop","0",a.out],void 0,F);else{if(C){const n=C.bufferKbps*1e3;let o=Bt*n;for(const[i,s]of ie.entries()){const k=await Ge(s,T);if(!k)continue;const m=qe(k,C,l,o);if(!m.breaks){o=m.end;continue}const O=G(k.length,!0,o/n),x=r=>de(y,["-v","error","-y","-i",s,"-an",...O,r],void 0,F);let p=S(H,`held.${String(i)}.mp4`);const v=Z[i];K&&v?p=(await K.segment(nt(Buffer.from(JSON.stringify(["held across the join",v,O]))),P,x)).file:await x(p),ie[i]=p,h.capped=(h.capped??0)+1,o=qe(await Ge(p,T)??k,C,l,o).end}}const e=S(H,"segments.txt");await Mt(e,ie.map(n=>`file '${n.replace(/'/g,"'\\''")}'
+`).join(""));const t=d==="mov"?["-c:a","pcm_s24le"]:d==="webm"?["-c:a","libopus","-b:a",`${String(a.encode?.audioBitrate??160)}k`]:["-c:a","aac","-b:a",`${String(a.encode?.audioBitrate??192)}k`];V.push(a.out),await de(y,["-v","error","-y","-f","concat","-safe","0","-i",e,...D===void 0?[]:["-i",D],"-map","0:v",...D===void 0?[]:["-map","1:a"],"-c:v","copy",...D===void 0?[]:t,...d==="mp4"||d==="mov"?["-movflags","+faststart"]:[],...ge,a.out],void 0,F)}V.length=0,h.mux=A(pt),a.onProgress?.(1);const Xe=U??[a.out];let Ye=0;for(const e of Xe)Ye+=(await xt(e)).size;return{out:Xe[0]??a.out,frames:Fe,duration:Fe/l,bytes:Ye,...xe?{loudness:xe}:{},...$?.gainDb!==void 0?{master:{...$.before?{before:$.before}:{},gainDb:$.gainDb,...$.limited===void 0?{}:{limited:$.limited},target:$.target,...$.rounds===void 0?{}:{rounds:$.rounds}}}:{},...U?{files:U}:{},parts:{total:E.filter(e=>!e.junction).length,cached:We},...E.some(e=>e.junction)?{junctions:{total:E.filter(e=>e.junction).length,cached:Le}}:{},timings:{...h,total:A(me),part:h.part.map(e=>({...e,capture:Math.round(e.capture*1e3)/1e3,waitFrames:Math.round(e.waitFrames*1e3)/1e3,waitPipe:Math.round(e.waitPipe*1e3)/1e3}))}}}finally{await Promise.allSettled([...le,...N?[N]:[]]),await rt(),await Promise.all(V.map(q=>re(q,{force:!0}))),await re(H,{recursive:!0,force:!0})}}

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

@@ -0,0 +1,17 @@
+{
+  "name": "@allyhub-next/render",
+  "version": "0.5.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/dist/node_modules/@allyhub-next/runtime/dist/bridge.d.ts

@@ -0,0 +1,211 @@
+import type { NoteShape } from "@allyhub-next/formats";
+import type { LocatedLayer } from "./locate.js";
+import type { MixPlan } from "@allyhub-next/audio";
+import type { BuildSource, CaptionLine, CaptionOptions, ConsoleLog, CoverInfo, Fact, LayerAnswer, LayerQueries, LayoutReport, LoadOptions, MediaInfo, PageObjects, PartText, Problem, Reads, TextInk, Timeline, Track, Word } from "@allyhub-next/video-core";
+import type { SayNeed } from "./speech.js";
+export type { SayNeed };
+/** How a moment is drawn: for its picture, or for its layout alone (nothing reads its pixels). */
+export type DrawMode = "picture" | "layout";
+export interface DrawOptions {
+    /** Default "picture". `ctx.layoutOnly` is true for a "layout" draw. */
+    mode?: DrawMode;
+    /**
+     * Seconds after the frame's moment, under one frame: the sub-frame
+     * samples of motion blur. The frame's seed is kept.
+     */
+    offset?: number;
+    /** Only the graphic layers of this plane of the part (Part.planes). */
+    plane?: number;
+    /**
+     * This part alone, as a cut would show it, held at its first or last
+     * frame outside its own time: a render composites the two parts of a
+     * transition itself. Without it, inside a transition's window both
+     * parts are drawn, placed as the transition has them.
+     */
+    part?: string;
+}
+/** LoadedOutput.partSignature's answer. */
+export type PartSignature = {
+    sign: string;
+    owners: string[];
+    unknown?: undefined;
+} | {
+    unknown: string;
+};
+/** One output of one piece in one combo, ready to draw frame by frame. */
+export interface LoadedOutput {
+    readonly kind: "video" | "slides";
+    /** The film's plan; after ready() it has the parts' titles. */
+    readonly timeline: Timeline;
+    /** Fonts and media loaded and decoded; every layer mounted; every still drawn. */
+    ready(): Promise<void>;
+    /** Draws moment t (film seconds), on the frame grid; the picture is settled when it returns. */
+    seek(t: number, options?: DrawOptions): Promise<void>;
+    /** The words said in it, on its film clock, as its captions have them. */
+    words(): Word[];
+    /** Its caption lines on its film clock: each part's line as shown and as said, with its words. */
+    lines(): CaptionLine[];
+    /** The options its first layer that read its captions asked (ctx.captions), which its subtitles follow; null when none did. */
+    captionOptions(): CaptionOptions | null;
+    /** The player plays or pauses: footage plays along. */
+    setPlaying(on: boolean): void;
+    text(): PartText[];
+    reads(): Reads;
+    /**
+     * Every problem so far, for the page's whole life: loading's, and what
+     * went wrong at any moment drawn since (a layer that throws, work that
+     * fails or never settles, a picture that does not load).
+     */
+    problems(): Problem[];
+    /** The AK-P003 of the last seek, when that moment did not finish drawing. */
+    stuck(): string | undefined;
+    /** The longest one moment may take to draw, seconds (video({ seekLimit })). */
+    readonly seekLimit: number;
+    /**
+     * What loading found that is a fact, not a problem: layers drawn their
+     * fallback way (a face track, matte or take missing). The layout's facts
+     * come from measure().
+     */
+    facts(): Fact[];
+    /** The parts that say text through `say`, and the file each needs. */
+    says(): SayNeed[];
+    /**
+     * Each part's identity, by key: what its graphics are drawn from (layers,
+     * props, windows, words, what it read while mounting and at its still,
+     * the look, the format, its length in frames), as JSON. The host adds
+     * the footage and the code, and renders a part once per identity.
+     */
+    signs(): Record<string, string>;
+    /** Its sound as a plan, which @allyhub-next/audio renders (the player's and the export's). */
+    mixPlan(): MixPlan;
+    covers(): CoverInfo[];
+    drawCover(n: number): Promise<void>;
+    /**
+     * Measurements for the check's facts and allyhub inspect: at each moment
+     * (film seconds; default every part's still, the middle of every graphic
+     * layer's window and of every caption cue, and every second where the
+     * speaker shows, at most 24 a part) the text blocks on screen and what
+     * they overlap (each other, the face, the covered edges); and how much
+     * each footage layer is enlarged. Facts, no judgement.
+     */
+    measure(times?: readonly number[]): Promise<LayoutReport>;
+    /**
+     * Everything on screen followed frame by frame from `from` to `to` (film
+     * seconds): each part alone, its text blocks, painted boxes and pictures,
+     * with their box and opacity at every frame.
+     */
+    tracks(from: number, to: number): Promise<Track[]>;
+    /**
+     * The text blocks on screen at `t` (film seconds; each part drawn where
+     * it rests), each line's glyph box with the colour its glyphs are
+     * filled with: what the text-contrast fact measures the pixels behind
+     * them against.
+     */
+    inks(t: number): Promise<TextInk[]>;
+    /** A deck as it was drawn (@allyhub-next/slides-core's DrawnDeck): what its PowerPoint file is written from. Absent on a video. */
+    deck?(): unknown;
+    /** A deck's editor's command (@allyhub-next/slides-runtime's DeckEditCommand): a shape drawn at a frame, its text typed in place, what is typed posted back. Absent on a video. */
+    edit?(command: unknown, post: (message: unknown) => void): void;
+    /** What moment t shows that an editor lets a person point at: placed elements and text blocks with their message keys. */
+    objects(t: number): Promise<PageObjects>;
+    /**
+     * What the stage shows after the last seek, as a short string: two
+     * moments with the same signature draw the same pixels, so a render
+     * captures the frame once. Parts hidden at that moment are left out.
+     * Undefined when what shows holds something the DOM does not describe
+     * (a canvas, a video, an iframe, a GIF).
+     */
+    signature(): string | undefined;
+    /**
+     * The signature of moment t (film seconds), drawn for its layout alone:
+     * what signature() would say after seek(t), without painting what no
+     * signature reads. The stage's pixels are then not t's until the next
+     * seek.
+     */
+    signatureAt(t: number): Promise<string | undefined>;
+    /**
+     * What part `key` draws at each of `times` (film seconds), for the part
+     * cache, which keys a part drawn by code it cannot see into (a custom()
+     * layer, a scenery, a component of the piece's own file) by it: each
+     * moment drawn for its layout alone, the part alone, and what shows of
+     * the stage's DOM hashed with SHA-256, a hash of them all. A canvas in
+     * it says what it draws (data-ak-sign: a scenery's), or is said by the
+     * layer that drew it and that layer's own time, its code named in
+     * `owners`: a component's name, or "custom@" and the file that wrote a
+     * custom() layer's part. `unknown` says why there is no signature: a
+     * moment shows a video, an iframe, a GIF or a canvas outside any layer.
+     */
+    partSignature(key: string, times: readonly number[]): Promise<PartSignature>;
+    /**
+     * Asks every layer that answers `name` (StageContext.answer), in film
+     * order: each answer with the part and layer it came from.
+     */
+    ask<K extends keyof LayerQueries>(name: K, args: LayerQueries[K]["args"]): Promise<LayerAnswer<LayerQueries[K]["answer"]>[]>;
+    dispose(): void;
+}
+/** What a host reads once, after a load and its ready(). */
+export interface LoadedSummary {
+    kind: "video" | "slides";
+    timeline: Timeline;
+    problems: Problem[];
+    facts: Fact[];
+    reads: Reads;
+    text: PartText[];
+    says: SayNeed[];
+    signs: Record<string, string>;
+    covers: CoverInfo[];
+    /** Seconds (LoadedOutput.seekLimit). */
+    seekLimit: number;
+}
+/**
+ * Why a piece cannot load at all. The page rejects with an Error named
+ * "LoadFailure" whose message is `<code>: <text>`.
+ */
+export interface LoadFailureInfo {
+    code: string;
+    text: string;
+}
+/** The one global the runtime's bundle installs. */
+export interface StageBridge {
+    /** Loads one piece and readies it. Rejects with a LoadFailure when the piece cannot load at all. */
+    load(source: BuildSource, options: LoadOptions): Promise<LoadedSummary>;
+    /** The output loaded last; every call below is on it. */
+    readonly output: LoadedOutput | undefined;
+    /** What piece code printed since the last load began. */
+    console(): ConsoleLog;
+    /**
+     * Plays the output loaded last in real time, in this page (a preview's
+     * stage): its sound the export's mix, its controls drawn unless asked
+     * not to; the page that embeds it drives it with `command`.
+     */
+    play(options: PlayOptions): Promise<PlayControl>;
+    /** What a person's mark is on, in shares of the stage. */
+    locate(mark: NoteShape): LocatedLayer[];
+}
+/** What `play` takes: the player's options but the output and the stage, which are the page's. */
+export interface PlayOptions {
+    /** The project's media by path, as the stage sees them (with loudness). */
+    media?: Readonly<Record<string, MediaInfo>>;
+    /** Seeds the synthesized sounds like the export: piece:output:seed key. */
+    seed?: string;
+    /** Where to start, seconds. */
+    start?: number;
+    /** Tells the embedding page what happens (the player's events, as JSON). */
+    post?: (event: unknown) => void;
+    /** false: no control bar (the embedding page draws its own). */
+    chrome?: boolean;
+}
+/** A playing output, driven by the page that embeds it. */
+export interface PlayControl {
+    /** play, pause, seek, mode, next, prev, captions (the player's PlayerCommand). */
+    command(command: {
+        type: string;
+        [key: string]: unknown;
+    }): void;
+}
+declare global {
+    interface Window {
+        allyhub: StageBridge;
+    }
+}
+//# sourceMappingURL=bridge.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{momentOf as E,problem as x,timeParts as M,transitionSpec as O,transitionWindow as P}from"@allyhub-next/video-core";import{messageOf as S}from"./errors.js";const k=d=>Math.round(d*1e6)/1e6;export function timeFilm(d,y,c,p){const{source:u,ledger:h}=d,{fps:m,dims:g,options:D,format:T}=y,{specs:i,inputs:f}=c,l=p?.snapTo(f),n=M([...f],{fps:m,beat:p?.beat??0,beatPhase:p?.beatPhase??0,...l?{snap:l}:{}});c.videoTakes.forEach((t,e)=>{const r=n.parts[e];!t||!r||(t.shown.start=r.start,t.shown.partStart=r.start)});const w=i.map((t,e)=>{const r=n.parts[e],o=f[e]?.placed??[],s=[...o,...(f[e]?.anchors??[]).filter(a=>!o.some(F=>F.name===a.name))];return{key:t.key,start:r?.start??0,anchors:r?s.map(a=>({name:a.name,at:k(r.start+n.at(e,`@${a.name}`)),...a.end===void 0?{}:{end:k(r.start+n.at(e,`@/${a.name}`))}})):[]}}),b=t=>E({parts:w},t),A=(t,e)=>{try{if(typeof t=="number")return t;if(typeof t=="string")return b(t);const r=i.findIndex(s=>s.key===t.part),o=n.parts[r];if(r<0||!o)throw new Error(`The video has no part ${t.part}; its parts are ${i.map(s=>s.key).join(", ")}.`);return o.start+n.at(r,t.at)}catch(r){h.problems.push(x("AK-T004",`${e}: ${S(r)}`,{where:{file:u.file}}));return}},$=new Map;{const t=e=>Math.round((e.end-e.start)*m);i.forEach((e,r)=>{const o=n.parts[r-1],s=n.parts[r];if(e.transition===void 0||!o||!s)return;const a=P(O(e.transition),m,t(o),t(s));a.before+a.after>0&&$.set(r,a)})}return{timing:n,duration:n.duration,parts:w,filmAt:b,momentAt:A,windows:$,checkLimit(){const t=g.profile,e=D.maxDuration;t&&n.duration>t.maxDuration+1e-6&&!(e!==void 0&&e<=t.maxDuration)&&h.problems.push(x("AK-F001",`This video lasts ${n.duration.toFixed(1)} s, and ${t.label} (${T}) takes at most ${String(t.maxDuration)} s. Cut ${(n.duration-t.maxDuration).toFixed(1)} s: shorter parts, an edits file on the take, or fewer parts.`,{where:{file:u.file}}))}}}

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{contentEdges as Se,fact as ge,intersect as ze,problem as be,RULES as Ne,STRUCTURE as we,toFrame as Re,showLayer as ke}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,h]of Object.entries(u))c in p&&p[c]!==void 0&&(p[c]=resolveTimes(p[c],h,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)),h=t.until!==void 0?p(b(t.until)):t.dur!==void 0?p(c+t.dur):u;return[c,h]}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",h=[];t.forEach((n,r)=>{isFootage(n)?(h.push(r),r===b&&t.forEach((v,E)=>{p(v)&&h.push(E)})):!p(n)&&!c(n)&&h.push(r)}),t.forEach((n,r)=>{c(n)&&h.push(r)});const x=[],y=new Map,j=new Map;let S;for(const n of h){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:h,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:h,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),P=[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 B=i.reads??Le,U=i.record??(()=>{}),z=i.place,H=i.answers,I={look:S,format:n,dims:r,combo:i.combo??j,dur:i.dur,asset:a=>h.asset(a),optionalAsset:a=>h.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(be(W,a.message,{...a.level?{level:a.level}:{},..._?{part:_}:{},...A?.t===void 0?{}:{t:A.t}}))},captions:a=>B.captions(a),face:(a,A)=>B.face(a,A),faces:a=>B.faces(a),texts:a=>B.texts(a),covered:v,content:P,video:(a,A)=>b.video(a,A,U),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:()=>(U("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,xe=t=>Math.round(t*1e6)/1e6;export function compose(t){const{env:u,piece:b,stage:p,takes:c,film:h,captions:x,footage:y,sound:j}=t,{source:S,options:n,combo:r,picked:v,ledger:E}=u,{fps:P,format:ee,dims:i}=b,{specs:B}=c,{timing:U,windows:z}=h,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(be("AK-X005",`A layer of part ${w} reads ctx.combo.${g}, ${g===we?"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 B.entries()){const d=U.parts[w];if(!d)continue;const g=d.end-d.start,M=e=>U.at(w,e),ve=x.partWords(o.key),Ee=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 D;if(typeof o.still=="function")D=o.still(g);else if(o.still===void 0){D=Te(g);const e=z.get(w),s=z.get(w+1);if(e||s){const l=(e?.after??0)/P,k=g-((s?.before??0)+1)/P;D=Math.max(l,Math.min(D,k))}}else D=M(o.still);let q=Re(d.start+D,P);(q<d.start||q>=d.end)&&(q=d.start);const te=o.slot??(v.has(o.key)&&o.key!==we?o.key:void 0),Ae=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,le=o.post??J.map(e=>"props"in e?e.props.sensor?.grade:void 0).find(Boolean),N=c.videoTakes[w],m={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]}:{},...le?{post:{filter:le.filter}}:{},...o.speechGainDb!==void 0&&o.speechGainDb!==0?{speechGainDb:o.speechGainDb}:{},...N?{plays:{video:N.id,from:N.from,to:N.to}}:{}};H.push(m),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"}),ke($,!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 Oe={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=[],ue=new Map;for(const[e,s]of J.entries()){const[l,k]=windowOf(s,g,M);if(isFootage(s)){const G=e===ne,Z=y.plan(s,m,Ee,d.speechAt,l,k,{at:M,cutout:G,over:fe.get(e)??0,person:G&&R!==void 0});if(Z&&A){const he=Q.get(e)??$,{matteUrl:ye,personOver:$e,...je}=Z;a.push({...je,host:he,...ye===void 0?{}:{cutoutIn:{host:$e&&R?R:he,matte:ye}}})}continue}const f=zOf(s),C=re.get(e)??0;K[C]?.layers.push({component:s.component,start:xe(m.start+l),end:xe(m.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"}),ke(O,!1),ue.set(e,O);const T=s.times?resolveTimes(s.props,s.times,M):s.props,Y=V.slice(),me=new Map,Me=t.contexts({dur:g,words:()=>ve,at:M,start:l,end:k,combo:Ae,reads:{...Oe,texts:G=>t.texts({part:m,el:$},Y,G)},record:(G,Z)=>se.reads.set(G,Z),place:{start:m.start,part:o.key},answers:me});V.push({spec:s,index:e,props:T,el:O,ctx:Me,start:l,end:k,z:f,plane:C,answers:me})}let F=$,L;if(K.some(e=>e.overlay===!0)){F=document.createElement("div"),L=document.createElement("div"),F.className="ak-picture",L.className="ak-overlays";for(const e of[F,L])Object.assign(e.style,{position:"absolute",inset:"0",overflow:"hidden"}),$.append(e)}pe.forEach((e,s)=>{const l=Q.get(e)??ue.get(e);l&&(L&&oe.overlaid(e)?L:F).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)&&F.append(R)}),j.sfx(o,m,M),N&&j.carry(N.inner,N.from,N.to,m.start,m.key,0);for(const e of V){const s=c.shownBy.get(e.spec);s&&(s.shown.start=m.start+e.start,s.shown.partStart=m.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,m.start+e.start,m.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!==m.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(ge("graphics-under-footage",{piece:S.piece,part:o.key,t:m.start},{layers:l,footage:k,covered:Math.max(...k.map(f=>f.frame))}))}),oe.hasBehind&&ne<0&&E.facts.push(ge("fallback",{piece:S.piece,part:o.key},{missing:"own-footage",for:"behind-person",fallback:"in-front"})),I.push({part:m,spec:o,n:w,el:$,picture:F,...L?{overlays:L}:{},layers:V,record:se})}return{parts:H,mounted:I,clips:a}}

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{entryKind as b}from"@allyhub-next/formats";import{comboKey as y,dimsCombo as x,problem as k,seedKey as g,STRUCTURE as j,validCombo as L}from"@allyhub-next/video-core";import{installConsole as O,resetConsole as C}from"./console.js";import{codeOf as S,LoadFailure as R}from"./errors.js";import{installGuards as E,realNow as l,within as K}from"./guards.js";import{ReadLog as T}from"./reads.js";export const RUN_PROBLEMS=200;export class Ledger{problems=[];facts=[];run=[];times=[];running;loading=!0;doing;waiting=[];ran(e){this.run.length>=RUN_PROBLEMS||this.run.some(i=>i.code===e.code&&i.message===e.message&&i.part===e.part)||this.run.push(e)}async timed(e,i){const a=l();try{return await i()}finally{this.times.push({what:e,ms:l()-a})}}wait(e){const i=this.running;if(!this.loading){this.waiting.push({work:e,who:i});return}const a=this.doing??"a layer",o=l();this.waiting.push({work:e.finally(()=>{this.times.push({what:`the work ${a} waited for (ctx.wait)`,ms:l()-o})}),who:i})}async settle(e){const i=l()+e,a=[];for(;this.waiting.length>0;){const o=this.waiting.splice(0);if((await K(o.map(n=>n.work),i-l())).forEach((n,d)=>{const r=o[d]?.who;if(n===void 0){a.push(`the work ${u(r)} waits for (ctx.wait)`);return}if(n.status==="fulfilled")return;const f=n.reason;this.ran(k(S(n.reason),`${u(r)}: the work it waits for (ctx.wait) failed: ${String(f.message??n.reason)}`,{...r?.part===void 0?{}:{part:r.part},...r?.t===void 0?{}:{t:r.t}}))}),a.length>0)break}return a}}const u=t=>t?.what??"A layer";function v(t,e){const i=t.dims,a=t.matrix?.space;if(L(a,i,t.matrix?.rules??[],e.combo))return;const o=a?`; slots: ${Object.entries(a.slots).map(([s,n])=>`${s}=${n.map(d=>d.name).join("|")}`).join(", ")}${a.declared?`; structures: ${Object.keys(a.structures).join("|")}`:""}; and the matrix's rules`:"";throw new R("bad_combo",`Piece ${t.piece} has no combo ${y(e.combo)} (dimensions: ${Object.entries(i).map(([s,n])=>`${s}=${n.join("|")}`).join(", ")||"none"}${o}).`)}export function createEnv(t,e,i){const a=l();v(t,e);const o={...e.combo},s=o.lang,n=t.locales[0],d=!i&&b(t.file)==="slides"?"slides":"video",r=`${t.piece}:${d}:${g(o,t.format)}`,f=g(x(t.dims,o),t.format),c=t.matrix?.space,$=new Set(c?[...Object.keys(c.slots),...c.declared?[j]:[]]:[]),p=E();p.setMoment(0,`${r}:load`),i||(O(),C({...e.consoleLimit===void 0?{}:{limit:e.consoleLimit},passThrough:e.purpose==="play"}));const h=new T({lang:s,defaultLang:n,...t.text===void 0?{}:{text:t.text},own:s===void 0?{}:t.messages[s]??{},fallback:n===void 0?{}:t.messages[n]??{},...t.anchors?{anchors:{...s!==void 0&&t.anchors[s]?{own:t.anchors[s]}:{},...n!==void 0&&t.anchors[n]?{fallback:t.anchors[n]}:{}}}:{},media:t.media,file:t.file,...t.data?{data:t.data}:{}});return{source:t,options:e,embed:i,combo:o,lang:s,defaultLang:n,output:d,seedBase:r,partSeed:(m,w)=>`${t.piece}:${d}:${f}:${m}:${String(w)}`,picked:$,space:c,guards:p,log:h,ledger:new Ledger,start:a,mediaOf:(m,w)=>typeof m=="string"?h.asset(m,w):h.mediaAt(m.path)??h.asset(`/${m.path}`)}}