@angular-wave/angular.ts 0.0.59 → 0.0.61

package/src/core/scope/scope.js

@@ -28,6 +28,20 @@ export const ScopePhase = {
  * @property {Object} locals
  */
 
+/**
+ * @typedef {function(any, any, Scope): any} WatchListener
+ * Callback function triggered whenever the value of `watchExpression` changes.
+ *
+ * @param {any} newVal - The current value of the `watchExpression`.
+ * @param {any} oldVal - The previous value of the `watchExpression`.
+ * @param {Scope} scope - The current scope in which the `watchExpression` is evaluated.
+ *
+ */
+
+/**
+ * @typedef {string | ((scope: Scope) => any)} WatchExpression
+ */
+
 /**
  *
  * The default number of `$digest` iterations the scope should attempt to execute before giving up and
@@ -378,12 +392,7 @@ export class Scope {
  *
  *    - `string`: Evaluated as {@link guide/expression expression}
  *    - `function(scope)`: called with current `scope` as a parameter.
- * @param {(newVal: any, oldVal: any, scope: Scope) => any} listener Callback called whenever the value
- *    of `watchExpression` changes.
- *
- *    - `newVal` contains the current value of the `watchExpression`
- *    - `oldVal` contains the previous value of the `watchExpression`
- *    - `scope` refers to the current scope
+ * @param {WatchListener} listener
  * @param {boolean=} [objectEquality=false] Compare for object equality using {@link angular.equals} instead of
  *     comparing for reference equality.
  * @returns {function()} Returns a deregistration function for this listener.
@@ -687,7 +696,7 @@ export class Scope {
         }
       }
     }
-
+    // TODO: fix this type signature
     return this.$watch(changeDetector, $watchCollectionAction);
   }
 
@@ -1282,7 +1291,8 @@ export class Scope {
     if (expr) {
       $$applyAsyncQueue.push(() => scope.$eval(expr));
     }
-    expr = $parse(expr);
+    // TODO: investigate
+    //expr = $parse(expr);
 
     if (applyAsyncId === null) {
       applyAsyncId = $browser.defer(flushApplyAsync, null, "$applyAsync");

package/src/directive/if/if.js

@@ -17,7 +17,12 @@ export function ngIfDirective($animate) {
     terminal: true,
     restrict: "A",
     /**
-     * TODO add type for $transclude service
+     *
+     * @param {*} $scope
+     * @param {*} $element
+     * @param {*} $attr
+     * @param {*} _ctrl
+     * @param {*} $transclude
      */
     link($scope, $element, $attr, _ctrl, $transclude) {
       /** @type {{clone: import("../../shared/jqlite/jqlite").JQLite }} */

package/src/filters/limit-to.js

@@ -19,14 +19,17 @@ export function limitToFilter() {
     if (Math.abs(Number(limit)) === Infinity) {
       limit = Number(limit);
     } else {
-      limit = toInt(limit);
+      limit = toInt(/** @type {String} */ (limit));
     }
     if (isNumberNaN(limit)) return input;
 
     if (isNumber(input)) input = input.toString();
     if (!isArrayLike(input)) return input;
 
-    begin = !begin || isNaN(/** @type {any} */ (begin)) ? 0 : toInt(begin);
+    begin =
+      !begin || isNaN(/** @type {any} */ (begin))
+        ? 0
+        : toInt(/** @type {String} */ (begin));
     begin =
       begin < 0 ? Math.max(0, /** @type {[]} */ (input).length + begin) : begin;
 

package/src/loader.js

@@ -275,10 +275,6 @@ export class Angular {
   }
 
   /**
-   * @ngdoc function
-   * @name angular.module
-   * @module ng
-   * @description
    *
    * The `angular.module` is a global place for creating, registering and retrieving AngularJS
    * modules.
@@ -414,7 +410,7 @@ export class Angular {
 
         /**
          * @ngdoc property
-         * @name import('./types').Module#requires
+         * @type import('./types').Module#requires
          * @module ng
          *
          * @description

package/src/router/params/param-type.js

@@ -35,10 +35,11 @@ export class ParamType {
     /** @inheritdoc */
     this.inherit = true;
     Object.assign(this, def);
+    this.name = undefined;
   }
   // consider these four methods to be "abstract methods" that should be overridden
   /** @inheritdoc */
-  is() {
+  is(_val) {
     return true;
   }
   /** @inheritdoc */

package/src/router/state/views.js

@@ -97,6 +97,8 @@ export class Ng1ViewConfig {
     this.path = path;
     this.viewDecl = viewDecl;
     this.factory = factory;
+    this.component = undefined;
+    this.template = undefined;
 
     /** @type {Number} */ this.$id = id++;
     this.loaded = false;
@@ -110,6 +112,7 @@ export class Ng1ViewConfig {
           )
         : this.template;
   }
+
   load() {
     const $q = services.$q;
     const context = new ResolveContext(this.path);

package/src/router/transition/reject-factory.js

@@ -105,6 +105,7 @@ export class Rejection {
     this.type = type;
     this.message = message;
     this.detail = detail;
+    this.redirected = false;
   }
   toString() {
     const detailString = (d) =>

package/src/router/url/url-rule.js

@@ -192,11 +192,11 @@ export class UrlRuleFactory {
 }
 UrlRuleFactory.isUrlRule = (obj) =>
   obj && ["type", "match", "handler"].every((key) => isDefined(obj[key]));
+
 /**
  * A base rule which calls `match`
  *
  * The value from the `match` function is passed through to the `handler`.
- * @type {angular.BaseUrlRule}
  */
 export class BaseUrlRule {
   constructor(match, handler) {

package/src/router/url/url-service.js

@@ -26,7 +26,7 @@ export class UrlService {
   ];
 
   /**
-   * @param {angular.ILocationProvider} $locationProvider
+   * @param {import("../../core/location/location").$LocationProvider} $locationProvider
    */
   constructor($locationProvider, stateService, globals, urlConfigProvider) {
     this.stateService = stateService;
@@ -53,7 +53,7 @@ export class UrlService {
      * The nested [[UrlConfig]] API to configure the URL and retrieve URL information
      *
      * See: [[UrlConfig]] for details
-     * @type {angular.UrlConfig}
+     * @type {import("./url-config").UrlConfigProvider}
      */
     this.config = urlConfigProvider;
 
@@ -231,7 +231,7 @@ export class UrlService {
       hash: this.hash(),
     };
     /**
-     * @type {angular.MatchResult}
+     * @type {MatchResult}
      */
     const best = this.match(url);
     const applyResult = pattern([
@@ -313,7 +313,7 @@ export class UrlService {
    *
    * Given a URL (as a [[UrlParts]] object), check all rules and determine the best matching rule.
    * Return the result as a [[MatchResult]].
-   * @returns {angular.MatchResult}
+   * @returns {any}
    */
   match(url) {
     url = Object.assign({ path: "", search: {}, hash: "" }, url);

package/src/services/http/http.js

@@ -275,9 +275,9 @@ function headersGetter(headers) {
  * This function is used for both request and response transforming
  *
  * @param {*} data Data to transform.
- * @param {function(string=)} headers HTTP headers getter fn.
+ * @param {function(string=):any} headers HTTP headers getter fn.
  * @param {number} status HTTP status code of the response.
- * @param {Function|Array<Function>} fns Function or an array of functions.
+ * @param {function(...any): any | Array<Function>} fns Function or an array of functions.
  * @returns {*} Transformed data.
  */
 function transformData(data, headers, status, fns) {
@@ -285,9 +285,11 @@ function transformData(data, headers, status, fns) {
     return fns(data, headers, status);
   }
 
-  forEach(fns, (fn) => {
-    data = fn(data, headers, status);
-  });
+  if (Array.isArray(fns)) {
+    /** @type {Array<function(...any): any>} */ (fns).forEach((fn) => {
+      data = fn(data, headers, status);
+    });
+  }
 
   return data;
 }

package/src/services/template-request.js

@@ -4,11 +4,6 @@ import { extend, isString, isUndefined, minErr } from "../shared/utils";
 var $templateRequestMinErr = minErr("$templateRequest");
 
 /**
- * @ngdoc provider
- * @name $templateRequestProvider
- * @this
- *
- * @description
  * Used to configure the options passed to the {@link $http} service when making a template request.
  *
  * For example, it can be used for specifying the "Accept" header that is sent to the server, when
@@ -27,8 +22,8 @@ export function TemplateRequestProvider() {
    * The {@link $templateRequest} will set the `cache` and the `transformResponse` properties of the
    * options if not overridden here.
    *
-   * @param {string=} value new value for the {@link $http} options.
-   * @returns {string|self} Returns the {@link $http} options when used as getter and self if used as setter.
+   * @param {string=} val new value for the {@link $http} options.
+   * @returns {string|TemplateRequestProvider} Returns the {@link $http} options when used as getter and self if used as setter.
    */
   this.httpOptions = function (val) {
     if (val) {

package/src/shared/common.js

@@ -345,7 +345,7 @@ export function assertFn(predicateOrMap, errMsg = "assert failure") {
   return (obj) => {
     const result = predicateOrMap(obj);
     if (!result) {
-      throw new Error(isFunction(errMsg) ? errMsg(obj) : errMsg);
+      throw new Error(errMsg);
     }
     return result;
   };

package/src/shared/utils.js

@@ -894,7 +894,7 @@ export function toJson(obj, pretty) {
   if (!isNumber(pretty)) {
     pretty = pretty ? 2 : null;
   }
-  return JSON.stringify(obj, toJsonReplacer, pretty);
+  return JSON.stringify(obj, toJsonReplacer, /** @type {Number} */ (pretty));
 }
 
 /**

package/src/types.js

@@ -202,12 +202,18 @@
  * https://docs.angularjs.org/api/ng/service/$compile#-controller-
  * http://teropa.info/blog/2015/06/09/transclusion.html
  *
- * @typedef {Object} TranscludeFunction
+ * @typedef {Object} TranscludeFunctionObject
  * @property {function(TScope, CloneAttachFunction, import('./shared/jqlite/jqlite').JQLite=, string=): import('./shared/jqlite/jqlite').JQLite} transcludeWithScope
  * @property {function(CloneAttachFunction=, import('./shared/jqlite/jqlite').JQLite=, string=): import('./shared/jqlite/jqlite').JQLite} transcludeWithoutScope
  * @property {function(string): boolean} isSlotFilled - Returns true if the specified slot contains content (i.e., one or more DOM nodes)
  */
 
+/**
+
+ *
+ * @typedef {function(TScope, CloneAttachFunction, import('./shared/jqlite/jqlite').JQLite=, string=): import('./shared/jqlite/jqlite').JQLite} TranscludeFunction
+ */
+
 /**
  * @typedef {function(TScope, CloneAttachFunction, import('./shared/jqlite/jqlite').JQLite=, string=): import('./shared/jqlite/jqlite').JQLite} transcludeWithScope
  */
@@ -264,6 +270,8 @@
  * HTML template URL.
  * @property {boolean | "element" | { [slot: string]: string } | undefined} [transclude]
  * Transclusion options.
+ * @property {function(...any): any} [$$addStateInfo]
+ * Hidden properties added by router
  */
 
 /**

package/types/core/parser/parse.d.ts

@@ -4,6 +4,7 @@
  * @property {boolean} constant - Indicates if the expression is constant.
  * @property {boolean} isPure
  * @property {boolean} oneTime
+ * @property {function(import('../scope/scope').Scope, import('../scope/scope').WatchListener, boolean, CompiledExpression, string | ((scope:  import('../scope/scope').Scope) => any)): any} $$watchDelegate
  * @property {any[]} inputs
  * @property {function(any, any): any} assign - Assigns a value to a context. If value is not provided,
  */
@@ -46,10 +47,7 @@ export class $ParseProvider {
      * @returns {$ParseProvider}
      */
     setIdentifierFns: (identifierStart?: (arg0: any) => boolean, identifierContinue?: (arg0: any) => boolean) => $ParseProvider;
-    $get: (string | (($filter: any) => {
-        (exp: any, interceptorFn: any): any;
-        $$getAst: (exp: string) => import("./ast").ASTNode;
-    }))[];
+    $get: (string | (($filter: (any: any) => any) => ParseService))[];
 }
 export function constantWatchDelegate(scope: any, listener: any, objectEquality: any, parsedExpression: any): any;
 export type CompiledExpressionProps = {
@@ -63,6 +61,7 @@ export type CompiledExpressionProps = {
     constant: boolean;
     isPure: boolean;
     oneTime: boolean;
+    $$watchDelegate: (arg0: import("../scope/scope").Scope, arg1: import("../scope/scope").WatchListener, arg2: boolean, arg3: CompiledExpression, arg4: string | ((scope: import("../scope/scope").Scope) => any)) => any;
     inputs: any[];
     /**
      * - Assigns a value to a context. If value is not provided,

package/types/core/parser/parser.d.ts

@@ -20,7 +20,7 @@ export class Parser {
     /**
      *
      * @param {string} exp - Expression to be parsed
-     * @returns
+     * @returns {import("./parse").CompiledExpression}
      */
     parse(exp: string): import("./parse").CompiledExpression;
     /**

package/types/core/q/q.d.ts

@@ -18,10 +18,10 @@ export class $QProvider {
      * This feature is enabled by default.
      *
      * @param {boolean=} value Whether to generate an error when a rejected promise is not handled.
-     * @returns {boolean|ng.$qProvider} Current value when called without a new value or self for
+     * @returns {boolean|$QProvider} Current value when called without a new value or self for
      *    chaining otherwise.
      */
-    errorOnUnhandledRejections: (value?: boolean | undefined) => boolean | ng.$qProvider;
+    errorOnUnhandledRejections: (value?: boolean | undefined) => boolean | $QProvider;
 }
 export function $$QProvider(): void;
 export class $$QProvider {

package/types/core/sanitize/sanitize-uri.d.ts

@@ -22,10 +22,10 @@ export class SanitizeUriProvider {
      * to the DOM it is inactive and potentially malicious code will not be executed.
      *
      * @param {RegExp=} regexp New regexp to trust urls with.
-     * @returns {RegExp|ng.ICompileProvider} Current RegExp if called without value or self for
+     * @returns {RegExp|SanitizeUriProvider} Current RegExp if called without value or self for
      *    chaining otherwise.
      */
-    aHrefSanitizationTrustedUrlList: (regexp?: RegExp | undefined) => RegExp | ng.ICompileProvider;
+    aHrefSanitizationTrustedUrlList: (regexp?: RegExp | undefined) => RegExp | SanitizeUriProvider;
     /**
      * @description
      * Retrieves or overrides the default regular expression that is used for determining trusted safe
@@ -45,9 +45,8 @@ export class SanitizeUriProvider {
      * to the DOM it is inactive and potentially malicious code will not be executed.
      *
      * @param {RegExp=} regexp New regexp to trust urls with.
-     * @returns {RegExp|ng.$compileProvider} Current RegExp if called without value or self for
-     *    chaining otherwise.
+     * @returns {RegExp|SanitizeUriProvider} Current RegExp if called without value or self for chaining otherwise.
      */
-    imgSrcSanitizationTrustedUrlList: (regexp?: RegExp | undefined) => RegExp | ng.$compileProvider;
+    imgSrcSanitizationTrustedUrlList: (regexp?: RegExp | undefined) => RegExp | SanitizeUriProvider;
     $get: () => (uri: any, isMediaUrl: any) => any;
 }

package/types/core/scope/scope.d.ts

@@ -31,6 +31,18 @@ export type TTL = number;
  * @property {Function} fn
  * @property {Object} locals
  */
+/**
+ * @typedef {function(any, any, Scope): any} WatchListener
+ * Callback function triggered whenever the value of `watchExpression` changes.
+ *
+ * @param {any} newVal - The current value of the `watchExpression`.
+ * @param {any} oldVal - The previous value of the `watchExpression`.
+ * @param {Scope} scope - The current scope in which the `watchExpression` is evaluated.
+ *
+ */
+/**
+ * @typedef {string | ((scope: Scope) => any)} WatchExpression
+ */
 /**
  *
  * The default number of `$digest` iterations the scope should attempt to execute before giving up and
@@ -272,17 +284,12 @@ export class Scope {
    *
    *    - `string`: Evaluated as {@link guide/expression expression}
    *    - `function(scope)`: called with current `scope` as a parameter.
-   * @param {(newVal: any, oldVal: any, scope: Scope) => any} listener Callback called whenever the value
-   *    of `watchExpression` changes.
-   *
-   *    - `newVal` contains the current value of the `watchExpression`
-   *    - `oldVal` contains the previous value of the `watchExpression`
-   *    - `scope` refers to the current scope
+   * @param {WatchListener} listener
    * @param {boolean=} [objectEquality=false] Compare for object equality using {@link angular.equals} instead of
    *     comparing for reference equality.
    * @returns {function()} Returns a deregistration function for this listener.
    */
-    $watch(watchExp: string | ((scope: Scope) => any), listener: (newVal: any, oldVal: any, scope: Scope) => any, objectEquality?: boolean | undefined): () => any;
+    $watch(watchExp: string | ((scope: Scope) => any), listener: WatchListener, objectEquality?: boolean | undefined): () => any;
     /**
      * @ngdoc method
      * @name $rootScope.Scope#$watchGroup
@@ -732,3 +739,8 @@ export type AsyncQueueTask = {
     fn: Function;
     locals: any;
 };
+/**
+ * Callback function triggered whenever the value of `watchExpression` changes.
+ */
+export type WatchListener = (arg0: any, arg1: any, arg2: Scope) => any;
+export type WatchExpression = string | ((scope: Scope) => any);

package/types/loader.d.ts

@@ -303,10 +303,6 @@ export class Angular {
      */
     injector(modules: any[], strictDi: boolean | null): angular.auto.IInjectorService;
     /**
-     * @ngdoc function
-     * @name angular.module
-     * @module ng
-     * @description
      *
      * The `angular.module` is a global place for creating, registering and retrieving AngularJS
      * modules.

package/types/router/params/param-type.d.ts

@@ -32,8 +32,9 @@ export class ParamType {
     pattern: RegExp;
     /** @inheritdoc */
     inherit: boolean;
+    name: any;
     /** @inheritdoc */
-    is(): boolean;
+    is(_val: any): boolean;
     /** @inheritdoc */
     encode(val: any): any;
     /** @inheritdoc */

package/types/router/state/views.d.ts

@@ -30,6 +30,8 @@ export class Ng1ViewConfig {
     path: any;
     viewDecl: any;
     factory: any;
+    component: any;
+    template: any;
     /** @type {Number} */ $id: number;
     loaded: boolean;
     getTemplate: (ngView: any, context: any) => any;

package/types/router/transition/reject-factory.d.ts

@@ -37,6 +37,7 @@ export class Rejection {
     type: any;
     message: any;
     detail: any;
+    redirected: boolean;
     toString(): string;
     toPromise(): any;
 }

package/types/router/url/url-rule.d.ts

@@ -124,7 +124,6 @@ export namespace UrlRuleFactory {
  * A base rule which calls `match`
  *
  * The value from the `match` function is passed through to the `handler`.
- * @type {angular.BaseUrlRule}
  */
 export class BaseUrlRule {
     constructor(match: any, handler: any);

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

@@ -4,11 +4,11 @@
 export class UrlService {
     static $inject: string[];
     /**
-     * @param {angular.ILocationProvider} $locationProvider
+     * @param {import("../../core/location/location").$LocationProvider} $locationProvider
      */
-    constructor($locationProvider: angular.ILocationProvider, stateService: any, globals: any, urlConfigProvider: any);
+    constructor($locationProvider: import("../../core/location/location").$LocationProvider, stateService: any, globals: any, urlConfigProvider: any);
     stateService: any;
-    $locationProvider: angular.ILocationProvider;
+    $locationProvider: import("../../core/location/location").$LocationProvider;
     $location: any;
     $browser: any;
     /** @type {boolean} */
@@ -26,9 +26,9 @@ export class UrlService {
      * The nested [[UrlConfig]] API to configure the URL and retrieve URL information
      *
      * See: [[UrlConfig]] for details
-     * @type {angular.UrlConfig}
+     * @type {import("./url-config").UrlConfigProvider}
      */
-    config: angular.UrlConfig;
+    config: import("./url-config").UrlConfigProvider;
     /** Creates a new [[Param]] for a given location (DefType) */
     paramFactory: ParamFactory;
     /**
@@ -214,9 +214,9 @@ export class UrlService {
      *
      * Given a URL (as a [[UrlParts]] object), check all rules and determine the best matching rule.
      * Return the result as a [[MatchResult]].
-     * @returns {angular.MatchResult}
+     * @returns {any}
      */
-    match(url: any): angular.MatchResult;
+    match(url: any): any;
     update(read: any): void;
     location: any;
     /**

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

@@ -1,15 +1,10 @@
 /**
- * @ngdoc provider
- * @name $templateRequestProvider
- * @this
- *
- * @description
  * Used to configure the options passed to the {@link $http} service when making a template request.
  *
  * For example, it can be used for specifying the "Accept" header that is sent to the server, when
  * requesting a template.
  */
-export function TemplateRequestProvider(this: any): void;
+export function TemplateRequestProvider(): void;
 export class TemplateRequestProvider {
     /**
      * @ngdoc method
@@ -21,10 +16,10 @@ export class TemplateRequestProvider {
      * The {@link $templateRequest} will set the `cache` and the `transformResponse` properties of the
      * options if not overridden here.
      *
-     * @param {string=} value new value for the {@link $http} options.
-     * @returns {string|self} Returns the {@link $http} options when used as getter and self if used as setter.
+     * @param {string=} val new value for the {@link $http} options.
+     * @returns {string|TemplateRequestProvider} Returns the {@link $http} options when used as getter and self if used as setter.
      */
-    httpOptions: (val: any) => string | (Window & typeof globalThis);
+    httpOptions: (val?: string | undefined) => string | TemplateRequestProvider;
     /**
      * @ngdoc service
      * @name $templateRequest

package/types/types.d.ts

@@ -29,7 +29,7 @@ export type CloneAttachFunction = (clonedElement?: import("./shared/jqlite/jqlit
  * https://docs.angularjs.org/api/ng/service/$compile#-controller-
  * http://teropa.info/blog/2015/06/09/transclusion.html
  */
-export type TranscludeFunction = {
+export type TranscludeFunctionObject = {
     transcludeWithScope: (arg0: TScope, arg1: CloneAttachFunction, arg2: import("./shared/jqlite/jqlite").JQLite | undefined, arg3: string | undefined) => import("./shared/jqlite/jqlite").JQLite;
     transcludeWithoutScope: (arg0: CloneAttachFunction | undefined, arg1: import("./shared/jqlite/jqlite").JQLite | undefined, arg2: string | undefined) => import("./shared/jqlite/jqlite").JQLite;
     /**
@@ -37,6 +37,7 @@ export type TranscludeFunction = {
      */
     isSlotFilled: (arg0: string) => boolean;
 };
+export type TranscludeFunction = (arg0: TScope, arg1: CloneAttachFunction, arg2: import("./shared/jqlite/jqlite").JQLite | undefined, arg3: string | undefined) => import("./shared/jqlite/jqlite").JQLite;
 export type transcludeWithScope = (arg0: TScope, arg1: CloneAttachFunction, arg2: import("./shared/jqlite/jqlite").JQLite | undefined, arg3: string | undefined) => import("./shared/jqlite/jqlite").JQLite;
 export type transcludeWithoutScope = (arg0: CloneAttachFunction | undefined, arg1: import("./shared/jqlite/jqlite").JQLite | undefined, arg2: string | undefined) => import("./shared/jqlite/jqlite").JQLite;
 /**
@@ -128,6 +129,10 @@ export type Directive = {
     transclude?: boolean | "element" | {
         [slot: string]: string;
     } | undefined;
+    /**
+     * Hidden properties added by router
+     */
+    $$addStateInfo?: (...args: any[]) => any;
 };
 /**
  * Factory function for creating directives.

package/src/core/parser/parse.test.js

@@ -1,12 +0,0 @@
-import { test, expect } from "@playwright/test";
-
-const TEST_URL = "src/core/parser/parse.html";
-
-test("unit tests contain no errors", async ({ page }) => {
-  await page.goto(TEST_URL);
-  await page.content();
-  await page.waitForTimeout(100);
-  await expect(page.locator(".jasmine-overall-result")).toHaveText(
-    /0 failures/,
-  );
-});

package/types-back/README.md

@@ -1,2 +0,0 @@
-Keep these for reference only but TODO(Remove in future). 
-Instead of decorating existing implementation with *.d.ts definitions, AngularTS uses JSDoc types as the source of truth for generating *.d.ts files.