@luma.gl/core 9.2.6 → 9.3.0-alpha.10

package/dist/adapter/canvas-surface.js

@@ -0,0 +1,392 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { isBrowser } from '@probe.gl/env';
+import { CanvasObserver } from "./canvas-observer.js";
+import { uid } from "../utils/uid.js";
+import { withResolvers } from "../utils/promise-utils.js";
+import { assertDefined } from "../utils/assert.js";
+/**
+ * Shared tracked-canvas lifecycle used by both renderable and presentation contexts.
+ * - Creates a new canvas or looks up a canvas from the DOM
+ * - Provides check for DOM loaded
+ * @todo commit() @see https://github.com/w3ctag/design-reviews/issues/288
+ * @todo transferControlToOffscreen: @see https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement/transferControlToOffscreen
+ */
+export class CanvasSurface {
+    static isHTMLCanvas(canvas) {
+        return typeof HTMLCanvasElement !== 'undefined' && canvas instanceof HTMLCanvasElement;
+    }
+    static isOffscreenCanvas(canvas) {
+        return typeof OffscreenCanvas !== 'undefined' && canvas instanceof OffscreenCanvas;
+    }
+    static defaultProps = {
+        id: undefined,
+        canvas: null,
+        width: 800,
+        height: 600,
+        useDevicePixels: true,
+        autoResize: true,
+        container: null,
+        visible: true,
+        alphaMode: 'opaque',
+        colorSpace: 'srgb',
+        trackPosition: false
+    };
+    id;
+    props;
+    canvas;
+    /** Handle to HTML canvas */
+    htmlCanvas;
+    /** Handle to wrapped OffScreenCanvas */
+    offscreenCanvas;
+    type;
+    /** Promise that resolved once the resize observer has updated the pixel size */
+    initialized;
+    isInitialized = false;
+    /** Visibility is automatically updated (via an IntersectionObserver) */
+    isVisible = true;
+    /** Width of canvas in CSS units (tracked by a ResizeObserver) */
+    cssWidth;
+    /** Height of canvas in CSS units (tracked by a ResizeObserver) */
+    cssHeight;
+    /** Device pixel ratio. Automatically updated via media queries */
+    devicePixelRatio;
+    /** Exact width of canvas in physical pixels (tracked by a ResizeObserver) */
+    devicePixelWidth;
+    /** Exact height of canvas in physical pixels (tracked by a ResizeObserver) */
+    devicePixelHeight;
+    /** Width of drawing buffer: automatically tracks this.pixelWidth if props.autoResize is true */
+    drawingBufferWidth;
+    /** Height of drawing buffer: automatically tracks this.pixelHeight if props.autoResize is true */
+    drawingBufferHeight;
+    /** Resolves when the canvas is initialized, i.e. when the ResizeObserver has updated the pixel size */
+    _initializedResolvers = withResolvers();
+    _canvasObserver;
+    /** Position of the canvas in the document, updated by a timer */
+    _position = [0, 0];
+    /** Whether this canvas context has been destroyed */
+    destroyed = false;
+    /** Whether the drawing buffer size needs to be resized (deferred resizing to avoid flicker) */
+    _needsDrawingBufferResize = true;
+    toString() {
+        return `${this[Symbol.toStringTag]}(${this.id})`;
+    }
+    constructor(props) {
+        this.props = { ...CanvasSurface.defaultProps, ...props };
+        props = this.props;
+        this.initialized = this._initializedResolvers.promise;
+        if (!isBrowser()) {
+            this.canvas = { width: props.width || 1, height: props.height || 1 };
+        }
+        else if (!props.canvas) {
+            this.canvas = createCanvasElement(props);
+        }
+        else if (typeof props.canvas === 'string') {
+            this.canvas = getCanvasFromDOM(props.canvas);
+        }
+        else {
+            this.canvas = props.canvas;
+        }
+        if (CanvasSurface.isHTMLCanvas(this.canvas)) {
+            this.id = props.id || this.canvas.id;
+            this.type = 'html-canvas';
+            this.htmlCanvas = this.canvas;
+        }
+        else if (CanvasSurface.isOffscreenCanvas(this.canvas)) {
+            this.id = props.id || 'offscreen-canvas';
+            this.type = 'offscreen-canvas';
+            this.offscreenCanvas = this.canvas;
+        }
+        else {
+            this.id = props.id || 'node-canvas-context';
+            this.type = 'node';
+        }
+        this.cssWidth = this.htmlCanvas?.clientWidth || this.canvas.width;
+        this.cssHeight = this.htmlCanvas?.clientHeight || this.canvas.height;
+        this.devicePixelWidth = this.canvas.width;
+        this.devicePixelHeight = this.canvas.height;
+        this.drawingBufferWidth = this.canvas.width;
+        this.drawingBufferHeight = this.canvas.height;
+        this.devicePixelRatio = globalThis.devicePixelRatio || 1;
+        this._position = [0, 0];
+        this._canvasObserver = new CanvasObserver({
+            canvas: this.htmlCanvas,
+            trackPosition: this.props.trackPosition,
+            onResize: entries => this._handleResize(entries),
+            onIntersection: entries => this._handleIntersection(entries),
+            onDevicePixelRatioChange: () => this._observeDevicePixelRatio(),
+            onPositionChange: () => this.updatePosition()
+        });
+    }
+    destroy() {
+        if (!this.destroyed) {
+            this.destroyed = true;
+            this._stopObservers();
+            // @ts-expect-error Clear the device to make sure we don't access it after destruction.
+            this.device = null;
+        }
+    }
+    setProps(props) {
+        if ('useDevicePixels' in props) {
+            this.props.useDevicePixels = props.useDevicePixels || false;
+            this._updateDrawingBufferSize();
+        }
+        return this;
+    }
+    /** Returns a framebuffer with properly resized current 'swap chain' textures */
+    getCurrentFramebuffer(options) {
+        this._resizeDrawingBufferIfNeeded();
+        return this._getCurrentFramebuffer(options);
+    }
+    getCSSSize() {
+        return [this.cssWidth, this.cssHeight];
+    }
+    getPosition() {
+        return this._position;
+    }
+    getDevicePixelSize() {
+        return [this.devicePixelWidth, this.devicePixelHeight];
+    }
+    getDrawingBufferSize() {
+        return [this.drawingBufferWidth, this.drawingBufferHeight];
+    }
+    getMaxDrawingBufferSize() {
+        const maxTextureDimension = this.device.limits.maxTextureDimension2D;
+        return [maxTextureDimension, maxTextureDimension];
+    }
+    setDrawingBufferSize(width, height) {
+        width = Math.floor(width);
+        height = Math.floor(height);
+        if (this.drawingBufferWidth === width && this.drawingBufferHeight === height) {
+            return;
+        }
+        this.drawingBufferWidth = width;
+        this.drawingBufferHeight = height;
+        this._needsDrawingBufferResize = true;
+    }
+    getDevicePixelRatio() {
+        const devicePixelRatio = typeof window !== 'undefined' && window.devicePixelRatio;
+        return devicePixelRatio || 1;
+    }
+    cssToDevicePixels(cssPixel, yInvert = true) {
+        const ratio = this.cssToDeviceRatio();
+        const [width, height] = this.getDrawingBufferSize();
+        return scalePixels(cssPixel, ratio, width, height, yInvert);
+    }
+    /** @deprecated - use .getDevicePixelSize() */
+    getPixelSize() {
+        return this.getDevicePixelSize();
+    }
+    /** @deprecated Use the current drawing buffer size for projection setup. */
+    getAspect() {
+        const [width, height] = this.getDrawingBufferSize();
+        return width > 0 && height > 0 ? width / height : 1;
+    }
+    /** @deprecated Returns multiplier need to convert CSS size to Device size */
+    cssToDeviceRatio() {
+        try {
+            const [drawingBufferWidth] = this.getDrawingBufferSize();
+            const [cssWidth] = this.getCSSSize();
+            return cssWidth ? drawingBufferWidth / cssWidth : 1;
+        }
+        catch {
+            return 1;
+        }
+    }
+    /** @deprecated Use canvasContext.setDrawingBufferSize() */
+    resize(size) {
+        this.setDrawingBufferSize(size.width, size.height);
+    }
+    _setAutoCreatedCanvasId(id) {
+        if (this.htmlCanvas?.id === 'lumagl-auto-created-canvas') {
+            this.htmlCanvas.id = id;
+        }
+    }
+    /**
+     * Starts DOM observation after the derived context and its device are fully initialized.
+     *
+     * `CanvasSurface` construction runs before subclasses can assign `this.device`, and the
+     * default WebGL canvas context is created before `WebGLDevice` has initialized `limits`,
+     * `features`, and the rest of its runtime state. Deferring observer startup avoids early
+     * `ResizeObserver` and DPR callbacks running against a partially initialized device.
+     */
+    _startObservers() {
+        if (this.destroyed) {
+            return;
+        }
+        this._canvasObserver.start();
+    }
+    /**
+     * Stops all DOM observation and timers associated with a canvas surface.
+     *
+     * This pairs with `_startObservers()` so teardown uses the same lifecycle whether a context is
+     * explicitly destroyed, abandoned during device reuse, or temporarily has not started observing
+     * yet. Centralizing shutdown here keeps resize/DPR/position watchers from surviving past the
+     * lifetime of the owning device.
+     */
+    _stopObservers() {
+        this._canvasObserver.stop();
+    }
+    _handleIntersection(entries) {
+        if (this.destroyed) {
+            return;
+        }
+        const entry = entries.find(entry_ => entry_.target === this.canvas);
+        if (!entry) {
+            return;
+        }
+        const isVisible = entry.isIntersecting;
+        if (this.isVisible !== isVisible) {
+            this.isVisible = isVisible;
+            this.device.props.onVisibilityChange(this);
+        }
+    }
+    _handleResize(entries) {
+        if (this.destroyed) {
+            return;
+        }
+        const entry = entries.find(entry_ => entry_.target === this.canvas);
+        if (!entry) {
+            return;
+        }
+        const contentBoxSize = assertDefined(entry.contentBoxSize?.[0]);
+        this.cssWidth = contentBoxSize.inlineSize;
+        this.cssHeight = contentBoxSize.blockSize;
+        const oldPixelSize = this.getDevicePixelSize();
+        const devicePixelWidth = entry.devicePixelContentBoxSize?.[0]?.inlineSize ||
+            contentBoxSize.inlineSize * devicePixelRatio;
+        const devicePixelHeight = entry.devicePixelContentBoxSize?.[0]?.blockSize ||
+            contentBoxSize.blockSize * devicePixelRatio;
+        const [maxDevicePixelWidth, maxDevicePixelHeight] = this.getMaxDrawingBufferSize();
+        this.devicePixelWidth = Math.max(1, Math.min(devicePixelWidth, maxDevicePixelWidth));
+        this.devicePixelHeight = Math.max(1, Math.min(devicePixelHeight, maxDevicePixelHeight));
+        this._updateDrawingBufferSize();
+        this.device.props.onResize(this, { oldPixelSize });
+    }
+    _updateDrawingBufferSize() {
+        if (this.props.autoResize) {
+            if (typeof this.props.useDevicePixels === 'number') {
+                const devicePixelRatio = this.props.useDevicePixels;
+                this.setDrawingBufferSize(this.cssWidth * devicePixelRatio, this.cssHeight * devicePixelRatio);
+            }
+            else if (this.props.useDevicePixels) {
+                this.setDrawingBufferSize(this.devicePixelWidth, this.devicePixelHeight);
+            }
+            else {
+                this.setDrawingBufferSize(this.cssWidth, this.cssHeight);
+            }
+        }
+        this._initializedResolvers.resolve();
+        this.isInitialized = true;
+        this.updatePosition();
+    }
+    _resizeDrawingBufferIfNeeded() {
+        if (this._needsDrawingBufferResize) {
+            this._needsDrawingBufferResize = false;
+            const sizeChanged = this.drawingBufferWidth !== this.canvas.width ||
+                this.drawingBufferHeight !== this.canvas.height;
+            if (sizeChanged) {
+                this.canvas.width = this.drawingBufferWidth;
+                this.canvas.height = this.drawingBufferHeight;
+                this._configureDevice();
+            }
+        }
+    }
+    _observeDevicePixelRatio() {
+        if (this.destroyed || !this._canvasObserver.started) {
+            return;
+        }
+        const oldRatio = this.devicePixelRatio;
+        this.devicePixelRatio = window.devicePixelRatio;
+        this.updatePosition();
+        this.device.props.onDevicePixelRatioChange?.(this, {
+            oldRatio
+        });
+    }
+    updatePosition() {
+        if (this.destroyed) {
+            return;
+        }
+        const newRect = this.htmlCanvas?.getBoundingClientRect();
+        if (newRect) {
+            const position = [newRect.left, newRect.top];
+            this._position ??= position;
+            const positionChanged = position[0] !== this._position[0] || position[1] !== this._position[1];
+            if (positionChanged) {
+                const oldPosition = this._position;
+                this._position = position;
+                this.device.props.onPositionChange?.(this, {
+                    oldPosition
+                });
+            }
+        }
+    }
+}
+function getContainer(container) {
+    if (typeof container === 'string') {
+        const element = document.getElementById(container);
+        if (!element) {
+            throw new Error(`${container} is not an HTML element`);
+        }
+        return element;
+    }
+    if (container) {
+        return container;
+    }
+    return document.body;
+}
+function getCanvasFromDOM(canvasId) {
+    const canvas = document.getElementById(canvasId);
+    if (!CanvasSurface.isHTMLCanvas(canvas)) {
+        throw new Error('Object is not a canvas element');
+    }
+    return canvas;
+}
+function createCanvasElement(props) {
+    const { width, height } = props;
+    const newCanvas = document.createElement('canvas');
+    newCanvas.id = uid('lumagl-auto-created-canvas');
+    newCanvas.width = width || 1;
+    newCanvas.height = height || 1;
+    newCanvas.style.width = Number.isFinite(width) ? `${width}px` : '100%';
+    newCanvas.style.height = Number.isFinite(height) ? `${height}px` : '100%';
+    if (!props?.visible) {
+        newCanvas.style.visibility = 'hidden';
+    }
+    const container = getContainer(props?.container || null);
+    container.insertBefore(newCanvas, container.firstChild);
+    return newCanvas;
+}
+function scalePixels(pixel, ratio, width, height, yInvert) {
+    const point = pixel;
+    const x = scaleX(point[0], ratio, width);
+    let y = scaleY(point[1], ratio, height, yInvert);
+    let temporary = scaleX(point[0] + 1, ratio, width);
+    const xHigh = temporary === width - 1 ? temporary : temporary - 1;
+    temporary = scaleY(point[1] + 1, ratio, height, yInvert);
+    let yHigh;
+    if (yInvert) {
+        temporary = temporary === 0 ? temporary : temporary + 1;
+        yHigh = y;
+        y = temporary;
+    }
+    else {
+        yHigh = temporary === height - 1 ? temporary : temporary - 1;
+    }
+    return {
+        x,
+        y,
+        width: Math.max(xHigh - x + 1, 1),
+        height: Math.max(yHigh - y + 1, 1)
+    };
+}
+function scaleX(x, ratio, width) {
+    return Math.min(Math.round(x * ratio), width - 1);
+}
+function scaleY(y, ratio, height, yInvert) {
+    return yInvert
+        ? Math.max(0, height - 1 - Math.round(y * ratio))
+        : Math.min(Math.round(y * ratio), height - 1);
+}
+//# sourceMappingURL=canvas-surface.js.map

package/dist/adapter/canvas-surface.js.map

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

package/dist/adapter/device.d.ts

@@ -1,10 +1,12 @@
 import { StatsManager } from "../utils/stats-manager.js";
-import type { VertexFormat, VertexFormatInfo } from "../shadertypes/vertex-arrays/vertex-formats.js";
-import type { TextureFormat, TextureFormatInfo } from "../shadertypes/textures/texture-formats.js";
+import type { VertexFormat, VertexFormatInfo } from "../shadertypes/vertex-types/vertex-formats.js";
+import type { TextureFormat, TextureFormatInfo, CompressedTextureFormat } from "../shadertypes/texture-types/texture-formats.js";
 import type { CanvasContext, CanvasContextProps } from "./canvas-context.js";
+import type { PresentationContext, PresentationContextProps } from "./presentation-context.js";
 import type { BufferProps } from "./resources/buffer.js";
 import { Buffer } from "./resources/buffer.js";
 import type { RenderPipeline, RenderPipelineProps } from "./resources/render-pipeline.js";
+import type { SharedRenderPipeline } from "./resources/shared-render-pipeline.js";
 import type { ComputePipeline, ComputePipelineProps } from "./resources/compute-pipeline.js";
 import type { Sampler, SamplerProps } from "./resources/sampler.js";
 import type { Shader, ShaderProps } from "./resources/shader.js";
@@ -18,7 +20,9 @@ import type { CommandBuffer } from "./resources/command-buffer.js";
 import type { VertexArray, VertexArrayProps } from "./resources/vertex-array.js";
 import type { TransformFeedback, TransformFeedbackProps } from "./resources/transform-feedback.js";
 import type { QuerySet, QuerySetProps } from "./resources/query-set.js";
-import type { ExternalImage } from "../image-utils/image-types.js";
+import type { Fence } from "./resources/fence.js";
+import type { Bindings, ComputeShaderLayout, ShaderLayout } from "./types/shader-layout.js";
+import type { ExternalImage } from "../shadertypes/image-types/image-types.js";
 /**
  * Identifies the GPU vendor and driver.
  * @note Chrome WebGPU does not provide much information, though more can be enabled with
@@ -116,7 +120,7 @@ export declare class DeviceFeatures {
 export type DeviceFeature = WebGPUDeviceFeature | WebGLDeviceFeature | WebGLCompressedTextureFeatures;
 /** Chrome-specific extensions. Expected to eventually become standard features. */
 export type WebGPUDeviceFeature = 'depth-clip-control' | 'depth32float-stencil8' | 'texture-compression-bc' | 'texture-compression-bc-sliced-3d' | 'texture-compression-etc2' | 'texture-compression-astc' | 'texture-compression-astc-sliced-3d' | 'timestamp-query' | 'indirect-first-instance' | 'shader-f16' | 'rg11b10ufloat-renderable' | 'bgra8unorm-storage' | 'float32-filterable' | 'float32-blendable' | 'clip-distances' | 'dual-source-blending' | 'subgroups';
-export type WebGLDeviceFeature = 'timer-query-webgl' | 'compilation-status-async-webgl' | 'provoking-vertex-webgl' | 'polygon-mode-webgl' | 'shader-noperspective-interpolation-webgl' | 'shader-conservative-depth-webgl' | 'shader-clip-cull-distance-webgl' | 'float32-renderable-webgl' | 'float16-renderable-webgl' | 'rgb9e5ufloat-renderable-webgl' | 'snorm8-renderable-webgl' | 'norm16-renderable-webgl' | 'snorm16-renderable-webgl' | 'float16-filterable-webgl' | 'texture-filterable-anisotropic-webgl' | 'bgra8unorm-storage' | 'texture-blend-float-webgl';
+export type WebGLDeviceFeature = 'compilation-status-async-webgl' | 'provoking-vertex-webgl' | 'polygon-mode-webgl' | 'shader-noperspective-interpolation-webgl' | 'shader-conservative-depth-webgl' | 'shader-clip-cull-distance-webgl' | 'float32-renderable-webgl' | 'float16-renderable-webgl' | 'rgb9e5ufloat-renderable-webgl' | 'snorm8-renderable-webgl' | 'norm16-webgl' | 'norm16-renderable-webgl' | 'snorm16-renderable-webgl' | 'float16-filterable-webgl' | 'texture-filterable-anisotropic-webgl' | 'bgra8unorm-storage' | 'texture-blend-float-webgl';
 type WebGLCompressedTextureFeatures = 'texture-compression-bc5-webgl' | 'texture-compression-bc7-webgl' | 'texture-compression-etc1-webgl' | 'texture-compression-pvrtc-webgl' | 'texture-compression-atc-webgl';
 /** Texture format capabilities that have been checked against a specific device */
 export type DeviceTextureFormatCapabilities = {
@@ -147,21 +151,23 @@ export type DeviceProps = {
     /** Error handler. If it returns a probe logger style function, it will be called at the site of the error to optimize console error links. */
     onError?: (error: Error, context?: unknown) => unknown;
     /** Called when the size of a CanvasContext's canvas changes */
-    onResize?: (ctx: CanvasContext, info: {
+    onResize?: (ctx: CanvasContext | PresentationContext, info: {
         oldPixelSize: [number, number];
     }) => unknown;
     /** Called when the absolute position of a CanvasContext's canvas changes. Must set `CanvasContextProps.trackPosition: true` */
-    onPositionChange?: (ctx: CanvasContext, info: {
+    onPositionChange?: (ctx: CanvasContext | PresentationContext, info: {
         oldPosition: [number, number];
     }) => unknown;
     /** Called when the visibility of a CanvasContext's canvas changes */
-    onVisibilityChange?: (ctx: CanvasContext) => unknown;
+    onVisibilityChange?: (ctx: CanvasContext | PresentationContext) => unknown;
     /** Called when the device pixel ratio of a CanvasContext's canvas changes */
-    onDevicePixelRatioChange?: (ctx: CanvasContext, info: {
+    onDevicePixelRatioChange?: (ctx: CanvasContext | PresentationContext, info: {
         oldRatio: number;
     }) => unknown;
     /** Turn on implementation defined checks that slow down execution but help break where errors occur */
     debug?: boolean;
+    /** Enable GPU timestamp collection without enabling all debug validation paths. */
+    debugGPUTime?: boolean;
     /** Show shader source in browser? The default is `'error'`, meaning that logs are shown when shader compilation has errors */
     debugShaders?: 'never' | 'errors' | 'warnings' | 'always';
     /** Renders a small version of updated Framebuffers into the primary canvas context. Can be set in console luma.log.set('debug-framebuffers', true) */
@@ -184,13 +190,28 @@ export type DeviceProps = {
     _initializeFeatures?: boolean;
     /** Enable shader caching (via ShaderFactory) */
     _cacheShaders?: boolean;
-    /** Enable shader caching (via PipelineFactory) */
+    /**
+     * Destroy cached shaders when they become unused.
+     * Defaults to `false` so repeated create/destroy cycles can still reuse cached shaders.
+     * Enable this if the application creates very large numbers of distinct shaders and needs cache eviction.
+     */
+    _destroyShaders?: boolean;
+    /** Enable pipeline caching (via PipelineFactory) */
     _cachePipelines?: boolean;
-    /** Never destroy cached shaders and pipelines */
-    _cacheDestroyPolicy?: 'unused' | 'never';
+    /** Enable sharing of backend render-pipeline implementations when caching is enabled. Currently used by WebGL. */
+    _sharePipelines?: boolean;
+    /**
+     * Destroy cached pipelines when they become unused.
+     * Defaults to `false` so repeated create/destroy cycles can still reuse cached pipelines.
+     * Enable this if the application creates very large numbers of distinct pipelines and needs cache eviction.
+     */
+    _destroyPipelines?: boolean;
     /** @deprecated Internal, Do not use directly! Use `luma.attachDevice()` to attach to pre-created contexts/devices. */
     _handle?: unknown;
 };
+type DeviceFactories = {
+    bindGroupFactory?: unknown;
+};
 /** WebGL independent copy of WebGLContextAttributes */
 type WebGLContextProps = {
     /** indicates if the canvas contains an alpha buffer. */
@@ -242,14 +263,14 @@ export declare abstract class Device {
     };
     /** stats */
     readonly statsManager: StatsManager;
+    /** Internal per-device factory storage */
+    _factories: DeviceFactories;
     /** An abstract timestamp used for change tracking */
     timestamp: number;
     /** True if this device has been reused during device creation (app has multiple references) */
     _reused: boolean;
     /** Used by other luma.gl modules to store data on the device */
-    _lumaData: {
-        [key: string]: unknown;
-    };
+    private _moduleData;
     /** Information about the device (vendor, versions etc) */
     abstract info: DeviceInfo;
     /** Optional capability discovery */
@@ -261,6 +282,8 @@ export declare abstract class Device {
     /** Default depth format used on this system */
     abstract preferredDepthFormat: 'depth16' | 'depth24plus' | 'depth32float';
     protected _textureCaps: Partial<Record<TextureFormat, DeviceTextureFormatCapabilities>>;
+    /** Internal timestamp query set used when GPU timing collection is enabled for this device. */
+    protected _debugGPUTimeQuery: QuerySet | null;
     constructor(props: DeviceProps);
     abstract destroy(): void;
     getVertexFormatInfo(format: VertexFormat): VertexFormatInfo;
@@ -269,8 +292,6 @@ export declare abstract class Device {
     getTextureFormatInfo(format: TextureFormat): TextureFormatInfo;
     /** Determines what operations are supported on a texture format on this particular device (checks against supported device features) */
     getTextureFormatCapabilities(format: TextureFormat): DeviceTextureFormatCapabilities;
-    /** Return the implementation specific alignment for a texture format. 1 on WebGL, 256 on WebGPU */
-    abstract getTextureByteAlignment(): number;
     /** Calculates the number of mip levels for a texture of width, height and in case of 3d textures only, depth */
     getMipLevelCount(width: number, height: number, depth3d?: number): number;
     /** Check if data is an external image */
@@ -288,6 +309,8 @@ export declare abstract class Device {
     isTextureFormatRenderable(format: TextureFormat): boolean;
     /** Check if a specific texture format is GPU compressed */
     isTextureFormatCompressed(format: TextureFormat): boolean;
+    /** Returns the compressed texture formats that can be created and sampled on this device */
+    getSupportedCompressedTextureFormats(): CompressedTextureFormat[];
     pushDebugGroup(groupLabel: string): void;
     popDebugGroup(): void;
     insertDebugMarker(markerLabel: string): void;
@@ -332,6 +355,8 @@ export declare abstract class Device {
     getDefaultCanvasContext(): CanvasContext;
     /** Creates a new CanvasContext (WebGPU only) */
     abstract createCanvasContext(props?: CanvasContextProps): CanvasContext;
+    /** Creates a presentation context for a destination canvas. WebGL requires the default canvas context to use an OffscreenCanvas. */
+    abstract createPresentationContext(props?: PresentationContextProps): PresentationContext;
     /** Call after rendering a frame (necessary e.g. on WebGL OffscreenCanvas) */
     abstract submit(commandBuffer?: CommandBuffer): void;
     /** Create a buffer */
@@ -356,10 +381,44 @@ export declare abstract class Device {
     /** Create a transform feedback (immutable set of output buffer bindings). WebGL only. */
     abstract createTransformFeedback(props: TransformFeedbackProps): TransformFeedback;
     abstract createQuerySet(props: QuerySetProps): QuerySet;
+    /** Create a fence sync object */
+    createFence(): Fence;
     /** Create a RenderPass using the default CommandEncoder */
     beginRenderPass(props?: RenderPassProps): RenderPass;
     /** Create a ComputePass using the default CommandEncoder*/
     beginComputePass(props?: ComputePassProps): ComputePass;
+    /**
+     * Generate mipmaps for a WebGPU texture.
+     * WebGPU textures must be created up front with the required mip count, usage flags, and a format that supports the chosen generation path.
+     * WebGL uses `Texture.generateMipmapsWebGL()` directly because the backend manages mip generation on the texture object itself.
+     */
+    generateMipmapsWebGPU(_texture: Texture): void;
+    /** Internal helper for creating a shareable WebGL render-pipeline implementation. */
+    _createSharedRenderPipelineWebGL(_props: RenderPipelineProps): SharedRenderPipeline;
+    /** Internal WebGPU-only helper for retrieving the native bind-group layout for a pipeline group. */
+    _createBindGroupLayoutWebGPU(_pipeline: RenderPipeline | ComputePipeline, _group: number): unknown;
+    /** Internal WebGPU-only helper for creating a native bind group. */
+    _createBindGroupWebGPU(_bindGroupLayout: unknown, _shaderLayout: ShaderLayout | ComputeShaderLayout, _bindings: Bindings, _group: number): unknown;
+    /**
+     * Internal helper that returns `true` when timestamp-query GPU timing should be
+     * collected for this device.
+     */
+    _supportsDebugGPUTime(): boolean;
+    /**
+     * Internal helper that enables device-managed GPU timing collection on the
+     * default command encoder. Reuses the existing query set if timing is already enabled.
+     *
+     * @param queryCount - Number of timestamp slots reserved for profiled passes.
+     * @returns The device-managed timestamp QuerySet, or `null` when timing is not supported or could not be enabled.
+     */
+    _enableDebugGPUTime(queryCount?: number): QuerySet | null;
+    /**
+     * Internal helper that disables device-managed GPU timing collection and restores
+     * the default command encoder to an unprofiled state.
+     */
+    _disableDebugGPUTime(): void;
+    /** Internal helper that returns `true` when device-managed GPU timing is currently active. */
+    _isDebugGPUTimeEnabled(): boolean;
     /**
      * Determines what operations are supported on a texture format, checking against supported device features
      * Subclasses override to apply additional checks
@@ -404,11 +463,17 @@ export declare abstract class Device {
     }): void;
     /** @deprecated - will be removed - should use for debugging only */
     resetWebGL(): void;
+    getModuleData<ModuleDataT extends Record<string, unknown>>(moduleName: string): ModuleDataT;
     /** Helper to get the canvas context props */
     static _getCanvasContextProps(props: DeviceProps): CanvasContextProps | undefined;
     protected _getDeviceTextureFormatCapabilities(format: TextureFormat): DeviceTextureFormatCapabilities;
     /** Subclasses use this to support .createBuffer() overloads */
     protected _normalizeBufferProps(props: BufferProps | ArrayBuffer | ArrayBufferView): BufferProps;
 }
+/**
+ * Internal helper for resolving the default `debug` prop.
+ * Precedence is: explicit log debug value first, then `NODE_ENV`, then `false`.
+ */
+export declare function _getDefaultDebugValue(logDebugValue: unknown, nodeEnv?: string): boolean;
 export {};
 //# sourceMappingURL=device.d.ts.map