@shopware-ag/dive 3.0.11 → 4.0.0

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

@@ -1,6 +1,6 @@
 import { WebGPURenderer } from 'three/webgpu';
 import { DIVEScene } from '../scene/Scene.ts';
-import { DIVEPerspectiveCamera } from '../camera/PerspectiveCamera.ts';
+import { DIVECameraComponent } from '../../components/camera/CameraComponent.ts';
 import { DIVEEnvironment } from '../environment/Environment.ts';
 export type DIVERendererSettings = {
     /**
@@ -70,25 +70,61 @@ export declare const DIVERendererDefaultSettings: Required<DIVERendererSettings>
  */
 export declare class DIVERenderer {
     private _scene;
-    private _camera;
     readonly isDIVERenderer: true;
     private _webgpurenderer;
     private _environment;
     private _initPromise;
     private _settings;
-    constructor(_scene: DIVEScene, _camera: DIVEPerspectiveCamera, settings?: Partial<DIVERendererSettings>);
+    /**
+     * Whose eyes the next frame is drawn through.
+     *
+     * The component, not the bare camera: a camera is reached through the
+     * component that owns it everywhere else, and taking the camera here would
+     * make the renderer the one place holding a handle that cannot be asked for
+     * its layers or resized. `tick` reads `.camera` off it per frame, so a
+     * component that swaps its camera is followed rather than remembered wrongly.
+     *
+     * Settable rather than fixed at construction: cameras are nodes now, so a
+     * caller may want to render through a camera entity or a preview and back
+     * again. Welding one in meant rebuilding the renderer -- and with it the WebGPU
+     * context -- to look somewhere else.
+     */
+    activeCamera: DIVECameraComponent;
+    constructor(_scene: DIVEScene, camera: DIVECameraComponent, settings?: Partial<DIVERendererSettings>);
     get webgpurenderer(): WebGPURenderer;
     get environment(): DIVEEnvironment;
     get canvas(): HTMLCanvasElement;
     get initialized(): boolean;
     initAsync(): Promise<void>;
-    /**
-     * @deprecated Use {@link DIVERenderer.tick} instead.
-     */
-    render(): void;
     tick(): void;
     onResize(width: number, height: number): void;
     dispose(): void;
     setCanvas(canvas: HTMLCanvasElement): void;
+    /**
+     * Stops a `dispose` from ending the canvas's WebGL context.
+     *
+     * `WebGLBackend.dispose()` finishes with `WEBGL_lose_context.loseContext()`,
+     * which kills the context of the *canvas*, not of the renderer. A canvas is
+     * only ever given one context per type, so once it is lost
+     * `getContext('webgl2')` keeps handing back the dead one -- and the next
+     * renderer on it reads `getParameter(VIEWPORT)`, gets `null`, and throws. That
+     * made a canvas unusable after the first teardown, which is not something DIVE
+     * may do to an element a caller passed in and still has in their document.
+     *
+     * Skipping it is only safe because {@link DIVEScene.dispose} releases the GPU
+     * resources itself, through the `dispose` listeners three puts on every
+     * geometry, material and texture -- and `DIVE.disposeAsync` runs it before the
+     * views, while this renderer is still there to hear it.
+     *
+     * `WebGLExtensions.get` returns whatever its cache holds unless that is
+     * `undefined`, so seeding the entry with `null` makes the lookup in `dispose`
+     * come up empty. Everything else `dispose` does still runs.
+     *
+     * Warns rather than throws if three's internals have moved: the canvas is then
+     * lost again, which is bad, but not worth failing a teardown over.
+     *
+     * @param renderer - The renderer about to be disposed.
+     */
+    private _keepCanvasUsable;
     private _createWebGPURenderer;
 }

package/build/engine/scene/Scene.d.ts

@@ -1,6 +1,8 @@
 import { Scene, Box3, ColorRepresentation } from 'three/webgpu';
-import { DIVERoot } from '../../components/root/Root.ts';
-import { DIVEGrid } from '../../components/grid/Grid.ts';
+import { DIVERoot } from './root/Root.ts';
+import { GridComponent } from '../../components/grid/GridComponent.ts';
+import { DIVEComponent } from '../component/Component.ts';
+import { DIVETicker } from '../clock/Clock.ts';
 export type DIVESceneSettings = {
     /**
      * Whether to add a floor to the scene.
@@ -41,15 +43,97 @@ export declare const DIVESceneDefaultSettings: Required<DIVESceneSettings>;
  *
  * @module
  */
-export declare class DIVEScene extends Scene {
+/**
+ * A basic scene class.
+ *
+ * Comes with a root object that contains all the scene objects, and drives the
+ * per-frame tick of every component attached anywhere below it.
+ */
+export declare class DIVEScene extends Scene implements DIVETicker {
     readonly isDIVEScene: true;
     private _settings;
     private _root;
     private _grid;
+    /**
+     * Components that asked for a per-frame callback.
+     *
+     * Flat and enrolment-based: nothing walks the scene tree per frame, and
+     * components without a `tick` never appear here at all. Nodes enrol and
+     * withdraw their components as they enter and leave the tree, so the only
+     * per-frame cost is iterating this array.
+     */
+    private _tickingComponents;
+    /** Set while `tick` is iterating, so mutations are deferred. */
+    private _isTicking;
+    /**
+     * What was withdrawn while `tick` was iterating.
+     *
+     * Splicing under the loop would shift the indices, so a withdrawal that
+     * arrives mid-frame is recorded and applied afterwards. Recorded by identity,
+     * not derived from `tick`/`tickEnabled` state: a component that is removed
+     * from its node still has both, so a state-based compaction kept it enrolled
+     * and it went on ticking with no owner -- and, after a move, in two scenes.
+     */
+    private _withdrawn;
     constructor(settings?: Partial<DIVESceneSettings>);
     get root(): DIVERoot;
-    get grid(): DIVEGrid;
+    /**
+     * The grid, built on first use.
+     *
+     * Lazy because a scene without one should not pay for the plane, the shader
+     * material and its uniforms.
+     */
+    get grid(): GridComponent;
+    /**
+     * Puts the grid on its own node in the scene.
+     *
+     * Its own node, and not the root: the grid is furniture the viewer sees, not
+     * scene content, so it must stay out of everything that walks the root --
+     * bounds, exports, the entity tree.
+     */
+    private _buildGrid;
     setBackground(value: ColorRepresentation): void;
     computeSceneBB(): Box3;
+    /**
+     * Drives every enrolled component once per frame.
+     *
+     * @param deltaTime - Seconds since the previous frame.
+     */
+    tick(deltaTime: number): void;
+    /**
+     * Registers a component for the per-frame tick.
+     *
+     * Called by {@link DIVENode} when a component becomes live; not part of the
+     * component-authoring surface.
+     *
+     * @param component - The component to enrol.
+     * @internal
+     */
+    enlistComponent(component: DIVEComponent): void;
+    /**
+     * Removes a component from the per-frame tick.
+     *
+     * @param component - The component to withdraw.
+     * @internal
+     */
+    withdrawComponent(component: DIVEComponent): void;
+    /**
+     * Gives up everything in the scene, GPU resources included.
+     *
+     * Every component gets its `dispose` called, which is what actually frees
+     * geometries, materials and textures: three hangs a `dispose` listener on each
+     * of those and destroys the GPU object when it fires. Its own
+     * `Renderer.dispose` does not do this -- it only drops its bookkeeping -- so
+     * without this pass the only thing that ever released GPU memory was ending
+     * the canvas's WebGL context, which is not something DIVE may do to a canvas
+     * it was handed.
+     *
+     * Found through the nodes rather than by looking for components in the graph:
+     * a component is not in the graph -- only what it contributed is -- so
+     * `node.components` is the only place they can be reached.
+     *
+     * Collects first and disposes afterwards, because a component is free to
+     * change the tree it sits in while being disposed.
+     */
     dispose(): void;
 }

package/build/engine/scene/root/Root.d.ts

@@ -0,0 +1,29 @@
+import { Box3 } from 'three/webgpu';
+import { FloorComponent } from '../../../components/mesh/floor/FloorComponent.ts';
+import { DIVENode } from '../../node/Node.ts';
+/**
+ * The scene node every entity hangs off, and the owner of the ground plane.
+ *
+ * It holds objects, it does not interpret them: turning entity data into
+ * scene objects is the state plugin's job and lives in its `EngineGateway`.
+ *
+ * @module
+ */
+export declare class DIVERoot extends DIVENode {
+    readonly isDIVERoot: true;
+    /**
+     * The ground plane component.
+     *
+     * Kept as a named accessor because scene settings address the floor
+     * directly, rather than as an entity.
+     */
+    get floor(): FloorComponent;
+    constructor();
+    /**
+     * The world bounding box of everything the scene actually contains.
+     *
+     * Helpers, gizmo handles and the floor are excluded by their layer, so no
+     * per-class exceptions are needed here.
+     */
+    computeSceneBB(): Box3;
+}

package/build/engine/scene/xrroot/XRRoot.d.ts

@@ -1,5 +1,5 @@
 import { Object3D } from 'three/webgpu';
-import { DIVERoot } from '../../../components/root/Root.ts';
+import { DIVERoot } from '../root/Root.ts';
 import { DIVEXRLightRoot } from './xrlightroot/XRLightRoot.ts';
 import { DIVEScene } from '../Scene.ts';
 export declare class DIVEXRRoot extends Object3D {

package/build/engine/view/View.d.ts

@@ -1,10 +1,9 @@
 import { DIVETicker } from '../clock/Clock.ts';
-import { DIVEPerspectiveCamera } from '../camera/PerspectiveCamera.ts';
+import { DIVECameraComponent } from '../../components/camera/CameraComponent.ts';
 import { DIVERenderer, DIVERendererSettings } from '../renderer/Renderer.ts';
 import { DIVEScene } from '../scene/Scene.ts';
 export declare class DIVEView implements DIVETicker {
     private _scene;
-    private _camera;
     private _settings;
     readonly isDIVEView: true;
     readonly uuid: string;
@@ -12,9 +11,21 @@ export declare class DIVEView implements DIVETicker {
     private _renderer;
     private _canvasLifecycleManager;
     private _initPromise;
-    constructor(_scene: DIVEScene, _camera: DIVEPerspectiveCamera, _settings: Partial<DIVERendererSettings>);
+    constructor(_scene: DIVEScene, cameraComponent: DIVECameraComponent, _settings: Partial<DIVERendererSettings>);
     get renderer(): DIVERenderer;
-    get camera(): DIVEPerspectiveCamera;
+    /**
+     * What the view looks through.
+     *
+     * The component and not the camera or its node: everything a consumer needs
+     * hangs off it -- `camera` for three, `owner` for the transform, `onResize` and
+     * `setCameraLayer` for itself -- so there is one way in rather than three.
+     *
+     * Read off the renderer rather than kept here. `DIVERenderer.activeCamera` is
+     * settable, so a second copy would keep reporting the camera the renderer has
+     * already stopped drawing through -- and `onResize` below would resize that
+     * stale one.
+     */
+    get cameraComponent(): DIVECameraComponent;
     get canvas(): HTMLCanvasElement;
     tick(): void;
     initAsync(): Promise<void>;

package/build/helpers/collectAnimations/collectAnimations.d.ts

@@ -0,0 +1,23 @@
+import { AnimationClip, Object3D } from 'three/webgpu';
+/**
+ * Gathers every animation clip below a root, bound to the objects it animates.
+ *
+ * Both exporters take a root and its clips separately, and resolve each track
+ * against the subtree they are handed. Clips therefore reach a file only when
+ * they are passed at the top level -- ones sitting on a descendant's
+ * `Object3D.animations`, or held by a component, are invisible to the export.
+ *
+ * Two places are read, because that is where clips end up: `Object3D.animations`,
+ * which the asset loader fills for a plain load, and the `animations` field of a
+ * component, which is where {@link ModelComponent} keeps them. Components are not
+ * part of the graph, so a traversal alone never reaches them. Matched
+ * structurally, so a component added later that carries clips needs no change
+ * here.
+ *
+ * Each clip is bound to the objects of the asset that holds it, which is why this
+ * cannot live in the exporter: only the holder knows which objects its clips
+ * belong to, and by the time a whole scene is handed over, that pairing is gone.
+ *
+ * @param root - The object to collect below.
+ */
+export declare function collectAnimations(root: Object3D): AnimationClip[];

package/build/helpers/computeProductBounds/computeProductBounds.d.ts

@@ -0,0 +1,18 @@
+import { Box3, Matrix4, Object3D } from 'three/webgpu';
+/**
+ * Computes the bounding box of everything in a subtree that counts as real
+ * geometry, as decided by {@link contributesToBounds}.
+ *
+ * Prefer this over `Box3.expandByObject`: that method recurses through the whole
+ * subtree itself and knows nothing about layers, so combining it with a
+ * `traverse` (as the previous call sites did) walks every node once per ancestor
+ * and pulls helper geometry into the result.
+ *
+ * @param object - Root of the subtree to measure.
+ * @param target - Optional box to write into, so callers can avoid allocating.
+ * @param intoFrame - Inverse of the frame to measure in. Omit for world space.
+ * A box is always axis-aligned in the frame it was measured in, so measuring in
+ * an object's own frame is what makes an oriented box possible.
+ * @returns The bounding box; empty when the subtree holds no real geometry.
+ */
+export declare function computeProductBounds(object: Object3D, target?: Box3, intoFrame?: Matrix4): Box3;

package/build/helpers/contributesToBounds/contributesToBounds.d.ts

@@ -0,0 +1,17 @@
+import { Object3D } from 'three/webgpu';
+/**
+ * Decides whether an object's geometry counts as real content.
+ *
+ * This is the single answer to "should this be measured, snapped against or
+ * exported?". It is a plain layer test on purpose: the visibility layers already
+ * encode exactly this distinction -- `PRODUCT` is real geometry, while `UI`
+ * handles, `HELPER` visualisations and the `FLOOR` ground plane are not. Adding
+ * a component or helper therefore never requires touching the call sites, only
+ * picking the right layer.
+ *
+ * Note this deliberately ignores `visible`, matching the previous behaviour:
+ * hiding an object does not shrink the scene bounds.
+ *
+ * @param object - The object to test.
+ */
+export declare function contributesToBounds(object: Object3D): boolean;

package/build/helpers/detachTransformControls/detachTransformControls.d.ts

@@ -0,0 +1,15 @@
+import { Object3D } from 'three/webgpu';
+/**
+ * Release the gizmo if it is currently holding this object.
+ *
+ * Only necessary because the old `TransformControls` are still in use instead
+ * of `DIVEGizmo`: they keep a reference to their target, so removing the
+ * object from the scene without detaching first leaves the gizmo pointing at
+ * something that is no longer there.
+ *
+ * Both shapes are checked because the controls sit under a helper root in
+ * newer three versions and directly in the scene in older ones.
+ *
+ * @param object - The object about to leave the scene.
+ */
+export declare const detachTransformControls: (object: Object3D) => void;

package/build/helpers/disposeComponents/disposeComponents.d.ts

@@ -0,0 +1,20 @@
+import { Object3D } from 'three/webgpu';
+/**
+ * Frees the GPU resources held by every component in a subtree.
+ *
+ * A component's geometries, materials and textures are only released by its own
+ * `dispose`, and nothing else in a teardown does that -- `Renderer.dispose` drops
+ * bookkeeping, and unparenting an object frees nothing at all. So whoever takes
+ * something out of the scene for good has to come through here, or it leaks until
+ * the page goes away.
+ *
+ * Walks the graph rather than a node's `components`, because components are not
+ * in the graph: what the traversal finds is nodes, and each of them is asked for
+ * its components.
+ *
+ * Unparents nothing. Removing an object and freeing what it holds are separate
+ * questions, and a caller that is only moving something must not free it.
+ *
+ * @param object - Root of the subtree to free. Included itself.
+ */
+export declare function disposeComponents(object: Object3D): void;

package/build/helpers/findSceneRecursive/findSceneRecursive.d.ts

@@ -1,9 +1,13 @@
 import { Object3D } from 'three/webgpu';
 import { DIVEScene } from '../../engine/scene/Scene.ts';
 /**
- * Find the scene object of an object.
+ * Find the scene an object belongs to.
+ *
+ * Returns `null` for a detached subtree. Objects are routinely built before
+ * they are added to the scene -- entity prefabs are assembled and only then
+ * handed to the root -- so "no scene yet" is an ordinary state, not an error.
  *
  * @param object - The object to find the scene of.
- * @returns The scene object.
+ * @returns The scene, or `null` when the object is not (yet) in one.
  */
-export declare const findSceneRecursive: (object: Object3D) => DIVEScene;
+export declare const findSceneRecursive: (object: Object3D | null | undefined) => DIVEScene | null;

package/build/helpers/implementsInterface/implementsInterface.d.ts

@@ -1,2 +1,13 @@
 import { Object3D } from 'three/webgpu';
+/**
+ * Checks whether an object carries a capability brand.
+ *
+ * Tests for the value being `true`, not merely for the key being present: a
+ * `readonly isSelectable: false` would otherwise count as implementing the
+ * interface, and `findInterface` would stop its walk at that object and hand it
+ * back as the owner.
+ *
+ * @param object - The object to check.
+ * @param discriminator - The brand property, e.g. `isSelectable`.
+ */
 export declare function implementsInterface<T>(object: Object3D | null | undefined, discriminator: string): object is Object3D & T;

package/build/helpers/index.d.ts

@@ -1,11 +1,16 @@
 export * from './applyMixins/applyMixins.ts';
+export * from './computeProductBounds/computeProductBounds.ts';
+export * from './disposeComponents/disposeComponents.ts';
+export * from './contributesToBounds/contributesToBounds.ts';
+export * from './collectAnimations/collectAnimations.ts';
 export * from './deepClone/deepClone.ts';
+export * from './detachTransformControls/detachTransformControls.ts';
 export * from './findInterface/findInterface.ts';
 export * from './findSceneRecursive/findSceneRecursive.ts';
 export * from './getFileTypeFromUri/getFileTypeFromUri.ts';
 export * from './getObjectDelta/getObjectDelta.ts';
 export * from './implementsInterface/implementsInterface.ts';
-export * from './isFileTypeSupported/isFileTypeSupported.ts';
+export * from './isVisibleInHierarchy/isVisibleInHierarchy.ts';
 export * from './isMimeTypeSupported/isMimeTypeSupported.ts';
 export * from './isFileExtensionSupported/isFileExtensionSupported.ts';
 export * from './isURIFileExtensionSupported/isURIFileExtensionSupported.ts';

package/build/helpers/isVisibleInHierarchy/isVisibleInHierarchy.d.ts

@@ -0,0 +1,12 @@
+import { Object3D } from 'three/webgpu';
+/**
+ * Checks whether an object is visible, taking its ancestors into account.
+ *
+ * `Raycaster` deliberately ignores `visible` — it only tests `layers`. So a ray
+ * still reports a hit on a visible mesh whose parent node was hidden, and any
+ * picking code has to apply the hierarchy rule itself.
+ *
+ * @param object - The object to check.
+ * @returns True when the object and every one of its ancestors are visible.
+ */
+export declare function isVisibleInHierarchy(object: Object3D | null | undefined): boolean;

package/build/index.d.ts

@@ -1,7 +1,6 @@
 export * from './engine/index.ts';
 export * from './constants/index.ts';
 export * from './components/index.ts';
-export * from './engine/index.ts';
 export * from './interfaces/index.ts';
 export * from './helpers/index.ts';
 export * from './error/index.ts';

package/build/plugins/animation/index.mjs

@@ -56,9 +56,10 @@ class l {
    *
    * @example
    * // Animate a single clip (e.g. a single animation) at once.
+   * // The clips belong to the ModelComponent that loaded them, not to the node.
    * const animator = await animationSystem.fromClips(
-   *     model,
-   *     model.animations,
+   *     node,
+   *     node.requireComponent(ModelComponent).animations,
    * );
    * // plays first clip by default
    * animator.play();

package/build/plugins/animation/src/system/AnimationSystem.d.ts

@@ -116,9 +116,10 @@ export declare class AnimationSystem implements DIVETicker {
      *
      * @example
      * // Animate a single clip (e.g. a single animation) at once.
+     * // The clips belong to the ModelComponent that loaded them, not to the node.
      * const animator = await animationSystem.fromClips(
-     *     model,
-     *     model.animations,
+     *     node,
+     *     node.requireComponent(ModelComponent).animations,
      * );
      * // plays first clip by default
      * animator.play();

package/build/plugins/ar/index.cjs

@@ -1 +1 @@
-"use strict";var f=Object.defineProperty;var h=(o,e,r)=>e in o?f(o,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):o[e]=r;var l=(o,e,r)=>h(o,typeof e!="symbol"?e+"":e,r);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("../systeminfo/index.cjs"),A=require("../assetconverter/index.cjs"),O=require("../../chunks/AssetLoader-B1n3KGOu.cjs");require("three/examples/jsm/loaders/DRACOLoader.js");const w=require("../../chunks/AssetExporter-Cdxb04b3.cjs");var m=(o=>(o.AR_DESKTOP_PLATFORM_ERROR="ar-desktop-platform-error",o.AR_QUICK_LOOK_NOT_SAFARI_ERROR="ar-quicklook-not-safari-error",o.AR_QUICK_LOOK_VERSION_MISMATCH_ERROR="ar-quicklook-version-mismatch-error",o.AR_QUICK_LOOK_UNKNOWN_ERROR="ar-quicklook-unknown-error",o))(m||{});class a extends Error{constructor(r,t){super(r);l(this,"type");this.name=this.constructor.name,this.type=t,Object.setPrototypeOf(this,new.target.prototype)}}class R extends a{constructor(){super("AR features are not supported on desktop platforms.","ar-desktop-platform-error")}}class p extends a{constructor(){super("ARQuickLook on iOS is only available in Safari.","ar-quicklook-not-safari-error")}}class d extends a{constructor(e,r){super(`ARQuickLook requires iOS version ${r} or later. Current version: ${e}.`,"ar-quicklook-version-mismatch-error"),this.currentVersion=e,this.requiredVersion=r}}class u extends a{constructor(){super("An unknown ARQuickLook compatibility error occurred.","ar-quicklook-unknown-error")}}const k=12;class S{constructor(){l(this,"converter",new A.AssetConverter(new O.AssetLoader,new w.AssetExporter))}async launch(e,r){if(c.SystemInfo.getBrowser()!==c.EBrowser.SAFARI)return Promise.reject(new p);const t=c.SystemInfo.getIOSVersion();if(t&&t.major<k)return Promise.reject(new d(t.full,k));if(!t)return Promise.reject(new u);if(!c.SystemInfo.getSupportsARQuickLook())return Promise.reject(new u);const n=await this.convertToUSDZ(e,r);return this.launchARQuickLook(n,r)}async convertToUSDZ(e,r){const t=await this.converter.convert(e).to("usdz",{quickLookCompatible:!0,ar:{anchoring:{type:"plane"},planeAnchoring:{alignment:"horizontal"}}}),n=new Blob([t],{type:"model/vnd.usdz+zip"});return URL.createObjectURL(n)}launchARQuickLook(e,r){return new Promise(t=>{(r==null?void 0:r.arScale)==="fixed"&&(e=e.concat("#allowsContentScaling=0"));const n=document.createElement("a");n.innerHTML="<picture></picture>",n.rel="ar",n.href=e,n.download="scene.usdz",t(),n.click()})}}class _{launch(e,r){const t=self.location.toString(),n=document.createElement("a"),s=this._createParams(t,e,r),i=this._createIntent(t,e,s);n.setAttribute("href",i),n.click()}_createParams(e,r,t){const n=new URL(r,e),s=new URLSearchParams(n.search);return s.set("mode","ar_preferred"),this._applyScaleOption(s,t),this._applyPlacementOption(s,t),this._applySoundOption(s,e),this._applyLinkOption(s,e),s}_applyScaleOption(e,r){(r==null?void 0:r.arScale)==="fixed"&&e.set("resizable","false")}_applyPlacementOption(e,r){(r==null?void 0:r.arPlacement)==="vertical"&&e.set("enable_vertical_placement","true")}_applySoundOption(e,r){if(e.has("sound")){const t=new URL(e.get("sound"),r);e.set("sound",t.toString())}}_applyLinkOption(e,r){if(e.has("link")){const t=new URL(e.get("link"),r);e.set("link",t.toString())}}_createIntent(e,r,t){const n=new URL(e),s=new URL(r,e),i="#model-viewer-no-ar-fallback";return n.hash=i,`intent://arvr.google.com/scene-viewer/1.2?${t.toString()+"&file="+s.toString()}#Intent;scheme=https;package=com.google.android.googlequicksearchbox;action=android.intent.action.VIEW;S.browser_fallback_url=${encodeURIComponent(n.toString())};end;`}}class L{async launch(e,r){const t=c.SystemInfo.getSystem();return t===c.ESystem.IOS?new S().launch(e,r):t===c.ESystem.ANDROID?new _().launch(e,r):Promise.reject(new R)}}exports.ARDesktopPlatformError=R;exports.ARError=a;exports.ARQuickLook=S;exports.ARQuickLookNotSafariError=p;exports.ARQuickLookUnknownError=u;exports.ARQuickLookVersionMismatchError=d;exports.ARSystem=L;exports.EARErrorType=m;exports.SceneViewer=_;
+"use strict";var f=Object.defineProperty;var h=(o,e,r)=>e in o?f(o,e,{enumerable:!0,configurable:!0,writable:!0,value:r}):o[e]=r;var l=(o,e,r)=>h(o,typeof e!="symbol"?e+"":e,r);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("../systeminfo/index.cjs"),A=require("../assetconverter/index.cjs"),O=require("../../chunks/AssetLoader-BDDJG9JL.cjs");require("three/examples/jsm/loaders/DRACOLoader.js");const w=require("../../chunks/AssetExporter-CoL-QXkB.cjs");var m=(o=>(o.AR_DESKTOP_PLATFORM_ERROR="ar-desktop-platform-error",o.AR_QUICK_LOOK_NOT_SAFARI_ERROR="ar-quicklook-not-safari-error",o.AR_QUICK_LOOK_VERSION_MISMATCH_ERROR="ar-quicklook-version-mismatch-error",o.AR_QUICK_LOOK_UNKNOWN_ERROR="ar-quicklook-unknown-error",o))(m||{});class a extends Error{constructor(r,t){super(r);l(this,"type");this.name=this.constructor.name,this.type=t,Object.setPrototypeOf(this,new.target.prototype)}}class R extends a{constructor(){super("AR features are not supported on desktop platforms.","ar-desktop-platform-error")}}class p extends a{constructor(){super("ARQuickLook on iOS is only available in Safari.","ar-quicklook-not-safari-error")}}class d extends a{constructor(e,r){super(`ARQuickLook requires iOS version ${r} or later. Current version: ${e}.`,"ar-quicklook-version-mismatch-error"),this.currentVersion=e,this.requiredVersion=r}}class u extends a{constructor(){super("An unknown ARQuickLook compatibility error occurred.","ar-quicklook-unknown-error")}}const k=12;class S{constructor(){l(this,"converter",new A.AssetConverter(new O.AssetLoader,new w.AssetExporter))}async launch(e,r){if(c.SystemInfo.getBrowser()!==c.EBrowser.SAFARI)return Promise.reject(new p);const t=c.SystemInfo.getIOSVersion();if(t&&t.major<k)return Promise.reject(new d(t.full,k));if(!t)return Promise.reject(new u);if(!c.SystemInfo.getSupportsARQuickLook())return Promise.reject(new u);const n=await this.convertToUSDZ(e,r);return this.launchARQuickLook(n,r)}async convertToUSDZ(e,r){const t=await this.converter.convert(e).to("usdz",{quickLookCompatible:!0,ar:{anchoring:{type:"plane"},planeAnchoring:{alignment:"horizontal"}}}),n=new Blob([t],{type:"model/vnd.usdz+zip"});return URL.createObjectURL(n)}launchARQuickLook(e,r){return new Promise(t=>{(r==null?void 0:r.arScale)==="fixed"&&(e=e.concat("#allowsContentScaling=0"));const n=document.createElement("a");n.innerHTML="<picture></picture>",n.rel="ar",n.href=e,n.download="scene.usdz",t(),n.click()})}}class _{launch(e,r){const t=self.location.toString(),n=document.createElement("a"),s=this._createParams(t,e,r),i=this._createIntent(t,e,s);n.setAttribute("href",i),n.click()}_createParams(e,r,t){const n=new URL(r,e),s=new URLSearchParams(n.search);return s.set("mode","ar_preferred"),this._applyScaleOption(s,t),this._applyPlacementOption(s,t),this._applySoundOption(s,e),this._applyLinkOption(s,e),s}_applyScaleOption(e,r){(r==null?void 0:r.arScale)==="fixed"&&e.set("resizable","false")}_applyPlacementOption(e,r){(r==null?void 0:r.arPlacement)==="vertical"&&e.set("enable_vertical_placement","true")}_applySoundOption(e,r){if(e.has("sound")){const t=new URL(e.get("sound"),r);e.set("sound",t.toString())}}_applyLinkOption(e,r){if(e.has("link")){const t=new URL(e.get("link"),r);e.set("link",t.toString())}}_createIntent(e,r,t){const n=new URL(e),s=new URL(r,e),i="#model-viewer-no-ar-fallback";return n.hash=i,`intent://arvr.google.com/scene-viewer/1.2?${t.toString()+"&file="+s.toString()}#Intent;scheme=https;package=com.google.android.googlequicksearchbox;action=android.intent.action.VIEW;S.browser_fallback_url=${encodeURIComponent(n.toString())};end;`}}class L{async launch(e,r){const t=c.SystemInfo.getSystem();return t===c.ESystem.IOS?new S().launch(e,r):t===c.ESystem.ANDROID?new _().launch(e,r):Promise.reject(new R)}}exports.ARDesktopPlatformError=R;exports.ARError=a;exports.ARQuickLook=S;exports.ARQuickLookNotSafariError=p;exports.ARQuickLookUnknownError=u;exports.ARQuickLookVersionMismatchError=d;exports.ARSystem=L;exports.EARErrorType=m;exports.SceneViewer=_;

package/build/plugins/ar/index.mjs

@@ -3,9 +3,9 @@ var R = (o, e, r) => e in o ? p(o, e, { enumerable: !0, configurable: !0, writab
 var l = (o, e, r) => R(o, typeof e != "symbol" ? e + "" : e, r);
 import { SystemInfo as c, EBrowser as d, ESystem as u } from "../systeminfo/index.mjs";
 import { AssetConverter as h } from "../assetconverter/index.mjs";
-import { A as _ } from "../../chunks/AssetLoader-BY5D3Cvc.mjs";
+import { A as _ } from "../../chunks/AssetLoader-kRhuVN4p.mjs";
 import "three/examples/jsm/loaders/DRACOLoader.js";
-import { A as f } from "../../chunks/AssetExporter-DLL_vJae.mjs";
+import { A as f } from "../../chunks/AssetExporter-CD2iuQce.mjs";
 var S = /* @__PURE__ */ ((o) => (o.AR_DESKTOP_PLATFORM_ERROR = "ar-desktop-platform-error", o.AR_QUICK_LOOK_NOT_SAFARI_ERROR = "ar-quicklook-not-safari-error", o.AR_QUICK_LOOK_VERSION_MISMATCH_ERROR = "ar-quicklook-version-mismatch-error", o.AR_QUICK_LOOK_UNKNOWN_ERROR = "ar-quicklook-unknown-error", o))(S || {});
 class a extends Error {
   constructor(r, t) {

package/build/plugins/ar/src/webxr/WebXR.d.ts

@@ -4,6 +4,13 @@ export declare class DIVEWebXR {
     private static _renderer;
     private static _scene;
     private static _controller;
+    /**
+     * Where the camera stood before the session, to be put back afterwards.
+     *
+     * Position and target are the whole transform -- the controller rebuilds the
+     * orientation from them -- and the position belongs to the node the camera
+     * component is attached to, not to the camera.
+     */
     private static _cameraPosition;
     private static _cameraTarget;
     private static _renderCallbackId;

package/build/plugins/assetcache/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../../chunks/AssetCache-MtISiPD2.cjs");exports.AssetCache=e.AssetCache;exports.Chunk=e.Chunk;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../../chunks/AssetCache-DdxevusY.cjs");exports.AssetCache=e.AssetCache;exports.Chunk=e.Chunk;

package/build/plugins/assetcache/index.mjs

@@ -1,4 +1,4 @@
-import { A as e, C } from "../../chunks/AssetCache-DOB996Vk.mjs";
+import { A as e, C } from "../../chunks/AssetCache-MXFCGzZU.mjs";
 export {
   e as AssetCache,
   C as Chunk

package/build/plugins/assetexporter/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../../chunks/AssetExporter-Cdxb04b3.cjs");exports.AssetExporter=e.AssetExporter;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../../chunks/AssetExporter-CoL-QXkB.cjs");exports.AssetExporter=e.AssetExporter;

package/build/plugins/assetexporter/index.mjs

@@ -1,4 +1,4 @@
-import { A as o } from "../../chunks/AssetExporter-DLL_vJae.mjs";
+import { A as o } from "../../chunks/AssetExporter-CD2iuQce.mjs";
 export {
   o as AssetExporter
 };

package/build/plugins/assetexporter/src/AssetExporter.d.ts

@@ -27,8 +27,20 @@ export declare class AssetExporter {
     private _usdzExporter;
     constructor();
     export<T extends FileType>(object: Object3D, type: T, options?: FileTypeToExporterOptions[T]): Promise<ArrayBuffer>;
+    private _exportByType;
     private _exportGlb;
     private _exportGltf;
     private _exportUsdz;
+    /**
+     * Temporarily hides everything drawable that does not count as real geometry.
+     *
+     * Anything carrying a geometry, not just a `Mesh`: a group's link lines and a
+     * bounding box helper are `LineSegments`, and a class-based test left them in
+     * the file. The layer decides, so product lines and points are exported and
+     * helper meshes are not.
+     *
+     * @returns A function that restores the previous visibility.
+     */
+    private _hideNonProductGeometry;
     private _computeNormals;
 }

package/build/plugins/assetloader/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../../chunks/AssetLoader-B1n3KGOu.cjs");exports.AssetLoader=e.AssetLoader;exports.DRACOWorker=e.DRACOWorker;exports.DracoLoader=e.DracoLoader;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../../chunks/AssetLoader-BDDJG9JL.cjs");exports.AssetLoader=e.AssetLoader;exports.DRACOWorker=e.DRACOWorker;exports.DracoLoader=e.DracoLoader;

package/build/plugins/assetloader/index.mjs

@@ -1,5 +1,5 @@
-import { A as o } from "../../chunks/AssetLoader-BY5D3Cvc.mjs";
-import { D as s, a as t } from "../../chunks/AssetLoader-BY5D3Cvc.mjs";
+import { A as o } from "../../chunks/AssetLoader-kRhuVN4p.mjs";
+import { D as s, a as t } from "../../chunks/AssetLoader-kRhuVN4p.mjs";
 export {
   o as AssetLoader,
   s as DRACOWorker,

package/build/plugins/mediacreator/index.cjs

@@ -1 +1 @@
-"use strict";var p=Object.defineProperty;var y=(c,t,e)=>t in c?p(c,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):c[t]=e;var a=(c,t,e)=>y(c,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("three/webgpu"),w=require("../../chunks/PerspectiveCamera-DwQUmkDv.cjs");class b{constructor(t,e,r){a(this,"_renderer");a(this,"_scene");a(this,"_controller");this._renderer=t,this._scene=e,this._controller=r}async generateMedia(t){const{position:e,target:r,resolution:i}=t,{width:o,height:s}=i,h=this._controller.object.position.clone(),d=this._controller.object.quaternion.clone(),l=this._controller.target.clone(),n=this._renderer.canvas.clientWidth||o,g=this._renderer.canvas.clientHeight||s;try{return"onResize"in this._controller.object&&this._controller.object.onResize(o,s),this._controller.object.position.copy(e),this._controller.target.copy(r),this._controller.update(),(await this.drawCanvas(void 0,i)).toDataURL()}finally{this._controller.object.position.copy(h),this._controller.object.quaternion.copy(d),this._controller.target.copy(l),this._controller.update(),"onResize"in this._controller.object&&this._controller.object.onResize(n,g)}}async drawCanvas(t,e){await this._renderer.initAsync();const r=this._renderer.webgpurenderer,i=Math.max(1,(e==null?void 0:e.width)??(t==null?void 0:t.width)??(t==null?void 0:t.clientWidth)??this._renderer.canvas.clientWidth),o=Math.max(1,(e==null?void 0:e.height)??(t==null?void 0:t.height)??(t==null?void 0:t.clientHeight)??this._renderer.canvas.clientHeight),s=new _.RenderTarget(i,o,{colorSpace:_.SRGBColorSpace}),h=r.getRenderTarget(),d=this._controller.object.layers.mask;try{r.setRenderTarget(s),this._controller.object.layers.mask=w.DIVEPerspectiveCamera.LIVE_VIEW_LAYER_MASK,r.render(this._scene,this._controller.object);const l=await r.readRenderTargetPixelsAsync(s,0,0,i,o),n=t??document.createElement("canvas");return n.width=i,n.height=o,this._writePixelsToCanvas(n,l,i,o),n}finally{this._controller.object.layers.mask=d,r.setRenderTarget(h),s.dispose()}}_writePixelsToCanvas(t,e,r,i){const o=t.getContext("2d");if(!o)throw new Error("MediaCreator.drawCanvas: 2D canvas context is not available.");const s=o.createImageData(r,i);s.data.set(new Uint8ClampedArray(Array.from(e))),o.putImageData(s,0,0)}}exports.MediaCreator=b;
+"use strict";var p=Object.defineProperty;var w=(a,e,t)=>e in a?p(a,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):a[e]=t;var h=(a,e,t)=>w(a,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("three/webgpu"),y=require("../../chunks/FileTypes-gD_1MonW.cjs");require("three/examples/jsm/loaders/HDRLoader.js");require("three/tsl");class C{constructor(e,t,r){h(this,"_renderer");h(this,"_scene");h(this,"_controller");this._renderer=e,this._scene=t,this._controller=r}async generateMedia(e){const{position:t,target:r,resolution:i}=e,{width:o,height:s}=i,d=this._controller.object.owner.position.clone(),n=this._controller.target.clone(),g=this._renderer.canvas.clientWidth||o,_=this._renderer.canvas.clientHeight||s;try{return this._controller.object.onResize(o,s),this._controller.object.owner.position.copy(t),this._controller.target.copy(r),this._controller.update(),(await this.drawCanvas(void 0,i)).toDataURL()}finally{this._controller.object.owner.position.copy(d),this._controller.target.copy(n),this._controller.update(),this._controller.object.onResize(g,_)}}async drawCanvas(e,t){await this._renderer.initAsync();const r=this._renderer.webgpurenderer,i=Math.max(1,(t==null?void 0:t.width)??(e==null?void 0:e.width)??(e==null?void 0:e.clientWidth)??this._renderer.canvas.clientWidth),o=Math.max(1,(t==null?void 0:t.height)??(e==null?void 0:e.height)??(e==null?void 0:e.clientHeight)??this._renderer.canvas.clientHeight),s=new l.RenderTarget(i,o,{colorSpace:l.SRGBColorSpace}),d=r.getRenderTarget(),n=this._controller.object.camera,g=n.layers.mask;try{r.setRenderTarget(s),n.layers.mask=y.DIVECameraComponent.LIVE_VIEW_LAYER_MASK,r.render(this._scene,n);const _=await r.readRenderTargetPixelsAsync(s,0,0,i,o),c=e??document.createElement("canvas");return c.width=i,c.height=o,this._writePixelsToCanvas(c,_,i,o),c}finally{n.layers.mask=g,r.setRenderTarget(d),s.dispose()}}_writePixelsToCanvas(e,t,r,i){const o=e.getContext("2d");if(!o)throw new Error("MediaCreator.drawCanvas: 2D canvas context is not available.");const s=o.createImageData(r,i);s.data.set(new Uint8ClampedArray(Array.from(t))),o.putImageData(s,0,0)}}exports.MediaCreator=C;