@splinetool/viewer 2.0.6 → 2.0.7

package/build/spline-viewer.d.ts

@@ -1,6 +1,7 @@
 import { LitElement } from 'lit';
 export type LoadingType = 'auto' | 'lazy' | 'eager';
 export type EventsTargetType = 'local' | 'global';
+export type RendererType = 'auto' | 'webgpu' | 'webgl' | 'webgl2';
 export type HintType = 'drag';
 export type PreloaderAnimType = 'spinner-small-dark' | 'spinner-small-light' | 'spinner-big-dark' | 'spinner-big-light';
 /**
@@ -24,6 +25,15 @@ export declare class SplineViewer extends LitElement {
      * Background color
      */
     background: string | undefined;
+    /**
+     * Rendering engine. 'auto' (default) lets the runtime pick: WebGPU
+     * wherever the browser provides it (honoring the Renderer setting the
+     * scene was exported with), WebGL everywhere else. 'webgpu' / 'webgl'
+     * force one engine ('webgl2' is accepted as an alias of 'webgl'). The
+     * engine is fixed per canvas, so changing this after a scene loaded
+     * rebuilds the canvas and reloads the scene.
+     */
+    renderer: RendererType;
     /**
      * Preloading strategy ('auto', 'lazy' or 'eager')
      */
@@ -49,7 +59,7 @@ export declare class SplineViewer extends LitElement {
      * Type of spinner preloader, can be 'spinner-small-dark', 'spinner-small-light' ,'spinner-big-dark', 'spinner-big-light' or undefined
      */
     loadingAnimType?: PreloaderAnimType;
-    private _spline;
+    private _spline?;
     protected _intersectionObserver: IntersectionObserver | null;
     protected _isElementInViewport: boolean;
     protected _loaded: boolean;
@@ -64,6 +74,21 @@ export declare class SplineViewer extends LitElement {
     private _wasContextLost;
     constructor();
     private rerender;
+    /**
+     * The engine the `renderer` attribute asks for ('auto' → undefined),
+     * checked against the engine(s) compiled into this build. The
+     * single-engine builds (spline-viewer.webgl.js / spline-viewer.webgpu.js)
+     * don't contain the other engine at all, so there a mismatched request is
+     * ignored with a console warning and the runtime's own selection runs.
+     */
+    private _resolveRenderer;
+    /**
+     * Creates the runtime Application for the current canvas, honoring the
+     * `renderer` attribute. 'auto' passes no option so the runtime
+     * auto-selects the engine (and the `?renderer=` URL diagnostic override
+     * keeps working).
+     */
+    private _createApplication;
     protected unload(): void;
     protected _handleContextLost: () => void;
     protected _handleContextRestored: () => void;