@operato/utils 2.0.0-alpha.0 → 2.0.0-alpha.110

package/dist/src/mixins/infinite-scrollable.d.ts

@@ -1,13 +1,37 @@
 type Constructor = new (...args: any[]) => {};
+/**
+ * A higher-order function that enhances a base class with infinite scrolling functionality.
+ *
+ * @template TBase - The base class constructor type.
+ * @param {TBase} Base - The base class to enhance with infinite scrolling.
+ * @returns {TBase & InfiniteScrollable} - The extended class with infinite scrolling capabilities.
+ */
 export default function InfiniteScrollable<TBase extends Constructor>(Base: TBase): {
     new (...args: any[]): {
+        /**
+         * Default options for infinite scrolling.
+         *
+         * @type {object}
+         * @property {number} threshold - The threshold value to trigger loading more items.
+         * @property {number} limit - The limit of items to load per page.
+         * @property {string} totalProp - The property name for the total number of items.
+         * @property {string} pageProp - The property name for the current page number.
+         */
         _infiniteScrollOptions: {
             threshold: number;
             limit: number;
             totalProp: string;
             pageProp: string;
         };
+        /**
+         * Event handler for the scroll event with debouncing.
+         *
+         * @param {Event} e - The scroll event object.
+         */
         onScroll: import("lodash").DebouncedFunc<(e: any) => void>;
+        /**
+         * An async function to handle scroll action when the threshold is reached.
+         */
         scrollAction(): Promise<void>;
     };
 } & TBase;

package/dist/src/mixins/infinite-scrollable.js

@@ -1,14 +1,35 @@
 import debounce from 'lodash-es/debounce';
+/**
+ * A higher-order function that enhances a base class with infinite scrolling functionality.
+ *
+ * @template TBase - The base class constructor type.
+ * @param {TBase} Base - The base class to enhance with infinite scrolling.
+ * @returns {TBase & InfiniteScrollable} - The extended class with infinite scrolling capabilities.
+ */
 export default function InfiniteScrollable(Base) {
     return class Scrolling extends Base {
         constructor() {
             super(...arguments);
+            /**
+             * Default options for infinite scrolling.
+             *
+             * @type {object}
+             * @property {number} threshold - The threshold value to trigger loading more items.
+             * @property {number} limit - The limit of items to load per page.
+             * @property {string} totalProp - The property name for the total number of items.
+             * @property {string} pageProp - The property name for the current page number.
+             */
             this._infiniteScrollOptions = {
                 threshold: 20,
                 limit: 30,
                 totalProp: '_total',
                 pageProp: '_page'
             };
+            /**
+             * Event handler for the scroll event with debouncing.
+             *
+             * @param {Event} e - The scroll event object.
+             */
             this.onScroll = debounce(e => {
                 //@ts-ignore inheritted class should have scrollTargetEl property
                 var el = this.scrollTargetEl;
@@ -28,6 +49,9 @@ export default function InfiniteScrollable(Base) {
         //   console.warn('scroll target element is not defined.')
         //   return null
         // }
+        /**
+         * An async function to handle scroll action when the threshold is reached.
+         */
         async scrollAction() {
             console.warn('scroll action not implemented.');
         }

package/dist/src/mixins/infinite-scrollable.js.map

@@ -1 +1 @@
-{"version":3,"file":"infinite-scrollable.js","sourceRoot":"","sources":["../../../src/mixins/infinite-scrollable.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,oBAAoB,CAAA;AAIzC,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAA4B,IAAW;IAC/E,OAAO,MAAM,SAAU,SAAQ,IAAI;QAA5B;;YACL,2BAAsB,GAAG;gBACvB,SAAS,EAAE,EAAE;gBACb,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,QAAQ;gBACnB,QAAQ,EAAE,OAAO;aAClB,CAAA;YAED,aAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE;gBACtB,iEAAiE;gBACjE,IAAI,EAAE,GAAG,IAAI,CAAC,cAAc,CAAA;gBAC5B,IAAI,CAAC,EAAE,EAAE,CAAC;oBACR,OAAO,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAA;oBACrD,OAAM;gBACR,CAAC;gBAED,IAAI,EAAE,SAAS,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,sBAAsB,CAAA;gBAE/E,IACG,IAAY,CAAC,QAAQ,CAAC,GAAI,IAAY,CAAC,SAAS,CAAC,GAAG,KAAK;oBAC1D,EAAE,CAAC,YAAY,GAAG,EAAE,CAAC,YAAY,IAAI,EAAE,CAAC,SAAS,GAAG,SAAS,EAC7D,CAAC;oBACD,IAAI,CAAC,YAAY,EAAE,CAAA;gBACrB,CAAC;YACH,CAAC,EAAE,GAAG,CAAC,CAAA;QAYT,CAAC;QAVC,gCAAgC;QAChC,6CAA6C;QAC7C,0DAA0D;QAE1D,gBAAgB;QAChB,IAAI;QAEJ,KAAK,CAAC,YAAY;YAChB,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;QAChD,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["import debounce from 'lodash-es/debounce'\n\ntype Constructor = new (...args: any[]) => {}\n\nexport default function InfiniteScrollable<TBase extends Constructor>(Base: TBase) {\n  return class Scrolling extends Base {\n    _infiniteScrollOptions = {\n      threshold: 20,\n      limit: 30,\n      totalProp: '_total',\n      pageProp: '_page'\n    }\n\n    onScroll = debounce(e => {\n      //@ts-ignore inheritted class should have scrollTargetEl property\n      var el = this.scrollTargetEl\n      if (!el) {\n        console.warn('scroll target element is not defined.')\n        return\n      }\n\n      var { threshold = 0, limit, totalProp, pageProp } = this._infiniteScrollOptions\n\n      if (\n        (this as any)[pageProp] < (this as any)[totalProp] / limit &&\n        el.scrollHeight - el.clientHeight <= el.scrollTop + threshold\n      ) {\n        this.scrollAction()\n      }\n    }, 300)\n\n    // commented due to TS2611 error\n    // get scrollTargetEl(): HTMLElement | null {\n    //   console.warn('scroll target element is not defined.')\n\n    //   return null\n    // }\n\n    async scrollAction() {\n      console.warn('scroll action not implemented.')\n    }\n  }\n}\n"]}
+{"version":3,"file":"infinite-scrollable.js","sourceRoot":"","sources":["../../../src/mixins/infinite-scrollable.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,oBAAoB,CAAA;AAIzC;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,kBAAkB,CAA4B,IAAW;IAC/E,OAAO,MAAM,SAAU,SAAQ,IAAI;QAA5B;;YACL;;;;;;;;eAQG;YACH,2BAAsB,GAAG;gBACvB,SAAS,EAAE,EAAE;gBACb,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,QAAQ;gBACnB,QAAQ,EAAE,OAAO;aAClB,CAAA;YAED;;;;eAIG;YACH,aAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE;gBACtB,iEAAiE;gBACjE,IAAI,EAAE,GAAG,IAAI,CAAC,cAAc,CAAA;gBAC5B,IAAI,CAAC,EAAE,EAAE,CAAC;oBACR,OAAO,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAA;oBACrD,OAAM;gBACR,CAAC;gBAED,IAAI,EAAE,SAAS,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,sBAAsB,CAAA;gBAE/E,IACG,IAAY,CAAC,QAAQ,CAAC,GAAI,IAAY,CAAC,SAAS,CAAC,GAAG,KAAK;oBAC1D,EAAE,CAAC,YAAY,GAAG,EAAE,CAAC,YAAY,IAAI,EAAE,CAAC,SAAS,GAAG,SAAS,EAC7D,CAAC;oBACD,IAAI,CAAC,YAAY,EAAE,CAAA;gBACrB,CAAC;YACH,CAAC,EAAE,GAAG,CAAC,CAAA;QAeT,CAAC;QAbC,gCAAgC;QAChC,6CAA6C;QAC7C,0DAA0D;QAE1D,gBAAgB;QAChB,IAAI;QAEJ;;WAEG;QACH,KAAK,CAAC,YAAY;YAChB,OAAO,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;QAChD,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["import debounce from 'lodash-es/debounce'\n\ntype Constructor = new (...args: any[]) => {}\n\n/**\n * A higher-order function that enhances a base class with infinite scrolling functionality.\n *\n * @template TBase - The base class constructor type.\n * @param {TBase} Base - The base class to enhance with infinite scrolling.\n * @returns {TBase & InfiniteScrollable} - The extended class with infinite scrolling capabilities.\n */\nexport default function InfiniteScrollable<TBase extends Constructor>(Base: TBase) {\n  return class Scrolling extends Base {\n    /**\n     * Default options for infinite scrolling.\n     *\n     * @type {object}\n     * @property {number} threshold - The threshold value to trigger loading more items.\n     * @property {number} limit - The limit of items to load per page.\n     * @property {string} totalProp - The property name for the total number of items.\n     * @property {string} pageProp - The property name for the current page number.\n     */\n    _infiniteScrollOptions = {\n      threshold: 20,\n      limit: 30,\n      totalProp: '_total',\n      pageProp: '_page'\n    }\n\n    /**\n     * Event handler for the scroll event with debouncing.\n     *\n     * @param {Event} e - The scroll event object.\n     */\n    onScroll = debounce(e => {\n      //@ts-ignore inheritted class should have scrollTargetEl property\n      var el = this.scrollTargetEl\n      if (!el) {\n        console.warn('scroll target element is not defined.')\n        return\n      }\n\n      var { threshold = 0, limit, totalProp, pageProp } = this._infiniteScrollOptions\n\n      if (\n        (this as any)[pageProp] < (this as any)[totalProp] / limit &&\n        el.scrollHeight - el.clientHeight <= el.scrollTop + threshold\n      ) {\n        this.scrollAction()\n      }\n    }, 300)\n\n    // commented due to TS2611 error\n    // get scrollTargetEl(): HTMLElement | null {\n    //   console.warn('scroll target element is not defined.')\n\n    //   return null\n    // }\n\n    /**\n     * An async function to handle scroll action when the threshold is reached.\n     */\n    async scrollAction() {\n      console.warn('scroll action not implemented.')\n    }\n  }\n}\n"]}

package/dist/src/{checker.js → number-parser.js}

@@ -20,4 +20,4 @@ export function parseToNumberOrNull(value) {
     }
     return result;
 }
-//# sourceMappingURL=checker.js.map
+//# sourceMappingURL=number-parser.js.map

package/dist/src/number-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-parser.js","sourceRoot":"","sources":["../../src/number-parser.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,mBAAmB;AACnB,mBAAmB;AACnB,mBAAmB;AACnB,mBAAmB;AACnB,mBAAmB;AACnB,mBAAmB;AACnB,oBAAoB;AACpB,oBAAoB;AACpB,oBAAoB;AACpB,oBAAoB;AACpB,oBAAoB;AACpB,oBAAoB;AACpB,oBAAoB;AACpB,MAAM,UAAU,mBAAmB,CAAC,KAAU;IAC5C,IAAI,MAAM,GAAkB,IAAI,CAAA;IAEhC,6BAA6B;IAC7B,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,IAAI,KAAK,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAe,CAAC,EAAE,CAAC;QACxG,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["// 숫자라면 숫자값을, 아니면 null을 반환\n// 0         = true\n// '0'       = true\n// 123       = true\n// \"123\"     = true\n// -123      = true\n// \"-123\"    = true\n// true      = false\n// false     = false\n// \"\"        = false\n// null      = false\n// undefined = false\n// {}        = false\n// []        = false\nexport function parseToNumberOrNull(value: any): number | null {\n  let result: number | null = null\n\n  // 숫자나 스트링이면서 NaN이 아니면 숫자로 변환\n  if ((typeof value === 'string' || typeof value === 'number') && value !== '' && !isNaN(value as number)) {\n    result = Number(value)\n  }\n\n  return result\n}\n"]}

package/dist/src/os.d.ts

@@ -23,4 +23,8 @@ export declare function isIOS(): boolean;
  * @returns {boolean}
  */
 export declare function isMacOS(): boolean;
+/**
+ * method to tell if platform of running browser is Safari
+ * @returns {boolean}
+ */
 export declare function isSafari(): false | RegExpMatchArray | null;

package/dist/src/os.js

@@ -34,6 +34,10 @@ export function isIOS() {
 export function isMacOS() {
     return navigator.userAgent.indexOf('Mac') !== -1;
 }
+/**
+ * method to tell if platform of running browser is Safari
+ * @returns {boolean}
+ */
 export function isSafari() {
     return !navigator.userAgent.match(/chrome|chromium|crios/i) && navigator.userAgent.match(/safari/i);
 }

package/dist/src/os.js.map

@@ -1 +1 @@
-{"version":3,"file":"os.js","sourceRoot":"","sources":["../../src/os.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAAA;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAA;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAA;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK;IACnB,YAAY;IACZ,OAAO,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAA;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,QAAQ;IACtB,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,wBAAwB,CAAC,IAAI,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;AACrG,CAAC","sourcesContent":["/**\n * method to tell if platform of running browser is kind of touch device\n * @returns {boolean}\n */\nexport function isTouchDevice() {\n  return window.matchMedia('(pointer:none), (pointer:coarse)').matches\n}\n\n/**\n * method to tell if platform of running browser is kind of mobile device\n * @returns {boolean}\n */\nexport function isHandheldDevice() {\n  return window.matchMedia('(max-width: 460px)').matches\n}\n\n/**\n * method to tell if platform of running browser is kind of mobile device\n * @returns {boolean}\n */\nexport function isMobileDevice() {\n  return window.matchMedia('(max-width: 767px)').matches\n}\n\n/**\n * method to tell if operating system of running browser is iOS\n * @returns {boolean}\n */\nexport function isIOS() {\n  //@ts-ignore\n  return /iPad|iPhone|iPod/.test(navigator.userAgent) && !window.MSStream\n}\n\n/**\n * method to tell if operating system of running browser is MacOS\n * @returns {boolean}\n */\nexport function isMacOS() {\n  return navigator.userAgent.indexOf('Mac') !== -1\n}\n\nexport function isSafari() {\n  return !navigator.userAgent.match(/chrome|chromium|crios/i) && navigator.userAgent.match(/safari/i)\n}\n"]}
+{"version":3,"file":"os.js","sourceRoot":"","sources":["../../src/os.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,MAAM,CAAC,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CAAA;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAA;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAA;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK;IACnB,YAAY;IACZ,OAAO,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAA;AACzE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO;IACrB,OAAO,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,wBAAwB,CAAC,IAAI,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;AACrG,CAAC","sourcesContent":["/**\n * method to tell if platform of running browser is kind of touch device\n * @returns {boolean}\n */\nexport function isTouchDevice() {\n  return window.matchMedia('(pointer:none), (pointer:coarse)').matches\n}\n\n/**\n * method to tell if platform of running browser is kind of mobile device\n * @returns {boolean}\n */\nexport function isHandheldDevice() {\n  return window.matchMedia('(max-width: 460px)').matches\n}\n\n/**\n * method to tell if platform of running browser is kind of mobile device\n * @returns {boolean}\n */\nexport function isMobileDevice() {\n  return window.matchMedia('(max-width: 767px)').matches\n}\n\n/**\n * method to tell if operating system of running browser is iOS\n * @returns {boolean}\n */\nexport function isIOS() {\n  //@ts-ignore\n  return /iPad|iPhone|iPod/.test(navigator.userAgent) && !window.MSStream\n}\n\n/**\n * method to tell if operating system of running browser is MacOS\n * @returns {boolean}\n */\nexport function isMacOS() {\n  return navigator.userAgent.indexOf('Mac') !== -1\n}\n\n/**\n * method to tell if platform of running browser is Safari\n * @returns {boolean}\n */\nexport function isSafari() {\n  return !navigator.userAgent.match(/chrome|chromium|crios/i) && navigator.userAgent.match(/safari/i)\n}\n"]}

package/dist/src/password-pattern.d.ts

@@ -1,3 +1,18 @@
+/**
+ * Generates a regular expression pattern for validating passwords based on specified criteria.
+ *
+ * @param {object} options - An object containing options for generating the pattern.
+ * @param {boolean} options.lowerCase - Indicates whether the password should contain at least one lowercase character.
+ * @param {boolean} options.upperCase - Indicates whether the password should contain at least one uppercase character.
+ * @param {boolean} options.digit - Indicates whether the password should contain at least one digit.
+ * @param {boolean} options.specialCharacter - Indicates whether the password should contain at least one special character.
+ * @param {boolean} options.allowRepeat - Indicates whether repeated characters are allowed in the password.
+ * @param {boolean} options.useTightPattern - Indicates whether to use a tight pattern for password length.
+ * @param {boolean} options.useLoosePattern - Indicates whether to use a loose pattern for password length.
+ * @param {number} options.tightCharacterLength - The minimum length of the password for the tight pattern.
+ * @param {number} options.looseCharacterLength - The minimum length of the password for the loose pattern.
+ * @returns {RegExp} - A regular expression pattern for validating passwords based on the specified criteria.
+ */
 export declare function generatePasswordPatternRegExp({ lowerCase, upperCase, digit, specialCharacter, allowRepeat, useTightPattern, useLoosePattern, tightCharacterLength, looseCharacterLength }?: {
     lowerCase?: boolean;
     upperCase?: boolean;

package/dist/src/password-pattern.js

@@ -1,3 +1,18 @@
+/**
+ * Generates a regular expression pattern for validating passwords based on specified criteria.
+ *
+ * @param {object} options - An object containing options for generating the pattern.
+ * @param {boolean} options.lowerCase - Indicates whether the password should contain at least one lowercase character.
+ * @param {boolean} options.upperCase - Indicates whether the password should contain at least one uppercase character.
+ * @param {boolean} options.digit - Indicates whether the password should contain at least one digit.
+ * @param {boolean} options.specialCharacter - Indicates whether the password should contain at least one special character.
+ * @param {boolean} options.allowRepeat - Indicates whether repeated characters are allowed in the password.
+ * @param {boolean} options.useTightPattern - Indicates whether to use a tight pattern for password length.
+ * @param {boolean} options.useLoosePattern - Indicates whether to use a loose pattern for password length.
+ * @param {number} options.tightCharacterLength - The minimum length of the password for the tight pattern.
+ * @param {number} options.looseCharacterLength - The minimum length of the password for the loose pattern.
+ * @returns {RegExp} - A regular expression pattern for validating passwords based on the specified criteria.
+ */
 export function generatePasswordPatternRegExp({ lowerCase = true, upperCase = true, digit = true, specialCharacter = true, allowRepeat = false, useTightPattern = true, useLoosePattern = false, tightCharacterLength = 8, looseCharacterLength = 15 } = {}) {
     var tightChecklist = useTightPattern
         ? [

package/dist/src/password-pattern.js.map

@@ -1 +1 @@
-{"version":3,"file":"password-pattern.js","sourceRoot":"","sources":["../../src/password-pattern.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,6BAA6B,CAAC,EAC5C,SAAS,GAAG,IAAI,EAChB,SAAS,GAAG,IAAI,EAChB,KAAK,GAAG,IAAI,EACZ,gBAAgB,GAAG,IAAI,EACvB,WAAW,GAAG,KAAK,EACnB,eAAe,GAAG,IAAI,EACtB,eAAe,GAAG,KAAK,EACvB,oBAAoB,GAAG,CAAC,EACxB,oBAAoB,GAAG,EAAE,KAWvB,EAAE;IACJ,IAAI,cAAc,GAAG,eAAe;QAClC,CAAC,CAAC;YACE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,wCAAwC;YACxE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,wCAAwC;YACxE,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,yBAAyB;YACnD,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,EAAE,qCAAqC;YACnF,CAAC,WAAW,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,EAAE,gDAAgD;YAC/F,KAAK,oBAAoB,IAAI,CAAC,6BAA6B;SAC5D;QACH,CAAC,CAAC,EAAE,CAAA;IAEN,IAAI,cAAc,GAAG,eAAe;QAClC,CAAC,CAAC;YACE,KAAK,oBAAoB,IAAI,CAAC,8BAA8B;SAC7D;QACH,CAAC,CAAC,EAAE,CAAA;IAEN,IAAI,SAAS,GAAG;QACd,GAAG,EAAE,aAAa;QAClB,GAAG,cAAc;QACjB,cAAc,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACzD,GAAG,cAAc;QACjB,GAAG,CAAC,aAAa;KAClB,CAAA;IAED,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;AACvC,CAAC","sourcesContent":["export function generatePasswordPatternRegExp({\n  lowerCase = true,\n  upperCase = true,\n  digit = true,\n  specialCharacter = true,\n  allowRepeat = false,\n  useTightPattern = true,\n  useLoosePattern = false,\n  tightCharacterLength = 8,\n  looseCharacterLength = 15\n}: {\n  lowerCase?: boolean\n  upperCase?: boolean\n  digit?: boolean\n  specialCharacter?: boolean\n  allowRepeat?: boolean\n  useTightPattern?: boolean\n  useLoosePattern?: boolean\n  tightCharacterLength?: Number\n  looseCharacterLength?: Number\n} = {}) {\n  var tightChecklist = useTightPattern\n    ? [\n        lowerCase ? '(?=.*[a-z])' : '', // has at least one lower case character\n        upperCase ? '(?=.*[A-Z])' : '', // has at least one upper case character\n        digit ? '(?=.*\\\\d)' : '', // has at least one digit\n        specialCharacter ? '(?=.*[!@#$%^&*()])' : '', // has at least one special character\n        !allowRepeat ? '(?!.*(.)\\\\1(?=\\\\1{1,}))' : '', // has not an repeated character more than twice\n        `.{${tightCharacterLength},}` // has a length of 8 and more\n      ]\n    : []\n\n  var looseChecklist = useLoosePattern\n    ? [\n        `.{${looseCharacterLength},}` // has a length of 15 and more\n      ]\n    : []\n\n  var checkList = [\n    '^', // from start\n    ...tightChecklist,\n    tightChecklist.length && looseChecklist.length ? '|' : '',\n    ...looseChecklist,\n    '$' //to the end\"\n  ]\n\n  return new RegExp(checkList.join(''))\n}\n"]}
+{"version":3,"file":"password-pattern.js","sourceRoot":"","sources":["../../src/password-pattern.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,6BAA6B,CAAC,EAC5C,SAAS,GAAG,IAAI,EAChB,SAAS,GAAG,IAAI,EAChB,KAAK,GAAG,IAAI,EACZ,gBAAgB,GAAG,IAAI,EACvB,WAAW,GAAG,KAAK,EACnB,eAAe,GAAG,IAAI,EACtB,eAAe,GAAG,KAAK,EACvB,oBAAoB,GAAG,CAAC,EACxB,oBAAoB,GAAG,EAAE,KAWvB,EAAE;IACJ,IAAI,cAAc,GAAG,eAAe;QAClC,CAAC,CAAC;YACE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,wCAAwC;YACxE,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,wCAAwC;YACxE,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,yBAAyB;YACnD,gBAAgB,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,EAAE,EAAE,qCAAqC;YACnF,CAAC,WAAW,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,EAAE,gDAAgD;YAC/F,KAAK,oBAAoB,IAAI,CAAC,6BAA6B;SAC5D;QACH,CAAC,CAAC,EAAE,CAAA;IAEN,IAAI,cAAc,GAAG,eAAe;QAClC,CAAC,CAAC;YACE,KAAK,oBAAoB,IAAI,CAAC,8BAA8B;SAC7D;QACH,CAAC,CAAC,EAAE,CAAA;IAEN,IAAI,SAAS,GAAG;QACd,GAAG,EAAE,aAAa;QAClB,GAAG,cAAc;QACjB,cAAc,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;QACzD,GAAG,cAAc;QACjB,GAAG,CAAC,aAAa;KAClB,CAAA;IAED,OAAO,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;AACvC,CAAC","sourcesContent":["/**\n * Generates a regular expression pattern for validating passwords based on specified criteria.\n *\n * @param {object} options - An object containing options for generating the pattern.\n * @param {boolean} options.lowerCase - Indicates whether the password should contain at least one lowercase character.\n * @param {boolean} options.upperCase - Indicates whether the password should contain at least one uppercase character.\n * @param {boolean} options.digit - Indicates whether the password should contain at least one digit.\n * @param {boolean} options.specialCharacter - Indicates whether the password should contain at least one special character.\n * @param {boolean} options.allowRepeat - Indicates whether repeated characters are allowed in the password.\n * @param {boolean} options.useTightPattern - Indicates whether to use a tight pattern for password length.\n * @param {boolean} options.useLoosePattern - Indicates whether to use a loose pattern for password length.\n * @param {number} options.tightCharacterLength - The minimum length of the password for the tight pattern.\n * @param {number} options.looseCharacterLength - The minimum length of the password for the loose pattern.\n * @returns {RegExp} - A regular expression pattern for validating passwords based on the specified criteria.\n */\nexport function generatePasswordPatternRegExp({\n  lowerCase = true,\n  upperCase = true,\n  digit = true,\n  specialCharacter = true,\n  allowRepeat = false,\n  useTightPattern = true,\n  useLoosePattern = false,\n  tightCharacterLength = 8,\n  looseCharacterLength = 15\n}: {\n  lowerCase?: boolean\n  upperCase?: boolean\n  digit?: boolean\n  specialCharacter?: boolean\n  allowRepeat?: boolean\n  useTightPattern?: boolean\n  useLoosePattern?: boolean\n  tightCharacterLength?: Number\n  looseCharacterLength?: Number\n} = {}) {\n  var tightChecklist = useTightPattern\n    ? [\n        lowerCase ? '(?=.*[a-z])' : '', // has at least one lower case character\n        upperCase ? '(?=.*[A-Z])' : '', // has at least one upper case character\n        digit ? '(?=.*\\\\d)' : '', // has at least one digit\n        specialCharacter ? '(?=.*[!@#$%^&*()])' : '', // has at least one special character\n        !allowRepeat ? '(?!.*(.)\\\\1(?=\\\\1{1,}))' : '', // has not an repeated character more than twice\n        `.{${tightCharacterLength},}` // has a length of 8 and more\n      ]\n    : []\n\n  var looseChecklist = useLoosePattern\n    ? [\n        `.{${looseCharacterLength},}` // has a length of 15 and more\n      ]\n    : []\n\n  var checkList = [\n    '^', // from start\n    ...tightChecklist,\n    tightChecklist.length && looseChecklist.length ? '|' : '',\n    ...looseChecklist,\n    '$' //to the end\"\n  ]\n\n  return new RegExp(checkList.join(''))\n}\n"]}

package/dist/src/stringify-bignum.d.ts

@@ -1 +1,12 @@
+/**
+ * Converts a large number into a human-readable string representation with SI unit prefixes (K, M, B, T, P, E).
+ *
+ * This function takes a large number as input and converts it into a human-readable string representation using SI unit prefixes
+ * (K for thousand, M for million, B for billion, T for trillion, P for quadrillion, E for quintillion, etc.).
+ * It checks the magnitude of the input number and selects the appropriate SI unit,
+ * then formats the number with two decimal places and appends the corresponding SI unit symbol to create the readable string.
+ *
+ * @param {number} n - The number to be converted.
+ * @returns {string} - A human-readable string representation of the number with SI unit prefixes.
+ */
 export declare function stringifyBigNumber(n: number): string | number;

package/dist/src/stringify-bignum.js

@@ -1,3 +1,14 @@
+/**
+ * Converts a large number into a human-readable string representation with SI unit prefixes (K, M, B, T, P, E).
+ *
+ * This function takes a large number as input and converts it into a human-readable string representation using SI unit prefixes
+ * (K for thousand, M for million, B for billion, T for trillion, P for quadrillion, E for quintillion, etc.).
+ * It checks the magnitude of the input number and selects the appropriate SI unit,
+ * then formats the number with two decimal places and appends the corresponding SI unit symbol to create the readable string.
+ *
+ * @param {number} n - The number to be converted.
+ * @returns {string} - A human-readable string representation of the number with SI unit prefixes.
+ */
 export function stringifyBigNumber(n) {
     if (n < 1000) {
         return n;

package/dist/src/stringify-bignum.js.map

@@ -1 +1 @@
-{"version":3,"file":"stringify-bignum.js","sourceRoot":"","sources":["../../src/stringify-bignum.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAAC,CAAS;IAC1C,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;QACb,OAAO,CAAC,CAAA;IACV,CAAC;IAED,IAAI,EAAE,GAAG;QACP,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;QAClB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;QAClB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;QAClB,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE;QACnB,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE;QACnB,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE;KACpB,CAAA;IAED,IAAI,KAAK,CAAA;IACT,KAAK,KAAK,GAAG,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,MAAK;QACP,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,0BAA0B,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAC7F,CAAC","sourcesContent":["export function stringifyBigNumber(n: number) {\n  if (n < 1000) {\n    return n\n  }\n\n  var si = [\n    { v: 1e3, s: 'K' },\n    { v: 1e6, s: 'M' },\n    { v: 1e9, s: 'B' },\n    { v: 1e12, s: 'T' },\n    { v: 1e15, s: 'P' },\n    { v: 1e18, s: 'E' }\n  ]\n\n  var index\n  for (index = si.length - 1; index > 0; index--) {\n    if (n >= si[index].v) {\n      break\n    }\n  }\n\n  return (n / si[index].v).toFixed(2).replace(/\\.0+$|(\\.[0-9]*[1-9])0+$/, '$1') + si[index].s\n}\n"]}
+{"version":3,"file":"stringify-bignum.js","sourceRoot":"","sources":["../../src/stringify-bignum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,UAAU,kBAAkB,CAAC,CAAS;IAC1C,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;QACb,OAAO,CAAC,CAAA;IACV,CAAC;IAED,IAAI,EAAE,GAAG;QACP,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;QAClB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;QAClB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE;QAClB,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE;QACnB,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE;QACnB,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE;KACpB,CAAA;IAED,IAAI,KAAK,CAAA;IACT,KAAK,KAAK,GAAG,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;QAC/C,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACrB,MAAK;QACP,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,0BAA0B,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAC7F,CAAC","sourcesContent":["/**\n * Converts a large number into a human-readable string representation with SI unit prefixes (K, M, B, T, P, E).\n *\n * This function takes a large number as input and converts it into a human-readable string representation using SI unit prefixes\n * (K for thousand, M for million, B for billion, T for trillion, P for quadrillion, E for quintillion, etc.).\n * It checks the magnitude of the input number and selects the appropriate SI unit,\n * then formats the number with two decimal places and appends the corresponding SI unit symbol to create the readable string.\n *\n * @param {number} n - The number to be converted.\n * @returns {string} - A human-readable string representation of the number with SI unit prefixes.\n */\n\nexport function stringifyBigNumber(n: number) {\n  if (n < 1000) {\n    return n\n  }\n\n  var si = [\n    { v: 1e3, s: 'K' },\n    { v: 1e6, s: 'M' },\n    { v: 1e9, s: 'B' },\n    { v: 1e12, s: 'T' },\n    { v: 1e15, s: 'P' },\n    { v: 1e18, s: 'E' }\n  ]\n\n  var index\n  for (index = si.length - 1; index > 0; index--) {\n    if (n >= si[index].v) {\n      break\n    }\n  }\n\n  return (n / si[index].v).toFixed(2).replace(/\\.0+$|(\\.[0-9]*[1-9])0+$/, '$1') + si[index].s\n}\n"]}

package/dist/src/timecapsule/snapshot-taker.d.ts

@@ -1,16 +1,47 @@
 import { TimeCapsule } from './timecapsule';
+/**
+ * Type definition for holding state information.
+ * @typedef {Object} StateHolder
+ * @property {*} state - The state to be held.
+ */
 export type StateHolder = {
     state: any;
 };
+/**
+ * Class responsible for taking and managing snapshots of state.
+ */
 export declare class SnapshotTaker {
     private _brake;
     dirty: boolean;
     state_holder?: StateHolder;
     timecapsule?: TimeCapsule;
+    /**
+     * Creates an instance of SnapshotTaker.
+     * @param {*} state_holder - The object that holds the state to be snapshot.
+     * @param {TimeCapsule} timecapsule - The TimeCapsule instance associated with this SnapshotTaker.
+     */
     constructor(state_holder: any, timecapsule: TimeCapsule);
+    /**
+     * Disposes of the SnapshotTaker and clears associated references.
+     */
     dispose(): void;
+    /**
+     * Marks the SnapshotTaker as dirty and initiates snapshot creation.
+     */
     touch(): void;
+    /**
+     * Takes a snapshot of the current state.
+     * @param {boolean} [force=false] - If true, the snapshot is taken even if not dirty.
+     */
     take(force?: boolean): void;
+    /**
+     * Gets the brake state of the SnapshotTaker.
+     * @returns {boolean} - true if the brake is active, false otherwise.
+     */
     get brake(): boolean;
+    /**
+     * Sets the brake state of the SnapshotTaker and initiates snapshot creation.
+     * @param {boolean} brake - The new brake state.
+     */
     set brake(brake: boolean);
 }

package/dist/src/timecapsule/snapshot-taker.js

@@ -1,18 +1,33 @@
-/*
- * Copyright © HatioLab Inc. All rights reserved.
- */
 import debounce from 'lodash-es/debounce';
+/**
+ * A function that takes a SnapshotTaker as an argument and initiates snapshot creation
+ * using a debouncer to delay the process.
+ * @param {SnapshotTaker} taker - The SnapshotTaker instance to trigger snapshots for.
+ */
 var debouncer = debounce(taker => {
     if (!taker.brake) {
         taker.take();
     }
 }, 1000, { leading: true, trailing: false });
+/**
+ * Function to trigger snapshot creation for a SnapshotTaker instance.
+ * Checks if the taker is in a brake state or not dirty before triggering the snapshot.
+ * @param {SnapshotTaker} taker - The SnapshotTaker instance to create a snapshot for.
+ */
 function take_snapshot(taker) {
     if (taker.brake || !taker.dirty)
         return;
     debouncer(taker);
 }
+/**
+ * Class responsible for taking and managing snapshots of state.
+ */
 export class SnapshotTaker {
+    /**
+     * Creates an instance of SnapshotTaker.
+     * @param {*} state_holder - The object that holds the state to be snapshot.
+     * @param {TimeCapsule} timecapsule - The TimeCapsule instance associated with this SnapshotTaker.
+     */
     constructor(state_holder, timecapsule) {
         this._brake = false;
         this.dirty = false;
@@ -20,15 +35,25 @@ export class SnapshotTaker {
         this.timecapsule = timecapsule;
         this.timecapsule.snapshot_taker = this;
     }
+    /**
+     * Disposes of the SnapshotTaker and clears associated references.
+     */
     dispose() {
         delete this.state_holder;
         delete this.timecapsule;
     }
+    /**
+     * Marks the SnapshotTaker as dirty and initiates snapshot creation.
+     */
     touch() {
         this.dirty = true;
         take_snapshot(this);
     }
     /* 모든 조건에 관계없이 현재 상태를 snapshot으로 취한다. */
+    /**
+     * Takes a snapshot of the current state.
+     * @param {boolean} [force=false] - If true, the snapshot is taken even if not dirty.
+     */
     take(force = false) {
         var _a, _b;
         if (this.dirty || force) {
@@ -36,10 +61,18 @@ export class SnapshotTaker {
             this.dirty = false;
         }
     }
+    /**
+     * Gets the brake state of the SnapshotTaker.
+     * @returns {boolean} - true if the brake is active, false otherwise.
+     */
     get brake() {
         return this._brake;
     }
     /* 마우스를 드래깅하는 동안, 보통 brake 를 ON 시킨다. */
+    /**
+     * Sets the brake state of the SnapshotTaker and initiates snapshot creation.
+     * @param {boolean} brake - The new brake state.
+     */
     set brake(brake) {
         this._brake = !!brake;
         take_snapshot(this);

package/dist/src/timecapsule/snapshot-taker.js.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-taker.js","sourceRoot":"","sources":["../../../src/timecapsule/snapshot-taker.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,QAAQ,MAAM,oBAAoB,CAAA;AAEzC,IAAI,SAAS,GAAG,QAAQ,CACtB,KAAK,CAAC,EAAE;IACN,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,EAAE,CAAA;IACd,CAAC;AACH,CAAC,EACD,IAAI,EACJ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CACnC,CAAA;AAED,SAAS,aAAa,CAAC,KAAoB;IACzC,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK;QAAE,OAAM;IACvC,SAAS,CAAC,KAAK,CAAC,CAAA;AAClB,CAAC;AAMD,MAAM,OAAO,aAAa;IAQxB,YAAY,YAAiB,EAAE,WAAwB;QAP/C,WAAM,GAAY,KAAK,CAAA;QAE/B,UAAK,GAAY,KAAK,CAAA;QAMpB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,WAAW,CAAC,cAAc,GAAG,IAAI,CAAA;IACxC,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,YAAY,CAAA;QACxB,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,aAAa,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC;IAED,wCAAwC;IACxC,IAAI,CAAC,QAAiB,KAAK;;QACzB,IAAI,IAAI,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC;YACxB,MAAA,IAAI,CAAC,WAAW,0CAAE,QAAQ,CAAC,MAAA,IAAI,CAAC,YAAY,0CAAE,KAAK,CAAC,CAAA;YACpD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QACpB,CAAC;IACH,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,uCAAuC;IACvC,IAAI,KAAK,CAAC,KAAK;QACb,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAA;QACrB,aAAa,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC;CACF","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\n\nimport { TimeCapsule } from './timecapsule'\nimport debounce from 'lodash-es/debounce'\n\nvar debouncer = debounce(\n  taker => {\n    if (!taker.brake) {\n      taker.take()\n    }\n  },\n  1000,\n  { leading: true, trailing: false }\n)\n\nfunction take_snapshot(taker: SnapshotTaker) {\n  if (taker.brake || !taker.dirty) return\n  debouncer(taker)\n}\n\nexport type StateHolder = {\n  state: any\n}\n\nexport class SnapshotTaker {\n  private _brake: boolean = false\n\n  dirty: boolean = false\n\n  state_holder?: StateHolder\n  timecapsule?: TimeCapsule\n\n  constructor(state_holder: any, timecapsule: TimeCapsule) {\n    this.state_holder = state_holder\n    this.timecapsule = timecapsule\n    this.timecapsule.snapshot_taker = this\n  }\n\n  dispose() {\n    delete this.state_holder\n    delete this.timecapsule\n  }\n\n  touch() {\n    this.dirty = true\n    take_snapshot(this)\n  }\n\n  /* 모든 조건에 관계없이 현재 상태를 snapshot으로 취한다. */\n  take(force: boolean = false) {\n    if (this.dirty || force) {\n      this.timecapsule?.snapshot(this.state_holder?.state)\n      this.dirty = false\n    }\n  }\n\n  get brake() {\n    return this._brake\n  }\n\n  /* 마우스를 드래깅하는 동안, 보통 brake 를 ON 시킨다. */\n  set brake(brake) {\n    this._brake = !!brake\n    take_snapshot(this)\n  }\n}\n"]}
+{"version":3,"file":"snapshot-taker.js","sourceRoot":"","sources":["../../../src/timecapsule/snapshot-taker.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,oBAAoB,CAAA;AAEzC;;;;GAIG;AACH,IAAI,SAAS,GAAG,QAAQ,CACtB,KAAK,CAAC,EAAE;IACN,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,CAAC,IAAI,EAAE,CAAA;IACd,CAAC;AACH,CAAC,EACD,IAAI,EACJ,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CACnC,CAAA;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,KAAoB;IACzC,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,KAAK;QAAE,OAAM;IACvC,SAAS,CAAC,KAAK,CAAC,CAAA;AAClB,CAAC;AAWD;;GAEG;AACH,MAAM,OAAO,aAAa;IAQxB;;;;OAIG;IACH,YAAY,YAAiB,EAAE,WAAwB;QAZ/C,WAAM,GAAY,KAAK,CAAA;QAE/B,UAAK,GAAY,KAAK,CAAA;QAWpB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAChC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAA;QAC9B,IAAI,CAAC,WAAW,CAAC,cAAc,GAAG,IAAI,CAAA;IACxC,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,YAAY,CAAA;QACxB,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,aAAa,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC;IAED,wCAAwC;IACxC;;;OAGG;IACH,IAAI,CAAC,QAAiB,KAAK;;QACzB,IAAI,IAAI,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC;YACxB,MAAA,IAAI,CAAC,WAAW,0CAAE,QAAQ,CAAC,MAAA,IAAI,CAAC,YAAY,0CAAE,KAAK,CAAC,CAAA;YACpD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;QACpB,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,uCAAuC;IACvC;;;OAGG;IACH,IAAI,KAAK,CAAC,KAAK;QACb,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,CAAA;QACrB,aAAa,CAAC,IAAI,CAAC,CAAA;IACrB,CAAC;CACF","sourcesContent":["import { TimeCapsule } from './timecapsule'\nimport debounce from 'lodash-es/debounce'\n\n/**\n * A function that takes a SnapshotTaker as an argument and initiates snapshot creation\n * using a debouncer to delay the process.\n * @param {SnapshotTaker} taker - The SnapshotTaker instance to trigger snapshots for.\n */\nvar debouncer = debounce(\n  taker => {\n    if (!taker.brake) {\n      taker.take()\n    }\n  },\n  1000,\n  { leading: true, trailing: false }\n)\n\n/**\n * Function to trigger snapshot creation for a SnapshotTaker instance.\n * Checks if the taker is in a brake state or not dirty before triggering the snapshot.\n * @param {SnapshotTaker} taker - The SnapshotTaker instance to create a snapshot for.\n */\nfunction take_snapshot(taker: SnapshotTaker) {\n  if (taker.brake || !taker.dirty) return\n  debouncer(taker)\n}\n\n/**\n * Type definition for holding state information.\n * @typedef {Object} StateHolder\n * @property {*} state - The state to be held.\n */\nexport type StateHolder = {\n  state: any\n}\n\n/**\n * Class responsible for taking and managing snapshots of state.\n */\nexport class SnapshotTaker {\n  private _brake: boolean = false\n\n  dirty: boolean = false\n\n  state_holder?: StateHolder\n  timecapsule?: TimeCapsule\n\n  /**\n   * Creates an instance of SnapshotTaker.\n   * @param {*} state_holder - The object that holds the state to be snapshot.\n   * @param {TimeCapsule} timecapsule - The TimeCapsule instance associated with this SnapshotTaker.\n   */\n  constructor(state_holder: any, timecapsule: TimeCapsule) {\n    this.state_holder = state_holder\n    this.timecapsule = timecapsule\n    this.timecapsule.snapshot_taker = this\n  }\n\n  /**\n   * Disposes of the SnapshotTaker and clears associated references.\n   */\n  dispose() {\n    delete this.state_holder\n    delete this.timecapsule\n  }\n\n  /**\n   * Marks the SnapshotTaker as dirty and initiates snapshot creation.\n   */\n  touch() {\n    this.dirty = true\n    take_snapshot(this)\n  }\n\n  /* 모든 조건에 관계없이 현재 상태를 snapshot으로 취한다. */\n  /**\n   * Takes a snapshot of the current state.\n   * @param {boolean} [force=false] - If true, the snapshot is taken even if not dirty.\n   */\n  take(force: boolean = false) {\n    if (this.dirty || force) {\n      this.timecapsule?.snapshot(this.state_holder?.state)\n      this.dirty = false\n    }\n  }\n\n  /**\n   * Gets the brake state of the SnapshotTaker.\n   * @returns {boolean} - true if the brake is active, false otherwise.\n   */\n  get brake() {\n    return this._brake\n  }\n\n  /* 마우스를 드래깅하는 동안, 보통 brake 를 ON 시킨다. */\n  /**\n   * Sets the brake state of the SnapshotTaker and initiates snapshot creation.\n   * @param {boolean} brake - The new brake state.\n   */\n  set brake(brake) {\n    this._brake = !!brake\n    take_snapshot(this)\n  }\n}\n"]}

package/dist/src/timecapsule/timecapsule.d.ts

@@ -1,19 +1,69 @@
 import { SnapshotTaker } from './snapshot-taker';
+/**
+ * A utility class for managing and navigating through a history of snapshots.
+ */
 export declare class TimeCapsule {
     private q;
     private maxsize;
     private pos;
     private _snapshot_taker;
+    /**
+     * Creates an instance of TimeCapsule.
+     * @param {number} maxsize - The maximum number of snapshots to store.
+     * @param {any} [start_state] - The initial state to be stored as the first snapshot (optional).
+     */
     constructor(maxsize: number, start_state?: any);
+    /**
+     * Disposes of the TimeCapsule and clears all stored snapshots.
+     */
     dispose(): void;
+    /**
+     * Captures a snapshot of the current state and stores it.
+     * @param {any} state - The state to be captured as a snapshot.
+     */
     snapshot(state: any): void;
+    /**
+     * Moves forward to the next snapshot in the history.
+     * @returns {any} The next state snapshot if available, or logs a warning if not.
+     */
     forward(): any;
+    /**
+     * Moves backward to the previous snapshot in the history.
+     * @returns {any} The previous state snapshot if available, or logs a warning if not.
+     */
     backward(): any;
+    /**
+     * Gets the current state snapshot.
+     * @returns {any} The current state snapshot if available, or logs a warning if not.
+     */
     get current(): any;
+    /**
+     * Gets the number of snapshots stored in the TimeCapsule.
+     * @returns {number} The count of stored snapshots.
+     */
     get length(): number;
+    /**
+     * Checks if there is a snapshot available to move forward.
+     * @returns {boolean} True if moving forward is possible, otherwise false.
+     */
     get forwardable(): boolean;
+    /**
+     * Checks if there is a snapshot available to move backward.
+     * @returns {boolean} True if moving backward is possible, otherwise false.
+     */
     get backwardable(): boolean;
+    /**
+     * Gets the SnapshotTaker associated with this TimeCapsule.
+     * @returns {SnapshotTaker | null} The associated SnapshotTaker, or null if not set.
+     */
     get snapshot_taker(): SnapshotTaker | null;
+    /**
+     * Sets the SnapshotTaker for this TimeCapsule.
+     * @param {SnapshotTaker | null} snapshot_taker - The SnapshotTaker instance to associate with this TimeCapsule.
+     */
     set snapshot_taker(snapshot_taker: SnapshotTaker | null);
+    /**
+     * Resets the TimeCapsule, clearing all stored snapshots and resetting the position.
+     */
     reset(): void;
 }

package/dist/src/timecapsule/timecapsule.js

@@ -1,8 +1,13 @@
-/*
- * Copyright © HatioLab Inc. All rights reserved.
- */
 import { error, warn } from '../logger';
+/**
+ * A utility class for managing and navigating through a history of snapshots.
+ */
 export class TimeCapsule {
+    /**
+     * Creates an instance of TimeCapsule.
+     * @param {number} maxsize - The maximum number of snapshots to store.
+     * @param {any} [start_state] - The initial state to be stored as the first snapshot (optional).
+     */
     constructor(maxsize, start_state) {
         this.q = [];
         this.maxsize = 10;
@@ -20,9 +25,16 @@ export class TimeCapsule {
             this.snapshot(start_state);
         }
     }
+    /**
+     * Disposes of the TimeCapsule and clears all stored snapshots.
+     */
     dispose() {
         this.reset();
     }
+    /**
+     * Captures a snapshot of the current state and stores it.
+     * @param {any} state - The state to be captured as a snapshot.
+     */
     snapshot(state) {
         this.q.splice(this.pos + 1, this.q.length - (this.pos + 1), state);
         if (this.q.length > this.maxsize) {
@@ -30,6 +42,10 @@ export class TimeCapsule {
         }
         this.pos = this.q.length - 1;
     }
+    /**
+     * Moves forward to the next snapshot in the history.
+     * @returns {any} The next state snapshot if available, or logs a warning if not.
+     */
     forward() {
         if (this.snapshot_taker)
             this.snapshot_taker.take();
@@ -38,6 +54,10 @@ export class TimeCapsule {
         }
         warn('Not forwardable.');
     }
+    /**
+     * Moves backward to the previous snapshot in the history.
+     * @returns {any} The previous state snapshot if available, or logs a warning if not.
+     */
     backward() {
         if (this.snapshot_taker)
             this.snapshot_taker.take();
@@ -46,26 +66,53 @@ export class TimeCapsule {
         }
         warn('Not backwardable.');
     }
+    /**
+     * Gets the current state snapshot.
+     * @returns {any} The current state snapshot if available, or logs a warning if not.
+     */
     get current() {
         if (this.pos !== -1)
             return this.q[this.pos];
         warn('Non state has been recorded.');
     }
+    /**
+     * Gets the number of snapshots stored in the TimeCapsule.
+     * @returns {number} The count of stored snapshots.
+     */
     get length() {
         return this.q.length;
     }
+    /**
+     * Checks if there is a snapshot available to move forward.
+     * @returns {boolean} True if moving forward is possible, otherwise false.
+     */
     get forwardable() {
         return this.pos < this.q.length - 1;
     }
+    /**
+     * Checks if there is a snapshot available to move backward.
+     * @returns {boolean} True if moving backward is possible, otherwise false.
+     */
     get backwardable() {
         return this.pos > 0;
     }
+    /**
+     * Gets the SnapshotTaker associated with this TimeCapsule.
+     * @returns {SnapshotTaker | null} The associated SnapshotTaker, or null if not set.
+     */
     get snapshot_taker() {
         return this._snapshot_taker;
     }
+    /**
+     * Sets the SnapshotTaker for this TimeCapsule.
+     * @param {SnapshotTaker | null} snapshot_taker - The SnapshotTaker instance to associate with this TimeCapsule.
+     */
     set snapshot_taker(snapshot_taker) {
         this._snapshot_taker = snapshot_taker;
     }
+    /**
+     * Resets the TimeCapsule, clearing all stored snapshots and resetting the position.
+     */
     reset() {
         this.q = [];
         this.pos = -1;

package/dist/src/timecapsule/timecapsule.js.map

@@ -1 +1 @@
-{"version":3,"file":"timecapsule.js","sourceRoot":"","sources":["../../../src/timecapsule/timecapsule.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright © HatioLab Inc. All rights reserved.\n */\n\nimport { debug, error, warn } from '../logger'\n\nimport { SnapshotTaker } from './snapshot-taker'\n\nexport class TimeCapsule {\n  private q: Array<any> = []\n  private maxsize = 10\n  private pos = -1\n\n  private _snapshot_taker: SnapshotTaker | null = null\n\n  constructor(maxsize: number, start_state?: any) {\n    maxsize = Number(maxsize)\n\n    if (!maxsize || maxsize <= 0) {\n      error('TimeCapsule maxsize should be greater than 0.', maxsize)\n    } else {\n      this.maxsize = maxsize\n    }\n\n    this.reset()\n    if (start_state) {\n      this.snapshot(start_state)\n    }\n  }\n\n  dispose() {\n    this.reset()\n  }\n\n  snapshot(state: any) {\n    this.q.splice(this.pos + 1, this.q.length - (this.pos + 1), state)\n\n    if (this.q.length > this.maxsize) {\n      this.q.splice(0, this.q.length - this.maxsize)\n    }\n\n    this.pos = this.q.length - 1\n  }\n\n  forward() {\n    if (this.snapshot_taker) this.snapshot_taker.take()\n\n    if (this.forwardable) {\n      return this.q[++this.pos]\n    }\n    warn('Not forwardable.')\n  }\n\n  backward() {\n    if (this.snapshot_taker) this.snapshot_taker.take()\n\n    if (this.backwardable) {\n      return this.q[--this.pos]\n    }\n    warn('Not backwardable.')\n  }\n\n  get current() {\n    if (this.pos !== -1) return this.q[this.pos]\n\n    warn('Non state has been recorded.')\n  }\n\n  get length() {\n    return this.q.length\n  }\n\n  get forwardable() {\n    return this.pos < this.q.length - 1\n  }\n\n  get backwardable() {\n    return this.pos > 0\n  }\n\n  get snapshot_taker(): SnapshotTaker | null {\n    return this._snapshot_taker\n  }\n\n  set snapshot_taker(snapshot_taker: SnapshotTaker | null) {\n    this._snapshot_taker = snapshot_taker\n  }\n\n  reset() {\n    this.q = []\n    this.pos = -1\n  }\n}\n"]}
+{"version":3,"file":"timecapsule.js","sourceRoot":"","sources":["../../../src/timecapsule/timecapsule.ts"],"names":[],"mappings":"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","sourcesContent":["import { debug, error, warn } from '../logger'\n\nimport { SnapshotTaker } from './snapshot-taker'\n\n/**\n * A utility class for managing and navigating through a history of snapshots.\n */\nexport class TimeCapsule {\n  private q: Array<any> = []\n  private maxsize = 10\n  private pos = -1\n\n  private _snapshot_taker: SnapshotTaker | null = null\n\n  /**\n   * Creates an instance of TimeCapsule.\n   * @param {number} maxsize - The maximum number of snapshots to store.\n   * @param {any} [start_state] - The initial state to be stored as the first snapshot (optional).\n   */\n  constructor(maxsize: number, start_state?: any) {\n    maxsize = Number(maxsize)\n\n    if (!maxsize || maxsize <= 0) {\n      error('TimeCapsule maxsize should be greater than 0.', maxsize)\n    } else {\n      this.maxsize = maxsize\n    }\n\n    this.reset()\n    if (start_state) {\n      this.snapshot(start_state)\n    }\n  }\n\n  /**\n   * Disposes of the TimeCapsule and clears all stored snapshots.\n   */\n  dispose() {\n    this.reset()\n  }\n\n  /**\n   * Captures a snapshot of the current state and stores it.\n   * @param {any} state - The state to be captured as a snapshot.\n   */\n  snapshot(state: any) {\n    this.q.splice(this.pos + 1, this.q.length - (this.pos + 1), state)\n\n    if (this.q.length > this.maxsize) {\n      this.q.splice(0, this.q.length - this.maxsize)\n    }\n\n    this.pos = this.q.length - 1\n  }\n\n  /**\n   * Moves forward to the next snapshot in the history.\n   * @returns {any} The next state snapshot if available, or logs a warning if not.\n   */\n  forward() {\n    if (this.snapshot_taker) this.snapshot_taker.take()\n\n    if (this.forwardable) {\n      return this.q[++this.pos]\n    }\n    warn('Not forwardable.')\n  }\n\n  /**\n   * Moves backward to the previous snapshot in the history.\n   * @returns {any} The previous state snapshot if available, or logs a warning if not.\n   */\n  backward() {\n    if (this.snapshot_taker) this.snapshot_taker.take()\n\n    if (this.backwardable) {\n      return this.q[--this.pos]\n    }\n    warn('Not backwardable.')\n  }\n\n  /**\n   * Gets the current state snapshot.\n   * @returns {any} The current state snapshot if available, or logs a warning if not.\n   */\n  get current() {\n    if (this.pos !== -1) return this.q[this.pos]\n\n    warn('Non state has been recorded.')\n  }\n\n  /**\n   * Gets the number of snapshots stored in the TimeCapsule.\n   * @returns {number} The count of stored snapshots.\n   */\n  get length() {\n    return this.q.length\n  }\n\n  /**\n   * Checks if there is a snapshot available to move forward.\n   * @returns {boolean} True if moving forward is possible, otherwise false.\n   */\n  get forwardable() {\n    return this.pos < this.q.length - 1\n  }\n\n  /**\n   * Checks if there is a snapshot available to move backward.\n   * @returns {boolean} True if moving backward is possible, otherwise false.\n   */\n  get backwardable() {\n    return this.pos > 0\n  }\n\n  /**\n   * Gets the SnapshotTaker associated with this TimeCapsule.\n   * @returns {SnapshotTaker | null} The associated SnapshotTaker, or null if not set.\n   */\n  get snapshot_taker(): SnapshotTaker | null {\n    return this._snapshot_taker\n  }\n\n  /**\n   * Sets the SnapshotTaker for this TimeCapsule.\n   * @param {SnapshotTaker | null} snapshot_taker - The SnapshotTaker instance to associate with this TimeCapsule.\n   */\n  set snapshot_taker(snapshot_taker: SnapshotTaker | null) {\n    this._snapshot_taker = snapshot_taker\n  }\n\n  /**\n   * Resets the TimeCapsule, clearing all stored snapshots and resetting the position.\n   */\n  reset() {\n    this.q = []\n    this.pos = -1\n  }\n}\n"]}