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

package/NOTICE

@@ -79,3 +79,88 @@ public-domain simplex noise reference ("Simplex noise demystified", 2005).
 
 The Apache License, Version 2.0 is reproduced at the end of LICENSE; those
 parts remain under it.
+
+How a voice was recorded (packages/engine/src/recording/) builds a room's
+impulse response after pyroomacoustics
+(https://github.com/LCAV/pyroomacoustics), under the MIT License: the image
+source method in a box with each reflection's amplitude per octave band,
+fractional delays written with a Hann-windowed sinc, the octave bands joined
+by Antoni's power-complementary crossovers, the late tail as random impulses
+of growing density decaying by each band's reverberation time, Eyring's
+reverberation time with the air's absorption, and the materials' absorption
+coefficients and the air's absorption table (pyroomacoustics/data/
+materials.json, acoustics.py, simulation/ism.py and rt.py, libroom_src/
+room.cpp). room.ts says so in its header.
+
+  Copyright (c) 2014-2017 EPFL-LCAV
+
+  Permission is hereby granted, free of charge, to any person obtaining a
+  copy of this software and associated documentation files (the
+  "Software"), to deal in the Software without restriction, including
+  without limitation the rights to use, copy, modify, merge, publish,
+  distribute, sublicense, and/or sell copies of the Software, and to permit
+  persons to whom the Software is furnished to do so, subject to the
+  following conditions:
+
+  The above copyright notice and this permission notice shall be included
+  in all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+  OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
+  NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+  DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+  USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+Its loudness (loudness.ts) puts BS.1770's K-weighting filters at any sample
+rate from their analogue prototypes, as pyloudnorm
+(https://github.com/csteinmetz1/pyloudnorm) does, Copyright (c) 2021
+Christian Steinmetz, under the MIT License; its filters follow Robert
+Bristow-Johnson's Audio EQ Cookbook, and its compressor Giannoulis, Massberg
+and Reiss, "Digital Dynamic Range Compressor Design" (JAES, 2012).
+
+---
+
+AllyHub
+Copyright (c) 2026 AllyHub, Inc. All rights reserved.
+
+This product is proprietary; see LICENSE.
+
+The centripetal Catmull-Rom tangents in src/curve.ts follow three.js's
+CatmullRomCurve3 (src/extras/curves/CatmullRomCurve3.js)
+(https://github.com/mrdoob/three.js),
+Copyright 2010-2026 three.js authors, under the MIT License:
+
+  Permission is hereby granted, free of charge, to any person obtaining a
+  copy of this software and associated documentation files (the
+  "Software"), to deal in the Software without restriction, including
+  without limitation the rights to use, copy, modify, merge, publish,
+  distribute, sublicense, and/or sell copies of the Software, and to permit
+  persons to whom the Software is furnished to do so, subject to the
+  following conditions:
+
+  The above copyright notice and this permission notice shall be included
+  in all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+  OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN
+  NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+  DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+  OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
+  USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+The arc-length parametrisation (Gauss-Legendre quadrature per segment,
+inverted by Newton steps with a bisection fallback) and the timing of
+keyframes by a monotone cubic follow the approach of the splines library
+(https://github.com/AudioSceneDescriptionFormat/splines), Copyright (c)
+2018-2026 Matthias Geier, under the MIT License (the same terms as above).
+No code of it is copied.
+
+The moiré a sensor makes of a screen (src/moire.ts) follows
+the screen-capture simulation of UniDemoiré
+(https://github.com/4DVLab/UniDemoire, unidemoire/models/shooting), Copyright
+(c) 2024 4DVLab, under the MIT License: a screen's RGB subpixels, the
+projective transform, the sensor's Bayer filter. It is worked out in closed
+form per pixel; no code of it is copied.

package/client.d.ts

@@ -1,6 +1,6 @@
 // Types of the imports AllyHub's build understands. Add "@allyhub/sdk/client" to `types` in tsconfig.json.
 
-type AllyHubMedia = import("@allyhub/engine/stage").MediaInfo;
+type AllyHubMedia = import("@allyhub/sdk").MediaInfo;
 type AllyHubRow = Record<string, string | number>;
 
 declare module "*.png" {
@@ -71,6 +71,50 @@ declare module "*.woff2" {
   const media: AllyHubMedia;
   export default media;
 }
+declare module "*.m4v" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.qt" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.woff" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.ttf" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.otf" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.glb" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.gltf" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.bin" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.ktx2" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.hdr" {
+  const media: AllyHubMedia;
+  export default media;
+}
+declare module "*.exr" {
+  const media: AllyHubMedia;
+  export default media;
+}
 declare module "*.csv" {
   /** One object per row, keyed by the header; numeric columns are numbers. */
   const rows: AllyHubRow[];

package/dist/anim.js

@@ -1,75 +1,2 @@
-// Animation helpers. All are pure functions of time (the skill's references/core.md, "Animation helpers").
-export const clamp = (x, lo = 0, hi = 1) => Math.min(hi, Math.max(lo, x));
-export const lerp = (a, b, x) => a + (b - a) * x;
-/** Progress of t through [start, start + dur], clamped to 0–1. */
-export const progress = (t, start, dur) => dur <= 0 ? (t >= start ? 1 : 0) : clamp((t - start) / dur);
-export const ease = {
-    linear: ((x) => x),
-    in: ((x) => x * x * x),
-    out: ((x) => 1 - Math.pow(1 - x, 3)),
-    inOut: ((x) => x < 0.5 ? 4 * x * x * x : 1 - Math.pow(-2 * x + 2, 3) / 2),
-    outExpo: ((x) => (x >= 1 ? 1 : 1 - Math.pow(2, -10 * x))),
-    outBack: ((x) => {
-        const c1 = 1.7;
-        const c3 = c1 + 1;
-        return 1 + c3 * Math.pow(x - 1, 3) + c1 * Math.pow(x - 1, 2);
-    }),
-    /** A damped spring that settles at 1. */
-    spring(damping = 7, frequency = 3.2) {
-        return (x) => x >= 1
-            ? 1
-            : 1 -
-                Math.exp(-damping * x) * Math.cos(frequency * Math.PI * 2 * x * 0.5);
-    },
-};
-/** The value at time t of a tween from `from` to `to`. */
-export function tween(t, opts = {}) {
-    const { from = 0, to = 1, start = 0, dur = 0.5, ease: e = ease.out } = opts;
-    return lerp(from, to, e(progress(t, start, dur)));
-}
-/** The delay of the i-th element of a staggered group. */
-export const stagger = (i, gap) => i * gap;
-function hashSeed(seed) {
-    const s = String(seed);
-    let h = 2166136261;
-    for (let i = 0; i < s.length; i++) {
-        h ^= s.charCodeAt(i);
-        h = Math.imul(h, 16777619);
-    }
-    return h >>> 0;
-}
-/** A deterministic random number generator: the same seed, the same numbers. */
-export function rand(seed) {
-    let a = hashSeed(seed);
-    return () => {
-        a = (a + 0x6d2b79f5) | 0;
-        let t = Math.imul(a ^ (a >>> 15), 1 | a);
-        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
-        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
-    };
-}
-/**
- * Sets the largest font size in [min, max] at which the element's text fits
- * its own box (no overflow). The element needs a definite width (and height,
- * to limit lines). Returns the size chosen.
- */
-export function fitText(el, opts) {
-    const fits = () => el.scrollWidth <= el.clientWidth + 1 &&
-        el.scrollHeight <= el.clientHeight + 1;
-    let lo = opts.min;
-    let hi = opts.max;
-    el.style.fontSize = `${hi}px`;
-    if (fits())
-        return hi;
-    while (hi - lo > 0.5) {
-        const mid = (lo + hi) / 2;
-        el.style.fontSize = `${mid}px`;
-        if (fits())
-            lo = mid;
-        else
-            hi = mid;
-    }
-    el.style.fontSize = `${lo}px`;
-    return lo;
-}
-//# sourceMappingURL=anim.js.map
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const clamp=(t,n=0,e=1)=>Math.min(e,Math.max(n,t)),lerp=(t,n,e)=>t+(n-t)*e,progress=(t,n,e)=>e<=0?t>=n?1:0:clamp((t-n)/e),ease={linear:(t=>t),in:(t=>t*t*t),out:(t=>1-Math.pow(1-t,3)),inOut:(t=>t<.5?4*t*t*t:1-Math.pow(-2*t+2,3)/2),outExpo:(t=>t>=1?1:1-Math.pow(2,-10*t)),outBack:(t=>1+2.7*Math.pow(t-1,3)+1.7*Math.pow(t-1,2)),spring(t=7,n=3.2){return e=>e>=1?1:1-Math.exp(-t*e)*Math.cos(n*Math.PI*2*e*.5)}};export function tween(t,n={}){const{from:e=0,to:o=1,start:r=0,dur:i=.5,ease:c=ease.out}=n;return lerp(e,o,c(progress(t,r,i)))}export const stagger=(t,n)=>t*n;function s(t){const n=String(t);let e=2166136261;for(let o=0;o<n.length;o++)e^=n.charCodeAt(o),e=Math.imul(e,16777619);return e>>>0}export function rand(t){let n=s(t);return()=>{n=n+1831565813|0;let e=Math.imul(n^n>>>15,1|n);return e=e+Math.imul(e^e>>>7,61|e)^e,((e^e>>>14)>>>0)/4294967296}}export function fitText(t,n){const e=()=>t.scrollWidth<=t.clientWidth+1&&t.scrollHeight<=t.clientHeight+1;let o=n.min,r=n.max;if(t.style.fontSize=`${String(r)}px`,e())return r;for(;r-o>.5;){const i=(o+r)/2;t.style.fontSize=`${String(i)}px`,e()?o=i:r=i}return t.style.fontSize=`${String(o)}px`,o}

package/dist/define.d.ts

@@ -1,14 +1,17 @@
-import { type GraphicLayer, type LayerTiming, type StageContext, type TimeShape } from "@allyhub/engine/stage";
+import { type GraphicLayer, type LayerTiming, type StageContext, type TimeShape } from "@allyhub-next/video-core";
 import type { PropSchema, Timed } from "./props.js";
-export type { StageContext } from "@allyhub/engine/stage";
+export type { StageContext } from "@allyhub-next/video-core";
 /** What every graphic layer takes besides a component's own props. */
 export interface LayerOptions extends LayerTiming {
     /**
      * "front" (default): at its place in the part's layers, over those
      * listed before it. "behind-person": right over the part's own footage
      * and under its speaker, cut out with the take's person matte.
+     * "overlay": over the finished picture, as an app lays captions over a
+     * video after it is filmed: over every other layer, and not marked by
+     * the camera (`capture`), motion blur, `post` or the LUT.
      */
-    z?: "front" | "behind-person";
+    z?: "front" | "behind-person" | "overlay";
 }
 /** Text for people: one string, or by language. */
 export type Label = string | Record<string, string>;
@@ -52,7 +55,7 @@ export interface ComponentDefinition<P extends object> {
     render(el: HTMLElement, t: number, props: P, ctx: StageContext): void;
 }
 /** A component: a function that makes a graphic layer from its props and the layer options. */
-export type Component<P extends object> = ((opts: LayerOptions & Timed<P>) => GraphicLayer<P>) & {
+export type Component<P extends object> = ((...opts: Partial<Timed<P>> extends Timed<P> ? [opts?: LayerOptions & Timed<P>] : [opts: LayerOptions & Timed<P>]) => GraphicLayer<P>) & {
     componentName: string;
     info: ComponentInfo;
 };
@@ -63,6 +66,9 @@ export type Component<P extends object> = ((opts: LayerOptions & Timed<P>) => Gr
 export declare const LAYER_OPTIONS: readonly string[];
 /** Where props hold times, from their schema; undefined when none do. */
 export declare function timeShape(props: Readonly<Record<string, PropSchema | undefined>>): TimeShape | undefined;
+/** The layer options of an options object, and the rest. */
+/** A layer's timing and z, and the rest of its options. */
+export declare function splitLayer<T extends LayerOptions>(opts: T): [LayerOptions, Omit<T, keyof LayerOptions>];
 /** Makes a component: a function that returns a graphic layer. */
 export declare function defineComponent<P extends object>(def: ComponentDefinition<P>): Component<P>;
 export interface CustomOptions extends LayerOptions {

package/dist/define.js

@@ -1,95 +1,2 @@
-import { LAYER_BRAND, } from "@allyhub/engine/stage";
-/**
- * Layer options share one object with a component's props, so these names
- * are reserved: a component cannot have props called this.
- */
-export const LAYER_OPTIONS = ["at", "until", "dur", "z"];
-/** Where props hold times, from their schema; undefined when none do. */
-export function timeShape(props) {
-    const of = (s) => {
-        if (s.type === "time")
-            return true;
-        if (s.type === "list")
-            return of(s.of);
-        if (s.type === "object")
-            return timeShape(s.fields);
-        return undefined;
-    };
-    const out = {};
-    for (const [k, s] of Object.entries(props)) {
-        const shape = s ? of(s) : undefined;
-        if (shape !== undefined)
-            out[k] = shape;
-    }
-    return Object.keys(out).length > 0 ? out : undefined;
-}
-/** The layer options of an options object, and the rest. */
-function splitLayer(opts) {
-    const { at, until, dur, z, ...rest } = opts;
-    return [
-        {
-            ...(at === undefined ? {} : { at }),
-            ...(until === undefined ? {} : { until }),
-            ...(dur === undefined ? {} : { dur }),
-            ...(z === undefined ? {} : { z }),
-        },
-        rest,
-    ];
-}
-/** Makes a component: a function that returns a graphic layer. */
-export function defineComponent(def) {
-    const names = [
-        ...Object.keys(def.props ?? {}),
-        ...Object.keys(def.defaults ?? {}),
-        ...Object.values(def.examples ?? {}).flatMap((e) => Object.keys(e)),
-    ];
-    const clash = [...new Set(names.filter((k) => LAYER_OPTIONS.includes(k)))];
-    if (clash.length > 0) {
-        throw new Error(`${def.name}: ${clash.join(", ")} is a layer option, not a prop name`);
-    }
-    const times = timeShape(def.props ?? {});
-    const make = (opts) => {
-        const [layer, rest] = splitLayer(opts);
-        // Word references in time() props are seconds by the time mount runs.
-        const props = { ...def.defaults, ...rest };
-        return {
-            [LAYER_BRAND]: "graphic",
-            ...layer,
-            component: def.name,
-            props,
-            ...(times ? { times } : {}),
-            mount: (el, p, ctx) => {
-                def.mount(el, p, ctx);
-            },
-            render: (el, t, p, ctx) => {
-                def.render(el, t, p, ctx);
-            },
-        };
-    };
-    const info = {
-        name: def.name,
-        label: def.label ?? def.name,
-        ...(def.summary === undefined ? {} : { summary: def.summary }),
-        props: Object.fromEntries(Object.entries(def.props ?? {}).filter((e) => e[1] !== undefined)),
-        examples: def.examples ?? {},
-        hidden: def.hidden ?? false,
-    };
-    return Object.assign(make, { componentName: def.name, info });
-}
-/** A graphic layer written directly in the output, for what no component does. */
-export function custom(opts) {
-    const [layer] = splitLayer(opts);
-    return {
-        [LAYER_BRAND]: "graphic",
-        ...layer,
-        component: "custom",
-        props: {},
-        mount: (el, _props, ctx) => {
-            opts.mount?.(el, ctx);
-        },
-        render: (el, t, _props, ctx) => {
-            opts.render(el, t, ctx);
-        },
-    };
-}
-//# sourceMappingURL=define.js.map
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{LAYER_BRAND as c}from"@allyhub-next/video-core";export const LAYER_OPTIONS=["at","until","dur","z"];export function timeShape(e){const o=n=>{if(n.type==="time")return!0;if(n.type==="list")return o(n.of);if(n.type==="object")return timeShape(n.fields)},t={};for(const[n,r]of Object.entries(e)){const s=r?o(r):void 0;s!==void 0&&(t[n]=s)}return Object.keys(t).length>0?t:void 0}export function splitLayer(e){const{at:o,until:t,dur:n,z:r,...s}=e;return[{...o===void 0?{}:{at:o},...t===void 0?{}:{until:t},...n===void 0?{}:{dur:n},...r===void 0?{}:{z:r}},s]}export function defineComponent(e){const o=[...Object.keys(e.props??{}),...Object.keys(e.defaults??{}),...Object.values(e.examples??{}).flatMap(i=>Object.keys(i))],t=[...new Set(o.filter(i=>LAYER_OPTIONS.includes(i)))];if(t.length>0)throw new Error(`${e.name}: ${t.join(", ")} is a layer option, not a prop name`);const n=timeShape(e.props??{}),r=i=>{const[m,l]=splitLayer(i??{}),d={...e.defaults,...l};return{[c]:"graphic",...m,component:e.name,props:d,...n?{times:n}:{},mount:(u,p,a)=>{e.mount(u,p,a)},render:(u,p,a,f)=>{e.render(u,p,a,f)}}},s={name:e.name,label:e.label??e.name,...e.summary===void 0?{}:{summary:e.summary},props:Object.fromEntries(Object.entries(e.props??{}).filter(i=>i[1]!==void 0)),examples:e.examples??{},hidden:e.hidden??!1};return Object.assign(r,{componentName:e.name,info:s})}export function custom(e){const[o]=splitLayer(e);return{[c]:"graphic",...o,component:"custom",props:{},mount:(t,n,r)=>{e.mount?.(t,r)},render:(t,n,r,s)=>{e.render(t,n,s)}}}

package/dist/dom.d.ts

@@ -1,4 +1,4 @@
-import { type CaptionTrackCue, type ContentOptions, type InlineMark, type StageContext } from "@allyhub/engine/stage";
+import { type CaptionTrackCue, type ContentOptions, type InlineMark, type StageContext } from "@allyhub-next/video-core";
 /** Inline styles: camelCase or `--custom` properties; numbers are pixels. */
 export type Style = Partial<Record<string, string | number>>;
 export declare function h(tag: string, style?: Style, children?: (Node | string)[], cls?: string): HTMLElement;