@toolpath/viewer 0.4.0 → 1.0.0

package/dist/{normalize-BXIGoZmc.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.
@@ -434,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;
@@ -452,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;
 /**
@@ -463,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
@@ -639,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.
@@ -889,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,8 +1,11 @@
 {
   "name": "@toolpath/viewer",
-  "version": "0.4.0",
+  "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/ui-packages.git",
@@ -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"
   }