@needle-tools/three 0.169.12 → 0.169.13

package/types/src/nodes/math/ConditionalNode.d.ts

@@ -0,0 +1,39 @@
+import Node from "../core/Node.js";
+import { NodeRepresentation, ShaderNodeObject } from "../tsl/TSLCore.js";
+
+declare class ConditionalNode extends Node {
+    condNode: Node;
+    ifNode: Node;
+    elseNode: Node;
+
+    constructor(condNode: Node, ifNode: Node, elseNode: Node);
+}
+
+export default ConditionalNode;
+
+export const select: (
+    condNode: NodeRepresentation,
+    ifNode: NodeRepresentation,
+    elseNode: NodeRepresentation,
+) => ShaderNodeObject<Node>;
+
+declare module "../tsl/TSLCore.js" {
+    interface NodeElements {
+        select: typeof select;
+    }
+}
+
+/**
+ * @deprecated cond() has been renamed to select()
+ */
+export const cond: (
+    condNode: NodeRepresentation,
+    ifNode: NodeRepresentation,
+    elseNode: NodeRepresentation,
+) => ShaderNodeObject<Node>;
+
+declare module "../tsl/TSLCore.js" {
+    interface NodeElements {
+        cond: typeof cond;
+    }
+}

package/types/src/nodes/math/Hash.d.ts

@@ -0,0 +1,4 @@
+import Node from "../core/Node.js";
+import { NodeRepresentation, ShaderNodeObject } from "../tsl/TSLCore.js";
+
+export const hash: (seed: NodeRepresentation) => ShaderNodeObject<Node>;

package/types/src/nodes/math/MathNode.d.ts

@@ -0,0 +1,273 @@
+import Node from "../core/Node.js";
+import TempNode from "../core/TempNode.js";
+import { NodeRepresentation, ShaderNodeObject } from "../tsl/TSLCore.js";
+import OperatorNode from "./OperatorNode.js";
+
+export type MathNodeMethod1 =
+    | typeof MathNode.RADIANS
+    | typeof MathNode.DEGREES
+    | typeof MathNode.EXP
+    | typeof MathNode.EXP2
+    | typeof MathNode.LOG
+    | typeof MathNode.LOG2
+    | typeof MathNode.SQRT
+    | typeof MathNode.INVERSE_SQRT
+    | typeof MathNode.FLOOR
+    | typeof MathNode.CEIL
+    | typeof MathNode.NORMALIZE
+    | typeof MathNode.FRACT
+    | typeof MathNode.SIN
+    | typeof MathNode.COS
+    | typeof MathNode.TAN
+    | typeof MathNode.ASIN
+    | typeof MathNode.ACOS
+    | typeof MathNode.ATAN
+    | typeof MathNode.ABS
+    | typeof MathNode.SIGN
+    | typeof MathNode.LENGTH
+    | typeof MathNode.NEGATE
+    | typeof MathNode.ONE_MINUS
+    | typeof MathNode.DFDX
+    | typeof MathNode.DFDY
+    | typeof MathNode.ROUND
+    | typeof MathNode.RECIPROCAL
+    | typeof MathNode.TRUNC
+    | typeof MathNode.FWIDTH
+    | typeof MathNode.BITCAST
+    | typeof MathNode.TRANSPOSE;
+
+export type MathNodeMethod2 =
+    | typeof MathNode.ATAN2
+    | typeof MathNode.MIN
+    | typeof MathNode.MAX
+    | typeof MathNode.MOD
+    | typeof MathNode.STEP
+    | typeof MathNode.REFLECT
+    | typeof MathNode.DISTANCE
+    | typeof MathNode.DOT
+    | typeof MathNode.CROSS
+    | typeof MathNode.POW
+    | typeof MathNode.TRANSFORM_DIRECTION;
+
+export type MathNodeMethod3 =
+    | typeof MathNode.MIX
+    | typeof MathNode.CLAMP
+    | typeof MathNode.REFRACT
+    | typeof MathNode.SMOOTHSTEP
+    | typeof MathNode.FACEFORWARD;
+
+export type MathNodeMethod = MathNodeMethod1 | MathNodeMethod2 | MathNodeMethod3;
+
+export default class MathNode extends TempNode {
+    // 1 input
+
+    static ALL: "all";
+    static ANY: "any";
+    static EQUALS: "equals";
+
+    static RADIANS: "radians";
+    static DEGREES: "degrees";
+    static EXP: "exp";
+    static EXP2: "exp2";
+    static LOG: "log";
+    static LOG2: "log2";
+    static SQRT: "sqrt";
+    static INVERSE_SQRT: "inversesqrt";
+    static FLOOR: "floor";
+    static CEIL: "ceil";
+    static NORMALIZE: "normalize";
+    static FRACT: "fract";
+    static SIN: "sin";
+    static COS: "cos";
+    static TAN: "tan";
+    static ASIN: "asin";
+    static ACOS: "acos";
+    static ATAN: "atan";
+    static ABS: "abs";
+    static SIGN: "sign";
+    static LENGTH: "length";
+    static NEGATE: "negate";
+    static ONE_MINUS: "oneMinus";
+    static DFDX: "dFdx";
+    static DFDY: "dFdy";
+    static ROUND: "round";
+    static RECIPROCAL: "reciprocal";
+    static TRUNC: "trunc";
+    static FWIDTH: "fwidth";
+    static BITCAST: "bitcast";
+    static TRANSPOSE: "transpose";
+
+    // 2 inputs
+
+    static ATAN2: "atan2";
+    static MIN: "min";
+    static MAX: "max";
+    static MOD: "mod";
+    static STEP: "step";
+    static REFLECT: "reflect";
+    static DISTANCE: "distance";
+    static DOT: "dot";
+    static CROSS: "cross";
+    static POW: "pow";
+    static TRANSFORM_DIRECTION: "transformDirection";
+
+    // 3 inputs
+
+    static MIX: "mix";
+    static CLAMP: "clamp";
+    static REFRACT: "refract";
+    static SMOOTHSTEP: "smoothstep";
+    static FACEFORWARD: "faceforward";
+
+    method: MathNodeMethod;
+    aNode: Node;
+    bNode: Node | null;
+    cNode: Node | null;
+
+    constructor(method: MathNodeMethod1, aNode: Node);
+    constructor(method: MathNodeMethod2, aNode: Node, bNode: Node);
+    constructor(method: MathNodeMethod3, aNode: Node, bNode: Node, cNode: Node);
+}
+
+export const EPSILON: ShaderNodeObject<Node>;
+export const INFINITY: ShaderNodeObject<Node>;
+export const PI: ShaderNodeObject<Node>;
+export const PI2: ShaderNodeObject<Node>;
+
+type Unary = (a: NodeRepresentation) => ShaderNodeObject<MathNode>;
+
+export const all: Unary;
+export const any: Unary;
+export const equals: Unary;
+
+export const radians: Unary;
+export const degrees: Unary;
+export const exp: Unary;
+export const exp2: Unary;
+export const log: Unary;
+export const log2: Unary;
+export const sqrt: Unary;
+export const inverseSqrt: Unary;
+export const floor: Unary;
+export const ceil: Unary;
+export const normalize: Unary;
+export const fract: Unary;
+export const sin: Unary;
+export const cos: Unary;
+export const tan: Unary;
+export const asin: Unary;
+export const acos: Unary;
+export const atan: Unary;
+export const abs: Unary;
+export const sign: Unary;
+export const length: Unary;
+export const negate: Unary;
+export const oneMinus: Unary;
+export const dFdx: Unary;
+export const dFdy: Unary;
+export const round: Unary;
+export const reciprocal: Unary;
+export const trunc: Unary;
+export const fwidth: Unary;
+export const bitcast: Unary;
+export const transpose: Unary;
+
+type Binary = (a: NodeRepresentation, b: NodeRepresentation) => ShaderNodeObject<MathNode>;
+
+export const atan2: Binary;
+export const min: Binary;
+export const max: Binary;
+export const mod: Binary;
+export const step: Binary;
+export const reflect: Binary;
+export const distance: Binary;
+export const difference: Binary;
+export const dot: Binary;
+export const cross: Binary;
+export const pow: Binary;
+export const pow2: Binary;
+export const pow3: Binary;
+export const pow4: Binary;
+export const transformDirection: Binary;
+
+type Ternary = (a: NodeRepresentation, b: NodeRepresentation, c: NodeRepresentation) => ShaderNodeObject<MathNode>;
+
+export const cbrt: Unary;
+export const lengthSq: Unary;
+export const mix: Ternary;
+export const clamp: (
+    a: NodeRepresentation,
+    b?: NodeRepresentation,
+    c?: NodeRepresentation,
+) => ShaderNodeObject<MathNode>;
+export const saturate: Unary;
+export const refract: Ternary;
+export const smoothstep: Ternary;
+export const faceForward: Ternary;
+
+export const rand: (uv: NodeRepresentation) => ShaderNodeObject<OperatorNode>;
+
+export const mixElement: Ternary;
+export const smoothstepElement: Ternary;
+
+declare module "../tsl/TSLCore.js" {
+    interface NodeElements {
+        all: typeof all;
+        any: typeof any;
+        equals: typeof equals;
+        radians: typeof radians;
+        degrees: typeof degrees;
+        exp: typeof exp;
+        exp2: typeof exp2;
+        log: typeof log;
+        log2: typeof log2;
+        sqrt: typeof sqrt;
+        inverseSqrt: typeof inverseSqrt;
+        floor: typeof floor;
+        ceil: typeof ceil;
+        normalize: typeof normalize;
+        fract: typeof fract;
+        sin: typeof sin;
+        cos: typeof cos;
+        tan: typeof tan;
+        asin: typeof asin;
+        acos: typeof acos;
+        atan: typeof atan;
+        abs: typeof abs;
+        sign: typeof sign;
+        length: typeof length;
+        lengthSq: typeof lengthSq;
+        negate: typeof negate;
+        oneMinus: typeof oneMinus;
+        dFdx: typeof dFdx;
+        dFdy: typeof dFdy;
+        round: typeof round;
+        reciprocal: typeof reciprocal;
+        trunc: typeof trunc;
+        fwidth: typeof fwidth;
+        atan2: typeof atan2;
+        min: typeof min;
+        max: typeof max;
+        mod: typeof mod;
+        step: typeof step;
+        reflect: typeof reflect;
+        distance: typeof distance;
+        dot: typeof dot;
+        cross: typeof cross;
+        pow: typeof pow;
+        pow2: typeof pow2;
+        pow3: typeof pow3;
+        pow4: typeof pow4;
+        transformDirection: typeof transformDirection;
+        mix: typeof mixElement;
+        clamp: typeof clamp;
+        refract: typeof refract;
+        smoothstep: typeof smoothstepElement;
+        faceForward: typeof faceForward;
+        difference: typeof difference;
+        saturate: typeof saturate;
+        cbrt: typeof cbrt;
+        transpose: typeof transpose;
+        rand: typeof rand;
+    }
+}

package/types/src/nodes/math/MathUtils.d.ts

@@ -0,0 +1,6 @@
+import { Binary, Ternary } from "./MathNode.js";
+
+export const parabola: Binary;
+export const gain: Binary;
+export const pcurve: Ternary;
+export const sinc: Binary;

package/types/src/nodes/math/OperatorNode.d.ts

@@ -0,0 +1,97 @@
+import Node from "../core/Node.js";
+import TempNode from "../core/TempNode.js";
+import { NodeRepresentation, ShaderNodeObject } from "../tsl/TSLCore.js";
+
+export type OperatorNodeOp =
+    | "%"
+    | "&"
+    | "|"
+    | "^"
+    | ">>"
+    | "<<"
+    | "=="
+    | "&&"
+    | "||"
+    | "^^"
+    | "<"
+    | ">"
+    | "<="
+    | ">="
+    | "+"
+    | "-"
+    | "*"
+    | "/";
+
+export default class OperatorNode extends TempNode {
+    aNode: Node;
+    bNode: Node;
+    op: OperatorNodeOp;
+
+    constructor(op: OperatorNodeOp, ...params: [Node, Node, ...Node[]]);
+}
+
+type Operator = (
+    a: NodeRepresentation,
+    b: NodeRepresentation,
+    ...others: NodeRepresentation[]
+) => ShaderNodeObject<OperatorNode>;
+
+export const add: Operator;
+export const sub: Operator;
+export const mul: Operator;
+export const div: Operator;
+export const modInt: Operator;
+export const equal: Operator;
+export const lessThan: Operator;
+export const greaterThan: Operator;
+export const lessThanEqual: Operator;
+export const greaterThanEqual: Operator;
+export const and: Operator;
+export const or: Operator;
+export const not: (a: NodeRepresentation) => ShaderNodeObject<OperatorNode>;
+export const xor: Operator;
+export const bitAnd: Operator;
+export const bitNot: (a: NodeRepresentation) => ShaderNodeObject<OperatorNode>;
+export const bitOr: Operator;
+export const bitXor: Operator;
+export const shiftLeft: Operator;
+export const shiftRight: Operator;
+
+declare module "../tsl/TSLCore.js" {
+    interface NodeElements {
+        add: typeof add;
+        sub: typeof sub;
+        mul: typeof mul;
+        div: typeof div;
+        modInt: typeof modInt;
+        equal: typeof equal;
+        lessThan: typeof lessThan;
+        greaterThan: typeof greaterThan;
+        lessThanEqual: typeof lessThanEqual;
+        greaterThanEqual: typeof greaterThanEqual;
+        and: typeof and;
+        or: typeof or;
+        not: typeof not;
+        xor: typeof xor;
+        bitAnd: typeof bitAnd;
+        bitNot: typeof bitNot;
+        bitOr: typeof bitOr;
+        bitXor: typeof bitXor;
+        shiftLeft: typeof shiftLeft;
+        shiftRight: typeof shiftRight;
+    }
+}
+
+/**
+ * @deprecated .remainder() has been renamed to .modInt().
+ */
+export const remainder: Operator;
+
+declare module "../tsl/TSLCore.js" {
+    interface NodeElements {
+        /**
+         * @deprecated .remainder() has been renamed to .modInt().
+         */
+        remainder: typeof remainder;
+    }
+}

package/types/src/nodes/math/TriNoise3D.d.ts

@@ -0,0 +1,12 @@
+import Node from "../core/Node.js";
+import { NodeRepresentation, ShaderNodeObject } from "../tsl/TSLCore.js";
+
+export const tri: (x: NodeRepresentation) => ShaderNodeObject<Node>;
+
+export const tri3: (p: NodeRepresentation) => ShaderNodeObject<Node>;
+
+export const triNoise3D: (
+    p_immutable: NodeRepresentation,
+    spd: NodeRepresentation,
+    time: NodeRepresentation,
+) => ShaderNodeObject<Node>;

package/types/src/nodes/parsers/GLSLNodeFunction.d.ts

@@ -0,0 +1,9 @@
+import NodeFunction from "../core/NodeFunction.js";
+
+declare class GLSLNodeFunction extends NodeFunction {
+    constructor(source: string);
+
+    getCode(name?: string): string;
+}
+
+export default GLSLNodeFunction;

package/types/src/nodes/parsers/GLSLNodeParser.d.ts

@@ -0,0 +1,8 @@
+import NodeParser from "../core/NodeParser.js";
+import GLSLNodeFunction from "./GLSLNodeFunction.js";
+
+declare class GLSLNodeParser extends NodeParser {
+    parseFunction(source: string): GLSLNodeFunction;
+}
+
+export default GLSLNodeParser;

package/types/src/nodes/pmrem/PMREMNode.d.ts

@@ -0,0 +1,22 @@
+import { Texture } from "../../textures/Texture.js";
+import Node from "../core/Node.js";
+import TempNode from "../core/TempNode.js";
+import { NodeRepresentation, ShaderNodeObject } from "../tsl/TSLCore.js";
+
+declare class PMREMNode extends TempNode {
+    uvNode: Node | null;
+    levelNode: Node | null;
+
+    constructor(value: Texture, uvNode?: Node | null, levelNode?: Node | null);
+
+    set value(value: Texture);
+    get value(): Texture;
+}
+
+export default PMREMNode;
+
+export const pmremTexture: (
+    value: Texture,
+    uvNode?: NodeRepresentation,
+    levelNode?: NodeRepresentation,
+) => ShaderNodeObject<PMREMNode>;

package/types/src/nodes/pmrem/PMREMUtils.d.ts

@@ -0,0 +1,28 @@
+import Node from "../core/Node.js";
+import { NodeRepresentation, ShaderNodeObject } from "../tsl/TSLCore.js";
+
+export const getDirection: (uv_immutable: NodeRepresentation, face: NodeRepresentation) => ShaderNodeObject<Node>;
+
+export const textureCubeUV: (
+    envMap: NodeRepresentation,
+    sampleDir_immutable: NodeRepresentation,
+    roughness_immutable: NodeRepresentation,
+    CUBEUV_TEXEL_WIDTH: NodeRepresentation,
+    CUBEUV_TEXEL_HEIGHT: NodeRepresentation,
+    CUBEUV_MAX_MIP: NodeRepresentation,
+) => ShaderNodeObject<Node>;
+
+export const blur: (
+    n: NodeRepresentation,
+    latitudinal: NodeRepresentation,
+    poleAxis: NodeRepresentation,
+    outputDirection: NodeRepresentation,
+    weights: NodeRepresentation,
+    samples: NodeRepresentation,
+    dTheta: NodeRepresentation,
+    mipInt: NodeRepresentation,
+    envMap: NodeRepresentation,
+    CUBEUV_TEXEL_WIDTH: NodeRepresentation,
+    CUBEUV_TEXEL_HEIGHT: NodeRepresentation,
+    CUBEUV_MAX_MIP: NodeRepresentation,
+) => ShaderNodeObject<Node>;

package/types/src/nodes/procedural/Checker.d.ts

@@ -0,0 +1,4 @@
+import Node from "../core/Node.js";
+import { NodeRepresentation, ShaderNodeObject } from "../tsl/TSLCore.js";
+
+export const checker: (coord?: NodeRepresentation) => ShaderNodeObject<Node>;

package/types/src/nodes/tsl/TSLBase.d.ts

@@ -0,0 +1,21 @@
+export * from "../accessors/BufferAttributeNode.js";
+export * from "../code/ExpressionNode.js";
+export * from "../code/FunctionCallNode.js";
+export * from "../core/AssignNode.js";
+export * from "../core/BypassNode.js";
+export * from "../core/CacheNode.js";
+export * from "../core/ContextNode.js";
+export * from "../core/PropertyNode.js";
+export * from "../core/UniformNode.js";
+export * from "../core/VarNode.js";
+export * from "../core/VaryingNode.js";
+export * from "../display/ColorSpaceNode.js";
+export * from "../display/RenderOutputNode.js";
+export * from "../display/ToneMappingNode.js";
+export * from "../gpgpu/ComputeNode.js";
+export * from "../math/ConditionalNode.js";
+export * from "../math/MathNode.js";
+export * from "../math/OperatorNode.js";
+export * from "../utils/Discard.js";
+export * from "../utils/RemapNode.js";
+export * from "./TSLCore.js";