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

package/dist/input.d.ts

@@ -0,0 +1,306 @@
+/** A point on the screen, px. */
+export type Point = readonly [x: number, y: number];
+/** How an aimed movement goes: its shape, its time, where it lands, its tremor. */
+export interface ReachOptions {
+    /** How far it goes past the target, a share of the distance (negative: it falls short); the correction comes back. */
+    overshoot?: number;
+    /** When its speed peaks, a share of its primary movement's time: under a half is a quick start and a longer settle. */
+    peak?: number;
+    /** How much a seed changes the shape from move to move, 0 to 1. */
+    vary?: number;
+    /** Fitts' law, without a duration: seconds = a + b · log2(1 + distance / size). */
+    fitts?: {
+        a?: number;
+        b?: number;
+    };
+    /** How far it lands from the target's centre: a standard deviation, a share of the target's size. */
+    scatter?: number;
+    /** How early or late it lands: a standard deviation, seconds. */
+    jitter?: number;
+    /** How far its path bows to one side, at most, a share of the distance (the side and amount drawn by the seed). */
+    bow?: number;
+    /** A hand's tremor: its standard deviation, px, and the middle of its band, Hz. */
+    tremor?: {
+        px?: number;
+        frequency?: number;
+    };
+    /** Another seed is another hand. */
+    seed?: number;
+}
+export declare const INPUT_DEFAULTS: {
+    reach: {
+        overshoot: number;
+        peak: number;
+        vary: number;
+        fitts: {
+            a: number;
+            b: number;
+        };
+        scatter: number;
+        jitter: number;
+        bow: number;
+        tremor: {
+            px: number;
+            frequency: number;
+        };
+        seed: number;
+    };
+    /** A target's size when a step gives none, px. */
+    size: number;
+    /** Seconds the pointer rests on a target before it presses, and a press's hold. */
+    dwell: number;
+    hold: number;
+    /** A drag: the finger's rest before it moves and after, s; its Fitts' b (a drag is slower than a move); its tremor while down. */
+    drag: {
+        settle: number;
+        release: number;
+        fitts: {
+            a: number;
+            b: number;
+        };
+        tremor: {
+            px: number;
+            frequency: number;
+        };
+    };
+    /** A tap: how far the finger slides while it is down, px, and its contact's growth, s. */
+    tap: {
+        slide: number;
+        grow: number;
+    };
+    /** A wheel: px a notch, seconds each notch is animated over, seconds between notches in a burst and between bursts, notches in a burst. */
+    wheel: {
+        notch: number;
+        animate: number;
+        interval: number;
+        pause: number;
+        burst: number;
+    };
+    /** A flick: the finger's seconds on the glass, the momentum's time constant (iOS's normal deceleration, 0.998 a millisecond), and the rubber band past an edge (its reach, px, and the seconds it springs back in). */
+    flick: {
+        contact: number;
+        decay: number;
+        band: number;
+        spring: number;
+    };
+    /** Typing: characters a second; how uneven the keys are (a share of the interval); how much longer the interval is before a word and after a mark; a pause to think before a word, how likely and how long; a mistake noticed after, and each backspace's seconds. */
+    typing: {
+        cps: number;
+        spread: number;
+        word: number;
+        mark: number;
+        think: {
+            chance: number;
+            seconds: number;
+        };
+        notice: number;
+        backspace: number;
+        seed: number;
+    };
+};
+/** Why a reach's options cannot be used, or undefined. */
+export declare function reachProblem(o: ReachOptions, what: string): string | undefined;
+/** Seconds an aimed movement takes by Fitts' law. */
+export declare function fittsTime(distance: number, size: number, fitts?: {
+    a?: number;
+    b?: number;
+}): number;
+/** One aimed movement from a point to another, between two moments. */
+export interface Movement {
+    /** When it leaves and when it lands. */
+    start: number;
+    end: number;
+    from: Point;
+    /** Where it lands (the target moved by its scatter). */
+    to: Point;
+    /** Where it is at `t`: `from` before, `to` after. */
+    at: (t: number) => Point;
+    /** Its share of the way over its share of the time (past 1 and back), and how far its path bows to the side (a share of the distance, signed). */
+    progress: (u: number) => number;
+    bow: number;
+}
+/**
+ * An aimed movement from `from` to `to` (a target `size` px across),
+ * landing at `end` (moved by its jitter) after `duration` seconds or the
+ * time Fitts' law gives: its shape drawn by the seed and `index`, the
+ * landing point moved by its scatter, the path bowed to one side.
+ */
+export declare function reach(from: Point, to: Point, at: {
+    end: number;
+    duration?: number;
+    size?: number;
+    index?: number;
+}, opts?: ReachOptions): Movement;
+/** One step of a pointer: it lands on `to` by `at`, or presses there at `at`. */
+export interface PointerStep {
+    /** Seconds: when it lands, or with `press`, when it presses. */
+    at: number;
+    to: Point;
+    /** The target's size, px: how far it may land from its centre and how long the move takes. */
+    size?: number;
+    /** It presses there (a click, or a finger's tap). */
+    press?: boolean;
+    /** Seconds the move takes; default by Fitts' law. */
+    duration?: number;
+    /** Seconds it rests before the press, and the press's hold; default `dwell` and `hold`. */
+    dwell?: number;
+    hold?: number;
+}
+export interface PointerOptions extends ReachOptions {
+    /** Where it is before its first step. */
+    from: Point;
+    steps: readonly PointerStep[];
+    dwell?: number;
+    hold?: number;
+}
+export interface PointerState {
+    x: number;
+    y: number;
+    /** Pressed at that moment. */
+    down: boolean;
+}
+export interface Pointer {
+    at: (t: number) => PointerState;
+    /** Each move, in order. */
+    moves: readonly Movement[];
+    /** Each press: when it goes down and comes up, and where. */
+    presses: readonly {
+        down: number;
+        up: number;
+        at: Point;
+    }[];
+}
+/**
+ * A pointer (a mouse's, or a finger hovering a screen) going from place to
+ * place: each step an aimed movement that lands on its target by its
+ * moment, resting `dwell` before a press, which goes down at the step's
+ * moment and up `hold` later (each drawn a little differently); a hand's
+ * tremor on it throughout.
+ */
+export declare function pointer(opts: PointerOptions): Pointer;
+export interface TapOptions {
+    /** When the finger touches, s. */
+    at: number;
+    to: Point;
+    /** Seconds it stays down; default `hold` (a long press: more). */
+    hold?: number;
+    /** How far the finger slides while it is down, px, and the seconds its contact takes to grow. */
+    slide?: number;
+    grow?: number;
+    /** The target's size: how far from its centre it lands. */
+    size?: number;
+    scatter?: number;
+    seed?: number;
+    index?: number;
+}
+export interface Tap {
+    /** When it touches and when it lifts: a phone highlights on the first and acts on the second. */
+    down: number;
+    up: number;
+    at: (t: number) => PointerState & {
+        /** How much of the fingertip touches, 0 to 1. */
+        contact: number;
+    };
+}
+/** A finger's tap: down at its moment, a little off the target's centre, sliding a little, up after its hold. */
+export declare function tap(opts: TapOptions): Tap;
+export interface DragOptions extends ReachOptions {
+    /** Where it is pressed and where it is let go. */
+    from: Point;
+    to: Point;
+    /** When it is pressed, s. */
+    at: number;
+    /** Seconds it moves; default by Fitts' law (a drag's, slower than a move's). */
+    duration?: number;
+    /** The target's size, px (how far from it it lands, and how long it takes). */
+    size?: number;
+    /** Seconds the finger rests after it is pressed and before it is let go. */
+    settle?: number;
+    release?: number;
+    index?: number;
+}
+export interface Drag {
+    /** When it is pressed, starts moving, stops and is let go. */
+    down: number;
+    start: number;
+    end: number;
+    up: number;
+    /** Where it is let go. */
+    to: Point;
+    at: (t: number) => PointerState;
+}
+/**
+ * A drag: pressed at its moment, a rest, then an aimed movement to the
+ * target (a quick start, a longer settle, past it and back), a rest, and
+ * let go; a hand's tremor on it while it is down.
+ */
+export declare function drag(opts: DragOptions): Drag;
+export interface ScrollOptions {
+    /** When it starts, s. */
+    at: number;
+    /** How far, px (negative: back up). */
+    by: number;
+    /** A mouse wheel's notches, or a finger's (or a trackpad's) flick and its momentum. */
+    kind?: "wheel" | "flick";
+    /** The furthest it can go, px (the content's end): a flick past it stretches and springs back. */
+    limit?: number;
+    wheel?: Partial<typeof INPUT_DEFAULTS.wheel>;
+    flick?: Partial<typeof INPUT_DEFAULTS.flick>;
+    seed?: number;
+    index?: number;
+}
+export interface Scroll {
+    /** When it starts and when it has (all but) stopped. */
+    start: number;
+    end: number;
+    /** How far it has scrolled at `t`, px. */
+    at: (t: number) => number;
+}
+/**
+ * A scroll by `by` px from its moment: a wheel's notches in bursts (each
+ * notch animated as a browser animates it, the notches adding up), or a
+ * flick: the finger's push, then momentum that slows as a phone's does,
+ * stretching past `limit` and springing back.
+ */
+export declare function scroll(opts: ScrollOptions): Scroll;
+export interface TypingOptions {
+    /** When the first key goes down, s. */
+    at: number;
+    cps?: number;
+    spread?: number;
+    word?: number;
+    mark?: number;
+    think?: {
+        chance?: number;
+        seconds?: number;
+    };
+    /** Mistakes to make and correct: before the character at `at` (its index in the text), `typed` is typed instead, noticed, deleted and typed right. */
+    mistakes?: readonly {
+        at: number;
+        typed: string;
+    }[];
+    notice?: number;
+    backspace?: number;
+    seed?: number;
+}
+export interface Typed {
+    /** Every key in order: a character, or "Backspace". */
+    keys: readonly {
+        t: number;
+        key: string;
+    }[];
+    /** When each character of the text was typed, the last time. */
+    times: readonly number[];
+    /** When the last key went down. */
+    end: number;
+    /** What the field shows at `t`. */
+    text: (t: number) => string;
+}
+/**
+ * When each key of `text` goes down: intervals that vary (log-normal
+ * round 1 / cps), longer before a word and after a mark, now and then a
+ * pause to think before a word, and the mistakes asked for typed, noticed,
+ * deleted and typed right.
+ */
+export declare function typing(text: string, opts: TypingOptions): Typed;
+//# sourceMappingURL=input.d.ts.map

package/dist/input.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{aimAt as q,aimShape as E,bandNoise as I,unit3 as v}from"@allyhub-next/scenery";export const INPUT_DEFAULTS={reach:{overshoot:.06,peak:.38,vary:.5,fitts:{a:.2,b:.15},scatter:.1,jitter:.02,bow:.06,tremor:{px:.3,frequency:9},seed:1},size:40,dwell:.12,hold:.1,drag:{settle:.08,release:.06,fitts:{a:.25,b:.2},tremor:{px:.8,frequency:8}},tap:{slide:1.2,grow:.03},wheel:{notch:100,animate:.15,interval:.05,pause:.25,burst:4},flick:{contact:.12,decay:.4995,band:800,spring:.12},typing:{cps:9,spread:.35,word:1.5,mark:2,think:{chance:.08,seconds:.35},notice:.3,backspace:.07,seed:1}};function z(t,o=INPUT_DEFAULTS.reach){return{...o,...t,fitts:{...o.fitts,...t?.fitts},tremor:{...o.tremor,...t?.tremor}}}const w=(t,o,r)=>2*v(t,o,r)-1,M=(t,o,r)=>Math.sqrt(-2*Math.log(v(t,o,r)))*Math.cos(2*Math.PI*v(t^625341585,o,r));export function reachProblem(t,o){const r=[["scatter",t.scatter],["jitter",t.jitter],["bow",t.bow],["vary",t.vary],["fitts.a",t.fitts?.a],["fitts.b",t.fitts?.b],["tremor.px",t.tremor?.px],["tremor.frequency",t.tremor?.frequency]];for(const[n,c]of r)if(c!==void 0&&!(Number.isFinite(c)&&c>=0))return`${o}'s ${n} is a number from 0, not ${String(c)}`;if(t.overshoot!==void 0&&!(t.overshoot>=-.5&&t.overshoot<=1))return`${o}'s overshoot is a share from -0.5 to 1, not ${String(t.overshoot)}`;if(t.peak!==void 0&&!(t.peak>=.15&&t.peak<=.6))return`${o}'s peak is a share from 0.15 to 0.6, not ${String(t.peak)}`;if(t.seed!==void 0&&!Number.isInteger(t.seed))return`${o}'s seed is a whole number, not ${String(t.seed)}`}export function fittsTime(t,o,r={}){const n={...INPUT_DEFAULTS.reach.fitts,...r};return n.a+n.b*Math.log2(1+t/Math.max(1,o))}export function reach(t,o,r,n={}){const c=reachProblem(n,"reach");if(c)throw new Error(c);const a=z(n),f=r.index??0,h=r.size??INPUT_DEFAULTS.size,y=[o[0]+a.scatter*h*M(a.seed,f,11),o[1]+a.scatter*h*M(a.seed,f,12)],m=y[0]-t[0],s=y[1]-t[1],u=Math.hypot(m,s),d=Math.max(.05,(r.duration??fittsTime(u,h,a.fitts))*(1+.15*a.vary*w(a.seed,f,13))),e=r.end+a.jitter*M(a.seed,f,14),i=e-d,x=E({overshoot:a.overshoot,peak:a.peak,vary:a.vary,seed:a.seed,index:f}),l=a.bow*w(a.seed,f,15);return{start:i,end:e,from:t,to:y,bow:l,progress:b=>q(x,b),at(b){if(b<=i)return t;if(b>=e)return y;const p=(b-i)/d,k=q(x,p),g=l*Math.sin(Math.PI*Math.min(1,p));return[t[0]+m*k-s*g,t[1]+s*k+m*g]}}}function S(t,o,r){if(r.px<=0)return()=>[0,0];const n={center:r.frequency,spread:r.frequency/5},c=I(t+o*31,101,n),a=I(t+o*31,102,n);return f=>[r.px*c(f),r.px*a(f)]}export function pointer(t){const o=reachProblem(t,"pointer");if(o)throw new Error(o);const r=z(t),n=t.dwell??INPUT_DEFAULTS.dwell,c=t.hold??INPUT_DEFAULTS.hold,a=[],f=[];let h=t.from;for(const[m,s]of t.steps.entries()){const u=s.press?(s.dwell??n)*(1+.4*r.vary*w(r.seed,m,21)):0,d=reach(h,s.to,{end:s.at-u,...s.duration===void 0?{}:{duration:s.duration},size:s.size??INPUT_DEFAULTS.size,index:m},t);if(a.push(d),s.press){const e=(s.hold??c)*(1+.4*r.vary*w(r.seed,m,22));f.push({down:s.at,up:s.at+e,at:d.to})}h=d.to}const y=S(r.seed,0,r.tremor);return{moves:a,presses:f,at(m){let s=t.from;for(const e of a)m>=e.start&&(s=e.at(m));const[u,d]=y(m);return{x:s[0]+u,y:s[1]+d,down:f.some(e=>m>=e.down&&m<e.up)}}}}export function tap(t){const o=t.seed??INPUT_DEFAULTS.reach.seed,r=t.index??0,n=t.size??INPUT_DEFAULTS.size,c=t.scatter??INPUT_DEFAULTS.reach.scatter,a=t.slide??INPUT_DEFAULTS.tap.slide,f=t.grow??INPUT_DEFAULTS.tap.grow,h=(t.hold??INPUT_DEFAULTS.hold)*(1+.3*w(o,r,31)),y=t.to[0]+c*n*M(o,r,32),m=t.to[1]+c*n*M(o,r,33),s=2*Math.PI*v(o,r,34),u=t.at,d=u+h;return{down:u,up:d,at(e){const i=Math.min(1,Math.max(0,(e-u)/h)),x=a*(i*i*(3-2*i)),l=e>=u&&e<d,b=l?Math.min(1,(e-u)/f,(d-e)/f):0;return{x:y+x*Math.cos(s),y:m+x*Math.sin(s),down:l,contact:b}}}}export function drag(t){const o=reachProblem(t,"drag");if(o)throw new Error(o);const r=INPUT_DEFAULTS.drag,n=z(t,{...INPUT_DEFAULTS.reach,fitts:r.fitts,tremor:r.tremor}),c=t.index??0,a=(t.settle??r.settle)*(1+.4*n.vary*w(n.seed,c,41)),f=(t.release??r.release)*(1+.4*n.vary*w(n.seed,c,42)),h=t.size??INPUT_DEFAULTS.size,y=Math.hypot(t.to[0]-t.from[0],t.to[1]-t.from[1]),m=t.duration??fittsTime(y,h,n.fitts),s=reach(t.from,t.to,{end:t.at+a+m,duration:m,size:h,index:c},{...n,jitter:0}),u=S(n.seed,c+1e3,n.tremor),d=s.end+f;return{down:t.at,start:s.start,end:s.end,up:d,to:s.to,at(e){const i=s.at(e),x=e>=t.at&&e<d,l=x?Math.min(1,(e-t.at)/.05,(d-e)/.05):0,[b,p]=u(e);return{x:i[0]+l*b,y:i[1]+l*p,down:x}}}}export function scroll(t){const o=t.seed??INPUT_DEFAULTS.reach.seed,r=t.index??0,n=t.by<0?-1:1;if((t.kind??"flick")==="wheel"){const e={...INPUT_DEFAULTS.wheel,...t.wheel},i=Math.max(1,Math.round(Math.abs(t.by)/e.notch)),x=t.by/i,l=[];let b=t.at;for(let k=0;k<i;k++){l.push(b);const g=(k+1)%Math.max(1,e.burst)===0?e.pause:e.interval;b+=g*(1+.4*w(o,r*997+k,51))}const p=k=>1-(1-k)**3;return{start:t.at,end:(l.at(-1)??t.at)+e.animate,at(k){let g=0;for(const $ of l)k>$&&(g+=x*p(Math.min(1,(k-$)/e.animate)));return g}}}const c={...INPUT_DEFAULTS.flick,...t.flick},a=c.contact*(1+.3*w(o,r,52)),f=Math.abs(t.by)/(a/2+c.decay),h=f*a/2,y=t.at+a,m=e=>{if(e<=t.at)return 0;if(e<=y){const i=(e-t.at)/a;return h*i*i}return h+f*c.decay*(1-Math.exp(-(e-y)/c.decay))},s=t.limit===void 0?1/0:Math.abs(t.limit);let u=1/0;Math.abs(t.by)>s&&(s<=h?u=t.at+a*Math.sqrt(s/h):u=y-c.decay*Math.log(1-(s-h)/(f*c.decay)));const d=e=>(1-1/(e*.55/c.band+1))*c.band;return{start:t.at,end:y+c.decay*5,at(e){const i=m(e);if(i<=s)return n*i;const x=Math.max(0,e-u),l=(1+x/c.spring)*Math.exp(-x/c.spring);return n*(s+d(i-s)*l)}}}const j=t=>t!==void 0&&/[\p{L}\p{N}]/u.test(t);export function typing(t,o){const r=INPUT_DEFAULTS.typing,n={...r,...o,think:{...r.think,...o.think}};if(!(n.cps>0))throw new Error(`typing's cps is above 0, not ${String(n.cps)}`);const c=Array.from(t),a=[],f=[];let h=n.at,y=0;const m=(d,e)=>{const i=1/n.cps,x=n.spread,l=M(n.seed,y,61);let b=i*Math.exp(x*l-x*x/2);return!j(d)&&j(e)&&(b*=n.word,v(n.seed,y,62)<n.think.chance&&(b+=n.think.seconds)),d!==void 0&&/[.,;:!?。，、！？]/u.test(d)&&(b*=n.mark),b},s=(d,e,i)=>{a.length>0&&(h+=i??m(d,e)),a.push({t:h,key:e}),y++};let u;for(const[d,e]of c.entries()){for(const i of n.mistakes??[]){if(i.at!==d)continue;const x=Array.from(i.typed);for(const l of x)s(u,l),u=l;h+=n.notice*(1+.3*w(n.seed,y,63));for(let l=0;l<x.length;l++)s(u,"Backspace",l===0?0:n.backspace);u=c[d-1]}s(u,e),f[d]=h,u=e}return{keys:a,times:f,end:h,text(d){let e=[];for(const i of a){if(i.t>d)break;i.key==="Backspace"?e=e.slice(0,-1):e.push(i.key)}return e.join("")}}}

package/dist/media.d.ts

@@ -1,9 +1,6 @@
-import { type MediaInfo } from "@allyhub/engine/stage";
-type Resolver = (path: string) => string;
-/** Installed by the runtime before a piece module loads. */
-export declare function setMediaResolver(resolve: Resolver | undefined): void;
+import { type MediaInfo } from "@allyhub-next/video-core";
 /** A media value. Used by the code the build generates for media imports. */
-export declare function media(info: Omit<MediaInfo, "url">): MediaInfo;
+export declare function media(info: MediaInfo): MediaInfo;
+/** Whether a value is a media value (an import, or ctx.asset's). */
 export declare function isMedia(v: unknown): v is MediaInfo;
-export {};
 //# sourceMappingURL=media.d.ts.map

package/dist/media.js

@@ -1,27 +1,2 @@
-import { asUrlString, MEDIA_BRAND, MEDIA_RESOLVER, } from "@allyhub/engine/stage";
-// Media imports (`import shot from "./shot.png"`) compile to media(...) with
-// what the build measured. The URL is
-// not known when the code is built: the stage serves the bytes wherever it
-// likes, so `url` asks the runtime, which also records the read. Turned
-// into a string, a media value is its url (`img.src = logo`).
-const RESOLVER = Symbol.for(MEDIA_RESOLVER);
-/** Installed by the runtime before a piece module loads. */
-export function setMediaResolver(resolve) {
-    globalThis[RESOLVER] = resolve;
-}
-/** A media value. Used by the code the build generates for media imports. */
-export function media(info) {
-    const out = { [MEDIA_BRAND]: true, ...info };
-    Object.defineProperty(out, "url", {
-        enumerable: true,
-        get() {
-            const resolve = globalThis[RESOLVER];
-            return resolve ? resolve(info.path) : info.path;
-        },
-    });
-    return asUrlString(out);
-}
-export function isMedia(v) {
-    return typeof v === "object" && v !== null && MEDIA_BRAND in v;
-}
-//# sourceMappingURL=media.js.map
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{asUrlString as e,MEDIA_BRAND as t}from"@allyhub-next/video-core";export function media(r){return e({[t]:!0,...r})}export function isMedia(r){return typeof r=="object"&&r!==null&&t in r}

package/dist/messages.d.ts

@@ -1,4 +1,4 @@
-import type { MessageHint } from "@allyhub/engine/stage";
+import type { MessageHint } from "@allyhub-next/video-core";
 /**
  * Every message key of the default language → the inputs s.with() takes
  * for it ({name} variables, plural counts). Filled by the generated types.
@@ -15,7 +15,8 @@ type Typed = [keyof Messages] extends [never] ? false : true;
 /** A message key: the generated keys, or any string before they exist. */
 export type MessageKey = Typed extends true ? keyof Messages & string : string;
 /** A prefix s.list() reads: the generated prefixes, or any string. */
-export type ListPrefix = [keyof MessageLists] extends [never] ? string : keyof MessageLists & string;
+export type ListPrefix = [keyof MessageLists] extends [never] ? string : // eslint-disable-next-line @typescript-eslint/no-redundant-type-constituents -- the prefixes come by declaration merging
+keyof MessageLists & string;
 /** The inputs a key takes in s.with(). */
 export type MessageInputs<K extends string> = K extends keyof Messages ? Messages[K] : Readonly<Record<string, string | number>>;
 /** One item of the list under a prefix. */

package/dist/messages.js

@@ -1,2 +1,2 @@
-export {};
-//# sourceMappingURL=messages.js.map
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{};

package/dist/module.d.ts

@@ -0,0 +1,24 @@
+import * as free from "./free.js";
+import { type FootageFn, type PartFn, type TakeFn } from "./parts.js";
+import { type SlidesFn, type VideoFn } from "./piece.js";
+import { type SdkModule } from "./written.js";
+export type { SdkModule } from "./written.js";
+/** The functions that name files, and so are made for a module. */
+export declare const BOUND: readonly ["video", "slides", "part", "take", "footage"];
+/** The functions sdkFor makes for a module. */
+export interface BoundSdk {
+    video: VideoFn;
+    slides: SlidesFn;
+    part: PartFn;
+    take: TakeFn;
+    footage: FootageFn;
+}
+/** The whole authoring API, bound to one module. */
+export type Sdk = typeof free & BoundSdk;
+/**
+ * The authoring API for the module `module.file` (a project path; "" the
+ * project's root): the paths its parts, takes, footage and pieces name
+ * are from that module's folder.
+ */
+export declare function sdkFor(module: SdkModule): Sdk;
+//# sourceMappingURL=module.d.ts.map

package/dist/module.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import*as e from"./free.js";import{footageFor as i,partFor as a,takeFor as s}from"./parts.js";import{slidesFor as f,videoFor as n}from"./piece.js";import{writtenIn as p}from"./written.js";export const BOUND=["video","slides","part","take","footage"];export function sdkFor(r){const o=p(r),t={video:n(o),slides:f(o),part:a(o),take:s(o),footage:i(o)};return{...e,...t}}

package/dist/noise.js

@@ -1,233 +1,2 @@
-// Simplex noise in 2, 3 and 4 dimensions, seeded: the same seed gives the
-// same values on every frame and every run, so a render stays deterministic.
-//
-// The algorithm follows Stefan Gustavson's public-domain reference
-// ("Simplex noise demystified", 2005; SimplexNoise.java, 2012), as the
-// simplex-noise package does (https://github.com/jwagner/simplex-noise.js,
-// Copyright (c) 2022 Jonas Wagner, MIT). The API, a seed then coordinates,
-// is after Remotion's @remotion/noise
-// (https://github.com/remotion-dev/remotion/tree/main/packages/noise, MIT),
-// which wraps simplex-noise. Written again here; see NOTICE.
-import { rand } from "./anim.js";
-const F2 = 0.5 * (Math.sqrt(3) - 1);
-const G2 = (3 - Math.sqrt(3)) / 6;
-const F3 = 1 / 3;
-const G3 = 1 / 6;
-const F4 = (Math.sqrt(5) - 1) / 4;
-const G4 = (5 - Math.sqrt(5)) / 20;
-// The 12 midpoints of a cube's edges; 2D uses their x and y.
-const GRAD3 = new Float64Array([
-    1, 1, 0, -1, 1, 0, 1, -1, 0, -1, -1, 0, 1, 0, 1, -1, 0, 1, 1, 0, -1, -1, 0,
-    -1, 0, 1, 1, 0, -1, 1, 0, 1, -1, 0, -1, -1,
-]);
-// The 32 midpoints of a tesseract's edges.
-const GRAD4 = new Float64Array([
-    0, 1, 1, 1, 0, 1, 1, -1, 0, 1, -1, 1, 0, 1, -1, -1, 0, -1, 1, 1, 0, -1, 1, -1,
-    0, -1, -1, 1, 0, -1, -1, -1, 1, 0, 1, 1, 1, 0, 1, -1, 1, 0, -1, 1, 1, 0, -1,
-    -1, -1, 0, 1, 1, -1, 0, 1, -1, -1, 0, -1, 1, -1, 0, -1, -1, 1, 1, 0, 1, 1, 1,
-    0, -1, 1, -1, 0, 1, 1, -1, 0, -1, -1, 1, 0, 1, -1, 1, 0, -1, -1, -1, 0, 1, -1,
-    -1, 0, -1, 1, 1, 1, 0, 1, 1, -1, 0, 1, -1, 1, 0, 1, -1, -1, 0, -1, 1, 1, 0,
-    -1, 1, -1, 0, -1, -1, 1, 0, -1, -1, -1, 0,
-]);
-const TABLES = new Map();
-const TABLE_CACHE = 32;
-function tableOf(seed) {
-    const key = String(seed);
-    const found = TABLES.get(key);
-    if (found)
-        return found;
-    const next = rand(seed);
-    const p = new Uint8Array(256);
-    for (let i = 0; i < 256; i++)
-        p[i] = i;
-    // Fisher–Yates, driven by the seed.
-    for (let i = 255; i > 0; i--) {
-        const r = Math.floor(next() * (i + 1));
-        const tmp = p[i] ?? 0;
-        p[i] = p[r] ?? 0;
-        p[r] = tmp;
-    }
-    const perm = new Uint8Array(512);
-    const mod12 = new Uint8Array(512);
-    for (let i = 0; i < 512; i++) {
-        perm[i] = p[i & 255] ?? 0;
-        mod12[i] = (perm[i] ?? 0) % 12;
-    }
-    const table = { perm, mod12 };
-    if (TABLES.size >= TABLE_CACHE) {
-        const oldest = TABLES.keys().next();
-        if (!oldest.done)
-            TABLES.delete(oldest.value);
-    }
-    TABLES.set(key, table);
-    return table;
-}
-// Indices below are always inside the 512-entry tables; `?? 0` only
-// satisfies the type checker.
-/**
- * 2D simplex noise at (x, y) for a seed: a smooth value in [-1, 1] that
- * changes over about one unit. Scale the coordinates to change its speed
- * (`noise2D("cam", t * 0.5, 0)` drifts slowly with time t).
- */
-export function noise2D(seed, x, y) {
-    const { perm, mod12 } = tableOf(seed);
-    const s = (x + y) * F2;
-    const i = Math.floor(x + s);
-    const j = Math.floor(y + s);
-    const t = (i + j) * G2;
-    const x0 = x - (i - t);
-    const y0 = y - (j - t);
-    const i1 = x0 > y0 ? 1 : 0;
-    const j1 = 1 - i1;
-    const x1 = x0 - i1 + G2;
-    const y1 = y0 - j1 + G2;
-    const x2 = x0 - 1 + 2 * G2;
-    const y2 = y0 - 1 + 2 * G2;
-    const ii = i & 255;
-    const jj = j & 255;
-    let n = 0;
-    let t0 = 0.5 - x0 * x0 - y0 * y0;
-    if (t0 > 0) {
-        const g = (mod12[ii + (perm[jj] ?? 0)] ?? 0) * 3;
-        t0 *= t0;
-        n += t0 * t0 * ((GRAD3[g] ?? 0) * x0 + (GRAD3[g + 1] ?? 0) * y0);
-    }
-    let t1 = 0.5 - x1 * x1 - y1 * y1;
-    if (t1 > 0) {
-        const g = (mod12[ii + i1 + (perm[jj + j1] ?? 0)] ?? 0) * 3;
-        t1 *= t1;
-        n += t1 * t1 * ((GRAD3[g] ?? 0) * x1 + (GRAD3[g + 1] ?? 0) * y1);
-    }
-    let t2 = 0.5 - x2 * x2 - y2 * y2;
-    if (t2 > 0) {
-        const g = (mod12[ii + 1 + (perm[jj + 1] ?? 0)] ?? 0) * 3;
-        t2 *= t2;
-        n += t2 * t2 * ((GRAD3[g] ?? 0) * x2 + (GRAD3[g + 1] ?? 0) * y2);
-    }
-    return 70 * n;
-}
-function corner3(g, x, y, z) {
-    let t = 0.6 - x * x - y * y - z * z;
-    if (t <= 0)
-        return 0;
-    const k = g * 3;
-    t *= t;
-    return (t *
-        t *
-        ((GRAD3[k] ?? 0) * x + (GRAD3[k + 1] ?? 0) * y + (GRAD3[k + 2] ?? 0) * z));
-}
-/** 3D simplex noise for a seed, in [-1, 1]: a 2D field that moves smoothly with z. */
-export function noise3D(seed, x, y, z) {
-    const { perm, mod12 } = tableOf(seed);
-    const s = (x + y + z) * F3;
-    const i = Math.floor(x + s);
-    const j = Math.floor(y + s);
-    const k = Math.floor(z + s);
-    const t = (i + j + k) * G3;
-    const x0 = x - (i - t);
-    const y0 = y - (j - t);
-    const z0 = z - (k - t);
-    let i1, j1, k1, i2, j2, k2;
-    if (x0 >= y0) {
-        if (y0 >= z0)
-            [i1, j1, k1, i2, j2, k2] = [1, 0, 0, 1, 1, 0];
-        else if (x0 >= z0)
-            [i1, j1, k1, i2, j2, k2] = [1, 0, 0, 1, 0, 1];
-        else
-            [i1, j1, k1, i2, j2, k2] = [0, 0, 1, 1, 0, 1];
-    }
-    else if (y0 < z0)
-        [i1, j1, k1, i2, j2, k2] = [0, 0, 1, 0, 1, 1];
-    else if (x0 < z0)
-        [i1, j1, k1, i2, j2, k2] = [0, 1, 0, 0, 1, 1];
-    else
-        [i1, j1, k1, i2, j2, k2] = [0, 1, 0, 1, 1, 0];
-    const ii = i & 255;
-    const jj = j & 255;
-    const kk = k & 255;
-    const g = (a, b, c) => mod12[ii + a + (perm[jj + b + (perm[kk + c] ?? 0)] ?? 0)] ?? 0;
-    const n = corner3(g(0, 0, 0), x0, y0, z0) +
-        corner3(g(i1, j1, k1), x0 - i1 + G3, y0 - j1 + G3, z0 - k1 + G3) +
-        corner3(g(i2, j2, k2), x0 - i2 + 2 * G3, y0 - j2 + 2 * G3, z0 - k2 + 2 * G3) +
-        corner3(g(1, 1, 1), x0 - 1 + 3 * G3, y0 - 1 + 3 * G3, z0 - 1 + 3 * G3);
-    return 32 * n;
-}
-function corner4(g, x, y, z, w) {
-    let t = 0.6 - x * x - y * y - z * z - w * w;
-    if (t <= 0)
-        return 0;
-    const k = g * 4;
-    t *= t;
-    return (t *
-        t *
-        ((GRAD4[k] ?? 0) * x +
-            (GRAD4[k + 1] ?? 0) * y +
-            (GRAD4[k + 2] ?? 0) * z +
-            (GRAD4[k + 3] ?? 0) * w));
-}
-/**
- * 4D simplex noise for a seed, in [-1, 1]. Two of its axes on a circle make
- * a loop: `noise4D(seed, x, y, cos(a) * r, sin(a) * r)` comes back to where
- * it started when `a` turns once.
- */
-export function noise4D(seed, x, y, z, w) {
-    const { perm } = tableOf(seed);
-    const s = (x + y + z + w) * F4;
-    const i = Math.floor(x + s);
-    const j = Math.floor(y + s);
-    const k = Math.floor(z + s);
-    const l = Math.floor(w + s);
-    const t = (i + j + k + l) * G4;
-    const x0 = x - (i - t);
-    const y0 = y - (j - t);
-    const z0 = z - (k - t);
-    const w0 = w - (l - t);
-    // Which simplex: each coordinate's rank among the four.
-    let rx = 0;
-    let ry = 0;
-    let rz = 0;
-    let rw = 0;
-    if (x0 > y0)
-        rx++;
-    else
-        ry++;
-    if (x0 > z0)
-        rx++;
-    else
-        rz++;
-    if (x0 > w0)
-        rx++;
-    else
-        rw++;
-    if (y0 > z0)
-        ry++;
-    else
-        rz++;
-    if (y0 > w0)
-        ry++;
-    else
-        rw++;
-    if (z0 > w0)
-        rz++;
-    else
-        rw++;
-    const ii = i & 255;
-    const jj = j & 255;
-    const kk = k & 255;
-    const ll = l & 255;
-    const g = (a, b, c, d) => (perm[ii + a + (perm[jj + b + (perm[kk + c + (perm[ll + d] ?? 0)] ?? 0)] ?? 0)] ?? 0) % 32;
-    let n = corner4(g(0, 0, 0, 0), x0, y0, z0, w0);
-    for (let step = 1; step <= 3; step++) {
-        const rank = 4 - step;
-        const a = rx >= rank ? 1 : 0;
-        const b = ry >= rank ? 1 : 0;
-        const c = rz >= rank ? 1 : 0;
-        const d = rw >= rank ? 1 : 0;
-        const o = step * G4;
-        n += corner4(g(a, b, c, d), x0 - a + o, y0 - b + o, z0 - c + o, w0 - d + o);
-    }
-    const o = 4 * G4;
-    n += corner4(g(1, 1, 1, 1), x0 - 1 + o, y0 - 1 + o, z0 - 1 + o, w0 - 1 + o);
-    return 27 * n;
-}
-//# sourceMappingURL=noise.js.map
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{rand as K}from"./anim.js";const N=.5*(Math.sqrt(3)-1),B=(3-Math.sqrt(3))/6,P=1/3,D=1/6,Q=(Math.sqrt(5)-1)/4,H=(5-Math.sqrt(5))/20,w=new Float64Array([1,1,0,-1,1,0,1,-1,0,-1,-1,0,1,0,1,-1,0,1,1,0,-1,-1,0,-1,0,1,1,0,-1,1,0,1,-1,0,-1,-1]),v=new Float64Array([0,1,1,1,0,1,1,-1,0,1,-1,1,0,1,-1,-1,0,-1,1,1,0,-1,1,-1,0,-1,-1,1,0,-1,-1,-1,1,0,1,1,1,0,1,-1,1,0,-1,1,1,0,-1,-1,-1,0,1,1,-1,0,1,-1,-1,0,-1,1,-1,0,-1,-1,1,1,0,1,1,1,0,-1,1,-1,0,1,1,-1,0,-1,-1,1,0,1,-1,1,0,-1,-1,-1,0,1,-1,-1,0,-1,1,1,1,0,1,1,-1,0,1,-1,1,0,1,-1,-1,0,-1,1,1,0,-1,1,-1,0,-1,-1,1,0,-1,-1,-1,0]),C=new Map,V=32;function O(g){const s=String(g),c=C.get(s);if(c)return c;const e=K(g),o=new Uint8Array(256);for(let t=0;t<256;t++)o[t]=t;for(let t=255;t>0;t--){const u=Math.floor(e()*(t+1)),p=o[t]??0;o[t]=o[u]??0,o[u]=p}const n=new Uint8Array(512),r=new Uint8Array(512);for(let t=0;t<512;t++)n[t]=o[t&255]??0,r[t]=(n[t]??0)%12;const d={perm:n,mod12:r};if(C.size>=V){const t=C.keys().next();t.done||C.delete(t.value)}return C.set(s,d),d}export function noise2D(g,s,c){const{perm:e,mod12:o}=O(g),n=(s+c)*N,r=Math.floor(s+n),d=Math.floor(c+n),t=(r+d)*B,u=s-(r-t),p=c-(d-t),m=u>p?1:0,M=1-m,i=u-m+B,l=p-M+B,f=u-1+2*B,h=p-1+2*B,k=r&255,j=d&255;let a=0,F=.5-u*u-p*p;if(F>0){const A=(o[k+(e[j]??0)]??0)*3;F*=F,a+=F*F*((w[A]??0)*u+(w[A+1]??0)*p)}let G=.5-i*i-l*l;if(G>0){const A=(o[k+m+(e[j+M]??0)]??0)*3;G*=G,a+=G*G*((w[A]??0)*i+(w[A+1]??0)*l)}let q=.5-f*f-h*h;if(q>0){const A=(o[k+1+(e[j+1]??0)]??0)*3;q*=q,a+=q*q*((w[A]??0)*f+(w[A+1]??0)*h)}return 70*a}function x(g,s,c,e){let o=.6-s*s-c*c-e*e;if(o<=0)return 0;const n=g*3;return o*=o,o*o*((w[n]??0)*s+(w[n+1]??0)*c+(w[n+2]??0)*e)}export function noise3D(g,s,c,e){const{perm:o,mod12:n}=O(g),r=(s+c+e)*P,d=Math.floor(s+r),t=Math.floor(c+r),u=Math.floor(e+r),p=(d+t+u)*D,m=s-(d-p),M=c-(t-p),i=e-(u-p);let l,f,h,k,j,a;m>=M?M>=i?[l,f,h,k,j,a]=[1,0,0,1,1,0]:m>=i?[l,f,h,k,j,a]=[1,0,0,1,0,1]:[l,f,h,k,j,a]=[0,0,1,1,0,1]:M<i?[l,f,h,k,j,a]=[0,0,1,0,1,1]:m<i?[l,f,h,k,j,a]=[0,1,0,0,1,1]:[l,f,h,k,j,a]=[0,1,0,1,1,0];const F=d&255,G=t&255,q=u&255,A=(U,y,b)=>n[F+U+(o[G+y+(o[q+b]??0)]??0)]??0;return 32*(x(A(0,0,0),m,M,i)+x(A(l,f,h),m-l+D,M-f+D,i-h+D)+x(A(k,j,a),m-k+2*D,M-j+2*D,i-a+2*D)+x(A(1,1,1),m-1+3*D,M-1+3*D,i-1+3*D))}function _(g,s,c,e,o){let n=.6-s*s-c*c-e*e-o*o;if(n<=0)return 0;const r=g*4;return n*=n,n*n*((v[r]??0)*s+(v[r+1]??0)*c+(v[r+2]??0)*e+(v[r+3]??0)*o)}export function noise4D(g,s,c,e,o){const{perm:n}=O(g),r=(s+c+e+o)*Q,d=Math.floor(s+r),t=Math.floor(c+r),u=Math.floor(e+r),p=Math.floor(o+r),m=(d+t+u+p)*H,M=s-(d-m),i=c-(t-m),l=e-(u-m),f=o-(p-m);let h=0,k=0,j=0,a=0;M>i?h++:k++,M>l?h++:j++,M>f?h++:a++,i>l?k++:j++,i>f?k++:a++,l>f?j++:a++;const F=d&255,G=t&255,q=u&255,A=p&255,L=(b,E,R,S)=>(n[F+b+(n[G+E+(n[q+R+(n[A+S]??0)]??0)]??0)]??0)%32;let U=_(L(0,0,0,0),M,i,l,f);for(let b=1;b<=3;b++){const E=4-b,R=h>=E?1:0,S=k>=E?1:0,I=j>=E?1:0,J=a>=E?1:0,T=b*H;U+=_(L(R,S,I,J),M-R+T,i-S+T,l-I+T,f-J+T)}const y=4*H;return U+=_(L(1,1,1,1),M-1+y,i-1+y,l-1+y,f-1+y),27*U}