@xaendar/common 0.1.7 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xaendar/common",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "description": "A library containing common utils and types",
   "type": "module",
   "main": "./xaendar-common.es.js",

package/xaendar-common.es.d.ts

@@ -1,119 +1,3 @@
-/**
- * A type representing an abstract constructor function for a given type T.
- * This type can be used to define abstract classes.
- */
-export declare type AbstractConstructor<T extends Object = Object> = abstract new (...args: any[]) => T;
-
-/**
- * An abstract constructor function type that can accept any number of arguments
- * and return an instance of the specified type.
- */
-export declare type AbstractConstructorFunction<T extends object = object, Statics extends Record<string, unknown> | undefined = undefined> = (abstract new (...args: any[]) => T) & (Statics extends undefined ? object : Statics);
-
-export declare type AccessorDecorator<Class extends Object, Field = unknown, ReturnTypeField = Field> = (value: ClassAccessorDecoratorValue<Field>, context: ClassAccessorDecoratorContext<Class, ReturnTypeField>) => {
-    get?: () => ReturnTypeField;
-    set?: (value: ReturnTypeField) => void;
-    init?: (initialValue: Field) => ReturnTypeField;
-} | void;
-
-/**
- * A function type that can accept any number of arguments and return a promise of any type.
- */
-export declare type AsyncFunction<Arguments extends any[] = any[], ReturnType = void> = Arguments extends Array<any> ? (...args: Arguments) => Promise<ReturnType> : () => Promise<ReturnType>;
-
-/**
- * An async function type that accepts arguments but always resolves to void.
- * Typically used for async callbacks or side-effect functions.
- * @template Arguments - The types of the function arguments
- * @example
- * type OnUserChangeAsync = AsyncVoidFunction<[user: User]>;
- * const handleUserChangeAsync: OnUserChangeAsync = async (user) => await api.logChange(user);
- */
-export declare type AsyncVoidFunction<Arguments extends any[] = any[]> = (...args: Arguments) => Promise<void>;
-
-export declare type Beautify<T extends Object> = {
-    [K in keyof T]: T[K];
-} & {};
-
-export declare type ClassAccessorDecoratorValue<Field = unknown> = {
-    get?: () => Field;
-    set: (value: Field) => void;
-};
-
-declare type ClassDecorator_2<T extends Object, Statics extends {
-    [key: string]: any;
-} = {
-    [key: string]: any;
-}> = (klass: Constructor<T, Statics>, context: ClassDecoratorContext) => void;
-export { ClassDecorator_2 as ClassDecorator }
-
-/**
- * A type representing a constructor function for a given type T.
- * This type can be used to define classes or factory functions
- */
-export declare type Constructor<T extends Object = Object, Statics extends Record<string, unknown> = {}> = (new (...args: any[]) => T) & Statics;
-
-/**
- * A constructor function type that can accept any number of arguments and return an instance of any type.
- */
-export declare type ConstructorFunction<T extends object = object, Statics extends Record<string, unknown> | undefined = undefined> = (new (...args: any[]) => T) & (Statics extends undefined ? object : Statics);
-
-export declare type ContainsChar<String extends string, Contains extends string> = String extends `${infer First}${infer Rest}` ? First extends Contains ? true : ContainsChar<Rest, Contains> : false;
-
-export declare type Dictionary<Key extends string | number, Value> = {
-    [K in Key]?: Value;
-};
-
-export declare type FieldDecorator<Class extends Object, Field, ReturnType = Field> = (field: undefined, context: ClassFieldDecoratorContext<Class, Field>) => ((value: Field) => ReturnType);
-
-/**
- * A function type that can accept any number of arguments and return any type.
- */
-declare type Function_2<Arguments extends any[] = any[], ReturnType = void> = Arguments extends Array<any> ? (...args: Arguments) => ReturnType : () => ReturnType;
-export { Function_2 as Function }
-
-declare type MethodDecorator_2<T extends Object, Method extends Function_2> = (value: Method, context: ClassMethodDecoratorContext<T, Method>) => Method | void;
-export { MethodDecorator_2 as MethodDecorator }
-
-export declare type Mutable<T extends Object> = {
-    -readonly [P in keyof T]: T[P];
-};
-
-/**
- * An async function type that accepts no arguments and returns a promise of the specified type.
- * @template ReturnType - The type that the promise resolves to (defaults to void)
- * @example
- * type FetchUser = AsyncFunctionNoArgs<User>;
- * const fetchUser: FetchUser = async () => await api.getUser();
- */
-export declare type NoArgsAsyncFunction<ReturnType = void> = () => Promise<ReturnType>;
-
-/**
- * An async function type that accepts arguments but always resolves to void.
- */
-export declare type NoArgsAsyncVoidFunction = () => Promise<void>;
-
-/**
- * A function type that accepts no arguments and returns a value of the specified type.
- * Also known as a 'thunk' in functional programming.
- * @template ReturnType - The return type of the function (defaults to void)
- * @example
- * type GetUser = FunctionNoArgs<User>;
- * const getUser: GetUser = () => ({ id: 1, name: 'John' });
- */
-export declare type NoArgsFunction<ReturnType = void> = () => ReturnType;
-
-/**
- * A function type that accepts arguments but always returns void.
- */
-export declare type NoArgsVoidFunction = () => void;
-
-export declare type PositiveInteger<Value extends number> = ContainsChar<`${Value}`, '-'> extends true ? never : ContainsChar<`${Value}`, '.'> extends true ? never : Value;
-
-export declare type RequireOne<T extends Object, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & {
-    [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>>;
-}[Keys];
-
 /**
  * A generic LIFO (Last In, First Out) stack data structure.
  *
@@ -125,6 +9,7 @@ export declare class Stack<T = unknown> {
      */
     private _elements;
     [index: number]: T;
+    [prop: string | symbol]: unknown;
     constructor();
     /**
      * The number of elements currently in the stack.
@@ -149,17 +34,4 @@ export declare class Stack<T = unknown> {
     push(element: T): number;
 }
 
-export declare type TupleOfLength<Length extends number, TupleType = number, Acc extends TupleType[] = []> = PositiveInteger<Length> extends never ? never : Acc['length'] extends Length ? Acc : TupleOfLength<Length, TupleType, [...Acc, TupleType]>;
-
-/**
- * A function type that accepts arguments but always returns void.
- * Typically used for callbacks, event handlers, or side-effect functions.
- * @template Arguments - The types of the function arguments
- * @example
- * type OnUserChange = VoidFunction<[user: User]>;
- * const handleUserChange: OnUserChange = (user) => console.log(user);
- */
-declare type VoidFunction_2<Arguments extends any[] = any[]> = (...args: Arguments) => void;
-export { VoidFunction_2 as VoidFunction }
-
 export { }

package/xaendar-common.es.js

@@ -3,7 +3,7 @@ var e = class {
 	_elements = [];
 	constructor() {
 		return new Proxy(this, { get(e, t) {
-			if (typeof t == "string") return isNaN(Number(t)) ? e[t] : e._elements[Number(t)];
+			return isNaN(Number(t)) ? e[t] : e._elements[Number(t)];
 		} });
 	}
 	get length() {

package/xaendar-common.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"xaendar-common.es.js","names":[],"sources":["../../../packages/common/src/models/stack/stack.model.ts"],"sourcesContent":["/**\r\n * A generic LIFO (Last In, First Out) stack data structure.\r\n *\r\n * @template T - The type of elements held in the stack. Defaults to `unknown`.\r\n */\r\nexport class Stack<T = unknown> {\r\n  /**\r\n   * Internal array holding the stack elements, ordered from bottom to top.\r\n   */\r\n  private _elements = new Array<T>;\r\n\r\n  [index: number]: T;\r\n\r\n  constructor() {\r\n    return new Proxy(this, {\r\n      get(target, prop) {\r\n        if (typeof prop === 'string') {\r\n          return isNaN(Number(prop)) ? (target as unknown as { [prop]: unknown })[prop] : target._elements[Number(prop)];\r\n        }\r\n      }\r\n    });\r\n  }\r\n\r\n  /**\r\n   * The number of elements currently in the stack.\r\n   */\r\n  public get length(): number {\r\n    return this._elements.length;\r\n  }\r\n\r\n  /**\r\n   * A shallow copy of the elements in the stack, ordered from bottom to top.\r\n   */\r\n  public get values(): T[] {\r\n    return [...this._elements];\r\n  }\r\n\r\n  /**\r\n   * Removes and returns the top element of the stack.\r\n   *\r\n   * @returns The top element, or `undefined` if the stack is empty.\r\n   */\r\n  public pop(): T | undefined {\r\n    return this._elements.pop();\r\n  }\r\n\r\n  /**\r\n   * Pushes an element onto the top of the stack.\r\n   *\r\n   * @param element - The element to push.\r\n   * @returns The new length of the stack.\r\n   */\r\n  public push(element: T): number {\r\n    return this._elements.push(element);\r\n  }\r\n}"],"mappings":";AAKA,IAAa,IAAb,MAAgC;CAI9B,YAAoB,EAAY;CAIhC,cAAc;AACZ,SAAO,IAAI,MAAM,MAAM,EACrB,IAAI,GAAQ,GAAM;AAChB,OAAI,OAAO,KAAS,SAClB,QAAO,MAAM,OAAO,EAAK,CAAC,GAAI,EAA0C,KAAQ,EAAO,UAAU,OAAO,EAAK;KAGlH,CAAC;;CAMJ,IAAW,SAAiB;AAC1B,SAAO,KAAK,UAAU;;CAMxB,IAAW,SAAc;AACvB,SAAO,CAAC,GAAG,KAAK,UAAU;;CAQ5B,MAA4B;AAC1B,SAAO,KAAK,UAAU,KAAK;;CAS7B,KAAY,GAAoB;AAC9B,SAAO,KAAK,UAAU,KAAK,EAAQ"}
+{"version":3,"file":"xaendar-common.es.js","names":[],"sources":["../../../packages/common/src/models/stack/stack.model.ts"],"sourcesContent":["/**\r\n * A generic LIFO (Last In, First Out) stack data structure.\r\n *\r\n * @template T - The type of elements held in the stack. Defaults to `unknown`.\r\n */\r\nexport class Stack<T = unknown> {\r\n  /**\r\n   * Internal array holding the stack elements, ordered from bottom to top.\r\n   */\r\n  private _elements = new Array<T>;\r\n\r\n  [index: number]: T;\r\n\r\n  [prop: string | symbol]: unknown;\r\n\r\n  constructor() {\r\n    return new Proxy(this, {\r\n      get(target, prop) {\r\n        return isNaN(Number(prop)) ? target[prop] : target._elements[Number(prop)];\r\n      }\r\n    });\r\n  }\r\n\r\n  /**\r\n   * The number of elements currently in the stack.\r\n   */\r\n  public get length(): number {\r\n    return this._elements.length;\r\n  }\r\n\r\n  /**\r\n   * A shallow copy of the elements in the stack, ordered from bottom to top.\r\n   */\r\n  public get values(): T[] {\r\n    return [...this._elements];\r\n  }\r\n\r\n  /**\r\n   * Removes and returns the top element of the stack.\r\n   *\r\n   * @returns The top element, or `undefined` if the stack is empty.\r\n   */\r\n  public pop(): T | undefined {\r\n    return this._elements.pop();\r\n  }\r\n\r\n  /**\r\n   * Pushes an element onto the top of the stack.\r\n   *\r\n   * @param element - The element to push.\r\n   * @returns The new length of the stack.\r\n   */\r\n  public push(element: T): number {\r\n    return this._elements.push(element);\r\n  }\r\n}"],"mappings":";AAKA,IAAa,IAAb,MAAgC;CAI9B,YAAoB,EAAY;CAMhC,cAAc;EACZ,OAAO,IAAI,MAAM,MAAM,EACrB,IAAI,GAAQ,GAAM;GAChB,OAAO,MAAM,OAAO,EAAK,CAAC,GAAG,EAAO,KAAQ,EAAO,UAAU,OAAO,EAAK;KAE5E,CAAC;;CAMJ,IAAW,SAAiB;EAC1B,OAAO,KAAK,UAAU;;CAMxB,IAAW,SAAc;EACvB,OAAO,CAAC,GAAG,KAAK,UAAU;;CAQ5B,MAA4B;EAC1B,OAAO,KAAK,UAAU,KAAK;;CAS7B,KAAY,GAAoB;EAC9B,OAAO,KAAK,UAAU,KAAK,EAAQ"}