@zephyr3d/scene 0.9.25 → 0.9.26

package/dist/shapes/sphere.js

@@ -9,7 +9,8 @@ import { Shape } from './shape.js';
         ...Shape._defaultOptions,
         radius: 1,
         verticalDetail: 20,
-        horizonalDetail: 20
+        horizonalDetail: 20,
+        eyeCompatible: false
     };
     /**
    * Creates an instance of sphere shape
@@ -56,8 +57,10 @@ import { Shape } from './shape.js';
         const radius = options.radius ?? 1;
         const verticalDetail = options.verticalDetail ?? 20;
         const horizonalDetail = options.horizonalDetail ?? 20;
+        const eyeCompatible = options.eyeCompatible ?? false;
         const vTheta = Math.PI / verticalDetail;
         const hTheta = Math.PI * 2 / horizonalDetail;
+        const invR = 1 / radius;
         for(let i = 0; i <= verticalDetail; i++){
             const v = i * vTheta;
             const sinV = Math.sin(v);
@@ -66,19 +69,57 @@ import { Shape } from './shape.js';
                 const h = j * hTheta;
                 const sinH = Math.sin(h);
                 const cosH = Math.cos(h);
-                const x = radius * sinV * sinH;
-                const y = radius * cosV;
-                const z = radius * sinV * cosH;
+                // Eye UVs are centred on +Z, so put the mesh poles on the gaze axis as
+                // well. Besides giving the rear projection a proper seam at -Z, this
+                // keeps the vertex rings concentric with the iris instead of placing
+                // its centre on the legacy longitude seam.
+                const x = radius * sinV * (eyeCompatible ? cosH : sinH);
+                const y = eyeCompatible ? radius * sinV * sinH : radius * cosV;
+                const z = eyeCompatible ? radius * cosV : radius * sinV * cosH;
                 vertices.push(x, y, z);
-                uvs?.push(j / horizonalDetail, i / verticalDetail);
+                if (eyeCompatible) {
+                    // Preserve the planar projection over the visible hemisphere. On
+                    // the rear hemisphere, continue from the equator into an outer
+                    // annulus rather than folding back to (0.5, 0.5); the old fold was
+                    // what produced a second iris and pupil at -Z.
+                    const uvRadius = cosV >= 0 ? sinV * 0.5 : 1 - sinV * 0.5;
+                    uvs?.push(0.5 + cosH * uvRadius, 0.5 + sinH * uvRadius);
+                } else {
+                    uvs?.push(j / horizonalDetail, i / verticalDetail);
+                }
                 if (normals) {
-                    const invR = 1 / radius;
                     normals.push(x * invR, y * invR, z * invR);
                 }
                 if (tangents) {
-                    const w = 1;
+                    let w = 1;
                     let tx, ty, tz;
-                    if (sinV > 1e-6) {
+                    if (eyeCompatible) {
+                        // Project +X onto the local tangent plane. This is the +U
+                        // direction of the planar eye projection; an azimuth tangent
+                        // would rotate the refraction frame around the iris.
+                        const nx = x * invR;
+                        const ny = y * invR;
+                        const nz = z * invR;
+                        tx = 1 - nx * nx;
+                        ty = -ny * nx;
+                        tz = -nz * nx;
+                        const len = Math.hypot(tx, ty, tz);
+                        if (len > 1e-8) {
+                            tx /= len;
+                            ty /= len;
+                            tz /= len;
+                        } else {
+                            // At +/-X the projected +X direction degenerates. Use its
+                            // limiting direction from the front hemisphere instead of a
+                            // vector parallel to the normal.
+                            tx = 0;
+                            ty = 0;
+                            tz = nx >= 0 ? -1 : 1;
+                        }
+                        // The rear annulus reverses its radial direction, so its tangent
+                        // frame has the opposite handedness.
+                        w = cosV >= 0 ? 1 : -1;
+                    } else if (sinV > 1e-6) {
                         tx = cosH;
                         ty = 0.0;
                         tz = -sinH;
@@ -106,7 +147,7 @@ import { Shape } from './shape.js';
                 indices.push(stripIndices[i], stripIndices[i + 2], stripIndices[i + 1]);
             }
         }
-        Shape._transform(options.transform, vertices, normals, start);
+        Shape._transform(options.transform, vertices, normals, start, tangents);
         if (bbox) {
             for(let i = start; i < vertices.length - 2; i += 3){
                 if (bbox) {

package/dist/shapes/sphere.js.map

@@ -1 +1 @@
-{"version":3,"file":"sphere.js","sources":["../../src/shapes/sphere.ts"],"sourcesContent":["import type { Clonable, Ray } from '@zephyr3d/base';\r\nimport type { AABB } from '@zephyr3d/base';\r\nimport { Vector3 } from '@zephyr3d/base';\r\nimport type { ShapeCreationOptions } from './shape';\r\nimport { Shape } from './shape';\r\n\r\n/**\r\n * Creation options for sphere shape\r\n * @public\r\n */\r\nexport interface SphereCreationOptions extends ShapeCreationOptions {\r\n  /** Radius of the sphere, default 1 */\r\n  radius?: number;\r\n  /** The vertical detail level, default 20 */\r\n  verticalDetail?: number;\r\n  /** The horizonal detail level, default 20 */\r\n  horizonalDetail?: number;\r\n}\r\n\r\n/**\r\n * Sphere shape\r\n * @public\r\n */\r\nexport class SphereShape extends Shape<SphereCreationOptions> implements Clonable<SphereShape> {\r\n  static _defaultOptions = {\r\n    ...Shape._defaultOptions,\r\n    radius: 1,\r\n    verticalDetail: 20,\r\n    horizonalDetail: 20\r\n  };\r\n  /**\r\n   * Creates an instance of sphere shape\r\n   * @param options - The creation options\r\n   */\r\n  constructor(options?: SphereCreationOptions) {\r\n    super(options);\r\n  }\r\n  clone() {\r\n    return new SphereShape(this._options) as this;\r\n  }\r\n  /** type of the shape */\r\n  get type() {\r\n    return 'Sphere' as const;\r\n  }\r\n  /**\r\n   * {@inheritDoc Primitive.raycast}\r\n   * @override\r\n   */\r\n  raycast(ray: Ray) {\r\n    const rSquared = this._options.radius * this._options.radius;\r\n    const eSquared = Vector3.dot(ray.origin, ray.origin);\r\n    if (eSquared < rSquared) {\r\n      return null;\r\n    }\r\n    const a = -Vector3.dot(ray.origin, ray.direction);\r\n    const bSquared = eSquared - a * a;\r\n    if (rSquared < bSquared) {\r\n      return null;\r\n    }\r\n    return a - Math.sqrt(rSquared - bSquared);\r\n  }\r\n  /** Sphere radius */\r\n  get radius() {\r\n    return this._options.radius ?? 1;\r\n  }\r\n  /**\r\n   * Generates the data for the sphere shape\r\n   * @param vertices - vertex positions\r\n   * @param normals - vertex normals\r\n   * @param uvs - vertex uvs\r\n   * @param indices - vertex indices\r\n   */\r\n  static generateData(\r\n    opt: SphereCreationOptions,\r\n    vertices: number[],\r\n    normals: number[],\r\n    tangents: number[],\r\n    uvs: number[],\r\n    indices: number[],\r\n    bbox?: AABB,\r\n    indexOffset?: number,\r\n    vertexCallback?: (index: number, x: number, y: number, z: number) => void\r\n  ) {\r\n    const options = Object.assign({}, this._defaultOptions, opt ?? {});\r\n    indexOffset = indexOffset ?? 0;\r\n    const start = vertices.length;\r\n    const stripIndices: number[] = [];\r\n    const radius = options.radius ?? 1;\r\n    const verticalDetail = options.verticalDetail ?? 20;\r\n    const horizonalDetail = options.horizonalDetail ?? 20;\r\n    const vTheta = Math.PI / verticalDetail;\r\n    const hTheta = (Math.PI * 2) / horizonalDetail;\r\n    for (let i = 0; i <= verticalDetail; i++) {\r\n      const v = i * vTheta;\r\n      const sinV = Math.sin(v);\r\n      const cosV = Math.cos(v);\r\n      for (let j = 0; j <= horizonalDetail; j++) {\r\n        const h = j * hTheta;\r\n        const sinH = Math.sin(h);\r\n        const cosH = Math.cos(h);\r\n\r\n        const x = radius * sinV * sinH;\r\n        const y = radius * cosV;\r\n        const z = radius * sinV * cosH;\r\n        vertices.push(x, y, z);\r\n        uvs?.push(j / horizonalDetail, i / verticalDetail);\r\n        if (normals) {\r\n          const invR = 1 / radius;\r\n          normals.push(x * invR, y * invR, z * invR);\r\n        }\r\n        if (tangents) {\r\n          const w = 1;\r\n          let tx: number, ty: number, tz: number;\r\n          if (sinV > 1e-6) {\r\n            tx = cosH;\r\n            ty = 0.0;\r\n            tz = -sinH;\r\n          } else {\r\n            tx = 1.0;\r\n            ty = 0.0;\r\n            tz = 0.0;\r\n          }\r\n          tangents.push(tx, ty, tz, w);\r\n        }\r\n      }\r\n    }\r\n    for (let i = 0; i < verticalDetail; i++) {\r\n      for (let j = 0; j <= horizonalDetail; j++) {\r\n        const startIndex = i * (horizonalDetail + 1);\r\n        stripIndices.push(startIndex + j + indexOffset, startIndex + j + horizonalDetail + 1 + indexOffset);\r\n      }\r\n      stripIndices.push(stripIndices[stripIndices.length - 1]);\r\n      stripIndices.push((i + 1) * (horizonalDetail + 1) + indexOffset);\r\n    }\r\n    for (let i = 0; i < stripIndices.length - 2; i++) {\r\n      if (i % 2 === 0) {\r\n        indices.push(stripIndices[i], stripIndices[i + 1], stripIndices[i + 2]);\r\n      } else {\r\n        indices.push(stripIndices[i], stripIndices[i + 2], stripIndices[i + 1]);\r\n      }\r\n    }\r\n    Shape._transform(options.transform, vertices, normals, start);\r\n    if (bbox) {\r\n      for (let i = start; i < vertices.length - 2; i += 3) {\r\n        if (bbox) {\r\n          bbox.minPoint.x = Math.min(bbox.minPoint.x, vertices[i]);\r\n          bbox.minPoint.y = Math.min(bbox.minPoint.y, vertices[i + 1]);\r\n          bbox.minPoint.z = Math.min(bbox.minPoint.z, vertices[i + 2]);\r\n          bbox.maxPoint.x = Math.max(bbox.maxPoint.x, vertices[i]);\r\n          bbox.maxPoint.y = Math.max(bbox.maxPoint.y, vertices[i + 1]);\r\n          bbox.maxPoint.z = Math.max(bbox.maxPoint.z, vertices[i + 2]);\r\n        }\r\n        vertexCallback?.((i - start) / 3, vertices[i], vertices[i + 1], vertices[i + 2]);\r\n      }\r\n    }\r\n    return 'triangle-list' as const;\r\n  }\r\n}\r\n"],"names":["SphereShape","Shape","_defaultOptions","radius","verticalDetail","horizonalDetail","options","clone","_options","type","raycast","ray","rSquared","eSquared","Vector3","dot","origin","a","direction","bSquared","Math","sqrt","generateData","opt","vertices","normals","tangents","uvs","indices","bbox","indexOffset","vertexCallback","Object","assign","start","length","stripIndices","vTheta","PI","hTheta","i","v","sinV","sin","cosV","cos","j","h","sinH","cosH","x","y","z","push","invR","w","tx","ty","tz","startIndex","_transform","transform","minPoint","min","maxPoint","max"],"mappings":"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"}
+{"version":3,"file":"sphere.js","sources":["../../src/shapes/sphere.ts"],"sourcesContent":["import type { Clonable, Ray } from '@zephyr3d/base';\r\nimport type { AABB } from '@zephyr3d/base';\r\nimport { Vector3 } from '@zephyr3d/base';\r\nimport type { ShapeCreationOptions } from './shape';\r\nimport { Shape } from './shape';\r\n\r\n/**\r\n * Creation options for sphere shape\r\n * @public\r\n */\r\nexport interface SphereCreationOptions extends ShapeCreationOptions {\r\n  /** Radius of the sphere, default 1 */\r\n  radius?: number;\r\n  /** The vertical detail level, default 20 */\r\n  verticalDetail?: number;\r\n  /** The horizonal detail level, default 20 */\r\n  horizonalDetail?: number;\r\n  /**\r\n   * Generate UVs and tangents for {@link EyeMaterial}.\r\n   *\r\n   * When enabled, the sphere's polar axis follows Z and the front hemisphere\r\n   * uses a planar projection along +Z, with its centre at (0.5, 0.5). The rear\r\n   * hemisphere is unwrapped outside that front disc so it cannot produce a\r\n   * second iris at -Z. The tangent follows +U. The sphere topology is otherwise\r\n   * unchanged, so this option remains compatible with the analytical raycast\r\n   * and with existing sphere consumers. The material must still opt into the\r\n   * tangent frame with `EyeMaterial.vertexTangent = true`.\r\n   *\r\n   * @defaultValue `false`\r\n   */\r\n  eyeCompatible?: boolean;\r\n}\r\n\r\n/**\r\n * Sphere shape\r\n * @public\r\n */\r\nexport class SphereShape extends Shape<SphereCreationOptions> implements Clonable<SphereShape> {\r\n  static _defaultOptions = {\r\n    ...Shape._defaultOptions,\r\n    radius: 1,\r\n    verticalDetail: 20,\r\n    horizonalDetail: 20,\r\n    eyeCompatible: false\r\n  };\r\n  /**\r\n   * Creates an instance of sphere shape\r\n   * @param options - The creation options\r\n   */\r\n  constructor(options?: SphereCreationOptions) {\r\n    super(options);\r\n  }\r\n  clone() {\r\n    return new SphereShape(this._options) as this;\r\n  }\r\n  /** type of the shape */\r\n  get type() {\r\n    return 'Sphere' as const;\r\n  }\r\n  /**\r\n   * {@inheritDoc Primitive.raycast}\r\n   * @override\r\n   */\r\n  raycast(ray: Ray) {\r\n    const rSquared = this._options.radius * this._options.radius;\r\n    const eSquared = Vector3.dot(ray.origin, ray.origin);\r\n    if (eSquared < rSquared) {\r\n      return null;\r\n    }\r\n    const a = -Vector3.dot(ray.origin, ray.direction);\r\n    const bSquared = eSquared - a * a;\r\n    if (rSquared < bSquared) {\r\n      return null;\r\n    }\r\n    return a - Math.sqrt(rSquared - bSquared);\r\n  }\r\n  /** Sphere radius */\r\n  get radius() {\r\n    return this._options.radius ?? 1;\r\n  }\r\n  /**\r\n   * Generates the data for the sphere shape\r\n   * @param vertices - vertex positions\r\n   * @param normals - vertex normals\r\n   * @param uvs - vertex uvs\r\n   * @param indices - vertex indices\r\n   */\r\n  static generateData(\r\n    opt: SphereCreationOptions,\r\n    vertices: number[],\r\n    normals: number[],\r\n    tangents: number[],\r\n    uvs: number[],\r\n    indices: number[],\r\n    bbox?: AABB,\r\n    indexOffset?: number,\r\n    vertexCallback?: (index: number, x: number, y: number, z: number) => void\r\n  ) {\r\n    const options = Object.assign({}, this._defaultOptions, opt ?? {});\r\n    indexOffset = indexOffset ?? 0;\r\n    const start = vertices.length;\r\n    const stripIndices: number[] = [];\r\n    const radius = options.radius ?? 1;\r\n    const verticalDetail = options.verticalDetail ?? 20;\r\n    const horizonalDetail = options.horizonalDetail ?? 20;\r\n    const eyeCompatible = options.eyeCompatible ?? false;\r\n    const vTheta = Math.PI / verticalDetail;\r\n    const hTheta = (Math.PI * 2) / horizonalDetail;\r\n    const invR = 1 / radius;\r\n    for (let i = 0; i <= verticalDetail; i++) {\r\n      const v = i * vTheta;\r\n      const sinV = Math.sin(v);\r\n      const cosV = Math.cos(v);\r\n      for (let j = 0; j <= horizonalDetail; j++) {\r\n        const h = j * hTheta;\r\n        const sinH = Math.sin(h);\r\n        const cosH = Math.cos(h);\r\n\r\n        // Eye UVs are centred on +Z, so put the mesh poles on the gaze axis as\r\n        // well. Besides giving the rear projection a proper seam at -Z, this\r\n        // keeps the vertex rings concentric with the iris instead of placing\r\n        // its centre on the legacy longitude seam.\r\n        const x = radius * sinV * (eyeCompatible ? cosH : sinH);\r\n        const y = eyeCompatible ? radius * sinV * sinH : radius * cosV;\r\n        const z = eyeCompatible ? radius * cosV : radius * sinV * cosH;\r\n        vertices.push(x, y, z);\r\n        if (eyeCompatible) {\r\n          // Preserve the planar projection over the visible hemisphere. On\r\n          // the rear hemisphere, continue from the equator into an outer\r\n          // annulus rather than folding back to (0.5, 0.5); the old fold was\r\n          // what produced a second iris and pupil at -Z.\r\n          const uvRadius = cosV >= 0 ? sinV * 0.5 : 1 - sinV * 0.5;\r\n          uvs?.push(0.5 + cosH * uvRadius, 0.5 + sinH * uvRadius);\r\n        } else {\r\n          uvs?.push(j / horizonalDetail, i / verticalDetail);\r\n        }\r\n        if (normals) {\r\n          normals.push(x * invR, y * invR, z * invR);\r\n        }\r\n        if (tangents) {\r\n          let w = 1;\r\n          let tx: number, ty: number, tz: number;\r\n          if (eyeCompatible) {\r\n            // Project +X onto the local tangent plane. This is the +U\r\n            // direction of the planar eye projection; an azimuth tangent\r\n            // would rotate the refraction frame around the iris.\r\n            const nx = x * invR;\r\n            const ny = y * invR;\r\n            const nz = z * invR;\r\n            tx = 1 - nx * nx;\r\n            ty = -ny * nx;\r\n            tz = -nz * nx;\r\n            const len = Math.hypot(tx, ty, tz);\r\n            if (len > 1e-8) {\r\n              tx /= len;\r\n              ty /= len;\r\n              tz /= len;\r\n            } else {\r\n              // At +/-X the projected +X direction degenerates. Use its\r\n              // limiting direction from the front hemisphere instead of a\r\n              // vector parallel to the normal.\r\n              tx = 0;\r\n              ty = 0;\r\n              tz = nx >= 0 ? -1 : 1;\r\n            }\r\n            // The rear annulus reverses its radial direction, so its tangent\r\n            // frame has the opposite handedness.\r\n            w = cosV >= 0 ? 1 : -1;\r\n          } else if (sinV > 1e-6) {\r\n            tx = cosH;\r\n            ty = 0.0;\r\n            tz = -sinH;\r\n          } else {\r\n            tx = 1.0;\r\n            ty = 0.0;\r\n            tz = 0.0;\r\n          }\r\n          tangents.push(tx, ty, tz, w);\r\n        }\r\n      }\r\n    }\r\n    for (let i = 0; i < verticalDetail; i++) {\r\n      for (let j = 0; j <= horizonalDetail; j++) {\r\n        const startIndex = i * (horizonalDetail + 1);\r\n        stripIndices.push(startIndex + j + indexOffset, startIndex + j + horizonalDetail + 1 + indexOffset);\r\n      }\r\n      stripIndices.push(stripIndices[stripIndices.length - 1]);\r\n      stripIndices.push((i + 1) * (horizonalDetail + 1) + indexOffset);\r\n    }\r\n    for (let i = 0; i < stripIndices.length - 2; i++) {\r\n      if (i % 2 === 0) {\r\n        indices.push(stripIndices[i], stripIndices[i + 1], stripIndices[i + 2]);\r\n      } else {\r\n        indices.push(stripIndices[i], stripIndices[i + 2], stripIndices[i + 1]);\r\n      }\r\n    }\r\n    Shape._transform(options.transform, vertices, normals, start, tangents);\r\n    if (bbox) {\r\n      for (let i = start; i < vertices.length - 2; i += 3) {\r\n        if (bbox) {\r\n          bbox.minPoint.x = Math.min(bbox.minPoint.x, vertices[i]);\r\n          bbox.minPoint.y = Math.min(bbox.minPoint.y, vertices[i + 1]);\r\n          bbox.minPoint.z = Math.min(bbox.minPoint.z, vertices[i + 2]);\r\n          bbox.maxPoint.x = Math.max(bbox.maxPoint.x, vertices[i]);\r\n          bbox.maxPoint.y = Math.max(bbox.maxPoint.y, vertices[i + 1]);\r\n          bbox.maxPoint.z = Math.max(bbox.maxPoint.z, vertices[i + 2]);\r\n        }\r\n        vertexCallback?.((i - start) / 3, vertices[i], vertices[i + 1], vertices[i + 2]);\r\n      }\r\n    }\r\n    return 'triangle-list' as const;\r\n  }\r\n}\r\n"],"names":["SphereShape","Shape","_defaultOptions","radius","verticalDetail","horizonalDetail","eyeCompatible","options","clone","_options","type","raycast","ray","rSquared","eSquared","Vector3","dot","origin","a","direction","bSquared","Math","sqrt","generateData","opt","vertices","normals","tangents","uvs","indices","bbox","indexOffset","vertexCallback","Object","assign","start","length","stripIndices","vTheta","PI","hTheta","invR","i","v","sinV","sin","cosV","cos","j","h","sinH","cosH","x","y","z","push","uvRadius","w","tx","ty","tz","nx","ny","nz","len","hypot","startIndex","_transform","transform","minPoint","min","maxPoint","max"],"mappings":"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"}

package/dist/utility/blueprint/common/constants.js

@@ -10,6 +10,9 @@ import { BaseGraphNode } from '../node.js';
     /** The scalar float value */ _value;
     /** Whether this constant should be exposed as a uniform parameter */ _isUniform;
     /** The uniform parameter name (only used when isUniform is true) */ _paramName;
+    /** Whether the scalar uniform should expose a value range in editor UI */ _useRange;
+    /** The minimum allowed value when range limiting is enabled */ _minValue;
+    /** The maximum allowed value when range limiting is enabled */ _maxValue;
     /**
    * Creates a new constant scalar node
    *
@@ -20,6 +23,9 @@ import { BaseGraphNode } from '../node.js';
         this._value = 0;
         this._isUniform = true;
         this._paramName = getParamName();
+        this._useRange = false;
+        this._minValue = 0;
+        this._maxValue = 1;
         this._outputs = [
             {
                 id: 1,
@@ -27,6 +33,18 @@ import { BaseGraphNode } from '../node.js';
             }
         ];
     }
+    clampValue(val) {
+        if (!this._useRange) {
+            return val;
+        }
+        return Math.min(this._maxValue, Math.max(this._minValue, val));
+    }
+    normalizeRange() {
+        if (this._minValue > this._maxValue) {
+            this._maxValue = this._minValue;
+        }
+        this._value = this.clampValue(this._value);
+    }
     /**
    * Generates a string representation of this node
    *
@@ -78,12 +96,63 @@ import { BaseGraphNode } from '../node.js';
                     {
                         name: 'x',
                         type: 'float',
+                        options: {
+                            label: 'DefaultValue'
+                        },
                         get (value) {
                             value.num[0] = this.x;
                         },
                         set (value) {
                             this.x = value.num[0];
                         }
+                    },
+                    {
+                        name: 'useRange',
+                        type: 'bool',
+                        options: {
+                            label: 'UseRange'
+                        },
+                        get (value) {
+                            value.bool[0] = this.useRange;
+                        },
+                        set (value) {
+                            this.useRange = value.bool[0];
+                        },
+                        isHidden () {
+                            return !this.isUniform;
+                        }
+                    },
+                    {
+                        name: 'minValue',
+                        type: 'float',
+                        options: {
+                            label: 'MinValue'
+                        },
+                        get (value) {
+                            value.num[0] = this.minValue;
+                        },
+                        set (value) {
+                            this.minValue = value.num[0];
+                        },
+                        isHidden () {
+                            return !this.isUniform || !this.useRange;
+                        }
+                    },
+                    {
+                        name: 'maxValue',
+                        type: 'float',
+                        options: {
+                            label: 'MaxValue'
+                        },
+                        get (value) {
+                            value.num[0] = this.maxValue;
+                        },
+                        set (value) {
+                            this.maxValue = value.num[0];
+                        },
+                        isHidden () {
+                            return !this.isUniform || !this.useRange;
+                        }
                     }
                 ]);
             }
@@ -114,13 +183,54 @@ import { BaseGraphNode } from '../node.js';
         }
     }
     /**
+   * Gets whether the scalar parameter uses editor range limits
+   */ get useRange() {
+        return this._useRange;
+    }
+    set useRange(val) {
+        const next = !!val;
+        if (this._useRange !== next) {
+            this._useRange = next;
+            this._value = this.clampValue(this._value);
+            this.dispatchEvent('changed');
+        }
+    }
+    /**
+   * Gets the minimum value for this scalar parameter
+   */ get minValue() {
+        return this._minValue;
+    }
+    set minValue(val) {
+        if (val !== this._minValue) {
+            this._minValue = val;
+            this.normalizeRange();
+            this.dispatchEvent('changed');
+        }
+    }
+    /**
+   * Gets the maximum value for this scalar parameter
+   */ get maxValue() {
+        return this._maxValue;
+    }
+    set maxValue(val) {
+        if (val !== this._maxValue) {
+            this._maxValue = val;
+            if (this._maxValue < this._minValue) {
+                this._minValue = this._maxValue;
+            }
+            this._value = this.clampValue(this._value);
+            this.dispatchEvent('changed');
+        }
+    }
+    /**
    * Gets the scalar value
    */ get x() {
         return this._value;
     }
     set x(val) {
-        if (val !== this._value) {
-            this._value = val;
+        const next = this.clampValue(val);
+        if (next !== this._value) {
+            this._value = next;
             this.dispatchEvent('changed');
         }
     }