> ## Documentation Index
> Fetch the complete documentation index at: https://docs.speckle.systems/llms.txt
> Use this file to discover all available pages before exploring further.

# Migration Guide

<Update label="2.25.9 -> 2.27.2" description="January 2026">
  * `fromMeasurementData` changed to `addMeasurement` which takes a serialized measurement as
    argument - `zoomExtents` and explode now take only visible bounds into account, not total bounds
    by default
</Update>

<Update label="2.25.8 -> 2.25.9" description="August 2025">
  * [*ObjectClicked*](/developers/viewer/viewer-api#viewerevent) and
    [*ObjectDoubleClicked*](/developers/viewer/viewer-api#viewerevent) events now have their picked
    objects filtered by a default
    [*ObjectPickConfiguration*](/developers/viewer/speckle-renderer-api#objectpickconfiguration)
</Update>

<Update label="2.25.0 -> 2.25.8" description="July 2025">
  * `GeometryData` now stores the original geometry DataChunks instead of just number arrays. This
    change was the basis of a larger update we made to facilitate larger model loading by minimizing
    memory allocation during startup and load - `ViewerEvent.Busy` has been removed and it's no longer
    emitted
</Update>

<Update label="2.23.8 -> 2.25.0" description="May 2025">
  * `get clippingVolume` from `SpeckleRenderer` now returns an `OBB` - `set clippingvolume` from
    `SpeckleRenderer` now accepts both `Box3` and `OBB` - all intersection methods from
    `Intersections` now accept both `Box3` and `OBB` as bounds argument - `expandBoxRelative` from
    `World` now accepts both a `Box3` and a `OBB` - `requestUpdate` from `SectionOutlines` extension
    now takes an optional `force` argument that forces an update
</Update>

<Update label="2.23.6 -> 2.23.8" description="February 2025">
  * `Loader`'s `resourceData` changed from `string | ArrayBuffer` to `unknown` to allow each loader
    to define it's own resource data type
</Update>

<Update label="2.21.2 -> 2.23.6" description="January 2025">
  * `SmoothOrbitControls`'s constructor changed. It no longer takes a `Scene` and `Intersections`,
    but only a `SpeckleRenderer`
</Update>

<Update label="2.21.2 -> 2.22.2" description="November 2024">
  * `Loader`'s `resourceData` changed from `string | ArrayBuffer` to `unknown` to allow each loader
    to define it's own resource data type - `SmoothOrbitControls`'s constructor changed. It no longer
    takes a `Scene` and `Intersections`, but only a `SpeckleRenderer`
</Update>

<Update label="2.21.1 -> 2.22.2" description="October 2024">
  * Entire rendering pipeline got a massive update and it now allows for free user customization as
    well as user defined passes - `pipeline` accessors added to `SpeckleRenderer`. This allows for
    user defined rendering pipelines - `pipelineOptions` accessors removed from `SpeckleRenderer` -
    `PipelineOutputType` removed. The pipeline's result now depends on the pipeline's pass
    configuration - `DynamicAOPassParams` and it's default removed - `StaticAoPassParams` and it's
    default removed and replaced by `ProgressiveAOPassOptions` - A series of pre-defined rendering
    passes as well as entire rendering pipelines have been added
</Update>

<Update label="2.20.2 -> 2.21.1" description="September 2024">
  * `Vector3` and `Box3` have been removed from the viewer's exports. They can now be imported from
    three.js
</Update>

<Update label="2.19.4 -> 2.20.2" description="August 2024">
  * All input mesh vertex colors are now treated as sRGB
</Update>

<Update label="2.19.1 -> 2.19.4" description="July 2024">
  * `NearCameraCalculation` type option added to `CameraController` option. - `UpdateFlags.RENDER`
    no longer resets pipeline. Added `UpdateFlags.RENDER_RESET` which forces a pipeline reset
</Update>

<Update label="2.18.16 -> 2.19.1" description="June 2024">
  * Added `tasOnly` as a parameter in all `intersect` variants. - The existing `firstHitOnly` option
    on `Raycaster` now stops on first intersected TAS, asa well as first intersected BAS from that TAS
    (if `tasOnly` is not set)
</Update>

<Update label="2.18.15 -> 2.18.16" description="May 2024">
  * `Vector3Like` replaces `VectorLike` in the arguments of `transformTRS` in `BatchObject` -
    `SpeckleLoader` no longer takes a `priority` argument in it's constructor - `addRenderTree` from
    `SpeckleRenderer` now takes a `RenderTree` as an argument instead of a `RenderTree` id -
    `getRenderTree` is now overloaded with a version with no arguments that never returns null -
    `intersect` and `intersectRay` arguments have been moved around and both are now overloaded
</Update>

<Update label="2.18.14 -> 2.18.15" description="April 2024">
  * Asset now has a mandatory `id` field - `getEnvironment` and `getTexture` from `Assets` now
    only accept `Asset` as argument - The concept of `Providers` has been removed entirely -
    `CameraProvider` has been replaced by `SpeckleCamera` - `CameraControllerEvent` renamed to
    `CameraEvent`
</Update>

<Update label="2.18 -> 2.18.14" description="March 2024">
  * `updateClippingPlanes` in `SpeckleRenderer` does not take an optional `Plane[]` argument anymore
  * `setOptions` from `SelectionExtension` has changed to an accessor - `displayOn` and `displayOff`
    from `SectionTool` are replaced by `visible` accessor
</Update>

<Update label="2.x -> 2.18" description="February 2024">
  The introduction of viewer API 2.0 into our stable channel. The changes to the API itself are
  extensive and there is no point for a step by step guide, as what was previously known as API 2.0
  will become the single supported viewer API moving forward.
</Update>