@qwreey-js/ts-util 1.0.3 → 1.0.5

package/dist/mixin.js

@@ -1,25 +1,90 @@
+/**
+ * Copies prototype methods and static properties from a list of base classes directly onto a target class.
+ * @param targetClass The class to which the mixins will be applied.
+ * @param baseClassList An array of base classes to mix into the `targetClass`.
+ */
 export function applyRuntimeMixins(targetClass, baseClassList) {
     for (const baseClass of baseClassList) {
-        Object.getOwnPropertyNames(baseClass.prototype).forEach((name) => {
-            if (name !== "constructor") {
-                const descriptor = Object.getOwnPropertyDescriptor(baseClass.prototype, name);
-                if (descriptor) {
-                    Object.defineProperty(targetClass.prototype, name, descriptor);
+        let currentProto = baseClass.prototype;
+        while (currentProto && currentProto !== Object.prototype) {
+            Object.getOwnPropertyNames(currentProto).forEach((name) => {
+                if (name !== "constructor") {
+                    const descriptor = Object.getOwnPropertyDescriptor(currentProto, name);
+                    if (descriptor) {
+                        Object.defineProperty(targetClass.prototype, name, descriptor);
+                    }
                 }
-            }
-        });
-        for (const name of Object.getOwnPropertyNames(baseClass)) {
-            if (!["length", "prototype", "name"].includes(name)) {
-                const descriptor = Object.getOwnPropertyDescriptor(baseClass, name);
-                if (descriptor) {
-                    Object.defineProperty(targetClass, name, descriptor);
+            });
+            currentProto = Object.getPrototypeOf(currentProto);
+        }
+        let currentClass = baseClass;
+        while (currentClass &&
+            currentClass !== Function.prototype &&
+            currentClass !== Object) {
+            for (const name of Object.getOwnPropertyNames(currentClass)) {
+                if (!["length", "prototype", "name"].includes(name)) {
+                    const descriptor = Object.getOwnPropertyDescriptor(currentClass, name);
+                    if (descriptor) {
+                        Object.defineProperty(targetClass, name, descriptor);
+                    }
                 }
             }
+            currentClass = Object.getPrototypeOf(currentClass);
         }
     }
 }
+export function isNonNullObject(instance) {
+    if (typeof instance !== "object")
+        return false;
+    if (instance === null)
+        return false;
+    return true;
+}
+/**
+ * Checks whether the given instance incorporates a specific mixin or base class.
+ * This utility serves as an alternative to the native `instanceof` operator for custom
+ * mixin implementations where the prototype chain does not inherently preserve the relationship.
+ *
+ * @template T - The constructor type of the target mixin or base class.
+ * @param {T} baseClass - The mixin or base class constructor to verify against.
+ * @param {*} instance - The object instance to inspect.
+ * @returns {instance is T} `true` if the instance incorporates the specified mixin; otherwise, `false`.
+ */
+export function hasMixin(baseClass, instance) {
+    const mixins = getMixins(instance);
+    if (!mixins)
+        return false;
+    return mixins.includes(baseClass);
+}
+/**
+ * Retrieves the sequence of mixins associated with the specified instance.
+ *
+ * @param {*} instance - The object instance to inspect.
+ * @returns {ReadonlyArray<AbstractConstructor> | undefined} A read-only array of mixin constructors applied to the instance, or `undefined` if no mixins are registered.
+ */
+export function getMixins(instance) {
+    if (!isNonNullObject(instance))
+        return;
+    if (!("constructor" in instance))
+        return;
+    const instConstructor = instance.constructor;
+    if (typeof instConstructor !== "function")
+        return;
+    if (!("$baseClassList" in instConstructor))
+        return;
+    const baseClassList = instConstructor["$baseClassList"];
+    if (!Array.isArray(baseClassList))
+        return;
+    return baseClassList;
+}
+/**
+ * Creates an anonymous target class, applies the `baseClassList` to it, and returns the constructed mixin class.
+ * @param baseClassList A list of base classes you want to compose.
+ * @returns A new class constructor containing all instance and static properties of the base classes.
+ */
 export function mixin(...baseClassList) {
     const targetClass = class {
+        static $baseClassList = baseClassList;
     };
     applyRuntimeMixins(targetClass, baseClassList);
     return targetClass;

package/dist/mixin.js.map

@@ -1 +1 @@
-{"version":3,"file":"mixin.js","sourceRoot":"","sources":["../src/mixin.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,kBAAkB,CAAC,WAAgB,EAAE,aAAoB;IACvE,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;QACtC,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAC/D,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;gBAC3B,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAChD,SAAS,CAAC,SAAS,EACnB,IAAI,CACL,CAAC;gBACF,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBAEpE,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,KAAK,CACnB,GAAG,aAAgB;IAEnB,MAAM,WAAW,GAAG;KAAQ,CAAC;IAC7B,kBAAkB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC/C,OAAO,WAAkB,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"mixin.js","sourceRoot":"","sources":["../src/mixin.ts"],"names":[],"mappings":"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"}

package/dist/params-builder.d.ts

@@ -0,0 +1,31 @@
+/** URLSearchParams builder pattern wrapper */
+export declare class ParamsBuilder {
+    private inner;
+    /**
+     * Creates a new ParamsBuilder instance.
+     * @param base - An optional existing {@link URLSearchParams} to wrap.
+     */
+    constructor(base?: URLSearchParams);
+    /**
+     * Appends a new query parameter.
+     * @param name - The name of the parameter.
+     * @param value - The value of the parameter.
+     * @returns The current instance for method chaining.
+     */
+    push(name: string, value: string): ParamsBuilder;
+    /**
+     * Finalizes the builder and returns the query string.
+     * @returns The serialized query parameters as a string.
+     */
+    finalize(): string;
+    /**
+     * Returns the underlying {@link URLSearchParams} instance.
+     *
+     * @note **Terminal Operation**: This method transfers ownership of the
+     * internal state. Do not use this builder instance after calling this method.
+     *
+     * @returns The raw URLSearchParams object.
+     */
+    asInner(): URLSearchParams;
+}
+//# sourceMappingURL=params-builder.d.ts.map

package/dist/params-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params-builder.d.ts","sourceRoot":"","sources":["../src/params-builder.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAkB;IAE/B;;;OAGG;gBACgB,IAAI,CAAC,EAAE,eAAe;IAIzC;;;;;OAKG;IACI,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa;IAKvD;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;;;;;OAOG;IACI,OAAO,IAAI,eAAe;CAGlC"}

package/dist/params-builder.js

@@ -0,0 +1,40 @@
+/** URLSearchParams builder pattern wrapper */
+export class ParamsBuilder {
+    inner;
+    /**
+     * Creates a new ParamsBuilder instance.
+     * @param base - An optional existing {@link URLSearchParams} to wrap.
+     */
+    constructor(base) {
+        this.inner = base ?? new URLSearchParams();
+    }
+    /**
+     * Appends a new query parameter.
+     * @param name - The name of the parameter.
+     * @param value - The value of the parameter.
+     * @returns The current instance for method chaining.
+     */
+    push(name, value) {
+        this.inner.append(name, value);
+        return this;
+    }
+    /**
+     * Finalizes the builder and returns the query string.
+     * @returns The serialized query parameters as a string.
+     */
+    finalize() {
+        return this.inner.toString();
+    }
+    /**
+     * Returns the underlying {@link URLSearchParams} instance.
+     *
+     * @note **Terminal Operation**: This method transfers ownership of the
+     * internal state. Do not use this builder instance after calling this method.
+     *
+     * @returns The raw URLSearchParams object.
+     */
+    asInner() {
+        return this.inner;
+    }
+}
+//# sourceMappingURL=params-builder.js.map

package/dist/params-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params-builder.js","sourceRoot":"","sources":["../src/params-builder.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,MAAM,OAAO,aAAa;IAChB,KAAK,CAAkB;IAE/B;;;OAGG;IACH,YAAmB,IAAsB;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,IAAI,IAAI,eAAe,EAAE,CAAC;IAC7C,CAAC;IAED;;;;;OAKG;IACI,IAAI,CAAC,IAAY,EAAE,KAAa;QACrC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACI,QAAQ;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;IAED;;;;;;;OAOG;IACI,OAAO;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF"}

package/dist/result.d.ts

@@ -1,3 +1,6 @@
+/**
+ * A discriminated union type that can represent either a successful value of type `T` or an error of type `U`.
+ */
 export type Result<T, U> = {
     result: undefined;
     error: U;
@@ -6,13 +9,23 @@ export type Result<T, U> = {
     error: undefined;
 };
 export declare namespace Result {
+    /**
+     * Creates a successful result object containing the provided `result` value.
+     * @param result The successful value to wrap.
+     */
     function ok<T>(result: T): {
         result: T;
         error: undefined;
     };
+    /**
+     * Creates an error result object containing the provided `error` value.
+     * @param error The error value or object to wrap.
+     */
     function err<U>(error: U): {
         result: undefined;
         error: U;
     };
 }
+export declare const Ok: typeof Result.ok;
+export declare const Err: typeof Result.err;
 //# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IACnB;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,CAAC,CAAC;CACV,GACD;IACE,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEN,yBAAiB,MAAM,CAAC;IACtB,SAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAEhE;IACD,SAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAEhE;CACF"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IACnB;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,CAAC,CAAC;CACV,GACD;IACE,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEN,yBAAiB,MAAM,CAAC;IACtB;;;OAGG;IACH,SAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAEhE;IAED;;;OAGG;IACH,SAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAEhE;CACF;AAED,eAAO,MAAM,EAAE,kBAAY,CAAC;AAC5B,eAAO,MAAM,GAAG,mBAAa,CAAC"}

package/dist/result.js

@@ -1,12 +1,22 @@
 export var Result;
 (function (Result) {
+    /**
+     * Creates a successful result object containing the provided `result` value.
+     * @param result The successful value to wrap.
+     */
     function ok(result) {
         return { error: undefined, result };
     }
     Result.ok = ok;
+    /**
+     * Creates an error result object containing the provided `error` value.
+     * @param error The error value or object to wrap.
+     */
     function err(error) {
         return { error, result: undefined };
     }
     Result.err = err;
 })(Result || (Result = {}));
+export const Ok = Result.ok;
+export const Err = Result.err;
 //# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAUA,MAAM,KAAW,MAAM,CAOtB;AAPD,WAAiB,MAAM;IACrB,SAAgB,EAAE,CAAI,MAAS;QAC7B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;IAFe,SAAE,KAEjB,CAAA;IACD,SAAgB,GAAG,CAAI,KAAQ;QAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACtC,CAAC;IAFe,UAAG,MAElB,CAAA;AACH,CAAC,EAPgB,MAAM,KAAN,MAAM,QAOtB"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAaA,MAAM,KAAW,MAAM,CAgBtB;AAhBD,WAAiB,MAAM;IACrB;;;OAGG;IACH,SAAgB,EAAE,CAAI,MAAS;QAC7B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;IAFe,SAAE,KAEjB,CAAA;IAED;;;OAGG;IACH,SAAgB,GAAG,CAAI,KAAQ;QAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACtC,CAAC;IAFe,UAAG,MAElB,CAAA;AACH,CAAC,EAhBgB,MAAM,KAAN,MAAM,QAgBtB;AAED,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;AAC5B,MAAM,CAAC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC"}

package/dist/timeid.d.ts

@@ -0,0 +1,24 @@
+export declare namespace TimeId {
+    /**
+     * Generates a unique, time-sortable identifier string.
+     *
+     * The identifier is composed of four hyphen-separated segments:
+     * - The first two segments encode the current millisecond timestamp.
+     * - The last two segments (16 characters) contain random entropy.
+     *
+     * @returns {string} A unique ID string (e.g., "XXXX-XXXX-YYYY-YYYY").
+     */
+    function create(timebase?: Date | null): string;
+    /**
+     * Parses a timeId string and returns the original Date and random bytes.
+     *
+     * @param id The timeId string to parse.
+     * @returns An object containing the decoded `date` and `randbytes`.
+     * @throws If the timeId format or payload is invalid.
+     */
+    function parse(id: string): {
+        date: Date;
+        randbytes: Uint8Array;
+    };
+}
+//# sourceMappingURL=timeid.d.ts.map

package/dist/timeid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeid.d.ts","sourceRoot":"","sources":["../src/timeid.ts"],"names":[],"mappings":"AAEA,yBAAiB,MAAM,CAAC;IACtB;;;;;;;;OAQG;IACH,SAAgB,MAAM,CAAC,QAAQ,GAAE,IAAI,GAAG,IAAW,GAAG,MAAM,CAsB3D;IAED;;;;;;OAMG;IACH,SAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,UAAU,CAAA;KAAE,CA+BvE;CACF"}

package/dist/timeid.js

@@ -0,0 +1,62 @@
+import { Base32 } from "./base32.js";
+export var TimeId;
+(function (TimeId) {
+    /**
+     * Generates a unique, time-sortable identifier string.
+     *
+     * The identifier is composed of four hyphen-separated segments:
+     * - The first two segments encode the current millisecond timestamp.
+     * - The last two segments (16 characters) contain random entropy.
+     *
+     * @returns {string} A unique ID string (e.g., "XXXX-XXXX-YYYY-YYYY").
+     */
+    function create(timebase = null) {
+        // Create random values
+        const randbytes = crypto.getRandomValues(new Uint8Array(8));
+        const k32 = Base32.fromUint8Array(randbytes);
+        const lower = k32.substring(0, 8);
+        const upper = k32.substring(8, 16);
+        const timepad = k32.substring(16, 19);
+        // Construct time Uint8Array
+        timebase ??= new Date();
+        const timestamp = BigInt(timebase.getTime());
+        const timebuffer = new ArrayBuffer(8);
+        const timeview = new DataView(timebuffer);
+        timeview.setBigUint64(0, timestamp, false);
+        const timearr = new Uint8Array(timebuffer);
+        // Assemble id
+        const timestr = Base32.fromUint8Array(timearr).substring(0, 13) + timepad;
+        const timelower = timestr.substring(0, 8);
+        const timeupper = timestr.substring(8, 16);
+        const generated = `${timelower}-${timeupper}-${lower}-${upper}`;
+        return generated;
+    }
+    TimeId.create = create;
+    /**
+     * Parses a timeId string and returns the original Date and random bytes.
+     *
+     * @param id The timeId string to parse.
+     * @returns An object containing the decoded `date` and `randbytes`.
+     * @throws If the timeId format or payload is invalid.
+     */
+    function parse(id) {
+        const parts = id.split("-");
+        if (parts.length !== 4) {
+            throw new Error("Invalid timeId format");
+        }
+        const [timeLower, timeUpper, randLower, randUpper] = parts;
+        const randStr = randLower + randUpper;
+        const randbytes = Base32.toUint8Array(randStr);
+        const timeStr = timeLower + timeUpper;
+        const timearr = Base32.toUint8Array(timeStr);
+        if (randbytes.length !== 8 || timearr.length !== 8) {
+            throw new Error("Invalid timeId payload");
+        }
+        const timeview = new DataView(timearr.buffer, timearr.byteOffset, timearr.byteLength);
+        const timestamp = timeview.getBigUint64(0, false);
+        const date = new Date(Number(timestamp));
+        return { date, randbytes };
+    }
+    TimeId.parse = parse;
+})(TimeId || (TimeId = {}));
+//# sourceMappingURL=timeid.js.map

package/dist/timeid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeid.js","sourceRoot":"","sources":["../src/timeid.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -1,2 +1,83 @@
+import { Result } from "./result.js";
+/**
+ * Converts a union type to an intersection type.
+ * @template U The union type to be converted.
+ */
 export type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+/**
+ * Pads a given number with leading zeros to meet the specified length.
+ * @param {number} num The number to be padded.
+ * @param {number} [zeroLength=2] The desired total length of the resulting string. Defaults to 2.
+ * @returns {string} The padded string representation of the number.
+ */
+export declare function zeroPadding(num: number, length?: number): string;
+/**
+ * Safely parses a JSON string. Returns null if a parsing error occurs.
+ * @template T The expected type of the parsed data.
+ * @param {string | undefined | null} content The JSON string to parse.
+ * @returns {T | null} The parsed object, or null if parsing fails.
+ */
+export declare function parseJsonSafe<T = any>(content: string | undefined | null): T | null;
+/**
+ * Executes a promise and returns a boolean indicating success.
+ * Logs an error and returns false if the promise is rejected.
+ * @param {Promise<any>} promise The promise to execute.
+ * @returns {Promise<boolean>} True if the promise resolves successfully, false otherwise.
+ */
+export declare function AsOk(promise: Promise<any>): Promise<boolean>;
+/**
+ * Executes a promise and returns a wrapped result.
+ * @param {Promise<T>} promise The promise to execute.
+ * @returns {Promise<Result<T, Error>>} Result.ok(T) if the promise resolves successfully, Result.err(Error) otherwise.
+ */
+export declare function AsResult<T>(promise: Promise<T>): Promise<Result<T, Error>>;
+/**
+ * Executes a promise and returns its result, or null if an error occurs.
+ * Logs the error if the promise is rejected.
+ * @template T The expected return type of the promise.
+ * @param {Promise<T>} promise The promise to execute.
+ * @returns {Promise<T | null>} The result of the promise, or null if it fails.
+ */
+export declare function NullCatch<T>(promise: Promise<T>): Promise<T | null>;
+/**
+ * Returns an empty promise that resolves to undefined.
+ * @returns {Promise<undefined>}
+ */
+export declare function EmptyPromise(): Promise<undefined>;
+/**
+ * Returns an promise that resolves to input value.
+ * @param {T} input The input value
+ * @returns {Promise<T>}
+ */
+export declare function ValuePromise<T>(input: T): Promise<T>;
+/**
+ * Returns a promise that immediately rejects with the provided error.
+ * @param {Error} err The error to be thrown.
+ * @returns {Promise<any>}
+ */
+export declare function ErrorPromise(err: Error): Promise<any>;
+/**
+ * Represents a valid CSS class name or a falsy value to be ignored during the merge process.
+ */
+export type ClassNameType = string | undefined | false | null;
+/**
+ * Merges multiple class names and arrays of class names into a single space-separated string.
+ * Falsy values such as null, undefined, or false are automatically filtered out.
+ * This function handles single-level arrays but does not support deep nesting.
+ *
+ * @param {...(ClassNameType | ClassNameType[])} classNameList - A list of class names or arrays containing class names.
+ * @returns {string} A combined string of valid class names separated by a space.
+ */
+export declare function mergeClassName(...classNameList: (ClassNameType | ClassNameType[])[]): string;
+export declare const TIB_UNIT: number;
+export declare const GIB_UNIT: number;
+export declare const MIB_UNIT: number;
+export declare const KIB_UNIT: number;
+/**
+ * Formats a file size in bytes into a human-readable string using binary prefixes (IEC standard).
+ *
+ * @param {number} sizeBytes - The size of the file in bytes.
+ * @returns {string} The formatted file size string with its corresponding unit (e.g., "1.5GiB", "500B").
+ */
+export declare function formatFileSize(sizeBytes: number): string;
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CACnC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CACvC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,GAC1B,CAAC,GACD,KAAK,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CACnC,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,KAAK,CACvC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,IAAI,GAC1B,CAAC,GACD,KAAK,CAAC;AAEV;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAU,GAAG,MAAM,CAanE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,GAAG,EACnC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GACjC,CAAC,GAAG,IAAI,CAOV;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAOlE;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAE3B;AAED;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAKzE;AAED;;;GAGG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC,CAAG;AAE3D;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1D;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAE3D;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC;AAE9D;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,GAAG,aAAa,EAAE,CAAC,aAAa,GAAG,aAAa,EAAE,CAAC,EAAE,GACpD,MAAM,CAYR;AAED,eAAO,MAAM,QAAQ,QAAY,CAAC;AAClC,eAAO,MAAM,QAAQ,QAAY,CAAC;AAClC,eAAO,MAAM,QAAQ,QAAY,CAAC;AAClC,eAAO,MAAM,QAAQ,QAAY,CAAC;AAClC;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAWxD"}

package/dist/utils.js

@@ -1,2 +1,142 @@
-export {};
+import { logErr } from "./libLog.js";
+import { Result } from "./result.js";
+/**
+ * Pads a given number with leading zeros to meet the specified length.
+ * @param {number} num The number to be padded.
+ * @param {number} [zeroLength=2] The desired total length of the resulting string. Defaults to 2.
+ * @returns {string} The padded string representation of the number.
+ */
+export function zeroPadding(num, length = 2) {
+    const numStr = Math.abs(num).toString();
+    const sign = Math.sign(num);
+    let signStr;
+    if (sign == -1) {
+        signStr = "-";
+    }
+    else {
+        signStr = "";
+    }
+    const numLength = Math.max(length - signStr.length, 0);
+    return signStr + numStr.padStart(numLength, "0");
+}
+/**
+ * Safely parses a JSON string. Returns null if a parsing error occurs.
+ * @template T The expected type of the parsed data.
+ * @param {string | undefined | null} content The JSON string to parse.
+ * @returns {T | null} The parsed object, or null if parsing fails.
+ */
+export function parseJsonSafe(content) {
+    if (!content)
+        return null;
+    try {
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Executes a promise and returns a boolean indicating success.
+ * Logs an error and returns false if the promise is rejected.
+ * @param {Promise<any>} promise The promise to execute.
+ * @returns {Promise<boolean>} True if the promise resolves successfully, false otherwise.
+ */
+export async function AsOk(promise) {
+    return await promise
+        .then(() => true)
+        .catch((i) => {
+        logErr("Promise throw(catch in AsOk): " + i);
+        return false;
+    });
+}
+/**
+ * Executes a promise and returns a wrapped result.
+ * @param {Promise<T>} promise The promise to execute.
+ * @returns {Promise<Result<T, Error>>} Result.ok(T) if the promise resolves successfully, Result.err(Error) otherwise.
+ */
+export async function AsResult(promise) {
+    return await promise.then(Result.ok).catch(Result.err);
+}
+/**
+ * Executes a promise and returns its result, or null if an error occurs.
+ * Logs the error if the promise is rejected.
+ * @template T The expected return type of the promise.
+ * @param {Promise<T>} promise The promise to execute.
+ * @returns {Promise<T | null>} The result of the promise, or null if it fails.
+ */
+export async function NullCatch(promise) {
+    return await promise.catch((i) => {
+        logErr("Promise throw(catch in NullCatch): " + i);
+        return null;
+    });
+}
+/**
+ * Returns an empty promise that resolves to undefined.
+ * @returns {Promise<undefined>}
+ */
+export async function EmptyPromise() { }
+/**
+ * Returns an promise that resolves to input value.
+ * @param {T} input The input value
+ * @returns {Promise<T>}
+ */
+export async function ValuePromise(input) {
+    return input;
+}
+/**
+ * Returns a promise that immediately rejects with the provided error.
+ * @param {Error} err The error to be thrown.
+ * @returns {Promise<any>}
+ */
+export async function ErrorPromise(err) {
+    throw err;
+}
+/**
+ * Merges multiple class names and arrays of class names into a single space-separated string.
+ * Falsy values such as null, undefined, or false are automatically filtered out.
+ * This function handles single-level arrays but does not support deep nesting.
+ *
+ * @param {...(ClassNameType | ClassNameType[])} classNameList - A list of class names or arrays containing class names.
+ * @returns {string} A combined string of valid class names separated by a space.
+ */
+export function mergeClassName(...classNameList) {
+    const buffer = [];
+    for (const className of classNameList) {
+        if (Array.isArray(className)) {
+            for (const item of className) {
+                if (item)
+                    buffer.push(item);
+            }
+        }
+        else if (className && className.length) {
+            buffer.push(className);
+        }
+    }
+    return buffer.join(" ");
+}
+export const TIB_UNIT = 1024 ** 4;
+export const GIB_UNIT = 1024 ** 3;
+export const MIB_UNIT = 1024 ** 2;
+export const KIB_UNIT = 1024 ** 1;
+/**
+ * Formats a file size in bytes into a human-readable string using binary prefixes (IEC standard).
+ *
+ * @param {number} sizeBytes - The size of the file in bytes.
+ * @returns {string} The formatted file size string with its corresponding unit (e.g., "1.5GiB", "500B").
+ */
+export function formatFileSize(sizeBytes) {
+    if (sizeBytes >= TIB_UNIT) {
+        return `${(sizeBytes / TIB_UNIT).toFixed(1)}TiB`;
+    }
+    else if (sizeBytes >= GIB_UNIT) {
+        return `${(sizeBytes / GIB_UNIT).toFixed(1)}GiB`;
+    }
+    else if (sizeBytes >= MIB_UNIT) {
+        return `${(sizeBytes / MIB_UNIT).toFixed(1)}MiB`;
+    }
+    else if (sizeBytes >= KIB_UNIT) {
+        return `${(sizeBytes / KIB_UNIT).toFixed(1)}KiB`;
+    }
+    return `${sizeBytes}B`;
+}
 //# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":""}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwreey-js/ts-util",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Qwreey's typescript utilities",
   "keywords": [
     "typescript"
@@ -26,7 +26,8 @@
     "check:format": "npm run --prefix ../../ prettier -- --check packages/ts-util/src",
     "fix:format": "npm run --prefix ../../ prettier -- --write packages/ts-util/src",
     "init": "npm ci --include-workspace-root --include=dev",
-    "prepack": "npm run init && npm run check && npm run build"
+    "prepack": "npm run init && npm run check && npm run build",
+    "test": "../../node_modules/.bin/tsx src/test/index.ts"
   },
   "exports": {
     ".": {