@angular-wave/angular.ts 0.16.1 → 0.18.0

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

@@ -46,9 +46,8 @@ export class Scope {
    * @param {Scope} [parent] - Custom parent.
    */
   constructor(context?: Scope, parent?: Scope);
-  context: Scope;
-  /** @type {Map<string, Array<import('./interface.ts').Listener>>} Watch listeners */
-  watchers: Map<string, Array<import("./interface.ts").Listener>>;
+  /** @ignore @type {Map<string, Array<import('./interface.ts').Listener>>} Watch listeners */
+  _watchers: Map<string, Array<import("./interface.ts").Listener>>;
   /** @private @type {Map<String, Function[]>} Event listeners */
   private _listeners;
   /** @private @type {Map<string, Array<import('./interface.ts').Listener>>} Watch listeners from other proxies */
@@ -59,25 +58,26 @@ export class Scope {
   private _objectListeners;
   /** @type {Proxy<Scope>} Current proxy being operated on */
   $proxy: ProxyConstructor;
-  /** @type {Scope} The actual proxy */
+  /** @type {Scope} This is the reference to the Scope object with acts as the actual proxy */
   $handler: Scope;
   /** @type {*} Current target being called on */
   $target: any;
-  /** @type {*} Value wrapped by the proxy */
-  $value: any;
   /**
-   * @type {Scope[]}
+   * @ignore @type {Scope[]}
    */
-  $children: Scope[];
+  _children: Scope[];
   /**
    * @type {number} Unique model ID (monotonically increasing) useful for debugging.
    */
   $id: number;
   /**
-   * @type {Scope}
+   * @type {ng.RootScopeService}
    */
-  $root: Scope;
-  $parent: Scope;
+  $root: ng.RootScopeService;
+  /**
+   * @type {Scope | undefined}
+   */
+  $parent: Scope | undefined;
   /** @ignore @type {boolean} */
   _destroyed: boolean;
   /** @private @type {import("./interface.ts").Listener[]} A list of scheduled Event listeners */
@@ -90,14 +90,14 @@ export class Scope {
    * Intercepts and handles property assignments on the target object. If a new value is
    * an object, it will be recursively proxied.
    *
-   * @param {Object} target - The target object.
+   * @param {Object & Record<string, any>} target - The target object.
    * @param {string} property - The name of the property being set.
    * @param {*} value - The new value being assigned to the property.
    * @param {Proxy<Scope>} proxy - The proxy intercepting property access
    * @returns {boolean} - Returns true to indicate success of the operation.
    */
   set(
-    target: any,
+    target: any & Record<string, any>,
     property: string,
     value: any,
     proxy: ProxyConstructor,
@@ -107,17 +107,21 @@ export class Scope {
    * properties (`watch` and `sync`) and binds their methods. For other properties,
    * it returns the value directly.
    *
-   * @param {Object} target - The target object.
+   * @param {Object & Record<string, any>} target - The target object.
    * @param {string|number|symbol} property - The name of the property being accessed.
    * @param {Proxy<Scope>} proxy - The proxy object being invoked
    * @returns {*} - The value of the property or a method if accessing `watch` or `sync`.
    */
   get(
-    target: any,
+    target: any & Record<string, any>,
     property: string | number | symbol,
     proxy: ProxyConstructor,
   ): any;
-  deleteProperty(target: any, property: any): boolean;
+  /**
+   * @param {Object & Record<string, any>} target - The target object.
+   * @param {string} property - The name of the property being deleted
+   */
+  deleteProperty(target: any & Record<string, any>, property: string): boolean;
   /**
    * Registers a watcher for a property along with a listener function. The listener
    * function is invoked when changes to that property are detected.
@@ -131,10 +135,42 @@ export class Scope {
     listenerFn?: ng.ListenerFn,
     lazy?: boolean,
   ): () => void;
-  $new(childInstance: any): any;
-  $newIsolate(instance: any): any;
-  $transcluded(parentInstance: any): any;
-  $eval(expr: any, locals: any): any;
+  /**
+   * @param {ng.Scope} [childInstance]
+   * @returns {Proxy<ng.Scope> & ng.Scope}
+   */
+  $new(childInstance?: ng.Scope): ProxyConstructor & ng.Scope;
+  /**
+   * @param {ng.Scope} [instance]
+   * @returns {Proxy<ng.Scope> & ng.Scope}
+   */
+  $newIsolate(instance?: ng.Scope): ProxyConstructor & ng.Scope;
+  /**
+   * @param {ng.Scope} parentInstance
+   * @returns {Proxy<ng.Scope> & ng.Scope}
+   */
+  $transcluded(parentInstance: ng.Scope): ProxyConstructor & ng.Scope;
+  /**
+   * @param {string} key
+   * @param {import("./interface.ts").Listener} listener
+   */
+  _registerForeignKey(
+    key: string,
+    listener: import("./interface.ts").Listener,
+  ): void;
+  /**
+   * @param {string} key
+   * @param {number} id
+   */
+  _deregisterForeignKey(key: string, id: number): boolean;
+  /**
+   * Evaluates an Angular expression in the context of this scope.
+   *
+   * @param {string} expr - Angular expression to evaluate
+   * @param {Record<string, any>} [locals] - Optional local variables
+   * @returns {any}
+   */
+  $eval(expr: string, locals?: Record<string, any>): any;
   /**
    * @param {Object} newTarget
    */
@@ -153,9 +189,9 @@ export class Scope {
   /**
    * @param {string} name
    * @param  {...any} args
-   * @returns {void}
+   * @returns {ng.ScopeEvent | undefined}
    */
-  $emit(name: string, ...args: any[]): void;
+  $emit(name: string, ...args: any[]): ng.ScopeEvent | undefined;
   /**
    * @param {string} name
    * @param  {...any} args

package/@types/directive/aria/aria.d.ts

@@ -19,7 +19,7 @@ export class AriaProvider {
   config: (newConfig: any) => void;
   $get: () => {
     config(key: any): any;
-    $$watchExpr: (
+    _watchExpr: (
       attrName: any,
       ariaAttr: any,
       nativeAriaNodeNamesParam: any,

package/@types/directive/form/form.d.ts

@@ -1,4 +1,14 @@
 export function setupValidity(instance: any): void;
+/**
+ * @param {FormController|ng.NgModelController} ctrl
+ * @param {string} className
+ * @param {boolean} switchValue
+ */
+export function cachedToggleClass(
+  ctrl: FormController | ng.NgModelController,
+  className: string,
+  switchValue: boolean,
+): void;
 /**
  * @type {{
  *   $nonscope: boolean,
@@ -74,21 +84,23 @@ export class FormController {
   static $nonscope: boolean;
   static $inject: string[];
   /**
-   * @param {Element} $element
+   * @param {HTMLFormElement} $element
    * @param {ng.Attributes} $attrs
    * @param {ng.Scope} $scope
    * @param {ng.AnimateService} $animate
    * @param {ng.InterpolateService} $interpolate
    */
   constructor(
-    $element: Element,
+    $element: HTMLFormElement,
     $attrs: ng.Attributes,
     $scope: ng.Scope,
     $animate: ng.AnimateService,
     $interpolate: ng.InterpolateService,
   );
+  /** @type {boolean} */
+  _isAnimated: boolean;
   _controls: any[];
-  $name: string;
+  $name: any;
   /**
    * @property {boolean} $dirty True if user has already interacted with the form.
    */
@@ -102,7 +114,7 @@ export class FormController {
   $submitted: boolean;
   /** @type {FormController|Object} */
   _parentForm: FormController | any;
-  _element: Element;
+  _element: HTMLFormElement;
   _animate: import("../../animations/interface.ts").AnimateService;
   $error: {};
   _success: {};

package/@types/directive/messages/messages.d.ts

@@ -37,19 +37,19 @@ declare class NgMessageCtrl {
     $attrs: ng.Attributes,
     $animate: ng.AnimateService,
   );
-  $element: Element;
-  $scope: ng.Scope;
-  $attrs: ng.Attributes;
-  $animate: import("../../animations/interface.ts").AnimateService;
-  latestKey: number;
-  nextAttachId: number;
-  messages: {};
-  renderLater: boolean;
-  cachedCollection: {};
-  head: any;
-  default: any;
-  getAttachId(): number;
-  render(collection?: {}): void;
+  _element: Element;
+  _scope: ng.Scope;
+  _attrs: ng.Attributes;
+  _animate: import("../../animations/interface.ts").AnimateService;
+  _latestKey: number;
+  _nextAttachId: number;
+  _messages: {};
+  _renderLater: boolean;
+  _cachedCollection: {};
+  _head: any;
+  _default: any;
+  _getAttachId(): number;
+  _render(collection?: {}): void;
   reRender(): void;
   register(comment: any, messageCtrl: any, isDefault: any): void;
   deregister(comment: any, isDefault: any): void;

package/@types/directive/model/model.d.ts

@@ -52,7 +52,7 @@ export class NgModelController {
    * @param {ng.Scope} $scope
    * @param {ng.ExceptionHandlerService} $exceptionHandler
    * @param {ng.Attributes} $attr
-   * @param {Element} $element
+   * @param {HTMLElement} $element
    * @param {ng.ParseService} $parse
    * @param {ng.AnimateService} $animate
    * @param {ng.InterpolateService} $interpolate
@@ -61,11 +61,13 @@ export class NgModelController {
     $scope: ng.Scope,
     $exceptionHandler: ng.ExceptionHandlerService,
     $attr: ng.Attributes,
-    $element: Element,
+    $element: HTMLElement,
     $parse: ng.ParseService,
     $animate: ng.AnimateService,
     $interpolate: ng.InterpolateService,
   );
+  /** @type {boolean} */
+  _isAnimated: boolean;
   /** @type {any} The actual value from the control's view  */
   $viewValue: any;
   /** @type {any} The value in the model that the control is bound to. */
@@ -97,7 +99,7 @@ export class NgModelController {
   $error: {};
   _success: {};
   $pending: any;
-  $name: string;
+  $name: any;
   _parentForm: {
     $nonscope: boolean;
     $addControl: Function;
@@ -144,7 +146,7 @@ export class NgModelController {
   /** @type {ng.Scope} */
   _scope: ng.Scope;
   _attr: ng.Attributes;
-  _element: Element;
+  _element: HTMLElement;
   _animate: import("../../animations/interface.ts").AnimateService;
   _parse: import("../../core/parse/interface.ts").ParseService;
   _exceptionHandler: import("../../services/exception/interface.ts").ExceptionHandler;

package/@types/filters/order-by.d.ts

@@ -6,3 +6,16 @@ export function orderByFilter($parse: ng.ParseService): ng.FilterFn;
 export namespace orderByFilter {
   let $inject: string[];
 }
+export type ComparisonObject = {
+  value: any;
+  tieBreaker: {
+    value: number;
+    type: string;
+    index: number;
+  };
+  predicateValues: Array<{
+    value: any;
+    type: string;
+    index: number;
+  }>;
+};

package/@types/interface.d.ts

@@ -25,7 +25,6 @@ export declare const PublicInjectionTokens: {
   readonly $interpolate: "$interpolate";
   readonly $location: "$location";
   readonly $log: "$log";
-  readonly $viewScroll: "$viewScroll";
   readonly $parse: "$parse";
   readonly $rest: "$rest";
   readonly $rootScope: "$rootScope";
@@ -65,7 +64,7 @@ export interface AngularBootstrapConfig {
    * This helps find bugs that would break under minified code.
    * Defaults to `false`.
    */
-  strictDi?: boolean;
+  strictDi: boolean;
 }
 /**
  * A JavaScript expression represented as a string, typically used in interpolation bindings.
@@ -474,7 +473,7 @@ export interface TemplateLinkingFunction {
   ): Element;
 }
 export interface TemplateLinkingFunctionOptions {
-  parentBoundTranscludeFn?: TranscludeFunctionObject | undefined;
+  _parentBoundTranscludeFn?: TranscludeFunctionObject | undefined;
   transcludeControllers?:
     | {
         [controller: string]: {
@@ -482,7 +481,7 @@ export interface TemplateLinkingFunctionOptions {
         };
       }
     | undefined;
-  futureParentElement?: Element | undefined;
+  _futureParentElement?: Element | undefined;
 }
 /**
  * Configuration for ngModel behavior.

package/@types/namespace.d.ts

@@ -11,11 +11,7 @@ import {
 import { NgModule as TNgModule } from "./core/di/ng-module/ng-module.js";
 import { InjectorService as TInjectorService } from "./core/di/internal-injector.js";
 import { AnchorScrollProvider as TAnchorScrollProvider } from "./services/anchor-scroll/anchor-scroll.js";
-import {
-  AnchorScrollFunction as TAnchorScrollFunction,
-  AnchorScrollService as TAnchorScrollService,
-  AnchorScrollObject as TAnchorScrollObject,
-} from "./services/anchor-scroll/interface.ts";
+import { AnchorScrollService as TAnchorScrollService } from "./services/anchor-scroll/interface.ts";
 import { ControllerService as TControllerService } from "./core/controller/interface.ts";
 import { ExceptionHandler as TExceptionHandler } from "./services/exception/interface.ts";
 import { ExceptionHandlerProvider as TExceptionHandlerProvider } from "./services/exception/exception.js";
@@ -115,16 +111,16 @@ import {
 } from "./router/state/interface.ts";
 import { StateObject as TStateObject } from "./router/state/state-object.js";
 import { StateRegistryProvider as TStateRegistryProvider } from "./router/state/state-registry.js";
-import { ViewScrollService as TViewScrollService } from "./router/scroll/interface.ts";
 import { HookRegistry } from "./router/transition/interface.ts";
 import {
-  SCEService as TSCEService,
-  SCEDelegateService as TSCEDelegateService,
+  SceService as TSceService,
+  SceDelegateService as TSceDelegateService,
 } from "./services/sce/interface.ts";
 import {
   WebSocketConfig as TWebSocketConfig,
   WebSocketService as TWebSocketService,
 } from "./services/websocket/interface.ts";
+import { AnimateRunner as TAnimateRunner } from "./animations/runner/animate-runner.js";
 declare global {
   interface Function {
     $inject?: readonly string[] | undefined;
@@ -164,6 +160,7 @@ declare global {
     type RouterProvider = TRouterProvider;
     type AnchorScrollService = TAnchorScrollService;
     type AnimateService = TAnimateService;
+    type AnimateRunner = TAnimateRunner;
     type CompileService = TCompileFn;
     type ControllerService = TControllerService;
     type CookieService = TCookieService;
@@ -185,8 +182,8 @@ declare global {
     type RouterService = TRouterProvider;
     type StateService = TStateProvider;
     type StateRegistryService = TStateRegistryProvider;
-    type SCEService = TSCEService;
-    type SCEDelegateService = TSCEDelegateService;
+    type SceService = TSceService;
+    type SceDelegateService = TSceDelegateService;
     type SseService = TSseService;
     type SseConfig = TSseConfig;
     type TransitionService = TransitionProvider & HookRegistry;
@@ -194,7 +191,6 @@ declare global {
     type TemplateRequestService = TTemplateRequestService;
     type UrlService = TUrlService;
     type ViewService = TViewService;
-    type ViewScrollService = TViewScrollService;
     type AnimationOptions = TAnimationOptions;
     type ErrorHandlingConfig = TErrorHandlingConfig;
     type ListenerFn = TListenerFn;
@@ -227,8 +223,6 @@ declare global {
     type StateDeclaration = TStateDeclaration;
     type BuiltStateDeclaration = TBuiltStateDeclaration;
     type StateObject = TStateObject;
-    type AnchorScrollFunction = TAnchorScrollFunction;
-    type AnchorScrollObject = TAnchorScrollObject;
     type InjectionTokens = typeof PublicInjectionTokens;
     type ScopeEvent = TScopeEvent;
     type RequestShortcutConfig = TRequestShortcutConfig;

package/@types/router/directives/view-directive.d.ts

@@ -1,14 +1,14 @@
 /**
  * @param {ng.ViewService} $view
  * @param {ng.AnimateService} $animate
- * @param {ng.AnchorScrollService} $viewScroll
+ * @param {ng.AnchorScrollService} $anchorScroll
  * @param {ng.InterpolateService} $interpolate
  * @returns {ng.Directive}
  */
 export function $ViewDirective(
   $view: ng.ViewService,
   $animate: ng.AnimateService,
-  $viewScroll: ng.AnchorScrollService,
+  $anchorScroll: ng.AnchorScrollService,
   $interpolate: ng.InterpolateService,
 ): ng.Directive;
 export namespace $ViewDirective {

package/@types/router/path/path-node.d.ts

@@ -16,7 +16,7 @@ export class PathNode {
   /** Sets [[paramValues]] for the node, from the values of an object hash */
   applyRawParams(params: any): this;
   /** Gets a specific [[Param]] metadata that belongs to the node */
-  parameter(name: any): undefined;
+  parameter(name: any): any;
   /**
    * @returns true if the state and parameter values for another PathNode are
    * equal to the state and param values for this PathNode

package/@types/router/resolve/resolve-context.d.ts

@@ -80,7 +80,7 @@ export class ResolveContext {
    * @returns {Promise<any>|any}
    */
   resolvePath(when: string, trans: any): Promise<any> | any;
-  findNode(resolvable: any): undefined;
+  findNode(resolvable: any): any;
   /**
    * Gets the async dependencies of a Resolvable
    *

package/@types/router/state/state-object.d.ts

@@ -3,7 +3,7 @@
  *
  * Instances of this class are created when a [[StateDeclaration]] is registered with the [[StateRegistry]].
  *
- * A registered [[StateDeclaration]] is augmented with a getter ([[StateDeclaration.$$state]]) which returns the corresponding [[StateObject]] object.
+ * A registered [[StateDeclaration]] is augmented with a getter ([[StateDeclaration._state]]) which returns the corresponding [[StateObject]] object.
  *
  * This class prototypally inherits from the corresponding [[StateDeclaration]].
  * Each of its own properties (i.e., `hasOwnProperty`) are built using builders from the [[StateBuilder]].
@@ -21,7 +21,7 @@ export class StateObject {
   params: any;
   url: any;
   includes: any;
-  $$state: () => this;
+  _state: () => this;
   /**
    * @type {ng.StateDeclaration|ng.BuiltStateDeclaration}
    */

package/@types/router/transition/hook-registry.d.ts

@@ -93,7 +93,7 @@ export class RegisteredHook {
    *   retained: true,
    * }
    */
-  _getDefaultMatchCriteria(): any;
+  _getDefaultMatchCriteria(): boolean[] | Record<string, boolean>;
   /**
    * Gets matching nodes as [[IMatchingNodes]]
    *

package/@types/router/url/url-matcher.d.ts

@@ -51,7 +51,7 @@
  */
 export class UrlMatcher {
   /** @internal Given a matcher, return an array with the matcher's path segments and path params, in order */
-  static pathSegmentsAndParams(matcher: any): any;
+  static pathSegmentsAndParams(matcher: any): any[];
   /** @internal Given a matcher, return an array with the matcher's query params */
   static queryParams(matcher: any): any;
   /**

package/@types/services/anchor-scroll/anchor-scroll.d.ts

@@ -5,6 +5,6 @@ export class AnchorScrollProvider {
     | ((
         $location: ng.LocationService,
         $rootScope: ng.Scope,
-      ) => import("./interface.ts").AnchorScrollFunction)
+      ) => ng.AnchorScrollService)
   )[];
 }

package/@types/services/anchor-scroll/interface.d.ts

@@ -1,4 +1,8 @@
-export interface AnchorScrollObject {
+export interface AnchorScrollService {
+  /**
+   * Invoke anchor scrolling.
+   */
+  (hash?: string | number): void;
   /**
    * Vertical scroll offset.
    * Can be a number, a function returning a number,
@@ -6,10 +10,3 @@ export interface AnchorScrollObject {
    */
   yOffset?: number | (() => number) | Element;
 }
-export type AnchorScrollFunction = (hash?: string) => void;
-/**
- * AngularJS $anchorScroll service
- *
- * Callable as a function and also exposes properties.
- */
-export type AnchorScrollService = AnchorScrollFunction | AnchorScrollObject;

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

@@ -96,7 +96,7 @@ export class HttpProvider {
     | string
     | ((
         $injector: ng.InjectorService,
-        $sce: ng.SCEService,
+        $sce: ng.SceService,
         $cookie: ng.CookieService,
       ) => {
         (requestConfig: any): Promise<any>;

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

@@ -262,7 +262,7 @@ export class Location {
    * @returns {Location}
    */
   setState(state: any): Location;
-  $$state: any;
+  _state: any;
   /**
    * Return the history state object
    * @returns {any}

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

@@ -1,4 +1,4 @@
-export interface SCEService {
+export interface SceService {
   HTML: string;
   CSS: string;
   JS: string;
@@ -8,26 +8,23 @@ export interface SCEService {
   getTrusted(type: string, mayBeTrusted: any): any;
   getTrustedCss(value: any): any;
   getTrustedHtml(value: any): any;
-  getTrustedJs(value: any): any;
   getTrustedResourceUrl(value: any): any;
   getTrustedUrl(value: any): any;
   getTrustedMediaUrl(value: any): any;
   parse(type: string, expression: string): (context: any, locals: any) => any;
   parseAsCss(expression: string): (context: any, locals: any) => any;
   parseAsHtml(expression: string): (context: any, locals: any) => any;
-  parseAsJs(expression: string): (context: any, locals: any) => any;
   parseAsResourceUrl(expression: string): (context: any, locals: any) => any;
   parseAsUrl(expression: string): (context: any, locals: any) => any;
   trustAs(type: string, value: any): any;
   trustAsHtml(value: any): any;
-  trustAsJs(value: any): any;
   trustAsResourceUrl(value: any): any;
   trustAsUrl(value: any): any;
   isEnabled(): boolean;
   valueOf(value?: any): any;
 }
-export interface SCEDelegateService {
+export interface SceDelegateService {
   getTrusted(type: string, mayBeTrusted: any): any;
   trustAs(type: string, value: any): any;
-  valueOf(value: any): any;
+  valueOf(value?: any): any;
 }

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

@@ -18,7 +18,13 @@ export class SceProvider {
    * Enables/disables SCE and returns the current value.
    */
   enabled: (value?: boolean | undefined, ...args: any[]) => boolean;
-  $get: (string | (($parse: ng.ParseService, $sceDelegate: any) => any))[];
+  $get: (
+    | string
+    | ((
+        $parse: ng.ParseService,
+        $sceDelegate: ng.SceDelegateService,
+      ) => ng.SceService)
+  )[];
 }
 export namespace SCE_CONTEXTS {
   let HTML: string;
@@ -26,7 +32,6 @@ export namespace SCE_CONTEXTS {
   let MEDIA_URL: string;
   let URL: string;
   let RESOURCE_URL: string;
-  let JS: string;
 }
 /**
  * `$sceDelegate` is a service that is used by the `$sce` service to provide {@link ng.$sce Strict