@kikiutils/shared 10.3.0 → 10.4.0

package/dist/vue.cjs

@@ -7,9 +7,9 @@ const url = require('./url.cjs');
 /**
  * Appends the current Vue Router route's fullPath as the `redirect` query parameter to the given URL.
  *
- * @param {string} url - The base URL to modify.
+ * @param {string} url - The base URL to modify
  *
- * @returns {string} A new URL with the current route fullPath as the `redirect` parameter.
+ * @returns {string} A new URL with the current route fullPath as the `redirect` parameter
  */
 function appendRedirectParamFromCurrentRouteToUrl(url$1) {
     return url.appendRedirectParamToUrl(url$1, vueRouter.useRoute().fullPath);
@@ -17,7 +17,7 @@ function appendRedirectParamFromCurrentRouteToUrl(url$1) {
 /**
  * Clears an interval referenced by a Vue ref and sets it to null.
  *
- * @param {Ref<null | ReturnType<typeof setInterval>>} intervalRef - A Vue ref holding a NodeJS.Timeout or null.
+ * @param {Ref<null | ReturnType<typeof setInterval>>} intervalRef - A Vue ref holding a NodeJS.Timeout or null
  */
 function clearIntervalRef(intervalRef) {
     if (intervalRef.value)
@@ -27,7 +27,7 @@ function clearIntervalRef(intervalRef) {
 /**
  * Clears a timeout referenced by a Vue ref and sets it to null.
  *
- * @param {Ref<null | ReturnType<typeof setTimeout>>} timeoutRef - A Vue ref holding a NodeJS.Timeout or null.
+ * @param {Ref<null | ReturnType<typeof setTimeout>>} timeoutRef - A Vue ref holding a NodeJS.Timeout or null
  */
 function clearTimeoutRef(timeoutRef) {
     if (timeoutRef.value)
@@ -38,9 +38,9 @@ function clearTimeoutRef(timeoutRef) {
  * A Vue composition function that remembers and restores scroll position
  * of a scrollable container across route changes and keep-alive activation.
  *
- * @template T - The type of the scrollable element (defaults to HTMLElement).
+ * @template T - The type of the scrollable element (defaults to HTMLElement)
  *
- * @param {Ref<null | T>} containerRef - A ref to the scrollable HTML element.
+ * @param {Ref<null | T>} containerRef - A ref to the scrollable HTML element
  */
 function usePreserveScroll(containerRef) {
     let scrollLeft = 0;

package/dist/vue.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"vue.cjs","sources":["../src/vue.ts"],"sourcesContent":["import { onActivated } from 'vue';\nimport type { Ref } from 'vue';\nimport {\n    onBeforeRouteLeave,\n    useRoute,\n} from 'vue-router';\n\nimport { appendRedirectParamToUrl } from './url';\n\n/**\n * Appends the current Vue Router route's fullPath as the `redirect` query parameter to the given URL.\n *\n * @param {string} url - The base URL to modify.\n *\n * @returns {string} A new URL with the current route fullPath as the `redirect` parameter.\n */\nexport function appendRedirectParamFromCurrentRouteToUrl(url: string) {\n    return appendRedirectParamToUrl(url, useRoute().fullPath);\n}\n\n/**\n * Clears an interval referenced by a Vue ref and sets it to null.\n *\n * @param {Ref<null | ReturnType<typeof setInterval>>} intervalRef - A Vue ref holding a NodeJS.Timeout or null.\n */\nexport function clearIntervalRef(intervalRef: Ref<null | ReturnType<typeof setInterval>>) {\n    if (intervalRef.value) clearInterval(intervalRef.value);\n    intervalRef.value = null;\n}\n\n/**\n * Clears a timeout referenced by a Vue ref and sets it to null.\n *\n * @param {Ref<null | ReturnType<typeof setTimeout>>} timeoutRef - A Vue ref holding a NodeJS.Timeout or null.\n */\nexport function clearTimeoutRef(timeoutRef: Ref<null | ReturnType<typeof setTimeout>>) {\n    if (timeoutRef.value) clearTimeout(timeoutRef.value);\n    timeoutRef.value = null;\n}\n\n/**\n * A Vue composition function that remembers and restores scroll position\n * of a scrollable container across route changes and keep-alive activation.\n *\n * @template T - The type of the scrollable element (defaults to HTMLElement).\n *\n * @param {Ref<null | T>} containerRef - A ref to the scrollable HTML element.\n */\nexport function usePreserveScroll<T extends Element = HTMLElement>(containerRef: Ref<null | T>) {\n    let scrollLeft = 0;\n    let scrollTop = 0;\n    onActivated(() => {\n        if (!containerRef.value) return;\n        containerRef.value.scrollLeft = scrollLeft;\n        containerRef.value.scrollTop = scrollTop;\n    });\n\n    onBeforeRouteLeave(() => {\n        scrollLeft = containerRef.value?.scrollLeft || 0;\n        scrollTop = containerRef.value?.scrollTop || 0;\n    });\n}\n"],"names":["url","appendRedirectParamToUrl","useRoute","onActivated","onBeforeRouteLeave"],"mappings":";;;;;;AASA;;;;;;AAMG;AACG,SAAU,wCAAwC,CAACA,KAAW,EAAA;IAChE,OAAOC,4BAAwB,CAACD,KAAG,EAAEE,kBAAQ,EAAE,CAAC,QAAQ,CAAC;AAC7D;AAEA;;;;AAIG;AACG,SAAU,gBAAgB,CAAC,WAAuD,EAAA;IACpF,IAAI,WAAW,CAAC,KAAK;AAAE,QAAA,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC;AACvD,IAAA,WAAW,CAAC,KAAK,GAAG,IAAI;AAC5B;AAEA;;;;AAIG;AACG,SAAU,eAAe,CAAC,UAAqD,EAAA;IACjF,IAAI,UAAU,CAAC,KAAK;AAAE,QAAA,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC;AACpD,IAAA,UAAU,CAAC,KAAK,GAAG,IAAI;AAC3B;AAEA;;;;;;;AAOG;AACG,SAAU,iBAAiB,CAAkC,YAA2B,EAAA;IAC1F,IAAI,UAAU,GAAG,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC;IACjBC,eAAW,CAAC,MAAK;QACb,IAAI,CAAC,YAAY,CAAC,KAAK;YAAE;AACzB,QAAA,YAAY,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU;AAC1C,QAAA,YAAY,CAAC,KAAK,CAAC,SAAS,GAAG,SAAS;AAC5C,IAAA,CAAC,CAAC;IAEFC,4BAAkB,CAAC,MAAK;QACpB,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,UAAU,IAAI,CAAC;QAChD,SAAS,GAAG,YAAY,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC;AAClD,IAAA,CAAC,CAAC;AACN;;;;;;;"}
+{"version":3,"file":"vue.cjs","sources":["../src/vue.ts"],"sourcesContent":["import { onActivated } from 'vue';\nimport type { Ref } from 'vue';\nimport {\n    onBeforeRouteLeave,\n    useRoute,\n} from 'vue-router';\n\nimport { appendRedirectParamToUrl } from './url';\n\n/**\n * Appends the current Vue Router route's fullPath as the `redirect` query parameter to the given URL.\n *\n * @param {string} url - The base URL to modify\n *\n * @returns {string} A new URL with the current route fullPath as the `redirect` parameter\n */\nexport function appendRedirectParamFromCurrentRouteToUrl(url: string) {\n    return appendRedirectParamToUrl(url, useRoute().fullPath);\n}\n\n/**\n * Clears an interval referenced by a Vue ref and sets it to null.\n *\n * @param {Ref<null | ReturnType<typeof setInterval>>} intervalRef - A Vue ref holding a NodeJS.Timeout or null\n */\nexport function clearIntervalRef(intervalRef: Ref<null | ReturnType<typeof setInterval>>) {\n    if (intervalRef.value) clearInterval(intervalRef.value);\n    intervalRef.value = null;\n}\n\n/**\n * Clears a timeout referenced by a Vue ref and sets it to null.\n *\n * @param {Ref<null | ReturnType<typeof setTimeout>>} timeoutRef - A Vue ref holding a NodeJS.Timeout or null\n */\nexport function clearTimeoutRef(timeoutRef: Ref<null | ReturnType<typeof setTimeout>>) {\n    if (timeoutRef.value) clearTimeout(timeoutRef.value);\n    timeoutRef.value = null;\n}\n\n/**\n * A Vue composition function that remembers and restores scroll position\n * of a scrollable container across route changes and keep-alive activation.\n *\n * @template T - The type of the scrollable element (defaults to HTMLElement)\n *\n * @param {Ref<null | T>} containerRef - A ref to the scrollable HTML element\n */\nexport function usePreserveScroll<T extends Element = HTMLElement>(containerRef: Ref<null | T>) {\n    let scrollLeft = 0;\n    let scrollTop = 0;\n    onActivated(() => {\n        if (!containerRef.value) return;\n        containerRef.value.scrollLeft = scrollLeft;\n        containerRef.value.scrollTop = scrollTop;\n    });\n\n    onBeforeRouteLeave(() => {\n        scrollLeft = containerRef.value?.scrollLeft || 0;\n        scrollTop = containerRef.value?.scrollTop || 0;\n    });\n}\n"],"names":["url","appendRedirectParamToUrl","useRoute","onActivated","onBeforeRouteLeave"],"mappings":";;;;;;AASA;;;;;;AAMG;AACG,SAAU,wCAAwC,CAACA,KAAW,EAAA;IAChE,OAAOC,4BAAwB,CAACD,KAAG,EAAEE,kBAAQ,EAAE,CAAC,QAAQ,CAAC;AAC7D;AAEA;;;;AAIG;AACG,SAAU,gBAAgB,CAAC,WAAuD,EAAA;IACpF,IAAI,WAAW,CAAC,KAAK;AAAE,QAAA,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC;AACvD,IAAA,WAAW,CAAC,KAAK,GAAG,IAAI;AAC5B;AAEA;;;;AAIG;AACG,SAAU,eAAe,CAAC,UAAqD,EAAA;IACjF,IAAI,UAAU,CAAC,KAAK;AAAE,QAAA,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC;AACpD,IAAA,UAAU,CAAC,KAAK,GAAG,IAAI;AAC3B;AAEA;;;;;;;AAOG;AACG,SAAU,iBAAiB,CAAkC,YAA2B,EAAA;IAC1F,IAAI,UAAU,GAAG,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC;IACjBC,eAAW,CAAC,MAAK;QACb,IAAI,CAAC,YAAY,CAAC,KAAK;YAAE;AACzB,QAAA,YAAY,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU;AAC1C,QAAA,YAAY,CAAC,KAAK,CAAC,SAAS,GAAG,SAAS;AAC5C,IAAA,CAAC,CAAC;IAEFC,4BAAkB,CAAC,MAAK;QACpB,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,UAAU,IAAI,CAAC;QAChD,SAAS,GAAG,YAAY,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC;AAClD,IAAA,CAAC,CAAC;AACN;;;;;;;"}

package/dist/vue.d.ts

@@ -2,30 +2,30 @@ import type { Ref } from 'vue';
 /**
  * Appends the current Vue Router route's fullPath as the `redirect` query parameter to the given URL.
  *
- * @param {string} url - The base URL to modify.
+ * @param {string} url - The base URL to modify
  *
- * @returns {string} A new URL with the current route fullPath as the `redirect` parameter.
+ * @returns {string} A new URL with the current route fullPath as the `redirect` parameter
  */
 export declare function appendRedirectParamFromCurrentRouteToUrl(url: string): string;
 /**
  * Clears an interval referenced by a Vue ref and sets it to null.
  *
- * @param {Ref<null | ReturnType<typeof setInterval>>} intervalRef - A Vue ref holding a NodeJS.Timeout or null.
+ * @param {Ref<null | ReturnType<typeof setInterval>>} intervalRef - A Vue ref holding a NodeJS.Timeout or null
  */
 export declare function clearIntervalRef(intervalRef: Ref<null | ReturnType<typeof setInterval>>): void;
 /**
  * Clears a timeout referenced by a Vue ref and sets it to null.
  *
- * @param {Ref<null | ReturnType<typeof setTimeout>>} timeoutRef - A Vue ref holding a NodeJS.Timeout or null.
+ * @param {Ref<null | ReturnType<typeof setTimeout>>} timeoutRef - A Vue ref holding a NodeJS.Timeout or null
  */
 export declare function clearTimeoutRef(timeoutRef: Ref<null | ReturnType<typeof setTimeout>>): void;
 /**
  * A Vue composition function that remembers and restores scroll position
  * of a scrollable container across route changes and keep-alive activation.
  *
- * @template T - The type of the scrollable element (defaults to HTMLElement).
+ * @template T - The type of the scrollable element (defaults to HTMLElement)
  *
- * @param {Ref<null | T>} containerRef - A ref to the scrollable HTML element.
+ * @param {Ref<null | T>} containerRef - A ref to the scrollable HTML element
  */
 export declare function usePreserveScroll<T extends Element = HTMLElement>(containerRef: Ref<null | T>): void;
 //# sourceMappingURL=vue.d.ts.map

package/dist/vue.mjs

@@ -5,9 +5,9 @@ import { appendRedirectParamToUrl } from './url.mjs';
 /**
  * Appends the current Vue Router route's fullPath as the `redirect` query parameter to the given URL.
  *
- * @param {string} url - The base URL to modify.
+ * @param {string} url - The base URL to modify
  *
- * @returns {string} A new URL with the current route fullPath as the `redirect` parameter.
+ * @returns {string} A new URL with the current route fullPath as the `redirect` parameter
  */
 function appendRedirectParamFromCurrentRouteToUrl(url) {
     return appendRedirectParamToUrl(url, useRoute().fullPath);
@@ -15,7 +15,7 @@ function appendRedirectParamFromCurrentRouteToUrl(url) {
 /**
  * Clears an interval referenced by a Vue ref and sets it to null.
  *
- * @param {Ref<null | ReturnType<typeof setInterval>>} intervalRef - A Vue ref holding a NodeJS.Timeout or null.
+ * @param {Ref<null | ReturnType<typeof setInterval>>} intervalRef - A Vue ref holding a NodeJS.Timeout or null
  */
 function clearIntervalRef(intervalRef) {
     if (intervalRef.value)
@@ -25,7 +25,7 @@ function clearIntervalRef(intervalRef) {
 /**
  * Clears a timeout referenced by a Vue ref and sets it to null.
  *
- * @param {Ref<null | ReturnType<typeof setTimeout>>} timeoutRef - A Vue ref holding a NodeJS.Timeout or null.
+ * @param {Ref<null | ReturnType<typeof setTimeout>>} timeoutRef - A Vue ref holding a NodeJS.Timeout or null
  */
 function clearTimeoutRef(timeoutRef) {
     if (timeoutRef.value)
@@ -36,9 +36,9 @@ function clearTimeoutRef(timeoutRef) {
  * A Vue composition function that remembers and restores scroll position
  * of a scrollable container across route changes and keep-alive activation.
  *
- * @template T - The type of the scrollable element (defaults to HTMLElement).
+ * @template T - The type of the scrollable element (defaults to HTMLElement)
  *
- * @param {Ref<null | T>} containerRef - A ref to the scrollable HTML element.
+ * @param {Ref<null | T>} containerRef - A ref to the scrollable HTML element
  */
 function usePreserveScroll(containerRef) {
     let scrollLeft = 0;

package/dist/vue.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vue.mjs","sources":["../src/vue.ts"],"sourcesContent":["import { onActivated } from 'vue';\nimport type { Ref } from 'vue';\nimport {\n    onBeforeRouteLeave,\n    useRoute,\n} from 'vue-router';\n\nimport { appendRedirectParamToUrl } from './url';\n\n/**\n * Appends the current Vue Router route's fullPath as the `redirect` query parameter to the given URL.\n *\n * @param {string} url - The base URL to modify.\n *\n * @returns {string} A new URL with the current route fullPath as the `redirect` parameter.\n */\nexport function appendRedirectParamFromCurrentRouteToUrl(url: string) {\n    return appendRedirectParamToUrl(url, useRoute().fullPath);\n}\n\n/**\n * Clears an interval referenced by a Vue ref and sets it to null.\n *\n * @param {Ref<null | ReturnType<typeof setInterval>>} intervalRef - A Vue ref holding a NodeJS.Timeout or null.\n */\nexport function clearIntervalRef(intervalRef: Ref<null | ReturnType<typeof setInterval>>) {\n    if (intervalRef.value) clearInterval(intervalRef.value);\n    intervalRef.value = null;\n}\n\n/**\n * Clears a timeout referenced by a Vue ref and sets it to null.\n *\n * @param {Ref<null | ReturnType<typeof setTimeout>>} timeoutRef - A Vue ref holding a NodeJS.Timeout or null.\n */\nexport function clearTimeoutRef(timeoutRef: Ref<null | ReturnType<typeof setTimeout>>) {\n    if (timeoutRef.value) clearTimeout(timeoutRef.value);\n    timeoutRef.value = null;\n}\n\n/**\n * A Vue composition function that remembers and restores scroll position\n * of a scrollable container across route changes and keep-alive activation.\n *\n * @template T - The type of the scrollable element (defaults to HTMLElement).\n *\n * @param {Ref<null | T>} containerRef - A ref to the scrollable HTML element.\n */\nexport function usePreserveScroll<T extends Element = HTMLElement>(containerRef: Ref<null | T>) {\n    let scrollLeft = 0;\n    let scrollTop = 0;\n    onActivated(() => {\n        if (!containerRef.value) return;\n        containerRef.value.scrollLeft = scrollLeft;\n        containerRef.value.scrollTop = scrollTop;\n    });\n\n    onBeforeRouteLeave(() => {\n        scrollLeft = containerRef.value?.scrollLeft || 0;\n        scrollTop = containerRef.value?.scrollTop || 0;\n    });\n}\n"],"names":[],"mappings":";;;;AASA;;;;;;AAMG;AACG,SAAU,wCAAwC,CAAC,GAAW,EAAA;IAChE,OAAO,wBAAwB,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC;AAC7D;AAEA;;;;AAIG;AACG,SAAU,gBAAgB,CAAC,WAAuD,EAAA;IACpF,IAAI,WAAW,CAAC,KAAK;AAAE,QAAA,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC;AACvD,IAAA,WAAW,CAAC,KAAK,GAAG,IAAI;AAC5B;AAEA;;;;AAIG;AACG,SAAU,eAAe,CAAC,UAAqD,EAAA;IACjF,IAAI,UAAU,CAAC,KAAK;AAAE,QAAA,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC;AACpD,IAAA,UAAU,CAAC,KAAK,GAAG,IAAI;AAC3B;AAEA;;;;;;;AAOG;AACG,SAAU,iBAAiB,CAAkC,YAA2B,EAAA;IAC1F,IAAI,UAAU,GAAG,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC;IACjB,WAAW,CAAC,MAAK;QACb,IAAI,CAAC,YAAY,CAAC,KAAK;YAAE;AACzB,QAAA,YAAY,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU;AAC1C,QAAA,YAAY,CAAC,KAAK,CAAC,SAAS,GAAG,SAAS;AAC5C,IAAA,CAAC,CAAC;IAEF,kBAAkB,CAAC,MAAK;QACpB,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,UAAU,IAAI,CAAC;QAChD,SAAS,GAAG,YAAY,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC;AAClD,IAAA,CAAC,CAAC;AACN;;;;"}
+{"version":3,"file":"vue.mjs","sources":["../src/vue.ts"],"sourcesContent":["import { onActivated } from 'vue';\nimport type { Ref } from 'vue';\nimport {\n    onBeforeRouteLeave,\n    useRoute,\n} from 'vue-router';\n\nimport { appendRedirectParamToUrl } from './url';\n\n/**\n * Appends the current Vue Router route's fullPath as the `redirect` query parameter to the given URL.\n *\n * @param {string} url - The base URL to modify\n *\n * @returns {string} A new URL with the current route fullPath as the `redirect` parameter\n */\nexport function appendRedirectParamFromCurrentRouteToUrl(url: string) {\n    return appendRedirectParamToUrl(url, useRoute().fullPath);\n}\n\n/**\n * Clears an interval referenced by a Vue ref and sets it to null.\n *\n * @param {Ref<null | ReturnType<typeof setInterval>>} intervalRef - A Vue ref holding a NodeJS.Timeout or null\n */\nexport function clearIntervalRef(intervalRef: Ref<null | ReturnType<typeof setInterval>>) {\n    if (intervalRef.value) clearInterval(intervalRef.value);\n    intervalRef.value = null;\n}\n\n/**\n * Clears a timeout referenced by a Vue ref and sets it to null.\n *\n * @param {Ref<null | ReturnType<typeof setTimeout>>} timeoutRef - A Vue ref holding a NodeJS.Timeout or null\n */\nexport function clearTimeoutRef(timeoutRef: Ref<null | ReturnType<typeof setTimeout>>) {\n    if (timeoutRef.value) clearTimeout(timeoutRef.value);\n    timeoutRef.value = null;\n}\n\n/**\n * A Vue composition function that remembers and restores scroll position\n * of a scrollable container across route changes and keep-alive activation.\n *\n * @template T - The type of the scrollable element (defaults to HTMLElement)\n *\n * @param {Ref<null | T>} containerRef - A ref to the scrollable HTML element\n */\nexport function usePreserveScroll<T extends Element = HTMLElement>(containerRef: Ref<null | T>) {\n    let scrollLeft = 0;\n    let scrollTop = 0;\n    onActivated(() => {\n        if (!containerRef.value) return;\n        containerRef.value.scrollLeft = scrollLeft;\n        containerRef.value.scrollTop = scrollTop;\n    });\n\n    onBeforeRouteLeave(() => {\n        scrollLeft = containerRef.value?.scrollLeft || 0;\n        scrollTop = containerRef.value?.scrollTop || 0;\n    });\n}\n"],"names":[],"mappings":";;;;AASA;;;;;;AAMG;AACG,SAAU,wCAAwC,CAAC,GAAW,EAAA;IAChE,OAAO,wBAAwB,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,QAAQ,CAAC;AAC7D;AAEA;;;;AAIG;AACG,SAAU,gBAAgB,CAAC,WAAuD,EAAA;IACpF,IAAI,WAAW,CAAC,KAAK;AAAE,QAAA,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC;AACvD,IAAA,WAAW,CAAC,KAAK,GAAG,IAAI;AAC5B;AAEA;;;;AAIG;AACG,SAAU,eAAe,CAAC,UAAqD,EAAA;IACjF,IAAI,UAAU,CAAC,KAAK;AAAE,QAAA,YAAY,CAAC,UAAU,CAAC,KAAK,CAAC;AACpD,IAAA,UAAU,CAAC,KAAK,GAAG,IAAI;AAC3B;AAEA;;;;;;;AAOG;AACG,SAAU,iBAAiB,CAAkC,YAA2B,EAAA;IAC1F,IAAI,UAAU,GAAG,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC;IACjB,WAAW,CAAC,MAAK;QACb,IAAI,CAAC,YAAY,CAAC,KAAK;YAAE;AACzB,QAAA,YAAY,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU;AAC1C,QAAA,YAAY,CAAC,KAAK,CAAC,SAAS,GAAG,SAAS;AAC5C,IAAA,CAAC,CAAC;IAEF,kBAAkB,CAAC,MAAK;QACpB,UAAU,GAAG,YAAY,CAAC,KAAK,EAAE,UAAU,IAAI,CAAC;QAChD,SAAS,GAAG,YAAY,CAAC,KAAK,EAAE,SAAS,IAAI,CAAC;AAClD,IAAA,CAAC,CAAC;AACN;;;;"}

package/dist/web.cjs

@@ -5,9 +5,9 @@ const url = require('./url.cjs');
 /**
  * Appends the current browser URL (including path, query, and hash) as the `redirect` query parameter to the given URL.
  *
- * @param {string} url - The base URL to modify.
+ * @param {string} url - The base URL to modify
  *
- * @returns {string} A new URL with the current location as the `redirect` parameter.
+ * @returns {string} A new URL with the current location as the `redirect` parameter
  */
 function appendRedirectParamFromCurrentLocationToUrl(url$1) {
     const currentPath = `${window.location.pathname}${window.location.search}${window.location.hash}`;
@@ -20,8 +20,8 @@ function appendRedirectParamFromCurrentLocationToUrl(url$1) {
  * Useful for redirecting to login or other gateways while preserving
  * the current location for post-auth navigation.
  *
- * @param {string} url - The destination URL to navigate to.
- * @param {number} [delayMs] - Optional delay in milliseconds before navigation.
+ * @param {string} url - The destination URL to navigate to
+ * @param {number} [delayMs] - Optional delay in milliseconds before navigation
  */
 function assignUrlWithRedirectParamFromCurrentLocation(url, delayMs) {
     if (delayMs === undefined)

package/dist/web.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"web.cjs","sources":["../src/web.ts"],"sourcesContent":["import { appendRedirectParamToUrl } from './url';\n\n/**\n * Appends the current browser URL (including path, query, and hash) as the `redirect` query parameter to the given URL.\n *\n * @param {string} url - The base URL to modify.\n *\n * @returns {string} A new URL with the current location as the `redirect` parameter.\n */\nexport function appendRedirectParamFromCurrentLocationToUrl(url: string) {\n    const currentPath = `${window.location.pathname}${window.location.search}${window.location.hash}`;\n    return appendRedirectParamToUrl(url, currentPath);\n}\n\n/**\n * Navigates to the given URL, appending the current browser location\n * (path, query, and hash) as the `redirect` query parameter.\n *\n * Useful for redirecting to login or other gateways while preserving\n * the current location for post-auth navigation.\n *\n * @param {string} url - The destination URL to navigate to.\n * @param {number} [delayMs] - Optional delay in milliseconds before navigation.\n */\nexport function assignUrlWithRedirectParamFromCurrentLocation(url: string, delayMs?: number) {\n    if (delayMs === undefined) window.location.assign(appendRedirectParamFromCurrentLocationToUrl(url));\n    else return setTimeout(() => window.location.assign(appendRedirectParamFromCurrentLocationToUrl(url)), delayMs);\n}\n"],"names":["url","appendRedirectParamToUrl"],"mappings":";;;;AAEA;;;;;;AAMG;AACG,SAAU,2CAA2C,CAACA,KAAW,EAAA;IACnE,MAAM,WAAW,GAAG,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA,CAAE;AACjG,IAAA,OAAOC,4BAAwB,CAACD,KAAG,EAAE,WAAW,CAAC;AACrD;AAEA;;;;;;;;;AASG;AACG,SAAU,6CAA6C,CAAC,GAAW,EAAE,OAAgB,EAAA;IACvF,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,2CAA2C,CAAC,GAAG,CAAC,CAAC;;AAC9F,QAAA,OAAO,UAAU,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,2CAA2C,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC;AACnH;;;;;"}
+{"version":3,"file":"web.cjs","sources":["../src/web.ts"],"sourcesContent":["import { appendRedirectParamToUrl } from './url';\n\n/**\n * Appends the current browser URL (including path, query, and hash) as the `redirect` query parameter to the given URL.\n *\n * @param {string} url - The base URL to modify\n *\n * @returns {string} A new URL with the current location as the `redirect` parameter\n */\nexport function appendRedirectParamFromCurrentLocationToUrl(url: string) {\n    const currentPath = `${window.location.pathname}${window.location.search}${window.location.hash}`;\n    return appendRedirectParamToUrl(url, currentPath);\n}\n\n/**\n * Navigates to the given URL, appending the current browser location\n * (path, query, and hash) as the `redirect` query parameter.\n *\n * Useful for redirecting to login or other gateways while preserving\n * the current location for post-auth navigation.\n *\n * @param {string} url - The destination URL to navigate to\n * @param {number} [delayMs] - Optional delay in milliseconds before navigation\n */\nexport function assignUrlWithRedirectParamFromCurrentLocation(url: string, delayMs?: number) {\n    if (delayMs === undefined) window.location.assign(appendRedirectParamFromCurrentLocationToUrl(url));\n    else return setTimeout(() => window.location.assign(appendRedirectParamFromCurrentLocationToUrl(url)), delayMs);\n}\n"],"names":["url","appendRedirectParamToUrl"],"mappings":";;;;AAEA;;;;;;AAMG;AACG,SAAU,2CAA2C,CAACA,KAAW,EAAA;IACnE,MAAM,WAAW,GAAG,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA,CAAE;AACjG,IAAA,OAAOC,4BAAwB,CAACD,KAAG,EAAE,WAAW,CAAC;AACrD;AAEA;;;;;;;;;AASG;AACG,SAAU,6CAA6C,CAAC,GAAW,EAAE,OAAgB,EAAA;IACvF,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,2CAA2C,CAAC,GAAG,CAAC,CAAC;;AAC9F,QAAA,OAAO,UAAU,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,2CAA2C,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC;AACnH;;;;;"}

package/dist/web.d.ts

@@ -1,9 +1,9 @@
 /**
  * Appends the current browser URL (including path, query, and hash) as the `redirect` query parameter to the given URL.
  *
- * @param {string} url - The base URL to modify.
+ * @param {string} url - The base URL to modify
  *
- * @returns {string} A new URL with the current location as the `redirect` parameter.
+ * @returns {string} A new URL with the current location as the `redirect` parameter
  */
 export declare function appendRedirectParamFromCurrentLocationToUrl(url: string): string;
 /**
@@ -13,8 +13,8 @@ export declare function appendRedirectParamFromCurrentLocationToUrl(url: string)
  * Useful for redirecting to login or other gateways while preserving
  * the current location for post-auth navigation.
  *
- * @param {string} url - The destination URL to navigate to.
- * @param {number} [delayMs] - Optional delay in milliseconds before navigation.
+ * @param {string} url - The destination URL to navigate to
+ * @param {number} [delayMs] - Optional delay in milliseconds before navigation
  */
 export declare function assignUrlWithRedirectParamFromCurrentLocation(url: string, delayMs?: number): NodeJS.Timeout | undefined;
 //# sourceMappingURL=web.d.ts.map

package/dist/web.mjs

@@ -3,9 +3,9 @@ import { appendRedirectParamToUrl } from './url.mjs';
 /**
  * Appends the current browser URL (including path, query, and hash) as the `redirect` query parameter to the given URL.
  *
- * @param {string} url - The base URL to modify.
+ * @param {string} url - The base URL to modify
  *
- * @returns {string} A new URL with the current location as the `redirect` parameter.
+ * @returns {string} A new URL with the current location as the `redirect` parameter
  */
 function appendRedirectParamFromCurrentLocationToUrl(url) {
     const currentPath = `${window.location.pathname}${window.location.search}${window.location.hash}`;
@@ -18,8 +18,8 @@ function appendRedirectParamFromCurrentLocationToUrl(url) {
  * Useful for redirecting to login or other gateways while preserving
  * the current location for post-auth navigation.
  *
- * @param {string} url - The destination URL to navigate to.
- * @param {number} [delayMs] - Optional delay in milliseconds before navigation.
+ * @param {string} url - The destination URL to navigate to
+ * @param {number} [delayMs] - Optional delay in milliseconds before navigation
  */
 function assignUrlWithRedirectParamFromCurrentLocation(url, delayMs) {
     if (delayMs === undefined)

package/dist/web.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"web.mjs","sources":["../src/web.ts"],"sourcesContent":["import { appendRedirectParamToUrl } from './url';\n\n/**\n * Appends the current browser URL (including path, query, and hash) as the `redirect` query parameter to the given URL.\n *\n * @param {string} url - The base URL to modify.\n *\n * @returns {string} A new URL with the current location as the `redirect` parameter.\n */\nexport function appendRedirectParamFromCurrentLocationToUrl(url: string) {\n    const currentPath = `${window.location.pathname}${window.location.search}${window.location.hash}`;\n    return appendRedirectParamToUrl(url, currentPath);\n}\n\n/**\n * Navigates to the given URL, appending the current browser location\n * (path, query, and hash) as the `redirect` query parameter.\n *\n * Useful for redirecting to login or other gateways while preserving\n * the current location for post-auth navigation.\n *\n * @param {string} url - The destination URL to navigate to.\n * @param {number} [delayMs] - Optional delay in milliseconds before navigation.\n */\nexport function assignUrlWithRedirectParamFromCurrentLocation(url: string, delayMs?: number) {\n    if (delayMs === undefined) window.location.assign(appendRedirectParamFromCurrentLocationToUrl(url));\n    else return setTimeout(() => window.location.assign(appendRedirectParamFromCurrentLocationToUrl(url)), delayMs);\n}\n"],"names":[],"mappings":";;AAEA;;;;;;AAMG;AACG,SAAU,2CAA2C,CAAC,GAAW,EAAA;IACnE,MAAM,WAAW,GAAG,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA,CAAE;AACjG,IAAA,OAAO,wBAAwB,CAAC,GAAG,EAAE,WAAW,CAAC;AACrD;AAEA;;;;;;;;;AASG;AACG,SAAU,6CAA6C,CAAC,GAAW,EAAE,OAAgB,EAAA;IACvF,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,2CAA2C,CAAC,GAAG,CAAC,CAAC;;AAC9F,QAAA,OAAO,UAAU,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,2CAA2C,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC;AACnH;;;;"}
+{"version":3,"file":"web.mjs","sources":["../src/web.ts"],"sourcesContent":["import { appendRedirectParamToUrl } from './url';\n\n/**\n * Appends the current browser URL (including path, query, and hash) as the `redirect` query parameter to the given URL.\n *\n * @param {string} url - The base URL to modify\n *\n * @returns {string} A new URL with the current location as the `redirect` parameter\n */\nexport function appendRedirectParamFromCurrentLocationToUrl(url: string) {\n    const currentPath = `${window.location.pathname}${window.location.search}${window.location.hash}`;\n    return appendRedirectParamToUrl(url, currentPath);\n}\n\n/**\n * Navigates to the given URL, appending the current browser location\n * (path, query, and hash) as the `redirect` query parameter.\n *\n * Useful for redirecting to login or other gateways while preserving\n * the current location for post-auth navigation.\n *\n * @param {string} url - The destination URL to navigate to\n * @param {number} [delayMs] - Optional delay in milliseconds before navigation\n */\nexport function assignUrlWithRedirectParamFromCurrentLocation(url: string, delayMs?: number) {\n    if (delayMs === undefined) window.location.assign(appendRedirectParamFromCurrentLocationToUrl(url));\n    else return setTimeout(() => window.location.assign(appendRedirectParamFromCurrentLocationToUrl(url)), delayMs);\n}\n"],"names":[],"mappings":";;AAEA;;;;;;AAMG;AACG,SAAU,2CAA2C,CAAC,GAAW,EAAA;IACnE,MAAM,WAAW,GAAG,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAA,EAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAA,CAAE;AACjG,IAAA,OAAO,wBAAwB,CAAC,GAAG,EAAE,WAAW,CAAC;AACrD;AAEA;;;;;;;;;AASG;AACG,SAAU,6CAA6C,CAAC,GAAW,EAAE,OAAgB,EAAA;IACvF,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,2CAA2C,CAAC,GAAG,CAAC,CAAC;;AAC9F,QAAA,OAAO,UAAU,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,2CAA2C,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC;AACnH;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kikiutils/shared",
-  "version": "10.3.0",
+  "version": "10.4.0",
   "description": "A lightweight and modular utility library for modern JavaScript and TypeScript — includes secure hashing, flexible logging, datetime tools, Vue/web helpers, storage abstraction, and more.",
   "author": "kiki-kanri",
   "license": "MIT",

package/src/buffer.ts

@@ -0,0 +1,37 @@
+import { Buffer } from 'node:buffer';
+
+/**
+ * Converts a Blob, Buffer, or File to a Buffer.
+ *
+ * This function provides a unified way to convert various binary data types
+ * to Node.js Buffer. If the input is already a Buffer, it returns it as-is.
+ * For Blob or File inputs, it converts them to Buffer via ArrayBuffer.
+ *
+ * @param {Blob | Buffer | File} input - The input to convert to Buffer
+ *
+ * @returns {Promise<Buffer>} A Promise that resolves to a Buffer
+ *
+ * @example
+ * ```typescript
+ * import { toBuffer } from '@kikiutils/shared/general';
+ *
+ * // Convert a Buffer (returns as-is)
+ * const buffer = Buffer.from('Hello World');
+ * const result1 = await toBuffer(buffer);
+ * console.log(result1); // <Buffer 48 65 6c 6c 6f 20 57 6f 72 6c 64>
+ *
+ * // Convert a Blob
+ * const blob = new Blob(['Hello from Blob'], { type: 'text/plain' });
+ * const result2 = await toBuffer(blob);
+ * console.log(result2.toString()); // 'Hello from Blob'
+ *
+ * // Convert a File
+ * const file = new File(['File content'], 'test.txt', { type: 'text/plain' });
+ * const result3 = await toBuffer(file);
+ * console.log(result3.toString()); // 'File content'
+ * ```
+ */
+export async function toBuffer(input: Blob | Buffer | File) {
+    if (Buffer.isBuffer(input)) return input;
+    return Buffer.from(await input.arrayBuffer());
+}

package/src/clipboard.ts

@@ -10,8 +10,8 @@ type CopyResult =
  * - Must be called **in response to a user interaction** (e.g. click, input).
  * - Not supported in Safari and some older browsers.
  *
- * @param {Blob} blob - The Blob object to copy (e.g. from a File, image, or text content).
- * @param {ClipboardItemOptions} [options] - Optional options passed to the ClipboardItem constructor.
+ * @param {Blob} blob - The Blob object to copy (e.g. from a File, image, or text content)
+ * @param {ClipboardItemOptions} [options] - Optional options passed to the ClipboardItem constructor
  *
  * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:
  *   - `{ ok: true }` if the copy succeeded
@@ -33,7 +33,7 @@ type CopyResult =
 export async function copyBlobToClipboard(blob: Blob, options?: ClipboardItemOptions): Promise<CopyResult> {
     if (!navigator.clipboard?.write) {
         return {
-            error: new Error('Clipboard.write is not supported in this browser.'),
+            error: new Error('Clipboard.write is not supported in this browser'),
             ok: false,
         };
     }
@@ -58,7 +58,7 @@ export async function copyBlobToClipboard(blob: Blob, options?: ClipboardItemOpt
  * - Must be called **in response to a user interaction** (e.g. click, input).
  * - Not supported in some older browsers (especially legacy Safari).
  *
- * @param {string} text - The string to be copied to the clipboard.
+ * @param {string} text - The string to be copied to the clipboard
  *
  * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:
  *   - `{ ok: true }` if the copy succeeded

package/src/datetime.ts

@@ -23,11 +23,11 @@ export type DateRangeType = 'lastMonth' | 'lastWeek' | 'thisMonth' | 'thisWeek'
  *
  * This function is a wrapper around `date-fns/format`.
  *
- * @param {DateArg<Date>} date - The input date to format. Can be a Date object, a timestamp, or a string.
- * @param {string} [format] - The target format string.
- * @param {FormatOptions} [options] - Optional formatting options passed to `date-fns/format`.
+ * @param {DateArg<Date>} date - The input date to format. Can be a Date object, a timestamp, or a string
+ * @param {string} [format] - The target format string
+ * @param {FormatOptions} [options] - Optional formatting options passed to `date-fns/format`
  *
- * @returns {string} The formatted date string.
+ * @returns {string} The formatted date string
  *
  * @example
  * ```typescript
@@ -54,13 +54,13 @@ export function formatDate(date: DateArg<Date> & {}, format: string = 'yyyy-MM-d
  *
  * Supports common range types like 'lastMonth', 'lastWeek', 'thisMonth', 'thisWeek', 'today', and 'yesterday'.
  *
- * @param {Date} date - The reference date.
- * @param {DateRangeType} type - The range type to compute.
- * @param {object} [options] - Optional settings.
- * @param {boolean} [options.setEndDateToNextDayStart] - If true, set `endDate` to 00:00:00.000 of the next day.
- * @param {Day} [options.weekStartsOn] - The start day of the week (0 = Sunday, 1 = Monday, ..., 6 = Saturday).
+ * @param {Date} date - The reference date
+ * @param {DateRangeType} type - The range type to compute
+ * @param {object} [options] - Optional settings
+ * @param {boolean} [options.setEndDateToNextDayStart] - If true, set `endDate` to 00:00:00.000 of the next day
+ * @param {Day} [options.weekStartsOn] - The start day of the week (0 = Sunday, 1 = Monday, ..., 6 = Saturday)
  *
- * @returns {{ startDate: Date, endDate: Date }} An object with `startDate` and `endDate`.
+ * @returns {{ startDate: Date, endDate: Date }} An object with `startDate` and `endDate`
  *
  * @example
  * ```typescript
@@ -123,7 +123,7 @@ export function getDateRangeFromDate(
             }
 
             break;
-        default: throw new Error(`Unsupported date range type: ${type}.`);
+        default: throw new Error(`Unsupported date range type: ${type}`);
     }
 
     if (options?.setEndDateToNextDayStart) endDate.setHours(24, 0, 0, 0);
@@ -136,9 +136,9 @@ export function getDateRangeFromDate(
 /**
  * Returns a `Date` object set to midnight (00:00:00) of today, with an optional day offset.
  *
- * @param {number} [offsetDays] - Number of days to offset from today. Can be negative.
+ * @param {number} [offsetDays] - Number of days to offset from today. Can be negative
  *
- * @returns {Date} A `Date` object at 00:00:00 of the offset day.
+ * @returns {Date} A `Date` object at 00:00:00 of the offset day
  *
  * @example
  * ```typescript

package/src/element-plus.ts

@@ -10,13 +10,13 @@ export type DoNotRemoveOrUseThisType = RuleType;
  * while allowing overrides via the `options` parameter. It simplifies common
  * form validation rule creation and ensures consistency across forms.
  *
- * @param {string} message - The validation message to display when the rule fails.
- * @param {FormItemRule} [options] - Optional overrides for the rule fields.
- * @param {boolean} [options.required] - Whether the field is required (default: `true`).
- * @param {string | string[]} [options.trigger] - The event(s) that trigger validation (default: `'blur'`).
- * @param {RuleType} [options.type] - The expected type of the field (default: `'string'`).
+ * @param {string} message - The validation message to display when the rule fails
+ * @param {FormItemRule} [options] - Optional overrides for the rule fields
+ * @param {boolean} [options.required] - Whether the field is required (default: `true`)
+ * @param {string | string[]} [options.trigger] - The event(s) that trigger validation (default: `'blur'`)
+ * @param {RuleType} [options.type] - The expected type of the field (default: `'string'`)
  *
- * @returns A `FormItemRule` object that can be used in Element Plus form validation.
+ * @returns A `FormItemRule` object that can be used in Element Plus form validation
  *
  * @example
  * ```typescript

package/src/enum.ts

@@ -1,12 +1,12 @@
 /**
  * Extracts only the numeric values from an enumeration-like object.
  *
- * @template T - The type of the enum object.
+ * @template T - The type of the enum object
  *
- * @param {T} enumObject - The enumeration-like object to extract numeric values from.
- * The object can contain numeric values, string values, or both.
+ * @param {T} enumObject - The enumeration-like object to extract numeric values from,
+ * the object can contain numeric values, string values, or both.
  *
- * @returns {Extract<T[keyof T], number>[]} An array of numeric values extracted from the enum object.
+ * @returns {Extract<T[keyof T], number>[]} An array of numeric values extracted from the enum object
  *
  * @example
  * ```typescript
@@ -28,12 +28,12 @@ export function getEnumNumberValues<T extends Record<string, any>>(enumObject: T
 /**
  * Extracts only the string values from an enumeration-like object.
  *
- * @template T - The type of the enum object.
+ * @template T - The type of the enum object
  *
- * @param {T} enumObject - The enumeration-like object to extract string values from.
- * The object can contain numeric values, string values, or both.
+ * @param {T} enumObject - The enumeration-like object to extract string values from,
+ * the object can contain numeric values, string values, or both.
  *
- * @returns {Extract<T[keyof T], string>[]} An array of string values extracted from the enum object.
+ * @returns {Extract<T[keyof T], string>[]} An array of string values extracted from the enum object
  *
  * @example
  * ```typescript
@@ -59,12 +59,12 @@ export function getEnumStringValues<T extends Record<string, any>>(enumObject: T
  * that occurs with numeric enums. It works with pure numeric enums, pure string enums,
  * and mixed enums.
  *
- * @template T - The type of the enum object.
+ * @template T - The type of the enum object
  *
- * @param {T} enumObject - The enumeration-like object to extract values from.
- * The object can contain numeric values, string values, or both.
+ * @param {T} enumObject - The enumeration-like object to extract values from,
+ * the object can contain numeric values, string values, or both.
  *
- * @returns {(T[keyof T])[]} An array containing all the values from the enum object.
+ * @returns {(T[keyof T])[]} An array containing all the values from the enum object
  *
  * @example
  * ```typescript

package/src/env.ts

@@ -11,7 +11,7 @@ export class EnvironmentNotFoundError extends Error {
     /**
      * Creates a new EnvironmentNotFoundError.
      *
-     * @param {string} key - The missing environment variable key.
+     * @param {string} key - The missing environment variable key
      */
     constructor(key: string) {
         super(`Missing environment variable: ${key}`);
@@ -27,11 +27,11 @@ export class EnvironmentNotFoundError extends Error {
  * Only checks for `process.env[key] === undefined`. An empty string (e.g. '') or any falsy string
  * value like `'0'` or `'false'` is considered a valid (defined) value.
  *
- * @param {string} key - The environment variable key to retrieve.
+ * @param {string} key - The environment variable key to retrieve
  *
- * @returns {string} The value of the environment variable.
+ * @returns {string} The value of the environment variable
  *
- * @throws {EnvironmentNotFoundError} If the environment variable is not defined.
+ * @throws {EnvironmentNotFoundError} If the environment variable is not defined
  *
  * @example
  * ```typescript

package/src/general.ts

@@ -7,13 +7,13 @@
  * - If `value` is not an array, returns `value` directly.
  * - If the result is `null` or `undefined`, and `defaultValue` is provided, returns `defaultValue` instead.
  *
- * @template T - The type of the input value(s).
- * @template D - The type of the default value (if provided).
+ * @template T - The type of the input value(s)
+ * @template D - The type of the default value (if provided)
  *
- * @param {T | T[]} value - A single value or an array of values.
- * @param {D} [defaultValue] - A fallback value if the result is `null` or `undefined`.
+ * @param {T | T[]} value - A single value or an array of values
+ * @param {D} [defaultValue] - A fallback value if the result is `null` or `undefined`
  *
- * @returns {T | D | undefined} The first value or the fallback.
+ * @returns {T | D | undefined} The first value or the fallback
  *
  * @example
  * ```typescript

package/src/math.ts

@@ -28,11 +28,11 @@ export interface ToPercentageStringOptions {
  * - Supports custom decimal places and optional percentage symbol.
  * - Returns `'0.00%'` if result is `NaN` or division is invalid.
  *
- * @param {CalculableValue} molecular - The numerator of the fraction.
- * @param {CalculableValue} denominator - The denominator of the fraction.
- * @param {ToPercentageStringOptions} [options] - Optional output settings.
+ * @param {CalculableValue} molecular - The numerator of the fraction
+ * @param {CalculableValue} denominator - The denominator of the fraction
+ * @param {ToPercentageStringOptions} [options] - Optional output settings
  *
- * @returns {string} Formatted percentage string.
+ * @returns {string} Formatted percentage string
  *
  * @example
  * ```typescript

package/src/number.ts

@@ -5,10 +5,10 @@ import { millify } from 'millify';
  *
  * Applies lowercase units (e.g. 'k', 'm') and default precision of 2, unless overridden.
  *
- * @param {number} value - The number to format.
- * @param {Parameters<typeof millify>[1]} [options] - Optional configuration passed to `millify`.
+ * @param {number} value - The number to format
+ * @param {Parameters<typeof millify>[1]} [options] - Optional configuration passed to `millify`
  *
- * @returns {string} The compact number string.
+ * @returns {string} The compact number string
  *
  * @example
  * ```typescript

package/src/object.ts

@@ -8,10 +8,10 @@
  * It is designed for use cases such as signature generation, cache key construction,
  * or any context requiring consistent and predictable object serialization.
  *
- * @param {Record<string, any>} input - The object to serialize. Can contain nested objects and arrays.
- * @param {string} kvSeparator - The string used to separate each key from its value (default: '=').
- * @param {string} pairSeparator - The string used to separate each key-value pair (default: '&').
- * @returns {string} A deterministic string representation of the input object.
+ * @param {Record<string, any>} input - The object to serialize. Can contain nested objects and arrays
+ * @param {string} kvSeparator - The string used to separate each key from its value (default: '=')
+ * @param {string} pairSeparator - The string used to separate each key-value pair (default: '&')
+ * @returns {string} A deterministic string representation of the input object
  *
  * @example
  * ```typescript

package/src/random.ts

@@ -8,15 +8,15 @@
  *
  * This function supports any return type by using a generic type parameter.
  *
- * @template T - The return type of the generator function.
+ * @template T - The return type of the generator function
  *
- * @param {(length: number) => T} generator - A function that accepts a length and returns a value of type T.
- * @param {number} minMin - Lower bound of the first random range.
- * @param {number} minMax - Upper bound of the first random range.
- * @param {number} maxMin - Lower bound of the second random range.
- * @param {number} maxMax - Upper bound of the second random range.
+ * @param {(length: number) => T} generator - A function that accepts a length and returns a value of type T
+ * @param {number} minMin - Lower bound of the first random range
+ * @param {number} minMax - Upper bound of the first random range
+ * @param {number} maxMin - Lower bound of the second random range
+ * @param {number} maxMax - Upper bound of the second random range
  *
- * @returns {T} The result of the generator function using the computed final length.
+ * @returns {T} The result of the generator function using the computed final length
  */
 export function generateWithNestedRandomLength<T = string>(
     generator: (length: number) => T,