@opsydyn/effect-three-foldkit 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.4.0](https://github.com/opsydyn/fold-kit-experiments/compare/effect-three-foldkit-v0.3.0...effect-three-foldkit-v0.4.0) (2026-10-20)
+
+### Features
+
+- **effect-three:** a HUD, and the viewport gizmo in it ([a1d99d4](https://github.com/opsydyn/fold-kit-experiments/commit/a1d99d477d80744652237c0718fe0f2418490ea8))
+- **effect-three:** a measuring tape, the last widget of Beyond parity 5 ([0a05ae0](https://github.com/opsydyn/fold-kit-experiments/commit/0a05ae04b0ccfd616f945f26429b27acbe79f108))
+- **effect-three:** a transform gizmo as data, and as a Foldkit submodel ([3b1e585](https://github.com/opsydyn/fold-kit-experiments/commit/3b1e58535b35669917c3325214199f9264fb314c))
+- **effect-three:** an inspector generated from schemas ([64d1d3b](https://github.com/opsydyn/fold-kit-experiments/commit/64d1d3b8bf9991c57c1cf56b94a8b3f1c773b17d))
+- **effect-three:** box select as data, and as a Foldkit submodel ([498a2ec](https://github.com/opsydyn/fold-kit-experiments/commit/498a2ecd7763208c17b54b85f5cc8af294c7ce9b))
+- **effect-three:** edges, trails, points, sparkles and stars ([f976907](https://github.com/opsydyn/fold-kit-experiments/commit/f9769078724c7ef405728581574d50001f338e81))
+- **effect-three:** pivot controls as data, and as a Foldkit submodel ([4284921](https://github.com/opsydyn/fold-kit-experiments/commit/42849211eed2b745c4a43ad42682e2508829901b))
+
+## [0.3.0](https://github.com/opsydyn/fold-kit-experiments/compare/effect-three-foldkit-v0.2.0...effect-three-foldkit-v0.3.0) (2026-10-19)
+
+### Features
+
+- **effect-three:** Drei's Billboard, RoundedBox and Backdrop, Detailed, CameraShake and Clone ([3ec570e](https://github.com/opsydyn/fold-kit-experiments/commit/3ec570e14e7632565adf846ef48b66287713a291))
+
 ## [0.2.0](https://github.com/opsydyn/fold-kit-experiments/compare/effect-three-foldkit-v0.1.0...effect-three-foldkit-v0.2.0) (2026-10-19)
 
 ### ⚠ BREAKING CHANGES
@@ -66,5 +84,4 @@
 ### Bug Fixes
 
 - **effect-three-foldkit:** build the troika package before typechecking tests ([31df93f](https://github.com/opsydyn/fold-kit-experiments/commit/31df93f215dbedf865410e5384a21307ab367404))
-- **effect-three-foldkit:** draw real WebGPU in Linux e2e ([fdf82e7](https://github.com/opsydyn/fold-kit-experiments/commit/fdf82e7815a901d09bea5fbd50769f398eded5c6))
 - **effect-three-foldkit:** draw real WebGPU in Linux e2e ([186db41](https://github.com/opsydyn/fold-kit-experiments/commit/186db41bf649888f31e83c49db5bd4c23facd0e6))

package/README.md

@@ -40,8 +40,9 @@ EffectThreeFoldkit.view(
 
 - **Updates are in place.** Foldkit hands the element a new scene on every render, and the core diffs it, so unchanged scenes cost no host changes and changed ones reuse their three.js objects.
 - **Animation never touches the Model.** Behaviours such as `spin` run in the frame loop, outside Foldkit's `update`.
-- **Events are typed and opt-in:** `onClick`, `onDoubleClick`, `onContextMenu`, `onPointerDown`, `onPointerUp`, `onPointerEnter`, `onPointerMove`, `onPointerLeave`, `onPointerMissed`, `onWheel`, `onDrag`, `onDragEnd`, `onGesture`, `onAutoRotated`, `onCollision`, `onContactForce`, `onMeasured`, `onLabelMeasured`, `onXRSession`, `onXRStick`, `onXRButton`, `onXRSurface`, `onXRMoved`, `onXRPlanes`, `onXRMeshes`, `onPerformanceChange`, `onError` and `onReconciled`. Only the handlers you pass are bound. Hits carry the mesh key (and instance), world-space point, distance, face normal and uv.
+- **Events are typed and opt-in:** `onClick`, `onDoubleClick`, `onContextMenu`, `onPointerDown`, `onPointerUp`, `onPointerEnter`, `onPointerMove`, `onPointerLeave`, `onPointerMissed`, `onWheel`, `onDrag`, `onDragEnd`, `onGesture`, `onGestureEnd`, `onAutoRotated`, `onCollision`, `onContactForce`, `onMeasured`, `onLabelMeasured`, `onXRSession`, `onXRStick`, `onXRButton`, `onXRSurface`, `onXRMoved`, `onXRPlanes`, `onXRMeshes`, `onPerformanceChange`, `onError` and `onReconciled`. Only the handlers you pass are bound. Hits carry the mesh key (and instance), world-space point, distance, face normal and uv.
 - **Controls:** with `scene({ gestures: 'scene' })`, `onGesture` reports drags, the wheel and pinches; `orbit(model.camera, gesture)` moves a camera kept in the Model ([ADR-006](../../docs/effect-three/adr/006-controls-as-data.md)).
+- **Editing widgets as submodels:** `TransformGizmo` (three's `TransformControls`), `PivotControls` (Drei's), `BoxSelect` (three's `SelectionBox`, from shift-drags), `ViewportGizmo` (Drei's `GizmoHelper`, in a scene's `hud`) and `MeasuringTape` each keep a Model, take Messages from the scene's events and report OutMessages (`Moved`, `Finished`, `Selected`, `Turned`, `Measured`) for the parent to apply; `inspectorView` draws the fields `Inspector.fields` reads from a schema as a form. The core keeps the maths pure and checked against three's and Drei's own ([ADR-006](../../docs/effect-three/adr/006-controls-as-data.md)).
 - **HTML overlays:** `overlays: [{ overlay, content }]` places Model-rendered HTML at points in the scene every drawn frame, as Drei's `Html`.
 - **Groups and drags:** hits carry their ancestor `path`, and an `interactive` group makes every mesh inside it pickable. A press on a mesh captures the pointer, so `onDrag` keeps firing off the mesh and off the canvas; pair its `ray` with `pointOnPlane` to drag along a plane.
 - **Pixel ratio:** `makeEnvironment(window, { pixelRatio: [1, 2] })` takes a fixed ratio or a `[min, max]` range around the device's (the default is `[1, 2]`, as React Three Fiber's `dpr`), and re-measures when the device ratio changes.

package/dist/boxSelect.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Box selection as a Foldkit submodel (roadmap, "Beyond parity" 5), after Drei's `Select`
+ * over three.js's `SelectionBox`: a shift-drag that begins on nothing draws a box, and
+ * its release selects what the box holds, through the core's pure `boxSelect`. The parent
+ * owns what is selected; the submodel owns only the box:
+ *
+ * - `Dragged` (each scene `Drag` gesture the box `claims`, made with `dragOf`) starts the box
+ *   where the press was and moves its far corner by the gesture's deltas;
+ * - `Ended` (the scene's `GestureEnd`, with the camera and what can be selected) reports
+ *   `Selected { keys }`, which replaces the selection as Drei's box does, and clears the
+ *   box;
+ * - `Cancelled` clears the box and selects nothing.
+ *
+ * `rectangle(model)` places the box on the canvas in CSS pixels, for an HTML outline, and
+ * `inside(model, camera, selectable)` says what the box holds so far, for highlighting
+ * while it is drawn (Drei selects as the box moves).
+ *
+ * @module
+ */
+import { type Camera, type Gesture } from '@opsydyn/effect-three';
+import { Option, Schema } from 'effect';
+import type { ReturnWithOutMessage } from 'foldkit/update';
+/** Something the box can select: its key, and the point that must fall inside. */
+declare const Selectable: Schema.Struct<{
+    readonly key: Schema.String;
+    readonly at: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+}>;
+/** A box being drawn: its corners in the canvas's normalised coordinates, −1 to 1, y up. */
+export declare const Box: Schema.Struct<{
+    readonly from: Schema.Struct<{
+        readonly x: Schema.Finite;
+        readonly y: Schema.Finite;
+    }>;
+    readonly to: Schema.Struct<{
+        readonly x: Schema.Finite;
+        readonly y: Schema.Finite;
+    }>;
+    readonly width: Schema.Finite;
+    readonly height: Schema.Finite;
+}>;
+export type Box = typeof Box.Type;
+export declare const Model: Schema.Struct<{
+    readonly box: Schema.Option<Schema.Struct<{
+        readonly from: Schema.Struct<{
+            readonly x: Schema.Finite;
+            readonly y: Schema.Finite;
+        }>;
+        readonly to: Schema.Struct<{
+            readonly x: Schema.Finite;
+            readonly y: Schema.Finite;
+        }>;
+        readonly width: Schema.Finite;
+        readonly height: Schema.Finite;
+    }>>;
+}>;
+export type Model = typeof Model.Type;
+export declare const Message: import("foldkit/message").MessageUnion<{
+    readonly Dragged: {
+        x: Schema.Finite;
+        y: Schema.Finite;
+        deltaX: Schema.Finite;
+        deltaY: Schema.Finite;
+        width: Schema.Finite;
+        height: Schema.Finite;
+    };
+    readonly Ended: {
+        camera: Schema.Union<readonly [Schema.TaggedStruct<"Perspective", {
+            readonly fov: Schema.Finite;
+            readonly near: Schema.Finite;
+            readonly far: Schema.Finite;
+            readonly position: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly lookAt: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly damping: Schema.Finite;
+            readonly autoRotate: Schema.Finite;
+            readonly shake: Schema.withDecodingDefaultKey<Schema.NullOr<Schema.Struct<{
+                readonly intensity: Schema.Finite;
+                readonly decay: Schema.Boolean;
+                readonly decayRate: Schema.Finite;
+                readonly maxYaw: Schema.Finite;
+                readonly maxPitch: Schema.Finite;
+                readonly maxRoll: Schema.Finite;
+                readonly yawFrequency: Schema.Finite;
+                readonly pitchFrequency: Schema.Finite;
+                readonly rollFrequency: Schema.Finite;
+                readonly trigger: Schema.Finite;
+            }>>, never>;
+        }>, Schema.TaggedStruct<"Orthographic", {
+            readonly zoom: Schema.Finite;
+            readonly near: Schema.Finite;
+            readonly far: Schema.Finite;
+            readonly position: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly lookAt: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly damping: Schema.Finite;
+            readonly autoRotate: Schema.Finite;
+            readonly shake: Schema.withDecodingDefaultKey<Schema.NullOr<Schema.Struct<{
+                readonly intensity: Schema.Finite;
+                readonly decay: Schema.Boolean;
+                readonly decayRate: Schema.Finite;
+                readonly maxYaw: Schema.Finite;
+                readonly maxPitch: Schema.Finite;
+                readonly maxRoll: Schema.Finite;
+                readonly yawFrequency: Schema.Finite;
+                readonly pitchFrequency: Schema.Finite;
+                readonly rollFrequency: Schema.Finite;
+                readonly trigger: Schema.Finite;
+            }>>, never>;
+        }>]>;
+        selectable: Schema.$Array<Schema.Struct<{
+            readonly key: Schema.String;
+            readonly at: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        }>>;
+    };
+    readonly Cancelled: {};
+}>;
+export type Message = typeof Message.Type;
+export declare const OutMessage: import("foldkit/message").MessageUnion<{
+    /** The box was let go: the keys inside it, for the new selection. */
+    readonly Selected: {
+        keys: Schema.$Array<Schema.String>;
+    };
+}>;
+export type OutMessage = typeof OutMessage.Type;
+/** No box drawn. */
+export declare const init: () => Model;
+type Return = ReturnWithOutMessage<Model, Message, OutMessage>;
+type Selectables = ReadonlyArray<typeof Selectable.Type>;
+export declare const update: (model: Model, message: Message) => Return;
+/** Whether a box is being drawn: the parent leaves the camera alone while it is. */
+export declare const drawing: (model: Model) => boolean;
+/** A scene `Drag` gesture: the only kind a box takes. */
+export type DragGesture = Extract<Gesture, {
+    readonly _tag: 'Drag';
+}>;
+/** Whether the box takes `drag`: every drag while one is drawn, and one that starts it. */
+export declare const claims: (model: Model, drag: DragGesture) => boolean;
+/** The `Dragged` Message for a drag the box claims. */
+export declare const dragOf: (gesture: DragGesture) => Message;
+/** What the box holds so far, seen through `camera`: none while no box is drawn. */
+export declare const inside: (model: Model, camera: Camera, selectable: Selectables) => ReadonlyArray<string>;
+/** A box on the canvas, in CSS pixels from its top left. */
+export type Rectangle = {
+    readonly left: number;
+    readonly top: number;
+    readonly width: number;
+    readonly height: number;
+};
+/** Where the box sits on the canvas, while one is drawn. */
+export declare const rectangle: (model: Model) => Option.Option<Rectangle>;
+export {};
+//# sourceMappingURL=boxSelect.d.ts.map

package/dist/boxSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boxSelect.d.ts","sourceRoot":"","sources":["../src/boxSelect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAa,KAAK,MAAM,EAAE,KAAK,OAAO,EAAe,MAAM,uBAAuB,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAI3D,kFAAkF;AAClF,QAAA,MAAM,UAAU;;;EAA8D,CAAC;AAE/E,4FAA4F;AAC5F,eAAO,MAAM,GAAG;;;;;;;;;;;EAKd,CAAC;AACH,MAAM,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,IAAI,CAAC;AAElC,eAAO,MAAM,KAAK;;;;;;;;;;;;;EAA6C,CAAC;AAChE,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAC;AAEtC,eAAO,MAAM,OAAO;;QAEhB,CAAC;QACD,CAAC;QACD,MAAM;QACN,MAAM;QACN,KAAK;QACL,MAAM;;;QAEC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAAsB,UAAU;;;;;;EAE/C,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAC;AAE1C,eAAO,MAAM,UAAU;IACrB,qEAAqE;;QACzD,IAAI;;EAChB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AAEhD,oBAAoB;AACpB,eAAO,MAAM,IAAI,QAAO,KAAiC,CAAC;AAE1D,KAAK,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAe/D,KAAK,WAAW,GAAG,aAAa,CAAC,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AAczD,eAAO,MAAM,MAAM,UAAW,KAAK,WAAW,OAAO,KAAG,MAKpD,CAAC;AAEL,oFAAoF;AACpF,eAAO,MAAM,OAAO,UAAW,KAAK,KAAG,OAAmC,CAAC;AAE3E,yDAAyD;AACzD,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAStE,2FAA2F;AAC3F,eAAO,MAAM,MAAM,UAAW,KAAK,QAAQ,WAAW,KAAG,OACtB,CAAC;AAEpC,uDAAuD;AACvD,eAAO,MAAM,MAAM,YAAa,WAAW,KAAG,OAQ1C,CAAC;AAEL,oFAAoF;AACpF,eAAO,MAAM,MAAM,UACV,KAAK,UACJ,MAAM,cACF,WAAW,KACtB,aAAa,CAAC,MAAM,CAInB,CAAC;AAEL,4DAA4D;AAC5D,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAUF,4DAA4D;AAC5D,eAAO,MAAM,SAAS,UAAW,KAAK,KAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAC/B,CAAC"}

package/dist/dom/webgl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgl.d.ts","sourceRoot":"","sources":["../../src/dom/webgl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,uBAAuB,CAAC;AAE3F,OAAO,EASL,KAAK,uBAAuB,EAE7B,MAAM,OAAO,CAAC;AAaf,+FAA+F;AAC/F,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;AAyEnE,uGAAuG;AACvG,eAAO,MAAM,oBAAoB,WACvB,iBAAiB,YAChB,YAAY,KACpB,eA0GD,CAAC"}
+{"version":3,"file":"webgl.d.ts","sourceRoot":"","sources":["../../src/dom/webgl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,uBAAuB,CAAC;AAE3F,OAAO,EASL,KAAK,uBAAuB,EAE7B,MAAM,OAAO,CAAC;AAaf,+FAA+F;AAC/F,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC;AAyEnE,uGAAuG;AACvG,eAAO,MAAM,oBAAoB,WACvB,iBAAiB,YAChB,YAAY,KACpB,eAyHD,CAAC"}

package/dist/dom/webgpu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgpu.d.ts","sourceRoot":"","sources":["../../src/dom/webgpu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,uBAAuB,CAAC;AAwB3F,kFAAkF;AAClF,MAAM,MAAM,aAAa,GAAG;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AA+DF,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,WACxB,iBAAiB,YAChB,aAAa,KACrB,eA8FD,CAAC"}
+{"version":3,"file":"webgpu.d.ts","sourceRoot":"","sources":["../../src/dom/webgpu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,uBAAuB,CAAC;AAwB3F,kFAAkF;AAClF,MAAM,MAAM,aAAa,GAAG;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AA+DF,oEAAoE;AACpE,eAAO,MAAM,qBAAqB,WACxB,iBAAiB,YAChB,aAAa,KACrB,eA6GD,CAAC"}

package/dist/element.d.ts

@@ -81,6 +81,18 @@ export declare const sceneElement: CustomElement.CustomElementSpec<"effect-three
             readonly lookAt: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
             readonly damping: Schema.Finite;
             readonly autoRotate: Schema.Finite;
+            readonly shake: Schema.withDecodingDefaultKey<Schema.NullOr<Schema.Struct<{
+                readonly intensity: Schema.Finite;
+                readonly decay: Schema.Boolean;
+                readonly decayRate: Schema.Finite;
+                readonly maxYaw: Schema.Finite;
+                readonly maxPitch: Schema.Finite;
+                readonly maxRoll: Schema.Finite;
+                readonly yawFrequency: Schema.Finite;
+                readonly pitchFrequency: Schema.Finite;
+                readonly rollFrequency: Schema.Finite;
+                readonly trigger: Schema.Finite;
+            }>>, never>;
         }>, Schema.TaggedStruct<"Orthographic", {
             readonly zoom: Schema.Finite;
             readonly near: Schema.Finite;
@@ -89,6 +101,18 @@ export declare const sceneElement: CustomElement.CustomElementSpec<"effect-three
             readonly lookAt: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
             readonly damping: Schema.Finite;
             readonly autoRotate: Schema.Finite;
+            readonly shake: Schema.withDecodingDefaultKey<Schema.NullOr<Schema.Struct<{
+                readonly intensity: Schema.Finite;
+                readonly decay: Schema.Boolean;
+                readonly decayRate: Schema.Finite;
+                readonly maxYaw: Schema.Finite;
+                readonly maxPitch: Schema.Finite;
+                readonly maxRoll: Schema.Finite;
+                readonly yawFrequency: Schema.Finite;
+                readonly pitchFrequency: Schema.Finite;
+                readonly rollFrequency: Schema.Finite;
+                readonly trigger: Schema.Finite;
+            }>>, never>;
         }>]>;
         readonly gestures: Schema.Literals<readonly ["page", "scene"]>;
         readonly views: Schema.$Array<Schema.Struct<{
@@ -101,6 +125,18 @@ export declare const sceneElement: CustomElement.CustomElementSpec<"effect-three
                 readonly lookAt: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
                 readonly damping: Schema.Finite;
                 readonly autoRotate: Schema.Finite;
+                readonly shake: Schema.withDecodingDefaultKey<Schema.NullOr<Schema.Struct<{
+                    readonly intensity: Schema.Finite;
+                    readonly decay: Schema.Boolean;
+                    readonly decayRate: Schema.Finite;
+                    readonly maxYaw: Schema.Finite;
+                    readonly maxPitch: Schema.Finite;
+                    readonly maxRoll: Schema.Finite;
+                    readonly yawFrequency: Schema.Finite;
+                    readonly pitchFrequency: Schema.Finite;
+                    readonly rollFrequency: Schema.Finite;
+                    readonly trigger: Schema.Finite;
+                }>>, never>;
             }>, Schema.TaggedStruct<"Orthographic", {
                 readonly zoom: Schema.Finite;
                 readonly near: Schema.Finite;
@@ -109,6 +145,18 @@ export declare const sceneElement: CustomElement.CustomElementSpec<"effect-three
                 readonly lookAt: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
                 readonly damping: Schema.Finite;
                 readonly autoRotate: Schema.Finite;
+                readonly shake: Schema.withDecodingDefaultKey<Schema.NullOr<Schema.Struct<{
+                    readonly intensity: Schema.Finite;
+                    readonly decay: Schema.Boolean;
+                    readonly decayRate: Schema.Finite;
+                    readonly maxYaw: Schema.Finite;
+                    readonly maxPitch: Schema.Finite;
+                    readonly maxRoll: Schema.Finite;
+                    readonly yawFrequency: Schema.Finite;
+                    readonly pitchFrequency: Schema.Finite;
+                    readonly rollFrequency: Schema.Finite;
+                    readonly trigger: Schema.Finite;
+                }>>, never>;
             }>]>;
             readonly rect: Schema.Struct<{
                 readonly x: Schema.Finite;
@@ -129,6 +177,18 @@ export declare const sceneElement: CustomElement.CustomElementSpec<"effect-three
                 readonly lookAt: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
                 readonly damping: Schema.Finite;
                 readonly autoRotate: Schema.Finite;
+                readonly shake: Schema.withDecodingDefaultKey<Schema.NullOr<Schema.Struct<{
+                    readonly intensity: Schema.Finite;
+                    readonly decay: Schema.Boolean;
+                    readonly decayRate: Schema.Finite;
+                    readonly maxYaw: Schema.Finite;
+                    readonly maxPitch: Schema.Finite;
+                    readonly maxRoll: Schema.Finite;
+                    readonly yawFrequency: Schema.Finite;
+                    readonly pitchFrequency: Schema.Finite;
+                    readonly rollFrequency: Schema.Finite;
+                    readonly trigger: Schema.Finite;
+                }>>, never>;
             }>, Schema.TaggedStruct<"Orthographic", {
                 readonly zoom: Schema.Finite;
                 readonly near: Schema.Finite;
@@ -137,10 +197,27 @@ export declare const sceneElement: CustomElement.CustomElementSpec<"effect-three
                 readonly lookAt: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
                 readonly damping: Schema.Finite;
                 readonly autoRotate: Schema.Finite;
+                readonly shake: Schema.withDecodingDefaultKey<Schema.NullOr<Schema.Struct<{
+                    readonly intensity: Schema.Finite;
+                    readonly decay: Schema.Boolean;
+                    readonly decayRate: Schema.Finite;
+                    readonly maxYaw: Schema.Finite;
+                    readonly maxPitch: Schema.Finite;
+                    readonly maxRoll: Schema.Finite;
+                    readonly yawFrequency: Schema.Finite;
+                    readonly pitchFrequency: Schema.Finite;
+                    readonly rollFrequency: Schema.Finite;
+                    readonly trigger: Schema.Finite;
+                }>>, never>;
             }>]>;
             readonly background: Schema.NullOr<Schema.Int>;
-            readonly children: Schema.$Array<Schema.Codec<import("@opsydyn/effect-three").SceneNode, import("@opsydyn/effect-three").SceneNode, never, never>>;
+            readonly children: Schema.$Array<Schema.Codec<import("@opsydyn/effect-three").SceneNode, unknown, never, never>>;
         }>>;
+        readonly hud: Schema.withDecodingDefaultKey<Schema.NullOr<Schema.Struct<{
+            readonly alignment: Schema.Literals<readonly ["top-left", "top-center", "top-right", "center-left", "center-center", "center-right", "bottom-left", "bottom-center", "bottom-right"]>;
+            readonly margin: Schema.Tuple<readonly [Schema.Finite, Schema.Finite]>;
+            readonly children: Schema.$Array<Schema.Codec<import("@opsydyn/effect-three").SceneNode, unknown, never, never>>;
+        }>>, never>;
         readonly overlays: Schema.$Array<Schema.Struct<{
             readonly key: Schema.String;
             readonly node: Schema.NullOr<Schema.String>;
@@ -325,6 +402,18 @@ export declare const sceneElement: CustomElement.CustomElementSpec<"effect-three
                 }>, Schema.TaggedStruct<"Circle", {
                     readonly radius: Schema.Finite;
                     readonly segments: Schema.Int;
+                }>, Schema.TaggedStruct<"RoundedBox", {
+                    readonly width: Schema.Finite;
+                    readonly height: Schema.Finite;
+                    readonly depth: Schema.Finite;
+                    readonly radius: Schema.Finite;
+                    readonly smoothness: Schema.Int;
+                    readonly bevelSegments: Schema.Int;
+                    readonly steps: Schema.Int;
+                    readonly creaseAngle: Schema.Finite;
+                }>, Schema.TaggedStruct<"Backdrop", {
+                    readonly floor: Schema.Finite;
+                    readonly segments: Schema.Int;
                 }>]>;
             }>>;
             readonly materials: Schema.$Array<Schema.Struct<{
@@ -339,6 +428,7 @@ export declare const sceneElement: CustomElement.CustomElementSpec<"effect-three
                     readonly wireframe: Schema.Boolean;
                     readonly color: Schema.Int;
                     readonly map: Schema.NullOr<Schema.String>;
+                    readonly depthTest: Schema.withDecodingDefaultKey<Schema.Boolean, never>;
                 }>, Schema.TaggedStruct<"Lambert", {
                     readonly opacity: Schema.Finite;
                     readonly transparent: Schema.Boolean;
@@ -396,7 +486,7 @@ export declare const sceneElement: CustomElement.CustomElementSpec<"effect-three
                 }>]>;
             }>>;
         }>;
-        readonly children: Schema.$Array<Schema.Codec<import("@opsydyn/effect-three").SceneNode, import("@opsydyn/effect-three").SceneNode, never, never>>;
+        readonly children: Schema.$Array<Schema.Codec<import("@opsydyn/effect-three").SceneNode, unknown, never, never>>;
     }>;
 }, {
     'scene-click': Schema.Struct<{
@@ -589,6 +679,17 @@ export declare const sceneElement: CustomElement.CustomElementSpec<"effect-three
             readonly deltaY: Schema.Finite;
         }>]>;
     }>;
+    'scene-gesture-end': Schema.Struct<{
+        readonly button: Schema.Int;
+        readonly modifiers: Schema.Struct<{
+            readonly shift: Schema.Boolean;
+            readonly control: Schema.Boolean;
+            readonly meta: Schema.Boolean;
+            readonly alt: Schema.Boolean;
+        }>;
+        readonly key: Schema.optionalKey<Schema.String>;
+        readonly view: Schema.optionalKey<Schema.String>;
+    }>;
     'scene-auto-rotated': Schema.Struct<{
         readonly view: Schema.optionalKey<Schema.String>;
         readonly position: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
@@ -747,6 +848,7 @@ export declare const domEventName: {
     readonly Drag: 'scene-drag';
     readonly DragEnd: 'scene-drag-end';
     readonly Gesture: 'scene-gesture';
+    readonly GestureEnd: 'scene-gesture-end';
     readonly AutoRotated: 'scene-auto-rotated';
     readonly Collision: 'scene-collision';
     readonly ContactForce: 'scene-contact-force';

package/dist/element.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../src/element.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,qFAAqF;AACrF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AAIhD,wEAAwE;AACxE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;EAW3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;AAE5D,oFAAoF;AACpF,eAAO,MAAM,eAAe;;EAE1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;AAE1D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiCvB,CAAC;AAEH,sDAAsD;AACtD,eAAO,MAAM,YAAY;oBAChB,aAAa;0BACP,oBAAoB;0BACpB,oBAAoB;0BACpB,oBAAoB;wBACtB,kBAAkB;2BACf,qBAAqB;0BACtB,oBAAoB;2BACnB,qBAAqB;4BACpB,sBAAsB;oBAC9B,aAAa;mBACd,YAAY;sBACT,gBAAgB;sBAChB,eAAe;0BACX,oBAAoB;wBACtB,iBAAiB;2BACd,qBAAqB;uBACzB,gBAAgB;4BACX,sBAAsB;sBAC5B,gBAAgB;uBACf,iBAAiB;wBAChB,kBAAkB;sBACpB,gBAAgB;uBACf,iBAAiB;uBACjB,iBAAiB;iCACP,mBAAmB;CACwC,CAAC;AAElF,yFAAyF;AACzF,eAAO,MAAM,cAAc;;;QAEV,MAAM;;EACrB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC"}
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../src/element.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,qFAAqF;AACrF,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AAIhD,wEAAwE;AACxE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;EAW3B,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC;AAE5D,oFAAoF;AACpF,eAAO,MAAM,eAAe;;EAE1B,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC;AAE1D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCvB,CAAC;AAEH,sDAAsD;AACtD,eAAO,MAAM,YAAY;oBAChB,aAAa;0BACP,oBAAoB;0BACpB,oBAAoB;0BACpB,oBAAoB;wBACtB,kBAAkB;2BACf,qBAAqB;0BACtB,oBAAoB;2BACnB,qBAAqB;4BACpB,sBAAsB;oBAC9B,aAAa;mBACd,YAAY;sBACT,gBAAgB;sBAChB,eAAe;yBACZ,mBAAmB;0BAClB,oBAAoB;wBACtB,iBAAiB;2BACd,qBAAqB;uBACzB,gBAAgB;4BACX,sBAAsB;sBAC5B,gBAAgB;uBACf,iBAAiB;wBAChB,kBAAkB;sBACpB,gBAAgB;uBACf,iBAAiB;uBACjB,iBAAiB;iCACP,mBAAmB;CACwC,CAAC;AAElF,yFAAyF;AACzF,eAAO,MAAM,cAAc;;;QAEV,MAAM;;EACrB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC"}

package/dist/index.d.ts

@@ -26,7 +26,13 @@ export { type XrMode } from './dom/xrHub.ts';
 export { type XrControls, XrUnavailable } from './xr.ts';
 export { summarise } from './dom/reconciled.ts';
 export { type Environment, type EnvironmentHost, type EnvironmentOptions, makeEnvironment, } from './environment.ts';
+export { inspectorView, type OnEdit } from './inspector.ts';
 export { makeSceneMount, type SceneMount } from './mount.ts';
+export * as BoxSelect from './boxSelect.ts';
+export * as MeasuringTape from './measuringTape.ts';
+export * as PivotControls from './pivotControls.ts';
+export * as TransformGizmo from './transformGizmo.ts';
+export * as ViewportGizmo from './viewportGizmo.ts';
 export { type OverlayView } from './overlayView.ts';
-export { type AutoRotatedDetail, type ButtonDetail, type CollisionDetail, type ContactForceDetail, type DragDetail, type Gesture, type HitDetail, type KeyDetail, type LabelMeasuredDetail, type MeasuredDetail, type MissDetail, type PerformanceDetail, view, type ViewConfig, type WheelDetail, type XrButtonDetail, type XrMeshesDetail, type XrMovedDetail, type XrPlanesDetail, type XrStickDetail, type XrSurfaceDetail, } from './view.ts';
+export { type AutoRotatedDetail, type ButtonDetail, type CollisionDetail, type ContactForceDetail, type DragDetail, type Gesture, type GestureEndDetail, type HitDetail, type KeyDetail, type LabelMeasuredDetail, type MeasuredDetail, type MissDetail, type PerformanceDetail, view, type ViewConfig, type WheelDetail, type XrButtonDetail, type XrMeshesDetail, type XrMovedDetail, type XrPlanesDetail, type XrStickDetail, type XrSurfaceDetail, } from './view.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,cAAc,EAAE,KAAK,MAAM,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,IAAI,EACT,KAAK,EACL,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,KAAK,aAAa,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,IAAI,EACJ,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,cAAc,EAAE,KAAK,MAAM,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,KAAK,IAAI,EACT,KAAK,EACL,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,KAAK,UAAU,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC1F,OAAO,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,KAAK,aAAa,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,KAAK,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAC5C,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,OAAO,KAAK,cAAc,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,aAAa,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,IAAI,EACJ,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC"}