@angular-wave/angular.ts 0.14.0 → 0.14.1

package/@types/core/di/ng-module/ng-module.d.ts

@@ -165,14 +165,14 @@ export class NgModule {
   ): NgModule;
   /**
    * @param {string} name
-   * @param {Function} ctor
+   * @param {Function|Object} ctor - A regular function, an arrow function or an object
    * @param {ng.StorageType} type
    * @param {ng.StorageBackend} [backendOrConfig]
    * @returns {NgModule}
    */
   store(
     name: string,
-    ctor: Function,
+    ctor: Function | any,
     type: ng.StorageType,
     backendOrConfig?: ng.StorageBackend,
   ): NgModule;

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

@@ -9,174 +9,69 @@ export class PubSubProvider {
    * @type {PubSub}
    */
   eventBus: PubSub;
-  /**
-   * @returns {PubSub}
-   */
-  $get: () => PubSub;
+  $get: any[];
+  $exceptionHandler: import("../exception/interface.ts").ExceptionHandler;
 }
 export class PubSub {
-  static $nonscope: any;
-  /**
-   * 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;
+  /** @private {Object<string, Array<{fn: Function, context: any}>>} */
+  private _topics;
+  /** @private */
+  private _disposed;
+  /** @type {ng.ExceptionHandlerService} */
+  $exceptionHandler: ng.ExceptionHandlerService;
   /**
-   * 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 `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.
-   * @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/shared/utils.d.ts

@@ -93,10 +93,7 @@ export function notNullOrUndefined(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.
@@ -437,6 +434,7 @@ 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.
@@ -459,6 +457,13 @@ export function validateRequired(arg: any, name: string): any;
  * @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.
  */
@@ -626,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";