@next2d/geom 1.18.11 → 2.0.0

package/package.json

@@ -1,26 +1,18 @@
 {
   "name": "@next2d/geom",
-  "version": "1.18.11",
-  "description": "Next2D Geom Packages",
-  "author": "Toshiyuki Ienaga<ienaga@tvon.jp> (https://github.com/ienaga/)",
+  "version": "2.0.0",
+  "description": "Next2D Geom Package",
+  "author": "Toshiyuki Ienaga<ienaga@next2d.app> (https://github.com/ienaga/)",
   "license": "MIT",
   "homepage": "https://next2d.app",
   "bugs": "https://github.com/Next2D/Player/issues",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "type": "module",
   "exports": {
     ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      }
+      "import": "./src/index.js",
+      "require": "./src/index.js"
     }
   },
   "keywords": [
@@ -30,13 +22,5 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Next2D/Player.git"
-  },
-  "peerDependencies": {
-    "@next2d/interface": "1.18.11",
-    "@next2d/display": "1.18.11",
-    "@next2d/core": "1.18.11",
-    "@next2d/util": "1.18.11",
-    "@next2d/filters": "1.18.11",
-    "@next2d/share": "1.18.11"
   }
 }

package/src/ColorTransform/service/ColorTransformConcatService.d.ts

@@ -0,0 +1,12 @@
+import { ColorTransform } from "../../ColorTransform";
+/**
+ * @description 指定のColorTransformを連結
+ *              Concatenate the specified ColorTransform
+ *
+ * @param  {ColorTransform} color_transform1
+ * @param  {ColorTransform} color_transform2
+ * @return {void}
+ * @method
+ * @public
+ */
+export declare const execute: (color_transform1: ColorTransform, color_transform2: ColorTransform) => void;

package/src/ColorTransform/service/ColorTransformConcatService.js

@@ -0,0 +1,25 @@
+import { ColorTransform } from "../../ColorTransform";
+/**
+ * @description 指定のColorTransformを連結
+ *              Concatenate the specified ColorTransform
+ *
+ * @param  {ColorTransform} color_transform1
+ * @param  {ColorTransform} color_transform2
+ * @return {void}
+ * @method
+ * @public
+ */
+export const execute = (color_transform1, color_transform2) => {
+    const multiColor = ColorTransform.multiply(color_transform1._$colorTransform, color_transform2._$colorTransform);
+    // update
+    color_transform1._$colorTransform[0] = multiColor[0];
+    color_transform1._$colorTransform[1] = multiColor[1];
+    color_transform1._$colorTransform[2] = multiColor[2];
+    color_transform1._$colorTransform[3] = multiColor[3];
+    color_transform1._$colorTransform[4] = multiColor[4];
+    color_transform1._$colorTransform[5] = multiColor[5];
+    color_transform1._$colorTransform[6] = multiColor[6];
+    color_transform1._$colorTransform[7] = multiColor[7];
+    // pool
+    ColorTransform.release(multiColor);
+};

package/{dist → src}/ColorTransform.d.ts

@@ -1,31 +1,35 @@
 /**
- * ColorTransform クラスを使用すると、表示オブジェクトのカラー値を調整することができます。
- * カラー調整、つまり "カラー変換" は、赤、緑、青、アルファ透明度の 4 つのチャンネルすべてに適用できます。
- * <ul>
- *     <li>新しい red 値 = (古い red 値 * redMultiplier ) + redOffset</li>
- *     <li>新しい green 値 = (古い green 値 * greenMultiplier ) + greenOffset</li>
- *     <li>新しい blue 値 = (古い blue 値 * blueMultiplier ) + blueOffset</li>
- *     <li>新しい alpha 値 = (古い alpha 値 * alphaMultiplier ) + alphaOffset</li>
- * </ul>
- * 算出後、カラーチャンネル値が 255 よりも大きい場合は 255 に設定されます。
- * 0 より小さい場合は 0 に設定されます。
+ * @description ColorTransform クラスを使用すると、表示オブジェクトのカラー値を調整することができます。
+ *              カラー調整、つまり "カラー変換" は、赤、緑、青、アルファ透明度の 4 つのチャンネルすべてに適用できます。
+ *              <ul>
+ *                  <li>新しい red 値 = (古い red 値 * redMultiplier ) + redOffset</li>
+ *                  <li>新しい green 値 = (古い green 値 * greenMultiplier ) + greenOffset</li>
+ *                  <li>新しい blue 値 = (古い blue 値 * blueMultiplier ) + blueOffset</li>
+ *                  <li>新しい alpha 値 = (古い alpha 値 * alphaMultiplier ) + alphaOffset</li>
+ *              </ul>
+ *              算出後、カラーチャンネル値が 255 よりも大きい場合は 255 に設定されます。
+ *              0 より小さい場合は 0 に設定されます。
  *
- * The ColorTransform class lets you adjust the color values in a display object.
- * The color adjustment or color transformation can be applied
- * to all four channels: red, green, blue, and alpha transparency.
- * <ul>
- *     <li>New red value = (old red value * redMultiplier) + redOffset</li>
- *     <li>New green value = (old green value * greenMultiplier) + greenOffset</li>
- *     <li>New blue value = (old blue value * blueMultiplier) + blueOffset</li>
- *     <li>New alpha value = (old alpha value * alphaMultiplier) + alphaOffset</li>
- * </ul>
- * If any of the color channel values is greater than 255 after the calculation,
- * it is set to 255. If it is less than 0, it is set to 0.
+ *              The ColorTransform class lets you adjust the color values in a display object.
+ *              The color adjustment or color transformation can be applied
+ *              to all four channels: red, green, blue, and alpha transparency.
+ *              <ul>
+ *                  <li>New red value = (old red value * redMultiplier) + redOffset</li>
+ *                  <li>New green value = (old green value * greenMultiplier) + greenOffset</li>
+ *                  <li>New blue value = (old blue value * blueMultiplier) + blueOffset</li>
+ *               <li>New alpha value = (old alpha value * alphaMultiplier) + alphaOffset</li>
+ *              </ul>
+ *              If any of the color channel values is greater than 255 after the calculation,
+ *              it is set to 255. If it is less than 0, it is set to 0.
  *
  * @class
  * @memberOf next2d.geom
  */
 export declare class ColorTransform {
+    /**
+     * @type {Float32Array}
+     * @private
+     */
     readonly _$colorTransform: Float32Array;
     /**
      * @param {number} [red_multiplier=1]
@@ -37,58 +41,19 @@ export declare class ColorTransform {
      * @param {number} [blue_offset=0]
      * @param {number} [alpha_offset=0]
      *
-     * @example <caption>Example usage of ColorTransform.</caption>
-     * // new ColorTransform
-     * const {ColorTransform} = next2d.geom;
-     * const colorTransform   = new ColorTransform();
-     * // set new ColorTransform
-     * const {MovieClip} = next2d.display;
-     * const movieClip   = new MovieClip();
-     * movieClip.transform.colorTransform = colorTransform;
-     *
      * @constructor
      * @public
      */
     constructor(red_multiplier?: number, green_multiplier?: number, blue_multiplier?: number, alpha_multiplier?: number, red_offset?: number, green_offset?: number, blue_offset?: number, alpha_offset?: number);
     /**
-     * 指定されたクラスのストリングを返します。
-     * Returns the string representation of the specified class.
-     *
-     * @return  {string}
-     * @default [class ColorTransform]
-     * @method
-     * @static
-     */
-    static toString(): string;
-    /**
-     * @description 指定されたクラスの空間名を返します。
-     *              Returns the space name of the specified class.
+     * @description ColorTransform の内部Float32Arrayデータを返却
+     *              Returns the internal Float32Array data of ColorTransform
      *
-     * @member {string}
-     * @default next2d.geom.ColorTransform
-     * @const
-     * @static
-     */
-    static get namespace(): string;
-    /**
-     * @description 指定されたオブジェクトのストリングを返します。
-     *              Returns the string representation of the specified object.
-     *
-     * @return {string}
-     * @method
+     * @member {Float32Array}
+     * @readonly
      * @public
      */
-    toString(): string;
-    /**
-     * @description 指定されたオブジェクトの空間名を返します。
-     *              Returns the space name of the specified object.
-     *
-     * @member  {string}
-     * @default next2d.geom.ColorTransform
-     * @const
-     * @public
-     */
-    get namespace(): string;
+    get rawData(): Float32Array;
     /**
      * @description アルファ透明度チャンネル値に乗算する 10 進数値です。
      *              A decimal value that is multiplied with the alpha transparency channel value.
@@ -177,6 +142,15 @@ export declare class ColorTransform {
      */
     get redOffset(): number;
     set redOffset(red_offset: number);
+    /**
+     * @description オブジェクトの複製を返します。
+     *              Returns a copy of this ColorTransform object.
+     *
+     * @return {ColorTransform}
+     * @method
+     * @public
+     */
+    clone(): ColorTransform;
     /**
      * @description 2 番目のパラメーターで指定された ColorTransform オブジェクトと
      *              現在の ColorTransform オブジェクトを連結し
@@ -186,16 +160,30 @@ export declare class ColorTransform {
      *              and sets the current object as the result,
      *              which is an additive combination of the two color transformations.
      *
-     * @param  {ColorTransform} second - ColorTransformオブジェクト
+     * @param  {ColorTransform} color_transform
      * @return {void}
      * @method
      * @public
      */
-    concat(second: ColorTransform): void;
+    concat(color_transform: ColorTransform): void;
     /**
-     * @return {ColorTransform}
+     * @description 指定された配列の値を乗算します
+     *              Multiplies the value of the specified array.
+     *
+     * @param  {Float32Array} a
+     * @param  {Float32Array} b
+     * @return {Float32Array}
+     * @method
+     * @private
+     */
+    static multiply(a: Float32Array, b: Float32Array): Float32Array;
+    /**
+     * @description 利用したFloat32Arrayを再利用する為にプールします。
+     *              Pool the Float32Array used for reuse.
+     *
+     * @param {Float32Array} buffer
      * @method
      * @private
      */
-    _$clone(): ColorTransform;
+    static release(buffer: Float32Array): void;
 }

package/src/ColorTransform.js

@@ -0,0 +1,240 @@
+import { execute as colorTransformConcatService } from "../src/ColorTransform/service/ColorTransformConcatService";
+import { $getFloat32Array8, $poolFloat32Array8, $clamp } from "./GeomUtil";
+/**
+ * @description ColorTransform クラスを使用すると、表示オブジェクトのカラー値を調整することができます。
+ *              カラー調整、つまり "カラー変換" は、赤、緑、青、アルファ透明度の 4 つのチャンネルすべてに適用できます。
+ *              <ul>
+ *                  <li>新しい red 値 = (古い red 値 * redMultiplier ) + redOffset</li>
+ *                  <li>新しい green 値 = (古い green 値 * greenMultiplier ) + greenOffset</li>
+ *                  <li>新しい blue 値 = (古い blue 値 * blueMultiplier ) + blueOffset</li>
+ *                  <li>新しい alpha 値 = (古い alpha 値 * alphaMultiplier ) + alphaOffset</li>
+ *              </ul>
+ *              算出後、カラーチャンネル値が 255 よりも大きい場合は 255 に設定されます。
+ *              0 より小さい場合は 0 に設定されます。
+ *
+ *              The ColorTransform class lets you adjust the color values in a display object.
+ *              The color adjustment or color transformation can be applied
+ *              to all four channels: red, green, blue, and alpha transparency.
+ *              <ul>
+ *                  <li>New red value = (old red value * redMultiplier) + redOffset</li>
+ *                  <li>New green value = (old green value * greenMultiplier) + greenOffset</li>
+ *                  <li>New blue value = (old blue value * blueMultiplier) + blueOffset</li>
+ *               <li>New alpha value = (old alpha value * alphaMultiplier) + alphaOffset</li>
+ *              </ul>
+ *              If any of the color channel values is greater than 255 after the calculation,
+ *              it is set to 255. If it is less than 0, it is set to 0.
+ *
+ * @class
+ * @memberOf next2d.geom
+ */
+export class ColorTransform {
+    /**
+     * @param {number} [red_multiplier=1]
+     * @param {number} [green_multiplier=1]
+     * @param {number} [blue_multiplier=1]
+     * @param {number} [alpha_multiplier=1]
+     * @param {number} [red_offset=0]
+     * @param {number} [green_offset=0]
+     * @param {number} [blue_offset=0]
+     * @param {number} [alpha_offset=0]
+     *
+     * @constructor
+     * @public
+     */
+    constructor(red_multiplier = 1, green_multiplier = 1, blue_multiplier = 1, alpha_multiplier = 1, red_offset = 0, green_offset = 0, blue_offset = 0, alpha_offset = 0) {
+        /**
+         * @type {Float32Array}
+         * @private
+         */
+        Object.defineProperty(this, "_$colorTransform", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this._$colorTransform = $getFloat32Array8(red_multiplier, green_multiplier, blue_multiplier, alpha_multiplier, red_offset, green_offset, blue_offset, alpha_offset);
+    }
+    /**
+     * @description ColorTransform の内部Float32Arrayデータを返却
+     *              Returns the internal Float32Array data of ColorTransform
+     *
+     * @member {Float32Array}
+     * @readonly
+     * @public
+     */
+    get rawData() {
+        return this._$colorTransform;
+    }
+    /**
+     * @description アルファ透明度チャンネル値に乗算する 10 進数値です。
+     *              A decimal value that is multiplied with the alpha transparency channel value.
+     *
+     * @member {number}
+     * @default 1
+     * @public
+     */
+    get alphaMultiplier() {
+        return this._$colorTransform[3];
+    }
+    set alphaMultiplier(alpha_multiplier) {
+        this._$colorTransform[3] = $clamp(alpha_multiplier, 0, 1, 1);
+    }
+    /**
+     * @description アルファ透明度チャンネル値に alphaMultiplier 値を乗算した後に加算する数値です。
+     *              数値の範囲は -255 ～ 255 です。
+     *              A number from -255 to 255 that is added to the alpha transparency channel value after
+     *              it has been multiplied by the alphaMultiplier value.
+     *
+     * @member {number}
+     * @default 0
+     * @public
+     */
+    get alphaOffset() {
+        return this._$colorTransform[7];
+    }
+    set alphaOffset(alpha_offset) {
+        this._$colorTransform[7] = $clamp(alpha_offset, -255, 255, 0);
+    }
+    /**
+     * @description 青チャンネル値に乗算する 10 進数値です。
+     *              A decimal value that is multiplied with the blue channel value.
+     *
+     * @member {number}
+     * @default 1
+     * @public
+     */
+    get blueMultiplier() {
+        return this._$colorTransform[2];
+    }
+    set blueMultiplier(blue_multiplier) {
+        this._$colorTransform[2] = $clamp(blue_multiplier, 0, 1, 1);
+    }
+    /**
+     * @description 青チャンネル値に blueMultiplier 値を乗算した後に加算する数値です。
+     *              数値の範囲は -255 ～ 255 です。
+     *              A number from -255 to 255 that is added to the blue channel value after
+     *              it has been multiplied by the blueMultiplier value.
+     *
+     * @member {number}
+     * @default 0
+     * @public
+     */
+    get blueOffset() {
+        return this._$colorTransform[6];
+    }
+    set blueOffset(blue_offset) {
+        this._$colorTransform[6] = $clamp(blue_offset, -255, 255, 0);
+    }
+    /**
+     * @description 緑チャンネル値に乗算する 10 進数値です。
+     *              A decimal value that is multiplied with the green channel value.
+     *
+     * @member {number}
+     * @default 1
+     * @public
+     */
+    get greenMultiplier() {
+        return this._$colorTransform[1];
+    }
+    set greenMultiplier(green_multiplier) {
+        this._$colorTransform[1] = $clamp(green_multiplier, 0, 1, 1);
+    }
+    /**
+     * @description 緑チャンネル値に greenMultiplier 値を乗算した後に加算する数値です。
+     *              数値の範囲は -255 ～ 255 です。
+     *              A number from -255 to 255 that is added to the green channel value after
+     *              it has been multiplied by the greenMultiplier value.
+     *
+     * @member {number}
+     * @default 0
+     * @public
+     */
+    get greenOffset() {
+        return this._$colorTransform[5];
+    }
+    set greenOffset(green_offset) {
+        this._$colorTransform[5] = $clamp(green_offset, -255, 255, 0);
+    }
+    /**
+     * @description 赤チャンネル値に乗算する 10 進数値です。
+     *              A decimal value that is multiplied with the red channel value.
+     *
+     * @member {number}
+     * @default 1
+     * @public
+     */
+    get redMultiplier() {
+        return this._$colorTransform[0];
+    }
+    set redMultiplier(red_multiplier) {
+        this._$colorTransform[0] = $clamp(red_multiplier, 0, 1, 1);
+    }
+    /**
+     * @description 赤チャンネル値に redMultiplier 値を乗算した後に加算する数値です。
+     *              数値の範囲は -255 ～ 255 です。
+     *              A number from -255 to 255 that is added to the red channel value after
+     *              it has been multiplied by the redMultiplier value.
+     *
+     * @member {number}
+     * @default 0
+     * @public
+     */
+    get redOffset() {
+        return this._$colorTransform[4];
+    }
+    set redOffset(red_offset) {
+        this._$colorTransform[4] = $clamp(red_offset, -255, 255, 0);
+    }
+    /**
+     * @description オブジェクトの複製を返します。
+     *              Returns a copy of this ColorTransform object.
+     *
+     * @return {ColorTransform}
+     * @method
+     * @public
+     */
+    clone() {
+        return new ColorTransform(...this._$colorTransform);
+    }
+    /**
+     * @description 2 番目のパラメーターで指定された ColorTransform オブジェクトと
+     *              現在の ColorTransform オブジェクトを連結し
+     *              2 つのカラー変換を加算的に組み合わせた結果を現在のオブジェクトに設定します。
+     *              Concatenates the ColorTransform object specified
+     *              by the second parameter with the current ColorTransform object
+     *              and sets the current object as the result,
+     *              which is an additive combination of the two color transformations.
+     *
+     * @param  {ColorTransform} color_transform
+     * @return {void}
+     * @method
+     * @public
+     */
+    concat(color_transform) {
+        colorTransformConcatService(this, color_transform);
+    }
+    /**
+     * @description 指定された配列の値を乗算します
+     *              Multiplies the value of the specified array.
+     *
+     * @param  {Float32Array} a
+     * @param  {Float32Array} b
+     * @return {Float32Array}
+     * @method
+     * @private
+     */
+    static multiply(a, b) {
+        return $getFloat32Array8(a[0] * b[0], a[1] * b[1], a[2] * b[2], a[3] * b[3], a[0] * b[4] + a[4], a[1] * b[5] + a[5], a[2] * b[6] + a[6], a[3] * b[7] + a[7]);
+    }
+    /**
+     * @description 利用したFloat32Arrayを再利用する為にプールします。
+     *              Pool the Float32Array used for reuse.
+     *
+     * @param {Float32Array} buffer
+     * @method
+     * @private
+     */
+    static release(buffer) {
+        $poolFloat32Array8(buffer);
+    }
+}

package/src/GeomUtil.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @description オブジェクトプールから Float32Array オブジェクトを取得します。
+ *              Get a Float32Array object from the object pool.
+ *
+ * @param  {number} [f0=0]
+ * @param  {number} [f1=0]
+ * @param  {number} [f2=0]
+ * @param  {number} [f3=0]
+ * @param  {number} [f4=0]
+ * @param  {number} [f5=0]
+ * @return {Float32Array}
+ * @method
+ * @private
+ */
+export declare const $getFloat32Array6: (f0?: number, f1?: number, f2?: number, f3?: number, f4?: number, f5?: number) => Float32Array;
+/**
+ * @description 再利用する為に、オブジェクトプールに Float32Array オブジェクトを追加します。
+ *              Add a Float32Array object to the object pool for reuse.
+ *
+ * @param {Float32Array} array
+ * @method
+ * @private
+ */
+export declare const $poolFloat32Array6: (array: Float32Array) => void;
+/**
+ * @description オブジェクトプールから Float32Array オブジェクトを取得します。
+ *              Get a Float32Array object from the object pool.
+ *
+ * @param  {number} [f0=0]
+ * @param  {number} [f1=0]
+ * @param  {number} [f2=0]
+ * @param  {number} [f3=0]
+ * @param  {number} [f4=0]
+ * @param  {number} [f5=0]
+ * @param  {number} [f6=0]
+ * @param  {number} [f7=0]
+ * @return {Float32Array}
+ * @method
+ * @private
+ */
+export declare const $getFloat32Array8: (f0?: number, f1?: number, f2?: number, f3?: number, f4?: number, f5?: number, f6?: number, f7?: number) => Float32Array;
+/**
+ * @description 再利用する為に、オブジェクトプールに Float32Array オブジェクトを追加します。
+ *              Add a Float32Array object to the object pool for reuse.
+ *
+ * @param {Float32Array} array
+ * @method
+ * @private
+ */
+export declare const $poolFloat32Array8: (array: Float32Array) => void;
+/**
+ * @description 値が最小値と最大値の間に収まるように調整します。
+ *              Adjust the value so that it falls between the minimum and maximum values.
+ *
+ * @param  {number} value
+ * @param  {number} min
+ * @param  {number} max
+ * @param  {number} [default_value=null]
+ * @return {number}
+ * @method
+ * @static
+ */
+export declare const $clamp: (value: number, min: number, max: number, default_value?: number | null) => number;

package/src/GeomUtil.js

@@ -0,0 +1,102 @@
+/**
+ * @type {Float32Array[]}
+ * @private
+ */
+const $objectPool6 = [];
+/**
+ * @description オブジェクトプールから Float32Array オブジェクトを取得します。
+ *              Get a Float32Array object from the object pool.
+ *
+ * @param  {number} [f0=0]
+ * @param  {number} [f1=0]
+ * @param  {number} [f2=0]
+ * @param  {number} [f3=0]
+ * @param  {number} [f4=0]
+ * @param  {number} [f5=0]
+ * @return {Float32Array}
+ * @method
+ * @private
+ */
+export const $getFloat32Array6 = (f0 = 1, f1 = 0, f2 = 0, f3 = 1, f4 = 0, f5 = 0) => {
+    const array = $objectPool6.pop() || new Float32Array(6);
+    array[0] = f0;
+    array[1] = f1;
+    array[2] = f2;
+    array[3] = f3;
+    array[4] = f4;
+    array[5] = f5;
+    return array;
+};
+/**
+ * @description 再利用する為に、オブジェクトプールに Float32Array オブジェクトを追加します。
+ *              Add a Float32Array object to the object pool for reuse.
+ *
+ * @param {Float32Array} array
+ * @method
+ * @private
+ */
+export const $poolFloat32Array6 = (array) => {
+    $objectPool6.push(array);
+};
+/**
+ * @type {Float32Array[]}
+ * @private
+ */
+const $objectPool8 = [];
+/**
+ * @description オブジェクトプールから Float32Array オブジェクトを取得します。
+ *              Get a Float32Array object from the object pool.
+ *
+ * @param  {number} [f0=0]
+ * @param  {number} [f1=0]
+ * @param  {number} [f2=0]
+ * @param  {number} [f3=0]
+ * @param  {number} [f4=0]
+ * @param  {number} [f5=0]
+ * @param  {number} [f6=0]
+ * @param  {number} [f7=0]
+ * @return {Float32Array}
+ * @method
+ * @private
+ */
+export const $getFloat32Array8 = (f0 = 1, f1 = 1, f2 = 1, f3 = 1, f4 = 0, f5 = 0, f6 = 0, f7 = 0) => {
+    const array = $objectPool8.pop() || new Float32Array(8);
+    array[0] = f0;
+    array[1] = f1;
+    array[2] = f2;
+    array[3] = f3;
+    array[4] = f4;
+    array[5] = f5;
+    array[6] = f6;
+    array[7] = f7;
+    return array;
+};
+/**
+ * @description 再利用する為に、オブジェクトプールに Float32Array オブジェクトを追加します。
+ *              Add a Float32Array object to the object pool for reuse.
+ *
+ * @param {Float32Array} array
+ * @method
+ * @private
+ */
+export const $poolFloat32Array8 = (array) => {
+    $objectPool8.push(array);
+};
+/**
+ * @description 値が最小値と最大値の間に収まるように調整します。
+ *              Adjust the value so that it falls between the minimum and maximum values.
+ *
+ * @param  {number} value
+ * @param  {number} min
+ * @param  {number} max
+ * @param  {number} [default_value=null]
+ * @return {number}
+ * @method
+ * @static
+ */
+export const $clamp = (value, min, max, default_value = null) => {
+    const number = +value;
+    return isNaN(number) && default_value !== null
+        ? default_value
+        : Math.min(Math.max(min, isNaN(number) ? 0 : number), max);
+};

package/src/Matrix/service/MatirxConcatService.d.ts

@@ -0,0 +1,12 @@
+import type { Matrix } from "../../Matrix";
+/**
+ * @description 指定のMatrixを連結
+ *              Concatenate specified Matrix
+ *
+ * @param  {Matrix} matrix1
+ * @param  {Matrix} matrix2
+ * @return {void}
+ * @method
+ * @public
+ */
+export declare const execute: (matrix1: Matrix, matrix2: Matrix) => void;