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

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

@@ -0,0 +1,226 @@
+import type { MediaGen } from "./gen.js";
+import type { Box } from "./problem.js";
+import type { Envelope, UnheardSound } from "./voice.js";
+export type MediaKind = "image" | "audio" | "video" | "font"
+/** A 3D model and its parts: glTF, GLB, a glTF's buffers, KTX2 textures. */
+ | "model"
+/** A 3D scenery's environment: HDR and EXR pictures. */
+ | "environment";
+export interface Word {
+    text: string;
+    start: number;
+    end: number;
+    /**
+     * How sure the recognizer was of the word, 0 to 1: the lowest
+     * probability it gave any of the word's letter tokens (`allyhub
+     * transcribe` with Parakeet: greedy decoding's token log probability,
+     * exponentiated). Absent when the recognizer gave none, or the file was
+     * written another way.
+     */
+    confidence?: number;
+}
+export interface MediaInfo {
+    /** Path in the project, relative to the project root. */
+    path: string;
+    sha256: string;
+    kind: MediaKind;
+    /** Where the stage loads it; valid only at run time. */
+    url: string;
+    bytes?: number;
+    width?: number;
+    height?: number;
+    /** Seconds (audio, video). */
+    duration?: number;
+    /** Video: whether it has a sound stream (ffprobe). */
+    audio?: boolean;
+    /** Audio and video: word times from the sibling `<name>.words.json` (a take). */
+    words?: Word[];
+    /** Image: element boxes from the sibling `<name>.elements.json` (a page screenshot). */
+    elements?: Record<string, Box>;
+    /** Audio: integrated loudness (LUFS), measured when mixing. */
+    loudness?: number;
+    /**
+     * How `loudness` was measured: "integrated" (BS.1770, gated), or
+     * "level", the K-weighted level over the whole file, for a sound too
+     * short for one 0.4 s block or all under the gate (a click). Absent:
+     * integrated.
+     */
+    loudnessBy?: "integrated" | "level";
+    /**
+     * Audio without words (music): its tempo, measured by the build from
+     * its onsets (`@allyhub/analysis` beats): beats per minute, how steady
+     * the beat is (0–1), and the first beat in seconds. Absent when the
+     * file has no steady tempo or could not be measured.
+     */
+    tempo?: {
+        bpm: number;
+        confidence: number;
+        beat: number;
+    };
+    /**
+     * Video: the rotation its display matrix asks for (90, 180 or 270,
+     * clockwise); `width` and `height` are already the displayed ones.
+     */
+    rotation?: number;
+    /** Video: its faces over time, and the default speaker (the media index's face track). */
+    faces?: FaceTrack;
+    /** Video: a person matte is in the media index. */
+    matte?: boolean;
+    /**
+     * A take (audio or video with words): its level every 10 ms, which cut
+     * points snap to (voice.ts), measured by the build and kept in the media
+     * index.
+     */
+    envelope?: Envelope;
+    /** A take: the median level of its words, dBFS. */
+    speechDb?: number;
+    /** A take: what is heard between its words (voice.ts), reported, never removed on its own. */
+    sounds?: UnheardSound[];
+    /**
+     * The file's provenance, from the `<file>.gen.json` beside it (gen.ts):
+     * the tool that generated it, when, from what input. Absent without a
+     * readable record.
+     */
+    gen?: MediaGen;
+    /** A `<file>.gen.json` beside it that could not be read, and why. */
+    genUnread?: {
+        record: string;
+        error: string;
+    };
+    /** A glTF or GLB (kind "model"): what it holds, measured by the build. */
+    model?: ModelInfo;
+    /**
+     * Video: where the stage loads that matte, when its host serves it (the
+     * preview draws the speaker cut out with it); valid only at run time.
+     */
+    matteUrl?: string;
+    /**
+     * Audio and video: where the stage loads the sound denoised and sped
+     * like a take's denoise() and speed(), or filtered like a stem's filter, in the render, with
+     * `?db=<reduction>`, `&speed=<times>` and `&filter=<chain>` appended (any of them), when
+     * its host makes it (the preview); valid only at run time.
+     */
+    denoisedUrl?: string;
+}
+/**
+ * A media value turned into a string is its `url`, so `img.src = logo`
+ * and `` `url(${logo})` `` draw the file. The method is not enumerable:
+ * the value's JSON, its spread copies and the digests stay as they were.
+ * Returns the value itself.
+ */
+export declare function asUrlString<T extends {
+    url: string;
+}>(value: T): T;
+/** Where the media index keeps what it learnt about a file, from the project root. */
+export declare const INDEX_DIR = ".allyhub/cache/index";
+/** A file of a media file's index entry: `.allyhub/cache/index/<sha256>/<name>`. */
+export declare function indexPath(sha256: string, name: string): string;
+export type { FaceSample, FaceTrack, TrackedFace } from "@allyhub-next/formats";
+import type { FaceTrack } from "@allyhub-next/formats";
+type FaceBox = [number, number, number, number];
+/**
+ * The box of face `id` (default: the track's speaker) at t, linear
+ * between samples; undefined outside its samples, or when the track has
+ * no such face.
+ */
+export declare function faceAt(track: FaceTrack, t: number, id?: number | undefined): FaceBox | undefined;
+/** Every face of a track at t, with its id, in id order. */
+export declare function facesAt(track: FaceTrack, t: number): {
+    id: number;
+    box: FaceBox;
+}[];
+/** Whether a track has a face with this id. */
+export declare function hasFace(track: FaceTrack, id: number): boolean;
+/** The media kind of a path, by its extension; undefined when not media. */
+export declare function mediaKindOf(path: string): MediaKind | undefined;
+/** Every media extension, without the dot. */
+export declare const MEDIA_EXTENSIONS: readonly string[];
+/**
+ * Joins a path relative to a file in the project: ("a/b/film.ts", "./vo/en.mp3")
+ * → "a/b/vo/en.mp3". Undefined when it leaves the project.
+ */
+export declare function repoPath(fromFile: string, spec: string): string | undefined;
+/**
+ * Joins a path written in a folder of the project ("" its root), as the
+ * SDK records where a spec was written: ("a/b", "./vo/en.mp3") →
+ * "a/b/vo/en.mp3". Undefined when it leaves the project.
+ */
+export declare function pathIn(folder: string, spec: string): string | undefined;
+/**
+ * A glTF or GLB as the build measures it (docs/design/3d-worlds.md §4.6),
+ * in two steps: its own description (the JSON: extensions, named nodes,
+ * the files it names), which never fails; then its contents through
+ * glTF-Transform (bounds, counts, materials, textures, animations), which
+ * says why when it cannot read them. glTF and three.js are Y up, in metres.
+ */
+export interface ModelInfo {
+    container: "glb" | "gltf";
+    /** asset.generator: what wrote it. */
+    generator?: string;
+    /** asset.copyright. */
+    copyright?: string;
+    /** It carries rights metadata (KHR_xmp_json_ld). */
+    rights?: boolean;
+    extensionsUsed: string[];
+    extensionsRequired: string[];
+    /** Required extensions no lent decoder reads: three.js cannot load it (AK-W003). */
+    unsupported: string[];
+    /** Files it names that are not there, as project paths. */
+    missing: string[];
+    /** Its named nodes, with their paths from its root: what `getObjectByName` takes. */
+    nodes: {
+        name: string;
+        path: string;
+    }[];
+    /** Its default scene's box, metres, and its largest side. */
+    bounds?: {
+        min: [number, number, number];
+        max: [number, number, number];
+        size: [number, number, number];
+        largest: number;
+    };
+    counts?: {
+        nodes: number;
+        meshes: number;
+        primitives: number;
+        triangles: number;
+        instances: number;
+    };
+    materials?: {
+        name: string;
+        extensions: string[];
+    }[];
+    textures?: {
+        name: string;
+        mimeType: string;
+        width?: number;
+        height?: number;
+        bytes: number;
+        gpuBytes?: number;
+    }[];
+    animations?: {
+        name: string;
+        duration: number;
+        channels: number;
+    }[];
+    skins: number;
+    morphTargets: number;
+    cameras: number;
+    lights: number;
+    /** glTF-Validator's counts by severity, and its first messages. */
+    validator?: {
+        errors: number;
+        warnings: number;
+        infos: number;
+        hints: number;
+        messages: {
+            code: string;
+            severity: number;
+            message: string;
+            pointer?: string;
+        }[];
+    };
+    /** Why the contents (bounds, counts, materials, textures, animations) were not measured. */
+    contentsMissing?: string;
+}
+//# sourceMappingURL=media.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{CACHE_DIR as m}from"@allyhub-next/formats";export function asUrlString(e){return Object.prototype.hasOwnProperty.call(e,"toString")||Object.defineProperty(e,"toString",{value(){return this.url},enumerable:!1,configurable:!0,writable:!0}),e}export const INDEX_DIR=`${m}/index`;export function indexPath(e,n){return`${INDEX_DIR}/${e}/${n}`}function c(e,n,t){const o=e[0],i=e.at(-1);if(!o||!i)return;const s=1/Math.max(1,n);if(t<o.t-s||t>i.t+s)return;if(t<=o.t)return o.box;if(t>=i.t)return i.box;let a=0,u=e.length-1;for(;u-a>1;){const r=a+u>>1;(e[r]?.t??0)<=t?a=r:u=r}const f=e[a]??o,d=e[u]??i,l=d.t===f.t?0:(t-f.t)/(d.t-f.t);return[0,1,2,3].map(r=>(f.box[r]??0)+((d.box[r]??0)-(f.box[r]??0))*l)}export function faceAt(e,n,t=e.speaker){if(t===void 0)return;const o=e.faces.find(i=>i.id===t);return o?c(o.samples,e.fps,n):void 0}export function facesAt(e,n){return e.faces.flatMap(t=>{const o=c(t.samples,e.fps,n);return o?[{id:t.id,box:o}]:[]})}export function hasFace(e,n){return e.faces.some(t=>t.id===n)}const p={png:"image",jpg:"image",jpeg:"image",webp:"image",gif:"image",svg:"image",avif:"image",mp3:"audio",wav:"audio",m4a:"audio",ogg:"audio",aac:"audio",flac:"audio",mp4:"video",webm:"video",mov:"video",m4v:"video",qt:"video",woff2:"font",woff:"font",ttf:"font",otf:"font",glb:"model",gltf:"model",bin:"model",ktx2:"model",hdr:"environment",exr:"environment"};export function mediaKindOf(e){const n=/\.([A-Za-z0-9]+)$/.exec(e)?.[1]?.toLowerCase();return n===void 0?void 0:p[n]}export const MEDIA_EXTENSIONS=Object.keys(p);export function repoPath(e,n){return pathIn(e.split("/").slice(0,-1).join("/"),n)}export function pathIn(e,n){const t=n.startsWith("/")||e===""?[]:e.split("/");for(const o of n.split("/"))if(!(o==="."||o===""))if(o===".."){if(t.length===0)return;t.pop()}else t.push(o);return t.join("/")}

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

@@ -0,0 +1,88 @@
+export interface SpokenText {
+    display: string;
+    speak: string;
+}
+/**
+ * A message with variants (inlang's complex message, unwrapped from its
+ * one-element array): `declarations` name the inputs and the plural
+ * locals, `selectors` what to match on, `match` maps "sel=value, …" to
+ * the text. `*` matches anything.
+ */
+export interface VariantsMessage {
+    declarations: string[];
+    selectors: string[];
+    match: Record<string, string>;
+}
+export type MessageValue = string | SpokenText | VariantsMessage;
+/** A messages file, as read: key → value. */
+export type MessagesFile = Record<string, MessageValue>;
+/** Keys: letters, digits, `_` and `-`, separated by dots. */
+export declare const MESSAGE_KEY: RegExp;
+/** The JSON Schema reference inlang files may carry; not a message. */
+export declare const SCHEMA_KEY = "$schema";
+/** Locale names: en, zh-cn, pt-br… (lower case, as the file names). */
+export declare const LOCALE: RegExp;
+export declare function isSpoken(v: unknown): v is SpokenText;
+export declare function isVariants(v: unknown): v is VariantsMessage;
+type Inputs = Readonly<Record<string, string | number>>;
+/**
+ * What a value shows on screen: `display` of a spoken pair, the selected
+ * variant of a message with variants, else itself.
+ */
+export declare function displayOf(v: MessageValue | undefined, inputs?: Inputs, locale?: string): string | undefined;
+/** What a value reads aloud: `speak` of a spoken pair, else as displayOf. */
+export declare function speakOf(v: MessageValue | undefined, inputs?: Inputs, locale?: string): string | undefined;
+/** Every text a value can show: each variant of a message with variants. */
+export declare function textsOf(v: MessageValue | undefined): string[];
+/** A parsed declaration: an input, or a local that applies plural to an input. */
+export type Declaration = {
+    kind: "input";
+    name: string;
+} | {
+    kind: "plural";
+    name: string;
+    of: string;
+    ordinal: boolean;
+};
+/** One declaration, or a message saying what is wrong with it. */
+export declare function parseDeclaration(text: string): Declaration | string;
+/** A match key ("count=one, platform=*") as selector → value. */
+export declare function parseMatchKey(key: string): Map<string, string> | undefined;
+/** The selectors of a message: as written, else the names in its first match key. */
+export declare function selectorsOf(m: VariantsMessage): string[];
+/** What is wrong with a message with variants, or undefined when nothing is. */
+export declare function variantsProblem(m: VariantsMessage): string | undefined;
+/**
+ * The inputs a message takes, by name: numbers for what a plural counts,
+ * text for the rest (declared inputs, selectors, {name} variables).
+ */
+export declare function messageInputs(v: MessageValue | undefined): Map<string, "number" | "text">;
+/**
+ * The text of a message with variants for these inputs (Intl.PluralRules
+ * in the locale for plurals). Per selector, an exact value beats a plural
+ * category, which beats `*`; the best-matching variant wins, the first
+ * written on a tie. With no match (no inputs given): the variant whose
+ * plurals are all `other`, else the first.
+ */
+export declare function selectVariant(m: VariantsMessage, inputs: Inputs, locale?: string): string;
+/** Fills {name} variables; unknown names stay as written. */
+export declare function fillMessage(text: string, inputs: Readonly<Record<string, string | number>>): string;
+/** A tree built from numbered and named keys under a prefix. */
+export type MessageTree = string | MessageTree[] | {
+    [k: string]: MessageTree;
+};
+/**
+ * The values under `prefix.`, as a list: `prefix.0`, `prefix.1`… in order.
+ * Deeper keys make objects and lists (`plans.0.name`, `plans.0.features.1`).
+ * Numbering stops at the first gap. `keys` receives every key used.
+ */
+export declare function messageList(read: (key: string) => string | undefined, allKeys: Iterable<string>, prefix: string, keys?: string[]): MessageTree[];
+/**
+ * Orders locales: the configured default first, else "en" first, then the
+ * rest alphabetically.
+ */
+export declare function orderLocales(locales: Iterable<string>, preferred?: readonly string[]): string[];
+/** A language's own name ("简体中文"); the code itself when we have none. */
+export declare function languageName(lang: string): string;
+export {};
+//# sourceMappingURL=messages.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const MESSAGE_KEY=/^[A-Za-z0-9_-]+(\.[A-Za-z0-9_-]+)*$/,SCHEMA_KEY="$schema",LOCALE=/^[a-z]{2,3}(-[a-z0-9]{2,8})?$/;export function isSpoken(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)&&typeof e.display=="string"&&typeof e.speak=="string"}export function isVariants(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)&&typeof e.match=="object"}export function displayOf(e,n={},s){return isVariants(e)?selectVariant(e,n,s):isSpoken(e)?e.display:e}export function speakOf(e,n={},s){return isVariants(e)?selectVariant(e,n,s):isSpoken(e)?e.speak:e}export function textsOf(e){if(isVariants(e))return[...new Set(Object.values(e.match))];const n=displayOf(e);return n===void 0?[]:[n]}const x=/^input\s+([A-Za-z_][A-Za-z0-9_]*)$/,A=/^local\s+([A-Za-z_][A-Za-z0-9_]*)\s*=\s*([A-Za-z_][A-Za-z0-9_]*)\s*:\s*([A-Za-z]+)((?:\s+[A-Za-z]+\s*=\s*[A-Za-z]+)*)$/;export function parseDeclaration(e){const n=e.trim(),s=x.exec(n);if(s?.[1])return{kind:"input",name:s[1]};const r=A.exec(n);if(r?.[1]&&r[2]&&r[3]){if(r[3]!=="plural")return`"${n}": only plural is supported, not ${r[3]}`;const t=new Map([...(r[4]??"").matchAll(/([A-Za-z]+)\s*=\s*([A-Za-z]+)/g)].map(a=>[a[1]??"",a[2]??""])).get("type")??"cardinal";return t!=="cardinal"&&t!=="ordinal"?`"${n}": type must be cardinal or ordinal`:{kind:"plural",name:r[1],of:r[2],ordinal:t==="ordinal"}}return`cannot read "${n}": write "input name" or "local name = input: plural"`}export function parseMatchKey(e){const n=new Map;for(const s of e.split(",")){const r=/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*([^,=\s]+)\s*$/.exec(s);if(!r?.[1]||!r[2])return;n.set(r[1],r[2])}return n}export function selectorsOf(e){if(e.selectors.length>0)return e.selectors;const n=Object.keys(e.match)[0];return n===void 0?[]:[...parseMatchKey(n)?.keys()??[]]}function g(e){return e.declarations.map(parseDeclaration).filter(n=>typeof n!="string")}export function variantsProblem(e){for(const t of e.declarations){const a=parseDeclaration(t);if(typeof a=="string")return a}const n=g(e),s=new Set(n.filter(t=>t.kind==="input").map(t=>t.name));for(const t of n)if(t.kind==="plural"&&!s.has(t.of))return`${t.of}, used by plural, must be declared first as "input ${t.of}"`;const r=selectorsOf(e),o=Object.keys(e.match);if(o.length===0)return"match needs at least one entry";if(r.length===0)return"selectors must not be empty";for(const t of o){const a=parseMatchKey(t);if(!a)return`match key "${t}" must be written as selector=value, separated by commas`;const p=[...a.keys()];if(p.length!==r.length||p.some(i=>!r.includes(i)))return`match key "${t}" must name every selector (${r.join(", ")}) exactly once`}}export function messageInputs(e){const n=new Map;if(e===void 0)return n;const s=new Set;if(isVariants(e)){const o=g(e);for(const t of o)t.kind==="input"?n.set(t.name,"text"):s.add(t.name);for(const t of o)t.kind==="plural"&&n.set(t.of,"number");for(const t of selectorsOf(e))!s.has(t)&&!n.has(t)&&n.set(t,"text")}const r=isVariants(e)?Object.values(e.match):isSpoken(e)?[e.display,e.speak]:[e];for(const o of r)for(const t of o.matchAll(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g)){const a=t[1]??"";!s.has(a)&&!n.has(a)&&n.set(a,"text")}return n}const h=new Map;function b(e,n,s){if(!Number.isFinite(e))return;const r=`${n??""}|${String(s)}`;let o=h.get(r);if(!o){const t=s?"ordinal":"cardinal";try{o=new Intl.PluralRules(n,{type:t})}catch{o=new Intl.PluralRules(void 0,{type:t})}h.set(r,o)}return o.select(e)}export function selectVariant(e,n,s){const r=new Map;for(const i of g(e))i.kind==="plural"&&r.set(i.name,{of:i.of,ordinal:i.ordinal});const o=selectorsOf(e),t=o.map(i=>{const d=r.get(i);if(d){const f=n[d.of],y=f===void 0||f===""?NaN:Number(f);return{exact:Number.isFinite(y)?String(y):void 0,category:b(y,s,d.ordinal)}}const c=n[i];return{exact:c===void 0?void 0:String(c),category:void 0}});let a,p=-1;for(const[i,d]of Object.entries(e.match)){const c=parseMatchKey(i);if(!c)continue;let f=0;for(const[y,u]of o.entries()){const l=c.get(u),m=t[y];if(l==="*")f+=1;else if(m?.exact!==void 0&&l===m.exact)f+=3;else if(m?.category!==void 0&&l===m.category)f+=2;else{f=-1;break}}f>p&&(a=d,p=f)}if(a!==void 0)return a;if(r.size>0)for(const[i,d]of Object.entries(e.match)){const c=parseMatchKey(i);if(c&&[...r.keys()].every(f=>c.get(f)==="other"))return d}return Object.values(e.match)[0]??""}export function fillMessage(e,n){return e.replace(/\{([A-Za-z_][A-Za-z0-9_]*)\}/g,(s,r)=>{const o=n[r];return o===void 0?s:String(o)})}export function messageList(e,n,s,r=[]){const o=`${s}.`,t=[...n].filter(i=>i.startsWith(o)),a=i=>{const d=e(i);if(d!==void 0&&!t.some(u=>u.startsWith(`${i}.`)))return r.push(i),d;const c=new Set;for(const u of t){if(!u.startsWith(`${i}.`))continue;const l=u.slice(i.length+1).split(".")[0];l&&c.add(l)}if(c.size===0)return;if([...c].every(u=>/^\d+$/.test(u))){const u=[];for(let l=0;c.has(String(l));l++){const m=a(`${i}.${String(l)}`);m!==void 0&&u.push(m)}return u}const y={};for(const u of[...c].sort()){const l=a(`${i}.${u}`);l!==void 0&&(y[u]=l)}return y},p=a(s);return Array.isArray(p)?p:[]}export function orderLocales(e,n=[]){const s=[...new Set(e)].sort(),r=n.filter(t=>s.includes(t)),o=s.filter(t=>!r.includes(t));return r.length===0&&o.includes("en")?["en",...o.filter(t=>t!=="en")]:[...r,...o]}const k={en:"English","zh-cn":"简体中文","zh-tw":"繁體中文","zh-hk":"繁體中文（香港）",ja:"日本語",ko:"한국어",fr:"Français",de:"Deutsch",es:"Español",pt:"Português","pt-br":"Português (Brasil)",it:"Italiano",ru:"Русский",vi:"Tiếng Việt",id:"Bahasa Indonesia",th:"ไทย",ar:"العربية"};export function languageName(e){return k[e]??e}

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

@@ -0,0 +1,56 @@
+import type { PixelRect } from "./timeline.js";
+/**
+ * How a segment between two keyframes runs: linear, or cubic easing in,
+ * out, or in and out. The ease of a keyframe applies to the segment that
+ * arrives at it.
+ */
+export type Ease = "linear" | "in" | "out" | "in-out";
+export declare const EASES: readonly Ease[];
+/** A number at a moment: seconds `t`, value `v`, and how the segment arriving here runs. */
+export interface ScalarKey {
+    t: number;
+    v: number;
+    ease?: Ease;
+}
+/** Eased progress over [0, 1]. */
+export declare function easeValue(ease: Ease | undefined, x: number): number;
+/**
+ * The value of keyframes at t: the first value before the first key, the
+ * last after the last, eased in between. Keys must be in time order.
+ */
+export declare function keyAt(keys: readonly ScalarKey[], t: number): number;
+/** easeValue as an ffmpeg expression of `x` (already clipped to [0, 1]). */
+export declare function easeExpr(ease: Ease | undefined, x: string): string;
+/**
+ * keyAt as an ffmpeg expression of the variable `tv`, whose value is
+ * `t - offset` (a filter's window clock): `keyExpr(keys, "t", start)`.
+ * Nested if()s, one per segment; a constant when the value never changes.
+ */
+export declare function keyExpr(keys: readonly ScalarKey[], tv: string, offset?: number): string;
+/** A rectangle at a moment, eased like ScalarKey. */
+export interface RectKey {
+    t: number;
+    rect: PixelRect;
+    ease?: Ease;
+}
+/** One coordinate of rectangle keys as scalar keys (0 x, 1 y, 2 w, 3 h). */
+export declare function rectChannel(keys: readonly RectKey[], i: 0 | 1 | 2 | 3): {
+    ease?: Ease;
+    t: number;
+    v: number;
+}[];
+/** The rectangle of keys at t (fractional pixels). */
+export declare function rectAt(keys: readonly RectKey[], t: number): PixelRect;
+/**
+ * Drops keys that a straight line through their neighbours already gives
+ * within `tolerance` (Ramer–Douglas–Peucker on linear keys): a smoothed
+ * face path of hundreds of samples becomes a handful of keys.
+ */
+export declare function simplifyKeys(keys: readonly {
+    t: number;
+    v: number[];
+}[], tolerance: number): {
+    t: number;
+    v: number[];
+}[];
+//# sourceMappingURL=motion.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const EASES=["linear","in","out","in-out"];export function easeValue(t,n){const e=Math.min(Math.max(n,0),1);switch(t??"linear"){case"linear":return e;case"in":return e*e*e;case"out":return 1-(1-e)**3;case"in-out":return e<.5?4*e*e*e:1-(-2*e+2)**3/2}}export function keyAt(t,n){const e=t[0];if(!e)return 0;if(n<=e.t)return e.v;for(let i=1;i<t.length;i++){const a=t[i-1],r=t[i];if(!(!a||!r)&&n<r.t){const o=r.t-a.t;return o<=0?r.v:a.v+(r.v-a.v)*easeValue(r.ease,(n-a.t)/o)}}return t.at(-1)?.v??e.v}const s=t=>{const n=(Math.round(t*1e6)/1e6).toFixed(6).replace(/\.?0+$/,"");return n==="-0"||n===""?"0":n};export function easeExpr(t,n){switch(t??"linear"){case"linear":return n;case"in":return`pow(${n},3)`;case"out":return`(1-pow(1-${n},3))`;case"in-out":return`if(lt(${n},0.5),4*pow(${n},3),1-pow(2-2*${n},3)/2)`}}export function keyExpr(t,n,e=0){const i=t[0];if(!i)return"0";if(t.every(o=>Math.abs(o.v-i.v)<1e-9))return s(i.v);const a=t.at(-1)??i;let r=s(a.v);for(let o=t.length-1;o>=1;o--){const c=t[o-1],u=t[o];if(!c||!u)continue;const l=u.t-c.t;if(l<=0)continue;const f=s(c.t-e),p=`min(max((${n}-${f})/${s(l)},0),1)`,h=Math.abs(u.v-c.v)<1e-9?s(c.v):`(${s(c.v)}+${s(u.v-c.v)}*${easeExpr(u.ease,p)})`;r=`if(lt(${n},${s(u.t-e)}),${h},${r})`}return`if(lt(${n},${s(i.t-e)}),${s(i.v)},${r})`}export function rectChannel(t,n){return t.map(e=>({t:e.t,v:e.rect[n],...e.ease?{ease:e.ease}:{}}))}export function rectAt(t,n){return[keyAt(rectChannel(t,0),n),keyAt(rectChannel(t,1),n),keyAt(rectChannel(t,2),n),keyAt(rectChannel(t,3),n)]}export function simplifyKeys(t,n){if(t.length<=2)return[...t];const e=new Uint8Array(t.length);e[0]=1,e[t.length-1]=1;const i=[[0,t.length-1]];for(;i.length>0;){const[a,r]=i.pop()??[0,0],o=t[a],c=t[r];if(!o||!c)continue;let u=-1,l=-1;for(let f=a+1;f<r;f++){const p=t[f];if(!p)continue;const h=c.t===o.t?0:(p.t-o.t)/(c.t-o.t);let v=0;p.v.forEach((x,$)=>{const w=(o.v[$]??0)+((c.v[$]??0)-(o.v[$]??0))*h;v=Math.max(v,Math.abs(x-w))}),v>u&&(u=v,l=f)}u>n&&l>0&&(e[l]=1,i.push([a,l],[l,r]))}return t.filter((a,r)=>e[r]===1)}

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

@@ -0,0 +1,110 @@
+/** The music's defaults: a seam's cross-fade, beats a bar, the whole file's loop seam. */
+export declare const MUSIC_DEFAULTS: {
+    /** Seconds a seam between two stretches cross-fades over. */
+    readonly seam: 0.03;
+    /** Beats a bar. */
+    readonly meter: 4;
+    /** Seconds the whole file looped (`loop: true`) cross-fades over at each seam. */
+    readonly loopSeam: 0.25;
+};
+/**
+ * A place in the music's file: seconds, or `{ beat }` beats after its
+ * first beat, or `{ bar }` bars after its downbeat (bar 0); a beat or a
+ * bar needs a tempo, given or measured.
+ */
+export type MusicTime = number | {
+    beat: number;
+} | {
+    bar: number;
+};
+/** A stretch of the music's file, from `from` to `to`. */
+export interface MusicStretch<T = MusicTime> {
+    from: T;
+    to: T;
+}
+/** The music's beat grid, in seconds of its file. */
+export interface MusicGrid {
+    /** Seconds a beat. */
+    beat: number;
+    /** The file's second of beat 0. */
+    first: number;
+    /** Beats a bar. */
+    meter: number;
+    /** The file's second of bar 0. */
+    downbeat: number;
+}
+/**
+ * The grid from a tempo (a given bpm counts from the file's start, a
+ * measured one from its first beat) and where the agent says bar 0 is
+ * (default: beat 0).
+ */
+export declare function musicGrid(tempo: {
+    bpm: number;
+    beat?: number;
+} | undefined, o?: {
+    meter?: number | undefined;
+    downbeat?: number | undefined;
+}): MusicGrid | undefined;
+/** A place in the file in seconds; undefined for a beat or a bar without a grid. */
+export declare function musicSeconds(t: MusicTime, grid: MusicGrid | undefined): number | undefined;
+/** Whether a place needs the grid (a beat or a bar). */
+export declare const onGrid: (t: MusicTime) => boolean;
+/** What is wrong with a music time, or nothing. */
+export declare function musicTimeProblem(t: unknown): string | undefined;
+/** A stretch of the file placed on the film: from film second `at`, file seconds `from` to `to`. */
+export interface PlacedStretch {
+    at: number;
+    from: number;
+    to: number;
+}
+/**
+ * The stretches on the film, back to back from film second 0: `play` in
+ * order, then `repeat` again and again, until `until` film seconds. Each
+ * `to` is at most `len` (the file's length) and a stretch that plays
+ * nothing is left out.
+ */
+export declare function placeStretches(play: readonly {
+    from: number;
+    to: number;
+}[], repeat: {
+    from: number;
+    to: number;
+} | undefined, len: number, until: number): PlacedStretch[];
+/**
+ * The whole file looped as it always was: from `from` to its end, then
+ * from its start again, each seam crossing its last `seam` seconds into
+ * the next start (so a stretch's own time on the film is its file less
+ * the seam).
+ */
+export declare function wholeLoop(from: number, len: number, until: number, seam?: number): PlacedStretch[];
+/** A piece of the file the mix plays: film second `at`, file second `from`, `dur` seconds, its equal-power fades. */
+export interface MusicSegment {
+    at: number;
+    from: number;
+    dur: number;
+    fadeIn: number;
+    fadeOut: number;
+}
+/**
+ * What the mix plays of the stretches: each one with the seam's
+ * cross-fade with its neighbour. `place` "before" crosses over the `seam`
+ * before the join: the stretch before fades out over its own last `seam`
+ * seconds, the one after fades in over the file's `seam` seconds before
+ * its start (what the file has of them: none at its very start); "after"
+ * crosses over the `seam` after the join, the stretch before running on
+ * past its end while the one after fades in over its own first seconds
+ * (the whole file's loop). With `ends`, the last stretch is where the
+ * music ends, and fades out over its last `seam` seconds unless it ends
+ * where the file does (a stretch that repeats runs on past the film's
+ * end). `len` is the file's length.
+ */
+export declare function musicSegments(stretches: readonly PlacedStretch[], seam: number, len: number, place?: "before" | "after", ends?: boolean): MusicSegment[];
+/** The film seconds where beats (or bars) of the grid fall in the stretches, in order. */
+export declare function filmBeats(stretches: readonly PlacedStretch[], grid: MusicGrid, unit?: "beat" | "bar"): number[];
+/**
+ * The beat a part ending near `t` ends on: the one nearest `t` that is
+ * after `after`, from the beats on the film (`beats`), and past the last
+ * of them the grid carried on at `step`. Undefined without beats.
+ */
+export declare function beatNear(beats: readonly number[], step: number, t: number, after: number): number | undefined;
+//# sourceMappingURL=music.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const MUSIC_DEFAULTS={seam:.03,meter:4,loopSeam:.25};export function musicGrid(e,t={}){if(!e||!(e.bpm>0))return;const f=e.beat??0;return{beat:60/e.bpm,first:t.downbeat??f,meter:t.meter??MUSIC_DEFAULTS.meter,downbeat:t.downbeat??f}}export function musicSeconds(e,t){if(typeof e=="number")return e;if(t)return"beat"in e?t.first+e.beat*t.beat:t.downbeat+e.bar*t.meter*t.beat}export const onGrid=e=>typeof e!="number";export function musicTimeProblem(e){if(typeof e=="number")return Number.isFinite(e)&&e>=0?void 0:`a place in the music is seconds from 0, not ${String(e)}`;if(typeof e=="object"&&e!==null){const t=Object.keys(e),f=e[t[0]??""];if(t.length===1&&(t[0]==="beat"||t[0]==="bar")&&typeof f=="number"&&Number.isFinite(f))return}return`a place in the music is seconds of its file, { beat: n } or { bar: n }, not ${JSON.stringify(e)}`}export function placeStretches(e,t,f,u){const a=[];let r=0;const o=n=>{const i=Math.max(0,n.from),c=Math.min(f,n.to);return c-i<.001?!1:(a.push({at:r,from:i,to:c}),r+=c-i,!0)};for(const n of e){if(r>=u)return a;o(n)}if(t)for(;r<u&&o(t););return a}export function wholeLoop(e,t,f,u=MUSIC_DEFAULTS.loopSeam){const a=t>1?u:0,r=t-a;if(r<=0)return[];const o=[];let n=0,i=Math.max(0,e)%r;for(;n<f;)o.push({at:n,from:i,to:r}),n+=r-i,i=0;return o}export function musicSegments(e,t,f,u="before",a=!0){const r=e.map(o=>({at:o.at,from:o.from,dur:o.to-o.from,fadeIn:0,fadeOut:0}));for(let o=0;o<r.length;o++){const n=r[o],i=e[o];if(!n||!i||t<=0)continue;const c=e[o+1],s=r[o+1],d=m=>Math.min(t,m.dur/2);if(!c||!s){a&&f-i.to>.001&&(n.fadeOut=d(n));continue}if(u==="after"){const m=Math.min(t,f-i.to);n.dur+=m,n.fadeOut=m,s.fadeIn=m;continue}n.fadeOut=d(n);const b=Math.min(t,c.from);s.at-=b,s.from-=b,s.dur+=b,s.fadeIn=b}return r}export function filmBeats(e,t,f="beat"){const u=f==="bar"?t.beat*t.meter:t.beat,a=f==="bar"?t.downbeat:t.first,r=[];for(const o of e){let n=Math.ceil((o.from-a)/u-1e-9);for(;;){const i=a+n*u;if(i>=o.to-1e-9)break;i>=o.from-1e-9&&r.push(o.at+(i-o.from)),n++}}return r.sort((o,n)=>o-n)}export function beatNear(e,t,f,u){const a=e.at(-1);if(a===void 0||!(t>0))return;let r;const o=n=>{n<=u+1e-9||(r===void 0||Math.abs(n-f)<Math.abs(r-f))&&(r=n)};for(const n of e)o(n);if(f+t>a){const n=Math.max(1,Math.round((f-a)/t));for(const i of[n-1,n,n+1])i>=1&&o(a+i*t)}if(r===void 0){const n=Math.max(1,Math.ceil((u-a)/t+1e-9));r=a+n*t}return r}