@dooboostore/simple-boot-http-server 1.0.26 → 1.0.27

package/dist/umd-bundle/websocket-client.umd.js

@@ -55,6 +55,7 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
     Fetcher: () => Fetcher,
     FormValidator: () => FormValidator,
     FunctionUtils: () => FunctionUtils,
+    HashUtils: () => HashUtils,
     HttpFetcher: () => HttpFetcher,
     HttpJsonFetcher: () => HttpJsonFetcher,
     HttpResponseError: () => HttpResponseError,
@@ -135,6 +136,7 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
     isCssCommentItem: () => isCssCommentItem,
     isCssDeclarationItem: () => isCssDeclarationItem,
     isCssRuleItem: () => isCssRuleItem,
+    isDefined: () => isDefined,
     isHttpResponseError: () => isHttpResponseError,
     isPoint2DType: () => isPoint2DType,
     isPoint3DType: () => isPoint3DType,
@@ -2094,6 +2096,12 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
         this.z = z ?? 0;
       }
     }
+    /**
+     * 성분 대입 (파괴적). 벡터 전달 시 그 성분을 복사.
+     * @example
+     * v.set(1, 2, 3);          // v = (1, 2, 3)
+     * v.set(otherVector);      // v = other와 동일 성분
+     */
     set(v, y = 0, z = 0) {
       if (v instanceof _Vector || v instanceof Point3D) {
         this.set(v.x || 0, v.y || 0, v.z || 0);
@@ -2104,16 +2112,45 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
       }
       return this;
     }
+    /**
+     * 복사본 반환 (비파괴). 파괴적 메서드와 조합해 원본 보존용.
+     * @example
+     * const s = a.get(); s.add(b); // s = a+b, a는 그대로
+     */
     get() {
       return new _Vector(this.x, this.y, this.z);
     }
-    // 피타고라스의 정리는 a의 제곱 더하기 b 의 제곱은 c 의 제곱과 같다는 것을 정의합니다.
-    mag() {
+    /**
+     * 노름(norm). 평평한 공간(유클리드 공간)에서의 직선 거리.
+     * - 수식: ‖v‖ = √(x² + y² + z²)
+     * - 2D에서는 피타고라스 정리 그 자체. 3D는 두 번 적용한 것과 같음.
+     *   (바닥 대각선 √(x²+y²) → 공간 대각선 √((바닥)²+z²))
+     * - "유클리드"는 평평한 공간의 기하학을 말함 (좌표계는 데카르트의 것, 유클리드는 좌표 없이 기하학을 세움).
+     *   휘어진 공간(구면·쌍곡)에서는 이 공식이 성립하지 않음.
+     * @example
+     * new Vector(3, 4, 0).norm(); // 5
+     * new Vector(6, 8, 0).norm(); // 10
+     */
+    norm() {
       const x = this.x;
       const y = this.y;
       const z = this.z;
       return Math.sqrt(x * x + y * y + z * z);
     }
+    /**
+     * norm()의 별칭 (p5.js 호환).
+     * @example
+     * new Vector(3, 4, 0).mag(); // 5
+     */
+    mag() {
+      return this.norm();
+    }
+    /**
+     * 덧셈 (파괴적). 성분별 합. 기하학적으로 평행사변형의 대각선.
+     * - 수식: a + b = (ax+bx, ay+by, az+bz)
+     * @example
+     * const a = new Vector(4, 2); a.add(new Vector(-2, 3)); // a = (2, 5)
+     */
     add(v, y = 0, z = 0) {
       if (v instanceof _Vector || v instanceof Point3D) {
         this.x += v.x;
@@ -2125,12 +2162,24 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
         this.z += z;
       }
     }
+    /**
+     * 덧셈 결과의 새 벡터 반환 (비파괴).
+     * - 수식: a + b = (ax+bx, ay+by, az+bz)
+     * @example
+     * const s = a.toAdd(a, b); // s = a+b, a·b는 그대로
+     */
     toAdd(v1, v2) {
       return new _Vector(v1.x + v2.x, v1.y + v2.y, v1.x + v2.y);
     }
     // public static add(v1: Vector, v2: Vector): Vector {
     //   return new Vector(v1.x + v2.x, v1.y + v2.y, v1.x + v2.y);
     // }
+    /**
+     * 뺄셈 (파괴적). a - b는 "a에서 b를 되돌리는" 벡터.
+     * - 수식: a - b = (ax-bx, ay-by, az-bz)
+     * @example
+     * const a = new Vector(4, 2); a.sub(new Vector(1, 1)); // a = (3, 1)
+     */
     sub(v, y = 0, z = 0) {
       if (v instanceof _Vector || v instanceof Point3D) {
         this.x -= v.x;
@@ -2142,6 +2191,12 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
         this.z -= z;
       }
     }
+    /**
+     * 뺄셈 결과의 새 벡터 반환 (비파괴).
+     * - 수식: a - b = (ax-bx, ay-by, az-bz)
+     * @example
+     * const d = a.toSub(b); // d = a-b, a·b는 그대로
+     */
     toSub(v2) {
       const v1 = this;
       return new _Vector(v1.x - v2.x, v1.y - v2.y, v1.z - v2.z);
@@ -2150,6 +2205,12 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
     // public static sub(v1: Vector, v2: Vector): Vector {
     //     return new Vector(v1.x - v2.x, v1.y - v2.y, v1.z - v2.z);
     // }
+    /**
+     * 스칼라배 또는 성분별 곱 (파괴적). 스칼라 k>1이면 늘어나고, 0<k<1이면 줄어듦. k<0이면 반대 방향.
+     * - 수식(스칼라): k·v = (k·x, k·y, k·z)
+     * @example
+     * const v = new Vector(1, 2); v.mult(3); // v = (3, 6)
+     */
     mult(v) {
       if (v instanceof _Vector || v instanceof Point3D) {
         this.x *= v.x;
@@ -2162,6 +2223,12 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
       }
       return this;
     }
+    /**
+     * 성분별 곱 결과의 새 벡터 반환 (비파괴).
+     * - 수식: (ax·bx, ay·by, az·bz)
+     * @example
+     * const m = a.toMult(b); // m = 성분별 곱, a·b는 그대로
+     */
     toMult(v2) {
       const v1 = this;
       return new _Vector(v1.x *= v2.x, v1.y *= v2.y, v1.z *= v2.z);
@@ -2169,6 +2236,12 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
     // public static mult(v1: Vector, v2: Vector) {
     //   return new Vector(v1.x *= v2.x, v1.y *= v2.y, v1.z *= v2.z);
     // }
+    /**
+     * 스칼라 나눗셈 또는 성분별 나눗셈 (파괴적). 정규화의 핵심 연산.
+     * - 수식(스칼라): v/k = (x/k, y/k, z/k)
+     * @example
+     * const v = new Vector(6, 8); v.div(2); // v = (3, 4)
+     */
     div(v) {
       if (v instanceof _Vector || v instanceof Point3D) {
         this.x /= v.x;
@@ -2181,6 +2254,12 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
       }
       return this;
     }
+    /**
+     * 스칼라 나눗셈 결과의 새 벡터 반환 (비파괴).
+     * - 수식: v/k = (x/k, y/k, z/k)
+     * @example
+     * const h = v.toDiv(2); // h = v/2, v는 그대로
+     */
     toDiv(d) {
       const v = this;
       const rv = v.get();
@@ -2196,10 +2275,22 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
     //   rv.z /= d;
     //   return rv;
     // }
+    /**
+     * 두 점(벡터) 사이 거리. 차 벡터의 크기.
+     * - 수식: d = √((dx)² + (dy)² + (dz)²)
+     * @example
+     * new Vector(0, 0).dist(new Vector(3, 4)); // 5
+     */
     dist(v) {
       const dx = this.x - v.x, dy = this.y - v.y, dz = this.z - v.z;
       return Math.sqrt(dx * dx + dy * dy + dz * dz);
     }
+    /**
+     * 두 점(벡터) 사이 거리 (toDist는 dist와 동일, 비파괴).
+     * - 수식: d = √((dx)² + (dy)² + (dz)²)
+     * @example
+     * a.toDist(b); // a와 b 사이 거리
+     */
     toDist(v2) {
       const v1 = this;
       const dx = v1.x - v2.x, dy = v1.y - v2.y, dz = v1.z - v2.z;
@@ -2211,36 +2302,90 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
     //     dz = v1.z - v2.z;
     //   return Math.sqrt(dx * dx + dy * dy + dz * dz);
     // }
-    dot(v, y, z) {
+    /**
+     * 내적(dot product). 두 벡터가 같은 방향을 향하는 정도.
+     * - 수식: a·b = ax·bx + ay·by + az·bz = |a||b|cosθ
+     * - θ=90°면 0(직교), 0°면 최대(같은 방향).
+     * - 벡터 전달 시 y·z 생략 가능, 스칼라(x) 전달 시 y·z와 함께 사용.
+     * @example
+     * new Vector(5, 12).dot(new Vector(-5, 12)); // -25+144 = 119
+     * new Vector(1, 0).dot(new Vector(0, 1));    // 0 (직각)
+     * new Vector(1, 2).dot(3, 4);                // 1*3+2*4 = 11
+     */
+    dot(v, y = 0, z = 0) {
       if (v instanceof _Vector || v instanceof Point3D) {
         return this.x * v.x + this.y * v.y + this.z * v.z;
       }
       ;
       return this.x * v + this.y * y + this.z * z;
     }
+    /**
+     * 외적(cross product). 두 벡터에 수직인 벡터. 오른손 법칙 방향.
+     * - 수식: a×b = (ay·bz − az·by, az·bx − ax·bz, ax·by − ay·bx)
+     * - 2D에서는 z값 = ax·by − ay·bx (부호 있는 면적, 회전 방향 판정용).
+     * @example
+     * new Vector(1, 0, 0).cross(new Vector(0, 1, 0)); // (0, 0, 1)
+     */
     cross(v) {
       const x = this.x, y = this.y, z = this.z;
       return new _Vector(y * v.z - v.y * z, z * v.x - v.z * x, x * v.y - v.x * y);
     }
+    /**
+     * 정규화 (파괴적). 방향은 그대로, 크기를 1로. 단위벡터 v̂ 생성.
+     * - 수식: v̂ = v / |v|
+     * - 영벡터(|v|=0)는 0으로 나누지 않고 그대로 둠.
+     * @example
+     * const v = new Vector(6, 8); v.normalize(); // v = (0.6, 0.8), |v| = 1
+     */
     normalize() {
-      const m = this.mag();
+      const m = this.norm();
       if (m > 0) this.div(m);
     }
+    /**
+     * 크기 상한 (파괴적). 속도가 high를 넘으면 방향 유지한 채 high로 자름. 물리 시뮬레이션 최고속도용.
+     * - 수식: |v| > high → v = v̂ · high
+     * @example
+     * const v = new Vector(6, 8); v.limit(5); // |v|=10 → 5, v = (3, 4)
+     */
     limit(high) {
-      if (this.mag() > high) {
+      if (this.norm() > high) {
         this.normalize();
         this.mult(high);
       }
     }
+    /**
+     * 2D 방향각. +x축 기준 반시계 방향 라디안 (-π ~ π).
+     * - 수식: θ = atan2(y, x)
+     * @example
+     * new Vector(1, 1).heading2D();  // π/4 (45°)
+     * new Vector(-1, 0).heading2D(); // π (180°)
+     */
     heading2D() {
       return -Math.atan2(-this.y, this.x);
     }
+    /**
+     * 무작위 방향 단위벡터 반환 (새 Vector, 자신은 변경 안 함).
+     * @example
+     * const r = new Vector().random2D(); // |r| = 1, 방향 랜덤
+     */
     random2D() {
       return this.fromAngle(Math.random() * (2 * Math.PI));
     }
+    /**
+     * 각도→벡터. 각도 θ, 길이 L인 2D 벡터 반환 (새 Vector).
+     * - 수식: (L·cosθ, L·sinθ, 0)
+     * @example
+     * new Vector().fromAngle(Math.PI / 3, 2); // (1, 1.73, 0)
+     */
     fromAngle(angle, length = 1) {
       return new _Vector(length * Math.cos(angle), length * Math.sin(angle), 0);
     }
+    /**
+     * 구면좌표→3D 벡터 (새 Vector 반환, p5.js 컨벤션).
+     * - 수식: (L·sinθ·sinφ, −L·cosθ, L·sinθ·cosφ)
+     * @example
+     * new Vector().fromAngles(Math.PI / 2, Math.PI / 2, 1); // (1, 0, 0)
+     */
     fromAngles(theta, phi, length = 1) {
       const cosPhi = Math.cos(phi);
       const sinPhi = Math.sin(phi);
@@ -2252,18 +2397,43 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
         length * sinTheta * cosPhi
       );
     }
+    /**
+     * 성분 배열 반환. [x, y, z] 순서.
+     * @example
+     * new Vector(1, 2, 3).array(); // [1, 2, 3]
+     */
     array() {
       return [this.x, this.y, this.z];
     }
+    /**
+     * Point3D로 변환 (위치 의미로 바꿀 때).
+     * @example
+     * new Vector(1, 2, 3).toPoint3D(); // Point3D(1, 2, 3)
+     */
     toPoint3D() {
       return new Point3D(this.x, this.y, this.z);
     }
+    /**
+     * Point2D로 변환 (z 버림).
+     * @example
+     * new Vector(1, 2, 3).toPoint2D(); // Point2D(1, 2)
+     */
     toPoint2D() {
       return new Point2D(this.x, this.y);
     }
+    /**
+     * 복사본 반환 (get()과 동일, 비파괴).
+     * @example
+     * const c = v.copy(); // v와 같은 성분의 새 벡터
+     */
     copy() {
       return new _Vector(this.x, this.y, this.z);
     }
+    /**
+     * 문자열 표현. "[x, y, z]" 형식.
+     * @example
+     * new Vector(1, 2).toString(); // "[1, 2, 0]"
+     */
     toString() {
       return "[" + this.x + ", " + this.y + ", " + this.z + "]";
     }
@@ -7109,7 +7279,7 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
 
   // ../core/dist/esm/url/UrlUtils.js
   var UrlUtils;
-  ((UrlUtils2) => {
+  (function(UrlUtils2) {
     UrlUtils2.origin = (fullurl) => {
       return new URL(fullurl).origin;
     };
@@ -7147,15 +7317,28 @@ var dooboostoreSimpleBootHttpServerWebSocketClient = (() => {
       });
       return searchParams;
     };
+    UrlUtils2.toAbsoluteUrl = (relative, base) => {
+      return new URL(relative, base);
+    };
+    function toAbsoluteRequest(input, base) {
+      if (input instanceof URL) {
+        return UrlUtils2.toAbsoluteUrl(input.href, base);
+      }
+      if (typeof input === "string") {
+        return UrlUtils2.toAbsoluteUrl(input, base).href;
+      }
+      return new Request(UrlUtils2.toAbsoluteUrl(input.url, base).href, input);
+    }
+    UrlUtils2.toAbsoluteRequest = toAbsoluteRequest;
     UrlUtils2.manipulateSearchParams = (searchParams, options) => {
       if (options?.delete) {
-        (0, UrlUtils2.deleteSearchParam)(searchParams, options.delete);
+        UrlUtils2.deleteSearchParam(searchParams, options.delete);
       }
       if (options?.append) {
-        (0, UrlUtils2.appendSearchParam)(searchParams, options.append);
+        UrlUtils2.appendSearchParam(searchParams, options.append);
       }
       if (options?.upsert) {
-        (0, UrlUtils2.upsertSearchParam)(searchParams, options.upsert);
+        UrlUtils2.upsertSearchParam(searchParams, options.upsert);
       }
       return searchParams;
     };
@@ -9549,6 +9732,23 @@ ${indentStr}}`;
     };
   }
 
+  // ../core/dist/esm/hash/HashUtils.js
+  var HashUtils;
+  ((HashUtils2) => {
+    const core53 = (str, seed) => {
+      let h1 = 3735928559 ^ seed, h2 = 1103547991 ^ seed;
+      for (let i = 0; i < str.length; i++) {
+        const ch = str.charCodeAt(i);
+        h1 = Math.imul(h1 ^ ch, 2654435761);
+        h2 = Math.imul(h2 ^ ch, 1597334677);
+      }
+      h1 = Math.imul(h1 ^ h1 >>> 16, 2246822507) ^ Math.imul(h2 ^ h2 >>> 13, 3266489909);
+      h2 = Math.imul(h2 ^ h2 >>> 16, 2246822507) ^ Math.imul(h1 ^ h1 >>> 13, 3266489909);
+      return (4294967296 * (2097151 & h2) + (h1 >>> 0)).toString(16).padStart(14, "0");
+    };
+    HashUtils2.hash53 = (str, seed = 0, xyz = 16) => `${core53(str, seed)}${core53(str, seed + 1)}`.slice(0, Math.max(1, xyz));
+  })(HashUtils || (HashUtils = {}));
+
   // ../core/dist/esm/message/operators/filter.js
   function filter(predicate) {
     return (source) => {