@angular-wave/angular.ts 0.13.0 → 0.14.1

package/@types/router/url/url-service.d.ts

@@ -231,11 +231,11 @@ export class UrlService {
   /**
    * Creates a [[UrlMatcher]] for the specified pattern.
    *
-   * @param pattern  The URL pattern.
+   * @param urlPattern  The URL pattern.
    * @param config  The config object hash.
    * @returns The UrlMatcher.
    */
-  compile(pattern: any, config: any): UrlMatcher;
+  compile(urlPattern: any, config: any): UrlMatcher;
   /**
    * Returns true if the specified object is a [[UrlMatcher]], or false otherwise.
    *

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

@@ -9,173 +9,69 @@ export class PubSubProvider {
    * @type {PubSub}
    */
   eventBus: PubSub;
-  /**
-   * @returns {PubSub}
-   */
-  $get: () => PubSub;
+  $get: any[];
+  $exceptionHandler: import("../exception/interface.ts").ExceptionHandler;
 }
 export class PubSub {
+  /** @private {Object<string, Array<{fn: Function, context: any}>>} */
+  private _topics;
+  /** @private */
+  private _disposed;
+  /** @type {ng.ExceptionHandlerService} */
+  $exceptionHandler: ng.ExceptionHandlerService;
   /**
-   * Runs a function asynchronously.
-   *
-   * @private
-   * @param {Function} fn Function to run.
-   * @param {Object} context Context in which to run the function.
-   * @param {Array} args Arguments to pass to the function.
-   */
-  private static runAsync_;
-  /**
-   * Topic-based publish/subscribe channel.  Maintains a map of topics to
-   * subscriptions.  When a message is published to a topic, all functions
-   * subscribed to that topic are invoked in the order they were added.
-   * Uncaught errors abort publishing.
-   *
-   * Topics may be identified by any nonempty string, <strong>except</strong>
-   * strings corresponding to native Object properties, e.g. "constructor",
-   * "toString", "hasOwnProperty", etc.
-   *
-   * @param {boolean=} async Enable asynchronous behavior.  Recommended for
-   *     new code.  See notes on the publish() method.
-   */
-  constructor(async?: boolean | undefined);
-  disposed: boolean;
-  /**
-   * The next available subscription key.  Internally, this is an index into the
-   * sparse array of subscriptions.
-   *
-   * @private {number}
-   */
-  private key;
-  /**
-   * Array of subscription keys pending removal once publishing is done.
-   *
-   * @private {!Array<number>}
-   * @const
-   */
-  private pendingKeys;
-  /**
-   * Lock to prevent the removal of subscriptions during publishing. Incremented
-   * at the beginning of {@link #publish}, and decremented at the end.
-   *
-   * @private {number}
+   * Set instance to initial state
    */
-  private publishDepth;
+  reset(): void;
   /**
-   * Sparse array of subscriptions. Each subscription is represented by a tuple
-   * comprising a topic identifier, a function, and an optional context object.
-   * Each tuple occupies three consecutive positions in the array, with the
-   * topic identifier at index n, the function at index (n + 1), the context
-   * object at index (n + 2), the next topic at index (n + 3), etc. (This
-   * representation minimizes the number of object allocations and has been
-   * shown to be faster than an array of objects with three key-value pairs or
-   * three parallel arrays, especially on IE.) Once a subscription is removed
-   * via {@link unsubscribe} or {@link unsubscribeByKey}, the three
-   * corresponding array elements are deleted, and never reused. This means the
-   * total number of subscriptions during the lifetime of the pubsub channel is
-   * limited by the maximum length of a JavaScript array to (2^32 - 1) / 3 =
-   * 1,431,655,765 subscriptions, which should suffice for most applications.
-   *
-   * @private {!Array<?>}
-   * @const
+   * Checks if instance has been disposed.
+   * @returns {boolean} True if disposed.
    */
-  private subscriptions;
-  /**
-   * Map of topics to arrays of subscription keys.
-   *
-   * @private {!Object<!Array<number>>}
-   */
-  private topics;
-  /**
-   * @private @const {boolean}
-   */
-  private async_;
-  /**
-   * Subscribes a function to a topic.  The function is invoked as a method on
-   * the given `opt_context` object, or in the global scope if no context
-   * is specified.  Subscribing the same function to the same topic multiple
-   * times will result in multiple function invocations while publishing.
-   * Returns a subscription key that can be used to unsubscribe the function from
-   * the topic via {@link unsubscribeByKey}.
-   *
-   * @param {string} topic Topic to subscribe to.
-   * @param {Function} fn Function to be invoked when a message is published to
-   *     the given topic.
-   * @param {Object=} opt_context Object in whose context the function is to be
-   *     called (the global scope if none).
-   * @return {number} Subscription key.
-   */
-  subscribe(topic: string, fn: Function, opt_context?: any | undefined): number;
+  isDisposed(): boolean;
   /**
-   * Subscribes a single-use function to a topic.  The function is invoked as a
-   * method on the given `opt_context` object, or in the global scope if
-   * no context is specified, and is then unsubscribed.  Returns a subscription
-   * key that can be used to unsubscribe the function from the topic via
-   * {@link unsubscribeByKey}.
-   *
-   * @param {string} topic Topic to subscribe to.
-   * @param {Function} fn Function to be invoked once and then unsubscribed when
-   *     a message is published to the given topic.
-   * @param {Object=} opt_context Object in whose context the function is to be
-   *     called (the global scope if none).
-   * @return {number} Subscription key.
+   * Dispose the instance, removing all topics and listeners.
    */
-  subscribeOnce(
-    topic: string,
-    fn: Function,
-    opt_context?: any | undefined,
-  ): number;
+  dispose(): void;
   /**
-   * Unsubscribes a function from a topic.  Only deletes the first match found.
-   * Returns a Boolean indicating whether a subscription was removed.
-   *
-   * @param {string} topic Topic to unsubscribe from.
-   * @param {Function} fn Function to unsubscribe.
-   * @param {Object=} opt_context Object in whose context the function was to be
-   *     called (the global scope if none).
-   * @return {boolean} Whether a matching subscription was removed.
+   * Subscribe a function to a topic.
+   * @param {string} topic - The topic to subscribe to.
+   * @param {Function} fn - The callback function to invoke when published.
+   * @param {*} [context] - Optional `this` context for the callback.
+   * @returns {() => boolean} A function that unsubscribes this listener.
    */
-  unsubscribe(
-    topic: string,
-    fn: Function,
-    opt_context?: any | undefined,
-  ): boolean;
+  subscribe(topic: string, fn: Function, context?: any): () => boolean;
   /**
-   * Removes a subscription based on the key returned by {@link subscribe}.
-   * No-op if no matching subscription is found.  Returns a Boolean indicating
-   * whether a subscription was removed.
-   *
-   * @param {number} key Subscription key.
-   * @return {boolean} Whether a matching subscription was removed.
+   * Subscribe a function to a topic only once.
+   * Listener is removed before the first invocation.
+   * @param {string} topic - The topic to subscribe to.
+   * @param {Function} fn - The callback function.
+   * @param {*} [context] - Optional `this` context for the callback.
+   * @returns {() => boolean} A function that unsubscribes this listener.
    */
-  unsubscribeByKey(key: number): boolean;
+  subscribeOnce(topic: string, fn: Function, context?: any): () => boolean;
   /**
-   * Publishes a message to a topic.  Calls functions subscribed to the topic in
-   * 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
-   * any of them throw an uncaught error, publishing is aborted.
-   *
-   * @param {string} topic Topic to publish to.
-   * @param {...*} var_args Arguments that are applied to each subscription
-   *     function.
-   * @return {boolean} Whether any subscriptions were called.
+   * Unsubscribe a specific function from a topic.
+   * Matches by function reference and optional context.
+   * @param {string} topic - The topic to unsubscribe from.
+   * @param {Function} fn - The listener function.
+   * @param {*} [context] - Optional `this` context.
+   * @returns {boolean} True if the listener was found and removed.
    */
-  publish(topic: string, ...var_args: any[]): boolean;
+  unsubscribe(topic: string, fn: Function, context?: any): boolean;
   /**
-   * Clears the subscription list for a topic, or all topics if unspecified.
-   * @param {string=} opt_topic Topic to clear (all topics if unspecified).
+   * Get the number of subscribers for a topic.
+   * @param {string} topic
+   * @returns {number}
    */
-  clear(opt_topic?: string | undefined): void;
+  getCount(topic: string): number;
   /**
-   * Returns the number of subscriptions to the given topic (or all topics if
-   * unspecified). This number will not change while publishing any messages.
-   * @param {string=} opt_topic The topic (all topics if unspecified).
-   * @return {number} Number of subscriptions to the topic.
+   * Publish a value to a topic asynchronously.
+   * All listeners are invoked in the order they were added.
+   * @param {string} topic - The topic to publish.
+   * @param {...*} args - Arguments to pass to listeners.
+   * @returns {boolean} True if any listeners exist for this topic.
    */
-  getCount(opt_topic?: string | undefined): number;
-  isDisposed(): boolean;
-  dispose(): void;
+  publish(topic: string, ...args: any[]): boolean;
 }
 export const EventBus: PubSub;
 /**

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;