allyhub 0.7.0 → 0.8.0

package/dist/node_modules/@allyhub/scenery-host/dist/page/screens.d.ts

@@ -0,0 +1,147 @@
+import { Mesh, type Camera, type Material, type Object3D, type Scene } from "three";
+import { type Px, type ResolvedCamera, type ScreenFace, type ScreenLightBase } from "@allyhub/scenery";
+import type { RealTimers } from "../clock.js";
+import { type SceneryProblem } from "../errors.js";
+import { type AnyRenderer } from "../idbuffer.js";
+import { type ScreenLevel } from "../measure/screen-readback.js";
+import { ScreenLight } from "../screen-light.js";
+import { ScreenPictures, type Picture, type PictureOptions } from "../screen-picture.js";
+/** How a screen is drawn in the scenery (Screens.show). */
+export interface ScreenInScenery extends PictureOptions {
+    /**
+     * The light it casts on the scenery's lit materials: false for none, or
+     * the cells it is cut into for its diffuse light, whether the
+     * materials reflect it (`specular`, default true; false: its diffuse
+     * light alone), and the steady light the scenery already has from it
+     * (`base`: its bake's pane, brightness by default this screen's), so that
+     * it adds only what its picture differs by (default null: all of it).
+     */
+    light?: false | {
+        cells?: readonly [number, number];
+        specular?: boolean;
+        base?: ScreenLightBase | null;
+    };
+}
+/** Where a screen's face lands on a frame (Screens.quad). */
+export interface ScreenQuad {
+    /** Its corners in its content's order: top left, top right, bottom right, bottom left, as seen from the front. */
+    corners: [Px, Px, Px, Px];
+    /** Degrees between the face and the line to the camera, where the frame looks at it. */
+    angle: number;
+    /** Its farthest corner's depth along the view. */
+    depth: number;
+}
+export declare class Screens {
+    private readonly scene;
+    private readonly renderer;
+    private readonly object;
+    private readonly mustObject;
+    private readonly report;
+    private readonly timers;
+    /** The screens drawn in the scenery: their elements, textures and materials. */
+    private pictures;
+    /**
+     * Each screen drawn in the scenery: the cells its light is cut into,
+     * whether it is reflected and the steady radiance the scenery already has
+     * from it (null: none), or false for none.
+     */
+    private readonly lit;
+    /**
+     * The light they cast on the scenery's lit materials. A material's
+     * reflections hold a screen's steady light (its base) when it reflects
+     * the area light on the screen's face once: by three's own highlight
+     * (what is not baked) or the probe's pane (what is). A baked material
+     * without the probe does not: the bake takes its direct specular away
+     * and its environment never saw the screen's pane.
+     */
+    readonly light: ScreenLight;
+    /** Screen geometries given UVs from their faces. */
+    private readonly mapped;
+    constructor(o: {
+        scene: Scene;
+        renderer: AnyRenderer;
+        object: (name: string) => Object3D | undefined;
+        mustObject: (name: string) => Object3D;
+        report: (p: SceneryProblem) => void;
+        timers: RealTimers;
+    });
+    /** Whether this page draws screens in the scenery (Chrome's HTML-in-Canvas, WebGL). */
+    get drawsElements(): boolean;
+    /**
+     * The canvas a screen's element is a child of while it is drawn in the
+     * scenery: a 2D canvas of the screens' own beside the renderer's, which
+     * draws them on the CPU (screen-picture.ts), else the renderer's.
+     */
+    get canvas(): HTMLCanvasElement;
+    /** A screen drawn in the scenery: its element, texture and material. */
+    picture(name: string): Picture | undefined;
+    /** Whether a material is one the screens drawn in the scenery own (never lit by them). */
+    owns(m: Material): boolean;
+    /** What a sensor's moiré multiplies a screen's picture by. */
+    factorOf(name: string): ReturnType<ScreenPictures["factorOf"]>;
+    /** Makes a material one the screens own (a glass that shows a picture). */
+    adopt(m: Material): void;
+    /** Sets the size the screens are drawn at for the next draw. */
+    frame(width: number, height: number): void;
+    /**
+     * Shows an element's picture on a screen's mesh, in the scenery: the
+     * element becomes a child of the renderer's canvas (Chrome's
+     * HTML-in-Canvas), its picture a texture the mesh shows, given out at
+     * `brightness` and toned by the camera's exposure as the rest of the
+     * scenery is; it lights the scenery's lit materials (unless `light` is
+     * false) and is what `w.screenPicture(name)` gives.
+     */
+    show(name: string, element: HTMLElement, o?: ScreenInScenery): void;
+    /**
+     * Waits until the screens drawn in the scenery are painted as they are now
+     * and copies the ones that changed into their textures: what a screen
+     * shows is the moment's, never the last one's. `size` is the drawing
+     * the scenery is drawn at next (px): an element is painted at the canvas's
+     * pixels per CSS pixel, so the canvas takes that size first, not the
+     * size of the last drawing (another layer's, or the build's warm-up).
+     */
+    paint(size?: readonly [number, number], timeoutMs?: number): Promise<void>;
+    /**
+     * A screen drawn in the scenery as its texture holds it now: its first
+     * level at most `most` px wide, as its element's picture was uploaded
+     * (before the scenery's light, tone curve and a sensor's moiré), with the
+     * element it was copied from; or why it cannot be read.
+     */
+    read(name: string, most: number, lost: boolean): (ScreenLevel & {
+        element: HTMLElement;
+    }) | string;
+    /** Copies a screen's element into its texture again at the next paint (after something moved it). */
+    repaint(name: string): void;
+    /** UVs from a screen's face for its meshes: (0, 0) at its content's top left, (1, 1) at its bottom right. */
+    mapToFace(name: string, meshes: readonly Mesh[]): void;
+    /** The screens drawn in the scenery light the scenery's lit materials by their pictures now. */
+    lightBy(names: readonly string[]): void;
+    /** A screen's face in world space now: its object's first mesh, the +Z side of its geometry's box. */
+    face(name: string): ScreenFace | undefined;
+    /**
+     * Where a screen's face lands on a frame of `frame` px from a camera: the
+     * face on its own +Z side, its corners in its content's order, the angle
+     * between the face and the line to the camera at the centre of what the
+     * frame shows of it, and its farthest corner's depth along the view.
+     * Undefined while a corner is behind the camera (the screen is then not
+     * shown).
+     */
+    quad(name: string, camera: ResolvedCamera, frame: readonly [number, number]): ScreenQuad | undefined;
+    /**
+     * How much of a screen what is in front of it hides from a camera, drawn
+     * at w × h: the share of its pixels hidden (0–1), and by which objects
+     * (the outermost named ones), each as a share. Undefined when it shows
+     * nothing at all.
+     */
+    hidden(name: string, aimed: {
+        camera: Camera;
+        resolved: ResolvedCamera;
+    }, w: number, h: number): Promise<{
+        hidden: number;
+        by: {
+            object: string;
+            share: number;
+        }[];
+    } | undefined>;
+}
+//# sourceMappingURL=screens.d.ts.map

package/dist/node_modules/@allyhub/scenery-host/dist/page/screens.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{Color as S,Float32BufferAttribute as D,Mesh as L,PerspectiveCamera as F,Vector3 as f,WebGLRenderer as W}from"three";import{project as G,shownCentre as $}from"@allyhub/scenery";import{reflectsAreaLights as q}from"../bake/apply.js";import{SceneryError as A}from"../errors.js";import{countable as P,seenFrom as R}from"../idbuffer.js";import{readTextureLevel as k}from"../measure/screen-readback.js";import{paths as H,vec as C}from"../scene.js";import{SCREEN_LIGHT_DEFAULTS as B,ScreenLight as I}from"../screen-light.js";import{ScreenPictures as V,canDrawElements as _}from"../screen-picture.js";import{length as E,normalize as N,sub as O}from"../vec.js";function Q(l,e){const i=l.brightness??e,n=typeof l.color=="string"?new S(l.color):l.color?new S(...l.color):new S(1,1,1);return[n.r*i,n.g*i,n.b*i]}function U(l){return(e,i)=>{let n=0;for(let t=0;t<l.length;t++){const r=l[t],s=l[(t+1)%l.length];if(!r||!s)return!1;const o=(s[0]-r[0])*(i-r[1])-(s[1]-r[1])*(e-r[0]);if(o===0)continue;const c=o>0?1:-1;if(n===0)n=c;else if(c!==n)return!1}return!0}}function T(l){let e;return l.traverse(i=>{!e&&i instanceof L&&(e=i)}),e}export class Screens{scene;renderer;object;mustObject;report;timers;pictures;lit=new Map;light=new I(q);mapped=new WeakSet;constructor(e){this.scene=e.scene,this.renderer=e.renderer,this.object=e.object,this.mustObject=e.mustObject,this.report=e.report,this.timers=e.timers}get drawsElements(){return this.renderer instanceof W&&_()}get canvas(){return this.pictures?.host??this.renderer.domElement}picture(e){return this.pictures?.get(e)}owns(e){return this.pictures?.owns(e)??!1}factorOf(e){return this.pictures?.factorOf(e)}adopt(e){this.pictures?.adopt(e)}frame(e,i){this.pictures?.frame(e,i)}show(e,i,n={}){if(!(this.renderer instanceof W))throw new A("build",`A screen drawn in the scenery ("${e}") needs the WebGL renderer.`);this.pictures??=new V(this.renderer,(t,r)=>{this.report({kind:"screen",level:"error",message:`The screen "${t}", drawn in the scenery, cannot show its element as it is: ${r}.`})}),this.pictures.show(e,i,n),this.lit.set(e,n.light===!1?!1:{cells:[...n.light?.cells??B.cells],specular:n.light?.specular??B.specular,base:(()=>{const t=n.light?.base??B.base;return t?Q(t,n.brightness??1):null})()})}async paint(e,i=5e3){if(!this.pictures)return;const n=this.renderer.domElement;if(e&&(n.width!==e[0]||n.height!==e[1])&&this.renderer.setSize(e[0],e[1],!1),!await this.pictures.paint(this.timers,i))throw new A("build",`A screen drawn in the scenery was not painted within ${String(i)} ms (Chrome's HTML-in-Canvas): its picture would be the last moment's.`)}read(e,i,n){const t=this.pictures?.get(e);if(!t)return"it is not drawn in the scenery";if(!t.size)return"its picture was never copied into its texture";if(!(this.renderer instanceof W))return"its scenery is not drawn with WebGL";if(n)return"the scenery's WebGL context was lost";let r;try{r=k(this.renderer.getContext(),t.texture.sourceTexture,i)}finally{this.renderer.resetState()}return typeof r=="string"?r:{...r,element:t.element}}repaint(e){const i=this.pictures?.get(e);i&&(i.dirty=!0)}mapToFace(e,i){const n=this.face(e);if(!n)return;const t=new f(...n.point(0,0)),r=new f(...n.point(1,0)).sub(t),s=new f(...n.point(0,1)).sub(t),o=r.lengthSq(),c=s.lengthSq(),p=new f;for(const x of i){const u=x.geometry;if(this.mapped.has(u))continue;const h=u.getAttribute("position"),d=new Float32Array(h.count*2);x.updateWorldMatrix(!0,!1);for(let m=0;m<h.count;m++)p.fromBufferAttribute(h,m).applyMatrix4(x.matrixWorld).sub(t),d[m*2]=p.dot(r)/o,d[m*2+1]=p.dot(s)/c;u.setAttribute("uv",new D(d,2)),this.mapped.add(u)}}lightBy(e){const i=this.pictures,n=[];for(const t of e){const r=this.lit.get(t),s=i?.get(t),o=this.face(t);if(r===!1||r===void 0||!s?.size||!o)continue;const c=new f(...o.point(0,0));n.push({picture:s.texture,size:s.size,corner:c,across:new f(...o.point(1,0)).sub(c),down:new f(...o.point(0,1)).sub(c),brightness:s.brightness,cells:r.cells,specular:r.specular,...r.base?{base:r.base}:{}})}this.light.set(n),n.length!==0&&this.scene.traverse(t=>{if(!(t instanceof L))return;const r=Array.isArray(t.material)?t.material:[t.material];for(const s of r)s.isMeshStandardMaterial&&s.userData.screenLight!==!1&&!i?.owns(s)&&this.light.patch(s)})}face(e){const i=this.object(e);if(!i)return;const n=T(i);if(!n)return;const t=n.geometry;t.boundingBox||t.computeBoundingBox();const r=t.boundingBox;if(!r)return;n.updateWorldMatrix(!0,!1);const s=n.matrixWorld,o=(d,m)=>C(new f(r.min.x+(r.max.x-r.min.x)*d,r.max.y-(r.max.y-r.min.y)*m,r.max.z).applyMatrix4(s)),c=o(0,0),p=o(1,0),x=o(0,1),u=O(p,c),h=O(x,c);return{point:o,center:o(.5,.5),normal:C(new f(0,0,1).transformDirection(s)),up:N([-h[0],-h[1],-h[2]]),width:E(u),height:E(h)}}quad(e,i,n){const t=T(this.mustObject(e));if(!t)throw new A("name",`The screen "${e}" has no mesh to show content on.`);const r=t.geometry;r.boundingBox||r.computeBoundingBox();const s=r.boundingBox;if(!s)return;const o=[];let c=0;for(const[v,z]of[[s.min.x,s.max.y],[s.max.x,s.max.y],[s.max.x,s.min.y],[s.min.x,s.min.y]]){const j=new f(v,z,s.max.z).applyMatrix4(t.matrixWorld),M=G(i,[j.x,j.y,j.z]);if(!(M.depth>i.near))return;c=Math.max(c,M.depth),o.push([(M.x+1)/2*n[0],(1-M.y)/2*n[1]])}const[p,x,u,h]=o;if(!p||!x||!u||!h)return;const d=[p,x,u,h],[m,w]=$(d,n)??[.5,.5],y=new f(s.min.x+(s.max.x-s.min.x)*m,s.max.y-(s.max.y-s.min.y)*w,s.max.z).applyMatrix4(t.matrixWorld),b=new f(0,0,1).transformDirection(t.matrixWorld),g=new f(...i.position).sub(y).normalize(),a=Math.acos(Math.max(-1,Math.min(1,b.dot(g))))*180/Math.PI;return{corners:d,angle:a,depth:c}}async hidden(e,i,n,t){const r=this.mustObject(e),s=H(this.scene),o=P(this.scene,s,!0);o.some(a=>a.object===r)||o.push({object:r,name:e,path:s.get(r)??e});const c=this.quad(e,i.resolved,[n,t]);if(!c)return;const p=c.corners.map(a=>a[0]),x=c.corners.map(a=>a[1]),u=Math.max(0,Math.floor(Math.min(...p))),h=Math.max(0,Math.floor(Math.min(...x))),d=Math.min(n,Math.ceil(Math.max(...p))),m=Math.min(t,Math.ceil(Math.max(...x)));if(d<=u||m<=h)return;let w=i.camera;if(i.camera instanceof F){const a=i.camera.clone();a.setViewOffset(n,t,u,h,d-u,m-h),a.far=Math.min(a.far,c.depth*1.001+.001),a.updateProjectionMatrix(),w=a}const y=U(c.corners),b=w!==i.camera,[g]=await R(this.renderer,this.scene,w,o,b?d-u:n,b?m-h:t,{by:!0,of:new Set([r]),region:b?(a,v)=>y(a+u,v+h):y});if(!(!g||g.pixels===0&&g.hidden===0))return{hidden:g.hidden,by:(g.by??[]).map(a=>({object:a.path,share:a.share}))}}}

package/dist/node_modules/@allyhub/scenery-host/dist/queries/inventory.d.ts

@@ -0,0 +1,5 @@
+import type { SceneryInventory } from "@allyhub/scenery";
+import type { SceneryPage } from "../page/page.js";
+/** The inventory at scenery time t, with the time one frame of a size takes. */
+export declare function inventory(page: SceneryPage, t: number, size: readonly [number, number]): SceneryInventory;
+//# sourceMappingURL=inventory.d.ts.map

package/dist/node_modules/@allyhub/scenery-host/dist/queries/map.d.ts

@@ -0,0 +1,5 @@
+import type { MapRequest, MapResult } from "@allyhub/scenery";
+import type { SceneryPage } from "../page/page.js";
+/** Plans from above and elevations from the front and side, with what is named, the cameras and the moves. */
+export declare function map(page: SceneryPage, req: MapRequest): MapResult;
+//# sourceMappingURL=map.d.ts.map

package/dist/node_modules/@allyhub/scenery-host/dist/queries/map.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{OrthographicCamera as it}from"three";import{topObjects as at}from"@allyhub/scenery";import{INK as g,label as Q,metres as X}from"../draw2d.js";import{um as Y}from"../scene.js";import{normalize as nt}from"../vec.js";import{inventory as ct}from"./inventory.js";import{pictureUrl as rt}from"./view.js";const B=r=>[Y(r[0]),Y(r[1]),Y(r[2])];export function map(r,i){r.pose(i.t);const m=r.shownFor(i.hide,i.only);try{const a=ct(r,i.t,[64,64]),l=(i.nested===!0?a.objects:at(a.objects)).filter(s=>s.name!==""&&s.visible&&s.upright&&s.box),b=[],y=i.aspect??9/16;for(const[s,d]of Object.entries({...r.named.cameras,...i.cameras??{}}))b.push({name:s,aimed:r.aim(d,y)});const O=[],F=[],w=[];for(const s of i.moves){const d=[],E=[],v=.03333333333333333;try{for(let u=i.from;u<=i.to+1e-9;u+=v)E.push(r.stateOf({move:s},u,y).state.position);for(let u=i.from;u<=i.to+1e-9;u+=i.tick)d.push({t:Math.round(u*1e3)/1e3,position:B(r.stateOf({move:s},u,y).state.position)})}catch(u){w.push({move:s,why:u.message});continue}finally{r.pose(i.t)}O.push({name:s,points:d}),F.push({name:s,points:E})}const N=[1/0,1/0,1/0],z=[-1/0,-1/0,-1/0],x=s=>{for(let d=0;d<3;d++)N[d]=Math.min(N[d]??0,s[d]??0),z[d]=Math.max(z[d]??0,s[d]??0)};for(const s of a.objects)s.box&&s.visible&&s.depth===0&&(x(s.box.min),x(s.box.max));for(const s of b)x(s.aimed.resolved.position);for(const s of F)s.points.forEach(x);Number.isFinite(N[0])||(x([-1,0,-1]),x([1,1,1]));const P=Math.max(.5,i.grid),C=[(N[0]??0)-P,(N[1]??0)-P,(N[2]??0)-P],j=[(z[0]??0)+P,(z[1]??0)+P,(z[2]??0)+P],L=[];for(const s of i.views)L.push(ht(r,s,C,j,i,l,b,F,O));const A=l.flatMap(s=>s.upright?[{name:s.name,path:s.path,corners:s.upright.footprint,bottom:s.upright.bottom,top:s.upright.top,facing:Math.round(Math.atan2(s.front[0],s.front[2])*180/Math.PI*1e3)/1e3}]:[]);return{views:L,footprints:A,paths:O,...w.length>0?{left:w}:{}}}finally{m(),r.pose(i.t)}}function ht(r,i,m,a,l,b,y,O,F){const w={top:{u:t=>t[0],v:t=>-t[2],uName:"x",vName:"z"},front:{u:t=>t[0],v:t=>t[1],uName:"x",vName:"y"},side:{u:t=>-t[2],v:t=>t[1],uName:"z",vName:"y"}},{u:N,v:z}=w[i],x=[];for(const t of[m[0],a[0]])for(const e of[m[1],a[1]])for(const n of[m[2],a[2]])x.push([t,e,n]);const P=x.map(N),C=x.map(z),j=Math.min(...P),L=Math.max(...P),A=Math.min(...C),s=Math.max(...C),d=L-j,E=s-A,v=l.size/Math.max(d,E),u=Math.max(1,Math.round(d*v)),D=Math.max(1,Math.round(E*v)),k=[(m[0]+a[0])/2,(m[1]+a[1])/2,(m[2]+a[2])/2],K=Math.max(a[0]-m[0],a[1]-m[1],a[2]-m[2])+10,W=new it(-d/2,d/2,E/2,-E/2,.01,K*2);i==="top"?(W.position.set(k[0],a[1]+K/2,k[2]),W.up.set(0,0,-1)):i==="front"?W.position.set(k[0],k[1],a[2]+K/2):W.position.set(a[0]+K/2,k[1],k[2]),W.lookAt(k[0],k[1],k[2]),W.updateMatrixWorld(!0);const Z=r.drawer.copy(W,u,D),o=Z.getContext("2d");if(!o)throw new Error("No 2D canvas in this page.");const T=t=>[(N(t)-j)*v,(s-z(t))*v],S=Math.max(11,Math.round(l.size/70));o.lineWidth=1,o.font=`500 ${String(S)}px "Inter", system-ui, sans-serif`;const _=[];for(let t=Math.ceil(j/l.grid)*l.grid;t<=L+1e-9;t+=l.grid)_.push(t);const R=[];for(let t=Math.ceil(A/l.grid)*l.grid;t<=s+1e-9;t+=l.grid)R.push(t);for(const t of _){const e=(t-j)*v;o.strokeStyle=Math.abs(t)<1e-9?g.gridStrong:g.grid,o.beginPath(),o.moveTo(e,0),o.lineTo(e,D),o.stroke()}for(const t of R){const e=(s-t)*v;o.strokeStyle=Math.abs(t)<1e-9?g.gridStrong:g.grid,o.beginPath(),o.moveTo(0,e),o.lineTo(u,e),o.stroke()}const $=Math.round(S*.35),U=S+$*2,q=(t,e,n)=>{const c=o.measureText(t).width+$*2;return o.fillStyle=g.label,o.fillRect(e,n,c,U),o.fillStyle=g.captionText,o.textBaseline="middle",o.fillText(t,e+$,n+U/2+.5),c};let G=0;for(const t of R)G=Math.max(G,o.measureText(`${w[i].vName} ${X(i==="top"?-t:t)}`).width+$*2);let tt=G+$;for(const t of _){const e=(t-j)*v,n=`${w[i].uName} ${X(i==="side"?-t:t)}`,c=o.measureText(n).width+$*2;e<tt||e+c>u||(q(n,e,D-U),tt=e+c+$)}let ot=D-U-$;for(const t of R){const e=(s-t)*v;e+U>ot||e<0||(q(`${w[i].vName} ${X(i==="top"?-t:t)}`,0,e),ot=e-$)}o.textBaseline="alphabetic",o.strokeStyle=g.box,o.lineWidth=1.5;for(const t of b){const e=t.box,n=t.upright;if(!(!e||!n)){if(o.beginPath(),i==="top")n.footprint.forEach(([c,h],p)=>{const[f,M]=T([c,0,h]);p===0?o.moveTo(f,M):o.lineTo(f,M)}),o.closePath();else{const[c,h]=T(e.min),[p,f]=T(e.max);o.rect(Math.min(c,p),Math.min(h,f),Math.abs(p-c),Math.abs(f-h))}o.stroke()}}if(i==="top"){o.strokeStyle=g.box,o.lineWidth=2;for(const t of b){const e=t.upright;if(!e)continue;const n=nt([t.front[0],0,t.front[2]]);if(n[0]===0&&n[2]===0)continue;const c=Math.max(.25,Math.min(e.length,e.width)/2+.15),[h,p]=T(e.center),[f,M]=T([e.center[0]+n[0]*c,0,e.center[2]+n[2]*c]);ft(o,h,p,f,M)}}for(const t of b){const e=t.box;if(!e)continue;const[n,c]=T(t.upright?.center??e.center);Q(o,t.name,n,c,{size:S,dot:g.box})}for(const{name:t,aimed:e}of y){const n=e.resolved,c=n.target?Math.hypot(n.target[0]-n.position[0],n.target[1]-n.position[1],n.target[2]-n.position[2]):2,h=(i==="top"?n.fov.horizontal:n.fov.vertical)*Math.PI/360,p=i==="top"?n.right:n.up;o.strokeStyle=g.camera,o.lineWidth=1.5;const[f,M]=T(n.position);for(const I of[-1,1]){const V=nt([n.forward[0]*Math.cos(h)+p[0]*Math.sin(h)*I,n.forward[1]*Math.cos(h)+p[1]*Math.sin(h)*I,n.forward[2]*Math.cos(h)+p[2]*Math.sin(h)*I]),[st,et]=T([n.position[0]+V[0]*c,n.position[1]+V[1]*c,n.position[2]+V[2]*c]);o.beginPath(),o.moveTo(f,M),o.lineTo(st,et),o.stroke()}o.setLineDash([4,4]);const[H,J]=T([n.position[0]+n.forward[0]*c,n.position[1]+n.forward[1]*c,n.position[2]+n.forward[2]*c]);o.beginPath(),o.moveTo(f,M),o.lineTo(H,J),o.stroke(),o.setLineDash([]),o.fillStyle=g.camera,o.beginPath(),o.arc(f,M,S*.32,0,Math.PI*2),o.fill(),Q(o,`camera ${t}`,f-S*.5,M+S*1.7,{size:S})}return O.forEach((t,e)=>{o.strokeStyle=g.path,o.lineWidth=2,o.beginPath(),t.points.forEach((h,p)=>{const[f,M]=T(h);p===0?o.moveTo(f,M):o.lineTo(f,M)}),o.stroke();const n=F[e]?.points??[],c=h=>h.toFixed(h%1===0?0:2);for(let h=0;h<n.length;){const p=n[h];if(!p)break;let f=h;for(;f+1<n.length;){const I=n[f+1];if(!I||Math.hypot(I.position[0]-p.position[0],I.position[1]-p.position[1],I.position[2]-p.position[2])>1e-6)break;f++}const M=n[f]??p,[H,J]=T(p.position);Q(o,`${t.name} ${f>h?`${c(p.t)}–${c(M.t)}`:c(p.t)} s`,H,J,{size:Math.round(S*.85),dot:g.path}),h=f+1}}),{view:i,png:rt(Z,l.picture),width:u,height:D,scale:Math.round(v*1e3)/1e3,bounds:{min:B(m),max:B(a),size:B([a[0]-m[0],a[1]-m[1],a[2]-m[2]]),center:B(k)}}}function ft(r,i,m,a,l){const b=Math.atan2(l-m,a-i),y=8;r.beginPath(),r.moveTo(i,m),r.lineTo(a,l),r.moveTo(a,l),r.lineTo(a-y*Math.cos(b-.45),l-y*Math.sin(b-.45)),r.moveTo(a,l),r.lineTo(a-y*Math.cos(b+.45),l-y*Math.sin(b+.45)),r.stroke()}

package/dist/node_modules/@allyhub/scenery-host/dist/queries/view.d.ts

@@ -0,0 +1,10 @@
+import type { ViewRequest, ViewResult } from "@allyhub/scenery";
+import { type SceneryPage } from "../page/page.js";
+/**
+ * A canvas as a data URL: a PNG, every pixel as drawn, or a WebP to look at
+ * (quality 90), encoded here rather than made one after.
+ */
+export declare function pictureUrl(canvas: HTMLCanvasElement, picture: "png" | "webp" | undefined): string;
+/** Pictures from cameras at moments, tiled with their cameras in numbers. */
+export declare function view(page: SceneryPage, req: ViewRequest): Promise<ViewResult>;
+//# sourceMappingURL=view.d.ts.map

package/dist/node_modules/@allyhub/scenery-host/dist/screen-light.d.ts

@@ -0,0 +1,58 @@
+import { Material, type MeshStandardMaterial, type Texture, Vector3 } from "three";
+/** The screens one draw lights by, at most. */
+export declare const LIGHT_SCREENS = 2;
+export { SCREEN_LIGHT_DEFAULTS } from "@allyhub/scenery";
+/** A screen's light: its picture now, where its content's corners are, how bright. */
+export interface LitScreen {
+    picture: Texture;
+    /** Its picture's pixels each way. */
+    size: [number, number];
+    /** Its content's top-left corner, and the edges to its top-right and bottom-left, world space. */
+    corner: Vector3;
+    across: Vector3;
+    down: Vector3;
+    /** What its white gives out, scene-linear. */
+    brightness: number;
+    cells: [number, number];
+    /**
+     * The steady radiance the scenery already has from it, scene-linear RGB
+     * (its bake's pane): its light is its picture's less this. None: all of it.
+     */
+    base?: readonly [number, number, number];
+    /** Whether it is reflected by the materials it lights (false: its diffuse light alone). */
+    specular?: boolean;
+}
+/** Whether a material takes the screens' reflection: not with userData.screenLight = { specular: false }. */
+export declare function reflectsScreens(material: Material): boolean;
+/** The light the screens drawn in a scenery cast, patched into its lit materials. */
+export declare class ScreenLight {
+    private readonly uniforms;
+    /** Each material it lights, with the screens its program was last asked to light by. */
+    private readonly patched;
+    /** How many materials it lights. */
+    count: number;
+    /**
+     * @param reflectsBase Whether a material's reflections already hold the
+     *   screens' steady light (LitScreen.base), so that their reflection in
+     *   it subtracts it as their diffuse light does; read when the material
+     *   is compiled. Default: every material's.
+     */
+    constructor(reflectsBase?: (material: Material) => boolean);
+    private readonly reflectsBase;
+    /**
+     * The texture units it adds to each material it lights: a sampler per
+     * screen lit (the last set() that lit any), the number the materials are
+     * compiled with.
+     */
+    samplers: number;
+    /** Whether it lights a material. */
+    has(material: Material): boolean;
+    /** The screens to light by from now on (at most LIGHT_SCREENS; none turns it off). */
+    set(screens: readonly LitScreen[]): void;
+    /**
+     * Adds the screens' light to a material: compiled again the first time,
+     * and again whenever the number of screens lit changed since.
+     */
+    patch(material: MeshStandardMaterial): void;
+}
+//# sourceMappingURL=screen-light.d.ts.map

package/dist/node_modules/@allyhub/scenery-host/dist/screen-light.js

@@ -0,0 +1,156 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{Material as l,Vector3 as a}from"three";export const LIGHT_SCREENS=2;export{SCREEN_LIGHT_DEFAULTS}from"@allyhub/scenery";export function reflectsScreens(n){const e=n.userData.screenLight;return!(typeof e=="object"&&e!==null&&e.specular===!1)}const i=String(LIGHT_SCREENS),u=(n,e,t)=>`
+#define S_SCREENS ${String(n)}
+${e?"":"#define S_NO_MIRROR"}
+${t?"":"#define S_MIRROR_WHOLE"}
+uniform int sCount;
+${Array.from({length:n},(o,s)=>`uniform sampler2D sPicture${String(s)};`).join(`
+`)}
+uniform vec3 sCorner[${i}];
+uniform vec3 sAcross[${i}];
+uniform vec3 sDown[${i}];
+uniform float sBright[${i}];
+uniform vec3 sBase[${i}];
+uniform float sSpecular[${i}];
+uniform vec2 sSize[${i}];
+uniform vec2 sCells[${i}];
+
+// One edge's share of a polygon's irradiance at the origin (its vertices
+// relative to the point), facing n.
+float sEdge( vec3 a, vec3 b, vec3 n ) {
+  vec3 ua = normalize( a );
+  vec3 ub = normalize( b );
+  vec3 g = cross( ua, ub );
+  float l = length( g );
+  if ( l < 1e-7 ) return 0.0;
+  return acos( clamp( dot( ua, ub ), -1.0, 1.0 ) ) * dot( g / l, n );
+}
+
+// A quad's irradiance factor at the origin facing n, its vertices relative
+// to the point: clipped to n·v >= 0, then Lambert's formula (E = L · this).
+float sQuad( vec3 q0, vec3 q1, vec3 q2, vec3 q3, vec3 n ) {
+  vec3 q[4] = vec3[4]( q0, q1, q2, q3 );
+  vec3 o[5];
+  int k = 0;
+  for ( int i = 0; i < 4; i++ ) {
+    vec3 a = q[i];
+    vec3 b = q[( i + 1 ) % 4];
+    float da = dot( a, n );
+    float db = dot( b, n );
+    if ( da >= 0.0 && k < 5 ) { o[k] = a; k++; }
+    if ( ( da >= 0.0 ) != ( db >= 0.0 ) && k < 5 ) { o[k] = a + ( b - a ) * ( da / ( da - db ) ); k++; }
+  }
+  if ( k < 3 ) return 0.0;
+  float s = 0.0;
+  for ( int i = 0; i < 5; i++ ) {
+    if ( i >= k ) break;
+    s += sEdge( o[i], o[( i + 1 ) % k], n );
+  }
+  return 0.5 * abs( s );
+}
+
+vec3 sDiffuse( sampler2D pic, int i, vec3 P, vec3 n ) {
+  vec3 c = sCorner[i];
+  vec3 ax = sAcross[i];
+  vec3 dw = sDown[i];
+  vec3 front = normalize( cross( dw, ax ) );
+  if ( dot( P - c, front ) <= 0.0 ) return vec3( 0.0 );
+  int cx = int( sCells[i].x );
+  int cy = int( sCells[i].y );
+  float lod = log2( max( sSize[i].x / sCells[i].x, sSize[i].y / sCells[i].y ) );
+  vec3 E = vec3( 0.0 );
+  for ( int x = 0; x < 32; x++ ) {
+    if ( x >= cx ) break;
+    for ( int y = 0; y < 32; y++ ) {
+      if ( y >= cy ) break;
+      float u0 = float( x ) / sCells[i].x;
+      float u1 = float( x + 1 ) / sCells[i].x;
+      float v0 = float( y ) / sCells[i].y;
+      float v1 = float( y + 1 ) / sCells[i].y;
+      vec3 a = c + ax * u0 + dw * v0 - P;
+      vec3 b = c + ax * u1 + dw * v0 - P;
+      vec3 d = c + ax * u1 + dw * v1 - P;
+      vec3 e = c + ax * u0 + dw * v1 - P;
+      float f = sQuad( a, b, d, e, n );
+      if ( f <= 0.0 ) continue;
+      vec3 L = textureLod( pic, vec2( ( u0 + u1 ) * 0.5, ( v0 + v1 ) * 0.5 ), lod ).rgb;
+      // What it differs by from the steady light the scenery has from it.
+      E += ( L * sBright[i] - sBase[i] ) * f;
+    }
+  }
+  return E;
+}
+
+#ifndef S_NO_MIRROR
+// The share of a tent of half-width r (> 0) round 0 that lies below x,
+// each axis: 0 at -r, 1 at r, smooth at both ends.
+vec2 sTent( vec2 x, vec2 r ) {
+  vec2 a = clamp( x / r, -1.0, 1.0 );
+  return 0.5 + a - 0.5 * a * abs( a );
+}
+
+// The reflection of screen i in the mirror direction rd from P: the
+// picture's mean over the part of the lobe's footprint on the screen, times
+// that part's share of the footprint.
+vec3 sMirror( sampler2D pic, int i, vec3 P, vec3 rd, float roughness ) {
+  vec3 c = sCorner[i];
+  vec3 ax = sAcross[i];
+  vec3 dw = sDown[i];
+  vec3 front = normalize( cross( dw, ax ) );
+  float den = dot( rd, front );
+  if ( den >= -1e-4 ) return vec3( 0.0 );
+  float t = dot( c - P, front ) / den;
+  if ( t <= 0.0 ) return vec3( 0.0 );
+  vec3 H = P + rd * t - c;
+  vec2 len = vec2( length( ax ), length( dw ) );
+  vec2 uv = vec2( dot( H, ax ), dot( H, dw ) ) / ( len * len );
+  // The footprint on the plane, a tent each way: its half-width the lobe's
+  // at the distance (tan 2.8α round the ray, α = roughness², so its half
+  // maximum is at about GGX's), longer along each axis by the ray's slant
+  // to the plane; in shares of the screen's sides.
+  vec2 slant = vec2( dot( rd, ax ), dot( rd, dw ) ) / ( len * den );
+  vec2 r = max( t * roughness * roughness * 2.8 * sqrt( 1.0 + slant * slant ) / len, 1e-6 );
+  // The footprint's share on the screen.
+  vec2 share = sTent( 1.0 - uv, r ) - sTent( - uv, r );
+  if ( share.x * share.y <= 0.0 ) return vec3( 0.0 );
+  // The picture's mean over the part on the screen: a level as wide as the
+  // footprint, at that part's middle.
+  vec2 px = r * sSize[i];
+  float lod = log2( max( 1.0, sqrt( px.x * px.y ) ) );
+  vec2 at = clamp( ( max( uv - r, 0.0 ) + min( uv + r, 1.0 ) ) * 0.5, 0.0, 1.0 );
+#ifdef S_MIRROR_WHOLE
+  vec3 base = vec3( 0.0 );
+#else
+  vec3 base = sBase[i];
+#endif
+  return ( textureLod( pic, at, lod ).rgb * sBright[i] - base ) * ( share.x * share.y );
+}
+#endif
+`,f=`
+#include <lights_fragment_end>
+if ( sCount > 0 && !isOrthographic ) {
+  vec3 sP = ( vec4( - vViewPosition, 0.0 ) * viewMatrix ).xyz + cameraPosition;
+  vec3 sN = normalize( ( vec4( normal, 0.0 ) * viewMatrix ).xyz );
+  vec3 sE = sDiffuse( sPicture0, 0, sP, sN );
+#if S_SCREENS > 1
+  if ( sCount > 1 ) sE += sDiffuse( sPicture1, 1, sP, sN );
+#endif
+  reflectedLight.directDiffuse += BRDF_Lambert( material.diffuseContribution ) * sE;
+#ifndef S_NO_MIRROR
+  vec3 sV = normalize( cameraPosition - sP );
+  vec3 sR = reflect( - sV, sN );
+  vec3 sM = vec3( 0.0 );
+  if ( sSpecular[0] > 0.0 ) sM += sMirror( sPicture0, 0, sP, sR, material.roughness );
+#if S_SCREENS > 1
+  if ( sCount > 1 && sSpecular[1] > 0.0 ) sM += sMirror( sPicture1, 1, sP, sR, material.roughness );
+#endif
+  // A metal's own colour is its reflectance (specularColorBlended, as
+  // three.js's area lights take it), a dielectric's its specular colour.
+  reflectedLight.indirectSpecular += sM * EnvironmentBRDF( geometryNormal, geometryViewDir, material.specularColorBlended, material.specularF90, material.roughness );
+#endif
+}
+`,v=`
+outgoingLight = max( outgoingLight, vec3( 0.0 ) );
+#include <opaque_fragment>
+`;export class ScreenLight{uniforms={sCount:{value:0},sPicture0:{value:null},sPicture1:{value:null},sCorner:{value:[new a,new a]},sAcross:{value:[new a,new a]},sDown:{value:[new a,new a]},sBright:{value:[0,0]},sBase:{value:[new a,new a]},sSpecular:{value:[1,1]},sSize:{value:[1,1,1,1]},sCells:{value:[1,1,1,1]}};patched=new WeakMap;count=0;constructor(e=()=>!0){this.reflectsBase=e}reflectsBase;samplers=1;has(e){return this.patched.has(e)}set(e){const t=this.uniforms,o=e.slice(0,LIGHT_SCREENS);t.sCount.value=o.length,o.length>0&&(this.samplers=o.length),o.forEach((s,r)=>{r===0?t.sPicture0.value=s.picture:t.sPicture1.value=s.picture,t.sCorner.value[r]?.copy(s.corner),t.sAcross.value[r]?.copy(s.across),t.sDown.value[r]?.copy(s.down),t.sBright.value[r]=s.brightness,t.sBase.value[r]?.set(...s.base??[0,0,0]),t.sSpecular.value[r]=s.specular===!1?0:1,t.sSize.value[r*2]=s.size[0],t.sSize.value[r*2+1]=s.size[1],t.sCells.value[r*2]=Math.max(1,Math.min(32,Math.round(s.cells[0]))),t.sCells.value[r*2+1]=Math.max(1,Math.min(32,Math.round(s.cells[1])))}),t.sPicture1.value??=t.sPicture0.value}patch(e){const t=this.patched.get(e);if(t===this.samplers||(this.patched.set(e,this.samplers),e.needsUpdate=!0,t!==void 0))return;this.count++;const o=e.onBeforeCompile.bind(e),s=e.customProgramCacheKey===l.prototype.customProgramCacheKey?e.onBeforeCompile.toString():e.customProgramCacheKey();e.onBeforeCompile=(r,c)=>{o(r,c),Object.assign(r.uniforms,this.uniforms),r.fragmentShader=r.fragmentShader.replace("void main() {",`${u(this.samplers,reflectsScreens(e),this.reflectsBase(e))}
+void main() {`).replace("#include <lights_fragment_end>",f).replace("#include <opaque_fragment>",v)},e.customProgramCacheKey=()=>`${s}|allyhub screen light ${String(this.samplers)}${reflectsScreens(e)?"":" diffuse"}${this.reflectsBase(e)?"":" whole mirror"}`}}

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

@@ -0,0 +1,128 @@
+import { type CameraState, type Scenery } from "@allyhub/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 long the wheel rests before the camera it moved is told, ms. */
+    wheelRestMs: 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;
+}
+/** Flies to a view the viewer told before (a note's), Back to where it was. */
+ | {
+    type: "view";
+    position: readonly [number, number, number];
+    target: readonly [number, number, number];
+}
+/** A wheel the page had where the viewer did not (a page's note mode takes the pointer from its frames). */
+ | {
+    type: "wheel";
+    deltaY: number;
+    ctrlKey: boolean;
+} | {
+    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/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 xt,Mesh as wt,PerspectiveCamera as ht,Raycaster as bt,Vector2 as vt,Vector3 as h}from"three";import{fitCamera as Mt}from"@allyhub/scenery";import{ownFrame as kt,ownTimers as q}from"./clock.js";import{SceneryPage as Et}from"./page/page.js";const U=i=>{kt(i)},z=()=>q.now();export const VIEWER_DEFAULTS={orbitSpeed:.3,maxElevation:89,dollyPerNotch:.12,minDistance:.02,maxDistance:200,lens:30,flyMs:450,wheelRestMs:150,fill:.8,clickSlop:4,marks:!0,markColor:"#1471e2"};const Q=i=>i*Math.PI/180,pt=i=>[Math.round(i.x*1e3)/1e3,Math.round(i.y*1e3)/1e3,Math.round(i.z*1e3)/1e3],_=i=>i*180/Math.PI;function zt(i,u){const M=Math.hypot(36,24)/Math.hypot(u,1);return _(2*Math.atan(M/(2*i)))}function G(i){const u=Q(i.elevation),c=Q(i.azimuth);return new h(i.target.x+i.distance*Math.cos(u)*Math.sin(c),i.target.y+i.distance*Math.sin(u),i.target.z+i.distance*Math.cos(u)*Math.cos(c))}function D(i,u){const c=i.clone().sub(u),M=Math.max(c.length(),1e-4);return{target:u.clone(),azimuth:_(Math.atan2(c.x,c.z)),elevation:_(Math.asin(Math.max(-1,Math.min(1,c.y/M)))),distance:M}}function Ct(i){const u=[];for(let c=i;c?.parent;c=c.parent)c.name&&u.unshift(c);return u}const St=(i,u)=>i.length===u.length&&i.every((c,M)=>c===u[M]);function T(i){return new xt().setFromObject(i)}export async function startViewer(i,u,c,M={},x=()=>{},Y){const p={...VIEWER_DEFAULTS,...M},g=await Et.open(i,u),H=()=>0;g.pose(0,H);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 J=t=>{const e=document.createElement("div");e.style.cssText=`position:absolute;pointer-events:none;border:1.5px ${t?"dashed":"solid"} ${p.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:${p.markColor};padding:2px 6px;border-radius:4px;white-space:nowrap`,e.appendChild(n),c.appendChild(e),{box:e,label:n}},mt=J(!0),ut=J(!1),O=T(g.scene),Z=O.isEmpty()?new h:O.getCenter(new h),ft=O.isEmpty()?1:Math.max(O.getSize(new h).length()/2,.05);let s={target:Z,azimuth:25,elevation:20,distance:ft*2.4};const $=g.named.cameras,tt=Object.keys($)[0];let w=new ht(40,1,.01,500);const C=()=>{const t=c.getBoundingClientRect();return{w:Math.max(1,t.width),h:Math.max(1,t.height)}},et=t=>{const e=$[t];if(!e)return;const{w:n,h:a}=C(),o=g.aim(e,n/a),r=o.camera.position.clone(),l=new h(0,0,-1).applyQuaternion(o.camera.quaternion),m=typeof e.target=="string"?new h(...g.pointOf(e.target)):Array.isArray(e.target)?new h(...e.target):r.clone().add(l.multiplyScalar(Math.max(r.distanceTo(Z),.1)));return D(r,m)};Y?s=D(new h(...Y.position),new h(...Y.target)):tt&&(s=et(tt)??s);let y=[],v=[],X=!1;const yt=t=>{const e=t[t.length-1];if(!e)return null;const n=T(e);if(n.isEmpty())return null;const{w:a,h:o}=C();let r=1/0,l=1/0,m=-1/0,b=-1/0;for(let S=0;S<8;S++){const j=new h(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(w);if(j.z>1)return null;r=Math.min(r,(j.x+1)/2*a),l=Math.min(l,(1-j.y)/2*o),m=Math.max(m,(j.x+1)/2*a),b=Math.max(b,(1-j.y)/2*o)}const A=4,W=Math.max(0,r-A),K=Math.max(0,l-A),lt=Math.min(a,m+A),dt=Math.min(o,b+A);return lt<=W||dt<=K?null:{x:W,y:K,width:lt-W,height:dt-K}},nt=(t,e)=>{const n=yt(e);return!n||!p.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=()=>{X=!1;const{w:t,h:e}=C(),n=Math.min(window.devicePixelRatio||1,2),a=z();w=new ht(zt(p.lens,t/e),t/e,Math.max(.005,s.distance/500),Math.max(50,s.distance*50)),w.position.copy(G(s)),w.lookAt(s.target),w.updateMatrixWorld(!0),g.pose(0,H),g.drawer.inPlace(w,Math.round(t*n),Math.round(e*n)),d.style.width="100%",d.style.height="100%";const o=nt(mt,St(v,y)?[]:v),r=nt(ut,y);x({type:"place",hover:o,select:r}),x({type:"drawn",ms:z()-a})},k=()=>{X||(X=!0,U(I))};let P=0;const L=t=>{const e={...s,target:s.target.clone()},n=++P,a=z();let o=t.azimuth-e.azimuth;o=((o+180)%360+360)%360-180;const r=()=>{if(n!==P)return;const l=Math.min(1,(z()-a)/p.flyMs),m=l<.5?4*l*l*l:1-(-2*l+2)**3/2;s={target:e.target.clone().lerp(t.target,m),azimuth:e.azimuth+o*m,elevation:e.elevation+(t.elevation-e.elevation)*m,distance:e.distance*(t.distance/e.distance)**m},I(),l<1?U(r):R()};U(r)},R=()=>{x({type:"camera",camera:{position:pt(G(s)),target:pt(s.target),lens:p.lens},framed:E.length>0})},ot=new bt,F=(t,e)=>{const n=c.getBoundingClientRect(),a=new vt((t-n.left)/n.width*2-1,-((e-n.top)/n.height)*2+1);ot.setFromCamera(a,w);const o=ot.intersectObject(g.scene,!0);for(const r of o){if(!(r.object instanceof wt)||!r.object.visible)continue;let l=!0;for(let b=r.object;b;b=b.parent)b.visible||(l=!1);if(!l)continue;const m=Ct(r.object);if(m.length>0)return{path:m,point:r.point}}return null},B=(t,e)=>{const n=t[t.length-1]??g.scene,a=T(n).getSize(new h),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)]}},N=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)<p.clickSlop)return;if(f.moved=!0,f.x=t.clientX,f.y=t.clientY,f.pan){const{h:r}=C(),l=2*s.distance*Math.tan(Q(w.fov)/2)/r,m=new h().setFromMatrixColumn(w.matrixWorld,0),b=new h().setFromMatrixColumn(w.matrixWorld,1);s.target.add(m.multiplyScalar(-a*l)),s.target.add(b.multiplyScalar(o*l))}else s.azimuth-=a*p.orbitSpeed,s.elevation=Math.max(-p.maxElevation,Math.min(p.maxElevation,s.elevation+o*p.orbitSpeed));k();return}const e=F(t.clientX,t.clientY),n=e?N(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?B(n,e.point):null}),k())});const at=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&&R(),!e)return;const a=F(t.clientX,t.clientY);y=a?N(a.path):[],x({type:"select",object:a&&y.length?B(y,a.point):null}),k()};d.addEventListener("pointerup",at),d.addEventListener("pointercancel",at),d.addEventListener("pointerleave",()=>{v.length&&(v=[],x({type:"hover",object:null}),k())});let it;const rt=(t,e)=>{P++;const n=t/100*(e?4:1);s.distance=Math.max(p.minDistance,Math.min(p.maxDistance,s.distance*(1+p.dollyPerNotch)**n)),k(),q.clearTimeout(it),it=q.setTimeout(R,p.wheelRestMs)};d.addEventListener("wheel",t=>{t.preventDefault(),rt(t.deltaY,t.ctrlKey)},{passive:!1}),new ResizeObserver(k).observe(c);const E=[],V=t=>{const e=T(t);if(e.isEmpty())return;const n=e.getCenter(new h),{w:a,h:o}=C(),r=s.target.clone().sub(G(s));let l;try{const m=Mt({boxes:[{min:e.min.toArray(),max:e.max.toArray()}],aspect:a/o,direction:r.toArray(),aim:n.toArray(),lens:p.lens,fill:p.fill,near:Math.max(.005,e.getSize(new h).length()/500)});l=new h(...m.position)}catch{return}E.push({...s,target:s.target.clone()}),L(D(l,n))},st=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},ct=t=>{switch(t.type){case"camera":{const e=et(t.name);e&&(E.push({...s,target:s.target.clone()}),L(e));return}case"view":{E.push({...s,target:s.target.clone()}),L(D(new h(...t.position),new h(...t.target)));return}case"wheel":rt(t.deltaY,t.ctrlKey);return;case"frame":{const e=st(t.path).pop();e&&V(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=F(t.x,t.y);x({type:"picked",id:t.id,object:e?B(e.path,e.point):null});return}case"back":{const e=E.pop();e&&L(e);return}case"select":y=t.path?st(t.path):[],k();return}};window.addEventListener("keydown",t=>{if(t.key==="Escape")E.length?ct({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&&V(e)}}),d.addEventListener("dblclick",t=>{const e=F(t.clientX,t.clientY),n=e?N(e.path).pop():void 0;n&&V(n)});const gt=z();return I(),x({type:"ready",cameras:Object.keys($),ms:z()-gt}),R(),{command:ct}}

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

@@ -0,0 +1,29 @@
+{
+  "name": "@allyhub/scenery-host",
+  "version": "0.8.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/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/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 g,NumericAxis as b,PieChart as k,Reference as _,ScatterChart as x,Scaling as C,Series as A,TextAxis as S}from"./charts.js";import{AutoFilter as v,ConditionalFormattingList as D,DataValidation as P,DataValidationList as F,DifferentialStyle as L,Rule as T}from"./rules.js";import{Alignment as R,Border as I,Color as N,Font as E,PatternFill as V,Side as B}from"./styles.js";import{Cell as W,ColumnDimension as j,DefinedName as G,DefinedNameDict as H,RowDimension as M,Table as O,TableList as U,Workbook as z,Worksheet as q}from"./workbook.js";import{Comment as X,HeaderFooter as J,HeaderFooterPart as K,Image as Q,PageMargins as Y,PageSetup as Z,SheetProtection as $}from"./page.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."},PageSetup:{fitToWidth:"Pages wide; setting it or fitToHeight fits the sheet, with no pageSetUpPr to set."},ColumnDimension:{files:"Its cells name files, from the sheet's folder: true, or { separator, height }."}},ee=["add_data","set_categories","append","title","legend","width","height","style","anchor","series","dataLabels","x_axis","y_axis"],te={BarChart:["type","grouping","overlap","gapWidth","varyColors"],LineChart:["grouping"],AreaChart:["grouping"],PieChart:["varyColors"],DoughnutChart:["holeSize"],ScatterChart:[]},oe={Workbook:z.prototype,Worksheet:q.prototype,Cell:W.prototype,Font:E.prototype,PatternFill:V.prototype,Border:I.prototype,Side:B.prototype,Alignment:R.prototype,Color:N.prototype,Table:O.prototype,TableList:U.prototype,DefinedName:G.prototype,DefinedNameDict:H.prototype,ColumnDimension:j.prototype,RowDimension:M.prototype,ConditionalFormattingList:D.prototype,Rule:T.prototype,DifferentialStyle:L.prototype,DataValidation:P.prototype,DataValidationList:F.prototype,AutoFilter:v.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:S.prototype,NumericAxis:b.prototype,DataLabelList:m.prototype,Marker:g.prototype,GraphicalProperties:w.prototype,LineProperties:y.prototype,PageSetup:Z.prototype,PageMargins:Y.prototype,_HeaderFooterItem:J.prototype,_HeaderFooterPart:K.prototype,SheetProtection:$.prototype,Comment:X.prototype,Image:Q.prototype},r=["title","scaling","majorUnit","number_format","delete","majorGridlines"],ae={_HeaderFooterItem:["left","center","right"],Comment:["text","author"],Image:["path","width","height","anchor"],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(te).map(([e,t])=>[e,[...ee.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 re=()=>{const e={};for(const[t,o]of Object.entries(oe)){const i=a[t]??{};e[t]=[...n(o),...ae[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:re(),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. This API does not read or write .xlsx: allyhub sheet import and allyhub render --type xlsx do.","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")}};