@angular-wave/angular.ts 0.0.60 → 0.0.62

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/index.d.ts

@@ -1 +1,5 @@
-export {};
+/**
+ * @type {Angular}
+ */
+export const angular: Angular;
+import { Angular } from "./loader";

package/types/loader.d.ts

@@ -196,40 +196,8 @@ export class Angular {
     cache: Map<number, import("./core/cache/cache").ExpandoStore>;
     /** @type {string} */
     version: string;
-    /** @type {bind} */
-    bind: typeof bind;
-    /** @type {equals} */
-    equals: typeof equals;
     /** @type {typeof import('./shared/jqlite/jqlite').JQLite} */
     element: typeof import("./shared/jqlite/jqlite").JQLite;
-    /** @type {extend} */
-    extend: typeof extend;
-    /** @type {forEach} */
-    forEach: typeof forEach;
-    /** @type {fromJson} */
-    fromJson: typeof fromJson;
-    /** @type {toJson} */
-    toJson: typeof toJson;
-    /** @type {identity} */
-    identity: typeof identity;
-    /** @type {isDate} */
-    isDate: typeof isDate;
-    /** @type {isDefined} */
-    isDefined: typeof isDefined;
-    /** @type {isElement} */
-    isElement: typeof isElement;
-    /** @type {isFunction} */
-    isFunction: typeof isFunction;
-    /** @type {isNumber} */
-    isNumber: typeof isNumber;
-    /** @type {isObject} */
-    isObject: typeof isObject;
-    /** @type {isString} */
-    isString: typeof isString;
-    /** @type {isUndefined} */
-    isUndefined: typeof isUndefined;
-    /** @type {merge} */
-    merge: typeof merge;
     /** @type {errorHandlingConfig} */
     errorHandlingConfig: typeof errorHandlingConfig;
     /** @type {Function} */
@@ -303,10 +271,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.
@@ -379,19 +343,3 @@ export type AngularBootstrapConfig = {
      */
     strictDi?: boolean;
 };
-import { bind } from "./shared/utils";
-import { equals } from "./shared/utils";
-import { extend } from "./shared/utils";
-import { forEach } from "./shared/utils";
-import { fromJson } from "./shared/utils";
-import { toJson } from "./shared/utils";
-import { identity } from "./shared/utils";
-import { isDate } from "./shared/utils";
-import { isDefined } from "./shared/utils";
-import { isElement } from "./shared/utils";
-import { isFunction } from "./shared/utils";
-import { isNumber } from "./shared/utils";
-import { isObject } from "./shared/utils";
-import { isString } from "./shared/utils";
-import { isUndefined } from "./shared/utils";
-import { merge } from "./shared/utils";

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/state-provider.d.ts

@@ -75,7 +75,7 @@ export class StateProvider {
      *   let result = {},
      *       views = parent(state);
      *
-     *   angular.forEach(views, function (config, name) {
+     *   forEach(views, function (config, name) {
      *     let autoName = (state.name + '.' + name).replace('.', '/');
      *     config.templateUrl = config.templateUrl || '/partials/' + autoName + '.html';
      *     result[name] = config;

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/shared/utils.d.ts

@@ -182,7 +182,7 @@ export function snakeCase(name: any, separator: any): any;
    ```js
      let values = {name: 'misko', gender: 'male'};
      let log = [];
-     angular.forEach(values, function(value, key) {
+     forEach(values, function(value, key) {
        this.push(key + ': ' + value);
      }, log);
      expect(log).toEqual(['name: misko', 'gender: male']);
@@ -266,12 +266,6 @@ export function isNumberNaN(num: any): boolean;
  * @returns {Object}
  */
 export function inherit(parent: any, extra: any): any;
-/**
- *
- * @param {*} value to be returned.
- * @returns {*} the value passed in.
- */
-export function identity(value: any): any;
 /**
  * @param {*} value
  * @returns {() => *}

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/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.

package/types-back/angular.d.ts

@@ -1,146 +0,0 @@
-///////////////////////////////////////////////////////////////////////////
-// AngularStatic
-// see http://docs.angularjs.org/api
-
-import {
-  IAngularBootstrapConfig,
-  IErrorHandlingConfig,
-  IModule,
-  Injectable,
-  auto,
-} from ".";
-
-///////////////////////////////////////////////////////////////////////////
-interface IAngularStatic {
-  /**
-   * Expando cache for adding properties to DOM nodes.
-   */
-  cache: Map<number, any>;
-
-  bind(context: any, fn: Function, ...args: any[]): Function;
-
-  /**
-   * Use this function to manually start up angular application.
-   *
-   * @param element DOM element which is the root of angular application.
-   * @param modules An array of modules to load into the application.
-   *     Each item in the array should be the name of a predefined module or a (DI annotated)
-   *     function that will be invoked by the injector as a config block.
-   * @param config an object for defining configuration options for the application. The following keys are supported:
-   *     - `strictDi`: disable automatic function annotation for the application. This is meant to assist in finding bugs which break minified code.
-   */
-  bootstrap(
-    element: string | Element | JQLite | Document,
-    modules?: Array<string | Function | any[]>,
-    config?: IAngularBootstrapConfig,
-  ): auto.IInjectorService;
-
-  /**
-   * Wraps a raw DOM element or HTML string in JQLite.
-   */
-  element: JQLite;
-  /**
-   * Configure several aspects of error handling in AngularJS if used as a setter
-   * or return the current configuration if used as a getter
-   */
-  errorHandlingConfig(): IErrorHandlingConfig;
-  errorHandlingConfig(config: IErrorHandlingConfig): void;
-  equals(value1: any, value2: any): boolean;
-  extend(destination: any, ...sources: any[]): any;
-
-  /**
-   * Invokes the iterator function once for each item in obj collection, which can be either an object or an array. The iterator function is invoked with iterator(value, key), where value is the value of an object property or an array element and key is the object property key or array element index. Specifying a context for the function is optional.
-   *
-   * It is worth noting that .forEach does not iterate over inherited properties because it filters using the hasOwnProperty method.
-   *
-   * @param obj Object to iterate over.
-   * @param iterator Iterator function.
-   * @param context Object to become context (this) for the iterator function.
-   */
-  forEach<T, U extends ArrayLike<T> = T[]>(
-    obj: U,
-    iterator: (value: U[number], key: number, obj: U) => void,
-    context?: any,
-  ): U;
-  /**
-   * Invokes the iterator function once for each item in obj collection, which can be either an object or an array. The iterator function is invoked with iterator(value, key), where value is the value of an object property or an array element and key is the object property key or array element index. Specifying a context for the function is optional.
-   *
-   * It is worth noting that .forEach does not iterate over inherited properties because it filters using the hasOwnProperty method.
-   *
-   * @param obj Object to iterate over.
-   * @param iterator Iterator function.
-   * @param context Object to become context (this) for the iterator function.
-   */
-  forEach<T>(
-    obj: { [index: string]: T },
-    iterator: (value: T, key: string, obj: { [index: string]: T }) => void,
-    context?: any,
-  ): { [index: string]: T };
-  /**
-   * Invokes the iterator function once for each item in obj collection, which can be either an object or an array. The iterator function is invoked with iterator(value, key), where value is the value of an object property or an array element and key is the object property key or array element index. Specifying a context for the function is optional.
-   *
-   * It is worth noting that .forEach does not iterate over inherited properties because it filters using the hasOwnProperty method.
-   *
-   * @param obj Object to iterate over.
-   * @param iterator Iterator function.
-   * @param context Object to become context (this) for the iterator function.
-   */
-  forEach(
-    obj: any,
-    iterator: (value: any, key: any, obj: any) => void,
-    context?: any,
-  ): any;
-
-  fromJson(json: string): any;
-  identity<T>(arg?: T): T;
-  injector(modules?: any[], strictDi?: boolean): auto.IInjectorService;
-  isDate(value: any): boolean;
-  isDefined(value: any): boolean;
-  isElement(value: any): boolean;
-  isFunction(value: any): boolean;
-  isNumber(value: any): boolean;
-  isObject(value: any): boolean;
-  isString(value: any): boolean;
-  isUndefined(value: any): boolean;
-
-  /**
-   * Deeply extends the destination object dst by copying own enumerable properties from the src object(s) to dst. You can specify multiple src objects. If you want to preserve original objects, you can do so by passing an empty object as the target: var object = angular.merge({}, object1, object2).
-   *
-   * Unlike extend(), merge() recursively descends into object properties of source objects, performing a deep copy.
-   *
-   * @param dst Destination object.
-   * @param src Source object(s).
-   */
-  merge(dst: any, ...src: any[]): any;
-
-  /**
-   * The angular.module is a global place for creating, registering and retrieving Angular modules. All modules (angular core or 3rd party) that should be available to an application must be registered using this mechanism.
-   *
-   * When passed two or more arguments, a new module is created. If passed only one argument, an existing module (the name passed as the first argument to module) is retrieved.
-   *
-   * @param name The name of the module to create or retrieve.
-   * @param requires The names of modules this module depends on. If specified then new module is being created. If unspecified then the module is being retrieved for further configuration.
-   * @param configFn Optional configuration function for the module.
-   */
-  module(
-    name: string,
-    requires?: string[],
-    configFn?: Injectable<Function>,
-  ): IModule;
-
-  reloadWithDebugInfo(): void;
-  toJson(obj: any, pretty?: boolean | number): string;
-  version: {
-    full: string;
-    major: number;
-    minor: number;
-    dot: number;
-    codeName: string;
-  };
-
-  /**
-   * If window.name contains prefix NG_DEFER_BOOTSTRAP! when angular.bootstrap is called, the bootstrap process will be paused until angular.resumeBootstrap() is called.
-   * @param extraModules An optional array of modules that should be added to the original list of modules that the app was about to be bootstrapped with.
-   */
-  resumeBootstrap?(extraModules?: string[]): ng.auto.IInjectorService;
-}