@allyhub/sdk 0.1.0-alpha.7 → 0.2.0-next.0

package/node_modules/@allyhub-next/video-core/dist/audio-types.d.ts

@@ -0,0 +1,148 @@
+/** An output's mix levels (`video({ mix })`), LUFS; each default is the audio package's. */
+export interface MixOptions {
+    /** Each part's speech; default -16. */
+    speech?: number;
+    /** The music while speech plays; default -20. */
+    music?: number;
+    /** The music where nobody speaks; default -16. */
+    musicAlone?: number;
+    /** Sound effects from files; built-in sounds move by the same amount from the default; default -22. */
+    sfx?: number;
+    /** Footage's own sound where nobody speaks; default -16. */
+    footage?: number;
+    /** Footage's own sound while speech plays; default -22. */
+    footageUnderSpeech?: number;
+    /**
+     * How the music dips under words: `db` below its level while speech
+     * plays (default -8), going down over `attack` seconds before a word
+     * (0.3), back up over `release` after one (1), and staying down
+     * through pauses shorter than `hold` (2).
+     */
+    duck?: {
+        db?: number;
+        attack?: number;
+        release?: number;
+        hold?: number;
+    };
+    /** The music's fade in at the start and out at the end, seconds; defaults 0.3 and 1.5 (at most a quarter of the video). */
+    musicFade?: {
+        in?: number;
+        out?: number;
+    };
+}
+/** The mix's settings with every default filled in. */
+export interface MixLevels {
+    speech: number;
+    music: number;
+    musicAlone: number;
+    sfx: number;
+    footage: number;
+    footageUnderSpeech: number;
+    duck: {
+        db: number;
+        attack: number;
+        release: number;
+        hold: number;
+    };
+    musicFade: {
+        in: number;
+        out: number;
+    };
+}
+export interface MasterOptions {
+    /**
+     * Integrated loudness, LUFS (-70 to 0); default the platform profile's,
+     * else -14. false keeps the mix's own level (peaks still limited).
+     */
+    lufs?: number | false;
+    /** True-peak ceiling, dBTP (-9 to 0); default -3 (AAC overshoots up to about 2 dB). */
+    truePeak?: number;
+}
+/** The master's targets, or false to keep the mix's level (its peaks still limited to `truePeak`). */
+export interface MasterTargets {
+    lufs: number | false;
+    truePeak: number;
+}
+export declare const BAND_TYPES: readonly ["highpass", "lowpass", "bandpass", "peak", "lowshelf", "highshelf"];
+export type BandType = (typeof BAND_TYPES)[number];
+/**
+ * A moment of the film a video-level option names: film seconds, an
+ * anchor of any part ("@drop", "@drop+0.2", "@/drop") or a part's key
+ * (its start), or a word reference in a part (`{ part, at }`: `at` as a
+ * layer's at, from that part's start).
+ */
+export type SoundMoment = number | string | {
+    part: string;
+    at: number | string;
+};
+/**
+ * A band's values from a moment of the film on: `at` is the moment (the
+ * music's own reference: film seconds, an anchor, a part or a word in a
+ * part), and what it leaves out is the band's own value.
+ */
+export interface BandKey<T = SoundMoment> {
+    at: T;
+    hz?: number;
+    db?: number;
+    q?: number;
+}
+/**
+ * One band of an equalizer: a pass (`highpass`, `lowpass`, `bandpass`,
+ * with its `q`, default a Butterworth's 0.707), a `peak` (`db` at `hz`,
+ * `q` default 1) or a shelf (`lowshelf`, `highshelf`: `db` under or over
+ * `hz`, `q` the shelf's slope, default 1). `keys` move its values over
+ * the film's clock (music only).
+ */
+export interface EqBand<T = SoundMoment> {
+    type: BandType;
+    hz: number;
+    db?: number;
+    q?: number;
+    keys?: BandKey<T>[];
+}
+/**
+ * A compressor: from `threshold` dB over the stem's loudness (its
+ * integrated loudness as shaped so far: 0 is at it, -6 six dB under), the
+ * level over it is divided by `ratio`.
+ */
+export interface SoundCompressor {
+    threshold: number;
+    /** Input dB over the threshold per output dB; default 2. */
+    ratio?: number;
+    /** The knee's width, dB; default 6. */
+    knee?: number;
+    /** Seconds to go down, and to come back up; defaults 0.01 and 0.15. */
+    attack?: number;
+    release?: number;
+    /** The detector's window, seconds (0: the peak); default 0.01. */
+    window?: number;
+}
+/** How a stem is shaped (`music: { filter, eq, compress }`, a sound's own). */
+export interface SoundShape<T = SoundMoment> {
+    /**
+     * An ffmpeg audio filter chain run on the file as it is decoded, on the
+     * file's own clock ("acompressor=ratio=3,deesser"): one chain, nothing
+     * that reads files, makes sound of its own or changes the timing.
+     */
+    filter?: string;
+    /** Equalizer bands, in order. */
+    eq?: EqBand<T>[];
+    /** A compressor after the bands. */
+    compress?: SoundCompressor;
+}
+/** A shape whose bands do not move (a sound effect's). */
+export type FixedShape = Omit<SoundShape, "eq"> & {
+    eq?: Omit<EqBand, "keys">[];
+};
+/** A shape resolved for the mix: its keys at film seconds. */
+export type ResolvedShape = SoundShape<number>;
+/**
+ * How a voice was recorded (`video({ mic })`, `part({ mic })`): a setup by
+ * name (studio, phone, lav), a setup's options with any value changed, or
+ * false (played as it is). Its fields and their checks are the audio
+ * package's recording; here it is only carried.
+ */
+export type VoiceSetting = string | Readonly<Record<string, unknown>> | false;
+/** A voice setting resolved over its presets, as the audio package resolves it. */
+export type ResolvedVoice = Readonly<Record<string, unknown>>;
+//# sourceMappingURL=audio-types.d.ts.map

package/node_modules/@allyhub-next/video-core/dist/audio-types.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const BAND_TYPES=["highpass","lowpass","bandpass","peak","lowshelf","highshelf"];

package/node_modules/@allyhub-next/video-core/dist/backdrop.d.ts

@@ -0,0 +1,87 @@
+/**
+ * The softness of the person's edge over a treated background when the
+ * layer does not say (`background.feather`): px at 1080p.
+ */
+export declare const MATTE_FEATHER = 2;
+/**
+ * How far the person's edge is pulled in then (`background.shrink`): px at
+ * 1080p. A little, so the rim of the old background the matte keeps round
+ * the person does not show against the new one.
+ */
+export declare const MATTE_SHRINK = 4;
+/** The most `background.blur`, `feather` and `shrink` take, px at 1080p. */
+export declare const BACKDROP_BLUR_MAX = 200;
+export declare const MATTE_FEATHER_MAX = 40;
+export declare const MATTE_SHRINK_MAX = 40;
+/**
+ * The frame's pixels in one "px at 1080p": a background's lengths (blur,
+ * feather, shrink) scale with the format's shorter side, so the same
+ * numbers look the same in every format.
+ */
+export declare function backdropUnit(width: number, height: number): number;
+/**
+ * A matte's levels are made firm before anything else: under the first
+ * (of 0–1) is none of the person, over the second all, a straight ramp
+ * between. A matte is a guess, and where it is unsure inside the person (a
+ * hand moving in front of the chest comes out at 0.9) the person is not
+ * see-through; its edge is then one clean line to soften and pull in.
+ */
+export declare const MATTE_FIRM: readonly [number, number];
+/** The firm level (0–255) of each level of a matte (0–255). */
+export declare function firmLevels(): Uint8ClampedArray;
+/** The same as an ffmpeg expression of `val` (0–255), for the lut filter. */
+export declare function firmLevelsExpr(): string;
+/**
+ * How a matte becomes the person's alpha: made firm (firmLevels), blurred
+ * by `sigma`, then each level m (0–1) becomes m / (m + gain × (1 − m)).
+ */
+export interface MatteEdge {
+    /** Gaussian blur of the matte, its standard deviation in the frame's pixels (0: none). */
+    sigma: number;
+    /** Over 1 pulls the edge in, under 1 lets it out, 1 leaves it. */
+    gain: number;
+}
+/**
+ * After the blur, a matte's lowest and highest levels count as none and
+ * all of the person: a little of each end, so that a level one short of
+ * all (the blur's rounding) does not make the whole person see-through
+ * once the edge is pulled in.
+ */
+export declare const MATTE_FLOOR = 6;
+/**
+ * The person's edge from a matte: `feather` softens it and `shrink` pulls
+ * it in (negative: lets it out), both in the frame's pixels; `scale` is
+ * the frame's pixels per matte pixel (a matte is smaller than the picture,
+ * so its edge, made firm, is still about a fifth of a matte pixel soft).
+ *
+ * The firm matte is blurred, which makes its edge an S-shaped ramp around
+ * where it was, as soft as the feather and the matte's own softness
+ * together. Sliding that ramp `shrink` pixels along is, on its levels,
+ * m → m / (m + gain × (1 − m)) with gain = exp(1.702 × shrink / softness)
+ * (the logistic curve that follows a Gaussian edge within a hundredth). A
+ * shrink the ramp is too narrow for (over 1.5 times its softness, where
+ * the levels left would be too few) widens the blur.
+ */
+export declare function matteEdge(feather: number, shrink: number, scale: number): MatteEdge;
+/** The person's alpha (0–255) for each level of a blurred matte (0–255). */
+export declare function edgeLevels(edge: MatteEdge): Uint8ClampedArray;
+/**
+ * The same levels as an ffmpeg expression of `val` (0–255), for the lut
+ * filter.
+ */
+export declare function edgeLevelsExpr(edge: MatteEdge): string;
+/**
+ * How much smaller a background is blurred: a blur of standard deviation
+ * `sigma` (pixels) holds no detail finer than about a third of it, so the
+ * picture is blurred at 1/2, 1/4 or 1/8 of its size and scaled back.
+ */
+export declare function blurStep(sigma: number): 1 | 2 | 4 | 8;
+/**
+ * The colour matrix of a background's `desaturate` and `dim` (each 0–1):
+ * rows for red, green and blue out, columns for red, green and blue in.
+ * The same as CSS `saturate(1 − desaturate) brightness(1 − dim)`.
+ */
+export declare function backdropMatrix(desaturate: number, dim: number): [Row, Row, Row];
+/** A row of a colour matrix: how much of red, green and blue goes into one channel. */
+export type Row = [r: number, g: number, b: number];
+//# sourceMappingURL=backdrop.d.ts.map

package/node_modules/@allyhub-next/video-core/dist/backdrop.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const MATTE_FEATHER=2,MATTE_SHRINK=4,BACKDROP_BLUR_MAX=200,MATTE_FEATHER_MAX=40,MATTE_SHRINK_MAX=40;export function backdropUnit(t,o){return Math.min(t,o)/1080}export const MATTE_FIRM=[.25,.75];export function firmLevels(){const t=new Uint8ClampedArray(256),[o,n]=MATTE_FIRM;for(let r=0;r<256;r++)t[r]=Math.round((r/255-o)/(n-o)*255);return t}export function firmLevelsExpr(){const[t,o]=MATTE_FIRM;return`clip((val-${String(t*255)})/${String(o-t)},0,255)`}export const MATTE_FLOOR=6;export function matteEdge(t,o,n){const r=.2*Math.max(0,n),a=Math.max(Math.hypot(t,r),Math.abs(o)/1.5,.001),c=Math.sqrt(Math.max(0,a*a-r*r)),e=s=>Math.round(s*1e4)/1e4;return{sigma:e(c),gain:e(Math.exp(1.702*o/a))}}export function edgeLevels(t){const o=new Uint8ClampedArray(256);for(let n=0;n<256;n++){const r=Math.min(Math.max((n-MATTE_FLOOR)/(255-2*MATTE_FLOOR),0),1);o[n]=Math.round(255*r/(r+t.gain*(1-r)))}return o}export function edgeLevelsExpr(t){const o=255-2*MATTE_FLOOR,n=`clip((val-${String(MATTE_FLOOR)})/${String(o)},0,1)`;return`255*${n}/(${n}+${String(t.gain)}*(1-${n}))`}export function blurStep(t){return t>=24?8:t>=12?4:t>=6?2:1}const i=[.2126,.7152,.0722];export function backdropMatrix(t,o){const n=Math.min(Math.max(t,0),1),r=1-Math.min(Math.max(o,0),1),a=e=>Math.round(e*1e4)/1e4,c=e=>[a(r*(n*i[0]+(e===0?1-n:0))),a(r*(n*i[1]+(e===1?1-n:0))),a(r*(n*i[2]+(e===2?1-n:0)))];return[c(0),c(1),c(2)]}

package/node_modules/@allyhub-next/video-core/dist/captions.d.ts

@@ -0,0 +1,122 @@
+import type { Word } from "./media.js";
+import type { CaptionOptions, CaptionTrackCue, CaptionWord } from "./piece.js";
+import type { PartText, Timeline } from "./timeline.js";
+export interface CaptionCue {
+    start: number;
+    end: number;
+    text: string;
+    part: string;
+}
+export interface CaptionLine {
+    part: string;
+    /** The line as shown, and as spoken. */
+    shown: string;
+    spoken: string;
+    /** The part's words on the film's clock. */
+    words: readonly Word[];
+}
+export interface CaptionInput {
+    /** Voiced parts in order. */
+    lines: CaptionLine[];
+    fps: number;
+}
+/** How subtitle cues are cut and timed (srt and vtt, and the player's captions). */
+export interface CaptionCueOptions {
+    /** Most characters on a cue's line. */
+    maxChars?: number;
+    /** Most characters on a line in Chinese, Japanese or Korean. */
+    maxCharsCjk?: number;
+    /** Shortest a cue lasts, in seconds (unless the next cue starts sooner). */
+    minSeconds?: number;
+    /** Longest a cue lasts, in seconds. */
+    maxSeconds?: number;
+    /** Frames left between a cue's end and the next cue's start. */
+    gapFrames?: number;
+}
+/** The values captionCues uses for options not given. */
+export declare const CAPTION_CUE_DEFAULTS: Readonly<Required<CaptionCueOptions>>;
+/**
+ * The caption lines of a timeline: each voiced part's words (from its
+ * take's words file), with the text it says.
+ */
+export declare function speechLines(timeline: Pick<Timeline, "parts">, texts: readonly PartText[], media: Readonly<Record<string, {
+    words?: Word[] | undefined;
+}>>): CaptionLine[];
+/**
+ * Where a place in a line as shown is in the line as said, both counted in
+ * letters and digits (normText). The words the two share are at the same
+ * place in both; inside a stretch that differs, the place is in proportion.
+ * Two lines with nothing in common are in proportion from end to end.
+ */
+export declare function shownToSpoken(shown: string, spoken: string): (place: number) => number;
+/** Character spans of a line, [from, to): a break never falls inside one. */
+export type KeptSpan = [from: number, to: number];
+/**
+ * Where a line says each phrase of `keep` (whole words, matched as said:
+ * case, accents and punctuation ignored), as character spans of the line.
+ * Chinese, Japanese and Korean phrases match inside the text.
+ */
+export declare function keptSpans(line: string, keep: readonly string[]): KeptSpan[];
+/**
+ * Splits a line into caption-sized pieces, keeping their positions. A
+ * piece breaks at no position inside a `keep` span: a piece that cannot
+ * break elsewhere stays longer than `max`.
+ */
+export declare function splitLine(line: string, max?: number, keep?: readonly KeptSpan[]): {
+    text: string;
+    from: number;
+    to: number;
+}[];
+/**
+ * Subtitle cues from the voiced parts' lines: one line per cue, cut at
+ * sentence ends, then clauses, then the length; frame-snapped, between
+ * minSeconds and maxSeconds long, gapFrames before the next cue.
+ * Options not given are CAPTION_CUE_DEFAULTS.
+ */
+export declare function captionCues(input: CaptionInput, options?: CaptionCueOptions): CaptionCue[];
+/**
+ * The subtitles (srt, vtt and the player's captions). A piece whose layers
+ * read its captions (`ctx.captions(options)`) has its subtitles cut and
+ * timed as the captions it burns in, by the options its first such layer
+ * asked; a piece without one, by captionCues and CAPTION_CUE_DEFAULTS.
+ */
+export declare function subtitleCues(input: CaptionInput, asked?: CaptionOptions): CaptionCue[];
+/** A cue with its words, on the film's clock. */
+export interface WordCue {
+    start: number;
+    end: number;
+    text: string;
+    part: string;
+    words: CaptionWord[];
+}
+export interface WordCueOptions {
+    fps: number;
+    /** Most characters in a cue; default 32 (16 for Chinese, Japanese and Korean). */
+    maxChars?: number;
+    /** Most words in a cue; default no limit. */
+    maxWords?: number;
+    /**
+     * Phrases a cue never breaks inside ("work harder"), wherever a line
+     * says them: the cue around one may run over maxChars or maxWords.
+     */
+    keep?: readonly string[];
+    /** Seconds: a gap between two cues of a part shorter than this closes; default 0.4. */
+    close?: number;
+}
+/**
+ * Caption cues with word times, for the burned-in captions track: each
+ * voiced part's line (as written; the times from aligning it to the
+ * words heard), cut at sentence and clause ends, then by length and word
+ * count. A cue never spans two parts. Cues follow each other without a
+ * flicker: a gap under `close` (0.4 s) is closed.
+ */
+export declare function wordCues(lines: readonly CaptionLine[], opts: WordCueOptions): WordCue[];
+/**
+ * The cues a part shows over its picture [start, end) in film seconds,
+ * on the part's clock: cues are clipped to the picture (a J or L cut's
+ * speech heard under a neighbour's picture shows there).
+ */
+export declare function cuesIn(cues: readonly WordCue[], start: number, end: number): CaptionTrackCue[];
+export declare function toSrt(cues: readonly CaptionCue[]): string;
+export declare function toVtt(cues: readonly CaptionCue[]): string;
+//# sourceMappingURL=captions.d.ts.map

package/node_modules/@allyhub-next/video-core/dist/captions.js

@@ -0,0 +1,11 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{changesOf as V}from"./anchors.js";import{normText as p,joinWords as z,ScriptAlignment as v,WordStream as F}from"./words.js";import{speechWords as D}from"./speech.js";export const CAPTION_CUE_DEFAULTS={maxChars:42,maxCharsCjk:16,minSeconds:.8,maxSeconds:6,gapFrames:2};export function speechLines(f,o,c){return f.parts.flatMap(r=>{const s=r.speech,h=s?c[s.file]?.words:void 0;if(!s||!h?.length)return[];const a=D(h,s);if(a.length===0)return[];const n=o.find(t=>t.key===r.key),e=n?.spoken??z(a);return[{part:r.key,shown:e,spoken:n?.speak??e,words:a}]})}export function shownToSpoken(f,o){const c=(s,h)=>p(s.slice(0,h)).length,r=[[0,0]];for(const s of V(f,o))r.push([c(f,s.at),c(o,s.into)]),r.push([c(f,s.at+s.removed),c(o,s.into+s.inserted)]);return r.push([p(f).length,p(o).length]),s=>{for(let h=1;h<r.length;h++){const[a,n]=r[h-1]??[0,0],[e,t]=r[h]??[0,0];if(s>e&&h<r.length-1)continue;if(e<=a)return s<=a?n:t;const u=Math.max(0,Math.min(1,(s-a)/(e-a)));return n+(t-n)*u}return 0}}const b=/[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]/u,G=/[。！？!?…]|\.(?=\s|$)/u,J=/[，、；：,;:—]/u,H=/[，、；：。,;:.\s]+$/u;export function keptSpans(f,o){const c=[],r=U(f).map(s=>({...s,n:p(s.w)}));for(const s of o){const h=p(s);if(!h)continue;if(b.test(s)){const n=[];Array.from(f).reduce((t,u)=>(p(u)&&n.push(t),t+u.length),0);const e=p(f);for(let t=e.indexOf(h);t>=0;t=e.indexOf(h,t+1)){const u=n[t],x=n[t+h.length-1];u!==void 0&&x!==void 0&&c.push([u,x+1])}continue}const a=s.split(/\s+/u).map(p).filter(Boolean);for(let n=0;n+a.length<=r.length;n++)if(a.every((e,t)=>r[n+t]?.n===e)){const e=r[n],t=r[n+a.length-1];e&&t&&c.push([e.from,t.to])}}return c}const _=(f,o)=>f.some(([c,r])=>o>c&&o<r);export function splitLine(f,o=b.test(f)?CAPTION_CUE_DEFAULTS.maxCharsCjk:CAPTION_CUE_DEFAULTS.maxChars,c=[]){const r=[],s=(a,n)=>{const e=f.slice(a,n),t=e.length-e.trimStart().length,u=e.trim();u&&r.push({text:u,from:a+t,to:a+t+u.length})},h=(a,n,e)=>{const t=f.slice(a,n);if(Array.from(t.trim()).length<=o){s(a,n);return}const x=e===0?G:e===1?J:void 0;if(x){let i=-1;for(let S=1;S<t.length-1;S++)x.test(t[S]??"")&&!_(c,a+S+1)&&(i<0||Math.abs(S-t.length/2)<Math.abs(i-t.length/2))&&(i=S);if(i<0){h(a,n,e+1);return}h(a,a+i+1,e),h(a+i+1,n,e);return}const w=Math.floor(t.length/2),C=i=>i>0&&i<t.length&&!_(c,a+i);let g=-1;if(!b.test(t)){for(let i=w;i>0&&g<0;i--)t[i]===" "&&C(i)&&(g=i);for(let i=w;i<t.length&&g<0;i++)t[i]===" "&&C(i)&&(g=i)}for(let i=0;i<=t.length&&g<0;i++)C(w-i)?g=w-i:C(w+i)&&(g=w+i);if(g<0){s(a,n);return}h(a,a+g,e),h(a+g,n,e)};return h(0,f.length,0),r}export function captionCues(f,o={}){const{lines:c,fps:r}=f,s={...CAPTION_CUE_DEFAULTS,...o},h=[];for(const t of c){if(t.words.length===0)continue;const u=t.words,x=new v(new F(u),[t.spoken]),w=(M,l)=>{const d=u[x.wordAtChar(0,M)];return d?l?d.end:d.start:0};if((x.lines[0]?.length??0)===0)continue;const i=p(t.shown)===p(t.spoken)?M=>M:shownToSpoken(t.shown,t.spoken),S=b.test(t.shown)?s.maxCharsCjk:s.maxChars;for(const M of splitLine(t.shown,S)){const l=Math.round(i(p(t.shown.slice(0,M.from)).length)),d=Math.round(i(p(t.shown.slice(0,M.to)).length)),k=w(l,!1),L=w(Math.max(l,d-1),!0),W=b.test(M.text)?M.text.replace(H,""):M.text.replace(/[,;:]+$/u,"");W&&h.push({start:k,end:Math.max(L,k),text:W,part:t.part})}}const a=1/r,n=t=>Math.round(t*r)/r,e=h.map(t=>({...t,start:n(t.start),end:n(t.end)}));for(let t=0;t<e.length;t++){const u=e[t];if(!u)continue;const x=e[t+1],w=x?x.start-s.gapFrames*a:1/0;u.end=Math.min(Math.max(u.end,u.start+s.minSeconds),u.start+s.maxSeconds,w),u.end<=u.start&&(u.end=u.start+a)}return e}export function subtitleCues(f,o){return o===void 0?captionCues(f):wordCues(f.lines,{...o,fps:f.fps}).map(c=>({start:c.start,end:c.end,text:c.text,part:c.part}))}function U(f){const o=[],c=/\S+/gu;for(let r=c.exec(f);r;r=c.exec(f))o.push({w:r[0],from:r.index,to:r.index+r[0].length});return o}export function wordCues(f,o){const{fps:c}=o,r=[];for(const n of f){if(n.words.length===0)continue;const e=n.words,t=new v(new F(e),[n.spoken]);if((t.lines[0]?.length??0)===0)continue;const x=(l,d)=>{const k=e[t.wordAtChar(0,l)];return k?d?k.end:k.start:0},C=p(n.shown)===p(n.spoken)?l=>l:shownToSpoken(n.shown,n.spoken),g=(l,d)=>{const k=Math.round(C(p(n.shown.slice(0,l)).length)),L=Math.round(C(p(n.shown.slice(0,d)).length));return[x(k,!1),x(Math.max(k,L-1),!0)]},i=b.test(n.shown),S=o.maxChars??(i?16:32),M=keptSpans(n.shown,o.keep??[]);for(const l of splitLine(n.shown,S,M)){const d=(i?[{w:l.text,from:l.from,to:l.to}]:U(n.shown.slice(l.from,l.to)).map(m=>({w:m.w,from:m.from+l.from,to:m.to+l.from}))).filter(m=>p(m.w)!=="");if(d.length===0)continue;const k=o.maxWords&&o.maxWords>0?o.maxWords:d.length,L=Math.ceil(d.length/k),W=Math.ceil(d.length/L),O=[];d.forEach((m,A)=>{const j=d[A-1],E=O.at(-1);E&&j&&_(M,Math.ceil((j.to+m.from)/2))?E.push(m):O.push([m])});const I=[];let $=[];for(const m of O)$.length>0&&$.length+m.length>W&&(I.push($),$=[]),$.push(...m);$.length>0&&I.push($);for(const m of I){const A=m.map(T=>{const[N,K]=g(T.from,T.to);return{text:T.w,start:N,end:Math.max(K,N)}}),j=A[0],E=A.at(-1);if(!j||!E)continue;const B=m.map(T=>T.w).join(i?"":" ").replace(i?H:/[,;:]+$/u,"");r.push({start:j.start,end:E.end,text:B,part:n.part,words:A})}}}const s=n=>Math.round(n*c)/c,h=1/c,a=r.map(n=>({...n,start:s(n.start),end:s(n.end)}));for(let n=0;n<a.length;n++){const e=a[n];if(!e)continue;const t=a[n+1],u=t?.part===e.part;t&&u&&t.start-e.end<(o.close??.4)&&(e.end=t.start),e.end=Math.max(e.end,e.start+Math.min(.5,6*h)),t&&e.end>t.start&&(e.end=t.start),e.end<=e.start&&(e.end=e.start+h)}return a}export function cuesIn(f,o,c){const r=s=>Math.round(s*1e6)/1e6;return f.filter(s=>s.end>o&&s.start<c).map(s=>({start:r(Math.max(s.start,o)-o),end:r(Math.min(s.end,c)-o),text:s.text,words:s.words.map(h=>({text:h.text,start:r(h.start-o),end:r(h.end-o)}))}))}const y=(f,o)=>{const c=Math.round(f*1e3),r=Math.floor(c/36e5),s=Math.floor(c/6e4)%60,h=Math.floor(c/1e3)%60,a=(n,e=2)=>String(n).padStart(e,"0");return`${a(r)}:${a(s)}:${a(h)}${o}${a(c%1e3,3)}`};export function toSrt(f){return f.map((o,c)=>`${String(c+1)}
+${y(o.start,",")} --> ${y(o.end,",")}
+${o.text}
+`).join(`
+`)}export function toVtt(f){return`WEBVTT
+
+${f.map(o=>`${y(o.start,".")} --> ${y(o.end,".")}
+${o.text}
+`).join(`
+`)}`}

package/node_modules/@allyhub-next/video-core/dist/console.d.ts

@@ -0,0 +1,91 @@
+import type { Combo } from "./matrix.js";
+export declare const CONSOLE_LEVELS: readonly ["log", "info", "warn", "error", "debug"];
+export type ConsoleLevel = (typeof CONSOLE_LEVELS)[number];
+/**
+ * What piece code was doing when it printed: loading its files' top level
+ * (`module`), running the output's function (`build`), a layer's `mount`
+ * or `render`, drawing a cover (`cover`), or anything else, such as a
+ * callback that ran later (`other`).
+ */
+export type ConsolePhase = "module" | "build" | "mount" | "render" | "cover" | "other";
+/** Where a console call was made, as the stage knows it. */
+export interface ConsoleWhere {
+    phase: ConsolePhase;
+    /** The part (or page) whose layer was running. */
+    part?: string;
+    /** The layer's component name ("custom" for custom()). */
+    layer?: string;
+    /** The layer's place in its part's `layers`, from 0. */
+    index?: number;
+    /** render and cover: the part time drawn, seconds from the part's start (render's t). */
+    t?: number;
+}
+/** One message: the same text printed at the same place, with its count. */
+export interface ConsoleMessage extends ConsoleWhere {
+    level: ConsoleLevel;
+    text: string;
+    /** render: the latest part time it was printed at, when later than `t`. */
+    until?: number;
+    /** How many calls printed it. */
+    count: number;
+}
+/** What one output × combo × format printed. */
+export interface ConsoleLog {
+    messages: ConsoleMessage[];
+    /** Calls not kept: their message came after `limit` others. */
+    dropped: number;
+}
+/** A message with the output × combo × format it came from. */
+export interface ConsoleEntry extends ConsoleMessage {
+    piece: string;
+    output: string;
+    combo: Combo;
+    format: string;
+}
+/** What a command's pages printed, for the CLI. */
+export interface ConsoleReport {
+    entries: ConsoleEntry[];
+    /** Calls not kept, over every output × combo × format. */
+    dropped: number;
+    /** The most messages kept per output × combo × format. */
+    limit: number;
+}
+/** The most different messages kept per output × combo × format by default. */
+export declare const CONSOLE_LIMIT = 200;
+/** The longest text kept of one call, in characters; the rest is cut with a note. */
+export declare const CONSOLE_TEXT_MAX = 4000;
+/**
+ * Collects messages: the same text at the same place counts once (with the
+ * earliest and latest part time it was printed at), at most `limit`
+ * different ones. Pure: the stage and the host both use it.
+ */
+export declare class ConsoleCollector {
+    readonly limit: number;
+    private readonly kept;
+    private droppedCalls;
+    constructor(limit?: number);
+    /** Adds one call (or `count` calls, from another collector). */
+    add(m: ConsoleWhere & {
+        level: ConsoleLevel;
+        text: string;
+        count?: number;
+        until?: number;
+    }): void;
+    /** Adds what another collector kept and dropped. */
+    merge(log: ConsoleLog): void;
+    /**
+     * What was kept, in order: phase (module, build, mount, render, cover,
+     * other), then part in `parts` order, then part time, then first printed.
+     */
+    log(parts?: readonly string[]): ConsoleLog;
+}
+/** A value as console.log would show it, on one line where it can be. */
+export declare function consoleValue(v: unknown): string;
+/**
+ * The text of one console call: format specifiers in a first string
+ * (%s %d %i %f %o %O %j %c %%) take the next arguments, as the browser's
+ * console does, and the rest follow separated by spaces. Cut at
+ * CONSOLE_TEXT_MAX characters, saying how many more there were.
+ */
+export declare function consoleText(args: readonly unknown[]): string;
+//# sourceMappingURL=console.d.ts.map

package/node_modules/@allyhub-next/video-core/dist/console.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const CONSOLE_LEVELS=["log","info","warn","error","debug"];const f={module:0,build:1,mount:2,render:3,cover:4,other:5};export const CONSOLE_LIMIT=200,CONSOLE_TEXT_MAX=4e3;const p=t=>[t.level,t.phase,t.part??"",t.layer??"",t.index??"",t.text].join("\0");export class ConsoleCollector{limit;kept=new Map;droppedCalls=0;constructor(e=CONSOLE_LIMIT){this.limit=Math.max(0,e)}add(e){const r=e.count??1,i=p(e),n=this.kept.get(i);if(n){n.count+=r;const o=[n.t,e.t].filter(s=>s!==void 0),u=[n.until??n.t,e.until??e.t].filter(s=>s!==void 0);if(o.length>0){const s=Math.min(...o),a=Math.max(...u);n.t=s,a>s&&(n.until=a)}return}if(this.kept.size>=this.limit){this.droppedCalls+=r;return}this.kept.set(i,{level:e.level,text:e.text,phase:e.phase,...e.part===void 0?{}:{part:e.part},...e.layer===void 0?{}:{layer:e.layer},...e.index===void 0?{}:{index:e.index},...e.t===void 0?{}:{t:e.t},...e.until!==void 0&&e.t!==void 0&&e.until>e.t?{until:e.until}:{},count:r})}merge(e){for(const r of e.messages)this.add(r);this.droppedCalls+=e.dropped}log(e=[]){const r=new Map(e.map((n,o)=>[n,o]));return{messages:[...this.kept.values()].map((n,o)=>({m:n,i:o})).sort((n,o)=>f[n.m.phase]-f[o.m.phase]||(r.get(n.m.part??"")??-1)-(r.get(o.m.part??"")??-1)||(n.m.t??-1)-(o.m.t??-1)||n.i-o.i).map(({m:n})=>({...n})),dropped:this.droppedCalls}}}function c(t){const e=globalThis.Node;if(!e||!(t instanceof e))return;const r=t;if(r.nodeType===1){const i=[...r.classList??[]].map(n=>`.${n}`).join("");return`<${r.nodeName.toLowerCase()}${i}${r.id?`#${r.id}`:""}>`}return JSON.stringify(r.textContent??"")}function l(t){if(typeof t=="bigint")return`${String(t)}n`;if(typeof t=="function")return`[Function${t.name?` ${t.name}`:""}]`;if(typeof t=="number"&&!Number.isFinite(t))return String(t);if(typeof t!="object"||t===null)return t;if(t instanceof Error)return`${t.name}: ${t.message}`;const e=c(t);return e!==void 0?e:t instanceof Map?{Map:[...t]}:t instanceof Set?{Set:[...t]}:ArrayBuffer.isView(t)&&!(t instanceof DataView)?Array.from(t):t}function d(t){const e=[];try{return JSON.stringify(t,function(r,i){for(;e.length>0&&e[e.length-1]!==this;)e.pop();if(typeof i!="object"||i===null)return l(i);if(e.includes(i))return"[Circular]";e.push(i);const n=l(i);return n!==i&&typeof n=="object"&&n!==null&&e.push(n),n})}catch{return Object.prototype.toString.call(t)}}export function consoleValue(t){switch(typeof t){case"string":return t;case"number":case"boolean":case"undefined":return String(t);case"bigint":return`${String(t)}n`;case"symbol":return t.toString();case"function":return`[Function${t.name?` ${t.name}`:""}]`;case"object":{if(t===null)return"null";if(t instanceof Error)return`${t.name}: ${t.message}`;const e=c(t);return e!==void 0?e:d(t)}}}export function consoleText(t){const e=[...t],r=[],i=e[0];typeof i=="string"&&i.includes("%")&&(e.shift(),r.push(i.replace(/%([sdifoOjc%])/g,(o,u)=>{if(u==="%")return"%";if(e.length===0)return o;const s=e.shift();if(u==="c")return"";if(u==="d"||u==="i"||u==="f"){const a=typeof s=="symbol"?NaN:Number(s);return String(u==="f"?a:Math.trunc(a))}return consoleValue(s)}))),r.push(...e.map(consoleValue));const n=r.join(" ");return n.length<=CONSOLE_TEXT_MAX?n:`${n.slice(0,CONSOLE_TEXT_MAX)}… (${String(n.length-CONSOLE_TEXT_MAX)} more characters)`}

package/node_modules/@allyhub-next/video-core/dist/contrast.d.ts

@@ -0,0 +1,98 @@
+import type { MeasuredText } from "./measure.js";
+import type { Box } from "./problem.js";
+/**
+ * A style sheet that hides every text's fill and nothing else: borders and
+ * icons drawn in `currentColor`, shadows and strokes round letters, and
+ * colour emoji stay. What a capture then has at the glyphs is what is
+ * behind them.
+ */
+export declare const HIDE_TEXT_CSS: string;
+/**
+ * The same, with the strokes and shadows round letters hidden too: what a
+ * capture has at the glyphs is then the picture under a text's outline.
+ */
+export declare const HIDE_OUTLINE_CSS = "*{-webkit-text-fill-color:transparent!important;caret-color:transparent!important;transition:none!important}svg text,svg tspan,svg textPath{fill:transparent!important}*{-webkit-text-stroke-color:transparent!important;text-shadow:none!important}";
+/** A colour in sRGB, channels 0–255, alpha 0–1. */
+export type Rgba = [r: number, g: number, b: number, a: number];
+/** One line of a text block's glyphs, as the stage draws it. */
+export interface InkLine {
+    /** The line's glyph box in the frame's pixels (not rounded; the frame may cut it). */
+    box: Box;
+    /** The colour its glyphs are filled with; absent when the fill is not a colour (transparent: a background clipped to the text). */
+    fill?: Rgba;
+    /** Its text node's opacity, its ancestors' included. */
+    opacity: number;
+}
+/** A text block with what its contrast is measured from (LoadedOutput.inks). */
+export interface TextInk {
+    text: MeasuredText;
+    lines: InkLine[];
+    /** Its font size in the frame's pixels (its transforms' scale counted), and its weight. */
+    size: number;
+    weight: number;
+    /** A text-shadow or a stroke round its letters: drawn with the picture behind its fill, so it counts there. */
+    shadow?: true;
+    stroke?: true;
+}
+/** How the text-contrast fact measures. */
+export interface ContrastOptions {
+    /** The low percentile reported beside the minimum and the median (0–100). */
+    percentile: number;
+    /** The scale the picture behind the text is captured at (0–1 of the frame's pixels). */
+    scale: number;
+    /** Blocks drawn at a lower opacity (fading in or out) are left out (0: every block). */
+    opacity: number;
+}
+/**
+ * The 10th percentile beside the minimum and the median; the picture
+ * behind captured at the frame's own pixels; blocks drawn at 90 % opacity
+ * or more (whole, as text-time counts it).
+ */
+export declare const CONTRAST_DEFAULTS: Readonly<ContrastOptions>;
+/** The options with the defaults filled in, checked. */
+export declare function contrastOptions(o?: Partial<ContrastOptions>): ContrastOptions;
+/** WCAG 2.1 relative luminance of an sRGB colour (0–1). */
+export declare function luminance(r: number, g: number, b: number): number;
+/** WCAG 2.1 contrast ratio of two luminances: 1 (none) to 21 (black on white). */
+export declare function contrastRatio(la: number, lb: number): number;
+/** A colour drawn at `alpha` over an opaque one. */
+export declare function over(fg: readonly [number, number, number], alpha: number, bg: readonly [number, number, number]): [number, number, number];
+/** #rrggbb, with the alpha as two more digits when under 1. */
+export declare function hexOf(c: readonly number[]): string;
+/** A picture's pixels, RGBA, row by row. */
+export interface Pixels {
+    width: number;
+    height: number;
+    data: Uint8Array;
+}
+/** Where a picture lies in the frame: its pixel (0, 0) is at frame (x, y), and each of its pixels spans `scale` frame pixels (2: captured at half size). */
+export interface PixelsAt {
+    x: number;
+    y: number;
+    scale: number;
+}
+/** The ratios over the pixels behind a block's glyphs. */
+export interface ContrastStats {
+    min: number;
+    low: number;
+    median: number;
+    /** Pixels measured. */
+    pixels: number;
+    /** The picture behind, #rrggbb: the median of each channel, and the pixel at the minimum. */
+    background: {
+        median: string;
+        atMin: string;
+    };
+}
+/**
+ * The contrast between each line's fill and every pixel of `behind` inside
+ * that line's glyph box (the box in frame pixels; `at` places the picture
+ * in the frame): the fill drawn at its alpha × opacity over the pixel,
+ * against the pixel. The minimum, the `percentile`th lowest and the
+ * median, and the colours behind. Undefined when no line has a colour or
+ * no pixel of the picture is inside a line's box.
+ */
+export declare function contrastOver(lines: readonly InkLine[], behind: Pixels, at: PixelsAt, percentile: number): ContrastStats | undefined;
+/** The box round a block's lines, whole frame pixels, inside the frame; undefined when none of it is inside. */
+export declare function linesRegion(lines: readonly InkLine[], width: number, height: number): Box | undefined;
+//# sourceMappingURL=contrast.d.ts.map

package/node_modules/@allyhub-next/video-core/dist/contrast.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const HIDE_TEXT_CSS="*{-webkit-text-fill-color:transparent!important;caret-color:transparent!important;transition:none!important}svg text,svg tspan,svg textPath{fill:transparent!important}",HIDE_OUTLINE_CSS=`${HIDE_TEXT_CSS}*{-webkit-text-stroke-color:transparent!important;text-shadow:none!important}`,CONTRAST_DEFAULTS={percentile:10,scale:1,opacity:.9};export function contrastOptions(o={}){const t=(n,r,a)=>{const e=o[n];return e!==void 0&&Number.isFinite(e)&&e>=r&&e<=a?e:CONTRAST_DEFAULTS[n]};return{percentile:t("percentile",0,100),scale:t("scale",.05,1),opacity:t("opacity",0,1)}}const S=o=>{const t=o/255;return t<=.04045?t/12.92:((t+.055)/1.055)**2.4};export function luminance(o,t,n){return .2126*S(o)+.7152*S(t)+.0722*S(n)}export function contrastRatio(o,t){const n=Math.max(o,t),r=Math.min(o,t);return(n+.05)/(r+.05)}export function over(o,t,n){const r=Math.min(1,Math.max(0,t));return[o[0]*r+n[0]*(1-r),o[1]*r+n[1]*(1-r),o[2]*r+n[2]*(1-r)]}const u=o=>Math.round(Math.min(255,Math.max(0,o))).toString(16).padStart(2,"0");export function hexOf(o){const[t=0,n=0,r=0,a=1]=o;return`#${u(t)}${u(n)}${u(r)}${a<1?u(a*255):""}`}const b=o=>Math.round(o*100)/100;export function contrastOver(o,t,n,r){const a=[],e=[],p=[],x=[];let f=1/0,m=[0,0,0];for(const h of o){const s=h.fill;if(!s)continue;const E=s[3]*h.opacity,[v,T,O,_]=h.box,$=Math.max(0,Math.ceil((v-n.x)/n.scale-.5)),k=Math.max(0,Math.ceil((T-n.y)/n.scale-.5)),A=Math.min(t.width-1,Math.floor((v+O-n.x)/n.scale-.5)),F=Math.min(t.height-1,Math.floor((T+_-n.y)/n.scale-.5));for(let y=k;y<=F;y++)for(let d=$;d<=A;d++){const g=(y*t.width+d)*4,c=[t.data[g]??0,t.data[g+1]??0,t.data[g+2]??0],w=over([s[0],s[1],s[2]],E,c),I=contrastRatio(luminance(w[0],w[1],w[2]),luminance(c[0],c[1],c[2]));a.push(I),e.push(c[0]),p.push(c[1]),x.push(c[2]),I<f&&(f=I,m=c)}}if(a.length===0)return;const l=Float64Array.from(a).sort(),i=h=>l[Math.min(l.length-1,Math.floor(h/100*l.length))]??0,M=h=>{const s=Float64Array.from(h).sort();return s[Math.floor(s.length/2)]??0};return{min:b(l[0]??0),low:b(i(r)),median:b(i(50)),pixels:a.length,background:{median:hexOf([M(e),M(p),M(x)]),atMin:hexOf(m)}}}export function linesRegion(o,t,n){let r=1/0,a=1/0,e=-1/0,p=-1/0;for(const{box:i}of o)r=Math.min(r,i[0]),a=Math.min(a,i[1]),e=Math.max(e,i[0]+i[2]),p=Math.max(p,i[1]+i[3]);const x=Math.max(0,Math.floor(r)),f=Math.max(0,Math.floor(a)),m=Math.min(t,Math.ceil(e)),l=Math.min(n,Math.ceil(p));return m>x&&l>f?[x,f,m-x,l-f]:void 0}