@nine-lab/nine-util 0.6.0 → 0.8.0

package/dist/nine-util.js

@@ -9,7 +9,7 @@ var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "acce
 var _name, _color, _enabled, _Trace_instances, autoConfig_fn, _timer, _queue, _delay, _TaskDebouncer_instances, flush_fn;
 class Trace {
   // 👈 이 상태값이 기준이 됩니다.
-  constructor(name = "nine-util", color = "green") {
+  constructor(name = null, color = "green") {
     __privateAdd(this, _Trace_instances);
     __privateAdd(this, _name);
     __privateAdd(this, _color);
@@ -26,15 +26,14 @@ class Trace {
   log(...args) {
     if (!__privateGet(this, _enabled)) return;
     const style = `color: ${__privateGet(this, _color)}; font-weight: bold;`;
-    console.log(`%c[${__privateGet(this, _name)}]`, style, ...args);
+    __privateGet(this, _name) ? console.log(`%c[${__privateGet(this, _name)}]`, style, ...args) : console.log(...args);
   }
   warn(...args) {
     if (!__privateGet(this, _enabled)) return;
-    console.warn(`%c[${__privateGet(this, _name)}]`, "color: cyan; font-weight: bold;", ...args);
+    __privateGet(this, _name) ? console.warn(`%c[${__privateGet(this, _name)}]`, "color: cyan; font-weight: bold;", ...args) : console.warn(...args);
   }
   error(...args) {
-    if (!__privateGet(this, _enabled)) return;
-    console.error(`%c[${__privateGet(this, _name)}]`, "color: red; font-weight: bold;", ...args);
+    __privateGet(this, _name) ? console.error(`%c[${__privateGet(this, _name)}]`, "color: red; font-weight: bold;", ...args) : console.error(...args);
   }
   enable() {
     __privateSet(this, _enabled, true);

package/dist/nine-util.js.map

@@ -1 +1 @@
-{"version":3,"file":"nine-util.js","sources":["../src/Trace.js","../src/TaskDebouncer.js"],"sourcesContent":["export class Trace {\r\n\t#name;\r\n\t#color;\r\n\t#enabled = true; // 👈 이 상태값이 기준이 됩니다.\r\n\r\n\tconstructor(name = \"nine-util\", color = \"green\") {\r\n\t\tthis.#name = name;\r\n\t\tthis.#color = color;\r\n\r\n\t\t// 인스턴스가 생성될 때 자동으로 환경을 체크해서 끄거나 켭니다.\r\n\t\tthis.#autoConfig();\r\n\t}\r\n\r\n\t#autoConfig() {\r\n\t\tif (typeof window === 'undefined') return;\r\n\r\n\t\tconst isLocal = window.location.hostname === 'localhost' ||\r\n\t\t\twindow.location.hostname === '127.0.0.1' ||\r\n\t\t\twindow.location.hostname.startsWith('192.168.'); // 로컬 IP 추가\r\n\r\n\t\tif (isLocal) {\r\n\t\t\tthis.enable();\r\n\t\t\t// 로컬일 때는 환영 메시지 (딱 한 번만 나오게 하려면 클래스 변수 활용 가능)\r\n\t\t} else {\r\n\t\t\tthis.disable();\r\n\t\t\t// 운영 환경 안내 메시지는 console.log로 직접 출력\r\n\t\t\tconsole.log(\r\n\t\t\t\t`%c[${this.#name}]%c 운영 모드: 로그가 비활성화되었습니다. %ctrace.enable()%c 로 켤 수 있습니다.`,\r\n\t\t\t\t\"color: #4CAF50; font-weight: bold;\", \"\",\r\n\t\t\t\t\"background: #333; color: yellow; padding: 2px 5px;\", \"\"\r\n\t\t\t);\r\n\t\t}\r\n\t}\r\n\r\n\tinit(name, color = \"green\") {\r\n\t\tthis.#name = name;\r\n\t\tthis.#color = color;\r\n\t}\r\n\r\n\t// 🔴 핵심: 함수를 갈아끼우지 않고, 호출될 때마다 상태를 체크합니다.\r\n\tlog(...args) {\r\n\t\tif (!this.#enabled) return;\r\n\t\tconst style = `color: ${this.#color}; font-weight: bold;`;\r\n\t\tconsole.log(`%c[${this.#name}]`, style, ...args);\r\n\t}\r\n\r\n\twarn(...args) {\r\n\t\tif (!this.#enabled) return;\r\n\t\tconsole.warn(`%c[${this.#name}]`, \"color: cyan; font-weight: bold;\", ...args);\r\n\t}\r\n\r\n\terror(...args) {\r\n\t\tif (!this.#enabled) return;\r\n\t\tconsole.error(`%c[${this.#name}]`, \"color: red; font-weight: bold;\", ...args);\r\n\t}\r\n\r\n\tenable() { this.#enabled = true; }\r\n\tdisable() { this.#enabled = false; }\r\n}\r\n\r\nexport const trace = new Trace();\r\n\r\n// 브라우저 콘솔에서 즉시 제어할 수 있도록 window에 연결\r\nif (typeof window !== 'undefined') {\r\n\twindow.trace = trace;\r\n}","export class TaskDebouncer {\r\n\t#timer = null;\r\n\t#queue = [];\r\n\t#delay;\r\n\r\n\tconstructor(delay = 50) {\r\n\t\tthis.#delay = delay;\r\n\t}\r\n\r\n\t/**\r\n\t * @param {Function} func - 실행할 함수\r\n\t * @param {...any} args - 함수에 전달할 임의의 파라미터들\r\n\t */\r\n\texec(func, ...args) {\r\n\t\t// 1. 어떤 함수와 어떤 인자들이 들어왔는지 큐에 저장\r\n\t\tthis.#queue.push({ func, args });\r\n\r\n\t\t// 2. 디바운스 타이머 설정\r\n\t\tif (this.#timer) clearTimeout(this.#timer);\r\n\r\n\t\tthis.#timer = setTimeout(() => {\r\n\t\t\tthis.#flush();\r\n\t\t}, this.#delay);\r\n\t}\r\n\r\n\t#flush() {\r\n\t\tif (this.#queue.length === 0) return;\r\n\r\n\t\t// 3. 현재까지 쌓인 큐를 쏙 빼옴\r\n\t\tconst tasks = this.#queue.splice(0, this.#queue.length);\r\n\t\tconst seen = new Set();\r\n\r\n\t\ttasks.forEach(task => {\r\n\t\t\t// 4. 핵심: 함수 이름과 인자들을 문자열로 합쳐서 유니크 키 생성\r\n\t\t\t// JSON.stringify를 통해 [1, {a:1}] 같은 파라미터도 문자열로 비교 가능\r\n\t\t\tconst identifier = `${task.func.name}_${JSON.stringify(task.args)}`;\r\n\r\n\t\t\tif (!seen.has(identifier)) {\r\n\t\t\t\t// 5. 중복이 아닐 때만 원래 인자들(...args) 그대로 실행\r\n\t\t\t\ttask.func(...task.args);\r\n\t\t\t\tseen.add(identifier);\r\n\t\t\t}\r\n\t\t});\r\n\r\n\t\tthis.#timer = null;\r\n\t}\r\n}"],"names":[],"mappings":";;;;;;;;AAAO;AAAA,MAAM,MAAM;AAAA;AAAA,EAKlB,YAAY,OAAO,aAAa,QAAQ,SAAS;AAL3C;AACN;AACA;AACA,iCAAW;AAGV,uBAAK,OAAQ;AACb,uBAAK,QAAS;AAGd,0BAAK,iCAAL;AAAA,EACD;AAAA,EAuBA,KAAK,MAAM,QAAQ,SAAS;AAC3B,uBAAK,OAAQ;AACb,uBAAK,QAAS;AAAA,EACf;AAAA;AAAA,EAGA,OAAO,MAAM;AACZ,QAAI,CAAC,mBAAK,UAAU;AACpB,UAAM,QAAQ,UAAU,mBAAK,OAAM;AACnC,YAAQ,IAAI,MAAM,mBAAK,MAAK,KAAK,OAAO,GAAG,IAAI;AAAA,EAChD;AAAA,EAEA,QAAQ,MAAM;AACb,QAAI,CAAC,mBAAK,UAAU;AACpB,YAAQ,KAAK,MAAM,mBAAK,MAAK,KAAK,mCAAmC,GAAG,IAAI;AAAA,EAC7E;AAAA,EAEA,SAAS,MAAM;AACd,QAAI,CAAC,mBAAK,UAAU;AACpB,YAAQ,MAAM,MAAM,mBAAK,MAAK,KAAK,kCAAkC,GAAG,IAAI;AAAA,EAC7E;AAAA,EAEA,SAAS;AAAE,uBAAK,UAAW;AAAA,EAAM;AAAA,EACjC,UAAU;AAAE,uBAAK,UAAW;AAAA,EAAO;AACpC;AAzDC;AACA;AACA;AAHM;AAaN,gBAAW,WAAG;AACb,MAAI,OAAO,WAAW,YAAa;AAEnC,QAAM,UAAU,OAAO,SAAS,aAAa,eAC5C,OAAO,SAAS,aAAa,eAC7B,OAAO,SAAS,SAAS,WAAW,UAAU;AAE/C,MAAI,SAAS;AACZ,SAAK,OAAM;AAAA,EAEZ,OAAO;AACN,SAAK,QAAO;AAEZ,YAAQ;AAAA,MACP,MAAM,mBAAK,MAAK;AAAA,MAChB;AAAA,MAAsC;AAAA,MACtC;AAAA,MAAsD;AAAA,IAC1D;AAAA,EACE;AACD;AA4BW,MAAC,QAAQ,IAAI,MAAK;AAG9B,IAAI,OAAO,WAAW,aAAa;AAClC,SAAO,QAAQ;AAChB;ACjEO,MAAM,cAAc;AAAA,EAK1B,YAAY,QAAQ,IAAI;AALlB;AACN,+BAAS;AACT,+BAAS,CAAA;AACT;AAGC,uBAAK,QAAS;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,KAAK,SAAS,MAAM;AAEnB,uBAAK,QAAO,KAAK,EAAE,MAAM,KAAI,CAAE;AAG/B,QAAI,mBAAK,QAAQ,cAAa,mBAAK,OAAM;AAEzC,uBAAK,QAAS,WAAW,MAAM;AAC9B,4BAAK,oCAAL;AAAA,IACD,GAAG,mBAAK,OAAM;AAAA,EACf;AAuBD;AA7CC;AACA;AACA;AAHM;AAyBN,WAAM,WAAG;AACR,MAAI,mBAAK,QAAO,WAAW,EAAG;AAG9B,QAAM,QAAQ,mBAAK,QAAO,OAAO,GAAG,mBAAK,QAAO,MAAM;AACtD,QAAM,OAAO,oBAAI;AAEjB,QAAM,QAAQ,UAAQ;AAGrB,UAAM,aAAa,GAAG,KAAK,KAAK,IAAI,IAAI,KAAK,UAAU,KAAK,IAAI,CAAC;AAEjE,QAAI,CAAC,KAAK,IAAI,UAAU,GAAG;AAE1B,WAAK,KAAK,GAAG,KAAK,IAAI;AACtB,WAAK,IAAI,UAAU;AAAA,IACpB;AAAA,EACD,CAAC;AAED,qBAAK,QAAS;AACf;"}
+{"version":3,"file":"nine-util.js","sources":["../src/Trace.js","../src/TaskDebouncer.js"],"sourcesContent":["export class Trace {\r\n\t#name;\r\n\t#color;\r\n\t#enabled = true; // 👈 이 상태값이 기준이 됩니다.\r\n\r\n\tconstructor(name = null, color = \"green\") {\r\n\t\tthis.#name = name;\r\n\t\tthis.#color = color;\r\n\r\n\t\t// 인스턴스가 생성될 때 자동으로 환경을 체크해서 끄거나 켭니다.\r\n\t\tthis.#autoConfig();\r\n\t}\r\n\r\n\t#autoConfig() {\r\n\t\tif (typeof window === 'undefined') return;\r\n\r\n\t\tconst isLocal = window.location.hostname === 'localhost' ||\r\n\t\t\twindow.location.hostname === '127.0.0.1' ||\r\n\t\t\twindow.location.hostname.startsWith('192.168.'); // 로컬 IP 추가\r\n\r\n\t\tif (isLocal) {\r\n\t\t\tthis.enable();\r\n\t\t\t// 로컬일 때는 환영 메시지 (딱 한 번만 나오게 하려면 클래스 변수 활용 가능)\r\n\t\t} else {\r\n\t\t\tthis.disable();\r\n\t\t\t// 운영 환경 안내 메시지는 console.log로 직접 출력\r\n\t\t\tconsole.log(\r\n\t\t\t\t`%c[${this.#name}]%c 운영 모드: 로그가 비활성화되었습니다. %ctrace.enable()%c 로 켤 수 있습니다.`,\r\n\t\t\t\t\"color: #4CAF50; font-weight: bold;\", \"\",\r\n\t\t\t\t\"background: #333; color: yellow; padding: 2px 5px;\", \"\"\r\n\t\t\t);\r\n\t\t}\r\n\t}\r\n\r\n\tinit(name, color = \"green\") {\r\n\t\tthis.#name = name;\r\n\t\tthis.#color = color;\r\n\t}\r\n\r\n\t// 🔴 핵심: 함수를 갈아끼우지 않고, 호출될 때마다 상태를 체크합니다.\r\n\tlog(...args) {\r\n\t\tif (!this.#enabled) return;\r\n\t\tconst style = `color: ${this.#color}; font-weight: bold;`;\r\n\t\t(this.#name) ? console.log(`%c[${this.#name}]`, style, ...args) : console.log(...args);\r\n\t}\r\n\r\n\twarn(...args) {\r\n\t\tif (!this.#enabled) return;\r\n\t\t(this.#name) ? console.warn(`%c[${this.#name}]`, \"color: cyan; font-weight: bold;\", ...args) : console.warn(...args);\r\n\t}\r\n\r\n\terror(...args) {\r\n\t\t//if (!this.#enabled) return;\r\n\t\t(this.#name) ? console.error(`%c[${this.#name}]`, \"color: red; font-weight: bold;\", ...args) : console.error(...args);\r\n\t}\r\n\r\n\tenable() { this.#enabled = true; }\r\n\tdisable() { this.#enabled = false; }\r\n}\r\n\r\nexport const trace = new Trace();\r\n\r\n// 브라우저 콘솔에서 즉시 제어할 수 있도록 window에 연결\r\nif (typeof window !== 'undefined') {\r\n\twindow.trace = trace;\r\n}","export class TaskDebouncer {\r\n\t#timer = null;\r\n\t#queue = [];\r\n\t#delay;\r\n\r\n\tconstructor(delay = 50) {\r\n\t\tthis.#delay = delay;\r\n\t}\r\n\r\n\t/**\r\n\t * @param {Function} func - 실행할 함수\r\n\t * @param {...any} args - 함수에 전달할 임의의 파라미터들\r\n\t */\r\n\texec(func, ...args) {\r\n\t\t// 1. 어떤 함수와 어떤 인자들이 들어왔는지 큐에 저장\r\n\t\tthis.#queue.push({ func, args });\r\n\r\n\t\t// 2. 디바운스 타이머 설정\r\n\t\tif (this.#timer) clearTimeout(this.#timer);\r\n\r\n\t\tthis.#timer = setTimeout(() => {\r\n\t\t\tthis.#flush();\r\n\t\t}, this.#delay);\r\n\t}\r\n\r\n\t#flush() {\r\n\t\tif (this.#queue.length === 0) return;\r\n\r\n\t\t// 3. 현재까지 쌓인 큐를 쏙 빼옴\r\n\t\tconst tasks = this.#queue.splice(0, this.#queue.length);\r\n\t\tconst seen = new Set();\r\n\r\n\t\ttasks.forEach(task => {\r\n\t\t\t// 4. 핵심: 함수 이름과 인자들을 문자열로 합쳐서 유니크 키 생성\r\n\t\t\t// JSON.stringify를 통해 [1, {a:1}] 같은 파라미터도 문자열로 비교 가능\r\n\t\t\tconst identifier = `${task.func.name}_${JSON.stringify(task.args)}`;\r\n\r\n\t\t\tif (!seen.has(identifier)) {\r\n\t\t\t\t// 5. 중복이 아닐 때만 원래 인자들(...args) 그대로 실행\r\n\t\t\t\ttask.func(...task.args);\r\n\t\t\t\tseen.add(identifier);\r\n\t\t\t}\r\n\t\t});\r\n\r\n\t\tthis.#timer = null;\r\n\t}\r\n}"],"names":[],"mappings":";;;;;;;;AAAO;AAAA,MAAM,MAAM;AAAA;AAAA,EAKlB,YAAY,OAAO,MAAM,QAAQ,SAAS;AALpC;AACN;AACA;AACA,iCAAW;AAGV,uBAAK,OAAQ;AACb,uBAAK,QAAS;AAGd,0BAAK,iCAAL;AAAA,EACD;AAAA,EAuBA,KAAK,MAAM,QAAQ,SAAS;AAC3B,uBAAK,OAAQ;AACb,uBAAK,QAAS;AAAA,EACf;AAAA;AAAA,EAGA,OAAO,MAAM;AACZ,QAAI,CAAC,mBAAK,UAAU;AACpB,UAAM,QAAQ,UAAU,mBAAK,OAAM;AACnC,IAAC,mBAAK,SAAS,QAAQ,IAAI,MAAM,mBAAK,MAAK,KAAK,OAAO,GAAG,IAAI,IAAI,QAAQ,IAAI,GAAG,IAAI;AAAA,EACtF;AAAA,EAEA,QAAQ,MAAM;AACb,QAAI,CAAC,mBAAK,UAAU;AACpB,IAAC,mBAAK,SAAS,QAAQ,KAAK,MAAM,mBAAK,MAAK,KAAK,mCAAmC,GAAG,IAAI,IAAI,QAAQ,KAAK,GAAG,IAAI;AAAA,EACpH;AAAA,EAEA,SAAS,MAAM;AAEd,IAAC,mBAAK,SAAS,QAAQ,MAAM,MAAM,mBAAK,MAAK,KAAK,kCAAkC,GAAG,IAAI,IAAI,QAAQ,MAAM,GAAG,IAAI;AAAA,EACrH;AAAA,EAEA,SAAS;AAAE,uBAAK,UAAW;AAAA,EAAM;AAAA,EACjC,UAAU;AAAE,uBAAK,UAAW;AAAA,EAAO;AACpC;AAzDC;AACA;AACA;AAHM;AAaN,gBAAW,WAAG;AACb,MAAI,OAAO,WAAW,YAAa;AAEnC,QAAM,UAAU,OAAO,SAAS,aAAa,eAC5C,OAAO,SAAS,aAAa,eAC7B,OAAO,SAAS,SAAS,WAAW,UAAU;AAE/C,MAAI,SAAS;AACZ,SAAK,OAAM;AAAA,EAEZ,OAAO;AACN,SAAK,QAAO;AAEZ,YAAQ;AAAA,MACP,MAAM,mBAAK,MAAK;AAAA,MAChB;AAAA,MAAsC;AAAA,MACtC;AAAA,MAAsD;AAAA,IAC1D;AAAA,EACE;AACD;AA4BW,MAAC,QAAQ,IAAI,MAAK;AAG9B,IAAI,OAAO,WAAW,aAAa;AAClC,SAAO,QAAQ;AAChB;ACjEO,MAAM,cAAc;AAAA,EAK1B,YAAY,QAAQ,IAAI;AALlB;AACN,+BAAS;AACT,+BAAS,CAAA;AACT;AAGC,uBAAK,QAAS;AAAA,EACf;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,KAAK,SAAS,MAAM;AAEnB,uBAAK,QAAO,KAAK,EAAE,MAAM,KAAI,CAAE;AAG/B,QAAI,mBAAK,QAAQ,cAAa,mBAAK,OAAM;AAEzC,uBAAK,QAAS,WAAW,MAAM;AAC9B,4BAAK,oCAAL;AAAA,IACD,GAAG,mBAAK,OAAM;AAAA,EACf;AAuBD;AA7CC;AACA;AACA;AAHM;AAyBN,WAAM,WAAG;AACR,MAAI,mBAAK,QAAO,WAAW,EAAG;AAG9B,QAAM,QAAQ,mBAAK,QAAO,OAAO,GAAG,mBAAK,QAAO,MAAM;AACtD,QAAM,OAAO,oBAAI;AAEjB,QAAM,QAAQ,UAAQ;AAGrB,UAAM,aAAa,GAAG,KAAK,KAAK,IAAI,IAAI,KAAK,UAAU,KAAK,IAAI,CAAC;AAEjE,QAAI,CAAC,KAAK,IAAI,UAAU,GAAG;AAE1B,WAAK,KAAK,GAAG,KAAK,IAAI;AACtB,WAAK,IAAI,UAAU;AAAA,IACpB;AAAA,EACD,CAAC;AAED,qBAAK,QAAS;AACf;"}

package/dist/nine-util.umd.cjs

@@ -1,2 +1,2 @@
-!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).NineUtil={})}(this,function(e){"use strict";var t,i,n,o,s,a,h,c,r,l,d=e=>{throw TypeError(e)},f=(e,t,i)=>t.has(e)||d("Cannot "+i),w=(e,t,i)=>(f(e,t,"read from private field"),i?i.call(e):t.get(e)),u=(e,t,i)=>t.has(e)?d("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(e):t.set(e,i),p=(e,t,i,n)=>(f(e,t,"write to private field"),n?n.call(e,i):t.set(e,i),i),g=(e,t,i)=>(f(e,t,"access private method"),i);class b{constructor(e="nine-util",a="green"){u(this,o),u(this,t),u(this,i),u(this,n,!0),p(this,t,e),p(this,i,a),g(this,o,s).call(this)}init(e,n="green"){p(this,t,e),p(this,i,n)}log(...e){if(!w(this,n))return;const o=`color: ${w(this,i)}; font-weight: bold;`;console.log(`%c[${w(this,t)}]`,o,...e)}warn(...e){w(this,n)&&console.warn(`%c[${w(this,t)}]`,"color: cyan; font-weight: bold;",...e)}error(...e){w(this,n)&&console.error(`%c[${w(this,t)}]`,"color: red; font-weight: bold;",...e)}enable(){p(this,n,!0)}disable(){p(this,n,!1)}}t=new WeakMap,i=new WeakMap,n=new WeakMap,o=new WeakSet,s=function(){if("undefined"==typeof window)return;"localhost"===window.location.hostname||"127.0.0.1"===window.location.hostname||window.location.hostname.startsWith("192.168.")?this.enable():(this.disable(),console.log(`%c[${w(this,t)}]%c 운영 모드: 로그가 비활성화되었습니다. %ctrace.enable()%c 로 켤 수 있습니다.`,"color: #4CAF50; font-weight: bold;","","background: #333; color: yellow; padding: 2px 5px;",""))};const m=new b;"undefined"!=typeof window&&(window.trace=m);a=new WeakMap,h=new WeakMap,c=new WeakMap,r=new WeakSet,l=function(){if(0===w(this,h).length)return;const e=w(this,h).splice(0,w(this,h).length),t=new Set;e.forEach(e=>{const i=`${e.func.name}_${JSON.stringify(e.args)}`;t.has(i)||(e.func(...e.args),t.add(i))}),p(this,a,null)},e.TaskDebouncer=class{constructor(e=50){u(this,r),u(this,a,null),u(this,h,[]),u(this,c),p(this,c,e)}exec(e,...t){w(this,h).push({func:e,args:t}),w(this,a)&&clearTimeout(w(this,a)),p(this,a,setTimeout(()=>{g(this,r,l).call(this)},w(this,c)))}},e.Trace=b,e.trace=m,Object.defineProperty(e,Symbol.toStringTag,{value:"Module"})});
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self).NineUtil={})}(this,function(e){"use strict";var t,o,n,i,s,a,l,r,c,h,d=e=>{throw TypeError(e)},f=(e,t,o)=>t.has(e)||d("Cannot "+o),w=(e,t,o)=>(f(e,t,"read from private field"),o?o.call(e):t.get(e)),u=(e,t,o)=>t.has(e)?d("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(e):t.set(e,o),p=(e,t,o,n)=>(f(e,t,"write to private field"),n?n.call(e,o):t.set(e,o),o),g=(e,t,o)=>(f(e,t,"access private method"),o);class b{constructor(e=null,a="green"){u(this,i),u(this,t),u(this,o),u(this,n,!0),p(this,t,e),p(this,o,a),g(this,i,s).call(this)}init(e,n="green"){p(this,t,e),p(this,o,n)}log(...e){if(!w(this,n))return;const i=`color: ${w(this,o)}; font-weight: bold;`;w(this,t)?console.log(`%c[${w(this,t)}]`,i,...e):console.log(...e)}warn(...e){w(this,n)&&(w(this,t)?console.warn(`%c[${w(this,t)}]`,"color: cyan; font-weight: bold;",...e):console.warn(...e))}error(...e){w(this,t)?console.error(`%c[${w(this,t)}]`,"color: red; font-weight: bold;",...e):console.error(...e)}enable(){p(this,n,!0)}disable(){p(this,n,!1)}}t=new WeakMap,o=new WeakMap,n=new WeakMap,i=new WeakSet,s=function(){if("undefined"==typeof window)return;"localhost"===window.location.hostname||"127.0.0.1"===window.location.hostname||window.location.hostname.startsWith("192.168.")?this.enable():(this.disable(),console.log(`%c[${w(this,t)}]%c 운영 모드: 로그가 비활성화되었습니다. %ctrace.enable()%c 로 켤 수 있습니다.`,"color: #4CAF50; font-weight: bold;","","background: #333; color: yellow; padding: 2px 5px;",""))};const m=new b;"undefined"!=typeof window&&(window.trace=m);a=new WeakMap,l=new WeakMap,r=new WeakMap,c=new WeakSet,h=function(){if(0===w(this,l).length)return;const e=w(this,l).splice(0,w(this,l).length),t=new Set;e.forEach(e=>{const o=`${e.func.name}_${JSON.stringify(e.args)}`;t.has(o)||(e.func(...e.args),t.add(o))}),p(this,a,null)},e.TaskDebouncer=class{constructor(e=50){u(this,c),u(this,a,null),u(this,l,[]),u(this,r),p(this,r,e)}exec(e,...t){w(this,l).push({func:e,args:t}),w(this,a)&&clearTimeout(w(this,a)),p(this,a,setTimeout(()=>{g(this,c,h).call(this)},w(this,r)))}},e.Trace=b,e.trace=m,Object.defineProperty(e,Symbol.toStringTag,{value:"Module"})});
 //# sourceMappingURL=nine-util.umd.cjs.map

package/dist/nine-util.umd.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"nine-util.umd.cjs","sources":["../src/Trace.js","../src/TaskDebouncer.js"],"sourcesContent":["export class Trace {\r\n\t#name;\r\n\t#color;\r\n\t#enabled = true; // 👈 이 상태값이 기준이 됩니다.\r\n\r\n\tconstructor(name = \"nine-util\", color = \"green\") {\r\n\t\tthis.#name = name;\r\n\t\tthis.#color = color;\r\n\r\n\t\t// 인스턴스가 생성될 때 자동으로 환경을 체크해서 끄거나 켭니다.\r\n\t\tthis.#autoConfig();\r\n\t}\r\n\r\n\t#autoConfig() {\r\n\t\tif (typeof window === 'undefined') return;\r\n\r\n\t\tconst isLocal = window.location.hostname === 'localhost' ||\r\n\t\t\twindow.location.hostname === '127.0.0.1' ||\r\n\t\t\twindow.location.hostname.startsWith('192.168.'); // 로컬 IP 추가\r\n\r\n\t\tif (isLocal) {\r\n\t\t\tthis.enable();\r\n\t\t\t// 로컬일 때는 환영 메시지 (딱 한 번만 나오게 하려면 클래스 변수 활용 가능)\r\n\t\t} else {\r\n\t\t\tthis.disable();\r\n\t\t\t// 운영 환경 안내 메시지는 console.log로 직접 출력\r\n\t\t\tconsole.log(\r\n\t\t\t\t`%c[${this.#name}]%c 운영 모드: 로그가 비활성화되었습니다. %ctrace.enable()%c 로 켤 수 있습니다.`,\r\n\t\t\t\t\"color: #4CAF50; font-weight: bold;\", \"\",\r\n\t\t\t\t\"background: #333; color: yellow; padding: 2px 5px;\", \"\"\r\n\t\t\t);\r\n\t\t}\r\n\t}\r\n\r\n\tinit(name, color = \"green\") {\r\n\t\tthis.#name = name;\r\n\t\tthis.#color = color;\r\n\t}\r\n\r\n\t// 🔴 핵심: 함수를 갈아끼우지 않고, 호출될 때마다 상태를 체크합니다.\r\n\tlog(...args) {\r\n\t\tif (!this.#enabled) return;\r\n\t\tconst style = `color: ${this.#color}; font-weight: bold;`;\r\n\t\tconsole.log(`%c[${this.#name}]`, style, ...args);\r\n\t}\r\n\r\n\twarn(...args) {\r\n\t\tif (!this.#enabled) return;\r\n\t\tconsole.warn(`%c[${this.#name}]`, \"color: cyan; font-weight: bold;\", ...args);\r\n\t}\r\n\r\n\terror(...args) {\r\n\t\tif (!this.#enabled) return;\r\n\t\tconsole.error(`%c[${this.#name}]`, \"color: red; font-weight: bold;\", ...args);\r\n\t}\r\n\r\n\tenable() { this.#enabled = true; }\r\n\tdisable() { this.#enabled = false; }\r\n}\r\n\r\nexport const trace = new Trace();\r\n\r\n// 브라우저 콘솔에서 즉시 제어할 수 있도록 window에 연결\r\nif (typeof window !== 'undefined') {\r\n\twindow.trace = trace;\r\n}","export class TaskDebouncer {\r\n\t#timer = null;\r\n\t#queue = [];\r\n\t#delay;\r\n\r\n\tconstructor(delay = 50) {\r\n\t\tthis.#delay = delay;\r\n\t}\r\n\r\n\t/**\r\n\t * @param {Function} func - 실행할 함수\r\n\t * @param {...any} args - 함수에 전달할 임의의 파라미터들\r\n\t */\r\n\texec(func, ...args) {\r\n\t\t// 1. 어떤 함수와 어떤 인자들이 들어왔는지 큐에 저장\r\n\t\tthis.#queue.push({ func, args });\r\n\r\n\t\t// 2. 디바운스 타이머 설정\r\n\t\tif (this.#timer) clearTimeout(this.#timer);\r\n\r\n\t\tthis.#timer = setTimeout(() => {\r\n\t\t\tthis.#flush();\r\n\t\t}, this.#delay);\r\n\t}\r\n\r\n\t#flush() {\r\n\t\tif (this.#queue.length === 0) return;\r\n\r\n\t\t// 3. 현재까지 쌓인 큐를 쏙 빼옴\r\n\t\tconst tasks = this.#queue.splice(0, this.#queue.length);\r\n\t\tconst seen = new Set();\r\n\r\n\t\ttasks.forEach(task => {\r\n\t\t\t// 4. 핵심: 함수 이름과 인자들을 문자열로 합쳐서 유니크 키 생성\r\n\t\t\t// JSON.stringify를 통해 [1, {a:1}] 같은 파라미터도 문자열로 비교 가능\r\n\t\t\tconst identifier = `${task.func.name}_${JSON.stringify(task.args)}`;\r\n\r\n\t\t\tif (!seen.has(identifier)) {\r\n\t\t\t\t// 5. 중복이 아닐 때만 원래 인자들(...args) 그대로 실행\r\n\t\t\t\ttask.func(...task.args);\r\n\t\t\t\tseen.add(identifier);\r\n\t\t\t}\r\n\t\t});\r\n\r\n\t\tthis.#timer = null;\r\n\t}\r\n}"],"names":["Trace","constructor","name","color","__privateAdd","this","_Trace_instances","_name","_color","_enabled","__privateSet","__privateMethod","autoConfig_fn","call","init","log","args","__privateGet","style","console","warn","error","enable","disable","WeakMap","WeakSet","window","location","hostname","startsWith","trace","_timer","_queue","_delay","_TaskDebouncer_instances","flush_fn","length","tasks","splice","seen","Set","forEach","task","identifier","func","JSON","stringify","has","add","delay","exec","push","clearTimeout","setTimeout"],"mappings":"onBAAO,MAAMA,EAKZ,WAAAC,CAAYC,EAAO,YAAaC,EAAQ,SALlCC,EAAAC,KAAAC,GACNF,EAAAC,KAAAE,GACAH,EAAAC,KAAAG,GACAJ,EAAAC,KAAAI,GAAW,GAGVC,EAAAL,KAAKE,EAAQL,GACbQ,EAAAL,KAAKG,EAASL,GAGdQ,EAAAN,KAAKC,EAAAM,GAALC,KAAAR,KACD,CAuBA,IAAAS,CAAKZ,EAAMC,EAAQ,SAClBO,EAAAL,KAAKE,EAAQL,GACbQ,EAAAL,KAAKG,EAASL,EACf,CAGA,GAAAY,IAAOC,GACN,IAAKC,OAAKR,GAAU,OACpB,MAAMS,EAAQ,UAAUD,EAAAZ,KAAKG,yBAC7BW,QAAQJ,IAAI,MAAME,EAAAZ,KAAKE,MAAUW,KAAUF,EAC5C,CAEA,IAAAI,IAAQJ,GACFC,OAAKR,IACVU,QAAQC,KAAK,MAAMH,EAAAZ,KAAKE,MAAU,qCAAsCS,EACzE,CAEA,KAAAK,IAASL,GACHC,OAAKR,IACVU,QAAQE,MAAM,MAAMJ,EAAAZ,KAAKE,MAAU,oCAAqCS,EACzE,CAEA,MAAAM,GAAWZ,EAAAL,KAAKI,GAAW,EAAM,CACjC,OAAAc,GAAYb,EAAAL,KAAKI,GAAW,EAAO,EAxDnCF,EAAA,IAAAiB,QACAhB,EAAA,IAAAgB,QACAf,EAAA,IAAAe,QAHMlB,EAAA,IAAAmB,QAaNb,EAAW,WACV,GAAsB,oBAAXc,OAAwB,OAEU,cAA7BA,OAAOC,SAASC,UACF,cAA7BF,OAAOC,SAASC,UAChBF,OAAOC,SAASC,SAASC,WAAW,YAGpCxB,KAAKiB,UAGLjB,KAAKkB,UAELJ,QAAQJ,IACP,MAAME,OAAKV,6DACX,qCAAsC,GACtC,qDAAsD,IAGzD,EA4BW,MAACuB,EAAQ,IAAI9B,EAGH,oBAAX0B,SACVA,OAAOI,MAAQA,GC/DfC,EAAA,IAAAP,QACAQ,EAAA,IAAAR,QACAS,EAAA,IAAAT,QAHMU,EAAA,IAAAT,QAyBNU,EAAM,WACL,GAA2B,IAAvBlB,EAAAZ,KAAK2B,GAAOI,OAAc,OAG9B,MAAMC,EAAQpB,EAAAZ,KAAK2B,GAAOM,OAAO,EAAGrB,EAAAZ,KAAK2B,GAAOI,QAC1CG,MAAWC,IAEjBH,EAAMI,QAAQC,IAGb,MAAMC,EAAa,GAAGD,EAAKE,KAAK1C,QAAQ2C,KAAKC,UAAUJ,EAAK1B,QAEvDuB,EAAKQ,IAAIJ,KAEbD,EAAKE,QAAQF,EAAK1B,MAClBuB,EAAKS,IAAIL,MAIXjC,EAAAL,KAAK0B,EAAS,KACf,kBA7CM,MAKN,WAAA9B,CAAYgD,EAAQ,IALd7C,EAAAC,KAAA6B,GACN9B,EAAAC,KAAA0B,EAAS,MACT3B,EAAAC,KAAA2B,EAAS,IACT5B,EAAAC,KAAA4B,GAGCvB,EAAAL,KAAK4B,EAASgB,EACf,CAMA,IAAAC,CAAKN,KAAS5B,GAEbC,EAAAZ,KAAK2B,GAAOmB,KAAK,CAAEP,OAAM5B,SAGrBC,EAAAZ,KAAK0B,IAAQqB,aAAanC,EAAAZ,KAAK0B,IAEnCrB,EAAAL,KAAK0B,EAASsB,WAAW,KACxB1C,EAAAN,KAAK6B,EAAAC,GAALtB,KAAAR,OACEY,OAAKgB,IACT"}
+{"version":3,"file":"nine-util.umd.cjs","sources":["../src/Trace.js","../src/TaskDebouncer.js"],"sourcesContent":["export class Trace {\r\n\t#name;\r\n\t#color;\r\n\t#enabled = true; // 👈 이 상태값이 기준이 됩니다.\r\n\r\n\tconstructor(name = null, color = \"green\") {\r\n\t\tthis.#name = name;\r\n\t\tthis.#color = color;\r\n\r\n\t\t// 인스턴스가 생성될 때 자동으로 환경을 체크해서 끄거나 켭니다.\r\n\t\tthis.#autoConfig();\r\n\t}\r\n\r\n\t#autoConfig() {\r\n\t\tif (typeof window === 'undefined') return;\r\n\r\n\t\tconst isLocal = window.location.hostname === 'localhost' ||\r\n\t\t\twindow.location.hostname === '127.0.0.1' ||\r\n\t\t\twindow.location.hostname.startsWith('192.168.'); // 로컬 IP 추가\r\n\r\n\t\tif (isLocal) {\r\n\t\t\tthis.enable();\r\n\t\t\t// 로컬일 때는 환영 메시지 (딱 한 번만 나오게 하려면 클래스 변수 활용 가능)\r\n\t\t} else {\r\n\t\t\tthis.disable();\r\n\t\t\t// 운영 환경 안내 메시지는 console.log로 직접 출력\r\n\t\t\tconsole.log(\r\n\t\t\t\t`%c[${this.#name}]%c 운영 모드: 로그가 비활성화되었습니다. %ctrace.enable()%c 로 켤 수 있습니다.`,\r\n\t\t\t\t\"color: #4CAF50; font-weight: bold;\", \"\",\r\n\t\t\t\t\"background: #333; color: yellow; padding: 2px 5px;\", \"\"\r\n\t\t\t);\r\n\t\t}\r\n\t}\r\n\r\n\tinit(name, color = \"green\") {\r\n\t\tthis.#name = name;\r\n\t\tthis.#color = color;\r\n\t}\r\n\r\n\t// 🔴 핵심: 함수를 갈아끼우지 않고, 호출될 때마다 상태를 체크합니다.\r\n\tlog(...args) {\r\n\t\tif (!this.#enabled) return;\r\n\t\tconst style = `color: ${this.#color}; font-weight: bold;`;\r\n\t\t(this.#name) ? console.log(`%c[${this.#name}]`, style, ...args) : console.log(...args);\r\n\t}\r\n\r\n\twarn(...args) {\r\n\t\tif (!this.#enabled) return;\r\n\t\t(this.#name) ? console.warn(`%c[${this.#name}]`, \"color: cyan; font-weight: bold;\", ...args) : console.warn(...args);\r\n\t}\r\n\r\n\terror(...args) {\r\n\t\t//if (!this.#enabled) return;\r\n\t\t(this.#name) ? console.error(`%c[${this.#name}]`, \"color: red; font-weight: bold;\", ...args) : console.error(...args);\r\n\t}\r\n\r\n\tenable() { this.#enabled = true; }\r\n\tdisable() { this.#enabled = false; }\r\n}\r\n\r\nexport const trace = new Trace();\r\n\r\n// 브라우저 콘솔에서 즉시 제어할 수 있도록 window에 연결\r\nif (typeof window !== 'undefined') {\r\n\twindow.trace = trace;\r\n}","export class TaskDebouncer {\r\n\t#timer = null;\r\n\t#queue = [];\r\n\t#delay;\r\n\r\n\tconstructor(delay = 50) {\r\n\t\tthis.#delay = delay;\r\n\t}\r\n\r\n\t/**\r\n\t * @param {Function} func - 실행할 함수\r\n\t * @param {...any} args - 함수에 전달할 임의의 파라미터들\r\n\t */\r\n\texec(func, ...args) {\r\n\t\t// 1. 어떤 함수와 어떤 인자들이 들어왔는지 큐에 저장\r\n\t\tthis.#queue.push({ func, args });\r\n\r\n\t\t// 2. 디바운스 타이머 설정\r\n\t\tif (this.#timer) clearTimeout(this.#timer);\r\n\r\n\t\tthis.#timer = setTimeout(() => {\r\n\t\t\tthis.#flush();\r\n\t\t}, this.#delay);\r\n\t}\r\n\r\n\t#flush() {\r\n\t\tif (this.#queue.length === 0) return;\r\n\r\n\t\t// 3. 현재까지 쌓인 큐를 쏙 빼옴\r\n\t\tconst tasks = this.#queue.splice(0, this.#queue.length);\r\n\t\tconst seen = new Set();\r\n\r\n\t\ttasks.forEach(task => {\r\n\t\t\t// 4. 핵심: 함수 이름과 인자들을 문자열로 합쳐서 유니크 키 생성\r\n\t\t\t// JSON.stringify를 통해 [1, {a:1}] 같은 파라미터도 문자열로 비교 가능\r\n\t\t\tconst identifier = `${task.func.name}_${JSON.stringify(task.args)}`;\r\n\r\n\t\t\tif (!seen.has(identifier)) {\r\n\t\t\t\t// 5. 중복이 아닐 때만 원래 인자들(...args) 그대로 실행\r\n\t\t\t\ttask.func(...task.args);\r\n\t\t\t\tseen.add(identifier);\r\n\t\t\t}\r\n\t\t});\r\n\r\n\t\tthis.#timer = null;\r\n\t}\r\n}"],"names":["Trace","constructor","name","color","__privateAdd","this","_Trace_instances","_name","_color","_enabled","__privateSet","__privateMethod","autoConfig_fn","call","init","log","args","__privateGet","style","console","warn","error","enable","disable","WeakMap","WeakSet","window","location","hostname","startsWith","trace","_timer","_queue","_delay","_TaskDebouncer_instances","flush_fn","length","tasks","splice","seen","Set","forEach","task","identifier","func","JSON","stringify","has","add","delay","exec","push","clearTimeout","setTimeout"],"mappings":"onBAAO,MAAMA,EAKZ,WAAAC,CAAYC,EAAO,KAAMC,EAAQ,SAL3BC,EAAAC,KAAAC,GACNF,EAAAC,KAAAE,GACAH,EAAAC,KAAAG,GACAJ,EAAAC,KAAAI,GAAW,GAGVC,EAAAL,KAAKE,EAAQL,GACbQ,EAAAL,KAAKG,EAASL,GAGdQ,EAAAN,KAAKC,EAAAM,GAALC,KAAAR,KACD,CAuBA,IAAAS,CAAKZ,EAAMC,EAAQ,SAClBO,EAAAL,KAAKE,EAAQL,GACbQ,EAAAL,KAAKG,EAASL,EACf,CAGA,GAAAY,IAAOC,GACN,IAAKC,OAAKR,GAAU,OACpB,MAAMS,EAAQ,UAAUD,EAAAZ,KAAKG,yBAC5BS,EAAAZ,KAAKE,GAASY,QAAQJ,IAAI,MAAME,EAAAZ,KAAKE,MAAUW,KAAUF,GAAQG,QAAQJ,OAAOC,EAClF,CAEA,IAAAI,IAAQJ,GACFC,OAAKR,KACTQ,EAAAZ,KAAKE,GAASY,QAAQC,KAAK,MAAMH,EAAAZ,KAAKE,MAAU,qCAAsCS,GAAQG,QAAQC,QAAQJ,GAChH,CAEA,KAAAK,IAASL,GAEPC,EAAAZ,KAAKE,GAASY,QAAQE,MAAM,MAAMJ,EAAAZ,KAAKE,MAAU,oCAAqCS,GAAQG,QAAQE,SAASL,EACjH,CAEA,MAAAM,GAAWZ,EAAAL,KAAKI,GAAW,EAAM,CACjC,OAAAc,GAAYb,EAAAL,KAAKI,GAAW,EAAO,EAxDnCF,EAAA,IAAAiB,QACAhB,EAAA,IAAAgB,QACAf,EAAA,IAAAe,QAHMlB,EAAA,IAAAmB,QAaNb,EAAW,WACV,GAAsB,oBAAXc,OAAwB,OAEU,cAA7BA,OAAOC,SAASC,UACF,cAA7BF,OAAOC,SAASC,UAChBF,OAAOC,SAASC,SAASC,WAAW,YAGpCxB,KAAKiB,UAGLjB,KAAKkB,UAELJ,QAAQJ,IACP,MAAME,OAAKV,6DACX,qCAAsC,GACtC,qDAAsD,IAGzD,EA4BW,MAACuB,EAAQ,IAAI9B,EAGH,oBAAX0B,SACVA,OAAOI,MAAQA,GC/DfC,EAAA,IAAAP,QACAQ,EAAA,IAAAR,QACAS,EAAA,IAAAT,QAHMU,EAAA,IAAAT,QAyBNU,EAAM,WACL,GAA2B,IAAvBlB,EAAAZ,KAAK2B,GAAOI,OAAc,OAG9B,MAAMC,EAAQpB,EAAAZ,KAAK2B,GAAOM,OAAO,EAAGrB,EAAAZ,KAAK2B,GAAOI,QAC1CG,MAAWC,IAEjBH,EAAMI,QAAQC,IAGb,MAAMC,EAAa,GAAGD,EAAKE,KAAK1C,QAAQ2C,KAAKC,UAAUJ,EAAK1B,QAEvDuB,EAAKQ,IAAIJ,KAEbD,EAAKE,QAAQF,EAAK1B,MAClBuB,EAAKS,IAAIL,MAIXjC,EAAAL,KAAK0B,EAAS,KACf,kBA7CM,MAKN,WAAA9B,CAAYgD,EAAQ,IALd7C,EAAAC,KAAA6B,GACN9B,EAAAC,KAAA0B,EAAS,MACT3B,EAAAC,KAAA2B,EAAS,IACT5B,EAAAC,KAAA4B,GAGCvB,EAAAL,KAAK4B,EAASgB,EACf,CAMA,IAAAC,CAAKN,KAAS5B,GAEbC,EAAAZ,KAAK2B,GAAOmB,KAAK,CAAEP,OAAM5B,SAGrBC,EAAAZ,KAAK0B,IAAQqB,aAAanC,EAAAZ,KAAK0B,IAEnCrB,EAAAL,KAAK0B,EAASsB,WAAW,KACxB1C,EAAAN,KAAK6B,EAAAC,GAALtB,KAAAR,OACEY,OAAKgB,IACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nine-lab/nine-util",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Custom Element based Util Component for Real-time Collaboration",
   "type": "module",
   "main": "./dist/nine-util.umd.cjs",