@toolpath/viewer 0.3.1 → 1.0.0

package/dist/index.js

@@ -1,11 +1,13 @@
 import {
   CAD_CAMERA_UP,
   CANDIDATE_WEIGHT,
+  CHAMFER,
   CONE_AXIS,
   CadCameraControls,
   DEFAULT_FIT_MARGIN,
   DEFAULT_THEME,
   DIRECTION_COLORS,
+  DOUBLE_TAP_MS,
   EXCLUDE_FROM_FRAME,
   EnginePart,
   ExtendedCameraControls,
@@ -16,7 +18,17 @@ import {
   HIGHLIGHT_COLORS,
   HIGHLIGHT_WEIGHT,
   HOVER_WEIGHT,
+  MAX_FRAME_RATIO,
+  MIN_FRAME_RATIO,
   NO_MODIFIERS,
+  ORBIT_TARGET_COLOR,
+  ORBIT_TARGET_FADE_MS,
+  ORBIT_TARGET_FLASH_MS,
+  ORBIT_TARGET_PIXELS,
+  ORBIT_TARGET_RING_COLOR,
+  ORBIT_TARGET_RING_OPACITY,
+  ORBIT_TARGET_RING_PIXELS,
+  ORBIT_TARGET_RING_WIDTH,
   PERSPECTIVE_FOV,
   PICKED_SURFACE_LABEL,
   PartMesh,
@@ -27,7 +39,10 @@ import {
   SectionView,
   TAP_SLOP,
   UnsupportedKernelVersionError,
+  VIEW_NAMES,
+  VIEW_SIGNS,
   Viewer,
+  adaptedUp,
   applyHighlightLayers,
   applyProjection,
   arrowPlacement,
@@ -39,8 +54,11 @@ import {
   buildRegionIndex,
   buildRegionTexels,
   cadViewDirections,
+  cameraLimits,
   contentBounds,
   createPart,
+  cubeOutlineGeometry,
+  cubeZones,
   currentViewDirection,
   cycleOwner,
   defaultBounds,
@@ -52,15 +70,21 @@ import {
   fitDistance,
   focusForPick,
   groupByDirection,
+  labelGeometry,
+  labelTexture,
   movedFar,
   normalizePartReport,
+  orbitTargetOpacity,
   orthographicHalfHeight,
+  panelGeometry,
   perspectiveFitDistance,
   pickedStartDepth,
   rankOwners,
+  regionAdjacency,
   regionEdgesGeometry,
   resolveSectionPlane,
   resolveTheme,
+  retargetPose,
   sameDirection,
   screenLength,
   sectionBounds,
@@ -72,15 +96,22 @@ import {
   sectionOffset,
   sectionPlane,
   smoothRegionNormals,
+  squaredUp,
   startPosition,
+  targetBoundary,
   themesEqual,
+  trackDoubleTaps,
   trackTaps,
   useContentBox,
+  useRetarget,
   useTapGuard,
   useViewerControls,
   viewDirection,
+  viewKind,
+  viewUp,
+  viewVector,
   visualSurfaces
-} from "./chunk-RICG6UVH.js";
+} from "./chunk-4BU4QZCL.js";
 
 // src/primitives.tsx
 import { GizmoHelper } from "@react-three/drei";
@@ -125,233 +156,6 @@ function gridGeometry(spec) {
   return geometry;
 }
 
-// src/render/view-cube.ts
-import {
-  BufferGeometry as BufferGeometry2,
-  CanvasTexture,
-  Float32BufferAttribute as Float32BufferAttribute2,
-  SRGBColorSpace,
-  Vector3 as Vector32
-} from "three";
-var VIEW_NAMES = [
-  // The six faces.
-  "top",
-  "bottom",
-  "front",
-  "back",
-  "left",
-  "right",
-  // The twelve edges.
-  "top-front",
-  "top-back",
-  "top-left",
-  "top-right",
-  "bottom-front",
-  "bottom-back",
-  "bottom-left",
-  "bottom-right",
-  "front-left",
-  "front-right",
-  "back-left",
-  "back-right",
-  // The eight corners.
-  "top-front-left",
-  "top-front-right",
-  "top-back-left",
-  "top-back-right",
-  "bottom-front-left",
-  "bottom-front-right",
-  "bottom-back-left",
-  "bottom-back-right"
-];
-var VIEW_SIGNS = {
-  top: [0, 0, 1],
-  bottom: [0, 0, -1],
-  front: [0, -1, 0],
-  back: [0, 1, 0],
-  left: [-1, 0, 0],
-  right: [1, 0, 0],
-  "top-front": [0, -1, 1],
-  "top-back": [0, 1, 1],
-  "top-left": [-1, 0, 1],
-  "top-right": [1, 0, 1],
-  "bottom-front": [0, -1, -1],
-  "bottom-back": [0, 1, -1],
-  "bottom-left": [-1, 0, -1],
-  "bottom-right": [1, 0, -1],
-  "front-left": [-1, -1, 0],
-  "front-right": [1, -1, 0],
-  "back-left": [-1, 1, 0],
-  "back-right": [1, 1, 0],
-  "top-front-left": [-1, -1, 1],
-  "top-front-right": [1, -1, 1],
-  "top-back-left": [-1, 1, 1],
-  "top-back-right": [1, 1, 1],
-  "bottom-front-left": [-1, -1, -1],
-  "bottom-front-right": [1, -1, -1],
-  "bottom-back-left": [-1, 1, -1],
-  "bottom-back-right": [1, 1, -1]
-};
-function viewKind(name) {
-  const off = VIEW_SIGNS[name].filter((sign) => sign !== 0).length;
-  if (off === 1) return "face";
-  if (off === 2) return "edge";
-  return "corner";
-}
-var DIRECTIONS = new Map(
-  VIEW_NAMES.map((name) => {
-    const [x, y, z] = VIEW_SIGNS[name];
-    const length = Math.hypot(x, y, z);
-    return [name, { x: x / length, y: y / length, z: z / length }];
-  })
-);
-function viewVector(name) {
-  return DIRECTIONS.get(name) ?? { x: 0, y: 0, z: 1 };
-}
-function viewUp(direction) {
-  if (direction.x === 0 && direction.y === 0) {
-    return { x: 0, y: direction.z > 0 ? 1 : -1, z: 0 };
-  }
-  return { x: 0, y: 0, z: 1 };
-}
-var CHAMFER = 0.5834;
-function vec(v) {
-  return { x: v.x, y: v.y, z: v.z };
-}
-function cubeZones(chamfer = CHAMFER) {
-  const AXES = [0, 1, 2];
-  return VIEW_NAMES.map((name) => {
-    const kind = viewKind(name);
-    const direction = viewVector(name);
-    const [sx, sy, sz] = VIEW_SIGNS[name];
-    const sign = (axis) => VIEW_SIGNS[name][axis] ?? 0;
-    const normal = new Vector32(direction.x, direction.y, direction.z);
-    let polygon;
-    if (kind === "face") {
-      const up = viewUp(direction);
-      const upVector = new Vector32(up.x, up.y, up.z);
-      const right = normal.clone().negate().cross(upVector).normalize();
-      const square = [
-        [-1, -1],
-        [1, -1],
-        [1, 1],
-        [-1, 1]
-      ];
-      polygon = square.map(
-        ([u, v]) => normal.clone().addScaledVector(right, u * chamfer).addScaledVector(upVector, v * chamfer)
-      );
-    } else if (kind === "edge") {
-      const a = AXES.find((axis) => sign(axis) !== 0) ?? 0;
-      const b = [...AXES].reverse().find((axis) => sign(axis) !== 0) ?? 0;
-      const c = AXES.find((axis) => sign(axis) === 0) ?? 0;
-      const rectangle = [
-        [1, chamfer, -chamfer],
-        [1, chamfer, chamfer],
-        [chamfer, 1, chamfer],
-        [chamfer, 1, -chamfer]
-      ];
-      polygon = rectangle.map(
-        ([onA, onB, onC]) => new Vector32().setComponent(a, sign(a) * onA).setComponent(b, sign(b) * onB).setComponent(c, onC)
-      );
-    } else {
-      const triangle = [
-        [1, chamfer, chamfer],
-        [chamfer, 1, chamfer],
-        [chamfer, chamfer, 1]
-      ];
-      polygon = triangle.map(([onX, onY, onZ]) => new Vector32(sx * onX, sy * onY, sz * onZ));
-    }
-    const [first, second, third] = polygon;
-    if (first && second && third) {
-      const facing = new Vector32().subVectors(second, first).cross(new Vector32().subVectors(third, first));
-      if (facing.dot(normal) < 0) polygon.reverse();
-    }
-    return { name, kind, direction, polygon: polygon.map(vec) };
-  });
-}
-function panelGeometry(zone) {
-  const positions = [];
-  const normals = [];
-  const [first] = zone.polygon;
-  const geometry = new BufferGeometry2();
-  if (!first) return geometry;
-  for (let index = 1; index + 1 < zone.polygon.length; index += 1) {
-    const b = zone.polygon[index];
-    const c = zone.polygon[index + 1];
-    if (!b || !c) continue;
-    positions.push(first.x, first.y, first.z, b.x, b.y, b.z, c.x, c.y, c.z);
-    for (let vertex = 0; vertex < 3; vertex += 1) {
-      normals.push(zone.direction.x, zone.direction.y, zone.direction.z);
-    }
-  }
-  geometry.setAttribute("position", new Float32BufferAttribute2(positions, 3));
-  geometry.setAttribute("normal", new Float32BufferAttribute2(normals, 3));
-  return geometry;
-}
-function cubeOutlineGeometry(zones) {
-  const positions = [];
-  for (const zone of zones) {
-    for (let index = 0; index < zone.polygon.length; index += 1) {
-      const from = zone.polygon[index];
-      const to = zone.polygon[(index + 1) % zone.polygon.length];
-      if (!from || !to) continue;
-      positions.push(from.x, from.y, from.z, to.x, to.y, to.z);
-    }
-  }
-  const geometry = new BufferGeometry2();
-  geometry.setAttribute("position", new Float32BufferAttribute2(positions, 3));
-  return geometry;
-}
-function labelGeometry(zone) {
-  const positions = [];
-  const uvs = [];
-  const corners = [0, 1, 2, 0, 2, 3];
-  const corner = [
-    [0, 0],
-    [1, 0],
-    [1, 1],
-    [0, 1]
-  ];
-  for (const index of corners) {
-    const point = zone.polygon[index];
-    const uv = corner[index];
-    if (!point || !uv) continue;
-    positions.push(
-      point.x + zone.direction.x * 4e-3,
-      point.y + zone.direction.y * 4e-3,
-      point.z + zone.direction.z * 4e-3
-    );
-    uvs.push(uv[0] ?? 0, uv[1] ?? 0);
-  }
-  const geometry = new BufferGeometry2();
-  geometry.setAttribute("position", new Float32BufferAttribute2(positions, 3));
-  geometry.setAttribute("uv", new Float32BufferAttribute2(uvs, 2));
-  return geometry;
-}
-function labelTexture(label, color) {
-  const size = 128;
-  const canvas = document.createElement("canvas");
-  canvas.width = size;
-  canvas.height = size;
-  const context = canvas.getContext("2d");
-  if (context) {
-    const text = label.toUpperCase();
-    const hex = `#${color.toString(16).padStart(6, "0")}`;
-    context.font = `600 ${size / 4}px system-ui, sans-serif`;
-    const width = context.measureText("BOTTOM").width || 1;
-    const scale = Math.min(1, size * 0.78 / width);
-    context.font = `600 ${size / 4 * scale}px system-ui, sans-serif`;
-    context.textAlign = "center";
-    context.textBaseline = "middle";
-    context.fillStyle = hex;
-    context.fillText(text, size / 2, size / 2);
-  }
-  const texture = new CanvasTexture(canvas);
-  texture.colorSpace = SRGBColorSpace;
-  texture.needsUpdate = true;
-  return texture;
-}
-
 // src/primitives.tsx
 import { jsx, jsxs } from "react/jsx-runtime";
 var FURNITURE = { [EXCLUDE_FROM_FRAME]: true };
@@ -460,7 +264,7 @@ var CubePanels = ({
 // src/direction-arrows.tsx
 import { useThree as useThree2 } from "@react-three/fiber";
 import { useMemo as useMemo2 } from "react";
-import { Quaternion, Vector3 as Vector33 } from "three";
+import { Quaternion, Vector3 as Vector32 } from "three";
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 var FURNITURE2 = { [EXCLUDE_FROM_FRAME]: true };
 var DirectionArrows = ({
@@ -476,6 +280,11 @@ var DirectionArrows = ({
   const box = useContentBox();
   const resolved = useMemo2(() => resolveTheme(theme), [theme]);
   const shown = shownDirection === void 0 ? activeDirection : shownDirection;
+  const drawn = (index) => {
+    if (shown === null) return true;
+    if (typeof shown === "number") return shown === index;
+    return shown.includes(index);
+  };
   if (!visible) return null;
   return (
     // Excluded from framing: the arrows are deliberately placed outside the
@@ -483,7 +292,7 @@ var DirectionArrows = ({
     // part small in the middle of them.
     /* @__PURE__ */ jsxs2("group", { userData: FURNITURE2, children: [
       directions.map((direction, index) => {
-        if (shown !== null && shown !== index) return null;
+        if (!drawn(index)) return null;
         return /* @__PURE__ */ jsx2(
           Arrow,
           {
@@ -517,7 +326,7 @@ var Arrow = ({ direction, box, color, opacity, onPick, onTop = false }) => {
     const placement = arrowPlacement(direction, box);
     const aim = new Quaternion().setFromUnitVectors(
       CONE_AXIS,
-      new Vector33(direction.x, direction.y, direction.z).normalize()
+      new Vector32(direction.x, direction.y, direction.z).normalize()
     );
     return { tip: placement.tip, length: placement.length, quaternion: aim };
   }, [box, direction]);
@@ -584,6 +393,7 @@ export {
   DEFAULT_FIT_MARGIN,
   DEFAULT_THEME,
   DIRECTION_COLORS,
+  DOUBLE_TAP_MS,
   DirectionArrows,
   EXCLUDE_FROM_FRAME,
   EnginePart,
@@ -594,7 +404,17 @@ export {
   HIGHLIGHT_COLORS,
   HIGHLIGHT_WEIGHT,
   HOVER_WEIGHT,
+  MAX_FRAME_RATIO,
+  MIN_FRAME_RATIO,
   NO_MODIFIERS,
+  ORBIT_TARGET_COLOR,
+  ORBIT_TARGET_FADE_MS,
+  ORBIT_TARGET_FLASH_MS,
+  ORBIT_TARGET_PIXELS,
+  ORBIT_TARGET_RING_COLOR,
+  ORBIT_TARGET_RING_OPACITY,
+  ORBIT_TARGET_RING_PIXELS,
+  ORBIT_TARGET_RING_WIDTH,
   PERSPECTIVE_FOV,
   PICKED_SURFACE_LABEL,
   PartMesh,
@@ -608,6 +428,7 @@ export {
   VIEW_SIGNS,
   ViewCube,
   Viewer,
+  adaptedUp,
   applyHighlightLayers,
   applyProjection,
   arrowPlacement,
@@ -619,6 +440,7 @@ export {
   buildRegionIndex,
   buildRegionTexels,
   cadViewDirections,
+  cameraLimits,
   contentBounds,
   createPart,
   cubeOutlineGeometry,
@@ -640,15 +462,18 @@ export {
   labelTexture,
   movedFar,
   normalizePartReport,
+  orbitTargetOpacity,
   orthographicHalfHeight,
   panelGeometry,
   perspectiveFitDistance,
   pickedStartDepth,
   rankOwners,
+  regionAdjacency,
   regionEdgesGeometry,
   regionNormals,
   resolveSectionPlane,
   resolveTheme,
+  retargetPose,
   sameDirection,
   screenLength,
   sectionBounds,
@@ -660,10 +485,14 @@ export {
   sectionOffset,
   sectionPlane,
   smoothRegionNormals,
+  squaredUp,
   startPosition,
+  targetBoundary,
   themesEqual,
+  trackDoubleTaps,
   trackTaps,
   useContentBox,
+  useRetarget,
   useTapGuard,
   useViewerControls,
   viewDirection,

package/dist/{normalize-Bzzwwxt4.d.ts → normalize-DsoIyM8B.d.ts}

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { Group, Mesh, LineSegments, Box3, Plane, BufferGeometry, Camera, Vector3, OrthographicCamera, PerspectiveCamera, Object3D } from 'three';
+import { Group, Mesh, LineSegments, Box3, Plane, BufferGeometry, Camera, Vector3 } from 'three';
 
 /**
  * The normalized part — the only thing the renderer consumes.
@@ -215,7 +215,7 @@ declare const HIGHLIGHT_COLORS: {
  * of the palette — it is an identity, not a ranking, which is why the colors
  * are unordered and deliberately not a scale.
  */
-declare const DIRECTION_COLORS: readonly [3900150, 1357990, 14239471, 440020, 6660877, 15485081, 6583435, 1096065, 6514417];
+declare const DIRECTION_COLORS: readonly [3900150, 889992, 14239471, 6809849, 6660877, 15485081, 9741240, 4906624, 1981066];
 declare const DEFAULT_THEME: ViewerTheme;
 declare function resolveTheme(overrides?: Partial<ViewerTheme>): ViewerTheme;
 /**
@@ -303,11 +303,15 @@ declare function buildRegionAttribute(model: RegionTable, texels: Map<number, nu
 /**
  * Builds the renderable part.
  *
- * Takes exclusive use of `geometry`: it adds {@link REGION_ATTRIBUTE} to it and
+ * Takes working use of `geometry`: it adds {@link REGION_ATTRIBUTE} to it and
  * removes that again on dispose, but never disposes the geometry itself — the
  * loader's caller owns it, and a viewer destroying an object it was handed is a
- * good way to break a cache that is legitimately sharing it. One geometry backs
- * one part; sharing it between two parts at once is unsupported.
+ * good way to break a cache that is legitimately sharing it.
+ *
+ * Two parts on one geometry is still not a thing to *render*, but it is a state
+ * that happens: a report changing identity rebuilds the part against the same
+ * cached mesh, and for a moment both exist. So dispose removes the attribute
+ * only if it is still the one this part set — see the note where it is built.
  */
 declare function createPart(model: PartModel, geometry: BufferGeometry, theme: ViewerTheme): PartObject;
 
@@ -430,6 +434,21 @@ interface PartPick {
     /** The surface's outward normal in world space — the plane under the cursor. */
     readonly normal: readonly [number, number, number];
     readonly modifiers: PickModifiers;
+    /**
+     * Whether this click completed a double click on the part.
+     *
+     * Reported rather than interpreted, for the same reason the modifiers are:
+     * what a second click means belongs to the app. A viewer that decided —
+     * withholding the pick so a double click could not disturb the selection —
+     * would be right for a list that walks through a face's readings and wrong
+     * for an editor where clicking a face twice puts it in and takes it out
+     * again. Both are ordinary, and only the app knows which one it is showing.
+     *
+     * The viewport still acts on the gesture itself: `retargetOnDoubleClick`
+     * re-aims the orbit, which is a question about the view rather than about the
+     * part, and is nobody else's to answer.
+     */
+    readonly doubled: boolean;
 }
 /** A unit vector from the part toward the camera, for the owner ranking. */
 declare function viewDirection(camera: Camera, target: Vector3): Vec3;
@@ -448,6 +467,8 @@ interface BuildPickInput {
      */
     readonly activeDirection?: number | null;
     readonly viewDirection?: Vec3 | null;
+    /** Whether this click completed a double click. Defaults to `false`. */
+    readonly doubled?: boolean;
 }
 declare function buildPick(input: BuildPickInput): PartPick;
 /**
@@ -459,86 +480,6 @@ declare function buildPick(input: BuildPickInput): PartPick;
  */
 declare function focusForPick(pick: PartPick, previousRegion: number | null, previousFocus: FeatureTag | null): FeatureTag | null;
 
-type Projection = 'orthographic' | 'perspective';
-type ViewerCamera = OrthographicCamera | PerspectiveCamera;
-interface ViewportSize {
-    readonly width: number;
-    readonly height: number;
-}
-/** Vertical field of view, in degrees, for the perspective camera. */
-declare const PERSPECTIVE_FOV = 30;
-/** Padding around the framed bounds, as a multiple of its radius. */
-declare const DEFAULT_FIT_MARGIN = 1.2;
-/** Marks scene furniture — grid, axes — that the camera should not frame. */
-declare const EXCLUDE_FROM_FRAME = "viewerExcludeFromFrame";
-/**
- * What the camera frames: a bounding *sphere*, not a box.
- *
- * A sphere makes framing rotation-invariant — the part stays fully visible from
- * every angle, and a resize never needs to know the current pose. Framing
- * per-axis box dimensions instead means recomputing the camera distance on
- * every resize, and still clipping on some orientations.
- */
-interface SceneBounds {
-    readonly center: Vector3;
-    readonly radius: number;
-}
-/**
- * Bounds for a scene with nothing in it. A viewer is mounted before it has a
- * part, and a camera with a zero-size frustum renders nothing at all.
- */
-declare function defaultBounds(): SceneBounds;
-/**
- * A container can be laid out at zero size, and a degenerate aspect ratio
- * produces a `NaN` projection matrix that never recovers. Fall back to square.
- */
-declare function aspectRatio(size: ViewportSize): number;
-declare function boundsFromBox(box: Box3): SceneBounds;
-/**
- * The bounds of everything worth framing under `root`.
- *
- * Skips objects flagged with {@link EXCLUDE_FROM_FRAME} and their descendants:
- * a 100 mm grid around a 6 mm part would otherwise frame the grid, and the part
- * would be a speck.
- */
-declare function contentBounds(root: Object3D, into: Box3): SceneBounds;
-/**
- * The distance at which a sphere of `radius` fits inside a perspective frustum.
- * Uses the narrower of the two field-of-view angles, so a portrait viewport
- * frames on width and a landscape one on height.
- */
-declare function perspectiveFitDistance(fovDegrees: number, aspect: number, radius: number): number;
-/**
- * Half-height of an orthographic frustum that fits a sphere of `radius`. A
- * portrait viewport grows the height so the width still clears the sphere.
- */
-declare function orthographicHalfHeight(aspect: number, radius: number): number;
-declare function fitDistance(projection: Projection, size: ViewportSize, bounds: SceneBounds, margin?: number): number;
-declare function startPosition(projection: Projection, size: ViewportSize, bounds: SceneBounds, margin?: number): Vector3;
-/**
- * Points an existing camera's frustum at `bounds` for the current viewport.
- * Pose is untouched — that belongs to the controls.
- */
-declare function applyProjection(camera: ViewerCamera, size: ViewportSize, bounds: SceneBounds, margin?: number): void;
-/**
- * The world-up convention. The part data is Z-up (millimetres, no conversion) —
- * not the glTF-conventional Y-up — so the camera has to say so explicitly.
- */
-declare const CAD_CAMERA_UP: Vector3;
-/** Named viewing directions, as unit vectors from the part toward the camera. */
-declare const cadViewDirections: {
-    readonly front: Vector3;
-    readonly back: Vector3;
-    readonly left: Vector3;
-    readonly right: Vector3;
-    readonly top: Vector3;
-    readonly bottom: Vector3;
-    readonly isometric: Vector3;
-};
-type ViewerView = keyof typeof cadViewDirections;
-/** The current orbit direction, so Fit can retain the direction being looked from. */
-declare function currentViewDirection(camera: ViewerCamera, target: Vector3, into: Vector3): Vector3;
-
 /**
  * Render order. The stencil pass must precede the cap, and the part must draw
  * after both or it overwrites the cap it is supposed to be capped by. The part
@@ -635,14 +576,6 @@ declare function sectionFromPick(surface: {
 declare function pickedStartDepth(box: Box3): number;
 /** The plane a cut sits on, for a placement or a swept offset. */
 declare function sectionPlane(box: Box3, normal: Vec3, offset: number, into?: Plane): Plane;
-/**
- * A world length that covers `pixels` on screen at `point`.
- *
- * A handle sized in world units is a thumbnail on a plate and a wall on an
- * insert; the whole reason it is measured this way is that it is a control
- * rather than part of the model.
- */
-declare function screenLength(camera: ViewerCamera, point: Vector3, viewport: ViewportSize, pixels: number): number;
 /**
  * The plane a drag is projected onto: the one containing the handle's axis and
  * facing the camera as squarely as it can.
@@ -772,6 +705,15 @@ interface PartMeshProps {
      * real change, so echoing it into state is safe.
      */
     onSectionChange?: (state: SectionState) => void;
+    /**
+     * Which faces touch which, once the mesh is in.
+     *
+     * The consumer cannot work this out: it has a region table with areas and
+     * shape kinds, and the topology only exists in the geometry. Handed over
+     * rather than queried, because it is computed once per mesh and the consumer
+     * needs it to answer questions about faces it has not clicked yet.
+     */
+    onAdjacency?: (adjacency: ReadonlyMap<number, ReadonlySet<number>>) => void;
     /**
      * A feature to frame. Framed when it changes, so setting it to the feature
      * already framed does nothing — a zoom is a request, not a state to hold.
@@ -801,7 +743,7 @@ interface PartMeshProps {
  * React render at all: the hovered face lives in a ref, and routing it through
  * state is what this rewrite exists to stop doing.
  */
-declare const PartMesh: ({ model, geometry, selection, candidates, highlights, regionHighlights, pickedRegions, hoveredFeatureIds, activeDirection, section, onSectionChange, focusFeature, onHover, onPick, theme, showEdges, }: PartMeshProps) => react.JSX.Element;
+declare const PartMesh: ({ model, geometry, selection, candidates, highlights, regionHighlights, pickedRegions, hoveredFeatureIds, activeDirection, section, onSectionChange, onAdjacency, focusFeature, onHover, onPick, theme, showEdges, }: PartMeshProps) => react.JSX.Element;
 
 interface EnginePartProps extends Omit<PartMeshProps, 'model' | 'geometry'> {
     /**
@@ -876,4 +818,4 @@ declare function normalizePartReport(report: unknown): PartModel;
  */
 declare function assertSupportedKernelVersion(kernelVersion: string): void;
 
-export { applyHighlightLayers as $, type PartPick as A, type BuildPickInput as B, CAD_CAMERA_UP as C, DEFAULT_FIT_MARGIN as D, EnginePart as E, type FeatureTag as F, type PickModifiers as G, HANDLE_PIXELS as H, REGION_ATTRIBUTE as I, type RegionHighlight as J, type KnownFeatureType as K, type RegionPaint as L, MIN_KERNEL_VERSION as M, NO_MODIFIERS as N, type SceneBounds as O, type PartModel as P, type SectionAnchor as Q, type RegionIndex as R, SECTION_RENDER_ORDER as S, type TriangleRange as T, type SectionBounds as U, type Vec3 as V, type SectionOptions as W, type SectionPlacement as X, type SectionState as Y, SectionView as Z, type ViewportSize as _, type PartMeshRefs as a, applyProjection as a0, aspectRatio as a1, boundsFromBox as a2, buildPick as a3, buildRegionAttribute as a4, buildRegionTexels as a5, cadViewDirections as a6, contentBounds as a7, createPart as a8, currentViewDirection as a9, defaultBounds as aa, directionColor as ab, dragPlane as ac, fitDistance as ad, focusForPick as ae, orthographicHalfHeight as af, perspectiveFitDistance as ag, pickedStartDepth as ah, resolveSectionPlane as ai, resolveTheme as aj, screenLength as ak, sectionBounds as al, sectionConstant as am, sectionDepth as an, sectionDepthConstant as ao, sectionDepthRange as ap, sectionFromPick as aq, sectionOffset as ar, sectionPlane as as, startPosition as at, themesEqual as au, viewDirection as av, type EnginePartProps as b, assertSupportedKernelVersion as c, type ViewerTheme as d, type PartModelRegion as e, type ViewerCamera as f, type ViewerView as g, type Projection as h, type PartModelFeature as i, type FeatureType as j, CANDIDATE_WEIGHT as k, DEFAULT_THEME as l, DIRECTION_COLORS as m, normalizePartReport as n, EXCLUDE_FROM_FRAME as o, type FeatureHighlight as p, HIGHLIGHT_COLORS as q, HIGHLIGHT_WEIGHT as r, smoothRegionNormals as s, HOVER_WEIGHT as t, type HighlightLayers as u, PERSPECTIVE_FOV as v, PICKED_SURFACE_LABEL as w, PartMesh as x, type PartMeshProps as y, type PartObject as z };
+export { resolveSectionPlane as $, type SectionOptions as A, type BuildPickInput as B, CANDIDATE_WEIGHT as C, DEFAULT_THEME as D, EnginePart as E, type FeatureTag as F, type SectionPlacement as G, HANDLE_PIXELS as H, type SectionState as I, SectionView as J, type KnownFeatureType as K, applyHighlightLayers as L, MIN_KERNEL_VERSION as M, NO_MODIFIERS as N, buildPick as O, type PartModel as P, buildRegionAttribute as Q, type RegionIndex as R, SECTION_RENDER_ORDER as S, type TriangleRange as T, buildRegionTexels as U, type Vec3 as V, createPart as W, directionColor as X, dragPlane as Y, focusForPick as Z, pickedStartDepth as _, type PartMeshRefs as a, resolveTheme as a0, sectionBounds as a1, sectionConstant as a2, sectionDepth as a3, sectionDepthConstant as a4, sectionDepthRange as a5, sectionFromPick as a6, sectionOffset as a7, sectionPlane as a8, themesEqual as a9, viewDirection as aa, type EnginePartProps as b, assertSupportedKernelVersion as c, type ViewerTheme as d, type PartModelRegion as e, type PartModelFeature as f, type FeatureType as g, DIRECTION_COLORS as h, type FeatureHighlight as i, HIGHLIGHT_COLORS as j, HIGHLIGHT_WEIGHT as k, HOVER_WEIGHT as l, type HighlightLayers as m, normalizePartReport as n, PICKED_SURFACE_LABEL as o, PartMesh as p, type PartMeshProps as q, type PartObject as r, smoothRegionNormals as s, type PartPick as t, type PickModifiers as u, REGION_ATTRIBUTE as v, type RegionHighlight as w, type RegionPaint as x, type SectionAnchor as y, type SectionBounds as z };

package/package.json

@@ -1,16 +1,19 @@
 {
   "name": "@toolpath/viewer",
-  "version": "0.3.1",
+  "version": "1.0.0",
   "description": "React Three Fiber viewer for Toolpath Engine part reports",
   "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
   "repository": {
     "type": "git",
-    "url": "https://github.com/toolpath/toolpath.git",
+    "url": "https://github.com/toolpath/ui-packages.git",
     "directory": "packages/viewer"
   },
   "homepage": "https://developers.toolpath.com",
   "bugs": {
-    "url": "https://github.com/toolpath/toolpath/issues"
+    "url": "https://github.com/toolpath/ui-packages/issues"
   },
   "publishConfig": {
     "access": "public",
@@ -62,6 +65,7 @@
   },
   "scripts": {
     "build": "tsup src/index.ts src/engine/index.ts --format esm --dts --clean --external react --external react-dom --external three --external @react-three/fiber --external @react-three/drei",
+    "build:watch": "tsup src/index.ts src/engine/index.ts --format esm --dts --watch --external react --external react-dom --external three --external @react-three/fiber --external @react-three/drei",
     "check-types": "tsc --noEmit",
     "test": "vitest run"
   }