@luma.gl/core 9.0.0-beta.4 → 9.0.0-beta.6

package/dist/adapter/resources/resource.js

@@ -1,101 +1,142 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 import { uid } from "../../utils/utils.js";
+/**
+ * Base class for GPU (WebGPU/WebGL) Resources
+ */
 export class Resource {
-  constructor(device, props, defaultProps) {
-    this.id = void 0;
-    this.props = void 0;
-    this.userData = {};
-    this.device = void 0;
-    this._device = void 0;
-    this.destroyed = false;
-    this.allocatedBytes = 0;
-    this._attachedResources = new Set();
-    if (!device) {
-      throw new Error('no device');
+    /** Default properties for resource */
+    static defaultProps = {
+        id: 'undefined',
+        handle: undefined,
+        userData: undefined
+    };
+    /** props.id, for debugging. */
+    id;
+    props;
+    userData = {};
+    _device;
+    /** Whether this resource has been destroyed */
+    destroyed = false;
+    /** For resources that allocate GPU memory */
+    allocatedBytes = 0;
+    /** Attached resources will be destroyed when this resource is destroyed. Tracks auto-created "sub" resources. */
+    _attachedResources = new Set();
+    /**
+     * Create a new Resource. Called from Subclass
+     */
+    constructor(device, props, defaultProps) {
+        if (!device) {
+            throw new Error('no device');
+        }
+        this._device = device;
+        this.props = selectivelyMerge(props, defaultProps);
+        const id = this.props.id !== 'undefined' ? this.props.id : uid(this[Symbol.toStringTag]);
+        this.props.id = id;
+        this.id = id;
+        this.userData = this.props.userData || {};
+        this.addStats();
     }
-    this._device = device;
-    this.props = selectivelyMerge(props, defaultProps);
-    const id = this.props.id !== 'undefined' ? this.props.id : uid(this[Symbol.toStringTag]);
-    this.props.id = id;
-    this.id = id;
-    this.userData = this.props.userData || {};
-    this.addStats();
-  }
-  destroy() {
-    this.destroyResource();
-  }
-  delete() {
-    this.destroy();
-    return this;
-  }
-  toString() {
-    return `${this[Symbol.toStringTag] || this.constructor.name}(${this.id})`;
-  }
-  getProps() {
-    return this.props;
-  }
-  attachResource(resource) {
-    this._attachedResources.add(resource);
-  }
-  detachResource(resource) {
-    this._attachedResources.delete(resource);
-  }
-  destroyAttachedResource(resource) {
-    if (this._attachedResources.delete(resource)) {
-      resource.destroy();
+    /**
+     * destroy can be called on any resource to release it before it is garbage collected.
+     */
+    destroy() {
+        this.destroyResource();
     }
-  }
-  destroyAttachedResources() {
-    for (const resource of Object.values(this._attachedResources)) {
-      resource.destroy();
+    /** @deprecated Use destroy() */
+    delete() {
+        this.destroy();
+        return this;
+    }
+    toString() {
+        return `${this[Symbol.toStringTag] || this.constructor.name}(${this.id})`;
+    }
+    /**
+     * Combines a map of user props and default props, only including props from defaultProps
+     * @returns returns a map of overridden default props
+     */
+    getProps() {
+        return this.props;
+    }
+    // ATTACHED RESOURCES
+    /**
+     * Attaches a resource. Attached resources are auto destroyed when this resource is destroyed
+     * Called automatically when sub resources are auto created but can be called by application
+     */
+    attachResource(resource) {
+        this._attachedResources.add(resource);
+    }
+    /**
+     * Detach an attached resource. The resource will no longer be auto-destroyed when this resource is destroyed.
+     */
+    detachResource(resource) {
+        this._attachedResources.delete(resource);
+    }
+    /**
+     * Destroys a resource (only if owned), and removes from the owned (auto-destroy) list for this resource.
+     */
+    destroyAttachedResource(resource) {
+        if (this._attachedResources.delete(resource)) {
+            resource.destroy();
+        }
+    }
+    /** Destroy all owned resources. Make sure the resources are no longer needed before calling. */
+    destroyAttachedResources() {
+        for (const resource of Object.values(this._attachedResources)) {
+            resource.destroy();
+        }
+        // don't remove while we are iterating
+        this._attachedResources = new Set();
+    }
+    // PROTECTED METHODS
+    /** Perform all destroy steps. Can be called by derived resources when overriding destroy() */
+    destroyResource() {
+        this.destroyAttachedResources();
+        this.removeStats();
+        this.destroyed = true;
+    }
+    /** Called by .destroy() to track object destruction. Subclass must call if overriding destroy() */
+    removeStats() {
+        const stats = this._device.statsManager.getStats('Resource Counts');
+        const name = this[Symbol.toStringTag];
+        stats.get(`${name}s Active`).decrementCount();
+    }
+    /** Called by subclass to track memory allocations */
+    trackAllocatedMemory(bytes, name = this[Symbol.toStringTag]) {
+        const stats = this._device.statsManager.getStats('Resource Counts');
+        stats.get('GPU Memory').addCount(bytes);
+        stats.get(`${name} Memory`).addCount(bytes);
+        this.allocatedBytes = bytes;
+    }
+    /** Called by subclass to track memory deallocations */
+    trackDeallocatedMemory(name = this[Symbol.toStringTag]) {
+        const stats = this._device.statsManager.getStats('Resource Counts');
+        stats.get('GPU Memory').subtractCount(this.allocatedBytes);
+        stats.get(`${name} Memory`).subtractCount(this.allocatedBytes);
+        this.allocatedBytes = 0;
+    }
+    /** Called by resource constructor to track object creation */
+    addStats() {
+        const stats = this._device.statsManager.getStats('Resource Counts');
+        const name = this[Symbol.toStringTag];
+        stats.get('Resources Created').incrementCount();
+        stats.get(`${name}s Created`).incrementCount();
+        stats.get(`${name}s Active`).incrementCount();
     }
-    this._attachedResources = new Set();
-  }
-  destroyResource() {
-    this.destroyAttachedResources();
-    this.removeStats();
-    this.destroyed = true;
-  }
-  removeStats() {
-    const stats = this._device.statsManager.getStats('Resource Counts');
-    const name = this[Symbol.toStringTag];
-    stats.get(`${name}s Active`).decrementCount();
-  }
-  trackAllocatedMemory(bytes) {
-    let name = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : this[Symbol.toStringTag];
-    const stats = this._device.statsManager.getStats('Resource Counts');
-    stats.get('GPU Memory').addCount(bytes);
-    stats.get(`${name} Memory`).addCount(bytes);
-    this.allocatedBytes = bytes;
-  }
-  trackDeallocatedMemory() {
-    let name = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this[Symbol.toStringTag];
-    const stats = this._device.statsManager.getStats('Resource Counts');
-    stats.get('GPU Memory').subtractCount(this.allocatedBytes);
-    stats.get(`${name} Memory`).subtractCount(this.allocatedBytes);
-    this.allocatedBytes = 0;
-  }
-  addStats() {
-    const stats = this._device.statsManager.getStats('Resource Counts');
-    const name = this[Symbol.toStringTag];
-    stats.get('Resources Created').incrementCount();
-    stats.get(`${name}s Created`).incrementCount();
-    stats.get(`${name}s Active`).incrementCount();
-  }
 }
-Resource.defaultProps = {
-  id: 'undefined',
-  handle: undefined,
-  userData: undefined
-};
+/**
+ * Combines a map of user props and default props, only including props from defaultProps
+ * @param props
+ * @param defaultProps
+ * @returns returns a map of overridden default props
+ */
 function selectivelyMerge(props, defaultProps) {
-  const mergedProps = {
-    ...defaultProps
-  };
-  for (const key in props) {
-    if (props[key] !== undefined) {
-      mergedProps[key] = props[key];
+    const mergedProps = { ...defaultProps };
+    for (const key in props) {
+        if (props[key] !== undefined) {
+            mergedProps[key] = props[key];
+        }
     }
-  }
-  return mergedProps;
+    return mergedProps;
 }
-//# sourceMappingURL=resource.js.map

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

@@ -1,6 +1,6 @@
-import type { Device } from '../device';
-import { CompareFunction } from '../types/parameters';
-import { Resource, ResourceProps } from './resource';
+import type { Device } from "../device.js";
+import { CompareFunction } from "../types/parameters.js";
+import { Resource, ResourceProps } from "./resource.js";
 /** Edge values sampling mode */
 export type SamplerAddressMode = 'clamp-to-edge' | 'repeat' | 'mirror-repeat';
 /** Sampler filtering mode */

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

@@ -1 +1 @@
-{"version":3,"file":"sampler.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/sampler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,WAAW,CAAC;AACtC,OAAO,EAAC,eAAe,EAAC,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAC,QAAQ,EAAE,aAAa,EAAC,MAAM,YAAY,CAAC;AAEnD,gCAAgC;AAChC,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,QAAQ,GAAG,eAAe,CAAC;AAE9E,6BAA6B;AAC7B,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG;IACzC,iGAAiG;IACjG,IAAI,CAAC,EAAE,eAAe,GAAG,oBAAoB,CAAC;IAC9C,yCAAyC;IACzC,YAAY,CAAC,EAAE,eAAe,GAAG,QAAQ,GAAG,eAAe,CAAC;IAC5D,yCAAyC;IACzC,YAAY,CAAC,EAAE,eAAe,GAAG,QAAQ,GAAG,eAAe,CAAC;IAC5D,yCAAyC;IACzC,YAAY,CAAC,EAAE,eAAe,GAAG,QAAQ,GAAG,eAAe,CAAC;IAE5D,uFAAuF;IACvF,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACjC,qFAAqF;IACrF,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACjC,iHAAiH;IACjH,YAAY,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACpC,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8FAA8F;IAC9F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iHAAiH;IACjH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,aAAa,CAAC,CAAC;AAExE,+BAA+B;AAC/B,8BAAsB,OAAQ,SAAQ,QAAQ,CAAC,YAAY,CAAC;IAC1D,OAAgB,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,CAalD;IAEF,IAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAE1C;gBAEW,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY;CAGhD"}
+{"version":3,"file":"sampler.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/sampler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,MAAM,EAAC,qBAAkB;AACtC,OAAO,EAAC,eAAe,EAAC,+BAA4B;AACpD,OAAO,EAAC,QAAQ,EAAE,aAAa,EAAC,sBAAmB;AAEnD,gCAAgC;AAChC,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,QAAQ,GAAG,eAAe,CAAC;AAE9E,6BAA6B;AAC7B,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG;IACzC,iGAAiG;IACjG,IAAI,CAAC,EAAE,eAAe,GAAG,oBAAoB,CAAC;IAC9C,yCAAyC;IACzC,YAAY,CAAC,EAAE,eAAe,GAAG,QAAQ,GAAG,eAAe,CAAC;IAC5D,yCAAyC;IACzC,YAAY,CAAC,EAAE,eAAe,GAAG,QAAQ,GAAG,eAAe,CAAC;IAC5D,yCAAyC;IACzC,YAAY,CAAC,EAAE,eAAe,GAAG,QAAQ,GAAG,eAAe,CAAC;IAE5D,uFAAuF;IACvF,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACjC,qFAAqF;IACrF,SAAS,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACjC,iHAAiH;IACjH,YAAY,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACpC,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8FAA8F;IAC9F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iHAAiH;IACjH,OAAO,CAAC,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,aAAa,CAAC,CAAC;AAExE,+BAA+B;AAC/B,8BAAsB,OAAQ,SAAQ,QAAQ,CAAC,YAAY,CAAC;IAC1D,OAAgB,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,CAalD;IAEF,IAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAE1C;gBAEW,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY;CAGhD"}

package/dist/adapter/resources/sampler.js

@@ -1,26 +1,27 @@
-let _Symbol$toStringTag;
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 import { Resource } from "./resource.js";
-_Symbol$toStringTag = Symbol.toStringTag;
+/** Immutable Sampler object */
 export class Sampler extends Resource {
-  get [_Symbol$toStringTag]() {
-    return 'Sampler';
-  }
-  constructor(device, props) {
-    super(device, props, Sampler.defaultProps);
-  }
+    static defaultProps = {
+        ...Resource.defaultProps,
+        type: 'color-sampler',
+        addressModeU: 'clamp-to-edge',
+        addressModeV: 'clamp-to-edge',
+        addressModeW: 'clamp-to-edge',
+        magFilter: 'nearest',
+        minFilter: 'nearest',
+        mipmapFilter: 'nearest',
+        lodMinClamp: 0,
+        lodMaxClamp: 32, // Per WebGPU spec
+        compare: 'less-equal',
+        maxAnisotropy: 1
+    };
+    get [Symbol.toStringTag]() {
+        return 'Sampler';
+    }
+    constructor(device, props) {
+        super(device, props, Sampler.defaultProps);
+    }
 }
-Sampler.defaultProps = {
-  ...Resource.defaultProps,
-  type: 'color-sampler',
-  addressModeU: 'clamp-to-edge',
-  addressModeV: 'clamp-to-edge',
-  addressModeW: 'clamp-to-edge',
-  magFilter: 'nearest',
-  minFilter: 'nearest',
-  mipmapFilter: 'nearest',
-  lodMinClamp: 0,
-  lodMaxClamp: 32,
-  compare: 'less-equal',
-  maxAnisotropy: 1
-};
-//# sourceMappingURL=sampler.js.map

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

@@ -1,6 +1,6 @@
-import type { Device } from '../device';
-import { Resource, ResourceProps } from './resource';
-import { CompilerMessage } from '../../lib/compiler-log/compiler-message';
+import type { Device } from "../device.js";
+import { Resource, ResourceProps } from "./resource.js";
+import { CompilerMessage } from "../../lib/compiler-log/compiler-message.js";
 /**
  * Properties for a Shader
  */
@@ -29,16 +29,18 @@ export declare abstract class Shader extends Resource<ShaderProps> {
     readonly stage: 'vertex' | 'fragment' | 'compute';
     /** The source code of this shader */
     readonly source: string;
-    /** The compilation status of this shader. May be 'pending' if compilation is done asynchronously */
-    compilationStatus: 'success' | 'error' | 'pending';
+    /** The compilation status of the shader. 'pending' if compilation is asynchronous, and on production */
+    compilationStatus: 'pending' | 'success' | 'error';
     /** Create a new Shader instance */
     constructor(device: Device, props: ShaderProps);
     /** Get compiler log asynchronously */
     abstract getCompilationInfo(): Promise<readonly CompilerMessage[]>;
     /** Get compiler log synchronously (WebGL only) */
     getCompilationInfoSync(): readonly CompilerMessage[] | null;
+    /** Get translated shader source in host platform's native language (HLSL, GLSL, and even GLSL ES), if available */
+    getTranslatedSource(): string | null;
     /** In browser logging of errors */
-    debugShader(): Promise<void>;
+    debugShader(trigger?: "never" | "errors" | "warnings" | "always"): Promise<void>;
     /** In-browser UI logging of errors */
     protected _displayShaderLog(messages: readonly CompilerMessage[]): void;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"shader.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/shader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,WAAW,CAAC;AACtC,OAAO,EAAC,QAAQ,EAAE,aAAa,EAAC,MAAM,YAAY,CAAC;AAGnD,OAAO,EAAC,eAAe,EAAC,MAAM,yCAAyC,CAAC;AAIxE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG;IACxC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,0EAA0E;IAC1E,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACzC,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;CACpD,CAAC;AAEF;;;GAGG;AACH,8BAAsB,MAAO,SAAQ,QAAQ,CAAC,WAAW,CAAC;IACxD,OAAgB,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,CAQjD;IAEF,IAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAE1C;IAED,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAClD,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oGAAoG;IACpG,iBAAiB,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAa;IAE/D,mCAAmC;gBACvB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IAM9C,sCAAsC;IACtC,QAAQ,CAAC,kBAAkB,IAAI,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAElE,kDAAkD;IAClD,sBAAsB,IAAI,SAAS,eAAe,EAAE,GAAG,IAAI;IAM3D,mCAAmC;IAC7B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBlC,sCAAsC;IACtC,SAAS,CAAC,iBAAiB,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI;CAuCxE"}
+{"version":3,"file":"shader.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/shader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,MAAM,EAAC,qBAAkB;AACtC,OAAO,EAAC,QAAQ,EAAE,aAAa,EAAC,sBAAmB;AAGnD,OAAO,EAAC,eAAe,EAAC,mDAAgD;AAIxE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG;IACxC,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,0EAA0E;IAC1E,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IACzC,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gDAAgD;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;CACpD,CAAC;AAEF;;;GAGG;AACH,8BAAsB,MAAO,SAAQ,QAAQ,CAAC,WAAW,CAAC;IACxD,OAAgB,YAAY,EAAE,QAAQ,CAAC,WAAW,CAAC,CAQjD;IAEF,IAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAE1C;IAED,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAClD,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wGAAwG;IACxG,iBAAiB,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAa;IAE/D,mCAAmC;gBACvB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IAM9C,sCAAsC;IACtC,QAAQ,CAAC,kBAAkB,IAAI,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;IAElE,kDAAkD;IAClD,sBAAsB,IAAI,SAAS,eAAe,EAAE,GAAG,IAAI;IAI3D,mHAAmH;IACnH,mBAAmB,IAAI,MAAM,GAAG,IAAI;IAMpC,mCAAmC;IAC7B,WAAW,CAAC,OAAO,6CAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwB5D,sCAAsC;IACtC,SAAS,CAAC,iBAAiB,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,IAAI;CA2CxE"}

package/dist/adapter/resources/shader.js

@@ -1,90 +1,114 @@
-let _Symbol$toStringTag;
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
 import { Resource } from "./resource.js";
+// import { log } from '../../utils/log';
 import { uid } from "../../utils/utils.js";
 import { formatCompilerLog } from "../../lib/compiler-log/format-compiler-log.js";
 import { getShaderInfo } from "../../lib/compiler-log/get-shader-info.js";
-_Symbol$toStringTag = Symbol.toStringTag;
+/**
+ * Immutable Shader object
+ * In WebGPU the handle can be copied between threads
+ */
 export class Shader extends Resource {
-  get [_Symbol$toStringTag]() {
-    return 'Shader';
-  }
-  constructor(device, props) {
-    super(device, {
-      id: getShaderIdFromProps(props),
-      ...props
-    }, Shader.defaultProps);
-    this.stage = void 0;
-    this.source = void 0;
-    this.compilationStatus = 'pending';
-    this.stage = this.props.stage;
-    this.source = this.props.source;
-  }
-  getCompilationInfoSync() {
-    return null;
-  }
-  async debugShader() {
-    switch (this.props.debug) {
-      case 'never':
-        return;
-      case 'errors':
-        if (this.compilationStatus === 'success') {
-          return;
-        }
-        break;
-      case 'warnings':
-      case 'always':
-        break;
+    static defaultProps = {
+        ...Resource.defaultProps,
+        language: 'auto',
+        stage: 'vertex',
+        source: '',
+        sourceMap: null,
+        entryPoint: 'main',
+        debug: 'errors'
+    };
+    get [Symbol.toStringTag]() {
+        return 'Shader';
+    }
+    /** The stage of this shader */
+    stage;
+    /** The source code of this shader */
+    source;
+    /** The compilation status of the shader. 'pending' if compilation is asynchronous, and on production */
+    compilationStatus = 'pending';
+    /** Create a new Shader instance */
+    constructor(device, props) {
+        super(device, { id: getShaderIdFromProps(props), ...props }, Shader.defaultProps);
+        this.stage = this.props.stage;
+        this.source = this.props.source;
     }
-    const messages = await this.getCompilationInfo();
-    if (this.props.debug === 'warnings' && (messages === null || messages === void 0 ? void 0 : messages.length) === 0) {
-      return;
+    /** Get compiler log synchronously (WebGL only) */
+    getCompilationInfoSync() {
+        return null;
     }
-    this._displayShaderLog(messages);
-  }
-  _displayShaderLog(messages) {
-    var _document, _errors$;
-    if (typeof document === 'undefined' || !((_document = document) !== null && _document !== void 0 && _document.createElement)) {
-      return;
+    /** Get translated shader source in host platform's native language (HLSL, GLSL, and even GLSL ES), if available */
+    getTranslatedSource() {
+        return null;
+    }
+    // PORTABLE HELPERS
+    /** In browser logging of errors */
+    async debugShader(trigger = this.props.debug) {
+        switch (trigger) {
+            case 'never':
+                return;
+            case 'errors':
+                // On WebGL - Don't extract the log unless errors
+                if (this.compilationStatus === 'success') {
+                    return;
+                }
+                break;
+            case 'warnings':
+            case 'always':
+                break;
+        }
+        const messages = await this.getCompilationInfo();
+        if (this.props.debug === 'warnings' && messages?.length === 0) {
+            return;
+        }
+        this._displayShaderLog(messages);
     }
-    const shaderName = getShaderInfo(this.source).name;
-    const shaderTitle = `${this.stage} ${shaderName}`;
-    const htmlLog = formatCompilerLog(messages, this.source, {
-      showSourceCode: 'all',
-      html: true
-    });
-    const button = document.createElement('Button');
-    button.innerHTML = `
+    // PRIVATE
+    /** In-browser UI logging of errors */
+    _displayShaderLog(messages) {
+        // Return if under Node.js / incomplete `document` polyfills
+        if (typeof document === 'undefined' || !document?.createElement) {
+            return;
+        }
+        const shaderName = getShaderInfo(this.source).name;
+        const shaderTitle = `${this.stage} ${shaderName}`;
+        let htmlLog = formatCompilerLog(messages, this.source, { showSourceCode: 'all', html: true });
+        // Show translated source if available
+        const translatedSource = this.getTranslatedSource();
+        if (translatedSource) {
+            htmlLog += `<br /><br /><h1>Translated Source</h1><br /><br /><code style="user-select:text;"><pre>${translatedSource}</pre></code>`;
+        }
+        // Make it clickable so we can copy to clipboard
+        const button = document.createElement('Button');
+        button.innerHTML = `
 <h1>Shader Compilation Error in ${shaderTitle}</h1><br /><br />
 <code style="user-select:text;"><pre>
 ${htmlLog}
 </pre></code>`;
-    button.style.top = '10px';
-    button.style.left = '10px';
-    button.style.position = 'absolute';
-    button.style.zIndex = '9999';
-    button.style.width = '100%';
-    button.style.textAlign = 'left';
-    document.body.appendChild(button);
-    const errors = document.getElementsByClassName('luma-compiler-log-error');
-    if ((_errors$ = errors[0]) !== null && _errors$ !== void 0 && _errors$.scrollIntoView) {
-      errors[0].scrollIntoView();
+        button.style.top = '10px';
+        button.style.left = '10px';
+        button.style.position = 'absolute';
+        button.style.zIndex = '9999';
+        button.style.width = '100%';
+        button.style.textAlign = 'left';
+        document.body.appendChild(button);
+        const errors = document.getElementsByClassName('luma-compiler-log-error');
+        if (errors[0]?.scrollIntoView) {
+            errors[0].scrollIntoView();
+        }
+        // TODO - add a small embedded copy button (instead of main button)
+        button.onclick = () => {
+            // const source = this.source.replaceAll('\n', '<br />');
+            const dataURI = `data:text/plain,${encodeURIComponent(this.source)}`;
+            navigator.clipboard.writeText(dataURI);
+        };
+        // TODO - add a small embedded close button
     }
-    button.onclick = () => {
-      const dataURI = `data:text/plain,${encodeURIComponent(this.source)}`;
-      navigator.clipboard.writeText(dataURI);
-    };
-  }
 }
-Shader.defaultProps = {
-  ...Resource.defaultProps,
-  language: 'auto',
-  stage: 'vertex',
-  source: '',
-  sourceMap: null,
-  entryPoint: 'main',
-  debug: 'errors'
-};
+// HELPERS
+/** Deduce an id, from shader source, or supplied id, or shader type */
 function getShaderIdFromProps(props) {
-  return getShaderInfo(props.source).name || props.id || uid(`unnamed ${props.stage}-shader`);
+    return getShaderInfo(props.source).name || props.id || uid(`unnamed ${props.stage}-shader`);
 }
-//# sourceMappingURL=shader.js.map

package/dist/adapter/resources/texture-view.d.ts

@@ -0,0 +1,32 @@
+import type { Device } from "../device.js";
+import type { Texture } from "./texture.js";
+import type { TextureFormat } from "../types/texture-formats.js";
+import { Resource, ResourceProps } from "./resource.js";
+/** Properties for initializing a texture view */
+export type TextureViewProps = ResourceProps & {
+    /** The format of the texture view. Must be either the format of the texture or one of the viewFormats specified during its creation. */
+    format?: TextureFormat;
+    /** The dimension to view the texture as. */
+    dimension?: '1d' | '2d' | '2d-array' | 'cube' | 'cube-array' | '3d';
+    /** Which aspect(s) of the texture are accessible to the texture view. default "all"*/
+    aspect?: 'all' | 'stencil-only' | 'depth-only';
+    /** The first (most detailed) mipmap level accessible to the texture view.  default 0*/
+    baseMipLevel?: number;
+    /** How many mipmap levels, starting with baseMipLevel, are accessible to the texture view. */
+    mipLevelCount: number;
+    /** The index of the first array layer accessible to the texture view. default 0 */
+    baseArrayLayer?: number;
+    /** How many array layers, starting with baseArrayLayer, are accessible to the texture view. */
+    arrayLayerCount: number;
+};
+/** Immutable TextureView object */
+export declare abstract class TextureView extends Resource<TextureViewProps> {
+    static defaultProps: Required<TextureViewProps>;
+    abstract texture: Texture;
+    get [Symbol.toStringTag](): string;
+    /** Should not be constructed directly. Use `texture.createView(props)` */
+    constructor(device: Device, props: TextureViewProps & {
+        texture: Texture;
+    });
+}
+//# sourceMappingURL=texture-view.d.ts.map

package/dist/adapter/resources/texture-view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture-view.d.ts","sourceRoot":"","sources":["../../../src/adapter/resources/texture-view.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,MAAM,EAAC,qBAAkB;AACtC,OAAO,KAAK,EAAC,OAAO,EAAC,qBAAkB;AACvC,OAAO,KAAK,EAAC,aAAa,EAAC,oCAAiC;AAC5D,OAAO,EAAC,QAAQ,EAAE,aAAa,EAAC,sBAAmB;AAEnD,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG;IAC7C,wIAAwI;IACxI,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,IAAI,CAAC;IACpE,sFAAsF;IACtF,MAAM,CAAC,EAAE,KAAK,GAAG,cAAc,GAAG,YAAY,CAAC;IAC/C,uFAAuF;IACvF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,aAAa,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+FAA+F;IAC/F,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,mCAAmC;AACnC,8BAAsB,WAAY,SAAQ,QAAQ,CAAC,gBAAgB,CAAC;IAClE,OAAgB,YAAY,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAStD;IAEF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,IAAa,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAE1C;IAED,0EAA0E;gBAC9D,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG;QAAC,OAAO,EAAE,OAAO,CAAA;KAAC;CAGzE"}

package/dist/adapter/resources/texture-view.js

@@ -0,0 +1,24 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { Resource } from "./resource.js";
+/** Immutable TextureView object */
+export class TextureView extends Resource {
+    static defaultProps = {
+        ...Resource.defaultProps,
+        format: undefined,
+        dimension: undefined,
+        aspect: 'all',
+        baseMipLevel: 0,
+        mipLevelCount: undefined,
+        baseArrayLayer: 0,
+        arrayLayerCount: undefined
+    };
+    get [Symbol.toStringTag]() {
+        return 'TextureView';
+    }
+    /** Should not be constructed directly. Use `texture.createView(props)` */
+    constructor(device, props) {
+        super(device, props, TextureView.defaultProps);
+    }
+}

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

@@ -1,9 +1,10 @@
 /// <reference types="node" />
-import type { Device } from '../device';
-import type { TypedArray } from '../../types';
-import type { TextureFormat } from '../types/texture-formats';
-import { Resource, ResourceProps } from './resource';
-import { Sampler, SamplerProps } from './sampler';
+import type { Device } from "../device.js";
+import type { TypedArray } from "../../types.js";
+import type { TextureFormat } from "../types/texture-formats.js";
+import { Resource, ResourceProps } from "./resource.js";
+import { Sampler, SamplerProps } from "./sampler.js";
+import { TextureView, TextureViewProps } from "./texture-view.js";
 /** Data types that can be used to initialize textures */
 export type TextureData = TypedArray | ArrayBuffer | Buffer | ImageBitmap | HTMLImageElement;
 export type CubeTextureData = Record<string, TextureData> | Record<string, Promise<TextureData>>;
@@ -18,11 +19,12 @@ export type TextureProps = ResourceProps & {
     usage?: number;
     data?: TextureData | Promise<TextureData> | CubeTextureData | string | HTMLVideoElement | null;
     mipmaps?: boolean;
-    sampler?: Sampler | SamplerProps;
     mipLevels?: number;
     samples?: number;
     type?: number;
     compressed?: boolean;
+    sampler?: Sampler | SamplerProps;
+    view?: TextureViewProps;
 };
 export type WebGPUTextureProps = ResourceProps & {
     width: number;
@@ -31,15 +33,6 @@ export type WebGPUTextureProps = ResourceProps & {
     mipLevels?: number;
     format?: string;
 };
-export type TextureViewProps = {
-    format: string;
-    dimension: '1d' | '2d' | '2d-array' | 'cube' | 'cube-array' | '3d';
-    aspect?: 'all' | 'stencil-only' | 'depth-only';
-    arrayLayerCount: number;
-    baseArrayLayer?: number;
-    mipLevels?: number;
-    baseMipLevel?: number;
-};
 /**
  * @deprecated
  * @todo remove, are these even used anymore?
@@ -85,6 +78,8 @@ export declare abstract class Texture<Props extends TextureProps = TextureProps>
     readonly depth: number;
     /** Default sampler for this texture */
     abstract sampler: Sampler;
+    /** Default view for this texture */
+    abstract view: TextureView;
     constructor(device: Device, props: Props, defaultProps?: Required<Props>);
 }
 //# sourceMappingURL=texture.d.ts.map