@expofp/renderer 3.2.5 → 3.27.0

package/dist/index.d.ts

@@ -1,783 +1,11 @@
-import { default as default_2 } from 'stats-gl';
-import { Vector2Like } from 'three';
-import { Vector2Tuple } from 'three';
-import { Vector3Like } from 'three';
-import { Vector3Tuple } from 'three';
-import { WebGLRenderer } from 'three';
-
-/** Camera state returned by {@link ControlsAPI.getCameraState}. */
-export declare interface CameraState {
-    /** Camera target position in SVG coordinates */
-    center: Vector2Like;
-    /** Current zoom factor */
-    zoom: number;
-    /** Roll angle in degrees */
-    roll: number;
-    /** Pitch angle in degrees */
-    pitch: number;
-    /** Pixel to SVG scale factor */
-    ptScale: number;
-}
-
-export declare type ColorInput = string | number;
-
-/** Options for the {@link ControlsAPI.configure} method. */
-export declare interface ConfigureOptions {
-    /** Smooth time for zoom operations in seconds.*/
-    zoomTime: number;
-    /** Smooth time for pan operations in seconds. */
-    panTime: number;
-    /** Smooth time for roll operations in seconds. */
-    rollTime: number;
-    /** Smooth time for pitch operations in seconds. */
-    pitchTime: number;
-}
-
-/** Controls system public API. */
-export declare interface ControlsAPI {
-    /**
-     * Gesture handlers for camera controls.
-     * @inlineType Handlers
-     */
-    handlers: Readonly<Handlers>;
-    /**
-     * Zooms the camera by the given factor.
-     * @param zoom Zoom factor to apply (e.g., 1.5 for 50% zoom in, 0.5 for 50% zoom out)
-     * @param immediate If true, applies the change immediately without animation
-     * @returns Promise that resolves when the zoom animation completes
-     */
-    zoomBy: (zoom: number, immediate?: boolean) => Promise<void>;
-    /**
-     * Zooms the camera to fit the given rectangle.
-     * @param rect Rectangle to zoom to in SVG coordinates
-     * @param options Optional zoom configuration
-     * @param immediate If true, applies the change immediately without animation
-     * @returns Promise that resolves when the zoom animation completes
-     */
-    zoomTo: (rect: Rect, options?: Partial<ZoomToOptions>, immediate?: boolean) => Promise<void>;
-    /**
-     * Pans the camera by the given offset in SVG space.
-     * @param x X offset in SVG space
-     * @param y Y offset in SVG space
-     * @param immediate If true, applies the change immediately without animation
-     * @returns Promise that resolves when the pan animation completes
-     */
-    panBy: (x: number, y: number, immediate?: boolean) => Promise<void>;
-    /**
-     * Pans the camera to the given coordinates in SVG space.
-     * @param x X coordinate in SVG space
-     * @param y Y coordinate in SVG space
-     * @param immediate If true, applies the change immediately without animation
-     * @returns Promise that resolves when the pan animation completes
-     */
-    panTo: (x: number, y: number, immediate?: boolean) => Promise<void>;
-    /**
-     * Rolls the camera by the given angle in degrees.
-     * Note: This method won't work if {@link ControlsAPI.handlers | handlers.roll} is disabled.
-     * @param angle Angle in degrees to roll by
-     * @param immediate If true, applies the change immediately without animation
-     * @returns Promise that resolves when the roll animation completes
-     */
-    rollBy: (angle: number, immediate?: boolean) => Promise<void>;
-    /**
-     * Rolls the camera to the given angle in degrees.
-     * Note: This method won't work if {@link ControlsAPI.handlers | handlers.roll} is disabled.
-     * @param angle Target angle in degrees
-     * @param immediate If true, applies the change immediately without animation
-     * @returns Promise that resolves when the roll animation completes
-     */
-    rollTo: (angle: number, immediate?: boolean) => Promise<void>;
-    /**
-     * Pitches the camera by the given angle in degrees.
-     * Positive angles increase pitch, negative angles decrease pitch.
-     * Note: This method won't work if {@link ControlsAPI.handlers | handlers.pitch} is disabled.
-     * @param angle Angle in degrees to pitch by
-     * @param immediate If true, applies the change immediately without animation
-     * @returns Promise that resolves when the pitch animation completes
-     */
-    pitchBy: (angle: number, immediate?: boolean) => Promise<void>;
-    /**
-     * Pitches the camera to the given angle in degrees.
-     * The angle is clamped to the 0-90 degree range.
-     * Note: This method won't work if {@link ControlsAPI.handlers | handlers.pitch} is disabled.
-     * @param angle Target angle in degrees
-     * @param immediate If true, applies the change immediately without animation
-     * @returns Promise that resolves when the pitch animation completes
-     */
-    pitchTo: (angle: number, immediate?: boolean) => Promise<void>;
-    /**
-     * Resets the camera to the starting state.
-     * @param options Configuration for which handlers to reset
-     * @param immediate If true, applies the change immediately without animation
-     * @returns Promise that resolves when all reset animations complete
-     */
-    resetCamera: (options?: Partial<ResetCameraOptions>, immediate?: boolean) => Promise<void>;
-    /**
-     * Configures smooth time values for camera operations.
-     * @param options Partial configuration object with time values in seconds
-     */
-    configure: (options: Partial<ConfigureOptions>) => void;
-    /**
-     * Sets the camera bounds to restrict camera movement.
-     * Note: This method must be called after the viewport is initialized by `renderer.start()`.
-     * @param rect Rectangle in SVG coordinates defining the camera boundary or `undefined` to remove the boundary
-     */
-    setCameraBounds: (rect?: Rect) => void;
-    /**
-     * Gets the current camera state.
-     * @returns Camera state object with center, zoom, roll, pitch, and ptScale
-     */
-    getCameraState: () => CameraState;
-}
-
-/**
- * Mapping of engine-wide events to their payloads
- */
-export declare interface EngineEvents {
-    /** Camera change */
-    "navigation:change": void;
-    /** Camera roll */
-    "navigation:roll": number;
-    /** Mouse move */
-    "pointer:move": MouseEventData;
-    /** Mouse out */
-    "pointer:out": MouseEventData;
-    /** Mouse click */
-    "pointer:click": MouseEventData;
-    /** Viewport pixel to svg scale */
-    "viewport:ptscale": PtScaleEventData;
-}
-
-export declare type EventHandler<Payload> = (payload: Payload) => void;
-
-/**
- * Public API for interacting with the event system
- */
-export declare interface EventsAPI {
-    /**
-     * Add an event listener for a specific event
-     * @param event - The event to listen for
-     * @param handler - The handler to call when the event is emitted
-     */
-    addEventListener<E extends keyof EngineEvents>(event: E, handler: EventHandler<EngineEvents[E]>): void;
-    /**
-     * Remove an event listener for a specific event
-     * @param event - The event to remove the listener for
-     * @param handler - The handler to remove
-     */
-    removeEventListener<E extends keyof EngineEvents>(event: E, handler: EventHandler<EngineEvents[E]>): void;
-    /**
-     * Check if there are any listeners for a specific event
-     * @param event - The event to check
-     * @returns true if there are listeners, false otherwise
-     */
-    hasListeners<E extends keyof EngineEvents>(event: E): boolean;
-    /**
-     * Clear all event listeners
-     */
-    clear(): void;
-}
-
-/**
- * Loads a GLB file, converts it to a Three.js {@link Scene}, exports the scene as a GLTF
- * (JSON) file, and triggers a browser download of the result.
- * @param url - The URL of the GLB file.
- * @param isMeshopt - Whether the model file uses meshopt compression.
- */
-export declare function glb2gltf(url: string, isMeshopt?: boolean): Promise<void>;
-
-/**
- * Public API interface exposed through renderer.controls.handlers.
- * Each handler implements this interface to provide consistent enable/disable/configure functionality.
- * @template T Handler-specific options type (can be undefined if handler has no options).
- */
-export declare interface HandlerAPI<T = undefined> {
-    /**
-     * Enable this handler
-     */
-    enable(): void;
-    /**
-     * Disable this handler
-     */
-    disable(): void;
-    /**
-     * Check if this handler is currently enabled
-     * @returns true if enabled, false otherwise
-     */
-    isEnabled(): boolean;
-    /**
-     * Configure this handler with new options.
-     * Only available if handler has options (T is not undefined)
-     * @param options Partial options to update
-     */
-    configure(options: T extends undefined ? never : Partial<T>): void;
-    /**
-     * Reset this handler to its initial state.
-     * @param enableTransition Whether to animate the transition (default: true)
-     * @returns Promise that resolves when the reset is complete
-     */
-    reset(enableTransition?: boolean): Promise<void>;
-}
-
-/**
- * Gesture handlers
- */
-declare interface Handlers {
-    /** Pan handler */
-    pan: HandlerAPI;
-    /** Zoom handler */
-    zoom: HandlerAPI;
-    /** Roll handler */
-    roll: HandlerAPI<RollHandlerOptions>;
-    /** Pitch handler */
-    pitch: HandlerAPI<PitchHandlerOptions>;
-}
-
-/** Image definition */
-export declare interface ImageDef extends SharedDef {
-    /** Image source. Not updatable. */
-    source: ImageSource;
-    /** Image's bounds */
-    bounds: Rect;
-    /**
-     * Image's anchor point. Defines the point on the image that is used as an origin point for transformations.
-     * [0, 0] is the top-left corner, [0.5, 0.5] is the center (default), [1, 1] is the bottom-right corner.
-     */
-    origin?: [number, number];
-}
-
-export declare type ImageSource = HTMLImageElement | HTMLCanvasElement | ImageBitmap | OffscreenCanvas;
-
-export declare type Index = readonly [number, number, number];
-
-export declare function isImageDef(def: RenderableDef): def is ImageDef;
-
-export declare function isImageLayer(layer: LayerDef): layer is TypedLayerDef<ImageDef>;
-
-export declare function isLayerDef(def: RenderableDef): def is LayerDef;
-
-export declare function isLayerLayer(layer: LayerDef): layer is TypedLayerDef<LayerDef>;
-
-export declare function isLineDef(def: RenderableDef): def is LineDef;
-
-export declare function isLineLayer(layer: LayerDef): layer is TypedLayerDef<LineDef>;
-
-export declare function isModelDef(def: RenderableDef): def is ModelDef;
-
-export declare function isModelLayer(layer: LayerDef): layer is TypedLayerDef<ModelDef>;
-
-export declare function isShapeDef(def: RenderableDef): def is ShapeDef;
-
-export declare function isShapeLayer(layer: LayerDef): layer is TypedLayerDef<ShapeDef>;
-
-export declare function isTextDef(def: RenderableDef): def is TextDef;
-
-export declare function isTextLayer(layer: LayerDef): layer is TypedLayerDef<TextDef>;
-
-export declare type IVector2 = Vector2Like | Vector2Tuple;
-
-export declare type IVector3 = Vector3Like | Vector3Tuple;
-
-/** Layer definition */
-export declare interface LayerDef extends SharedDef {
-    /** Layer's name */
-    readonly name: string;
-    /** Whether to enable interaction with the layer (raycasting). */
-    interactive?: boolean;
-    /** Collection of layer's children. Mixing different types of children is not supported. */
-    children: RenderableDefCollection;
-    /**
-     * Layer's rendering mode. Propagates to children: child layers inherit the parent's mode
-     * unless they specify their own. Defaults to `"2D"` at the root.
-     * Resolved once during scene build and should not be changed afterwards.
-     * - `"2D"`: painter's algorithm (AlwaysDepth). Layer order determines overlap.
-     * - `"3D"`: depth testing (LessDepth). Closer geometry occludes farther geometry.
-     */
-    readonly mode?: "2D" | "3D";
-}
-
-/** Line definition */
-export declare interface LineDef extends SharedDef {
-    /** Line's points. Not updatable. */
-    points: [Vector2Like, Vector2Like];
-    /** Line's color in css format */
-    color: ColorInput;
-    /** Line's width in screen-space units (pixels). */
-    width: number;
-}
-
-/** Options for loading a GLB file. */
-export declare interface LoadGLBOptions {
-    /** The URL of the GLB file. */
-    url: string;
-    /** Whether the model file uses meshopt compression. */
-    isMeshopt?: boolean;
-    /** Whether the model file uses Draco compression. */
-    isDraco?: boolean;
-}
-
-/** External 3D model definition */
-export declare interface ModelDef extends SharedDef {
-    /** Model's URL. Not updatable. */
-    url: string;
-    /** Model's bounds */
-    bounds: Rect;
-    /** Model's opacity. Optional. */
-    opacity?: number;
-}
-
-/**
- * Data for mouse events
- */
-export declare interface MouseEventData {
-    /** Original mouse event */
-    event: MouseEvent;
-    /** Translated pointer data for each loaded scene */
-    data: PointWithinSceneData[];
-}
-
-/**
- * Configuration options for PitchHandler
- */
-export declare interface PitchHandlerOptions {
-    /**
-     * Minimum pitch angle in degrees (0 = looking straight down at the map)
-     * @default 0
-     */
-    minPitch?: number;
-    /**
-     * Maximum pitch angle in degrees (90 = looking horizontally)
-     * @default 85
-     */
-    maxPitch?: number;
-}
-
-/** Point within a scene coupled with the scene identifier and intersected defs */
-export declare interface PointWithinSceneData {
-    /** Point in SVG/model coordinates. */
-    point: Vector2Like;
-    /** Identifier of the scene that contains the point. Undefined in case of default scene. */
-    sceneId?: string;
-    /** Intersected defs */
-    defs: RenderableDef[];
-}
-
-/** Polygon shape instance. */
-export declare class Polygon {
-    private _indices;
-    private _vertices;
-    private _bbox;
-    /**
-     * @param vertices Array of polygon vertices.
-     * @param indices Array of polygon indices. Each index is a triplet of vertex indices forming a triangle.
-     */
-    constructor(vertices: (IVector3 | IVector2)[], indices: Index[]);
-    /** Array of polygon vertices. */
-    get vertices(): readonly Vector3Like[];
-    /** Array of polygon indices. Each index is a triplet of vertex indices forming a triangle. */
-    get indices(): readonly Index[];
-    /**
-     * Bounding rectangle of the polygon.
-     * This is a 2D axis-aligned bounding box computed from the X/Y projection of vertices.
-     * The Z extent of the polygon is not tracked.
-     */
-    get bounds(): Rect;
-    /**
-     * Converts a {@link Rect} to a {@link Polygon}.
-     * @param rect {@link Rect} instance
-     * @returns new {@link Polygon} instance
-     */
-    static fromRect(rect: Rect): Polygon;
-    /**
-     * Merges multiple polygons into a single one.
-     * @param polygons Array of {@link Polygon} instances
-     * @returns new {@link Polygon} instance
-     */
-    static merge(...polygons: Polygon[]): Polygon;
-    /**
-     * Translates all vertices of the polygon by the given offset.
-     * @param offset Offset to translate the polygon by. Can be a 2D or 3D vector.
-     * @returns this {@link Polygon} instance
-     */
-    translate(offset: Vector2Like | Vector3Like): Polygon;
-    /**
-     * Rotates all vertices of the polygon around the given center. Only 2D rotation (around Z axis) is supported.
-     * @param rotation Rotation angle in radians. Positive values rotate clockwise.
-     * @param center Center of the rotation. If omitted, defaults to the bounding rectangle center.
-     * @returns this {@link Polygon} instance
-     */
-    rotate(rotation: number, center?: Vector2Like): Polygon;
-    /**
-     * Scales the polygon around the given origin.
-     * @param scaleFactor Can be a single number or a 2D vector. If a single number is provided, both horizontal and
-     * vertical axes will be scaled by the same factor. Z is unchanged in both cases.
-     * @param origin Origin of the scaling. If omitted, defaults to the bounding rectangle center.
-     * @returns this {@link Polygon} instance
-     */
-    scale(scaleFactor: number | Vector2Like, origin?: Vector2Like): Polygon;
-    private computeBoundingRect;
-}
-
-/** Data for ptScale events */
-export declare interface PtScaleEventData {
-    /** Scene identifier, undefined for default scene */
-    sceneId?: string;
-    /** Pixel to SVG scale factor */
-    ptScale: number;
-}
-
-/** Rectangle shape instance. */
-export declare class Rect {
-    /** Optional rotation of the rectangle. In radians, around center. Positive values rotate clockwise. */
-    rotation: number;
-    /** Optional elevation of the rectangle. Positive values raise geometry toward the viewer. Defaults to 0. */
-    elevation: number;
-    private _min;
-    private _max;
-    private _center;
-    private _size;
-    /**
-     * @param min Top left corner of the rectangle.
-     * @param max Bottom right corner of the rectangle.
-     * @param rotation Optional rotation of the rectangle. In radians, around center. Positive values rotate clockwise.
-     * @param elevation Optional elevation. Positive values raise geometry toward the viewer. Defaults to 0.
-     */
-    constructor(min: IVector2, max: IVector2, rotation?: number, elevation?: number);
-    /** Top left corner of the rectangle. */
-    get min(): Vector2Like;
-    /** Set top left corner of the rectangle. */
-    set min(min: Vector2Like);
-    /** Bottom right corner of the rectangle. */
-    get max(): Vector2Like;
-    /** Set bottom right corner of the rectangle. */
-    set max(max: Vector2Like);
-    /** Center of the rectangle. */
-    get center(): Vector2Like;
-    /** Set center of the rectangle. */
-    set center(center: Vector2Like);
-    /** Size of the rectangle. */
-    get size(): Vector2Like;
-    /** Set size of the rectangle. */
-    set size(size: Vector2Like);
-    /**
-     * Creates a rectangle from an SVG rectangle element.
-     * @param rect {@link SVGRectElement} or {@link SVGImageElement}
-     * @param rotation Optional rotation of the rectangle. In radians, around center. Positive values rotate clockwise.
-     * @param elevation Optional elevation. Positive values raise geometry toward the viewer. Defaults to 0.
-     * @returns new {@link Rect} instance
-     */
-    static fromSvg(rect: SVGRectElement | SVGImageElement, rotation?: number, elevation?: number): Rect;
-    /**
-     * Moves the rectangle by the given offset.
-     * @param offset Offset to move the rectangle by.
-     * @returns this {@link Rect} instance
-     */
-    translate(offset: Vector2Like): Rect;
-    /**
-     * Expands the rectangle by the given amount on all sides.
-     * Use positive values to increase the size of the rectangle, negative values to decrease it.
-     * @param expansion Can be a single number or a 2D vector. If a single number is provided, both horizontal and vertical sizes will be expanded by the same amount.
-     * @returns this {@link Rect} instance
-     */
-    expand(expansion: number | Vector2Like): Rect;
-    private updateCenterAndSize;
-    private updateMinAndMax;
-}
-
-export declare type RenderableDef = LayerDef | ShapeDef | ImageDef | TextDef | LineDef | ModelDef;
-
-export declare type RenderableDefCollection<T = RenderableDef> = T extends RenderableDef ? T[] : never;
-
-/**
- * Main class for rendering the content of a {@link SceneDef}
- */
-export declare class Renderer {
-    /** {@link HTMLCanvasElement} that this renderer is rendering to */
-    readonly canvas: HTMLCanvasElement;
-    private ui?;
-    private gl?;
-    private ctx;
-    private clock;
-    private renderer;
-    private memoryInfoExtension;
-    private memoryInfo?;
-    private eventSystem;
-    private lightsSystem;
-    private layerSystem;
-    private viewportSystem;
-    private updatesSystem;
-    private interactionsSystem;
-    private controlsSystem?;
-    private controlsAPI?;
-    private eventsAPI?;
-    private viewportAPI?;
-    private initialized;
-    private disposed;
-    private needsRedraw;
-    /**
-     * @param opts {@link RendererOptions}
-     */
-    constructor(opts: RendererOptions);
-    /**
-     * {@link EventsAPI} instance for subscribing to internal events
-     */
-    get events(): EventsAPI;
-    /**
-     * {@link ControlsAPI} instance for controlling the viewport
-     */
-    get controls(): ControlsAPI;
-    /**
-     * {@link ViewportAPI} instance for view transforms and coordinate conversion.
-     */
-    get viewport(): ViewportAPI;
-    /**
-     * Optional CSS-pixel sub-rectangle of the viewport used for positioning the scene's viewbox.
-     */
-    get visibleRect(): Rect | undefined;
-    /**
-     * Sets the CSS-pixel visible sub-rectangle.
-     * Triggers a viewport transform recompute (and schedules a redraw) only if the renderer
-     * is already initialized and not disposed; otherwise the value is stored and applied on the
-     * next {@link init} or {@link addScene} call.
-     */
-    set visibleRect(rect: Rect);
-    /**
-     * Underlying {@link WebGLRenderer} instance
-     */
-    get context(): WebGLRenderer;
-    /* Excluded from this release type: size */
-    /**
-     * Returns true if the renderer is in external mode, meaning that webgl context is managed outside of the renderer
-     * (for example, when using Mapbox GL JS as a host context). In this mode renderer will not clear the canvas before
-     * rendering, and will not automatically compute scene and camera transformations. Clients are responsible for setting
-     * the transform matrix manually by using {@link SceneDef.staticTransform} and passing camera projection matrix
-     * to {@link render} as an optional argument.
-     */
-    get isExternalMode(): boolean;
-    /**
-     * Returns true if the renderer is initialized, meaning that the viewport and scene have been set up.
-     */
-    get isInitialized(): boolean;
-    /**
-     * Returns true if the renderer is disposed, meaning that all WebGL resources have been released.
-     */
-    get isDisposed(): boolean;
-    /**
-     * Loads a GLB file and returns a Three.js model.
-     * @param models - The models to load.
-     */
-    loadModel(models: LoadGLBOptions[]): Promise<void>;
-    /**
-     * Initializes viewport and scene with the given scene definition.
-     * Should be called once on startup. Repeated calls will produce console warnings.
-     * @param sceneDef {@link SceneDef} to render
-     */
-    init(sceneDef?: SceneDef): void;
-    /**
-     * Add a scene to the renderer. Note that this method is untested in internal mode. Use {@link Renderer.init} instead.
-     * @param sceneDef {@link SceneDef} to render
-     * @param sceneId identifier of the scene (map key)
-     */
-    addScene(sceneDef: SceneDef, sceneId: string): void;
-    /**
-     * Start the rendering loop
-     */
-    start(): void;
-    /**
-     * Update the given defs to make them reflect the current state.
-     * Defs are queued for processing and will be applied during the next render frame,
-     * with frustum culling deferring off-screen text and image updates.
-     * @param defs {@link RenderableDef} array to update
-     */
-    update(...defs: RenderableDef[]): void;
-    /**
-     * Render a single frame
-     * @param cameraProjection optional camera projection matrix. Ignored in internal mode, required in external mode.
-     */
-    render(cameraProjection?: number[]): void;
-    /**
-     * Stop the rendering loop
-     */
-    stop(): void;
-    /**
-     * Dispose all WebGL resources. This calls {@link Renderer.stop} internally.
-     * WARNING: This method is final and cannot be undone. Attempting to use the renderer after calling this method
-     * will result in a console warning and no-op methods. If you need to re-initialize the renderer, create a new instance.
-     */
-    dispose(): void;
-    private initScene;
-    private resizeCanvasToDisplaySize;
-    private createRendererContext;
-    private onContextLost;
-    private onContextRestored;
-    private initStatsContext;
-    private updateMemoryInfo;
-}
-
-/**
- * Options for initializing the {@link Renderer}
- */
-export declare interface RendererOptions {
-    /** {@link HTMLCanvasElement} to render to */
-    canvas: HTMLCanvasElement;
-    /** Optional {@link WebGLRenderingContext} to use (e.g. for Mapbox GL JS) */
-    gl?: WebGLRenderingContext;
-    /** Optional partial {@link UI} configuration */
-    ui?: Partial<UI>;
-}
-
-/**
- * Options for the {@link ControlsAPI.resetCamera} method.
- * @inline
- */
-export declare type ResetCameraOptions = {
-    [Property in keyof Handlers]?: boolean;
-};
-
-/**
- * Configuration options for RollHandler
- */
-export declare interface RollHandlerOptions {
-    /**
-     * Rotation threshold in pixels along circumference of touch circle (Mapbox-style).
-     * Higher values require more movement before rotation starts.
-     * @default 25
-     */
-    rotationThreshold?: number;
-}
-
-/** Scene definition */
-export declare interface SceneDef {
-    /** Root layer of the scene tree */
-    rootLayer: LayerDef;
-    /** Background color in css format */
-    background?: ColorInput;
-    /** SVG viewbox */
-    viewbox: Rect;
-    /** Textures memory limit in megabytes */
-    memoryLimit?: number;
-    /** Static transform matrix */
-    staticTransform?: number[];
-}
-
-export declare type Shape = Rect | Polygon;
-
-/** Shape definition. */
-export declare interface ShapeDef extends SharedDef {
-    /**
-     * Shape to render. Updating partially supported, you can't add or remove polygon's vertices or indices.
-     * Also it's not possible to change the shape type (i.e. from polygon to rect and vice versa).
-     */
-    shape: Shape;
-    /** Shape's color in css format */
-    color: ColorInput;
-}
-
-/** Shared properties for all renderable defs */
-export declare interface SharedDef {
-    /** Whether the def is hidden */
-    hidden?: boolean;
-    /** Def's dim state. `true` to dim, `false` to skip dim, `undefined` to reset to ancestor's value. */
-    dim?: boolean;
-}
-
-/**
- * Loads a GLTF/GLB file and splits its top-level children into two GLB files based on
- * whether each child's name starts with `BasisTransform`. The matching children are saved
- * with a `-decor` suffix; the rest are saved with a `-base` suffix. Both files are
- * triggered as browser downloads. The output is intentionally uncompressed — run a
- * meshopt/quantize pass offline (e.g. via `gltf-transform`) afterwards.
- * @param url - The URL of the GLTF/GLB file.
- */
-export declare function splitGltf(url: string): Promise<void>;
-
-/** Text alignment */
-export declare interface TextAlignment {
-    /** Horizontal alignment */
-    horizontal: "left" | "center" | "right";
-    /** Vertical alignment */
-    vertical: "top" | "center" | "bottom";
-    /** Text alignment within the line. Optional. */
-    text?: "left" | "center" | "right";
-}
-
-/** Text definition */
-export declare interface TextDef extends SharedDef {
-    /** Array of text lines. Not updatable, but each line is updatable. */
-    lines: TextLineDef[];
-    /** Text's bounds */
-    bounds: Rect;
-    /** Text's padding [horizontal, vertical] */
-    padding: [number, number];
-    /** {@link TextAlignment} object describing text's alignment */
-    alignment: TextAlignment;
-}
-
-/** Single text line definition */
-export declare interface TextLineDef {
-    /** Line's text */
-    text: string;
-    /** Line's color in css format */
-    color: ColorInput;
-    /** Line's font URL. Not updatable. Supported formats: .ttf, .otf, .woff (.woff2 is not supported). */
-    fontUrl: string;
-    /** Line's font size */
-    fontSize: number;
-    /** Line's stroke color & width. Optional. */
-    stroke?: {
-        color: ColorInput;
-        width: number;
-    };
-}
-
-/** Typed layer definition. Useful for type-checking and type-casting. */
-export declare interface TypedLayerDef<T extends RenderableDef> extends LayerDef {
-    children: RenderableDefCollection<T>;
-}
-
-/**
- * Type describing debug UI elements
- */
-export declare interface UI {
-    /** {@link Stats} instance for tracking performance metrics */
-    stats: default_2;
-    /** HTML element for displaying WebGL memory information */
-    memoryInfoPanel: HTMLDivElement;
-}
-
-export { Vector2Like }
-
-export { Vector3Like }
-
-/** Viewport system public API. */
-export declare interface ViewportAPI {
-    /**
-     * Convert canvas coordinates (CSS pixels, relative to canvas top-left) to SVG coordinates.
-     * @param point point in canvas space (CSS pixels)
-     * @returns Array of points in SVG coordinates of all loaded scenes
-     */
-    canvasToSvg: (point: Vector2Like) => {
-        point: Vector2Like;
-        sceneId?: string;
-    }[];
-    /**
-     * Set the maximum zoom factor. Default is 35.
-     * @param maxZoom Maximum zoom factor
-     */
-    setMaxZoom: (maxZoom: number) => void;
-    /**
-     * Set the minimum zoom factor. Default is 0.1.
-     * @param minZoom Minimum zoom factor
-     */
-    setMinZoom: (minZoom: number) => void;
-}
-
-/** Options for the {@link ControlsAPI.zoomTo} method. */
-export declare interface ZoomToOptions {
-    /** Maximum zoom factor. */
-    maxZoom: number;
-    /** Percentage of padding to add to the target rectangle. */
-    paddingPercent: number;
-}
-
-export { }
+export { type CameraAPI, type CameraAxes, type CameraState, type ControlsConfig, type InertiaConfig, type PanConfig, type RollConfig, type TransitionOptions, useCameraAPI, useCameraMoveStart, useCameraState, type ZoomToOptions, } from './controls';
+export { prepareDebug } from './debug';
+export * from './Renderer';
+export { type CameraProps, type SmoothTime } from './space/Camera';
+export { type CanvasPoint, type CanvasPointLike, type PlanPoint, type PlanPointLike, } from './space/Space';
+export { useViewport, type ViewportAPI } from './space/viewport';
+export * from './types/defs';
+export * from './types/events';
+export * from './types/guards';
+export { update } from './update';
+//# sourceMappingURL=index.d.ts.map