@shopware-ag/dive 4.0.1 → 4.1.0

package/build/components/softshadow/SoftShadowComponent.d.ts

@@ -0,0 +1,197 @@
+import { Color, Mesh, ColorRepresentation, Scene, WebGPURenderer } from 'three/webgpu';
+import { DIVEComponent } from '../../engine/component/Component.ts';
+import { DIVENode } from '../../engine/node/Node.ts';
+/**
+ * A soft contact shadow under the node it is attached to, baked once.
+ *
+ * What it draws is not a shadow map and does not come from any light: a camera
+ * under the node looks up and records how close the geometry above it comes to
+ * the ground, and that gets blurred and put on a plane. So it costs one
+ * transparent quad per frame however complicated the model is, the softness is a
+ * number rather than a consequence of a light's size, and it does not flicker or
+ * crawl the way a shadow map does at grazing angles.
+ *
+ * The trade is that it is baked. It holds for a model that stands still --
+ * which is what it is for -- and anything that moves, turns or reshapes the node
+ * needs another bake. The same events {@link BoundingBoxComponent} watches mark
+ * it stale, and {@link tick} re-bakes it by itself; {@link setAutoBake} turns
+ * that off for a caller that would rather decide, such as an editor dragging a
+ * gizmo.
+ *
+ * The bake needs a renderer and a scene, which a component has no way to ask
+ * for. Both arrive through `onBeforeRender` on the contributed plane -- the
+ * sanctioned route, and the same one {@link GridComponent} uses for its camera.
+ * The first frame therefore draws nothing, and the shadow appears in the second.
+ * {@link bake} is there for a caller that has a renderer and does not want to
+ * wait for that.
+ *
+ * The plane sits on {@link SHADOW_LAYER_MASK}, which keeps it out of bounding
+ * boxes, exports and picking -- and, since the bake camera renders
+ * {@link PRODUCT_LAYER_MASK}, out of its own shadow. Everything else on the
+ * product layer within the frustum is captured, so a model standing next to
+ * another one is shaded by it too.
+ *
+ * @module
+ */
+export declare class SoftShadowComponent extends DIVEComponent {
+    readonly isSoftShadowComponent: true;
+    private _mesh;
+    private _material;
+    /** Where the bake ends up, and what the plane samples. Never swapped. */
+    private _target;
+    /** The other half of the blur ping-pong. */
+    private _scratch;
+    private _quad;
+    private _blurToScratch;
+    private _blurToTarget;
+    private _horizontal;
+    private _vertical;
+    private _camera;
+    private _depthMaterial;
+    private _opacity;
+    private _darkness;
+    /** How high the bake frustum reaches, so the shader can normalise depth. */
+    private _reach;
+    private _bounds;
+    private _stale;
+    private _needsBake;
+    private _resolution;
+    private _softness;
+    private _autoBake;
+    /** World-space extent of the plane, which is what a blur radius is in UV of. */
+    private _width;
+    private _depth;
+    private _renderer;
+    private _scene;
+    private _invalidate;
+    constructor();
+    /** The plane the shadow is drawn on. */
+    get mesh(): Mesh;
+    /** Whether the shadow is drawn. */
+    get visible(): boolean;
+    /** The shadow colour. */
+    get color(): Color;
+    /** How opaque the shadow is drawn, 0 to 1. */
+    get opacity(): number;
+    /** How dark the shadow goes where something touches the ground, 0 to 1. */
+    get darkness(): number;
+    /** How far the shadow spreads past what casts it, in meters. */
+    get softness(): number;
+    /** Edge length of the shadow texture, in pixels. */
+    get resolution(): number;
+    /** Whether {@link tick} re-bakes the shadow when it goes stale. */
+    get autoBake(): boolean;
+    /** Whether the shadow on screen is behind what the node looks like now. */
+    get needsBake(): boolean;
+    /**
+     * @param visible - Whether the shadow is drawn.
+     */
+    setVisibility(visible: boolean): this;
+    /**
+     * Costs no bake: the bake writes alpha, and this is the colour under it.
+     *
+     * @param color - The shadow colour.
+     */
+    setColor(color: ColorRepresentation): this;
+    /**
+     * Costs no bake either, which makes it the one to animate or tie to a slider.
+     *
+     * @param opacity - How opaque the shadow is drawn, 0 to 1.
+     */
+    setOpacity(opacity: number): this;
+    /**
+     * How dark the shadow goes directly under the model.
+     *
+     * Baked into the texture, unlike {@link setOpacity}, because it is a curve
+     * over height rather than one value over the whole plane.
+     *
+     * @param darkness - The darkness at ground contact, 0 to 1.
+     */
+    setDarkness(darkness: number): this;
+    /**
+     * How far the shadow spreads past what casts it.
+     *
+     * In meters, so it stays put when the model is swapped for a bigger one.
+     * The plane grows with it -- {@link PADDING_FACTOR} radii past the bounds --
+     * so raising this never clips the falloff.
+     *
+     * @param softness - The spread in meters.
+     */
+    setSoftness(softness: number): this;
+    /**
+     * @param resolution - Edge length of the shadow texture in pixels.
+     */
+    setResolution(resolution: number): this;
+    /**
+     * Whether the component re-bakes itself when the node changes.
+     *
+     * On by default. Worth turning off while something drags the node around,
+     * where every frame would otherwise pay for a bake nobody sees.
+     *
+     * @param autoBake - Whether to re-bake on tick.
+     */
+    setAutoBake(autoBake: boolean): this;
+    /**
+     * Marks the shadow stale, so it is baked again.
+     *
+     * Only needed for changes nothing announces -- a geometry swapped in place
+     * on a mesh that is already in the node. Everything that goes through the
+     * node's own API arrives here as an event.
+     */
+    refresh(): this;
+    /**
+     * Renders the shadow.
+     *
+     * Four passes: the silhouette from below, then the blur twice over, each
+     * horizontal and vertical. All of it on the GPU, nothing read back, so this
+     * is synchronous -- but it does render the scene, so it is not something to
+     * call every frame by choice.
+     *
+     * Puts back everything it borrows from the renderer and the scene, including
+     * on the way out of a failure, because the live view renders from the same
+     * two.
+     *
+     * @param renderer - An initialised renderer.
+     * @param scene - The scene the node stands in.
+     */
+    bake(renderer: WebGPURenderer, scene: Scene): this;
+    /**
+     * Keeps the plane under the node, and bakes when something has changed.
+     *
+     * Enrolled only while there is something to do: a bake turns the tick off
+     * again, and an event turns it back on.
+     */
+    tick(): void;
+    protected onAttach(owner: DIVENode): void;
+    protected onDetach(previousOwner: DIVENode): void;
+    copy(source: this): this;
+    dispose(): void;
+    /** Re-encloses the owner if anything has happened since the last read. */
+    private _measure;
+    /**
+     * Sizes the plane to the bounds and puts it under them.
+     *
+     * World-aligned and flat on the lowest point of the node, whatever the
+     * owner's own transform is -- which is why the owner's world matrix is
+     * multiplied back out: a contributed object would otherwise be transformed
+     * by it a second time.
+     */
+    private _place;
+    /** Points the bake camera up through the bounds from the plane. */
+    private _aim;
+    /** Matches both targets to the configured resolution. */
+    private _resize;
+    /**
+     * One separable blur: horizontal into the scratch target, vertical back.
+     *
+     * The radius is in meters and the taps step in UV, so each direction is
+     * divided by the extent of the plane along it -- which is what keeps a
+     * shadow on a wide, shallow plane from being blurred into an oval.
+     *
+     * @param renderer - The renderer to draw with.
+     * @param scale - The radius for this pass, relative to {@link softness}.
+     */
+    private _blur;
+    /** Marks the shadow current, and stops the tick until something changes. */
+    private _settle;
+}

package/build/components/softshadow/index.d.ts

@@ -0,0 +1 @@
+export * from './SoftShadowComponent.ts';

package/build/constants/GridColors.d.ts

@@ -1,2 +1,46 @@
-export declare const GRID_MINOR_LINE_COLOR = "#dddddd";
-export declare const GRID_MAJOR_LINE_COLOR = "#888888";
+import { ColorRepresentation } from 'three/webgpu';
+/**
+ * What a grid preset settles: how the two kinds of line read against the ground
+ * they sit on, and nothing else.
+ *
+ * Opacity rather than a paler color, because paler only works in one direction:
+ * on a dark ground the way to a quieter line is darker, on a light one it is
+ * lighter, and opacity is the same move on both. It is also the only one open
+ * to a transparent canvas, where the ground is a page the engine cannot read.
+ */
+export type DIVEGridColors = {
+    /** Color of the minor grid lines. */
+    minorLineColor: ColorRepresentation;
+    /** Color of the major grid lines. */
+    majorLineColor: ColorRepresentation;
+    /** How opaque the minor grid lines are drawn, 0 to 1. */
+    minorLineOpacity: number;
+    /** How opaque the major grid lines are drawn, 0 to 1. */
+    majorLineOpacity: number;
+};
+/**
+ * Lines for a grid that sits on something light -- a white floor, or a page in
+ * its light theme.
+ *
+ * The minor lines carry the pattern and the major ones the reading of it, so
+ * the two are a step apart rather than a shade: close together they read as one
+ * grid drawn badly.
+ */
+export declare const DIVEGridOnLightColors: DIVEGridColors;
+/**
+ * Lines for a grid that sits on something dark -- a dark floor, or a page in
+ * its dark theme.
+ *
+ * Lighter than the ground rather than darker, and by less than the light
+ * preset's step: on a dark ground the same contrast reads louder, and a grid
+ * that shouts is furniture drawing attention to itself.
+ */
+export declare const DIVEGridOnDarkColors: DIVEGridColors;
+/**
+ * Lines that hold on either ground, for a viewer that does not know which it is
+ * standing on.
+ *
+ * A compromise by construction: mid grey never disappears into white or into
+ * black, and never reads as well on either as the preset made for it.
+ */
+export declare const DIVEGridOnAnyColors: DIVEGridColors;

package/build/constants/VisibilityLayerMask.d.ts

@@ -26,3 +26,15 @@ export declare const FLOOR_LAYER_MASK = 32;
  * picked at all.
  */
 export declare const PROXY_LAYER_MASK = 64;
+/**
+ * A baked contact shadow under a model.
+ *
+ * Its own bit for the same reason the floor has one: the shadow has to be drawn
+ * in both views, but it is not geometry. `PRODUCT_LAYER_MASK` would put it into
+ * bounding boxes, scene exports and picking, and it is the one thing the bake
+ * must never capture -- the bake camera renders `PRODUCT_LAYER_MASK`, so this
+ * bit is what keeps the plane out of its own shadow. `FLOOR_LAYER_MASK` would
+ * tie it to the ground plane, and hiding the floor would take the shadow with
+ * it.
+ */
+export declare const SHADOW_LAYER_MASK = 128;

package/build/dive.cjs

@@ -1 +1 @@
-"use strict";var M=Object.defineProperty;var P=(e,t,n)=>t in e?M(e,t,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[t]=n;var I=(e,t,n)=>P(e,typeof t!="symbol"?t+"":t,n);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./chunks/FileTypes-B-MjfMGd.cjs"),f=require("./chunks/AxisHelperColors-BrGqktN5.cjs"),E=require("./chunks/contributesToBounds-C1mva__U.cjs"),m=require("./chunks/detachTransformControls-CZ2cd5hx.cjs"),L=require("./chunks/ModelComponent-Cmu0EX0r.cjs"),V=require("./chunks/SpriteTextComponent-BpoKLOjA.cjs"),_=require("./chunks/collectAnimations-C3HfZHte.cjs"),d=require("./chunks/isVisibleInHierarchy-D9JcLqR5.cjs"),D=require("./chunks/isFileExtensionSupported-B1q2eWs7.cjs"),g=require("three/webgpu"),A=require("./chunks/network-error-CdDXil5g.cjs"),O=require("./chunks/parse-error-Dy_EE4rL.cjs");class h{constructor(){I(this,"isMovable",!0)}}class y{constructor(){I(this,"isSelectable",!0)}}function T(e,t){return t.forEach(n=>{Object.getOwnPropertyNames(n.prototype).forEach(c=>{if(c==="constructor")return;const l=Object.getOwnPropertyDescriptor(n.prototype,c);Object.defineProperty(e.prototype,c,l)});const r=new n;Object.getOwnPropertyNames(r).forEach(c=>{const l=Object.getOwnPropertyDescriptor(r,c);Object.defineProperty(e.prototype,c,l)})}),e}function a(e,t=new WeakMap){if(e===null||typeof e!="object")return e;if(t.has(e))return t.get(e);if(e instanceof Date)return new Date(e.getTime());if(e instanceof RegExp)return new RegExp(e.source,e.flags);if(Array.isArray(e)){const i=[];t.set(e,i);for(let s=0;s<e.length;s++)i[s]=a(e[s],t);return i}if(e instanceof Map){const i=new Map;t.set(e,i);for(const[s,u]of e)i.set(a(s,t),a(u,t));return i}if(e instanceof Set){const i=new Set;t.set(e,i);for(const s of e)i.add(a(s,t));return i}const n=e;if(typeof n.clone=="function"){const i=n.clone();return t.set(e,i),i}const r=Object.create(Object.getPrototypeOf(e));t.set(e,r);const c=Object.getOwnPropertyNames(e);for(const i of c){const s=Object.getOwnPropertyDescriptor(e,i);if(s)if(s.value!==void 0){const u=a(s.value,t);Object.defineProperty(r,i,{...s,value:u})}else Object.defineProperty(r,i,s)}const l=Object.getOwnPropertySymbols(e);for(const i of l){const s=Object.getOwnPropertyDescriptor(e,i);if(s)if(s.value!==void 0){const u=a(s.value,t);Object.defineProperty(r,i,{...s,value:u})}else Object.defineProperty(r,i,s)}return r}const C=(e,t)=>{if(Object.keys(e).length===0&&Object.keys(t).length===0)return{};if(typeof e!="object"||typeof t!="object")return t;let n={};return Object.keys(t).forEach(r=>{if(!Object.keys(e).includes(r)){n={...n,[r]:t[r]};return}if(Array.isArray(t[r])){if(!Array.isArray(e[r])){n={...n,[r]:t[r]};return}const c=e[r],l=t[r];if(c.length===0&&l.length===0){n={...n};return}if(c.length!==l.length){n={...n,[r]:t[r]};return}const i=[];if(l.forEach((s,u)=>{const R=C(c[u],l[u]);Object.keys(R).length&&i.push(l[u])}),Object.keys(i).length){n={...n,[r]:i};return}return}if(typeof t[r]=="object"){if(typeof e[r]!="object"){n={...n,[r]:t[r]};return}const c=C(e[r],t[r]);if(Object.keys(c).length){n={...n,[r]:c};return}}e[r]!==t[r]&&(n={...n,[r]:t[r]})}),n};function x(e){return o.SUPPORTED_MIME_TYPES.includes(e.toLowerCase())}function F(e){return D.isFileExtensionSupported(D.getFileTypeFromUri(e))}function p(e,t){const n=(e+"e").split("e");return+(n[0]+"e"+(+n[1]+(t||0)))}function Y(e,t=0){const n=p(e,+t);return p(Math.ceil(n),-t)}function w(e,t=0){const n=p(e,+t);return p(Math.floor(n),-t)}function S(e,t=0){if(e<0)return-S(-e,t);const n=p(e,+t);return p(Math.round(n),-t)}function B(e,t,n){return Math.atan2(e.clone().cross(t).dot(n),t.clone().dot(e))}function U(e,t=0){const n=p(e,+t);return p(Math.round(n),-t).toFixed(t)}function b(e,t=0){const n=p(e,+t);return p(Math.trunc(n),-t)}function N(e){return(g.MathUtils.radToDeg(e)+360)%360}function K(e){return g.MathUtils.degToRad(e)}const v={ceilExp:Y,floorExp:w,roundExp:S,toFixedExp:U,truncateExp:b,signedAngleTo:B,radToDeg:N,degToRad:K};exports.BoundingBox=o.BoundingBox;exports.BoundingBoxComponent=o.BoundingBoxComponent;exports.DIVE=o.DIVE;exports.DIVEAbortablePromise=o.DIVEAbortablePromise;exports.DIVECameraComponent=o.DIVECameraComponent;exports.DIVECanvasLifecycleManager=o.DIVECanvasLifecycleManager;exports.DIVEClock=o.DIVEClock;exports.DIVEComponent=o.DIVEComponent;exports.DIVEDefaultSettings=o.DIVEDefaultSettings;exports.DIVEDeferredPromise=o.DIVEDeferredPromise;exports.DIVEEnvironment=o.DIVEEnvironment;exports.DIVEEnvironmentDefaultSettings=o.DIVEEnvironmentDefaultSettings;exports.DIVELightComponent=o.DIVELightComponent;exports.DIVENode=o.DIVENode;exports.DIVEPerspectiveCameraDefaultSettings=o.DIVEPerspectiveCameraDefaultSettings;exports.DIVERenderer=o.DIVERenderer;exports.DIVERendererDefaultSettings=o.DIVERendererDefaultSettings;exports.DIVERoot=o.DIVERoot;exports.DIVEScene=o.DIVEScene;exports.DIVESceneDefaultSettings=o.DIVESceneDefaultSettings;exports.DIVEView=o.DIVEView;exports.DirectionalLightComponent=o.DirectionalLightComponent;exports.FILE_TYPES=o.FILE_TYPES;exports.FloorComponent=o.FloorComponent;exports.GRID_MAJOR_LINE_COLOR=o.GRID_MAJOR_LINE_COLOR;exports.GRID_MINOR_LINE_COLOR=o.GRID_MINOR_LINE_COLOR;exports.GridComponent=o.GridComponent;exports.HemisphereLightComponent=o.HemisphereLightComponent;exports.MeshComponent=o.MeshComponent;exports.MultiLineComponent=o.MultiLineComponent;exports.PerspectiveCameraComponent=o.PerspectiveCameraComponent;exports.SUPPORTED_FILE_TYPES=o.SUPPORTED_FILE_TYPES;exports.SUPPORTED_MIME_TYPES=o.SUPPORTED_MIME_TYPES;exports.computeProductBounds=o.computeProductBounds;exports.contributedBy=o.contributedBy;exports.disposeComponents=o.disposeComponents;exports.findComponent=o.findComponent;exports.findSceneRecursive=o.findSceneRecursive;exports.isDIVEComponent=o.isDIVEComponent;exports.AxesColorBlue=f.AxesColorBlue;exports.AxesColorBlueLetter=f.AxesColorBlueLetter;exports.AxesColorGreen=f.AxesColorGreen;exports.AxesColorGreenLetter=f.AxesColorGreenLetter;exports.AxesColorRed=f.AxesColorRed;exports.AxesColorRedLetter=f.AxesColorRedLetter;exports.COORDINATE_LAYER_MASK=E.COORDINATE_LAYER_MASK;exports.DEFAULT_LAYER_MASK=E.DEFAULT_LAYER_MASK;exports.FLOOR_LAYER_MASK=E.FLOOR_LAYER_MASK;exports.HELPER_LAYER_MASK=E.HELPER_LAYER_MASK;exports.PRODUCT_LAYER_MASK=E.PRODUCT_LAYER_MASK;exports.PROXY_LAYER_MASK=E.PROXY_LAYER_MASK;exports.UI_LAYER_MASK=E.UI_LAYER_MASK;exports.contributesToBounds=E.contributesToBounds;exports.AmbientLightComponent=m.AmbientLightComponent;exports.PointLightComponent=m.PointLightComponent;exports.PrimitiveComponent=m.PrimitiveComponent;exports.detachTransformControls=m.detachTransformControls;exports.ModelComponent=L.ModelComponent;exports.SpriteTextComponent=V.SpriteTextComponent;exports.collectAnimations=_.collectAnimations;exports.findInterface=d.findInterface;exports.implementsInterface=d.implementsInterface;exports.isVisibleInHierarchy=d.isVisibleInHierarchy;exports.getFileTypeFromUri=D.getFileTypeFromUri;exports.isFileExtensionSupported=D.isFileExtensionSupported;exports.FileContentError=A.FileContentError;exports.NetworkError=A.NetworkError;exports.FileTypeError=O.FileTypeError;exports.ParseError=O.ParseError;exports.DIVEMath=v;exports.DIVEMovable=h;exports.DIVESelectable=y;exports.applyMixins=T;exports.deepClone=a;exports.getObjectDelta=C;exports.isMimeTypeSupported=x;exports.isURIFileExtensionSupported=F;
+"use strict";var P=Object.defineProperty;var h=(e,t,n)=>t in e?P(e,t,{enumerable:!0,configurable:!0,writable:!0,value:n}):e[t]=n;var m=(e,t,n)=>h(e,typeof t!="symbol"?t+"":t,n);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./chunks/FileTypes-DTCnNV95.cjs"),f=require("./chunks/AxisHelperColors-BrGqktN5.cjs"),E=require("./chunks/contributesToBounds-Dmh3K2n5.cjs"),C=require("./chunks/detachTransformControls-C6Zej6b_.cjs"),M=require("./chunks/ModelComponent-CHIXv2a6.cjs"),y=require("./chunks/SpriteTextComponent-IYbrESut.cjs"),L=require("./chunks/collectAnimations-C3HfZHte.cjs"),I=require("./chunks/isVisibleInHierarchy-D9JcLqR5.cjs"),D=require("./chunks/isFileExtensionSupported-CY90yqQo.cjs"),S=require("three/webgpu"),A=require("./chunks/network-error-CdDXil5g.cjs"),g=require("./chunks/parse-error-Dy_EE4rL.cjs");class R{constructor(){m(this,"isMovable",!0)}}class _{constructor(){m(this,"isSelectable",!0)}}function T(e,t){return t.forEach(n=>{Object.getOwnPropertyNames(n.prototype).forEach(c=>{if(c==="constructor")return;const l=Object.getOwnPropertyDescriptor(n.prototype,c);Object.defineProperty(e.prototype,c,l)});const r=new n;Object.getOwnPropertyNames(r).forEach(c=>{const l=Object.getOwnPropertyDescriptor(r,c);Object.defineProperty(e.prototype,c,l)})}),e}function a(e,t=new WeakMap){if(e===null||typeof e!="object")return e;if(t.has(e))return t.get(e);if(e instanceof Date)return new Date(e.getTime());if(e instanceof RegExp)return new RegExp(e.source,e.flags);if(Array.isArray(e)){const i=[];t.set(e,i);for(let s=0;s<e.length;s++)i[s]=a(e[s],t);return i}if(e instanceof Map){const i=new Map;t.set(e,i);for(const[s,u]of e)i.set(a(s,t),a(u,t));return i}if(e instanceof Set){const i=new Set;t.set(e,i);for(const s of e)i.add(a(s,t));return i}const n=e;if(typeof n.clone=="function"){const i=n.clone();return t.set(e,i),i}const r=Object.create(Object.getPrototypeOf(e));t.set(e,r);const c=Object.getOwnPropertyNames(e);for(const i of c){const s=Object.getOwnPropertyDescriptor(e,i);if(s)if(s.value!==void 0){const u=a(s.value,t);Object.defineProperty(r,i,{...s,value:u})}else Object.defineProperty(r,i,s)}const l=Object.getOwnPropertySymbols(e);for(const i of l){const s=Object.getOwnPropertyDescriptor(e,i);if(s)if(s.value!==void 0){const u=a(s.value,t);Object.defineProperty(r,i,{...s,value:u})}else Object.defineProperty(r,i,s)}return r}const d=(e,t)=>{if(Object.keys(e).length===0&&Object.keys(t).length===0)return{};if(typeof e!="object"||typeof t!="object")return t;let n={};return Object.keys(t).forEach(r=>{if(!Object.keys(e).includes(r)){n={...n,[r]:t[r]};return}if(Array.isArray(t[r])){if(!Array.isArray(e[r])){n={...n,[r]:t[r]};return}const c=e[r],l=t[r];if(c.length===0&&l.length===0){n={...n};return}if(c.length!==l.length){n={...n,[r]:t[r]};return}const i=[];if(l.forEach((s,u)=>{const O=d(c[u],l[u]);Object.keys(O).length&&i.push(l[u])}),Object.keys(i).length){n={...n,[r]:i};return}return}if(typeof t[r]=="object"){if(typeof e[r]!="object"){n={...n,[r]:t[r]};return}const c=d(e[r],t[r]);if(Object.keys(c).length){n={...n,[r]:c};return}}e[r]!==t[r]&&(n={...n,[r]:t[r]})}),n};function x(e){return o.SUPPORTED_MIME_TYPES.includes(e.toLowerCase())}function F(e){return D.isFileExtensionSupported(D.getFileTypeFromUri(e))}function p(e,t){const n=(e+"e").split("e");return+(n[0]+"e"+(+n[1]+(t||0)))}function Y(e,t=0){const n=p(e,+t);return p(Math.ceil(n),-t)}function w(e,t=0){const n=p(e,+t);return p(Math.floor(n),-t)}function V(e,t=0){if(e<0)return-V(-e,t);const n=p(e,+t);return p(Math.round(n),-t)}function B(e,t,n){return Math.atan2(e.clone().cross(t).dot(n),t.clone().dot(e))}function U(e,t=0){const n=p(e,+t);return p(Math.round(n),-t).toFixed(t)}function K(e,t=0){const n=p(e,+t);return p(Math.trunc(n),-t)}function b(e){return(S.MathUtils.radToDeg(e)+360)%360}function G(e){return S.MathUtils.degToRad(e)}const v={ceilExp:Y,floorExp:w,roundExp:V,toFixedExp:U,truncateExp:K,signedAngleTo:B,radToDeg:b,degToRad:G};exports.BoundingBox=o.BoundingBox;exports.BoundingBoxComponent=o.BoundingBoxComponent;exports.DIVE=o.DIVE;exports.DIVEAbortablePromise=o.DIVEAbortablePromise;exports.DIVECameraComponent=o.DIVECameraComponent;exports.DIVECanvasLifecycleManager=o.DIVECanvasLifecycleManager;exports.DIVEClock=o.DIVEClock;exports.DIVEComponent=o.DIVEComponent;exports.DIVEDefaultSettings=o.DIVEDefaultSettings;exports.DIVEDeferredPromise=o.DIVEDeferredPromise;exports.DIVEEnvironment=o.DIVEEnvironment;exports.DIVEEnvironmentDefaultSettings=o.DIVEEnvironmentDefaultSettings;exports.DIVEGridDefaultSettings=o.DIVEGridDefaultSettings;exports.DIVEGridOnAnyColors=o.DIVEGridOnAnyColors;exports.DIVEGridOnDarkColors=o.DIVEGridOnDarkColors;exports.DIVEGridOnLightColors=o.DIVEGridOnLightColors;exports.DIVELightComponent=o.DIVELightComponent;exports.DIVENode=o.DIVENode;exports.DIVEPerspectiveCameraDefaultSettings=o.DIVEPerspectiveCameraDefaultSettings;exports.DIVERenderer=o.DIVERenderer;exports.DIVERendererDefaultSettings=o.DIVERendererDefaultSettings;exports.DIVERoot=o.DIVERoot;exports.DIVEScene=o.DIVEScene;exports.DIVESceneDefaultSettings=o.DIVESceneDefaultSettings;exports.DIVEView=o.DIVEView;exports.DirectionalLightComponent=o.DirectionalLightComponent;exports.FILE_TYPES=o.FILE_TYPES;exports.FloorComponent=o.FloorComponent;exports.GridComponent=o.GridComponent;exports.HemisphereLightComponent=o.HemisphereLightComponent;exports.MeshComponent=o.MeshComponent;exports.MultiLineComponent=o.MultiLineComponent;exports.PerspectiveCameraComponent=o.PerspectiveCameraComponent;exports.SUPPORTED_FILE_TYPES=o.SUPPORTED_FILE_TYPES;exports.SUPPORTED_MIME_TYPES=o.SUPPORTED_MIME_TYPES;exports.SoftShadowComponent=o.SoftShadowComponent;exports.computeProductBounds=o.computeProductBounds;exports.contributedBy=o.contributedBy;exports.disposeComponents=o.disposeComponents;exports.findComponent=o.findComponent;exports.findSceneRecursive=o.findSceneRecursive;exports.isDIVEComponent=o.isDIVEComponent;exports.AxesColorBlue=f.AxesColorBlue;exports.AxesColorBlueLetter=f.AxesColorBlueLetter;exports.AxesColorGreen=f.AxesColorGreen;exports.AxesColorGreenLetter=f.AxesColorGreenLetter;exports.AxesColorRed=f.AxesColorRed;exports.AxesColorRedLetter=f.AxesColorRedLetter;exports.COORDINATE_LAYER_MASK=E.COORDINATE_LAYER_MASK;exports.DEFAULT_LAYER_MASK=E.DEFAULT_LAYER_MASK;exports.FLOOR_LAYER_MASK=E.FLOOR_LAYER_MASK;exports.HELPER_LAYER_MASK=E.HELPER_LAYER_MASK;exports.PRODUCT_LAYER_MASK=E.PRODUCT_LAYER_MASK;exports.PROXY_LAYER_MASK=E.PROXY_LAYER_MASK;exports.SHADOW_LAYER_MASK=E.SHADOW_LAYER_MASK;exports.UI_LAYER_MASK=E.UI_LAYER_MASK;exports.contributesToBounds=E.contributesToBounds;exports.AmbientLightComponent=C.AmbientLightComponent;exports.PointLightComponent=C.PointLightComponent;exports.PrimitiveComponent=C.PrimitiveComponent;exports.detachTransformControls=C.detachTransformControls;exports.ModelComponent=M.ModelComponent;exports.SpriteTextComponent=y.SpriteTextComponent;exports.collectAnimations=L.collectAnimations;exports.findInterface=I.findInterface;exports.implementsInterface=I.implementsInterface;exports.isVisibleInHierarchy=I.isVisibleInHierarchy;exports.getFileTypeFromUri=D.getFileTypeFromUri;exports.isFileExtensionSupported=D.isFileExtensionSupported;exports.FileContentError=A.FileContentError;exports.NetworkError=A.NetworkError;exports.FileTypeError=g.FileTypeError;exports.ParseError=g.ParseError;exports.DIVEMath=v;exports.DIVEMovable=R;exports.DIVESelectable=_;exports.applyMixins=T;exports.deepClone=a;exports.getObjectDelta=d;exports.isMimeTypeSupported=x;exports.isURIFileExtensionSupported=F;

package/build/dive.mjs

@@ -1,27 +1,27 @@
 var g = Object.defineProperty;
-var O = (e, t, r) => t in e ? g(e, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : e[t] = r;
-var u = (e, t, r) => O(e, typeof t != "symbol" ? t + "" : t, r);
-import { h as d } from "./chunks/FileTypes-D3Dxr2dj.mjs";
-import { B as G, i as j, c as v, j as H, D as b, k as J, l as W, a as q, b as z, m as X, n as Q, o as Z, f as $, d as k, p as ee, q as te, r as re, s as ne, t as oe, u as se, v as ae, w as ce, F as ie, x as fe, G as pe, y as ue, z as le, H as Ee, M as me, A as De, P as ge, S as Oe, C as de, E as Ae, e as Ie, I as ye, g as he, J as Ce } from "./chunks/FileTypes-D3Dxr2dj.mjs";
-import { b as Me, e as xe, a as Se, d as Re, A as Le, c as Ve } from "./chunks/AxisHelperColors-JLBHYQDi.mjs";
-import { C as Te, D as we, F as Fe, H as Ne, P as Ye, a as Be, U as Ue, c as Ke } from "./chunks/contributesToBounds-DYmHYES4.mjs";
-import { A as je, P as ve, a as He, d as be } from "./chunks/detachTransformControls-B4iRF1bw.mjs";
-import { M as We } from "./chunks/ModelComponent-WA0kLOEY.mjs";
-import { S as ze } from "./chunks/SpriteTextComponent-DIZFqao0.mjs";
-import { c as Qe } from "./chunks/collectAnimations-BgYCN1le.mjs";
-import { f as $e, i as ke, a as et } from "./chunks/isVisibleInHierarchy-KzVGvDEw.mjs";
-import { i as A, g as I } from "./chunks/isFileExtensionSupported-BqOqU3-h.mjs";
+var d = (e, t, r) => t in e ? g(e, t, { enumerable: !0, configurable: !0, writable: !0, value: r }) : e[t] = r;
+var l = (e, t, r) => d(e, typeof t != "symbol" ? t + "" : t, r);
+import { h as O } from "./chunks/FileTypes-C8BdyVai.mjs";
+import { B as G, i as H, c as j, j as v, D as b, k as W, l as q, a as z, b as J, m as X, n as Q, o as Z, p as $, q as k, r as ee, s as te, f as re, d as ne, t as oe, u as se, v as ae, w as ce, x as ie, y as fe, z as pe, A as le, F as ue, C as Ee, G as De, H as me, M as ge, E as de, P as Oe, S as Ae, I as he, J as ye, K as Ce, e as Ie, L as Se, g as Pe, N as xe } from "./chunks/FileTypes-C8BdyVai.mjs";
+import { b as Ve, e as Le, a as Re, d as _e, A as Te, c as we } from "./chunks/AxisHelperColors-JLBHYQDi.mjs";
+import { C as Ye, D as Ke, F as Be, H as Ne, P as Ue, a as Ge, S as He, U as je, c as ve } from "./chunks/contributesToBounds-DK3AK1Lq.mjs";
+import { A as We, P as qe, a as ze, d as Je } from "./chunks/detachTransformControls-DRCqBDEX.mjs";
+import { M as Qe } from "./chunks/ModelComponent-DEUhl62p.mjs";
+import { S as $e } from "./chunks/SpriteTextComponent-JwWMzAKh.mjs";
+import { c as et } from "./chunks/collectAnimations-BgYCN1le.mjs";
+import { f as rt, i as nt, a as ot } from "./chunks/isVisibleInHierarchy-KzVGvDEw.mjs";
+import { i as A, g as h } from "./chunks/isFileExtensionSupported-DRnGwWT2.mjs";
 import { MathUtils as E } from "three/webgpu";
-import { F as rt, N as nt } from "./chunks/network-error-BONfHWQq.mjs";
-import { F as st, P as at } from "./chunks/parse-error-DfOPyLWM.mjs";
+import { F as at, N as ct } from "./chunks/network-error-BONfHWQq.mjs";
+import { F as ft, P as pt } from "./chunks/parse-error-DfOPyLWM.mjs";
 class T {
   constructor() {
-    u(this, "isMovable", !0);
+    l(this, "isMovable", !0);
   }
 }
 class w {
   constructor() {
-    u(this, "isSelectable", !0);
+    l(this, "isSelectable", !0);
   }
 }
 function F(e, t) {
@@ -110,7 +110,7 @@ function p(e, t = /* @__PURE__ */ new WeakMap()) {
   }
   return n;
 }
-const l = (e, t) => {
+const u = (e, t) => {
   if (Object.keys(e).length === 0 && Object.keys(t).length === 0)
     return {};
   if (typeof e != "object" || typeof t != "object")
@@ -137,11 +137,11 @@ const l = (e, t) => {
       }
       const o = [];
       if (c.forEach((s, f) => {
-        const D = l(
+        const m = u(
           a[f],
           c[f]
         );
-        Object.keys(D).length && o.push(c[f]);
+        Object.keys(m).length && o.push(c[f]);
       }), Object.keys(o).length) {
         r = { ...r, [n]: o };
         return;
@@ -153,7 +153,7 @@ const l = (e, t) => {
         r = { ...r, [n]: t[n] };
         return;
       }
-      const a = l(
+      const a = u(
         e[n],
         t[n]
       );
@@ -165,11 +165,11 @@ const l = (e, t) => {
     e[n] !== t[n] && (r = { ...r, [n]: t[n] });
   }), r;
 };
-function N(e) {
-  return d.includes(e.toLowerCase());
-}
 function Y(e) {
-  return A(I(e));
+  return O.includes(e.toLowerCase());
+}
+function K(e) {
+  return A(h(e));
 }
 function i(e, t) {
   const r = (e + "e").split("e");
@@ -179,121 +179,125 @@ function y(e, t = 0) {
   const r = i(e, +t);
   return i(Math.ceil(r), -t);
 }
-function h(e, t = 0) {
+function C(e, t = 0) {
   const r = i(e, +t);
   return i(Math.floor(r), -t);
 }
-function m(e, t = 0) {
-  if (e < 0) return -m(-e, t);
+function D(e, t = 0) {
+  if (e < 0) return -D(-e, t);
   const r = i(e, +t);
   return i(Math.round(r), -t);
 }
-function C(e, t, r) {
+function I(e, t, r) {
   return Math.atan2(
     e.clone().cross(t).dot(r),
     t.clone().dot(e)
   );
 }
-function P(e, t = 0) {
+function S(e, t = 0) {
   const r = i(e, +t);
   return i(Math.round(r), -t).toFixed(t);
 }
-function M(e, t = 0) {
+function P(e, t = 0) {
   const r = i(e, +t);
   return i(Math.trunc(r), -t);
 }
 function x(e) {
   return (E.radToDeg(e) + 360) % 360;
 }
-function S(e) {
+function M(e) {
   return E.degToRad(e);
 }
 const B = {
   ceilExp: y,
-  floorExp: h,
-  roundExp: m,
-  toFixedExp: P,
-  truncateExp: M,
-  signedAngleTo: C,
+  floorExp: C,
+  roundExp: D,
+  toFixedExp: S,
+  truncateExp: P,
+  signedAngleTo: I,
   radToDeg: x,
-  degToRad: S
+  degToRad: M
 };
 export {
-  je as AmbientLightComponent,
-  Me as AxesColorBlue,
-  xe as AxesColorBlueLetter,
-  Se as AxesColorGreen,
-  Re as AxesColorGreenLetter,
-  Le as AxesColorRed,
-  Ve as AxesColorRedLetter,
+  We as AmbientLightComponent,
+  Ve as AxesColorBlue,
+  Le as AxesColorBlueLetter,
+  Re as AxesColorGreen,
+  _e as AxesColorGreenLetter,
+  Te as AxesColorRed,
+  we as AxesColorRedLetter,
   G as BoundingBox,
-  j as BoundingBoxComponent,
-  Te as COORDINATE_LAYER_MASK,
-  we as DEFAULT_LAYER_MASK,
-  v as DIVE,
-  H as DIVEAbortablePromise,
+  H as BoundingBoxComponent,
+  Ye as COORDINATE_LAYER_MASK,
+  Ke as DEFAULT_LAYER_MASK,
+  j as DIVE,
+  v as DIVEAbortablePromise,
   b as DIVECameraComponent,
-  J as DIVECanvasLifecycleManager,
-  W as DIVEClock,
-  q as DIVEComponent,
-  z as DIVEDefaultSettings,
+  W as DIVECanvasLifecycleManager,
+  q as DIVEClock,
+  z as DIVEComponent,
+  J as DIVEDefaultSettings,
   X as DIVEDeferredPromise,
   Q as DIVEEnvironment,
   Z as DIVEEnvironmentDefaultSettings,
-  $ as DIVELightComponent,
+  $ as DIVEGridDefaultSettings,
+  k as DIVEGridOnAnyColors,
+  ee as DIVEGridOnDarkColors,
+  te as DIVEGridOnLightColors,
+  re as DIVELightComponent,
   B as DIVEMath,
   T as DIVEMovable,
-  k as DIVENode,
-  ee as DIVEPerspectiveCameraDefaultSettings,
-  te as DIVERenderer,
-  re as DIVERendererDefaultSettings,
-  ne as DIVERoot,
-  oe as DIVEScene,
-  se as DIVESceneDefaultSettings,
+  ne as DIVENode,
+  oe as DIVEPerspectiveCameraDefaultSettings,
+  se as DIVERenderer,
+  ae as DIVERendererDefaultSettings,
+  ce as DIVERoot,
+  ie as DIVEScene,
+  fe as DIVESceneDefaultSettings,
   w as DIVESelectable,
-  ae as DIVEView,
-  ce as DirectionalLightComponent,
-  ie as FILE_TYPES,
-  Fe as FLOOR_LAYER_MASK,
-  rt as FileContentError,
-  st as FileTypeError,
-  fe as FloorComponent,
-  pe as GRID_MAJOR_LINE_COLOR,
-  ue as GRID_MINOR_LINE_COLOR,
-  le as GridComponent,
+  pe as DIVEView,
+  le as DirectionalLightComponent,
+  ue as FILE_TYPES,
+  Be as FLOOR_LAYER_MASK,
+  at as FileContentError,
+  ft as FileTypeError,
+  Ee as FloorComponent,
+  De as GridComponent,
   Ne as HELPER_LAYER_MASK,
-  Ee as HemisphereLightComponent,
-  me as MeshComponent,
-  We as ModelComponent,
-  De as MultiLineComponent,
-  nt as NetworkError,
-  Ye as PRODUCT_LAYER_MASK,
-  Be as PROXY_LAYER_MASK,
-  at as ParseError,
-  ge as PerspectiveCameraComponent,
-  ve as PointLightComponent,
-  He as PrimitiveComponent,
-  Oe as SUPPORTED_FILE_TYPES,
-  d as SUPPORTED_MIME_TYPES,
-  ze as SpriteTextComponent,
-  Ue as UI_LAYER_MASK,
+  me as HemisphereLightComponent,
+  ge as MeshComponent,
+  Qe as ModelComponent,
+  de as MultiLineComponent,
+  ct as NetworkError,
+  Ue as PRODUCT_LAYER_MASK,
+  Ge as PROXY_LAYER_MASK,
+  pt as ParseError,
+  Oe as PerspectiveCameraComponent,
+  qe as PointLightComponent,
+  ze as PrimitiveComponent,
+  He as SHADOW_LAYER_MASK,
+  Ae as SUPPORTED_FILE_TYPES,
+  O as SUPPORTED_MIME_TYPES,
+  he as SoftShadowComponent,
+  $e as SpriteTextComponent,
+  je as UI_LAYER_MASK,
   F as applyMixins,
-  Qe as collectAnimations,
-  de as computeProductBounds,
-  Ae as contributedBy,
-  Ke as contributesToBounds,
+  et as collectAnimations,
+  ye as computeProductBounds,
+  Ce as contributedBy,
+  ve as contributesToBounds,
   p as deepClone,
-  be as detachTransformControls,
+  Je as detachTransformControls,
   Ie as disposeComponents,
-  ye as findComponent,
-  $e as findInterface,
-  he as findSceneRecursive,
-  I as getFileTypeFromUri,
-  l as getObjectDelta,
-  ke as implementsInterface,
-  Ce as isDIVEComponent,
+  Se as findComponent,
+  rt as findInterface,
+  Pe as findSceneRecursive,
+  h as getFileTypeFromUri,
+  u as getObjectDelta,
+  nt as implementsInterface,
+  xe as isDIVEComponent,
   A as isFileExtensionSupported,
-  N as isMimeTypeSupported,
-  Y as isURIFileExtensionSupported,
-  et as isVisibleInHierarchy
+  Y as isMimeTypeSupported,
+  K as isURIFileExtensionSupported,
+  ot as isVisibleInHierarchy
 };

package/build/engine/node/Node.d.ts

@@ -182,6 +182,8 @@ export declare class DIVENode extends Object3D<DIVEEntityEventMap> implements DI
     setToWorldOrigin(): void;
     onSelect(): void;
     onDeselect(): void;
+    /** Whether an object is this node or hangs anywhere below it. */
+    private _contains;
     private _handleAddedToTree;
     private _handleRemovedFromTree;
     private _attachToScene;

package/build/engine/renderer/Renderer.d.ts

@@ -44,9 +44,29 @@ export type DIVERendererSettings = {
     /**
      * Whether to use logarithmic depth buffer
      *
-     * @default true
+     * Off, and {@link reversedDepthBuffer} on in its place: both answer the same
+     * question, and only one of them answers it in the projection. A logarithmic
+     * buffer has every fragment shader write its own depth, which costs early-z
+     * and makes every rasterizer-level depth bias a no-op -- `polygonOffset`
+     * included, which is how coplanar surfaces are normally settled.
+     *
+     * @default false
      */
     logarithmicDepthBuffer: boolean;
+    /**
+     * Whether to use a reversed depth buffer
+     *
+     * Floating point depth is near-uniform in its exponent, and a reversed range
+     * lines that up with where a perspective divide puts its precision. That is
+     * what makes a near plane of a millimeter and a far plane of a kilometer
+     * survivable without writing depth per fragment.
+     *
+     * The WebGL backend needs `EXT_clip_control` for it; three warns and falls
+     * back to a plain depth buffer where the extension is missing.
+     *
+     * @default true
+     */
+    reversedDepthBuffer: boolean;
     /**
      * Whether to enable shadows
      *