@nine-lab/nine-util 0.3.0 → 0.6.0

package/dist/nine-util.js

@@ -6,17 +6,19 @@ var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read fr
 var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
 var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
 var __privateMethod = (obj, member, method) => (__accessCheck(obj, member, "access private method"), method);
-var _name, _color, _enabled, _timer, _queue, _delay, _TaskDebouncer_instances, flush_fn;
+var _name, _color, _enabled, _Trace_instances, autoConfig_fn, _timer, _queue, _delay, _TaskDebouncer_instances, flush_fn;
 class Trace {
   // 👈 이 상태값이 기준이 됩니다.
-  constructor(name = "nine-util", color = "#4CAF50") {
+  constructor(name = "nine-util", color = "green") {
+    __privateAdd(this, _Trace_instances);
     __privateAdd(this, _name);
     __privateAdd(this, _color);
     __privateAdd(this, _enabled, true);
     __privateSet(this, _name, name);
     __privateSet(this, _color, color);
+    __privateMethod(this, _Trace_instances, autoConfig_fn).call(this);
   }
-  init(name, color = "#4CAF50") {
+  init(name, color = "green") {
     __privateSet(this, _name, name);
     __privateSet(this, _color, color);
   }
@@ -28,11 +30,11 @@ class Trace {
   }
   warn(...args) {
     if (!__privateGet(this, _enabled)) return;
-    console.warn(`%c[${__privateGet(this, _name)}-WARN]`, "color: #ffeb3b; font-weight: bold;", ...args);
+    console.warn(`%c[${__privateGet(this, _name)}]`, "color: cyan; font-weight: bold;", ...args);
   }
   error(...args) {
     if (!__privateGet(this, _enabled)) return;
-    console.error(`%c[${__privateGet(this, _name)}-ERR]`, "color: #ff4444; font-weight: bold;", ...args);
+    console.error(`%c[${__privateGet(this, _name)}]`, "color: red; font-weight: bold;", ...args);
   }
   enable() {
     __privateSet(this, _enabled, true);
@@ -44,6 +46,23 @@ class Trace {
 _name = new WeakMap();
 _color = new WeakMap();
 _enabled = new WeakMap();
+_Trace_instances = new WeakSet();
+autoConfig_fn = function() {
+  if (typeof window === "undefined") return;
+  const isLocal = window.location.hostname === "localhost" || window.location.hostname === "127.0.0.1" || window.location.hostname.startsWith("192.168.");
+  if (isLocal) {
+    this.enable();
+  } else {
+    this.disable();
+    console.log(
+      `%c[${__privateGet(this, _name)}]%c 운영 모드: 로그가 비활성화되었습니다. %ctrace.enable()%c 로 켤 수 있습니다.`,
+      "color: #4CAF50; font-weight: bold;",
+      "",
+      "background: #333; color: yellow; padding: 2px 5px;",
+      ""
+    );
+  }
+};
 const trace = new Trace();
 if (typeof window !== "undefined") {
   window.trace = trace;

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 = \"#4CAF50\") {\r\n\t\tthis.#name = name;\r\n\t\tthis.#color = color;\r\n\t}\r\n\r\n\tinit(name, color = \"#4CAF50\") {\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}-WARN]`, \"color: #ffeb3b; 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}-ERR]`, \"color: #ff4444; 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,WAAW;AAJnD;AACA;AACA,iCAAW;AAGV,uBAAK,OAAQ;AACb,uBAAK,QAAS;AAAA,EACf;AAAA,EAEA,KAAK,MAAM,QAAQ,WAAW;AAC7B,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,UAAU,sCAAsC,GAAG,IAAI;AAAA,EACrF;AAAA,EAEA,SAAS,MAAM;AACd,QAAI,CAAC,mBAAK,UAAU;AACpB,YAAQ,MAAM,MAAM,mBAAK,MAAK,SAAS,sCAAsC,GAAG,IAAI;AAAA,EACrF;AAAA,EAEA,SAAS;AAAE,uBAAK,UAAW;AAAA,EAAM;AAAA,EACjC,UAAU;AAAE,uBAAK,UAAW;AAAA,EAAO;AACpC;AAjCC;AACA;AACA;AAiCW,MAAC,QAAQ,IAAI,MAAK;AAG9B,IAAI,OAAO,WAAW,aAAa;AAClC,SAAO,QAAQ;AAChB;ACzCO,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 = \"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;"}

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,s,n,o,a,r,h,c=e=>{throw TypeError(e)},l=(e,t,i)=>t.has(e)||c("Cannot "+i),f=(e,t,i)=>(l(e,t,"read from private field"),i?i.call(e):t.get(e)),d=(e,t,i)=>t.has(e)?c("Cannot add the same private member more than once"):t instanceof WeakSet?t.add(e):t.set(e,i),u=(e,t,i,s)=>(l(e,t,"write to private field"),s?s.call(e,i):t.set(e,i),i);class p{constructor(e="nine-util",n="#4CAF50"){d(this,t),d(this,i),d(this,s,!0),u(this,t,e),u(this,i,n)}init(e,s="#4CAF50"){u(this,t,e),u(this,i,s)}log(...e){if(!f(this,s))return;const n=`color: ${f(this,i)}; font-weight: bold;`;console.log(`%c[${f(this,t)}]`,n,...e)}warn(...e){f(this,s)&&console.warn(`%c[${f(this,t)}-WARN]`,"color: #ffeb3b; font-weight: bold;",...e)}error(...e){f(this,s)&&console.error(`%c[${f(this,t)}-ERR]`,"color: #ff4444; font-weight: bold;",...e)}enable(){u(this,s,!0)}disable(){u(this,s,!1)}}t=new WeakMap,i=new WeakMap,s=new WeakMap;const w=new p;"undefined"!=typeof window&&(window.trace=w);n=new WeakMap,o=new WeakMap,a=new WeakMap,r=new WeakSet,h=function(){if(0===f(this,o).length)return;const e=f(this,o).splice(0,f(this,o).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))}),u(this,n,null)},e.TaskDebouncer=class{constructor(e=50){d(this,r),d(this,n,null),d(this,o,[]),d(this,a),u(this,a,e)}exec(e,...t){f(this,o).push({func:e,args:t}),f(this,n)&&clearTimeout(f(this,n)),u(this,n,setTimeout(()=>{var e,t,i;(e=this,t=r,i=h,l(e,t,"access private method"),i).call(this)},f(this,a)))}},e.Trace=p,e.trace=w,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,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"})});
 //# 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 = \"#4CAF50\") {\r\n\t\tthis.#name = name;\r\n\t\tthis.#color = color;\r\n\t}\r\n\r\n\tinit(name, color = \"#4CAF50\") {\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}-WARN]`, \"color: #ffeb3b; 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}-ERR]`, \"color: #ff4444; 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","_name","_color","_enabled","__privateSet","init","log","args","__privateGet","style","console","warn","error","enable","disable","WeakMap","trace","window","_timer","_queue","_delay","_TaskDebouncer_instances","WeakSet","flush_fn","length","tasks","splice","seen","Set","forEach","task","identifier","func","JSON","stringify","has","add","delay","exec","push","clearTimeout","setTimeout","call"],"mappings":"kkBAAO,MAAMA,EAKZ,WAAAC,CAAYC,EAAO,YAAaC,EAAQ,WAJxCC,EAAAC,KAAAC,GACAF,EAAAC,KAAAE,GACAH,EAAAC,KAAAG,GAAW,GAGVC,EAAAJ,KAAKC,EAAQJ,GACbO,EAAAJ,KAAKE,EAASJ,EACf,CAEA,IAAAO,CAAKR,EAAMC,EAAQ,WAClBM,EAAAJ,KAAKC,EAAQJ,GACbO,EAAAJ,KAAKE,EAASJ,EACf,CAGA,GAAAQ,IAAOC,GACN,IAAKC,OAAKL,GAAU,OACpB,MAAMM,EAAQ,UAAUD,EAAAR,KAAKE,yBAC7BQ,QAAQJ,IAAI,MAAME,EAAAR,KAAKC,MAAUQ,KAAUF,EAC5C,CAEA,IAAAI,IAAQJ,GACFC,OAAKL,IACVO,QAAQC,KAAK,MAAMH,EAAAR,KAAKC,WAAe,wCAAyCM,EACjF,CAEA,KAAAK,IAASL,GACHC,OAAKL,IACVO,QAAQE,MAAM,MAAMJ,EAAAR,KAAKC,UAAc,wCAAyCM,EACjF,CAEA,MAAAM,GAAWT,EAAAJ,KAAKG,GAAW,EAAM,CACjC,OAAAW,GAAYV,EAAAJ,KAAKG,GAAW,EAAO,EAhCnCF,EAAA,IAAAc,QACAb,EAAA,IAAAa,QACAZ,EAAA,IAAAY,QAiCW,MAACC,EAAQ,IAAIrB,EAGH,oBAAXsB,SACVA,OAAOD,MAAQA,GCvCfE,EAAA,IAAAH,QACAI,EAAA,IAAAJ,QACAK,EAAA,IAAAL,QAHMM,EAAA,IAAAC,QAyBNC,EAAM,WACL,GAA2B,IAAvBf,EAAAR,KAAKmB,GAAOK,OAAc,OAG9B,MAAMC,EAAQjB,EAAAR,KAAKmB,GAAOO,OAAO,EAAGlB,EAAAR,KAAKmB,GAAOK,QAC1CG,MAAWC,IAEjBH,EAAMI,QAAQC,IAGb,MAAMC,EAAa,GAAGD,EAAKE,KAAKnC,QAAQoC,KAAKC,UAAUJ,EAAKvB,QAEvDoB,EAAKQ,IAAIJ,KAEbD,EAAKE,QAAQF,EAAKvB,MAClBoB,EAAKS,IAAIL,MAIX3B,EAAAJ,KAAKkB,EAAS,KACf,kBA7CM,MAKN,WAAAtB,CAAYyC,EAAQ,IALdtC,EAAAC,KAAAqB,GACNtB,EAAAC,KAAAkB,EAAS,MACTnB,EAAAC,KAAAmB,EAAS,IACTpB,EAAAC,KAAAoB,GAGChB,EAAAJ,KAAKoB,EAASiB,EACf,CAMA,IAAAC,CAAKN,KAASzB,GAEbC,EAAAR,KAAKmB,GAAOoB,KAAK,CAAEP,OAAMzB,SAGrBC,EAAAR,KAAKkB,IAAQsB,aAAahC,EAAAR,KAAKkB,IAEnCd,EAAAJ,KAAKkB,EAASuB,WAAW,kBACxBzC,OAAKqB,IAAAE,oCAALmB,KAAA1C,OACEQ,OAAKY,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 = \"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"}

package/package.json

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