@toolpath/viewer 0.3.0 → 0.4.0

package/dist/engine/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PartModel, a as PartMeshRefs } from '../normalize-W9Lv_Mpg.js';
-export { E as EnginePart, b as EnginePartProps, M as MIN_KERNEL_VERSION, c as assertSupportedKernelVersion, n as normalizePartReport, s as smoothRegionNormals } from '../normalize-W9Lv_Mpg.js';
+import { P as PartModel, a as PartMeshRefs } from '../normalize-BXIGoZmc.js';
+export { E as EnginePart, b as EnginePartProps, M as MIN_KERNEL_VERSION, c as assertSupportedKernelVersion, n as normalizePartReport, s as smoothRegionNormals } from '../normalize-BXIGoZmc.js';
 import { BufferGeometry } from 'three';
 import 'react';
 

package/dist/engine/index.js

@@ -12,7 +12,7 @@ import {
   parsePartGeometry,
   partMeshAssets,
   smoothRegionNormals
-} from "../chunk-RICG6UVH.js";
+} from "../chunk-ILZ2KQUK.js";
 export {
   EnginePart,
   MIN_KERNEL_VERSION,

package/dist/index.d.ts

@@ -1,10 +1,18 @@
-import { V as Vec3, d as ViewerTheme, P as PartModel, e as PartModelRegion, f as ViewerCamera, g as ViewerView, h as Projection, T as TriangleRange, F as FeatureTag, R as RegionIndex, i as PartModelFeature, j as FeatureType } from './normalize-W9Lv_Mpg.js';
-export { B as BuildPickInput, C as CAD_CAMERA_UP, k as CANDIDATE_WEIGHT, D as DEFAULT_FIT_MARGIN, l as DEFAULT_THEME, m as DIRECTION_COLORS, o as EXCLUDE_FROM_FRAME, E as EnginePart, p as FeatureHighlight, H as HANDLE_PIXELS, q as HIGHLIGHT_COLORS, r as HIGHLIGHT_WEIGHT, t as HOVER_WEIGHT, u as HighlightLayers, K as KnownFeatureType, N as NO_MODIFIERS, v as PERSPECTIVE_FOV, w as PICKED_SURFACE_LABEL, x as PartMesh, y as PartMeshProps, a as PartMeshRefs, z as PartObject, A as PartPick, G as PickModifiers, I as REGION_ATTRIBUTE, J as RegionHighlight, L as RegionPaint, S as SECTION_RENDER_ORDER, O as SceneBounds, Q as SectionAnchor, U as SectionBounds, W as SectionOptions, X as SectionPlacement, Y as SectionState, Z as SectionView, _ as ViewportSize, $ as applyHighlightLayers, a0 as applyProjection, a1 as aspectRatio, a2 as boundsFromBox, a3 as buildPick, a4 as buildRegionAttribute, a5 as buildRegionTexels, a6 as cadViewDirections, a7 as contentBounds, a8 as createPart, a9 as currentViewDirection, aa as defaultBounds, ab as directionColor, ac as dragPlane, ad as fitDistance, ae as focusForPick, n as normalizePartReport, af as orthographicHalfHeight, ag as perspectiveFitDistance, ah as pickedStartDepth, ai as resolveSectionPlane, aj as resolveTheme, ak as screenLength, al as sectionBounds, am as sectionConstant, an as sectionDepth, ao as sectionDepthConstant, ap as sectionDepthRange, aq as sectionFromPick, ar as sectionOffset, as as sectionPlane, s as smoothRegionNormals, at as startPosition, au as themesEqual, av as viewDirection } from './normalize-W9Lv_Mpg.js';
+import { P as PartModel, V as Vec3, d as ViewerTheme, e as PartModelRegion, f as ViewerCamera, g as ViewerView, h as Projection, T as TriangleRange, F as FeatureTag, R as RegionIndex, i as PartModelFeature, j as FeatureType } from './normalize-BXIGoZmc.js';
+export { B as BuildPickInput, C as CAD_CAMERA_UP, k as CANDIDATE_WEIGHT, D as DEFAULT_FIT_MARGIN, l as DEFAULT_THEME, m as DIRECTION_COLORS, o as EXCLUDE_FROM_FRAME, E as EnginePart, p as FeatureHighlight, H as HANDLE_PIXELS, q as HIGHLIGHT_COLORS, r as HIGHLIGHT_WEIGHT, t as HOVER_WEIGHT, u as HighlightLayers, K as KnownFeatureType, N as NO_MODIFIERS, v as PERSPECTIVE_FOV, w as PICKED_SURFACE_LABEL, x as PartMesh, y as PartMeshProps, a as PartMeshRefs, z as PartObject, A as PartPick, G as PickModifiers, I as REGION_ATTRIBUTE, J as RegionHighlight, L as RegionPaint, S as SECTION_RENDER_ORDER, O as SceneBounds, Q as SectionAnchor, U as SectionBounds, W as SectionOptions, X as SectionPlacement, Y as SectionState, Z as SectionView, _ as ViewportSize, $ as applyHighlightLayers, a0 as applyProjection, a1 as aspectRatio, a2 as boundsFromBox, a3 as buildPick, a4 as buildRegionAttribute, a5 as buildRegionTexels, a6 as cadViewDirections, a7 as contentBounds, a8 as createPart, a9 as currentViewDirection, aa as defaultBounds, ab as directionColor, ac as dragPlane, ad as fitDistance, ae as focusForPick, n as normalizePartReport, af as orthographicHalfHeight, ag as perspectiveFitDistance, ah as pickedStartDepth, ai as resolveSectionPlane, aj as resolveTheme, ak as screenLength, al as sectionBounds, am as sectionConstant, an as sectionDepth, ao as sectionDepthConstant, ap as sectionDepthRange, aq as sectionFromPick, ar as sectionOffset, as as sectionPlane, s as smoothRegionNormals, at as startPosition, au as themesEqual, av as viewDirection } from './normalize-BXIGoZmc.js';
+import { BufferGeometry, CanvasTexture, Vector3, Box3 } from 'three';
 import * as react from 'react';
 import { RefObject, ReactNode, CSSProperties } from 'react';
-import { BufferGeometry, CanvasTexture, Vector3, Box3 } from 'three';
 import CameraControls from 'camera-controls';
 
+/**
+ * Every face's neighbours, keyed by region index.
+ *
+ * One pass over the triangles: each contributes three edges, each edge names
+ * the region that owns it, and any edge named by two regions joins them.
+ */
+declare function regionAdjacency(model: PartModel, geometry: BufferGeometry): Map<number, Set<number>>;
+
 /**
  * The 26 standard views: the six faces of the cube, the twelve edges between
  * them, and its eight corners.
@@ -39,6 +47,21 @@ declare function viewVector(name: ViewName): Vec3;
  * come from here.
  */
 declare function viewUp(direction: Vec3): Vec3;
+/**
+ * The squared up vector nearest to the one the camera already has.
+ *
+ * A view has four square orientations, not one: {@link viewUp} rolled by 0°,
+ * 90°, 180° and 270° about the view direction. Snapping to the canonical one
+ * would spin the part on the way to a view somebody asked for because it was
+ * already nearly in front of them — arrive at the bottom view from the right
+ * and the part turns a quarter of a turn for no reason they can see.
+ *
+ * So the roll is chosen, not imposed: of the four, the one closest to where the
+ * camera is looking from now. The view still lands square — Bottom simply lands
+ * square in whichever of its four ways was already nearest, which is how the
+ * Fusion cube behaves and what somebody arriving from it will expect.
+ */
+declare function squaredUp(direction: Vec3, currentUp: Vec3): Vec3;
 /**
  * Half-width of a face panel, where the cube's half-extent is 1 — so the
  * chamfer taken off each edge is the remaining `1 - CHAMFER`.
@@ -134,10 +157,15 @@ interface DirectionArrowsProps {
      */
     activeDirection?: number | null;
     /**
-     * Shows one direction's arrow without scoping anything, for "the feature
-     * being read came from this way". Falls back to `activeDirection`.
+     * Which arrows are drawn, without scoping anything: `null` for all of them,
+     * an index for one, `-1` for none — and **a list of indices for a set**, which
+     * is how a plan draws only the ways up it has confirmed.
+     *
+     * One prop rather than a singular and a plural, because two would need a rule
+     * about which wins, and a caller with an answer to give should not also have
+     * to say where to put it. Falls back to `activeDirection`.
      */
-    shownDirection?: number | null;
+    shownDirection?: number | readonly number[] | null;
     /**
      * A direction being named, drawn while it is aimed. Not a candidate and not a
      * selection: a way up that does not exist yet, so it is drawn over the part —
@@ -227,6 +255,37 @@ interface TapTracker {
  * and a listener that runs after `stopPropagation` runs never.
  */
 declare function trackTaps(element: HTMLElement): TapTracker;
+/**
+ * How long between two presses still reads as one gesture, in milliseconds.
+ *
+ * The browser's own `dblclick` threshold is a platform setting and is not
+ * readable from script, so a hand-paired gesture has to pick a number. 400ms is
+ * inside every default and outside a deliberate pair of separate clicks.
+ */
+declare const DOUBLE_TAP_MS = 400;
+interface DoubleTapPoint extends TapPoint {
+    readonly timeStamp: number;
+}
+interface DoubleTapTracker {
+    /** Whether this press completes a double tap begun by the last one. */
+    isDouble(event: DoubleTapPoint): boolean;
+}
+/**
+ * Pairing presses into a double tap by hand.
+ *
+ * Needed because `dblclick` fires for the **primary button only** — there is no
+ * such event for the middle button, however many times it is pressed. So a
+ * middle-button gesture has to be assembled from single presses.
+ *
+ * Position matters as well as time: two presses at opposite corners inside the
+ * window are two clicks that happened to be quick, not one gesture, and
+ * treating them as a double would re-frame the view out from under somebody
+ * who was doing something else. The same {@link TAP_SLOP} the click guard uses.
+ *
+ * A completed double clears the state rather than leaving it, so three presses
+ * are one double and one single rather than two overlapping doubles.
+ */
+declare function trackDoubleTaps(within?: number, slop?: number): DoubleTapTracker;
 
 /**
  * A click that is a click, for anything inside the canvas.
@@ -368,6 +427,15 @@ interface CadCameraControlsProps {
      * about an orbit control.
      */
     freeOrbit?: boolean;
+    /**
+     * What the wheel zooms toward: the pointer, or the middle of the view.
+     *
+     * Fusion and SolidWorks zoom to the cursor and most people expect it — you
+     * point at the corner you want and lean in. It is not universally liked: on a
+     * trackpad it can walk the model off screen, which is why the other one
+     * stays.
+     */
+    zoomTo?: 'cursor' | 'centre';
 }
 /**
  * Mounts `camera-controls` against the R3F camera and canvas.
@@ -378,7 +446,7 @@ interface CadCameraControlsProps {
  * also registered as R3F's default `controls`, which is how anything else in
  * the scene reaches the orbit target.
  */
-declare const CadCameraControls: ({ controlsRef, scheme, freeOrbit, }: CadCameraControlsProps) => null;
+declare const CadCameraControls: ({ controlsRef, scheme, freeOrbit, zoomTo, }: CadCameraControlsProps) => null;
 
 interface ViewerControls {
     /** Frames the part without changing the current viewing direction. */
@@ -430,6 +498,20 @@ interface ViewerProps {
     controls?: ControlScheme;
     /** Orbit past the poles instead of stopping there. On by default. */
     freeOrbit?: boolean;
+    /**
+     * What the wheel zooms toward: the pointer, or the middle of the view.
+     *
+     * `cursor` by default, which is what Fusion does and what most people reach
+     * for. It is a preference rather than a right answer — on a trackpad it can
+     * walk the model off screen.
+     */
+    zoomTo?: 'cursor' | 'centre';
+    /**
+     * Whether a double **middle** click re-frames the part. On by default — it is
+     * the way back from having zoomed into a corner, which zooming to the cursor
+     * makes easy to do.
+     */
+    recentreOnDoubleClick?: boolean;
     /** Lighting and background. The part's own colours are tuned against this rig. */
     theme?: Partial<ViewerTheme>;
     /**
@@ -602,4 +684,4 @@ declare function bestOwner(model: PartModel, owners: readonly FeatureTag[], cont
  */
 declare function cycleOwner(owners: readonly FeatureTag[], current: FeatureTag | null): FeatureTag | null;
 
-export { type ArrowPlacement, Axes, type AxesProps, CHAMFER, CadCameraControls, type CadCameraControlsProps, type ControlScheme, type CubeZone, DirectionArrows, type DirectionArrowsProps, type DirectionGroup, ExtendedCameraControls, type ExtendedCameraControlsOptions, FEATURE_TYPE_RANKS, FeatureTag, FeatureType, Grid, type GridProps, type GridSpec, type NamedDirection, PartModel, PartModelFeature, PartModelRegion, PartReportFormatError, Projection, type RankingContext, RegionIndex, type SurfaceOf, TAP_SLOP, type TapPoint, type TapTracker, TriangleRange, UnsupportedKernelVersionError, VIEW_NAMES, VIEW_SIGNS, Vec3, ViewCube, type ViewCubeProps, type ViewKind, type ViewName, Viewer, ViewerCamera, type ViewerControls, type ViewerHandle, type ViewerProps, ViewerTheme, ViewerView, arrowPlacement, bestOwner, buildRegionIndex, cubeOutlineGeometry, cubeZones, cycleOwner, directionIndexOf, directionLabel, featureTypeRank, gridGeometry, gridSpec, groupByDirection, labelGeometry, labelTexture, movedFar, panelGeometry, rankOwners, regionEdgesGeometry, regionNormals, sameDirection, trackTaps, useContentBox, useTapGuard, useViewerControls, viewKind, viewUp, viewVector, visualSurfaces };
+export { type ArrowPlacement, Axes, type AxesProps, CHAMFER, CadCameraControls, type CadCameraControlsProps, type ControlScheme, type CubeZone, DOUBLE_TAP_MS, DirectionArrows, type DirectionArrowsProps, type DirectionGroup, type DoubleTapPoint, type DoubleTapTracker, ExtendedCameraControls, type ExtendedCameraControlsOptions, FEATURE_TYPE_RANKS, FeatureTag, FeatureType, Grid, type GridProps, type GridSpec, type NamedDirection, PartModel, PartModelFeature, PartModelRegion, PartReportFormatError, Projection, type RankingContext, RegionIndex, type SurfaceOf, TAP_SLOP, type TapPoint, type TapTracker, TriangleRange, UnsupportedKernelVersionError, VIEW_NAMES, VIEW_SIGNS, Vec3, ViewCube, type ViewCubeProps, type ViewKind, type ViewName, Viewer, ViewerCamera, type ViewerControls, type ViewerHandle, type ViewerProps, ViewerTheme, ViewerView, arrowPlacement, bestOwner, buildRegionIndex, cubeOutlineGeometry, cubeZones, cycleOwner, directionIndexOf, directionLabel, featureTypeRank, gridGeometry, gridSpec, groupByDirection, labelGeometry, labelTexture, movedFar, panelGeometry, rankOwners, regionAdjacency, regionEdgesGeometry, regionNormals, sameDirection, squaredUp, trackDoubleTaps, trackTaps, useContentBox, useTapGuard, useViewerControls, viewKind, viewUp, viewVector, visualSurfaces };

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,
@@ -27,6 +29,8 @@ import {
   SectionView,
   TAP_SLOP,
   UnsupportedKernelVersionError,
+  VIEW_NAMES,
+  VIEW_SIGNS,
   Viewer,
   applyHighlightLayers,
   applyProjection,
@@ -41,6 +45,8 @@ import {
   cadViewDirections,
   contentBounds,
   createPart,
+  cubeOutlineGeometry,
+  cubeZones,
   currentViewDirection,
   cycleOwner,
   defaultBounds,
@@ -52,12 +58,16 @@ import {
   fitDistance,
   focusForPick,
   groupByDirection,
+  labelGeometry,
+  labelTexture,
   movedFar,
   normalizePartReport,
   orthographicHalfHeight,
+  panelGeometry,
   perspectiveFitDistance,
   pickedStartDepth,
   rankOwners,
+  regionAdjacency,
   regionEdgesGeometry,
   resolveSectionPlane,
   resolveTheme,
@@ -72,15 +82,20 @@ import {
   sectionOffset,
   sectionPlane,
   smoothRegionNormals,
+  squaredUp,
   startPosition,
   themesEqual,
+  trackDoubleTaps,
   trackTaps,
   useContentBox,
   useTapGuard,
   useViewerControls,
   viewDirection,
+  viewKind,
+  viewUp,
+  viewVector,
   visualSurfaces
-} from "./chunk-RICG6UVH.js";
+} from "./chunk-ILZ2KQUK.js";
 
 // src/primitives.tsx
 import { GizmoHelper } from "@react-three/drei";
@@ -125,233 +140,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 +248,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 +264,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 +276,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 +310,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 +377,7 @@ export {
   DEFAULT_FIT_MARGIN,
   DEFAULT_THEME,
   DIRECTION_COLORS,
+  DOUBLE_TAP_MS,
   DirectionArrows,
   EXCLUDE_FROM_FRAME,
   EnginePart,
@@ -645,6 +439,7 @@ export {
   perspectiveFitDistance,
   pickedStartDepth,
   rankOwners,
+  regionAdjacency,
   regionEdgesGeometry,
   regionNormals,
   resolveSectionPlane,
@@ -660,8 +455,10 @@ export {
   sectionOffset,
   sectionPlane,
   smoothRegionNormals,
+  squaredUp,
   startPosition,
   themesEqual,
+  trackDoubleTaps,
   trackTaps,
   useContentBox,
   useTapGuard,

package/dist/{normalize-W9Lv_Mpg.d.ts → normalize-BXIGoZmc.d.ts}

@@ -5,7 +5,7 @@ import { Group, Mesh, LineSegments, Box3, Plane, BufferGeometry, Camera, Vector3
  * The normalized part — the only thing the renderer consumes.
  *
  * `engine/` produces this; nothing under `model/` or `render/` sees a
- * `PartReportResponse`. The renderer therefore survives an API change, and the
+ * `PartResponse`. The renderer therefore survives an API change, and the
  * viewer can be driven from a local file with no API at all, which is also how
  * it gets tested.
  *
@@ -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;
 
@@ -772,6 +776,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 +814,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'> {
     /**

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@toolpath/viewer",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "React Three Fiber viewer for Toolpath Engine part reports",
   "license": "MIT",
   "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",