@pluot/core 0.1.0 → 0.1.1

package/dist-tsc/functional-dom-2d-camera.js

@@ -0,0 +1,178 @@
+// Functional/stateless adaptation of dom-2d-camera.
+//
+// License copied from https://github.com/flekschas/dom-2d-camera/blob/master/LICENSE.md
+//
+// This software is released under the MIT license:
+//
+// Permission is hereby granted, free of charge, to any person obtaining a copy of
+// this software and associated documentation files (the "Software"), to deal in
+// the Software without restriction, including without limitation the rights to
+// use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+// the Software, and to permit persons to whom the Software is furnished to do so,
+// subject to the following conditions:
+//
+// The above copyright notice and this permission notice shall be included in all
+// copies or substantial portions of the Software.
+//
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+// FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+// COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+// IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+// CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+import { mat4, vec2 } from 'gl-matrix';
+// Camera configuration constants (matching dom-2d-camera defaults)
+const isFixed = false;
+const isNdc = true;
+const isPan = true;
+const isPanInverted = [false, true];
+const panSpeed = 1;
+const isRotate = true;
+const rotateSpeed = 1;
+const defaultMouseDownMoveAction = "pan";
+const mouseDownMoveModKey = "alt";
+const isZoom = true;
+const zoomSpeed = 1;
+// Derived settings
+const isPanX = Array.isArray(isPan) ? Boolean(isPan[0]) : Boolean(isPan);
+const isPanY = Array.isArray(isPan) ? Boolean(isPan[1]) : Boolean(isPan);
+const isPanXInverted = Array.isArray(isPanInverted) ? Boolean(isPanInverted[0]) : Boolean(isPanInverted);
+const isPanYInverted = Array.isArray(isPanInverted) ? Boolean(isPanInverted[1]) : Boolean(isPanInverted);
+const isZoomX = Array.isArray(isZoom) ? Boolean(isZoom[0]) : Boolean(isZoom);
+const isZoomY = Array.isArray(isZoom) ? Boolean(isZoom[1]) : Boolean(isZoom);
+const panOnMouseDownMove = defaultMouseDownMoveAction === "pan";
+const KEY_MAP = {
+    alt: "altKey",
+    cmd: "metaKey",
+    ctrl: "ctrlKey",
+    meta: "metaKey",
+    shift: "shiftKey",
+};
+// --- Aspect ratio helpers ---
+function computeAspectRatioFactors(vp) {
+    const aspectRatio = vp.width / vp.height;
+    let xFactor = 1.0;
+    let yFactor = 1.0;
+    if (vp.aspectRatioMode === "Contain") {
+        if (aspectRatio > 1.0)
+            xFactor = 1.0 / aspectRatio;
+        else if (aspectRatio < 1.0)
+            yFactor = aspectRatio;
+    }
+    else if (vp.aspectRatioMode === "Cover") {
+        if (aspectRatio > 1.0)
+            yFactor = aspectRatio;
+        else if (aspectRatio < 1.0)
+            xFactor = 1.0 / aspectRatio;
+    }
+    let xAlignTranslation = 0.0;
+    let yAlignTranslation = 0.0;
+    if (vp.aspectRatioAlignmentMode === "Start") {
+        xAlignTranslation = xFactor - 1.0;
+        yAlignTranslation = yFactor - 1.0;
+    }
+    else if (vp.aspectRatioAlignmentMode === "End") {
+        xAlignTranslation = 1.0 - xFactor;
+        yAlignTranslation = 1.0 - yFactor;
+    }
+    return { xFactor, yFactor, xAlignTranslation, yAlignTranslation };
+}
+// --- Event handlers ---
+export function onWheel(viewportParams, prevCameraMatrix, event) {
+    event.preventDefault();
+    if ((!isZoomX && !isZoomY) || isFixed)
+        return prevCameraMatrix;
+    const { width: plotWidth, height: plotHeight, margins } = viewportParams;
+    const width = plotWidth - ((margins?.marginLeft ?? 0) + (margins?.marginRight ?? 0));
+    const height = plotHeight - ((margins?.marginBottom ?? 0) + (margins?.marginTop ?? 0));
+    const { xFactor, yFactor, xAlignTranslation, yAlignTranslation } = computeAspectRatioFactors(viewportParams);
+    const deltaModeScale = event.deltaMode === 1 ? 12 : 1;
+    const scrollDist = deltaModeScale * (event.deltaY || event.deltaX || 0);
+    if (!scrollDist)
+        return prevCameraMatrix;
+    const dZ = zoomSpeed * Math.exp(scrollDist / height);
+    const px = isNdc
+        ? ((-1 + (event.offsetX / width) * 2) - xAlignTranslation) * (1.0 / xFactor)
+        : event.offsetX;
+    const py = isNdc
+        ? ((1 - (event.offsetY / height) * 2) - yAlignTranslation) * (1.0 / yFactor)
+        : event.offsetY;
+    let dx = isZoomX ? 1 / dZ : 1;
+    let dy = isZoomY ? 1 / dZ : 1;
+    if (dx <= 0 || dy <= 0 || (dx === 1 && dy === 1))
+        return prevCameraMatrix;
+    const view = mat4.clone(prevCameraMatrix);
+    const s = mat4.fromScaling(mat4.create(), new Float32Array([dx, dy, 1]));
+    const p = new Float32Array([px, py, 0]);
+    const a = mat4.fromTranslation(mat4.create(), p);
+    const aInv = mat4.invert(mat4.create(), a);
+    // view = a * s * aInv * prevCameraMatrix  (scale about mouse pivot)
+    mat4.multiply(view, aInv, view);
+    mat4.multiply(view, s, view);
+    mat4.multiply(view, a, view);
+    return view;
+}
+export function onMouseMove(viewportParams, prevCameraMatrix, event) {
+    const { width: plotWidth, height: plotHeight, margins } = viewportParams;
+    const width = plotWidth - ((margins?.marginLeft ?? 0) + (margins?.marginRight ?? 0));
+    const height = plotHeight - ((margins?.marginBottom ?? 0) + (margins?.marginTop ?? 0));
+    const { xFactor, yFactor } = computeAspectRatioFactors(viewportParams);
+    const isLeftMousePressed = (event.buttons & 1) !== 0;
+    const isMouseDownMoveModActive = Boolean(event[KEY_MAP[mouseDownMoveModKey]]);
+    const view = mat4.clone(prevCameraMatrix);
+    let changed = false;
+    // Pan
+    if ((isPanX || isPanY) &&
+        isLeftMousePressed &&
+        ((panOnMouseDownMove && !isMouseDownMoveModActive) ||
+            (!panOnMouseDownMove && isMouseDownMoveModActive))) {
+        const dX = isPanXInverted ? -event.movementX : event.movementX;
+        const dY = isPanYInverted ? -event.movementY : event.movementY;
+        const tx = isPanX ? (isNdc ? ((panSpeed * dX) / width) * 2 * (1.0 / xFactor) : panSpeed * dX) : 0;
+        const ty = isPanY ? (isNdc ? ((panSpeed * dY) / height) * 2 * (1.0 / yFactor) : -(panSpeed * dY)) : 0;
+        if (tx !== 0 || ty !== 0) {
+            const t = mat4.fromTranslation(mat4.create(), new Float32Array([tx, ty, 0]));
+            mat4.multiply(view, t, view);
+            changed = true;
+        }
+    }
+    // Rotate
+    if (isRotate &&
+        isLeftMousePressed &&
+        ((panOnMouseDownMove && isMouseDownMoveModActive) ||
+            (!panOnMouseDownMove && !isMouseDownMoveModActive)) &&
+        (Math.abs(event.movementX) + Math.abs(event.movementY)) > 0) {
+        const wh = width / 2;
+        const hh = height / 2;
+        const x1 = (event.offsetX - event.movementX) - wh;
+        const y1 = hh - (event.offsetY - event.movementY);
+        const x2 = event.offsetX - wh;
+        const y2 = hh - event.offsetY;
+        if (x1 * x1 + y1 * y1 > 0 && x2 * x2 + y2 * y2 > 0) {
+            const radians = vec2.angle([x1, y1], [x2, y2]);
+            const cross = x1 * y2 - x2 * y1;
+            const rad = rotateSpeed * radians * Math.sign(cross);
+            if (rad !== 0) {
+                const r = mat4.fromRotation(mat4.create(), rad, new Float32Array([0, 0, 1]));
+                mat4.multiply(view, r, view);
+                changed = true;
+            }
+        }
+    }
+    return changed ? view : prevCameraMatrix;
+}
+// These handlers don't modify the camera matrix in the functional approach.
+// Button state is read from event.buttons in onMouseMove; modifier key state
+// is read from event.altKey/etc. in onMouseMove.
+export function onMouseDown(_viewportParams, prevCameraMatrix, _event) {
+    return prevCameraMatrix;
+}
+export function onMouseUp(_viewportParams, prevCameraMatrix, _event) {
+    return prevCameraMatrix;
+}
+export function onKeyDown(_viewportParams, prevCameraMatrix, _event) {
+    return prevCameraMatrix;
+}
+export function onKeyUp(_viewportParams, prevCameraMatrix, _event) {
+    return prevCameraMatrix;
+}

package/dist-tsc/index.d.ts

@@ -1,6 +1,6 @@
 export { initialize, getIsWasmReady, render_wasm, pick_wasm, setStore, setStoreByName, getStore, } from './core.js';
-export { default as create2dCamera } from "./dom-2d-camera.js";
-export { default as create3dCamera } from "./3d-view-controls.js";
 export { checkWebGpuFeatureDetection } from './feature-detection.js';
 export { getBounds, getCameraMatrixFromBounds } from './viewport.js';
+export { onMouseMove as onMouseMove2d, onWheel as onWheel2d } from './functional-dom-2d-camera.js';
+export { onMouseMove as onMouseMove3d, onWheel as onWheel3d } from './functional-3d-view-controls.js';
 //# sourceMappingURL=index.d.ts.map

package/dist-tsc/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,SAAS,EACT,QAAQ,EACR,cAAc,EACd,QAAQ,GACT,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,cAAc,EACd,WAAW,EACX,SAAS,EACT,QAAQ,EACR,cAAc,EACd,QAAQ,GACT,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,WAAW,IAAI,aAAa,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACnG,OAAO,EAAE,WAAW,IAAI,aAAa,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,kCAAkC,CAAC"}

package/dist-tsc/index.js

@@ -1,5 +1,5 @@
 export { initialize, getIsWasmReady, render_wasm, pick_wasm, setStore, setStoreByName, getStore, } from './core.js';
-export { default as create2dCamera } from "./dom-2d-camera.js";
-export { default as create3dCamera } from "./3d-view-controls.js";
 export { checkWebGpuFeatureDetection } from './feature-detection.js';
 export { getBounds, getCameraMatrixFromBounds } from './viewport.js';
+export { onMouseMove as onMouseMove2d, onWheel as onWheel2d } from './functional-dom-2d-camera.js';
+export { onMouseMove as onMouseMove3d, onWheel as onWheel3d } from './functional-3d-view-controls.js';

package/dist-tsc/lru-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lru-store.d.ts","sourceRoot":"","sources":["../src/lru-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,aAAa,EAAgB,MAAM,SAAS,CAAC;AAavE,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE,CAAC,IAEhD,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAmBhG;AAID,qBAAa,QAAQ,CAAC,CAAC,SAAS,aAAa,CAAE,YAAW,aAAa;;gBASzD,KAAK,EAAE,CAAC,EAAE,OAAO,SAAM;IAW7B,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IA8BzE,OAAO,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS;IAQlF,QAAQ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAmChG,YAAY,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS;IAO/G,UAAU;CAUX;AAED,wBAAgB,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,OAAO,SAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,CAEtF"}
+{"version":3,"file":"lru-store.d.ts","sourceRoot":"","sources":["../src/lru-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAc,aAAa,EAAgB,MAAM,SAAS,CAAC;AAavE,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,EAAE,KAAK,EAAE,CAAC,IAEhD,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAmBhG;AAID,qBAAa,QAAQ,CAAC,CAAC,SAAS,aAAa,CAAE,YAAW,aAAa;;gBAYzD,KAAK,EAAE,CAAC,EAAE,OAAO,SAAM;IAW7B,GAAG,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IA8BzE,OAAO,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS;IAQlF,QAAQ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAmChG,YAAY,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS;IAO/G,UAAU;CAUX;AAED,wBAAgB,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,OAAO,SAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,CAEtF"}

package/dist-tsc/lru-store.js

@@ -40,6 +40,9 @@ export class LruStore {
     #cache;
     // We need a way to synchronously peek at the promise state (a-la Bun's peek or Effect's Deferred.poll).
     // We can probably do something more sophisticated but will try this first.
+    // TODO: should this map be stored on the Rust side instead, so that the peeking can be performed without
+    // the JS function call? Instead, JS would "push" the promise states by calling a Rust function upon any
+    // promise state change, via a new function exposed from Rust such as `wasm.push_promise_state(key, 'fulfilled')`
     #promise_states;
     constructor(store, maxSize = 100) {
         this.#inner_store = store;

package/dist-tsc/unrolled-3d-view-controls.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=unrolled-3d-view-controls.d.ts.map

package/dist-tsc/unrolled-3d-view-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unrolled-3d-view-controls.d.ts","sourceRoot":"","sources":["../src/unrolled-3d-view-controls.js"],"names":[],"mappings":""}