@angular-wave/angular.ts 0.13.0 → 0.14.1

package/@types/shared/utils.d.ts

@@ -57,13 +57,7 @@ export function isObject(value: any): boolean;
  * @returns {boolean} True if `value` is an `Object` with a null prototype
  */
 export function isBlankObject(value: any): boolean;
-/**
- * Determines if a reference is a `String`.
- *
- * @param {*} value Reference to check.
- * @returns {boolean} True if `value` is a `String`.
- */
-export function isString(value: any): boolean;
+export function isString(value: unknown): boolean;
 /**
  * Determines if a reference is a null.
  *
@@ -78,6 +72,13 @@ export function isNull(value: any): boolean;
  * @returns {boolean} True if `value` is null or undefined.
  */
 export function isNullOrUndefined(obj: any): boolean;
+/**
+ * Determines if a reference is not null or undefined.
+ *
+ * @param {*} obj Reference to check.
+ * @returns {boolean} True if `value` is null or undefined.
+ */
+export function notNullOrUndefined(obj: any): boolean;
 /**
  * Determines if a reference is a `Number`.
  *
@@ -92,10 +93,7 @@ export function isNullOrUndefined(obj: any): boolean;
  */
 export function isNumber(value: any): boolean;
 /**
- * @module angular
- * @function isDate
  *
- * @description
  * Determines if a value is a date.
  *
  * @param {*} value Reference to check.
@@ -180,10 +178,30 @@ export function snakeCase(name: any, separator: any): any;
 /**
  * Set or clear the hashkey for an object.
  * @param obj object
- * @param h the hashkey (!truthy to delete the hashkey)
- */
-export function setHashKey(obj: any, h: any): void;
-export function baseExtend(dst: any, objs: any, deep: any): any;
+ * @param hashkey the hashkey (!truthy to delete the hashkey)
+ */
+export function setHashKey(obj: any, hashkey: any): void;
+/**
+ * Deeply extends a destination object with one or more source objects.
+ * Safely handles Dates, RegExps, DOM nodes, arrays, and nested objects.
+ * Ignores the `__proto__` key to prevent prototype pollution.
+ *
+ * @param {Object<string, any>} dst - The destination object to extend.
+ * @param {Array<Object<string, any>>} objs - Array of source objects to copy properties from.
+ * @param {boolean} [deep=false] - Whether to perform a deep merge of nested objects.
+ * @returns {Object<string, any>} The extended destination object.
+ */
+export function baseExtend(
+  dst: {
+    [x: string]: any;
+  },
+  objs: Array<{
+    [x: string]: any;
+  }>,
+  deep?: boolean,
+): {
+  [x: string]: any;
+};
 /**
  * Extends the destination object `dst` by copying own enumerable properties from the `src` object(s)
  * to `dst`. You can specify multiple `src` objects. If you want to preserve original objects, you can do so
@@ -227,7 +245,7 @@ export function includes(array: any, obj: any): boolean;
  * @returns {number} - The index of the removed value, or -1 if the value was not found.
  */
 export function arrayRemove<T>(array: Array<T>, value: T): number;
-export function simpleCompare(a: any, b: any): boolean;
+export function simpleCompare(val1: any, val2: any): boolean;
 /**
  * Determines if two objects or two values are equivalent. Supports value types, regular
  * expressions, arrays and objects.
@@ -286,7 +304,6 @@ export function simpleCompare(a: any, b: any): boolean;
   </example>
  */
 export function equals(o1: any, o2: any): boolean;
-export function csp(): any;
 /**
  * throw error if the name given is hasOwnProperty
  * @param  {string} name    the name to test
@@ -373,9 +390,9 @@ export function toKeyValue(obj: any): string;
  * Tries to decode the URI component without throwing an exception.
  *
  * @param  {string} value potential URI component to check.
- * @returns {string|void}
+ * @returns {string|undefined}
  */
-export function tryDecodeURIComponent(value: string): string | void;
+export function tryDecodeURIComponent(value: string): string | undefined;
 /**
  * We need our custom method because encodeURIComponent is too aggressive and doesn't follow
  * http://www.ietf.org/rfc/rfc3986.txt with regards to the character set (pchar) allowed in path
@@ -414,6 +431,39 @@ export function shallowCopy(src: any, dst: any): any;
  * @param {string} errorMsg
  */
 export function assert(argument: boolean, errorMsg?: string): void;
+/**
+ * Validate a value using a predicate function.
+ * Throws if the predicate returns false.
+ * IMPORTANT: use this function only for developper errors and not for user/data errors
+ *
+ * @param {ng.Validator} fn - Predicate validator function.
+ * @param {*} arg - The value to validate.
+ * @param {string} name - Parameter name (included in error message).
+ * @returns {*} The validated value.
+ * @throws {TypeError} If the value does not satisfy the validator.
+ */
+export function validate(fn: ng.Validator, arg: any, name: string): any;
+/**
+ * @param {*} arg - The value to validate.
+ * @param {string} name - Parameter name (included in error message).
+ * @returns {*} The validated value.
+ * @throws {TypeError} If the value does not satisfy the validator.
+ */
+export function validateRequired(arg: any, name: string): any;
+/**
+ * @param {*} arg - The value to validate.
+ * @param {string} name - Parameter name (included in error message).
+ * @returns {*} The validated value.
+ * @throws {TypeError} If the value does not satisfy the validator.
+ */
+export function validateArray(arg: any, name: string): any;
+/**
+ * @param {*} arg - The value to validate.
+ * @param {string} name - Parameter name (included in error message).
+ * @returns {*} The validated value.
+ * @throws {TypeError} If the value does not satisfy the validator.
+ */
+export function validateIsString(arg: any, name: string): any;
 /**
  * Throw error if the argument is falsy.
  */
@@ -429,12 +479,12 @@ export function assertArgFn(
  *
  * Omitted or undefined options will leave the corresponding configuration values unchanged.
  *
- * @param {import("./interface.ts").ErrorHandlingConfig} [config]
- * @returns {import("./interface.ts").ErrorHandlingConfig}
+ * @param {ng.ErrorHandlingConfig} [config]
+ * @returns {ng.ErrorHandlingConfig}
  */
 export function errorHandlingConfig(
-  config?: import("./interface.ts").ErrorHandlingConfig,
-): import("./interface.ts").ErrorHandlingConfig;
+  config?: ng.ErrorHandlingConfig,
+): ng.ErrorHandlingConfig;
 /**
  * This object provides a utility for producing rich Error messages within
  * AngularTS. It can be called as follows:
@@ -479,13 +529,13 @@ export function hashKey(obj: any): string;
  * Merges two class name values into a single space-separated string.
  * Accepts strings, arrays of strings, or null/undefined values.
  *
- * @param {string | string[] | null | undefined} a - The first class name(s).
- * @param {string | string[] | null | undefined} b - The second class name(s).
+ * @param {string | string[] | null | undefined} firstClass - The first class name(s).
+ * @param {string | string[] | null | undefined} secondClass - The second class name(s).
  * @returns {string} A single string containing all class names separated by spaces.
  */
 export function mergeClasses(
-  a: string | string[] | null | undefined,
-  b: string | string[] | null | undefined,
+  firstClass: string | string[] | null | undefined,
+  secondClass: string | string[] | null | undefined,
 ): string;
 /**
  * Converts all accepted directives format into proper directive name.
@@ -538,10 +588,10 @@ export function callBackAfterFirst(fn: Function): Function;
 /**
  * Delays execution for a specified number of milliseconds.
  *
- * @param {number} [t=0] - The number of milliseconds to wait. Defaults to 0.
+ * @param {number} [timeout=0] - The number of milliseconds to wait. Defaults to 0.
  * @returns {Promise<void>} A promise that resolves after the delay.
  */
-export function wait(t?: number): Promise<void>;
+export function wait(timeout?: number): Promise<void>;
 /**
  * Checks if a given string starts with a specified substring.
  *
@@ -581,6 +631,11 @@ export function instantiateWasm(
   exports: WebAssembly.Exports;
   module: WebAssembly.Module;
 }>;
+/**
+ * @param {*} fn
+ * @returns {boolean}
+ */
+export function isArrowFunction(fn: any): boolean;
 export const isProxySymbol: unique symbol;
 export const BADARG: "badarg";
 export const BADARGKEY: "badarg: key";

package/LICENSE

@@ -1,6 +1,7 @@
 The MIT License
 
 Copyright (c) 2010-2020 Google LLC. http://angularjs.org
+Copyright (c) 2021-present Angular Wave contributors. https://angular-wave.github.io/angular.ts/
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal