beckhoff-xts-viewer-3d 3.0.0 → 4.0.0

package/dist/index.d.cts

@@ -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: "3.0.0";
+declare const VERSION: "4.0.0";
 
 /**
  * Default CDN URL for the GLB asset bundle (`beckhoff-xts-viewer-3d-assets`).
@@ -37,25 +37,24 @@ declare const JSDELIVR_ASSETS_BASE_URL: "https://cdn.jsdelivr.net/npm/beckhoff-x
 /**
  * Public type surface for beckhoff-xts-viewer-3d.
  *
- * This file is the canonical TypeScript representation of the JSON schema
- * specified in docs/spec/xts-3d-viewer.md §6. Anything that crosses the
- * Component boundary — props, refs, callbacks — is declared here.
+ * Anything that crosses the Component boundary — props, refs, callbacks —
+ * is declared here.
  */
-/** Beckhoff XTS module types supported by the 3D viewer (spec §6.3). */
+/** Beckhoff XTS module types supported by the 3D viewer. */
 type ModuleType3D = 'AT2000_0250' | 'AT2001_0250' | 'AT2002_0250' | 'AT2002_0249' | 'AT2002_0249_ZX2002_0001' | 'AT2000_0233' | 'AT2000_0249' | 'AT2100_0250' | 'AT2102_0250' | 'AT2020_0250' | 'AT2021_0250' | 'AT2025_0250' | 'AT2026_0250' | 'AT2040_0250' | 'AT2041_0250' | 'AT2042_0250' | 'AT2140_0250' | 'AT2050_0500' | 'AT2050_0501' | 'AT2050_0500_180' | 'AT2200_0500' | 'AT2202_0500' | 'ATH2000_0250' | 'ATH2001_0250' | 'ATH2002_0250' | 'ATH2020_0250' | 'ATH2040_0250' | 'ATH2041_0250' | 'ATH2042_0250' | 'ATH2050_0500' | 'ATH2050_0501' | 'ATH2050_0500_180';
 /**
- * Schienensystem unter dem Modul. Beeinflusst nur das visuelle Mesh
- * (Beckhoff Aluminium-Schiene vs. Hepco GFX), nicht die Pfad-Math.
+ * Rail system beneath the module. Only affects the visual mesh
+ * (Beckhoff aluminium rail vs. Hepco GFX), not the path math.
  *
- * `Beckhoff` ist die Beckhoff-Aluminium-Führungsschiene (alle
- * AT-Standard- + Eco-Familien); `HepcoGfx` ist das alternative
- * Hepco-GFX-Profil. ATH-Module bringen ihre Schiene im Modul-GLB
- * mit und sind von dieser Wahl unabhängig.
+ * `Beckhoff` is the Beckhoff aluminium guiding rail (all
+ * AT-Standard + Eco families); `HepcoGfx` is the alternative
+ * Hepco GFX profile. ATH modules ship with their rail baked into
+ * the module GLB and are independent of this choice.
  */
 type RailSystem = 'Beckhoff' | 'HepcoGfx';
 /** Beckhoff XTS + Hepco mover types. `Custom` requires `customMoverLayout`. */
 type MoverType3D = 'AT9011_0050' | 'AT9011_0070' | 'AT9012_0050' | 'AT9014_0055' | 'AT9014_0070' | 'ATH9011_0075' | 'ATH9013_0075' | 'Hepco_GFX2_1TC_S25' | 'Custom';
-/** Predefined mover-tool / carrier-plate types (spec §4.8). */
+/** Predefined mover-tool / carrier-plate types. */
 type MoverToolType3D = 'AT8200_1000_0100' | 'AT8200_2000_0100' | 'Custom';
 /**
  * Beckhoff guiding-rail GLB variants. Rendered alongside the motor modules
@@ -137,11 +136,11 @@ interface XtsConfig {
     processingUnits: ProcessingUnitConfig[];
     stations?: StationConfig[];
     /**
-     * Beschriftete Bereiche entlang der Strecke. Wie eine StationConfig, aber
-     * ohne Stop-Positionen — nur ein farbiges Tube-Segment plus optionaler
-     * Beschreibungs-Billboard. Für Zonenmarkierungen (z. B. „Manueller
-     * Zugriff", „Sicherheitsbereich", „Reinraum"), die keine
-     * Maschinen-Stops haben.
+     * Labelled regions along the track. Like a StationConfig, but
+     * without stop positions — only a coloured tube segment plus an
+     * optional description billboard. For zone markings (e.g. "Manual
+     * Access", "Safety Area", "Cleanroom") that have no
+     * machine stops.
      */
     areas?: AreaConfig[];
     infoBars?: InfoBarConfig[];
@@ -218,7 +217,7 @@ interface PartConfig {
      * the contract is violated.
      */
     objectId: number;
-    /** = ServerTypes.PartModel.ObjectId — eindeutig systemweit. */
+    /** = ServerTypes.PartModel.ObjectId — unique system-wide. */
     globalNumber: number;
     modules: ModuleEntry[];
     partTransformation?: PartTransformation;
@@ -291,16 +290,16 @@ interface MoverConfig {
      * is unique across all movers in the config.
      */
     id: number;
-    /** Verweist auf PartConfig.globalNumber. */
+    /** References PartConfig.globalNumber. */
     partOid: number;
-    /** [0, part.trackLengthMm] — clamped wenn out-of-bounds. */
+    /** [0, part.trackLengthMm] — clamped when out-of-bounds. */
     partPositionMm: number;
     status?: {
         warning?: boolean;
         error?: boolean;
     };
     selected?: boolean;
-    /** Vordefinierte Werkzeug-Carrier oder Custom-GLBs an diesem Mover. */
+    /** Predefined tool carriers or custom GLBs attached to this mover. */
     tools?: MoverToolConfig[];
 }
 /**
@@ -382,7 +381,7 @@ interface CustomAssetConfig {
 }
 interface DisplayOptions {
     displayStations?: boolean;
-    /** Render konfigurierte Areas. Default: true (wenn `areas[]` gesetzt ist). */
+    /** Render configured areas. Default: true (when `areas[]` is set). */
     displayAreas?: boolean;
     displayDimensions?: boolean;
     showDriveErrors?: boolean;
@@ -431,7 +430,7 @@ interface DisplayOptions {
      * Use during calibration to verify that adjacent modules' mating-faces
      * are in geometrically the same place — when the corner spheres of two
      * neighbouring modules overlap, the chain has C0 continuity at that
-     * boundary (spec §3.9). Off by default.
+     * boundary. Off by default.
      */
     showModuleCornerMarkers?: boolean;
     /** Diameter (mm) of the corner-marker spheres. Default: 10. */
@@ -689,7 +688,7 @@ interface StationConfig {
     partOids: number[];
     startPositionOnPart: number;
     endPositionOnPart: number;
-    /** ARGB int (wie 2D). */
+    /** ARGB int (same as 2D). */
     stationColor: number;
     stopPositions?: number[];
     /**
@@ -716,14 +715,14 @@ interface StationConfig {
     stopMarkerSizeMm?: number;
 }
 /**
- * Beschrifteter Bereich entlang der Strecke. Identisch mit
- * `StationConfig`, aber ohne Stop-Positionen — Areas haben nur Text +
- * Farbe und beschreiben eine Zone (z. B. „Reinraum", „Manueller Zugriff",
- * „Sicherheitskreis"), die keine Maschinen-Stops auslöst.
+ * Labelled region along the track. Identical to
+ * `StationConfig`, but without stop positions — areas only carry text +
+ * colour and describe a zone (e.g. "Cleanroom", "Manual Access",
+ * "Safety Loop") that does not trigger machine stops.
  *
- * Multi-part: identische Semantik wie `StationConfig.partOids`. Mit nur
- * einem partOid und `endPositionOnPart < startPositionOnPart` wird ein
- * geschlossener Loop gerendert (ans Track-Ende, dann von 0 zum End).
+ * Multi-part: same semantics as `StationConfig.partOids`. With a single
+ * partOid and `endPositionOnPart < startPositionOnPart`, a closed loop
+ * is rendered (to the end of the track, then from 0 to End).
  */
 interface AreaConfig {
     areaId: number;
@@ -732,7 +731,7 @@ interface AreaConfig {
     partOids: number[];
     startPositionOnPart: number;
     endPositionOnPart: number;
-    /** ARGB int (wie StationConfig). Wird für Tube + Default-Label genutzt. */
+    /** ARGB int (same as StationConfig). Used for tube + default label. */
     color: number;
 }
 interface InfoBarConfig {
@@ -776,7 +775,7 @@ type SelectionMode = 'Off' | 'Single' | 'Multi';
 interface CameraState {
     positionMm: Vec3;
     targetMm: Vec3;
-    /** Always 'Z' im aktuellen Spec. */
+    /** Always 'Z' in the current spec. */
     upAxis: 'Z' | 'Y';
     zoom?: number;
 }
@@ -855,16 +854,15 @@ interface XtsRuntimeState {
 /**
  * Module catalog (3D-canonical).
  *
- * Per spec §2.2 + §3, every module declares its path topology
- * (Straight / Curve / Free), its arc length, and — for curves — the signed
- * end-of-module yaw delta in degrees. Centerline radius for analytic curves
- * is derived from `R = L / |θ_rad|` (spec §3.2 footnote 2).
+ * Every module declares its path topology (Straight / Curve / Free), its
+ * arc length, and — for curves — the signed end-of-module yaw delta in
+ * degrees. Centerline radius for analytic curves is derived from
+ * `R = L / |θ_rad|`.
  *
- * Hygienic ATH variants share path math with their AT pendants (spec §14.2)
- * — only the GLB mesh differs.
+ * Hygienic ATH variants share path math with their AT pendants — only the
+ * GLB mesh differs.
  *
- * This file is hand-curated to match docs/spec/data/module-catalog-3d.json
- * and §14.1 AABB inspection. The geometry module imports from here directly
+ * This file is hand-curated. The geometry module imports from here directly
  * (no JSON fetch) so the library has zero runtime data deps.
  */
 
@@ -876,14 +874,14 @@ interface ModuleCatalogEntry {
     pathType: PathType;
     /**
      * Encoder-side end-of-module yaw, in degrees, in the module-local 3D frame.
-     * Sign convention (spec §3.2): positive endAngle ⇒ Y-flip math curves toward
+     * Sign convention: positive endAngle ⇒ Y-flip math curves toward
      * −Y (= right of path). 0 for Straight. 180 for AT2050_*_180 free path.
      */
     endAngleDeg: number;
     /**
      * Centerline radius for analytic curves, in mm. `null` for Straight + Free.
      * Computed as R = L / |θ_rad|; equals 636.6198 for ±22.5° and 318.3099 for
-     * ±45° curves at L=250 (spec §2.2 + §3.2).
+     * ±45° curves at L=250.
      */
     centerlineRadiusMm: number | null;
     /**
@@ -892,7 +890,7 @@ interface ModuleCatalogEntry {
      * geometry/PointClouds.ts.
      */
     freePathId?: string;
-    /** True if STP is not delivered yet (spec §14.4). */
+    /** True if STP is not delivered yet. */
     prepared?: boolean;
 }
 declare const MODULE_CATALOG: Readonly<Record<ModuleType3D, ModuleCatalogEntry>>;
@@ -904,7 +902,7 @@ declare function isKnownModuleType(value: string): value is ModuleType3D;
 /**
  * ChainBuilder — builds the per-module `startWorldMatrix` for a Part.
  *
- * Spec §3.3 (simplified — modules butt up edge-to-edge in this build):
+ * Chain composition (simplified — modules butt up edge-to-edge in this build):
  *   chain_world = Identity
  *   for each module_i:
  *     module_i.startWorldMatrix       = chain_world
@@ -960,8 +958,8 @@ interface BuiltChain {
 declare function buildChain(modules: ReadonlyArray<ModuleEntry>): BuiltChain;
 /**
  * Locate the module containing `partPositionMm` along the chain.
- * Spec §3.4: first module with partPosition < startInPart + trackLength;
- * at boundary `partPosition == trackLength` the LAST module is returned with
+ * First module with partPosition < startInPart + trackLength; at boundary
+ * `partPosition == trackLength` the LAST module is returned with
  * `localPos = trackLength`.
  */
 declare function findModuleAt(chain: BuiltChain, partPositionMm: number): {
@@ -969,7 +967,7 @@ declare function findModuleAt(chain: BuiltChain, partPositionMm: number): {
     localPosMm: number;
 } | null;
 /**
- * Mover world pose at `partPositionMm` (spec §3.4).
+ * Mover world pose at `partPositionMm`.
  *
  * The module's startWorldPose is composed with the local path sample at
  * `localPosMm` along that module's path.
@@ -1091,14 +1089,14 @@ declare function checkSamePathCollisions(chain: BuiltChain, partOid: number, pro
 /**
  * normalizeXtsConfig — pre-render pass.
  *
- * Spec §6.6 + §10.1 — fail-fast validation + AT2050 half-clothoid merging:
+ * 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 ohne 0501 oder umgekehrt)
+ *   - 'unmatched-clothoid-half'   (0500 without 0501 or vice versa)
  *
  * Warnings (collected, non-fatal) returned alongside the normalized config:
  *   - mover.partOid not in part-list
@@ -1298,15 +1296,15 @@ interface XtsViewer3DRef {
 }
 
 /**
- * SidecarLoader — fetches per-asset JSON sidecars (spec §4.3, §4.4, §4.8.4).
+ * 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)` per spec §10.4. The renderer can still place the GLB; the
- * calibration tool is the authoritative source for sidecar values.
+ * `(0,0,0)`. The renderer can still place the GLB; the calibration tool is
+ * the authoritative source for sidecar values.
  */
 
 interface OriginCorrection {
@@ -1391,7 +1389,7 @@ 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' (spec §14.4).
+ * not delivered'.
  */
 declare function pickGlbForRail(sidecar: ModuleSidecar | undefined, rail: RailSystem): string | null;
 
@@ -1493,7 +1491,7 @@ declare function createHepcoGfxBaseplateShape(dims?: HepcoGfxRailProfileDims): S
 declare function createHepcoGfxRailShape(dims?: HepcoGfxRailProfileDims): Shape;
 
 /**
- * <XtsViewer3D> — Top-level React component (spec §6.1).
+ * <XtsViewer3D> — Top-level React component.
  *
  * Thin wrapper around the r3f <Canvas>:
  *   - useNormalizedConfig:    pre-render validate + clamp pass
@@ -1516,33 +1514,33 @@ interface SidecarOverrides {
     rails?: Partial<Record<RailType3D, OriginCorrection>>;
 }
 interface XtsViewer3DProps {
-    /** Vollständige XTS-Konfiguration. */
+    /** Complete XTS configuration. */
     config: XtsConfig;
     /**
-     * Basis-URL für GLB-Assets.
+     * Base URL for GLB assets.
      *
-     * Default: `JSDELIVR_ASSETS_BASE_URL`, das auf
+     * Default: `JSDELIVR_ASSETS_BASE_URL`, which points to
      * `https://cdn.jsdelivr.net/npm/beckhoff-xts-viewer-3d-assets@<version>/models`
-     * zeigt — das Schwester-Paket mit allen GLBs, version-pinned an die
-     * Viewer-Version.
+     * — the sister package with all GLBs, version-pinned to the
+     * viewer version.
      */
     assetsBaseUrl?: string;
     /**
-     * Quelle der Sidecar-Calibration-Daten.
+     * Source of the sidecar calibration data.
      *
-     *   • `true` (default) — Sidecars kommen aus dem gebundelten
-     *     `BUILTIN_*_SIDECARS`-Konstanten in der JS-Bibliothek.
-     *   • `false` — Jedes Sidecar wird live von
-     *     `<assetsBaseUrl>/<id>.meta.json` geholt.
+     *   • `true` (default) — sidecars come from the bundled
+     *     `BUILTIN_*_SIDECARS` constants in the JS library.
+     *   • `false` — each sidecar is fetched live from
+     *     `<assetsBaseUrl>/<id>.meta.json`.
      */
     useBuiltinSidecars?: boolean;
-    /** Override des Modul-/Mover-Asset-Manifests (für Tests, alternative Skins). */
+    /** Override of the module / mover asset manifest (for tests, alternative skins). */
     assetManifest?: AssetManifest;
-    /** Display-Optionen. */
+    /** Display options. */
     display?: DisplayOptions;
-    /** Initial-Kamera. */
+    /** Initial camera. */
     initialCamera?: CameraState;
-    /** Sperren von Interaktionen. */
+    /** Lock interactions. */
     lock?: {
         rotate?: boolean;
         pan?: boolean;
@@ -1574,8 +1572,8 @@ interface XtsViewer3DProps {
         autoPauseOnHidden?: boolean;
     };
     /**
-     * Live override of the per-asset origin-correction sidecars (spec §4.3,
-     * §4.4). Useful for the calibration tool.
+     * Live override of the per-asset origin-correction sidecars. Useful for
+     * the calibration tool.
      */
     sidecarOverrides?: SidecarOverrides;
     /**
@@ -1622,8 +1620,8 @@ declare const XtsViewer3D: React__default.ForwardRefExoticComponent<XtsViewer3DP
 /**
  * Mover catalog (3D-canonical).
  *
- * Per spec §2.3. Magnet-plate-center-Mm is the canonical attachment point on
- * the path centerline (after originCorrection of the GLB).
+ * Magnet-plate-center-Mm is the canonical attachment point on the path
+ * centerline (after originCorrection of the GLB).
  */
 
 interface MoverCatalogEntry {
@@ -1643,12 +1641,12 @@ declare function getMoverEntry(moverType: MoverType3D): MoverCatalogEntry | unde
 declare function isKnownMoverType(value: string): value is MoverType3D;
 
 /**
- * Module-local path math (spec §3.2).
+ * Module-local path math.
  *
  * Pure functions, no Three.js dependency. Returns position + tangent + yaw
  * in the module-local 3D frame after originCorrection (centerline on Z=0).
  *
- * Coordinate conventions (spec §3.1):
+ * Coordinate conventions:
  *   - Y-flip: 3D-Y = -2D-canvas-Y, so positive endAngle (2D-positive)
  *     curves toward −Y in 3D.
  *   - 1 unit = 1 mm.
@@ -1668,7 +1666,7 @@ interface PathSample {
  */
 declare function sampleModulePath(module: ModuleCatalogEntry, sMm: number): PathSample;
 /**
- * End-of-module local transform (spec §3.3):
+ * End-of-module local transform:
  * Δ_local = T( ΔX, -ΔY_canvas, 0 ) ⊗ R_z( -θ )
  *
  * We return the position delta and yaw delta separately so callers can compose
@@ -1685,14 +1683,13 @@ declare function moduleEndDelta(module: ModuleCatalogEntry): EndDelta;
 /**
  * XtsArcCurve3 — Three.js Curve3 wrapper around the analytic Curve sample.
  *
- * Spec §3.5: each module exposes a THREE.Curve<Vector3> that the part-level
- * CurvePath chains together. For analytic Curves we just wrap the math from
+ * Each module exposes a THREE.Curve<Vector3> that the part-level CurvePath
+ * chains together. For analytic Curves we just wrap the math from
  * pathMath.ts; for Free paths see XtsPointCloudCurve3.
  *
- * Note (spec §3.5): CurvePath delegates to subcurve length-proportional, so
- * `getLength()` MUST return the actual arc length so subcurves are weighted
- * correctly. Our subcurves are arc-length parametrised (t = s / L), so this
- * just-works.
+ * Note: CurvePath delegates to subcurve length-proportional, so `getLength()`
+ * MUST return the actual arc length so subcurves are weighted correctly.
+ * Our subcurves are arc-length parametrised (t = s / L), so this just-works.
  */
 
 declare class XtsArcCurve3 extends Curve<Vector3> {
@@ -1706,8 +1703,8 @@ declare class XtsArcCurve3 extends Curve<Vector3> {
 /**
  * XtsPointCloudCurve3 — Three.js Curve3 wrapper around the Free-path sample.
  *
- * Spec §3.5 + §3.2 Free + §3.11. The off-by-one clamp at s == ModuleLength
- * (spec §3.2 critical edge case) is handled in pathMath.sampleModulePath.
+ * The off-by-one clamp at s == ModuleLength is handled in
+ * pathMath.sampleModulePath.
  */
 
 declare class XtsPointCloudCurve3 extends Curve<Vector3> {
@@ -1721,8 +1718,8 @@ declare class XtsPointCloudCurve3 extends Curve<Vector3> {
 /**
  * PathBuilder — assemble a `THREE.CurvePath<Vector3>` for a Part.
  *
- * Spec §3.5: pro Part eine CurvePath, die alle Modul-Curves end-to-end
- * verkettet. Per Modul:
+ * One CurvePath per part, chaining all module curves end-to-end.
+ * Per module:
  *   - Straight → THREE.LineCurve3 (module geometry baked in)
  *   - Curve    → XtsArcCurve3 (analytic)
  *   - Free     → XtsPointCloudCurve3
@@ -1742,9 +1739,9 @@ interface PartPath {
 }
 /**
  * Build a Part path. Returns the BuiltChain plus a CurvePath for visual
- * debug splines (spec §3.9 continuity overlay). The CurvePath subcurves
- * live in MODULE-LOCAL coordinates; the consumer is responsible for placing
- * each module under a parent group with `startWorldPose` applied.
+ * debug splines (continuity overlay). The CurvePath subcurves live in
+ * MODULE-LOCAL coordinates; the consumer is responsible for placing each
+ * module under a parent group with `startWorldPose` applied.
  */
 declare function buildPartPath(modules: ReadonlyArray<ModuleEntry>): PartPath;
 /**
@@ -1754,7 +1751,7 @@ declare function buildPartPath(modules: ReadonlyArray<ModuleEntry>): PartPath;
 declare function poseToMatrix4(pose: PlanarPose, out?: Matrix4): Matrix4;
 
 /**
- * Point-cloud registry for Free-path modules (spec §3.11).
+ * Point-cloud registry for Free-path modules.
  *
  * The AT2050 / ATH2050 180° U-turn is sampled at Δs = 0.1 mm with 5001
  * points covering [0..500] mm of arc length. The data ships as JSON files
@@ -1763,7 +1760,7 @@ declare function poseToMatrix4(pose: PlanarPose, out?: Matrix4): Matrix4;
  *
  * Y-axis convention in the JSON is 2D-canvas-down (positive = "into the
  * curve"). XtsPointCloudCurve3 applies the Y-flip when projecting into the
- * 3D RH-Z-up frame (spec §3.2 Free).
+ * 3D RH-Z-up frame.
  *
  * Build note: `tsc` does not emit imported .json files. A postbuild copy
  * step (scripts/copy-runtime-data.mjs) mirrors src/geometry/data/*.json
@@ -1860,7 +1857,7 @@ declare function normaliseToHeatmapRange(value: number, min: number, max: number
 /**
  * Path-sample helpers — convert a chain + a [startMm, endMm] range into a
  * world-frame polyline of Vector3s. Used by Stations, Dimensions and
- * InfoBars (spec §5) to build TubeGeometries that follow the path.
+ * InfoBars to build TubeGeometries that follow the path.
  */
 
 /**
@@ -1894,9 +1891,9 @@ declare function sampleChainPoint(chain: BuiltChain, positionMm: number, liftZ?:
  *
  * The XtsViewer3D owns a SelectionManager instance internally and exposes
  * selection updates through the controlled `selection` prop and the
- * `onSelectionChange` callback (spec §6.2).
+ * `onSelectionChange` callback.
  *
- * Spec §5 selection modes:
+ * Selection modes:
  *   - Off    → ignore clicks
  *   - Single → click replaces selection with one item
  *   - Multi  → ctrl/meta-click adds, shift-click range-selects (modules
@@ -1924,8 +1921,8 @@ declare function applyEmptyClick(selection: SelectionState, mode: SelectionMode)
  * <ModuleCornerMarkers> — 8 red spheres at the GLB's CAD-frame AABB corners.
  *
  * Calibration helper: when two adjacent modules are placed correctly in the
- * chain (spec §3.9 C0/C1 continuity), the corner sphere on Module N's exit
- * face overlaps the matching corner sphere on Module N+1's entry face. A
+ * chain (C0/C1 continuity), the corner sphere on Module N's exit face
+ * overlaps the matching corner sphere on Module N+1's entry face. A
  * visible gap or overlap signals a bad origin-correction (or a bad chain
  * transform — but the latter is unit-tested).
  *
@@ -2045,19 +2042,18 @@ declare const SidecarSourceContext: React.Context<SidecarSourceConfig>;
 declare function useSidecarSource(): SidecarSourceConfig;
 
 /**
- * Default asset manifest (spec §4.2 — UPPERCASE-Bindestrich filenames).
+ * Default asset manifest (UPPERCASE-hyphen filenames).
  *
  * URLs are relative to `assetsBaseUrl` (default `/models`). The viewer can
  * override entries via the `assetManifest` prop (e.g. for tests, alternative
  * skins, or to plug in user GLBs).
  *
  * Hygienic ATH modules carry per-RailSystem URLs. Standard AT/Eco modules
- * only set `Beckhoff`; the loader silently falls back to that
- * variant when `HepcoGfx` is requested but unavailable (spec §4.3).
+ * only set `Beckhoff`; the loader silently falls back to that variant when
+ * `HepcoGfx` is requested but unavailable.
  *
  * `null` for `Beckhoff` marks "prepared but not delivered"
- * (AT2042 / AT2140) — the loader renders a placeholder AABB mesh
- * (spec §14.4).
+ * (AT2042 / AT2140) — the loader renders a placeholder AABB mesh.
  */
 
 /** Filename mapping per ModuleType3D (relative to assetsBaseUrl). */
@@ -2077,7 +2073,7 @@ declare const DEFAULT_RAIL_MANIFEST: Readonly<Record<RailType3D, {
     glbUrl: string;
 }>>;
 /**
- * ModuleType → guiding-rail mapping (spec §14.x extension).
+ * ModuleType → guiding-rail mapping.
  *
  * Picks the rail GLB by curve sign + arc length:
  *   - Straights pick the matching-length AT9000 rail (0249 / 0250 / 0500).
@@ -2108,15 +2104,14 @@ declare function resolveGuidingRailGlbUrl(railType: RailType3D, override?: Asset
 /**
  * AssetLoader — promise-cached GLB loader for the viewer.
  *
- * Spec §9 performance strategy: pro Modul-/Mover-Typ wird genau eine GLB
- * geladen, dann pro Instanz `clone()`. The loader is keyed by absolute URL
+ * Performance strategy: exactly one GLB is loaded per module / mover type,
+ * then `clone()` is called per instance. The loader is keyed by absolute URL
  * (concat of assetsBaseUrl + entry filename), and concurrent loads of the
  * same URL share a single in-flight Promise.
  *
  * Asset failure: a 404 (or any fetch error) surfaces as
  * XtsViewerErrorException(code='asset-load-failed'). The renderer is
- * expected to fall back to a Wireframe-AABB placeholder (spec §11.4 +
- * §10.4).
+ * expected to fall back to a wireframe-AABB placeholder.
  *
  * Concurrent-cancel: when `cancel()` is called for a URL, future awaiters
  * receive an AbortError. The cache entry is cleared so a fresh `load()`
@@ -2149,22 +2144,4 @@ declare function getSharedAssetLoader(): AssetLoader;
 /** Compose a URL from a base + a filename, normalising trailing slashes. */
 declare function composeAssetUrl(baseUrl: string, filename: string): string;
 
-/**
- * beckhoff-xts-viewer-3d
- *
- * 3D React component for rendering Beckhoff XTS linear-motor systems.
- *
- * Public surface:
- *   - <XtsViewer3D> React component (Phase 1 — see components/XtsViewer3D.tsx)
- *   - Geometry primitives (XtsArcCurve3, XtsPointCloudCurve3, ChainBuilder)
- *   - normalizeXtsConfig pre-pass
- *   - Module + Mover catalogs
- *   - All TypeScript types from spec §6
- */
-
-declare const SPEC_VERSION: "v5";
-
-/** Returns the spec version this package targets. */
-declare function specVersion(): string;
-
-export { type AreaConfig, type AreaOptions, AssetLoader, type AssetManifest, BUILTIN_MODULE_SIDECARS, BUILTIN_MOVER_SIDECARS, BUILTIN_RAIL_SIDECARS, BUILTIN_TOOL_SIDECARS, type BuiltChain, type BuiltModule, type CameraState, type CheckMoverCollisionsOptions, type ClickModifiers, type CustomAssetBinding, type CustomAssetConfig, type CustomMoverLayout, DEFAULT_LABEL_FONT_URL, DEFAULT_MODULE_MANIFEST, DEFAULT_MOVER_MANIFEST, DEFAULT_ORIGIN_CORRECTION, DEFAULT_RAIL_MANIFEST, DEFAULT_TOOL_MANIFEST, type DimensionOptions, type DisplayOptions, EMPTY_SELECTION, type EndDelta, HEPCO_GFX_PROFILE, type HeatmapSample, type HepcoGfxRailProfileDims, IDENTITY_POSE, type InfoBarConfig, type InfoBarMarkerConfig, type InfoBarOptions, JSDELIVR_ASSETS_BASE_URL, MODULE_CATALOG, MODULE_GUIDING_RAIL_MAP, MOVER_CATALOG, type MarkerOptions, type MarkerShape, type ModuleAssetEntry, type ModuleCatalogEntry, ModuleCornerMarkers, type ModuleEntry, 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 PathSample, type PathType, type PlanarPose, type PointCloud, type PositionFrame, type ProcessingUnitConfig, type RailAssetEntry, type RailSidecar, type RailSystem, type RailType3D, SPEC_VERSION, type ScreenshotFormat, type ScreenshotMode, type ScreenshotOptions, type ScreenshotResult, type SelectionMode, type SelectionState, SidecarLoader, type SidecarOverrides, type SidecarSourceConfig, SidecarSourceContext, type StationConfig, type StationOptions, type StatorHeatmap, type StopPositionMoverOptions, type TextOptions, 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, applyEmptyClick, applyModuleClick, applyMoverClick, buildChain, buildPartPath, chainToUserPositionMm, checkSamePathCollisions, composeAssetUrl, createHepcoGfxBaseplateShape, createHepcoGfxRailShape, deselectAll, findModuleAt, getModuleEntry, getMoverEntry, getPointCloud, getSharedAssetLoader, interpolateHeatmapValue, isKnownModuleType, isKnownMoverType, isModuleSelected, isMoverSelected, moduleEndDelta, moduleSidecarFilename, moverSidecarFilename, moverWorldAt, normaliseToHeatmapRange, normalizeXtsConfig, pickGlbForRail, poseToMatrix4, railSidecarFilename, registerPointCloud, resolveGuidingRailGlbUrl, resolveGuidingRailType, resolveHepcoGfxProfile, resolveModuleGlbUrl, resolveMoverGlbUrl, resolveOriginCorrection, resolveStopPositionMm, resolveToolGlbUrl, sampleChainPoint, sampleChainRange, sampleModulePath, sortHeatmapSamples, specVersion, toolSidecarFilename, trackLengthOf, unregisterPointCloud, useSidecarSource, userToChainPositionMm };
+export { type AreaConfig, type AreaOptions, AssetLoader, type AssetManifest, BUILTIN_MODULE_SIDECARS, BUILTIN_MOVER_SIDECARS, BUILTIN_RAIL_SIDECARS, BUILTIN_TOOL_SIDECARS, type BuiltChain, type BuiltModule, type CameraState, type CheckMoverCollisionsOptions, type ClickModifiers, type CustomAssetBinding, type CustomAssetConfig, type CustomMoverLayout, DEFAULT_LABEL_FONT_URL, DEFAULT_MODULE_MANIFEST, DEFAULT_MOVER_MANIFEST, DEFAULT_ORIGIN_CORRECTION, DEFAULT_RAIL_MANIFEST, DEFAULT_TOOL_MANIFEST, type DimensionOptions, type DisplayOptions, EMPTY_SELECTION, type EndDelta, HEPCO_GFX_PROFILE, type HeatmapSample, type HepcoGfxRailProfileDims, IDENTITY_POSE, type InfoBarConfig, type InfoBarMarkerConfig, type InfoBarOptions, JSDELIVR_ASSETS_BASE_URL, MODULE_CATALOG, MODULE_GUIDING_RAIL_MAP, MOVER_CATALOG, type MarkerOptions, type MarkerShape, type ModuleAssetEntry, type ModuleCatalogEntry, ModuleCornerMarkers, type ModuleEntry, 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 PathSample, type PathType, type PlanarPose, type PointCloud, type PositionFrame, type ProcessingUnitConfig, type RailAssetEntry, type RailSidecar, type RailSystem, type RailType3D, type ScreenshotFormat, type ScreenshotMode, type ScreenshotOptions, type ScreenshotResult, type SelectionMode, type SelectionState, SidecarLoader, type SidecarOverrides, type SidecarSourceConfig, SidecarSourceContext, type StationConfig, type StationOptions, type StatorHeatmap, type StopPositionMoverOptions, type TextOptions, 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, applyEmptyClick, applyModuleClick, applyMoverClick, buildChain, buildPartPath, chainToUserPositionMm, checkSamePathCollisions, composeAssetUrl, createHepcoGfxBaseplateShape, createHepcoGfxRailShape, deselectAll, findModuleAt, getModuleEntry, getMoverEntry, getPointCloud, getSharedAssetLoader, interpolateHeatmapValue, isKnownModuleType, isKnownMoverType, isModuleSelected, isMoverSelected, moduleEndDelta, moduleSidecarFilename, moverSidecarFilename, moverWorldAt, normaliseToHeatmapRange, normalizeXtsConfig, pickGlbForRail, poseToMatrix4, railSidecarFilename, registerPointCloud, resolveGuidingRailGlbUrl, resolveGuidingRailType, resolveHepcoGfxProfile, resolveModuleGlbUrl, resolveMoverGlbUrl, resolveOriginCorrection, resolveStopPositionMm, resolveToolGlbUrl, sampleChainPoint, sampleChainRange, sampleModulePath, sortHeatmapSamples, toolSidecarFilename, trackLengthOf, unregisterPointCloud, useSidecarSource, userToChainPositionMm };