@angular-wave/angular.ts 0.7.2 → 0.7.4

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

@@ -0,0 +1,33 @@
+/**
+ * A function that logs messages. Accepts any number of arguments.
+ */
+export type LogCall = (...args: any[]) => void;
+/**
+ * A function that returns a LogService implementation.
+ */
+export type LogServiceFactory = (...args: any[]) => LogService;
+/**
+ * Service for logging messages at various levels.
+ */
+export interface LogService {
+  /**
+   * Log a debug message.
+   */
+  debug: LogCall;
+  /**
+   * Log an error message.
+   */
+  error: LogCall;
+  /**
+   * Log an info message.
+   */
+  info: LogCall;
+  /**
+   * Log a general message.
+   */
+  log: LogCall;
+  /**
+   * Log a warning message.
+   */
+  warn: LogCall;
+}

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

@@ -0,0 +1,25 @@
+/**
+ * Configuration provider for `$log` service
+ */
+export class LogProvider {
+  /** @type {boolean} */
+  debug: boolean;
+  /** @private @type {import("./interface.ts").LogServiceFactory | null} */
+  private _override;
+  /**
+   * Override the default {@link LogService} implemenation
+   * @param {import("./interface.ts").LogServiceFactory} fn
+   */
+  setLogger(fn: import("./interface.ts").LogServiceFactory): void;
+  /** @private */
+  private formatError;
+  /**
+   * @private
+   * @param {string} type
+   */
+  private consoleLog;
+  /**
+   * @returns {import("./interface.ts").LogService}
+   */
+  $get(): import("./interface.ts").LogService;
+}

package/@types/{core → services}/pubsub/pubsub.d.ts

@@ -2,9 +2,9 @@
 
 /**
  * Configurable provider for an injectable event bus
- * @implements {ServiceProvider}
+ * @extends {ServiceProvider}
  */
-export class PubSubProvider implements ServiceProvider {
+export class PubSubProvider {
   /**
    * @type {PubSub}
    */
@@ -34,10 +34,10 @@ export class PubSub {
    * strings corresponding to native Object properties, e.g. "constructor",
    * "toString", "hasOwnProperty", etc.
    *
-   * @param {boolean=} opt_async Enable asynchronous behavior.  Recommended for
+   * @param {boolean=} async Enable asynchronous behavior.  Recommended for
    *     new code.  See notes on the publish() method.
    */
-  constructor(opt_async?: boolean | undefined);
+  constructor(async?: boolean | undefined);
   disposed: boolean;
   /**
    * The next available subscription key.  Internally, this is an index into the
@@ -69,7 +69,7 @@ export class PubSub {
    * 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
+   * 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 =
@@ -95,7 +95,7 @@ export class PubSub {
    * 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}.
+   * 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
@@ -110,7 +110,7 @@ export class PubSub {
    * 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}.
+   * {@link unsubscribeByKey}.
    *
    * @param {string} topic Topic to subscribe to.
    * @param {Function} fn Function to be invoked once and then unsubscribed when
@@ -140,7 +140,7 @@ export class PubSub {
     opt_context?: any | undefined,
   ): boolean;
   /**
-   * Removes a subscription based on the key returned by {@link #subscribe}.
+   * 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.
    *
@@ -153,7 +153,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 setTimeout().  Otherwise, the functions are called directly, and if
+   * 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.

package/@types/services/template-cache/interface.d.ts

@@ -0,0 +1,4 @@
+/**
+ * A cache for mapping template names to their respective content.
+ */
+export type TemplateCache = Map<string, string>;

package/@types/services/template-cache/template-cache.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Provides an instance of a cache that can be used to store and retrieve template content.
+ */
+export class TemplateCacheProvider {
+  /** @type {import('./interface.ts').TemplateCache} */
+  cache: import("./interface.ts").TemplateCache;
+  /**
+   * @returns {import('./interface.ts').TemplateCache}
+   */
+  $get: () => import("./interface.ts").TemplateCache;
+}

package/@types/services/template-request.d.ts

@@ -44,7 +44,7 @@ export class TemplateRequestProvider {
     | string
     | ((
         $exceptionHandler: import("../core/exception-handler.js").ErrorHandler,
-        $templateCache: import("../core/cache/cache-factory.js").TemplateCache,
+        $templateCache: import("../services/template-cache/interface.ts").TemplateCache,
         $http: any,
         $sce: any,
       ) => {

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

@@ -0,0 +1,9 @@
+/**
+ * Expando cache for adding properties to DOM nodes with JavaScript.
+ * This used to be an Object in JQLite decorator, but swapped out for a Map
+ * for performance reasons and convenience methods. A proxy is available for
+ * additional logic handling.
+ *
+ * @type {Map<number, import('../interface.ts').ExpandoStore>}
+ */
+export const Cache: Map<number, import("../interface.ts").ExpandoStore>;

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

@@ -166,8 +166,13 @@ export function arrayTuples(...args: any[]): any[][];
  * ```
  */
 export function applyPairs(memo: any, keyValTuple: any): any;
-/** Get the last element of an array */
-export function tail(arr: any): any;
+/**
+ * Returns the last element of an array, or undefined if the array is empty.
+ * @template T
+ * @param {T[]} arr - The input array.
+ * @returns {T | undefined} The last element or undefined.
+ */
+export function tail<T>(arr: T[]): T | undefined;
 /**
  * shallow copy from src to dest
  */
@@ -179,22 +184,16 @@ export function copy(src: any, dest: any): any;
 export const removeFrom: any;
 /** pushes a values to an array and returns the value */
 export const pushTo: any;
-export function deregAll(functions: any): any;
 export function allTrueR(memo: any, elem: any): any;
 export function anyTrueR(memo: any, elem: any): any;
 export function unnestR(memo: any, elem: any): any;
 export function flattenR(memo: any, elem: any): any;
 export function uniqR(acc: any, token: any): any;
 export function unnest(arr: any): any;
-export function flatten(arr: any): any;
 export function assertPredicate(
   predicateOrMap: any,
   errMsg?: string,
 ): (obj: any) => any;
-export function assertMap(
-  predicateOrMap: any,
-  errMsg?: string,
-): (obj: any) => any;
 export function pairs(obj: any): any[][];
 export function silenceUncaughtInPromise(promise: any): any;
 export function silentRejection(error: any): any;

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

@@ -25,12 +25,12 @@ export function removeElementData(element: Element, name?: string): void;
  *
  * @param {Element} element
  * @param {boolean} [createIfNecessary=false]
- * @returns {import("../core/cache/cache.js").ExpandoStore}
+ * @returns {import("../interface.ts").ExpandoStore}
  */
 export function getExpando(
   element: Element,
   createIfNecessary?: boolean,
-): import("../core/cache/cache.js").ExpandoStore;
+): import("../interface.ts").ExpandoStore;
 /**
  * Checks if the string contains HTML tags or entities.
  * @param {string} html

package/Makefile

@@ -29,8 +29,13 @@ types:
 	@echo "Generating *.d.ts"
 	@npx -p typescript tsc --project tsconfig.types.json
 
-jsdoc: 
+
+TYPEDOC_DIR = docs/static/typedoc
+typedoc: types pretty
+	@rm -rf $(TYPEDOC_DIR)
 	@npm run generate-docs
+	@npx prettier ./typedoc --write
+	mv typedoc $(TYPEDOC_DIR)
 
 serve:
 	@npm run serve
@@ -46,3 +51,6 @@ test:
 test-ui:
 	@echo $(INFO) "Playwright test JS with ui"
 	@$(PLAYWRIGHT_TEST) --ui
+
+hugo:
+	hugo server --source=docs --disableFastRender