> ## 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.

> ## Agent Instructions
> These docs contain multiple Speckle product experiences. For Speckle 2026.9, prefer /next/ pages for the topics and changes they cover. The navigation label Current does not override this version-specific precedence.
> Coverage under /next/ is incremental. Use Current documentation for unchanged topics and when a /next/ page says coverage is unavailable or explicitly refers you to Current. Do not infer a feature was removed from a missing page.
> Read the page-specific documentation status, applicability, affected guidance and replacement links in agent-only content. Impacted, changed and superseded apply only to the stated scope; they do not mean the entire feature is deprecated. Historical connector guides apply only to the legacy connector described.
> Match guidance to the customer's deployment version, model data format and connector. Respect plan, permission and compatibility restrictions. If an unknown version or data format changes the answer, ask a focused clarification; do not infer deployment version from the date alone.

# API 1.0 Full Migration

> The encouraged way, is to conform to the new API as soon as possible. The following guide will attempt to help with the initial migration from the old API to the new one.

## Extensions

A lot of existing viewer functionality has been transferred over to modular `Extensions`.
In order to continue to make use of this functionality, the viewer clients now need to
explicitly enable extensions by calling `createExtension` with the extension's constructor
as the argument. For example, the complete functionality set requires all the extensions
enabled.

```typescript theme={null}
const cameraController = this.createExtension(CameraController)
const selection = this.createExtension(LegacySelectionExtension)
const sections = this.createExtension(SectionTool)
const sectionOutlines = this.createExtension(SectionOutlines)
const measurements = this.createExtension(MeasurementsExtension)
const filtering = this.createExtension(FilteringExtension)
const explodeExtension = this.createExtension(ExplodeExtension)
const diffExtension = this.createExtension(DiffExtension)
```

## General

* `ViewerParams`no longer has a `keepGeometryData` property. Redundant geometry
  data is by default removed and cannot be kept
* `SectionBoxChanged` and `SectionBoxUpdated` removed from `ViewerEvent` and replaced
  by `SectionToolEvent.Updated` in `SectionTool` extension
* `SelectionEvent.hits` changed to `Array<{node: TreeNode, point: Vector3}>`
* `requestRender` from `Viewer` now takes optional `UpdateFlags`
* `getObjects` removed from `Viewer`. Similar functionality exists with `getObject`
  in `SpeckleRenderer`
* `explode` removed from `Viewer` and replaced by having an `ExplodeExtension` active.
  Explode time is now controller via `setExplode` in `ExplodeExtension`
* `getDataTree` and `DataTree` type still exist, but are deprecated and will be
  soon removed completely. Any functionality can now be replicated with `WorldTree`
* `cameraHandler` removed from `Viewer` and replaced by `controls` accessor in `CameraController`.

## Section Box

* `setSectionBox` removed from `Viewer` and replaced by `setBox` in`SectionTool`
* `getSectionBoxFromObjects` removed from `Viewer` and replaced by `boxFromObjects`
  from `SpeckleRenderer`
* `getCurrentSectionBox` removed from `Viewer` and replace by `getCurrentBox` in`SectionTool`
* `toggleSectionBox` removed from `Viewer` and replaced by `toggle` in `SectionTool`
* `sectionBoxOff` and `sectionBoxOn` removed from `Viewer` and replaced by the `enabled`
  accessor in `SectionTool`

## Camera

* `zoom` removed from `Viewer` and replaced by `setCameraView` in `CameraController`
  extension
* `toggleCameraProjection` removed from `Viewer` and replaced by `toggleCameras` in
  `CameraController` extension
* `setView` removed from `Viewer` and replaced by `setCameraView` in `CameraController`
  extension
* `loadObject` signature changed to `loadObject(loader: Loader, zoomToObject?: boolean)`
  and it's now asynchronous
* `loadObjectAsync` removed from `Viewer`

## Diffing

* `diff` removed from `Viewer` and replaced by `diff` in `DiffExtension`
* `undiff` removed from `Viewer` and replaced by `undiff` in `DiffExtension`
* `setDiffTime` and `setVisualDiffMode` removed from `Viewer` and replaced by
  `updateVisualDiff` in `DiffExtension`

## Filtering and Selection

* `applyFilter` removed from `Viewer`
* `getObjectProperties` is now asynchronous
* `showObjects` and `hideObjects` are removed from `Viewer` and moved to `FilteringExtension`
* `isolateObjects` and `unIsolateObjects` are removed from `Viewer` and moved to `FilterinExtension`
* `selectObjects` is removed from `Viewer` and replaced by `selectObjects` in `SelectionExtension`
* `resetSelection` is removed from `Viewer` and replaced by `clearSelection` in `SelectionExtension`
* `highlightObjects` and `resetHighlight` are removed from `Viewer`
* `setColorFilter` ans `removeColorFilter` are removed from `Viewer` and replaced
  by `setColorFilter`and `removeColorFilter` in `FilteringExtension`
* `setUserObjectColors` is remove from `Viewer` and replaced by `setUserObjectColors`
  in `SelectionExtension` but usage is discouraged since paradigm no longer applies
* `resetFilters` is removed from `Viewer` and replaced by `resetFilters` in `SelectionExtension`

## Measurements

* `enableMeasurements` removed from `Viewer` and replaced by having a
  `MeasurementsExtension` active and it’s `enabled` accessor set
* `setMeasurementOptions` removed from `Viewer` and replaced by the `options`
  accessor in `MeasurementsExtension`
* `removeMeasurement` removed from `Viewer` and replaced by `removeMeasurement`
  in `MeasurementsExtension`