@equinor/videx-3d 3.1.0 → 3.2.0

package/dist/sdk.js

@@ -1,2 +1,2 @@
-import { $ as e, $t as t, A as n, At as r, Bt as i, C as a, Cn as o, Ct as s, D as c, Dn as l, Dt as u, E as d, En as f, Et as p, F as m, Ft as h, Gt as g, H as _, Ht as v, It as y, J as b, Jt as x, Kt as S, Lt as C, M as w, Mt as T, N as E, Nt as D, O, Ot as k, P as A, Pt as j, Q as M, Qt as N, Rt as P, S as F, Sn as I, St as L, T as R, Tn as z, Tt as B, Ut as V, Vt as H, Wt as U, X as W, Xt as G, Y as K, Yt as q, Z as J, Zt as Y, _ as X, _n as Z, _t as Q, an as $, at as ee, b as te, bn as ne, bt as re, c as ie, cn as ae, ct as oe, d as se, dn as ce, dt as le, en as ue, et as de, f as fe, fn as pe, ft as me, g as he, gn as ge, gt as _e, h as ve, hn as ye, ht as be, in as xe, it as Se, j as Ce, jt as we, k as Te, kt as Ee, l as De, ln as Oe, lt as ke, m as Ae, mn as je, mt as Me, n as Ne, nn as Pe, nt as Fe, on as Ie, ot as Le, p as Re, pn as ze, pt as Be, q as Ve, qt as He, rn as Ue, rt as We, s as Ge, sn as Ke, st as qe, t as Je, tn as Ye, tt as Xe, u as Ze, un as Qe, ut as $e, v as et, vn as tt, vt as nt, w as rt, wn as it, wt as at, x as ot, xn as st, xt as ct, y as lt, yn as ut, yt as dt, zt as ft } from "./chunk-DKAquGKk.js";
-export { Ce as CRS, _ as CameraManager, l as DataLoader, B as Delatin, rt as DepthReadMaterial, f as GeneratorRegistry, ae as PI, Oe as PI2, Qe as PI4, ce as PI8, b as PlanarGeometry, K as PlanarLineGeometry, W as PlanarPointGeometry, J as PlanarPolygonGeometry, pe as TAU, Ne as TubeMaterial, ie as Typed2DArray, m as WellboreManager, D as addVec2, j as addVec3, h as angleVec3, y as asVec2, Me as buildMaskedGridPlane, r as calculateFrenetFrames, De as calculateHashValue, I as calculateWellSegments, je as clamp, Q as computePlanarXZUv, X as computeSurfaceNormalsRG, nt as computeUpwardNormals, C as copyVec3, he as createConfig, et as createElevationTexture, ct as createFenceGeometry, dt as createIndexedGeometry, lt as createNormalTexture, Le as createOceanBox, qe as createOceanBoxFromPolygon, oe as createOceanBoxFromSurface, ke as createOceanEllipseBox, $e as createOceanPlane, te as createPackedNormalTexture, p as createTubeGeometries, u as createTubeGeometry, P as crossVec3, R as degreesToRadians, ft as directionVec2, i as directionVec3, H as distanceVec2, v as distanceVec3, V as dotVec2, U as dotVec3, ze as edgeOfRectangle, ot as elevationMapNormalsToRGBA, ut as extractBoundaryLoops, d as feetToMeters, be as floodFillExternalHoles, we as getCurvePositions, o as getFormationMarkers, fe as getObjectByCustomProperty, L as getProjectedTrajectory, w as getProjectionDefFromUtmZone, T as getSplineCurve, s as getTrajectory, M as getTypedArrayFromBuffer, e as getTypedArrayType, E as getUtmZoneFromLatLng, g as getVec2, S as getVec3, it as getWellboreFormations, Te as idToHexColor, ye as inverseLerp, He as lengthVec2, x as lengthVec3, ge as lerp, z as mergeFormationIntervals, k as mergeGeometries, q as mixVec2, G as mixVec3, Re as multiply, Ae as negate, Y as negateVec2, N as negateVec3, t as normalizeVec2, ue as normalizeVec3, c as normalizedDeviceToScreen, de as packAttribute, Xe as packBufferGeometries, Fe as packBufferGeometry, We as packBufferGeometryLike, ve as parseIrapbin, n as randomColor, a as readDepth, me as refineInteriorEdges, Z as remap, re as rotateGeometryY, Ye as rotateVec3, _e as sampleValidGrid, Pe as scaleVec2, Ue as scaleVec3, O as screenToNormalizedDevice, xe as setVec2, $ as setVec3, at as simplifyCurve2D, ne as smoothBoundaryLoops, st as snapBoundaryToOutline, Ie as subVec2, Ke as subVec3, Be as subdivideGeometry, Ze as titleCase, Ee as toBufferGeometry, Ge as toFloat32Array, tt as toRGB, se as toSegments, F as triangleNormal, Ve as triangulateGrid, le as triangulateGridDelaunay, Se as unpackBufferGeometries, ee as unpackBufferGeometry, Je as uvMaterial, A as wgs84Def };
+import { $ as e, $t as t, A as n, At as r, Bt as i, C as a, Cn as o, Ct as s, D as c, Dn as l, Dt as u, E as d, En as f, Et as p, F as m, Ft as h, Gt as g, H as _, Ht as v, It as y, J as b, Jt as x, Kt as S, Lt as C, M as w, Mt as T, N as E, Nt as D, O, On as k, Ot as A, P as j, Pt as M, Q as N, Qt as P, Rt as F, S as I, Sn as L, St as R, T as z, Tn as B, Tt as V, Ut as H, Vt as U, Wt as W, X as G, Xt as K, Y as q, Yt as J, Z as Y, Zt as X, _ as Z, _n as Q, _t as $, an as ee, at as te, b as ne, bn as re, bt as ie, c as ae, cn as oe, ct as se, d as ce, dn as le, dt as ue, en as de, et as fe, f as pe, fn as me, ft as he, g as ge, gn as _e, gt as ve, h as ye, hn as be, ht as xe, in as Se, it as Ce, j as we, jt as Te, k as Ee, kt as De, l as Oe, ln as ke, lt as Ae, m as je, mn as Me, mt as Ne, n as Pe, nn as Fe, nt as Ie, on as Le, ot as Re, p as ze, pn as Be, pt as Ve, q as He, qt as Ue, rn as We, rt as Ge, s as Ke, sn as qe, st as Je, t as Ye, tn as Xe, tt as Ze, u as Qe, un as $e, ut as et, v as tt, vn as nt, vt as rt, w as it, wn as at, wt as ot, x as st, xn as ct, xt as lt, y as ut, yn as dt, yt as ft, zt as pt } from "./chunk-r8Ybij6M.js";
+export { we as CRS, _ as CameraManager, k as DataLoader, V as Delatin, it as DepthReadMaterial, l as GeneratorRegistry, ke as PI, $e as PI2, le as PI4, me as PI8, b as PlanarGeometry, q as PlanarLineGeometry, G as PlanarPointGeometry, Y as PlanarPolygonGeometry, Be as TAU, Pe as TubeMaterial, ae as Typed2DArray, m as WellboreManager, D as addVec2, M as addVec3, h as angleVec3, y as asVec2, Ne as buildMaskedGridPlane, r as calculateFrenetFrames, Oe as calculateHashValue, o as calculateWellSegments, be as clamp, $ as computePlanarXZUv, Z as computeSurfaceNormalsRG, rt as computeUpwardNormals, C as copyVec3, ge as createConfig, tt as createElevationTexture, lt as createFenceGeometry, ft as createIndexedGeometry, ut as createNormalTexture, Re as createOceanBox, Je as createOceanBoxFromPolygon, se as createOceanBoxFromSurface, Ae as createOceanEllipseBox, et as createOceanPlane, ne as createPackedNormalTexture, p as createTubeGeometries, u as createTubeGeometry, F as crossVec3, z as degreesToRadians, pt as directionVec2, i as directionVec3, U as distanceToBounds, v as distanceVec2, H as distanceVec3, W as dotVec2, g as dotVec3, Me as edgeOfRectangle, st as elevationMapNormalsToRGBA, re as extractBoundaryLoops, d as feetToMeters, xe as floodFillExternalHoles, Te as getCurvePositions, at as getFormationMarkers, pe as getObjectByCustomProperty, R as getProjectedTrajectory, w as getProjectionDefFromUtmZone, T as getSplineCurve, s as getTrajectory, N as getTypedArrayFromBuffer, e as getTypedArrayType, E as getUtmZoneFromLatLng, S as getVec2, Ue as getVec3, B as getWellboreFormations, Ee as idToHexColor, _e as inverseLerp, x as lengthVec2, J as lengthVec3, Q as lerp, f as mergeFormationIntervals, A as mergeGeometries, K as mixVec2, X as mixVec3, ze as multiply, je as negate, P as negateVec2, t as negateVec3, de as normalizeVec2, Xe as normalizeVec3, c as normalizedDeviceToScreen, fe as packAttribute, Ze as packBufferGeometries, Ie as packBufferGeometry, Ge as packBufferGeometryLike, ye as parseIrapbin, n as randomColor, a as readDepth, he as refineInteriorEdges, nt as remap, ie as rotateGeometryY, Fe as rotateVec3, ve as sampleValidGrid, We as scaleVec2, Se as scaleVec3, O as screenToNormalizedDevice, ee as setVec2, Le as setVec3, ot as simplifyCurve2D, ct as smoothBoundaryLoops, L as snapBoundaryToOutline, qe as subVec2, oe as subVec3, Ve as subdivideGeometry, Qe as titleCase, De as toBufferGeometry, Ke as toFloat32Array, dt as toRGB, ce as toSegments, I as triangleNormal, He as triangulateGrid, ue as triangulateGridDelaunay, Ce as unpackBufferGeometries, te as unpackBufferGeometry, Ye as uvMaterial, j as wgs84Def };

package/dist/types/components/Distance/Bounds.d.ts

@@ -0,0 +1,37 @@
+import { ReactNode } from 'react';
+import { BoundsShape } from '../../sdk';
+/**
+ * Bounds props
+ * @expand
+ */
+export type BoundsProps = BoundsShape & {
+    children?: ReactNode;
+};
+/**
+ * A generic provider of the {@link DistanceContext}, so the {@link Distance} component
+ * (and anything else reading the context) can be used for ANY object — not just
+ * wellbores. Supply a bounding `sphere`, `box` or a single `position` and `Bounds`
+ * publishes the camera's distance to it each frame, measured in this component's local
+ * space and divided by `camera.zoom` (matching {@link WellboreBounds}, so `Distance`'s
+ * `min`/`max` behave identically).
+ *
+ * If more than one shape is provided the precedence is `sphere` > `box` > `position`.
+ * With none, the distance stays `Infinity` (so distance-gated children remain hidden).
+ *
+ * @example
+ * <Bounds sphere={{ center: [0, 0, 0], radius: 5 }}>
+ *   <Distance min={0} max={50}>
+ *     <mesh>
+ *       <sphereGeometry />
+ *       <meshStandardMaterial color="red" />
+ *     </mesh>
+ *   </Distance>
+ * </Bounds>
+ *
+ * @see {@link Distance}
+ * @see {@link DistanceContext}
+ * @see {@link WellboreBounds}
+ *
+ * @group Components
+ */
+export declare const Bounds: ({ sphere, box, position, children }: BoundsProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/components/Distance/Distance.d.ts

@@ -10,23 +10,34 @@ export type DistanceProps = {
     children: ReactNode;
 };
 /**
- * The Distance component can be used to conditionally render other components.
+ * The Distance component can be used to conditionally render (or, with `onDemand`,
+ * mount/unmount) child components based on the camera's distance to a bounds — for
+ * example to swap geometry level-of-detail. It reads the {@link DistanceContext}, which a
+ * parent must provide: use the generic {@link Bounds} for any object, or
+ * {@link WellboreBounds} for a wellbore.
  *
  * @example
- * <Wellbore id={wellboreId}>
- *  { // DistanceContext provider }
- *   <WellboreBounds id={wellboreId}>
- *     <BasicTrajectory />
- *     <Distance min={0} max={2000}>
- *       <TubeTrajectory />
- *     </Distance>
- *   </WellboreBounds>
- * </Wellbore>
+ * <Bounds sphere={{ center: [0, 0, 0], radius: 5 }}>
+ *   <Distance min={0} max={50}>
+ *     <mesh>
+ *       <sphereGeometry />
+ *       <meshStandardMaterial color="red" />
+ *     </mesh>
+ *   </Distance>
+ *   <Distance min={50} max={Infinity}>
+ *     <mesh>
+ *       <boxGeometry />
+ *       <meshStandardMaterial color="blue" />
+ *     </mesh>
+ *   </Distance>
+ * </Bounds>
  *
  * @remarks
- * This component depends on a `DistanceContext` being provided by a parent component.
+ * This component depends on a `DistanceContext` being provided by a parent component
+ * (e.g. {@link Bounds} or {@link WellboreBounds}).
  *
  * @see [Storybook](/videx-3d/?path=/docs/components-misc-distance--docs)
+ * @see {@link Bounds}
  * @see {@link DistanceContext}
  * @see {@link WellboreBounds}
  *

package/dist/types/components/Distance/index.d.ts

@@ -1,2 +1,3 @@
+export * from './Bounds';
 export * from './Distance';
 export * from './DistanceContext';

package/dist/types/sdk/utils/vector-operations.d.ts

@@ -14,6 +14,31 @@ export declare function copyVec3(vec: Vec3): Vec3;
 export declare function angleVec3(v1: Vec3, v2: Vec3): number;
 export declare function rotateVec3(vector: Vec3, axis?: Vec3, angle?: number): Vec3;
 export declare function directionVec3(v1: Vec3, v2: Vec3): Vec3;
+/**
+ * A bounds shape for distance-based level of detail: a bounding `sphere`, an
+ * axis-aligned bounding `box` (as `[min, max]`) or a single `position`. Consumed by the
+ * `Bounds` component and {@link distanceToBounds}.
+ */
+export type BoundsShape = {
+    /** Bounding sphere. Highest precedence. */
+    sphere?: {
+        center: Vec3;
+        radius: number;
+    };
+    /** Axis-aligned bounding box as `[min, max]`. Used when `sphere` is unset. */
+    box?: [Vec3, Vec3];
+    /** A single point. Lowest precedence. */
+    position?: Vec3;
+};
+/**
+ * Non-negative distance from `point` to a {@link BoundsShape} — `0` when the point is
+ * inside or on the shape. Precedence when several are set: `sphere` > `box` >
+ * `position`; returns `Infinity` when none is provided. Pure math (no rendering
+ * dependencies), so it can drive level-of-detail decisions and be unit tested directly.
+ *
+ * Mirrors three.js' `Sphere`/`Box3.distanceToPoint` (clamped to `0` on the inside).
+ */
+export declare function distanceToBounds(point: Vec3, bounds: BoundsShape): number;
 export declare function distanceVec3(v1: Vec3, v2: Vec3): number;
 /**
  * Resolve a `number | Vec2 | undefined` parameter into a concrete `Vec2`. A

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/videx-3d",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "private": false,
   "type": "module",
   "license": "MIT",
@@ -20,7 +20,7 @@
     "dist"
   ],
   "engines": {
-    "npm": "^11.7.0"
+    "npm": "^12.0.0"
   },
   "exports": {
     ".": {