@angular-wave/angular.ts 0.15.1 → 0.16.0

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

@@ -0,0 +1,20 @@
+/**
+ * WebSocketProvider
+ * Provides a pre-configured WebSocket connection as an injectable.
+ */
+export class WebSocketProvider {
+  /** @type {ng.WebSocketConfig} */
+  defaults: ng.WebSocketConfig;
+  $get: (
+    | string
+    | ((
+        log: ng.LogService,
+      ) => (
+        url: string,
+        protocols?: string[],
+        config?: import("./interface.ts").WebSocketConfig,
+      ) => StreamConnection)
+  )[];
+  _$log: import("../log/interface.ts").LogService;
+}
+import { StreamConnection } from "../stream/stream.js";

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

@@ -1,4 +1,8 @@
-export function equals(o1: any, o2: any): boolean;
+/**
+ * @param {unknown} o1
+ * @param {unknown} o2
+ */
+export function equals(o1: unknown, o2: unknown): boolean;
 /**
  * prototypal inheritance helper.
  * Creates a new object which has `parent` object as its prototype, and then copies the properties from `extra` onto it
@@ -15,25 +19,46 @@ export function inherit(parent: any, extra?: any): any;
 /**
  * Given an array, and an item, if the item is found in the array, it removes it (in-place).
  * The same array is returned
- * @param {Array} array
+ * @param {Array<any>} array
  * @param {any} obj
- * @returns {Array}
+ * @returns {Array<any>}
  */
-export function removeFrom(array: any[], obj: any): any[];
+export function removeFrom(array: Array<any>, obj: any): Array<any>;
 /**
  * Applies a set of defaults to an options object.  The options object is filtered
  * to only those properties of the objects in the defaultsList.
  * Earlier objects in the defaultsList take precedence when applying defaults.
+ * @param {{}} opts
+ * @param {{ current?: (() => void) | (() => null); transition?: null; traceData?: {}; bind?: null; inherit?: boolean; matchingKeys?: null; state?: { params: {}; }; strict?: boolean; caseInsensitive?: boolean; relative?: import("../router/state/state-object.js").StateObject | null | undefined; location?: boolean; notify?: boolean; reload?: boolean; supercede?: boolean; custom?: {}; source?: string; lossy?: boolean; absolute?: boolean; }[]} defaultsList
  */
-export function defaults(opts: any, ...defaultsList: any[]): any;
-/**
- * Finds the common ancestor path between two states.
- *
- * @param {Object} first The first state.
- * @param {Object} second The second state.
- * @return {Array} Returns an array of state names in descending order, not including the root.
- */
-export function ancestors(first: any, second: any): any[];
+export function defaults(
+  opts: {},
+  ...defaultsList: {
+    current?: (() => void) | (() => null);
+    transition?: null;
+    traceData?: {};
+    bind?: null;
+    inherit?: boolean;
+    matchingKeys?: null;
+    state?: {
+      params: {};
+    };
+    strict?: boolean;
+    caseInsensitive?: boolean;
+    relative?:
+      | import("../router/state/state-object.js").StateObject
+      | null
+      | undefined;
+    location?: boolean;
+    notify?: boolean;
+    reload?: boolean;
+    supercede?: boolean;
+    custom?: {};
+    source?: string;
+    lossy?: boolean;
+    absolute?: boolean;
+  }[]
+): any;
 /**
  * Return a copy of the object only containing the whitelisted properties.
  *
@@ -77,18 +102,17 @@ export function assertFn(
 /**
  * Given two or more parallel arrays, returns an array of tuples where
  * each tuple is composed of [ a[i], b[i], ... z[i] ]
- *
- * @example
- * ```
- *
- * let foo = [ 0, 2, 4, 6 ];
- * let bar = [ 1, 3, 5, 7 ];
- * let baz = [ 10, 30, 50, 70 ];
- * arrayTuples(foo, bar);       // [ [0, 1], [2, 3], [4, 5], [6, 7] ]
- * arrayTuples(foo, bar, baz);  // [ [0, 1, 10], [2, 3, 30], [4, 5, 50], [6, 7, 70] ]
- * ```
+ * @example ```
+
+let foo = [ 0, 2, 4, 6 ];
+let bar = [ 1, 3, 5, 7 ];
+let baz = [ 10, 30, 50, 70 ];
+arrayTuples(foo, bar);       // [ [0, 1], [2, 3], [4, 5], [6, 7] ]
+arrayTuples(foo, bar, baz);  // [ [0, 1, 10], [2, 3, 30], [4, 5, 50], [6, 7, 70] ]
+```
+ * @param {any[][]} args
  */
-export function arrayTuples(...args: any[]): any[][];
+export function arrayTuples(...args: any[][]): any[][];
 /**
  * Reduce function which builds an object from an array of [key, value] pairs.
  *
@@ -131,6 +155,3 @@ export function assertPredicate(
   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/constants.d.ts

@@ -8,11 +8,5 @@ export const EMPTY_CLASS: "ng-empty";
 export const NOT_EMPTY_CLASS: "ng-not-empty";
 export const PREFIX_REGEXP: RegExp;
 export const SPECIAL_CHARS_REGEXP: RegExp;
-export namespace ALIASED_ATTR {
-  let ngMinlength: string;
-  let ngMaxlength: string;
-  let ngMin: string;
-  let ngMax: string;
-  let ngPattern: string;
-  let ngStep: string;
-}
+/** @type {Record<string, string>} */
+export const ALIASED_ATTR: Record<string, string>;

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

@@ -11,24 +11,24 @@ export function kebabToCamel(name: string): string;
  */
 export function snakeToCamel(name: string): string;
 /**
- * Removes expando data from this element. If key is provided, only
- * its field is removed. If data is empty, also removes `ExpandoStore`
- * from cache.
- * @param {Element} element
- * @param {string} [name] - key of field to remove
+ * @param {Element & Record<string, any>} element
+ * @param {string} [name]
  */
-export function removeElementData(element: Element, name?: string): void;
+export function removeElementData(
+  element: Element & Record<string, any>,
+  name?: string,
+): void;
 /**
  * Stores data associated with an element inside the expando property of the DOM element.
  *
  * @see {@link https://developer.mozilla.org/en-US/docs/Glossary/Expando MDN Glossary: Expando}
  *
- * @param {Element} element
+ * @param {Element & Record<string, any> } element
  * @param {boolean} [createIfNecessary=false]
  * @returns {import("../interface.ts").ExpandoStore}
  */
 export function getExpando(
-  element: Element,
+  element: Element & Record<string, any>,
   createIfNecessary?: boolean,
 ): import("../interface.ts").ExpandoStore;
 /**
@@ -38,22 +38,30 @@ export function getExpando(
  */
 export function isTextNode(html: string): boolean;
 /**
- * @param {Element} element
+ * @param {Element & Record<string, any>} element
+ * @param {Element & Record<string, any>} element
  * @param {boolean} [onlyDescendants]
  * @returns {void}
  */
-export function dealoc(element: Element, onlyDescendants?: boolean): void;
+export function dealoc(
+  element: Element & Record<string, any>,
+  onlyDescendants?: boolean,
+): void;
 /**
  * Gets or sets cache data for a given element.
  *
  * @param {Element} element - The DOM element to get or set data on.
- * @param {string|Object} key - The key (as a string) to get/set or an object for mass-setting.
+ * @param {string|Object.<string, any>} key - The key to get/set or an object for mass-setting.
  * @param {*} [value] - The value to set. If not provided, the function acts as a getter.
- * @returns {*} - The retrieved data if acting as a getter. Otherwise, returns undefined.
+ * @returns {*} - The retrieved data if acting as a getter. Otherwise, undefined.
  */
 export function getOrSetCacheData(
   element: Element,
-  key: string | any,
+  key:
+    | string
+    | {
+        [x: string]: any;
+      },
   value?: any,
 ): any;
 /**
@@ -128,10 +136,11 @@ export function getController(
   name?: string,
 ): ng.Scope | undefined;
 /**
+ * Walk up the DOM tree (including Shadow DOM) to get inherited data.
  *
- * @param {Node} element
- * @param {string} name
- * @returns
+ * @param {Node} element - The starting element (or document/document fragment)
+ * @param {string} name - The data key to look up
+ * @returns {any} - The found value, or undefined if not found
  */
 export function getInheritedData(element: Node, name: string): any;
 /**
@@ -149,10 +158,10 @@ export function removeElement(element: Element, keepData?: boolean): void;
 export function startingTag(elementOrStr: string | Element | Node): string;
 /**
  * Return the DOM siblings between the first and last node in the given array.
- * @param {Array<Node>} nodes An array-like object
- * @returns {*[]|Array<Node>} the inputted object or a JQLite collection containing the nodes
+ * @param {Node[]} nodes
+ * @returns {Node[]}
  */
-export function getBlockNodes(nodes: Array<Node>): any[] | Array<Node>;
+export function getBlockNodes(nodes: Node[]): Node[];
 /**
  * Gets the name of a boolean attribute if it exists on a given element.
  *
@@ -230,6 +239,11 @@ export function animatedomInsert(
  * @returns {string} The base href.
  */
 export function getBaseHref(): string;
+/**
+ * @param {NodeList|Node} element
+ * @returns {Node | undefined}
+ */
+export function extractElementNode(element: NodeList | Node): Node | undefined;
 /**
  * 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

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

@@ -23,14 +23,14 @@ export function deProxy<T>(
 export function nextUid(): number;
 /**
  *
- * @description Converts the specified string to lowercase.
+ *  Converts the specified string to lowercase.
  * @param {string} string String to be converted to lowercase.
  * @returns {string} Lowercased string.
  */
 export function lowercase(string: string): string;
 /**
  *
- * @description Converts the specified string to uppercase.
+ *  Converts the specified string to uppercase.
  * @param {string} string String to be converted to uppercase.
  * @returns {string} Uppercased string.
  */
@@ -133,9 +133,9 @@ export function isNumber(value: unknown): value is number;
  * Determines if a value is a date.
  *
  * @param {*} value Reference to check.
- * @returns {boolean} True if `value` is a `Date`.
+ * @returns {value is Date} True if `value` is a `Date`.
  */
-export function isDate(value: any): boolean;
+export function isDate(value: any): value is Date;
 /**
  * Determines if a reference is an `Error`.
  * Loosely based on https://www.npmjs.com/package/iserror
@@ -148,16 +148,16 @@ export function isError(value: any): value is Error;
  * Determines if a reference is a `Function`.
  *
  * @param {*} value Reference to check.
- * @returns {boolean} True if `value` is a `Function`.
+ * @returns {value is Function} True if `value` is a `Function`.
  */
-export function isFunction(value: any): boolean;
+export function isFunction(value: any): value is Function;
 /**
  * Determines if a value is a regular expression object.
  *
  * @param {*} value Reference to check.
- * @returns {boolean} True if `value` is a `RegExp`.
+ * @returns {value is RegExp} True if `value` is a `RegExp`.
  */
-export function isRegExp(value: any): boolean;
+export function isRegExp(value: any): value is RegExp;
 /**
  * Checks if `obj` is a window object.
  *
@@ -195,16 +195,6 @@ export function isBoolean(value: any): boolean;
  * @returns {boolean}
  */
 export function isPromiseLike(obj: any): boolean;
-/**
- * @param {*} value
- * @returns {boolean}
- */
-export function isTypedArray(value: any): boolean;
-/**
- * @param {*} obj
- * @returns {boolean}
- */
-export function isArrayBuffer(obj: any): boolean;
 /**
  * @param {*} value
  * @returns {string | *}

package/README.md

@@ -3,12 +3,13 @@
 ![Build status](https://github.com/angular-wave/angular.ts/actions/workflows/ci.yml/badge.svg)
 [![stats](https://data.jsdelivr.com/v1/package/npm/@angular-wave/angular.ts/badge?style=rounded)](https://www.jsdelivr.com/package/npm/@angular-wave/angular.ts)
 
-This project preserves, modernises and expands the original [AngularJS](https://angularjs.org/)
+This project preserves, modernizes and expands the original [AngularJS](https://angularjs.org/)
 framework. AngularTS is "AngularJS: The Good Parts". It takes the three core pillars of the original – a string-interpolation engine,
-dependency injection, two-way data-binding – and adds a reactive change-detection model on top of modern build tooling with strong typechecking of TypeScript.
+dependency injection, two-way data-binding – and adds a reactive change-detection model on top of modern build tooling 
+with strong typechecking of TypeScript.
 
-With AngularJS, you get a decade-long optimization effort of Angular Team at Google, plus a massive testing suite, required for applications like Google Cloud and Kubernetes.
-AngularTS adds:
+With AngularJS, you get a decade-long optimization effort of Angular Team at Google, plus a massive testing suite.
+AngularTS builds on that foundation and adds:
 
 - a fully reactive change-detection model without digests or virtual DOMs, like `Vue`
 - access to native DOM APIs at component and directive level (no `JQuery`or `JQLite`)
@@ -16,10 +17,17 @@ AngularTS adds:
 - built-in enterprise-level router (`ui-router` ported as `ng-router`)
 - built-in animations (`animate`)
 - new directives, inspired by `HTMX`
-- new injectables for REST resources, persistent stores, Web Workers and WASM modules
+- new injectables for REST resources, persistent stores, Web Workers, EventSources, WebSockets and WASM modules
 
-The result is a high-performance, buildless, progressive and battle-tested JS framework that stays as close to Web standards as possible.
-If you write server-rendered web applications for desktop and mobile, and do not wish to leave the comfort of your tech-stack, this is your new secret weapon.
+The result is a high-performance, buildless, multi-paradigm and battle-tested JS framework that stays as close to Web standards as possible.
+
+If you: 
+
+- Build server-rendered web applications for desktop and mobile
+- Want a tools that is easy to get started with, yet remains expert-friendly at scale
+- Make no compromises on performance (think McMaster-Carr) 
+
+then AngularTS is your new (old) secret weapon.
 
 ### Getting started