@toolpath/viewer 2.0.0 → 2.2.0

package/README.md

@@ -357,9 +357,9 @@ individual buttons to use only the controls and order your application needs.
 </ViewerToolbarProvider>
 ```
 
-`ViewerToolbar.Controls`, `Divider`, and the thirteen `*Button` components are available on
-`ViewerToolbar`: `StockButton`, `AxesButton`, `GridButton`, `BananaButton`, `DirectionsButton`,
-`HoverButton`, `FocusButton`, `WireframeButton`, `SectionButton`, `MeasureButton`, `FitButton`,
+`ViewerToolbar.Controls`, `Divider`, and the fifteen `*Button` components are available on
+`ViewerToolbar`: `StockButton`, `AxesButton`, `GridButton`, `BananaButton`, `ToolsButton`, `DirectionsButton`,
+`DfmButton` (shows or hides an application's DFM flags), `HoverButton`, `FocusButton`, `WireframeButton`, `SectionButton`, `MeasureButton`, `FitButton`,
 `ResetButton`, and `TopButton`. A rendered button requires its matching provider control. For an
 application-specific toolbar component, `useViewerToolbar()` reads the same controls from inside
 the provider.
@@ -388,19 +388,19 @@ override any of these selectors in your application stylesheet.
 The following `data-*` attributes identify generated elements without depending on labels, which
 can change with state or localization:
 
-| Attribute                             | Element and values                                                                                                                              |
-| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
-| `data-viewer-root="true"`             | `<Viewer>` wrapper                                                                                                                              |
-| `data-viewer-canvas-container="true"` | R3F canvas event container                                                                                                                      |
-| `data-viewer-canvas-frame="true"`     | R3F canvas-sizing frame                                                                                                                         |
-| `data-viewer-canvas="true"`           | The `<canvas>` itself                                                                                                                           |
-| `data-viewer-hover-card="true"`       | `<HoverCard>` shell                                                                                                                             |
-| `data-viewer-toolbar="true"`          | Toolbar stack                                                                                                                                   |
-| `data-viewer-toolbar-controls="true"` | Controls group                                                                                                                                  |
-| `data-viewer-toolbar-action`          | Standard button: `stock`, `axes`, `grid`, `banana`, `directions`, `hover`, `focus`, `wireframe`, `section`, `measure`, `fit`, `reset`, or `top` |
-| `data-viewer-toolbar-icon="true"`     | Standard button SVG                                                                                                                             |
-| `data-viewer-toolbar-tooltip="true"`  | Standard button tooltip                                                                                                                         |
-| `data-viewer-toolbar-divider="true"`  | Toolbar separator                                                                                                                               |
+| Attribute                             | Element and values                                                                                                                                       |
+| ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `data-viewer-root="true"`             | `<Viewer>` wrapper                                                                                                                                       |
+| `data-viewer-canvas-container="true"` | R3F canvas event container                                                                                                                               |
+| `data-viewer-canvas-frame="true"`     | R3F canvas-sizing frame                                                                                                                                  |
+| `data-viewer-canvas="true"`           | The `<canvas>` itself                                                                                                                                    |
+| `data-viewer-hover-card="true"`       | `<HoverCard>` shell                                                                                                                                      |
+| `data-viewer-toolbar="true"`          | Toolbar stack                                                                                                                                            |
+| `data-viewer-toolbar-controls="true"` | Controls group                                                                                                                                           |
+| `data-viewer-toolbar-action`          | Standard button: `stock`, `axes`, `grid`, `banana`, `tools`, `directions`, `hover`, `focus`, `wireframe`, `section`, `measure`, `fit`, `reset`, or `top` |
+| `data-viewer-toolbar-icon="true"`     | Standard button SVG                                                                                                                                      |
+| `data-viewer-toolbar-tooltip="true"`  | Standard button tooltip                                                                                                                                  |
+| `data-viewer-toolbar-divider="true"`  | Toolbar separator                                                                                                                                        |
 
 Toggle buttons also carry standard `aria-pressed="true"` or `"false"`; use that to style their
 current state. `Fit`, `Reset`, and `Top view` are actions rather than toggles, so they omit the
@@ -501,6 +501,7 @@ Draws the part and handles clicks. You only use it directly when you
 | `section`         | `SectionOptions`                   | Cut the part open. Omit it to follow the viewer's own cut. See [Section view](#section-view).   |
 | `onSectionChange` | `(state: SectionState) => void`    | Called when the cut moves or goes away. With `section`, passing it also shows the drag handle.  |
 | `onAdjacency`     | `(map) => void`                    | Called once per mesh with which faces touch which.                                              |
+| `children`        | `ReactNode`                        | Objects drawn on the part. They read its model and mesh with `usePartContext()`.                |
 
 Hovering over the part is handled for you. You only need `onHover` if you want to show the hovered
 feature elsewhere in your UI.
@@ -606,6 +607,56 @@ what a label looks like is your stylesheet's, through the `toolpath-measure-labe
 data attributes on each one — see [Measuring](#measuring) for a starting point. While the tool is
 mounted the part reports no hovers or picks, as with `<SectionTool>`.
 
+### `<ToolMarks>`
+
+Cutting tools drawn on the part, each to scale where it stands: a see-through end mill — flat,
+bull nose or ball — or any tool given by its profile, rimmed at its bottom and top, with a dimension
+across its top and a label on it. What a tool stands for is yours: the widest tool a pocket admits, the tool an operation uses.
+Nothing here reads a datasheet.
+
+```tsx
+<EnginePart report={report}>
+  <ToolMarks
+    marks={[
+      {
+        base: { x: 12, y: 4, z: -8 },
+        axis: { x: 0, y: 0, z: 1 },
+        diameter: 6,
+        height: 8,
+        cornerRadius: 0.5,
+        label: '⌀ 6.000 mm',
+        note: 'bull nose R 0.5',
+      },
+    ]}
+  />
+</EnginePart>
+```
+
+| Prop             | What it does                                                                       |
+| ---------------- | ---------------------------------------------------------------------------------- |
+| `marks`          | The tools, in the coordinates the part is drawn in. See `ToolMark` below.          |
+| `visible`        | `false` hides them without unmounting. On by default.                              |
+| `labelClassName` | Added to every label, beside `toolpath-measure-label`.                             |
+| `theme`          | `measure` colours the rims and the dimension, as it does the measure tool's lines. |
+
+A `ToolMark` is `base` (the centre of the tool's bottom), `axis` (up the tool), `diameter`,
+`height`, and optionally `cornerRadius` (0 flat, half the diameter a ball), `across` (which way the
+dimension runs; any direction square to the axis otherwise), `label` and `note`. Any other tool —
+a drill, a chamfer mill, a tool in its holder — takes `profile`: its side as `{ r, z }` points from
+the tip up, such as `@toolpath/tool-drawing`'s outline, turned about the axis in place of the end
+mill.
+
+Show and hide them with `visible`, from the toolbar's `ToolsButton` and its `tools` control.
+
+It draws as `<MeasureTool>` draws: the lines show through the part, and each label is an unstyled
+`<div class="toolpath-measure-label" data-measure-label="tool">` with its text in a
+`data-measure-value` span and its note in a `data-measure-note` one. The marks take no pointer
+events and are left out of framing.
+
+Inside `<PartMesh>` or `<EnginePart>`, `usePartContext()` gives the part's `model` and `geometry`,
+and `featureTriangles(model, geometry, tag)` a feature's triangles, for working out where a tool
+stands.
+
 ### `<Grid>` and `<Axes>`
 
 Reference geometry. The camera ignores both when it frames the part.
@@ -1185,6 +1236,7 @@ is a complete app built this way, with no API key needed.
 | `useViewerToolbar()`  | Inside `<ViewerToolbarProvider>` | Get the actions and state supplied to the provider.                              |
 | `useSectionStore()`   | Inside `<Viewer>`                | Read, set, or subscribe to the viewer's own cut.                                 |
 | `useContentBox()`     | Inside `<Viewer>`                | Get the part's bounding box (a `THREE.Box3`, empty until loaded).                |
+| `usePartContext()`    | Inside `<PartMesh>`              | Get the part's `model` and the `geometry` it is drawn from, for an overlay.      |
 | `useTapGuard()`       | Inside `<Viewer>`                | Check whether a pointer event was a click and not a drag.                        |
 
 ### Helpers
@@ -1198,6 +1250,7 @@ is a complete app built this way, with no API key needed.
 | `focusForPick(pick, lastRegion, lastFocus)`              | Steps through a face's matches on repeated clicks.          |
 | `rankOwners` / `bestOwner`                               | The ranking `onPick` uses, if you want to run it yourself.  |
 | `groupByDirection(model)`                                | Features grouped by machining direction.                    |
+| `featureTriangles(model, geometry, tag)`                 | A feature's triangles and outward normals, as plain arrays. |
 | `directionLabel(v)` / `directionColor(i)`                | A direction's label and colour.                             |
 | `sectionFromPick({ point, normal })`                     | Turns a clicked surface into a section plane.               |
 | `measurementLabel(measurement, format?)`                 | Writes a measurement the way `<MeasureTool>` labels it.     |

package/dist/{chunk-4TBLMR4Z.js → chunk-WTTOUG4P.js}

@@ -13,6 +13,15 @@ import {
 } from "react";
 import { Vector3 as Vector311 } from "three";
 
+// src/part-context.tsx
+import { createContext, useContext } from "react";
+var PartContext = createContext(null);
+var usePartContext = () => {
+  const part = useContext(PartContext);
+  if (!part) throw new Error("usePartContext must be used inside <PartMesh> or <EnginePart>");
+  return part;
+};
+
 // src/model/directions.ts
 var EPSILON = 1e-6;
 function sameDirection(a, b) {
@@ -781,8 +790,8 @@ function perpendicular(axis) {
 // src/tap.tsx
 import { useThree } from "@react-three/fiber";
 import {
-  createContext,
-  useContext,
+  createContext as createContext2,
+  useContext as useContext2,
   useEffect,
   useMemo,
   useRef
@@ -823,10 +832,10 @@ function trackDoubleTaps(within = DOUBLE_TAP_MS, slop = TAP_SLOP) {
 
 // src/tap.tsx
 import { jsx } from "react/jsx-runtime";
-var ViewerTapContext = createContext(null);
+var ViewerTapContext = createContext2(null);
 var ViewerTapProvider = ({ value, children }) => /* @__PURE__ */ jsx(ViewerTapContext.Provider, { value, children });
 function useTapGuard() {
-  const shared = useContext(ViewerTapContext);
+  const shared = useContext2(ViewerTapContext);
   const domElement = useThree((state) => state.gl.domElement);
   const tracker = useRef(null);
   useEffect(() => {
@@ -1319,10 +1328,10 @@ function focusForPick(pick, previousRegion, previousFocus) {
 // src/viewer.tsx
 import { Canvas, useFrame as useFrame3, useThree as useThree4 } from "@react-three/fiber";
 import {
-  createContext as createContext2,
+  createContext as createContext3,
   forwardRef,
   useCallback,
-  useContext as useContext2,
+  useContext as useContext3,
   useEffect as useEffect4,
   useImperativeHandle,
   useMemo as useMemo4,
@@ -2193,20 +2202,20 @@ function labelTexture(label, color) {
 
 // src/viewer.tsx
 import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
-var ViewerControlsContext = createContext2(null);
+var ViewerControlsContext = createContext3(null);
 var useViewerControls = () => {
-  const controls = useContext2(ViewerControlsContext);
+  const controls = useContext3(ViewerControlsContext);
   if (!controls) throw new Error("useViewerControls must be used inside <Viewer>");
   return controls;
 };
-var SectionStoreContext = createContext2(null);
+var SectionStoreContext = createContext3(null);
 var useSectionStore = () => {
-  const store = useContext2(SectionStoreContext);
+  const store = useContext3(SectionStoreContext);
   if (!store) throw new Error("useSectionStore must be used inside <Viewer>");
   return store;
 };
-var ViewerRetargetContext = createContext2(null);
-var useRetarget = () => useContext2(ViewerRetargetContext);
+var ViewerRetargetContext = createContext3(null);
+var useRetarget = () => useContext3(ViewerRetargetContext);
 var ViewerScene = ({
   children,
   setControls,
@@ -3029,9 +3038,11 @@ var PartMesh = ({
   onPick,
   theme,
   showEdges = true,
-  display = "solid"
+  display = "solid",
+  children
 }) => {
   const { camera, controls, invalidate } = useThree7();
+  const context = useMemo6(() => ({ model, geometry }), [model, geometry]);
   const viewerControls = useViewerControls();
   const resolved = useStableTheme(theme);
   const currentTheme = useRef6(resolved);
@@ -3243,7 +3254,8 @@ var PartMesh = ({
         showHandle: !controlled || onSectionChange !== void 0,
         onDrag: !controlled || onSectionChange ? dragSection : void 0
       }
-    ) : null
+    ) : null,
+    children ? /* @__PURE__ */ jsx5(PartContext.Provider, { value: context, children }) : null
   ] });
 };
 var ORIGIN = new Vector311();
@@ -3890,6 +3902,7 @@ function useGeometryResource(part) {
 }
 
 export {
+  usePartContext,
   sameDirection,
   directionIndexOf,
   groupByDirection,

package/dist/engine/index.d.ts

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

package/dist/engine/index.js

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

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { P as PartModel, d as PartPick, V as Vec3, R as RegionHighlight, e as ViewerTheme, S as SectionOptions, f as SectionState, g as PartModelRegion, T as TriangleRange, F as FeatureTag, h as RegionIndex, i as PartModelFeature, j as FeatureType } from './normalize-CvnV9Ggh.js';
-export { A as AXES_PLANE_OFFSET, k as AXES_PLANE_SCALE, l as AxesPlane, B as BuildPickInput, C as CANDIDATE_WEIGHT, m as CAP_HATCH, D as DEFAULT_SECTION_NORMAL, o as DEFAULT_THEME, p as DIRECTION_COLORS, q as DISABLED_SECTION, E as EnginePart, r as FeatureHighlight, t as FocusOptions, H as HANDLE_PIXELS, u as HIGHLIGHT_COLORS, v as HIGHLIGHT_WEIGHT, w as HOVER_WEIGHT, x as HighlightLayers, K as KnownFeatureType, y as KnownShapeKind, N as NO_MODIFIERS, O as OUTLINE_SCALE, z as PICKED_SURFACE_LABEL, G as PREVIEW_SCALE, I as PartDisplay, J as PartMesh, L as PartMeshProps, a as PartMeshRefs, Q as PartObject, U as PickModifiers, W as PointerLocation, X as REGION_ATTRIBUTE, Y as RegionPaint, Z as SECTION_GIZMO_FRAME_SCALE, _ as SECTION_RENDER_ORDER, $ as SectionAnchor, a0 as SectionBounds, a1 as SectionPlacement, a2 as ShapeKind, a3 as SurfaceHit, a4 as applyHighlightLayers, a5 as axesPlanes, a6 as buildPick, a7 as buildRegionAttribute, a8 as buildRegionTexels, a9 as createPart, aa as directionColor, ab as dragPlane, ac as focusForPick, ad as hitUnderRay, n as normalizePartReport, ae as pickedStartDepth, af as resolveTheme, ag as sectionAnchor, ah as sectionBounds, ai as sectionConstant, aj as sectionDepth, ak as sectionDepthConstant, al as sectionDepthRange, am as sectionFromPick, an as sectionMeasurement, ao as sectionOffset, ap as sectionOptionsFromState, aq as sectionPlane, s as smoothRegionNormals, ar as surfaceUnderRay, as as themesEqual, at as viewDirection } from './normalize-CvnV9Ggh.js';
+import { P as PartModel, F as FeatureTag, d as PartPick, V as Vec3, R as RegionHighlight, e as ViewerTheme, S as SectionOptions, f as SectionState, g as PartModelRegion, T as TriangleRange, h as RegionIndex, i as PartModelFeature, j as FeatureType } from './normalize--FiXUhO4.js';
+export { A as AXES_PLANE_OFFSET, k as AXES_PLANE_SCALE, l as AxesPlane, B as BuildPickInput, C as CANDIDATE_WEIGHT, m as CAP_HATCH, D as DEFAULT_SECTION_NORMAL, o as DEFAULT_THEME, p as DIRECTION_COLORS, q as DISABLED_SECTION, E as EnginePart, r as FeatureHighlight, t as FocusOptions, H as HANDLE_PIXELS, u as HIGHLIGHT_COLORS, v as HIGHLIGHT_WEIGHT, w as HOVER_WEIGHT, x as HighlightLayers, K as KnownFeatureType, y as KnownShapeKind, N as NO_MODIFIERS, O as OUTLINE_SCALE, z as PICKED_SURFACE_LABEL, G as PREVIEW_SCALE, I as PartDisplay, J as PartMesh, L as PartMeshProps, a as PartMeshRefs, Q as PartObject, U as PickModifiers, W as PointerLocation, X as REGION_ATTRIBUTE, Y as RegionPaint, Z as SECTION_GIZMO_FRAME_SCALE, _ as SECTION_RENDER_ORDER, $ as SectionAnchor, a0 as SectionBounds, a1 as SectionPlacement, a2 as ShapeKind, a3 as SurfaceHit, a4 as applyHighlightLayers, a5 as axesPlanes, a6 as buildPick, a7 as buildRegionAttribute, a8 as buildRegionTexels, a9 as createPart, aa as directionColor, ab as dragPlane, ac as focusForPick, ad as hitUnderRay, n as normalizePartReport, ae as pickedStartDepth, af as resolveTheme, ag as sectionAnchor, ah as sectionBounds, ai as sectionConstant, aj as sectionDepth, ak as sectionDepthConstant, al as sectionDepthRange, am as sectionFromPick, an as sectionMeasurement, ao as sectionOffset, ap as sectionOptionsFromState, aq as sectionPlane, s as smoothRegionNormals, ar as surfaceUnderRay, as as themesEqual, at as viewDirection } from './normalize--FiXUhO4.js';
 import { BufferGeometry, Box3, CanvasTexture, Plane, Vector3, OrthographicCamera, PerspectiveCamera, Object3D, Matrix4, Vector2, Ray, ShaderMaterial, Texture, Color, MeshBasicMaterial, WebGLRenderTarget } from 'three';
 import * as react from 'react';
 import { ReactNode, PropsWithChildren, RefObject, CSSProperties } from 'react';
@@ -13,6 +13,49 @@ import CameraControls from 'camera-controls';
  */
 declare function regionAdjacency(model: PartModel, geometry: BufferGeometry): Map<number, Set<number>>;
 
+/**
+ * A feature's faces as plain triangles: what something placed on the part
+ * fits itself against, without needing three.js to read them.
+ */
+interface FeatureTriangles {
+    /** Nine numbers a triangle — its three corners, x, y, z each — in the geometry's coordinates. */
+    readonly positions: Float32Array;
+    /** Three a triangle: its unit normal, pointing out of the part. */
+    readonly normals: Float32Array;
+}
+/**
+ * Every triangle of a feature's faces, read out of the mesh through the
+ * region index.
+ *
+ * Each normal is the mesh's own where it has them — the average of the three
+ * corners' — because they say which side is outside whatever order a
+ * triangle's corners are wound in. A mesh without normals gives each triangle
+ * its winding's. A triangle with no area has no normal and is left out.
+ *
+ * Indexed and non-indexed meshes both read: triangle `t` is corners `3t` to
+ * `3t + 2` of the index where there is one, of the positions where there is
+ * not. Empty for a tag the part does not have, or a geometry with no positions.
+ */
+declare function featureTriangles(model: Pick<PartModel, 'regionIndex'>, geometry: BufferGeometry, tag: FeatureTag): FeatureTriangles;
+
+/**
+ * The part an overlay is drawn on: its model and the mesh `<PartMesh>` draws.
+ *
+ * `<EnginePart>` loads its mesh itself, so a child of it has no other way to
+ * reach the geometry — and an overlay placed on the part, such as
+ * `<ToolMarks>` at a feature's faces, needs the triangles it is drawn against.
+ */
+interface PartContextValue {
+    readonly model: PartModel;
+    /** In the coordinates the part is drawn in: the caller's, whatever it did to centre it. */
+    readonly geometry: BufferGeometry;
+}
+/**
+ * The part this is drawn inside: a child of `<PartMesh>` or `<EnginePart>`.
+ * Throws anywhere else, as `useViewerControls` does outside `<Viewer>`.
+ */
+declare const usePartContext: () => PartContextValue;
+
 interface HoverCardProps {
     /** The current `onHover` pick, or `null` after the pointer leaves the part. */
     pick: PartPick | null;
@@ -44,7 +87,10 @@ interface ViewerToolbarControls {
     axes?: ViewerToolbarControl;
     grid?: ViewerToolbarControl;
     banana?: ViewerToolbarControl;
+    /** Tools drawn on the part: see `<ToolMarks>`. */
+    tools?: ViewerToolbarControl;
     directions?: ViewerToolbarControl;
+    dfm?: ViewerToolbarControl;
     hover?: ViewerToolbarControl;
     focus?: ViewerToolbarControl;
     wireframe?: ViewerToolbarControl;
@@ -84,7 +130,9 @@ declare const ViewerToolbar: (({ className, children }: ViewerToolbarProps) => r
     AxesButton: () => react.JSX.Element;
     GridButton: () => react.JSX.Element;
     BananaButton: () => react.JSX.Element;
+    ToolsButton: () => react.JSX.Element;
     DirectionsButton: () => react.JSX.Element;
+    DfmButton: () => react.JSX.Element;
     HoverButton: () => react.JSX.Element;
     FocusButton: () => react.JSX.Element;
     WireframeButton: () => react.JSX.Element;
@@ -947,6 +995,81 @@ interface MeasureToolProps {
  */
 declare const MeasureTool: ({ mode, measurements, onChange, showDeltas, format, labelClassName, theme, }: MeasureToolProps) => react.JSX.Element | null;
 
+/**
+ * A cutting tool drawn on the part: an end mill standing at a place, up an
+ * axis, to scale. What it stands for — the widest tool a pocket admits, the
+ * tool an operation uses — is the caller's; this is only where and how big.
+ */
+interface ToolMark {
+    /** The centre of the tool's bottom, in the coordinates the part is drawn in. */
+    readonly base: Vec3;
+    /** Up the tool, from its tip to its shank. Need not be unit length. */
+    readonly axis: Vec3;
+    readonly diameter: number;
+    /** How tall the drawn tool stands from its tip. */
+    readonly height: number;
+    /**
+     * The radius on the tool's corner: 0 for a flat end mill, half the diameter
+     * for a ball, anything between for a bull nose. Held to that range.
+     */
+    readonly cornerRadius?: number;
+    /**
+     * Which way the dimension across the tool's top runs: toward what it
+     * touches, say. Any direction square to the axis when left out or along it.
+     */
+    readonly across?: Vec3;
+    /**
+     * The tool's own side, to turn about its axis in place of the end mill
+     * `diameter` and `cornerRadius` make: radius out from the axis and height
+     * above the tip, from the tip up — `@toolpath/tool-drawing`'s outline of a
+     * drill, a chamfer mill, a tool in its holder. `diameter` and `height` still
+     * place the rims and the dimension.
+     */
+    readonly profile?: readonly ToolProfilePoint[];
+    /** Written on the dimension: `⌀ 3.200 mm`. */
+    readonly label?: string;
+    /** After the label, quieter: `bull nose R 0.5 · 3 places`. */
+    readonly note?: string;
+}
+/** A point on a tool's side: radius out from its axis and height above its tip. */
+interface ToolProfilePoint {
+    readonly r: number;
+    readonly z: number;
+}
+
+interface ToolMarksProps {
+    /** The tools to draw, in the coordinates the part is drawn in. */
+    marks: readonly ToolMark[];
+    /** Draws nothing while false, and keeps its place in the scene. On by default. */
+    visible?: boolean;
+    /**
+     * Added to every label's `className`, beside {@link MEASURE_LABEL_CLASS} —
+     * a Tailwind utility list, or a CSS module's class.
+     */
+    labelClassName?: string;
+    /** `measure` colours the rims and the dimension, as it does the measure tool's lines. */
+    theme?: Partial<ViewerTheme>;
+}
+/**
+ * Cutting tools drawn on the part, each to scale where it stands: a
+ * see-through end mill — flat, bull nose or ball — or any tool turned from its
+ * `profile`, rimmed at its bottom and top, with a dimension across its top and
+ * a label on it. Mount it inside
+ * `<Viewer>`, beside or inside the part.
+ *
+ * What a tool stands for is the caller's. A DFM panel stands the widest tool
+ * a pocket admits in its tightest place; a plan could show the tool an
+ * operation uses. Nothing here reads a datasheet.
+ *
+ * Drawn as the measure tool draws: the lines show through the part, in the
+ * theme's `measure` colour, and the labels are unstyled DOM elements with the
+ * {@link MEASURE_LABEL_CLASS} class and `data-measure-label="tool"`, the
+ * label's text in a `data-measure-value` span and its note in a
+ * `data-measure-note` one. The marks take no pointer events and are left out
+ * of framing, so fitting the view fits the part.
+ */
+declare const ToolMarks: ({ marks, visible, labelClassName, theme }: ToolMarksProps) => react.JSX.Element;
+
 /**
  * The cut a viewer holds for itself, when nobody else is holding it.
  *
@@ -1854,4 +1977,4 @@ declare const ORBIT_TARGET_FADE_MS = 1000;
  */
 declare function orbitTargetOpacity(sinceHold: number, fade?: number): number;
 
-export { ANGLE_ARC_FRACTION, ANGLE_ARC_SEGMENTS, AXIS_COLORS, type AngleMeasurement, type ArrowPlacement, Axes, type AxesProps, type Axis, type AxisLock, BANANA_GAP, BANANA_MODEL_URL, Banana, type BananaProps, type BoxStockFigure, type BoxStockInput, type BoxStockPreview, CAD_CAMERA_UP, CHAMFER, CONTROL_SCHEME_OPTIONS, CadCameraControls, type CadCameraControlsProps, type CameraLimits, type CapMaterial, type CapUniforms, type ControlScheme, type ControlSchemeOption, type CubeZone, type CylinderStockFigure, type CylinderStockInput, type CylinderStockPreview, DEFAULT_FIT_MARGIN, DELTA_DASH_PIXELS, DOUBLE_TAP_MS, type DeltaLeg, DirectionArrows, type DirectionArrowsProps, type DirectionGroup, type DistanceMeasurement, type DoubleTapPoint, type DoubleTapTracker, EXCLUDE_FROM_FRAME, ExtendedCameraControls, type ExtendedCameraControlsOptions, FEATURE_TYPE_RANKS, FeatureTag, FeatureType, Grid, type GridProps, type GridSpec, HoverCard, type HoverCardProps, MAX_FRAME_RATIO, MEASURE_LABEL_CLASS, MEASURE_LINE_PIXELS, MEASURE_MARKER_PIXELS, MEASURE_RENDER_ORDER, MIN_FRAME_RATIO, type MeasureLabelKind, type MeasureMode, MeasureTool, type MeasureToolProps, type Measurement, type NamedDirection, 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, POINTS_PER_MEASUREMENT, PartModel, PartModelFeature, PartModelRegion, PartPick, PartReportFormatError, type Projection, type RankingContext, RegionHighlight, RegionIndex, type Retarget, type RetargetPose, SNAP_MARKER_PIXELS, SNAP_PIXELS, type SceneBounds, SectionOptions, type SectionSample, SectionState, type SectionStore, SectionTool, type SectionToolProps, SectionView, type Snap, type SnapEdges, type SnapHit, type SnapKind, Stock, type StockAllowance, type StockAppearanceProps, type StockPosition, type StockProps, type StockSource, type SurfaceOf, TAP_SLOP, type TapPoint, type TapTracker, TriangleRange, UnsupportedKernelVersionError, VIEW_NAMES, VIEW_SIGNS, Vec3, ViewCube, type ViewCubeProps, type ViewKind, type ViewName, Viewer, type ViewerCamera, type ViewerControls, type ViewerHandle, type ViewerProps, ViewerTheme, ViewerToolbar, type ViewerToolbarControl, type ViewerToolbarControls, type ViewerToolbarControlsProps, type ViewerToolbarProps, ViewerToolbarProvider, type ViewerView, type ViewportSize, adaptedUp, angleArc, angleArcRadius, angleAt, applyCapTheme, applyProjection, arrowPlacement, aspectRatio, bananaFrameBounds, bananaPosition, bestOwner, boundsFromBox, boxStockBounds, buildRegionIndex, cadViewDirections, cameraLimits, capHit, clipSegments, contentBounds, createCapMaterial, createMaskMaterial, createMaskTarget, createSectionStore, createStencilMaterials, cubeOutlineGeometry, cubeZones, currentViewDirection, cycleOwner, defaultBounds, deltaBetween, deltaLegs, directionHighlights, directionIndexOf, directionLabel, distanceBetween, excludedFromFrame, featureTypeRank, fitDistance, fixedBoxStockBounds, formatDegrees, formatMillimetres, gridGeometry, gridSpec, groupByDirection, labelGeometry, labelTexture, lockToAxis, measurementFromPoints, measurementLabel, measurementLabelAnchor, midpoint, movedFar, nextMeasurementId, orbitTargetOpacity, orthographicHalfHeight, panelGeometry, perspectiveFitDistance, pointInContour, rankOwners, regionAdjacency, regionEdgesGeometry, regionNormals, resolveSectionPlane, retargetPose, sameDirection, sampleSection, screenLength, screenPoint, sectionContour, snapAt, squaredUp, startPosition, targetBoundary, trackDoubleTaps, trackTaps, useContentBox, useRetarget, useSectionStore, useTapGuard, useViewerControls, useViewerToolbar, viewKind, viewUp, viewVector, visualSurfaces };
+export { ANGLE_ARC_FRACTION, ANGLE_ARC_SEGMENTS, AXIS_COLORS, type AngleMeasurement, type ArrowPlacement, Axes, type AxesProps, type Axis, type AxisLock, BANANA_GAP, BANANA_MODEL_URL, Banana, type BananaProps, type BoxStockFigure, type BoxStockInput, type BoxStockPreview, CAD_CAMERA_UP, CHAMFER, CONTROL_SCHEME_OPTIONS, CadCameraControls, type CadCameraControlsProps, type CameraLimits, type CapMaterial, type CapUniforms, type ControlScheme, type ControlSchemeOption, type CubeZone, type CylinderStockFigure, type CylinderStockInput, type CylinderStockPreview, DEFAULT_FIT_MARGIN, DELTA_DASH_PIXELS, DOUBLE_TAP_MS, type DeltaLeg, DirectionArrows, type DirectionArrowsProps, type DirectionGroup, type DistanceMeasurement, type DoubleTapPoint, type DoubleTapTracker, EXCLUDE_FROM_FRAME, ExtendedCameraControls, type ExtendedCameraControlsOptions, FEATURE_TYPE_RANKS, FeatureTag, type FeatureTriangles, FeatureType, Grid, type GridProps, type GridSpec, HoverCard, type HoverCardProps, MAX_FRAME_RATIO, MEASURE_LABEL_CLASS, MEASURE_LINE_PIXELS, MEASURE_MARKER_PIXELS, MEASURE_RENDER_ORDER, MIN_FRAME_RATIO, type MeasureLabelKind, type MeasureMode, MeasureTool, type MeasureToolProps, type Measurement, type NamedDirection, 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, POINTS_PER_MEASUREMENT, type PartContextValue, PartModel, PartModelFeature, PartModelRegion, PartPick, PartReportFormatError, type Projection, type RankingContext, RegionHighlight, RegionIndex, type Retarget, type RetargetPose, SNAP_MARKER_PIXELS, SNAP_PIXELS, type SceneBounds, SectionOptions, type SectionSample, SectionState, type SectionStore, SectionTool, type SectionToolProps, SectionView, type Snap, type SnapEdges, type SnapHit, type SnapKind, Stock, type StockAllowance, type StockAppearanceProps, type StockPosition, type StockProps, type StockSource, type SurfaceOf, TAP_SLOP, type TapPoint, type TapTracker, type ToolMark, ToolMarks, type ToolMarksProps, type ToolProfilePoint, TriangleRange, UnsupportedKernelVersionError, VIEW_NAMES, VIEW_SIGNS, Vec3, ViewCube, type ViewCubeProps, type ViewKind, type ViewName, Viewer, type ViewerCamera, type ViewerControls, type ViewerHandle, type ViewerProps, ViewerTheme, ViewerToolbar, type ViewerToolbarControl, type ViewerToolbarControls, type ViewerToolbarControlsProps, type ViewerToolbarProps, ViewerToolbarProvider, type ViewerView, type ViewportSize, adaptedUp, angleArc, angleArcRadius, angleAt, applyCapTheme, applyProjection, arrowPlacement, aspectRatio, bananaFrameBounds, bananaPosition, bestOwner, boundsFromBox, boxStockBounds, buildRegionIndex, cadViewDirections, cameraLimits, capHit, clipSegments, contentBounds, createCapMaterial, createMaskMaterial, createMaskTarget, createSectionStore, createStencilMaterials, cubeOutlineGeometry, cubeZones, currentViewDirection, cycleOwner, defaultBounds, deltaBetween, deltaLegs, directionHighlights, directionIndexOf, directionLabel, distanceBetween, excludedFromFrame, featureTriangles, featureTypeRank, fitDistance, fixedBoxStockBounds, formatDegrees, formatMillimetres, gridGeometry, gridSpec, groupByDirection, labelGeometry, labelTexture, lockToAxis, measurementFromPoints, measurementLabel, measurementLabelAnchor, midpoint, movedFar, nextMeasurementId, orbitTargetOpacity, orthographicHalfHeight, panelGeometry, perspectiveFitDistance, pointInContour, rankOwners, regionAdjacency, regionEdgesGeometry, regionNormals, resolveSectionPlane, retargetPose, sameDirection, sampleSection, screenLength, screenPoint, sectionContour, snapAt, squaredUp, startPosition, targetBoundary, trackDoubleTaps, trackTaps, useContentBox, usePartContext, useRetarget, useSectionStore, useTapGuard, useViewerControls, useViewerToolbar, viewKind, viewUp, viewVector, visualSurfaces };

package/dist/index.js

@@ -152,6 +152,7 @@ import {
   trackDoubleTaps,
   trackTaps,
   useContentBox,
+  usePartContext,
   useRetarget,
   useSectionStore,
   useTapGuard,
@@ -161,7 +162,50 @@ import {
   viewUp,
   viewVector,
   visualSurfaces
-} from "./chunk-4TBLMR4Z.js";
+} from "./chunk-WTTOUG4P.js";
+
+// src/render/feature-triangles.ts
+var EMPTY = { positions: new Float32Array(), normals: new Float32Array() };
+function featureTriangles(model, geometry, tag) {
+  const position = geometry.getAttribute("position");
+  if (!position) return EMPTY;
+  const normal = geometry.getAttribute("normal");
+  const index = geometry.getIndex();
+  const vertex = (corner) => index ? index.getX(corner) : corner;
+  const triangleCount = Math.floor((index ? index.count : position.count) / 3);
+  const positions = [];
+  const normals = [];
+  for (const region of new Set(model.regionIndex.regionsForFeature(tag))) {
+    const range = model.regionIndex.rangeForRegion(region);
+    if (!range) continue;
+    for (let triangle = range.start; triangle < Math.min(range.end, triangleCount); triangle++) {
+      const corners = [vertex(triangle * 3), vertex(triangle * 3 + 1), vertex(triangle * 3 + 2)];
+      const at = corners.map((corner) => [
+        position.getX(corner),
+        position.getY(corner),
+        position.getZ(corner)
+      ]);
+      const out = normal ? corners.reduce(
+        (sum, corner) => [
+          sum[0] + normal.getX(corner),
+          sum[1] + normal.getY(corner),
+          sum[2] + normal.getZ(corner)
+        ],
+        [0, 0, 0]
+      ) : winding(at);
+      const length = Math.hypot(out[0], out[1], out[2]);
+      if (length === 0) continue;
+      positions.push(...at[0], ...at[1], ...at[2]);
+      normals.push(out[0] / length, out[1] / length, out[2] / length);
+    }
+  }
+  return { positions: new Float32Array(positions), normals: new Float32Array(normals) };
+}
+var winding = ([a, b, c]) => {
+  const u = [b[0] - a[0], b[1] - a[1], b[2] - a[2]];
+  const v = [c[0] - a[0], c[1] - a[1], c[2] - a[2]];
+  return [u[1] * v[2] - u[2] * v[1], u[2] * v[0] - u[0] * v[2], u[0] * v[1] - u[1] * v[0]];
+};
 
 // src/hover-card.tsx
 import { useEffect, useState } from "react";
@@ -222,7 +266,9 @@ var StockIcon = () => /* @__PURE__ */ jsx2(SvgIcon, { children: /* @__PURE__ */
 var AxesIcon = () => /* @__PURE__ */ jsx2(SvgIcon, { children: /* @__PURE__ */ jsx2("path", { d: "M5 19V3m0 16h16M5 19l10-10M2 6l3-3 3 3m10 10 3 3-3 3M11 9h4v4" }) });
 var GridIcon = () => /* @__PURE__ */ jsx2(SvgIcon, { children: /* @__PURE__ */ jsx2("path", { d: "M3 8l9-5 9 5-9 5zM3 8v8l9 5 9-5V8M12 13v8M7.5 5.5v8M16.5 5.5v8" }) });
 var BananaIcon = () => /* @__PURE__ */ jsx2(SvgIcon, { viewBox: "0 0 576 512", fill: "currentColor", children: /* @__PURE__ */ jsx2("path", { d: "M284.2 245.6c12.99 6.929 25.35 15.14 36.08 25.8L334.5 285.6l65.75-23.47c14.75-5.265 30.18-7.849 45.81-8.389c1.154-10.73 1.764-21.38 1.764-31.87c0-118.5-81.33-221.9-119.7-221.9c-21.01 0-40.91 17.04-40.91 39.25c0 16.18 16.74 41.9 16.74 103C303.1 170.1 300.6 203.1 284.2 245.6zM575.1 389.6c0-3.687-.8637-7.429-2.687-10.93l-15.12-29.11c-21.05-40.53-63.08-64.51-106.9-64.51c-13.43 0-27.02 2.252-40.22 6.969l-84.84 30.27l-28.59-28.41C274.4 270.9 243.7 258.1 212.8 258.1c-23.72 0-47.57 6.97-68.29 21.2L106.3 306.4c-6.732 4.631-10.35 12.07-10.35 19.63c0 14.93 12.7 23.87 24.04 23.87c4.695 0 9.443-1.376 13.61-4.26l38.13-26.23c12.43-8.525 26.71-12.69 40.91-12.69c10.64 0 21.24 2.339 30.97 6.934c-50.62 62.23-128.3 99.85-211.4 99.85C14.42 413.5 0 427.8 0 445.5v31.38c0 17.68 14.66 32.02 32.46 32.02l28.98.0009c14.15 0 34.69 1.098 59.07 1.098c93.51 0 243.4-16.15 304.8-172.4c9.021-3.22 17.95-4.712 26.53-4.712c27.65 0 51.7 15.49 63.7 38.55l15.12 29.11c3.484 6.723 11.74 12.98 21.41 12.98C564.1 413.6 575.1 403.8 575.1 389.6z" }) });
+var ToolsIcon = () => /* @__PURE__ */ jsx2(SvgIcon, { children: /* @__PURE__ */ jsx2("path", { d: "M9 2h6v7H9zM9.5 9v9.5l2.5 3.5 2.5-3.5V9M9.5 12l5 2.5M9.5 15.5l5 2.5" }) });
 var DirectionsIcon = () => /* @__PURE__ */ jsx2(SvgIcon, { children: /* @__PURE__ */ jsx2("path", { d: "M7 3v18m-4-4 4 4 4-4M17 21V3m-4 4 4-4 4 4" }) });
+var DfmIcon = () => /* @__PURE__ */ jsx2(SvgIcon, { children: /* @__PURE__ */ jsx2("path", { d: "M8.3 3h7.4L21 8.3v7.4L15.7 21H8.3L3 15.7V8.3zM12 7.5v5.5m0 3.5v.01" }) });
 var HoverIcon = () => /* @__PURE__ */ jsx2(SvgIcon, { children: /* @__PURE__ */ jsx2("path", { d: "M4 4h16v12H9l-5 4zm4 5h8m-8 3h5" }) });
 var FocusIcon = () => /* @__PURE__ */ jsx2(SvgIcon, { children: /* @__PURE__ */ jsx2("path", { d: "M4 4h16v16H4zM8 8h8v8H8zM2 12h4m12 0h4M12 2v4m0 12v4" }) });
 var WireframeIcon = () => /* @__PURE__ */ jsx2(SvgIcon, { children: /* @__PURE__ */ jsx2("path", { d: "M4 7l8-4 8 4v10l-8 4-8-4zM4 7l8 4 8-4M12 11v10M4 17l8-4 8 4M12 3v10" }) });
@@ -236,7 +282,9 @@ var ICONS = {
   axes: AxesIcon,
   grid: GridIcon,
   banana: BananaIcon,
+  tools: ToolsIcon,
   directions: DirectionsIcon,
+  dfm: DfmIcon,
   hover: HoverIcon,
   focus: FocusIcon,
   wireframe: WireframeIcon,
@@ -315,6 +363,14 @@ var BananaButton = () => /* @__PURE__ */ jsx3(
     label: (pressed) => pressed ? "Banana for scale (on)" : "Banana for scale"
   }
 );
+var ToolsButton = () => /* @__PURE__ */ jsx3(
+  ToolbarButton,
+  {
+    action: "tools",
+    icon: "tools",
+    label: (pressed) => pressed ? "Hide tools on the part" : "Show tools on the part"
+  }
+);
 var DirectionsButton = () => /* @__PURE__ */ jsx3(
   ToolbarButton,
   {
@@ -323,6 +379,14 @@ var DirectionsButton = () => /* @__PURE__ */ jsx3(
     label: () => "Highlight faces by direction"
   }
 );
+var DfmButton = () => /* @__PURE__ */ jsx3(
+  ToolbarButton,
+  {
+    action: "dfm",
+    icon: "dfm",
+    label: (pressed) => pressed ? "Hide DFM flags" : "Show DFM flags"
+  }
+);
 var HoverButton = () => /* @__PURE__ */ jsx3(
   ToolbarButton,
   {
@@ -376,10 +440,12 @@ var DefaultControls = () => {
     controls.stock ? /* @__PURE__ */ jsx3(StockButton, {}, "stock") : null,
     controls.axes ? /* @__PURE__ */ jsx3(AxesButton, {}, "axes") : null,
     controls.grid ? /* @__PURE__ */ jsx3(GridButton, {}, "grid") : null,
-    controls.banana ? /* @__PURE__ */ jsx3(BananaButton, {}, "banana") : null
+    controls.banana ? /* @__PURE__ */ jsx3(BananaButton, {}, "banana") : null,
+    controls.tools ? /* @__PURE__ */ jsx3(ToolsButton, {}, "tools") : null
   ].filter(Boolean);
   const analysis = [
     controls.directions ? /* @__PURE__ */ jsx3(DirectionsButton, {}, "directions") : null,
+    controls.dfm ? /* @__PURE__ */ jsx3(DfmButton, {}, "dfm") : null,
     controls.hover ? /* @__PURE__ */ jsx3(HoverButton, {}, "hover") : null,
     controls.focus ? /* @__PURE__ */ jsx3(FocusButton, {}, "focus") : null,
     controls.wireframe ? /* @__PURE__ */ jsx3(WireframeButton, {}, "wireframe") : null,
@@ -417,7 +483,9 @@ var ViewerToolbar = Object.assign(ViewerToolbarRoot, {
   AxesButton,
   GridButton,
   BananaButton,
+  ToolsButton,
   DirectionsButton,
+  DfmButton,
   HoverButton,
   FocusButton,
   WireframeButton,
@@ -2168,6 +2236,145 @@ function className(extra) {
   return extra ? `${MEASURE_LABEL_CLASS} ${extra}` : MEASURE_LABEL_CLASS;
 }
 
+// src/tool-marks.tsx
+import { Html as Html2, Line as Line2 } from "@react-three/drei";
+import { useMemo as useMemo7 } from "react";
+import { DoubleSide as DoubleSide2 } from "three";
+
+// src/render/tool-marks.ts
+import { Quaternion as Quaternion4, Vector2 as Vector23, Vector3 as Vector38 } from "three";
+var TOOL_CORNER_STEPS = 12;
+var TOOL_ROUND = 64;
+function toolProfile(radius, corner, height) {
+  const rounded = Math.min(Math.max(corner, 0), radius);
+  const flat = radius - rounded;
+  const points = [new Vector23(0, 0)];
+  if (rounded <= 0) {
+    points.push(new Vector23(radius, 0));
+  } else {
+    for (let step = 0; step <= TOOL_CORNER_STEPS; step++) {
+      const angle = step / TOOL_CORNER_STEPS * (Math.PI / 2);
+      points.push(
+        new Vector23(flat + Math.sin(angle) * rounded, rounded - Math.cos(angle) * rounded)
+      );
+    }
+  }
+  points.push(new Vector23(radius, Math.max(height, rounded)));
+  return points;
+}
+var UP = new Vector38(0, 1, 0);
+var AXES = [new Vector38(1, 0, 0), new Vector38(0, 1, 0), new Vector38(0, 0, 1)];
+var toVector = ({ x, y, z }) => new Vector38(x, y, z);
+var squareTo = (w, along) => {
+  const wanted = along ? toVector(along) : null;
+  const flat = wanted?.clone().addScaledVector(w, -wanted.dot(w));
+  if (flat && flat.lengthSq() > 1e-12) return flat.normalize();
+  const least = AXES.reduce(
+    (best, axis) => Math.abs(axis.dot(w)) < Math.abs(best.dot(w)) ? axis : best
+  );
+  return least.clone().addScaledVector(w, -least.dot(w)).normalize();
+};
+var circle = (centre, u, v, radius) => Array.from({ length: TOOL_ROUND + 1 }, (_, step) => {
+  const angle = step / TOOL_ROUND * Math.PI * 2;
+  return centre.clone().addScaledVector(u, Math.cos(angle) * radius).addScaledVector(v, Math.sin(angle) * radius);
+});
+var tickLength = (diameter) => Math.min(Math.max(diameter * 0.15, 0.3), 3);
+function toolMarkShape(mark) {
+  const axis = toVector(mark.axis);
+  if (!(mark.diameter > 0) || axis.lengthSq() === 0) return null;
+  const w = axis.normalize();
+  const u = squareTo(w, mark.across);
+  const v = new Vector38().crossVectors(w, u);
+  const radius = mark.diameter / 2;
+  const corner = Math.min(Math.max(mark.cornerRadius ?? 0, 0), radius);
+  const height = Math.max(mark.height, corner);
+  const base = toVector(mark.base);
+  const top = base.clone().addScaledVector(w, height);
+  const dimension = [
+    top.clone().addScaledVector(u, radius),
+    top.clone().addScaledVector(u, -radius)
+  ];
+  const half = tickLength(mark.diameter) / 2;
+  const tick = (end) => [
+    end.clone().addScaledVector(w, -half),
+    end.clone().addScaledVector(w, half)
+  ];
+  return {
+    base,
+    turn: new Quaternion4().setFromUnitVectors(UP, w),
+    profile: mark.profile ? mark.profile.map(({ r, z }) => new Vector23(r, z)) : toolProfile(radius, corner, height),
+    rims: [
+      ...radius - corner > 1e-9 ? [circle(base, u, v, radius - corner)] : [],
+      circle(top, u, v, radius)
+    ],
+    dimension,
+    ticks: [tick(dimension[0]), tick(dimension[1])],
+    labelAt: top
+  };
+}
+
+// src/tool-marks.tsx
+import { jsx as jsx10, jsxs as jsxs6 } from "react/jsx-runtime";
+var BODY = { color: 16317180, opacity: 0.32 };
+var NO_POINTER2 = { pointerEvents: "none" };
+var ignoreRay = () => void 0;
+var ToolMarks = ({ marks, visible = true, labelClassName, theme }) => {
+  const color = resolveTheme(theme).measure;
+  const shapes = useMemo7(
+    () => marks.flatMap((mark) => {
+      const shape = toolMarkShape(mark);
+      return shape ? [{ mark, shape }] : [];
+    }),
+    [marks]
+  );
+  const label = labelClassName ? `${MEASURE_LABEL_CLASS} ${labelClassName}` : MEASURE_LABEL_CLASS;
+  return /* @__PURE__ */ jsx10("group", { visible, userData: { [EXCLUDE_FROM_FRAME]: true }, children: shapes.map(({ mark, shape }, index) => /* @__PURE__ */ jsxs6("group", { children: [
+    /* @__PURE__ */ jsx10(ToolBody, { shape }),
+    [...shape.rims, shape.dimension, ...shape.ticks].map((points, line) => /* @__PURE__ */ jsx10(
+      Line2,
+      {
+        points,
+        color,
+        lineWidth: MEASURE_LINE_PIXELS.line,
+        depthTest: false,
+        depthWrite: false,
+        renderOrder: MEASURE_RENDER_ORDER,
+        raycast: ignoreRay
+      },
+      line
+    )),
+    mark.label && visible ? /* @__PURE__ */ jsx10(Html2, { position: shape.labelAt, center: true, zIndexRange: [0, 0], style: NO_POINTER2, children: /* @__PURE__ */ jsxs6("div", { className: label, "data-measure-label": "tool", children: [
+      /* @__PURE__ */ jsx10("span", { "data-measure-value": true, children: mark.label }),
+      mark.note ? /* @__PURE__ */ jsxs6("span", { "data-measure-note": true, children: [
+        " ",
+        mark.note
+      ] }) : null
+    ] }) }) : null
+  ] }, index)) });
+};
+var ToolBody = ({ shape }) => /* @__PURE__ */ jsxs6(
+  "mesh",
+  {
+    position: shape.base,
+    quaternion: shape.turn,
+    raycast: ignoreRay,
+    renderOrder: MEASURE_RENDER_ORDER - 1,
+    children: [
+      /* @__PURE__ */ jsx10("latheGeometry", { args: [shape.profile, 64] }),
+      /* @__PURE__ */ jsx10(
+        "meshBasicMaterial",
+        {
+          color: BODY.color,
+          transparent: true,
+          opacity: BODY.opacity,
+          depthWrite: false,
+          side: DoubleSide2
+        }
+      )
+    ]
+  }
+);
+
 // src/model/normals.ts
 function regionNormals(geometry, regions) {
   const position = geometry.getAttribute("position");
@@ -2267,6 +2474,7 @@ export {
   SectionView,
   Stock,
   TAP_SLOP,
+  ToolMarks,
   UnsupportedKernelVersionError,
   VIEW_NAMES,
   VIEW_SIGNS,
@@ -2318,6 +2526,7 @@ export {
   distanceBetween,
   dragPlane,
   excludedFromFrame,
+  featureTriangles,
   featureTypeRank,
   fitDistance,
   fixedBoxStockBounds,
@@ -2377,6 +2586,7 @@ export {
   trackDoubleTaps,
   trackTaps,
   useContentBox,
+  usePartContext,
   useRetarget,
   useSectionStore,
   useTapGuard,

package/dist/{normalize-CvnV9Ggh.d.ts → normalize--FiXUhO4.d.ts}

@@ -1,4 +1,5 @@
 import * as react from 'react';
+import { ReactNode } from 'react';
 import { Group, Mesh, LineSegments, Box3, Plane, BufferGeometry, Vector3, Raycaster, Object3D, Intersection, Camera } from 'three';
 
 /**
@@ -851,6 +852,11 @@ interface PartMeshProps {
     showEdges?: boolean;
     /** Wireframe shows region boundaries and any hovered/painted faces, with no triangle diagonals. */
     display?: PartDisplay;
+    /**
+     * Objects drawn on the part, such as `<ToolMarks>`. They can read its model
+     * and mesh with `usePartContext`.
+     */
+    children?: ReactNode;
 }
 /**
  * The part, as one mesh with one material.
@@ -862,7 +868,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, focus, candidates, highlights, regionHighlights, pickedRegions, hoveredFeatureIds, hover, activeDirection, section, onSectionChange, onAdjacency, focusFeature, onHover, onPick, theme, showEdges, display, }: PartMeshProps) => react.JSX.Element;
+declare const PartMesh: ({ model, geometry, selection, focus, candidates, highlights, regionHighlights, pickedRegions, hoveredFeatureIds, hover, activeDirection, section, onSectionChange, onAdjacency, focusFeature, onHover, onPick, theme, showEdges, display, children, }: PartMeshProps) => react.JSX.Element;
 
 interface EnginePartProps extends Omit<PartMeshProps, 'model' | 'geometry'> {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toolpath/viewer",
-  "version": "2.0.0",
+  "version": "2.2.0",
   "description": "React Three Fiber viewer for Toolpath Engine part reports",
   "license": "MIT",
   "engines": {