@deck.gl-community/infovis-layers 9.3.5 → 9.3.7

package/dist/views/view-layout/view-layout.test.js

@@ -0,0 +1,112 @@
+import { OrthographicView } from '@deck.gl/core';
+import { describe, expect, it } from 'vitest';
+import { buildViewsFromViewLayout, ViewLayoutItem } from '.';
+describe('buildViewsFromViewLayout', () => {
+    it('splits remaining row width evenly across children without explicit widths', () => {
+        const layout = new ViewLayoutItem({
+            type: 'row',
+            children: [
+                new OrthographicView({ id: 'fixed', width: 100 }),
+                new OrthographicView({ id: 'flex-a' }),
+                new OrthographicView({ id: 'flex-b' })
+            ]
+        });
+        const compiled = buildViewsFromViewLayout({
+            layout,
+            width: 400,
+            height: 120
+        });
+        expect(compiled.rectsById.fixed).toEqual({ x: 0, y: 0, width: 100, height: 120 });
+        expect(compiled.rectsById['flex-a']).toEqual({ x: 100, y: 0, width: 150, height: 120 });
+        expect(compiled.rectsById['flex-b']).toEqual({ x: 250, y: 0, width: 150, height: 120 });
+    });
+    it('splits remaining column height evenly across children without explicit heights', () => {
+        const layout = new ViewLayoutItem({
+            type: 'column',
+            children: [
+                new OrthographicView({ id: 'header', height: 40 }),
+                new OrthographicView({ id: 'body-a' }),
+                new OrthographicView({ id: 'body-b' })
+            ]
+        });
+        const compiled = buildViewsFromViewLayout({
+            layout,
+            width: 200,
+            height: 200
+        });
+        expect(compiled.rectsById.header).toEqual({ x: 0, y: 0, width: 200, height: 40 });
+        expect(compiled.rectsById['body-a']).toEqual({ x: 0, y: 40, width: 200, height: 80 });
+        expect(compiled.rectsById['body-b']).toEqual({ x: 0, y: 120, width: 200, height: 80 });
+    });
+    it('resolves overlay children against the same parent bounds', () => {
+        const layout = new ViewLayoutItem({
+            type: 'overlay',
+            children: [new OrthographicView({ id: 'base' }), new OrthographicView({ id: 'top' })]
+        });
+        const compiled = buildViewsFromViewLayout({
+            layout,
+            width: 320,
+            height: 180
+        });
+        expect(compiled.rectsById.base).toEqual({ x: 0, y: 0, width: 320, height: 180 });
+        expect(compiled.rectsById.top).toEqual({ x: 0, y: 0, width: 320, height: 180 });
+    });
+    it('resolves raw view expressions against the current parent bounds', () => {
+        const layout = new ViewLayoutItem({
+            type: 'overlay',
+            children: [
+                new OrthographicView({
+                    id: 'calc-view',
+                    x: 10,
+                    y: '10%',
+                    width: 'calc(50% - 20px)',
+                    height: '50%'
+                })
+            ]
+        });
+        const compiled = buildViewsFromViewLayout({
+            layout,
+            width: 300,
+            height: 200
+        });
+        expect(compiled.rectsById['calc-view']).toEqual({ x: 10, y: 20, width: 130, height: 100 });
+    });
+    it('supports nested items and reuses unchanged compiled views by id', () => {
+        const layout = new ViewLayoutItem({
+            type: 'column',
+            children: [
+                new ViewLayoutItem({
+                    type: 'row',
+                    height: 50,
+                    children: [
+                        new ViewLayoutItem({ type: 'spacer', width: 80 }),
+                        new OrthographicView({ id: 'header' })
+                    ]
+                }),
+                new ViewLayoutItem({
+                    type: 'row',
+                    children: [
+                        new OrthographicView({ id: 'legend', width: 80 }),
+                        new OrthographicView({ id: 'main' })
+                    ]
+                })
+            ]
+        });
+        const first = buildViewsFromViewLayout({
+            layout,
+            width: 300,
+            height: 200
+        });
+        const second = buildViewsFromViewLayout({
+            layout,
+            width: 300,
+            height: 200,
+            previous: first
+        });
+        expect(second.rectsById.header).toEqual({ x: 80, y: 0, width: 220, height: 50 });
+        expect(second.rectsById.legend).toEqual({ x: 0, y: 50, width: 80, height: 150 });
+        expect(second.rectsById.main).toEqual({ x: 80, y: 50, width: 220, height: 150 });
+        expect(second.views.find(view => view.props.id === 'main')).toBe(first.views.find(view => view.props.id === 'main'));
+    });
+});
+//# sourceMappingURL=view-layout.test.js.map

package/dist/views/view-layout/view-layout.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view-layout.test.js","sourceRoot":"","sources":["../../../src/views/view-layout/view-layout.test.ts"],"names":[],"mappings":"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"}

package/dist/views/viewport-bounds-utils.d.ts

@@ -0,0 +1,55 @@
+import type { Bounds } from "./bounds-utils.js";
+import type { OrthographicViewState } from '@deck.gl/core';
+/** Default floating-point tolerance used when comparing bounds values. @defaultValue 1e-6 */
+export declare const DEFAULT_BOUNDS_EPSILON = 0.000001;
+/**
+ * Axis-aligned bounding box describing the area that is currently visible in a Deck.gl viewport.
+ *
+ */
+export type ViewportBounds = {
+    /** Inclusive minimum world-space X coordinate within the viewport. */
+    minX: number;
+    /** Inclusive maximum world-space X coordinate within the viewport. */
+    maxX: number;
+    /** Inclusive minimum world-space Y coordinate within the viewport. */
+    minY: number;
+    /** Inclusive maximum world-space Y coordinate within the viewport. */
+    maxY: number;
+};
+/** Floating-point comparison configuration for {@link boundsAreEqual}. */
+export type BoundsEqualityOptions = {
+    /** Maximum allowed coordinate delta before bounds differ. @defaultValue DEFAULT_BOUNDS_EPSILON */
+    epsilon?: number;
+};
+/**
+ * Returns `true` when two bounds tuples are identical within a configurable floating-point
+ * tolerance.
+ *
+ * @param a - First bounds tuple to compare.
+ * @param b - Second bounds tuple to compare.
+ * @param options - Comparison configuration.
+ * @param options.epsilon - Maximum allowed absolute difference between coordinate values before
+ * the bounds are considered distinct. Defaults to {@link DEFAULT_BOUNDS_EPSILON}.
+ */
+export declare function boundsAreEqual(a: Bounds, b: Bounds, options?: BoundsEqualityOptions): boolean;
+/**
+ * Computes the world-space bounds of an orthographic viewport given its view state and Deck.gl
+ * dimensions.
+ *
+ * @param view - The orthographic view state describing the viewport target and zoom level.
+ * @param deckDimensions - The pixel dimensions of the Deck.gl canvas hosting the view.
+ * @returns The minimum and maximum X/Y world-space coordinates visible within the viewport.
+ */
+export declare function getViewportBoundsForViewState(view: OrthographicViewState, deckDimensions: {
+    width: number;
+    height: number;
+}): ViewportBounds;
+/**
+ * Determines whether a bounds tuple lies entirely outside the supplied viewport bounds.
+ *
+ * @param bounds - The bounds tuple that may or may not intersect with the viewport.
+ * @param viewport - The viewport bounds to test against.
+ * @returns `true` when the bounds are completely outside of the viewport; otherwise `false`.
+ */
+export declare function isBoundsCompletelyOutside(bounds: Bounds, viewport: ViewportBounds): boolean;
+//# sourceMappingURL=viewport-bounds-utils.d.ts.map

package/dist/views/viewport-bounds-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-bounds-utils.d.ts","sourceRoot":"","sources":["../../src/views/viewport-bounds-utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,MAAM,EAAC,0BAAuB;AAC3C,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,eAAe,CAAC;AAEzD,6FAA6F;AAC7F,eAAO,MAAM,sBAAsB,WAAO,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,qBAAqB,GAAG;IAClC,kGAAkG;IAClG,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAa7F;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,qBAAqB,EAC3B,cAAc,EAAE;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,GAC9C,cAAc,CAsBhB;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAK3F"}

package/dist/views/viewport-bounds-utils.js

@@ -0,0 +1,70 @@
+// deck.gl-community
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** Default floating-point tolerance used when comparing bounds values. @defaultValue 1e-6 */
+export const DEFAULT_BOUNDS_EPSILON = 1e-6;
+/**
+ * Returns `true` when two bounds tuples are identical within a configurable floating-point
+ * tolerance.
+ *
+ * @param a - First bounds tuple to compare.
+ * @param b - Second bounds tuple to compare.
+ * @param options - Comparison configuration.
+ * @param options.epsilon - Maximum allowed absolute difference between coordinate values before
+ * the bounds are considered distinct. Defaults to {@link DEFAULT_BOUNDS_EPSILON}.
+ */
+export function boundsAreEqual(a, b, options) {
+    const epsilon = options?.epsilon ?? DEFAULT_BOUNDS_EPSILON;
+    let [ax, ay] = a[0];
+    let [bx, by] = b[0];
+    if (Math.abs(ax - bx) > epsilon || Math.abs(ay - by) > epsilon) {
+        return false;
+    }
+    [ax, ay] = a[1];
+    [bx, by] = b[1];
+    if (Math.abs(ax - bx) > epsilon || Math.abs(ay - by) > epsilon) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Computes the world-space bounds of an orthographic viewport given its view state and Deck.gl
+ * dimensions.
+ *
+ * @param view - The orthographic view state describing the viewport target and zoom level.
+ * @param deckDimensions - The pixel dimensions of the Deck.gl canvas hosting the view.
+ * @returns The minimum and maximum X/Y world-space coordinates visible within the viewport.
+ */
+export function getViewportBoundsForViewState(view, deckDimensions) {
+    const target = view.target ?? [0, 0];
+    const zoomValue = view.zoom;
+    const zoomArray = Array.isArray(zoomValue)
+        ? zoomValue
+        : typeof zoomValue === 'number'
+            ? [zoomValue, zoomValue]
+            : [0, 0];
+    const zoomX = zoomArray[0] ?? 0;
+    const zoomY = zoomArray[1] ?? zoomArray[0] ?? 0;
+    const scaleX = 2 ** zoomX || 1;
+    const scaleY = 2 ** zoomY || 1;
+    const halfWidth = deckDimensions.width / scaleX / 2;
+    const halfHeight = deckDimensions.height / scaleY / 2;
+    return {
+        minX: target[0] - halfWidth,
+        maxX: target[0] + halfWidth,
+        minY: target[1] - halfHeight,
+        maxY: target[1] + halfHeight
+    };
+}
+/**
+ * Determines whether a bounds tuple lies entirely outside the supplied viewport bounds.
+ *
+ * @param bounds - The bounds tuple that may or may not intersect with the viewport.
+ * @param viewport - The viewport bounds to test against.
+ * @returns `true` when the bounds are completely outside of the viewport; otherwise `false`.
+ */
+export function isBoundsCompletelyOutside(bounds, viewport) {
+    const [[minX, minY], [maxX, maxY]] = bounds;
+    return (maxX < viewport.minX || minX > viewport.maxX || maxY < viewport.minY || minY > viewport.maxY);
+}
+//# sourceMappingURL=viewport-bounds-utils.js.map

package/dist/views/viewport-bounds-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport-bounds-utils.js","sourceRoot":"","sources":["../../src/views/viewport-bounds-utils.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,+BAA+B;AAC/B,oCAAoC;AAKpC,6FAA6F;AAC7F,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAuB3C;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,CAAS,EAAE,CAAS,EAAE,OAA+B;IAClF,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,sBAAsB,CAAC;IAC3D,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChB,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChB,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,IAA2B,EAC3B,cAA+C;IAE/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC;IAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QACxC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,OAAO,SAAS,KAAK,QAAQ;YAC7B,CAAC,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC;YACxB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEb,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,cAAc,CAAC,KAAK,GAAG,MAAM,GAAG,CAAC,CAAC;IACpD,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC;IAEtD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS;QAC3B,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS;QAC3B,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,UAAU;QAC5B,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,UAAU;KACJ,CAAC;AAC7B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAc,EAAE,QAAwB;IAChF,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC;IAC5C,OAAO,CACL,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,IAAI,GAAG,QAAQ,CAAC,IAAI,CAC7F,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deck.gl-community/infovis-layers",
-  "version": "9.3.5",
+  "version": "9.3.7",
   "description": "Infovis layers (non-geospatial) for deck.gl",
   "license": "MIT",
   "publishConfig": {
@@ -33,13 +33,20 @@
     "test-watch": "vitest"
   },
   "dependencies": {
-    "@luma.gl/shadertools": "~9.3.2"
+    "@luma.gl/shadertools": "~9.3.2",
+    "@probe.gl/log": "^4.1.1"
   },
   "peerDependencies": {
     "@deck.gl/core": "~9.3.0",
     "@deck.gl/layers": "~9.3.0",
     "@luma.gl/core": "~9.3.2",
-    "@luma.gl/engine": "~9.3.2"
+    "@luma.gl/engine": "~9.3.2",
+    "apache-arrow": ">=17"
+  },
+  "peerDependenciesMeta": {
+    "apache-arrow": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@deck.gl/core": "~9.3.0",
@@ -49,5 +56,5 @@
     "@luma.gl/webgpu": "~9.3.2",
     "@probe.gl/test-utils": "^4.1.1"
   },
-  "gitHead": "3857a818efeabf0ea12ba9a71ea3d124db30fec8"
+  "gitHead": "ede78777382aaf1c821a9c427cdb48eb4e77e20e"
 }

package/src/index.ts

@@ -3,11 +3,100 @@
 // Copyright (c) vis.gl contributors
 
 export {TimeDeltaLayer, type TimeDeltaLayerProps} from './layers/time-delta-layer';
+export {
+  AnimationLayer,
+  type AnimationLayerProps
+} from './layers/animation-layer/animation-layer';
+export type {
+  AnimationFrame,
+  AnimationFramesGroup
+} from './layers/animation-layer/animation';
+export {BlockLayer, type BlockLayerProps} from './layers/block-layer/block-layer';
+export {
+  FastTextLayer,
+  type FastTextLayerProps,
+  type _FastTextLayerProps,
+  buildFastTextUtf8ColumnSource,
+  buildFastTextGlyphData,
+  buildMultiLineGlyphData,
+  buildSingleLineGlyphData,
+  collectFastTextCharacterSet,
+  updateFastTextDynamicGlyphAttributes,
+  type BuildFastTextGlyphDataProps,
+  type CollectFastTextCharacterSetProps,
+  type FastTextAlignmentBaseline,
+  type FastTextAnchor,
+  type FastTextClipRect,
+  type FastTextContentAlign,
+  type FastTextDynamicGlyphUpdateStats,
+  type FastTextGlyphBuildStats,
+  type FastTextGlyphAttributes,
+  type FastTextGlyphData,
+  type FastTextUtf8Column,
+  type FastTextUtf8ColumnSource,
+  type FastTextUtf8ViewAccessor,
+  type UpdateFastTextDynamicGlyphAttributesProps,
+  buildFastTextCharacterMapping,
+  createFastTextFontAtlas,
+  DEFAULT_FAST_TEXT_FONT_SETTINGS,
+  FastTextFontAtlasManager,
+  type FastTextCharacter,
+  type FastTextCharacterMapping,
+  type FastTextFontAtlas,
+  type FastTextFontSettings
+} from './layers/fast-text-layer/index';
 
-export {fitBoundsOrthographic} from './views/orthographic-utils';
-export {formatTimeMs, formatTimeRangeMs} from './utils/format-utils';
+export {fitBoundsOrthographic, getBoundsOrthographic} from './views/orthographic-utils';
+export {
+  buildViewsFromViewLayout,
+  type CompiledDeckViews,
+  type ViewLayoutRect,
+  ViewLayoutItem,
+  type ViewLayoutBaseProps,
+  type ViewLayoutChild,
+  type ViewLayoutColumnProps,
+  type ViewLayoutInsets,
+  type ViewLayoutItemProps,
+  type ViewLayoutLength,
+  type ViewLayoutOverlayProps,
+  type ViewLayoutRowProps,
+  type ViewLayoutSpacerProps,
+  type ViewLayoutViewProps
+} from './views/view-layout/index';
+export {
+  getPaddedBlockBounds,
+  type Bounds,
+  type Geometry,
+  type PaddedBlockBoundsOptions
+} from './views/bounds-utils';
+export {formatTimeMs, formatTimeRangeMs, type FormatTimeMsOptions} from './utils/format-utils';
+export {
+  arrowFindUtf8,
+  getArrowUtf8ColumnSource,
+  getArrowUtf8RowView,
+  getUtf8ColumnSourceRowView,
+  makeUtf8StringView,
+  type Utf8ColumnSource,
+  type Utf8ColumnSourceChunk,
+  type Utf8StringView
+} from './utils/utf8-string-view';
 export {validateViewState, mergeViewStates, type OptionalViewState} from './views/view-state-utils';
 export {makeLayerFilter} from './views/layer-filter';
+export {
+  DEFAULT_BOUNDS_EPSILON,
+  boundsAreEqual,
+  getViewportBoundsForViewState,
+  isBoundsCompletelyOutside,
+  type BoundsEqualityOptions,
+  type ViewportBounds
+} from './views/viewport-bounds-utils';
+export {
+  type LayerFilter,
+  type LayerBoundsFilterDecision,
+  type LayerBoundsFilterOptions,
+  combineLayerFilters,
+  createViewportBoundsFilter
+} from './views/layer-bounds-filter';
 
 export {
   HEADER_VIEW_HEIGHT,

package/src/layers/animation-layer/animation-layer.ts

@@ -0,0 +1,92 @@
+// deck.gl-community
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import {CompositeLayer} from '@deck.gl/core';
+
+import {
+  AnimationFramesGroup,
+  AnimationState,
+  resolveAnimationFrames,
+  resolveProps
+} from './animation';
+
+import type {CompositeLayerProps, Layer} from '@deck.gl/core';
+
+/** Properties supported by {@link AnimationLayer}. */
+export type AnimationLayerProps<LayerT extends Layer> = CompositeLayerProps &
+  _AnimationLayerProps<LayerT>;
+
+type _AnimationLayerProps<LayerT extends Layer> = {
+  /** Base child layer cloned for each animation frame. */
+  layer: LayerT;
+  /** Frames that describe how child layer props change over time. */
+  frames: AnimationFramesGroup<LayerT>;
+  /** Number of additional animation iterations after the first pass. @defaultValue 0 */
+  repeat?: number;
+  /** Whether repeated frames restart or alternate in reverse. @defaultValue 'loop' */
+  repeatType?: 'loop' | 'reverse';
+  /** Delay in milliseconds before each repeated iteration. @defaultValue 0 */
+  repeatDelay?: number;
+};
+
+/** A composite layer that animates its child layer with composable frames. */
+export class AnimationLayer<LayerT extends Layer> extends CompositeLayer<
+  _AnimationLayerProps<LayerT>
+> {
+  static override layerName = 'AnimationLayer';
+
+  override state: {
+    layer?: LayerT;
+    animationState?: AnimationState<LayerT>;
+  } = {};
+
+  // Hack - hijacking another flag to force updates
+  override hasUniformTransition(): boolean {
+    if (!this.props.visible) return false;
+    const {animationState} = this.state;
+    return !animationState || animationState.inProgress;
+  }
+
+  override updateState(): void {
+    if (!this.props.visible) {
+      // Disable animation when visible=false
+      this.state.animationState = undefined;
+      this.state.layer = undefined;
+      return;
+    }
+
+    const time = this.context.timeline.getTime();
+    const baseLayer = this.props.layer.clone({
+      parameters: {
+        ...this.props.layer.props.parameters,
+        ...this.props.parameters
+      }
+    });
+    let {animationState} = this.state;
+    let layer = baseLayer;
+
+    while (true) {
+      if (animationState?.inProgress) {
+        const nextProps = resolveProps(layer, animationState.frames, time - animationState.start);
+        nextProps['id'] = `${this.id}-animation-layer`;
+        layer = baseLayer.clone(nextProps);
+        animationState.inProgress = time < animationState.end;
+        this.setNeedsRedraw();
+      }
+      const nextState = resolveAnimationFrames(
+        time,
+        this.props as _AnimationLayerProps<LayerT>,
+        animationState
+      );
+      if (nextState === animationState) break;
+      animationState = nextState;
+    }
+    this.state.animationState = animationState;
+    this.state.layer = layer;
+  }
+
+  override renderLayers() {
+    return this.state.layer!;
+  }
+}