TSL: Add texture_depth_multisampled_2d for wgslFn

src-testing/changes.patch

@@ -458,17 +458,17 @@ index 4841d46c..d69010bc 100644
          textureNode.levelNode = nodeObject(levelNode);
          textureNode.referenceNode = this.getSelf();
 diff --git a/src-testing/src/nodes/code/CodeNode.ts b/src-testing/src/nodes/code/CodeNode.ts
-index 140e564d..c01f9349 100644
+index 04762469..c62335d9 100644
 --- a/src-testing/src/nodes/code/CodeNode.ts
 +++ b/src-testing/src/nodes/code/CodeNode.ts
 @@ -1,5 +1,6 @@
  import Node from '../core/Node.js';
  import { nodeProxy } from '../tsl/TSLBase.js';
 +import NodeBuilder from '../core/NodeBuilder.js';
 
- /**
-  * This class represents native code sections. It is the base
-@@ -13,6 +14,11 @@ class CodeNode extends Node {
+ /** @module CodeNode **/
+
+@@ -15,6 +16,11 @@ class CodeNode extends Node {
          return 'CodeNode';
      }
 
@@ -480,7 +480,7 @@ index 140e564d..c01f9349 100644
      /**
       * Constructs a new code node.
       *
-@@ -84,11 +90,11 @@ class CodeNode extends Node {
+@@ -86,11 +92,11 @@ class CodeNode extends Node {
       * @param {NodeBuilder} builder - The current node builder.
       * @return {Array<Node>} The includes.
       */
@@ -559,7 +559,7 @@ index 75c17de0..dcea81cc 100644
 +export const glslFn = (code: string, includes) => nativeFn(code, includes, 'glsl');
 +export const wgslFn = (code: string, includes) => nativeFn(code, includes, 'wgsl');
 diff --git a/src-testing/src/nodes/core/ContextNode.ts b/src-testing/src/nodes/core/ContextNode.ts
-index dd4b5cba..5a997eef 100644
+index c7f478be..9bc47f27 100644
 --- a/src-testing/src/nodes/core/ContextNode.ts
 +++ b/src-testing/src/nodes/core/ContextNode.ts
 @@ -1,5 +1,6 @@
@@ -568,9 +568,9 @@ index dd4b5cba..5a997eef 100644
 +import { addMethodChaining, nodeProxy, NodeRepresentation } from '../tsl/TSLCore.js';
 +import NodeBuilder from './NodeBuilder.js';
 
- /**
-  * This node can be used as a context management component for another node.
-@@ -11,18 +12,23 @@ import { addMethodChaining, nodeProxy } from '../tsl/TSLCore.js';
+ /** @module ContextNode **/
+
+@@ -13,18 +14,23 @@ import { addMethodChaining, nodeProxy } from '../tsl/TSLCore.js';
   *```
   * @augments Node
   */
@@ -596,7 +596,7 @@ index dd4b5cba..5a997eef 100644
          super();
 
          /**
-@@ -65,15 +71,15 @@ class ContextNode extends Node {
+@@ -67,15 +73,15 @@ class ContextNode extends Node {
       * @param {NodeBuilder} builder - The current node builder.
       * @return {String} The type of {@link ContextNode#node}.
       */
@@ -615,7 +615,7 @@ index dd4b5cba..5a997eef 100644
          const previousContext = builder.getContext();
 
          builder.setContext({ ...builder.context, ...this.value });
-@@ -85,7 +91,7 @@ class ContextNode extends Node {
+@@ -87,7 +93,7 @@ class ContextNode extends Node {
          return node;
      }
 
@@ -624,10 +624,10 @@ index dd4b5cba..5a997eef 100644
          const previousContext = builder.getContext();
 
          builder.setContext({ ...builder.context, ...this.value });
-@@ -101,7 +107,7 @@ class ContextNode extends Node {
- export default ContextNode;
-
- export const context = /*@__PURE__*/ nodeProxy(ContextNode);
+@@ -120,7 +126,7 @@ export const context = /*@__PURE__*/ nodeProxy(ContextNode);
+  * @param {String} name - The name/label to set.
+  * @returns {ContextNode}
+  */
 -export const label = (node, name) => context(node, { label: name });
 +export const label = (node: NodeRepresentation, name: string) => context(node, { label: name });
 
@@ -2669,7 +2669,7 @@ index 8a291b92..39c864a4 100644
 
          /**
 diff --git a/src-testing/src/nodes/core/StackNode.ts b/src-testing/src/nodes/core/StackNode.ts
-index e0c3d103..6152b031 100644
+index 7da88417..01d12e80 100644
 --- a/src-testing/src/nodes/core/StackNode.ts
 +++ b/src-testing/src/nodes/core/StackNode.ts
 @@ -1,6 +1,7 @@
@@ -2679,9 +2679,9 @@ index e0c3d103..6152b031 100644
 +import { ShaderNode, nodeProxy, getCurrentStack, setCurrentStack, ShaderNodeObject } from '../tsl/TSLBase.js';
 +import NodeBuilder from './NodeBuilder.js';
 
- /**
-  * Stack is a helper for Nodes that need to produce stack-based code instead of continuous flow.
-@@ -13,6 +14,15 @@ class StackNode extends Node {
+ /** @module StackNode **/
+
+@@ -15,6 +16,15 @@ class StackNode extends Node {
          return 'StackNode';
      }
 
@@ -2697,7 +2697,7 @@ index e0c3d103..6152b031 100644
      /**
       * Constructs a new stack node.
       *
-@@ -63,7 +73,7 @@ class StackNode extends Node {
+@@ -65,7 +75,7 @@ class StackNode extends Node {
          this.isStackNode = true;
      }
 
@@ -2706,7 +2706,7 @@ index e0c3d103..6152b031 100644
          return this.outputNode ? this.outputNode.getNodeType(builder) : 'void';
      }
 
-@@ -73,7 +83,7 @@ class StackNode extends Node {
+@@ -75,7 +85,7 @@ class StackNode extends Node {
       * @param {Node} node - The node to add.
       * @return {StackNode} A reference to this stack node.
       */
@@ -2715,7 +2715,7 @@ index e0c3d103..6152b031 100644
          this.nodes.push(node);
 
          return this;
-@@ -86,7 +96,7 @@ class StackNode extends Node {
+@@ -88,7 +98,7 @@ class StackNode extends Node {
       * @param {Function} method - TSL code which is executed if the condition evaluates to `true`.
       * @return {StackNode} A reference to this stack node.
       */
@@ -2724,7 +2724,7 @@ index e0c3d103..6152b031 100644
          const methodNode = new ShaderNode(method);
          this._currentCond = select(boolNode, methodNode);
 
-@@ -100,7 +110,7 @@ class StackNode extends Node {
+@@ -102,7 +112,7 @@ class StackNode extends Node {
       * @param {Function} method - TSL code which is executed if the condition evaluates to `true`.
       * @return {StackNode} A reference to this stack node.
       */
@@ -2733,7 +2733,7 @@ index e0c3d103..6152b031 100644
          const methodNode = new ShaderNode(method);
          const ifNode = select(boolNode, methodNode);
 
-@@ -116,13 +126,13 @@ class StackNode extends Node {
+@@ -118,13 +128,13 @@ class StackNode extends Node {
       * @param {Function} method - TSL code which is executed in the `else` case.
       * @return {StackNode} A reference to this stack node.
       */
@@ -2773,16 +2773,16 @@ index d698c2fb..90dc52b0 100644
 
          /**
 diff --git a/src-testing/src/nodes/core/UniformGroupNode.ts b/src-testing/src/nodes/core/UniformGroupNode.ts
-index 3c7fc425..e6677c50 100644
+index 2efc188e..8fe0929f 100644
 --- a/src-testing/src/nodes/core/UniformGroupNode.ts
 +++ b/src-testing/src/nodes/core/UniformGroupNode.ts
 @@ -1,4 +1,4 @@
 -import Node from './Node.js';
 +import Node, { NodeJSONInputData, NodeJSONIntermediateOutputData } from './Node.js';
 
- /**
-  * This node can be used to group single instances of {@link UniformNode}
-@@ -18,6 +18,10 @@ class UniformGroupNode extends Node {
+ /** @module UniformGroupNode **/
+
+@@ -20,6 +20,10 @@ class UniformGroupNode extends Node {
          return 'UniformGroupNode';
      }
 
@@ -2793,7 +2793,7 @@ index 3c7fc425..e6677c50 100644
      /**
       * Constructs a new uniform group node.
       *
-@@ -62,7 +66,7 @@ class UniformGroupNode extends Node {
+@@ -64,7 +68,7 @@ class UniformGroupNode extends Node {
          this.isUniformGroup = true;
      }
 
@@ -2802,7 +2802,7 @@ index 3c7fc425..e6677c50 100644
          super.serialize(data);
 
          data.name = this.name;
-@@ -70,7 +74,7 @@ class UniformGroupNode extends Node {
+@@ -72,7 +76,7 @@ class UniformGroupNode extends Node {
          data.shared = this.shared;
      }
 
@@ -2812,10 +2812,10 @@ index 3c7fc425..e6677c50 100644
 
          this.name = data.name;
 diff --git a/src-testing/src/nodes/core/UniformNode.ts b/src-testing/src/nodes/core/UniformNode.ts
-index c85b4aae..7f3d18cc 100644
+index c086bae5..ce0f8a5c 100644
 --- a/src-testing/src/nodes/core/UniformNode.ts
 +++ b/src-testing/src/nodes/core/UniformNode.ts
-@@ -1,24 +1,33 @@
+@@ -1,6 +1,10 @@
  import InputNode from './InputNode.js';
 -import { objectGroup } from './UniformGroupNode.js';
 +import UniformGroupNode, { objectGroup } from './UniformGroupNode.js';
@@ -2825,8 +2825,9 @@ index c85b4aae..7f3d18cc 100644
 +import NodeFrame from './NodeFrame.js';
 +import { NodeUpdateType } from './constants.js';
 
- /**
-  * Class for representing a uniform.
+ /** @module UniformNode **/
+
+@@ -9,18 +13,23 @@ import { nodeObject, getConstNodeType } from '../tsl/TSLCore.js';
   *
   * @augments InputNode
   */
@@ -2852,7 +2853,7 @@ index c85b4aae..7f3d18cc 100644
          super(value, nodeType);
 
          /**
-@@ -54,7 +63,7 @@ class UniformNode extends InputNode {
+@@ -56,7 +65,7 @@ class UniformNode extends InputNode {
       * @param {String} name - The name of the uniform.
       * @return {UniformNode} A reference to this node.
       */
@@ -2861,7 +2862,7 @@ index c85b4aae..7f3d18cc 100644
          this.name = name;
 
          return this;
-@@ -66,7 +75,7 @@ class UniformNode extends InputNode {
+@@ -68,7 +77,7 @@ class UniformNode extends InputNode {
       * @param {UniformGroupNode} group - The uniform group.
       * @return {UniformNode} A reference to this node.
       */
@@ -2870,7 +2871,7 @@ index c85b4aae..7f3d18cc 100644
          this.groupNode = group;
 
          return this;
-@@ -88,11 +97,11 @@ class UniformNode extends InputNode {
+@@ -90,11 +99,11 @@ class UniformNode extends InputNode {
       * @param {NodeBuilder} builder - The current node builder.
       * @return {String} The uniform hash.
       */
@@ -2884,7 +2885,7 @@ index c85b4aae..7f3d18cc 100644
          const self = this.getSelf();
 
          callback = callback.bind(self);
-@@ -106,12 +115,12 @@ class UniformNode extends InputNode {
+@@ -108,12 +117,12 @@ class UniformNode extends InputNode {
          }, updateType);
      }
 
@@ -2899,7 +2900,7 @@ index c85b4aae..7f3d18cc 100644
 
          if (sharedNode === undefined) {
              builder.setHashNode(this, hash);
-@@ -124,7 +133,7 @@ class UniformNode extends InputNode {
+@@ -126,7 +135,7 @@ class UniformNode extends InputNode {
          const nodeUniform = builder.getUniformFromNode(
              sharedNode,
              sharedNodeType,
@@ -2908,10 +2909,10 @@ index c85b4aae..7f3d18cc 100644
              this.name || builder.context.label,
          );
          const propertyName = builder.getPropertyName(nodeUniform);
-@@ -137,11 +146,14 @@ class UniformNode extends InputNode {
-
- export default UniformNode;
-
+@@ -147,11 +156,14 @@ export default UniformNode;
+  * @param {String?} arg2 - The node type. If no explicit type is defined, the node tries to derive the type from its value.
+  * @returns {UniformNode}
+  */
 -export const uniform = (arg1, arg2) => {
 +export const uniform = <TValue>(arg1: InputNode<TValue> | TValue, arg2?: Node | string) => {
      const nodeType = getConstNodeType(arg2 || arg1);
@@ -2926,10 +2927,10 @@ index c85b4aae..7f3d18cc 100644
      return nodeObject(new UniformNode(value, nodeType));
  };
 diff --git a/src-testing/src/nodes/core/constants.ts b/src-testing/src/nodes/core/constants.ts
-index 1fe2dbbd..a431897f 100644
+index 49c06f8f..eb4ac132 100644
 --- a/src-testing/src/nodes/core/constants.ts
 +++ b/src-testing/src/nodes/core/constants.ts
-@@ -7,7 +7,7 @@
+@@ -9,7 +9,7 @@
  export const NodeShaderStage = {
      VERTEX: 'vertex',
      FRAGMENT: 'fragment',
@@ -2938,7 +2939,7 @@ index 1fe2dbbd..a431897f 100644
 
  /**
   * Update types of a node.
-@@ -22,7 +22,7 @@ export const NodeUpdateType = {
+@@ -24,7 +24,7 @@ export const NodeUpdateType = {
      FRAME: 'frame',
      RENDER: 'render',
      OBJECT: 'object',
@@ -2947,7 +2948,7 @@ index 1fe2dbbd..a431897f 100644
 
  /**
   * Data types of a node.
-@@ -47,7 +47,7 @@ export const NodeType = {
+@@ -49,7 +49,7 @@ export const NodeType = {
      MATRIX2: 'mat2',
      MATRIX3: 'mat3',
      MATRIX4: 'mat4',
@@ -2956,7 +2957,7 @@ index 1fe2dbbd..a431897f 100644
 
  /**
   * Access types of a node. These are relevant for compute and storage usage.
-@@ -60,9 +60,13 @@ export const NodeAccess = {
+@@ -62,9 +62,13 @@ export const NodeAccess = {
      READ_ONLY: 'readOnly',
      WRITE_ONLY: 'writeOnly',
      READ_WRITE: 'readWrite',

types/three/src/nodes/core/UniformNode.d.ts

@@ -4,6 +4,7 @@ import Node from "./Node.js";
 import NodeBuilder from "./NodeBuilder.js";
 import NodeFrame from "./NodeFrame.js";
 import UniformGroupNode from "./UniformGroupNode.js";
+/** @module UniformNode **/
 /**
  * Class for representing a uniform.
  *
@@ -53,6 +54,14 @@ declare class UniformNode<TValue> extends InputNode<TValue> {
     generate(builder: NodeBuilder, output: string | null): string;
 }
 export default UniformNode;
+/**
+ * TSL function for creating a uniform node with the given paramters.
+ *
+ * @function
+ * @param {Any} arg1 - The value of this node. Usually a JS primitive or three.js object (vector, matrix, color, texture).
+ * @param {String?} arg2 - The node type. If no explicit type is defined, the node tries to derive the type from its value.
+ * @returns {UniformNode}
+ */
 export declare const uniform: <TValue>(
     arg1: InputNode<TValue> | TValue,
     arg2?: Node | string,

types/three/src/nodes/core/constants.d.ts

@@ -1,3 +1,4 @@
+/** @module NodeConstants **/
 /**
  * Possible shader stages.
  *

types/three/src/nodes/display/PassNode.d.ts

@@ -68,4 +68,4 @@ export default PassNode;
 
 export const pass: (scene: Scene, camera: Camera, options?: RenderTargetOptions) => ShaderNodeObject<PassNode>;
 export const passTexture: (pass: PassNode, texture: Texture) => ShaderNodeObject<PassTextureNode>;
-export const depthPass: (scene: Scene, camera: Camera) => ShaderNodeObject<PassNode>;
+export const depthPass: (scene: Scene, camera: Camera, options?: RenderTargetOptions) => ShaderNodeObject<PassNode>;