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

package/dist/umd-bundle/dooboostore-simple-boot-http-server.umd.js

@@ -36,9 +36,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
   ));
   var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), 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) {
@@ -1121,9 +1121,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/mime-db@1.52.0/node_modules/mime-db/db.json
+  // ../../../node_modules/.pnpm/mime-db@1.52.0/node_modules/mime-db/db.json
   var require_db = __commonJS({
-    "../../node_modules/.pnpm/mime-db@1.52.0/node_modules/mime-db/db.json"(exports, module) {
+    "../../../node_modules/.pnpm/mime-db@1.52.0/node_modules/mime-db/db.json"(exports, module) {
       module.exports = {
         "application/1d-interleaved-parityfec": {
           source: "iana"
@@ -9646,16 +9646,16 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/mime-db@1.52.0/node_modules/mime-db/index.js
+  // ../../../node_modules/.pnpm/mime-db@1.52.0/node_modules/mime-db/index.js
   var require_mime_db = __commonJS({
-    "../../node_modules/.pnpm/mime-db@1.52.0/node_modules/mime-db/index.js"(exports, module) {
+    "../../../node_modules/.pnpm/mime-db@1.52.0/node_modules/mime-db/index.js"(exports, module) {
       module.exports = require_db();
     }
   });
 
-  // ../../node_modules/.pnpm/mime-types@2.1.35/node_modules/mime-types/index.js
+  // ../../../node_modules/.pnpm/mime-types@2.1.35/node_modules/mime-types/index.js
   var require_mime_types = __commonJS({
-    "../../node_modules/.pnpm/mime-types@2.1.35/node_modules/mime-types/index.js"(exports) {
+    "../../../node_modules/.pnpm/mime-types@2.1.35/node_modules/mime-types/index.js"(exports) {
       "use strict";
       var db = require_mime_db();
       var extname2 = __require("path").extname;
@@ -9743,9 +9743,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/node-gzip@1.1.2/node_modules/node-gzip/dist/index.js
+  // ../../../node_modules/.pnpm/node-gzip@1.1.2/node_modules/node-gzip/dist/index.js
   var require_dist = __commonJS({
-    "../../node_modules/.pnpm/node-gzip@1.1.2/node_modules/node-gzip/dist/index.js"(exports, module) {
+    "../../../node_modules/.pnpm/node-gzip@1.1.2/node_modules/node-gzip/dist/index.js"(exports, module) {
       "use strict";
       var zlib = __require("zlib");
       module.exports = {
@@ -9771,9 +9771,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/commonjs/helpers.js
+  // ../../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/commonjs/helpers.js
   var require_helpers = __commonJS({
-    "../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/commonjs/helpers.js"(exports) {
+    "../../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/commonjs/helpers.js"(exports) {
       var __extends = exports && exports.__extends || /* @__PURE__ */ function() {
         var extendStatics = function(d, b) {
           extendStatics = Object.setPrototypeOf || { __proto__: [] } instanceof Array && function(d2, b2) {
@@ -9939,9 +9939,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/commonjs/core.js
+  // ../../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/commonjs/core.js
   var require_core = __commonJS({
-    "../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/commonjs/core.js"(exports) {
+    "../../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/commonjs/core.js"(exports) {
       Object.defineProperty(exports, "__esModule", { value: true });
       var helpers_js_1 = require_helpers();
       exports.JsonPatchError = helpers_js_1.PatchError;
@@ -10272,9 +10272,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/commonjs/duplex.js
+  // ../../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/commonjs/duplex.js
   var require_duplex = __commonJS({
-    "../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/commonjs/duplex.js"(exports) {
+    "../../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/commonjs/duplex.js"(exports) {
       Object.defineProperty(exports, "__esModule", { value: true });
       var helpers_js_1 = require_helpers();
       var core_js_1 = require_core();
@@ -10446,9 +10446,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/index.js
+  // ../../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/index.js
   var require_fast_json_patch = __commonJS({
-    "../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/index.js"(exports) {
+    "../../../node_modules/.pnpm/fast-json-patch@3.1.1/node_modules/fast-json-patch/index.js"(exports) {
       var core = require_core();
       Object.assign(exports, core);
       var duplex = require_duplex();
@@ -10461,9 +10461,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/constants.js
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/constants.js
   var require_constants = __commonJS({
-    "../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/constants.js"(exports, module) {
+    "../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/constants.js"(exports, module) {
       "use strict";
       var BINARY_TYPES = ["nodebuffer", "arraybuffer", "fragments"];
       var hasBlob = typeof Blob !== "undefined";
@@ -10484,9 +10484,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/buffer-util.js
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/buffer-util.js
   var require_buffer_util = __commonJS({
-    "../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/buffer-util.js"(exports, module) {
+    "../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/buffer-util.js"(exports, module) {
       "use strict";
       var { EMPTY_BUFFER } = require_constants();
       var FastBuffer = Buffer[Symbol.species];
@@ -10559,9 +10559,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/limiter.js
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/limiter.js
   var require_limiter = __commonJS({
-    "../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/limiter.js"(exports, module) {
+    "../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/limiter.js"(exports, module) {
       "use strict";
       var kDone = Symbol("kDone");
       var kRun = Symbol("kRun");
@@ -10609,9 +10609,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/permessage-deflate.js
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/permessage-deflate.js
   var require_permessage_deflate = __commonJS({
-    "../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/permessage-deflate.js"(exports, module) {
+    "../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/permessage-deflate.js"(exports, module) {
       "use strict";
       var zlib = __require("zlib");
       var bufferUtil = require_buffer_util();
@@ -10992,9 +10992,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/validation.js
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/validation.js
   var require_validation = __commonJS({
-    "../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/validation.js"(exports, module) {
+    "../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/validation.js"(exports, module) {
       "use strict";
       var { isUtf8 } = __require("buffer");
       var { hasBlob } = require_constants();
@@ -11193,9 +11193,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/receiver.js
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/receiver.js
   var require_receiver = __commonJS({
-    "../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/receiver.js"(exports, module) {
+    "../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/receiver.js"(exports, module) {
       "use strict";
       var { Writable } = __require("stream");
       var PerMessageDeflate2 = require_permessage_deflate();
@@ -11228,10 +11228,6 @@ var dooboostoreSimpleBootHttpServer = (() => {
          *     extensions
          * @param {Boolean} [options.isServer=false] Specifies whether to operate in
          *     client or server mode
-         * @param {Number} [options.maxBufferedChunks=0] The maximum number of
-         *     buffered data chunks
-         * @param {Number} [options.maxFragments=0] The maximum number of message
-         *     fragments
          * @param {Number} [options.maxPayload=0] The maximum allowed message length
          * @param {Boolean} [options.skipUTF8Validation=false] Specifies whether or
          *     not to skip UTF-8 validation for text and close messages
@@ -11242,8 +11238,6 @@ var dooboostoreSimpleBootHttpServer = (() => {
           this._binaryType = options.binaryType || BINARY_TYPES[0];
           this._extensions = options.extensions || {};
           this._isServer = !!options.isServer;
-          this._maxBufferedChunks = options.maxBufferedChunks | 0;
-          this._maxFragments = options.maxFragments | 0;
           this._maxPayload = options.maxPayload | 0;
           this._skipUTF8Validation = !!options.skipUTF8Validation;
           this[kWebSocket] = void 0;
@@ -11273,18 +11267,6 @@ var dooboostoreSimpleBootHttpServer = (() => {
          */
         _write(chunk, encoding, cb) {
           if (this._opcode === 8 && this._state == GET_INFO) return cb();
-          if (this._maxBufferedChunks > 0 && this._buffers.length >= this._maxBufferedChunks) {
-            cb(
-              this.createError(
-                RangeError,
-                "Too many buffered chunks",
-                false,
-                1008,
-                "WS_ERR_TOO_MANY_BUFFERED_PARTS"
-              )
-            );
-            return;
-          }
           this._bufferedBytes += chunk.length;
           this._buffers.push(chunk);
           this.startLoop(cb);
@@ -11614,17 +11596,6 @@ var dooboostoreSimpleBootHttpServer = (() => {
             return;
           }
           if (data.length) {
-            if (this._maxFragments > 0 && this._fragments.length >= this._maxFragments) {
-              const error = this.createError(
-                RangeError,
-                "Too many message fragments",
-                false,
-                1008,
-                "WS_ERR_TOO_MANY_BUFFERED_PARTS"
-              );
-              cb(error);
-              return;
-            }
             this._messageLength = this._totalPayloadLength;
             this._fragments.push(data);
           }
@@ -11654,17 +11625,6 @@ var dooboostoreSimpleBootHttpServer = (() => {
                 cb(error);
                 return;
               }
-              if (this._maxFragments > 0 && this._fragments.length >= this._maxFragments) {
-                const error = this.createError(
-                  RangeError,
-                  "Too many message fragments",
-                  false,
-                  1008,
-                  "WS_ERR_TOO_MANY_BUFFERED_PARTS"
-                );
-                cb(error);
-                return;
-              }
               this._fragments.push(buf);
             }
             this.dataMessage(cb);
@@ -11825,15 +11785,12 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/sender.js
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/sender.js
   var require_sender = __commonJS({
-    "../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/sender.js"(exports, module) {
+    "../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/sender.js"(exports, module) {
       "use strict";
       var { Duplex } = __require("stream");
       var { randomFillSync } = __require("crypto");
-      var {
-        types: { isUint8Array }
-      } = __require("util");
       var PerMessageDeflate2 = require_permessage_deflate();
       var { EMPTY_BUFFER, kWebSocket, NOOP } = require_constants();
       var { isBlob, isValidStatusCode } = require_validation();
@@ -11987,10 +11944,8 @@ var dooboostoreSimpleBootHttpServer = (() => {
             buf.writeUInt16BE(code, 0);
             if (typeof data === "string") {
               buf.write(data, 2);
-            } else if (isUint8Array(data)) {
-              buf.set(data, 2);
             } else {
-              throw new TypeError("Second argument must be a string or a Uint8Array");
+              buf.set(data, 2);
             }
           }
           const options = {
@@ -12318,9 +12273,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/event-target.js
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/event-target.js
   var require_event_target = __commonJS({
-    "../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/event-target.js"(exports, module) {
+    "../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/event-target.js"(exports, module) {
       "use strict";
       var { kForOnEventAttribute, kListener } = require_constants();
       var kCode = Symbol("kCode");
@@ -12547,9 +12502,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/extension.js
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/extension.js
   var require_extension = __commonJS({
-    "../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/extension.js"(exports, module) {
+    "../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/extension.js"(exports, module) {
       "use strict";
       var { tokenChars } = require_validation();
       function push(dest, name, elem) {
@@ -12700,9 +12655,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/websocket.js
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/websocket.js
   var require_websocket = __commonJS({
-    "../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/websocket.js"(exports, module) {
+    "../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/websocket.js"(exports, module) {
       "use strict";
       var EventEmitter = __require("events");
       var https = __require("https");
@@ -12871,10 +12826,6 @@ var dooboostoreSimpleBootHttpServer = (() => {
          *     multiple times in the same tick
          * @param {Function} [options.generateMask] The function used to generate the
          *     masking key
-         * @param {Number} [options.maxBufferedChunks=0] The maximum number of
-         *     buffered data chunks
-         * @param {Number} [options.maxFragments=0] The maximum number of message
-         *     fragments
          * @param {Number} [options.maxPayload=0] The maximum allowed message size
          * @param {Boolean} [options.skipUTF8Validation=false] Specifies whether or
          *     not to skip UTF-8 validation for text and close messages
@@ -12886,8 +12837,6 @@ var dooboostoreSimpleBootHttpServer = (() => {
             binaryType: this.binaryType,
             extensions: this._extensions,
             isServer: this._isServer,
-            maxBufferedChunks: options.maxBufferedChunks,
-            maxFragments: options.maxFragments,
             maxPayload: options.maxPayload,
             skipUTF8Validation: options.skipUTF8Validation
           });
@@ -13187,8 +13136,6 @@ var dooboostoreSimpleBootHttpServer = (() => {
           autoPong: true,
           closeTimeout: CLOSE_TIMEOUT,
           protocolVersion: protocolVersions[1],
-          maxBufferedChunks: 1024 * 1024,
-          maxFragments: 128 * 1024,
           maxPayload: 100 * 1024 * 1024,
           skipUTF8Validation: false,
           perMessageDeflate: true,
@@ -13431,8 +13378,6 @@ var dooboostoreSimpleBootHttpServer = (() => {
           websocket.setSocket(socket, head, {
             allowSynchronousEvents: opts.allowSynchronousEvents,
             generateMask: opts.generateMask,
-            maxBufferedChunks: opts.maxBufferedChunks,
-            maxFragments: opts.maxFragments,
             maxPayload: opts.maxPayload,
             skipUTF8Validation: opts.skipUTF8Validation
           });
@@ -13596,9 +13541,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/stream.js
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/stream.js
   var require_stream = __commonJS({
-    "../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/stream.js"(exports, module) {
+    "../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/stream.js"(exports, module) {
       "use strict";
       var WebSocket3 = require_websocket();
       var { Duplex } = __require("stream");
@@ -13694,9 +13639,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/subprotocol.js
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/subprotocol.js
   var require_subprotocol = __commonJS({
-    "../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/subprotocol.js"(exports, module) {
+    "../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/subprotocol.js"(exports, module) {
       "use strict";
       var { tokenChars } = require_validation();
       function parse2(header) {
@@ -13739,9 +13684,9 @@ var dooboostoreSimpleBootHttpServer = (() => {
     }
   });
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/websocket-server.js
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/websocket-server.js
   var require_websocket_server = __commonJS({
-    "../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/lib/websocket-server.js"(exports, module) {
+    "../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/websocket-server.js"(exports, module) {
       "use strict";
       var EventEmitter = __require("events");
       var http = __require("http");
@@ -13775,10 +13720,6 @@ var dooboostoreSimpleBootHttpServer = (() => {
          *     called
          * @param {Function} [options.handleProtocols] A hook to handle protocols
          * @param {String} [options.host] The hostname where to bind the server
-         * @param {Number} [options.maxBufferedChunks=1048576] The maximum number of
-         *     buffered data chunks
-         * @param {Number} [options.maxFragments=131072] The maximum number of message
-         *     fragments
          * @param {Number} [options.maxPayload=104857600] The maximum allowed message
          *     size
          * @param {Boolean} [options.noServer=false] Enable no server mode
@@ -13800,8 +13741,6 @@ var dooboostoreSimpleBootHttpServer = (() => {
           options = {
             allowSynchronousEvents: true,
             autoPong: true,
-            maxBufferedChunks: 1024 * 1024,
-            maxFragments: 128 * 1024,
             maxPayload: 100 * 1024 * 1024,
             skipUTF8Validation: false,
             perMessageDeflate: false,
@@ -14081,8 +14020,6 @@ var dooboostoreSimpleBootHttpServer = (() => {
           socket.removeListener("error", socketOnError);
           ws.setSocket(socket, head, {
             allowSynchronousEvents: this.options.allowSynchronousEvents,
-            maxBufferedChunks: this.options.maxBufferedChunks,
-            maxFragments: this.options.maxFragments,
             maxPayload: this.options.maxPayload,
             skipUTF8Validation: this.options.skipUTF8Validation
           });
@@ -14221,6 +14158,7 @@ var dooboostoreSimpleBootHttpServer = (() => {
     getUrlMapping: () => getUrlMapping,
     getUrlMappings: () => getUrlMappings,
     headMethod: () => headMethod,
+    injectRequestResponse: () => injectRequestResponse,
     isDataDist: () => isDataDist,
     isPathDist: () => isPathDist,
     makeIntentHeaderBySymbolFor: () => makeIntentHeaderBySymbolFor,
@@ -14260,6 +14198,8 @@ var dooboostoreSimpleBootHttpServer = (() => {
     Mimes2["ImageXpixmap"] = "image/x-xpixmap";
     Mimes2["ImageXxbm"] = "image/x-xbm";
     Mimes2["MultipartFormData"] = "multipart/form-data";
+    Mimes2["TextEventStream"] = "text/event-stream";
+    Mimes2["ApplicationXndjson"] = "application/x-ndjson";
     Mimes2["ApplicationJsonPostSimpleBootSsrIntentScheme"] = "application/json-post+simple-boot-ssr-intent-scheme";
     Mimes2["Intent"] = "intent";
     return Mimes2;
@@ -14392,6 +14332,7 @@ var dooboostoreSimpleBootHttpServer = (() => {
     Fetcher: () => Fetcher,
     FormValidator: () => FormValidator,
     FunctionUtils: () => FunctionUtils,
+    HashUtils: () => HashUtils,
     HttpFetcher: () => HttpFetcher,
     HttpJsonFetcher: () => HttpJsonFetcher,
     HttpResponseError: () => HttpResponseError,
@@ -14472,6 +14413,7 @@ var dooboostoreSimpleBootHttpServer = (() => {
     isCssCommentItem: () => isCssCommentItem,
     isCssDeclarationItem: () => isCssDeclarationItem,
     isCssRuleItem: () => isCssRuleItem,
+    isDefined: () => isDefined,
     isHttpResponseError: () => isHttpResponseError,
     isPoint2DType: () => isPoint2DType,
     isPoint3DType: () => isPoint3DType,
@@ -14517,6 +14459,12 @@ var dooboostoreSimpleBootHttpServer = (() => {
         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);
     };
@@ -16431,6 +16379,12 @@ var dooboostoreSimpleBootHttpServer = (() => {
         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);
@@ -16441,16 +16395,45 @@ var dooboostoreSimpleBootHttpServer = (() => {
       }
       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;
@@ -16462,12 +16445,24 @@ var dooboostoreSimpleBootHttpServer = (() => {
         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;
@@ -16479,6 +16474,12 @@ var dooboostoreSimpleBootHttpServer = (() => {
         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);
@@ -16487,6 +16488,12 @@ var dooboostoreSimpleBootHttpServer = (() => {
     // 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;
@@ -16499,6 +16506,12 @@ var dooboostoreSimpleBootHttpServer = (() => {
       }
       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);
@@ -16506,6 +16519,12 @@ var dooboostoreSimpleBootHttpServer = (() => {
     // 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;
@@ -16518,6 +16537,12 @@ var dooboostoreSimpleBootHttpServer = (() => {
       }
       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();
@@ -16533,10 +16558,22 @@ var dooboostoreSimpleBootHttpServer = (() => {
     //   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;
@@ -16548,36 +16585,90 @@ var dooboostoreSimpleBootHttpServer = (() => {
     //     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);
@@ -16589,18 +16680,43 @@ var dooboostoreSimpleBootHttpServer = (() => {
         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 + "]";
     }
@@ -18793,87 +18909,64 @@ var dooboostoreSimpleBootHttpServer = (() => {
   // ../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((resolve2, reject) => {
+        const cleanup = () => signal.removeEventListener("abort", onAbort);
+        const onAbort = () => reject(signal.reason);
+        signal.addEventListener("abort", onAbort, { once: true });
+        this.source.then(
+          (value) => {
+            cleanup();
+            resolve2(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;
-        }
-      );
+      return new _AbortablePromise(this.promise.finally(onfinally), this.signal);
     }
-    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;
-      }
-    }
-    // Convert to native Promise
+    // 네이티브 Promise 로 변환 (그냥 await 해도 된다)
     toPromise() {
-      return this.execute();
+      return this.promise;
     }
   };
 
@@ -19746,11 +19839,15 @@ var dooboostoreSimpleBootHttpServer = (() => {
           resolve2(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);
@@ -19767,41 +19864,30 @@ var dooboostoreSimpleBootHttpServer = (() => {
     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;
@@ -19838,7 +19924,7 @@ var dooboostoreSimpleBootHttpServer = (() => {
         }
       } else {
         httpResponseError.body = e;
-        httpResponseError.message = e.message;
+        httpResponseError.message = e?.message;
       }
       return httpResponseError;
     }
@@ -19848,7 +19934,7 @@ var dooboostoreSimpleBootHttpServer = (() => {
       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);
           });
@@ -19863,43 +19949,30 @@ var dooboostoreSimpleBootHttpServer = (() => {
         }
       }
       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;
@@ -19909,30 +19982,31 @@ var dooboostoreSimpleBootHttpServer = (() => {
           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 _a4, _b3;
       const headers = {
         "Content-Type": "application/json",
         Accept: "application/json, text/plain, */*"
       };
-      config.config ?? (config.config = {});
-      (_a4 = config.config).fetch ?? (_a4.fetch = {});
-      (_b3 = config.config.fetch).headers ?? (_b3.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);
@@ -21446,7 +21520,7 @@ var dooboostoreSimpleBootHttpServer = (() => {
 
   // ../core/dist/esm/url/UrlUtils.js
   var UrlUtils;
-  ((UrlUtils2) => {
+  (function(UrlUtils2) {
     UrlUtils2.origin = (fullurl) => {
       return new URL(fullurl).origin;
     };
@@ -21484,15 +21558,28 @@ var dooboostoreSimpleBootHttpServer = (() => {
       });
       return searchParams;
     };
+    UrlUtils2.toAbsoluteUrl = (relative2, base) => {
+      return new URL(relative2, 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;
     };
@@ -21743,12 +21830,13 @@ var dooboostoreSimpleBootHttpServer = (() => {
     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;
     };
@@ -21756,12 +21844,13 @@ var dooboostoreSimpleBootHttpServer = (() => {
       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;
     };
@@ -23886,6 +23975,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/index.js
   var src_default = {
     // Core utilities are exported as named exports above
@@ -24003,7 +24109,7 @@ ${indentStr}}`;
     return getUrlMapping(target, propertyKey);
   };
   var getPATCHS = (target) => {
-    return getUrlMappings(target)?.filter((it) => it.config?.method.toUpperCase() === "GET" /* GET */);
+    return getUrlMappings(target)?.filter((it) => it.config?.method.toUpperCase() === "PATCH" /* PATCH */);
   };
   function OPTIONS(configOrTarget, propertyKey, descriptor) {
     if (propertyKey && descriptor) {
@@ -24035,7 +24141,7 @@ ${indentStr}}`;
     return getUrlMapping(target, propertyKey);
   };
   var getHEADS = (target) => {
-    return getUrlMappings(target)?.filter((it) => it.config?.method.toUpperCase() === "GET" /* GET */);
+    return getUrlMappings(target)?.filter((it) => it.config?.method.toUpperCase() === "HEAD" /* HEAD */);
   };
   function TRACE(configOrTarget, propertyKey, descriptor) {
     if (propertyKey && descriptor) {
@@ -24991,7 +25097,16 @@ ${indentStr}}`;
       }
       if (!this.value) {
         if (typeof this.type.targetKeyType === "symbol") {
-          this.value = this.simstanceManager.findFirstSim(this.type.targetKeyType)?.getValue();
+          const stored = this.simstanceManager.getStoreSet(this.type.targetKeyType);
+          if (ValidUtils.isArrowFunction(stored?.instance)) {
+            const fresh = stored.instance();
+            if (this.getConfig()?.scope === Lifecycle.Singleton) {
+              this.simstanceManager.setStoreSet(this.type.targetKeyType, fresh, stored.type);
+              this.value = fresh;
+            }
+            return fresh;
+          }
+          this.value = stored?.instance;
         } else {
           this.value = this.simstanceManager.getOrNewSim({ target: this.type.targetKeyType, originTypeTarget: this.type.originalType, newInstanceCarrier: config?.newInstanceCarrier });
         }
@@ -25546,7 +25661,7 @@ ${indentStr}}`;
     registerStore(targetKey, regTyps) {
       const itemMap = this.storage.get(targetKey) ?? /* @__PURE__ */ new Map();
       regTyps.forEach((it) => {
-        const { type, value } = typeof it === "object" ? { type: it.constructor, value: it } : { type: it, value: void 0 };
+        const { type, value } = ValidUtils.isArrowFunction(it) ? { type: it, value: it } : typeof it === "object" ? { type: it.constructor, value: it } : { type: it, value: void 0 };
         if (!itemMap.has(type) || value !== void 0 && itemMap.get(type) === void 0) {
           itemMap.set(type, value);
         }
@@ -25799,9 +25914,16 @@ ${indentStr}}`;
     }
     run(otherInstanceSim = /* @__PURE__ */ new Map()) {
       for (const [k, v] of Array.from(otherInstanceSim.entries())) {
-        const storageKey = typeof k === "object" && k !== null && "type" in k ? k.type : k;
-        this.registerStore(storageKey, /* @__PURE__ */ new Set([v]));
-        if (typeof k === "object" && k !== null && "symbol" in k && k.symbol) {
+        const hasType = typeof k === "object" && k !== null && "type" in k;
+        const hasSymbol = typeof k === "object" && k !== null && !!k.symbol;
+        const storageKey = hasType ? k.type : k;
+        if (hasType || !hasSymbol) {
+          this.registerStore(storageKey, /* @__PURE__ */ new Set([v]));
+        }
+        if (hasSymbol) {
+          if (!ReflectUtils.getMetadata(SimMetadataKey, v)) {
+            ReflectUtils.defineMetadata(SimMetadataKey, { ...k, scope: k.scope ?? Lifecycle.Singleton }, v);
+          }
           this.registerStore(k.symbol, /* @__PURE__ */ new Set([v]));
         }
       }
@@ -27759,7 +27881,6 @@ ${indentStr}}`;
           return it.test(url);
         }
         if (typeof it === "string") {
-          console.log("url!!!!!!!", url);
           return it === url;
         }
         if (typeof it === "function") {
@@ -27931,7 +28052,7 @@ ${indentStr}}`;
                     fetch: {
                       credentials: "include",
                       headers,
-                      body: ConvertUtils.toFormData(userConfig?.body)
+                      body: userConfig?.body ? ConvertUtils.toFormData(userConfig.body) : void 0
                     }
                   }
                 });
@@ -28244,6 +28365,16 @@ ${indentStr}}`;
     };
   };
 
+  // src/proxy/RequestResponseInjectProxy.ts
+  var injectRequestResponse = (sim2, rr) => new Proxy(sim2, {
+    get(target, prop) {
+      const value = target[prop];
+      if (prop === "constructor" || typeof value !== "function") return value;
+      if (!rr) return value.bind(target);
+      return (...args) => value.apply(target, [...args, rr]);
+    }
+  });
+
   // src/inject/InjectSituationType.ts
   var InjectSituationType2;
   ((InjectSituationType3) => {
@@ -28268,6 +28399,7 @@ ${indentStr}}`;
 
   // src/models/RequestResponse.ts
   var import_node_gzip = __toESM(require_dist(), 1);
+  var import_zlib = __require("zlib");
   var import_node_buffer2 = __require("node:buffer");
   var RequestResponse = class _RequestResponse {
     constructor(req, res, config) {
@@ -28706,6 +28838,57 @@ ${indentStr}}`;
       this.createRequestResponseChain(this.res.writeHead(statusCode, headers));
       this.res.end();
     }
+    /**
+     * 헤더를 즉시 보내고, source 가 내놓는 값을 하나씩 바로 body 에 쓴 뒤 end.
+     * (SSE / 스트리밍 응답용. resWrite 는 버퍼링 후 resEnd 에서 한 번에 보내므로 스트리밍 불가)
+     * - 문자열/Buffer 는 그대로, 그 외는 JSON.stringify
+     * - Accept-Encoding 에 gzip 이 있으면 gzip 스트림으로 압축하고, 청크마다 Z_SYNC_FLUSH 로 바로 내보낸다
+     *   (flush 없이 쓰면 zlib 내부 버퍼에 모였다가 늦게 나가서 SSE 실시간성이 깨짐)
+     * - 클라이언트가 끊으면 source.return() 으로 제너레이터를 종료시켜 finally 가 돌게 한다
+     */
+    async resStream(source) {
+      const res = this.res;
+      const gz = this.reqHeaderFirst(HttpHeaders.AcceptEncoding)?.includes("gzip") ? (0, import_zlib.createGzip)() : void 0;
+      if (gz) {
+        res.setHeader(HttpHeaders.ContentEncoding, "gzip");
+        res.removeHeader(HttpHeaders.ContentLength);
+        gz.pipe(res);
+      }
+      const out = gz ?? res;
+      res.flushHeaders();
+      let closed = false;
+      const onClose = () => {
+        closed = true;
+        source.return?.();
+      };
+      res.once("close", onClose);
+      try {
+        for await (const chunk of source) {
+          if (closed) break;
+          const data = typeof chunk === "string" || import_buffer.Buffer.isBuffer(chunk) ? chunk : JSON.stringify(chunk);
+          const ok = out.write(data);
+          gz?.flush(import_zlib.constants.Z_SYNC_FLUSH);
+          if (!ok) await new Promise((resolve2) => {
+            out.once("drain", resolve2);
+            res.once("close", resolve2);
+          });
+        }
+      } catch (e) {
+        if (!closed) throw e;
+      } finally {
+        res.off("close", onClose);
+        if (closed) {
+          gz?.destroy();
+        } else if (!res.writableEnded) {
+          const finished = new Promise((resolve2) => {
+            res.once("finish", resolve2);
+            res.once("close", resolve2);
+          });
+          out.end();
+          await finished;
+        }
+      }
+    }
     resIsDone() {
       return this.res.finished || this.res.writableEnded || this.res.headersSent;
     }
@@ -28953,7 +29136,7 @@ ${indentStr}}`;
   var import_http = __require("http");
   var import_https = __require("https");
 
-  // ../../node_modules/.pnpm/ws@8.21.0/node_modules/ws/wrapper.mjs
+  // ../../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/wrapper.mjs
   var import_stream = __toESM(require_stream(), 1);
   var import_extension = __toESM(require_extension(), 1);
   var import_permessage_deflate = __toESM(require_permessage_deflate(), 1);
@@ -29053,6 +29236,11 @@ ${indentStr}}`;
         otherStorage.set(RequestResponse, rr);
         otherStorage.set(import_http.IncomingMessage, req);
         otherStorage.set(import_http.ServerResponse, res);
+        const abortController = new AbortController();
+        res.once("close", () => {
+          if (!res.writableFinished) abortController.abort();
+        });
+        otherStorage.set(AbortSignal, abortController.signal);
         try {
           transactionManager?.try();
           if (this.option.requestEndPoints) {
@@ -29209,23 +29397,35 @@ ${indentStr}}`;
                   target: moduleInstance,
                   targetKey: it.propertyKey
                 }, otherStorage);
-                if (it.config?.resolver) {
-                  const execute = typeof it.config.resolver === "function" ? this.simstanceManager.getOrNewSim({ target: it.config.resolver }) : it.config.resolver;
-                  data = await execute?.resolve?.(data, rr);
-                }
-                const status = it.config?.res?.status ?? 200 /* Ok */;
-                const headers = it.config?.res?.header ?? {};
-                if (it.config?.res?.contentType) {
-                  headers[HttpHeaders.ContentType] = it.config?.res?.contentType;
-                }
-                if ((it.config?.res?.contentType?.toLowerCase().indexOf("application/json" /* ApplicationJson */.toLowerCase()) ?? -1) > -1) {
-                  data = JSON.stringify(data);
-                } else if (data && typeof data === "object") {
-                  data = JSON.stringify(data);
+                const resConfig = it.config?.res;
+                if (resConfig === "manual") {
+                } else if (ValidUtils.isGenerator(data) || ValidUtils.isAsyncGenerator(data)) {
+                  const headers = resConfig?.header ?? {};
+                  if (resConfig?.contentType) {
+                    headers[HttpHeaders.ContentType] = resConfig.contentType;
+                  }
+                  rr.resSetHeaders(headers);
+                  rr.resSetStatusCode(resConfig?.status ?? 200 /* Ok */);
+                  await rr.resStream(data);
+                } else {
+                  if (it.config?.resolver) {
+                    const execute = typeof it.config.resolver === "function" ? this.simstanceManager.getOrNewSim({ target: it.config.resolver }) : it.config.resolver;
+                    data = await execute?.resolve?.(data, rr, resConfig);
+                  }
+                  const status = resConfig?.status ?? 200 /* Ok */;
+                  const headers = resConfig?.header ?? {};
+                  if (resConfig?.contentType) {
+                    headers[HttpHeaders.ContentType] = resConfig.contentType;
+                  }
+                  if ((resConfig?.contentType?.toLowerCase().indexOf("application/json" /* ApplicationJson */.toLowerCase()) ?? -1) > -1) {
+                    data = JSON.stringify(data);
+                  } else if (data && typeof data === "object") {
+                    data = JSON.stringify(data);
+                  }
+                  rr.resSetHeaders(headers);
+                  rr.resSetStatusCode(status);
+                  rr.resWrite(data);
                 }
-                rr.resSetHeaders(headers);
-                rr.resSetStatusCode(status);
-                rr.resWrite(data);
               }
             }
             if (this.option.noSuchRouteEndPointMappingThrow && methods.length <= 0 && rr.reqMethod()?.toUpperCase() !== "OPTIONS" /* OPTIONS */) {
@@ -29522,7 +29722,7 @@ ${indentStr}}`;
   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: "@" };
@@ -29545,6 +29745,8 @@ ${indentStr}}`;
       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;
     }
@@ -29649,10 +29851,15 @@ ${indentStr}}`;
             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)) {
@@ -29677,7 +29884,6 @@ ${indentStr}}`;
                     }
                   }
               `)(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) {
@@ -29697,6 +29903,15 @@ ${indentStr}}`;
         }
       }
     }
+    /** 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) => {
@@ -30074,15 +30289,21 @@ ${indentStr}}`;
       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;
@@ -30091,38 +30312,17 @@ ${indentStr}}`;
       }
     }
     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;
@@ -30131,14 +30331,7 @@ ${indentStr}}`;
       }
     }
     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;
@@ -30147,38 +30340,17 @@ ${indentStr}}`;
       }
     }
     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;
@@ -30198,14 +30370,7 @@ ${indentStr}}`;
       }
     }
     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) {
@@ -30213,14 +30378,7 @@ ${indentStr}}`;
       }
     }
     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) {
@@ -30228,14 +30386,7 @@ ${indentStr}}`;
       }
     }
     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) {
@@ -30926,6 +31077,7 @@ ${indentStr}}`;
   var ROUTER_NO_EVENT_MARKER = "__ROUTER_NO_EVENT__";
   var Router2 = class {
     constructor(config) {
+      this.leaveGuards = /* @__PURE__ */ new Set();
       this._config = config;
       let routeData;
       if (config?.firstUrl) {
@@ -30946,13 +31098,39 @@ ${indentStr}}`;
         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();
     }
@@ -31083,17 +31261,24 @@ ${indentStr}}`;
       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;