allyhub 0.7.0 → 0.8.0

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

@@ -0,0 +1,110 @@
+import { Box3, Matrix4, Mesh, type Object3D, type Scene } from "three";
+import type { MeshBVH } from "three-mesh-bvh";
+import { type ResolvedCamera } from "@allyhub/scenery";
+import type { CameraClearance, Contact, MeasureRequest, MeasureResult, MeshHealth, Motion, MotionRequest, SeeRequest, SeeResult, Support } from "@allyhub/scenery";
+import type { Vec3 } from "../vec.js";
+import { type SceneryPage } from "../page/page.js";
+import { type Solid } from "./solid.js";
+/**
+ * What the measurements read of a scenery's page: its scene, posed at a
+ * moment, its objects by name and manifold-3d's wasm. A SceneryPage is one.
+ */
+export interface Measured {
+    readonly scene: Scene;
+    pose(t: number, time?: (ref: string) => number): void;
+    objectNamed(name: string): Object3D;
+    readonly manifoldWasm?: string | undefined;
+}
+/**
+ * What an object's triangles in world space depend on: each shown mesh in
+ * it and under it as posed (poseKey); undefined when one deforms.
+ */
+export declare function objectKey(o: Object3D): string | undefined;
+/** Solids of a pose, by named object and by mesh, with each one's health on demand. */
+export declare class Solids {
+    all: Map<Object3D, string>;
+    /** Each named object's solid and the pose it was made at (objectKey). */
+    private readonly named;
+    private meshes?;
+    /** Each mesh's solid and the pose it was made at (poseKey). */
+    private readonly kept;
+    private readonly health;
+    /** Meshes' triangles in their own frames, by their geometry (localOf). */
+    private readonly locals;
+    /** Health by the shape it was measured on (shapeKey), at any pose. */
+    private readonly healthByShape;
+    /** Contacts and supports measured, by what they depend on. */
+    readonly contacts: Map<string, Contact | null>;
+    readonly supports: Map<string, Support>;
+    private readonly page;
+    constructor(page: Measured);
+    /** A named object's solid; undefined when it has no visible mesh. */
+    of(o: Object3D): Solid | undefined;
+    /** What a named object's solid depends on (objectKey), as last made. */
+    keyOf(s: Solid): string | undefined;
+    /** Every visible mesh with the path of its nearest named object (or its own type), in the scene's order. */
+    meshEntries(): {
+        mesh: Mesh;
+        owner: Object3D;
+        path: string;
+    }[];
+    /** A mesh as a solid in world space, made again only when it moved, deforms or changed. */
+    meshSolid(e: {
+        mesh: Mesh;
+        owner: Object3D;
+        path: string;
+    }): Solid | undefined;
+    /** Every visible mesh as a solid, named by its nearest named object (or its own path). */
+    everyMesh(): Solid[];
+    /**
+     * A mesh in its own frame, for questions a rigid move does not change:
+     * its triangles there with a BVH, kept by its geometry, so a mesh that
+     * only moves is not made again; with where it is now (the matrix back
+     * into its frame, its scale, its box in the scenery). Undefined for a mesh
+     * that deforms, is instanced or is not scaled evenly: those are asked in
+     * world space.
+     */
+    localOf(mesh: Mesh): {
+        bvh: MeshBVH;
+        inverse: Matrix4;
+        scale: number;
+        box: Box3;
+    } | undefined;
+    /**
+     * The scenery posed again: each solid, a named object's or a mesh's, is
+     * made again when next asked for, only where it moved, deforms or
+     * changed.
+     */
+    refresh(): void;
+    /** Meshes that are not under any of these objects, nor above them. */
+    others(...exclude: Object3D[]): Solid[];
+    healthOf(s: Solid): MeshHealth;
+    /** A solid: closed, its faces turned out. A room's walls, closed and turned in, are not one. */
+    closed: (s: Solid) => boolean;
+    /** Closed with its faces turned in: it encloses space (a room), nothing is inside it as in a solid. */
+    inward: (s: Solid) => boolean;
+    dispose(): void;
+}
+/** The page's solids, brought to the pose it is in now. */
+export declare function solidsOf(page: Measured): Solids;
+/**
+ * Health, contacts, support and the relations asked for, at scenery time t;
+ * `time` finds the moments of references a layer's part gives (else those
+ * the request's --times gave).
+ */
+export declare function measure(page: Measured, req: MeasureRequest, time?: (ref: string) => number): Promise<MeasureResult>;
+/** A camera's near plane as a thin box in its own frame, and the matrix that places it. */
+export declare function nearPlaneOf(cam: ResolvedCamera): {
+    box: Box3;
+    matrix: Matrix4;
+};
+/** The camera itself among the scenery's surfaces. */
+export declare function clearanceOf(solids: Solids, position: Vec3, near: {
+    box: Box3;
+    matrix: Matrix4;
+} | undefined): CameraClearance;
+/** What cameras see, in numbers, at moments. */
+export declare function see(page: SceneryPage, req: SeeRequest): Promise<SeeResult>;
+/** A move's motion, sampled at a steady rate, and how named objects move on its frame. */
+export declare function motion(page: SceneryPage, req: MotionRequest): Motion;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{Box3 as T,DoubleSide as X,InstancedMesh as Y,Matrix4 as I,Mesh as W,Raycaster as Z,Vector2 as q,Vector3 as S}from"three";import{project as B}from"@allyhub/scenery";import{motionOf as tt}from"@allyhub/scenery";import{countable as et,seenFrom as nt}from"../idbuffer.js";import{SceneryError as A}from"../errors.js";import{drawnCamera as K}from"../page/page.js";import{paths as E,shown as V,vec as ot}from"../scene.js";import{contactOf as st}from"./contacts.js";import{healthOf as it}from"./health.js";import{clearAhead as at,freeFloor as rt,sightBetween as ct}from"./relations.js";import{disposeSolid as P,inside as ft,poseKey as N,solidOf as F}from"./solid.js";import{supportOf as lt}from"./support.js";export function objectKey(o){const t=[];let e=!1;return o.traverse(n=>{if(!(n instanceof W)||!V(n))return;const a=N(n);a===void 0?e=!0:t.push(a)}),e?void 0:t.join(";")}const L=o=>String(Math.round(o*1e9)/1e9),D=new I,R=new I;function ht(o){const t=[];let e=!1;if(R.copy(o.matrixWorld).invert(),o.traverse(h=>{if(!(h instanceof W)||!V(h))return;const u=h,d=N(u);if(d===void 0){e=!0;return}D.multiplyMatrices(R,u.matrixWorld),t.push(`${D.elements.map(L).join(",")}|${d.slice(d.indexOf("|")+1)}`)}),e)return;const n=o.matrixWorld.elements,a=h=>[n[h*4]??0,n[h*4+1]??0,n[h*4+2]??0],r=[a(0),a(1),a(2)],m=(h,u)=>(h[0]??0)*(u[0]??0)+(h[1]??0)*(u[1]??0)+(h[2]??0)*(u[2]??0);return`${[0,1,2].flatMap(h=>[0,1,2].map(u=>L(m(r[h]??[],r[u]??[])))).join(",")}|${String(Math.sign(o.matrixWorld.determinant()))}|${t.join(";")}`}export class Solids{all;named=new Map;meshes;kept=new Map;health=new Map;locals=new Map;healthByShape=new Map;contacts=new Map;supports=new Map;page;constructor(t){this.page=t,this.all=E(t.scene)}of(t){const e=objectKey(t),n=this.named.get(t);if(n&&e!==void 0&&n.key===e)return n.solid;n?.solid&&(P(n.solid),this.health.delete(n.solid));const a=F(t,t.name,this.all.get(t)??t.name);return this.named.set(t,{key:e,solid:a}),a}keyOf(t){const e=this.named.get(t.object);return e?e.key:t.object instanceof W?N(t.object):void 0}meshEntries(){const t=[];return this.page.scene.traverse(e=>{if(!(e instanceof W)||!V(e))return;const n=e;let a=n;for(;a?.name===""&&a!==this.page.scene;)a=a.parent;const r=a&&a!==this.page.scene?a:n;t.push({mesh:n,owner:r,path:this.all.get(r)??r.type})}),t}meshSolid(t){const e=N(t.mesh),n=this.kept.get(t.mesh);if(n&&e!==void 0&&n.key===e)return n.solid;n?.solid&&(P(n.solid),this.health.delete(n.solid));const a=F(t.mesh,t.owner.name,t.path);return this.kept.set(t.mesh,{key:e,solid:a}),a}everyMesh(){if(!this.meshes){const t=[],e=new Set;for(const n of this.meshEntries()){const a=this.meshSolid(n);e.add(n.mesh),a&&t.push(a)}for(const[n,a]of this.kept)e.has(n)||(a.solid&&P(a.solid),this.kept.delete(n));this.meshes=t}return this.meshes}localOf(t){if(t instanceof Y)return;const e=N(t);if(e===void 0)return;const n=t.matrixWorld.elements,a=c=>[n[c*4]??0,n[c*4+1]??0,n[c*4+2]??0],[r,m,y]=[a(0),a(1),a(2)],h=c=>Math.hypot(c[0],c[1],c[2]),u=(c,l)=>c[0]*l[0]+c[1]*l[1]+c[2]*l[2],d=h(r),b=c=>Math.abs(c-d)<=1e-9*Math.max(1,d);if(!(d>0)||!b(h(m))||!b(h(y))||Math.abs(u(r,m))>1e-9*d*d||Math.abs(u(r,y))>1e-9*d*d||Math.abs(u(m,y))>1e-9*d*d)return;const s=`${t.geometry.uuid}|${e.slice(e.indexOf("|")+1)}`;let i=this.locals.get(s);if(!i){const c=F(t,t.name,t.name,!0);if(!c)return;i={bvh:c.bvh,box:c.box},this.locals.set(s,i)}return{bvh:i.bvh,inverse:new I().copy(t.matrixWorld).invert(),scale:d,box:i.box.clone().applyMatrix4(t.matrixWorld)}}refresh(){this.all=E(this.page.scene),this.meshes=void 0}others(...t){const e=(n,a)=>{for(let r=n;r;r=r.parent)if(r===a)return!0;return!1};return this.everyMesh().filter(n=>t.every(a=>!e(n.object,a)&&!e(a,n.object)))}healthOf(t){let e=this.health.get(t);if(e)return e;const n=ht(t.object),a=n===void 0?void 0:`${t.path}|${n}`;return e=a===void 0?void 0:this.healthByShape.get(a),e||(e=it(t),a!==void 0&&this.healthByShape.set(a,e)),this.health.set(t,e),e}closed=t=>{const e=this.healthOf(t);return e.closed&&(e.volume??0)>0};inward=t=>{const e=this.healthOf(t);return e.closed&&(e.volume??0)<0};dispose(){for(const t of this.named.values())t.solid&&P(t.solid);for(const t of this.kept.values())t.solid&&P(t.solid);this.named.clear(),this.kept.clear()}}const J=new WeakMap;export function solidsOf(o){let t=J.get(o);return t?t.refresh():(t=new Solids(o),J.set(o,t)),t}function _(o,t,e=!1){if(t&&t.length>0)return t.map(r=>o.objectNamed(r));const n=r=>{for(let m=r.parent;m&&m!==o.scene;m=m.parent)if(m.name!=="")return!0;return!1},a=[];return o.scene.traverse(r=>{r===o.scene||r.name===""||!V(r)||e&&n(r)||a.push(r)}),a}const dt=(o,t)=>{for(let e=o;e;e=e.parent)if(e===t)return!0;for(let e=t;e;e=e.parent)if(e===o)return!0;return!1};let G;function ut(o){return G??=(async()=>{try{const t=o.manifoldWasm,{default:e}=await import("manifold-3d/manifold"),n=await e(t?{locateFile:()=>t}:void 0);return n.setup(),n}catch{return}})(),G}const mt="ExtendedTriangle.intersectsTriangle: Triangles are coplanar";async function pt(o){const t=console.warn;console.warn=(...e)=>{typeof e[0]=="string"&&e[0].startsWith(mt)||t.apply(console,e)};try{return await o()}finally{console.warn=t}}export function measure(o,t,e){return pt(()=>wt(o,t,e))}async function H(o,t,e){try{return await st(o,t,e)}catch(n){return{a:o.path,b:t.path,crossing:!1,touching:!1,missing:`measuring the pair failed: ${n instanceof Error?n.message:String(n)}`}}}async function wt(o,t,e){o.pose(t.t,e);const n=solidsOf(o);{const r=_(o,t.objects,t.nested!==!0).flatMap(s=>{const i=n.of(s);return i?[i]:[]}),m=r.map(s=>n.healthOf(s)),y=[],h={near:t.near,tolerance:t.tolerance,samples:t.samples,lift:t.lift??[0,1,0],closed:n.closed,...t.volume?{manifold:()=>ut(o)}:{},seed:1},u=JSON.stringify([t.near,t.tolerance,t.samples,h.lift,t.volume,t.all]);for(let s=0;s<r.length;s++)for(let i=s+1;i<r.length;i++){const c=r[s],l=r[i];if(!c||!l||dt(c.object,l.object))continue;const M=n.keyOf(c),O=n.keyOf(l),p=M===void 0||O===void 0?void 0:`${c.path}#${M}|${l.path}#${O}|${u}`,k=p===void 0?void 0:n.contacts.get(p),x=k!==void 0?k??void 0:await H(c,l,{...h,always:t.all});p!==void 0&&k===void 0&&n.contacts.set(p,x??null),x&&y.push(x)}if(t.between){const s=n.of(o.objectNamed(t.between[0])),i=n.of(o.objectNamed(t.between[1]));if(!s||!i)throw new A("name",`--between names something with no surface (${s?t.between[1]:t.between[0]}).`);const c=y.findIndex(M=>M.a===s.path&&M.b===i.path||M.a===i.path&&M.b===s.path),l=await H(s,i,{...h,always:!0});l&&(c>=0?y[c]=l:y.push(l))}const d=r.map(s=>{const i=n.others(s.object),c=n.keyOf(s),l=t.tolerance+1e-6,M=i.filter(f=>f.box.min.x<=s.box.max.x+l&&f.box.max.x>=s.box.min.x-l&&f.box.min.z<=s.box.max.z+l&&f.box.max.z>=s.box.min.z-l&&f.box.min.y<=s.box.max.y+l),O=M.map(f=>n.keyOf(f)),p=c===void 0||O.some(f=>f===void 0)?void 0:`${s.path}#${c}|${M.map((f,w)=>`${f.path}#${O[w]??""}`).join(";")}|${String(t.tolerance)},${String(t.grid)}`,k=p===void 0?void 0:n.supports.get(p);if(k)return k;const x=lt(s,i,{tolerance:t.tolerance,grid:t.grid,closed:n.closed});return p!==void 0&&n.supports.set(p,x),x}),b={t:t.t,objects:r.map(s=>s.path),health:m,contacts:y,support:d};if(t.sight){const s=n.of(o.objectNamed(t.sight[0])),i=n.of(o.objectNamed(t.sight[1]));s&&i&&(b.sight=ct(s,i,n.others(s.object,i.object),Math.max(16,t.samples),3))}if(t.clear){const s=n.of(o.objectNamed(t.clear));s&&(b.clear=at(s,n.others(s.object)))}if(t.floor){const s=n.of(o.objectNamed(t.floor.name));if(!s)throw new A("name",`"${t.floor.name}" has no surface to stand on.`);const i=t.floor.from?n.of(o.objectNamed(t.floor.from)):void 0;b.floor=rt(s,n.others(s.object),{radius:t.floor.radius,height:t.floor.height,cell:t.floor.cell,...i?{from:i}:{},targets:r.filter(c=>c!==s)})}return b}}export function nearPlaneOf(o){const t=Math.tan(o.fov.horizontal*Math.PI/360)*o.near,e=Math.tan(o.fov.vertical*Math.PI/360)*o.near,n=new T(new S(-t,-e,-1e-6),new S(t,e,1e-6)),a=new I().makeBasis(new S(...o.right),new S(...o.up),new S(-o.forward[0],-o.forward[1],-o.forward[2]));return a.setPosition(o.position[0]+o.forward[0]*o.near,o.position[1]+o.forward[1]*o.near,o.position[2]+o.forward[2]*o.near),{box:n,matrix:a}}export function clearanceOf(o,t,e){const n={inside:[],nearCut:[]},a=new S(t[0],t[1],t[2]);let r;const m=o.meshEntries(),y=m.map((s,i)=>{const c=o.localOf(s.mesh),l=c?void 0:o.meshSolid(s),M=c?.box??l?.box;return{e:s,index:i,local:c,scenery:l,d:M?M.distanceToPoint(a):1/0}}).filter(s=>s.local!==void 0||s.scenery!==void 0).sort((s,i)=>s.d-i.d||s.index-i.index);let h=-1;if(e){const s=new S;for(let i=0;i<8;i++)s.set(i&1?e.box.max.x:e.box.min.x,i&2?e.box.max.y:e.box.min.y,i&4?e.box.max.z:e.box.min.z).applyMatrix4(e.matrix),h=Math.max(h,s.distanceTo(a))}const u=new S,d=new Map,b=new Map;for(const s of y){if(!r||s.d<=r.distance){let i;if(s.local){u.copy(a).applyMatrix4(s.local.inverse);const c=s.local.bvh.closestPointToPoint(u);c&&(i=c.distance*s.local.scale)}else i=s.scenery?.bvh.closestPointToPoint(a)?.distance;i!==void 0&&(!r||i<r.distance||i===r.distance&&s.index<r.index)&&(r={path:s.e.path,distance:i,index:s.index})}if(s.d===0||e&&s.d<=h){const i=s.scenery??o.meshSolid(s.e);if(!i)continue;i.box.containsPoint(a)&&!o.inward(i)&&ft(i,t)&&d.set(s.index,i),e&&i.bvh.intersectsBox(e.box,e.matrix)&&b.set(s.index,i.path)}}for(let s=0;s<m.length;s++){const i=d.get(s);i&&!n.inside.some(l=>l.path===i.path)&&n.inside.push({path:i.path,closed:o.closed(i)});const c=b.get(s);c!==void 0&&!n.nearCut.includes(c)&&n.nearCut.push(c)}return r&&(n.nearest={path:r.path,distance:Math.round(r.distance*1e6)/1e6}),n}function bt(o){const e=o.getContext("2d")?.getImageData(0,0,o.width,o.height).data,n=new Array(16).fill(0);if(!e||e.length===0)return{mean:0,black:0,white:0,histogram:n};let a=0,r=0,m=0;const y=e.length/4;for(let u=0;u<e.length;u+=4){const d=e[u]??0,b=e[u+1]??0,s=e[u+2]??0,i=(.2126*d+.7152*b+.0722*s)/255;a+=i,(d===0||b===0||s===0)&&r++,(d===255||b===255||s===255)&&m++,n[Math.min(15,Math.floor(i*16))]=(n[Math.min(15,Math.floor(i*16))]??0)+1}const h=u=>Math.round(u*1e4)/1e4;return{mean:h(a/y),black:h(r/y),white:h(m/y),histogram:n.map(u=>h(u/y))}}export async function see(o,t){const{width:e,height:n}=t,a=e/n,r=[];for(const m of t.tiles){const{state:y,label:h}=o.stateOf(m.camera,m.t,a),u=o.shownFor(t.hide,t.only),d=new Solids(o);try{const b=o.aim(y,a),s=o.drawer.copy(b.camera,e,n),i=E(o.scene),c=await nt(o.renderer,o.scene,b.camera,et(o.scene,i),e,n,{by:!0,cut:!0}),l=b.resolved,M=new S(...l.position),O=new Map([...i].map(([x,f])=>[f,x]));for(const x of c){const f=O.get(x.path),w=f?d.of(f)?.bvh.closestPointToPoint(M):void 0;w&&(x.distance=Math.round(w.distance*1e6)/1e6)}const p=clearanceOf(d,l.position,nearPlaneOf(l)),k={t:m.t,label:m.label??h,camera:K(b),objects:c,clearance:p,levels:bt(s)};if(t.pick){const[x,f]=t.pick,w=new Z;w.setFromCamera(new q(x/e*2-1,1-f/n*2),b.camera);let g;for(const v of d.everyMesh()){const j=v.bvh.raycastFirst(w.ray,X);j&&(!g||j.distance<g.d)&&(g={s:v,d:j.distance,p:j.point.clone()})}const $=v=>Math.round(v*1e6)/1e6;k.pick=g?{x,y:f,path:g.s.path,name:g.s.name,point:[$(g.p.x),$(g.p.y),$(g.p.z)],distance:$(g.d)}:{x,y:f}}r.push(k)}finally{d.dispose(),u()}}return{width:e,height:n,tiles:r}}const xt=o=>({peak:0,at:o,mean:0});export function motion(o,t){const e=t.width/t.height,n=1/t.fps,a=[],r=[];for(let c=t.from;c<=t.to+1e-9;c+=n)r.push(Math.round(c*1e6)/1e6);const m=_(o,t.objects),y=E(o.scene),h=new Map;for(const c of m)h.set(c,{x:[],y:[],size:[],inView:[]});const u=Math.max(1,Math.round(t.fps/10));let d,b;try{r.forEach((c,l)=>{const{state:M}=o.stateOf(t.camera,c,e),O=o.aim(M,e),p=O.resolved,k=K(O);a.push({t:c,position:p.position,forward:p.forward,up:p.up,right:p.right,lens:p.lens,yaw:k.yaw,pitch:k.pitch,roll:k.roll,...p.target?{target:p.target}:{}});for(const[x,f]of h){const w=new T().setFromObject(x);if(w.isEmpty())continue;const g=w.getCenter(new S),$=B(p,ot(g));let v=[1/0,1/0],j=[-1/0,-1/0];for(const C of[w.min.x,w.max.x])for(const Q of[w.min.y,w.max.y])for(const U of[w.min.z,w.max.z]){const z=B(p,[C,Q,U]);z.depth<=0||(v=[Math.min(v[0]??0,z.x),Math.min(v[1]??0,z.y)],j=[Math.max(j[0]??0,z.x),Math.max(j[1]??0,z.y)])}f.x.push(($.x+1)/2*t.width),f.y.push((1-$.y)/2*t.height),f.size.push(Number.isFinite(v[0])?Math.hypot(((j[0]??0)-(v[0]??0))/2*t.width,((j[1]??0)-(v[1]??0))/2*t.height):0),f.inView.push($.inView?1:0)}if(l%u===0){b&&o.animated&&b.refresh();const x=b??=new Solids(o),f=clearanceOf(x,p.position,void 0);f.nearest&&(!d||f.nearest.distance<d.distance)&&(d={distance:f.nearest.distance,path:f.nearest.path,at:c})}})}finally{b?.dispose()}const s=tt(a,"move"in t.camera?o.cutsOf(t.camera.move):[]),i=[];for(const[c,l]of h){const M=[],O=[],p=[];for(let f=0;f+1<r.length;f++){if(!l.inView[f]||!l.inView[f+1])continue;M.push(Math.hypot((l.x[f+1]??0)-(l.x[f]??0),(l.y[f+1]??0)-(l.y[f]??0)));const w=l.size[f]??0,g=l.size[f+1]??0;O.push(w>0?(g-w)/w/n:0),p.push(((r[f]??0)+(r[f+1]??0))/2)}const k=l.inView.reduce((f,w)=>f+w,0);if(k===0)continue;const x=f=>{if(f.length===0)return xt(t.from);let w=0,g=p[0]??t.from,$=0;f.forEach((j,C)=>{$+=Math.abs(j),Math.abs(j)>w&&(w=Math.abs(j),g=p[C]??g)});const v=j=>Math.round(j*1e6)/1e6;return{peak:v(w),at:v(g),mean:v($/f.length)}};i.push({path:y.get(c)??c.name,screen:x(M),growth:x(O),inView:Math.round(k/r.length*1e4)/1e4})}return{from:t.from,to:t.to,fps:t.fps,samples:a.length,...s,...d?{clearance:d}:{},objects:i}}

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

@@ -0,0 +1,17 @@
+import type { ClearAhead, FreeFloor, Sight } from "@allyhub/scenery";
+import type { Solid } from "./solid.js";
+export declare function sightBetween(a: Solid, b: Solid, others: readonly Solid[], samples: number, seed: number): Sight;
+export declare function clearAhead(s: Solid, others: readonly Solid[], grid?: number, far?: number): ClearAhead;
+export interface FloorOptions {
+    radius: number;
+    /** What stands higher than this above the floor's top does not take a cell, m. */
+    height: number;
+    /** Cell size, m. */
+    cell: number;
+    /** Where to start: a solid whose nearest free cell starts the connected floor. */
+    from?: Solid;
+    /** Objects whose reach is asked. */
+    targets: readonly Solid[];
+}
+export declare function freeFloor(floor: Solid, others: readonly Solid[], opts: FloorOptions): FreeFloor;
+//# sourceMappingURL=relations.d.ts.map

package/dist/node_modules/@allyhub/scenery-host/dist/measure/relations.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{DoubleSide as O,Matrix4 as T,Ray as U,Vector3 as v}from"three";import{floorRect as W}from"@allyhub/scenery";import{samplesOn as V}from"./contacts.js";const w=i=>Math.round(i*1e6)/1e6;function j(i,k,n){let a;for(const g of k){if(!i.intersectsBox(g.box))continue;const m=g.bvh.raycastFirst(i,O);m&&m.distance<n&&(!a||m.distance<a.d)&&(a={s:g,d:m.distance})}return a?.s}export function sightBetween(i,k,n,a,g){const m=V(i,a,g,!1),F=V(k,a,g+7,!1),u=new U,y=new v;let d=0;const e=new Map;for(let s=0;s<a;s++){const o=m[s],z=F[s];if(!o||!z)continue;u.origin.set(o[0],o[1],o[2]),y.set(z[0],z[1],z[2]);const r=y.distanceTo(u.origin)-1e-4;u.direction.subVectors(y,u.origin).normalize();const l=j(u,n,r);l?e.set(l.path,(e.get(l.path)??0)+1):d++}return{a:i.path,b:k.path,rays:a,clear:w(d/a),blockedBy:[...e].map(([s,o])=>({path:s,share:w(o/a)})).sort((s,o)=>o.share-s.share)}}export function clearAhead(i,k,n=5,a=50){const g=i.object.matrixWorld,m=new v(0,0,1).transformDirection(g),F=new T().copy(g).invert(),u=i.geometry.getAttribute("position"),y=new v(1/0,1/0,1/0),d=new v(-1/0,-1/0,-1/0),e=new v;for(let r=0;r<u.count;r++)e.set(u.getX(r),u.getY(r),u.getZ(r)).applyMatrix4(F),y.min(e),d.max(e);const s=new U,o=[];let z=0;for(let r=0;r<n;r++)for(let l=0;l<n;l++){const D=y.x+(d.x-y.x)*(r+.5)/n,R=y.y+(d.y-y.y)*(l+.5)/n;s.origin.set(D,R,d.z).applyMatrix4(g),s.direction.copy(m);let A=1/0;for(const I of k){const M=I.bvh.raycastFirst(s,O);M&&M.distance<A&&(A=M.distance)}A<=a?o.push(A):z++}return o.sort((r,l)=>r-l),{path:i.path,front:[w(m.x),w(m.y),w(m.z)],rays:n*n,open:z,far:a,...o.length>0?{least:w(o[0]??0),median:w(o[Math.floor(o.length/2)]??0),most:w(o.at(-1)??0)}:{}}}export function freeFloor(i,k,n){const a=i.geometry.getAttribute("position"),g=[];for(let t=0;t<a.count;t++)g.push([a.getX(t),a.getZ(t)]);const m=W(g),F=i.box.max.y,u=i.box.min.x,y=i.box.min.z,d=Math.max(1,Math.ceil((i.box.max.x-u)/n.cell)),e=Math.max(1,Math.ceil((i.box.max.z-y)/n.cell)),s=new Uint8Array(d*e),o=new U,z=new v(0,-1,0);for(let t=0;t<d;t++)for(let f=0;f<e;f++){const h=u+(t+.5)*n.cell,x=y+(f+.5)*n.cell;o.origin.set(h,F+n.height,x),o.direction.copy(z);const c=i.bvh.raycastFirst(o,O);if(!c||Math.abs(c.point.y-F)>.05)continue;const b=j(o,k,n.height-.02);s[t*e+f]=b?2:1}const r=Math.ceil(n.radius/n.cell),l=new Uint8Array(d*e);for(let t=0;t<d;t++)for(let f=0;f<e;f++){if(s[t*e+f]!==1)continue;let h=!0;for(let x=-r;h&&x<=r;x++)for(let c=-r;h&&c<=r;c++){if(x*x+c*c>r*r)continue;const b=t+x,p=f+c;(b<0||p<0||b>=d||p>=e||s[b*e+p]!==1)&&(h=!1)}h&&(l[t*e+f]=1)}const D=t=>w(t*n.cell*n.cell);let R=0,A=0;for(let t=0;t<s.length;t++)s[t]!==0&&R++,l[t]===1&&A++;const I=new Int32Array(d*e).fill(-1),M=[];for(let t=0;t<l.length;t++){if(l[t]!==1||(I[t]??0)>=0)continue;const f=M.length;let h=0;const x=[t];for(I[t]=f;x.length>0;){const c=x.pop()??0;h++;const b=Math.floor(c/e),p=c%e;for(const[B,Z]of[[b+1,p],[b-1,p],[b,p+1],[b,p-1]]){if(B<0||Z<0||B>=d||Z>=e)continue;const X=B*e+Z;l[X]===1&&(I[X]??0)<0&&(I[X]=f,x.push(X))}}M.push(h)}const q=t=>{const f=t.box.getCenter(new v);let h,x=1/0;for(let c=0;c<l.length;c++){if(l[c]!==1)continue;const b=u+(Math.floor(c/e)+.5)*n.cell,p=y+(c%e+.5)*n.cell,B=(b-f.x)**2+(p-f.z)**2;B<x&&(x=B,h=c)}return h};let C;if(n.from){const t=q(n.from);C=t===void 0?void 0:I[t]}else M.length>0&&(C=M.indexOf(Math.max(...M)));const S=t=>{if(C===void 0)return!1;const f=n.radius+n.cell*1.5;for(let h=0;h<l.length;h++){if(I[h]!==C)continue;const x=u+(Math.floor(h/e)+.5)*n.cell,c=y+(h%e+.5)*n.cell,b=Math.max(t.box.min.x-x,0,x-t.box.max.x),p=Math.max(t.box.min.z-c,0,c-t.box.max.z);if(Math.hypot(b,p)<=f)return!0}return!1};return{floor:i.path,radius:n.radius,height:n.height,cell:n.cell,floorArea:D(R),...m?{floorRect:w(m.area)}:{},freeArea:D(A),connected:C===void 0?0:D(M[C]??0),...n.from?{from:n.from.path}:{},reach:n.targets.map(t=>({path:t.path,reached:S(t)}))}}

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

@@ -0,0 +1,11 @@
+import type { Support } from "@allyhub/scenery";
+import { type Solid } from "./solid.js";
+export interface SupportOptions {
+    tolerance: number;
+    /** Columns across each side of the footprint. */
+    grid: number;
+    closed(s: Solid): boolean;
+}
+/** What a solid rests on. `others` must not hold its own parts or what holds it. */
+export declare function supportOf(s: Solid, others: readonly Solid[], opts: SupportOptions): Support;
+//# sourceMappingURL=support.d.ts.map

package/dist/node_modules/@allyhub/scenery-host/dist/measure/support.js

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{DoubleSide as H,Ray as E,Vector3 as S}from"three";import{convexHull as F,floorRect as O}from"@allyhub/scenery";import{inside as R}from"./solid.js";const w=c=>Math.round(c*1e6)/1e6;function $(c){const n=c.geometry.getAttribute("position"),g=c.geometry.getIndex();let l=0,z=0,i=0;for(let e=0;g&&e<g.count/3;e++){const r=g.getX(e*3),f=g.getX(e*3+1),u=g.getX(e*3+2),m=n.getX(f)-n.getX(r),h=n.getY(f)-n.getY(r),v=n.getZ(f)-n.getZ(r),x=n.getX(u)-n.getX(r),p=n.getY(u)-n.getY(r),M=n.getZ(u)-n.getZ(r),Z=Math.hypot(h*M-v*p,v*x-m*M,m*p-h*x)/2;l+=Z*(n.getX(r)+n.getX(f)+n.getX(u))/3,z+=Z*(n.getZ(r)+n.getZ(f)+n.getZ(u))/3,i+=Z}return i>0?[l/i,z/i]:[c.box.getCenter(new S).x,c.box.getCenter(new S).z]}function G(c,n){if(n.length===0)return-1/0;const g=(i,e)=>{const r=e[0]-i[0],f=e[1]-i[1],u=r*r+f*f,m=u>0?Math.max(0,Math.min(1,((c[0]-i[0])*r+(c[1]-i[1])*f)/u)):0;return Math.hypot(c[0]-(i[0]+r*m),c[1]-(i[1]+f*m))};let l=1/0;for(let i=0;i<n.length;i++){const e=n[i],r=n[(i+1)%n.length];e&&r&&(l=Math.min(l,g(e,r)))}return n.length<3?-l:n.every((i,e)=>{const r=n[(e+1)%n.length]??i;return(r[0]-i[0])*(c[1]-i[1])-(r[1]-i[1])*(c[0]-i[0])>=0})?l:-l}const L=64;export function supportOf(c,n,g){const l=c.geometry.getAttribute("position"),z=[];for(let t=0;t<l.count;t++)z.push([l.getX(t),l.getZ(t)]);const i=O(z),e={path:c.path,name:c.name,bottom:w(c.box.min.y),columns:0,on:[],gap:null,sunk:0,footprintShare:0,nothingBelow:0};if(!i)return e;const[r,f,,u]=i.corners,m=Math.max(2,Math.round(g.grid)),h=new E,v=new S(0,-1,0),x=new S(0,1,0),p=[];for(let t=0;t<m;t++)for(let o=0;o<m;o++){const s=.02+.96*(t+.5)/m,a=.02+.96*(o+.5)/m,y=r[0]+(f[0]-r[0])*s+(u[0]-r[0])*a,d=r[1]+(f[1]-r[1])*s+(u[1]-r[1])*a;h.origin.set(y,c.box.max.y+1,d),h.direction.copy(v);const X=c.bvh.raycast(h,H);if(X.length===0)continue;let b=X[0];for(const C of X)b&&C.point.y<b.point.y&&(b=C);b&&p.push({x:y,z:d,bottom:b.point.y,normal:b.face?.normal.clone()??x.clone()})}const M=p.length,Z=Math.max(.005,.02*(c.box.max.y-c.box.min.y)),k=new Map;for(let t=0;t<l.count;t++){const o=l.getY(t);if(o>c.box.min.y+Z)continue;const s=l.getX(t),a=l.getZ(t),y=`${String(Math.round(s/.02))},${String(Math.round(a/.02))}`,d=k.get(y);(!d||o<d.y)&&k.set(y,{x:s,z:a,y:o})}const P=[...k.values()],D=Math.max(1,Math.ceil(P.length/L));for(let t=0;t<P.length;t+=D){const o=P[t];if(!o)continue;h.origin.set(o.x,c.box.max.y+1,o.z),h.direction.copy(v);let s;for(const a of c.bvh.raycast(h,H))(!s||a.point.y<s.point.y)&&(s=a);p.push({x:o.x,z:o.z,bottom:s?.point.y??o.y,normal:s?.face?.normal.clone()??x.clone(),foot:!0})}e.columns=M,e.feet=p.length-M;for(const t of p){const o=new S(t.x,t.bottom,t.z);let s;for(const a of n){if(g.closed(a)&&a.box.containsPoint(o)&&R(a,[t.x,t.bottom+1e-6,t.z])){const X=a.bvh.closestPointToPoint(o),b=X?X.distance:0;(!s||-b<s.gap)&&(s={solid:a,gap:-b,normal:x.clone()});continue}if(a.box.min.y>t.bottom+g.tolerance)continue;h.origin.set(t.x,t.bottom+g.tolerance,t.z),h.direction.copy(v);const y=a.bvh.raycastFirst(h,H);if(!y)continue;const d=y.distance-g.tolerance;(!s||d<s.gap)&&(s={solid:a,gap:d,normal:y.face?.normal.clone()??x.clone()})}s&&(t.below=s)}const I=p.filter(t=>t.below);if(e.nothingBelow=p.length-I.length,I.length===0)return e;const T=I.map(t=>t.below?.gap??1/0);e.gap=w(Math.min(...T)),e.sunk=w(Math.max(0,...T.map(t=>-t)));const A=new Map;for(const t of I){if(!t.below)continue;const o=A.get(t.below.solid)??{columns:0,gap:1/0};o.columns++,o.gap=Math.min(o.gap,t.below.gap),A.set(t.below.solid,o)}e.on=[...A].map(([t,o])=>({path:t.path,name:t.name,columns:o.columns,share:w(o.columns/p.length),gap:w(o.gap)})).sort((t,o)=>t.gap-o.gap);const B=I.filter(t=>(t.below?.gap??1/0)<=g.tolerance),Y=B.filter(t=>!t.foot);if(e.footprintShare=M>0?w(Y.length/M):0,Y.length>0){let t=0;for(const o of Y){const s=Math.min(1,Math.abs(o.normal.dot(o.below?.normal??x)));t=Math.max(t,Math.acos(s)*180/Math.PI)}e.angle=Math.round(t*1e3)/1e3,e.contactArea=w(i.area*Y.length/(m*m))}if(B.length>0){const t=F(B.map(o=>[o.x,o.z]));e.margin=w(G($(c),t))}return e}

package/dist/node_modules/@allyhub/scenery-host/dist/model-stage.js

@@ -0,0 +1,3 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{mkdir as S,writeFile as H}from"node:fs/promises";import{dirname as h,join as u,relative as y,sep as p}from"node:path";import{CACHE_DIR as $}from"@allyhub/formats";import{buildModule as I}from"@allyhub/model/build";const m=35;async function R(n,t){const{report:c}=await I(u(n,t),{root:n,cache:u(n,$,"model")}),i=[1/0,1/0,1/0],e=[-1/0,-1/0,-1/0];for(const o of c.objects){if(!o.bounds)continue;const[l,f,d]=o.bounds.min,[s,g,E]=o.bounds.max,M=[l,d,-g],x=[s,E,-f];for(let r=0;r<3;r++)i[r]=Math.min(i[r]??0,M[r]??0),e[r]=Math.max(e[r]??0,x[r]??0)}return Number.isFinite(i[0])?{min:i,max:e}:{min:[-.5,0,-.5],max:[.5,1,.5]}}const a=n=>Math.round(n*1e4)/1e4,w=n=>[a(n[0]),a(n[1]),a(n[2])];export function stageCameras(n){const t=[(n.min[0]+n.max[0])/2,(n.min[1]+n.max[1])/2,(n.min[2]+n.max[2])/2],i=Math.max(.01,Math.hypot(n.max[0]-n.min[0],n.max[1]-n.min[1],n.max[2]-n.min[2])/2)/Math.sin(Math.atan(12/m))*1.08,e=(l,f,d)=>{const s=Math.hypot(l,f,d);return w([t[0]+l/s*i,t[1]+f/s*i,t[2]+d/s*i])},o=w(t);return{front:{position:e(0,.18,1),target:o,lens:m},threeQuarter:{position:e(1,.5,1),target:o,lens:m},side:{position:e(1,.18,0),target:o,lens:m},top:{position:e(0,1,0),target:o,up:[0,0,-1],lens:m}}}export async function writeModelStage(n){const t=await R(n.root,n.model),c=stageCameras(t),i=Math.max(4,6*Math.max(t.max[0]-t.min[0],t.max[2]-t.min[2],.1)),e=u(n.outDir,"model-stage",h(n.model).replace(/[^A-Za-z0-9]+/g,"_")||"root","scenery.ts"),o=y(h(e),u(n.root,n.model)).split(p).join("/");return await S(h(e),{recursive:!0}),await H(e,[`// Written by allyhub: the model ${n.model} alone, on a floor in soft light, framed on its size.`,'import * as THREE from "three";','import { defineScenery } from "@allyhub/scenery-host/layer";','import { modelObject } from "@allyhub/model/three";',`import model from ${JSON.stringify(o.startsWith(".")?o:`./${o}`)};`,"","export default defineScenery({","  renderer: { antialias: true },","  async build(w) {",'    w.scene.background = new THREE.Color("#e4e2dd");',"    const floor = new THREE.Mesh(",`      new THREE.PlaneGeometry(${String(a(i))}, ${String(a(i))}),`,'      new THREE.MeshStandardMaterial({ color: "#d6d3cc", roughness: 0.95 }),',"    );",'    floor.name = "floor";',"    floor.rotation.x = -Math.PI / 2;",`    floor.position.set(${String(a((t.min[0]+t.max[0])/2))}, ${String(a(t.min[1]-5e-4))}, ${String(a((t.min[2]+t.max[2])/2))});`,"    w.scene.add(floor);","    w.scene.add(await modelObject(w, model));",'    w.scene.add(new THREE.HemisphereLight("#ffffff", "#8a8580", 1.6));','    const sun = new THREE.DirectionalLight("#fff6ea", 2.4);','    sun.name = "sun";',"    sun.position.set(1.5, 3, 2.5);","    w.scene.add(sun);","    return {};","  },",`  cameras: ${JSON.stringify(c)},`,"});",""].join(`
+`)),y(n.root,e).split(p).join("/")}

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

@@ -0,0 +1,53 @@
+import { type Scene } from "three";
+import { type BakeOptions, type BakeReport } from "@allyhub/scenery";
+import type { SceneryAdapter } from "../adapter.js";
+import { type LaidBake } from "../bake/apply.js";
+import { type RealTimers } from "../clock.js";
+import type { AnyRenderer } from "../idbuffer.js";
+/**
+ * The scenery's bake: the scene's digest, the renderer this page draws on
+ * (bakeRenderer: whose bake it lays, else the CPU's), and what was laid on
+ * it (null for nothing).
+ */
+export interface BakeState {
+    digest: string;
+    renderer: string;
+    laid: LaidBake | null;
+    /** Whether the scenery says how to bake it (defineScenery's bake). */
+    asked: boolean;
+}
+export declare class PageBake {
+    private readonly scene;
+    private readonly renderer;
+    private readonly glName;
+    private readonly options;
+    private readonly adapter;
+    private readonly timers;
+    private readonly pathOf;
+    /** Poses the scenery at a moment, an update that needs references leaving it as it is. */
+    private readonly poseAt;
+    /** The scene's digest and the bake laid on it. */
+    state: BakeState;
+    /** The bake file `make()` made, until it is read back. */
+    private bytes?;
+    constructor(o: {
+        scene: Scene;
+        renderer: AnyRenderer;
+        glName: string;
+        options: BakeOptions | undefined;
+        adapter: SceneryAdapter;
+        timers: RealTimers;
+        pathOf: (url: string) => string | undefined;
+        poseAt: (t: number) => void;
+    });
+    /** Lays the bake made for the scene as it now stands, if there is one. */
+    lay(): Promise<void>;
+    /**
+     * Bakes the scenery's light on this page's GPU and lays it on the scene:
+     * the report; the file is read back with chunk().
+     */
+    make(): Promise<BakeReport>;
+    /** A stretch of the bake file make() made, as base64 (empty past its end). */
+    chunk(offset: number, length: number): string;
+}
+//# sourceMappingURL=bake.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{WebGLRenderer as o}from"three";import{BAKE_CPU as h,bakeRenderer as l,resolveBake as d}from"@allyhub/scenery";import{fetchAndLay as c,layBake as p}from"../bake/apply.js";import{BAKE_VERSION as b,sceneDigest as m}from"../bake/digest.js";import{readBake as f}from"../bake/format.js";import{withRealTimers as u}from"../clock.js";import{SceneryError as i}from"../errors.js";export class PageBake{scene;renderer;glName;options;adapter;timers;pathOf;poseAt;state={digest:"",renderer:"",laid:null,asked:!1};bytes;constructor(e){this.scene=e.scene,this.renderer=e.renderer,this.glName=e.glName,this.options=e.options,this.adapter=e.adapter,this.timers=e.timers,this.pathOf=e.pathOf,this.poseAt=e.poseAt}async lay(){if(!(this.renderer instanceof o))return;const e=m(this.scene,d(this.options),a=>this.pathOf(a)),t=l(this.glName);if(this.state={digest:e,renderer:t,laid:null,asked:this.options!==void 0},this.adapter.unbaked)return;let s,r=t;for(const a of t===h?[t]:[t,h])if(s=this.adapter.bakeUrl?.(e,a),r=a,s!==void 0)break;if(s!==void 0)try{this.state.laid=await c(s,this.scene,this.renderer,e,r,b)}catch(a){throw new i("file",`The scenery's bake could not be laid on it: ${a.message} (bake it again)`)}}async make(){const e=this.renderer;if(!(e instanceof o))throw new i("build",'A scenery drawn with renderer.kind "webgpu" cannot be baked yet: bake one drawn with "webgl".');if(this.state.laid)throw new i("build","The scenery already has its bake laid on it: open it unbaked to bake it again.");const t=this.adapter.xatlasWasm;if(t===void 0)throw new i("build","This page cannot bake: it was given no xatlas wasm.");const{runBake:s}=await import("../bake/run.js"),r=await u(this.timers,()=>s({scene:this.scene,renderer:e,settings:d(this.options),digest:this.state.digest,xatlasWasm:t,poseAt:this.poseAt,gl:this.glName}));return this.bytes=r.bytes,this.state.laid=await p(this.scene,e,f(r.bytes)),r.report}chunk(e,t){const s=this.bytes;if(!s)throw new i("build","The scenery has not been baked in this page.");const r=s.subarray(e,Math.min(s.byteLength,e+t));let a="";for(let n=0;n<r.byteLength;n+=32768)a+=String.fromCharCode(...r.subarray(n,n+32768));return btoa(a)}}

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

@@ -0,0 +1,42 @@
+import { type Camera, type Object3D, type Scene } from "three";
+import { type GlassOptions, type SceneryRendererOptions } from "@allyhub/scenery";
+import { type FocusSettings } from "../focus-pass.js";
+import type { AnyRenderer } from "../idbuffer.js";
+import type { Screens } from "./screens.js";
+export declare class Drawer {
+    private readonly scene;
+    private readonly renderer;
+    private readonly options;
+    private readonly screens;
+    private readonly mustObject;
+    private readonly checkBudget;
+    private focusPass;
+    /** Each screen's glass, by its name, kept from frame to frame. */
+    private readonly glasses;
+    constructor(o: {
+        scene: Scene;
+        renderer: AnyRenderer;
+        options: SceneryRendererOptions;
+        screens: Screens;
+        mustObject: (name: string) => Object3D;
+        checkBudget: () => void;
+    });
+    /**
+     * Draws the scene from a camera into the renderer's own canvas at a size
+     * (a scenery layer shows that canvas), and returns the canvas.
+     */
+    inPlace(camera: Camera, width: number, height: number, background?: string | null, holes?: readonly string[], focus?: FocusSettings, 
+    /** Screens with glass, by name: drawn as glass that reflects the scenery over what they show. */
+    glass?: ReadonlyMap<string, GlassOptions>, 
+    /** Screens drawn in the scenery (Screens.show): their meshes show their pictures. */
+    pictured?: readonly string[]): HTMLCanvasElement;
+    /** Draws the scene from a camera at a size and copies it out. */
+    copy(camera: Camera, width: number, height: number, background?: string | null, focus?: FocusSettings): HTMLCanvasElement;
+    /**
+     * The scene from a camera into the renderer's canvas: as it is, or with
+     * the camera's depth of field (its aperture and focus) drawn.
+     */
+    private render;
+    private renderScene;
+}
+//# sourceMappingURL=draw.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{Color as E,LinearToneMapping as B,Mesh as S,MeshBasicMaterial as P,NoBlending as R,NoToneMapping as j,PerspectiveCamera as M,Vector3 as k,WebGLRenderer as m}from"three";import{exposureOf as L,SCENERY_RENDERER_DEFAULTS as D}from"@allyhub/scenery";import{canvas2d as N}from"../draw2d.js";import{SceneryError as T}from"../errors.js";import{FocusPass as F}from"../focus-pass.js";import{Glass as y}from"../glass.js";import{steady as v}from"../steady.js";const G=new P({color:0,transparent:!0,opacity:0,blending:R,toneMapped:!1}),C=w=>{const e=[];return w.traverse(r=>{r instanceof S&&e.push(r)}),e};export class Drawer{scene;renderer;options;screens;mustObject;checkBudget;focusPass;glasses=new Map;constructor(e){this.scene=e.scene,this.renderer=e.renderer,this.options=e.options,this.screens=e.screens,this.mustObject=e.mustObject,this.checkBudget=e.checkBudget}inPlace(e,r,n,t,p=[],o,h,u=[]){const O=this.scene.background;t===null?this.scene.background=null:t!==void 0&&(this.scene.background=new E(t));const g=[],x=[],b=[];try{for(const s of p){const i=C(this.mustObject(s)),l=h?.get(s);let a;l&&this.renderer instanceof m&&(a=this.glasses.get(s)??new y,this.glasses.set(s,a),a.set(l),a.showContent(null),b.push({name:s,glass:a,meshes:i}));for(const f of i)g.push([f,f.material]),f.material=a?a.material:G;x.push(i)}this.screens.frame(r,n);for(const s of u){const i=this.screens.picture(s);if(!i)continue;const l=C(this.mustObject(s));this.screens.mapToFace(s,l);const a=h?.get(s);let f=i.material;if(a&&this.renderer instanceof m){const c=this.glasses.get(s)??new y;this.glasses.set(s,c),c.set(a),c.showContent(i.texture,i.brightness,this.screens.factorOf(s)),this.screens.adopt(c.material),b.push({name:s,glass:c,meshes:l}),f=c.material}for(const c of l)g.push([c,c.material]),c.material=f}this.screens.lightBy(u),this.checkBudget();const d=this.renderer.domElement;(d.width!==r||d.height!==n)&&this.renderer.setSize(r,n,!1),this.renderer.setClearColor(0,0);for(const s of b){const i=this.screens.face(s.name);i&&e instanceof M&&this.renderer instanceof m&&s.glass.reflect(this.renderer,this.scene,e,new k(...i.center),new k(...i.normal),r,n,s.meshes,o)}return this.render(e,r,n,o,x),d}finally{for(const[d,s]of g)d.material=s;this.scene.background=O}}copy(e,r,n,t,p){const o=this.scene.background;t===null?this.scene.background=null:t!==void 0&&(this.scene.background=new E(t));try{this.renderer.setSize(r,n,!1),this.renderer.setClearColor(0,0),this.render(e,r,n,p);const{canvas:h,ctx:u}=N(r,n);return u.drawImage(this.renderer.domElement,0,0,r,n),h}finally{this.scene.background=o}}render(e,r,n,t,p=[]){const o=e.userData.ev,h={exposure:this.renderer.toneMappingExposure,curve:this.renderer.toneMapping};o!==void 0&&(this.renderer.toneMappingExposure=L(o),h.curve===j&&(this.renderer.toneMapping=B));try{this.renderScene(e,r,n,t,p)}finally{this.renderer.toneMappingExposure=h.exposure,this.renderer.toneMapping=h.curve}}renderScene(e,r,n,t,p){if(!t){this.renderer.render(this.scene,v(this.renderer,e));return}if(!(this.renderer instanceof m)||!(e instanceof M))throw new T("camera",`A camera's aperture and focus are drawn with the WebGL renderer (renderer: { kind: "webgl" }) and a perspective camera.`);const o=this.options.focus;this.focusPass??=new F(o?.samples,o?.maxRadius,o?.supersample??(this.options.antialias??D.antialias?2:1)),this.focusPass.render(this.renderer,this.scene,v(this.renderer,e),e,r,n,t,p)}}

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

@@ -0,0 +1,45 @@
+import { type Group, type Scene, type Texture } from "three";
+import type { AssetRef } from "@allyhub/scenery";
+import type { SceneryAdapter } from "../adapter.js";
+import { type RealTimers } from "../clock.js";
+import type { AnyRenderer } from "../idbuffer.js";
+/** Waits until three.js's default loading manager has nothing left to load. */
+export declare function loadsSettled(timers: RealTimers): {
+    done(): Promise<void>;
+};
+/** A scenery's files: where each is, what was read, and the loaders. */
+export declare class SceneryFiles {
+    /** Project files the scenery loaded through its host, by URL. */
+    readonly reads: string[];
+    /** Project paths of the files the scenery loaded, by URL: a picture's file for the bake's digest. */
+    private readonly paths;
+    private readonly adapter;
+    private readonly renderer;
+    private dracoLoader?;
+    private ktx2Loader?;
+    constructor(adapter: SceneryAdapter, renderer: AnyRenderer);
+    /** The project file a URL the scenery read was, when it was one. */
+    pathOf(url: string): string | undefined;
+    /**
+     * A path as a path from the project's root: one that starts with ./ or
+     * ../ is from the scenery's own module, so a scenery keeps its files
+     * wherever its folder goes; any other is from the project's root.
+     */
+    place(s: string): string;
+    /** A project file's URL in this page. */
+    asset(path: string): string;
+    /** An asset's URL, its read recorded. */
+    private url;
+    /** Draco's decoder, for KHR_draco_mesh_compression, made once. */
+    private draco;
+    /** Basis Universal's transcoder, for KHR_texture_basisu (KTX2), made once. */
+    private ktx2;
+    load(asset: AssetRef): Promise<Group>;
+    texture(asset: AssetRef, opts?: {
+        colorSpace?: "srgb" | "linear";
+    }): Promise<Texture>;
+    environment(scene: Scene, asset: AssetRef, opts?: {
+        background?: boolean;
+    }): Promise<Texture>;
+}
+//# sourceMappingURL=files.d.ts.map

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

@@ -0,0 +1,127 @@
+import { PerspectiveCamera, Scene, type Object3D } from "three";
+import { type CameraSource, type CameraState, type DrawnCamera, type Move, type PointsRequest, type ResolvedCamera, type Scenery, type SceneryInventory } from "@allyhub/scenery";
+import type { SceneryAdapter } from "../adapter.js";
+import { type RealTimers } from "../clock.js";
+import { type SceneryProblem } from "../errors.js";
+import type { AnyRenderer } from "../idbuffer.js";
+import { type Vec3 } from "../vec.js";
+import { PageBake } from "./bake.js";
+import { Drawer } from "./draw.js";
+import { SceneryFiles } from "./files.js";
+import { Props } from "./props.js";
+import { Screens } from "./screens.js";
+import { Shaders } from "./shaders.js";
+/** The draw of a camera: the state, as resolved, as three.js holds it. */
+export interface Aimed {
+    state: CameraState;
+    resolved: ResolvedCamera;
+    camera: PerspectiveCamera;
+    targetName?: string;
+}
+/** A camera as it was drawn, in numbers. */
+export declare function drawnCamera(a: Aimed): DrawnCamera;
+export declare class SceneryPage {
+    /** The scenery's own, as it built it. */
+    readonly scene: Scene<import("three").Object3DEventMap>;
+    /** What the page was opened with. */
+    readonly adapter: SceneryAdapter;
+    readonly renderer: AnyRenderer;
+    /** The page's real timers. */
+    readonly timers: RealTimers;
+    /** What went wrong drawing so far, each once (the adapter's onProblem hears each). */
+    readonly problems: SceneryProblem[];
+    /** Its files and their loaders. */
+    readonly files: SceneryFiles;
+    readonly shaders: Shaders;
+    readonly screens: Screens;
+    readonly drawer: Drawer;
+    readonly props: Props;
+    readonly bake: PageBake;
+    private readonly scenery;
+    private readonly kind;
+    private readonly glName;
+    private readonly clock;
+    private readonly host;
+    private made;
+    private posedAt;
+    /** While the page is made, or a bake poses it: a pose with no references. */
+    private warming;
+    /** The moments of references the scenery was posed with (SceneryHost.time). */
+    private posedWith?;
+    private poseTimes?;
+    /** The moments of references a request gave, as one way of finding them. */
+    private givenTimes?;
+    private constructor();
+    /** A scenery built in this page, ready to draw. Throws SceneryError when it cannot be. */
+    static open(scenery: Scenery, adapter: SceneryAdapter): Promise<SceneryPage>;
+    /** Records a problem once, and tells the adapter. */
+    report(p: SceneryProblem): void;
+    /** Runs a pose with no references (the page being made, a bake). */
+    private warm;
+    /** Project files the scenery loaded through its host, by URL. */
+    get reads(): readonly string[];
+    /** What draws: the WebGL renderer string, three.js's revision, the kind. */
+    get rendererInfo(): SceneryInventory["renderer"];
+    /** The scenery's cameras and moves, by name. */
+    get named(): {
+        cameras: Record<string, CameraState>;
+        moves: string[];
+    };
+    /** The renderer's canvas: a scenery layer puts it in its page when a screen is drawn in the scenery. */
+    get canvas(): HTMLCanvasElement;
+    /** Whether the scenery changes with time (it has an update). */
+    get animated(): boolean;
+    /** manifold-3d's wasm file in this page, for overlap volumes. */
+    get manifoldWasm(): string | undefined;
+    /** The renderer options the scenery asked for. */
+    get rendererOptions(): NonNullable<Scenery["renderer"]>;
+    /** Whether the renderer's WebGL context is lost (its pictures are then empty). */
+    get lost(): boolean;
+    private makeHost;
+    /** An object by its name: undefined for none, SceneryError for two. */
+    object(name: string): Object3D | undefined;
+    /** The one object with a name; SceneryError for none or two. */
+    objectNamed(name: string): Object3D;
+    /** Where a named object is now: the centre of its box, or its origin when it draws nothing. */
+    pointOf(name: string): Vec3;
+    /** A named object's centre, or undefined for none. */
+    private pointIfAny;
+    /**
+     * Moments for moves timed by references, given by hand: a reference's
+     * seconds of scenery time ("@turn": 3.2); "@turn+0.2" is found from
+     * "@turn". Undefined takes them away.
+     */
+    useTimes(times: Readonly<Record<string, number>> | undefined): void;
+    /** What a move is given: the scenery, and where the moments of its references come from. */
+    private viewWith;
+    /** Where named points are at scenery time t: an object's box centre, a place on a screen's face. */
+    points(req: PointsRequest): Vec3[];
+    /**
+     * Poses the scenery at scenery time t, its update finding the moments of
+     * references with `time` (a layer's), else those given with useTimes.
+     */
+    pose(t: number, time?: (ref: string) => number): void;
+    /** The scenery time it was last posed at. */
+    get posed(): number;
+    /** The camera state a source names at scenery time t (the scenery posed at t). */
+    stateOf(source: CameraSource, t: number, aspect: number, time?: (ref: string) => number): {
+        state: CameraState;
+        label: string;
+    };
+    /** A move's camera at t; what it throws is a camera failure (a reference without a time its cause, a NeedsTimeError). */
+    private moved;
+    /**
+     * The camera a scenery layer gives at scenery time t: a state, the name of
+     * one of the scenery's cameras or moves, or a move of its own.
+     */
+    stateFrom(camera: CameraState | string | Move, t: number, aspect: number, time?: (ref: string) => number): CameraState;
+    /** A camera that frames a named object from one of its sides, with fitCamera. */
+    private around;
+    /** The cuts of a layer's camera (shots()), scenery times: by its name in the scenery's moves, or itself. */
+    cutsOf(camera: CameraState | string | Move, time?: (ref: string) => number): number[];
+    /** A state resolved for a frame, names found in the scenery as posed. */
+    aim(state: CameraState, aspect: number): Aimed;
+    /** Objects hidden for a view (hide, only), and a way back. */
+    shownFor(hide?: readonly string[], only?: readonly string[]): () => void;
+}
+//# sourceMappingURL=page.d.ts.map

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

@@ -0,0 +1,2 @@
+/*! AllyHub. Copyright (c) 2026 AllyHub, Inc. All rights reserved. Use is subject to LICENSE.md. */
+import{PerspectiveCamera as T,REVISION as B,SRGBColorSpace as C,Scene as P,Vector3 as b,WebGLRenderer as v}from"three";import{AROUND_DEFAULTS as $,CameraError as A,cutsOf as M,fitCamera as _,NeedsTimeError as j,resolveCamera as L,SCENERY_RENDERER_DEFAULTS as E,yawPitchOf as F}from"@allyhub/scenery";import{HOST_CLOCK as I,ownClock as G,ownTimers as U,withRealTimers as z}from"../clock.js";import{SceneryError as c}from"../errors.js";import{byName as H,drawnUnder as S,eachVertex as V,um as y,vec as p,worldBox as x}from"../scene.js";import{steady as k}from"../steady.js";import{cross as K,normalize as w,scale as O}from"../vec.js";import{PageBake as q}from"./bake.js";import{Drawer as Y}from"./draw.js";import{loadsSettled as J,SceneryFiles as Q}from"./files.js";import{Props as X}from"./props.js";import{Screens as Z}from"./screens.js";import{Shaders as ee}from"./shaders.js";function te(m){try{const e=m.getContext();if(!e||typeof e.getExtension!="function")return"";const t=e.getExtension("WEBGL_debug_renderer_info");return String(e.getParameter(t?t.UNMASKED_RENDERER_WEBGL:e.RENDERER))}catch{return""}}async function se(m){const e=m.renderer??{},t=document.createElement("canvas");t.width=2,t.height=2;const s=e.kind??"webgl",n=e.antialias??E.antialias,r={...e.logarithmicDepthBuffer!==void 0?{logarithmicDepthBuffer:e.logarithmicDepthBuffer}:{},...e.reversedDepthBuffer!==void 0?{reversedDepthBuffer:e.reversedDepthBuffer}:{},...e.outputBufferType!==void 0?{outputBufferType:e.outputBufferType}:{}};try{if(s==="webgpu"){const{WebGPURenderer:o}=await import("three/webgpu"),a=new o({canvas:t,antialias:n,alpha:!0,forceWebGL:!0,...r});return await a.init(),a}const i={canvas:t,antialias:n,alpha:!0,preserveDrawingBuffer:!0,...r},h=new v(i);return h.transmissionResolutionScale=e.transmissionScale??E.transmissionScale,h}catch(i){throw new c("renderer",`WebGL could not be made in this page: ${i.message}`)}}export function drawnCamera(m){const e=m.resolved,{yaw:t,pitch:s}=F(e.forward),n=i=>Math.round(i*1e3)/1e3,r=i=>[y(i[0]),y(i[1]),y(i[2])];return{position:r(e.position),...e.target?{target:r(e.target)}:{},...m.targetName!==void 0?{targetName:m.targetName}:{},forward:r(e.forward),up:r(e.up),fov:{horizontal:n(e.fov.horizontal),vertical:n(e.fov.vertical),diagonal:n(e.fov.diagonal)},lens:n(e.lens),...m.state.lensFrame!==void 0?{lensFrame:m.state.lensFrame}:{},yaw:n(t),pitch:n(s),roll:n(m.state.roll??0),near:e.near,far:e.far,...e.dof?{dof:{aperture:n(e.dof.aperture),focus:n(e.dof.focus),lens:n(e.dof.lens)}}:{},...e.ev!==void 0?{ev:n(e.ev)}:{}}}export class SceneryPage{scene=new P;adapter;renderer;timers;problems=[];files;shaders;screens;drawer;props;bake;scenery;kind;glName;clock;host;made;posedAt=Number.NaN;warming=!1;posedWith;poseTimes;givenTimes;constructor(e,t,s,n){this.scenery=e,this.adapter=t,this.renderer=s,this.clock=n,this.timers=t.timers??U,this.kind=e.renderer?.kind??"webgl",this.glName=te(s);const r=o=>{this.report(o)},i=o=>this.object(o),h=o=>this.objectNamed(o);this.files=new Q(t,s),this.screens=new Z({scene:this.scene,renderer:s,object:i,mustObject:h,report:r,timers:this.timers}),this.shaders=new ee({scene:this.scene,renderer:s,glName:this.glName,screenLight:this.screens.light,report:r}),this.drawer=new Y({scene:this.scene,renderer:s,options:e.renderer??{},screens:this.screens,mustObject:h,checkBudget:()=>{this.shaders.check()}}),this.host=this.makeHost(),this.props=new X(this.scene,this.host),this.bake=new q({scene:this.scene,renderer:s,glName:this.glName,options:e.bake,adapter:t,timers:this.timers,pathOf:o=>this.files.pathOf(o),poseAt:o=>{this.warm(()=>{this.pose(o)})}})}static async open(e,t){const s=t.timers?I:G();s.setMoment(0,t.seed);const n=await se(e);n.setPixelRatio(1),n.outputColorSpace=C;const r=new SceneryPage(e,t,n,s),i=r.timers,h=J(i),o=t.buildTimeout??6e4;try{await z(i,async()=>{let a;const l=(async()=>{r.made=await e.build(r.host),await h.done()})();await Promise.race([l,new Promise((g,f)=>{a=i.setTimeout(()=>{f(new c("build",`The scenery's build did not finish in ${String(o/1e3)} s.`))},o)})]).finally(()=>{i.clearTimeout(a)}),r.warm(()=>{r.pose(0)}),await r.bake.lay(),r.shaders.check();const d=new T(50,1,.05,500);n.setSize(64,64,!1),n instanceof v?n.compile(r.scene,k(n,d)):await n.compileAsync(r.scene,k(n,d)),n.render(r.scene,k(n,d)),r.shaders.check(!0)})}catch(a){throw a instanceof c?a:new c("build",`The scenery's build threw: ${a.message} (w.load, w.texture and w.environment return promises: await them in build)`)}return r}report(e){this.problems.some(t=>t.kind===e.kind&&t.message===e.message)||(this.problems.push(e),this.adapter.onProblem?.(e))}warm(e){this.warming=!0;try{e()}finally{this.warming=!1}}get reads(){return this.files.reads}get rendererInfo(){return{gl:this.glName,three:B,kind:this.kind}}get named(){return{cameras:{...this.scenery.cameras??{}},moves:Object.keys(this.scenery.moves??{})}}get canvas(){return this.renderer.domElement}get animated(){return this.scenery.update!==void 0}get manifoldWasm(){return this.adapter.manifoldWasm}get rendererOptions(){return this.scenery.renderer??{}}get lost(){return this.renderer instanceof v?this.renderer.getContext().isContextLost():!1}makeHost(){return{scene:this.scene,renderer:this.renderer,load:e=>this.files.load(e),texture:(e,t)=>this.files.texture(e,t),environment:(e,t)=>this.files.environment(this.scene,e,t),seek:(e,t)=>{const s=e._actions;for(const n of s)n.reset();e.setTime(t)},object:e=>this.object(e),positionOf:e=>this.pointOf(e),boundsOf:e=>{const t=x(this.objectNamed(e));if(!t)throw new c("name",`"${e}" has nothing drawn in it, so it has no box.`);return{min:p(t.min),max:p(t.max)}},asset:e=>this.files.asset(e),screen:e=>this.screens.face(e),screenPicture:e=>this.screens.picture(e)?.texture,time:e=>{const t=this.poseTimes;if(!t)throw new j(e,"w.time");const s=t(e);if(!Number.isFinite(s))throw new Error(`w.time("${e}") has no time (${String(s)}).`);return s}}}object(e){try{return H(this.scene,e)}catch(t){throw new c("name",t.message)}}objectNamed(e){const t=this.object(e);if(!t)throw new c("name",`"${e}" names nothing in the scenery.`);return t}pointOf(e){const t=this.objectNamed(e),s=x(t);return s?p(s.getCenter(new b)):p(t.getWorldPosition(new b))}pointIfAny(e){return this.object(e)?this.pointOf(e):void 0}useTimes(e){if(!e||Object.keys(e).length===0){this.givenTimes=void 0;return}const t={...e};this.givenTimes=s=>{const n=t[s];if(n!==void 0)return n;const r=/^(.*?)([+-]\d+(?:\.\d+)?)$/.exec(s),i=r?.[1]!==void 0?t[r[1]]:void 0;if(r&&i!==void 0)return i+Number(r[2]);throw new Error(`The times given name no time for "${s}" (they name ${Object.keys(t).join(", ")}).`)}}viewWith(e,t){const s=e??this.givenTimes;return{pointOf:n=>this.pointIfAny(n),screen:n=>this.screens.face(n),...s?{time:s}:{},...t!==void 0?{aspect:t}:{}}}points(e){return this.pose(e.t),e.refs.map(t=>{if("object"in t)return this.pointOf(t.object);const s=this.screens.face(t.screen);if(!s)throw new c("name",`No screen "${t.screen}": no object of that name with a mesh in it.`);return s.point(t.at[0],t.at[1])})}pose(e,t){const s=t??this.givenTimes;if(!(e===this.posedAt&&s===this.posedWith)){this.clock.setMoment(e,`${this.adapter.seed}@${String(e)}`),this.poseTimes=s;try{this.scenery.update?.(this.made,e,this.host)}catch(n){if(n instanceof j&&this.warming)return;throw new c("build",`The scenery's update threw at ${String(e)} s: ${n.message}`,{cause:n})}finally{this.poseTimes=void 0}this.scene.updateMatrixWorld(!0),this.posedAt=e,this.posedWith=s}}get posed(){return this.posedAt}stateOf(e,t,s,n){if(this.pose(t,n),"state"in e)return{state:e.state,label:"camera"};if("name"in e){const r=this.scenery.cameras?.[e.name];if(!r){const i=Object.keys(this.scenery.cameras??{});throw new c("name",`The scenery has no camera "${e.name}"${i.length?`; its cameras: ${i.join(", ")}`:": it names none"}.`)}return{state:r,label:e.name}}if("move"in e){const r=this.scenery.moves?.[e.move];if(!r){const i=Object.keys(this.scenery.moves??{});throw new c("name",`The scenery has no move "${e.move}"${i.length?`; its moves: ${i.join(", ")}`:": it names none"}.`)}return{state:this.moved(r,t,n,s,`The move "${e.move}"`),label:e.move}}return{state:this.around(e.around,e.side,s,e.lens,e.fill),label:`${e.around} ${e.side}`}}moved(e,t,s,n,r){try{return e(t,this.viewWith(s,n))}catch(i){throw new c("camera",`${r} threw at ${String(t)} s: ${i.message}`,{cause:i})}}stateFrom(e,t,s,n){if(this.pose(t,n),typeof e=="function")return this.moved(e,t,n,s,"The layer's camera");if(typeof e=="string"){const r=this.scenery.cameras?.[e]?{name:e}:{move:e};if(!this.scenery.cameras?.[e]&&!this.scenery.moves?.[e])throw new c("name",`The scenery has no camera or move "${e}".`);return this.stateOf(r,t,s,n).state}return e}around(e,t,s,n=$.lens,r=$.fill){const i=this.objectNamed(e),h=[];for(const u of S(i))V(u,(R,D,W)=>h.push([R,D,W]));if(h.length===0)throw new c("name",`"${e}" has nothing drawn in it to frame.`);const o=new b(0,0,1).transformDirection(i.matrixWorld);let a=w([o.x,0,o.z]);a[0]===0&&a[2]===0&&(a=[0,0,1]);const l=w(K(a,[0,1,0])),d=O(l,-1),g=O(a,-1);let f,N=[0,1,0];switch(t){case"front":f=g;break;case"back":f=a;break;case"left":f=l;break;case"right":f=d;break;case"top":f=[0,-1,0],N=g;break;case"three-quarter":{const u=w([a[0]+d[0],0,a[2]+d[2]]);f=w([-u[0]*Math.cos(Math.PI/6),-Math.sin(Math.PI/6),-u[2]*Math.cos(Math.PI/6)]);break}}return _({points:h,direction:f,up:N,aspect:s,lens:n,fill:r})}cutsOf(e,t){const s=typeof e=="function"?e:typeof e=="string"?this.scenery.moves?.[e]:void 0;return s?M(s,this.viewWith(t)):[]}aim(e,t){let s;try{s=L(e,t,r=>this.pointIfAny(r))}catch(r){throw r instanceof A?new c("camera",r.message):r}const n=new T(s.fov.vertical,t,s.near,s.far);return n.position.set(...s.position),n.quaternion.set(...s.quaternion),n.updateMatrixWorld(!0),s.ev!==void 0?n.userData.ev=s.ev:delete n.userData.ev,{state:e,resolved:s,camera:n,...typeof e.target=="string"?{targetName:e.target}:{}}}shownFor(e=[],t=[]){const s=[],n=(r,i)=>{s.push([r,r.visible]),r.visible=i};for(const r of e)n(this.objectNamed(r),!1);if(t.length>0){const r=new Set;for(const i of t){const h=this.objectNamed(i);h.traverse(o=>r.add(o));for(let o=h;o;o=o.parent)r.add(o)}for(const i of S(this.scene))r.has(i)||n(i,!1)}return()=>{for(const[r,i]of s.reverse())r.visible=i}}}

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

@@ -0,0 +1,23 @@
+import type { Object3D, Scene } from "three";
+import type { SceneryHost, SceneryProp } from "@allyhub/scenery";
+export declare class Props {
+    private readonly scene;
+    private readonly host;
+    /** Each prop, built once, by the SceneryProp it was made from. */
+    private readonly built;
+    /** Each prop while it is built: two layers that bring it at once build it once. */
+    private readonly building;
+    constructor(scene: Scene, host: SceneryHost);
+    /**
+     * Builds a prop and puts it in the scene, hidden until a layer shows it.
+     * Built once however many layers add it.
+     */
+    add(prop: SceneryProp): Promise<Object3D>;
+    private build;
+    /**
+     * Shows a layer's props, each posed at scenery time t, and hides every
+     * other prop: call it after the scenery is posed, before the layer draws.
+     */
+    show(shown: readonly SceneryProp[], t: number): void;
+}
+//# sourceMappingURL=props.d.ts.map