@zelgadis87/utils-core 5.2.12 → 5.3.1

package/dist/utils/arrays.d.ts

@@ -1,71 +0,0 @@
-import { type TOptional } from "../Optional.js";
-import type { TComparisonFunction } from "../sorting/_index.js";
-import type { TAccumulator, TBiPredicate, TPredicate, TTransformer } from "./functions.js";
-import { type TMaybe } from "./nulls.js";
-export * from './arrays/groupBy.js';
-export * from './arrays/indexBy.js';
-export * from './arrays/statistics.js';
-export * from './arrays/uniqBy.js';
-export type TReadableArray<T> = Array<T> | ReadonlyArray<T>;
-export type TArrayable<T> = T | T[];
-export type TEmptyArray = [];
-export declare function ensureArray<const T>(t: T | Array<T> | null | undefined): Array<T>;
-export declare function ensureReadableArray<const T>(t: T | Array<T> | ReadonlyArray<T> | null | undefined): TReadableArray<T>;
-export declare function isArray<const T>(t: unknown): t is Array<T>;
-/**
- * Generate a new copy of an array with:
- * - the first instance of an item matching the predicate being replaced with the given argument
- * - the given argument added as last item of the array if the predicate did not produce a match
- * @param arr - the original array of items
- * @param item - the item to insert or update
- * @param predicate - a function that returns true iff an item is equal to the given argument
- * @returns a new copy of the array with the item updated or added in last place
- */
-export declare function upsert<T>(arr: ReadonlyArray<T>, item: T, isEqual: TBiPredicate<T>): Array<T>;
-export declare function range(start: number, end: number): Array<number>;
-export declare function fill<T>(length: number, value: T): Array<T>;
-export declare function extendArray<T extends Record<string | number | symbol, unknown>, X extends Record<string | number | symbol, unknown>>(arr: TReadableArray<T>, props: X): Array<(T & X)>;
-export declare function extendArrayWith<T extends Record<string | number | symbol, unknown>, X extends Record<string | number | symbol, unknown>>(arr: TReadableArray<T>, propsFn: (t: T) => X): Array<(T & X)>;
-export declare function reverse<T>(arr: TReadableArray<T>): Array<T>;
-export declare function first<T>(arr: TReadableArray<T>, defaultValue?: TMaybe<T>): TMaybe<T>;
-export declare function last<T>(arr: TReadableArray<T>, defaultValue?: TMaybe<T>): TMaybe<T>;
-export declare const head: typeof first;
-export declare function tail<T>(arr: TReadableArray<T>): T[];
-export declare function sortedArray<T>(arr: Array<T>, sortFn?: TComparisonFunction<T> | undefined): Array<T>;
-export declare function sortedArray<T>(arr: ReadonlyArray<T>, sortFn?: TComparisonFunction<T> | undefined): ReadonlyArray<T>;
-/**
- * Custom implementation of includes which allows checking for arbitrary items inside the array.
- */
-export declare function includes<T>(arr: TReadableArray<T>, item: unknown, fromIndex?: number): boolean;
-export declare function mapTruthys<T, R>(arr: Array<T>, mapper: (value: T, index: number, array: T[]) => R | undefined): Array<R>;
-export declare function flatMapTruthys<T, R>(arr: Array<T>, mapper: (value: T, index: number, array: T[]) => R | undefined): Array<R>;
-export declare function filterMap<T, R>(array: T[], filterFn: TPredicate<T>, mapFn: TTransformer<T, R>): R[];
-export declare function filterMapReduce<T, U, R>(array: T[], filterFn: TPredicate<T>, mapFn: TTransformer<T, U>, reduceFn: TAccumulator<R, U>, initialValue: R): R;
-/**
- * Partitions the given array in two groups, in the first one there will be any and only values of the array that match the given predicate, in the second one there will be any and only values that don't.
- * @param arr the array of items
- * @param predicate the predicate to use to partition the array
- * @returns a tuple, where the first array contains items matching the predicate, and the second array contains items not matching the predicate.
- */
-export declare function partition<T>(arr: T[], predicate: TPredicate<T>): [T[], T[]];
-/**
- * Maps the first truthy value in the array using the provided mapping function.
- * @param arr - The array of items.
- * @param mapFn - The mapping function.
- * @returns The first truthy value returned by the mapping function, or null if no truthy value is found.
- */
-export declare function mapFirstTruthy<T, R>(arr: T[], mapFn: TTransformer<T, R>): R | null;
-export declare function listToDict<T, K extends string, V>(arr: T[], mapFn: TTransformer<T, [K, V]>): Record<K, V>;
-export declare function shallowArrayEquals(a: unknown[], b: unknown[]): boolean;
-export declare function findInArray<T>(arr: T[], predicate: TPredicate<T>): TOptional<T>;
-export declare function findIndexInArray<T>(arr: T[], predicate: TPredicate<T>): TOptional<number>;
-export declare function zip<T, R>(ts: T[], rs: R[]): [T, R][];
-export declare function unzip<T, R>(arr: [T, R][]): [T[], R[]];
-/**
- * Gets the element at the specified index in the array, wrapped in an Optional.
- * Returns an empty Optional if the index is out of bounds (negative or >= array length).
- * @param arr - The array to get the element from
- * @param index - The index of the element to retrieve
- * @returns An Optional containing the element at the index, or empty if index is out of bounds
- */
-export declare function arrayGet<T>(arr: TReadableArray<T>, index: number): import("../Optional.js").TEmptyOptional<T> | import("../Optional.js").TPresentOptional<T>;

package/dist/utils/booleans.d.ts

@@ -1,2 +0,0 @@
-export declare function isTrue(x: unknown): x is true;
-export declare function isFalse(x: unknown): x is false;

package/dist/utils/css.d.ts

@@ -1,14 +0,0 @@
-import { type TProducer } from "./_index.ts";
-import { type TKeysOfType } from "./records.ts";
-export type TCssRuleDeclarationKey = TKeysOfType<CSSStyleDeclaration, string> & string;
-export type TCssVariableDeclarationKey = `--${string}`;
-export type TCssGenericDeclarationKey = TCssRuleDeclarationKey | TCssVariableDeclarationKey;
-export type TCssDeclarationRulesDictionary = Partial<Record<TCssGenericDeclarationKey, string>>;
-export type TCssSelectorDeclarationRulesDictionary = {
-    [selector: string]: TCssDeclarationRulesDictionary | TCssSelectorDeclarationRulesDictionary;
-};
-export declare function cssDeclarationRulesDictionaryToCss(syleDeclarationRulesForSelectorsProduceable: TProduceable<TCssSelectorDeclarationRulesDictionary>, indent?: number): string;
-export declare function cssSelectorDeclarationRulesDictionaryToCss(styleDeclarationRules: TCssDeclarationRulesDictionary | TCssSelectorDeclarationRulesDictionary, indent?: number): string[];
-export declare function transformCssDictionary(dict: TCssSelectorDeclarationRulesDictionary, transformer: (key: TCssGenericDeclarationKey, value: string) => string): TCssSelectorDeclarationRulesDictionary;
-type TProduceable<T> = T | TProducer<T>;
-export {};

package/dist/utils/empties.d.ts

@@ -1,18 +0,0 @@
-/**
- * Define a new type that is true if T is the empty object, false otherwise.
- */
-export type TIsEmptyObject<T> = keyof T extends never ? true : false;
-/**
- * Defines a new type that is the empty array, if T is an empty object, or is the array containing T if T is not the empty object.<br/>
- * This type can be used as function argument, to conditionally require an argument based on type T.<br/>
- * Usage example:
- * ```
- * type TMetadata = { a: {}, b: {}, c: { x: 1 } };
- * function foo<X extends keyof TMetadata>( type: X, metadata: TMetadata[X] ) { ... };
- * export function fooWrapper<X extends keyof TMetadata>( type: X, ...args: TConditionalOptionalType<TMetadata[X]> ) {
- * 	const bar = foo( type, args.length === 0 ? void 0 : args[ 0 ] );
- * }
- * ```
- */
-export type TConditionalOptionalType<T> = TIsEmptyObject<T> extends true ? [] : [T];
-export type TEmptyObject = Record<string, never>;

package/dist/utils/errors/withTryCatch.d.ts

@@ -1,4 +0,0 @@
-import { type TFunction, type TTransformer } from "../functions.js";
-import type { TAsyncOperationTuple, TOperationTuple } from "../operations.js";
-export declare function withTryCatch<R>(fn: TFunction<void, R>, errMapFn?: TTransformer<Error, Error>): TOperationTuple<R, Error>;
-export declare function withTryCatchAsync<R>(fn: TFunction<void, Promise<R>>, errMapFn?: TTransformer<Error, Error>): TAsyncOperationTuple<R, Error>;

package/dist/utils/errors.d.ts

@@ -1,20 +0,0 @@
-export * from './errors/withTryCatch.js';
-export declare function asError(e: unknown): Error;
-export declare function isError(e: unknown): e is Error;
-export declare function getMessageFromError(error: Error): string;
-export declare function getStackFromError(error: Error): string;
-export declare function getCauseMessageFromError(error: Error): string;
-export declare function getCauseStackFromError(error: Error): string;
-/**
- * Throws an error if a switch discriminated union type does not cover all the expected cases.
- * Expected usage: `
- * switch ( x.type ) {
- *   case "x": return doX();
- *   case "y": return doY();
- *   ...
- *   default: throw new NonExhaustiveSwitchError( x satisfies never );
- * }`
- */
-export declare class NonExhaustiveSwitchError extends Error {
-    constructor(value: unknown);
-}

package/dist/utils/functions/_index.d.ts

@@ -1,3 +0,0 @@
-export * from './constant.js';
-export * from './iff.js';
-export * from './predicateBuilder.js';

package/dist/utils/functions/constant.d.ts

@@ -1,11 +0,0 @@
-export declare function constant<T>(v: T): () => T;
-export declare function identity<T>(t: T): T;
-export default constant;
-export declare const constantNull: () => null;
-export declare const constantTrue: () => boolean;
-export declare const constantFalse: () => boolean;
-export declare const constantUndefined: () => undefined;
-export declare const alwaysTrue: () => boolean;
-export declare const alwaysFalse: () => boolean;
-export declare const constantZero: () => number;
-export declare const constantOne: () => number;

package/dist/utils/functions/iff.d.ts

@@ -1,8 +0,0 @@
-import { TPredicate } from "../_index";
-type TBooleanOrPredicate = boolean | TPredicate<void>;
-type TIff<T> = {
-    elseIf<R>(pred: TBooleanOrPredicate, valueIfTrue: R): TIff<T | R>;
-    otherwise<R>(valueIfElse: R): T | R;
-};
-export declare function iff<T>(firstPredicate: TBooleanOrPredicate, valueIfTrue: T): TIff<T>;
-export default iff;

package/dist/utils/functions/predicateBuilder.d.ts

@@ -1,7 +0,0 @@
-import { type TPredicate } from "../functions.ts";
-export declare class PredicateBuilder<T> {
-    private _currentPredicate;
-    and(predicate: TPredicate<T>): this;
-    or(predicate: TPredicate<T>): this;
-    toPredicate(): TPredicate<T>;
-}

package/dist/utils/functions.d.ts

@@ -1,41 +0,0 @@
-export * from './functions/_index.js';
-export type TFunction<A, R> = (a: A) => R;
-export type TTransformer<A, R> = TFunction<A, R>;
-export type TVoidFunction = TFunction<void, void>;
-export type TProducer<R> = TFunction<void, R>;
-export type TConsumer<T> = TFunction<T, void>;
-export type TPredicate<T> = TFunction<T, boolean>;
-export type TTypePredicate<T, R extends T> = (t: T) => t is R;
-export type TIdentityFunction<T> = TFunction<T, T>;
-export type TBiFunction<A, B, R> = (a: A, b: B) => R;
-export type TBiConsumer<A, B> = TBiFunction<A, B, void>;
-export type TBiPredicate<T> = TBiFunction<T, T, boolean>;
-export type TAccumulator<A, B> = TBiFunction<A, B, A>;
-export type TAsyncFunction<A, R> = TFunction<A, Promise<R>>;
-export type TAsyncVoidFunction = TAsyncFunction<void, void>;
-export type TAsyncProducer<R> = TAsyncFunction<void, R>;
-export type TAsyncConsumer<T> = TAsyncFunction<T, void>;
-export type TAsyncPredicate<T> = TAsyncFunction<T, boolean>;
-export type TAsyncBiFunction<A, B, R> = TBiFunction<A, B, Promise<R>>;
-export type TAsyncBiConsumer<A, B> = TAsyncBiFunction<A, B, void>;
-export type TAsyncBiPredicate<T> = TAsyncBiFunction<T, T, boolean>;
-export type TAnyFunction<R> = (...args: unknown[]) => R;
-export type TAsyncAnyFunction<R> = (...args: unknown[]) => Promise<R>;
-export declare function isFunction(t: unknown): t is Function;
-export declare function noop(): void;
-export declare function filterWithTypePredicate<T, R extends T>(filter: TPredicate<T>): TTypePredicate<T, R>;
-export declare function not<T>(predicate: TPredicate<T>): TPredicate<T>;
-export declare function and<T>(a: TPredicate<T>, b: TPredicate<T>): TPredicate<T>;
-export declare function or<T>(a: TPredicate<T>, b: TPredicate<T>): TPredicate<T>;
-export declare function xor<T>(a: TPredicate<T>, b: TPredicate<T>): TPredicate<T>;
-export declare function pipedInvoke<T, A>(op1: TFunction<T, A>): TFunction<T, A>;
-export declare function pipedInvoke<T, A, B>(op1: TFunction<T, A>, op2: TFunction<A, B>): TFunction<T, B>;
-export declare function pipedInvoke<T, A, B, C>(op1: TFunction<T, A>, op2: TFunction<A, B>, op3: TFunction<B, C>): TFunction<T, C>;
-export declare function pipedInvoke<T, A, B, C, D>(op1: TFunction<T, A>, op2: TFunction<A, B>, op3: TFunction<B, C>, op4: TFunction<C, D>): TFunction<T, D>;
-export declare function pipedInvoke<T, A, B, C, D, E>(op1: TFunction<T, A>, op2: TFunction<A, B>, op3: TFunction<B, C>, op4: TFunction<C, D>, op5: TFunction<D, E>): TFunction<T, E>;
-export declare function pipedInvoke<T, A, B, C, D, E, F>(op1: TFunction<T, A>, op2: TFunction<A, B>, op3: TFunction<B, C>, op4: TFunction<C, D>, op5: TFunction<D, E>, op6: TFunction<E, F>): TFunction<T, F>;
-export declare function pipedInvoke<T, A, B, C, D, E, F, G>(op1: TFunction<T, A>, op2: TFunction<A, B>, op3: TFunction<B, C>, op4: TFunction<C, D>, op5: TFunction<D, E>, op6: TFunction<E, F>, op7: TFunction<F, G>): TFunction<T, G>;
-export declare function pipedInvoke<T, A, B, C, D, E, F, G, H>(op1: TFunction<T, A>, op2: TFunction<A, B>, op3: TFunction<B, C>, op4: TFunction<C, D>, op5: TFunction<D, E>, op6: TFunction<E, F>, op7: TFunction<F, G>, op8: TFunction<G, H>): TFunction<T, H>;
-export declare function pipedInvoke<T, A, B, C, D, E, F, G, H, I>(op1: TFunction<T, A>, op2: TFunction<A, B>, op3: TFunction<B, C>, op4: TFunction<C, D>, op5: TFunction<D, E>, op6: TFunction<E, F>, op7: TFunction<F, G>, op8: TFunction<G, H>, op9: TFunction<H, I>): TFunction<T, I>;
-export declare function pipedInvoke<T, A, B, C, D, E, F, G, H, I>(op1: TFunction<T, A>, op2: TFunction<A, B>, op3: TFunction<B, C>, op4: TFunction<C, D>, op5: TFunction<D, E>, op6: TFunction<E, F>, op7: TFunction<F, G>, op8: TFunction<G, H>, op9: TFunction<H, I>, ...operations: TFunction<any, any>[]): TFunction<T, unknown>;
-export declare function pipedInvokeFromArray<T, R>(fns: Array<TFunction<any, any>>): TFunction<any, any>;

package/dist/utils/json.d.ts

@@ -1,11 +0,0 @@
-export type TJsonPrimitive = string | number | boolean | null | undefined;
-export type TJsonArray = Array<TJsonSerializable> | ReadonlyArray<TJsonSerializable>;
-export type TJsonObject = {
-    [key: string]: TJsonSerializable;
-};
-export type TJsonSerializable = TJsonPrimitive | TJsonArray | TJsonObject;
-export declare function tryToParseJson<T extends TJsonSerializable>(jsonContent: string): [T, undefined] | [undefined, Error];
-export declare function parseJson<T extends TJsonSerializable>(jsonContent: string): T;
-export declare function stringifyJson(jsonSerializable: TJsonSerializable, minify?: boolean): string;
-export declare function jsonCloneDeep<A extends TJsonSerializable>(a: A): A;
-export declare function omitFromJsonObject<T extends TJsonObject, K extends keyof T>(o: T, ...keys: K[]): Omit<T, K>;

package/dist/utils/nulls.d.ts

@@ -1,9 +0,0 @@
-import { TConsumer, TFunction, TProducer, TVoidFunction } from "./functions.js";
-export type TMaybe<T> = T | null;
-export declare function ensureDefined<T>(v: T, name?: string): T;
-export declare function isDefined<T>(x: T | null | undefined): x is T;
-export declare function isNullOrUndefined(x: unknown): x is null | undefined;
-export declare function ifDefined<R>(source: TMaybe<R>, callback: TConsumer<R>): void;
-export declare function mapDefined<R, S>(source: TMaybe<R>, mapper: TFunction<R, S>): TMaybe<S>;
-export declare function ifNullOrUndefined(source: TMaybe<unknown>, callback: TVoidFunction): void;
-export declare function throwIfNullOrUndefined(source: TMaybe<unknown>, errorProducer?: TProducer<Error>): void;

package/dist/utils/numbers/round.d.ts

@@ -1,8 +0,0 @@
-type TRoundMode = 'toNearest' | 'toLower' | 'toUpper' | 'towardsZero' | 'awayFromZero';
-export declare function round(n: number, precision?: number, mode?: TRoundMode): number;
-export default round;
-export declare const roundToNearest: (n: number, precision?: number) => number;
-export declare const roundToLower: (n: number, precision?: number) => number;
-export declare const roundToUpper: (n: number, precision?: number) => number;
-export declare const roundTowardsZero: (n: number, precision?: number) => number;
-export declare const roundAwayFromZero: (n: number, precision?: number) => number;

package/dist/utils/numbers.d.ts

@@ -1,35 +0,0 @@
-import type { TFunction } from "./functions.js";
-export * from './numbers/round.js';
-export type TNumericString = `${number}`;
-export type TNumericFloatingPointString = `${number}.${number}`;
-export type TPositiveNumber = number;
-export type TNegativeNumber = number;
-export type TZero = 0;
-export type TDigit = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
-export type TDigit1_9 = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
-export type TNumber0_100 = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100;
-export type TNumber0_1000 = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100 | 101 | 102 | 103 | 104 | 105 | 106 | 107 | 108 | 109 | 110 | 111 | 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | 121 | 122 | 123 | 124 | 125 | 126 | 127 | 128 | 129 | 130 | 131 | 132 | 133 | 134 | 135 | 136 | 137 | 138 | 139 | 140 | 141 | 142 | 143 | 144 | 145 | 146 | 147 | 148 | 149 | 150 | 151 | 152 | 153 | 154 | 155 | 156 | 157 | 158 | 159 | 160 | 161 | 162 | 163 | 164 | 165 | 166 | 167 | 168 | 169 | 170 | 171 | 172 | 173 | 174 | 175 | 176 | 177 | 178 | 179 | 180 | 181 | 182 | 183 | 184 | 185 | 186 | 187 | 188 | 189 | 190 | 191 | 192 | 193 | 194 | 195 | 196 | 197 | 198 | 199 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 209 | 210 | 211 | 212 | 213 | 214 | 215 | 216 | 217 | 218 | 219 | 220 | 221 | 222 | 223 | 224 | 225 | 226 | 227 | 228 | 229 | 230 | 231 | 232 | 233 | 234 | 235 | 236 | 237 | 238 | 239 | 240 | 241 | 242 | 243 | 244 | 245 | 246 | 247 | 248 | 249 | 250 | 251 | 252 | 253 | 254 | 255 | 256 | 257 | 258 | 259 | 260 | 261 | 262 | 263 | 264 | 265 | 266 | 267 | 268 | 269 | 270 | 271 | 272 | 273 | 274 | 275 | 276 | 277 | 278 | 279 | 280 | 281 | 282 | 283 | 284 | 285 | 286 | 287 | 288 | 289 | 290 | 291 | 292 | 293 | 294 | 295 | 296 | 297 | 298 | 299 | 300 | 301 | 302 | 303 | 304 | 305 | 306 | 307 | 308 | 309 | 310 | 311 | 312 | 313 | 314 | 315 | 316 | 317 | 318 | 319 | 320 | 321 | 322 | 323 | 324 | 325 | 326 | 327 | 328 | 329 | 330 | 331 | 332 | 333 | 334 | 335 | 336 | 337 | 338 | 339 | 340 | 341 | 342 | 343 | 344 | 345 | 346 | 347 | 348 | 349 | 350 | 351 | 352 | 353 | 354 | 355 | 356 | 357 | 358 | 359 | 360 | 361 | 362 | 363 | 364 | 365 | 366 | 367 | 368 | 369 | 370 | 371 | 372 | 373 | 374 | 375 | 376 | 377 | 378 | 379 | 380 | 381 | 382 | 383 | 384 | 385 | 386 | 387 | 388 | 389 | 390 | 391 | 392 | 393 | 394 | 395 | 396 | 397 | 398 | 399 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 419 | 420 | 421 | 422 | 423 | 424 | 425 | 426 | 427 | 428 | 429 | 430 | 431 | 432 | 433 | 434 | 435 | 436 | 437 | 438 | 439 | 440 | 441 | 442 | 443 | 444 | 445 | 446 | 447 | 448 | 449 | 450 | 451 | 452 | 453 | 454 | 455 | 456 | 457 | 458 | 459 | 460 | 461 | 462 | 463 | 464 | 465 | 466 | 467 | 468 | 469 | 470 | 471 | 472 | 473 | 474 | 475 | 476 | 477 | 478 | 479 | 480 | 481 | 482 | 483 | 484 | 485 | 486 | 487 | 488 | 489 | 490 | 491 | 492 | 493 | 494 | 495 | 496 | 497 | 498 | 499 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 509 | 510 | 511 | 512 | 513 | 514 | 515 | 516 | 517 | 518 | 519 | 520 | 521 | 522 | 523 | 524 | 525 | 526 | 527 | 528 | 529 | 530 | 531 | 532 | 533 | 534 | 535 | 536 | 537 | 538 | 539 | 540 | 541 | 542 | 543 | 544 | 545 | 546 | 547 | 548 | 549 | 550 | 551 | 552 | 553 | 554 | 555 | 556 | 557 | 558 | 559 | 560 | 561 | 562 | 563 | 564 | 565 | 566 | 567 | 568 | 569 | 570 | 571 | 572 | 573 | 574 | 575 | 576 | 577 | 578 | 579 | 580 | 581 | 582 | 583 | 584 | 585 | 586 | 587 | 588 | 589 | 590 | 591 | 592 | 593 | 594 | 595 | 596 | 597 | 598 | 599 | 600 | 601 | 602 | 603 | 604 | 605 | 606 | 607 | 608 | 609 | 610 | 611 | 612 | 613 | 614 | 615 | 616 | 617 | 618 | 619 | 620 | 621 | 622 | 623 | 624 | 625 | 626 | 627 | 628 | 629 | 630 | 631 | 632 | 633 | 634 | 635 | 636 | 637 | 638 | 639 | 640 | 641 | 642 | 643 | 644 | 645 | 646 | 647 | 648 | 649 | 650 | 651 | 652 | 653 | 654 | 655 | 656 | 657 | 658 | 659 | 660 | 661 | 662 | 663 | 664 | 665 | 666 | 667 | 668 | 669 | 670 | 671 | 672 | 673 | 674 | 675 | 676 | 677 | 678 | 679 | 680 | 681 | 682 | 683 | 684 | 685 | 686 | 687 | 688 | 689 | 690 | 691 | 692 | 693 | 694 | 695 | 696 | 697 | 698 | 699 | 700 | 701 | 702 | 703 | 704 | 705 | 706 | 707 | 708 | 709 | 710 | 711 | 712 | 713 | 714 | 715 | 716 | 717 | 718 | 719 | 720 | 721 | 722 | 723 | 724 | 725 | 726 | 727 | 728 | 729 | 730 | 731 | 732 | 733 | 734 | 735 | 736 | 737 | 738 | 739 | 740 | 741 | 742 | 743 | 744 | 745 | 746 | 747 | 748 | 749 | 750 | 751 | 752 | 753 | 754 | 755 | 756 | 757 | 758 | 759 | 760 | 761 | 762 | 763 | 764 | 765 | 766 | 767 | 768 | 769 | 770 | 771 | 772 | 773 | 774 | 775 | 776 | 777 | 778 | 779 | 780 | 781 | 782 | 783 | 784 | 785 | 786 | 787 | 788 | 789 | 790 | 791 | 792 | 793 | 794 | 795 | 796 | 797 | 798 | 799 | 800 | 801 | 802 | 803 | 804 | 805 | 806 | 807 | 808 | 809 | 810 | 811 | 812 | 813 | 814 | 815 | 816 | 817 | 818 | 819 | 820 | 821 | 822 | 823 | 824 | 825 | 826 | 827 | 828 | 829 | 830 | 831 | 832 | 833 | 834 | 835 | 836 | 837 | 838 | 839 | 840 | 841 | 842 | 843 | 844 | 845 | 846 | 847 | 848 | 849 | 850 | 851 | 852 | 853 | 854 | 855 | 856 | 857 | 858 | 859 | 860 | 861 | 862 | 863 | 864 | 865 | 866 | 867 | 868 | 869 | 870 | 871 | 872 | 873 | 874 | 875 | 876 | 877 | 878 | 879 | 880 | 881 | 882 | 883 | 884 | 885 | 886 | 887 | 888 | 889 | 890 | 891 | 892 | 893 | 894 | 895 | 896 | 897 | 898 | 899 | 900 | 901 | 902 | 903 | 904 | 905 | 906 | 907 | 908 | 909 | 910 | 911 | 912 | 913 | 914 | 915 | 916 | 917 | 918 | 919 | 920 | 921 | 922 | 923 | 924 | 925 | 926 | 927 | 928 | 929 | 930 | 931 | 932 | 933 | 934 | 935 | 936 | 937 | 938 | 939 | 940 | 941 | 942 | 943 | 944 | 945 | 946 | 947 | 948 | 949 | 950 | 951 | 952 | 953 | 954 | 955 | 956 | 957 | 958 | 959 | 960 | 961 | 962 | 963 | 964 | 965 | 966 | 967 | 968 | 969 | 970 | 971 | 972 | 973 | 974 | 975 | 976 | 977 | 978 | 979 | 980 | 981 | 982 | 983 | 984 | 985 | 986 | 987 | 988 | 989 | 990 | 991 | 992 | 993 | 994 | 995 | 996 | 997 | 998 | 999;
-export type TNumber0_5 = 0 | 1 | 2 | 3 | 4 | 5;
-export type TNumber0_10 = TNumber0_5 | 6 | 7 | 8 | 9 | 10;
-export type TNumber0_15 = TNumber0_10 | 11 | 12 | 13 | 14 | 15;
-export type TNumber0_20 = TNumber0_15 | 16 | 17 | 18 | 19 | 20;
-export type TNumber1_10 = Exclude<TNumber0_10, 0>;
-export type TParseInt<T> = T extends `${infer N extends number}` ? N : never;
-export type TParseableInt<T> = T extends `${number}` ? T : never;
-export declare function ensurePositiveNumber(v: number, name?: string): number;
-export declare function ensureNonNegativeNumber(v: number, name?: string): number;
-export declare function ensureNonPositiveNumber(v: number, name?: string): number;
-export declare function ensureNegativeNumber(v: number, name?: string): number;
-export declare function incrementBy(n: number): TFunction<number, number>;
-export declare function multiplyBy(n: number): TFunction<number, number>;
-export declare function divideBy(n: number): TFunction<number, number>;
-export declare const increment: TFunction<number, number>;
-export declare const decrement: TFunction<number, number>;
-export declare const decrementBy: (n: number) => TFunction<number, number>;
-export declare function isNumber(v: unknown): v is number;
-export declare function isPositiveNumber(v: number): v is TPositiveNumber;
-export declare function isNegativeNumber(v: number): v is TNegativeNumber;
-export declare function isZero(v: number): v is TZero;
-export declare function clamp(n: number, min: number, max: number): number;
-export declare function clampInt0_100(n: number): TNumber0_100;
-export declare function tryToParseNumber(numberStr: string): import("./operations.js").TOperationTuple<number, Error>;

package/dist/utils/operations.d.ts

@@ -1,28 +0,0 @@
-export type TOperation<T, E = Error> = {
-    success: false;
-    error: E;
-} | {
-    success: true;
-    data: T;
-};
-export type TAsyncOperation<T, E = Error> = Promise<TOperation<T, E>>;
-export type TOperationTuple<T, E = Error> = [T, undefined] | [undefined, E];
-export type TAsyncOperationTuple<T, E = Error> = Promise<TOperationTuple<T, E>>;
-export type TValidation<T, E = Error> = {
-    success: false;
-    errors: E[];
-} | {
-    success: true;
-    data: T;
-};
-export type TAsyncValidation<T, E = Error> = Promise<TValidation<T, E>>;
-export declare const Operation: {
-    ok: <const T>(data: T) => {
-        readonly success: true;
-        readonly data: T;
-    };
-    ko: <const E>(error: E) => {
-        readonly success: false;
-        readonly error: E;
-    };
-};

package/dist/utils/primitives.d.ts

@@ -1,3 +0,0 @@
-export type TTimeoutHandle = ReturnType<typeof setTimeout>;
-export type TIntervalHandle = ReturnType<typeof setInterval>;
-export type TPrimitive = string | number | boolean | null;

package/dist/utils/promises.d.ts

@@ -1,10 +0,0 @@
-import TimeDuration from "../time/TimeDuration.js";
-import { TAsyncFunction, TFunction } from "./functions.js";
-export type TPromisable<T> = T | Promise<T>;
-export declare function asPromise<T>(promisable: TPromisable<T>): Promise<T>;
-export declare function promiseSequence<R>(...fns: TFunction<void, Promise<R>>[]): TFunction<void, Promise<R[]>>;
-export declare function delayPromise<T>(duration: TimeDuration): TAsyncFunction<T, T>;
-export declare class TimeoutError extends Error {
-}
-export declare function awaitAtMost<T>(promise: Promise<T>, duration: TimeDuration): Promise<T>;
-export declare const NEVER: Promise<unknown>;

package/dist/utils/random.d.ts

@@ -1,3 +0,0 @@
-import { TPositiveNumber } from "./numbers.ts";
-export declare function randomNumberInInterval(min: number, max: number): number;
-export declare const randomId: (length: TPositiveNumber) => string;

package/dist/utils/records/entries.d.ts

@@ -1,7 +0,0 @@
-import { TFunction } from "../_index";
-export declare function dictToEntries<V, K extends string = string>(obj: Record<K, V>): [K, V][];
-export declare function entriesToDict<V, K extends string = string>(entries: [K, V][]): Record<K, V>;
-export declare function entriesToEntries<K1 extends string, V1, K2 extends string, V2>(dict: Record<K1, V1>, mapper: TFunction<[K1, V1], [K2, V2]>): Record<K2, V2>;
-/** @deprecated[2025.08.01]: Compatibility layer. */
-export declare const mapEntries: typeof entriesToEntries;
-export declare function entriesToList<K1 extends string, V1, R>(dict: Record<K1, V1>, mapper: TFunction<[K1, V1], R>): Array<R>;

package/dist/utils/records.d.ts

@@ -1,63 +0,0 @@
-export * from './records/entries.js';
-export type TEmpty = Record<string, never>;
-export type TKeysOfType<T, V> = {
-    [K in keyof T]-?: T[K] extends V ? K : never;
-}[keyof T];
-export declare function dictToList<T>(obj: Record<string | number, T>): T[];
-export declare function pick<T extends object, K extends keyof T>(o: T, keys: K[]): Pick<T, K>;
-export type TOptionsWithoutDefaults<T, R> = Partial<T> & Required<Omit<T, keyof R>>;
-export type TOptionalKeysForType<T> = {
-    [K in keyof T]-?: {} extends Pick<T, K> ? K : never;
-}[keyof T];
-export type TRequiredKeysForType<T> = Exclude<keyof T, TOptionalKeysForType<T>>;
-export type TAllKeysOptional<T> = TRequiredKeysForType<T> extends never ? true : false;
-export type TConditionalParameter<T> = TAllKeysOptional<T> extends true ? T | undefined : T;
-export type TConditionalParameterOptions<T, R> = TConditionalParameter<TOptionsWithoutDefaults<T, R>>;
-/**
- * Given a type T, replaces all fields of type From to fields of type To.
- */
-export type TReplaceType<T, From, To> = {
-    [K in keyof T]: T[K] extends From ? To : T[K];
-};
-/**
- * Given a type T, make field K required instead of optional.
- */
-export type TWithRequiredProperty<T, K extends keyof T> = T & {
-    [Property in K]-?: T[Property];
-};
-/**
- * Given a type T, make all fields required instead of optional.
- */
-export type TWithRequiredProperties<T> = Required<T>;
-/**
- * Type that forces a record to contain a few properties, but allows for extraneous properties.
- */
-export type TWithExtras<R extends Record<any, any>, T extends Record<any, any> = Record<string, unknown>> = R & T;
-/**
- * Types that improves the human readability of a Typescript type.
- */
-export type TPrettify<T> = {
-    [K in keyof T]: T[K];
-} & {};
-export declare function shallowRecordEquals(a: Record<string, unknown>, b: Record<string, unknown>): boolean;
-/**
- * A utility type that checks if any property in a record type `T` has the `never` type.
- * This type evaluates to `true` if at least one property in `T` is of type `never`, and `false` otherwise.
- * It's commonly used to create compile-time assertions that prevent unintended changes where properties might accidentally become `never` due to type mismatches.
- *
- * @example Advanced usage for type guards
- * ```typescript
- * type TMap = { a: string; b: number; c: boolean };
- * type TJsonSerializable = string | number | boolean;
- *
- * type TFiltered = {
- *   [K in keyof TMap]: TMap[K] extends TJsonSerializable ? TMap[K] : never;
- * };
- *
- * // If TMap changes and some property becomes not serializable, TFiltered will have 'never' values
- * const _guard: THasNever<TFiltered> = false; // Compile error if any property became 'never'
- * ```
- */
-export type THasNever<T> = {
-    [K in keyof T]: [T[K]] extends [never] ? true : false;
-}[keyof T] extends false ? false : true;

package/dist/utils/strings/StringParts.d.ts

@@ -1,38 +0,0 @@
-import { TReadableArray } from "../arrays.js";
-import { TMaybe } from "../nulls.js";
-export declare class StringParts {
-    private readonly _parts;
-    private constructor();
-    toUpperCase(): StringParts;
-    toLowerCase(): StringParts;
-    capitalizeFirst(): StringParts;
-    capitalizeEach(): StringParts;
-    get parts(): string[];
-    get tail(): string[];
-    get first(): TMaybe<string>;
-    get last(): TMaybe<string>;
-    get length(): number;
-    trim(): StringParts;
-    toSnakeCase(): string;
-    toCamelCase(): string;
-    toKebabCase(): string;
-    toPascalCase(): string;
-    toHumanCase(): string;
-    join(separator: string): string;
-    mergeWith({ parts: otherParts }: {
-        parts: TReadableArray<string>;
-    }): StringParts;
-    slice(start: number, end?: number): StringParts;
-    splice(start: number, deleteCount: number, ...items: string[]): StringParts;
-    push(part: string): StringParts;
-    shift(part: string): StringParts;
-    reverse(): StringParts;
-    static fromString: (s: string, separator?: string | RegExp) => StringParts;
-    static fromParts: (...parts: string[]) => StringParts;
-    /**
-     * Tries to convert a word in PascalCase to an array of words. Will not work if there are spaces or special characters. Does not cope well on uppercase abbreviations (eg, "CSS").
-     * @param s a string in PascalCase.
-     * @returns a StringParts where each sub-word in PascalCase is now a part.
-     */
-    static tryToParsePascalCaseWord(s: string): StringParts;
-}

package/dist/utils/strings.d.ts

@@ -1,20 +0,0 @@
-import { TMaybe } from "./nulls.js";
-export * from './strings/StringParts.js';
-export type THtmlString = string;
-export type TUrl = string;
-export type TRelativeUrl = string;
-export declare function hashCode(str: string): number;
-export declare function repeat(char: string, times: number): string;
-export declare function capitalizeWord(word: string): string;
-export declare function splitWords(text: string, regEx?: RegExp): string[];
-export declare function stringToNumber(s: string | null | undefined): number | null;
-export declare function pad(str: string, n: number, char: string, where?: 'left' | 'right'): string;
-export declare function padLeft(str: string, n: number, char: string): string;
-export declare function padRight(str: string, n: number, char: string): string;
-export declare function ellipsis(str: string, maxLength: number): string;
-export declare function pluralize(n: number, singular: string, plural?: string): string;
-export declare function isString(source: unknown): source is string;
-export declare function isEmpty(source: string): boolean;
-export declare function isNullOrUndefinedOrEmpty(source: TMaybe<string>): boolean;
-export declare function wrapWithString(str: string, delimiter: string): string;
-export declare function wrapWithString(str: string, start: string, end: string): string;