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

package/node_modules/@allyhub-next/scenery/dist/handheld.d.ts

@@ -0,0 +1,184 @@
+import { type CameraState } from "./camera.js";
+import { type Move, type MoveTime } from "./move.js";
+/** A turn about the camera's own axes, degrees: yaw (positive turns left), pitch (up) and roll (counterclockwise). */
+export type Turn = readonly [yaw: number, pitch: number, roll?: number];
+/** A move along the camera's own axes, m: right, up and forward. */
+export type Shift = readonly [right: number, up: number, forward?: number];
+/** A reframe: the hand going to another framing. */
+export interface Reframe {
+    /** When it starts: seconds of scenery time or a word or anchor reference. */
+    at: MoveTime;
+    /** The framing it goes to (a camera, or a move), held until the shot ends. */
+    to?: CameraState | Move;
+    /** Or a turn of the camera about its own axes from where it is. */
+    turn?: Turn;
+    /** And a move along them. */
+    shift?: Shift;
+    /** Seconds it takes; default `reframe.duration`. */
+    duration?: number;
+    /** How far past the framing it goes before it comes back, a share of the move; default `reframe.overshoot`. */
+    overshoot?: number;
+}
+/** A jolt: the hand knocked, the view thrown and ringing back. */
+export interface Jolt {
+    at: MoveTime;
+    /** How far it throws the view at most; default `jolt.turn`. */
+    turn?: Turn;
+}
+export interface AutofocusOptions {
+    /** Where it rests, a share of the distance to what it focuses on (negative: in front of it). */
+    miss?: number;
+    /** How far it hunts after a cut, at most, as a share of the distance. */
+    hunt?: number;
+    /** Its swings a second as it hunts, and the seconds they take to die away. */
+    rate?: number;
+    decay?: number;
+    /** The share of `hunt` a cut, a reframe and a jolt each set off. */
+    after?: {
+        cut?: number;
+        reframe?: number;
+        jolt?: number;
+    };
+}
+export interface AutoExposureOptions {
+    /** Seconds before it follows a reframe to a framing of another ev, and the seconds it takes to get there (with no overshoot). */
+    delay?: number;
+    settle?: number;
+    /** Stops it is off at a cut, at most (from half that, either way), settling over `settle`. */
+    cut?: number;
+    /** Its breathing as it meters: the standard deviation in stops, and the seconds of its slow swing. */
+    breathe?: number;
+    period?: number;
+}
+export interface HandheldOptions {
+    /** How far the hand sways the camera's view: each of yaw and pitch's standard deviation, degrees. */
+    angle?: number;
+    /** Roll's standard deviation over the angle's (the sway's, the drift's and the tremor's). */
+    roll?: number;
+    /** How far the hand moves the camera: each axis's standard deviation, m. */
+    shift?: number;
+    /** How fast it sways: the middle of its spectrum, Hz (from a third of it to three times it, falling as 1/f²). */
+    sway?: number;
+    /**
+     * The tremor over the sway: yaw and pitch's standard deviation,
+     * degrees; the middle of its band and how far it spreads, Hz; how much
+     * its middle differs from shot to shot (a share); how much its strength
+     * swells and fades (0: steady), over about `period` seconds.
+     */
+    tremor?: {
+        angle?: number;
+        frequency?: number;
+        spread?: number;
+        vary?: number;
+        swell?: number;
+        period?: number;
+    };
+    /** The framing's slow drift: yaw and pitch's standard deviation, degrees; each axis's, m; the seconds of its swing. */
+    drift?: {
+        angle?: number;
+        shift?: number;
+        period?: number;
+    };
+    /**
+     * A phone's stabiliser: the share of the turning it takes out, from
+     * none at 0 Hz to `strength` well above `cutoff` Hz (the sway's slow
+     * part passes, the tremor and a jolt's ringing mostly go). Absent: none;
+     * `{}` takes STABILIZER_DEFAULTS.
+     */
+    stabilizer?: {
+        strength?: number;
+        cutoff?: number;
+    };
+    /** Reframes the hand makes, each in the shot it starts in. */
+    reframes?: readonly Reframe[];
+    /** How a reframe moves when it does not say: its seconds, its overshoot, when its speed peaks (a share of the move), how far its path bows (a share), and how much a seed changes each from reframe to reframe. */
+    reframe?: {
+        duration?: number;
+        overshoot?: number;
+        peak?: number;
+        bow?: number;
+        vary?: number;
+    };
+    /** Jolts, each in the shot it is in. */
+    jolts?: readonly Jolt[];
+    /** How a jolt throws the view when it does not say, how fast it rings (Hz) and how soon it is gone (s), and how much a seed changes each. */
+    jolt?: {
+        turn?: Turn;
+        ring?: number;
+        decay?: number;
+        vary?: number;
+    };
+    /** The autofocus hunting, when the camera has an aperture: absent, none; `{}` takes AUTOFOCUS_DEFAULTS. */
+    autofocus?: AutofocusOptions;
+    /** The auto-exposure, when the camera has an ev: absent, none; `{}` takes AUTO_EXPOSURE_DEFAULTS. */
+    exposure?: AutoExposureOptions;
+    /** Another seed is another hand. */
+    seed?: number;
+}
+export declare const HANDHELD_DEFAULTS: {
+    angle: number;
+    roll: number;
+    shift: number;
+    sway: number;
+    tremor: {
+        angle: number;
+        frequency: number;
+        spread: number;
+        vary: number;
+        swell: number;
+        period: number;
+    };
+    drift: {
+        angle: number;
+        shift: number;
+        period: number;
+    };
+    reframe: {
+        duration: number;
+        overshoot: number;
+        peak: number;
+        bow: number;
+        vary: number;
+    };
+    jolt: {
+        turn: Turn;
+        ring: number;
+        decay: number;
+        vary: number;
+    };
+    seed: number;
+};
+export declare const STABILIZER_DEFAULTS: {
+    strength: number;
+    cutoff: number;
+};
+export declare const AUTOFOCUS_DEFAULTS: {
+    miss: number;
+    hunt: number;
+    rate: number;
+    decay: number;
+    after: {
+        cut: number;
+        reframe: number;
+        jolt: number;
+    };
+};
+export declare const AUTO_EXPOSURE_DEFAULTS: {
+    delay: number;
+    settle: number;
+    cut: number;
+    breathe: number;
+    period: number;
+};
+/** Why handheld's options cannot be used, or undefined. */
+export declare function handheldProblem(o: HandheldOptions): string | undefined;
+/**
+ * A camera, or a move, held in a hand: each moment's camera turned and
+ * moved about its own axes by the hand, reframed and jolted where asked,
+ * its focus hunting and its exposure following where asked. Its lens,
+ * aperture and focus are kept, and the cuts of a camera made by shots()
+ * (each shot a new hand); a camera aimed at a target is given as the
+ * direction it looked.
+ */
+export declare function handheld(camera: CameraState | Move, opts?: HandheldOptions): Move;
+//# sourceMappingURL=handheld.d.ts.map

package/node_modules/@allyhub-next/scenery/dist/handheld.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{aimAt as Fe,aimShape as $e}from"./aim.js";import{CAMERA_DEFAULTS as ke,resolveCamera as X}from"./camera.js";import{cutsOf as Ue,mixCameras as De,momentOf as re,stateOf as ne,withCuts as Ie}from"./move.js";import{bandNoise as Y,hash3 as Le,powerNoise as Te,swellOf as Ne,unit3 as _e}from"./noise.js";import{add as Z,cross as J,DEG as C,dot as I,normalize as oe,rotate as Q,scale as N,sub as Pe}from"./vec.js";export const HANDHELD_DEFAULTS={angle:.25,roll:.5,shift:.003,sway:.7,tremor:{angle:.02,frequency:9,spread:1.5,vary:.12,swell:.3,period:3},drift:{angle:.15,shift:.002,period:8},reframe:{duration:.5,overshoot:.1,peak:.36,bow:.1,vary:.5},jolt:{turn:[.15,-.35,.1],ring:5,decay:.09,vary:.3},seed:1};const Ce=2;export const STABILIZER_DEFAULTS={strength:.8,cutoff:1.5},AUTOFOCUS_DEFAULTS={miss:-.02,hunt:.12,rate:2.3,decay:.3,after:{cut:1,reframe:.7,jolt:.3}},AUTO_EXPOSURE_DEFAULTS={delay:.15,settle:.7,cut:.25,breathe:.03,period:3};export function handheldProblem(t){const o=[["angle",t.angle],["roll",t.roll],["shift",t.shift],["sway",t.sway],["tremor.angle",t.tremor?.angle],["tremor.frequency",t.tremor?.frequency],["tremor.spread",t.tremor?.spread],["tremor.vary",t.tremor?.vary],["tremor.swell",t.tremor?.swell],["drift.angle",t.drift?.angle],["drift.shift",t.drift?.shift],["stabilizer.strength",t.stabilizer?.strength],["stabilizer.cutoff",t.stabilizer?.cutoff],["reframe.bow",t.reframe?.bow],["reframe.vary",t.reframe?.vary],["jolt.vary",t.jolt?.vary],["autofocus.hunt",t.autofocus?.hunt],["autofocus.rate",t.autofocus?.rate],["exposure.cut",t.exposure?.cut],["exposure.breathe",t.exposure?.breathe],["exposure.delay",t.exposure?.delay]];for(const[i,e]of o)if(e!==void 0&&!(Number.isFinite(e)&&e>=0))return`handheld()'s ${i} is a number from 0, not ${String(e)}`;const y=[["tremor.period",t.tremor?.period],["drift.period",t.drift?.period],["reframe.duration",t.reframe?.duration],["jolt.ring",t.jolt?.ring],["jolt.decay",t.jolt?.decay],["autofocus.decay",t.autofocus?.decay],["exposure.settle",t.exposure?.settle],["exposure.period",t.exposure?.period],...(t.reframes??[]).map((i,e)=>[`reframes[${String(e)}].duration`,i.duration])];for(const[i,e]of y)if(e!==void 0&&!(Number.isFinite(e)&&e>0))return`handheld()'s ${i} is a number above 0, not ${String(e)}`;if(t.stabilizer?.strength!==void 0&&t.stabilizer.strength>1)return`handheld()'s stabilizer.strength is a share from 0 to 1, not ${String(t.stabilizer.strength)}`;for(const[i,e]of(t.reframes??[]).entries()){if(e.to===void 0&&e.turn===void 0&&e.shift===void 0)return`handheld()'s reframes[${String(i)}] has nowhere to go: give it a framing (to), a turn or a shift`;if(e.overshoot!==void 0&&!(Number.isFinite(e.overshoot)&&e.overshoot>=-.5&&e.overshoot<=1))return`handheld()'s reframes[${String(i)}].overshoot is a share from -0.5 to 1, not ${String(e.overshoot)}`}if(t.seed!==void 0&&!Number.isInteger(t.seed))return`handheld()'s seed is a whole number, not ${String(t.seed)}`}const qe=t=>{const o=Math.min(1,Math.max(0,t));return o*o*(3-2*o)},$=(t,o,y)=>2*_e(t,o,y)-1;function Re(t,o,y){if(t<=0)return 0;const i=2*Math.PI*o,e=Math.atan(i*y)/i,D=Math.exp(-e/y)*Math.sin(i*e);return Math.exp(-t/y)*Math.sin(i*t)/D}export function handheld(t,o={}){const y=handheldProblem(o);if(y)throw new Error(y);const i=HANDHELD_DEFAULTS,e={angle:o.angle??i.angle,roll:o.roll??i.roll,shift:o.shift??i.shift,sway:o.sway??i.sway,tremor:{...i.tremor,...o.tremor},drift:{...i.drift,...o.drift},reframe:{...i.reframe,...o.reframe},jolt:{...i.jolt,...o.jolt},seed:o.seed??i.seed},D=o.stabilizer?{...STABILIZER_DEFAULTS,...o.stabilizer}:void 0,M=o.autofocus?{...AUTOFOCUS_DEFAULTS,...o.autofocus,after:{...AUTOFOCUS_DEFAULTS.after,...o.autofocus.after}}:void 0,x=o.exposure?{...AUTO_EXPOSURE_DEFAULTS,...o.exposure}:void 0,_=s=>D?1-D.strength*s*s/(s*s+D.cutoff*D.cutoff):1,j=e.seed*7919,V=new Map,se=s=>{const m=V.get(s);if(m)return m;const l=Le(j,s,1),u={low:e.sway/3,high:e.sway*3,alpha:Ce},O=[0,1,2,3,4,5].map(h=>Te(l,h,u,h<3?_:()=>1)),f=e.tremor.frequency*(1+e.tremor.vary*$(l,7,0)),c=_(f),w=[10,11,12].map(h=>{const g=Y(l,h,{center:f,spread:e.tremor.spread});return F=>c*g(F)}),n={sway:O,tremor:w,swell:Ne(l,13,e.tremor.swell,e.tremor.period),drift:[20,21,22,23,24,25].map(h=>Y(l,h,{center:0,spread:1/e.drift.period})),breathe:x?Y(l,30,{center:0,spread:1/x.period}):()=>0};return V.set(s,n),n},ee=new WeakMap;let q;const ae=s=>{const m=s?.time;if(m){const f=ee.get(m);if(f)return f}else if(q)return q;const l=Ue(t,s),u=f=>l.filter(c=>c<=f).length,O={cuts:l,reframes:(o.reframes??[]).map((f,c)=>{const w=re(s,f.at,"A reframe's at"),n=e.reframe.vary;return{at:w,shot:u(w),spec:f,shape:$e({overshoot:f.overshoot??e.reframe.overshoot,peak:e.reframe.peak,vary:n,seed:j,index:c}),duration:(f.duration??e.reframe.duration)*(1+.25*n*$(j,c,40)),bow:e.reframe.bow*$(j,c,41),index:c}}).sort((f,c)=>f.at-c.at),jolts:(o.jolts??[]).map((f,c)=>{const w=re(s,f.at,"A jolt's at"),n=e.jolt.vary,h=f.turn??e.jolt.turn,g=F=>1+n*$(j,c,50+F);return{at:w,shot:u(w),turn:[h[0]*g(0),h[1]*g(1),(h[2]??0)*g(2)],ring:e.jolt.ring*g(3),decay:e.jolt.decay*g(4),index:c}})};return m?ee.set(m,O):q=O,O};return Ie(t,(s,m)=>{const l=ae(m),u=l.cuts.filter(r=>r<=s).length,O=u>0?l.cuts[u-1]??-1/0:-1/0,f=se(u),c=m?.aspect??1,w=r=>m?.pointOf(r);let n=ne(t,s,m),h=0,g=0,F=0;const S=[0,0,0];for(const r of l.reframes){if(r.shot!==u||s<=r.at)continue;const p=(s-r.at)/r.duration,d=Fe(r.shape,p),z=r.bow*Math.sin(Math.PI*Math.min(1,p));if(r.spec.to){const b=ne(r.spec.to,s,m),a=X(n,c,w),U=X(b,c,w).forward,P=I(U,a.right),B=I(U,a.up),T=I(U,a.forward),G=Math.atan2(-P,T)/C,Ee=Math.atan2(B,Math.hypot(P,T))/C;h+=-Ee*z,g+=G*z;const Oe=x?qe((s-r.at-x.delay)/x.settle):Math.min(1,Math.max(0,d));n=De(n,b,d,m,"A reframe",Oe)}if(r.spec.turn){const[b,a,E=0]=r.spec.turn;h+=b*d-a*z,g+=a*d+b*z,F+=E*d}if(r.spec.shift){const[b,a,E=0]=r.spec.shift;S[0]+=b*d,S[1]+=a*d,S[2]+=E*d}}for(const r of l.jolts){if(r.shot!==u||s<=r.at)continue;const p=Re(s-r.at,r.ring,r.decay)*_(r.ring);h+=r.turn[0]*p,g+=r.turn[1]*p,F+=(r.turn[2]??0)*p}const[ie,fe,de,ue,ce,le]=f.sway.map(r=>r(s)),[he,me,pe]=f.tremor.map(r=>r(s)),[ge,we,ve,ye,be,Me]=f.drift.map(r=>r(s)),xe=f.swell(s),R=e.tremor.angle*xe,H=_(1/e.drift.period);h+=e.angle*(ie??0)+R*(he??0)+e.drift.angle*H*(ge??0),g+=e.angle*(fe??0)+R*(me??0)+e.drift.angle*H*(we??0),F+=e.roll*(e.angle*(de??0)+R*(pe??0)+e.drift.angle*H*(ve??0)),S[0]+=e.shift*(ue??0)+e.drift.shift*(ye??0),S[1]+=e.shift*(ce??0)+e.drift.shift*(be??0),S[2]+=e.shift*(le??0)+e.drift.shift*(Me??0);const A=X(n,c,w);let k=A.forward,L=A.up,K=A.right;const W=(r,p)=>{const d=p*C;k=Q(k,r,d),L=Q(L,r,d),K=Q(K,r,d)};W(K,g),W(L,h),W(N(k,-1),F);const je=Z(Z(Z(A.position,N(A.right,S[0])),N(A.up,S[1])),N(A.forward,S[2])),v={};if(n.lens!==void 0&&(v.lens=n.lens),n.lensFrame!==void 0&&(v.lensFrame=n.lensFrame),n.fov!==void 0&&(v.fov=n.fov),n.near!==void 0&&(v.near=n.near),n.far!==void 0&&(v.far=n.far),n.aperture!==void 0&&(v.aperture=n.aperture),n.ev!==void 0&&(v.ev=n.ev),n.focus!==void 0&&(v.focus=n.focus),M&&n.aperture!==void 0&&n.focus!==void 0){const r=n.focus,p=typeof r=="number"?void 0:typeof r=="string"?m?.pointOf(r):r,d=typeof r=="number"?r:p?I(Pe(p,A.position),A.forward):void 0;if(d!==void 0&&d>0){const z=[...u>0?[{when:O,share:M.after.cut,id:0}]:[],...l.reframes.filter(a=>a.shot===u).map(a=>({when:a.at+a.duration*.5,share:M.after.reframe,id:1+a.index})),...l.jolts.filter(a=>a.shot===u).map(a=>({when:a.at,share:M.after.jolt,id:1e3+a.index}))];let b=M.miss;for(const a of z){const E=s-a.when;if(E<0||E>M.decay*12)continue;const U=a.id*4,P=M.hunt*a.share*(1+.4*$(j,u,60+U)),B=M.rate*(1+.2*$(j,u,61+U)),T=2*Math.PI*B*E,G=$(j,u,62+U)<0?-1:1;b+=G*P*Math.exp(-E/M.decay)*(a.id===0?Math.cos(T):Math.sin(T))}v.focus=d*(1+b)}}if(x&&n.ev!==void 0){let r=n.ev+x.breathe*f.breathe(s);if(u>0){const p=s-O,d=x.settle/4,z=$(j,u,70);r+=x.cut*Math.sign(z)*(.5+.5*Math.abs(z))*(1+p/d)*Math.exp(-p/d)}v.ev=r}const Se=oe(n.up??ke.up),te=J(oe(J(k,Se)),k),Ae=N(k,-1),ze=Math.atan2(I(J(te,L),Ae),I(te,L));return{...v,position:je,direction:k,...n.up?{up:n.up}:{},roll:ze/C}})}

package/node_modules/@allyhub-next/scenery/dist/hull.d.ts

@@ -0,0 +1,23 @@
+/** A point on the floor: x and z, m. */
+export type Floor = readonly [number, number];
+/** The convex hull, counterclockwise from the lowest x (then z), without repeats. */
+export declare function convexHull(points: readonly Floor[]): Floor[];
+/** The smallest rectangle round points on the floor. */
+export interface FloorRect {
+    /** Its centre, x and z. */
+    center: Floor;
+    /** Its longer side, then its shorter, m. */
+    length: number;
+    width: number;
+    /**
+     * Degrees about +Y from +X to its longer side, in [0, 180): which way it
+     * runs on the floor, as yaw turns (counterclockwise seen from above).
+     */
+    angle: number;
+    /** Its four corners, in order round it. */
+    corners: [Floor, Floor, Floor, Floor];
+    area: number;
+}
+/** The smallest-area rectangle round points on the floor; undefined for none. */
+export declare function floorRect(points: readonly Floor[]): FloorRect | undefined;
+//# sourceMappingURL=hull.d.ts.map

package/node_modules/@allyhub-next/scenery/dist/hull.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+const P=(r,c,e)=>(c[0]-r[0])*(e[1]-r[1])-(c[1]-r[1])*(e[0]-r[0]);export function convexHull(r){const c=[...r].sort((t,n)=>t[0]-n[0]||t[1]-n[1]),e=[];for(const t of c){const n=e.at(-1);(n?.[0]!==t[0]||n[1]!==t[1])&&e.push(t)}if(e.length<3)return e;const o=[];for(const t of e){for(;o.length>=2;){const[n,s]=[o[o.length-2],o[o.length-1]];if(n&&s&&P(n,s,t)<=0)o.pop();else break}o.push(t)}const i=[];for(let t=e.length-1;t>=0;t--){const n=e[t];if(n){for(;i.length>=2;){const[s,l]=[i[i.length-2],i[i.length-1]];if(s&&l&&P(s,l,n)<=0)i.pop();else break}i.push(n)}}return[...o.slice(0,-1),...i.slice(0,-1)]}export function floorRect(r){const c=convexHull(r),e=c[0];if(!e)return;let o;const i=c.length<2?1:c.length;for(let h=0;h<i;h++){const g=c[h]??e,k=c[(h+1)%c.length]??e;let p=k[0]-g[0],d=k[1]-g[1];const I=Math.hypot(p,d);I===0?(p=1,d=0):(p/=I,d/=I);const b=[p,d],w=[-d,p];let a=[1/0,1/0],f=[-1/0,-1/0];for(const x of c){const v=x[0]*b[0]+x[1]*b[1],H=x[0]*w[0]+x[1]*w[1];a=[Math.min(a[0],v),Math.min(a[1],H)],f=[Math.max(f[0],v),Math.max(f[1],H)]}const q=(f[0]-a[0])*(f[1]-a[1]);(!o||q<o.area-1e-12)&&(o={area:q,ux:b,uz:w,lo:a,hi:f})}if(!o)return;const{ux:t,uz:n,lo:s,hi:l,area:R}=o,u=(h,g)=>[t[0]*h+n[0]*g,t[1]*h+n[1]*g],j=[u(s[0],s[1]),u(l[0],s[1]),u(l[0],l[1]),u(s[0],l[1])],M=l[0]-s[0],m=l[1]-s[1],z=M>=m?t:n;let y=Math.atan2(-z[1],z[0])*180/Math.PI;return y=(y%180+180)%180,{center:u((s[0]+l[0])/2,(s[1]+l[1])/2),length:Math.max(M,m),width:Math.min(M,m),angle:y,corners:j,area:R}}

package/node_modules/@allyhub-next/scenery/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { blurDiameter, CAMERA_DEFAULTS, CameraError, cameraProblems, directionOf, exposureOf, project, resolveCamera, yawPitchOf, type CameraState, type PointOf, type Projection, type ResolvedCamera, } from "./camera.js";
+export { BAKE_CPU, BAKE_DEFAULTS, BAKE_MIN_SIZE, bakeProblems, bakeRenderer, resolveBake, type BakeOptions, type BakeReport, type ResolvedBake, } from "./bake.js";
+export { Curve, SAME_POINT, type CurvePoint } from "./curve.js";
+export { defineScenery, isScenery, type AssetRef, type Bounds, type Scenery, type SceneryDefinition, type SceneryHost, type SceneryProp, type SceneryRendererOptions, SCENERY_RENDERER_DEFAULTS, } from "./define.js";
+export { FIT_DEFAULTS, fitCamera, type Box, type FitOptions, type Margins, } from "./fit.js";
+export { diagonalLens, fieldOfView, fieldOfViewFromVertical, FULL_FRAME_DIAGONAL, lensForVertical, lensFrameProblem, type FieldOfView, type LensFrame, } from "./lens.js";
+export { blend, cutsOf, focusScreen, keys, mixCameras, momentOf, orbit, path, PATH_DEFAULTS, pathCurve, shots, stateOf, withCuts, NeedsTimeError, type CameraKey, type Cuts, type Shot, type BlendOptions, type FocusScreenOptions, type ScreenFace, type KeysOptions, type LensOptions, type Move, type OrbitOptions, type PathOptions, type MoveTime, type SceneryView, } from "./move.js";
+export { GLASS_DEFAULTS, glassIor, glassProblems, type GlassOptions, } from "./glass.js";
+export { aimAt, aimed, AIM_DEFAULTS, aimProblem, aimShape, rise, type AimOptions, type AimShape, } from "./aim.js";
+export { AUTO_EXPOSURE_DEFAULTS, AUTOFOCUS_DEFAULTS, handheld, HANDHELD_DEFAULTS, handheldProblem, STABILIZER_DEFAULTS, type AutoExposureOptions, type AutofocusOptions, type HandheldOptions, type Jolt, type Reframe, type Shift, type Turn, } from "./handheld.js";
+export { bandNoise, gauss3, hash3, powerNoise, swellOf, unit3, type Band, type Slope, } from "./noise.js";
+export { convexHull, floorRect, type Floor, type FloorRect } from "./hull.js";
+export { solveCamera, SOLVE_DEFAULTS, SOLVE_PARAMS, type SolveLine, type SolveOptions, type SolveParam, type SolvePoint, type SolveResidual, type SolveResult, } from "./solve.js";
+export { invert3, moireAt, moireBand, moireCamera, moireProblems, moireScreen, MOIRE_GLSL, MOIRE_SCREENS, PANEL_DEFAULTS, SENSOR_DEFAULTS, STRIPE_DEPTH, type MoireCamera, type MoireScreen, type PanelOptions, type SensorOptions, } from "./moire.js";
+export { screenFocus, SCREEN_FOCUS_DEFAULTS, type ScreenFocus, type ScreenFocusOptions, } from "./screen-focus.js";
+export { apply, homography, matrix3d, screenOnFrame, shownCentre, SCREEN_LIGHT_DEFAULTS, screenLightBaseProblem, type Px, type ScreenLightBase, type ScreenOnFrame, } from "./screen.js";
+export { AROUND_DEFAULTS, FLOOR_DEFAULTS, INVENTORY_FRAME, MAP_DEFAULTS, MAP_VIEWS, MEASURE_DEFAULTS, MOTION_DEFAULTS, SIDES, type AxisBox, type CameraClearance, type CameraSource, type Channel, type ClearAhead, type Contact, type FreeFloor, type Levels, type MeasureRequest, type MeasureResult, type MeshHealth, type Motion, type MotionRequest, type SeeRequest, type SeeResult, type SeeTile, type Sight, type Support, type DrawnCamera, type Footprint, type MapPath, type MapRequest, type MapResult, type MapView, type MapViewResult, type OwnBox, type PointRef, type PointsRequest, type Seen, type Side, type UprightBox, type ViewRequest, type ViewResult, type ViewTile, type ViewTileResult, type SceneryInventory, type SceneryLight, type SceneryObject, topObjects, } from "./report.js";
+export { channel, motionOf, type CameraSample, type MotionNumbers, } from "./motion.js";
+export { easeValue, timedNumber, type Ease, type NumberKey } from "./timing.js";
+export { PHONE_CAMERA, phoneCamera, type Deeper, type PhoneCamera, } from "./phone.js";
+export type { Vec3 } from "./vec.js";
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@allyhub-next/scenery/dist/index.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export{blurDiameter,CAMERA_DEFAULTS,CameraError,cameraProblems,directionOf,exposureOf,project,resolveCamera,yawPitchOf}from"./camera.js";export{BAKE_CPU,BAKE_DEFAULTS,BAKE_MIN_SIZE,bakeProblems,bakeRenderer,resolveBake}from"./bake.js";export{Curve,SAME_POINT}from"./curve.js";export{defineScenery,isScenery,SCENERY_RENDERER_DEFAULTS}from"./define.js";export{FIT_DEFAULTS,fitCamera}from"./fit.js";export{diagonalLens,fieldOfView,fieldOfViewFromVertical,FULL_FRAME_DIAGONAL,lensForVertical,lensFrameProblem}from"./lens.js";export{blend,cutsOf,focusScreen,keys,mixCameras,momentOf,orbit,path,PATH_DEFAULTS,pathCurve,shots,stateOf,withCuts,NeedsTimeError}from"./move.js";export{GLASS_DEFAULTS,glassIor,glassProblems}from"./glass.js";export{aimAt,aimed,AIM_DEFAULTS,aimProblem,aimShape,rise}from"./aim.js";export{AUTO_EXPOSURE_DEFAULTS,AUTOFOCUS_DEFAULTS,handheld,HANDHELD_DEFAULTS,handheldProblem,STABILIZER_DEFAULTS}from"./handheld.js";export{bandNoise,gauss3,hash3,powerNoise,swellOf,unit3}from"./noise.js";export{convexHull,floorRect}from"./hull.js";export{solveCamera,SOLVE_DEFAULTS,SOLVE_PARAMS}from"./solve.js";export{invert3,moireAt,moireBand,moireCamera,moireProblems,moireScreen,MOIRE_GLSL,MOIRE_SCREENS,PANEL_DEFAULTS,SENSOR_DEFAULTS,STRIPE_DEPTH}from"./moire.js";export{screenFocus,SCREEN_FOCUS_DEFAULTS}from"./screen-focus.js";export{apply,homography,matrix3d,screenOnFrame,shownCentre,SCREEN_LIGHT_DEFAULTS,screenLightBaseProblem}from"./screen.js";export{AROUND_DEFAULTS,FLOOR_DEFAULTS,INVENTORY_FRAME,MAP_DEFAULTS,MAP_VIEWS,MEASURE_DEFAULTS,MOTION_DEFAULTS,SIDES,topObjects}from"./report.js";export{channel,motionOf}from"./motion.js";export{easeValue,timedNumber}from"./timing.js";export{PHONE_CAMERA,phoneCamera}from"./phone.js";

package/node_modules/@allyhub-next/scenery/dist/lens.d.ts

@@ -0,0 +1,48 @@
+/** The diagonal of a 36 × 24 mm frame, in mm. */
+export declare const FULL_FRAME_DIAGONAL: number;
+/** The long and short sides of a 36 × 24 mm frame, in mm. */
+export declare const FULL_FRAME_LONG = 36;
+export declare const FULL_FRAME_SHORT = 24;
+/**
+ * What a lens is measured on:
+ * - "diagonal": the output frame's diagonal (the default);
+ * - "long", "short": the output frame's long or short side, as 36 or 24 mm;
+ * - { aspect, keep }: the diagonal of a frame of that aspect (4/3, a
+ *   phone's photo), then the output frame cut from it keeping that frame's
+ *   long or short side (a phone's video keeps the long side);
+ * - "phone": { aspect: 4 / 3, keep: "long" }, how a phone's camera app
+ *   quotes its lenses for video.
+ */
+export type LensFrame = "diagonal" | "long" | "short" | "phone" | {
+    aspect: number;
+    keep: "long" | "short";
+};
+/** "phone" is a phone's 4:3 photo frame, its video keeping the long side. */
+export declare const PHONE_FRAME: {
+    readonly aspect: number;
+    readonly keep: "long";
+};
+/** The angles a frame sees, in degrees. */
+export interface FieldOfView {
+    horizontal: number;
+    vertical: number;
+    diagonal: number;
+}
+/** Whether a lens frame is one of the five forms, with a usable aspect. */
+export declare function lensFrameProblem(frame: LensFrame): string | undefined;
+/**
+ * The angles a lens sees on a frame of `aspect` (width over height).
+ * fieldOfView(26, 16 / 9) is 71.9° × 44.4°, 79.5° on the diagonal.
+ */
+export declare function fieldOfView(lens: number, aspect: number, frame?: LensFrame): FieldOfView;
+/** The lens that sees `vertical` degrees on a frame of `aspect`: fieldOfView's inverse. */
+export declare function lensForVertical(vertical: number, aspect: number, frame?: LensFrame): number;
+/** The angles a frame of `aspect` sees with a vertical angle of `vertical` degrees. */
+export declare function fieldOfViewFromVertical(vertical: number, aspect: number): FieldOfView;
+/**
+ * A lens said in the default convention: the focal length that sees the
+ * same diagonal on the output frame. A phone's 26 mm in 16:9 video
+ * (`{ aspect: 4/3, keep: "long" }`) is 28.3 mm on the diagonal.
+ */
+export declare function diagonalLens(lens: number, aspect: number, frame?: LensFrame): number;
+//# sourceMappingURL=lens.d.ts.map

package/node_modules/@allyhub-next/scenery/dist/lens.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const FULL_FRAME_DIAGONAL=Math.hypot(36,24),FULL_FRAME_LONG=36,FULL_FRAME_SHORT=24,PHONE_FRAME={aspect:4/3,keep:"long"};const g=t=>Math.max(t,1/t);function p(t,n){const e=g(t),o=n==="phone"?PHONE_FRAME:n;if(o==="diagonal"){const r=FULL_FRAME_DIAGONAL/2,u=Math.hypot(1,e);return{long:r*e/u,short:r/u}}if(o==="long"){const r=FULL_FRAME_LONG/2;return{long:r,short:r/e}}if(o==="short"){const r=FULL_FRAME_SHORT/2;return{long:r*e,short:r}}const s=g(o.aspect),a=FULL_FRAME_DIAGONAL/2,i=Math.hypot(1,s);if(o.keep==="long"){const r=a*s/i;return{long:r,short:r/e}}const l=a/i;return{long:l*e,short:l}}const c=t=>2*Math.atan(t)*180/Math.PI,h=t=>Math.tan(t*Math.PI/360);export function lensFrameProblem(t){if(t==="diagonal"||t==="long"||t==="short"||t==="phone")return;if(!(Number.isFinite(t.aspect)&&t.aspect>0))return`lensFrame.aspect must be a positive number, not ${String(t.aspect)}`;const n=t.keep;if(n!=="long"&&n!=="short")return`lensFrame.keep must be "long" or "short", not ${JSON.stringify(n)}`}export function fieldOfView(t,n,e="diagonal"){const o=p(n,e),s=o.long/t,a=o.short/t,i=n>=1;return{horizontal:c(i?s:a),vertical:c(i?a:s),diagonal:c(Math.hypot(s,a))}}export function lensForVertical(t,n,e="diagonal"){const o=p(n,e);return(n>=1?o.short:o.long)/h(t)}export function fieldOfViewFromVertical(t,n){const e=h(t),o=e*n;return{horizontal:c(o),vertical:t,diagonal:c(Math.hypot(o,e))}}export function diagonalLens(t,n,e="diagonal"){const o=fieldOfView(t,n,e).diagonal;return FULL_FRAME_DIAGONAL/2/h(o)}

package/node_modules/@allyhub-next/scenery/dist/moire.d.ts

@@ -0,0 +1,136 @@
+import { type ResolvedCamera } from "./camera.js";
+import { type Px } from "./screen.js";
+import type { Vec3 } from "./vec.js";
+/** A sensor that films the scenery layer (scenery({ sensor })). */
+export interface SensorOptions {
+    /** Photosites across the frame's longer side (a 12 MP phone's 4:3 sensor, cropped to 16:9: 4032). */
+    photosites?: number;
+    /** The lens's own blur, a Gaussian's standard deviation in photosites. */
+    lens?: number;
+    /** How strong the moiré is, a share of what the model gives (0: none). */
+    moire?: number;
+    /**
+     * How much of the false colour the phone's processing leaves (0: bands of
+     * light and dark only; 1: as the Bayer grid made them).
+     */
+    chroma?: number;
+    /**
+     * The lens's barrel (negative) or pincushion (positive) distortion before
+     * the phone corrects the picture, k1 over the frame's half diagonal: the
+     * sensor's grid, as the corrected picture sees it, bends, and so do the
+     * bands.
+     */
+    distortion?: number;
+}
+/** A screen's physical pixels (screen({ pixels })). */
+export interface PanelOptions {
+    /** Physical pixels per content pixel each way (a Retina laptop: 2). */
+    density?: number;
+    /** How much the dark lines between rows of pixels darken them (0–1). */
+    rows?: number;
+}
+export declare const SENSOR_DEFAULTS: {
+    photosites: number;
+    lens: number;
+    moire: number;
+    chroma: number;
+    distortion: number;
+};
+export declare const PANEL_DEFAULTS: {
+    density: number;
+    rows: number;
+};
+/**
+ * The depth a stripe a third of a pixel wide gives its fundamental,
+ * against its mean (2 sin(π/3) / (π/3)), half of it left by a phone's
+ * demosaicing: with a phone's lens (sharp to about half at the sensor's
+ * Nyquist), a screen at the worst distance shows bands of a fifth to a
+ * third of its brightness.
+ */
+export declare const STRIPE_DEPTH: number;
+/** What the moiré of one screen at one moment is drawn from. */
+export interface MoireScreen {
+    /** The homography from the layer's px to the content's px (row-major, 3 × 3). */
+    inverse: number[];
+    /** The content's size, px. */
+    size: [number, number];
+    /** Physical pixels per content pixel. */
+    density: number;
+    /** How much the rows darken. */
+    rows: number;
+    /** Depth along the view at the content's (0, 0), and its change per content px along x and y, m. */
+    depth: [d0: number, dx: number, dy: number];
+}
+/** The camera's part: the sensor and its depth of field. */
+export interface MoireCamera {
+    /** Layer px per photosite. */
+    pitch: number;
+    /** The lens's blur, photosites. */
+    lens: number;
+    strength: number;
+    /** The share of false colour left. */
+    chroma: number;
+    /** k1, and the frame's centre and half diagonal in layer px. */
+    distortion: {
+        k1: number;
+        centre: Px;
+        radius: number;
+    };
+    /**
+     * The circle of confusion's diameter in layer px at a depth d:
+     * k · |d − focus| / max(d, near); none without an aperture.
+     */
+    blur?: {
+        k: number;
+        focus: number;
+        near: number;
+    };
+}
+/**
+ * The factor per channel (red, green, blue) a layer pixel of a screen is
+ * multiplied by; undefined where the pixel is not on the screen.
+ */
+export declare function moireAt(screen: MoireScreen, camera: MoireCamera, at: Px): [number, number, number] | undefined;
+/**
+ * The deepest band at a layer pixel of a screen, of any channel and of
+ * the stripes or the rows: how much it darkens at its darkest (0–1, before
+ * the phone takes out its colour) and how far apart its bands are, layer
+ * px. Undefined off the screen.
+ */
+export declare function moireBand(screen: MoireScreen, camera: MoireCamera, at: Px): {
+    depth: number;
+    period: number;
+} | undefined;
+/** The most screens one layer's moiré is drawn for. */
+export declare const MOIRE_SCREENS = 4;
+/**
+ * The same arithmetic for the page: a fragment shader over the layer that
+ * gives, at each pixel, the factors of the nearest screen there (clear
+ * elsewhere), to multiply what is under it by.
+ */
+export declare const MOIRE_GLSL: string;
+/** A 3 × 3 matrix's inverse (row-major); undefined when it has none. */
+export declare function invert3(m: readonly number[]): number[] | undefined;
+/**
+ * One screen's part of the moiré at a moment: its content's corners on the
+ * layer (top left, top right, bottom right, bottom left, layer px) and in
+ * the scenery, its content's size and its panel.
+ */
+export declare function moireScreen(o: {
+    quad: readonly [Px, Px, Px, Px];
+    corners: readonly [Vec3, Vec3, Vec3, Vec3];
+    size: readonly [number, number];
+    camera: ResolvedCamera;
+    panel?: PanelOptions;
+}): MoireScreen | undefined;
+/**
+ * The camera's part: its sensor on a frame `frame` px (the photosites span
+ * its longer side) and, with an aperture, its blur on a layer `height` px
+ * tall (blurDiameter's frame).
+ */
+export declare function moireCamera(camera: ResolvedCamera, frame: readonly [number, number], height: number, sensor?: SensorOptions, 
+/** Where the layer's box starts on the frame, px. */
+origin?: Px): MoireCamera;
+/** Problems with a sensor's or a panel's options, each a sentence. */
+export declare function moireProblems(sensor: SensorOptions | undefined, panel: PanelOptions | undefined): string[];
+//# sourceMappingURL=moire.d.ts.map

package/node_modules/@allyhub-next/scenery/dist/moire.js

@@ -0,0 +1,93 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{blurDiameter as z}from"./camera.js";import{homography as C}from"./screen.js";export const SENSOR_DEFAULTS={photosites:4032,lens:.35,moire:1,chroma:.3,distortion:-.03},PANEL_DEFAULTS={density:2,rows:.15},STRIPE_DEPTH=2*Math.sin(Math.PI/3)/(Math.PI/3)/2;const g=2*Math.PI,P=o=>Math.abs(o)<1e-6?1:Math.sin(Math.PI*o)/(Math.PI*o);function R(o,n){if(n===1){const i=Math.round(o[0]+o[1]),t=Math.round(o[0]-o[1]);return[(i+t)/2,(i-t)/2]}return[Math.round(2*o[0])/2,Math.round(2*o[1])/2]}const T={0:[0,0],1:[1,0],2:[1,1]};function D(o,n,i,t,f,s,e){return E(o,n,i,t,f,s,e).factor}function E(o,n,i,t,f,s,e){const r=s.pitch,c=[i[0]*r,i[1]*r],d=F(t,s),h=[d[0]/r,d[1]/r],u=R(c,o),p=T[o],a=[(c[0]-u[0])/r,(c[1]-u[1])/r],m=Math.hypot(a[0],a[1]);if(m>=.5)return{factor:1,depth:0,period:1/0};const w=c[0]*c[0]+c[1]*c[1],S=Math.exp(-2*Math.PI**2*s.lens**2*w),x=e/4,b=Math.exp(-2*Math.PI**2*x**2*(i[0]*i[0]+i[1]*i[1])),y=Math.abs(P(c[0])*P(c[1])),M=Math.abs(P(a[0])*P(a[1]))*(1-2*m),l=Math.min(1,s.strength*f*S*b*y*M),v=n-g*(u[0]*h[0]+u[1]*h[1])+g*(u[0]*p[0]+u[1]*p[1]);return{factor:1-l*(1-Math.cos(v))/2,depth:l,period:m>0?1/m:1/0}}function F(o,n){const{k1:i,centre:t,radius:f}=n.distortion,s=o[0]-t[0],e=o[1]-t[1],r=(s*s+e*e)/(f*f),c=1+i*r;return[t[0]+s*c,t[1]+e*c]}const I=[.299,.587,.114];export function moireAt(o,n,i){const t=o.inverse,[f,s]=i,e=(t[6]??0)*f+(t[7]??0)*s+(t[8]??1);if(e<=0)return;const r=((t[0]??0)*f+(t[1]??0)*s+(t[2]??0))/e,c=((t[3]??0)*f+(t[4]??0)*s+(t[5]??0))/e,[d,h]=o.size;if(r<0||c<0||r>d||c>h)return;const u=[((t[0]??0)-(t[6]??0)*r)/e,((t[1]??0)-(t[7]??0)*r)/e],p=[((t[3]??0)-(t[6]??0)*c)/e,((t[4]??0)-(t[7]??0)*c)/e],a=o.density,[m,w,S]=o.depth,x=m+w*r+S*c,b=n.blur?n.blur.k*Math.abs(x-n.blur.focus)/Math.max(x,n.blur.near):0,y=[a*u[0],a*u[1]],M=[a*p[0],a*p[1]],l=[1,1,1];for(const k of[0,1,2]){const A=D(k,g*(a*r-k/3),y,i,STRIPE_DEPTH,n,b),N=D(k,g*a*c,M,i,o.rows*STRIPE_DEPTH,n,b);l[k]=A*N}const v=I[0]*l[0]+I[1]*l[1]+I[2]*l[2];return[v+n.chroma*(l[0]-v),v+n.chroma*(l[1]-v),v+n.chroma*(l[2]-v)]}export function moireBand(o,n,i){const t=o.inverse,[f,s]=i,e=(t[6]??0)*f+(t[7]??0)*s+(t[8]??1);if(e<=0)return;const r=((t[0]??0)*f+(t[1]??0)*s+(t[2]??0))/e,c=((t[3]??0)*f+(t[4]??0)*s+(t[5]??0))/e,[d,h]=o.size;if(r<0||c<0||r>d||c>h)return;const u=[((t[0]??0)-(t[6]??0)*r)/e,((t[1]??0)-(t[7]??0)*r)/e],p=[((t[3]??0)-(t[6]??0)*c)/e,((t[4]??0)-(t[7]??0)*c)/e],a=o.density,[m,w,S]=o.depth,x=m+w*r+S*c,b=n.blur?n.blur.k*Math.abs(x-n.blur.focus)/Math.max(x,n.blur.near):0;let y={depth:0,period:1/0};for(const M of[0,1,2])for(const l of[E(M,g*(a*r-M/3),[a*u[0],a*u[1]],i,STRIPE_DEPTH,n,b),E(M,g*a*c,[a*p[0],a*p[1]],i,o.rows*STRIPE_DEPTH,n,b)])l.depth>y.depth&&(y={depth:l.depth,period:l.period});return y}export const MOIRE_SCREENS=4,MOIRE_GLSL=`#version 300 es
+precision highp float;
+#define SCREENS ${String(MOIRE_SCREENS)}
+uniform int count;
+uniform mat3 inverse[SCREENS];
+uniform vec2 size[SCREENS];
+uniform vec2 panel[SCREENS];
+uniform vec3 depth[SCREENS];
+uniform vec2 layer;
+uniform float pitch;
+uniform float lensBlur;
+uniform float strength;
+uniform vec3 blur;
+uniform float stripeDepth;
+uniform float chroma;
+uniform vec4 distortion;
+out vec4 colour;
+const float PI = 3.14159265358979;
+const float TAU = 6.28318530717959;
+
+float sinc(float x) { return abs(x) < 1e-6 ? 1.0 : sin(PI * x) / (PI * x); }
+
+vec2 nearestPoint(vec2 k, int channel) {
+  if (channel == 1) {
+    float p = floor(k.x + k.y + 0.5);
+    float r = floor(k.x - k.y + 0.5);
+    return vec2(p + r, p - r) / 2.0;
+  }
+  return floor(2.0 * k + 0.5) / 2.0;
+}
+
+vec2 sensorAt(vec2 at) {
+  vec2 d = at - distortion.yz;
+  float r2 = dot(d, d) / (distortion.w * distortion.w);
+  return distortion.yz + d * (1.0 + distortion.x * r2);
+}
+
+float aliased(int channel, float phase, vec2 k, vec2 at, float lines, float blurPx) {
+  vec2 ks = k * pitch;
+  vec2 s = sensorAt(at) / pitch;
+  vec2 g = nearestPoint(ks, channel);
+  vec2 o = channel == 0 ? vec2(0.0) : channel == 1 ? vec2(1.0, 0.0) : vec2(1.0);
+  vec2 ka = (ks - g) / pitch;
+  float fine = length(ka);
+  if (fine >= 0.5) return 1.0;
+  float lens = exp(-2.0 * PI * PI * lensBlur * lensBlur * dot(ks, ks));
+  float sigma = blurPx / 4.0;
+  float defocus = exp(-2.0 * PI * PI * sigma * sigma * dot(k, k));
+  float site = abs(sinc(ks.x) * sinc(ks.y));
+  float outMtf = abs(sinc(ka.x) * sinc(ka.y)) * (1.0 - 2.0 * fine);
+  float d = min(1.0, strength * lines * lens * defocus * site * outMtf);
+  float psi = phase - TAU * dot(g, s) + TAU * dot(g, o);
+  return 1.0 - d * (1.0 - cos(psi)) / 2.0;
+}
+
+void main() {
+  // Layer px, from the top left, at the pixel's centre.
+  vec2 at = vec2(gl_FragCoord.x, layer.y - gl_FragCoord.y);
+  vec3 factor = vec3(1.0);
+  bool on = false;
+  float nearestDepth = 1e9;
+  for (int i = 0; i < SCREENS; i++) {
+    if (i >= count) break;
+    // Sent transposed: m[col][row] is the homography's row, column.
+    mat3 m = inverse[i];
+    float w = m[0][2] * at.x + m[1][2] * at.y + m[2][2];
+    if (w <= 0.0) continue;
+    float u = (m[0][0] * at.x + m[1][0] * at.y + m[2][0]) / w;
+    float v = (m[0][1] * at.x + m[1][1] * at.y + m[2][1]) / w;
+    if (u < 0.0 || v < 0.0 || u > size[i].x || v > size[i].y) continue;
+    float d = depth[i].x + depth[i].y * u + depth[i].z * v;
+    if (d >= nearestDepth) continue;
+    nearestDepth = d;
+    vec2 du = vec2(m[0][0] - m[0][2] * u, m[1][0] - m[1][2] * u) / w;
+    vec2 dv = vec2(m[0][1] - m[0][2] * v, m[1][1] - m[1][2] * v) / w;
+    float D = panel[i].x;
+    float blurPx = blur.x > 0.0 ? blur.x * abs(d - blur.y) / max(d, blur.z) : 0.0;
+    vec2 ku = D * du;
+    vec2 kv = D * dv;
+    vec3 f;
+    for (int c = 0; c < 3; c++) {
+      float stripes = aliased(c, TAU * (D * u - float(c) / 3.0), ku, at, stripeDepth, blurPx);
+      float rows = aliased(c, TAU * D * v, kv, at, panel[i].y * stripeDepth, blurPx);
+      f[c] = stripes * rows;
+    }
+    float light = dot(f, vec3(0.299, 0.587, 0.114));
+    factor = vec3(light) + chroma * (f - vec3(light));
+    on = true;
+  }
+  // Off every screen: nothing (premultiplied).
+  colour = on ? vec4(factor, 1.0) : vec4(0.0);
+}`;export function invert3(o){const[n=0,i=0,t=0,f=0,s=0,e=0,r=0,c=0,d=1]=o,h=s*d-e*c,u=-(f*d-e*r),p=f*c-s*r,a=n*h+i*u+t*p;if(!(Math.abs(a)<1e-18))return[h/a,-(i*d-t*c)/a,(i*e-t*s)/a,u/a,(n*d-t*r)/a,-(n*e-t*f)/a,p/a,-(n*c-i*r)/a,(n*s-i*f)/a]}export function moireScreen(o){const[n,i]=o.size,t=C(n,i,o.quad),f=t?invert3(t):void 0;if(!f)return;const s=o.camera,e=u=>(u[0]-s.position[0])*s.forward[0]+(u[1]-s.position[1])*s.forward[1]+(u[2]-s.position[2])*s.forward[2],[r,c,,d]=o.corners,h=e(r);return{inverse:f,size:[n,i],density:o.panel?.density??PANEL_DEFAULTS.density,rows:o.panel?.rows??PANEL_DEFAULTS.rows,depth:[h,(e(c)-h)/n,(e(d)-h)/i]}}export function moireCamera(o,n,i,t={},f=[0,0]){const s=t.photosites??SENSOR_DEFAULTS.photosites,e={pitch:Math.max(n[0],n[1])/s,lens:t.lens??SENSOR_DEFAULTS.lens,strength:t.moire??SENSOR_DEFAULTS.moire,chroma:t.chroma??SENSOR_DEFAULTS.chroma,distortion:{k1:t.distortion??SENSOR_DEFAULTS.distortion,centre:[n[0]/2-f[0],n[1]/2-f[1]],radius:Math.hypot(n[0],n[1])/2}},r=o.dof;if(r){const c=2*r.focus,d=z(o,c,i)*Math.max(c,o.near)/Math.abs(c-r.focus);e.blur={k:d,focus:r.focus,near:o.near}}return e}export function moireProblems(o,n){const i=[],t=(s,e)=>{s!==void 0&&!(Number.isFinite(s)&&s>0)&&i.push(`${e} is a positive number, not ${String(s)}.`)};t(o?.photosites,"sensor.photosites"),t(o?.lens,"sensor.lens"),t(n?.density,"pixels.density");const f=(s,e,r)=>{s!==void 0&&!(Number.isFinite(s)&&s>=0&&s<=r)&&i.push(`${e} is from 0 to ${String(r)}, not ${String(s)}.`)};return f(o?.moire,"sensor.moire",4),f(o?.chroma,"sensor.chroma",1),o?.distortion!==void 0&&!(Number.isFinite(o.distortion)&&Math.abs(o.distortion)<=.5)&&i.push(`sensor.distortion is from -0.5 to 0.5, not ${String(o.distortion)}.`),f(n?.rows,"pixels.rows",1),i}

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

@@ -0,0 +1,48 @@
+import type { Channel } from "./report.js";
+import { type Vec3 } from "./vec.js";
+/** A camera at a moment, resolved. */
+export interface CameraSample {
+    t: number;
+    position: Vec3;
+    forward: Vec3;
+    up: Vec3;
+    right: Vec3;
+    /** The lens in the diagonal convention, mm. */
+    lens: number;
+    yaw: number;
+    pitch: number;
+    roll: number;
+    target?: Vec3;
+}
+export interface MotionNumbers {
+    length: number;
+    truck: Channel;
+    pedestal: Channel;
+    dolly: Channel;
+    pan: Channel;
+    tilt: Channel;
+    roll: Channel;
+    zoom: Channel;
+    arc?: Channel;
+    speed: Channel;
+    turn: Channel;
+    acceleration: Channel;
+    jerk: Channel;
+    smoothness: number | null;
+    step: {
+        distance: number;
+        angle: number;
+        at: number;
+    };
+    /** The cuts inside it, times: what is measured stops at each and starts again after. */
+    cuts: number[];
+}
+/** A channel from values at moments: its largest magnitude and when, its mean magnitude. */
+export declare function channel(values: readonly number[], times: readonly number[]): Channel;
+/**
+ * The motion of samples taken at a steady rate. A cut (a time between two
+ * samples) is no motion: the step across it is not measured, and neither
+ * acceleration nor jerk spans it; smoothness is the least smooth shot's.
+ */
+export declare function motionOf(samples: readonly CameraSample[], cuts?: readonly number[]): MotionNumbers;
+//# sourceMappingURL=motion.d.ts.map

package/node_modules/@allyhub-next/scenery/dist/motion.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{distance as V,dot as k,length as L,normalize as N,sub as j}from"./vec.js";const u=a=>Math.round(a*1e6)/1e6;export function channel(a,d){let r=0,m=d[0]??0,g=0;return a.forEach((x,h)=>{const i=Math.abs(x);g+=i,i>r&&(r=i,m=d[h]??m)}),{peak:u(r),at:u(m),mean:u(a.length>0?g/a.length:0)}}const Q=(a,d)=>{let r=d-a;for(;r>180;)r-=360;for(;r<-180;)r+=360;return r},R=(a,d)=>{const r=Math.max(-1,Math.min(1,k(N(a),N(d))));return Math.acos(r)*180/Math.PI};export function motionOf(a,d=[]){const r=a.length,m=[...d].sort((t,n)=>t-n),g=t=>m.filter(n=>n<=t).length,x=m.filter(t=>t>(a[0]?.t??0)&&t<=(a[r-1]?.t??0)),h={peak:0,at:a[0]?.t??0,mean:0};if(r<2)return{length:0,truck:h,pedestal:h,dolly:h,pan:h,tilt:h,roll:h,zoom:h,speed:h,turn:h,acceleration:h,jerk:h,smoothness:null,step:{distance:0,angle:0,at:a[0]?.t??0},cuts:x.map(u)};const i=[],T=[],q=[],B=[],C=[],D=[],F=[],G=[],S=[],_=[],H=[],y=[],M=[];let J=0,f={distance:0,angle:0,at:a[0]?.t??0},K=!0;for(let t=0;t+1<r;t++){const n=a[t],e=a[t+1];if(!n||!e)continue;const o=e.t-n.t;if(!(o>0)||g(n.t)!==g(e.t))continue;const s=j(e.position,n.position),l=[s[0]/o,s[1]/o,s[2]/o];y.push(l),M.push(g(n.t)),i.push((n.t+e.t)/2),T.push(k(l,n.right)),q.push(k(l,n.up)),B.push(k(l,n.forward)),C.push(Q(n.yaw,e.yaw)/o),D.push((e.pitch-n.pitch)/o),F.push(Q(n.roll,e.roll)/o),G.push((Math.log2(e.lens)-Math.log2(n.lens))/o),_.push(L(l));const w=R(n.forward,e.forward);H.push(w/o),n.target&&e.target?S.push(R(j(n.position,n.target),j(e.position,e.target))/o):K=!1;const c=V(n.position,e.position);J+=c,(c>f.distance||w>f.angle)&&(f={distance:Math.max(f.distance,c),angle:Math.max(f.angle,w),at:n.t})}const b=[],z=[],v=[];for(let t=0;t+1<y.length;t++){if(M[t]!==M[t+1])continue;const n=y[t],e=y[t+1],o=i[t],s=i[t+1];if(!n||!e||o===void 0||s===void 0||!(s>o))continue;const l=j(e,n);b.push([l[0]/(s-o),l[1]/(s-o),l[2]/(s-o)]),z.push((o+s)/2),v.push(M[t]??0)}const P=[],E=[],A=[];for(let t=0;t+1<b.length;t++){if(v[t]!==v[t+1])continue;const n=b[t],e=b[t+1],o=z[t],s=z[t+1];if(!n||!e||o===void 0||s===void 0||!(s>o))continue;const l=j(e,n);P.push([l[0]/(s-o),l[1]/(s-o),l[2]/(s-o)]),E.push((o+s)/2),A.push(v[t]??0)}let O=null;for(const t of new Set(A)){const n=P.filter((c,p)=>A[p]===t),e=E.filter((c,p)=>A[p]===t),o=a.filter(c=>g(c.t)===t).map(c=>c.t),s=Math.max(0,..._.filter((c,p)=>M[p]===t));if(!(s>1e-9)||n.length<2)continue;let l=0;for(let c=0;c+1<n.length;c++){const p=n[c],I=n[c+1],U=(e[c+1]??0)-(e[c]??0);!p||!I||(l+=(k(p,p)+k(I,I))/2*U)}const w=(o.at(-1)??0)-(o[0]??0);if(l>0){const c=u(-Math.log(w**3/(s*s)*l));(O===null||c<O)&&(O=c)}}return{length:u(J),truck:channel(T,i),pedestal:channel(q,i),dolly:channel(B,i),pan:channel(C,i),tilt:channel(D,i),roll:channel(F,i),zoom:channel(G,i),...K&&S.length>0?{arc:channel(S,i)}:{},speed:channel(_,i),turn:channel(H,i),acceleration:channel(b.map(L),z),jerk:channel(P.map(L),E),smoothness:O,step:{distance:u(f.distance),angle:u(f.angle),at:u(f.at)},cuts:x.map(u)}}