@angular-wave/angular.ts 0.13.0 → 0.14.0

package/@types/router/view/view.d.ts

@@ -1,19 +1,3 @@
-/**
- * The View service
- *
- * This service pairs existing `ng-view` components (which live in the DOM)
- * with view configs (from the state declaration objects: [[StateDeclaration.views]]).
- *
- * - After a successful Transition, the views from the newly entered states are activated via [[activateViewConfig]].
- *   The views from exited states are deactivated via [[deactivateViewConfig]].
- *   (See: the [[registerActivateViews]] Transition Hook)
- *
- * - As `ng-view` components pop in and out of existence, they register themselves using [[registerUIView]].
- *
- * - When the [[sync]] function is called, the registered `ng-view`(s) ([[ActiveUIView]])
- * are configured with the matching [[ViewConfig]](s)
- *
- */
 export class ViewService {
   _ngViews: any[];
   _viewConfigs: any[];

package/@types/services/anchor-scroll/anchor-scroll.d.ts

@@ -14,7 +14,7 @@ export class AnchorScrollProvider {
     | string
     | ((
         $location: import("../../services/location/location.js").Location,
-        $rootScope: import("../../core/scope/scope.js").Scope,
+        $rootScope: ng.Scope,
       ) => AnchorScrollFunction)
   )[];
 }

package/@types/services/cookie/cookie.d.ts

@@ -34,6 +34,7 @@ export class CookieService {
    *
    * @param {string} key
    * @returns {string|null}
+   * @throws {URIError} – If decodeURIComponent fails.
    */
   get(key: string): string | null;
   /**
@@ -49,6 +50,7 @@ export class CookieService {
    * Returns an object containing all raw cookies.
    *
    * @returns {Record<string, string>}
+   * @throws {URIError} – If decodeURIComponent fails
    */
   getAll(): Record<string, string>;
   /**

package/@types/services/exception/exception.d.ts

@@ -37,7 +37,7 @@
  * }
  * ```
  *
- * @see {@link ng.ExceptionHandlerService ExceptionHandlerService}
+ * @see {@link ng.ExceptionHandlerService} ExceptionHandlerService
  */
 /**
  * Provider for the `$exceptionHandler` service.

package/@types/services/exception/interface.d.ts

@@ -2,5 +2,6 @@
  * A callback type for handling errors.
  *
  * @param {Error} exception - The exception associated with the error.
+ * @throws {Error}
  */
-export type ExceptionHandler = (exception: Error) => void;
+export type ExceptionHandler = (exception: Error) => never;

package/@types/services/http/http.d.ts

@@ -25,7 +25,7 @@ export function HttpProvider(): void;
 export class HttpProvider {
   defaults: {
     transformResponse: (typeof defaultHttpResponseTransform)[];
-    transformRequest: ((d: any) => any)[];
+    transformRequest: ((data: any) => any)[];
     headers: {
       common: {
         Accept: string;
@@ -108,6 +108,7 @@ export class HttpProvider {
     | ((
         $injector: ng.InjectorService,
         $sce: any,
+        $cookie: ng.CookieService,
       ) => {
         (requestConfig: any): Promise<any>;
         pendingRequests: any[];
@@ -119,7 +120,7 @@ export class HttpProvider {
          */
         defaults: {
           transformResponse: (typeof defaultHttpResponseTransform)[];
-          transformRequest: ((d: any) => any)[];
+          transformRequest: ((data: any) => any)[];
           headers: {
             common: {
               Accept: string;
@@ -170,3 +171,10 @@ export function http(
   eventHandlers?: Record<string, EventListener>,
   uploadEventHandlers?: Record<string, EventListener>,
 ): void;
+export const Http: Readonly<{
+  OK: 200;
+  MultipleChoices: 300;
+  BadRequest: 400;
+  NotFound: 404;
+  ErrorMax: 599;
+}>;

package/@types/services/location/location.d.ts

@@ -94,10 +94,10 @@ export function parseAppUrl(url: string, html5Mode: boolean): void;
  * Returns `undefined` if `url` does not start with `base`.
  * @param {string} base
  * @param {string} url
- * @returns {string} returns text from `url` after `base` or `undefined` if it does not begin with
+ * @returns {string|undefined} returns text from `url` after `base` or `undefined` if it does not begin with
  *                   the expected string.
  */
-export function stripBaseUrl(base: string, url: string): string;
+export function stripBaseUrl(base: string, url: string): string | undefined;
 /**
  * @ignore
  * Removes the hash fragment (including the '#') from the given URL string.
@@ -143,11 +143,11 @@ export function serverBase(url: string): string;
  * Determine if two URLs are equal despite potential differences in encoding,
  * trailing slashes, or empty hash fragments, such as between $location.absUrl() and $browser.url().
  *
- * @param {string} a - First URL to compare.
- * @param {string} b - Second URL to compare.
+ * @param {string} x - First URL to compare.
+ * @param {string} y - Second URL to compare.
  * @returns {boolean} True if URLs are equivalent after normalization.
  */
-export function urlsEqual(a: string, b: string): boolean;
+export function urlsEqual(x: string, y: string): boolean;
 export class Location {
   /**
    * @param {string} appBase application base URL
@@ -321,7 +321,11 @@ export class LocationProvider {
   lastCachedState: any;
   $get: (
     | string
-    | (($rootScope: ng.Scope, $rootElement: Element) => Location)
+    | ((
+        $rootScope: ng.Scope,
+        $rootElement: Element,
+        $exceptionHandler: ng.ExceptionHandlerService,
+      ) => Location)
   )[];
   #private;
 }

package/@types/services/pubsub/pubsub.d.ts

@@ -15,6 +15,7 @@ export class PubSubProvider {
   $get: () => PubSub;
 }
 export class PubSub {
+  static $nonscope: any;
   /**
    * Runs a function asynchronously.
    *
@@ -153,7 +154,7 @@ export class PubSub {
    * the order in which they were added, passing all arguments along.
    *
    * If this object was created with async=true, subscribed functions are called
-   * via Promise.resolve().  Otherwise, the functions are called directly, and if
+   * via `queueMicrotask`.  Otherwise, the functions are called directly, and if
    * any of them throw an uncaught error, publishing is aborted.
    *
    * @param {string} topic Topic to publish to.

package/@types/services/rest/rest.d.ts

@@ -9,18 +9,14 @@ export class RestService<T, ID> {
    *
    * @param {ng.HttpService} $http Angular-like $http service
    * @param {string} baseUrl Base URL or URI template
-   * @param {{new(data: any): T}=} entityClass Optional constructor to map JSON to objects
-   * @param {Object=} options Optional settings (interceptors, headers, etc.)
+   * @param {ng.EntityClass<T>} [entityClass] Optional constructor to map JSON to objects
+   * @param {Object} [options] Optional settings (interceptors, headers, etc.)
    */
   constructor(
     $http: ng.HttpService,
     baseUrl: string,
-    entityClass?:
-      | {
-          new (data: any): T;
-        }
-      | undefined,
-    options?: any | undefined,
+    entityClass?: ng.EntityClass<T>,
+    options?: any,
   );
   /** @private */
   private $http;

package/@types/services/sce/sce.d.ts

@@ -1,4 +1,4 @@
-export function escapeForRegexp(s: any): any;
+export function escapeForRegexp(str: any): any;
 export function adjustMatcher(matcher: any): any;
 export function SceProvider(): void;
 export class SceProvider {

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

@@ -1,4 +1,4 @@
-export function equals(o1: any, o2: any): any;
+export function equals(o1: any, o2: any): boolean;
 /**
  * prototypal inheritance helper.
  * Creates a new object which has `parent` object as its prototype, and then copies the properties from `extra` onto it

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

@@ -149,13 +149,13 @@ export function getInheritedData(element: Node, name: string): any;
  * @param {Node} element
  * @param {string|string[]} name
  * @param {any} [value]
- * @returns
+ * @returns {any|undefined}
  */
 export function setInheritedData(
   element: Node,
   name: string | string[],
   value?: any,
-): any;
+): any | undefined;
 /**
  *
  * @param {Element} element

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

@@ -46,7 +46,7 @@ export function curry(fn: any): any | (() => any | any);
  * let composed = compose(f,g,h)
  * then, composed is: f(g(h(x)))
  */
-export function compose(...args: any[]): () => any;
+export function compose(...fns: any[]): (...args: any[]) => any;
 /**
  * Given a class constructor, returns a predicate function that checks
  * whether a given object is an instance of that class.
@@ -105,4 +105,4 @@ export function pattern(struct: any): (arg0: any) => any;
  */
 export const propEq: any;
 export function parse(path: any): (obj: any) => any;
-export function val(v: any): () => any;
+export function val(value: any): () => any;

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

@@ -17,3 +17,4 @@ export interface ErrorHandlingConfig {
    */
   urlErrorParamsEnabled?: boolean;
 }
+export type Validator = (value: unknown) => boolean;

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

@@ -3,6 +3,7 @@
  * Provides guarantees around presence and access.
  */
 export class NodeRef {
+  static $nonscope: boolean;
   /**
    * @param {Node | Element | string | NodeList | Node[]} element - The DOM node(s) or HTML string to wrap.
    * @throws {Error} If the argument is invalid or cannot be wrapped properly.

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

@@ -1,16 +1,14 @@
-/**
- * Functions that manipulate strings
- */
 /**
  * Returns a string shortened to a maximum length
  *
  * If the string is already less than the `max` length, return the string.
  * Else return the string, shortened to `max - 3` and append three dots ("...").
  *
- * @param max the maximum length of the string to return
- * @param str the input string
+ * @param {number} max the maximum length of the string to return
+ * @param {string} str the input string
+ * @returns {string}
  */
-export function maxLength(max: any, str: any): any;
+export function maxLength(max: number, str: string): string;
 /**
  * Returns a string, with spaces added to the end, up to a desired str length
  *
@@ -24,7 +22,7 @@ export function padString(length: any, str: any): any;
 export function kebobString(camelCase: any): any;
 export function functionToString(fn: any): any;
 export function fnToString(fn: any): any;
-export function stringify(o: any): any;
+export function stringify(value: any): any;
 /**
  * Splits on a delimiter, but returns the delimiters in the array
  *
@@ -48,5 +46,5 @@ export function splitOnDelim(delim: any): (str: any) => any;
  * arr.reduce(joinNeighborsR, []) // ["foobar", 1, "bazqux" ]
  * ```
  */
-export function joinNeighborsR(acc: any, x: any): any;
+export function joinNeighborsR(acc: any, str: any): any;
 export function stripLastPathElement(str: any): any;

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`.
  *
@@ -180,10 +181,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 +248,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 +307,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 +393,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 +434,31 @@ 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.
+ *
+ * @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;
 /**
  * Throw error if the argument is falsy.
  */
@@ -429,12 +474,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 +524,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 +583,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.
  *

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