# Changelog
What changed in each release of the Creator plugin API.

Every released version of `@lottiefiles/creator-api-types`, newest first.

## 1.2.0

### October 8, 2026

#### Added

- Audio layers. An [`AudioLayer`](/en/creator-api/nodes/audio-layer) plays an [`AudioAsset`](/en/creator-api/types/audio-asset) and is identified by
  `type === "AUDIO_LAYER"`.
- [`Scene.import`](/en/creator-api/nodes/scene/import) accepts `type: "AUDIO"`, from a URL or base64 content.
  Each import type now has its own overload, so the promise resolves to the matching layer: `SceneLayer` for `LOTTIE` and
  `SVG`, `ImageLayer` for `IMAGE`, and `AudioLayer` for `AUDIO`.
- `creator.assets` includes audio assets.
- [`TransformableLayer`](/en/creator-api/nodes/transformable-layer) refers to a layer type that has a transform (position, rotation, etc.).
  [`creator.utils.isTransformableLayer`](/en/creator-api/utils-api/is-transformable-layer) helps to identify TransformableLayers.
- [`BaseLayerMixin`](/en/creator-api/nodes/base-layer-mixin) holds the members every layer has.

#### Changed

- [`Layer`](/en/creator-api/nodes/layer) now includes `AudioLayer`, so [`scene.layers`](/en/creator-api/nodes/scene/layers),
  `creator.selection.nodes` and the `selection:nodes` event can return audio layers.
- [`transformParent`](/en/creator-api/nodes/layer-mixin/transform-parent), [`Matte.layer`](/en/creator-api/nodes/matte/layer),
  [`NullLayer.layers`](/en/creator-api/nodes/null-layer/layers) and
  [`NullLayerCreateOptions.layers`](/en/creator-api/types/null-layer-create-options/layers) now use `TransformableLayer`
  instead of `Layer`.

## 1.1.0

### September 10, 2026

#### Added

- [`NullLayer`](/en/creator-api/nodes/null-layer) is a transform parent for other layers. It does not render anything on its own,
  and is identified by `type === "NULL_LAYER"`. Its [`layers`](/en/creator-api/nodes/null-layer/layers) property lists the layers
  parented to it.
- [`Scene.createNullLayer`](/en/creator-api/nodes/scene/create-null-layer) creates a null layer. Its [`layers`](/en/creator-api/types/null-layer-create-options/layers) option parents existing
  layers to the new null layer.
- [`Layer.transformParent`](/en/creator-api/nodes/layer-mixin/transform-parent) reads and sets the layer driving a layer's transform. Assign a layer
  to parent to it, or `undefined` to clear it.

#### Changed

- [`scene.layers`](/en/creator-api/nodes/scene/layers), `creator.selection.nodes` and the `selection:nodes` event now include null
  layers. Narrow on `layer.type` before assuming a layer kind.

#### Deprecated

- Reading a transform parent from [`Layer.parent`](/en/creator-api/nodes/base-layer-mixin/parent). Use [`transformParent`](/en/creator-api/nodes/layer-mixin/transform-parent)
  instead. Reading the containing `Scene` from `parent` stays supported.

## 1.0.1

### August 13, 2026

#### Removed

- The unused `ExportFormat` type.

## 1.0.0

### July 20, 2026

#### Changed

- The Creator plugin API is now stable at v1.