@fluixi/utils 1.0.0-alpha.100

package/dist/lib/maths/types/operations.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Type-level mathematical operations that actually work.
+ * These use clever TypeScript tricks to perform type-level arithmetic.
+ * @module OperationTypes
+ */
+import { Integer, IsNegative } from "./basic.js";
+import { MakeNegative } from "./negative.js";
+/**
+ * Creates a tuple of length N.
+ * This is the foundation for all type-level arithmetic.
+ */
+type Tuple<N extends number, T = unknown, Acc extends T[] = []> = Acc['length'] extends N ? Acc : Tuple<N, T, [...Acc, T]>;
+/**
+ * Converts a number to a tuple length.
+ */
+type NumberToTuple<N extends number> = Tuple<N>;
+/**
+ * Converts a tuple to a number.
+ */
+type TupleToNumber<T extends unknown[]> = T['length'];
+/**
+ * Helper type to get the numeric value of a digit string.
+ */
+type Digit = '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9';
+/**
+ * Adds two numbers at the type level (works up to ~50).
+ */
+type _Add<A extends number, B extends number> = IsNegative<A> extends true ? IsNegative<B> extends true ? Add<Absolute<A>, Absolute<B>> : Compare<Absolute<A>, Absolute<B>> extends -1 ? Subtract<B, Absolute<A>> : Subtract<Absolute<A>, B> : TupleToNumber<[...Tuple<A>, ...Tuple<B>]> & number;
+/**
+ * Subtracts B from A at the type level (A - B).
+ */
+export type Subtract<A extends number, B extends number> = Tuple<A> extends [...Tuple<B>, ...infer R] ? TupleToNumber<R> : never;
+/**
+ * Multiplies two numbers at the type level.
+ */
+type _Multiply<A extends number, B extends number> = B extends 0 ? 0 : B extends 1 ? A : MultiplyRec<A, B, 0>;
+type MultiplyRec<A extends number, B extends number, Acc extends number> = B extends 0 ? Acc : MultiplyRec<A, Subtract<B, 1>, Add<Acc, A>>;
+/**
+ * Divides A by B at the type level (integer division).
+ */
+type _Divide<A extends number, B extends number> = B extends 0 ? never : DivideRec<A, B, 0>;
+type DivideRec<A extends number, B extends number, Q extends number> = A extends 0 ? Q : Subtract<A, B> extends never ? Q : DivideRec<Subtract<A, B>, B, Add<Q, 1>>;
+/**
+ * Modulo operation at the type level (A % B).
+ */
+export type Mod<A extends number, B extends number> = B extends 0 ? never : Subtract<A, Multiply<Divide<A, B>, B>>;
+export type Add<A extends number, B extends number> = IsNegative<A> extends true ? IsNegative<B> extends true ? MakeNegative<Add<Absolute<A>, Absolute<B>>> : Compare<Absolute<A>, Absolute<B>> extends 1 ? MakeNegative<Subtract<Absolute<A>, Absolute<B>>> : Subtract<Absolute<B>, Absolute<A>> : IsNegative<B> extends true ? Compare<A, Absolute<B>> extends 1 | 0 ? Subtract<A, Absolute<B>> : MakeNegative<Subtract<Absolute<B>, A>> : _Add<A, B>;
+/**
+ * Multiplies two numbers, handling signs correctly.
+ */
+export type Multiply<A extends number, B extends number> = (IsNegative<A> extends true ? -1 : 1) extends infer SignA ? (IsNegative<B> extends true ? -1 : 1) extends infer SignB ? SignA extends -1 ? SignB extends -1 ? _Multiply<Absolute<A>, Absolute<B>> : MakeNegative<_Multiply<Absolute<A>, Absolute<B>>> : SignB extends -1 ? MakeNegative<_Multiply<Absolute<A>, Absolute<B>>> : _Multiply<Absolute<A>, Absolute<B>> : never : never;
+/**
+ * Divides two numbers, handling signs correctly.
+ */
+export type Divide<A extends number, B extends number> = B extends 0 ? never : (IsNegative<A> extends true ? -1 : 1) extends infer SignA ? (IsNegative<B> extends true ? -1 : 1) extends infer SignB ? SignA extends -1 ? SignB extends -1 ? _Divide<Absolute<A>, Absolute<B>> : MakeNegative<_Divide<Absolute<A>, Absolute<B>>> : SignB extends -1 ? MakeNegative<_Divide<Absolute<A>, Absolute<B>>> : _Divide<Absolute<A>, Absolute<B>> : never : never;
+/**
+ * Compares two numbers at the type level.
+ * Returns -1 if A < B, 0 if A = B, 1 if A > B.
+ */
+export type Compare<A extends number, B extends number> = A extends B ? 0 : Absolute<A> extends A ? Absolute<B> extends B ? Tuple<A> extends [...Tuple<B>, ...any] ? 1 : -1 : 1 : Absolute<B> extends B ? -1 : never;
+/**
+ * Checks if A equals B at the type level.
+ */
+export type Equals<A extends number, B extends number> = A extends B ? (B extends A ? true : false) : false;
+/**
+ * Checks if A is less than B at the type level.
+ */
+export type LessThan<A extends number, B extends number> = Compare<A, B> extends -1 ? true : false;
+/**
+ * Checks if A is greater than B at the type level.
+ */
+export type GreaterThan<A extends number, B extends number> = Compare<A, B> extends 1 ? true : false;
+/**
+ * Checks if A is less than or equal to B at the type level.
+ */
+export type LessThanOrEqual<A extends number, B extends number> = Compare<A, B> extends -1 | 0 ? true : false;
+/**
+ * Checks if A is greater than or equal to B at the type level.
+ */
+export type GreaterThanOrEqual<A extends number, B extends number> = Compare<A, B> extends 1 | 0 ? true : false;
+/**
+ * Returns the minimum of two numbers at the type level.
+ */
+export type Min<A extends number, B extends number> = Compare<A, B> extends -1 | 0 ? A : B;
+/**
+ * Returns the maximum of two numbers at the type level.
+ */
+export type Max<A extends number, B extends number> = Compare<A, B> extends 1 | 0 ? A : B;
+/**
+ * Extracts the absolute value type from a number.
+ */
+export type Absolute<T extends number> = `${T}` extends `-${infer U extends number}` ? U : T;
+/**
+ * Represents a decimal number as a string for type manipulation.
+ */
+type DecimalString<N extends number> = `${N}` extends `${infer I}.${infer F}` ? [I, F] : [`${N}`, '0'];
+/**
+ * Rounds a number to the nearest integer at the type level.
+ * This works for numbers up to 2 decimal places.
+ */
+export type Round<T extends number> = DecimalString<T> extends [infer I extends string, infer F extends string] ? F extends Digit ? `${F}` extends `${'5' | '6' | '7' | '8' | '9'}` ? Add<ToNumber<I>, 1> : ToNumber<I> : ToNumber<I> : T;
+/**
+ * Helper to convert string to number.
+ */
+type ToNumber<S extends string> = S extends `${infer N extends number}` ? N : never;
+/**
+ * Rounds a number down to the nearest integer at the type level.
+ */
+export type Floor<T extends number> = DecimalString<T> extends [infer I extends string, any] ? ToNumber<I> : T;
+/**
+ * Rounds a number up to the nearest integer at the type level.
+ */
+export type Ceil<T extends number> = DecimalString<T> extends [infer I extends string, infer F extends string] ? F extends '0' ? ToNumber<I> : Add<ToNumber<I>, 1> : T;
+/**
+ * Truncates the decimal part of a number at the type level.
+ */
+export type Trunc<T extends number> = Floor<T>;
+/**
+ * Power operation at the type level (A^B).
+ */
+export type Power<Base extends number, Exponent extends number> = Exponent extends 0 ? 1 : Exponent extends 1 ? Base : PowerRec<Base, Exponent, 1>;
+type PowerRec<B extends number, E extends number, Acc extends number> = E extends 0 ? Acc : PowerRec<B, Subtract<E, 1>, Multiply<Acc, B>>;
+/**
+ * Factorial operation at the type level (n!).
+ * Works for n up to ~12 due to recursion limits.
+ */
+export type Factorial<N extends number> = N extends 0 ? 1 : N extends 1 ? 1 : Multiply<N, Factorial<Subtract<N, 1>>>;
+/**
+ * Clamps a value between min and max at the type level.
+ */
+export type Clamp<T extends number, MinVal extends number, MaxVal extends number> = Min<Max<T, MinVal>, MaxVal>;
+/**
+ * Creates a range of numbers from Start to End (inclusive) at the type level.
+ */
+export type Range<Start extends number, End extends number> = BuildRange<Start, End, []>;
+type BuildRange<S extends number, E extends number, Acc extends number[]> = GreaterThan<S, E> extends true ? Acc : BuildRange<Add<S, 1>, E, [...Acc, S]>;
+/**
+ * Increments a number by 1 at the type level.
+ */
+export type Increment<T extends number> = Add<T, 1>;
+/**
+ * Decrements a number by 1 at the type level.
+ */
+export type Decrement<T extends number> = Subtract<T, 1>;
+/**
+ * Checks if a number is even at the type level.
+ */
+export type IsEven<T extends number> = Mod<T, 2> extends 0 ? true : false;
+/**
+ * Checks if a number is odd at the type level.
+ */
+export type IsOdd<T extends number> = Mod<T, 2> extends 1 ? true : false;
+/**
+ * Checks if A is divisible by B at the type level.
+ */
+export type IsDivisible<A extends number, B extends number> = B extends 0 ? false : Mod<A, B> extends 0 ? true : false;
+/**
+ * Asserts that a type condition is true.
+ * Useful for writing type tests.
+ */
+export type AssertTrue<T extends true> = T;
+/**
+ * Asserts that two types are equal.
+ */
+export type AssertEqual<A, B> = (<T>() => T extends A ? 1 : 2) extends (<T>() => T extends B ? 1 : 2) ? true : false;
+export type { Tuple, NumberToTuple, TupleToNumber };
+/**
+ * Represents an even integer.
+ */
+export type Even<T extends number> = T extends Integer ? `${T}` extends `${infer N extends number}` ? Mod<Absolute<N>, 2> extends 0 ? T : never : never : never;
+/**
+ * Represents an odd integer.
+ */
+export type Odd<T extends number> = T extends Integer ? `${T}` extends `${infer N extends number}` ? Mod<Absolute<N>, 2> extends 1 ? T : never : never : never;
+/**
+ * Extracts the sign of a number as a type.
+ * Returns -1, 0, or 1 as a numeric literal type.
+ */
+export type SignOf<T extends number> = T extends 0 ? 0 : `${T}` extends `-${string}` ? -1 : 1;
+/**
+ * Type-level subtraction that always returns a negative or zero result.
+ */
+export type SubtractToNegative<A extends number, B extends number> = Compare<A, B> extends 1 | 0 ? MakeNegative<Subtract<A, B>> : Subtract<A, B>;
+/**
+ * Returns the negative absolute value (always returns a negative number or zero).
+ */
+export type NegativeAbsolute<T extends number> = T extends 0 ? 0 : `-${Absolute<T>}` extends `${infer N extends number}` ? N : never;
+//# sourceMappingURL=operations.d.ts.map

package/dist/lib/maths/types/operations.d.ts.map

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

package/dist/lib/maths/types/operations.js

@@ -0,0 +1,6 @@
+/**
+ * Type-level mathematical operations that actually work.
+ * These use clever TypeScript tricks to perform type-level arithmetic.
+ * @module OperationTypes
+ */
+export {};

package/dist/lib/object/clone.cjs

@@ -0,0 +1,88 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/object/clone.ts
+var clone_exports = {};
+__export(clone_exports, {
+  deepClone: () => deepClone
+});
+module.exports = __toCommonJS(clone_exports);
+
+// src/lib/object/utils.ts
+var isObject = (value) => {
+  if (value == null) return false;
+  if (Array.isArray(value)) return false;
+  if (typeof value === "function") return false;
+  if (value instanceof Date) return false;
+  if (value instanceof RegExp) return false;
+  if (value instanceof Map) return false;
+  if (value instanceof Set) return false;
+  if (value instanceof Error) return false;
+  return typeof value === "object";
+};
+
+// src/lib/object/clone.ts
+var deepClone = (obj, skipKeys) => {
+  if (obj == null || typeof obj !== "object") {
+    return obj;
+  }
+  if (obj instanceof Date) {
+    return new Date(obj.getTime());
+  }
+  if (obj instanceof RegExp) {
+    return new RegExp(obj.source, obj.flags);
+  }
+  if (obj instanceof Map) {
+    const clone = /* @__PURE__ */ new Map();
+    obj.forEach((value, key) => {
+      if (!skipKeys || !skipKeys.some((k) => k.toString() === key.toString())) {
+        clone.set(key, deepClone(value));
+      }
+    });
+    return clone;
+  }
+  if (obj instanceof Set) {
+    const clone = /* @__PURE__ */ new Set();
+    obj.forEach((value) => {
+      clone.add(deepClone(value));
+    });
+    return clone;
+  }
+  if (Array.isArray(obj)) {
+    return Array.from(obj).map((item) => deepClone(item));
+  }
+  if (isObject(obj)) {
+    const clone = {};
+    for (const key in obj) {
+      if (Object.prototype.hasOwnProperty.call(obj, key)) {
+        if (!skipKeys || !skipKeys.some((k) => k.toString() === key.toString())) {
+          clone[key] = deepClone(obj[key]);
+        }
+      }
+    }
+    const symbols = Object.getOwnPropertySymbols(obj);
+    for (const symbol of symbols) {
+      if (!skipKeys || !skipKeys.some((s) => s.toString() === symbol.toString())) {
+        clone[symbol] = deepClone(obj[symbol]);
+      }
+    }
+    return clone;
+  }
+  return obj;
+};

package/dist/lib/object/clone.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Creates a deep clone of a value (object, array, primitive, or built-in types)
+ *
+ * This function creates a complete copy of the input value, including all nested
+ * properties, without maintaining any references to the original object. It properly
+ * handles various JavaScript built-in types including:
+ *
+ * - Primitive values (strings, numbers, booleans)
+ * - Plain objects
+ * - Arrays
+ * - Dates
+ * - RegExp
+ * - Maps
+ * - Sets
+ * - Symbols as object keys
+ *
+ * @template T - The type of the value being cloned
+ * @param obj - The value to clone
+ * @returns A deep copy of the input value with the same type
+ *
+ * @example
+ * // Cloning a nested object
+ * const obj = { a: 1, b: { c: 2 } };
+ * const clone = deepClone(obj);
+ * obj.b.c = 3;
+ * console.log(clone.b.c); // 2 (remains unchanged)
+ *
+ * @example
+ * // Cloning an array with objects
+ * const arr = [1, 2, { a: 3 }];
+ * const cloneArr = deepClone(arr);
+ * arr[2].a = 4;
+ * console.log(cloneArr[2].a); // 3 (remains unchanged)
+ *
+ * @example
+ * // Cloning built-in types
+ * const date = new Date();
+ * const map = new Map([['key', 'value']]);
+ * const set = new Set([1, 2, 3]);
+ *
+ * const dateClone = deepClone(date); // independent Date instance
+ * const mapClone = deepClone(map);   // independent Map instance
+ * const setClone = deepClone(set);   // independent Set instance
+ */
+export declare const deepClone: <T>(obj: T, skipKeys?: (string | symbol)[]) => T;
+//# sourceMappingURL=clone.d.ts.map

package/dist/lib/object/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../../src/lib/object/clone.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,eAAO,MAAM,SAAS,GAAI,CAAC,EAAE,KAAK,CAAC,EAAE,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KAAG,CAwErE,CAAC"}

package/dist/lib/object/clone.js

@@ -0,0 +1,104 @@
+import { isObject } from './utils.js';
+/**
+ * Creates a deep clone of a value (object, array, primitive, or built-in types)
+ *
+ * This function creates a complete copy of the input value, including all nested
+ * properties, without maintaining any references to the original object. It properly
+ * handles various JavaScript built-in types including:
+ *
+ * - Primitive values (strings, numbers, booleans)
+ * - Plain objects
+ * - Arrays
+ * - Dates
+ * - RegExp
+ * - Maps
+ * - Sets
+ * - Symbols as object keys
+ *
+ * @template T - The type of the value being cloned
+ * @param obj - The value to clone
+ * @returns A deep copy of the input value with the same type
+ *
+ * @example
+ * // Cloning a nested object
+ * const obj = { a: 1, b: { c: 2 } };
+ * const clone = deepClone(obj);
+ * obj.b.c = 3;
+ * console.log(clone.b.c); // 2 (remains unchanged)
+ *
+ * @example
+ * // Cloning an array with objects
+ * const arr = [1, 2, { a: 3 }];
+ * const cloneArr = deepClone(arr);
+ * arr[2].a = 4;
+ * console.log(cloneArr[2].a); // 3 (remains unchanged)
+ *
+ * @example
+ * // Cloning built-in types
+ * const date = new Date();
+ * const map = new Map([['key', 'value']]);
+ * const set = new Set([1, 2, 3]);
+ *
+ * const dateClone = deepClone(date); // independent Date instance
+ * const mapClone = deepClone(map);   // independent Map instance
+ * const setClone = deepClone(set);   // independent Set instance
+ */
+export const deepClone = (obj, skipKeys) => {
+    // Handle primitives
+    if (obj == null || typeof obj !== 'object') {
+        return obj;
+    }
+    // Handle Date
+    if (obj instanceof Date) {
+        return new Date(obj.getTime());
+    }
+    // Handle RegExp
+    if (obj instanceof RegExp) {
+        return new RegExp(obj.source, obj.flags);
+    }
+    // Handle Map
+    if (obj instanceof Map) {
+        const clone = new Map();
+        obj.forEach((value, key) => {
+            if (!skipKeys || !skipKeys.some((k) => k.toString() === key.toString())) {
+                clone.set(key, deepClone(value));
+            }
+        });
+        return clone;
+    }
+    // Handle Set
+    if (obj instanceof Set) {
+        const clone = new Set();
+        obj.forEach((value) => {
+            clone.add(deepClone(value));
+        });
+        return clone;
+    }
+    // Handle Array
+    if (Array.isArray(obj)) {
+        return Array.from(obj).map((item) => deepClone(item));
+    }
+    // Handle plain object
+    if (isObject(obj)) {
+        const clone = {};
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                if (!skipKeys ||
+                    !skipKeys.some((k) => k.toString() === key.toString())) {
+                    clone[key] = deepClone(obj[key]);
+                }
+            }
+        }
+        // Handle symbols
+        const symbols = Object.getOwnPropertySymbols(obj);
+        for (const symbol of symbols) {
+            if (!skipKeys ||
+                !skipKeys.some((s) => s.toString() === symbol.toString())) {
+                clone[symbol] = deepClone(obj[symbol]);
+            }
+        }
+        return clone;
+    }
+    // Fallback for other object types
+    return obj;
+};

package/dist/lib/object/clone.mjs

@@ -0,0 +1,65 @@
+// src/lib/object/utils.ts
+var isObject = (value) => {
+  if (value == null) return false;
+  if (Array.isArray(value)) return false;
+  if (typeof value === "function") return false;
+  if (value instanceof Date) return false;
+  if (value instanceof RegExp) return false;
+  if (value instanceof Map) return false;
+  if (value instanceof Set) return false;
+  if (value instanceof Error) return false;
+  return typeof value === "object";
+};
+
+// src/lib/object/clone.ts
+var deepClone = (obj, skipKeys) => {
+  if (obj == null || typeof obj !== "object") {
+    return obj;
+  }
+  if (obj instanceof Date) {
+    return new Date(obj.getTime());
+  }
+  if (obj instanceof RegExp) {
+    return new RegExp(obj.source, obj.flags);
+  }
+  if (obj instanceof Map) {
+    const clone = /* @__PURE__ */ new Map();
+    obj.forEach((value, key) => {
+      if (!skipKeys || !skipKeys.some((k) => k.toString() === key.toString())) {
+        clone.set(key, deepClone(value));
+      }
+    });
+    return clone;
+  }
+  if (obj instanceof Set) {
+    const clone = /* @__PURE__ */ new Set();
+    obj.forEach((value) => {
+      clone.add(deepClone(value));
+    });
+    return clone;
+  }
+  if (Array.isArray(obj)) {
+    return Array.from(obj).map((item) => deepClone(item));
+  }
+  if (isObject(obj)) {
+    const clone = {};
+    for (const key in obj) {
+      if (Object.prototype.hasOwnProperty.call(obj, key)) {
+        if (!skipKeys || !skipKeys.some((k) => k.toString() === key.toString())) {
+          clone[key] = deepClone(obj[key]);
+        }
+      }
+    }
+    const symbols = Object.getOwnPropertySymbols(obj);
+    for (const symbol of symbols) {
+      if (!skipKeys || !skipKeys.some((s) => s.toString() === symbol.toString())) {
+        clone[symbol] = deepClone(obj[symbol]);
+      }
+    }
+    return clone;
+  }
+  return obj;
+};
+export {
+  deepClone
+};