@dooboostore/dom-render 1.0.114 → 1.0.115

package/dist/esm-bundle/dooboostore-dom-render.esm.js

@@ -28,9 +28,9 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 
-// ../../node_modules/.pnpm/reflect-metadata@0.2.2/node_modules/reflect-metadata/Reflect.js
+// ../../../node_modules/.pnpm/reflect-metadata@0.2.2/node_modules/reflect-metadata/Reflect.js
 var require_Reflect = __commonJS({
-  "../../node_modules/.pnpm/reflect-metadata@0.2.2/node_modules/reflect-metadata/Reflect.js"() {
+  "../../../node_modules/.pnpm/reflect-metadata@0.2.2/node_modules/reflect-metadata/Reflect.js"() {
     var Reflect2;
     (function(Reflect3) {
       (function(factory) {
@@ -1232,6 +1232,7 @@ __export(esm_exports, {
   Fetcher: () => Fetcher,
   FormValidator: () => FormValidator,
   FunctionUtils: () => FunctionUtils,
+  HashUtils: () => HashUtils,
   HttpFetcher: () => HttpFetcher,
   HttpJsonFetcher: () => HttpJsonFetcher,
   HttpResponseError: () => HttpResponseError,
@@ -1312,6 +1313,7 @@ __export(esm_exports, {
   isCssCommentItem: () => isCssCommentItem,
   isCssDeclarationItem: () => isCssDeclarationItem,
   isCssRuleItem: () => isCssRuleItem,
+  isDefined: () => isDefined,
   isHttpResponseError: () => isHttpResponseError,
   isPoint2DType: () => isPoint2DType,
   isPoint3DType: () => isPoint3DType,
@@ -1357,6 +1359,12 @@ var ValidUtils;
       return false;
     }
   };
+  ValidUtils22.isGenerator = (value) => {
+    return value !== null && typeof value === "object" && typeof value.next === "function" && typeof value[Symbol.iterator] === "function";
+  };
+  ValidUtils22.isAsyncGenerator = (value) => {
+    return value !== null && typeof value === "object" && typeof value.next === "function" && typeof value[Symbol.asyncIterator] === "function";
+  };
   ValidUtils22.isFrozen = (obj) => {
     return Object.isFrozen(obj);
   };
@@ -3271,6 +3279,12 @@ var Vector = class _Vector {
       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);
@@ -3281,16 +3295,45 @@ var Vector = class _Vector {
     }
     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;
@@ -3302,12 +3345,24 @@ var Vector = class _Vector {
       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;
@@ -3319,6 +3374,12 @@ var Vector = class _Vector {
       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);
@@ -3327,6 +3388,12 @@ var Vector = class _Vector {
   // 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;
@@ -3339,6 +3406,12 @@ var Vector = class _Vector {
     }
     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);
@@ -3346,6 +3419,12 @@ var Vector = class _Vector {
   // 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;
@@ -3358,6 +3437,12 @@ var Vector = class _Vector {
     }
     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();
@@ -3373,10 +3458,22 @@ var Vector = class _Vector {
   //   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;
@@ -3388,36 +3485,90 @@ var Vector = class _Vector {
   //     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);
@@ -3429,18 +3580,43 @@ var Vector = class _Vector {
       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 + "]";
   }
@@ -5633,87 +5809,64 @@ var throttle = (fn, delay) => {
 // ../core/dist/esm/promise/AbortablePromise.js
 var AbortablePromise = class _AbortablePromise {
   constructor(executor, signal) {
-    this.steps = [];
-    this.initialExecutor = executor;
     this.signal = signal;
+    if (typeof executor !== "function") {
+      this.source = Promise.resolve(executor);
+    } else if (signal?.aborted) {
+      this.source = Promise.reject(signal.reason);
+    } else {
+      this.source = Promise.resolve().then(executor);
+    }
+  }
+  /**
+   * source 를 abort 와 경쟁시킨 promise. 실제로 소비될 때(then/toPromise) 한 번만 만든다 —
+   * await 는 then() 이 돌려준 새 인스턴스를 버리므로, 미리 만들면 아무도 안 받는 reject 가 unhandled 로 남는다.
+   */
+  get promise() {
+    if (this.guarded) return this.guarded;
+    const signal = this.signal;
+    if (!signal) return this.guarded = this.source;
+    if (signal.aborted) {
+      this.source.catch(() => {
+      });
+      return this.guarded = Promise.reject(signal.reason);
+    }
+    return this.guarded = new Promise((resolve, reject) => {
+      const cleanup = () => signal.removeEventListener("abort", onAbort);
+      const onAbort = () => reject(signal.reason);
+      signal.addEventListener("abort", onAbort, { once: true });
+      this.source.then(
+        (value) => {
+          cleanup();
+          resolve(value);
+        },
+        (reason) => {
+          cleanup();
+          reject(reason);
+        }
+      );
+    });
   }
   then(onfulfilled, onrejected) {
-    const newPromise = new _AbortablePromise(
-      this.initialExecutor,
-      this.signal
+    const signal = this.signal;
+    const next = this.promise.then(
+      onfulfilled ? (value) => {
+        if (signal?.aborted) throw signal.reason;
+        return onfulfilled(value);
+      } : void 0,
+      onrejected
     );
-    newPromise.steps = [...this.steps];
-    if (onfulfilled) {
-      newPromise.steps.push(onfulfilled);
-    }
-    if (onrejected) {
-      newPromise.errorHandler = onrejected;
-    } else if (this.errorHandler) {
-      newPromise.errorHandler = this.errorHandler;
-    }
-    return newPromise;
+    return new _AbortablePromise(next, signal);
   }
   catch(onrejected) {
     return this.then(void 0, onrejected);
   }
   finally(onfinally) {
-    return this.then(
-      (value) => {
-        onfinally?.();
-        return value;
-      },
-      (reason) => {
-        onfinally?.();
-        throw reason;
-      }
-    );
-  }
-  async execute() {
-    try {
-      if (this.signal?.aborted) {
-        throw new Error(this.signal.reason || "Aborted");
-      }
-      const abortPromise = new Promise((_, reject) => {
-        if (this.signal?.aborted) {
-          return reject(new Error(this.signal.reason || "Aborted"));
-        }
-        const callback = (e) => {
-          const target = e.target;
-          this.signal?.removeEventListener("abort", callback);
-          reject(new Error(target.reason || "Aborted"));
-        };
-        this.signal?.addEventListener("abort", callback, { once: true });
-      });
-      const pipelineRunner = async () => {
-        let lastResult;
-        if (typeof this.initialExecutor === "function") {
-          if (this.signal?.aborted) {
-            throw new Error(this.signal.reason || "Aborted");
-          }
-          lastResult = await this.initialExecutor();
-        } else {
-          lastResult = await this.initialExecutor;
-        }
-        for (let i = 0; i < this.steps.length; i++) {
-          if (this.signal?.aborted) {
-            throw new Error(this.signal.reason || "Aborted");
-          }
-          const step = this.steps[i];
-          lastResult = await step(lastResult);
-        }
-        return lastResult;
-      };
-      return await Promise.race([pipelineRunner(), abortPromise]);
-    } catch (error) {
-      if (this.errorHandler) {
-        return await this.errorHandler(error);
-      }
-      throw error;
-    }
+    return new _AbortablePromise(this.promise.finally(onfinally), this.signal);
   }
-  // Convert to native Promise
+  // 네이티브 Promise 로 변환 (그냥 await 해도 된다)
   toPromise() {
-    return this.execute();
+    return this.promise;
   }
 };
 
@@ -6586,11 +6739,15 @@ var Fetcher = class {
         resolve(gdata);
       }).catch(async (e) => {
         this.error(config, pipe, e);
-        config?.error?.();
+        config?.error?.(e);
         if (config?.errorTransform) {
           e = await config.errorTransform(e);
         }
-        e = await this.errorTransform(e);
+        try {
+          e = await this.errorTransform(e);
+        } catch (ee) {
+          e = ee;
+        }
         reject(e);
       }).finally(() => {
         this.finally(config, pipe);
@@ -6607,41 +6764,30 @@ var isHttpResponseError = (data) => {
   return data instanceof HttpResponseError;
 };
 var HttpFetcher = class extends Fetcher {
+  // get/post/put/patch/head/delete가 전부 config.config.fetch.method를 세팅하려고 caller가
+  // 넘긴 config(.fetch) 객체를 직접 mutate했다 - 같은 config 객체를 여러 호출이 공유하면
+  // (예: Promise.all로 동시에 get/post) 서로의 method를 덮어쓰는 레이스가 생겼다. caller의
+  // 객체는 절대 건드리지 않고, 얕은 복사본 위에 method만 얹어서 반환한다.
+  withMethod(config, method) {
+    return { ...config, config: { ...config.config, fetch: { ...config.config?.fetch, method } } };
+  }
   get(config) {
-    config.config ?? (config.config = {});
-    config.config.fetch = config.config?.fetch ?? {};
-    config.config.fetch.method = "GET";
-    return this.fetch(config);
+    return this.fetch(this.withMethod(config, "GET"));
   }
   post(config) {
-    config.config ?? (config.config = {});
-    config.config.fetch = config.config?.fetch ?? {};
-    config.config.fetch.method = "POST";
-    return this.fetch(config);
+    return this.fetch(this.withMethod(config, "POST"));
   }
   patch(config) {
-    config.config ?? (config.config = {});
-    config.config.fetch = config.config?.fetch ?? {};
-    config.config.fetch.method = "PATCH";
-    return this.fetch(config);
+    return this.fetch(this.withMethod(config, "PATCH"));
   }
   put(config) {
-    config.config ?? (config.config = {});
-    config.config.fetch = config.config?.fetch ?? {};
-    config.config.fetch.method = "PUT";
-    return this.fetch(config);
+    return this.fetch(this.withMethod(config, "PUT"));
   }
   head(config) {
-    config.config ?? (config.config = {});
-    config.config.fetch = config.config?.fetch ?? {};
-    config.config.fetch.method = "HEAD";
-    return this.fetch(config);
+    return this.fetch(this.withMethod(config, "HEAD"));
   }
   delete(config) {
-    config.config ?? (config.config = {});
-    config.config.fetch = config.config?.fetch ?? {};
-    config.config.fetch.method = "DELETE";
-    return this.fetch(config);
+    return this.fetch(this.withMethod(config, "DELETE"));
   }
   async beforeProxyFetch(config) {
     return config;
@@ -6678,7 +6824,7 @@ var HttpFetcher = class extends Fetcher {
       }
     } else {
       httpResponseError.body = e;
-      httpResponseError.message = e.message;
+      httpResponseError.message = e?.message;
     }
     return httpResponseError;
   }
@@ -6688,7 +6834,7 @@ var HttpFetcher = class extends Fetcher {
     if (!(target instanceof URL) && typeof target !== "string") {
       const searchParams = ConvertUtils.toURLSearchParams(target.searchParams ?? {});
       try {
-        const url = typeof target.url === "string" ? new URL(target.url) : target.url;
+        const url = new URL(target.url);
         searchParams.forEach((value, key) => {
           url.searchParams.append(key, value);
         });
@@ -6703,43 +6849,30 @@ var HttpFetcher = class extends Fetcher {
       }
     }
     const beforeProxyData = { requestInfo: target, init: config?.fetch };
-    let beforeData = config?.beforeProxyFetch ? await config?.beforeProxyFetch(config) : beforeProxyData.requestInfo;
-    beforeData = config?.skipGlobalBeforeProxyFetch ? beforeProxyData : await this.beforeProxyFetch(beforeProxyData);
+    let beforeData = config?.beforeProxyFetch ? await config?.beforeProxyFetch(beforeProxyData) : beforeProxyData;
+    beforeData = config?.skipGlobalBeforeProxyFetch ? beforeData : await this.beforeProxyFetch(beforeData);
     target = beforeData.requestInfo;
     if (beforeData.init) {
       config ?? (config = {});
       config.fetch = beforeData.init;
     }
-    let abortedTimeout;
+    let requestInit = config?.fetch;
     if (config?.fetch && "timeout" in config.fetch) {
-      const abortController = new AbortController();
-      abortedTimeout = setTimeout(() => {
-        if (config?.fetch?.signal) {
-          const inputSignal = config.fetch.signal;
-          const listener = () => {
-            if (!abortController.signal.aborted) {
-              abortController.abort();
-            }
-            inputSignal.removeEventListener("abort", listener);
-          };
-          inputSignal.addEventListener("abort", listener);
-        }
-        if (!abortController.signal.aborted) {
-          abortController.abort();
-        }
-      }, config.fetch.timeout);
-      config.fetch.signal = abortController.signal;
+      const timeoutSignal = AbortSignal.timeout(config.fetch.timeout);
+      const signal = config.fetch.signal ? AbortSignal.any([timeoutSignal, config.fetch.signal]) : timeoutSignal;
+      requestInit = { ...config.fetch, signal };
     }
-    this.beforeFetch({ target, requestInit: config?.fetch });
-    return (config.fetcher ?? fetch)(target, config?.fetch).then(async (it) => {
-      this.afterFetch({ target, requestInit: config?.fetch }, it);
+    this.beforeFetch({ target, requestInit });
+    return (config.fetcher ?? fetch)(target, requestInit).then(async (it) => {
+      this.afterFetch({ target, requestInit }, it);
       const afterProxyData = {
-        fetch: { target, requestInit: config.fetch },
+        fetch: { target, requestInit },
         config: beforeData,
         response: it
       };
-      it = config?.afterProxyFetch ? await config.afterProxyFetch(afterProxyData) : it;
-      it = config?.skipGlobalAfterProxyFetch ? it : await this.afterProxyFetch(afterProxyData);
+      afterProxyData.response = config?.afterProxyFetch ? await config.afterProxyFetch(afterProxyData) : it;
+      afterProxyData.response = config?.skipGlobalAfterProxyFetch ? afterProxyData.response : await this.afterProxyFetch(afterProxyData);
+      it = afterProxyData.response;
       config?.fetchResponseAfterCallBack?.(it, config);
       if (!config?.allowedResponseNotOk && !it.ok) {
         throw it;
@@ -6749,30 +6882,31 @@ var HttpFetcher = class extends Fetcher {
         throw data;
       }
       return it;
-    }).finally(() => {
-      if (abortedTimeout) {
-        clearTimeout(abortedTimeout);
-      }
     });
   }
 };
 
 // ../core/dist/esm/fetch/HttpJsonFetcher.js
 var HttpJsonFetcher = class extends HttpFetcher {
+  // config.config/config.config.fetch를 직접 mutate하면(예전처럼) 같은 config 객체를 여러
+  // postJson/patchJson/putJson 호출이 동시에 공유할 때 서로의 headers/body를 덮어쓰는 레이스가
+  // 생긴다(HttpFetcher.get/post의 method 레이스랑 같은 문제). caller의 객체는 안 건드리고,
+  // 얕은 복사본을 만들어서 새 config 객체를 리턴한다.
   updateJsonFetchConfigAndData(config) {
-    var _a2, _b2;
     const headers = {
       "Content-Type": "application/json",
       Accept: "application/json, text/plain, */*"
     };
-    config.config ?? (config.config = {});
-    (_a2 = config.config).fetch ?? (_a2.fetch = {});
-    (_b2 = config.config.fetch).headers ?? (_b2.headers = {});
-    config.config.fetch.headers = { ...headers, ...config.config.fetch?.headers };
-    if (config.config?.fetch?.body && typeof config.config?.fetch?.body !== "string") {
-      config.config.fetch.body = JSON.stringify(config.config.fetch.body);
+    const fetchInit = { ...config.config?.fetch };
+    const merged = new Headers(headers);
+    if (fetchInit.headers) {
+      new Headers(fetchInit.headers).forEach((value, key) => merged.set(key, value));
     }
-    return config;
+    fetchInit.headers = merged;
+    if (fetchInit.body && typeof fetchInit.body !== "string") {
+      fetchInit.body = JSON.stringify(fetchInit.body);
+    }
+    return { ...config, config: { ...config.config, fetch: fetchInit } };
   }
   get(config) {
     return super.get(config);
@@ -8286,7 +8420,7 @@ var StoreLoader = class {
 
 // ../core/dist/esm/url/UrlUtils.js
 var UrlUtils;
-((UrlUtils2) => {
+(function(UrlUtils2) {
   UrlUtils2.origin = (fullurl) => {
     return new URL(fullurl).origin;
   };
@@ -8324,15 +8458,28 @@ var UrlUtils;
     });
     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;
   };
@@ -8583,12 +8730,13 @@ var ReflectUtils;
   ReflectUtils2.findMetadata = (metadataKey, target, propertyKey) => {
     if (target == null) return void 0;
     let searchTarget = typeof target === "object" && typeof target !== "function" ? target.constructor : target;
-    while (searchTarget && searchTarget !== Object) {
+    const seen = /* @__PURE__ */ new Set();
+    while (searchTarget && searchTarget !== Object && !seen.has(searchTarget)) {
+      seen.add(searchTarget);
       const data = propertyKey ? Reflect.getOwnMetadata(metadataKey, searchTarget, propertyKey) : Reflect.getOwnMetadata(metadataKey, searchTarget);
       if (data !== void 0) return data;
       const proto = Object.getPrototypeOf(searchTarget);
       searchTarget = proto && typeof proto === "function" ? proto : proto?.constructor || null;
-      if (searchTarget === target) break;
     }
     return void 0;
   };
@@ -8596,12 +8744,13 @@ var ReflectUtils;
     const results = [];
     if (target == null) return results;
     let searchTarget = typeof target === "object" && typeof target !== "function" ? target.constructor : target;
-    while (searchTarget && searchTarget !== Object) {
+    const seen = /* @__PURE__ */ new Set();
+    while (searchTarget && searchTarget !== Object && !seen.has(searchTarget)) {
+      seen.add(searchTarget);
       const data = propertyKey ? Reflect.getOwnMetadata(metadataKey, searchTarget, propertyKey) : Reflect.getOwnMetadata(metadataKey, searchTarget);
       if (data !== void 0) results.unshift(data);
       const proto = Object.getPrototypeOf(searchTarget);
       searchTarget = proto && typeof proto === "function" ? proto : proto?.constructor || null;
-      if (searchTarget === target) break;
     }
     return results;
   };
@@ -10726,6 +10875,23 @@ function getExpression(value, config) {
   };
 }
 
+// ../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/index.js
 var src_default = {
   // Core utilities are exported as named exports above
@@ -10887,7 +11053,7 @@ var ElementUtils;
 var ElementApply = class _ElementApply {
   constructor(el, config) {
     this.el = el;
-    this.window = this.el.ownerDocument.defaultView;
+    this.window = this.el.ownerDocument.defaultView ?? globalThis;
     this.document = this.el.ownerDocument;
     this.id = config?.id ?? el.id;
     this.variableWrap = config?.variableWrap ?? { start: "@", end: "@" };
@@ -10910,6 +11076,8 @@ var ElementApply = class _ElementApply {
     let match;
     while ((match = regex.exec(script)) !== null) {
       variables.push(match[1]);
+      const root = match[1].split(/[.[(]/)[0].trim();
+      if (root && root !== match[1]) variables.push(root);
     }
     return variables;
   }
@@ -11014,10 +11182,15 @@ var ElementApply = class _ElementApply {
           type.variables.forEach((v) => variables.add(v));
         });
       }
+      const bind = config?.bind;
+      const fromBind = (key) => bind != null && typeof key === "string" && !(key in (config?.context ?? {})) && _ElementApply.isUserMember(bind, key);
       const context = new Proxy(config?.context ?? {}, {
+        has(target, key) {
+          return key in target || fromBind(key);
+        },
         get(target, key) {
-          const value = target[key];
-          return typeof value === "function" ? value.bind(config?.bind ?? target) : value;
+          const value = key in target ? target[key] : fromBind(key) ? bind[key] : void 0;
+          return typeof value === "function" ? value.bind(bind ?? target) : value;
         }
       });
       if (!config?.targetVariableName || config?.targetVariableName && variables.has(config?.targetVariableName)) {
@@ -11042,7 +11215,6 @@ var ElementApply = class _ElementApply {
                     }
                   }
               `)(context).bind(it.node);
-              console.log("------------------->", it, tit);
               if (tit.type === "attribute" && !config?.exclude?.attribute) {
                 it.node.setAttribute(tit.name, data());
               } else if (tit.type === "property" && !config?.exclude?.property) {
@@ -11062,6 +11234,15 @@ var ElementApply = class _ElementApply {
       }
     }
   }
+  /** key 가 네이티브(DOM/내장) prototype 이 아니라 사용자 클래스나 인스턴스에 정의돼 있으면 true */
+  static isUserMember(obj, key) {
+    for (let p = obj; p; p = Object.getPrototypeOf(p)) {
+      if (!Object.prototype.hasOwnProperty.call(p, key)) continue;
+      const ctor = p === obj ? null : p.constructor;
+      return !(typeof ctor === "function" && /\[native code\]/.test(Function.prototype.toString.call(ctor)));
+    }
+    return false;
+  }
   removeAllEventListener() {
     const m = this.findAllTarget().filter((it) => it.nodeType === "element").flatMap((it) => it.types.map((sit) => ({ ...sit, node: it.node })).filter((it2) => it2.type === "event"));
     m.forEach((tit) => {
@@ -11439,15 +11620,21 @@ var NodeSlot = class _NodeSlot {
     const slots = this.findSlots();
     return slots.map((s) => s.nodes());
   }
-  append(...args) {
-    let targetId;
-    let items = [];
-    if (typeof args[0] === "string" && args.length > 1) {
-      targetId = args[0];
-      items = args.slice(1);
-    } else {
-      items = args;
+  /**
+   * Shared disambiguation for the `(...items)` / `(targetId, ...items)` overload pair.
+   * Items are always Node instances (or strings meant as literal content) coming from
+   * callers; a leading string is therefore always treated as `targetId`, even when no
+   * items follow — this avoids misclassifying `targetId` itself as content when the
+   * caller has zero items to insert (e.g. a decorated method returning undefined).
+   */
+  static parseTargetArgs(args) {
+    if (typeof args[0] === "string") {
+      return { targetId: args[0], items: args.slice(1) };
     }
+    return { targetId: void 0, items: args };
+  }
+  append(...args) {
+    const { targetId, items } = _NodeSlot.parseTargetArgs(args);
     if (!items || items.length === 0) return;
     const slots = this.findSlots(targetId);
     if (!slots || slots.length === 0) return;
@@ -11456,38 +11643,17 @@ var NodeSlot = class _NodeSlot {
     }
   }
   appendHtml(...args) {
-    let targetId;
-    let items = [];
-    if (typeof args[0] === "string" && args.length > 1) {
-      targetId = args[0];
-      items = args.slice(1);
-    } else {
-      items = args;
-    }
+    const { targetId, items } = _NodeSlot.parseTargetArgs(args);
     const slots = this.findSlots(targetId);
     for (const s of slots) s.appendHtml(...items);
   }
   appendText(...args) {
-    let targetId;
-    let items = [];
-    if (typeof args[0] === "string" && args.length > 1) {
-      targetId = args[0];
-      items = args.slice(1);
-    } else {
-      items = args;
-    }
+    const { targetId, items } = _NodeSlot.parseTargetArgs(args);
     const slots = this.findSlots(targetId);
     for (const s of slots) s.appendText(...items);
   }
   appendCopy(...args) {
-    let targetId;
-    let items = [];
-    if (typeof args[0] === "string" && args.length > 1) {
-      targetId = args[0];
-      items = args.slice(1);
-    } else {
-      items = args;
-    }
+    const { targetId, items } = _NodeSlot.parseTargetArgs(args);
     if (!items || items.length === 0) return;
     const slots = this.findSlots(targetId);
     if (!slots || slots.length === 0) return;
@@ -11496,14 +11662,7 @@ var NodeSlot = class _NodeSlot {
     }
   }
   prepend(...args) {
-    let targetId;
-    let items = [];
-    if (typeof args[0] === "string" && args.length > 1) {
-      targetId = args[0];
-      items = args.slice(1);
-    } else {
-      items = args;
-    }
+    const { targetId, items } = _NodeSlot.parseTargetArgs(args);
     if (!items || items.length === 0) return;
     const slots = this.findSlots(targetId);
     if (!slots || slots.length === 0) return;
@@ -11512,38 +11671,17 @@ var NodeSlot = class _NodeSlot {
     }
   }
   prependHtml(...args) {
-    let targetId;
-    let items = [];
-    if (typeof args[0] === "string" && args.length > 1) {
-      targetId = args[0];
-      items = args.slice(1);
-    } else {
-      items = args;
-    }
+    const { targetId, items } = _NodeSlot.parseTargetArgs(args);
     const slots = this.findSlots(targetId);
     for (const s of slots) s.prependHtml(...items);
   }
   prependText(...args) {
-    let targetId;
-    let items = [];
-    if (typeof args[0] === "string" && args.length > 1) {
-      targetId = args[0];
-      items = args.slice(1);
-    } else {
-      items = args;
-    }
+    const { targetId, items } = _NodeSlot.parseTargetArgs(args);
     const slots = this.findSlots(targetId);
     for (const s of slots) s.prependText(...items);
   }
   prependCopy(...args) {
-    let targetId;
-    let items = [];
-    if (typeof args[0] === "string" && args.length > 1) {
-      targetId = args[0];
-      items = args.slice(1);
-    } else {
-      items = args;
-    }
+    const { targetId, items } = _NodeSlot.parseTargetArgs(args);
     if (!items || items.length === 0) return;
     const slots = this.findSlots(targetId);
     if (!slots || slots.length === 0) return;
@@ -11563,14 +11701,7 @@ var NodeSlot = class _NodeSlot {
     }
   }
   replaceChildren(...args) {
-    let targetId;
-    let items = [];
-    if (typeof args[0] === "string" && args.length > 1) {
-      targetId = args[0];
-      items = args.slice(1);
-    } else {
-      items = args;
-    }
+    const { targetId, items } = _NodeSlot.parseTargetArgs(args);
     const slots = this.findSlots(targetId);
     if (!slots || slots.length === 0) return;
     for (const s of slots) {
@@ -11578,14 +11709,7 @@ var NodeSlot = class _NodeSlot {
     }
   }
   replaceChildrenHtml(...args) {
-    let targetId;
-    let items = [];
-    if (typeof args[0] === "string" && args.length > 1) {
-      targetId = args[0];
-      items = args.slice(1);
-    } else {
-      items = args;
-    }
+    const { targetId, items } = _NodeSlot.parseTargetArgs(args);
     const slots = this.findSlots(targetId);
     if (!slots || slots.length === 0) return;
     for (const s of slots) {
@@ -11593,14 +11717,7 @@ var NodeSlot = class _NodeSlot {
     }
   }
   replaceChildrenText(...args) {
-    let targetId;
-    let items = [];
-    if (typeof args[0] === "string" && args.length > 1) {
-      targetId = args[0];
-      items = args.slice(1);
-    } else {
-      items = args;
-    }
+    const { targetId, items } = _NodeSlot.parseTargetArgs(args);
     const slots = this.findSlots(targetId);
     if (!slots || slots.length === 0) return;
     for (const s of slots) {
@@ -12291,6 +12408,7 @@ var LocationUtils;
 var ROUTER_NO_EVENT_MARKER = "__ROUTER_NO_EVENT__";
 var Router = class {
   constructor(config) {
+    this.leaveGuards = /* @__PURE__ */ new Set();
     this._config = config;
     let routeData;
     if (config?.firstUrl) {
@@ -12311,13 +12429,39 @@ var Router = class {
       this.behaviorSubject = new BehaviorSubject(routeData);
     }
     this.config.window.addEventListener("popstate", (event) => {
-      const routeData2 = { ...this.getRouteData(), triggerPoint: "end" };
-      this.behaviorSubject.next(routeData2);
+      const publish = () => this.behaviorSubject.next({ ...this.getRouteData(), triggerPoint: "end" });
+      if (!this.leaveGuards.size) return publish();
+      const from = this.value;
+      void this.canLeave(this.getRouteData(), from).then((ok) => {
+        if (ok) publish();
+        else this.config.window.history?.pushState(from.data ?? null, "", from.url);
+      });
     });
   }
   get value() {
     return this.behaviorSubject.getValue();
   }
+  /**
+   * 이동 전 가드 등록. go() 와 뒤로/앞으로 가기(popstate)에 적용된다 (pushState/replaceState 직접 호출은 제외).
+   * 리턴한 함수를 부르면 해제된다.
+   */
+  addLeaveGuard(guard) {
+    this.leaveGuards.add(guard);
+    return () => {
+      this.leaveGuards.delete(guard);
+    };
+  }
+  /** 가드가 하나라도 있는지 (없으면 호출자가 동기로 진행해도 된다) */
+  get hasLeaveGuards() {
+    return this.leaveGuards.size > 0;
+  }
+  /** 등록된 가드를 순서대로 평가. 하나라도 false 면 false */
+  async canLeave(to, from) {
+    for (const guard of [...this.leaveGuards]) {
+      if (await guard(to, from) === false) return false;
+    }
+    return true;
+  }
   get observable() {
     return this.behaviorSubject.asObservable();
   }
@@ -12448,17 +12592,24 @@ var Router = class {
     if (typeof config === "string") {
       config = { path: config };
     }
-    if (config?.replace) {
-      this.replace(config.path, config.state);
-    } else {
-      this.push(config.path, config.state);
-    }
-    if (config.scrollToTop !== false) {
-      try {
-        this._config.window?.scrollTo?.(0, 0);
-      } catch (e) {
+    const target = config;
+    const navigate = () => {
+      if (target?.replace) {
+        this.replace(target.path, target.state);
+      } else {
+        this.push(target.path, target.state);
       }
-    }
+      if (target.scrollToTop !== false) {
+        try {
+          this._config.window?.scrollTo?.(0, 0);
+        } catch (e) {
+        }
+      }
+    };
+    if (!this.leaveGuards.size) return navigate();
+    return this.canLeave(this.getRouteData({ pathOrUrl: this.toUrl(target.path) }), this.value).then((ok) => {
+      if (ok) navigate();
+    });
   }
   toUrl(data) {
     let targetPath;