@opsydyn/effect-three-foldkit 0.2.0 → 0.4.0

package/dist/inspector.d.ts

@@ -0,0 +1,24 @@
+/**
+ * An inspector panel for Foldkit views (roadmap, "Beyond parity" 4): the fields the
+ * core's `Inspector.fields` reads from a schema, drawn as a form. Each control reports
+ * an edit as the app's own Message, with the field's path and the new value; the app
+ * applies it with `Inspector.edit`, which the schema checks, and keeps the result (or
+ * shows why it was refused).
+ *
+ * Numbers, text and choices report when they change (on Enter or leaving the field),
+ * colours as they are picked, switches when clicked, and each of a vector's three
+ * numbers on its own. Kinds, absent parts and lists are shown, not edited.
+ *
+ * @module
+ */
+import type { FieldPath, FieldValue, InspectedField } from '@opsydyn/effect-three';
+import type { Html, HtmlBuilder } from 'foldkit/html';
+/** Turns an edit (where, and the new value) into the app's Message. */
+export type OnEdit<Message> = (path: FieldPath, value: FieldValue) => Message;
+/**
+ * The fields as a form: a row each, its name and its control, keyed by path. Style it
+ * with the classes `e3-inspector`, `e3-inspector-row`, `e3-inspector-name`,
+ * `e3-inspector-vector` and `e3-inspector-fixed`.
+ */
+export declare const inspectorView: <Message>(h: HtmlBuilder<Message>, fields: ReadonlyArray<InspectedField>, onEdit: OnEdit<Message>) => Html;
+//# sourceMappingURL=inspector.d.ts.map

package/dist/inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../src/inspector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEtD,uEAAuE;AACvE,MAAM,MAAM,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;AA2E9E;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,KAChC,WAAW,CAAC,OAAO,CAAC,UACf,aAAa,CAAC,cAAc,CAAC,UAC7B,MAAM,CAAC,OAAO,CAAC,KACtB,IAUA,CAAC"}

package/dist/measuringTape.d.ts

@@ -0,0 +1,76 @@
+/**
+ * A measuring tape as a Foldkit submodel (roadmap, "Beyond parity" 5): the core's pure
+ * `tape` with Messages for clicks and pointer moves on the scene, an OutMessage when a
+ * length is measured, and its length as HTML at the tape's middle. The parent decides
+ * when the tape is in use and which clicks are on the scene:
+ *
+ * - `Placed` (a click on the scene, with the point it hit) places an end, or starts a
+ *   new tape; placing the second reports `Measured { from, to, length }`;
+ * - `Pointed` (the pointer moving over the scene, or `null` off it) runs the tape to
+ *   the pointer while the second end is placed;
+ * - `Cleared` empties it; `ChoseSnap` rounds new ends to a step, or not.
+ *
+ * `nodes(model)` draws it for the scene and `label(model, h)` is the length for the
+ * view's `overlays`.
+ *
+ * @module
+ */
+import { type SceneNode, type TapeLook } from '@opsydyn/effect-three';
+import { Option, Schema } from 'effect';
+import type { HtmlBuilder } from 'foldkit/html';
+import type { ReturnWithOutMessage } from 'foldkit/update';
+import type { OverlayView } from './overlayView.ts';
+export declare const Model: Schema.Struct<{
+    /** The key its nodes and label are drawn under. */
+    readonly key: Schema.String;
+    readonly tape: Schema.Struct<{
+        readonly from: Schema.NullOr<Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>>;
+        readonly to: Schema.NullOr<Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>>;
+        readonly pointer: Schema.NullOr<Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>>;
+        readonly snap: Schema.NullOr<Schema.Finite>;
+    }>;
+}>;
+export type Model = typeof Model.Type;
+export declare const Message: import("foldkit/message").MessageUnion<{
+    readonly Placed: {
+        point: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+    };
+    readonly Pointed: {
+        point: Schema.NullOr<Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>>;
+    };
+    readonly Cleared: {};
+    readonly ChoseSnap: {
+        snap: Schema.NullOr<Schema.Finite>;
+    };
+}>;
+export type Message = typeof Message.Type;
+export declare const OutMessage: import("foldkit/message").MessageUnion<{
+    /** Both ends are placed: where, and how far apart. */
+    readonly Measured: {
+        from: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        to: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        length: Schema.Finite;
+    };
+}>;
+export type OutMessage = typeof OutMessage.Type;
+/** An empty tape drawn under `key`, snapping to `snap` when given. */
+export declare const init: (key: string, options?: {
+    readonly snap?: number | null;
+}) => Model;
+type Return = ReturnWithOutMessage<Model, Message, OutMessage>;
+export declare const update: (model: Model, message: Message) => Return;
+/** The tape's length, while it has one (to the pointer while the second end is placed). */
+export declare const length: (model: Model) => Option.Option<number>;
+/** The tape, for the parent's scene. */
+export declare const nodes: (model: Model, look?: Partial<TapeLook>) => SceneNode;
+/**
+ * The length at the tape's middle, for the view's `overlays`: two decimals and `unit`
+ * (`m` unless given), in an element with the class `className` (unstyled unless given).
+ * Pointer events pass through it to the scene.
+ */
+export declare const label: <Message>(model: Model, h: HtmlBuilder<Message>, options?: {
+    readonly unit?: string;
+    readonly className?: string;
+}) => ReadonlyArray<OverlayView>;
+export {};
+//# sourceMappingURL=measuringTape.d.ts.map

package/dist/measuringTape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measuringTape.d.ts","sourceRoot":"","sources":["../src/measuringTape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAML,KAAK,SAAS,EAGd,KAAK,QAAQ,EAGd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,eAAO,MAAM,KAAK;IAChB,mDAAmD;;;;;;;;EAGnD,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAC;AAEtC,eAAO,MAAM,OAAO;;QACR,KAAK;;;QACJ,KAAK;;;;QAEH,IAAI;;EACjB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAC;AAE1C,eAAO,MAAM,UAAU;IACrB,sDAAsD;;QAC1C,IAAI;QAAoB,EAAE;QAAoB,MAAM;;EAChE,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AAEhD,sEAAsE;AACtE,eAAO,MAAM,IAAI,QAAS,MAAM,YAAW;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,KAAQ,KAGlF,CAAC;AAEH,KAAK,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAe/D,eAAO,MAAM,MAAM,UAAW,KAAK,WAAW,OAAO,KAAG,MAMpD,CAAC;AAEL,2FAA2F;AAC3F,eAAO,MAAM,MAAM,UAAW,KAAK,KAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CACZ,CAAC;AAE/C,wCAAwC;AACxC,eAAO,MAAM,KAAK,UAAW,KAAK,SAAQ,OAAO,CAAC,QAAQ,CAAC,KAAQ,SAC3B,CAAC;AASzC;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,OAAO,SACpB,KAAK,KACT,WAAW,CAAC,OAAO,CAAC,YACd;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,KAC/D,aAAa,CAAC,WAAW,CAYxB,CAAC"}

package/dist/pivotControls.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Pivot controls as a Foldkit submodel (roadmap, "Beyond parity" 5): the core's pure
+ * `pivotNodes`, `pressPivot` and `dragPivot` (after Drei's `PivotControls`) with
+ * Messages for the scene's pointer events and OutMessages for what the parent does with
+ * them, as `TransformGizmo` is for three's controls. The parent owns where its objects
+ * are; the submodel owns only the handles:
+ *
+ * - `Pressed` (a pointer down on one of its handles, with the point it hit and the
+ *   object's placement) takes hold;
+ * - `Dragged` reports `Moved { placement }` for the parent to apply (`snap` rounds turns
+ *   to ten degrees and scales to tenths, as Drei's shift does);
+ * - `Released` lets go and reports `Finished { placement }`, a step for history;
+ * - `Hovered` highlights a handle.
+ *
+ * `handleOf(model, key)` says whether a hit is on a handle, and `nodes(model, placement)`
+ * draws them.
+ *
+ * @module
+ */
+import { pivot, type PivotHandle, type Placement, type SceneNode } from '@opsydyn/effect-three';
+import { Option, Schema } from 'effect';
+import type { ReturnWithOutMessage } from 'foldkit/update';
+export declare const Model: Schema.Struct<{
+    /** The key its handles are drawn under: `${key}:arrow-x`, `${key}:slider-z` and so on. */
+    readonly key: Schema.String;
+    readonly pivot: Schema.Struct<{
+        readonly scale: Schema.Finite;
+        readonly depthTest: Schema.Boolean;
+        readonly disableAxes: Schema.Boolean;
+        readonly disableSliders: Schema.Boolean;
+        readonly disableRotations: Schema.Boolean;
+        readonly disableScaling: Schema.Boolean;
+        readonly hovered: Schema.NullOr<Schema.Literals<("arrow-x" | "arrow-y" | "arrow-z" | "rotator-x" | "rotator-y" | "rotator-z" | "slider-x" | "slider-y" | "slider-z" | "sphere-x" | "sphere-y" | "sphere-z")[]>>;
+        readonly grab: Schema.NullOr<Schema.Struct<{
+            readonly handle: Schema.Literals<("arrow-x" | "arrow-y" | "arrow-z" | "rotator-x" | "rotator-y" | "rotator-z" | "slider-x" | "slider-y" | "slider-z" | "sphere-x" | "sphere-y" | "sphere-z")[]>;
+            readonly start: Schema.Struct<{
+                readonly position: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+                readonly rotation: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+                readonly scale: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            }>;
+            readonly point: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly e1: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly e2: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly normal: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        }>>;
+    }>;
+    /** The placement the drag last reported, so `Released` can report where it ended. */
+    readonly last: Schema.Option<Schema.Struct<{
+        readonly position: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        readonly rotation: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        readonly scale: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+    }>>;
+}>;
+export type Model = typeof Model.Type;
+export declare const Message: import("foldkit/message").MessageUnion<{
+    readonly Pressed: {
+        handle: Schema.Literals<("arrow-x" | "arrow-y" | "arrow-z" | "rotator-x" | "rotator-y" | "rotator-z" | "slider-x" | "slider-y" | "slider-z" | "sphere-x" | "sphere-y" | "sphere-z")[]>;
+        point: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        placement: Schema.Struct<{
+            readonly position: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly rotation: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly scale: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        }>;
+    };
+    readonly Dragged: {
+        origin: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        direction: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        snap: Schema.Boolean;
+    };
+    readonly Released: {};
+    readonly Hovered: {
+        handle: Schema.NullOr<Schema.Literals<("arrow-x" | "arrow-y" | "arrow-z" | "rotator-x" | "rotator-y" | "rotator-z" | "slider-x" | "slider-y" | "slider-z" | "sphere-x" | "sphere-y" | "sphere-z")[]>>;
+    };
+}>;
+export type Message = typeof Message.Type;
+export declare const OutMessage: import("foldkit/message").MessageUnion<{
+    /** The object's placement now, during a drag. */
+    readonly Moved: {
+        placement: Schema.Struct<{
+            readonly position: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly rotation: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly scale: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        }>;
+    };
+    /** The drag is over, the object here: a step for history. */
+    readonly Finished: {
+        placement: Schema.Struct<{
+            readonly position: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly rotation: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly scale: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        }>;
+    };
+}>;
+export type OutMessage = typeof OutMessage.Type;
+/** Pivot controls drawn under `key`, with Drei's defaults or the options given. */
+export declare const init: (key: string, options?: Parameters<typeof pivot>[0]) => Model;
+type Return = ReturnWithOutMessage<Model, Message, OutMessage>;
+export declare const update: (model: Model, message: Message) => Return;
+/** Whether a hit `key` is one of these controls' handles, and which. */
+export declare const handleOf: (model: Model, key: string) => Option.Option<PivotHandle>;
+/** Whether a handle is held: the parent leaves the camera alone while it is. */
+export declare const held: (model: Model) => boolean;
+/** The handles for `placement`, for the parent's scene. */
+export declare const nodes: (model: Model, placement: Placement) => SceneNode;
+export {};
+//# sourceMappingURL=pivotControls.d.ts.map

package/dist/pivotControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pivotControls.d.ts","sourceRoot":"","sources":["../src/pivotControls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAIL,KAAK,EACL,KAAK,WAAW,EAGhB,KAAK,SAAS,EAId,KAAK,SAAS,EAEf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,eAAO,MAAM,KAAK;IAChB,0FAA0F;;;;;;;;;;;;;;;;;;;;;;;IAG1F,qFAAqF;;;;;;EAErF,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAC;AAItC,eAAO,MAAM,OAAO;;QACP,MAAM;QAAU,KAAK;QAAoB,SAAS;;;;;;;QAClD,MAAM;QAAoB,SAAS;QAAoB,IAAI;;;;QAE3D,MAAM;;EACjB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAC;AAE1C,eAAO,MAAM,UAAU;IACrB,iDAAiD;;QACxC,SAAS;;;;;;IAClB,6DAA6D;;QACjD,SAAS;;;;;;EACrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AAEhD,mFAAmF;AACnF,eAAO,MAAM,IAAI,QAAS,MAAM,YAAW,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAAQ,KAI5E,CAAC;AAEH,KAAK,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAuB/D,eAAO,MAAM,MAAM,UAAW,KAAK,WAAW,OAAO,KAAG,MAWpD,CAAC;AAEL,wEAAwE;AACxE,eAAO,MAAM,QAAQ,UAAW,KAAK,OAAO,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CACzB,CAAC;AAEtD,gFAAgF;AAChF,eAAO,MAAM,IAAI,UAAW,KAAK,KAAG,OAAoC,CAAC;AAEzE,2DAA2D;AAC3D,eAAO,MAAM,KAAK,UAAW,KAAK,aAAa,SAAS,KAAG,SACZ,CAAC"}

package/dist/transformGizmo.d.ts

@@ -0,0 +1,158 @@
+/**
+ * A transform gizmo as a Foldkit submodel (roadmap, "Beyond parity" 5): the core's pure
+ * gizmo (`gizmoNodes`, `pressGizmo`, `dragGizmo`, after three's `TransformControls`)
+ * with Messages for the scene's pointer events and OutMessages for what the parent does
+ * with them. The parent owns where its objects are; the submodel owns only the gizmo:
+ *
+ * - `Pressed` (a press on one of its handles, with the object's placement and the
+ *   camera) takes hold;
+ * - `Dragged` reports `Moved { placement }` for the parent to apply;
+ * - `Released` lets go and reports `Finished { placement }`, the moment to record a step
+ *   of history;
+ * - `Hovered` highlights a handle; `ChoseMode` and `ChoseSpace` switch them.
+ *
+ * `handleOf(model, key)` says whether a hit is on a handle, and `nodes(model, placement,
+ * camera)` draws them, for the parent's scene and view.
+ *
+ * @module
+ */
+import { type Camera, gizmo, type GizmoHandle, type Placement, type SceneNode } from '@opsydyn/effect-three';
+import { Option, Schema } from 'effect';
+import type { ReturnWithOutMessage } from 'foldkit/update';
+export declare const Model: Schema.Struct<{
+    /** The key its handles are drawn under: `${key}:x`, `${key}:xy` and so on. */
+    readonly key: Schema.String;
+    readonly gizmo: Schema.Struct<{
+        readonly mode: Schema.Literals<readonly ["translate", "rotate", "scale"]>;
+        readonly space: Schema.Literals<readonly ["world", "local"]>;
+        readonly size: Schema.Finite;
+        readonly translationSnap: Schema.NullOr<Schema.Finite>;
+        readonly rotationSnap: Schema.NullOr<Schema.Finite>;
+        readonly scaleSnap: Schema.NullOr<Schema.Finite>;
+        readonly showX: Schema.Boolean;
+        readonly showY: Schema.Boolean;
+        readonly showZ: Schema.Boolean;
+        readonly hovered: Schema.NullOr<Schema.Literals<readonly ["x", "y", "z", "xy", "yz", "xz", "xyz"]>>;
+        readonly grab: Schema.NullOr<Schema.Struct<{
+            readonly handle: Schema.Literals<readonly ["x", "y", "z", "xy", "yz", "xz", "xyz"]>;
+            readonly start: Schema.Struct<{
+                readonly position: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+                readonly rotation: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+                readonly scale: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            }>;
+            readonly from: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly plane: Schema.Struct<{
+                readonly normal: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+                readonly constant: Schema.Finite;
+            }>;
+            readonly eye: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly distance: Schema.Finite;
+        }>>;
+    }>;
+    /** The placement the drag last reported, so `Released` can report where it ended. */
+    readonly last: Schema.Option<Schema.Struct<{
+        readonly position: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        readonly rotation: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        readonly scale: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+    }>>;
+}>;
+export type Model = typeof Model.Type;
+export declare const Message: import("foldkit/message").MessageUnion<{
+    readonly Pressed: {
+        handle: Schema.Literals<readonly ["x", "y", "z", "xy", "yz", "xz", "xyz"]>;
+        origin: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        direction: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        placement: Schema.Struct<{
+            readonly position: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly rotation: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly scale: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        }>;
+        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>;
+        }>]>;
+    };
+    readonly Dragged: {
+        origin: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        direction: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+    };
+    readonly Released: {};
+    readonly Hovered: {
+        handle: Schema.NullOr<Schema.Literals<readonly ["x", "y", "z", "xy", "yz", "xz", "xyz"]>>;
+    };
+    readonly ChoseMode: {
+        mode: Schema.Literals<readonly ["translate", "rotate", "scale"]>;
+    };
+    readonly ChoseSpace: {
+        space: Schema.Literals<readonly ["world", "local"]>;
+    };
+}>;
+export type Message = typeof Message.Type;
+export declare const OutMessage: import("foldkit/message").MessageUnion<{
+    /** The object's placement now, during a drag. */
+    readonly Moved: {
+        placement: Schema.Struct<{
+            readonly position: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly rotation: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly scale: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        }>;
+    };
+    /** The drag is over, the object here: a step for history. */
+    readonly Finished: {
+        placement: Schema.Struct<{
+            readonly position: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly rotation: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+            readonly scale: Schema.Tuple<readonly [Schema.Finite, Schema.Finite, Schema.Finite]>;
+        }>;
+    };
+}>;
+export type OutMessage = typeof OutMessage.Type;
+/** A gizmo drawn under `key`, with the core's defaults or the options given. */
+export declare const init: (key: string, options?: Parameters<typeof gizmo>[0]) => Model;
+type Return = ReturnWithOutMessage<Model, Message, OutMessage>;
+export declare const update: (model: Model, message: Message) => Return;
+/** Whether a hit `key` is one of this gizmo's handles, and which. */
+export declare const handleOf: (model: Model, key: string) => Option.Option<GizmoHandle>;
+/** Whether the gizmo is held: the parent leaves the camera alone while it is. */
+export declare const held: (model: Model) => boolean;
+/** The handles for `placement`, seen from `camera`, for the parent's scene. */
+export declare const nodes: (model: Model, placement: Placement, camera: Camera) => SceneNode;
+export {};
+//# sourceMappingURL=transformGizmo.d.ts.map

package/dist/transformGizmo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformGizmo.d.ts","sourceRoot":"","sources":["../src/transformGizmo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EACL,KAAK,MAAM,EAGX,KAAK,EACL,KAAK,WAAW,EAIhB,KAAK,SAAS,EAId,KAAK,SAAS,EAEf,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE3D,eAAO,MAAM,KAAK;IAChB,8EAA8E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAG9E,qFAAqF;;;;;;EAErF,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAC;AAItC,eAAO,MAAM,OAAO;;QAEhB,MAAM;QACN,MAAM;QACN,SAAS;QACT,SAAS;;;;;QACT,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAEG,MAAM;QAAoB,SAAS;;;;QAEnC,MAAM;;;QACJ,IAAI;;;QACH,KAAK;;EACnB,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAC;AAE1C,eAAO,MAAM,UAAU;IACrB,iDAAiD;;QACxC,SAAS;;;;;;IAClB,6DAA6D;;QACjD,SAAS;;;;;;EACrB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AAEhD,gFAAgF;AAChF,eAAO,MAAM,IAAI,QAAS,MAAM,YAAW,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAAQ,KAI5E,CAAC;AAEH,KAAK,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAuB/D,eAAO,MAAM,MAAM,UAAW,KAAK,WAAW,OAAO,KAAG,MAgBpD,CAAC;AAEL,qEAAqE;AACrE,eAAO,MAAM,QAAQ,UAAW,KAAK,OAAO,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,WAAW,CACzB,CAAC;AAEtD,iFAAiF;AACjF,eAAO,MAAM,IAAI,UAAW,KAAK,KAAG,OAAoC,CAAC;AAEzE,+EAA+E;AAC/E,eAAO,MAAM,KAAK,UAAW,KAAK,aAAa,SAAS,UAAU,MAAM,KAAG,SACpB,CAAC"}

package/dist/view.d.ts

@@ -27,6 +27,8 @@ export type DragDetail = typeof SceneSchema.DragDetail.Type;
  * `orbit` to move a camera kept in the Model.
  */
 export type Gesture = typeof SceneSchema.Gesture.Type;
+/** Detail of the end of a gesture that moved: the press's button, modifiers, mesh and view. */
+export type GestureEndDetail = typeof SceneSchema.GestureEndDetail.Type;
 /** Detail of collision events: the two bodies' keys, and whether they began touching. */
 export type CollisionDetail = typeof SceneSchema.CollisionDetail.Type;
 /** Detail of contact force events: the two bodies, and how hard they pushed. */
@@ -89,6 +91,11 @@ export type ViewConfig<Message> = {
      * the camera stays in the Model.
      */
     readonly onGesture?: (gesture: Gesture) => Message;
+    /**
+     * A gesture that moved has ended (released, or the pointer left): finish what it drew,
+     * such as a `BoxSelect` box. Not after a press that never moved.
+     */
+    readonly onGestureEnd?: (detail: GestureEndDetail) => Message;
     /**
      * A gesture is about to begin on a camera turning by itself (`autoRotate`): keep where
      * it got to with `autoRotated(model.camera, detail)` (a view's camera when `view` names

package/dist/view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../src/view.ts"],"names":[],"mappings":"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"}

package/dist/viewportGizmo.d.ts

@@ -0,0 +1,146 @@
+/**
+ * A viewport gizmo as a Foldkit submodel (roadmap, "Beyond parity" 5), after Drei's
+ * `GizmoHelper` with `GizmoViewport`: the core's `viewportGizmoNodes` in a scene's
+ * `hud`, its heads highlighted under the pointer, and a press on one turning the camera
+ * to look from that axis. The parent owns the camera; the submodel owns the highlight:
+ *
+ * - `Entered` and `Left` (the scene's pointer enter and leave, with the hit key)
+ *   highlight a head, and clear it;
+ * - `Pressed` (a pointer down, with the hit key and the camera) reports
+ *   `Turned { camera }`, the camera looking from that head's axis, for the parent to
+ *   keep. A camera with `damping` eases round to it, as Drei's tween does.
+ *
+ * `hud(model, camera)` is the scene's HUD with the gizmo in it; `nodes` the gizmo alone,
+ * for a HUD with more in it.
+ *
+ * @module
+ */
+import { type Camera, type Hud, type HudAlignment, type SceneNode, type ViewAxis } from '@opsydyn/effect-three';
+import { Option, Schema } from 'effect';
+import type { ReturnWithOutMessage } from 'foldkit/update';
+export declare const Model: Schema.Struct<{
+    /** The key its nodes are drawn under: `${key}:x`, `${key}:-y` and so on. */
+    readonly key: Schema.String;
+    /** The head under the pointer. */
+    readonly hovered: Schema.NullOr<Schema.Literals<readonly ["x", "y", "z", "-x", "-y", "-z"]>>;
+    /** Leaves out the negative heads. */
+    readonly hideNegativeAxes: Schema.Boolean;
+}>;
+export type Model = typeof Model.Type;
+export declare const Message: import("foldkit/message").MessageUnion<{
+    readonly Entered: {
+        key: Schema.String;
+    };
+    readonly Left: {
+        key: Schema.String;
+    };
+    readonly Pressed: {
+        key: Schema.String;
+        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>;
+        }>]>;
+    };
+}>;
+export type Message = typeof Message.Type;
+export declare const OutMessage: import("foldkit/message").MessageUnion<{
+    /** The camera, looking from the axis of the head pressed. */
+    readonly Turned: {
+        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>;
+        }>]>;
+    };
+}>;
+export type OutMessage = typeof OutMessage.Type;
+/** A gizmo drawn under `key`, every head shown unless `hideNegativeAxes`. */
+export declare const init: (key: string, options?: {
+    readonly hideNegativeAxes?: boolean;
+}) => Model;
+type Return = ReturnWithOutMessage<Model, Message, OutMessage>;
+/** Which head a hit `key` is on, if it is one of this gizmo's. */
+export declare const axisOf: (model: Model, key: string) => Option.Option<ViewAxis>;
+export declare const update: (model: Model, message: Message) => Return;
+/** The gizmo for `camera`, for a HUD. */
+export declare const nodes: (model: Model, camera: Camera) => SceneNode;
+/** A HUD holding only the gizmo, 80 pixels in from the bottom right unless placed. */
+export declare const hud: (model: Model, camera: Camera, placement?: {
+    readonly alignment?: HudAlignment;
+    readonly margin?: readonly [number, number];
+}) => Hud;
+export {};
+//# sourceMappingURL=viewportGizmo.d.ts.map

package/dist/viewportGizmo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewportGizmo.d.ts","sourceRoot":"","sources":["../src/viewportGizmo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EACL,KAAK,MAAM,EAGX,KAAK,GAAG,EACR,KAAK,YAAY,EAEjB,KAAK,SAAS,EACd,KAAK,QAAQ,EAGd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAExC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAI3D,eAAO,MAAM,KAAK;IAChB,4EAA4E;;IAE5E,kCAAkC;;IAElC,qCAAqC;;EAErC,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,KAAK,CAAC,IAAI,CAAC;AAEtC,eAAO,MAAM,OAAO;;QACP,GAAG;;;QACN,GAAG;;;QACA,GAAG;QAAiB,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EACrC,CAAC;AACH,MAAM,MAAM,OAAO,GAAG,OAAO,OAAO,CAAC,IAAI,CAAC;AAE1C,eAAO,MAAM,UAAU;IACrB,6DAA6D;;QACnD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAChB,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,IAAI,CAAC;AAEhD,6EAA6E;AAC7E,eAAO,MAAM,IAAI,QACV,MAAM,YACF;IAAE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAE,KAC/C,KAID,CAAC;AAEH,KAAK,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;AAE/D,kEAAkE;AAClE,eAAO,MAAM,MAAM,UAAW,KAAK,OAAO,MAAM,KAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CACnB,CAAC;AAwBvD,eAAO,MAAM,MAAM,UAAW,KAAK,WAAW,OAAO,KAAG,MAKpD,CAAC;AAEL,yCAAyC;AACzC,eAAO,MAAM,KAAK,UAAW,KAAK,UAAU,MAAM,KAAG,SAIjD,CAAC;AAEL,sFAAsF;AACtF,eAAO,MAAM,GAAG,UACP,KAAK,UACJ,MAAM,cACH;IACT,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7C,KACA,GAAsE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opsydyn/effect-three-foldkit",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Thin Foldkit adapter for @opsydyn/effect-three.",
   "license": "MIT",
   "repository": {
@@ -66,7 +66,7 @@
     "typescript": "7.0.2"
   },
   "peerDependencies": {
-    "@opsydyn/effect-three": "0.2.0",
+    "@opsydyn/effect-three": "0.4.0",
     "effect": "^4.0.0",
     "foldkit": "0.167.0",
     "three": ">=0.186.0 <0.187.0"