allyhub 0.4.0 → 0.5.0

package/dist/node_modules/@allyhub-next/runtime/dist/footage.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{backdropUnit as he,fact as Ue,faceAt as $e,faceOnFrame as pe,facesOnFrame as Ce,forOrient as le,fromEdited as Fe,hasFace as Pe,keyAt as me,MATTE_FEATHER as Oe,MATTE_SHRINK as Se,parsePunch as Ke,pixelRect as Le,placeFootage as Re,problem as Q,pullbackKeys as _e,PULLBACK_DUR as je,PULLBACK_SCALE as Te,PUNCH_CENTER as ke,PUNCH_SCALE as Be,punchKeys as De,REFRAME_FALLBACK as Ne,reframePath as Ge,reframeWindow as ze,sourceAt as He,toFrame as V}from"@allyhub-next/video-core";import{isBoxKeys as Ie}from"./embed.js";import{LoadFailure as We}from"./errors.js";const Je=/\.(png|jpe?g|webp)$/i,Ye=t=>(t.blur??0)>0||(t.dim??0)>0||(t.desaturate??0)>0||t.color!==void 0||t.image!==void 0,S=t=>Math.round(t*1e3)/1e3;export function footagePlanner(t,ge,be,xe){const{source:$,ledger:K,embed:ye}=t,{dims:f,fps:N}=ge,b=[],L=new Map,X=new Set,G=new Map,z=(e,n)=>{const o=G.get(e)??{file:e};o[n]=!0,G.set(e,o)},R=(e,n)=>{K.facts.push(Ue("fallback",{piece:$.piece,part:e},n))},we=(e,n,o)=>{const d=he(f.width,f.height),c=l=>Math.round(l*d*1e3)/1e3;let r;if(e.image!==void 0){if(r=t.mediaOf(e.image,o),r.sha256==="")return;if(r.kind!=="image"||!Je.test(r.path)){K.problems.push(Q("AK-A003",`The background image ${r.path} of footage() in part ${n} is not a PNG, JPEG or WebP image.`,{part:n,where:{file:$.file}}));return}}let u;if(e.color!==void 0){const l=CSS.supports("color",e.color)?xe(e.color):void 0;if(l===void 0)throw new Error(`footage() background color ${JSON.stringify(e.color)} in part ${n} is not a CSS color.`);u=l.length===9&&l.endsWith("00")?"transparent":l}return{backdrop:{...e.blur?{blur:c(e.blur)}:{},...e.dim?{dim:e.dim}:{},...e.desaturate?{desaturate:e.desaturate}:{},...u===void 0?{}:{color:u},...r?{image:r.path}:{},feather:c(e.feather??Oe),shrink:c(e.shrink??Se)},...r?{imageUrl:r.url}:{}}};return{plan:(e,n,o,d,c,r,u)=>{const l=e.file,v=l===void 0;let a;if(v){if(!o){K.problems.push(Q("AK-A001",`footage() in part ${n.key} names no file, so it shows the part's take, and the part has no take. Give footage a file, or give the part speech: take("./clip.mp4").`,{part:n.key,where:{file:$.file}}));return}a=o.media}else a=t.mediaOf(l,e.base);if(a.sha256==="")return;if(a.kind!=="video"){K.problems.push(Q("AK-A003",v?`footage() in part ${n.key} shows the part's take, and ${a.path} is not a video. Give footage a file, or take a video.`:`The footage ${a.path} in part ${n.key} is not a video (mp4, webm or mov).`,{part:n.key,where:{file:$.file}}));return}const k=V(n.start+c,N),_=V(n.start+r,N);if(_<=k)return;a.faces&&L.set(a.path,a.faces),a.matte===!0&&X.add(a.path);let C,F;if(v&&o&&d!==void 0){const i=o.ranges??[{from:o.from,to:o.from+o.dur}];if(C=S(Fe(i,k-d)),o.ranges&&o.ranges.length>1){const h=[{at:k,from:C}];let U=0;for(const A of o.ranges){const p=S(d+U);U>0&&p>k+1e-6&&p<_&&h.push({at:p,from:A.from}),U+=A.to-A.from}h.length>1&&(F=h)}}else C=Math.max(0,typeof e.from=="number"?e.from:0);const x=a.width!==void 0&&a.height!==void 0?{width:a.width,height:a.height}:void 0,Z=e.fit??"cover",H=le(e.box,f.orient),ee=le(e.crop,f.orient),te=Ie(H)?H:void 0,j=te?.map(i=>({t:V(n.start+Math.min(Math.max(u.at(i.t),c),r),N),box:i.box==="full"?[0,0,f.width,f.height]:Le(i.box,f.width,f.height),...i.ease?{ease:i.ease}:{}})).sort((i,h)=>i.t-h.t),Ae=te?"full":H??"full",P=j?.[0],M=Re({box:P?[P.box[0]/f.width,P.box[1]/f.height,P.box[2]/f.width,P.box[3]/f.height]:Ae,fit:Z,...ee?{crop:ee}:{},...x?{source:x}:{},frame:f}),ne=e.shape==="circle"||!e.radius?0:S(Math.min(e.radius*he(f.width,f.height),M.box[2]/2,M.box[3]/2));let I=M.crop,ae=M.picture,y,W;const oe=e.punchIn??[],w=e.pullback===void 0||e.pullback===!1?void 0:e.pullback===!0?{}:e.pullback;if((e.reframe!==void 0||oe.length>0||w)&&x){const i=M.box,h=ze(x,{w:i[2],h:i[3]}),U=typeof e.reframe=="object"&&"face"in e.reframe?e.reframe:void 0,A=e.reframe==="face"||U!==void 0;A&&!a.faces&&(z(a.path,"faces"),R(n.key,{file:a.path,missing:"face-track",for:"reframe",fallback:"centred"}));const p=a.faces,ie=e.speaker??p?.speaker;p&&e.speaker!==void 0&&!Pe(p,e.speaker)&&R(n.key,{file:a.path,missing:"face",face:e.speaker,for:"speaker",fallback:"centred"});const ve=typeof e.reframe=="object"&&"x"in e.reframe?e.reframe:A?Ne:{x:.5,y:.5},ce={start:k,end:_,from:C,speed:v?1:e.speed??1,...F?{cuts:F}:{}};y=Ge({track:A?p:void 0,speaker:ie,faceY:U?.faceY,focus:ve,window:h,source:x,layer:ce});const T=y[0]??{x:0,y:0};I=[T.x,T.y,h.w,h.h],ae=[...i],y.length<=1&&(y=void 0);const B=y,fe=(s,g)=>{if(g)return{cx:g.x,cy:g.y};const m=p?$e(p,He(ce,s),ie):void 0;if(!m)return{cx:ke.x,cy:ke.y};const q=B?me(B.map(O=>({t:O.t,v:O.x})),s):T.x,D=B?me(B.map(O=>({t:O.t,v:O.y})),s):T.y,Me=(m[0]+m[2]/2-q)/h.w,Ee=(m[1]+m[3]/2-D)/h.h;return{cx:S(Math.min(Math.max(Me,0),1)),cy:S(Math.min(Math.max(Ee,0),1))}},Y=[];for(const s of oe){const g=typeof s=="object"?{...s,ref:s.at}:{...Ke(String(s)),until:void 0},m=u.at(g.ref),q=g.until!==void 0?u.at(g.until):be.wordEnd(n.key,m),D=n.start+m;Y.push({start:D,end:n.start+Math.max(q,m),scale:g.scale??Be,...fe(D,typeof s=="object"?s.center:void 0),...typeof s=="object"&&s.in!==void 0?{in:s.in}:{},...typeof s=="object"&&s.out!==void 0?{out:s.out}:{},...typeof s=="object"&&s.ease!==void 0?{ease:s.ease}:{}})}const de=Y.length>0?De(Y):[],ue=w?_e(k,{scale:w.scale??Te,dur:w.dur??je,...fe(k,w.center),...w.ease?{ease:w.ease}:{}},de):de;ue.length>0&&(W=ue)}let J=!1;u.cutout&&(a.matte===!0?J=!0:(z(a.path,"matte"),R(n.key,{file:a.path,missing:"person-matte",for:"behind-person",fallback:"in-front"})));let E;if(e.background&&Ye(e.background)){const i=we(e.background,n.key,e.base);i&&a.matte===!0?E=i:i&&(z(a.path,"matte"),R(n.key,{file:a.path,missing:"person-matte",for:"background",fallback:"unprocessed"}))}if(ye)throw new We("embedded_footage",`${$.piece}'s part ${n.key} plays ${a.path}: a video shown inside another (a scenery's screen, a part's video take, a footage of a video item) draws its graphic layers only, not footage yet.`);const re=J&&u.person,se={part:n.key,file:a.path,start:k,end:_,from:C,speed:v?1:e.speed??1,gainDb:e.gainDb??0,audio:(e.audio??!1)&&a.audio===!0,...v?{take:!0}:{},fit:Z,box:M.box,...I?{crop:I}:{},picture:ae,...F?{cuts:F}:{},...y?{pan:y}:{},...W?{zoom:W}:{},...j&&j.length>1?{boxes:j}:{},...u.over>0?{over:u.over}:{},...J?{cutout:!0}:{},...e.sharpen?{sharpen:e.sharpen}:{},...E?{background:E.backdrop}:{},...E?.imageUrl?{imageUrl:E.imageUrl}:{},...(re||E)&&a.matteUrl?{matteUrl:a.matteUrl}:{},...re?{personOver:!0}:{},...e.shape==="circle"?{shape:"circle"}:{},...ne>0?{radius:ne}:{},...e.speaker===void 0?{}:{speaker:e.speaker},url:a.url,...a.duration===void 0?{}:{duration:a.duration},...x?{source:x}:{}};return b.push(se),se},placed:b,needs:()=>[...G.values()],speakerIn:e=>b.some(n=>n.part===e&&(L.has(n.file)||X.has(n.file))),faceAt(e,n,o){for(let d=b.length-1;d>=0;d--){const c=b[d];if(c?.part!==e||n<c.start||n>=c.end)continue;const r=L.get(c.file);if(!r)continue;const u=o===void 0?pe(c,r,n):pe(c,r,n,o);if(u)return u}},facesAt(e,n){for(let o=b.length-1;o>=0;o--){const d=b[o];if(d?.part!==e||n<d.start||n>=d.end)continue;const c=L.get(d.file);if(!c)continue;const r=Ce(d,c,n);if(r.length>0)return r}return[]}}}export function timelineFootage(t){return{part:t.part,file:t.file,start:t.start,end:t.end,from:t.from,speed:t.speed,gainDb:t.gainDb,audio:t.audio,...t.take?{take:!0}:{},fit:t.fit,box:t.box,...t.crop?{crop:t.crop}:{},picture:t.picture,...t.cuts?{cuts:t.cuts}:{},...t.pan?{pan:t.pan}:{},...t.zoom?{zoom:t.zoom}:{},...t.boxes?{boxes:t.boxes}:{},...t.over?{over:t.over}:{},...t.cutout?{cutout:!0}:{},...t.sharpen?{sharpen:t.sharpen}:{},...t.background?{background:t.background}:{},...t.shape?{shape:t.shape}:{},...t.radius?{radius:t.radius}:{},...t.speaker===void 0?{}:{speaker:t.speaker}}}

package/dist/node_modules/@allyhub-next/runtime/dist/reads.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{pathIn as g,asUrlString as l,displayOf as c,fillMessage as f,lineAnchors as m,messageList as A,problem as r,repoPath as u,speakOf as w,textsOf as p,hasMarks as O,withoutMarks as k}from"@allyhub-next/video-core";import{TEXT_DIR as $}from"@allyhub-next/formats";const v="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII=",b=3;export class ReadLog{messages=new Map;media=new Map;data=new Map;keyByText=new Map;missingReads=new Set;missingMedia=new Set;problems=[];texts=new Set;tap;opts;fileOf;constructor(t){this.opts=t,this.fileOf=e=>`${t.text??$}/${e??"en"}.json`}value(t){const{own:e,fallback:i,lang:s,defaultLang:n}=this.opts;return Object.hasOwn(e,t)?{value:e[t],fellBack:!1}:Object.hasOwn(i,t)?{value:i[t],fellBack:s!==n}:{value:void 0,fellBack:!1}}record(t,e,i){if(this.messages.has(t))return;const{value:s,fellBack:n}=this.value(t);if(this.messages.set(t,{key:t,kind:e,fallback:n,...i?{hint:i}:{}}),e!=="list"&&s===void 0){const a=t.slice(t.indexOf(".")+1),h=Object.keys(this.opts.fallback).find(d=>d.endsWith(`.${a}`));this.problems.push(r("AK-S001",`The code reads ${t}, but the default language ${this.opts.defaultLang??"(no messages)"} does not have it. ${h===void 0?`Add it to ${this.fileOf(this.opts.defaultLang)}.`:`It has ${h}: read that, or give the piece the id "${t.slice(0,t.indexOf("."))}".`}`,{where:{file:this.fileOf(this.opts.defaultLang)}}))}}locale(t){return Object.hasOwn(this.opts.own,t)?this.opts.lang:this.opts.defaultLang}text(t,e,i){this.record(t,"text",e);const{value:s}=this.value(t);this.tap?.(`m:${t}`,JSON.stringify(s??null));for(const n of p(s))this.texts.add(n);return c(s,i,this.locale(t))??""}s(t,e){const i=this.text(t,e,{});return i&&this.keyByText.set(i,{key:t,inputs:{}}),i}with(t,e,i){const s=f(this.text(t,i,e),e);return this.texts.add(s),s&&this.keyByText.set(s,{key:t,inputs:e}),s}spokenOf(t){const e=this.keyByText.get(t);if(!e)return;const i=w(this.value(e.key).value,e.inputs,this.locale(e.key)),s=(Object.hasOwn(this.opts.own,e.key)?this.opts.anchors?.own:this.opts.anchors?.fallback)?.[e.key];return{key:e.key,speak:i===void 0?t:f(i,e.inputs),...s&&i!==void 0?{anchors:m(i,s,n=>f(n,e.inputs))}:{}}}list(t,e){const i=[],s=new Set([...Object.keys(this.opts.own),...Object.keys(this.opts.fallback)]),n=A(a=>c(this.value(a).value,{},this.locale(a)),s,t,i);this.record(t,"list",e),i.length===0&&this.problems.push(r("AK-S001",`The code reads the list ${t}, but the default language has no keys like ${t}.0, ${t}.1. Add them to ${this.fileOf(this.opts.defaultLang)}.`,{where:{file:this.fileOf(this.opts.defaultLang)}}));for(const a of i)this.text(a,void 0,{});return n}keysUnder(t){const e=`${t}.`;return[...new Set([...Object.keys(this.opts.own),...Object.keys(this.opts.fallback)])].filter(i=>i.startsWith(e))}peek(t){return this.value(t).value}touch(t){const{value:e,fellBack:i}=this.value(t);return this.tap?.(`m:${t}`,JSON.stringify(e??null)),e!==void 0&&!this.messages.has(t)&&this.messages.set(t,{key:t,kind:"text",fallback:i}),e}mediaAt(t){const e=this.opts.media[t];return e&&this.media.set(t,l(e)),this.tap?.(`f:${t}`,e?.sha256??""),e}missing(t){this.missingReads.add(t)}report(t){this.problems.some(e=>e.code===t.code&&e.message===t.message)||this.problems.push(t)}relativeTo(t){this.base=t}base;get pathBase(){return this.base??this.opts.file}baseOf(t){return t===void 0?this.pathBase:t===""?"the project's root":t}resolve(t,e){return e===void 0?u(this.pathBase,t):g(e,t)}asset(t,e){const i=this.baseOf(e),s=this.resolve(t,e),n=s===void 0?void 0:this.mediaAt(s);if(n)return n;const a=s??t;return this.missingMedia.has(a)||(this.missingMedia.add(a),this.problems.push(r("AK-A001",s===void 0?`"${t}" points outside the project. Put media in the project, with a path relative to ${i}.`:`"${t}" (named in ${i}) cannot find ${s}: the path is wrong, or the file is not in the project yet.`,{where:{file:i}}))),l({path:s??t,sha256:"",kind:"image",url:v,width:1,height:1})}optionalAsset(t){const e=u(this.pathBase,t);if(e===void 0)return;const i=this.mediaAt(e);return i||this.missing(e),i?l(i):void 0}optionalData(t,e){const i=this.resolve(t,e);if(i===void 0)return{found:!1};const s=this.opts.data?.[i];return this.data.set(i,s?.sha256??""),s?s.error===void 0?{full:i,found:!0,value:s.value}:{full:i,found:!0,error:s.error}:{full:i,found:!1}}readData(t){const e=u(this.pathBase,t),i=e===void 0?void 0:this.opts.data?.[e];if(e!==void 0&&i){if(this.data.set(e,i.sha256),this.tap?.(`d:${e}`,i.sha256),i.error===void 0)return i.value;this.missingMedia.has(e)||(this.missingMedia.add(e),this.problems.push(r("AK-R001",`Cannot read the data file ${e}: ${i.error}`,{where:{file:e}})));return}this.missingMedia.has(t)||(this.missingMedia.add(t),this.problems.push(r("AK-A001",e===void 0?`ctx.data("${t}") points outside the project. Put data files in the project, with a path relative to ${this.pathBase}.`:`ctx.data("${t}") cannot find ${e}: the path is wrong, or the file is not CSV, YAML or JSON.`,{where:{file:this.pathBase}})))}reads(t,e){const i=s=>{if(!s.startsWith(`${t}.`))return;const n=s.slice(t.length+1).split(".")[0]??"";return e.includes(n)?n:void 0};return{messages:[...this.messages.values()].map(s=>{const n=i(s.key);return n===void 0?s:{...s,part:n}}).sort((s,n)=>s.key<n.key?-1:s.key>n.key?1:0),media:[...[...this.media.values()].map(s=>({path:s.path,sha256:s.sha256,kind:s.kind})),...[...this.missingReads].filter(s=>!this.media.has(s)).map(s=>({path:s,sha256:"",kind:"audio"}))].sort((s,n)=>s.path<n.path?-1:1),data:[...this.data.entries()].map(([s,n])=>({path:s,sha256:n})).sort((s,n)=>s.path<n.path?-1:1)}}translationProblems(){const t=[];for(const e of this.messages.values())e.fallback&&e.kind==="text"&&t.push(r("AK-S002",`${this.opts.lang??""} is missing a translation: ${e.key}. The ${this.opts.defaultLang??""} text was used.`,{where:{file:this.fileOf(this.opts.lang)}}));return t}keysShowing(t){const e=h=>h.replace(/[\s\p{Cf}]+/gu,""),i=e(t);if(i==="")return[];const s=[],n=[];for(const h of this.messages.values()){const d=p(this.peek(h.key)).flatMap(o=>O(o)?[o,k(o)]:[o]).map(e);d.includes(i)?s.push(h.key):d.some(o=>o.includes(i))&&n.push(h.key)}return s.length>0?s:(i.match(/[\p{L}\p{N}]/gu)?.length??0)>=b?n:[]}get file(){return this.fileOf(this.opts.lang)}}

package/dist/node_modules/@allyhub-next/runtime/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@allyhub-next/runtime",
+  "version": "0.5.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./bridge": {
+      "types": "./dist/bridge.d.ts",
+      "default": "./dist/bridge.js"
+    },
+    "./stage": {
+      "types": "./dist/stage-kit.d.ts",
+      "default": "./dist/stage-kit.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub-next/runtimes/dist/lock.d.ts

@@ -0,0 +1,8 @@
+export interface LockOptions {
+    signal?: AbortSignal | undefined;
+    pollMs?: number;
+    /** Called once, when the lock is another's and this waits for it. */
+    onWait?: () => void;
+}
+export declare function withLock<T>(path: string, run: () => Promise<T>, options?: LockOptions): Promise<T>;
+//# sourceMappingURL=lock.d.ts.map

package/dist/node_modules/@allyhub-next/runtimes/dist/lock.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{setTimeout as c}from"node:timers/promises";import{lock as m}from"proper-lockfile";export async function withLock(r,l,f={}){const{signal:o,pollMs:n=150,onWait:s}=f;let e,a,i=!1;for(;;){o?.throwIfAborted();try{a=await m(r,{lockfilePath:r,realpath:!1,onCompromised:t=>{e=t}});break}catch(t){if(t.code!=="ELOCKED")throw t;i||s?.(),i=!0,await c(n,void 0,o?{signal:o}:{})}}try{const t=await l();if(e)throw e;return t}finally{e||await a()}}

package/dist/node_modules/@allyhub-next/runtimes/dist/runtimes.d.ts

@@ -0,0 +1,69 @@
+import { type Platform, type RuntimeManifest } from "@allyhub-next/protocol";
+export interface RuntimesOptions {
+    /** The cache folder (default: the system's, `cacheHome`). */
+    home?: string;
+    manifest?: RuntimeManifest;
+    /** The platform (default: this process's). */
+    platform?: Platform | undefined;
+    env?: Readonly<Record<string, string | undefined>>;
+    fetch?: typeof globalThis.fetch;
+    /**
+     * Where a download no `onProgress` follows says how it goes (default:
+     * stderr): most commands get a runtime in passing, and minutes of silence
+     * read as a hang to whoever runs them.
+     */
+    log?: (line: string) => void;
+}
+export interface Located {
+    name: string;
+    /** The pinned version; none for programs the environment names, whose version is their own. */
+    version: string | undefined;
+    /** Its folder; for one named by the environment, where its first program is. */
+    dir: string;
+    /** Its programs, by name, at their absolute paths. */
+    bins: Record<string, string>;
+    /** Where it was found. */
+    from: "cache" | "env";
+}
+export interface Status {
+    name: string;
+    about: string;
+    version: string;
+    license: string;
+    /** It has files for this platform. */
+    available: boolean;
+    installed: boolean;
+    /** Where it is, when it is. */
+    from?: "cache" | "env";
+    /** What it downloads, in bytes. */
+    size: number;
+    dir: string;
+}
+export interface Progress {
+    runtime: string;
+    url: string;
+    received: number;
+    total: number;
+}
+export interface EnsureOptions {
+    signal?: AbortSignal | undefined;
+    onProgress?: (progress: Progress) => void;
+}
+export interface Runtimes {
+    readonly home: string;
+    readonly platform: Platform | undefined;
+    /** Every runtime of the manifest, as it stands on this computer. */
+    status(): Promise<Status[]>;
+    /** A runtime if it is there; never downloads. */
+    locate(name: string): Promise<Located | undefined>;
+    /** A runtime, downloaded and checked first if it is not there. */
+    ensure(name: string, options?: EnsureOptions): Promise<Located>;
+    /** One program of a runtime, ensured. */
+    bin(name: string, bin: string, options?: EnsureOptions): Promise<string>;
+    /** Takes a runtime off this computer; it comes back when next ensured. */
+    remove(name: string): Promise<void>;
+}
+/** The variable that names a program on the computer: ALLYHUB_FFMPEG, ALLYHUB_YT_DLP. */
+export declare const binVariable: (bin: string) => string;
+export declare function createRuntimes(options?: RuntimesOptions): Runtimes;
+//# sourceMappingURL=runtimes.d.ts.map

package/dist/node_modules/@allyhub-next/runtimes/dist/runtimes.js

@@ -0,0 +1,4 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{randomBytes as W}from"node:crypto";import{chmod as _,mkdir as R,readFile as T,rename as P,rm as k,writeFile as V}from"node:fs/promises";import{dirname as U,join as d}from"node:path";import{binsOf as A,filesFor as B,platformOf as Y}from"@allyhub-next/protocol";import{download as q,sha256Of as G}from"./download.js";import{RuntimeError as m}from"./errors.js";import{cacheHome as K}from"./home.js";import{withLock as Q}from"./lock.js";import{shippedManifest as X}from"./manifest.js";import{inside as C,native as Z,undmg as tt,untgz as et,unzip as rt}from"./unpack.js";const D=".allyhub-runtime.json";export const binVariable=i=>`ALLYHUB_${i.toUpperCase().replaceAll("-","_")}`;const x=i=>`${String(Math.max(1,Math.round(i/1e6)))} MB`;function nt(i,b,w,g){g(`Downloading ${i} ${b} (${x(w)}), once…`);let h=0;return u=>{const $=Math.floor(u/w*10)*10;$!==h&&(h=$,g(`  ${String($)}% (${x(u)} of ${x(w)})`))}}export function createRuntimes(i={}){const b=i.log??(t=>{process.stderr.write(`${t}
+`)}),w=i.env??process.env,g=i.home??K(w),h=i.manifest??X(),u="platform"in i?i.platform:Y(process.platform,process.arch),$=i.fetch??globalThis.fetch,S=d(g,"runtimes"),z=t=>{const e=Object.hasOwn(h.runtimes,t)?h.runtimes[t]:void 0;if(!e)throw new m("unknown-runtime",`AllyHub has no runtime "${t}".`);return e},p=(t,e)=>d(S,`${t}@${e.version}`),O=(t,e)=>{const r=u?B(e,u):void 0;if(!r)throw new m("unsupported",`${t} ${e.version} has no build for ${u??`${process.platform}-${process.arch}`}.`);return r},F=(t,e,r)=>Object.fromEntries(Object.entries(A(O(t,e))).map(([n,s])=>[n,d(r,Z(s))])),E=(t,e)=>{const r=[...new Set(Object.values(e.platforms).flatMap(c=>Object.keys(A(c))))];if(r.length===0)return;const n=r.map(c=>[c,w[binVariable(c)]]);if(n.some(([,c])=>!c))return;const s=Object.fromEntries(n),a=n[0]?.[1]??"";return{name:t,version:void 0,dir:U(a),bins:s,from:"env"}},j=async(t,e)=>{try{const r=JSON.parse(await T(d(p(t,e),D),"utf8")),n=O(t,e).map(s=>s.sha256);return r.version===e.version&&JSON.stringify(r.files)===JSON.stringify(n)}catch{return!1}},M=async t=>{const e=z(t),r=E(t,e);if(r)return r;if(!await j(t,e))return;const n=p(t,e);return{name:t,version:e.version,dir:n,bins:F(t,e,n),from:"cache"}},H=async(t,e,r)=>{const n=O(t,e),s=p(t,e),a=`${s}.partial-${String(process.pid)}-${W(4).toString("hex")}`,c=d(a,".downloads");await R(c,{recursive:!0});const I=r.onProgress?void 0:nt(t,e.version,n.reduce((l,o)=>l+o.size,0),b);let N=0;try{for(const[l,o]of n.entries()){const v=d(c,String(l));if(await q(o.url,v,{size:o.size,sha256:o.sha256,fetch:$,signal:r.signal,onProgress:(f,y)=>{I?.(N+f),r.onProgress?.({runtime:t,url:o.url,received:f,total:y})}}),N+=o.size,o.unpack==="zip")await rt(v,a);else if(o.unpack==="tgz")await et(v,a);else if(o.unpack==="dmg")await tt(v,a);else{const f=C(a,o.name??st(o.url));if(!f)throw new m("unpack",`${o.url} would be kept outside its folder.`);await R(U(f),{recursive:!0}),await P(v,f),o.executable&&await _(f,493)}for(const f of o.check){const y=C(a,f.path),J=y?await G(y).catch(()=>"missing"):"missing";if(J!==f.sha256)throw new m("checksum",`${f.path} from ${o.url} has sha256 ${J}; its pin is ${f.sha256}.`)}}await k(c,{recursive:!0,force:!0}),await V(d(a,D),`${JSON.stringify({version:e.version,files:n.map(l=>l.sha256),at:new Date().toISOString()})}
+`),await k(s,{recursive:!0,force:!0}),await P(a,s)}catch(l){throw await k(a,{recursive:!0,force:!0}),l}},L=async(t,e={})=>{const r=z(t),n=await M(t);if(n)return n;O(t,r),await R(S,{recursive:!0}),await Q(`${p(t,r)}.lock`,async()=>{await j(t,r)||await H(t,r,e)},{signal:e.signal,onWait:()=>{b(`Waiting for ${t}, which another command is getting…`)}});const s=await M(t);if(!s)throw new m("download",`${t} was installed but cannot be found in ${S}.`);return s};return{home:g,platform:u,locate:M,ensure:L,async bin(t,e,r){const s=(await L(t,r)).bins[e];if(!s)throw new m("unknown-runtime",`${t} holds no program "${e}".`);return s},async remove(t){const e=z(t);await k(p(t,e),{recursive:!0,force:!0})},async status(){return Promise.all(Object.entries(h.runtimes).map(async([t,e])=>{const r=u?B(e,u):void 0,n=p(t,e),s=E(t,e)!==void 0?"env":r!==void 0&&await j(t,e)?"cache":void 0;return{name:t,about:e.about,version:e.version,license:e.license,available:r!==void 0,installed:s!==void 0,...s?{from:s}:{},size:(r??[]).reduce((a,c)=>a+c.size,0),dir:n}}))}}}const st=i=>decodeURIComponent(new URL(i).pathname.split("/").pop()??"file");

package/dist/node_modules/@allyhub-next/runtimes/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "@allyhub-next/runtimes",
+  "version": "0.5.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node-program.d.ts",
+      "default": "./dist/node-program.js"
+    },
+    "./manifest.json": "./manifest.json"
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

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

@@ -0,0 +1,16 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{mkdir as c,readFile as y,writeFile as d}from"node:fs/promises";import{basename as f,join as a,resolve as h}from"node:path";export const PROJECT_PACKAGES={cli:"allyhub",sdk:"@allyhub/sdk"},PROJECT_TYPESCRIPT="~5.9.3",PROJECT_GITIGNORE=`node_modules/
+.allyhub/
+.playwright-cli/
+`,SDK_DOCS=[["project.md","folders, items and entry files, imports, scripts and shared text, allyhub.config.ts, fonts"],["contract.md","a frame drawn from its time alone, drawn offline, problems and their rules"],["video.md","video(), formats, part(), layers and stacking, transitions, the look, capture, post"],["layers.md","defineComponent(), custom(), the layer's ctx, DOM, animation, path, noise and input helpers, starter components"],["speech.md","take(), say(), word references, anchors, shown and said, captions, edits files"],["sound.md","music, sound effects, the mix, the master, mic"],["footage.md","footage(): placing, cropping, reframing, faces and mattes, a video item inside another"],["slides.md","slides(), layouts, slides.yaml's pages and what is placed on them, steps, speaker notes"],["batches.md","the matrix: dimensions, slots, pools, rules, combos"],["scenery.md","3D sceneries: defineScenery(), cameras and moves, the scenery() layer, screens"],["modeling.md","props modelled in code with @allyhub-next/model"],["docs.md","a doc (doc.mdx): its title, the Markdown and tags it reads, pictures and links, comments"],["sheets.md","a sheet (sheet.yaml and CSV): Excel's model as text, the openpyxl API, formulas, tables, names, checks, sheet.ts, scenarios, calc, trace, render"],["defaults.md","every default of the piece API and the option that changes it"]],REGISTRY="https://allyhub.com/r",MASTER_SKILL="allyhub";export function workSkills(t){return t.filter(e=>e.type==="allyhub:skill"&&e.name!==MASTER_SKILL).map(e=>({name:e.name,description:e.description.replaceAll(/\s+/gu," ").trim()}))}export const AGENT_RULES_BEGIN="<!-- BEGIN:allyhub-agent-rules -->",AGENT_RULES_END="<!-- END:allyhub-agent-rules -->";export function agentRules(){return[AGENT_RULES_BEGIN,"",`Before writing or changing a video, a deck, a doc, a sheet, a 3D scenery or a 3D model, read the files it needs in the SDK's docs, for the version this project builds with: \`node_modules/${PROJECT_PACKAGES.sdk}/docs/\` once the project has installed it; without it, \`allyhub help\` says where they are (the SDK the CLI lends). The API has changed from what you may know; the docs and the SDK's types are right.`,"",...SDK_DOCS.map(([t,e])=>`- ${t}: ${e}`),"","`allyhub help` lists AllyHub's commands (`npx allyhub help` once the project has installed it); `allyhub help <command>` says what one does.","","`allyhub skills` lists AllyHub's work skills, each how to make one kind of work; `allyhub skills show <name>` prints one, `allyhub add skill/<name>` adds it to this project.","",AGENT_RULES_END].join(`
+`)}export function projectAgents(){return`# AllyHub project
+
+This folder is an AllyHub project. Videos, 3D sceneries and 3D models are TypeScript, docs MDX, sheets YAML and CSV: each is a folder with its entry file (\`video.ts\`, \`scenery.ts\`, \`model.ts\`, \`doc.mdx\`, \`sheet.yaml\`), wherever it suits the project; a model is made once and put in any scenery that imports it.
+
+- A video or a scenery is code: where the project has no package.json yet, \`npm create allyhub@latest .\` then \`npm install\`.
+
+${agentRules()}
+`}export const PROJECT_CLAUDE=`@AGENTS.md
+`,PROJECT_TSCONFIG=`${JSON.stringify({compilerOptions:{target:"ES2022",module:"ESNext",moduleResolution:"Bundler",lib:["ES2022","DOM","DOM.Iterable"],types:[`${PROJECT_PACKAGES.sdk}/client`,`${PROJECT_PACKAGES.cli}/client`],strict:!0,noEmit:!0,skipLibCheck:!0,verbatimModuleSyntax:!0,allowImportingTsExtensions:!0},include:["**/*.ts",".allyhub/cache/types"],exclude:["node_modules"]},null,2)}
+`;export function packageName(t){const e=t.toLowerCase().normalize("NFKD").replace(/\p{M}/gu,"").replace(/[^\w.-]+/gu,"-").replace(/^[-._]+|[-._]+$/gu,"").slice(0,214);return e===""?"allyhub-project":e}const l=t=>y(t).then(()=>!0,()=>!1);export async function writeAgentFiles(t){const e=h(t);await c(e,{recursive:!0});const s=[];for(const[n,r]of[["AGENTS.md",projectAgents()],["CLAUDE.md",PROJECT_CLAUDE]])await l(a(e,n))||(await d(a(e,n),r,{flag:"wx"}),s.push(n));return s}export async function startProject(t,e){const s=h(t);if(await l(a(s,"package.json")))throw new Error(`${s} already has a package.json: add AllyHub to it with npm install ${PROJECT_PACKAGES.cli} ${PROJECT_PACKAGES.sdk}.`);const n=packageName(f(s)),r=o=>e.packages?.[o]??e.version,p={name:n,version:"0.0.0",private:!0,type:"module",scripts:{dev:"allyhub dev",check:"allyhub check",render:"allyhub render",typecheck:"tsc --noEmit"},dependencies:{[PROJECT_PACKAGES.cli]:r(PROJECT_PACKAGES.cli),[PROJECT_PACKAGES.sdk]:r(PROJECT_PACKAGES.sdk)},devDependencies:{typescript:PROJECT_TYPESCRIPT}},m=[["package.json",`${JSON.stringify(p,null,2)}
+`],["tsconfig.json",PROJECT_TSCONFIG],[".gitignore",PROJECT_GITIGNORE]];await c(s,{recursive:!0});const i=[];for(const[o,u]of m)await l(a(s,o))||(await d(a(s,o),u,{flag:"wx"}),i.push(o));return i.push(...await writeAgentFiles(s)),{folder:s,name:n,files:i}}

package/dist/node_modules/@allyhub-next/scaffold/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub-next/scaffold",
+  "version": "0.5.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

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

@@ -0,0 +1,143 @@
+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;
+    /**
+     * How the phone grades what it films: the part's `post` wherever a part
+     * sets none. null for no grade.
+     */
+    grade?: {
+        filter: string;
+    } | null;
+}
+/** 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/dist/node_modules/@allyhub-next/scenery/dist/phone.d.ts

@@ -0,0 +1,36 @@
+import type { HandheldOptions } from "./handheld.js";
+import type { LensFrame } from "./lens.js";
+import type { SensorOptions } from "./moire.js";
+/** What a phone's camera is, as the options of each mechanism. */
+export interface PhoneCamera {
+    /** A camera state's lens: 35 mm-equivalent focal length on the phone's 4:3 frame, and its aperture in the same terms. */
+    lens: {
+        lens: number;
+        lensFrame: LensFrame;
+        aperture: number;
+    };
+    /** The sensor filming a screen: its photosites, the lens's own blur on them, its moiré and false colour, its distortion. */
+    sensor: SensorOptions;
+    /** handheld(camera, hand): the hand, its stabiliser, its autofocus and auto-exposure. */
+    hand: HandheldOptions;
+}
+/**
+ * A phone's main camera filming a screen or a room indoors, held in a
+ * hand: a 26 mm lens on its 4:3 frame at f/8 equivalent (f/1.8 on its
+ * small sensor), a 12 MP sensor, a hand whose tremor its stabiliser mostly
+ * takes out, focus that hunts after a cut, a reframe or a jolt, exposure
+ * that follows a new framing late, and a grade that takes a render's flat,
+ * pale, cool picture to the contrast and colour of a phone filming a screen:
+ * a screen's white stays near white, and what is dark goes darker.
+ */
+export declare const PHONE_CAMERA: PhoneCamera;
+/** Something with every field optional, all the way down. */
+export type Deeper<T> = {
+    [K in keyof T]?: T[K] extends readonly unknown[] ? T[K] : T[K] extends object ? Deeper<T[K]> : T[K];
+};
+/**
+ * PHONE_CAMERA with any of its values changed (`{ hand: { tremor: { angle:
+ * 0.2 } } }` changes that one and keeps the rest).
+ */
+export declare function phoneCamera(over?: Deeper<PhoneCamera>): PhoneCamera;
+//# sourceMappingURL=phone.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const PHONE_CAMERA={lens:{lens:26,lensFrame:"phone",aperture:8},sensor:{photosites:4032,lens:.35,moire:1,chroma:.3,distortion:-.03,grade:{filter:"curves=all='0/0 0.2/0.07 0.5/0.38 0.78/0.82 1/1',eq=saturation=1.5,colortemperature=temperature=6000"}},hand:{angle:.25,roll:.6,shift:.001,sway:.65,tremor:{angle:.1,frequency:8.5},drift:{angle:.15,shift:.001,period:8},stabilizer:{strength:.7,cutoff:1.5},autofocus:{},exposure:{}}};const s=e=>typeof e=="object"&&e!==null&&!Array.isArray(e);function i(e,r){if(!s(e)||!s(r))return r===void 0?e:r;const n={...e};for(const[t,o]of Object.entries(r))n[t]=o===void 0?e[t]:i(e[t],o);return n}export function phoneCamera(e={}){return i(PHONE_CAMERA,e)}

package/dist/node_modules/@allyhub-next/scenery/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@allyhub-next/scenery",
+  "version": "0.5.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

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

@@ -0,0 +1,75 @@
+import { type Plugin, type UserVite } from "@allyhub-next/build";
+/** Where a stage serves three.js's decoders (draco/, basis/): this folder beside its pieces/ and chunks/. */
+export { stageCameras, writeModelStage } from "./model-stage.js";
+export declare const THREE_LIBS = "three-libs";
+/** Where a stage serves the wasm files a scenery page loads. */
+export declare const WASM_DIR = "wasm";
+/** three.js's examples/jsm/libs folder (draco/, basis/), of the copy this package depends on. */
+export declare function threeLibsDir(): string;
+/** manifold-3d's wasm, of the copy AllyHub has. */
+export declare function manifoldWasmFile(): Promise<string>;
+/** xatlas-web's wasm, of the copy this package depends on. */
+export declare function xatlasWasmFile(): string;
+/** Copies three's decoders into a stage's folder, as `three-libs/draco/` and `three-libs/basis/`. */
+export declare function copyDecoders(stageDir: string): Promise<void>;
+/**
+ * Lends three.js to a project that does not declare it: "three" and
+ * "three/…" resolve to this package's pinned copy, from anywhere (three's
+ * addons import "three" too, and must get the same copy). A project that
+ * declares its own builds with it.
+ */
+export declare function lendThree(opts: {
+    /** Package names the project's package.json declares. */
+    dependencies: ReadonlySet<string>;
+}): Plugin;
+/**
+ * Resolves manifold-3d to the copy AllyHub has: it does not install with
+ * AllyHub, so nothing beside the layer or the modelling library that import it
+ * holds it. Every build a scenery can be in needs this: a stage's as well.
+ */
+export declare function lendManifold(): Plugin;
+/** Resolves this package's own entry points, which the entries the build writes import: never the project's. */
+export declare function hostResolve(): Plugin;
+/**
+ * Ends each scenery item's entry module (…/scenery.ts) with a call
+ * that records which file its scenery came from (module.ts's markScenery),
+ * so a scenery() layer that draws it finds the paths it names from its own
+ * module. A module whose default export is not written `export default …`
+ * is left as it is.
+ */
+export declare function sceneryModules(opts: {
+    root: string;
+}): Plugin;
+export interface SceneryBundle {
+    /** The bundle's file, relative to the build folder. */
+    module: string;
+    /** Where three's decoders are, relative to the build folder (a folder, ending in "/"). */
+    decoders: string;
+    /** manifold-3d's wasm, relative to the build folder, for overlap volumes. */
+    manifoldWasm: string;
+    /** xatlas-web's wasm, relative to the build folder, for a bake. */
+    xatlasWasm: string;
+    /** The project's files bundled into it (project paths). */
+    files: string[];
+}
+/**
+ * Bundles a scenery module (a project path) with this package's page half
+ * into the build folder's stage, as `stage/pieces/scenery__<name>.<hash>.js`,
+ * which exports the scenery as `scenery` and everything of this package's
+ * page half (openScenery, startViewer…): the page that loads it calls them
+ * with its own adapter. `plugins` are the stage's own (AllyHub's, which
+ * read media and refuse what a project may not import), run after this
+ * package's.
+ */
+export declare function bundleScenery(opts: {
+    root: string;
+    /** The scenery module, a project path. */
+    file: string;
+    /** The build folder. */
+    outDir: string;
+    /** Package names the project's package.json declares. */
+    dependencies: ReadonlySet<string>;
+    plugins: Plugin[];
+    user?: UserVite;
+}): Promise<SceneryBundle>;
+//# sourceMappingURL=bundle.d.ts.map

package/dist/node_modules/@allyhub-next/scenery-host/dist/bundle.js

@@ -0,0 +1,6 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{realpathSync as _}from"node:fs";import{cp as S,copyFile as d,mkdir as y,writeFile as v}from"node:fs/promises";import{createRequire as W}from"node:module";import{dirname as l,join as o,relative as j,sep as p}from"node:path";import{fileURLToPath as c}from"node:url";import{bundleForStage as D}from"@allyhub-next/build";import{entryKind as F}from"@allyhub-next/formats";import{manifoldFiles as h}from"@allyhub-next/model/build";export{stageCameras,writeModelStage}from"./model-stage.js";export const THREE_LIBS="three-libs",WASM_DIR="wasm";const i="@allyhub-next/scenery-host",O="manifold-3d/manifold",k=new Set(["three"]),E=W(import.meta.url);export function threeLibsDir(){return l(l(c(import.meta.resolve("three/addons/libs/draco/draco_decoder.wasm"))))}export async function manifoldWasmFile(){return(await h()).wasm}export function xatlasWasmFile(){return E.resolve("xatlas-web/dist/xatlas-web.wasm")}export async function copyDecoders(e){const r=threeLibsDir();for(const t of["draco","basis"])await S(o(r,t),o(e,THREE_LIBS,t),{recursive:!0})}function M(e){const r=e.split("/");return e.startsWith("@")?r.slice(0,2).join("/"):r[0]??e}export function lendThree(e){return{name:"allyhub-scenery-three",enforce:"pre",resolveId(r){const t=M(r);if(!k.has(t)||e.dependencies.has(t))return null;try{return c(import.meta.resolve(r))}catch{return null}}}}export function lendManifold(){return{name:"allyhub-scenery-manifold",enforce:"pre",async resolveId(e){return e===O?(await h()).js:null}}}export function hostResolve(){return{name:"allyhub-scenery-host",enforce:"pre",resolveId(e){return e!==i&&!e.startsWith(`${i}/`)?null:c(import.meta.resolve(e))}}}const w=/(^|\n)export default\s+/;function b(e){let r=e;try{r=_(e)}catch{}return t=>{for(const a of[r,e]){const n=j(a,t).split(p).join("/");if(!n.startsWith("..")&&!n.startsWith("/"))return n}}}export function sceneryModules(e){const r=b(e.root);return{name:"allyhub-scenery-modules",enforce:"post",transform(t,a){const n=r(a.replace(/[?#].*$/,""));return n===void 0||F(n)!=="scenery"||!w.test(t)?null:{code:`${t.replace(w,"$1const __allyhubScenery = ")}
+import { markScenery as __allyhubMark } from ${JSON.stringify(`${i}/module`)};
+export default __allyhubMark(__allyhubScenery, ${JSON.stringify(n)});
+`,map:null}}}}const N=e=>e.replace(/\.[^.]+$/,"").replace(/[^A-Za-z0-9]+/g,"_").replace(/^_+|_+$/g,"");export async function bundleScenery(e){const r=`scenery__${N(e.file)}`,t=o(e.outDir,"sceneries",`${r}.entry.js`);await y(l(t),{recursive:!0});const a=o(e.root,e.file).split(p).join("/");await v(t,["// Written by allyhub for a scenery page: the scenery and its host, one bundle.",`export { default as scenery } from ${JSON.stringify(a)};`,`export * from ${JSON.stringify(i)};`,""].join(`
+`));const n=o(e.outDir,"stage"),u=await D({root:e.root,entries:{[r]:t},outDir:n,plugins:[hostResolve(),lendManifold(),lendThree({dependencies:e.dependencies}),sceneryModules({root:e.root}),...e.plugins],...e.user?{user:e.user}:{}}),f=u.entries[r];if(!f)throw new Error(`The scenery ${e.file} did not bundle.`);const x=b(e.root),m=new Set;for(const g of Object.values(u.chunks))for(const $ of g.modules){const s=x($.replace(/[?#].*$/,""));s!==void 0&&!s.includes("node_modules")&&!s.startsWith(".allyhub/")&&m.add(s)}return await y(o(n,WASM_DIR),{recursive:!0}),await d(await manifoldWasmFile(),o(n,WASM_DIR,"manifold.wasm")),await d(xatlasWasmFile(),o(n,WASM_DIR,"xatlas.wasm")),await copyDecoders(n),{module:`stage/${f.file}`,decoders:`stage/${THREE_LIBS}/`,manifoldWasm:`stage/${WASM_DIR}/manifold.wasm`,xatlasWasm:`stage/${WASM_DIR}/xatlas.wasm`,files:[...m].sort()}}

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{glassProblems as _,moireCamera as D,moireProblems as A,PANEL_DEFAULTS as C,project as R,resolveCamera as M,SCREEN_FOCUS_DEFAULTS as j,SCREEN_LIGHT_DEFAULTS as x,screenLightBaseProblem as P}from"@allyhub-next/scenery";import{isPieceDefinition as z,LAYER_BRAND as L}from"@allyhub-next/video-core";import{bakeFile as B,DRAWN_OVER_RULE as I,ruleOf as J,SCENERY_RULES as H}from"../allyhub.js";import{sceneryFileOf as W}from"../module.js";import{drawMoire as G}from"./moire.js";import{answerFor as q}from"./queries.js";import{blurScreen as V,drawScreen as Y,mountScreen as K,placeInScenery as X,screenEdge as Z,screenFocusOf as Q,screenTo as ee,stackByDepth as ne}from"./screens.js";import{cameraOf as re,coded as O,refScenery as $,registry as v,ruled as k,sceneryAtFilm as se,sceneryTime as F}from"./state.js";import{SCREEN as te}from"./types.js";export{stackByDepth}from"./screens.js";export{markScenery,sceneryFileOf}from"../module.js";export{PHONE_CAMERA,phoneCamera,aimAt,aimed,AIM_DEFAULTS,AUTO_EXPOSURE_DEFAULTS,AUTOFOCUS_DEFAULTS,BAKE_DEFAULTS,blend,CAMERA_DEFAULTS,cameraProblems,cutsOf,defineScenery,diagonalLens,directionOf,easeValue,exposureOf,fieldOfView,FIT_DEFAULTS,fitCamera,focusScreen,GLASS_DEFAULTS,handheld,HANDHELD_DEFAULTS,keys,lensForVertical,mixCameras,orbit,PANEL_DEFAULTS,path,PATH_DEFAULTS,project,resolveCamera,rise,SCREEN_LIGHT_DEFAULTS,SENSOR_DEFAULTS,shots,STABILIZER_DEFAULTS,withCuts,SCENERY_RENDERER_DEFAULTS,yawPitchOf}from"@allyhub-next/scenery";export const SCREEN_DEFAULTS={size:[1920,1080],background:"#000000"};function ie(t){if(t===!1)return!1;const n=typeof t=="object"?t:{},e=n.brightness??1;if(!(Number.isFinite(e)&&e>=0))throw new Error(`screen()'s inScenery brightness ${String(e)} is not a number of 0 or more.`);const o=n.light??!0;if(o===!1)return{brightness:e,light:!1};const s=(typeof o=="object"?o.cells:void 0)??[...x.cells];if(s.length!==2||!s.every(a=>Number.isInteger(a)&&a>=1&&a<=32))throw new Error(`screen()'s inScenery light cells ${JSON.stringify(s)} are not two whole numbers from 1 to 32 (across, down).`);const c=(typeof o=="object"?o.specular:void 0)??x.specular;if(typeof c!="boolean")throw new Error(`screen()'s inScenery light specular ${JSON.stringify(c)} is not true or false.`);const i=(typeof o=="object"?o.base:void 0)??x.base;if(i!==null){const a=P(i);if(a!==void 0)throw new Error(`screen()'s inScenery light base: ${a}.`)}const l=i;return{brightness:e,light:{cells:[s[0]??1,s[1]??1],specular:c,base:l?{brightness:l.brightness??e,color:typeof l.color=="string"?l.color:l.color?[...l.color]:"#ffffff"}:null}}}export function screen(t,n={}){if((n.start!==void 0||n.cue!==void 0)&&n.time!==void 0)throw new Error("screen() takes start and cue, or time, not both.");if(n.cues!==void 0){if(n.start!==void 0||n.cue!==void 0||n.time!==void 0)throw new Error("screen() takes cues, or start and cue, or time: one way to time it.");if(Object.keys(n.cues).length===0)throw new Error(`screen()'s cues is empty: give the screen's moments and where each plays, { "@click": "@press" }.`);for(const[a,h]of Object.entries(n.cues)){if(!(a.trim().startsWith("@")?!0:Number.isFinite(Number(a)))||Array.isArray(t)&&a.trim().startsWith("@"))throw new Error(`screen()'s cue key ${JSON.stringify(a)}: ${Array.isArray(t)?`layers' moments are seconds of the screen's time, as a string ("2.5")`:`a video's own reference ("@click") or seconds of its time as a string ("2.5")`}.`);if(!(typeof h=="number"&&Number.isFinite(h))&&!(typeof h=="string"&&h.trim()!==""))throw new Error(`screen()'s cue ${JSON.stringify(a)} plays at ${JSON.stringify(h)}: a reference of the film ("@press") or a scenery time in seconds.`)}}if(typeof n.cue=="number"&&!Number.isFinite(n.cue))throw new Error(`screen()'s cue ${String(n.cue)} is not a number of seconds.`);if(typeof n.cue=="string"&&Array.isArray(t))throw new Error(`screen()'s cue "${n.cue}" is a reference: only a video has references of its own. Give layers' cue in seconds of the screen's time.`);const e=n.background??SCREEN_DEFAULTS.background,o={[te]:!0,time:n.time??{},...n.start!==void 0?{start:n.start}:{},...n.cue!==void 0?{cue:n.cue}:{},...n.cues!==void 0?{cues:{...n.cues}}:{},background:e==="transparent"?null:e,...n.pixels?{pixels:{...n.pixels}}:{},...n.glass?{glass:{...n.glass}}:{},inScenery:ie(n.inScenery)},s=A(void 0,n.pixels);if(s.length>0)throw new Error(`screen()'s ${s.join(" ")}`);const c=_(n.glass);if(c.length>0)throw new Error(`screen()'s ${c.join(" ")}`);if(!Array.isArray(t)){if(!z(t))throw new Error('screen() shows a video item (its piece, imported: import demo from "../demo/video") or graphic layers.');if(n.size!==void 0||n.dur!==void 0)throw new Error("screen() with a video takes its size and length from the video: its own format, and its length.");return{...o,video:t,layers:[],size:SCREEN_DEFAULTS.size}}const i=t;for(const a of i)if(a[L]!=="graphic")throw new Error("screen() takes graphic layers (components, custom()), or a video item whose own layers include footage.");const l=n.size??SCREEN_DEFAULTS.size;if(!(l[0]>0&&l[1]>0))throw new Error(`screen()'s size ${JSON.stringify(l)} is not two sizes in px.`);return{...o,layers:i,size:l,...n.dur!==void 0?{dur:n.dur}:{}}}export const SCENERY_LAYER_DEFAULTS={scale:.5,name:"scenery",focusLevels:j.levels};const N=new WeakMap,T=new WeakMap,U=new WeakMap,oe=()=>{const t=import.meta.url;return new URL("../three-libs/",t).href};function ae(t,n,e){const o=W(t);return{assetUrl:s=>n.asset(`/${s.replace(/^\/+/,"")}`).url,...o===void 0?{}:{module:o},decoders:oe(),seed:e,onProblem:s=>{n.report?.({code:J(s.kind),level:s.level,message:s.message})},bakeUrl:(s,c)=>n.optionalAsset?.(`/${B(s,c)}`)?.url,...n.realTimers?{timers:n.realTimers}:{}}}function ce(t,n,e){let o=T.get(t);return o||(o=Promise.all([import("../page/page.js"),import("../signature.js")]).then(async([{SceneryPage:s},{signatureOf:c}])=>{const i={page:await s.open(t,ae(t,n,e)),sign:c};return U.set(t,i),i}),T.set(t,o)),o}function le(t,n){const e=n.canvas;e.parentNode!==t.el&&t.el.insertBefore(e,t.canvas),e.dataset.akSign="the scenery's renderer",Object.assign(e.style,{position:"absolute",left:t.canvas.style.left,top:t.canvas.style.top,width:t.canvas.style.width,height:t.canvas.style.height,clipPath:"inset(0 calc(100% - 1px) calc(100% - 1px) 0)",pointerEvents:"none"})}export function scenery(t,n){const{at:e,until:o,dur:s,z:c,...i}=n,l={...e===void 0?{}:{at:e},...o===void 0?{}:{until:o},...s===void 0?{}:{dur:s},...c===void 0?{}:{z:c}},a=i.box===void 0||i.box==="full"?[0,0,1,1]:i.box;if(a.some(p=>!Number.isFinite(p))||a[2]<=0||a[3]<=0||a[0]+a[2]>1+1e-9||a[1]+a[3]>1+1e-9)throw new Error(`scenery()'s box ${JSON.stringify(a)} is not inside the frame: [x, y, width, height] as fractions, x + width and y + height at most 1.`);const h=i.quality?.scale??SCENERY_LAYER_DEFAULTS.scale;if(!(h>0&&h<=4))throw new Error(`scenery()'s quality.scale ${String(h)} is outside (0, 4].`);const u=i.quality?.focusLevels??SCENERY_LAYER_DEFAULTS.focusLevels;if(!(Number.isInteger(u)&&u>=1&&u<=16))throw new Error(`scenery()'s quality.focusLevels ${String(u)} is not a whole number from 1 to 16.`);const d=A(i.sensor,void 0);if(d.length>0)throw new Error(`scenery()'s ${d.join(" ")}`);const f=i.background;return{[L]:"graphic",...l,component:"scenery",props:{scenery:t,camera:i.camera,box:a,...f===void 0?{}:{background:f==="transparent"?null:f},time:i.time??{},scale:h,focusLevels:u,...i.sensor?{sensor:{...i.sensor}}:{},name:i.name??SCENERY_LAYER_DEFAULTS.name,screens:i.screens??{},props:i.props??[]},mount(p,y,w){k(()=>{de(p,y,w)})},render(p,y){k(()=>{fe(p,y)})}}}function de(t,n,e){const{width:o,height:s}=e.dims,c={x:Math.round(n.box[0]*o),y:Math.round(n.box[1]*s),w:Math.max(1,Math.round(n.box[2]*o)),h:Math.max(1,Math.round(n.box[3]*s))},i=document.createElement("canvas"),l=e.sceneryScale??n.scale;i.width=Math.max(1,Math.round(c.w*l)),i.height=Math.max(1,Math.round(c.h*l)),Object.assign(i.style,{position:"absolute",left:`${String(c.x)}px`,top:`${String(c.y)}px`,width:`${String(c.w)}px`,height:`${String(c.h)}px`});const a=document.createElement("div");Object.assign(a.style,{position:"absolute",left:i.style.left,top:i.style.top,width:i.style.width,height:i.style.height,overflow:"hidden",isolation:"isolate"});const h=g=>se(n,(e.film?.start??0)+g);t.appendChild(a);const u=Object.entries(n.screens).map(([g,r])=>K(a,g,r,e,h,m=>$(n,e,m)));let d;n.sensor&&u.length>0&&(d=document.createElement("canvas"),d.width=c.w,d.height=c.h,d.dataset.akSign="the scenery's moiré",Object.assign(d.style,{position:"absolute",left:"0px",top:"0px",width:`${String(c.w)}px`,height:`${String(c.h)}px`,zIndex:"100000",mixBlendMode:"multiply",pointerEvents:"none"}),a.appendChild(d)),u.length===0&&a.remove(),t.appendChild(i);const f={props:n,ctx:e,el:t,canvas:i,px:c,screens:u,time:g=>$(n,e,g),...d?{moire:d}:{}};N.set(t,f),q(f);const p=v.get(n.name)??[];p.push(f),v.set(n.name,p);const y=g=>Promise.all(n.props.map(r=>g.props.add(r))),w=g=>{throw O(g)},E=U.get(n.scenery);if(E){f.page=E.page,f.sign=E.sign,n.props.length>0&&e.wait(y(E.page).catch(w));return}e.wait(ce(n.scenery,e,n.name).then(async({page:g,sign:r})=>{await y(g),f.page=g,f.sign=r}).catch(w))}function fe(t,n){const e=N.get(t);if(!e?.page)return;const o=e.page,s=F(e,n),c=e.px.w/e.px.h,i=o.stateFrom(re(e),s,c,e.time);o.props.show(e.props.props,s);const l=o.aim(i,c),{width:a,height:h}=e.canvas,u=o.screens.drawsElements,d=u?e.screens.filter(r=>r.spec.inScenery!==!1):[];if(!u&&!e.fellBack){const r=e.screens.filter(m=>m.spec.inScenery!==!1);r.length>0&&(e.fellBack=!0,e.ctx.report?.({code:I,level:"warn",message:`The screens ${r.map(m=>`"${m.mesh}"`).join(", ")} of the scenery layer "${e.props.name}" are drawn over the scenery, unlit and untoned, not in it: this page cannot draw an element into the scenery's canvas (Chrome's HTML-in-Canvas is missing or turned off, or the scenery draws with WebGPU). AllyHub's own Chrome, which allyhub frames, check and exports use, has it: when allyhub check does not report this, only this page's preview is affected, so change nothing. screen(…, { inScenery: false }) would take the scenery's light and a sensor's moiré out of the export too.`}))}const f=e.screens.filter(r=>!d.includes(r)).map(r=>r.mesh),p=e.screens.map(r=>o.screens.quad(r.mesh,l.resolved,[e.px.w,e.px.h])),y=Math.ceil(2/(e.canvas.height/e.px.h))+1;d.length>0&&le(e,o);const w=[];if(e.screens.forEach((r,m)=>{if(d.includes(r)){const b=r.spec.pixels?.density??C.density,S=r.spec.inScenery;o.screens.show(r.mesh,r.el,{brightness:S===!1?1:S.brightness,light:S===!1?!1:S.light,...e.moire&&e.props.sensor?{factor:e.moire}:{}}),X(r,p[m],b),w.push(ee(r,s));return}Y(r,s,p[m]),Z(r,p[m],y),V(r,Q(e,r,p[m],l.resolved))}),ne(e.screens.map((r,m)=>({el:r.el,depth:p[m]?.depth}))),e.sign&&(e.canvas.dataset.akSign=e.sign(o.scene,l.camera,[a,h],`${e.props.background===void 0?"the scenery's":e.props.background??"none"}|${f.join(",")}${l.resolved.dof?`|f/${String(l.resolved.dof.aperture)}@${String(l.resolved.dof.focus)}:${String(l.resolved.dof.lens)}`:""}${e.props.sensor?`|sensor ${JSON.stringify(e.props.sensor)} ${JSON.stringify(e.screens.map(r=>r.spec.pixels??null))}`:""}${e.screens.some(r=>r.spec.glass)?`|glass ${JSON.stringify(e.screens.map(r=>r.spec.glass??null))}`:""}${d.length>0?`|in scenery ${JSON.stringify(d.map(r=>[r.mesh,r.spec.inScenery]))}`:""}`)),e.ctx.layoutOnly===!0)return;e.moire&&e.props.sensor&&G(e,p,l.resolved,D(l.resolved,[e.ctx.dims.width,e.ctx.dims.height],e.px.h,e.props.sensor,[e.px.x,e.px.y]));const E=new Map(e.screens.flatMap(r=>r.spec.glass?[[r.mesh,r.spec.glass]]:[])),g=()=>{const r=o.drawer.inPlace(l.camera,a,h,e.props.background,f,l.resolved.dof,E.size>0?E:void 0,d.map(b=>b.mesh)),m=e.canvas.getContext("2d");if(m&&(m.clearRect(0,0,a,h),m.drawImage(r,0,0,a,h),o.lost))throw Object.assign(new Error(`The scenery's WebGL context was lost (the browser's GPU process failed): its picture at ${n.toFixed(3)} s is empty.`),{code:H.renderer})};if(d.length===0){g();return}e.ctx.wait(Promise.all(w).then(()=>o.screens.paint([a,h])).then(g).catch(r=>{throw O(r)}))}export function projectScenery(t,n,e,o){const s=v.get(t)?.find(f=>f.el.parentElement===o.parentElement&&f.ctx.layer.start<=e&&e<f.ctx.layer.end&&f.page),c=s?.page;if(!s||!c)return;const i=F(s,e),l=s.px.w/s.px.h,a=c.stateFrom(s.props.camera,i,l,s.time);c.props.show(s.props.props,i);const h=M(a,l,f=>c.pointOf(f)),u=typeof n=="string"?c.pointOf(n):n,d=R(h,u);return{x:s.px.x+(d.x+1)/2*s.px.w,y:s.px.y+(1-d.y)/2*s.px.h,inView:d.inView,depth:d.depth}}

package/dist/node_modules/@allyhub-next/scenery-host/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@allyhub-next/scenery-host",
+  "version": "0.5.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./layer": {
+      "types": "./dist/layer/index.d.ts",
+      "default": "./dist/layer/index.js"
+    },
+    "./module": {
+      "types": "./dist/module.d.ts",
+      "default": "./dist/module.js"
+    },
+    "./fidelity": {
+      "types": "./dist/fidelity.d.ts",
+      "default": "./dist/fidelity.js"
+    },
+    "./bundle": {
+      "types": "./dist/bundle.d.ts",
+      "default": "./dist/bundle.js"
+    }
+  },
+  "private": true,
+  "license": "SEE LICENSE IN LICENSE.md"
+}

package/dist/node_modules/@allyhub-next/sheet/dist/address.d.ts

@@ -0,0 +1,32 @@
+/** Excel's grid. */
+export declare const MAX_ROWS = 1048576;
+export declare const MAX_COLUMNS = 16384;
+/** A place, from 0. */
+export interface Place {
+    row: number;
+    col: number;
+}
+/** A rectangle, ends included, from 0. */
+export interface Area {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+}
+/** A column's letters: 0 is A, 26 is AA. */
+export declare function columnLetter(col: number): string;
+/** A column's index from its letters, in either case; undefined when it is not a column of the grid. */
+export declare function columnIndex(letters: string): number | undefined;
+/** A1: a place's name. */
+export declare const cellName: (p: Place) => string;
+/** A1:B2, or A1 for one cell. */
+export declare function rangeName(a: Area): string;
+/** The place an address names, `$` allowed; undefined when it is not one. */
+export declare function readAddress(text: string): Place | undefined;
+/** The area `A1:B2` or `A1` names, whichever way round; undefined when it is neither. */
+export declare function readArea(text: string): Area | undefined;
+/** Ranges apart by spaces, as Excel's `sqref`; undefined when any of them is not a range. */
+export declare function readAreas(text: string): Area[] | undefined;
+export declare const contains: (a: Area, row: number, col: number) => boolean;
+export declare const overlaps: (a: Area, b: Area) => boolean;
+//# sourceMappingURL=address.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/address.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+export const MAX_ROWS=1048576,MAX_COLUMNS=16384;export function columnLetter(t){let o="";for(let e=t+1;e>0;e=Math.floor((e-1)/26))o=String.fromCharCode(65+(e-1)%26)+o;return o}export function columnIndex(t){if(!/^[A-Za-z]{1,3}$/u.test(t))return;let o=0;for(const e of t.toUpperCase())o=o*26+e.charCodeAt(0)-64;return o<=16384?o-1:void 0}export const cellName=t=>`${columnLetter(t.col)}${String(t.row+1)}`;export function rangeName(t){const o=cellName({row:t.top,col:t.left});return t.top===t.bottom&&t.left===t.right?o:`${o}:${cellName({row:t.bottom,col:t.right})}`}export function readAddress(t){const o=/^\$?([A-Za-z]{1,3})\$?([1-9]\d*)$/u.exec(t.trim());if(!o)return;const e=columnIndex(o[1]??""),n=Number(o[2])-1;return e===void 0||n>=1048576?void 0:{row:n,col:e}}export function readArea(t){const[o="",e,n]=t.split(":");if(n!==void 0)return;const r=readAddress(o),i=e===void 0?r:readAddress(e);if(!(!r||!i))return{top:Math.min(r.row,i.row),left:Math.min(r.col,i.col),bottom:Math.max(r.row,i.row),right:Math.max(r.col,i.col)}}export function readAreas(t){const o=[];for(const e of t.trim().split(/\s+/u)){const n=readArea(e);if(!n)return;o.push(n)}return o}export const contains=(t,o,e)=>o>=t.top&&o<=t.bottom&&e>=t.left&&e<=t.right,overlaps=(t,o)=>t.top<=o.bottom&&o.top<=t.bottom&&t.left<=o.right&&o.left<=t.right;