@angular-wave/angular.ts 0.18.0 → 0.19.0

package/@types/core/parse/interpreter.d.ts

@@ -31,198 +31,250 @@ export class ASTInterpreter {
    * Unary plus operation.
    * @param {function} argument - The argument function.
    * @param {Object} [context] - The context.
-   * @returns {function} The unary plus function.
+   * @returns {CompiledExpressionFunction} The unary plus function.
    */
-  "unary+"(argument: Function, context?: any): Function;
+  "unary+"(argument: Function, context?: any): CompiledExpressionFunction;
   /**
    * Unary minus operation.
    * @param {function} argument - The argument function.
    * @param {Object} [context] - The context.
-   * @returns {function} The unary minus function.
+   * @returns {CompiledExpressionFunction} The unary minus function.
    */
-  "unary-"(argument: Function, context?: any): Function;
+  "unary-"(argument: Function, context?: any): CompiledExpressionFunction;
   /**
    * Unary negation operation.
    * @param {function} argument - The argument function.
    * @param {Object} [context] - The context.
-   * @returns {function} The unary negation function.
+   * @returns {CompiledExpressionFunction} The unary negation function.
    */
-  "unary!"(argument: Function, context?: any): Function;
+  "unary!"(argument: Function, context?: any): CompiledExpressionFunction;
   /**
    * Binary plus operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary plus function.
+   * @returns {CompiledExpressionFunction} The binary plus function.
    */
-  "binary+"(left: Function, right: Function, context?: any): Function;
+  "binary+"(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Binary minus operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary minus function.
+   * @returns {CompiledExpressionFunction} The binary minus function.
    */
-  "binary-"(left: Function, right: Function, context?: any): Function;
+  "binary-"(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Binary multiplication operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary multiplication function.
+   * @returns {CompiledExpressionFunction} The binary multiplication function.
    */
-  "binary*"(left: Function, right: Function, context?: any): Function;
-  "binary/"(
-    left: any,
-    right: any,
-    context: any,
-  ): (
-    scope: any,
-    locals: any,
-    assign: any,
-  ) =>
-    | number
-    | {
-        value: number;
-      };
+  "binary*"(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Binary division operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary division function.
+   * @returns {CompiledExpressionFunction} The binary division function.
    */
-  "binary%"(left: Function, right: Function, context?: any): Function;
+  "binary/"(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
+  /**
+   * Binary modulo operation.
+   * @param {function} left - The left operand function.
+   * @param {function} right - The right operand function.
+   * @param {Object} [context] - The context.
+   * @returns {CompiledExpressionFunction} The binary division function.
+   */
+  "binary%"(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Binary strict equality operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary strict equality function.
+   * @returns {CompiledExpressionFunction} The binary strict equality function.
    */
-  "binary==="(left: Function, right: Function, context?: any): Function;
+  "binary==="(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Binary strict inequality operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary strict inequality function.
+   * @returns {CompiledExpressionFunction} The binary strict inequality function.
    */
-  "binary!=="(left: Function, right: Function, context?: any): Function;
+  "binary!=="(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Binary equality operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary equality function.
+   * @returns {CompiledExpressionFunction} The binary equality function.
    */
-  "binary=="(left: Function, right: Function, context?: any): Function;
+  "binary=="(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Binary inequality operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary inequality function.
+   * @returns {CompiledExpressionFunction} The binary inequality function.
    */
-  "binary!="(left: Function, right: Function, context?: any): Function;
+  "binary!="(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Binary less-than operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary less-than function.
+   * @returns {CompiledExpressionFunction} The binary less-than function.
    */
-  "binary<"(left: Function, right: Function, context?: any): Function;
+  "binary<"(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Binary greater-than operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary greater-than function.
+   * @returns {CompiledExpressionFunction} The binary greater-than function.
    */
-  "binary>"(left: Function, right: Function, context?: any): Function;
+  "binary>"(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Binary less-than-or-equal-to operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary less-than-or-equal-to function.
+   * @returns {CompiledExpressionFunction} The binary less-than-or-equal-to function.
    */
-  "binary<="(left: Function, right: Function, context?: any): Function;
+  "binary<="(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Binary greater-than-or-equal-to operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary greater-than-or-equal-to function.
+   * @returns {CompiledExpressionFunction} The binary greater-than-or-equal-to function.
    */
-  "binary>="(left: Function, right: Function, context?: any): Function;
+  "binary>="(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Binary logical AND operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary logical AND function.
+   * @returns {CompiledExpressionFunction} The binary logical AND function.
    */
-  "binary&&"(left: Function, right: Function, context?: any): Function;
+  "binary&&"(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Binary logical OR operation.
    * @param {function} left - The left operand function.
    * @param {function} right - The right operand function.
    * @param {Object} [context] - The context.
-   * @returns {function} The binary logical OR function.
+   * @returns {CompiledExpressionFunction} The binary logical OR function.
    */
-  "binary||"(left: Function, right: Function, context?: any): Function;
+  "binary||"(
+    left: Function,
+    right: Function,
+    context?: any,
+  ): CompiledExpressionFunction;
   /**
    * Ternary conditional operation.
    * @param {function} test - The test function.
    * @param {function} alternate - The alternate function.
    * @param {function} consequent - The consequent function.
    * @param {Object} [context] - The context.
-   * @returns {function} The ternary conditional function.
+   * @returns {CompiledExpressionFunction} The ternary conditional function.
    */
   "ternary?:"(
     test: Function,
     alternate: Function,
     consequent: Function,
     context?: any,
-  ): Function;
+  ): CompiledExpressionFunction;
   /**
    * Returns the value of a literal.
    * @param {*} value - The literal value.
    * @param {Object} [context] - The context.
-   * @returns {import("./interface.ts").CompiledExpressionFunction} The function returning the literal value.
+   * @returns {CompiledExpressionFunction} The function returning the literal value.
    */
-  value(
-    value: any,
-    context?: any,
-  ): import("./interface.ts").CompiledExpressionFunction;
+  value(value: any, context?: any): CompiledExpressionFunction;
   /**
    * Returns the value of an identifier.
    * @param {string} name - The identifier name.
    * @param {Object} [context] - The context.
    * @param {boolean|1} [create] - Whether to create the identifier if it does not exist.
-   * @returns {import("./interface.ts").CompiledExpressionFunction} The function returning the identifier value.
+   *  @returns {CompiledExpressionFunction}  The function returning the identifier value.
    */
   identifier(
     name: string,
     context?: any,
     create?: boolean | 1,
-  ): import("./interface.ts").CompiledExpressionFunction;
+  ): CompiledExpressionFunction;
   /**
    * Returns the value of a non-computed member expression.
    * @param {function} left - The left operand function.
    * @param {string} right - The right operand function.
    * @param {Object} [context] - The context.
    * @param {boolean|1} [create] - Whether to create the member if it does not exist.
-   * @returns {function} The function returning the non-computed member value.
+   * @returns {CompiledExpressionFunction}  The function returning the non-computed member value.
    */
   nonComputedMember(
     left: Function,
     right: string,
     context?: any,
     create?: boolean | 1,
-  ): Function;
+  ): CompiledExpressionFunction;
   #private;
 }
 export type ASTNode = import("./ast/ast-node.ts").ASTNode;

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

@@ -47,3 +47,9 @@ export interface ScopeEvent {
    */
   defaultPrevented: boolean;
 }
+export type ScopeProxied<T extends object> = T & {
+  /** The Scope handler instance (your Proxy handler) */
+  $handler: ng.Scope;
+  /** The raw target object behind the proxy */
+  $target: T;
+};

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

@@ -129,12 +129,13 @@ export class Scope {
    * @param {string} watchProp - An expression to be watched in the context of this model.
    * @param {ng.ListenerFn} [listenerFn] - A function to execute when changes are detected on watched context.
    * @param {boolean} [lazy] - A flag to indicate if the listener should be invoked immediately. Defaults to false.
+   * @return {(() => void) | undefined} - A function to deregister the watcher, or undefined if no listener function is provided.
    */
   $watch(
     watchProp: string,
     listenerFn?: ng.ListenerFn,
     lazy?: boolean,
-  ): () => void;
+  ): (() => void) | undefined;
   /**
    * @param {ng.Scope} [childInstance]
    * @returns {Proxy<ng.Scope> & ng.Scope}

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

@@ -18,20 +18,37 @@ export function AriaProvider(): void;
 export class AriaProvider {
   config: (newConfig: any) => void;
   $get: () => {
-    config(key: any): any;
+    /**
+     * @param {string | number} key
+     */
+    config(key: string | number): any;
     _watchExpr: (
-      attrName: any,
+      attrName: string | number,
       ariaAttr: any,
-      nativeAriaNodeNamesParam: any,
+      nativeAriaNodeNamesParam: string | any[],
       negate: any,
-    ) => (scope: any, elem: any, attr: any) => void;
+    ) => (
+      /** @type {ng.Scope} */ scope: ng.Scope,
+      /** @type {HTMLElement} */ elem: HTMLElement,
+      /** @type {ng.Attributes} */ attr: ng.Attributes,
+    ) => void;
   };
 }
-export function ngDisabledAriaDirective($aria: any): any;
+/**
+ * @param {ng.AriaService} $aria
+ */
+export function ngDisabledAriaDirective(
+  $aria: ng.AriaService,
+): (scope: ng.Scope, elem: HTMLElement, attr: ng.Attributes) => void;
 export namespace ngDisabledAriaDirective {
   let $inject: string[];
 }
-export function ngShowAriaDirective($aria: any): any;
+/**
+ * @param {ng.AriaService} $aria
+ */
+export function ngShowAriaDirective(
+  $aria: ng.AriaService,
+): (scope: ng.Scope, elem: HTMLElement, attr: ng.Attributes) => void;
 export namespace ngShowAriaDirective {
   let $inject_1: string[];
   export { $inject_1 as $inject };
@@ -41,61 +58,84 @@ export namespace ngShowAriaDirective {
  */
 export function ngMessagesAriaDirective(): ng.Directive;
 /**
- * @param $aria
+ * @param {ng.AriaService} $aria
  * @param {ng.ParseService} $parse
  * @return {ng.Directive}
  */
 export function ngClickAriaDirective(
-  $aria: any,
+  $aria: ng.AriaService,
   $parse: ng.ParseService,
 ): ng.Directive;
 export namespace ngClickAriaDirective {
   let $inject_2: string[];
   export { $inject_2 as $inject };
 }
-export function ngRequiredAriaDirective($aria: any): any;
+/**
+ * @param {ng.AriaService} $aria
+ */
+export function ngRequiredAriaDirective(
+  $aria: ng.AriaService,
+): (scope: ng.Scope, elem: HTMLElement, attr: ng.Attributes) => void;
 export namespace ngRequiredAriaDirective {
   let $inject_3: string[];
   export { $inject_3 as $inject };
 }
-export function ngCheckedAriaDirective($aria: any): any;
+/**
+ * @param {ng.AriaService} $aria
+ */
+export function ngCheckedAriaDirective(
+  $aria: ng.AriaService,
+): (scope: ng.Scope, elem: HTMLElement, attr: ng.Attributes) => void;
 export namespace ngCheckedAriaDirective {
   let $inject_4: string[];
   export { $inject_4 as $inject };
 }
-export function ngValueAriaDirective($aria: any): any;
+/**
+ * @param {ng.AriaService} $aria
+ */
+export function ngValueAriaDirective(
+  $aria: ng.AriaService,
+): (scope: ng.Scope, elem: HTMLElement, attr: ng.Attributes) => void;
 export namespace ngValueAriaDirective {
   let $inject_5: string[];
   export { $inject_5 as $inject };
 }
-export function ngHideAriaDirective($aria: any): any;
+/**
+ * @param {ng.AriaService} $aria
+ */
+export function ngHideAriaDirective(
+  $aria: ng.AriaService,
+): (scope: ng.Scope, elem: HTMLElement, attr: ng.Attributes) => void;
 export namespace ngHideAriaDirective {
   let $inject_6: string[];
   export { $inject_6 as $inject };
 }
-export function ngReadonlyAriaDirective($aria: any): any;
+/**
+ * @param {ng.AriaService} $aria
+ */
+export function ngReadonlyAriaDirective(
+  $aria: ng.AriaService,
+): (scope: ng.Scope, elem: HTMLElement, attr: ng.Attributes) => void;
 export namespace ngReadonlyAriaDirective {
   let $inject_7: string[];
   export { $inject_7 as $inject };
 }
-export function ngModelAriaDirective($aria: any): {
-  restrict: string;
-  require: string;
-  priority: number;
-  compile(
-    _: any,
-    attr: any,
-  ): {
-    post(_: any, elem: any, attrPost: any, ngModel: any): void;
-  };
-};
+/**
+ * @param {ng.AriaService} $aria
+ * @returns {ng.Directive}
+ */
+export function ngModelAriaDirective($aria: ng.AriaService): ng.Directive;
 export namespace ngModelAriaDirective {
   let $inject_8: string[];
   export { $inject_8 as $inject };
 }
+/**
+ * @param {ng.AriaService} $aria
+ * @returns {import("../../interface.js").DirectiveLinkFn<any>}
+ */
 export function ngDblclickAriaDirective(
-  $aria: any,
-): (scope: any, elem: any, attr: any) => void;
+  $aria: ng.AriaService,
+): import("../../interface.js").DirectiveLinkFn<any>;
 export namespace ngDblclickAriaDirective {
   let $inject_9: string[];
   export { $inject_9 as $inject };

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

@@ -0,0 +1,9 @@
+export interface AriaService {
+  config(key: string | number): any;
+  _watchExpr(
+    attrName: string | number,
+    ariaAttr: string,
+    nativeAriaNodeNamesParam: string[],
+    negate: boolean,
+  ): (scope: ng.Scope, elem: HTMLElement, attr: ng.Attributes) => void;
+}

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

@@ -1,3 +1,34 @@
+/**
+ * Returns all items from `tokens1` that are not present in `tokens2`.
+ *
+ * @param {string[]} tokens1
+ * @param {string[]} tokens2
+ * @returns {string[]}
+ */
+export function arrayDifference(tokens1: string[], tokens2: string[]): string[];
+/**
+ * Split a class string into tokens.
+ *
+ * - Trims leading/trailing whitespace
+ * - Collapses any whitespace runs (space/tab/newline) into token boundaries
+ *
+ * @param {string} classString
+ * @return {string[]}
+ */
+export function split(classString: string): string[];
+/**
+ * Convert an `ngClass` expression value into a space-delimited class string.
+ *
+ * Supports:
+ * - string: returned as-is
+ * - array: flattened and joined with spaces (falsy items are ignored)
+ * - object: keys with truthy values are included
+ * - other primitives: stringified
+ *
+ * @param {unknown} classValue
+ * @returns {string}
+ */
+export function toClassString(classValue: unknown): string;
 export const ngClassDirective: import("../../interface.ts").DirectiveFactory;
 export const ngClassOddDirective: import("../../interface.ts").DirectiveFactory;
 export const ngClassEvenDirective: import("../../interface.ts").DirectiveFactory;

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

@@ -1,4 +1,3 @@
-export function setupValidity(instance: any): void;
 /**
  * @param {FormController|ng.NgModelController} ctrl
  * @param {string} className
@@ -16,7 +15,7 @@ export function cachedToggleClass(
  *   $getControls: () => any[],
  *   _renameControl: Function,
  *   $removeControl: Function,
- *   $setValidity: Function | ((key: any, isValid: boolean, control: any) => any),
+ *   $setValidity: Function | ((key: any, isValid: boolean | undefined | null, control: any) => any),
  *   $setDirty: Function,
  *   $setPristine: Function,
  *   $setSubmitted: Function,
@@ -29,7 +28,9 @@ export const nullFormCtrl: {
   $getControls: () => any[];
   _renameControl: Function;
   $removeControl: Function;
-  $setValidity: Function | ((key: any, isValid: boolean, control: any) => any);
+  $setValidity:
+    | Function
+    | ((key: any, isValid: boolean | undefined | null, control: any) => any);
   $setDirty: Function;
   $setPristine: Function;
   $setSubmitted: Function;
@@ -99,7 +100,10 @@ export class FormController {
   );
   /** @type {boolean} */
   _isAnimated: boolean;
-  _controls: any[];
+  /**
+   * @type {FormController[]}
+   */
+  _controls: FormController[];
   $name: any;
   /**
    * @property {boolean} $dirty True if user has already interacted with the form.
@@ -109,18 +113,27 @@ export class FormController {
    * @propertys {boolean} $pristine - True if user has not interacted with the form yet.s
    */
   $pristine: boolean;
-  $valid: boolean;
-  $invalid: boolean;
+  /** @type {boolean | undefined} */
+  $valid: boolean | undefined;
+  /** @type {boolean | undefined} */
+  $invalid: boolean | undefined;
   $submitted: boolean;
   /** @type {FormController|Object} */
   _parentForm: FormController | any;
   _element: HTMLFormElement;
-  _animate: import("../../animations/interface.ts").AnimateService;
-  $error: {};
-  _success: {};
-  $pending: any;
-  _classCache: {};
-  $target: {};
+  _animate: import("../../docs.ts").AnimateService;
+  /** @type {Record<string, any>} */
+  $error: Record<string, any>;
+  /** @type {Record<string, any>} */
+  _success: Record<string, any>;
+  /**
+   * @type {Record<string, any>| undefined}
+   */
+  $pending: Record<string, any> | undefined;
+  /** @type {Record<string, any>} */
+  _classCache: Record<string, any>;
+  /** @type {Record<string, any>} */
+  $target: Record<string, any>;
   /**
    * Rollback all form controls pending updates to the `$modelValue`.
    *
@@ -151,8 +164,9 @@ export class FormController {
    *
    * For example, if an input control is added that is already `$dirty` and has `$error` properties,
    * calling `$setDirty()` and `$validate()` afterwards will propagate the state to the parent form.
+   * @param {FormController} control
    */
-  $addControl(control: any): void;
+  $addControl(control: FormController): void;
   /**
    * This method returns a **shallow copy** of the controls that are currently part of this form.
    * The controls can be instances of {@link form.FormController `FormController`}
@@ -170,7 +184,11 @@ export class FormController {
    * @returns {ReadonlyArray<FormController>}
    */
   $getControls(): ReadonlyArray<FormController>;
-  _renameControl(control: any, newName: any): void;
+  /**
+   * @param {FormController} control
+   * @param {string | number} newName
+   */
+  _renameControl(control: FormController, newName: string | number): void;
   /**
    * Deregister a control from the form.
    *
@@ -219,8 +237,26 @@ export class FormController {
    */
   $setSubmitted(): void;
   _setSubmitted(): void;
-  set(object: any, property: any, controller: any): void;
-  unset(object: any, property: any, controller: any): void;
+  /**
+   * @param {Record<string, any>} object
+   * @param {string} property
+   * @param {FormController | import("../model/model.js").NgModelController} controller
+   */
+  set(
+    object: Record<string, any>,
+    property: string,
+    controller: FormController | import("../model/model.js").NgModelController,
+  ): void;
+  /**
+   * @param {Record<string, any>} object
+   * @param {string} property
+   * @param {FormController | import("../model/model.js").NgModelController} controller
+   */
+  unset(
+    object: Record<string, any>,
+    property: string,
+    controller: FormController | import("../model/model.js").NgModelController,
+  ): void;
   /**
    * Change the validity state of the form, and notify the parent form (if any).
    *
@@ -234,7 +270,7 @@ export class FormController {
    *        `validationErrorKey` should be in camelCase and will get converted into dash-case for
    *        class name. Example: `myError` will result in `ng-valid-my-error` and
    *        `ng-invalid-my-error` classes and can be bound to as `{{ someForm.$error.myError }}`.
-   * @param {boolean} state Whether the current state is valid (true), invalid (false), pending
+   * @param {boolean | null | undefined} state Whether the current state is valid (true), invalid (false), pending
    *        (undefined),  or skipped (null). Pending is used for unfulfilled `$asyncValidators`.
    *        Skipped is used by AngularTS when validators do not run because of parse errors and when
    *        `$asyncValidators` do not run because any of the `$validators` failed.
@@ -243,7 +279,7 @@ export class FormController {
    */
   $setValidity(
     validationErrorKey: string,
-    state: boolean,
+    state: boolean | null | undefined,
     controller: import("../model/model.js").NgModelController | FormController,
   ): void;
 }