@kikiutils/shared 14.1.1 → 15.0.0

package/dist/vue.js.map

@@ -1 +1 @@
-{"version":3,"file":"vue.js","names":[],"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 type { Nullable } from './types';\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<Nullable<ReturnType<typeof setInterval>>>} intervalRef - A Vue ref holding a NodeJS.Timeout or null\n */\nexport function clearIntervalRef(intervalRef: Ref<Nullable<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<Nullable<ReturnType<typeof setTimeout>>>} timeoutRef - A Vue ref holding a NodeJS.Timeout or null\n */\nexport function clearTimeoutRef(timeoutRef: Ref<Nullable<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<Nullable<T>>} containerRef - A ref to the scrollable HTML element\n */\nexport function usePreserveScroll<T extends Element = HTMLElement>(containerRef: Ref<Nullable<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"],"mappings":";;;;;;;;;;;;AAiBA,SAAgB,yCAAyC,KAAa;AAClE,QAAO,yBAAyB,KAAK,UAAU,CAAC,SAAS;;;;;;;AAQ7D,SAAgB,iBAAiB,aAA4D;AACzF,KAAI,YAAY,MAAO,eAAc,YAAY,MAAM;AACvD,aAAY,QAAQ;;;;;;;AAQxB,SAAgB,gBAAgB,YAA0D;AACtF,KAAI,WAAW,MAAO,cAAa,WAAW,MAAM;AACpD,YAAW,QAAQ;;;;;;;;;;AAWvB,SAAgB,kBAAmD,cAAgC;CAC/F,IAAI,aAAa;CACjB,IAAI,YAAY;AAChB,mBAAkB;AACd,MAAI,CAAC,aAAa,MAAO;AACzB,eAAa,MAAM,aAAa;AAChC,eAAa,MAAM,YAAY;GACjC;AAEF,0BAAyB;AACrB,eAAa,aAAa,OAAO,cAAc;AAC/C,cAAY,aAAa,OAAO,aAAa;GAC/C"}
+{"version":3,"file":"vue.js","names":[],"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 type { Nullable } from './types';\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<Nullable<ReturnType<typeof setInterval>>>} intervalRef - A Vue ref holding a NodeJS.Timeout or null\n */\nexport function clearIntervalRef(intervalRef: Ref<Nullable<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<Nullable<ReturnType<typeof setTimeout>>>} timeoutRef - A Vue ref holding a NodeJS.Timeout or null\n */\nexport function clearTimeoutRef(timeoutRef: Ref<Nullable<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<Nullable<T>>} containerRef - A ref to the scrollable HTML element\n */\nexport function usePreserveScroll<T extends Element = HTMLElement>(containerRef: Ref<Nullable<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"],"mappings":";;;;;;;;;;;AAiBA,SAAgB,yCAAyC,KAAa;AAClE,QAAO,yBAAyB,KAAK,UAAU,CAAC,SAAS;;;;;;;AAQ7D,SAAgB,iBAAiB,aAA4D;AACzF,KAAI,YAAY,MAAO,eAAc,YAAY,MAAM;AACvD,aAAY,QAAQ;;;;;;;AAQxB,SAAgB,gBAAgB,YAA0D;AACtF,KAAI,WAAW,MAAO,cAAa,WAAW,MAAM;AACpD,YAAW,QAAQ;;;;;;;;;;AAWvB,SAAgB,kBAAmD,cAAgC;CAC/F,IAAI,aAAa;CACjB,IAAI,YAAY;AAChB,mBAAkB;AACd,MAAI,CAAC,aAAa,MAAO;AACzB,eAAa,MAAM,aAAa;AAChC,eAAa,MAAM,YAAY;GACjC;AAEF,0BAAyB;AACrB,eAAa,aAAa,OAAO,cAAc;AAC/C,cAAY,aAAa,OAAO,aAAa;GAC/C"}

package/dist/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","names":[],"sources":["../src/web.ts"],"sourcesContent":[],"mappings":";;AASA;AAeA;;;;;iBAfgB,2CAAA;;;;;;;;;;;iBAeA,6CAAA,iCAA2E,MAAA,CAAA"}
+{"version":3,"file":"web.d.ts","names":[],"sources":["../src/web.ts"],"mappings":";;AASA;;;;;AAeA;iBAfgB,2CAAA,CAA4C,GAAA;;;;;;;;;;;iBAe5C,6CAAA,CAA8C,GAAA,UAAa,OAAA,YAAgB,MAAA,CAAA,OAAA"}

package/dist/web.js

@@ -1,5 +1,4 @@
 import { appendRedirectParamToUrl } from "./url.js";
-
 //#region src/web.ts
 /**
 * Appends the current browser URL (including path, query, and hash) as the `redirect` query parameter to the given URL.
@@ -25,7 +24,7 @@ function assignUrlWithRedirectParamFromCurrentLocation(url, delayMs) {
 	if (delayMs === void 0) window.location.assign(appendRedirectParamFromCurrentLocationToUrl(url));
 	else return setTimeout(() => window.location.assign(appendRedirectParamFromCurrentLocationToUrl(url)), delayMs);
 }
-
 //#endregion
 export { appendRedirectParamFromCurrentLocationToUrl, assignUrlWithRedirectParamFromCurrentLocation };
+
 //# sourceMappingURL=web.js.map

package/dist/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","names":[],"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"],"mappings":";;;;;;;;;;AASA,SAAgB,4CAA4C,KAAa;AAErE,QAAO,yBAAyB,KADZ,GAAG,OAAO,SAAS,WAAW,OAAO,SAAS,SAAS,OAAO,SAAS,OAC1C;;;;;;;;;;;;AAarD,SAAgB,8CAA8C,KAAa,SAAkB;AACzF,KAAI,YAAY,OAAW,QAAO,SAAS,OAAO,4CAA4C,IAAI,CAAC;KAC9F,QAAO,iBAAiB,OAAO,SAAS,OAAO,4CAA4C,IAAI,CAAC,EAAE,QAAQ"}
+{"version":3,"file":"web.js","names":[],"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"],"mappings":";;;;;;;;;AASA,SAAgB,4CAA4C,KAAa;AAErE,QAAO,yBAAyB,KADZ,GAAG,OAAO,SAAS,WAAW,OAAO,SAAS,SAAS,OAAO,SAAS,OAC1C;;;;;;;;;;;;AAarD,SAAgB,8CAA8C,KAAa,SAAkB;AACzF,KAAI,YAAY,KAAA,EAAW,QAAO,SAAS,OAAO,4CAA4C,IAAI,CAAC;KAC9F,QAAO,iBAAiB,OAAO,SAAS,OAAO,4CAA4C,IAAI,CAAC,EAAE,QAAQ"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kikiutils/shared",
   "type": "module",
-  "version": "14.1.1",
+  "version": "15.0.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",
@@ -56,47 +56,38 @@
   "scripts": {
     "build": "tsdown",
     "bumplog": "changelogen --bump --hideAuthorEmail",
-    "depcheck": "depcheck",
+    "knip:deps": "knip --dependencies",
+    "knip:exports": "knip --exports",
     "lint": "eslint --max-warnings 0",
     "lint:fix": "eslint --fix --max-warnings 0",
     "prepack": "pnpm run build",
     "release": "pnpm run lint && pnpm run typecheck && pnpm run test && pnpm run build && changelogen --hideAuthorEmail --push --release && npm publish",
     "test": "cross-env TZ=UTC vitest run --coverage",
     "test:watch": "cross-env TZ=UTC vitest watch --coverage",
-    "typecheck": "tsc -b --noEmit",
-    "unused-exports": "ts-unused-exports ./tsconfig.json"
+    "typecheck": "tsc -b --noEmit"
   },
   "peerDependencies": {
     "@noble/hashes": "^2.0.1",
-    "@types/fs-extra": "^11.0.4",
-    "@types/jsonfile": "^6.1.4",
     "@types/ssh2": "^1.15.5",
     "async-validator": "^4.2.5",
-    "bson": "^7.1.1",
+    "bson": "^7.2.0",
     "consola": "^3.4.2",
     "date-fns": "^4.1.0",
     "decimal.js": "^10.6.0",
-    "element-plus": "^2.13.1",
-    "fs-extra": "^11.3.3",
-    "lru-cache": "^11.2.4",
+    "element-plus": "^2.13.5",
+    "lru-cache": "^11.2.6",
     "millify": "^6.1.0",
     "msgpackr": "^1.11.8",
     "node-ssh": "^13.2.1",
-    "pino": "^10.2.0",
+    "pino": "^10.3.1",
     "pino-pretty": "^13.1.3",
-    "vue": "^3.5.26",
-    "vue-router": "^4.6.4"
+    "vue": "^3.5.30",
+    "vue-router": ">= 4.6.4"
   },
   "peerDependenciesMeta": {
     "@noble/hashes": {
       "optional": true
     },
-    "@types/fs-extra": {
-      "optional": true
-    },
-    "@types/jsonfile": {
-      "optional": true
-    },
     "@types/ssh2": {
       "optional": true
     },
@@ -118,9 +109,6 @@
     "element-plus": {
       "optional": true
     },
-    "fs-extra": {
-      "optional": true
-    },
     "lru-cache": {
       "optional": true
     },
@@ -147,40 +135,36 @@
     }
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^7.0.1",
-    "@kikiutils/eslint-config": "^5.0.2",
-    "@kikiutils/tsconfigs": "^5.0.5",
+    "@antfu/eslint-config": "^7.7.0",
+    "@kikiutils/eslint-config": "^7.0.2",
+    "@kikiutils/tsconfigs": "^5.1.0",
     "@noble/hashes": "^2.0.1",
-    "@types/fs-extra": "^11.0.4",
-    "@types/jsonfile": "^6.1.4",
-    "@types/node": "^25.0.9",
+    "@types/node": "^25.4.0",
     "@types/ssh2": "^1.15.5",
-    "@vitest/coverage-v8": "^4.0.17",
+    "@vitest/coverage-v8": "^4.0.18",
     "async-validator": "^4.2.5",
-    "bson": "^7.1.1",
+    "bson": "^7.2.0",
     "changelogen": "^0.6.2",
     "consola": "^3.4.2",
     "cross-env": "^10.1.0",
     "date-fns": "^4.1.0",
     "decimal.js": "^10.6.0",
-    "depcheck": "^1.4.7",
-    "element-plus": "^2.13.1",
-    "fs-extra": "^11.3.3",
-    "jsdom": "^27.4.0",
-    "lru-cache": "^11.2.4",
+    "element-plus": "^2.13.5",
+    "jsdom": "^28.1.0",
+    "knip": "^5.86.0",
+    "lru-cache": "^11.2.6",
     "millify": "^6.1.0",
     "msgpackr": "^1.11.8",
     "node-ssh": "^13.2.1",
-    "pino": "^10.2.0",
+    "pino": "^10.3.1",
     "pino-pretty": "^13.1.3",
-    "publint": "^0.3.16",
-    "ts-unused-exports": "^11.0.1",
-    "tsdown": "^0.19.0",
+    "publint": "^0.3.18",
+    "tsdown": "^0.21.1",
     "typescript": "^5.9.3",
-    "unplugin-unused": "^0.5.6",
-    "vitest": "^4.0.17",
-    "vue": "^3.5.26",
-    "vue-router": "^4.6.4"
+    "unplugin-unused": "^0.5.7",
+    "vitest": "^4.0.18",
+    "vue": "^3.5.30",
+    "vue-router": "^5.0.3"
   },
   "pnpm": {
     "onlyBuiltDependencies": [

package/src/classes/path.ts

@@ -17,13 +17,6 @@ import {
 } from 'node:path';
 import type * as nodePath from 'node:path';
 
-import * as fsExtra from 'fs-extra';
-import type {
-    JFReadOptions,
-    JFWriteOptions,
-} from 'jsonfile';
-
-export type DoNotRemoveOrUseThisType = typeof fsExtra;
 type DropFirstParameters<T extends (...args: any) => any> = Parameters<T> extends [any, ...infer R] ? R : never;
 export type PathLike = fs.PathLike | Path;
 
@@ -385,44 +378,4 @@ export class Path {
     writeFile(...args: DropFirstParameters<typeof fsp.writeFile>) {
         return fsp.writeFile(this.#value, ...args);
     }
-
-    // Some commonly used promise fs extra methods
-
-    /**
-     * @see {@link fsExtra.ensureDir}
-     */
-    ensureDir(options?: fsExtra.EnsureDirOptions | number) {
-        return fsExtra.ensureDir(this.#value, options);
-    }
-
-    /**
-     * @see {@link fsExtra.ensureDir}
-     */
-    mkdirp = this.ensureDir;
-
-    /**
-     * @see {@link fsExtra.ensureDir}
-     */
-    mkdirs = this.ensureDir;
-
-    /**
-     * @see {@link fsExtra.readJson}
-     */
-    async readJson<T = any>(options?: JFReadOptions) {
-        return await fsExtra.readJson(this.#value, options) as T;
-    }
-
-    /**
-     * @see {@link fsExtra.remove}
-     */
-    remove() {
-        return fsExtra.remove(this.#value);
-    }
-
-    /**
-     * @see {@link fsExtra.writeJson}
-     */
-    writeJson(data: any, options?: JFWriteOptions) {
-        return fsExtra.writeJson(this.#value, data, options);
-    }
 }

package/src/string.ts

@@ -46,5 +46,5 @@ export function randomString(length: number, mode: RandomStringMode = 'alphabeti
 
     const charset = CHARSETS[mode];
     if (!charset) throw new Error(`Unsupported mode: ${mode}`);
-    return Array.from({ length }, () => charset[Math.floor(Math.random() * charset.length)]).join('');
+    return Array.from({ length }).fill(charset[Math.floor(Math.random() * charset.length)]).join('');
 }