@luma.gl/core 9.0.0-alpha.9 → 9.0.0-beta.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"canvas-context.js","names":["isBrowser","log","isPage","document","isPageLoaded","readyState","DEFAULT_CANVAS_CONTEXT_PROPS","canvas","width","height","useDevicePixels","autoResize","container","visible","colorSpace","alphaMode","CanvasContext","constructor","props","device","id","htmlCanvas","offscreenCanvas","type","resizeObserver","_canvasSizeInfo","clientWidth","clientHeight","devicePixelRatio","_props","_props2","createCanvas","getContainer","insertBefore","firstChild","style","visibility","getCanvasFromDOM","HTMLCanvasElement","ResizeObserver","entries","entry","target","update","observe","getDevicePixelRatio","OffscreenCanvas","undefined","dpr","window","getPixelSize","parentElement","Error","getAspect","cssToDeviceRatio","drawingBufferWidth","getDrawingBufferSize","cssToDevicePixels","cssPixel","yInvert","arguments","length","ratio","scalePixels","setDevicePixelRatio","options","cachedSize","clampedPixelRatio","canvasWidth","Math","floor","canvasHeight","drawingBufferHeight","min","warn","gl","_setAutoCreatedCanvasId","_this$htmlCanvas","pageLoaded","getPageLoadPromise","Promise","resolve","addEventListener","element","getElementById","body","canvasId","targetCanvas","createElement","Number","isFinite","pixel","point","x","scaleX","y","scaleY","t","xHigh","yHigh","max","r","round"],"sources":["../../src/adapter/canvas-context.ts"],"sourcesContent":["// luma.gl, MIT license\nimport {isBrowser} from '@probe.gl/env';\nimport type {Device} from './device';\nimport type {Framebuffer} from './resources/framebuffer';\nimport {log} from '../utils/log';\n\nconst isPage: boolean = isBrowser() && typeof document !== 'undefined';\nconst isPageLoaded: () => boolean = () => isPage && document.readyState === 'complete';\n\n/** Properties for a CanvasContext */\nexport type CanvasContextProps = {\n  /** If canvas not supplied, will be created and added to the DOM. If string, will be looked up in the DOM */\n  canvas?: HTMLCanvasElement | OffscreenCanvas | string | null;\n  /** If new canvas is created, it will be created in the specified container, otherwise appended to body */\n  container?: HTMLElement | string | null;\n  /** Width in pixels of the canvas */\n  width?: number;\n  /** Height in pixels of the canvas */\n  height?: number;\n  /** Whether to apply a device pixels scale factor (`true` uses browser DPI) */\n  useDevicePixels?: boolean | number;\n  /** Whether to track resizes (if not ) */\n  autoResize?: boolean;\n  /** Visibility (only used if new canvas is created). */\n  visible?: boolean;\n  /** WebGPU only https://www.w3.org/TR/webgpu/#canvas-configuration */\n  colorSpace?: 'srgb'; // GPUPredefinedColorSpace\n  /** WebGPU only https://www.w3.org/TR/webgpu/#canvas-configuration */\n  alphaMode?: 'opaque' | 'premultiplied';\n};\n\nconst DEFAULT_CANVAS_CONTEXT_PROPS: Required<CanvasContextProps> = {\n  canvas: null,\n  width: 800, // width are height are only used by headless gl\n  height: 600,\n  useDevicePixels: true,\n  autoResize: true,\n  container: null,\n  visible: true,\n  colorSpace: 'srgb',\n  alphaMode: 'opaque'\n};\n\n/**\n * Manages a canvas. Supports both HTML or offscreen canvas\n * - Creates a new canvas or looks up a canvas from the DOM\n * - Provides check for DOM loaded\n * @todo commit(): https://github.com/w3ctag/design-reviews/issues/288\n * @todo transferControlToOffscreen: https://developer.mozilla.org/en-US/docs/Web/API/HTMLCanvasElement/transferControlToOffscreen\n */\nexport abstract class CanvasContext {\n  abstract readonly device: Device;\n  readonly id: string;\n  readonly props: Required<CanvasContextProps>;\n  readonly canvas: HTMLCanvasElement | OffscreenCanvas;\n  readonly htmlCanvas?: HTMLCanvasElement;\n  readonly offscreenCanvas?: OffscreenCanvas;\n  readonly type: 'html-canvas' | 'offscreen-canvas' | 'node';\n\n  width: number = 1;\n  height: number = 1;\n\n  readonly resizeObserver: ResizeObserver | undefined;\n\n  /** State used by luma.gl classes: TODO - move to canvasContext*/\n  readonly _canvasSizeInfo = {clientWidth: 0, clientHeight: 0, devicePixelRatio: 1};\n\n  /** Check if the DOM is loaded */\n  static get isPageLoaded(): boolean {\n    return isPageLoaded();\n  }\n\n  /**\n   * Get a 'lazy' promise that resolves when the DOM is loaded.\n   * @note Since there may be limitations on number of `load` event listeners,\n   * it is recommended avoid calling this function until actually needed.\n   * I.e. don't call it until you know that you will be looking up a string in the DOM.\n   */\n  static pageLoaded: Promise<void> = getPageLoadPromise();\n\n  constructor(props?: CanvasContextProps) {\n    this.props = {...DEFAULT_CANVAS_CONTEXT_PROPS, ...props};\n    props = this.props;\n\n    if (!isBrowser()) {\n      this.id = 'node-canvas-context';\n      this.type = 'node';\n      this.width = this.props.width;\n      this.height = this.props.height;\n      // TODO - does this prevent app from using jsdom style polyfills?\n      this.canvas = null!;\n      return;\n    }\n\n    if (!props.canvas) {\n      const canvas = createCanvas(props);\n      const container = getContainer(props?.container || null);\n      container.insertBefore(canvas, container.firstChild);\n\n      this.canvas = canvas;\n\n      if (!props?.visible) {\n        this.canvas.style.visibility = 'hidden';\n      }\n    } else if (typeof props.canvas === 'string') {\n      this.canvas = getCanvasFromDOM(props.canvas);\n    } else {\n      this.canvas = props.canvas;\n    }\n\n    if (this.canvas instanceof HTMLCanvasElement) {\n      this.id = this.canvas.id;\n      this.type = 'html-canvas';\n      this.htmlCanvas = this.canvas;\n    } else {\n      this.id = 'offscreen-canvas';\n      this.type = 'offscreen-canvas';\n      this.offscreenCanvas = this.canvas;\n    }\n\n    // React to size changes\n    if (this.canvas instanceof HTMLCanvasElement && props.autoResize) {\n      this.resizeObserver = new ResizeObserver((entries) => {\n        for (const entry of entries) {\n          if (entry.target === this.canvas) {\n            this.update();\n          }\n        }\n      });\n      this.resizeObserver.observe(this.canvas);\n    }\n  }\n\n  /** Returns a framebuffer with properly resized current 'swap chain' textures */\n  abstract getCurrentFramebuffer(): Framebuffer;\n\n  /**\n   * Returns the current DPR, if props.useDevicePixels is true\n   * Device refers to physical\n   */\n  getDevicePixelRatio(useDevicePixels?: boolean | number): number {\n    if (typeof OffscreenCanvas !== 'undefined' && this.canvas instanceof OffscreenCanvas) {\n      return 1;\n    }\n\n    useDevicePixels = useDevicePixels === undefined ? this.props.useDevicePixels : useDevicePixels;\n\n    if (!useDevicePixels || useDevicePixels as number <= 0) {\n      return 1;\n    }\n\n    // The param was mainly provide to support the test cases, could be removed\n    if (useDevicePixels === true) {\n      const dpr = typeof window !== 'undefined' && window.devicePixelRatio;\n      return dpr || 1;\n    }\n\n    return useDevicePixels;\n  }\n\n  /**\n   * Returns the size of drawing buffer in device pixels.\n   * @note This can be different from the 'CSS' size of a canvas, and also from the\n   * canvas' internal drawing buffer size (.width, .height).\n   * This is the size required to cover the canvas, adjusted for DPR\n   */\n  getPixelSize(): [number, number] {\n    switch (this.type) {\n      case 'node':\n        return [this.width, this.height];\n      case 'offscreen-canvas':\n        return [this.canvas.width, this.canvas.height];\n      case 'html-canvas':\n        const dpr = this.getDevicePixelRatio();\n        const canvas = this.canvas as HTMLCanvasElement;\n        // If not attached to DOM client size can be 0\n        return canvas.parentElement\n          ? [canvas.clientWidth * dpr, canvas.clientHeight * dpr]\n          : [this.canvas.width, this.canvas.height];\n      default:\n        throw new Error(this.type);\n    }\n  }\n\n  getAspect(): number {\n    const [width, height] = this.getPixelSize();\n    return width / height;\n  }\n\n  /**\n   * Returns multiplier need to convert CSS size to Device size\n   */\n  cssToDeviceRatio(): number {\n    try {\n      // For headless gl we might have used custom width and height\n      // hence use cached clientWidth\n      const [drawingBufferWidth] = this.getDrawingBufferSize();\n      const {clientWidth} = this._canvasSizeInfo;\n      return clientWidth ? drawingBufferWidth / clientWidth : 1;\n    } catch {\n      return 1;\n    }\n  }\n\n  /**\n   * Maps CSS pixel position to device pixel position\n   */\n  cssToDevicePixels(\n    cssPixel: number[],\n    yInvert: boolean = true\n  ): {\n    x: number;\n    y: number;\n    width: number;\n    height: number;\n  } {\n    const ratio = this.cssToDeviceRatio();\n    const [width, height] = this.getDrawingBufferSize();\n    return scalePixels(cssPixel, ratio, width, height, yInvert);\n  }\n\n  /**\n   * Use devicePixelRatio to set canvas width and height\n   * @note this is a raw port of luma.gl v8 code. Might be worth a review\n   */\n  setDevicePixelRatio(\n    devicePixelRatio: number,\n    options: {width?: number; height?: number} = {}\n  ): void {\n    if (!this.htmlCanvas) {\n      return;\n    }\n\n    // NOTE: if options.width and options.height not used remove in v8\n    let clientWidth = 'width' in options ? options.width : this.htmlCanvas.clientWidth;\n    let clientHeight = 'height' in options ? options.height : this.htmlCanvas.clientHeight;\n\n    if (!clientWidth || !clientHeight) {\n      log.log(1, 'Canvas clientWidth/clientHeight is 0')();\n      // by forcing devicePixel ratio to 1, we do not scale canvas.width and height in each frame.\n      devicePixelRatio = 1;\n      clientWidth = this.htmlCanvas.width || 1;\n      clientHeight = this.htmlCanvas.height || 1;\n    }\n\n    const cachedSize = this._canvasSizeInfo;\n    // Check if canvas needs to be resized\n    if (\n      cachedSize.clientWidth !== clientWidth ||\n      cachedSize.clientHeight !== clientHeight ||\n      cachedSize.devicePixelRatio !== devicePixelRatio\n    ) {\n      let clampedPixelRatio = devicePixelRatio;\n\n      const canvasWidth = Math.floor(clientWidth * clampedPixelRatio);\n      const canvasHeight = Math.floor(clientHeight * clampedPixelRatio);\n      this.htmlCanvas.width = canvasWidth;\n      this.htmlCanvas.height = canvasHeight;\n\n      // Note: when devicePixelRatio is too high, it is possible we might hit system limit for\n      // drawing buffer width and hight, in those cases they get clamped and resulting aspect ration may not be maintained\n      // for those cases, reduce devicePixelRatio.\n      const [drawingBufferWidth, drawingBufferHeight] = this.getDrawingBufferSize();\n\n      if (drawingBufferWidth !== canvasWidth || drawingBufferHeight !== canvasHeight) {\n        clampedPixelRatio = Math.min(\n          drawingBufferWidth / clientWidth,\n          drawingBufferHeight / clientHeight\n        );\n\n        this.htmlCanvas.width = Math.floor(clientWidth * clampedPixelRatio);\n        this.htmlCanvas.height = Math.floor(clientHeight * clampedPixelRatio);\n\n        log.warn('Device pixel ratio clamped')();\n      }\n\n      this._canvasSizeInfo.clientWidth = clientWidth;\n      this._canvasSizeInfo.clientHeight = clientHeight;\n      this._canvasSizeInfo.devicePixelRatio = devicePixelRatio;\n    }\n  }\n\n  // PRIVATE\n\n  /** @todo Major hack done to port the CSS methods above, base canvas context should not depend on WebGL */\n  getDrawingBufferSize(): [number, number] {\n    // @ts-expect-error This only works for WebGL\n    const gl = this.device.gl;\n    if (!gl) {\n      // use default device pixel ratio\n      throw new Error('canvas size');\n    }\n    return [gl.drawingBufferWidth, gl.drawingBufferHeight];\n  }\n\n  abstract resize(options?: {\n    width?: number;\n    height?: number;\n    useDevicePixels?: boolean | number;\n  }): void;\n\n  /** Perform platform specific updates (WebGPU vs WebGL) */\n  protected abstract update(): void;\n\n  /**\n   * Allows subclass constructor to override the canvas id for auto created canvases.\n   * This can really help when debugging DOM in apps that create multiple devices\n   */\n  protected _setAutoCreatedCanvasId(id: string) {\n    if (this.htmlCanvas?.id === 'lumagl-auto-created-canvas') {\n      this.htmlCanvas.id = id;\n    }\n  }\n}\n\n// HELPER FUNCTIONS\n\n/** Returns a promise that resolves when the page is loaded */\nfunction getPageLoadPromise(): Promise<void> {\n  if (isPageLoaded() || typeof window === 'undefined') {\n    return Promise.resolve();\n  }\n  return new Promise((resolve) => {\n    window.addEventListener('load', () => resolve());\n  });\n}\n\nfunction getContainer(container: HTMLElement | string | null): HTMLElement {\n  if (typeof container === 'string') {\n    const element = document.getElementById(container);\n    if (!element && !isPageLoaded()) {\n      throw new Error(`Accessing '${container}' before page was loaded`);\n    }\n    if (!element) {\n      throw new Error(`${container} is not an HTML element`);\n    }\n    return element;\n  } else if (container) {\n    return container;\n  }\n  return document.body;\n}\n\n/** Get a Canvas element from DOM id */\nfunction getCanvasFromDOM(canvasId: string): HTMLCanvasElement {\n  const canvas = document.getElementById(canvasId);\n  if (!canvas && !isPageLoaded()) {\n    throw new Error(`Accessing '${canvasId}' before page was loaded`);\n  }\n  if (!(canvas instanceof HTMLCanvasElement)) {\n    throw new Error('Object is not a canvas element');\n  }\n  return canvas;\n}\n\n/** Create a new canvas */\nfunction createCanvas(props: CanvasContextProps) {\n  const {width, height} = props;\n  const targetCanvas = document.createElement('canvas');\n  targetCanvas.id = 'lumagl-auto-created-canvas';\n  targetCanvas.width = width || 1;\n  targetCanvas.height = height || 1;\n  targetCanvas.style.width = Number.isFinite(width) ? `${width}px` : '100%';\n  targetCanvas.style.height = Number.isFinite(height) ? `${height}px` : '100%';\n  return targetCanvas;\n}\n\n/**\n *\n * @param pixel\n * @param ratio\n * @param width\n * @param height\n * @param yInvert\n * @returns\n */\nfunction scalePixels(\n  pixel: number[],\n  ratio: number,\n  width: number,\n  height: number,\n  yInvert: boolean\n): {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n} {\n  const point = pixel as [number, number];\n  \n  const x = scaleX(point[0], ratio, width);\n  let y = scaleY(point[1], ratio, height, yInvert);\n\n  // Find boundaries of next pixel to provide valid range of device pixel locations\n\n  let t = scaleX(point[0] + 1, ratio, width);\n  // If next pixel's position is clamped to boundary, use it as is, otherwise subtract 1 for current pixel boundary\n  const xHigh = t === width - 1 ? t : t - 1;\n\n  t = scaleY(point[1] + 1, ratio, height, yInvert);\n  let yHigh;\n  if (yInvert) {\n    // If next pixel's position is clamped to boundary, use it as is, otherwise clamp it to valid range\n    t = t === 0 ? t : t + 1;\n    // swap y and yHigh\n    yHigh = y;\n    y = t;\n  } else {\n    // If next pixel's position is clamped to boundary, use it as is, otherwise clamp it to valid range\n    yHigh = t === height - 1 ? t : t - 1;\n    // y remains same\n  }\n  return {\n    x,\n    y,\n    // when ratio < 1, current css pixel and next css pixel may point to same device pixel, set width/height to 1 in those cases.\n    width: Math.max(xHigh - x + 1, 1),\n    height: Math.max(yHigh - y + 1, 1)\n  };\n}\n\nfunction scaleX(x: number, ratio: number, width: number): number {\n  // since we are rounding to nearest, when ratio > 1, edge pixels may point to out of bounds value, clamp to the limit\n  const r = Math.min(Math.round(x * ratio), width - 1);\n  return r;\n}\n\nfunction scaleY(y: number, ratio: number, height: number, yInvert: boolean): number {\n  // since we are rounding to nearest, when ratio > 1, edge pixels may point to out of bounds value, clamp to the limit\n  return yInvert\n    ? Math.max(0, height - 1 - Math.round(y * ratio))\n    : Math.min(Math.round(y * ratio), height - 1);\n}\n"],"mappings":"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"}

package/dist/adapter/device.d.ts

@@ -0,0 +1,219 @@
+import { StatsManager } from '../utils/stats-manager';
+import type { TextureFormat } from './types/texture-formats';
+import type { CanvasContext, CanvasContextProps } from './canvas-context';
+import type { BufferProps } from './resources/buffer';
+import { Buffer } from './resources/buffer';
+import type { RenderPipeline, RenderPipelineProps } from './resources/render-pipeline';
+import type { ComputePipeline, ComputePipelineProps } from './resources/compute-pipeline';
+import type { Sampler, SamplerProps } from './resources/sampler';
+import type { Shader, ShaderProps } from './resources/shader';
+import type { Texture, TextureProps, TextureData } from './resources/texture';
+import type { ExternalTexture, ExternalTextureProps } from './resources/external-texture';
+import type { Framebuffer, FramebufferProps } from './resources/framebuffer';
+import type { RenderPass, RenderPassProps } from './resources/render-pass';
+import type { ComputePass, ComputePassProps } from './resources/compute-pass';
+import type { CommandEncoder, CommandEncoderProps } from './resources/command-encoder';
+import type { VertexArray, VertexArrayProps } from './resources/vertex-array';
+import type { TransformFeedback, TransformFeedbackProps } from './resources/transform-feedback';
+/** Device properties */
+export type DeviceProps = {
+    id?: string;
+    type?: 'webgl' | 'webgl1' | 'webgl2' | 'webgpu' | 'best-available';
+    canvas?: HTMLCanvasElement | OffscreenCanvas | string | null;
+    container?: HTMLElement | string | null;
+    width?: number /** width is only used when creating a new canvas */;
+    height?: number /** height is only used when creating a new canvas */;
+    webgl2?: boolean;
+    webgl1?: boolean;
+    debug?: boolean;
+    manageState?: boolean;
+    break?: string[];
+    gl?: WebGLRenderingContext | WebGL2RenderingContext | null;
+};
+/**
+ * Identifies the GPU vendor and driver.
+ * @note Chrome WebGPU does not provide much information, though more can be enabled with
+ * @see https://developer.chrome.com/blog/new-in-webgpu-120#adapter_information_updates
+ * chrome://flags/#enable-webgpu-developer-features
+ */
+export type DeviceInfo = {
+    /** Type of device */
+    type: 'webgl' | 'webgl2' | 'webgpu';
+    /** Vendor (name of GPU vendor, Apple, nVidia etc */
+    vendor: string;
+    /** Renderer (usually driver name) */
+    renderer: string;
+    /** version of driver */
+    version: string;
+    /** family of GPU */
+    gpu: 'nvidia' | 'amd' | 'intel' | 'apple' | 'software' | 'unknown';
+    /** Type of GPU () */
+    gpuType: 'discrete' | 'integrated' | 'cpu' | 'unknown';
+    /** GPU architecture */
+    gpuArchitecture?: string;
+    /** GPU driver backend. Can sometimes be sniffed */
+    gpuBackend?: 'opengl' | 'opengles' | 'metal' | 'd3d11' | 'd3d12' | 'vulkan' | 'unknown';
+    /** If this is a fallback adapter */
+    fallback?: boolean;
+    /** Shader language supported by device.createShader() */
+    shadingLanguage: 'wgsl' | 'glsl';
+    /** Highest supported shader language version (GLSL 3.00 = 300, GLSL 1.00 = 100) */
+    shadingLanguageVersion: number;
+};
+/** Limits for a device */
+export type DeviceLimits = {
+    readonly maxTextureDimension1D?: number;
+    readonly maxTextureDimension2D?: number;
+    readonly maxTextureDimension3D?: number;
+    readonly maxTextureArrayLayers?: number;
+    readonly maxBindGroups: number;
+    readonly maxDynamicUniformBuffersPerPipelineLayout: number;
+    readonly maxDynamicStorageBuffersPerPipelineLayout: number;
+    readonly maxSampledTexturesPerShaderStage: number;
+    readonly maxSamplersPerShaderStage: number;
+    readonly maxStorageBuffersPerShaderStage: number;
+    readonly maxStorageTexturesPerShaderStage: number;
+    readonly maxUniformBuffersPerShaderStage: number;
+    readonly maxUniformBufferBindingSize: number;
+    readonly maxStorageBufferBindingSize?: number;
+    readonly minUniformBufferOffsetAlignment?: number;
+    readonly minStorageBufferOffsetAlignment?: number;
+    readonly maxVertexBuffers?: number;
+    readonly maxVertexAttributes: number;
+    readonly maxVertexBufferArrayStride?: number;
+    readonly maxInterStageShaderComponents?: number;
+    readonly maxComputeWorkgroupStorageSize?: number;
+    readonly maxComputeInvocationsPerWorkgroup?: number;
+    readonly maxComputeWorkgroupSizeX?: number;
+    readonly maxComputeWorkgroupSizeY?: number;
+    readonly maxComputeWorkgroupSizeZ?: number;
+    readonly maxComputeWorkgroupsPerDimension?: number;
+};
+export type WebGPUDeviceFeature = 'depth-clip-control' | 'depth24unorm-stencil8' | 'depth32float-stencil8' | 'timestamp-query' | 'indirect-first-instance' | 'texture-compression-bc' | 'texture-compression-etc2' | 'texture-compression-astc';
+export type WebGLDeviceFeature = 'webgpu' | 'webgl2' | 'webgl' | 'timer-query-webgl' | 'uniform-buffers-webgl' | 'uniforms-webgl' | 'texture-filter-linear-float32-webgl' | 'texture-filter-linear-float16-webgl' | 'texture-filter-anisotropic-webgl' | 'texture-renderable-float32-webgl' | 'texture-renderable-float16-webgl' | 'texture-renderable-rgba32float-webgl' | 'texture-blend-float-webgl1' | 'texture-formats-norm16-webgl' | 'texture-formats-srgb-webgl1' | 'texture-formats-depth-webgl1' | 'texture-formats-float32-webgl1' | 'texture-formats-float16-webgl1' | 'vertex-array-object-webgl1' | 'instanced-rendering-webgl1' | 'multiple-render-targets-webgl1' | 'index-uint32-webgl1' | 'blend-minmax-webgl1' | 'transform-feedback-webgl2' | 'glsl-frag-data' | 'glsl-frag-depth' | 'glsl-derivatives' | 'glsl-texture-lod';
+type WebGLCompressedTextureFeatures = 'texture-compression-bc5-webgl' | 'texture-compression-etc1-webgl' | 'texture-compression-pvrtc-webgl' | 'texture-compression-atc-webgl';
+/** Valid feature strings */
+export type DeviceFeature = WebGPUDeviceFeature | WebGLDeviceFeature | WebGLCompressedTextureFeatures;
+/**
+ * WebGPU Device/WebGL context abstraction
+ */
+export declare abstract class Device {
+    static defaultProps: Required<DeviceProps>;
+    get [Symbol.toStringTag](): string;
+    static VERSION: string;
+    constructor(props: DeviceProps);
+    /** id of this device, primarily for debugging */
+    readonly id: string;
+    /** stats */
+    readonly statsManager: StatsManager;
+    /** A copy of the device props  */
+    readonly props: Required<DeviceProps>;
+    /** Available for the application to store data on the device */
+    userData: {
+        [key: string]: unknown;
+    };
+    /** Used by other luma.gl modules to store data on the device */
+    _lumaData: {
+        [key: string]: unknown;
+    };
+    abstract destroy(): void;
+    /** Information about the device (vendor, versions etc) */
+    abstract info: DeviceInfo;
+    /** Optional capability discovery */
+    abstract get features(): Set<DeviceFeature>;
+    /** WebGPU style device limits */
+    abstract get limits(): DeviceLimits;
+    /** Check if device supports a specific texture format (creation and `nearest` sampling) */
+    abstract isTextureFormatSupported(format: TextureFormat): boolean;
+    /** Check if linear filtering (sampler interpolation) is supported for a specific texture format */
+    abstract isTextureFormatFilterable(format: TextureFormat): boolean;
+    /** Check if device supports rendering to a specific texture format */
+    abstract isTextureFormatRenderable(format: TextureFormat): boolean;
+    /** `true` if device is already lost */
+    abstract get isLost(): boolean;
+    /** Promise that resolves when device is lost */
+    abstract readonly lost: Promise<{
+        reason: 'destroyed';
+        message: string;
+    }>;
+    /**
+     * Trigger device loss.
+     * @returns `true` if context loss could actually be triggered.
+     * @note primarily intended for testing how application reacts to device loss
+     */
+    loseDevice(): boolean;
+    /** Default / primary canvas context. Can be null as WebGPU devices can be created without a CanvasContext */
+    abstract canvasContext: CanvasContext | null;
+    /** Returns the default / primary canvas context. Throws an error if no canvas context is available (a WebGPU compute device) */
+    getCanvasContext(): CanvasContext;
+    /** Creates a new CanvasContext (WebGPU only) */
+    abstract createCanvasContext(props?: CanvasContextProps): CanvasContext;
+    /** Call after rendering a frame (necessary e.g. on WebGL OffscreenCanvas) */
+    abstract submit(): void;
+    /** Create a buffer */
+    abstract createBuffer(props: BufferProps | ArrayBuffer | ArrayBufferView): Buffer;
+    /** Create a texture */
+    abstract _createTexture(props: TextureProps): Texture;
+    createTexture(props: TextureProps): Texture;
+    createTexture(data: Promise<TextureData>): Texture;
+    createTexture(url: string): Texture;
+    /** Create a temporary texture view of a video source */
+    abstract createExternalTexture(props: ExternalTextureProps): ExternalTexture;
+    /** Create a sampler */
+    abstract createSampler(props: SamplerProps): Sampler;
+    /** Create a Framebuffer. Must have at least one attachment. */
+    abstract createFramebuffer(props: FramebufferProps): Framebuffer;
+    /** Create a shader */
+    abstract createShader(props: ShaderProps): Shader;
+    /** Create a render pipeline (aka program) */
+    abstract createRenderPipeline(props: RenderPipelineProps): RenderPipeline;
+    /** Create a compute pipeline (aka program). WebGPU only. */
+    abstract createComputePipeline(props: ComputePipelineProps): ComputePipeline;
+    /** Create a vertex array */
+    abstract createVertexArray(props: VertexArrayProps): VertexArray;
+    /** Create a RenderPass */
+    abstract beginRenderPass(props?: RenderPassProps): RenderPass;
+    /** Create a ComputePass */
+    abstract beginComputePass(props?: ComputePassProps): ComputePass;
+    /** Get a renderpass that is set up to render to the primary CanvasContext */
+    abstract getDefaultRenderPass(): RenderPass;
+    /** Create a transform feedback (immutable set of output buffer bindings). WebGL 2 only. */
+    abstract createTransformFeedback(props: TransformFeedbackProps): TransformFeedback;
+    createCommandEncoder(props?: CommandEncoderProps): CommandEncoder;
+    /** @deprecated - will be removed - should use command encoder */
+    readPixelsToArrayWebGL(source: Framebuffer | Texture, options?: {
+        sourceX?: number;
+        sourceY?: number;
+        sourceFormat?: number;
+        sourceAttachment?: number;
+        target?: Uint8Array | Uint16Array | Float32Array;
+        sourceWidth?: number;
+        sourceHeight?: number;
+        sourceType?: number;
+    }): Uint8Array | Uint16Array | Float32Array;
+    /** @deprecated - will be removed - should use command encoder */
+    readPixelsToBufferWebGL2(source: Framebuffer | Texture, options?: {
+        sourceX?: number;
+        sourceY?: number;
+        sourceFormat?: number;
+        target?: Buffer;
+        targetByteOffset?: number;
+        sourceWidth?: number;
+        sourceHeight?: number;
+        sourceType?: number;
+    }): Buffer;
+    /** @deprecated - will be removed - should use WebGPU parameters (pipeline) */
+    setParametersWebGL(parameters: any): void;
+    /** @deprecated - will be removed - should use WebGPU parameters (pipeline) */
+    withParametersWebGL(parameters: any, func: any): any;
+    /** @deprecated - will be removed - should use clear arguments in RenderPass */
+    clearWebGL(options?: {
+        framebuffer?: Framebuffer;
+        color?: any;
+        depth?: any;
+        stencil?: any;
+    }): void;
+    protected _getBufferProps(props: BufferProps | ArrayBuffer | ArrayBufferView): BufferProps;
+}
+export {};
+//# sourceMappingURL=device.d.ts.map

package/dist/adapter/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/adapter/device.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,YAAY,EAAY,MAAM,wBAAwB,CAAC;AAG/D,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAC,aAAa,EAAE,kBAAkB,EAAC,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAC,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAC1C,OAAO,KAAK,EAAC,cAAc,EAAE,mBAAmB,EAAC,MAAM,6BAA6B,CAAC;AACrF,OAAO,KAAK,EAAC,eAAe,EAAE,oBAAoB,EAAC,MAAM,8BAA8B,CAAC;AACxF,OAAO,KAAK,EAAC,OAAO,EAAE,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAC,MAAM,EAAE,WAAW,EAAC,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAC,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAC,eAAe,EAAE,oBAAoB,EAAC,MAAM,8BAA8B,CAAC;AACxF,OAAO,KAAK,EAAC,WAAW,EAAE,gBAAgB,EAAC,MAAM,yBAAyB,CAAC;AAC3E,OAAO,KAAK,EAAC,UAAU,EAAE,eAAe,EAAC,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAC,WAAW,EAAE,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAC,cAAc,EAAE,mBAAmB,EAAC,MAAM,6BAA6B,CAAC;AACrF,OAAO,KAAK,EAAC,WAAW,EAAE,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAC,iBAAiB,EAAE,sBAAsB,EAAC,MAAM,gCAAgC,CAAC;AAE9F,wBAAwB;AACxB,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IAEZ,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IAGnE,MAAM,CAAC,EAAE,iBAAiB,GAAG,eAAe,GAAG,MAAM,GAAG,IAAI,CAAC;IAC7D,SAAS,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC,oDAAoD,CAAC;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC,qDAAqD,CAAC;IAGtE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IAYjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAGjB,EAAE,CAAC,EAAE,qBAAqB,GAAG,sBAAsB,GAAG,IAAI,CAAC;CAC5D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,qBAAqB;IACrB,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpC,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,GAAG,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IACnE,qBAAqB;IACrB,OAAO,EAAE,UAAU,GAAG,YAAY,GAAG,KAAK,GAAG,SAAS,CAAC;IACvD,uBAAuB;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,UAAU,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxF,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yDAAyD;IACzD,eAAe,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,mFAAmF;IACnF,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,0BAA0B;AAC1B,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,yCAAyC,EAAE,MAAM,CAAC;IAC3D,QAAQ,CAAC,yCAAyC,EAAE,MAAM,CAAC;IAC3D,QAAQ,CAAC,gCAAgC,EAAE,MAAM,CAAC;IAClD,QAAQ,CAAC,yBAAyB,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,+BAA+B,EAAE,MAAM,CAAC;IACjD,QAAQ,CAAC,gCAAgC,EAAE,MAAM,CAAC;IAClD,QAAQ,CAAC,+BAA+B,EAAE,MAAM,CAAC;IACjD,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAC9C,QAAQ,CAAC,+BAA+B,CAAC,EAAE,MAAM,CAAC;IAClD,QAAQ,CAAC,+BAA+B,CAAC,EAAE,MAAM,CAAC;IAClD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IAC7C,QAAQ,CAAC,6BAA6B,CAAC,EAAE,MAAM,CAAC;IAChD,QAAQ,CAAC,8BAA8B,CAAC,EAAE,MAAM,CAAC;IACjD,QAAQ,CAAC,iCAAiC,CAAC,EAAE,MAAM,CAAC;IACpD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAC3C,QAAQ,CAAC,gCAAgC,CAAC,EAAE,MAAM,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC3B,oBAAoB,GACpB,uBAAuB,GACvB,uBAAuB,GACvB,iBAAiB,GACjB,yBAAyB,GACzB,wBAAwB,GACxB,0BAA0B,GAC1B,0BAA0B,CAAC;AAU/B,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,QAAQ,GACR,OAAO,GAGP,mBAAmB,GACnB,uBAAuB,GACvB,gBAAgB,GAGhB,qCAAqC,GACrC,qCAAqC,GACrC,kCAAkC,GAGlC,kCAAkC,GAClC,kCAAkC,GAClC,sCAAsC,GAGtC,4BAA4B,GAG5B,8BAA8B,GAC9B,6BAA6B,GAC7B,8BAA8B,GAC9B,gCAAgC,GAChC,gCAAgC,GAGhC,4BAA4B,GAC5B,4BAA4B,GAC5B,gCAAgC,GAChC,qBAAqB,GACrB,qBAAqB,GACrB,2BAA2B,GAG3B,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,kBAAkB,CAAC;AAEvB,KAAK,8BAA8B,GAC/B,+BAA+B,GAC/B,gCAAgC,GAChC,iCAAiC,GACjC,+BAA+B,CAAC;AAEpC,4BAA4B;AAC5B,MAAM,MAAM,aAAa,GACrB,mBAAmB,GACnB,kBAAkB,GAClB,8BAA8B,CAAC;AAEnC;;GAEG;AACH,8BAAsB,MAAM;IAE1B,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,CAsBxC;IAGF,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAEjC;IAED,MAAM,CAAC,OAAO,SAAW;gBAEb,KAAK,EAAE,WAAW;IAK9B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,YAAY;IACZ,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAa;IAChD,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IACtC,gEAAgE;IAChE,QAAQ,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAC,CAAM;IACxC,gEAAgE;IAChE,SAAS,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAC,CAAM;IAEzC,QAAQ,CAAC,OAAO,IAAI,IAAI;IAIxB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B,oCAAoC;IACpC,QAAQ,KAAK,QAAQ,IAAI,GAAG,CAAC,aAAa,CAAC,CAAC;IAE5C,iCAAiC;IACjC,QAAQ,KAAK,MAAM,IAAI,YAAY,CAAC;IAEpC,2FAA2F;IAC3F,QAAQ,CAAC,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAEjE,mGAAmG;IACnG,QAAQ,CAAC,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAElE,sEAAsE;IACtE,QAAQ,CAAC,yBAAyB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO;IAIlE,uCAAuC;IACvC,QAAQ,KAAK,MAAM,IAAI,OAAO,CAAC;IAE/B,gDAAgD;IAChD,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IAExE;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAMrB,6GAA6G;IAC7G,QAAQ,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IAE7C,gIAAgI;IAChI,gBAAgB,IAAI,aAAa;IAOjC,gDAAgD;IAChD,QAAQ,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,kBAAkB,GAAG,aAAa;IAEvE,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,IAAI,IAAI;IAIvB,sBAAsB;IACtB,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,MAAM;IAEjF,uBAAuB;IACvB,QAAQ,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IACrD,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAC3C,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO;IAClD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAUnC,wDAAwD;IACxD,QAAQ,CAAC,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe;IAE5E,uBAAuB;IACvB,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;IAEpD,+DAA+D;IAC/D,QAAQ,CAAC,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW;IAEhE,sBAAsB;IACtB,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM;IAEjD,6CAA6C;IAC7C,QAAQ,CAAC,oBAAoB,CAAC,KAAK,EAAE,mBAAmB,GAAG,cAAc;IAEzE,4DAA4D;IAC5D,QAAQ,CAAC,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,eAAe;IAE5E,4BAA4B;IAC5B,QAAQ,CAAC,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW;IAEhE,0BAA0B;IAC1B,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,eAAe,GAAG,UAAU;IAE7D,2BAA2B;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,gBAAgB,GAAG,WAAW;IAEhE,6EAA6E;IAC7E,QAAQ,CAAC,oBAAoB,IAAI,UAAU;IAE3C,2FAA2F;IAC3F,QAAQ,CAAC,uBAAuB,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB;IAElF,oBAAoB,CAAC,KAAK,GAAE,mBAAwB,GAAG,cAAc;IAOrE,iEAAiE;IACjE,sBAAsB,CACpB,MAAM,EAAE,WAAW,GAAG,OAAO,EAC7B,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,MAAM,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,YAAY,CAAC;QAEjD,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,UAAU,GAAG,WAAW,GAAG,YAAY;IAI1C,iEAAiE;IACjE,wBAAwB,CACtB,MAAM,EAAE,WAAW,GAAG,OAAO,EAC7B,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAE1B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,MAAM;IAIT,8EAA8E;IAC9E,kBAAkB,CAAC,UAAU,EAAE,GAAG,GAAG,IAAI;IAIzC,8EAA8E;IAC9E,mBAAmB,CAAC,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG;IAIpD,+EAA+E;IAC/E,UAAU,CAAC,OAAO,CAAC,EAAE;QAAC,WAAW,CAAC,EAAE,WAAW,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAC;QAAC,KAAK,CAAC,EAAE,GAAG,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAC,GAAG,IAAI;IAMhG,SAAS,CAAC,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,WAAW;CAqB3F"}

package/dist/adapter/device.js

@@ -0,0 +1,99 @@
+let _Symbol$toStringTag;
+import { VERSION } from "../init.js";
+import { lumaStats } from "../utils/stats-manager.js";
+import { log } from "../utils/log.js";
+import { uid } from "../utils/utils.js";
+import { Buffer } from "./resources/buffer.js";
+_Symbol$toStringTag = Symbol.toStringTag;
+export class Device {
+  get [_Symbol$toStringTag]() {
+    return 'Device';
+  }
+  constructor(props) {
+    this.id = void 0;
+    this.statsManager = lumaStats;
+    this.props = void 0;
+    this.userData = {};
+    this._lumaData = {};
+    this.info = void 0;
+    this.lost = void 0;
+    this.canvasContext = void 0;
+    this.props = {
+      ...Device.defaultProps,
+      ...props
+    };
+    this.id = this.props.id || uid(this[Symbol.toStringTag].toLowerCase());
+  }
+  loseDevice() {
+    return false;
+  }
+  getCanvasContext() {
+    if (!this.canvasContext) {
+      throw new Error('Device has no CanvasContext');
+    }
+    return this.canvasContext;
+  }
+  createTexture(props) {
+    if (props instanceof Promise || typeof props === 'string') {
+      props = {
+        data: props
+      };
+    }
+    return this._createTexture(props);
+  }
+  createCommandEncoder() {
+    let props = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+    throw new Error('not implemented');
+  }
+  readPixelsToArrayWebGL(source, options) {
+    throw new Error('not implemented');
+  }
+  readPixelsToBufferWebGL2(source, options) {
+    throw new Error('not implemented');
+  }
+  setParametersWebGL(parameters) {
+    throw new Error('not implemented');
+  }
+  withParametersWebGL(parameters, func) {
+    throw new Error('not implemented');
+  }
+  clearWebGL(options) {
+    throw new Error('not implemented');
+  }
+  _getBufferProps(props) {
+    if (props instanceof ArrayBuffer || ArrayBuffer.isView(props)) {
+      props = {
+        data: props
+      };
+    }
+    const newProps = {
+      ...props
+    };
+    if ((props.usage || 0) & Buffer.INDEX && !props.indexType) {
+      if (props.data instanceof Uint32Array) {
+        newProps.indexType = 'uint32';
+      } else if (props.data instanceof Uint16Array) {
+        newProps.indexType = 'uint16';
+      } else {
+        log.warn('indices buffer content must be of integer type')();
+      }
+    }
+    return newProps;
+  }
+}
+Device.defaultProps = {
+  id: null,
+  type: 'best-available',
+  canvas: null,
+  container: null,
+  webgl2: true,
+  webgl1: true,
+  manageState: true,
+  width: 800,
+  height: 600,
+  debug: Boolean(log.get('debug')),
+  break: [],
+  gl: null
+};
+Device.VERSION = VERSION;
+//# sourceMappingURL=device.js.map

package/dist/adapter/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","names":["VERSION","lumaStats","log","uid","Buffer","_Symbol$toStringTag","Symbol","toStringTag","Device","constructor","props","id","statsManager","userData","_lumaData","info","lost","canvasContext","defaultProps","toLowerCase","loseDevice","getCanvasContext","Error","createTexture","Promise","data","_createTexture","createCommandEncoder","arguments","length","undefined","readPixelsToArrayWebGL","source","options","readPixelsToBufferWebGL2","setParametersWebGL","parameters","withParametersWebGL","func","clearWebGL","_getBufferProps","ArrayBuffer","isView","newProps","usage","INDEX","indexType","Uint32Array","Uint16Array","warn","type","canvas","container","webgl2","webgl1","manageState","width","height","debug","Boolean","get","break","gl"],"sources":["../../src/adapter/device.ts"],"sourcesContent":["// luma.gl, MIT license\nimport {VERSION} from '../init';\nimport {StatsManager, lumaStats} from '../utils/stats-manager';\nimport {log} from '../utils/log';\nimport {uid} from '../utils/utils';\nimport type {TextureFormat} from './types/texture-formats';\nimport type {CanvasContext, CanvasContextProps} from './canvas-context';\nimport type {BufferProps} from './resources/buffer';\nimport {Buffer} from './resources/buffer';\nimport type {RenderPipeline, RenderPipelineProps} from './resources/render-pipeline';\nimport type {ComputePipeline, ComputePipelineProps} from './resources/compute-pipeline';\nimport type {Sampler, SamplerProps} from './resources/sampler';\nimport type {Shader, ShaderProps} from './resources/shader';\nimport type {Texture, TextureProps, TextureData} from './resources/texture';\nimport type {ExternalTexture, ExternalTextureProps} from './resources/external-texture';\nimport type {Framebuffer, FramebufferProps} from './resources/framebuffer';\nimport type {RenderPass, RenderPassProps} from './resources/render-pass';\nimport type {ComputePass, ComputePassProps} from './resources/compute-pass';\nimport type {CommandEncoder, CommandEncoderProps} from './resources/command-encoder';\nimport type {VertexArray, VertexArrayProps} from './resources/vertex-array';\nimport type {TransformFeedback, TransformFeedbackProps} from './resources/transform-feedback';\n\n/** Device properties */\nexport type DeviceProps = {\n  id?: string;\n\n  type?: 'webgl' | 'webgl1' | 'webgl2' | 'webgpu' | 'best-available';\n\n  // Common parameters\n  canvas?: HTMLCanvasElement | OffscreenCanvas | string | null; // A canvas element or a canvas string id\n  container?: HTMLElement | string | null;\n  width?: number /** width is only used when creating a new canvas */;\n  height?: number /** height is only used when creating a new canvas */;\n\n  // WebGLDevice parameters\n  webgl2?: boolean; // Set to false to not create a WebGL2 context (force webgl1)\n  webgl1?: boolean; // set to false to not create a WebGL1 context (fails if webgl2 not available)\n\n  // WebGLContext PARAMETERS - Can only be set on context creation...\n  // alpha?: boolean; // Default render target has an alpha buffer.\n  // depth?: boolean; // Default render target has a depth buffer of at least 16 bits.\n  // stencil?: boolean; // Default render target has a stencil buffer of at least 8 bits.\n  // antialias?: boolean; // Boolean that indicates whether or not to perform anti-aliasing.\n  // premultipliedAlpha?: boolean; // Boolean that indicates that the page compositor will assume the drawing buffer contains colors with pre-multiplied alpha.\n  // preserveDrawingBuffer?: boolean; // Default render target buffers will not be automatically cleared and will preserve their values until cleared or overwritten\n  // failIfMajorPerformanceCaveat?: boolean; // Do not create if the system performance is low.\n\n  // Unclear if these are still supported\n  debug?: boolean; // Instrument context (at the expense of performance)\n  manageState?: boolean; // Set to false to disable WebGL state management instrumentation\n  break?: string[]; // TODO: types\n\n  // @deprecated Attach to existing context\n  gl?: WebGLRenderingContext | WebGL2RenderingContext | null;\n};\n\n/**\n * Identifies the GPU vendor and driver.\n * @note Chrome WebGPU does not provide much information, though more can be enabled with\n * @see https://developer.chrome.com/blog/new-in-webgpu-120#adapter_information_updates\n * chrome://flags/#enable-webgpu-developer-features\n */\nexport type DeviceInfo = {\n  /** Type of device */\n  type: 'webgl' | 'webgl2' | 'webgpu';\n  /** Vendor (name of GPU vendor, Apple, nVidia etc */\n  vendor: string;\n  /** Renderer (usually driver name) */\n  renderer: string;\n  /** version of driver */\n  version: string;\n  /** family of GPU */\n  gpu: 'nvidia' | 'amd' | 'intel' | 'apple' | 'software' | 'unknown';\n  /** Type of GPU () */\n  gpuType: 'discrete' | 'integrated' | 'cpu' | 'unknown';\n  /** GPU architecture */\n  gpuArchitecture?: string; // 'common-3' on Apple\n  /** GPU driver backend. Can sometimes be sniffed */\n  gpuBackend?: 'opengl' | 'opengles' | 'metal' | 'd3d11' | 'd3d12' | 'vulkan' | 'unknown';\n  /** If this is a fallback adapter */\n  fallback?: boolean;\n  /** Shader language supported by device.createShader() */\n  shadingLanguage: 'wgsl' | 'glsl';\n  /** Highest supported shader language version (GLSL 3.00 = 300, GLSL 1.00 = 100) */\n  shadingLanguageVersion: number;\n};\n\n/** Limits for a device */\nexport type DeviceLimits = {\n  readonly maxTextureDimension1D?: number;\n  readonly maxTextureDimension2D?: number;\n  readonly maxTextureDimension3D?: number;\n  readonly maxTextureArrayLayers?: number;\n  readonly maxBindGroups: number;\n  readonly maxDynamicUniformBuffersPerPipelineLayout: number;\n  readonly maxDynamicStorageBuffersPerPipelineLayout: number;\n  readonly maxSampledTexturesPerShaderStage: number;\n  readonly maxSamplersPerShaderStage: number;\n  readonly maxStorageBuffersPerShaderStage: number;\n  readonly maxStorageTexturesPerShaderStage: number;\n  readonly maxUniformBuffersPerShaderStage: number;\n  readonly maxUniformBufferBindingSize: number;\n  readonly maxStorageBufferBindingSize?: number;\n  readonly minUniformBufferOffsetAlignment?: number;\n  readonly minStorageBufferOffsetAlignment?: number;\n  readonly maxVertexBuffers?: number;\n  readonly maxVertexAttributes: number;\n  readonly maxVertexBufferArrayStride?: number;\n  readonly maxInterStageShaderComponents?: number;\n  readonly maxComputeWorkgroupStorageSize?: number;\n  readonly maxComputeInvocationsPerWorkgroup?: number;\n  readonly maxComputeWorkgroupSizeX?: number;\n  readonly maxComputeWorkgroupSizeY?: number;\n  readonly maxComputeWorkgroupSizeZ?: number;\n  readonly maxComputeWorkgroupsPerDimension?: number;\n};\n\nexport type WebGPUDeviceFeature =\n  | 'depth-clip-control'\n  | 'depth24unorm-stencil8'\n  | 'depth32float-stencil8'\n  | 'timestamp-query'\n  | 'indirect-first-instance'\n  | 'texture-compression-bc'\n  | 'texture-compression-etc2'\n  | 'texture-compression-astc';\n\n// obsolete...\n// 'depth-clamping' |\n// 'depth24unorm-stencil8' |\n// 'depth32float-stencil8' |\n// 'pipeline-statistics-query' |\n// 'timestamp-query' |\n// 'texture-compression-bc'\n\nexport type WebGLDeviceFeature =\n  | 'webgpu'\n  | 'webgl2'\n  | 'webgl'\n\n  // api support (unify with WebGPU timestamp-query?)\n  | 'timer-query-webgl'\n  | 'uniform-buffers-webgl'\n  | 'uniforms-webgl'\n\n  // texture filtering\n  | 'texture-filter-linear-float32-webgl'\n  | 'texture-filter-linear-float16-webgl'\n  | 'texture-filter-anisotropic-webgl'\n\n  // texture rendering\n  | 'texture-renderable-float32-webgl'\n  | 'texture-renderable-float16-webgl'\n  | 'texture-renderable-rgba32float-webgl' // TODO - remove\n\n  // texture blending\n  | 'texture-blend-float-webgl1'\n\n  // texture format support\n  | 'texture-formats-norm16-webgl'\n  | 'texture-formats-srgb-webgl1'\n  | 'texture-formats-depth-webgl1'\n  | 'texture-formats-float32-webgl1'\n  | 'texture-formats-float16-webgl1'\n\n  // api support\n  | 'vertex-array-object-webgl1'\n  | 'instanced-rendering-webgl1'\n  | 'multiple-render-targets-webgl1'\n  | 'index-uint32-webgl1'\n  | 'blend-minmax-webgl1'\n  | 'transform-feedback-webgl2'\n\n  // glsl extensions\n  | 'glsl-frag-data'\n  | 'glsl-frag-depth'\n  | 'glsl-derivatives'\n  | 'glsl-texture-lod';\n\ntype WebGLCompressedTextureFeatures =\n  | 'texture-compression-bc5-webgl'\n  | 'texture-compression-etc1-webgl'\n  | 'texture-compression-pvrtc-webgl'\n  | 'texture-compression-atc-webgl';\n\n/** Valid feature strings */\nexport type DeviceFeature =\n  | WebGPUDeviceFeature\n  | WebGLDeviceFeature\n  | WebGLCompressedTextureFeatures;\n\n/**\n * WebGPU Device/WebGL context abstraction\n */\nexport abstract class Device {\n\n  static defaultProps: Required<DeviceProps> = {\n    id: null!,\n    type: 'best-available',\n    canvas: null,\n    container: null,\n    webgl2: true, // Attempt to create a WebGL2 context\n    webgl1: true, // Attempt to create a WebGL1 context (false to fail if webgl2 not available)\n    manageState: true,\n    width: 800, // width are height are only used by headless gl\n    height: 600,\n    debug: Boolean(log.get('debug')), // Instrument context (at the expense of performance)\n    break: [],\n  \n    // alpha: undefined,\n    // depth: undefined,\n    // stencil: undefined,\n    // antialias: undefined,\n    // premultipliedAlpha: undefined,\n    // preserveDrawingBuffer: undefined,\n    // failIfMajorPerformanceCaveat: undefined\n  \n    gl: null\n  };\n  \n\n  get [Symbol.toStringTag](): string {\n    return 'Device';\n  }\n\n  static VERSION = VERSION;\n\n  constructor(props: DeviceProps) {\n    this.props = {...Device.defaultProps, ...props};\n    this.id = this.props.id || uid(this[Symbol.toStringTag].toLowerCase());\n  }\n\n  /** id of this device, primarily for debugging */\n  readonly id: string;\n  /** stats */\n  readonly statsManager: StatsManager = lumaStats;\n  /** A copy of the device props  */\n  readonly props: Required<DeviceProps>;\n  /** Available for the application to store data on the device */\n  userData: {[key: string]: unknown} = {};\n  /** Used by other luma.gl modules to store data on the device */\n  _lumaData: {[key: string]: unknown} = {};\n\n  abstract destroy(): void;\n\n  // Capabilities\n\n  /** Information about the device (vendor, versions etc) */\n  abstract info: DeviceInfo;\n\n  /** Optional capability discovery */\n  abstract get features(): Set<DeviceFeature>;\n\n  /** WebGPU style device limits */\n  abstract get limits(): DeviceLimits;\n\n  /** Check if device supports a specific texture format (creation and `nearest` sampling) */\n  abstract isTextureFormatSupported(format: TextureFormat): boolean;\n\n  /** Check if linear filtering (sampler interpolation) is supported for a specific texture format */\n  abstract isTextureFormatFilterable(format: TextureFormat): boolean;\n\n  /** Check if device supports rendering to a specific texture format */\n  abstract isTextureFormatRenderable(format: TextureFormat): boolean;\n\n  // Device loss\n\n  /** `true` if device is already lost */\n  abstract get isLost(): boolean;\n\n  /** Promise that resolves when device is lost */\n  abstract readonly lost: Promise<{reason: 'destroyed'; message: string}>;\n\n  /**\n   * Trigger device loss.\n   * @returns `true` if context loss could actually be triggered.\n   * @note primarily intended for testing how application reacts to device loss\n   */\n  loseDevice(): boolean {\n    return false;\n  }\n\n  // Canvas context\n\n  /** Default / primary canvas context. Can be null as WebGPU devices can be created without a CanvasContext */\n  abstract canvasContext: CanvasContext | null;\n\n  /** Returns the default / primary canvas context. Throws an error if no canvas context is available (a WebGPU compute device) */\n  getCanvasContext(): CanvasContext {\n    if (!this.canvasContext) {\n      throw new Error('Device has no CanvasContext');\n    }\n    return this.canvasContext;\n  }\n\n  /** Creates a new CanvasContext (WebGPU only) */\n  abstract createCanvasContext(props?: CanvasContextProps): CanvasContext;\n\n  /** Call after rendering a frame (necessary e.g. on WebGL OffscreenCanvas) */\n  abstract submit(): void;\n\n  // Resource creation\n\n  /** Create a buffer */\n  abstract createBuffer(props: BufferProps | ArrayBuffer | ArrayBufferView): Buffer;\n\n  /** Create a texture */\n  abstract _createTexture(props: TextureProps): Texture;\n  createTexture(props: TextureProps): Texture;\n  createTexture(data: Promise<TextureData>): Texture;\n  createTexture(url: string): Texture;\n\n  createTexture(props: TextureProps | Promise<TextureData> | string): Texture {\n    // Signature: new Texture2D(gl, url | Promise)\n    if (props instanceof Promise || typeof props === 'string') {\n      props = {data: props};\n    }\n    return this._createTexture(props);\n  }\n\n  /** Create a temporary texture view of a video source */\n  abstract createExternalTexture(props: ExternalTextureProps): ExternalTexture;\n\n  /** Create a sampler */\n  abstract createSampler(props: SamplerProps): Sampler;\n\n  /** Create a Framebuffer. Must have at least one attachment. */\n  abstract createFramebuffer(props: FramebufferProps): Framebuffer;\n\n  /** Create a shader */\n  abstract createShader(props: ShaderProps): Shader;\n\n  /** Create a render pipeline (aka program) */\n  abstract createRenderPipeline(props: RenderPipelineProps): RenderPipeline;\n\n  /** Create a compute pipeline (aka program). WebGPU only. */\n  abstract createComputePipeline(props: ComputePipelineProps): ComputePipeline;\n\n  /** Create a vertex array */\n  abstract createVertexArray(props: VertexArrayProps): VertexArray;\n\n  /** Create a RenderPass */\n  abstract beginRenderPass(props?: RenderPassProps): RenderPass;\n\n  /** Create a ComputePass */\n  abstract beginComputePass(props?: ComputePassProps): ComputePass;\n\n  /** Get a renderpass that is set up to render to the primary CanvasContext */\n  abstract getDefaultRenderPass(): RenderPass;\n\n  /** Create a transform feedback (immutable set of output buffer bindings). WebGL 2 only. */\n  abstract createTransformFeedback(props: TransformFeedbackProps): TransformFeedback;\n\n  createCommandEncoder(props: CommandEncoderProps = {}): CommandEncoder {\n    throw new Error('not implemented');\n  }\n\n  // WebGL specific HACKS - enables app to remove webgl import\n  // Use until we have a better way to handle these\n\n  /** @deprecated - will be removed - should use command encoder */\n  readPixelsToArrayWebGL(\n    source: Framebuffer | Texture,\n    options?: {\n      sourceX?: number;\n      sourceY?: number;\n      sourceFormat?: number;\n      sourceAttachment?: number;\n      target?: Uint8Array | Uint16Array | Float32Array;\n      // following parameters are auto deduced if not provided\n      sourceWidth?: number;\n      sourceHeight?: number;\n      sourceType?: number;\n    }\n  ): Uint8Array | Uint16Array | Float32Array {\n    throw new Error('not implemented');\n  }\n  \n  /** @deprecated - will be removed - should use command encoder */\n  readPixelsToBufferWebGL2(\n    source: Framebuffer | Texture,\n    options?: {\n      sourceX?: number;\n      sourceY?: number;\n      sourceFormat?: number;\n      target?: Buffer; // A new Buffer object is created when not provided.\n      targetByteOffset?: number; // byte offset in buffer object\n      // following parameters are auto deduced if not provided\n      sourceWidth?: number;\n      sourceHeight?: number;\n      sourceType?: number;\n    }\n  ): Buffer {\n    throw new Error('not implemented');\n  }\n\n  /** @deprecated - will be removed - should use WebGPU parameters (pipeline) */\n  setParametersWebGL(parameters: any): void {\n    throw new Error('not implemented');\n  }\n\n  /** @deprecated - will be removed - should use WebGPU parameters (pipeline) */\n  withParametersWebGL(parameters: any, func: any): any {\n    throw new Error('not implemented');\n  }\n\n  /** @deprecated - will be removed - should use clear arguments in RenderPass */\n  clearWebGL(options?: {framebuffer?: Framebuffer; color?: any; depth?: any; stencil?: any}): void {\n    throw new Error('not implemented');\n  }\n\n  // Implementation\n\n  protected _getBufferProps(props: BufferProps | ArrayBuffer | ArrayBufferView): BufferProps {\n    if (props instanceof ArrayBuffer || ArrayBuffer.isView(props)) {\n      props = {data: props};\n    }\n\n    // TODO - fragile, as this is done before we merge with default options\n    // inside the Buffer constructor\n\n    const newProps = {...props};\n    // Deduce indexType\n    if ((props.usage || 0) & Buffer.INDEX && !props.indexType) {\n      if (props.data instanceof Uint32Array) {\n        newProps.indexType = 'uint32';\n      } else if (props.data instanceof Uint16Array) {\n        newProps.indexType = 'uint16';\n      } else {\n        log.warn('indices buffer content must be of integer type')();\n      }\n    }\n    return newProps;\n  }\n}\n"],"mappings":"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"}

package/dist/adapter/resources/buffer.d.ts

@@ -0,0 +1,56 @@
+import type { Device } from '../device';
+import { Resource, ResourceProps } from './resource';
+export type BufferProps = ResourceProps & {
+    /** Supply a handle to connect to an existing device-specific buffer */
+    handle?: WebGLBuffer;
+    /** Specifies how this buffer can be used */
+    usage?: number;
+    /** Length in bytes of memory to be allocated. If not specified, `byteLength` of  `props.data` will be used. */
+    byteLength?: number;
+    /** Data to initialize the buffer with. */
+    data?: ArrayBuffer | ArrayBufferView | null;
+    /** Byte offset into the newly created Buffer to store data at */
+    byteOffset?: number;
+    /** If props.usage includes Buffer.INDEX */
+    indexType?: 'uint16' | 'uint32';
+    mappedAtCreation?: boolean;
+};
+/** Abstract GPU buffer */
+export declare abstract class Buffer extends Resource<BufferProps> {
+    static defaultProps: Required<BufferProps>;
+    static MAP_READ: number;
+    static MAP_WRITE: number;
+    static COPY_SRC: number;
+    static COPY_DST: number;
+    /** Index buffer */
+    static INDEX: number;
+    /** Vertex buffer */
+    static VERTEX: number;
+    /** Uniform buffer */
+    static UNIFORM: number;
+    /** Storage buffer */
+    static STORAGE: number;
+    static INDIRECT: number;
+    static QUERY_RESOLVE: number;
+    get [Symbol.toStringTag](): string;
+    /** The usage with which this buffer was created */
+    readonly usage: number;
+    /** For index buffers, whether indices are 16 or 32 bit */
+    readonly indexType?: 'uint16' | 'uint32';
+    /** Length of buffer in bytes */
+    abstract byteLength: number;
+    constructor(device: Device, props: BufferProps);
+    /** Write data to buffer */
+    abstract write(data: ArrayBufferView, byteOffset?: number): void;
+    /** Read data asynchronoursly */
+    abstract readAsync(byteOffset?: number, byteLength?: number): Promise<Uint8Array>;
+    /** Read data synchronously. @note WebGL2 only */
+    readSyncWebGL2(byteOffset?: number, byteLength?: number): Uint8Array;
+    /** Max amount of debug data saved. Two vec4's */
+    static DEBUG_DATA_MAX_LENGTH: number;
+    /** A partial CPU-side copy of the data in this buffer, for debugging purposes */
+    debugData: ArrayBuffer;
+    /** This doesn't handle partial non-zero offset updates correctly */
+    protected _setDebugData(data: ArrayBufferView | ArrayBuffer | null, byteOffset: number, byteLength: number): void;
+}
+//# sourceMappingURL=buffer.d.ts.map

package/dist/adapter/resources/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/buffer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,WAAW,CAAC;AACtC,OAAO,EAAC,QAAQ,EAAE,aAAa,EAAC,MAAM,YAAY,CAAC;AAEnD,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG;IACxC,uEAAuE;IACvE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+GAA+G;IAC/G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,WAAW,GAAG,eAAe,GAAG,IAAI,CAAC;IAC5C,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAGhC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAA;AAED,0BAA0B;AAC1B,8BAAsB,MAAO,SAAQ,QAAQ,CAAC,WAAW,CAAC;IACxD,OAAgB,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,CAQjD;IAGF,MAAM,CAAC,QAAQ,SAAQ;IACvB,MAAM,CAAC,SAAS,SAAQ;IACxB,MAAM,CAAC,QAAQ,SAAU;IACzB,MAAM,CAAC,QAAQ,SAAU;IACzB,mBAAmB;IACnB,MAAM,CAAC,KAAK,SAAU;IACtB,oBAAoB;IACpB,MAAM,CAAC,MAAM,SAAU;IACvB,qBAAqB;IACrB,MAAM,CAAC,OAAO,SAAU;IACxB,qBAAqB;IACrB,MAAM,CAAC,OAAO,SAAU;IACxB,MAAM,CAAC,QAAQ,SAAU;IACzB,MAAM,CAAC,aAAa,SAAU;IAE9B,IAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAAqB;IAEhE,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACzC,gCAAgC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IAkB9C,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAChE,gCAAgC;IAChC,QAAQ,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAEjF,iDAAiD;IACjD,cAAc,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU;IAIpE,iDAAiD;IACjD,MAAM,CAAC,qBAAqB,SAAM;IAClC,iFAAiF;IACjF,SAAS,EAAE,WAAW,CAAsB;IAE5C,oEAAoE;IACpE,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;CAWlH"}

package/dist/adapter/resources/buffer.js

@@ -0,0 +1,62 @@
+let _Symbol$toStringTag;
+import { Resource } from "./resource.js";
+_Symbol$toStringTag = Symbol.toStringTag;
+export class Buffer extends Resource {
+  get [_Symbol$toStringTag]() {
+    return 'Buffer';
+  }
+  constructor(device, props) {
+    const deducedProps = {
+      ...props
+    };
+    if ((props.usage || 0) & Buffer.INDEX && !props.indexType) {
+      if (props.data instanceof Uint32Array) {
+        deducedProps.indexType = 'uint32';
+      } else if (props.data instanceof Uint16Array) {
+        deducedProps.indexType = 'uint16';
+      }
+    }
+    super(device, deducedProps, Buffer.defaultProps);
+    this.usage = void 0;
+    this.indexType = void 0;
+    this.byteLength = void 0;
+    this.debugData = new ArrayBuffer(0);
+    this.usage = props.usage || 0;
+    this.indexType = deducedProps.indexType;
+  }
+  readSyncWebGL2(byteOffset, byteLength) {
+    throw new Error('not implemented');
+  }
+  _setDebugData(data, byteOffset, byteLength) {
+    const buffer = ArrayBuffer.isView(data) ? data.buffer : data;
+    const debugDataLength = Math.min(data ? data.byteLength : byteLength, Buffer.DEBUG_DATA_MAX_LENGTH);
+    if (data === null) {
+      this.debugData = new ArrayBuffer(debugDataLength);
+    } else if (byteOffset === 0 && byteLength === data.byteLength) {
+      this.debugData = buffer.slice(0, debugDataLength);
+    } else {
+      this.debugData = buffer.slice(byteOffset, byteOffset + debugDataLength);
+    }
+  }
+}
+Buffer.defaultProps = {
+  ...Resource.defaultProps,
+  usage: 0,
+  byteLength: 0,
+  byteOffset: 0,
+  data: null,
+  indexType: 'uint16',
+  mappedAtCreation: false
+};
+Buffer.MAP_READ = 0x01;
+Buffer.MAP_WRITE = 0x02;
+Buffer.COPY_SRC = 0x0004;
+Buffer.COPY_DST = 0x0008;
+Buffer.INDEX = 0x0010;
+Buffer.VERTEX = 0x0020;
+Buffer.UNIFORM = 0x0040;
+Buffer.STORAGE = 0x0080;
+Buffer.INDIRECT = 0x0100;
+Buffer.QUERY_RESOLVE = 0x0200;
+Buffer.DEBUG_DATA_MAX_LENGTH = 32;
+//# sourceMappingURL=buffer.js.map

package/dist/adapter/resources/buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.js","names":["Resource","_Symbol$toStringTag","Symbol","toStringTag","Buffer","constructor","device","props","deducedProps","usage","INDEX","indexType","data","Uint32Array","Uint16Array","defaultProps","byteLength","debugData","ArrayBuffer","readSyncWebGL2","byteOffset","Error","_setDebugData","buffer","isView","debugDataLength","Math","min","DEBUG_DATA_MAX_LENGTH","slice","mappedAtCreation","MAP_READ","MAP_WRITE","COPY_SRC","COPY_DST","VERTEX","UNIFORM","STORAGE","INDIRECT","QUERY_RESOLVE"],"sources":["../../../src/adapter/resources/buffer.ts"],"sourcesContent":["// luma.gl, MIT license\n\nimport type {Device} from '../device';\nimport {Resource, ResourceProps} from './resource';\n\nexport type BufferProps = ResourceProps & {\n  /** Supply a handle to connect to an existing device-specific buffer */\n  handle?: WebGLBuffer;\n  /** Specifies how this buffer can be used */\n  usage?: number;\n  /** Length in bytes of memory to be allocated. If not specified, `byteLength` of  `props.data` will be used. */\n  byteLength?: number;\n  /** Data to initialize the buffer with. */\n  data?: ArrayBuffer | ArrayBufferView | null;\n  /** Byte offset into the newly created Buffer to store data at */\n  byteOffset?: number;\n  /** If props.usage includes Buffer.INDEX */\n  indexType?: 'uint16' | 'uint32';\n\n  // TBD\n  mappedAtCreation?: boolean;\n}\n\n/** Abstract GPU buffer */\nexport abstract class Buffer extends Resource<BufferProps> {\n  static override defaultProps: Required<BufferProps> = {\n    ...Resource.defaultProps,\n    usage: 0, // Buffer.COPY_DST | Buffer.COPY_SRC\n    byteLength: 0,\n    byteOffset: 0,\n    data: null,\n    indexType: 'uint16',\n    mappedAtCreation: false\n  };\n\n  // Usage Flags\n  static MAP_READ = 0x01;\n  static MAP_WRITE = 0x02;\n  static COPY_SRC = 0x0004;\n  static COPY_DST = 0x0008;\n  /** Index buffer */\n  static INDEX = 0x0010;\n  /** Vertex buffer */\n  static VERTEX = 0x0020;\n  /** Uniform buffer */\n  static UNIFORM = 0x0040;\n  /** Storage buffer */\n  static STORAGE = 0x0080;\n  static INDIRECT = 0x0100;\n  static QUERY_RESOLVE = 0x0200;\n\n  override get [Symbol.toStringTag](): string { return 'Buffer'; }\n\n  /** The usage with which this buffer was created */\n  readonly usage: number;\n  /** For index buffers, whether indices are 16 or 32 bit */\n  readonly indexType?: 'uint16' | 'uint32';\n  /** Length of buffer in bytes */\n  abstract byteLength: number;\n\n  constructor(device: Device, props: BufferProps) {\n    const deducedProps = {...props};\n\n    // Deduce indexType\n    if ((props.usage || 0) & Buffer.INDEX && !props.indexType) {\n      if (props.data instanceof Uint32Array) {\n        deducedProps.indexType = 'uint32';\n      } else if (props.data instanceof Uint16Array) {\n        deducedProps.indexType = 'uint16';\n      }\n    }\n\n    super(device, deducedProps, Buffer.defaultProps);\n\n    this.usage = props.usage || 0;\n    this.indexType = deducedProps.indexType;\n  }\n\n  /** Write data to buffer */\n  abstract write(data: ArrayBufferView, byteOffset?: number): void;\n  /** Read data asynchronoursly */\n  abstract readAsync(byteOffset?: number, byteLength?: number): Promise<Uint8Array>;\n\n  /** Read data synchronously. @note WebGL2 only */\n  readSyncWebGL2(byteOffset?: number, byteLength?: number): Uint8Array  { throw new Error('not implemented'); }\n\n  // PROTECTED METHODS (INTENDED FOR USE BY OTHER FRAMEWORK CODE ONLY)\n\n  /** Max amount of debug data saved. Two vec4's */\n  static DEBUG_DATA_MAX_LENGTH = 32;\n  /** A partial CPU-side copy of the data in this buffer, for debugging purposes */\n  debugData: ArrayBuffer = new ArrayBuffer(0);\n\n  /** This doesn't handle partial non-zero offset updates correctly */\n  protected _setDebugData(data: ArrayBufferView | ArrayBuffer | null, byteOffset: number, byteLength: number): void {\n    const buffer: ArrayBuffer | null = ArrayBuffer.isView(data) ? data.buffer : data;\n    const debugDataLength = Math.min(data ? data.byteLength : byteLength, Buffer.DEBUG_DATA_MAX_LENGTH);\n    if (data === null) {\n      this.debugData = new ArrayBuffer(debugDataLength);\n    } else if (byteOffset === 0 && byteLength === data.byteLength) {\n      this.debugData = buffer.slice(0, debugDataLength);\n    } else {\n      this.debugData = buffer.slice(byteOffset, byteOffset + debugDataLength);\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/adapter/resources/command-buffer.d.ts

@@ -0,0 +1,12 @@
+import { Device } from '../device';
+import { Resource, ResourceProps } from './resource';
+export type CommandBufferProps = ResourceProps & {};
+/**
+ * Encodes commands to queue that can be executed later
+ */
+export declare abstract class CommandBuffer extends Resource<CommandBufferProps> {
+    static defaultProps: Required<CommandBufferProps>;
+    get [Symbol.toStringTag](): string;
+    constructor(device: Device, props: CommandBufferProps);
+}
+//# sourceMappingURL=command-buffer.d.ts.map

package/dist/adapter/resources/command-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-buffer.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/command-buffer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAC,QAAQ,EAAE,aAAa,EAAC,MAAM,YAAY,CAAC;AAiBnD,MAAM,MAAM,kBAAkB,GAAG,aAAa,GAAG,EAChD,CAAC;AAEF;;GAEG;AACH,8BAAsB,aAAc,SAAQ,QAAQ,CAAC,kBAAkB,CAAC;IACtE,OAAgB,YAAY,EAAE,QAAQ,CAAC,kBAAkB,CAAC,CAExD;IAEF,IAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAE1C;gBAEW,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB;CAGtD"}

package/dist/adapter/resources/command-buffer.js

@@ -0,0 +1,15 @@
+let _Symbol$toStringTag;
+import { Resource } from "./resource.js";
+_Symbol$toStringTag = Symbol.toStringTag;
+export class CommandBuffer extends Resource {
+  get [_Symbol$toStringTag]() {
+    return 'CommandBuffer';
+  }
+  constructor(device, props) {
+    super(device, props, CommandBuffer.defaultProps);
+  }
+}
+CommandBuffer.defaultProps = {
+  ...Resource.defaultProps
+};
+//# sourceMappingURL=command-buffer.js.map

package/dist/adapter/resources/command-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-buffer.js","names":["Resource","_Symbol$toStringTag","Symbol","toStringTag","CommandBuffer","constructor","device","props","defaultProps"],"sources":["../../../src/adapter/resources/command-buffer.ts"],"sourcesContent":["// luma.gl, MIT license\nimport { Device } from '../device';\nimport {Resource, ResourceProps} from './resource';\n\n// interface Queue {\n//   submit(commandBuffers);\n\n//   // onSubmittedWorkDone(): Promise<undefined>;\n\n//   writeBuffer(options: WriteBufferOptions): void;\n//   writeTexture(options: WriteTextureOptions): void;\n\n//   // copyExternalImageToTexture(\n//   //   GPUImageCopyExternalImage source,\n//   //   GPUImageCopyTextureTagged destination,\n//   //   GPUExtent3D copySize\n//   // ): void;\n// }\n\nexport type CommandBufferProps = ResourceProps & {\n};\n\n/**\n * Encodes commands to queue that can be executed later\n */\nexport abstract class CommandBuffer extends Resource<CommandBufferProps> {\n  static override defaultProps: Required<CommandBufferProps> = {\n    ...Resource.defaultProps\n  };\n  \n  override get [Symbol.toStringTag](): string {\n    return 'CommandBuffer';\n  }\n\n  constructor(device: Device, props: CommandBufferProps) {\n    super(device, props, CommandBuffer.defaultProps);\n  }\n}\n"],"mappings":";SAEQA,QAAQ;AAAAC,mBAAA,GA4BAC,MAAM,CAACC,WAAW;AALlC,OAAO,MAAeC,aAAa,SAASJ,QAAQ,CAAqB;EAKvE,KAAAC,mBAAA,IAA4C;IAC1C,OAAO,eAAe;EACxB;EAEAI,WAAWA,CAACC,MAAc,EAAEC,KAAyB,EAAE;IACrD,KAAK,CAACD,MAAM,EAAEC,KAAK,EAAEH,aAAa,CAACI,YAAY,CAAC;EAClD;AACF;AAZsBJ,aAAa,CACjBI,YAAY,GAAiC;EAC3D,GAAGR,QAAQ,CAACQ;AACd,CAAC"}