manim-web 0.13.0 → 0.15.0

package/dist/mobjects/geo/ChoroplethMap.d.ts

@@ -0,0 +1,72 @@
+import { Group } from '../../core/Group';
+import { Mobject } from '../../core/Mobject';
+import { Polygon } from '../geometry/Polygon';
+import { GeoFeature, GeoFeatureCollection } from './geojson';
+import { GeoProjection } from './projections';
+import { ColorScale } from './colorScale';
+/**
+ * Reads the value a feature should be colored by. Return `null`/`undefined`
+ * (or a non-finite number) to color the feature with the no-data color.
+ */
+export type ChoroplethValueAccessor = (feature: GeoFeature, index: number) => number | null | undefined;
+/** Options for a {@link ChoroplethMap}. */
+export interface ChoroplethMapOptions {
+    /** The GeoJSON feature collection to render. */
+    geojson: GeoFeatureCollection;
+    /** Reads the numeric value per feature. */
+    value: ChoroplethValueAccessor;
+    /** Reference colors for the fill scale (interpolated). Default: a blue ramp. */
+    colorScale?: string[];
+    /** Fixed value domain `[min, max]`. Default: computed from the data. */
+    domain?: [number, number];
+    /** Fill opacity from 0 to 1. Default: 1. */
+    fillOpacity?: number;
+    /** Fill color used when a feature has no value. Default: Manim gray. */
+    noDataColor?: string;
+    /** Border (stroke) color. Default: '#1b263b'. */
+    borderColor?: string;
+    /** Border width in pixels. 0 hides the border. Default: 1. */
+    borderWidth?: number;
+    /** Projection from lon/lat to 2D. Default: equirectangular(). */
+    projection?: GeoProjection;
+}
+/**
+ * ChoroplethMap - a value-colored 2D map built from GeoJSON polygons.
+ *
+ * @example
+ * ```typescript
+ * const map = new ChoroplethMap({
+ *   geojson: worldFeatureCollection,
+ *   value: (feature) => feature.properties?.gdp as number,
+ *   colorScale: ['#f7fbff', '#08306b'],
+ *   borderWidth: 1,
+ * });
+ * map.scale(2);
+ * scene.add(map);
+ * ```
+ */
+export declare class ChoroplethMap extends Group {
+    private _projection;
+    private _colorScale;
+    private _regions;
+    private _regionColors;
+    private _regionPolygons;
+    constructor(options: ChoroplethMapOptions);
+    private _buildRegion;
+    private _buildPolygon;
+    /** Get the per-feature region mobjects (one entry per feature). */
+    getRegions(): Mobject[];
+    /** Get the number of regions (equals the number of input features). */
+    getRegionCount(): number;
+    /** Get the fill color assigned to a feature's region. */
+    getRegionColor(index: number): string;
+    /** Get the polygons that make up a feature's region (one per exterior ring). */
+    getRegionPolygons(index: number): Polygon[];
+    /** Get the projection used to place lon/lat. */
+    getProjection(): GeoProjection;
+    /** Get the color scale mapping values to fill colors. */
+    getColorScale(): ColorScale;
+}
+/** Alias: some callers prefer the shorter `GeoMap` name. */
+export declare const GeoMap: typeof ChoroplethMap;
+//# sourceMappingURL=ChoroplethMap.d.ts.map

package/dist/mobjects/geo/ChoroplethMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChoroplethMap.d.ts","sourceRoot":"","sources":["../../../src/mobjects/geo/ChoroplethMap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,oBAAoB,EAE1B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,CACpC,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,MAAM,KACV,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAE/B,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,2CAA2C;IAC3C,KAAK,EAAE,uBAAuB,CAAC;IAC/B,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,wEAAwE;IACxE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,UAAU,CAAC,EAAE,aAAa,CAAC;CAC5B;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,eAAe,CAAmB;gBAE9B,OAAO,EAAE,oBAAoB;IAqCzC,OAAO,CAAC,YAAY;IA6BpB,OAAO,CAAC,aAAa;IA0BrB,mEAAmE;IACnE,UAAU,IAAI,OAAO,EAAE;IAIvB,uEAAuE;IACvE,cAAc,IAAI,MAAM;IAIxB,yDAAyD;IACzD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAIrC,gFAAgF;IAChF,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE;IAI3C,gDAAgD;IAChD,aAAa,IAAI,aAAa;IAI9B,yDAAyD;IACzD,aAAa,IAAI,UAAU;CAG5B;AAED,4DAA4D;AAC5D,eAAO,MAAM,MAAM,sBAAgB,CAAC"}

package/dist/mobjects/geo/Globe.d.ts

@@ -0,0 +1,122 @@
+import { Group } from '../../core/Group';
+import { Vector3Tuple } from '../../core/Mobject';
+import { Sphere } from '../three-d/Sphere';
+import { TexturedSurface } from '../three-d/TexturedSurface';
+import { Dot3D } from '../three-d/ThreeDExtensions';
+import { Polygon } from '../geometry/Polygon';
+/** A `[latitude, longitude]` pair in decimal degrees. */
+export type LatLon = [number, number];
+/** Options for a {@link Globe}. */
+export interface GlobeOptions {
+    /** Sphere radius. Default: 1. */
+    radius?: number;
+    /** Center position `[x, y, z]`. Default: `[0, 0, 0]`. */
+    center?: Vector3Tuple;
+    /** Texture image URL. When set, the globe uses a textured sphere. */
+    textureUrl?: string;
+    /** Optional dark/night texture URL, blended by light direction. */
+    darkTextureUrl?: string;
+    /** Sphere color when untextured. Default: '#2a6f97'. */
+    color?: string;
+    /** Opacity from 0 to 1. Default: 1. */
+    opacity?: number;
+    /** Sphere mesh resolution. Default: 64. */
+    resolution?: number;
+}
+/** Options for a plotted point marker. */
+export interface GlobePointOptions {
+    /** Marker radius in scene units. Default: radius * 0.03. */
+    size?: number;
+    /** Marker color. Default: '#ffd166'. */
+    color?: string;
+}
+/** Options for a great-circle arc. */
+export interface GlobeArcOptions {
+    /** Number of segments along the arc. Default: 64. */
+    segments?: number;
+    /** Line color. Default: '#ef476f'. */
+    color?: string;
+    /** Line width in pixels. Default: 2. */
+    lineWidth?: number;
+    /** Fraction of the sphere radius to lift the arc off the surface. Default: 0. */
+    altitude?: number;
+}
+/** Options for a graticule (lat/long grid). */
+export interface GlobeGraticuleOptions {
+    /** Spacing between parallels in degrees. Default: 30. */
+    latStep?: number;
+    /** Spacing between meridians in degrees. Default: 30. */
+    lonStep?: number;
+    /** Samples per grid line. Default: 48. */
+    segments?: number;
+    /** Line color. Default: '#8d99ae'. */
+    color?: string;
+    /** Line width in pixels. Default: 1. */
+    lineWidth?: number;
+}
+/**
+ * Globe - a 3D sphere with geographic plotting helpers.
+ *
+ * @example
+ * ```typescript
+ * const globe = new Globe({ radius: 2, textureUrl: '/textures/earth.jpg' });
+ * globe.plotPoint(48.85, 2.35); // Paris
+ * globe.arc([48.85, 2.35], [40.71, -74.0]); // Paris -> New York
+ * globe.graticule({ latStep: 30, lonStep: 30 });
+ * scene.add(globe);
+ * ```
+ */
+export declare class Globe extends Group {
+    private _radius;
+    private _center;
+    private _sphere;
+    private _plottedPoints;
+    constructor(options?: GlobeOptions);
+    /** Get the underlying sphere mobject (plain or textured). */
+    getSphere(): Sphere | TexturedSurface;
+    /** Get the sphere radius. */
+    getRadius(): number;
+    /**
+     * Convert a latitude/longitude (degrees) to a point on the sphere surface,
+     * in scene coordinates (center offset included).
+     *
+     * @param lat - Latitude in degrees (north positive).
+     * @param lon - Longitude in degrees (east positive).
+     * @returns The `[x, y, z]` surface point.
+     */
+    latLonToPoint(lat: number, lon: number): Vector3Tuple;
+    /**
+     * Plot a marker at a latitude/longitude. The marker is added as a child so it
+     * transforms with the globe.
+     *
+     * @param lat - Latitude in degrees.
+     * @param lon - Longitude in degrees.
+     * @param options - Marker size and color.
+     * @returns The created {@link Dot3D} marker.
+     */
+    plotPoint(lat: number, lon: number, options?: GlobePointOptions): Dot3D;
+    /** Get the markers added via {@link plotPoint}. */
+    getPlottedPoints(): Dot3D[];
+    /**
+     * Draw the great-circle (shortest-path) arc between two lat/long points. The
+     * arc is sampled with spherical linear interpolation, so every vertex lies on
+     * the sphere. The arc is added as a child.
+     *
+     * @param from - Start `[lat, lon]` in degrees.
+     * @param to - End `[lat, lon]` in degrees.
+     * @param options - Segment count, color, width and optional altitude.
+     * @returns The created {@link Polygon} polyline.
+     */
+    arc(from: LatLon, to: LatLon, options?: GlobeArcOptions): Polygon;
+    /**
+     * Build a graticule (lat/long grid) as a group of polylines, added as a
+     * child. Meridians run pole to pole; parallels circle the globe.
+     *
+     * @param options - Grid spacing, resolution and style.
+     * @returns The created {@link Group} of grid lines.
+     */
+    graticule(options?: GlobeGraticuleOptions): Group;
+    private _gridLine;
+    private _surfacePoint;
+}
+//# sourceMappingURL=Globe.d.ts.map

package/dist/mobjects/geo/Globe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Globe.d.ts","sourceRoot":"","sources":["../../../src/mobjects/geo/Globe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAkB,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,KAAK,EAAE,MAAM,6BAA6B,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAI9C,yDAAyD;AACzD,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtC,mCAAmC;AACnC,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,KAAM,SAAQ,KAAK;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,cAAc,CAAe;gBAEzB,OAAO,GAAE,YAAiB;IA+BtC,6DAA6D;IAC7D,SAAS,IAAI,MAAM,GAAG,eAAe;IAIrC,6BAA6B;IAC7B,SAAS,IAAI,MAAM;IAInB;;;;;;;OAOG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY;IAIrD;;;;;;;;OAQG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,KAAK;IAQ3E,mDAAmD;IACnD,gBAAgB,IAAI,KAAK,EAAE;IAI3B;;;;;;;;;OASG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO;IA0BrE;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,GAAE,qBAA0B,GAAG,KAAK;IAiBrD,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,aAAa;CAQtB"}

package/dist/mobjects/geo/colorScale.d.ts

@@ -0,0 +1,45 @@
+/**
+ * A sequential color scale: maps a numeric value in a domain to a color by
+ * sampling a gradient built from reference colors.
+ *
+ * Reuses {@link colorGradient} (the same helper behind
+ * `VMobject.setColorByGradient`) so choropleth colors match the rest of the
+ * library. Values are normalized over the domain, clamped to `[0, 1]`, and
+ * indexed into a pre-sampled palette.
+ */
+/** Options for a {@link ColorScale}. */
+export interface ColorScaleOptions {
+    /** Reference colors to interpolate (at least one). Default: a blue ramp. */
+    colors?: string[];
+    /** Value domain `[min, max]`. Default: `[0, 1]`, or set from data later. */
+    domain?: [number, number];
+    /** Number of palette samples. Higher is smoother. Default: 256. */
+    samples?: number;
+}
+/**
+ * Maps numeric values to `#rrggbb` colors across a domain.
+ */
+export declare class ColorScale {
+    private _palette;
+    private _domain;
+    constructor(options?: ColorScaleOptions);
+    /**
+     * Set the domain from a list of values (its min and max). Non-finite values
+     * are ignored. Leaves the domain unchanged when no finite value is present.
+     *
+     * @param values - The data values.
+     * @returns this for chaining.
+     */
+    setDomainFromValues(values: number[]): this;
+    /** Get the current domain `[min, max]`. */
+    getDomain(): [number, number];
+    /**
+     * Map a value to a color. Values outside the domain clamp to the endpoints.
+     * A zero-width domain maps everything to the first palette color.
+     *
+     * @param value - The value to map.
+     * @returns A `#rrggbb` color string.
+     */
+    colorFor(value: number): string;
+}
+//# sourceMappingURL=colorScale.d.ts.map

package/dist/mobjects/geo/colorScale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorScale.d.ts","sourceRoot":"","sources":["../../../src/mobjects/geo/colorScale.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1B,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,OAAO,CAAmB;gBAEtB,OAAO,GAAE,iBAAsB;IAO3C;;;;;;OAMG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAc3C,2CAA2C;IAC3C,SAAS,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC;IAI7B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAQhC"}

package/dist/mobjects/geo/geojson.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Minimal GeoJSON type definitions (RFC 7946 subset) for the geo module.
+ *
+ * Only the pieces the choropleth map needs are modeled: positions, Polygon and
+ * MultiPolygon geometries, features and feature collections. Typing these
+ * precisely avoids `any` while keeping the dependency surface at zero (no
+ * `@types/geojson` needed).
+ */
+/**
+ * A single coordinate as `[longitude, latitude]` in decimal degrees. A third
+ * altitude element is allowed by the spec and ignored by this module.
+ */
+export type GeoPosition = [number, number] | [number, number, number];
+/** A linear ring: an array of positions. The first ring of a polygon is its
+ * exterior; any further rings are holes (not punched out in V1). */
+export type GeoLinearRing = GeoPosition[];
+/** A Polygon geometry: an array of linear rings (exterior first). */
+export interface GeoPolygon {
+    type: 'Polygon';
+    coordinates: GeoLinearRing[];
+}
+/** A MultiPolygon geometry: an array of polygons. */
+export interface GeoMultiPolygon {
+    type: 'MultiPolygon';
+    coordinates: GeoLinearRing[][];
+}
+/** The geometry types this module renders. */
+export type GeoGeometry = GeoPolygon | GeoMultiPolygon;
+/** Arbitrary per-feature properties. */
+export type GeoProperties = Record<string, unknown> | null;
+/** A GeoJSON Feature carrying a polygonal geometry and properties. */
+export interface GeoFeature {
+    type: 'Feature';
+    geometry: GeoGeometry;
+    properties?: GeoProperties;
+    id?: string | number;
+}
+/** A GeoJSON FeatureCollection. */
+export interface GeoFeatureCollection {
+    type: 'FeatureCollection';
+    features: GeoFeature[];
+}
+/**
+ * Return the exterior rings of a feature's geometry.
+ *
+ * A Polygon yields its first ring. A MultiPolygon yields the first ring of each
+ * contained polygon. Interior rings (holes) are dropped: the choropleth fills
+ * exterior rings only in V1.
+ *
+ * @param geometry - The feature geometry.
+ * @returns One linear ring per exterior boundary.
+ */
+export declare function exteriorRings(geometry: GeoGeometry): GeoLinearRing[];
+//# sourceMappingURL=geojson.d.ts.map

package/dist/mobjects/geo/geojson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geojson.d.ts","sourceRoot":"","sources":["../../../src/mobjects/geo/geojson.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtE;oEACoE;AACpE,MAAM,MAAM,aAAa,GAAG,WAAW,EAAE,CAAC;AAE1C,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,aAAa,EAAE,CAAC;CAC9B;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,WAAW,EAAE,aAAa,EAAE,EAAE,CAAC;CAChC;AAED,8CAA8C;AAC9C,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,eAAe,CAAC;AAEvD,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;AAE3D,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,WAAW,CAAC;IACtB,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAED,mCAAmC;AACnC,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,aAAa,EAAE,CAWpE"}

package/dist/mobjects/geo/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Geographical maps module for manim-web.
+ *
+ * Provides a 2D choropleth map ({@link ChoroplethMap}) and a 3D globe
+ * ({@link Globe}) built from GeoJSON. See each class for coordinate
+ * conventions and covered projections.
+ */
+export { exteriorRings, type GeoPosition, type GeoLinearRing, type GeoPolygon, type GeoMultiPolygon, type GeoGeometry, type GeoProperties, type GeoFeature, type GeoFeatureCollection, } from './geojson';
+export { equirectangular, mercator, type GeoProjection, type EquirectangularOptions, type MercatorOptions, } from './projections';
+export { ColorScale, type ColorScaleOptions } from './colorScale';
+export { ChoroplethMap, GeoMap, type ChoroplethMapOptions, type ChoroplethValueAccessor, } from './ChoroplethMap';
+export { Globe, type LatLon, type GlobeOptions, type GlobePointOptions, type GlobeArcOptions, type GlobeGraticuleOptions, } from './Globe';
+//# sourceMappingURL=index.d.ts.map

package/dist/mobjects/geo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mobjects/geo/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,oBAAoB,GAC1B,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,eAAe,EACf,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGlE,OAAO,EACL,aAAa,EACb,MAAM,EACN,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,GAC7B,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,KAAK,EACL,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,qBAAqB,GAC3B,MAAM,SAAS,CAAC"}

package/dist/mobjects/geo/projections.d.ts

@@ -0,0 +1,53 @@
+import { GeoPosition } from './geojson';
+/**
+ * A projection maps a lon/lat position (degrees) to a 2D scene point.
+ */
+export type GeoProjection = (position: GeoPosition) => [number, number];
+/** Options for the equirectangular (plate carrée) projection. */
+export interface EquirectangularOptions {
+    /** Scene-unit scale applied to the radian coordinates. Default: 1. */
+    radius?: number;
+    /** Central meridian in degrees; subtracted from each longitude. Default: 0. */
+    centerLon?: number;
+    /** Central parallel in degrees; subtracted from each latitude. Default: 0. */
+    centerLat?: number;
+    /**
+     * Standard parallel in degrees. Its cosine scales the horizontal axis so the
+     * map is undistorted along that latitude. Default: 0 (cosine 1).
+     */
+    standardParallel?: number;
+}
+/**
+ * Build an equirectangular projection.
+ *
+ * `x = radius * cos(standardParallel) * (lon - centerLon)` and
+ * `y = radius * (lat - centerLat)`, with all angles in radians.
+ *
+ * @param options - Projection parameters.
+ * @returns A projection function.
+ */
+export declare function equirectangular(options?: EquirectangularOptions): GeoProjection;
+/** Options for the Web Mercator projection. */
+export interface MercatorOptions {
+    /** Scene-unit scale applied to the radian coordinates. Default: 1. */
+    radius?: number;
+    /** Central meridian in degrees; subtracted from each longitude. Default: 0. */
+    centerLon?: number;
+    /**
+     * Latitude cutoff in degrees. Latitudes beyond this are clamped so `y` stays
+     * finite. Default: 85.05112878 (the standard Web Mercator limit).
+     */
+    maxLatitude?: number;
+}
+/**
+ * Build a Web Mercator projection.
+ *
+ * `x = radius * (lon - centerLon)` and
+ * `y = radius * ln(tan(PI/4 + lat/2))`, with angles in radians and latitude
+ * clamped to `maxLatitude`.
+ *
+ * @param options - Projection parameters.
+ * @returns A projection function.
+ */
+export declare function mercator(options?: MercatorOptions): GeoProjection;
+//# sourceMappingURL=projections.d.ts.map

package/dist/mobjects/geo/projections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projections.d.ts","sourceRoot":"","sources":["../../../src/mobjects/geo/projections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAI7C;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,WAAW,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAExE,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,aAAa,CAOnF;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,eAAoB,GAAG,aAAa,CAUrE"}

package/dist/mobjects/three-d/Line3D.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Line3D.d.ts","sourceRoot":"","sources":["../../../src/mobjects/three-d/Line3D.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oCAAoC;IACpC,GAAG,EAAE,YAAY,CAAC;IAClB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,MAAO,SAAQ,SAAS;IACnC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC;IAC/B,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC;IAK7B,OAAO,CAAC,gBAAgB,CAAmC;IAC3D,OAAO,CAAC,iBAAiB,CAAoC;gBAEjD,OAAO,EAAE,aAAa;IAelC,SAAS,CAAC,kBAAkB,IAAI,KAAK,CAAC,QAAQ;cAmB3B,oBAAoB,IAAI,IAAI;IAc/C,SAAS,CAAC,eAAe,IAAI,IAAI;IASjC,OAAO,CAAC,eAAe;IAWvB,gBAAgB;IACP,gBAAgB,CACvB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,IAAI;IASP,QAAQ,IAAI,YAAY;IAIxB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMnC,MAAM,IAAI,YAAY;IAItB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMjC,YAAY,IAAI,MAAM;IAItB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,SAAS,IAAI,MAAM;IAOnB,YAAY,IAAI,YAAY;IAY5B,WAAW,IAAI,YAAY;IAQ3B,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY;IAQhC,IAAI,IAAI,MAAM;CAWxB"}
+{"version":3,"file":"Line3D.d.ts","sourceRoot":"","sources":["../../../src/mobjects/three-d/Line3D.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,oCAAoC;IACpC,GAAG,EAAE,YAAY,CAAC;IAClB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,MAAO,SAAQ,SAAS;IACnC,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC;IAC/B,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC;IAK7B,OAAO,CAAC,gBAAgB,CAAmC;IAC3D,OAAO,CAAC,iBAAiB,CAAoC;gBAEjD,OAAO,EAAE,aAAa;IAelC,SAAS,CAAC,kBAAkB,IAAI,KAAK,CAAC,QAAQ;cA6B3B,oBAAoB,IAAI,IAAI;IAc/C,SAAS,CAAC,eAAe,IAAI,IAAI;IASjC,OAAO,CAAC,eAAe;IAWvB,gBAAgB;IACP,gBAAgB,CACvB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,IAAI;IASP,QAAQ,IAAI,YAAY;IAIxB,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMnC,MAAM,IAAI,YAAY;IAItB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAMjC,YAAY,IAAI,MAAM;IAItB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,SAAS,IAAI,MAAM;IAOnB,YAAY,IAAI,YAAY;IAY5B,WAAW,IAAI,YAAY;IAQ3B,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY;IAQhC,IAAI,IAAI,MAAM;CAWxB"}

package/dist/player/ExportSettingsUI.d.ts

@@ -0,0 +1,82 @@
+/**
+ * ExportSettingsUI - opt-in export options for the PlayerUI export menu.
+ *
+ * Lets the user choose frame rate, output resolution and quality before
+ * exporting, instead of subclassing Player/PlayerUI. The panel is pure DOM and
+ * lives in this sibling file so PlayerUI.ts stays within its line budget.
+ */
+/** Concrete, resolved export settings handed to the exporter. */
+export interface ExportSettings {
+    /** Frames per second. */
+    fps: number;
+    /** Output width in pixels. */
+    width: number;
+    /** Output height in pixels. */
+    height: number;
+    /** 0-1; higher is better quality (maps to a higher video bitrate). */
+    quality: number;
+}
+/** A named output resolution. `null` width/height means "use the current size". */
+export interface ResolutionPreset {
+    id: string;
+    label: string;
+    width: number | null;
+    height: number | null;
+}
+/** A named quality level mapped to a 0-1 value. */
+export interface QualityPreset {
+    id: string;
+    label: string;
+    value: number;
+}
+/** The player's current output size and frame rate, used for defaults. */
+export interface ExportDefaults {
+    width: number;
+    height: number;
+    fps: number;
+}
+/** Selectable output resolutions. The first entry tracks the current size. */
+export declare const RESOLUTION_PRESETS: ResolutionPreset[];
+/** Selectable frame rates. */
+export declare const FPS_PRESETS: number[];
+/** Selectable quality levels. */
+export declare const QUALITY_PRESETS: QualityPreset[];
+/**
+ * Convert a 0-1 quality to a WebCodecs bitrate in bits per second.
+ * @param quality - Quality from 0 to 1 (clamped).
+ * @returns The target bitrate.
+ */
+export declare function qualityToBitrate(quality: number): number;
+/**
+ * Resolve a resolution preset id to concrete pixel dimensions.
+ * An unknown id, or the "current" preset, resolves to the current size.
+ * @param presetId - The preset id.
+ * @param currentWidth - The current output width.
+ * @param currentHeight - The current output height.
+ * @returns The resolved width and height.
+ */
+export declare function resolveResolution(presetId: string, currentWidth: number, currentHeight: number): {
+    width: number;
+    height: number;
+};
+/**
+ * The settings panel shown inside the export menu when `exportControls` is on.
+ * Renders fps, resolution and quality selectors and resolves the current choice
+ * to concrete {@link ExportSettings} on demand.
+ */
+export declare class ExportSettingsPanel {
+    private _element;
+    private _fpsSelect;
+    private _resolutionSelect;
+    private _qualitySelect;
+    private _defaults;
+    constructor(defaults: ExportDefaults);
+    /** The panel's root element, to insert into the export menu. */
+    get element(): HTMLElement;
+    /** Resolve the current selection to concrete export settings. */
+    getSettings(): ExportSettings;
+    /** Snap an arbitrary fps to the closest available preset. */
+    private _nearestFps;
+    private _buildSelect;
+}
+//# sourceMappingURL=ExportSettingsUI.d.ts.map

package/dist/player/ExportSettingsUI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExportSettingsUI.d.ts","sourceRoot":"","sources":["../../src/player/ExportSettingsUI.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,yBAAyB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,EAAE,gBAAgB,EAOhD,CAAC;AAEF,8BAA8B;AAC9B,eAAO,MAAM,WAAW,EAAE,MAAM,EAAiB,CAAC;AAElD,iCAAiC;AACjC,eAAO,MAAM,eAAe,EAAE,aAAa,EAI1C,CAAC;AAKF;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGxD;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACpB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAMnC;AAED;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,cAAc,CAAoB;IAC1C,OAAO,CAAC,SAAS,CAAiB;gBAEtB,QAAQ,EAAE,cAAc;IA8BpC,gEAAgE;IAChE,IAAI,OAAO,IAAI,WAAW,CAEzB;IAED,iEAAiE;IACjE,WAAW,IAAI,cAAc;IAW7B,6DAA6D;IAC7D,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,YAAY;CAiDrB"}

package/dist/player/Player.d.ts

@@ -1,6 +1,7 @@
 import { Scene, SceneOptions } from '../core/Scene';
 import { MasterTimeline } from '../animation/MasterTimeline';
 import { RecordingScene } from './RecordingScene';
+import { ExportSettings } from './ExportSettingsUI';
 export interface PlayerOptions extends SceneOptions {
     /** Auto-hide controls after this many ms. 0 = never. Default 2500. */
     autoHideMs?: number;
@@ -10,6 +11,18 @@ export interface PlayerOptions extends SceneOptions {
     loop?: boolean;
     /** Slides mode: arrows play/pause at slide boundaries like a presentation. Default false. */
     slidesMode?: boolean;
+    /**
+     * Keep the scene interactive while paused. When true, a Draggable,
+     * Clickable or Hoverable object responds on a paused slide: a pointer event
+     * triggers one scene render without advancing the timeline. Default false,
+     * so normal slides keep their cheap paused behavior (no extra renders).
+     */
+    interactiveSlides?: boolean;
+    /**
+     * Show an fps/resolution/quality panel in the export menu, so viewers can
+     * pick export settings without subclassing the Player. Default false.
+     */
+    exportControls?: boolean;
 }
 export declare class Player {
     private _scene;
@@ -24,6 +37,11 @@ export declare class Player {
     private _loop;
     private _autoPlay;
     private _slidesMode;
+    private _interactiveSlides;
+    /** Idle-render path that keeps a paused slide interactive. Null when off. */
+    private _slideInteraction;
+    private _exportControls;
+    private _exportFps;
     /**
      * Index of the slide that slidesMode playback should stop (or loop / advance)
      * at when its endTime is reached. -1 means no target armed.
@@ -39,6 +57,11 @@ export declare class Player {
     private _origHeight;
     private _onFullscreenChange;
     constructor(container: HTMLElement, options?: PlayerOptions);
+    /**
+     * Attach the idle-render path. Renders happen only while the Player is
+     * paused (not playing), so this never fights the active render loop.
+     */
+    private _enableSlideInteraction;
     /**
      * Define the animation sequence. The callback receives a recording proxy
      * that captures all play()/wait() calls to build the master timeline.
@@ -90,8 +113,33 @@ export declare class Player {
     setPlaybackRate(rate: number): void;
     /** Enable or disable slides (presentation) mode at runtime. */
     setSlidesMode(enabled: boolean): void;
-    /** Export the animation in the given format (gif, webm, mp4). */
-    exportAs(format: string): Promise<void>;
+    /** Whether the scene stays interactive while paused on a slide. */
+    get interactiveSlides(): boolean;
+    /**
+     * Enable or disable interactive slides at runtime. When enabled, a paused
+     * slide renders on pointer interaction (drag/click/hover) without advancing
+     * the timeline. When disabled, the idle-render path is removed.
+     */
+    setInteractiveSlides(enabled: boolean): void;
+    /**
+     * Export the animation in the given format (gif, webm, mp4).
+     *
+     * For video (webm/mp4) the frame-accurate {@link WebCodecsExporter} is used
+     * when the browser supports it; otherwise it falls back to the MediaRecorder
+     * VideoExporter via `Scene.export`. GIF always uses `Scene.export`.
+     *
+     * @param format - Output format: `gif`, `webm` or `mp4`.
+     * @param settings - Optional fps/resolution/quality from the export panel.
+     *   When omitted, the exporter keeps its format defaults.
+     */
+    exportAs(format: string, settings?: ExportSettings): Promise<void>;
+    /** Run a frame-accurate WebCodecs video export and download the result. */
+    private _exportWithWebCodecs;
+    /**
+     * Build `Scene.export` options. With no `settings`, only the base options are
+     * set so each format keeps its own defaults (e.g. GIF fps 30, quality 10).
+     */
+    private _buildSceneExportOptions;
     /** Toggle browser fullscreen on the player container. */
     toggleFullscreen(): void;
     /** Clean up all resources. */

package/dist/player/Player.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Player.d.ts","sourceRoot":"","sources":["../../src/player/Player.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,6FAA6F;IAC7F,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,WAAW,CAAU;IAC7B;;;OAGG;IACH,OAAO,CAAC,uBAAuB,CAAc;IAC7C;;;;OAIG;IACH,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,mBAAmB,CAAa;gBAE5B,SAAS,EAAE,WAAW,EAAE,OAAO,GAAE,aAAkB;IAmE/D;;;OAGG;IACG,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BhF,wDAAwD;IACxD,IAAI,KAAK,IAAI,KAAK,CAEjB;IAED,+BAA+B;IAC/B,IAAI,QAAQ,IAAI,cAAc,CAE7B;IAED,kCAAkC;IAClC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,4EAA4E;IAC5E,IAAI,IAAI,IAAI,OAAO,CAElB;IAED,uEAAuE;IACvE,IAAI,IAAI,CAAC,KAAK,EAAE,OAAO,EAEtB;IAED,4CAA4C;IAC5C,IAAI,IAAI,IAAI;IAgBZ,sBAAsB;IACtB,KAAK,IAAI,IAAI;IAOb,qCAAqC;IACrC,eAAe,IAAI,IAAI;IAQvB;;;;;;OAMG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAmBxB;;;;;;;;OAQG;IACH,WAAW,IAAI,IAAI;IAgBnB,qFAAqF;IACrF,SAAS,IAAI,IAAI;IAIjB,qFAAqF;IACrF,SAAS,IAAI,IAAI;IAIjB,mFAAmF;IACnF,WAAW,IAAI,IAAI;IAgBnB,OAAO,CAAC,eAAe;IA4CvB,OAAO,CAAC,eAAe;IA+BvB,yCAAyC;IACzC,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAInC,+DAA+D;IAC/D,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IASrC,iEAAiE;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B7C,yDAAyD;IACzD,gBAAgB,IAAI,IAAI;IAmBxB,8BAA8B;IAC9B,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,UAAU;IA4GlB,OAAO,CAAC,SAAS;CAMlB"}
+{"version":3,"file":"Player.d.ts","sourceRoot":"","sources":["../../src/player/Player.ts"],"names":[],"mappings":"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"}

package/dist/player/PlayerUI.d.ts

@@ -1,4 +1,5 @@
 import { MasterTimeline } from '../animation/MasterTimeline';
+import { ExportSettings, ExportDefaults } from './ExportSettingsUI';
 export interface PlayerUICallbacks {
     onPlayPause: () => void;
     onSeek: (time: number) => void;
@@ -6,12 +7,23 @@ export interface PlayerUICallbacks {
     onNext: () => void;
     onSpeedChange: (rate: number) => void;
     onFullscreen: () => void;
-    onExport: (format: string) => void;
+    /**
+     * Export in the given format. When the export settings panel is enabled
+     * (`exportControls`), the chosen fps/resolution/quality are passed too.
+     */
+    onExport: (format: string, settings?: ExportSettings) => void;
     onSlidesToggle: (enabled: boolean) => void;
+    /** Current output size and frame rate, used to seed the settings panel. */
+    getExportDefaults?: () => ExportDefaults;
 }
 export interface PlayerUIOptions {
     /** Auto-hide controls after this many ms of inactivity. 0 = never hide. Default 2500. */
     autoHideMs?: number;
+    /**
+     * Show an fps/resolution/quality panel in the export menu. Default false, so
+     * the export menu is unchanged unless opted in.
+     */
+    exportControls?: boolean;
 }
 export declare class PlayerUI {
     private _container;
@@ -33,6 +45,8 @@ export declare class PlayerUI {
     private _exportBtnWrapper;
     private _callbacks;
     private _autoHideMs;
+    private _exportControls;
+    private _exportPanel;
     private _hideTimeout;
     private _isVisible;
     private _isDragging;

package/dist/player/PlayerUI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PlayerUI.d.ts","sourceRoot":"","sources":["../../src/player/PlayerUI.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PlayerUI.d.ts","sourceRoot":"","sources":["../../src/player/PlayerUI.ts"],"names":[],"mappings":"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"}