beckhoff-xts-viewer-3d 5.2.2 → 5.2.3

package/dist/index.d.ts

@@ -12,7 +12,7 @@ import { GLTF } from 'three-stdlib';
  * Run `npm run sync-version` (or any script that depends on it) to refresh
  * after bumping the package version.
  */
-declare const VERSION: "5.2.2";
+declare const VERSION: "5.2.3";
 
 /**
  * Default CDN URL for the GLB asset bundle (`beckhoff-xts-viewer-3d-assets`).
@@ -1420,6 +1420,201 @@ interface XtsRuntimeState {
     display?: Partial<DisplayOptions>;
 }
 
+/**
+ * SidecarLoader — fetches per-asset JSON sidecars.
+ *
+ * Sidecars carry origin-correction (translateMm + rotationDegEuler) plus
+ * path metadata. They live next to the GLB at <baseUrl>/<id>.meta.json (or
+ * <id>.tool.meta.json for mover tools).
+ *
+ * On 404 the loader falls back to default origin-correction `(0,0,0)` /
+ * `(0,0,0)`. The renderer can still place the GLB; the calibration tool is
+ * the authoritative source for sidecar values.
+ */
+
+interface OriginCorrection {
+    translateMm: Vec3;
+    rotationDegEuler: Vec3;
+}
+interface ModuleSidecar {
+    moduleType: ModuleType3D;
+    glbByRailSystem: {
+        Beckhoff: string | null;
+        HepcoGfx?: string | null;
+    };
+    originCorrection: OriginCorrection;
+    pathType: 'Straight' | 'Curve' | 'Free';
+    moduleLengthMm: number;
+    endAngleDeg: number;
+    freePathFile?: string;
+    approximateBoundsMm?: {
+        min: Vec3;
+        max: Vec3;
+    };
+}
+interface MoverSidecar {
+    moverType: MoverType3D;
+    glb: string;
+    originCorrection: OriginCorrection;
+    magnetPlateCenterMm: Vec3;
+    pathLengthMm: number;
+}
+interface MoverToolSidecar {
+    toolType: MoverToolType3D;
+    glbUrl: string;
+    originCorrection: OriginCorrection;
+    defaultOffsetMm: Vec3;
+    approximateBoundsMm?: {
+        min: Vec3;
+        max: Vec3;
+    };
+    label: string;
+}
+/**
+ * Calibration sidecar for a guiding-rail GLB. The rail is rendered in the
+ * same module-local frame as the module (i.e. under the module's
+ * `startWorldPose`) with this correction applied to the GLB scene.
+ */
+interface RailSidecar {
+    railType: RailType3D;
+    glb: string;
+    originCorrection: OriginCorrection;
+    approximateBoundsMm?: {
+        min: Vec3;
+        max: Vec3;
+    };
+}
+declare const DEFAULT_ORIGIN_CORRECTION: OriginCorrection;
+/**
+ * Generic sidecar fetch with promise caching + graceful fallback. Returns
+ * `undefined` on 404 (caller substitutes a default), and surfaces network or
+ * parse errors as `Error` (caller is expected to forward to onError).
+ */
+declare class SidecarLoader {
+    private readonly timeoutMs;
+    private readonly cache;
+    constructor(timeoutMs?: number);
+    clear(): void;
+    /**
+     * Fetch and cache the sidecar at `url`. The loader validates the one field
+     * every sidecar shape shares (`originCorrection`) and hands the rest to the
+     * caller as `T` — the kind is a property of the URL, not of the loader.
+     */
+    fetch<T>(url: string): Promise<T | undefined>;
+}
+/**
+ * Resolve the effective origin correction for a module sidecar — falls back
+ * to identity when the sidecar is absent.
+ */
+declare function resolveOriginCorrection(sidecar: {
+    originCorrection?: OriginCorrection;
+} | undefined): OriginCorrection;
+/** Standard sidecar filename from a base id. */
+declare function moduleSidecarFilename(moduleType: ModuleType3D): string;
+declare function moverSidecarFilename(moverType: MoverType3D): string;
+declare function toolSidecarFilename(toolType: MoverToolType3D): string;
+declare function railSidecarFilename(railType: RailType3D): string;
+/** Anything that names a GLB per rail system — a sidecar or a manifest entry. */
+interface GlbByRailSystem {
+    glbByRailSystem: {
+        Beckhoff: string | null;
+        HepcoGfx?: string | null;
+    };
+}
+/**
+ * Pure helper: pick the GLB filename with rail-system fallback. Returns null
+ * when the entry marks the module 'prepared but not delivered'.
+ *
+ * Takes the structural shape rather than `ModuleSidecar` so
+ * `resolveModuleGlbUrl`, which used to carry a line-for-line identical copy
+ * of this body over manifest entries, can delegate here. Both are public
+ * API, so both stay — but there is one implementation of the fallback rule.
+ */
+declare function pickGlbForRail(entry: GlbByRailSystem | undefined, rail: RailSystem): string | null;
+
+/**
+ * Option shapes shared between the public `<XtsViewer3D>` props and the
+ * internal `<XtsScene>` / `<ProcessingUnitRoot>` props.
+ *
+ * Each of these used to be declared twice — once on each side of that
+ * boundary, character for character — so the two could drift silently, and
+ * `SidecarOverrides` was even exported under two public names. Declared once
+ * here and imported by both.
+ */
+
+/** Where the view cube sits in the canvas. */
+type ViewCubeAlignment = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'top-center' | 'bottom-center' | 'center-left' | 'center-right' | 'center-center';
+interface ViewCubeOptions {
+    enabled?: boolean;
+    /** Default `'bottom-right'`. */
+    alignment?: ViewCubeAlignment;
+    /** Distance from the aligned corner, in CSS px. Default `[80, 80]`. */
+    marginPx?: [number, number];
+}
+/** Interaction locks. Each `true` disables that interaction. */
+interface InteractionLocks {
+    rotate?: boolean;
+    pan?: boolean;
+    zoom?: boolean;
+    selection?: boolean;
+}
+interface PerformanceOptions {
+    /** Cap the frameloop rate. Unset = uncapped. */
+    maxFps?: number;
+    /**
+     * Draw a processing unit's movers as one `InstancedMesh` instead of one
+     * scene node each, cutting mover draw calls from N to 1. Default: false.
+     *
+     * Applies from four movers up, and only to movers with nothing bound to
+     * them: a mover carrying tools, a mover-bound custom asset, or a visible
+     * drive status still gets its own node. Turning on the anchor marker or
+     * mover-id labels gives every mover a child object, so the batch is
+     * skipped for that unit entirely. Selection and clicks work either way.
+     */
+    instancing?: boolean;
+    /** Stop the frameloop while the tab is hidden. Default: true. */
+    autoPauseOnHidden?: boolean;
+    /**
+     * Enable demand rendering: frames only render when something changes
+     * (camera move, mover position update, selection). Saves >90% GPU time
+     * when the scene is idle. Default: true.
+     */
+    demandRendering?: boolean;
+    /**
+     * Cap the device pixel ratio. Values above 2 rarely improve perceptible
+     * quality but double fill-rate cost on Retina/4K displays. Default: 2.
+     */
+    maxDpr?: number;
+    /**
+     * Disable automatic per-frame shadow map updates. Shadows only re-render
+     * on camera change. Default: true (when shadows enabled).
+     */
+    shadowOnDemand?: boolean;
+    /**
+     * Opt into the WebGPU renderer when the browser supports it. Falls back to
+     * WebGL automatically. Default: false (experimental).
+     */
+    webgpu?: boolean;
+    /**
+     * Override the KTX2 (Basis) transcoder path used to decode compressed
+     * textures in the GLB assets. Defaults to a CDN copy pinned to the bundled
+     * three.js revision. Point this at a self-hosted
+     * `basis_transcoder.{js,wasm}` directory for offline / air-gapped use.
+     */
+    ktx2TranscoderUrl?: string;
+}
+/**
+ * Live override of the per-asset origin-correction sidecars, keyed by asset
+ * type. Useful for calibration tooling that adjusts a model's origin without
+ * re-publishing its `.meta.json`.
+ */
+interface SidecarOverrides {
+    modules?: Partial<Record<ModuleType3D, OriginCorrection>>;
+    movers?: Partial<Record<MoverType3D, OriginCorrection>>;
+    tools?: Partial<Record<MoverToolType3D, OriginCorrection>>;
+    rails?: Partial<Record<RailType3D, OriginCorrection>>;
+}
+
 /**
  * Module catalog (3D-canonical).
  *
@@ -1556,6 +1751,67 @@ declare function moverWorldAt(chain: BuiltChain, partPositionMm: number): Planar
 /** Convenience: chain from full ModuleEntry[] returning trackLength alone. */
 declare function trackLengthOf(modules: ReadonlyArray<ModuleEntry>): number;
 
+/**
+ * normalizeXtsConfig — pre-render pass.
+ *
+ * Fail-fast validation + AT2050 half-clothoid merging:
+ *   AT2050_0500 + AT2050_0501 (gap=0)        → AT2050_0500_180
+ *   ATH2050_0500 + ATH2050_0501 (gap=0)      → ATH2050_0500_180
+ *
+ * Errors thrown via XtsViewerErrorException:
+ *   - 'unknown-module-type'
+ *   - 'unknown-mover-type'
+ *   - 'unmatched-clothoid-half'   (0500 without 0501 or vice versa)
+ *
+ * Warnings (collected, non-fatal) returned alongside the normalized config:
+ *   - mover.partOid not in part-list
+ *   - duplicate mover.id within an XPU
+ *   - mover.partPositionMm out of range (clamped)
+ */
+
+interface NormalizedXtsConfig extends XtsConfig {
+    /**
+     * Same shape as the input, with all parts' modules pre-merged + validated.
+     * Mover positions are clamped, but the original values are preserved in
+     * `__warnings` for diagnostics.
+     */
+    readonly __warnings: NormalizationWarning[];
+}
+interface NormalizationWarning {
+    code: 'mover-out-of-range' | 'mover-orphan' | 'mover-duplicate-id' | 'mover-missing-id' | 'mover-invalid-id' | 'empty-part' | 'prepared-module' | 'duplicate-xpu-object-id' | 'missing-xpu-object-id' | 'invalid-xpu-object-id' | 'duplicate-part-object-id' | 'missing-part-object-id' | 'invalid-part-object-id' | 'duplicate-part-global-number' | 'missing-part-global-number' | 'invalid-part-global-number' | 'duplicate-module-global-number' | 'missing-module-global-number' | 'invalid-module-global-number';
+    message: string;
+    details?: unknown;
+}
+/**
+ * Normalizer handle.
+ *
+ * This used to carry a single-slot structural cache keyed on a
+ * `JSON.stringify` of the config with the frame-paced fields stripped out.
+ * It was removed: the only production caller is `useNormalizedConfig`, whose
+ * `useMemo` already collapses repeat calls on an unchanged config, so the
+ * cache could fire only when the config identity changed but its structure
+ * did not — and in exactly that case the "fast path" cost a full stringify
+ * of the config plus a full rebuild of every XPU, which is strictly more
+ * work than the single O(n) pass it was avoiding.
+ *
+ * It also cost correctness twice over. The key stripped `status` by name at
+ * every depth, so it removed `ModuleEntry.status` along with the mover field
+ * it was aimed at, while the clone path rebuilt only movers — freezing
+ * declarative module warnings after the first normalize. And it forced a
+ * second copy of the mover clamp that had already drifted from `clampMover`
+ * (different `details` key, different `original` value), so hosts parsing
+ * warning details saw two shapes for one warning code.
+ *
+ * The class stays because it is part of the published API. It is now a thin
+ * handle over the pure function.
+ */
+declare class XtsConfigNormalizer {
+    normalize(config: XtsConfig): NormalizedXtsConfig;
+    /** No-op. Kept so existing callers keep compiling; there is no cache. */
+    clearCache(): void;
+}
+declare function normalizeXtsConfig(config: XtsConfig): NormalizedXtsConfig;
+
 /**
  * Mover collision detection.
  *
@@ -1665,6 +1921,20 @@ interface MoverProbe {
  * appear first.
  */
 declare function checkSamePathCollisions(chain: BuiltChain, partOid: number, probes: ReadonlyArray<MoverProbe>, opts?: CheckMoverCollisionsOptions): MoverCollision[];
+/**
+ * Collision check across a whole config: build a probe per mover, group by
+ * part, and run `checkSamePathCollisions` on each group with two or more.
+ *
+ * `livePositionOf` supplies the current position of a mover when one is
+ * being driven imperatively — the `MoverPositionStore` at 60 Hz — falling
+ * back to the config value. Passing it as a function rather than the store
+ * itself is what keeps this a pure geometry function: it was previously
+ * trapped inside the `useImperativeHandle` closure of `useXtsViewerHandle`,
+ * where it could only be exercised through a mounted canvas.
+ *
+ * Results are sorted so the deepest collision in the scene comes first.
+ */
+declare function checkAllMoverCollisions(config: NormalizedXtsConfig, livePositionOf: (moverId: number) => number | undefined, opts?: CheckMoverCollisionsOptions): MoverCollision[];
 
 /**
  * Module collision / overlap detection.
@@ -1819,58 +2089,25 @@ declare function checkModuleCollisions(probes: ReadonlyArray<ModuleProbe>, adjac
     count: number;
     closed: boolean;
 }>, opts?: CheckModuleCollisionsOptions): ModuleCollision[];
-
 /**
- * normalizeXtsConfig — pre-render pass.
- *
- * Fail-fast validation + AT2050 half-clothoid merging:
- *   AT2050_0500 + AT2050_0501 (gap=0)        → AT2050_0500_180
- *   ATH2050_0500 + ATH2050_0501 (gap=0)      → ATH2050_0500_180
+ * Resolve a normalized config into the per-XPU inputs `buildModuleProbes`
+ * takes, applying the same override precedence the scene uses: an imperative
+ * `trackTransformOverrides` entry beats the config value.
  *
- * Errors thrown via XtsViewerErrorException:
- *   - 'unknown-module-type'
- *   - 'unknown-mover-type'
- *   - 'unmatched-clothoid-half'   (0500 without 0501 or vice versa)
+ * This adapter was written out twice, character for character — once in
+ * `<ModuleCollisionMonitor>` and once inside the `checkModuleCollisions`
+ * closure of `useXtsViewerHandle` — with the only difference being where the
+ * orientation came from.
  *
- * Warnings (collected, non-fatal) returned alongside the normalized config:
- *   - mover.partOid not in part-list
- *   - duplicate mover.id within an XPU
- *   - mover.partPositionMm out of range (clamped)
+ * A part whose chain cannot be built is skipped, as before, but no longer in
+ * silence: `normalizeXtsConfig` has already made that impossible, so if it
+ * ever happens it means a part has silently dropped out of collision
+ * detection, which is a safety feature. Reported rather than thrown, because
+ * both callers run inside React and a throw would take the scene down.
  */
-
-interface NormalizedXtsConfig extends XtsConfig {
-    /**
-     * Same shape as the input, with all parts' modules pre-merged + validated.
-     * Mover positions are clamped, but the original values are preserved in
-     * `__warnings` for diagnostics.
-     */
-    readonly __warnings: NormalizationWarning[];
-}
-interface NormalizationWarning {
-    code: 'mover-out-of-range' | 'mover-orphan' | 'mover-duplicate-id' | 'mover-missing-id' | 'mover-invalid-id' | 'empty-part' | 'prepared-module' | 'duplicate-xpu-object-id' | 'missing-xpu-object-id' | 'invalid-xpu-object-id' | 'duplicate-part-object-id' | 'missing-part-object-id' | 'invalid-part-object-id' | 'duplicate-module-global-number' | 'missing-module-global-number' | 'invalid-module-global-number';
-    message: string;
-    details?: unknown;
-}
-/**
- * Stateful normalizer with a single-slot structural cache. The key
- * intentionally excludes `mover.partPositionMm` so that frame-paced
- * position updates fall into the fast path: when the structure (modules,
- * parts, transforms, mover ids/partOids) hasn't changed between calls,
- * we return a clone of the cached result with only the mover positions
- * re-clamped against the current input.
- *
- * Construct your own instance when you need an isolated cache (e.g. in
- * tests, or when multiple viewers in the same JS realm would otherwise
- * thrash a shared single-slot cache). The standalone `normalizeXtsConfig`
- * function delegates to a process-wide singleton for backwards
- * compatibility.
- */
-declare class XtsConfigNormalizer {
-    private _cache;
-    normalize(config: XtsConfig): NormalizedXtsConfig;
-    clearCache(): void;
-}
-declare function normalizeXtsConfig(config: XtsConfig): NormalizedXtsConfig;
+declare function toModuleCollisionInputs(config: NormalizedXtsConfig, trackTransformOverrides?: Record<number, TrackTransform>): ModuleCollisionXpuInput[];
+/** `toModuleCollisionInputs` → `buildModuleProbes` → `checkModuleCollisions`. */
+declare function checkAllModuleCollisions(config: NormalizedXtsConfig, orientation: Orientation | undefined, trackTransformOverrides?: Record<number, TrackTransform>, opts?: CheckModuleCollisionsOptions): ModuleCollision[];
 
 /**
  * Shared, mostly-pure plumbing behind `exportScreenshot` and
@@ -1891,6 +2128,89 @@ declare function normalizeXtsConfig(config: XtsConfig): NormalizedXtsConfig;
  */
 
 type CaptureMode = 'current' | 'top-down' | 'custom';
+/**
+ * The options `exportScreenshot` and `beginFrameCapture` share.
+ *
+ * They used to be written out twice — `ScreenshotOptions` and
+ * `FrameCaptureOptions` each hand-documented the same nine fields, and the
+ * two `updateShadows` comments already described the same behaviour in
+ * different words. Documented once here; each path intersects this with the
+ * handful of options that are genuinely its own.
+ */
+interface CaptureRequest {
+    /** Camera mode. Default `'current'`. */
+    mode?: CaptureMode;
+    /** Required when `mode === 'custom'`. Ignored otherwise. */
+    camera?: CameraState;
+    /**
+     * Dimensions in pixels. Supply at least one; the other follows the scene
+     * aspect (`top-down`) or the live canvas aspect (`current` / `custom`).
+     * Omit both to use the live canvas dimensions x pixel ratio.
+     *
+     * Both are clamped to what the GPU can actually allocate — read
+     * `widthPx` / `heightPx` / `clamped` back for what was really rendered.
+     */
+    width?: number;
+    height?: number;
+    /**
+     * Background colour:
+     *   - `null` (default) → transparent frames, matching the live canvas
+     *     contract. JPEG falls back to white because it has no alpha.
+     *   - `'#RRGGBB'` / any three.js ColorRepresentation → solid fill.
+     */
+    backgroundColor?: ColorRepresentation | null;
+    /** Margin around the scene AABB in `top-down` mode. Default 1.1 (10 %). */
+    paddingFactor?: number;
+    /**
+     * Multiplier applied to every Light in the scene for the render, restored
+     * afterwards. The default differs per path: 1.35 for a still, which
+     * otherwise reads dim next to the live canvas, and 1 for a clip, where
+     * that boost would make the whole video brighter than the run the user
+     * watched. Pass 1 to disable.
+     */
+    exposureBoost?: number;
+    /**
+     * MSAA sample count for the offscreen target. Default 4 where the context
+     * supports it, 0 otherwise; 0 disables. The live canvas is created with
+     * `antialias: true`, so without this every geometry edge in an export is
+     * hard-aliased while the live view stays smooth. The effective count,
+     * clamped to the hardware maximum, is reported back.
+     */
+    samples?: number;
+    /**
+     * Refresh the shadow map before rendering. Default `true`.
+     *
+     * `performance.shadowOnDemand` leaves `shadowMap.autoUpdate` off and only
+     * dirties the map on camera change, so movers driven through
+     * `setMoverPositions` would otherwise cast shadows from a stale position.
+     * Costs one shadow pass; pass `false` to skip it.
+     */
+    updateShadows?: boolean;
+    /**
+     * Pin wall-clock animations (the drive-status blink) for the render.
+     * Default `true`.
+     *
+     * Unpinned, a capture catches whatever phase the last live frame left
+     * behind: two stills of the same scene differ, and a clip flickers at an
+     * irregular rate because its frames are not produced at wall-clock speed.
+     */
+    freezeAnimations?: boolean;
+}
+/** What a capture reports back about the frame it actually produced. */
+interface CaptureDimensions {
+    /** Dimensions actually rendered — after hardware / budget clamping. */
+    widthPx: number;
+    heightPx: number;
+    /** Dimensions requested, before clamping. */
+    requestedWidthPx: number;
+    requestedHeightPx: number;
+    /** True when the request exceeded what the GPU could allocate. */
+    clamped: boolean;
+    /** MSAA samples actually used (0 = off). */
+    samples: number;
+    /** Camera the frame was rendered with. */
+    camera: CameraState;
+}
 
 /**
  * captureScreenshot — render the live r3f scene into an offscreen
@@ -1931,79 +2251,26 @@ type CaptureMode = 'current' | 'top-down' | 'custom';
  *     background and boosted lights.
  */
 
-type ScreenshotMode = 'current' | 'top-down' | 'custom';
+/**
+ * @deprecated Use `CaptureMode`. This was a byte-for-byte re-declaration of
+ * it, so the package shipped two public names for one union.
+ */
+type ScreenshotMode = CaptureMode;
 type ScreenshotFormat = 'png' | 'jpeg' | 'webp';
-interface ScreenshotOptions {
-    /** Camera mode. Default: `'current'`. */
-    mode?: ScreenshotMode;
-    /** Required when `mode === 'custom'`. Ignored otherwise. */
-    camera?: CameraState;
-    /**
-     * Image dimensions in pixels.
-     * - Both supplied: the rendered frustum (top-down) is adjusted to
-     *   match the resulting aspect; the camera (current / custom) is
-     *   fitted to `width / height`.
-     * - One supplied: the other is derived to keep the scene's aspect
-     *   ratio (top-down) or the live canvas aspect (current / custom).
-     * - Neither: canvas CSS dimensions × `pixelRatio`.
-     *
-     * Both are clamped to what the GPU can actually allocate — check
-     * `widthPx` / `heightPx` / `clamped` on the result for what was
-     * really rendered.
-     */
-    width?: number;
-    height?: number;
+/**
+ * `CaptureRequest` carries the nine options shared with `beginFrameCapture`;
+ * these three are the still-image path's own.
+ */
+interface ScreenshotOptions extends CaptureRequest {
     format?: ScreenshotFormat;
     /** 0..1 — JPEG / WebP quality. Default 0.92. Ignored for PNG. */
     quality?: number;
     /**
-     * Padding factor around the scene AABB in `top-down` mode. Default
-     * 1.1 (10 % margin on each side). Higher = more whitespace.
-     */
-    paddingFactor?: number;
-    /**
-     * Background colour:
-     *   - `null` (default) → transparent PNG, matches the live canvas
-     *     contract. JPEG falls back to white because the format has no
-     *     alpha channel.
-     *   - `'#RRGGBB'` / any three.js ColorRepresentation → solid fill.
-     */
-    backgroundColor?: ColorRepresentation | null;
-    /**
-     * Pixel ratio for offscreen renders. Default = renderer's current
-     * pixel ratio (matches the live canvas sharpness on high-DPI
-     * displays). Set explicitly for fixed-resolution exports.
+     * Pixel ratio for the offscreen render. Default = the renderer's current
+     * pixel ratio, which matches live-canvas sharpness on high-DPI displays.
+     * Set explicitly for fixed-resolution exports.
      */
     pixelRatio?: number;
-    /**
-     * Multiplier applied to every Light in the scene during the offscreen
-     * render. Default 1.35 — screenshots tend to feel dim compared to
-     * the live canvas because the live tone-mapping pipeline picks up
-     * the surrounding monitor luminance, which the offscreen render
-     * doesn't. Pass 1 to disable, > 1 for a brighter result. Restored
-     * after capture.
-     */
-    exposureBoost?: number;
-    /**
-     * MSAA sample count for the offscreen target. Default 4 where the
-     * context supports it, 0 otherwise. 0 disables.
-     *
-     * The live canvas is created with `antialias: true`; without this the
-     * offscreen pass had no MSAA at all, so every geometry edge in an
-     * export was hard-aliased while the live view stayed smooth. The
-     * effective count (clamped to the hardware maximum) comes back on the
-     * result.
-     */
-    samples?: number;
-    /**
-     * Refresh the shadow map before rendering. Default `true`.
-     *
-     * `performance.shadowOnDemand` leaves `shadowMap.autoUpdate` off and
-     * only dirties the map when the camera moves, so movers driven purely
-     * through `setMoverPositions` would otherwise cast shadows from a
-     * stale position. Costs one shadow pass; pass `false` to skip it.
-     */
-    updateShadows?: boolean;
 }
 interface ScreenshotResult {
     blob: Blob;
@@ -2079,69 +2346,13 @@ interface ScreenshotResult {
  * `exportScreenshot` does.
  */
 
-interface FrameCaptureOptions {
-    /**
-     * Frame dimensions in px. Supply at least one; the other follows the scene
-     * aspect (`top-down`) or the live canvas aspect (`current` / `custom`).
-     * Omit both to use the live canvas dimensions × pixel ratio.
-     *
-     * Sessions tolerate a render size well above the live canvas — supersampling
-     * for the encoder is the expected usage. Both values are clamped to what the
-     * GPU can allocate; check `widthPx` / `heightPx` / `clamped` for what you
-     * actually get.
-     */
-    width?: number;
-    height?: number;
-    /** Camera mode. Default `'current'`. */
-    mode?: CaptureMode;
-    /** Required when `mode === 'custom'`. */
-    camera?: CameraState;
-    /** `null` (default) → transparent frames. */
-    backgroundColor?: ColorRepresentation | null;
-    /** Top-down margin. Fixed for the session. Default 1.1. */
-    paddingFactor?: number;
-    /**
-     * Light multiplier. Default **1** — unlike `exportScreenshot`, which uses
-     * 1.35 because a single still reads dim next to the live canvas. Applying
-     * that to every frame of a clip would make the whole video uniformly
-     * brighter than the run the user watched.
-     */
-    exposureBoost?: number;
-    /** MSAA samples. Default 4, clamped to the hardware maximum. 0 disables. */
-    samples?: number;
-    /**
-     * Pin wall-clock-driven effects (the drive-status blink) to a fixed value
-     * for every frame. Default `true`.
-     *
-     * Export frames are not produced at wall-clock speed, so an unpinned blink
-     * flickers at an irregular rate in the clip and two exports of the same run
-     * differ pixel-wise.
-     */
-    freezeAnimations?: boolean;
-    /**
-     * Refresh the shadow map on every frame. Default `true` when shadows are
-     * enabled.
-     *
-     * `performance.shadowOnDemand` leaves `shadowMap.autoUpdate` off and only
-     * dirties on camera change, so movers driven through `setMoverPositions`
-     * would drag their first-frame shadows through the whole clip. Costs one
-     * shadow pass per frame; set `false` to trade correctness for speed.
-     */
-    updateShadows?: boolean;
-}
-interface FrameCaptureSession {
-    /** Dimensions actually rendered — after hardware / budget clamping. */
-    readonly widthPx: number;
-    readonly heightPx: number;
-    /** Dimensions requested, before clamping. */
-    readonly requestedWidthPx: number;
-    readonly requestedHeightPx: number;
-    /** True when the request exceeded what the GPU could allocate. */
-    readonly clamped: boolean;
-    /** MSAA samples actually used (0 = off). */
-    readonly samples: number;
-    /** Camera pinned for the whole session. */
-    readonly camera: CameraState;
+/**
+ * `CaptureRequest` carries the nine options shared with `exportScreenshot`.
+ * The clip path adds nothing of its own; it only differs in the default for
+ * `exposureBoost` (1 rather than 1.35 — see the field's doc).
+ */
+type FrameCaptureOptions = CaptureRequest;
+interface FrameCaptureSession extends Readonly<CaptureDimensions> {
     /** True until `dispose()`. */
     readonly disposed: boolean;
     /**
@@ -2408,6 +2619,14 @@ interface XtsViewer3DRef {
     focusOn(target: FocusTarget, opts?: FocusOptions): void;
     setCamera(cam: CameraState): void;
     getCamera(): CameraState | null;
+    /**
+     * @deprecated Not implemented — this is a no-op that warns in development.
+     *
+     * `orientation` is a static prop in this build; there is no state behind
+     * it to update. Set it through `<XtsViewer3D orientation={…}>` instead.
+     * The method is kept only so the published interface does not change
+     * shape mid-major, and will be removed in the next major.
+     */
     setOrientation(orientation: XtsConfig['orientation']): void;
     getMoverWorldTransform(ref: MoverRef): {
         positionMm: [number, number, number];
@@ -2472,6 +2691,15 @@ interface XtsViewer3DRef {
      * frameloop tick.
      */
     renderFrameNow(): void;
+    /**
+     * @deprecated Not implemented — this is a no-op that warns in development.
+     *
+     * GLB caching lives in `useGLTF`'s global cache, which r3f exposes no
+     * per-instance handle to clear. Use `useGLTF.clear()` from
+     * `@react-three/drei` directly if you need to drop cached assets. Kept
+     * only so the published interface does not change shape mid-major, and
+     * will be removed in the next major.
+     */
     reloadAssets(): Promise<void>;
     setMoverPosition(moverId: number, partPositionMm: number): void;
     /**
@@ -2528,107 +2756,6 @@ interface XtsViewer3DRef {
     measurements: MeasurementApi;
 }
 
-/**
- * SidecarLoader — fetches per-asset JSON sidecars.
- *
- * Sidecars carry origin-correction (translateMm + rotationDegEuler) plus
- * path metadata. They live next to the GLB at <baseUrl>/<id>.meta.json (or
- * <id>.tool.meta.json for mover tools).
- *
- * On 404 the loader falls back to default origin-correction `(0,0,0)` /
- * `(0,0,0)`. The renderer can still place the GLB; the calibration tool is
- * the authoritative source for sidecar values.
- */
-
-interface OriginCorrection {
-    translateMm: Vec3;
-    rotationDegEuler: Vec3;
-}
-interface ModuleSidecar {
-    moduleType: ModuleType3D;
-    glbByRailSystem: {
-        Beckhoff: string | null;
-        HepcoGfx?: string | null;
-    };
-    originCorrection: OriginCorrection;
-    pathType: 'Straight' | 'Curve' | 'Free';
-    moduleLengthMm: number;
-    endAngleDeg: number;
-    freePathFile?: string;
-    approximateBoundsMm?: {
-        min: Vec3;
-        max: Vec3;
-    };
-}
-interface MoverSidecar {
-    moverType: MoverType3D;
-    glb: string;
-    originCorrection: OriginCorrection;
-    magnetPlateCenterMm: Vec3;
-    pathLengthMm: number;
-}
-interface MoverToolSidecar {
-    toolType: MoverToolType3D;
-    glbUrl: string;
-    originCorrection: OriginCorrection;
-    defaultOffsetMm: Vec3;
-    approximateBoundsMm?: {
-        min: Vec3;
-        max: Vec3;
-    };
-    label: string;
-}
-/**
- * Calibration sidecar for a guiding-rail GLB. The rail is rendered in the
- * same module-local frame as the module (i.e. under the module's
- * `startWorldPose`) with this correction applied to the GLB scene.
- */
-interface RailSidecar {
-    railType: RailType3D;
-    glb: string;
-    originCorrection: OriginCorrection;
-    approximateBoundsMm?: {
-        min: Vec3;
-        max: Vec3;
-    };
-}
-declare const DEFAULT_ORIGIN_CORRECTION: OriginCorrection;
-/**
- * Generic sidecar fetch with promise caching + graceful fallback. Returns
- * `undefined` on 404 (caller substitutes a default), and surfaces network or
- * parse errors as `Error` (caller is expected to forward to onError).
- */
-declare class SidecarLoader {
-    private readonly timeoutMs;
-    private readonly cache;
-    constructor(timeoutMs?: number);
-    clear(): void;
-    /**
-     * Fetch and cache the sidecar at `url`. The loader validates the one field
-     * every sidecar shape shares (`originCorrection`) and hands the rest to the
-     * caller as `T` — the kind is a property of the URL, not of the loader.
-     */
-    fetch<T>(url: string): Promise<T | undefined>;
-}
-/**
- * Resolve the effective origin correction for a module sidecar — falls back
- * to identity when the sidecar is absent.
- */
-declare function resolveOriginCorrection(sidecar: {
-    originCorrection?: OriginCorrection;
-} | undefined): OriginCorrection;
-/** Standard sidecar filename from a base id. */
-declare function moduleSidecarFilename(moduleType: ModuleType3D): string;
-declare function moverSidecarFilename(moverType: MoverType3D): string;
-declare function toolSidecarFilename(toolType: MoverToolType3D): string;
-declare function railSidecarFilename(railType: RailType3D): string;
-/**
- * Pure helper: pick the GLB filename for a moduleSidecar with rail-system
- * fallback. Returns null when the sidecar marks the module 'prepared but
- * not delivered'.
- */
-declare function pickGlbForRail(sidecar: ModuleSidecar | undefined, rail: RailSystem): string | null;
-
 /**
  * HepcoGfxRailProfile — cross-section of the Hepco GFX guiding rail used by
  * the procedural extrusion in <HepcoGfxRail>.
@@ -2756,12 +2883,6 @@ declare function createHepcoGfxRailShape(dims?: HepcoGfxRailProfileDims): Shape;
  * Live overrides for module/mover/tool origin-correction sidecars. Used by
  * the calibration tool to preview adjustments without writing files.
  */
-interface SidecarOverrides {
-    modules?: Partial<Record<ModuleType3D, OriginCorrection>>;
-    movers?: Partial<Record<MoverType3D, OriginCorrection>>;
-    tools?: Partial<Record<MoverToolType3D, OriginCorrection>>;
-    rails?: Partial<Record<RailType3D, OriginCorrection>>;
-}
 interface XtsViewer3DProps {
     /** Complete XTS configuration. */
     config: XtsConfig;
@@ -2806,12 +2927,7 @@ interface XtsViewer3DProps {
      */
     topDown?: boolean;
     /** Lock interactions. */
-    lock?: {
-        rotate?: boolean;
-        pan?: boolean;
-        zoom?: boolean;
-        selection?: boolean;
-    };
+    lock?: InteractionLocks;
     /** Selection-Mode. Default: 'Off'. */
     selectionMode?: SelectionMode;
     /** Controlled selection. */
@@ -2896,40 +3012,7 @@ interface XtsViewer3DProps {
     onError?: (err: XtsViewerError) => void;
     onAssetsLoaded?: () => void;
     /** Performance-Tuning. */
-    performance?: {
-        maxFps?: number;
-        instancing?: boolean;
-        autoPauseOnHidden?: boolean;
-        /**
-         * Enable demand rendering: frames only render when something changes
-         * (camera move, mover position update, selection). Saves >90% GPU
-         * time when the scene is idle. Default: true.
-         */
-        demandRendering?: boolean;
-        /**
-         * Cap the device pixel ratio. Values above 2 rarely improve
-         * perceptible quality but double fill-rate cost on Retina/4K
-         * displays. Default: 2.
-         */
-        maxDpr?: number;
-        /**
-         * Disable automatic per-frame shadow map updates. Shadows only
-         * re-render on camera change. Default: true (when shadows enabled).
-         */
-        shadowOnDemand?: boolean;
-        /**
-         * Opt into the WebGPU renderer when the browser supports it.
-         * Falls back to WebGL automatically. Default: false (experimental).
-         */
-        webgpu?: boolean;
-        /**
-         * Override the KTX2 (Basis) transcoder path used to decode compressed
-         * textures in the GLB assets. Defaults to a CDN copy pinned to the
-         * bundled three.js revision. Point this at a self-hosted
-         * `basis_transcoder.{js,wasm}` directory for offline / air-gapped use.
-         */
-        ktx2TranscoderUrl?: string;
-    };
+    performance?: PerformanceOptions;
     /**
      * Live override of the per-asset origin-correction sidecars. Useful for
      * the calibration tool.
@@ -2946,11 +3029,7 @@ interface XtsViewer3DProps {
      */
     hepcoGfxProfile?: Partial<HepcoGfxRailProfileDims>;
     /** CAD-style ViewCube overlay. */
-    viewCube?: {
-        enabled?: boolean;
-        alignment?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'top-center' | 'bottom-center' | 'center-left' | 'center-right' | 'center-center';
-        marginPx?: [number, number];
-    };
+    viewCube?: ViewCubeOptions;
     /** Stator heatmap data — coloured tube along each part's centerline. */
     statorHeatmap?: StatorHeatmap;
     /** Continuous mover collision monitoring. */
@@ -3843,4 +3922,4 @@ declare function snapToGrid(positionMm: Vec3, gridMm: number): Vec3;
 /** Convenience: `resolveSceneContext` + `toEntityRef`. */
 declare function resolveEntityFromObject(object: Object3D | null, instanceId?: number): MeasuredEntityRef | null;
 
-export { type AngleMeasurement, type Annotation, type AnnotationAnchor, type AnnotationInput, type AreaConfig, type AreaOptions, AssetLoader, type AssetManifest, BUILTIN_MODULE_SIDECARS, BUILTIN_MOVER_SIDECARS, BUILTIN_RAIL_SIDECARS, BUILTIN_TOOL_SIDECARS, type BuiltChain, type BuiltModule, type CameraProjection, type CameraState, type CaptureMode, type CheckModuleCollisionsOptions, type CheckMoverCollisionsOptions, type ClickModifiers, type CoordinateSystem, type CustomAssetBinding, type CustomAssetConfig, type CustomMoverLayout, DEFAULT_LABEL_FONT_URL, DEFAULT_MEASUREMENT_STYLE, DEFAULT_MODULE_HALF_WIDTH_MM, DEFAULT_MODULE_HEIGHT_MM, DEFAULT_MODULE_MANIFEST, DEFAULT_MOVER_MANIFEST, DEFAULT_ORIGIN_CORRECTION, DEFAULT_RAIL_MANIFEST, DEFAULT_SNAP_KINDS, DEFAULT_SNAP_RADIUS_PX, DEFAULT_TOOL_MANIFEST, type DimensionOptions, type DisplayOptions, type DistanceMeasurement, EMPTY_SELECTION, type EndDelta, type FeedSegment, type FeedSegmentHighlight, type FeedSegmentSelector, type FeedSegmentSpan, type FocusOptions, type FocusTarget, type FrameCaptureOptions, type FrameCaptureSession, HEPCO_GFX_PROFILE, type HeatmapSample, type HepcoGfxRailProfileDims, IDENTITY_POSE, INFEED_MODULE_TYPES, type InfoBarConfig, type InfoBarMarkerConfig, type InfoBarOptions, JSDELIVR_ASSETS_BASE_URL, MODULE_CATALOG, MODULE_GUIDING_RAIL_MAP, MOVER_CATALOG, type MarkerOptions, type MarkerShape, type MeasuredEntityRef, type Measurement, type MeasurementApi, type MeasurementAxis, type MeasurementDocument, type MeasurementDraft, type MeasurementFormatOptions, type MeasurementId, type MeasurementInput, type MeasurementKind, type MeasurementOptions, type MeasurementPoint, type MeasurementResult, type MeasurementSnapshot, type MeasurementStyle, type MeasurementTool, type ModuleAssetEntry, type ModuleCatalogEntry, type ModuleCollision, type ModuleCollisionPartInput, type ModuleCollisionXpuInput, ModuleCornerMarkers, type ModuleEntry, type ModuleHighlight, type ModuleProbe, type ModuleRef, type ModuleSidecar, type ModuleStatusEntry, type ModuleType3D, type MoverAssetEntry, type MoverCatalogEntry, type MoverCollision, type MoverConfig, MoverIdLabel, type MoverIdLabelOptions, type MoverPositionEntry, type MoverProbe, type MoverRef, type MoverSidecar, type MoverToolAssetEntry, type MoverToolConfig, type MoverToolSidecar, type MoverToolType3D, type MoverType3D, type NormalizationWarning, type NormalizedXtsConfig, type Orientation, type OriginCorrection, type PartConfig, type PartPath, type PartTransformation, type PathMeasurement, type PathSample, type PathType, type PlanarPose, type PointCloud, type PointProjector, type PositionFrame, type ProcessingUnitConfig, type RailAssetEntry, type RailSidecar, type RailSystem, type RailType3D, type ResolvedMeasurementStyle, SIDECAR_KINDS, type ScreenshotFormat, type ScreenshotMode, type ScreenshotOptions, type ScreenshotResult, type SelectionMode, type SelectionState, type SidecarIdOf, type SidecarKind, type SidecarKindSpec, type SidecarKinds, SidecarLoader, type SidecarOf, type SidecarOverrides, type SidecarSourceConfig, SidecarSourceContext, type SnapCandidate, type SnapKind, type SnapOptions, type SplitFeedSegmentsOptions, type StationConfig, type StationOptions, type StatorHeatmap, type StopPositionMoverOptions, type TextOptions, type TrackAnchor, type TrackDistanceMeasurement, type TrackIndex, type TrackIndexEntry, type TrackMetrics, type TrackMetricsResolver, type TrackProjection, type TrackTransform, VERSION, type Vec2, type Vec3, XtsArcCurve3, type XtsConfig, XtsConfigNormalizer, type XtsModelDocument, XtsPointCloudCurve3, type XtsRuntimeState, XtsViewer3D, type XtsViewer3DProps, type XtsViewer3DRef, type XtsViewerError, type XtsViewerErrorCode, XtsViewerErrorException, angleDeg, applyBeckhoffXtsConvention, applyEmptyClick, applyModuleClick, applyMoverClick, arcPoints, axisDistanceMm, buildChain, buildModuleProbes, buildPartPath, buildTrackIndex, chainToUserPositionMm, checkModuleCollisions, checkSamePathCollisions, chooseSnapCandidate, collectFeedSegments, collectFeedSegmentsForXpu, collectTriangleSnapCandidates, composeAssetUrl, computeMeasurementResult, createHepcoGfxBaseplateShape, createHepcoGfxRailShape, deselectAll, distanceMm, findModuleAt, formatAngleDeg, formatLengthMm, getModuleEntry, getMoverEntry, getPointCloud, getSharedAssetLoader, interpolateHeatmapValue, isChainClosed, isKnownModuleType, isKnownMoverType, isModuleSelected, isMoverSelected, labelAnchorFor, moduleAnchorWorld, moduleEndDelta, moduleSidecarFilename, moverAnchorWorld, moverSidecarFilename, moverWorldAt, nearestTrackPoint, normaliseToHeatmapRange, normalizeXtsConfig, pathLengthsMm, pickGlbForRail, poseToMatrix4, railSidecarFilename, registerPointCloud, resolveEntityFromObject, resolveGuidingRailGlbUrl, resolveGuidingRailType, resolveHepcoGfxProfile, resolveMeasurementStyle, resolveModuleGlbUrl, resolveMoverGlbUrl, resolveOriginCorrection, resolveStopPositionMm, resolveToolGlbUrl, sampleChainPoint, sampleChainRange, sampleModulePath, snapToGrid, sortHeatmapSamples, splitIntoFeedSegments, toolSidecarFilename, trackAnchorWorld, trackDistanceMm, trackLengthOf, trackPolylineWorld, unregisterPointCloud, useSidecarSource, userToChainPositionMm, worldPointOnPart };
+export { type AngleMeasurement, type Annotation, type AnnotationAnchor, type AnnotationInput, type AreaConfig, type AreaOptions, AssetLoader, type AssetManifest, BUILTIN_MODULE_SIDECARS, BUILTIN_MOVER_SIDECARS, BUILTIN_RAIL_SIDECARS, BUILTIN_TOOL_SIDECARS, type BuiltChain, type BuiltModule, type CameraProjection, type CameraState, type CaptureDimensions, type CaptureMode, type CaptureRequest, type CheckModuleCollisionsOptions, type CheckMoverCollisionsOptions, type ClickModifiers, type CoordinateSystem, type CustomAssetBinding, type CustomAssetConfig, type CustomMoverLayout, DEFAULT_LABEL_FONT_URL, DEFAULT_MEASUREMENT_STYLE, DEFAULT_MODULE_HALF_WIDTH_MM, DEFAULT_MODULE_HEIGHT_MM, DEFAULT_MODULE_MANIFEST, DEFAULT_MOVER_MANIFEST, DEFAULT_ORIGIN_CORRECTION, DEFAULT_RAIL_MANIFEST, DEFAULT_SNAP_KINDS, DEFAULT_SNAP_RADIUS_PX, DEFAULT_TOOL_MANIFEST, type DimensionOptions, type DisplayOptions, type DistanceMeasurement, EMPTY_SELECTION, type EndDelta, type FeedSegment, type FeedSegmentHighlight, type FeedSegmentSelector, type FeedSegmentSpan, type FocusOptions, type FocusTarget, type FrameCaptureOptions, type FrameCaptureSession, HEPCO_GFX_PROFILE, type HeatmapSample, type HepcoGfxRailProfileDims, IDENTITY_POSE, INFEED_MODULE_TYPES, type InfoBarConfig, type InfoBarMarkerConfig, type InfoBarOptions, type InteractionLocks, JSDELIVR_ASSETS_BASE_URL, MODULE_CATALOG, MODULE_GUIDING_RAIL_MAP, MOVER_CATALOG, type MarkerOptions, type MarkerShape, type MeasuredEntityRef, type Measurement, type MeasurementApi, type MeasurementAxis, type MeasurementDocument, type MeasurementDraft, type MeasurementFormatOptions, type MeasurementId, type MeasurementInput, type MeasurementKind, type MeasurementOptions, type MeasurementPoint, type MeasurementResult, type MeasurementSnapshot, type MeasurementStyle, type MeasurementTool, type ModuleAssetEntry, type ModuleCatalogEntry, type ModuleCollision, type ModuleCollisionPartInput, type ModuleCollisionXpuInput, ModuleCornerMarkers, type ModuleEntry, type ModuleHighlight, type ModuleProbe, type ModuleRef, type ModuleSidecar, type ModuleStatusEntry, type ModuleType3D, type MoverAssetEntry, type MoverCatalogEntry, type MoverCollision, type MoverConfig, MoverIdLabel, type MoverIdLabelOptions, type MoverPositionEntry, type MoverProbe, type MoverRef, type MoverSidecar, type MoverToolAssetEntry, type MoverToolConfig, type MoverToolSidecar, type MoverToolType3D, type MoverType3D, type NormalizationWarning, type NormalizedXtsConfig, type Orientation, type OriginCorrection, type PartConfig, type PartPath, type PartTransformation, type PathMeasurement, type PathSample, type PathType, type PerformanceOptions, type PlanarPose, type PointCloud, type PointProjector, type PositionFrame, type ProcessingUnitConfig, type RailAssetEntry, type RailSidecar, type RailSystem, type RailType3D, type ResolvedMeasurementStyle, SIDECAR_KINDS, type ScreenshotFormat, type ScreenshotMode, type ScreenshotOptions, type ScreenshotResult, type SelectionMode, type SelectionState, type SidecarIdOf, type SidecarKind, type SidecarKindSpec, type SidecarKinds, SidecarLoader, type SidecarOf, type SidecarOverrides, type SidecarSourceConfig, SidecarSourceContext, type SnapCandidate, type SnapKind, type SnapOptions, type SplitFeedSegmentsOptions, type StationConfig, type StationOptions, type StatorHeatmap, type StopPositionMoverOptions, type TextOptions, type TrackAnchor, type TrackDistanceMeasurement, type TrackIndex, type TrackIndexEntry, type TrackMetrics, type TrackMetricsResolver, type TrackProjection, type TrackTransform, VERSION, type Vec2, type Vec3, type ViewCubeAlignment, type ViewCubeOptions, XtsArcCurve3, type XtsConfig, XtsConfigNormalizer, type XtsModelDocument, XtsPointCloudCurve3, type XtsRuntimeState, XtsViewer3D, type XtsViewer3DProps, type XtsViewer3DRef, type XtsViewerError, type XtsViewerErrorCode, XtsViewerErrorException, angleDeg, applyBeckhoffXtsConvention, applyEmptyClick, applyModuleClick, applyMoverClick, arcPoints, axisDistanceMm, buildChain, buildModuleProbes, buildPartPath, buildTrackIndex, chainToUserPositionMm, checkAllModuleCollisions, checkAllMoverCollisions, checkModuleCollisions, checkSamePathCollisions, chooseSnapCandidate, collectFeedSegments, collectFeedSegmentsForXpu, collectTriangleSnapCandidates, composeAssetUrl, computeMeasurementResult, createHepcoGfxBaseplateShape, createHepcoGfxRailShape, deselectAll, distanceMm, findModuleAt, formatAngleDeg, formatLengthMm, getModuleEntry, getMoverEntry, getPointCloud, getSharedAssetLoader, interpolateHeatmapValue, isChainClosed, isKnownModuleType, isKnownMoverType, isModuleSelected, isMoverSelected, labelAnchorFor, moduleAnchorWorld, moduleEndDelta, moduleSidecarFilename, moverAnchorWorld, moverSidecarFilename, moverWorldAt, nearestTrackPoint, normaliseToHeatmapRange, normalizeXtsConfig, pathLengthsMm, pickGlbForRail, poseToMatrix4, railSidecarFilename, registerPointCloud, resolveEntityFromObject, resolveGuidingRailGlbUrl, resolveGuidingRailType, resolveHepcoGfxProfile, resolveMeasurementStyle, resolveModuleGlbUrl, resolveMoverGlbUrl, resolveOriginCorrection, resolveStopPositionMm, resolveToolGlbUrl, sampleChainPoint, sampleChainRange, sampleModulePath, snapToGrid, sortHeatmapSamples, splitIntoFeedSegments, toModuleCollisionInputs, toolSidecarFilename, trackAnchorWorld, trackDistanceMm, trackLengthOf, trackPolylineWorld, unregisterPointCloud, useSidecarSource, userToChainPositionMm, worldPointOnPart };