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

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

@@ -0,0 +1,214 @@
+import type { Pixels } from "./contrast.js";
+import type { Track } from "./measure.js";
+import type { Box } from "./problem.js";
+/** How cut-seam measures. */
+export interface SeamOptions {
+    /** Frames looked at on each side of a join (2 or more): velocities are over them. */
+    frames: number;
+    /** A thing whose centre moves slower than this many pixels a second, and whose size changes slower, is at rest: it has no direction. */
+    rest: number;
+    /** Things listed on each side, moving ones first, largest first (0: every thing, at rest too). */
+    top: number;
+}
+/** Three frames each side; at rest under 15 px a second; three things a side. */
+export declare const SEAM_DEFAULTS: Readonly<SeamOptions>;
+export declare function seamOptions(o?: Partial<SeamOptions>): SeamOptions;
+/** One thing's motion on one side of a join. */
+export interface SeamMotion {
+    layer: string;
+    /** `text "…"`, `box`, or a picture's tag. */
+    what: string;
+    selector: string;
+    /** Its `data-ak` name, when it has one. */
+    name?: string;
+    /** Its box at the side's frame nearest the join that shows it. */
+    box: Box;
+    /** Its box's share of the frame (0–1). */
+    area: number;
+    /** Pixels a second its centre moves: rightward, downward, and in all. */
+    vx: number;
+    vy: number;
+    speed: number;
+    /** Degrees: 0 rightward, 90 downward, ±180 leftward, −90 upward; absent at rest. */
+    angle?: number;
+    /** Its size (√(w × h)) changes by this share of itself a second (0.5: half again a second; negative: shrinking). */
+    scale: number;
+    /** Its opacity changes by this much a second. */
+    fade: number;
+    /** It moves (or grows) at `rest` pixels a second or faster. */
+    moving: boolean;
+}
+/** A velocity, with its direction when it is not at rest. */
+export interface Velocity {
+    vx: number;
+    vy: number;
+    speed: number;
+    angle?: number;
+}
+/** The picture's own shift from frame to frame on one side (block matching on a small copy). */
+export interface PictureMotion extends Velocity {
+    /** The mean difference left after the shift, and with none, levels of 255: a shift that explains the change leaves far less. */
+    match: number;
+    still: number;
+}
+/** What moves on one side of a join. */
+export interface SeamSide {
+    part: string;
+    /** Film seconds of the first and last frames looked at. */
+    from: number;
+    to: number;
+    /** Things that show at any of its frames, and how many of them move. */
+    things: number;
+    moving: number;
+    /** The things listed (`options.top`), moving ones first, largest first. */
+    list: SeamMotion[];
+    /** The moving things' velocity, weighted by their area. */
+    overall?: Velocity & {
+        scale: number;
+    };
+    /** The picture's shift, when measured. */
+    picture?: PictureMotion;
+}
+/** A thing named alike on both sides of a join. */
+export interface SeamCarrier {
+    /** Its `data-ak` name, or its text (`text "…"`). */
+    name: string;
+    /** Its box at the last frame before and the first after. */
+    before: Box;
+    after: Box;
+    /** Pixels between the two boxes' centres. */
+    distance: number;
+    /** The size after over the size before (√ area). */
+    size: number;
+    /** Its speed on each side, pixels a second. */
+    speed: [before: number, after: number];
+}
+/** How the motion changes across a join. */
+export interface SeamChange {
+    /** Degrees from the direction before to the direction after (−180 to 180); absent when a side is at rest. */
+    turn?: number;
+    /** Speeds, pixels a second, before and after. */
+    speed: [before: number, after: number];
+}
+/** Degrees of a velocity: 0 rightward, 90 downward. */
+export declare function angleOf(vx: number, vy: number): number;
+/** The turn from one direction to another, −180 to 180 degrees. */
+export declare function turnOf(from: number, to: number): number;
+/**
+ * One side's motion from the tracks of its part over its frames (film
+ * seconds, in order): each thing that shows at any of them, its velocity
+ * from its first to its last frame that shows it (none from one frame),
+ * and its box at the frame that shows it nearest the join (`near`: the
+ * last frames before, the first after). `frame` is the format's pixels.
+ */
+export declare function seamSide(tracks: readonly Track[], part: string, times: readonly number[], near: "first" | "last", frame: [width: number, height: number], options: SeamOptions): SeamSide;
+/** The change from one velocity to another. */
+export declare function changeOf(before: Velocity | undefined, after: Velocity | undefined): SeamChange;
+/**
+ * Things on both sides named alike: by their `data-ak` name, else a text
+ * by what it says, each name only when it is one thing on each side, and
+ * on the frame (`[width, height]`, when given) on both: what the frame
+ * does not show carries nothing across the cut.
+ */
+export declare function seamCarriers(before: readonly SeamMotion[], after: readonly SeamMotion[], frame?: readonly [number, number]): SeamCarrier[];
+/**
+ * The shift that best lays picture `a` over picture `b` (both one size):
+ * every whole shift up to `max` pixels each way, the mean luminance
+ * difference over where they overlap (at least half of each), refined to
+ * a fraction of a pixel by a parabola through the best and its neighbours.
+ * In `a`'s pixels: b looks like a moved by (dx, dy). `error` is the mean
+ * difference at the best shift, `still` with none (levels of 255).
+ */
+export declare function pictureShift(a: Pixels, b: Pixels, max: number): {
+    dx: number;
+    dy: number;
+    error: number;
+    still: number;
+};
+/**
+ * The picture's motion over a side's frames (small copies in order, `fps`
+ * apart, `k` frame pixels to one of theirs): the mean of the shifts between
+ * frames in a row, as pixels a second of the frame.
+ */
+export declare function pictureMotion(frames: readonly Pixels[], fps: number, k: number, max: number, rest: number): PictureMotion | undefined;
+/** How the flash fact looks for frames unlike both neighbours. */
+export interface FlashOptions {
+    /** Frames looked at either side of a join (and of a transition's window's edges). */
+    reach: number;
+    /** The width of the small copy of each frame compared, in pixels. */
+    width: number;
+    /** A pixel is foreign when a channel lies more than this many levels (of 255) outside what its neighbours span. */
+    noise: number;
+    /** A frame (or a run of frames) is reported when at least this share of its pixels (0–1) is foreign. */
+    change: number;
+    /** Runs of up to this many frames are looked for (1: single frames). */
+    frames: number;
+    /**
+     * A run beside a cut is reported only when it steps from its own shot by
+     * more than this many times the shot's usual change from frame to frame
+     * (`own`): a frame in a moving shot, its grain and its hand's sway, steps
+     * about as much as its neighbours do, and the cut beside it is no flash.
+     */
+    usual: number;
+}
+/**
+ * The frame on each side of every join; a copy 160 px wide; foreign past
+ * 24 levels; reported from 0.5 % of the pixels; single frames; beside a
+ * cut, from twice its shot's usual change.
+ */
+export declare const FLASH_DEFAULTS: Readonly<FlashOptions>;
+export declare function flashOptions(o?: Partial<FlashOptions>): FlashOptions;
+/** How a frame differs from another: the share of pixels past a noise, and the mean of a pixel's largest channel difference. */
+export interface FrameChange {
+    /** Share of pixels (0–1). */
+    share: number;
+    /** Levels of 255. */
+    mean: number;
+}
+/** How b differs from a; two pictures of different sizes differ everywhere. */
+export declare function frameChange(a: Pixels, b: Pixels, noise: number): FrameChange;
+/**
+ * How far a frame lies outside what the frames either side of it span:
+ * per pixel, the most a channel is below both neighbours' or above both;
+ * the share of pixels where that is more than `noise`, and its mean.
+ */
+export declare function foreignPixels(prev: Pixels, cur: Pixels, next: Pixels, noise: number): FrameChange;
+/** A run of frames unlike the frames either side of it. */
+export interface FlashRun {
+    /** Its first and last frame. */
+    from: number;
+    to: number;
+    /** The least foreign of its frames: share and mean. */
+    foreign: FrameChange;
+    /** Its first frame against the frame before, its last against the frame after, and those two against each other. */
+    before: FrameChange;
+    after: FrameChange;
+    across: FrameChange;
+    /**
+     * When the run touches a cut (one of its neighbours is the other shot),
+     * the run against its own shot alone: `step`, its frame nearest its own
+     * side against the next frame of its own shot; `usual`, that frame
+     * against the one beyond it, the shot's own change from frame to frame.
+     * A blank or stray frame steps far past its shot's usual change; a frame
+     * in a fast move steps about as much as its neighbours do.
+     */
+    own?: {
+        side: "before" | "after";
+        step: FrameChange;
+        usual: FrameChange;
+    };
+}
+/**
+ * Runs of 1 to `options.frames` frames starting at each of `starts`, each
+ * against the frame before it and the frame after it: `picture(f)` is
+ * frame f's small copy, `same(a, b)` says two frames draw the same (their
+ * stage signatures match), which makes a run's frame no flash without a
+ * capture. A run is kept when every frame of it has `change` or more of
+ * its pixels foreign, beside a cut steps from its own shot by more than
+ * `usual` times the shot's usual change, and no shorter run from its first
+ * frame was (with `all`, every run looked at). `last` is the last frame there is. `cuts`
+ * are the first frames of the shots that start at a cut: a run beside one
+ * is also measured against its own shot (`own`).
+ */
+export declare function flashRuns(starts: readonly number[], last: number, picture: (f: number) => Promise<Pixels>, same: (a: number, b: number) => Promise<boolean>, options: FlashOptions, all?: boolean, cuts?: readonly number[]): Promise<FlashRun[]>;
+//# sourceMappingURL=seams.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const SEAM_DEFAULTS={frames:3,rest:15,top:3};export function seamOptions(t={}){const n=(a,d,r)=>a!==void 0&&Number.isFinite(a)&&a>=d?Math.round(a):r;return{frames:n(t.frames,2,SEAM_DEFAULTS.frames),rest:t.rest!==void 0&&Number.isFinite(t.rest)&&t.rest>=0?t.rest:SEAM_DEFAULTS.rest,top:n(t.top,0,SEAM_DEFAULTS.top)}}const A=t=>Math.round(t*10)/10,y=t=>Math.round(t*1e3)/1e3,$=t=>[t[0]+t[2]/2,t[1]+t[3]/2],I=t=>Math.sqrt(Math.max(0,t[2])*Math.max(0,t[3]));export function angleOf(t,n){return A(Math.atan2(n,t)*180/Math.PI)}export function turnOf(t,n){let a=(n-t)%360;return a>180&&(a-=360),a<=-180&&(a+=360),A(a)}const L=(t,n,a)=>{const d=Math.hypot(t,n);return{vx:A(t),vy:A(n),speed:A(d),...d>=a&&d>0?{angle:angleOf(t,n)}:{}}};export function seamSide(t,n,a,d,r,i){const w=new Map(a.map(s=>[y(s),s])),x=[];for(const s of t){if(s.part!==n)continue;const h=s.samples.filter(O=>w.has(y(O.t))&&O.box!==void 0&&O.opacity>.05),F=d==="last"?h.at(-1):h[0];if(!F?.box)continue;const f=h[0],g=h.at(-1);let m=0,M=0,p=0,v=0,b=0;const S=f?w.get(y(f.t))??f.t:0,N=g?w.get(y(g.t))??g.t:0;if(f?.box&&g?.box&&N>S){const O=N-S,[C,D]=$(f.box),[P,T]=$(g.box);m=(P-C)/O,M=(T-D)/O;const E=I(f.box);b=(I(g.box)-E)/O,p=E>0?b/E:0,v=(g.opacity-f.opacity)/O}const z=L(m,M,i.rest),k=F.box;x.push({layer:s.layer,what:s.what,selector:s.selector,...s.name===void 0?{}:{name:s.name},box:k,area:y(k[2]*k[3]/Math.max(1,r[0]*r[1])),...z,scale:y(p),fade:y(v),moving:Math.hypot(m,M)>=i.rest||Math.abs(b)>=i.rest})}const c=s=>Math.max(0,s.box[2]*s.box[3]),e=x.filter(s=>s.moving),l=[...e.sort((s,h)=>c(h)-c(s)),...x.filter(s=>!s.moving).sort((s,h)=>c(h)-c(s))],o=e.reduce((s,h)=>s+c(h),0),u=o>0?{...L(e.reduce((s,h)=>s+h.vx*c(h),0)/o,e.reduce((s,h)=>s+h.vy*c(h),0)/o,i.rest),scale:y(e.reduce((s,h)=>s+h.scale*c(h),0)/o)}:void 0;return{part:n,from:y(a[0]??0),to:y(a.at(-1)??0),things:x.length,moving:e.length,list:i.top===0?l:l.filter(s=>s.moving).slice(0,i.top),...u?{overall:u}:{}}}export function changeOf(t,n){return{...t?.angle!==void 0&&n?.angle!==void 0?{turn:turnOf(t.angle,n.angle)}:{},speed:[t?.speed??0,n?.speed??0]}}export function seamCarriers(t,n,a){const d=e=>!a||(e[0]??0)<a[0]&&(e[0]??0)+(e[2]??0)>0&&(e[1]??0)<a[1]&&(e[1]??0)+(e[3]??0)>0,r=e=>e.name??(e.what.startsWith("text ")?e.what:void 0),i=e=>{const l=new Map;for(const o of e){const u=r(o);u!==void 0&&l.set(u,l.has(u)?null:o)}return l},w=i(t),x=i(n),c=[];for(const[e,l]of w){const o=x.get(e);if(!l||!o||!d(l.box)||!d(o.box))continue;const[u,s]=$(l.box),[h,F]=$(o.box),f=I(l.box);c.push({name:e,before:l.box,after:o.box,distance:A(Math.hypot(h-u,F-s)),size:y(f>0?I(o.box)/f:0),speed:[l.speed,o.speed]})}return c}const q=t=>{const n=new Float32Array(t.width*t.height);for(let a=0;a<n.length;a++)n[a]=.2126*(t.data[a*4]??0)+.7152*(t.data[a*4+1]??0)+.0722*(t.data[a*4+2]??0);return n};export function pictureShift(t,n,a){const d=Math.min(t.width,n.width),r=Math.min(t.height,n.height),i=q(t),w=q(n),x=(f,g)=>{let m=0,M=0;for(let p=Math.max(0,g);p<Math.min(r,r+g);p++){const v=p-g;for(let b=Math.max(0,f);b<Math.min(d,d+f);b++)m+=Math.abs((w[p*n.width+b]??0)-(i[v*t.width+(b-f)]??0)),M++}return M>=d*r/2?m/M:1/0},c=x(0,0);let e={dx:0,dy:0,c};const l=new Map,o=Math.max(0,Math.round(a));for(let f=-o;f<=o;f++)for(let g=-o;g<=o;g++){const m=x(g,f);l.set(`${String(g)},${String(f)}`,m),(m<e.c-1e-9||Math.abs(m-e.c)<=1e-9&&Math.hypot(g,f)<Math.hypot(e.dx,e.dy))&&(e={dx:g,dy:f,c:m})}const u=(f,g)=>l.get(`${String(f)},${String(g)}`)??1/0,s=(f,g,m)=>{if(!Number.isFinite(f)||!Number.isFinite(m))return 0;const M=f-2*g+m;return M>1e-9?Math.max(-.5,Math.min(.5,(f-m)/(2*M))):0},h=s(u(e.dx-1,e.dy),e.c,u(e.dx+1,e.dy)),F=s(u(e.dx,e.dy-1),e.c,u(e.dx,e.dy+1));return{dx:e.c<c-1e-9?e.dx+h:0,dy:e.c<c-1e-9?e.dy+F:0,error:y(e.c),still:y(c)}}export function pictureMotion(t,n,a,d,r){if(t.length<2)return;let i=0,w=0,x=0,c=0,e=0;for(let l=1;l<t.length;l++){const o=t[l-1],u=t[l];if(!o||!u)continue;const s=pictureShift(o,u,d);i+=s.dx,w+=s.dy,x+=s.error,c+=s.still,e++}if(e!==0)return{...L(i/e*a*n,w/e*a*n,r),match:y(x/e),still:y(c/e)}}export const FLASH_DEFAULTS={reach:1,width:160,noise:24,change:.005,frames:1,usual:2};export function flashOptions(t={}){const n=(a,d,r)=>{const i=t[a];return i===void 0||!Number.isFinite(i)||i<d?FLASH_DEFAULTS[a]:r?Math.round(i):i};return{reach:n("reach",1,!0),width:n("width",8,!0),noise:n("noise",0,!1),change:n("change",0,!1),frames:n("frames",1,!0),usual:n("usual",0,!1)}}export function frameChange(t,n,a){if(t.width!==n.width||t.height!==n.height)return{share:1,mean:255};const d=t.width*t.height;if(d===0)return{share:0,mean:0};let r=0,i=0;for(let w=0;w<d*4;w+=4){let x=0;for(let c=0;c<3;c++)x=Math.max(x,Math.abs((t.data[w+c]??0)-(n.data[w+c]??0)));i+=x,x>a&&r++}return{share:r/d,mean:i/d}}export function foreignPixels(t,n,a,d){if(t.width!==n.width||a.width!==n.width||t.height!==n.height||a.height!==n.height)return{share:1,mean:255};const r=n.width*n.height;if(r===0)return{share:0,mean:0};let i=0,w=0;for(let x=0;x<r*4;x+=4){let c=0;for(let e=0;e<3;e++){const l=t.data[x+e]??0,o=a.data[x+e]??0,u=n.data[x+e]??0;c=Math.max(c,Math.min(l,o)-u,u-Math.max(l,o))}w+=c,c>d&&i++}return{share:i/r,mean:w/r}}export async function flashRuns(t,n,a,d,r,i=!1,w=[]){const x=new Set(w),c=async(o,u)=>{if(x.has(u+1)&&o-2>=0){const s=await a(o-1);return{side:"before",step:frameChange(s,await a(o),r.noise),usual:frameChange(await a(o-2),s,r.noise)}}if(x.has(o)&&u+2<=n){const s=await a(u+1);return{side:"after",step:frameChange(await a(u),s,r.noise),usual:frameChange(s,await a(u+2),r.noise)}}},e=[],l=new Set;for(const o of t){let u=!1;for(let s=1;s<=r.frames&&!(u&&!i);s++){const h=o+s-1,F=o-1,f=h+1;if(F<0||f>n)continue;const g=`${String(o)}-${String(h)}`;if(l.has(g))continue;l.add(g);let m=!1;for(let S=o;S<=h&&!m;S++)m=await d(S,F)||await d(S,f);if(m&&!i)continue;const M=await a(F),p=await a(f);let v={share:1/0,mean:1/0};for(let S=o;S<=h;S++){const N=m?{share:0,mean:0}:foreignPixels(M,await a(S),p,r.noise);N.share<v.share&&(v=N)}if(!i&&v.share<r.change-1e-12)continue;const b=await c(o,h);!i&&b&&b.step.share<=r.usual*b.usual.share+1e-12||(u=!0,e.push({from:o,to:h,foreign:v,before:frameChange(M,await a(o),r.noise),after:frameChange(await a(h),p,r.noise),across:frameChange(M,p,r.noise),...b?{own:b}:{}}))}}return e}

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

@@ -0,0 +1,37 @@
+import { z } from "zod";
+import { PIECE_BRAND, type OutputDefinition, type PartSpec, type PieceCommon, type PieceContext } from "./piece.js";
+/** A deck's (paged piece's) options. */
+export interface PagedOptions {
+    /** Speaker notes: each page's `<prefix>.<page>.notes` (slides). */
+    notes?: boolean;
+    /** The look's name; default "clean". */
+    look?: string;
+    /** Prefix of the speaker notes' keys; default: the piece's id with `/` as `.`. */
+    prefix?: string;
+    /** How long loading it may take, seconds; default LOAD_LIMIT, 10 (AK-P002). */
+    loadLimit?: number;
+    /** How long one page may take to draw, seconds; default SEEK_LIMIT, 30 (AK-P003). */
+    seekLimit?: number;
+}
+export type PagedBuild = (ctx: PieceContext) => PartSpec[] | Promise<PartSpec[]>;
+/** Slides (any pages): the default export of an item's slides.ts, made by slides(). */
+export interface PagedPiece extends PieceCommon, PagedOptions {
+    [PIECE_BRAND]: true;
+    kind: "paged";
+    /** Its pages, in order. A method, as VideoPiece's parts is. */
+    pages(ctx: PieceContext): PartSpec[] | Promise<PartSpec[]>;
+}
+export interface PagedOutput extends OutputDefinition<"paged"> {
+    build: PagedBuild;
+    options: PagedOptions;
+}
+/** A deck's options as metadata (its format is the piece's). */
+export declare const PagedOptionsMeta: z.ZodObject<{
+    notes: z.ZodOptional<z.ZodBoolean>;
+    look: z.ZodOptional<z.ZodString>;
+    prefix: z.ZodOptional<z.ZodString>;
+    loadLimit: z.ZodOptional<z.ZodNumber>;
+    seekLimit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export type PagedOptionsMeta = z.infer<typeof PagedOptionsMeta>;
+//# sourceMappingURL=slides.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{z as o}from"zod";import{MESSAGE_KEY as i}from"./messages.js";import"./piece.js";export const PagedOptionsMeta=o.strictObject({notes:o.boolean().optional(),look:o.string().min(1).optional(),prefix:o.string().regex(i).optional(),loadLimit:o.number().positive().optional(),seekLimit:o.number().positive().optional()});

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

@@ -0,0 +1,72 @@
+import type { Word } from "./media.js";
+import { type VoiceFrames } from "./voice.js";
+/** What the sound summary counts by. */
+export interface SoundParams {
+    /** A stretch with no word counts from this long, seconds. */
+    gap: number;
+    /** Seconds kept clear either side of a word: its breath and its tail are not the stretch's. */
+    edge: number;
+    /** A frame is voiced from this periodicity, 0–100. */
+    voiced: number;
+}
+export declare const SOUND_DEFAULTS: Readonly<SoundParams>;
+/** The 10th, 50th and 90th percentile of levels (dBFS), and how long they last. */
+export interface LevelStats {
+    seconds: number;
+    p10: number;
+    median: number;
+    p90: number;
+}
+/** A sound under and between its words. */
+export interface SoundSummary extends SoundParams {
+    /** Every frame. */
+    whole: LevelStats;
+    /** The mean of the quietest tenth of the frames, dBFS. */
+    floor: number;
+    /** The frames during a word; absent without words. */
+    words?: LevelStats;
+    /** The frames clear of every word, in stretches of at least `gap`; absent where there are none. */
+    between?: LevelStats & {
+        /** The share of those frames that are voiced. */
+        voicedShare: number;
+        /** Onsets a minute there. */
+        onsetsPerMinute: number;
+    };
+}
+/**
+ * The sound under and between the words: frames during a word, frames in
+ * a stretch of at least `gap` seconds with no word within `edge` of it,
+ * and the whole; `onsets` are the onsets' times, counted between the
+ * words. Without words (`words` undefined: not heard) only the whole and
+ * the floor.
+ */
+export declare function soundUnder(frames: VoiceFrames, words: readonly Word[] | undefined, onsets: readonly number[], params?: Partial<SoundParams>): SoundSummary;
+/** A sound's pace: tempo, onsets and words a minute. */
+export interface SoundPace {
+    /** The onsets' tempo, beats per minute, with how steady its beat is (0–1); null where none was found. */
+    tempo: {
+        bpm: number;
+        confidence: number;
+    } | null;
+    onsetsPerMinute: number;
+    /** Words a minute over the whole sound. */
+    wordsPerMinute: number;
+    /** Words a minute from the first word to the last. */
+    speakingRate: number;
+    /** The share of the sound words are said in. */
+    speechShare: number;
+    /** Seconds to the first word; null without words. */
+    timeToFirstWord: number | null;
+}
+/** The pace of a sound `duration` seconds long with this many onsets, this tempo and these words. */
+export declare function paceOf(duration: number, onsets: number, tempo: {
+    bpm: number;
+    confidence: number;
+} | undefined, words: readonly Word[]): SoundPace;
+/**
+ * Words in time order, a word said again within `gap` seconds of itself
+ * joined into one: where two parts both carry the same word (a J or L
+ * cut's overlap), it is one word heard.
+ */
+export declare function joinedWords(words: readonly Word[], gap: number): Word[];
+//# sourceMappingURL=sound-under.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{frameDb as k}from"./voice.js";export const SOUND_DEFAULTS={gap:.2,edge:.05,voiced:50};const d=n=>Math.round(n*10)/10,b=n=>Math.round(n*1e3)/1e3;function m(n,h){const s=[...n].sort((e,i)=>e-i),o=e=>s[Math.min(s.length-1,Math.floor(e*s.length))]??-120;return{seconds:b(s.length*h),p10:d(o(.1)),median:d(o(.5)),p90:d(o(.9))}}export function soundUnder(n,h,s,o={}){const e={...SOUND_DEFAULTS,...o},i=n.db.length,p=[];for(let t=0;t<i;t++)p.push(k(n,t));const f=[...p].sort((t,c)=>t-c),u=f.slice(0,Math.max(1,Math.floor(f.length/10))),M=u.length?d(u.reduce((t,c)=>t+c,0)/u.length):-120,U={gap:e.gap,edge:e.edge,voiced:e.voiced,whole:m(p,n.hop),floor:M};if(!h)return U;const w=t=>t*n.hop,a=new Uint8Array(i),x=t=>Math.ceil(t/n.hop-1e-6);for(const t of h){const c=Math.max(0,x(t.start-e.edge)),r=Math.min(i-1,x(t.end+e.edge)-1);for(let l=c;l<=r;l++)l>=x(t.start)&&l<x(t.end)?a[l]=1:a[l]===0&&(a[l]=2)}const v=[],g=[];let D=0;const P=[];for(let t=0;t<i;){if(a[t]===1&&v.push(k(n,t)),a[t]!==0){t++;continue}let c=t;for(;c<i&&a[c]===0;)c++;if((c-t)*n.hop>=e.gap){P.push([w(t),w(c)]);for(let r=t;r<c;r++)g.push(k(n,r)),(n.voicing[r]??0)>=e.voiced&&D++}t=c}const F=s.filter(t=>P.some(([c,r])=>t>=c&&t<r)).length,A=g.length*n.hop/60;return{...U,...v.length>0?{words:m(v,n.hop)}:{},...g.length>0?{between:{...m(g,n.hop),voicedShare:b(D/g.length),onsetsPerMinute:A>0?d(F/A):0}}:{}}}const S=(n,h)=>h>0?d(n*60/h):0;export function paceOf(n,h,s,o){const e=o[0],i=o.at(-1),p=e&&i?i.end-e.start:0,f=o.reduce((u,M)=>u+Math.max(0,M.end-M.start),0);return{tempo:s?{bpm:s.bpm,confidence:s.confidence}:null,onsetsPerMinute:S(h,n),wordsPerMinute:S(o.length,n),speakingRate:S(o.length,p),speechShare:n>0?Math.min(1,b(f/n)):0,timeToFirstWord:e?b(e.start):null}}export function joinedWords(n,h){const s=[];for(const o of[...n].sort((e,i)=>e.start-i.start)){const e=s.at(-1);if(e?.text===o.text&&o.start-e.end<=h&&o.start>=e.start){s[s.length-1]={...e,end:Math.max(e.end,o.end)};continue}s.push({...o})}return s}

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

@@ -0,0 +1,83 @@
+import type { MediaInfo, Word } from "./media.js";
+/** Where `allyhub voice` puts the files of `say`, from the project root. */
+export declare const SAY_DIR = "assets/media/gen/say";
+/** The voice tool `say` uses when it names none. */
+export declare const DEFAULT_VOICE_TOOL = "tts-elevenlabs-multilingual-v2";
+/**
+ * FNV-1a, 64 bits, over the UTF-8 bytes: the same 16 hex digits in Node and
+ * the browser, synchronously.
+ */
+export declare function hash64(text: string): string;
+/**
+ * Where a value stops being plain JSON data (null, booleans, finite
+ * numbers, strings, and arrays and plain objects of them): its path, such
+ * as `params.style[2]`; undefined when it is plain JSON throughout.
+ */
+export declare function notJson(v: unknown, path?: string): string | undefined;
+/** Plain JSON data as text with every object's keys sorted: equal data, equal text. */
+export declare function canonicalJson(v: unknown): string;
+/**
+ * A `say`'s file without its extension: `assets/media/gen/say/<hash>`, the hash
+ * over the text as read aloud, the voice, the tool and the tool's extra
+ * parameters (when there are any). Changing any of them names another
+ * file, so an old one is never read for new text.
+ */
+export declare function sayStem(say: {
+    text: string;
+    voice?: string | undefined;
+    tool?: string | undefined;
+    params?: Readonly<Record<string, unknown>> | undefined;
+}): string;
+/** The audio file of a stem among the project's media (any audio extension). */
+export declare function mediaByStem(media: Readonly<Record<string, MediaInfo>>, stem: string): MediaInfo | undefined;
+/**
+ * The words a part's speech plays, on the film's clock: the stretch of
+ * its take from `from`, or, for a cut take, the words inside each kept
+ * stretch at its place; at its speed (seconds of the file per second of
+ * film).
+ */
+export declare function speechWords(words: readonly Word[], sp: {
+    start: number;
+    end: number;
+    from: number;
+    speed?: number | undefined;
+    cuts?: readonly {
+        at: number;
+        from: number;
+    }[] | undefined;
+}): Word[];
+/**
+ * The words said in a stretch of a take, moved onto another clock: the
+ * words that start in the `dur` seconds of that clock from the file's
+ * `from`, played `rate` seconds of the file per second (default 1), each
+ * at `at` plus its distance from `from` over the rate.
+ */
+export declare function wordsIn(words: readonly Word[], from: number, dur: number, at: number, rate?: number): Word[];
+/** Seconds a word takes to say, and a Chinese, Japanese or Korean character. */
+export interface SpeechRate {
+    word?: number;
+    cjk?: number;
+}
+/** The rates a line's length is estimated at when nothing was measured. */
+export declare const SPEECH_RATE_DEFAULTS: Required<SpeechRate>;
+/** What a line's length is counted by: its words, and its CJK characters one by one. */
+export declare function speechUnits(text: string): {
+    words: number;
+    cjk: number;
+};
+/**
+ * About how long a line takes to say, for a part whose speech is missing:
+ * an estimate from its words at `rate`, never under a second.
+ */
+export declare function estimateSpeech(text: string, rate?: SpeechRate): number;
+/**
+ * About how long a line would take to say, before there is sound for it.
+ * With `paced`, a line already spoken and the seconds its words took, it is
+ * that voice's own pace applied to the new words; else the rates above. An
+ * estimate either way: the sound, once made, is what counts.
+ */
+export declare function speechLength(text: string, paced?: {
+    text: string;
+    seconds: number;
+}, rate?: SpeechRate): number;
+//# sourceMappingURL=speech.d.ts.map

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

@@ -0,0 +1,5 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{MEDIA_DIR as p}from"@allyhub-next/formats";export const SAY_DIR=`${p}/gen/say`,DEFAULT_VOICE_TOOL="tts-elevenlabs-multilingual-v2";export function hash64(n){let t=0xcbf29ce484222325n;const e=0x100000001b3n;for(const r of new TextEncoder().encode(n))t^=BigInt(r),t=t*e&0xffffffffffffffffn;return t.toString(16).padStart(16,"0")}export function notJson(n,t="value"){if(n===null||typeof n=="string"||typeof n=="boolean")return;if(typeof n=="number")return Number.isFinite(n)?void 0:t;if(typeof n!="object")return t;if(Array.isArray(n)){for(const[r,o]of n.entries()){const i=notJson(o,`${t}[${String(r)}]`);if(i!==void 0)return i}return}const e=Object.getPrototypeOf(n);if(e!==Object.prototype&&e!==null)return t;for(const[r,o]of Object.entries(n)){const i=notJson(o,`${t}.${r}`);if(i!==void 0)return i}}export function canonicalJson(n){if(Array.isArray(n))return`[${n.map(canonicalJson).join(",")}]`;if(typeof n=="object"&&n!==null){const t=n;return`{${Object.keys(t).sort().map(e=>`${JSON.stringify(e)}:${canonicalJson(t[e])}`).join(",")}}`}return JSON.stringify(n)}export function sayStem(n){const t=n.tool??DEFAULT_VOICE_TOOL,e=n.params&&Object.keys(n.params).length>0?`
+${canonicalJson(n.params)}`:"";return`${SAY_DIR}/${hash64(`${t}
+${n.voice??""}
+${n.text}${e}`)}`}export function mediaByStem(n,t){for(const[e,r]of Object.entries(n))if(r.kind==="audio"&&e.startsWith(`${t}.`)){const o=e.slice(t.length+1);if(!o.includes("/")&&!o.includes("."))return r}}export function speechWords(n,t){const e=t.speed??1,r=t.cuts;return!r||r.length===0?wordsIn(n,t.from,t.end-t.start,t.start,e):r.flatMap((o,i)=>{const c=r[i+1]?.at??t.end;return wordsIn(n,o.from,c-o.at,o.at,e)})}export function wordsIn(n,t,e,r,o=1){const i=s=>Math.round(s*1e3)/1e3,c=t+e*o,d=r-t,u=s=>i(o===1?s+d:r+(s-t)/o);return n.filter(s=>s.start>=t-1e-6&&s.start<c-1e-6).map(s=>({text:s.text,start:u(s.start),end:u(Math.min(s.end,c))}))}const a=/[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}\p{Script=Hangul}]/gu;export const SPEECH_RATE_DEFAULTS={word:.38,cjk:.22};export function speechUnits(n){const t=n.match(a)?.length??0;return{words:n.replace(a," ").split(/\s+/u).filter(r=>/[\p{L}\p{N}]/u.test(r)).length,cjk:t}}const f=(n,t)=>{const{words:e,cjk:r}=speechUnits(n);return e*(t.word??SPEECH_RATE_DEFAULTS.word)+r*(t.cjk??SPEECH_RATE_DEFAULTS.cjk)};export function estimateSpeech(n,t={}){return Math.max(1,Math.round(f(n,t)*10)/10)}export function speechLength(n,t,e={}){const r=f(n,e),o=t===void 0?0:f(t.text,e),i=t!==void 0&&o>0&&t.seconds>0?t.seconds*r/o:r;return Math.round(i*10)/10}