allyhub 0.3.0 → 0.5.0

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/dist/viewer.d.ts

@@ -0,0 +1,114 @@
+import { type CameraState, type Scenery } from "@allyhub-next/scenery";
+import type { SceneryAdapter } from "./adapter.js";
+import type { Vec3 } from "./vec.js";
+/** How the viewer's camera answers the hand; every value can change. */
+export declare const VIEWER_DEFAULTS: {
+    /** Degrees turned for each pixel dragged. */
+    orbitSpeed: number;
+    /** The camera's height above the horizon, degrees, at most. */
+    maxElevation: number;
+    /** How far one wheel notch (100 px of delta) moves in or out, a share of the distance. */
+    dollyPerNotch: number;
+    /** The nearest and farthest the camera comes to its point, m. */
+    minDistance: number;
+    maxDistance: number;
+    /** The lens, 35 mm-equivalent mm. */
+    lens: number;
+    /** How long a move to a framing takes, ms. */
+    flyMs: number;
+    /** How far toward the frame's edges a framed object reaches, 0–1 (fitCamera's fill). */
+    fill: number;
+    /** A press that moves less than this, px, is a click. */
+    clickSlop: number;
+    /** Draw the hover and selection outlines itself (a page that embeds it may draw its own from "place"). */
+    marks: boolean;
+    /** The outlines' colour. */
+    markColor: string;
+};
+export type ViewerOptions = typeof VIEWER_DEFAULTS;
+/** An object as the person points at it: its path of names from the scene down. */
+export interface PickedObject {
+    /** The named objects from the outermost down to the one picked. */
+    path: string[];
+    /** The one picked: the last of path. */
+    name: string;
+    /** Its box's size along the world axes, m. */
+    size: [number, number, number];
+    /** Where the pointer met it, world space, m. */
+    point: [number, number, number];
+}
+/** What the viewer tells the page that embeds it. */
+export type ViewerEvent = {
+    type: "ready";
+    cameras: string[];
+    ms: number;
+} | {
+    type: "hover";
+    object: PickedObject | null;
+} | {
+    type: "select";
+    object: PickedObject | null;
+}
+/** The camera after the hand moved it; `framed`: Back has somewhere to go. */
+ | {
+    type: "camera";
+    camera: CameraState;
+    framed: boolean;
+}
+/** Where the selection is on the picture after a draw, px from its top left (null: not on it). */
+ | {
+    type: "place";
+    hover: Box2D | null;
+    select: Box2D | null;
+}
+/** The picture as drawn now, a WebP data URL to look at (asked with "shot"). */
+ | {
+    type: "shot";
+    picture: string;
+}
+/** What is at a place of the picture (asked with "pick"). */
+ | {
+    type: "picked";
+    id: string;
+    object: PickedObject | null;
+} | {
+    type: "drawn";
+    ms: number;
+};
+/** A box on the picture, CSS px from its top left. */
+export interface Box2D {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** What the embedding page can ask of it. */
+export type ViewerCommand = {
+    type: "camera";
+    name: string;
+} | {
+    type: "frame";
+    path: string[];
+} | {
+    type: "shot";
+} | {
+    type: "pick";
+    id: string;
+    x: number;
+    y: number;
+} | {
+    type: "back";
+} | {
+    type: "select";
+    path: string[] | null;
+};
+/** Starts a viewer of a scenery in an element: the scenery built, then drawn. */
+export declare function startViewer(scenery: Scenery, adapter: SceneryAdapter, el: HTMLElement, given?: Partial<ViewerOptions>, tell?: (e: ViewerEvent) => void, 
+/** Where the camera starts: the person's last view, kept across a reload. */
+start?: {
+    position: Vec3;
+    target: Vec3;
+}): Promise<{
+    command(c: ViewerCommand): void;
+}>;
+//# sourceMappingURL=viewer.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{Box3 as ft,Mesh as yt,PerspectiveCamera as ct,Raycaster as gt,Vector2 as xt,Vector3 as u}from"three";import{fitCamera as bt}from"@allyhub-next/scenery";import{ownFrame as wt,ownTimers as vt}from"./clock.js";import{SceneryPage as Mt}from"./page/page.js";const q=i=>{wt(i)},E=()=>vt.now();export const VIEWER_DEFAULTS={orbitSpeed:.3,maxElevation:89,dollyPerNotch:.12,minDistance:.02,maxDistance:200,lens:30,flyMs:450,fill:.8,clickSlop:4,marks:!0,markColor:"#1471e2"};const K=i=>i*Math.PI/180,lt=i=>[Math.round(i.x*1e3)/1e3,Math.round(i.y*1e3)/1e3,Math.round(i.z*1e3)/1e3],U=i=>i*180/Math.PI;function kt(i,p){const M=Math.hypot(36,24)/Math.hypot(p,1);return U(2*Math.atan(M/(2*i)))}function Q(i){const p=K(i.elevation),c=K(i.azimuth);return new u(i.target.x+i.distance*Math.cos(p)*Math.sin(c),i.target.y+i.distance*Math.sin(p),i.target.z+i.distance*Math.cos(p)*Math.cos(c))}function _(i,p){const c=i.clone().sub(p),M=Math.max(c.length(),1e-4);return{target:p.clone(),azimuth:U(Math.atan2(c.x,c.z)),elevation:U(Math.asin(Math.max(-1,Math.min(1,c.y/M)))),distance:M}}function Et(i){const p=[];for(let c=i;c?.parent;c=c.parent)c.name&&p.unshift(c);return p}const zt=(i,p)=>i.length===p.length&&i.every((c,M)=>c===p[M]);function R(i){return new ft().setFromObject(i)}export async function startViewer(i,p,c,M={},x=()=>{},A){const m={...VIEWER_DEFAULTS,...M},g=await Mt.open(i,p),G=()=>0;g.pose(0,G);const d=g.renderer.domElement;d.style.cssText="position:absolute;inset:0;width:100%;height:100%;display:block;touch-action:none;cursor:grab",getComputedStyle(c).position==="static"&&(c.style.position="relative"),c.style.overflow="hidden",c.appendChild(d);const H=t=>{const e=document.createElement("div");e.style.cssText=`position:absolute;pointer-events:none;border:1.5px ${t?"dashed":"solid"} ${m.markColor};border-radius:4px;display:none`;const n=document.createElement("div");return n.style.cssText=`position:absolute;left:-1px;bottom:100%;margin-bottom:4px;font:12px/1.3 system-ui,sans-serif;color:#fff;background:${m.markColor};padding:2px 6px;border-radius:4px;white-space:nowrap`,e.appendChild(n),c.appendChild(e),{box:e,label:n}},dt=H(!0),ht=H(!1),O=R(g.scene),J=O.isEmpty()?new u:O.getCenter(new u),pt=O.isEmpty()?1:Math.max(O.getSize(new u).length()/2,.05);let s={target:J,azimuth:25,elevation:20,distance:pt*2.4};const D=g.named.cameras,Z=Object.keys(D)[0];let b=new ct(40,1,.01,500);const z=()=>{const t=c.getBoundingClientRect();return{w:Math.max(1,t.width),h:Math.max(1,t.height)}},tt=t=>{const e=D[t];if(!e)return;const{w:n,h:a}=z(),o=g.aim(e,n/a),r=o.camera.position.clone(),l=new u(0,0,-1).applyQuaternion(o.camera.quaternion),h=typeof e.target=="string"?new u(...g.pointOf(e.target)):Array.isArray(e.target)?new u(...e.target):r.clone().add(l.multiplyScalar(Math.max(r.distanceTo(J),.1)));return _(r,h)};A?s=_(new u(...A.position),new u(...A.target)):Z&&(s=tt(Z)??s);let y=[],v=[],Y=!1;const mt=t=>{const e=t[t.length-1];if(!e)return null;const n=R(e);if(n.isEmpty())return null;const{w:a,h:o}=z();let r=1/0,l=1/0,h=-1/0,w=-1/0;for(let S=0;S<8;S++){const j=new u(S&1?n.max.x:n.min.x,S&2?n.max.y:n.min.y,S&4?n.max.z:n.min.z).project(b);if(j.z>1)return null;r=Math.min(r,(j.x+1)/2*a),l=Math.min(l,(1-j.y)/2*o),h=Math.max(h,(j.x+1)/2*a),w=Math.max(w,(1-j.y)/2*o)}const F=4,V=Math.max(0,r-F),W=Math.max(0,l-F),rt=Math.min(a,h+F),st=Math.min(o,w+F);return rt<=V||st<=W?null:{x:V,y:W,width:rt-V,height:st-W}},et=(t,e)=>{const n=mt(e);return!n||!m.marks?(t.box.style.display="none",n):(t.box.style.display="block",t.box.style.left=`${String(n.x)}px`,t.box.style.top=`${String(n.y)}px`,t.box.style.width=`${String(n.width)}px`,t.box.style.height=`${String(n.height)}px`,t.label.textContent=e.map(a=>a.name).join(" › "),n)},I=()=>{Y=!1;const{w:t,h:e}=z(),n=Math.min(window.devicePixelRatio||1,2),a=E();b=new ct(kt(m.lens,t/e),t/e,Math.max(.005,s.distance/500),Math.max(50,s.distance*50)),b.position.copy(Q(s)),b.lookAt(s.target),b.updateMatrixWorld(!0),g.pose(0,G),g.drawer.inPlace(b,Math.round(t*n),Math.round(e*n)),d.style.width="100%",d.style.height="100%";const o=et(dt,zt(v,y)?[]:v),r=et(ht,y);x({type:"place",hover:o,select:r}),x({type:"drawn",ms:E()-a})},k=()=>{Y||(Y=!0,q(I))};let P=0;const $=t=>{const e={...s,target:s.target.clone()},n=++P,a=E();let o=t.azimuth-e.azimuth;o=((o+180)%360+360)%360-180;const r=()=>{if(n!==P)return;const l=Math.min(1,(E()-a)/m.flyMs),h=l<.5?4*l*l*l:1-(-2*l+2)**3/2;s={target:e.target.clone().lerp(t.target,h),azimuth:e.azimuth+o*h,elevation:e.elevation+(t.elevation-e.elevation)*h,distance:e.distance*(t.distance/e.distance)**h},I(),l<1?q(r):T()};q(r)},T=()=>{x({type:"camera",camera:{position:lt(Q(s)),target:lt(s.target),lens:m.lens},framed:C.length>0})},nt=new gt,L=(t,e)=>{const n=c.getBoundingClientRect(),a=new xt((t-n.left)/n.width*2-1,-((e-n.top)/n.height)*2+1);nt.setFromCamera(a,b);const o=nt.intersectObject(g.scene,!0);for(const r of o){if(!(r.object instanceof yt)||!r.object.visible)continue;let l=!0;for(let w=r.object;w;w=w.parent)w.visible||(l=!1);if(!l)continue;const h=Et(r.object);if(h.length>0)return{path:h,point:r.point}}return null},X=(t,e)=>{const n=t[t.length-1]??g.scene,a=R(n).getSize(new u),o=r=>Math.round(r*1e3)/1e3;return{path:t.map(r=>r.name),name:n.name,size:[o(a.x),o(a.y),o(a.z)],point:[o(e.x),o(e.y),o(e.z)]}},B=t=>t.slice(0,1);let f;d.addEventListener("contextmenu",t=>{t.preventDefault()}),d.addEventListener("pointerdown",t=>{d.setPointerCapture(t.pointerId),P++,f={x:t.clientX,y:t.clientY,moved:!1,pan:t.button===2||t.button===1||t.shiftKey,id:t.pointerId},d.style.cursor="grabbing"}),d.addEventListener("pointermove",t=>{if(f?.id===t.pointerId){const a=t.clientX-f.x,o=t.clientY-f.y;if(!f.moved&&Math.hypot(a,o)<m.clickSlop)return;if(f.moved=!0,f.x=t.clientX,f.y=t.clientY,f.pan){const{h:r}=z(),l=2*s.distance*Math.tan(K(b.fov)/2)/r,h=new u().setFromMatrixColumn(b.matrixWorld,0),w=new u().setFromMatrixColumn(b.matrixWorld,1);s.target.add(h.multiplyScalar(-a*l)),s.target.add(w.multiplyScalar(o*l))}else s.azimuth-=a*m.orbitSpeed,s.elevation=Math.max(-m.maxElevation,Math.min(m.maxElevation,s.elevation+o*m.orbitSpeed));k();return}const e=L(t.clientX,t.clientY),n=e?B(e.path):[];(n.length!==v.length||n.some((a,o)=>a!==v[o]))&&(v=n,d.style.cursor=v.length?"pointer":"grab",x({type:"hover",object:e&&n.length?X(n,e.point):null}),k())});const ot=t=>{if(f?.id!==t.pointerId)return;const e=!f.moved&&!f.pan,n=f.moved;if(f=void 0,d.style.cursor=v.length?"pointer":"grab",n&&T(),!e)return;const a=L(t.clientX,t.clientY);y=a?B(a.path):[],x({type:"select",object:a&&y.length?X(y,a.point):null}),k()};d.addEventListener("pointerup",ot),d.addEventListener("pointercancel",ot),d.addEventListener("pointerleave",()=>{v.length&&(v=[],x({type:"hover",object:null}),k())}),d.addEventListener("wheel",t=>{t.preventDefault(),P++;const e=t.deltaY/100*(t.ctrlKey?4:1);s.distance=Math.max(m.minDistance,Math.min(m.maxDistance,s.distance*(1+m.dollyPerNotch)**e)),k()},{passive:!1}),new ResizeObserver(k).observe(c);const C=[],N=t=>{const e=R(t);if(e.isEmpty())return;const n=e.getCenter(new u),{w:a,h:o}=z(),r=s.target.clone().sub(Q(s));let l;try{const h=bt({boxes:[{min:e.min.toArray(),max:e.max.toArray()}],aspect:a/o,direction:r.toArray(),aim:n.toArray(),lens:m.lens,fill:m.fill,near:Math.max(.005,e.getSize(new u).length()/500)});l=new u(...h.position)}catch{return}C.push({...s,target:s.target.clone()}),$(_(l,n))},at=t=>{const e=[];let n=g.scene;for(const a of t){let o;if(n.traverse(r=>{!o&&r!==n&&r.name===a&&(o=r)}),!o)return[];e.push(o),n=o}return e},it=t=>{switch(t.type){case"camera":{const e=tt(t.name);e&&(C.push({...s,target:s.target.clone()}),$(e));return}case"frame":{const e=at(t.path).pop();e&&N(e);return}case"shot":{I();const e=document.createElement("canvas");e.width=d.width,e.height=d.height;const n=e.getContext("2d");n&&(n.fillStyle=getComputedStyle(document.body).backgroundColor,n.fillRect(0,0,e.width,e.height),n.drawImage(d,0,0)),x({type:"shot",picture:e.toDataURL("image/webp",.9)});return}case"pick":{const e=L(t.x,t.y);x({type:"picked",id:t.id,object:e?X(e.path,e.point):null});return}case"back":{const e=C.pop();e&&$(e);return}case"select":y=t.path?at(t.path):[],k();return}};window.addEventListener("keydown",t=>{if(t.key==="Escape")C.length?it({type:"back"}):y.length&&(y=y.slice(0,-1),x({type:"select",object:null}),k());else if((t.key==="f"||t.key==="F")&&y.length){const e=y[y.length-1];e&&N(e)}}),d.addEventListener("dblclick",t=>{const e=L(t.clientX,t.clientY),n=e?B(e.path).pop():void 0;n&&N(n)});const ut=E();return I(),x({type:"ready",cameras:Object.keys(D),ms:E()-ut}),T(),{command:it}}

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;

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

@@ -0,0 +1,23 @@
+export interface Capabilities {
+    reference: {
+        library: string;
+        version: string;
+        docs: string;
+    };
+    /** openpyxl's classes, each with the names of it the API holds. */
+    holds: Record<string, string[]>;
+    /** openpyxl's helpers the API holds. */
+    functions: string[];
+    /** Where a held name behaves differently from openpyxl's. */
+    differs: string[];
+    /** What the API adds, by class and name, and what each is. */
+    adds: Record<string, Record<string, string>>;
+    /** The worksheet functions, by where each comes from. */
+    formulas: {
+        own: string[];
+        formulajs: string[];
+    };
+}
+export declare const HELPERS: string[];
+export declare const CAPABILITIES: Capabilities;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/node_modules/@allyhub-next/sheet/dist/api/capabilities.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{publicNames as n}from"@allyhub-next/formats";import{FUNCTIONS as h}from"../calc/functions/index.js";import{AreaChart as d,BarChart as p,DataLabelList as m,DoughnutChart as c,GraphicalProperties as w,Legend as f,LineChart as u,LineProperties as y,Marker as b,NumericAxis as g,PieChart as k,Reference as _,ScatterChart as x,Scaling as C,Series as A,TextAxis as v}from"./charts.js";import{AutoFilter as S,ConditionalFormattingList as D,DataValidation as L,DataValidationList as R,DifferentialStyle as T,Rule as F}from"./rules.js";import{Alignment as N,Border as P,Color as E,Font as V,PatternFill as B,Side as I}from"./styles.js";import{Cell as j,ColumnDimension as W,DefinedName as G,DefinedNameDict as M,RowDimension as O,Table as z,TableList as H,Workbook as U,Worksheet as q}from"./workbook.js";const a={Series:{title:"A series' name in words, openpyxl's SeriesFactory argument, kept here as a field."},Workbook:{open:"Workbook.open(dir): a workbook's folder read (load_workbook(dir) is the same).",block_cells:"How many typed cells together go in a CSV file of their own: 100 unless set.",title:"The workbook's title, sheet.yaml's.",check:"wb.check(): what allyhub check would say of the workbook as it stands: a list of { file, line, message }."},Cell:{computed:"What the cell computes to, the workbook as it stands, saved or not."},Table:{key:"The column that lines rows up when two hands' changes merge."},DataValidation:{multiple:"A list's cell may hold several of its values, joined by separator: an .xlsx keeps them as text.",separator:"What joins a cell's choices: a comma and a space unless set."},ColumnDimension:{files:"Its cells name files, from the sheet's folder: true, or { separator, height }."}},X=["add_data","set_categories","append","title","legend","width","height","style","anchor","series","dataLabels","x_axis","y_axis"],J={BarChart:["type","grouping","overlap","gapWidth","varyColors"],LineChart:["grouping"],AreaChart:["grouping"],PieChart:["varyColors"],DoughnutChart:["holeSize"],ScatterChart:[]},K={Workbook:U.prototype,Worksheet:q.prototype,Cell:j.prototype,Font:V.prototype,PatternFill:B.prototype,Border:P.prototype,Side:I.prototype,Alignment:N.prototype,Color:E.prototype,Table:z.prototype,TableList:H.prototype,DefinedName:G.prototype,DefinedNameDict:M.prototype,ColumnDimension:W.prototype,RowDimension:O.prototype,ConditionalFormattingList:D.prototype,Rule:F.prototype,DifferentialStyle:T.prototype,DataValidation:L.prototype,DataValidationList:R.prototype,AutoFilter:S.prototype,BarChart:p.prototype,LineChart:u.prototype,AreaChart:d.prototype,PieChart:k.prototype,DoughnutChart:c.prototype,ScatterChart:x.prototype,Reference:_.prototype,Series:A.prototype,Legend:f.prototype,Scaling:C.prototype,TextAxis:v.prototype,NumericAxis:g.prototype,DataLabelList:m.prototype,Marker:b.prototype,GraphicalProperties:w.prototype,LineProperties:y.prototype},r=["title","scaling","majorUnit","number_format","delete","majorGridlines"],Q={Workbook:["worksheets","defined_names","data_only","path","title","block_cells"],Cell:["row","column"],Worksheet:["min_row","min_column"],Font:["name","size","bold","italic","underline","strike","color"],PatternFill:["fill_type","fgColor","bgColor"],Border:["left","right","top","bottom"],Side:["style","color"],Alignment:["horizontal","vertical","wrap_text","shrink_to_fit","indent","text_rotation"],Color:["rgb"],Table:["displayName","ref","key","autoFilter"],DefinedName:["name","attr_text"],ColumnDimension:["index"],RowDimension:["index"],Rule:["type","operator","formula","stopIfTrue","rank","percent","bottom","aboveAverage","equalAverage","text","dxf"],DifferentialStyle:["font","fill","border"],DataValidation:["type","formula1","formula2","operator","allow_blank","showDropDown","showErrorMessage","showInputMessage","errorStyle","errorTitle","error","promptTitle","prompt","sqref"],DataValidationList:["dataValidation"],AutoFilter:["ref"],...Object.fromEntries(Object.entries(J).map(([e,t])=>[e,[...X.filter(o=>!(/^(?:Pie|Doughnut)/u.test(e)&&o.endsWith("_axis"))),...t]])),Reference:["worksheet","min_col","min_row","max_col","max_row"],Series:["val","xVal","title","smooth","marker","graphicalProperties"],Legend:["position"],Scaling:["min","max","orientation"],TextAxis:r.filter(e=>e!=="majorUnit"),NumericAxis:r,DataLabelList:["showVal","showPercent","showCatName","showSerName","dLblPos"],Marker:["symbol","size"],GraphicalProperties:["solidFill","noFill","line"],LineProperties:["width","solidFill","noFill"]};export const HELPERS=["CellIsRule","ColorScaleRule","DataBarRule","FormulaRule","IconSetRule","column_index_from_string","coordinate_to_tuple","get_column_letter","range_boundaries"];const Y=()=>{const e={};for(const[t,o]of Object.entries(K)){const i=a[t]??{};e[t]=[...n(o),...Q[t]??[]].filter(l=>!Object.hasOwn(i,l)).sort()}return e},s=e=>[...h.values()].filter(t=>t.from===e).map(t=>t.name).sort();export const CAPABILITIES={reference:{library:"openpyxl",version:"3.1.5",docs:"https://openpyxl.readthedocs.io/"},holds:Y(),functions:HELPERS,differs:["A workbook is a folder, not a file: load_workbook(dir) reads sheet.yaml and its CSV files, wb.save(dir) writes them, and only what changed is written. .xlsx is not read or written yet.","A keyword argument of openpyxl's is a field of an object: new Font({ bold: true }), new Table({ displayName, ref }), new DefinedName(name, { attr_text }). Classes are made with new.","A name openpyxl has that is not held throws where it is used, naming what the class holds. ws['A1'], ws['A1:B2'], ws['A'], ws[1], wb['Sheet'], ws.tables['t'], wb.defined_names['n'], ws.column_dimensions['A'] and ws.row_dimensions[1] are held; in TypeScript ws['A1'] is typed as a Cell, so write ws['A1'].value = v (ws['A1'] = v works at run time), and wb.get_sheet_by_name(name) is typed where wb[name] is not.","Rows and columns count from 1, as openpyxl's. iter_rows, rows, columns and values give arrays, not generators.","A colour is #RRGGBB; RRGGBB and AARRGGBB are taken, the alpha left out. Theme colours are not held.","cell.value of a date is a Date (read in UTC), a formula's its text, and with load_workbook(dir, { data_only: true }) what it computes to, which openpyxl reads from a file's cache and this computes.","column_dimensions' width is Excel's unit and row_dimensions' height points, as openpyxl's; the file holds pixels.","ws.merged_cells is an array of each merged range's text.","A table's rows are its CSV file, so ws.add_table(new Table({ displayName, ref })) moves the cells of ref there; its header row names its columns. A column whose every row has one formula, moved, is written as a calculated column.","A run of cells with one formula, moved, is written as one range key, and at least wb.block_cells typed cells together in a CSV file of their own (a block).","ws.title = 'New' renames the sheet in every formula, which openpyxl leaves to you.","ws.insert_rows, delete_rows, insert_cols and delete_cols rewrite every formula of the workbook as Excel does (a reference moves, a range grows or shrinks, one to what went is #REF!), move tables, blocks, merges and looks, and take rows and columns in or out of a table's CSV file. openpyxl moves cells and leaves formulas as they were. A table's header row is not deleted unless all of the table is.","A string that reads as another value (=, 12%, 2026-01-01) stays text, as openpyxl's does: its cell is written with a leading ' unless it starts with =, which makes it a formula.","A DataValidation refuses what breaks it and shows its prompt unless showErrorMessage or showInputMessage is false, as Excel's dialog starts: openpyxl's leave both off. A list's cell keeps its blank unless allow_blank is false.","ws.auto_filter.ref and add_filter_column say what a filter keeps, and the rows it leaves out are worked out from that, never written: a file made by openpyxl hides nothing until Excel reapplies it. A table has its own, table.autoFilter. add_sort_condition is not held: sorting is the rows of the files in order.","A chart reads its cells live, whatever else is in the file: there is no cache to refresh. chart.add_data and set_categories, and Series, take a Reference or a formula's text for a table's column or a spill, as add_data('orders[total]', { title: 'Total' }) or set_categories('orders[month]'), since a Reference cannot name one.","Series is made with new Series(values, { xvalues, title, title_from_data }); openpyxl's is the SeriesFactory function.","A chart's width and height are centimetres, as openpyxl's; the file holds pixels, and anchor a cell: ws.add_chart(chart, 'E2').","A LineChart's grouping is standard; a stacked area is an AreaChart. Chart styles are kept but draw nothing, as sheet.yaml has no place for them: chart.style is only read.","ws._charts lists a sheet's charts, those read from sheet.yaml among them, as the classes above.","In a rule, a fill's bgColor paints, or its fgColor where it has none. A rule's font holds bold, italic, underline, strike and a colour; alignment and number formats in a rule are not held.","workbook((wb, { data }) => { … }), the default export of an item's sheet.ts, makes sheets with these classes, on a workbook of its own that starts with none. They are made again from the code wherever the workbook is read, never saved: wb.save throws there."],adds:a,formulas:{own:s("allyhub"),formulajs:s("formulajs")}};