@angular-wave/angular.ts 0.0.48 → 0.0.50

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

@@ -0,0 +1,153 @@
+/**
+ * @typedef {Object} LexerOptions
+ * @property {(ch: string, codePoint: number) => boolean} [isIdentifierStart] - Custom function to determine if a character is a valid identifier start.
+ * @property {(ch: string, codePoint: number) => boolean} [isIdentifierContinue] - Custom function to determine if a character is a valid identifier continuation.
+ */
+/**
+ * Represents a token produced by the lexer.
+ * @typedef {Object} Token
+ * @property {number} index - Index of the token.
+ * @property {string} text - Text of the token.
+ * @property {boolean} [identifier] - Indicates if token is an identifier.
+ * @property {boolean} [constant] - Indicates if token is a constant.
+ * @property {string|number} [value] - Value of the token if it's a constant.
+ * @property {boolean} [operator] - Indicates if token is an operator.
+ */
+/**
+ * Represents a lexer that tokenizes input text. The Lexer takes the original expression string and returns an array of tokens parsed from that string.
+ * For example, the string "a + b" would result in tokens for a, +, and b.
+ */
+export class Lexer {
+    /**
+     * Creates an instance of Lexer.
+     * @param {LexerOptions} options - Lexer options.
+     */
+    constructor(options: LexerOptions);
+    /** @type {LexerOptions} */
+    options: LexerOptions;
+    /**
+     * Tokenizes the input text.
+     * @param {string} text Input text to lex.
+     * @returns {Array<Token>} Array of tokens.
+     */
+    lex(text: string): Array<Token>;
+    text: string;
+    index: number;
+    /** @type {Array<Token>} */
+    tokens: Array<Token>;
+    /**
+     * Checks if a character is contained in a set of characters.
+     * @param {string} ch Character to check.
+     * @param {string} chars Set of characters.
+     * @returns {boolean} True if character is in the set, false otherwise.
+     */
+    is(ch: string, chars: string): boolean;
+    /**
+     * Peeks at the next character in the text.
+     * @param {number} [i=1] Number of characters to peek.
+     * @returns {string|false} Next character or false if end of text.
+     */
+    peek(i?: number): string | false;
+    /**
+     * Checks if a character is a number.
+     * @param {string} ch Character to check.
+     * @returns {boolean} True if character is a number, false otherwise.
+     */
+    isNumber(ch: string): boolean;
+    /**
+     * Checks if a character is whitespace.
+     * @param {string} ch Character to check.
+     * @returns {boolean} True if character is whitespace, false otherwise.
+     */
+    isWhitespace(ch: string): boolean;
+    /**
+     * Checks if a character is a valid identifier start.
+     * @param {string} ch Character to check.
+     * @returns {boolean} True if character is a valid identifier start, false otherwise.
+     */
+    isIdentifierStart(ch: string): boolean;
+    /**
+     * Checks if a character is a valid identifier continuation.
+     * @param {string} ch Character to check.
+     * @returns {boolean} True if character is a valid identifier continuation, false otherwise.
+     */
+    isIdentifierContinue(ch: string): boolean;
+    /**
+     * Converts a character to its Unicode code point.
+     * @param {string} ch Character to convert.
+     * @returns {number} Unicode code point.
+     */
+    codePointAt(ch: string): number;
+    /**
+     * Peeks at the next multicharacter sequence in the text.
+     * @returns {string} Next multicharacter sequence.
+     */
+    peekMultichar(): string;
+    /**
+     * Checks if a character is an exponent operator.
+     * @param {string} ch Character to check.
+     * @returns {boolean} True if character is an exponent operator, false otherwise.
+     */
+    isExpOperator(ch: string): boolean;
+    /**
+     * Throws a lexer error.
+     * @param {string} error Error message.
+     * @param {number} [start] Start index.
+     * @param {number} [end] End index.
+     * @throws {Error} Lexer error.
+     */
+    throwError(error: string, start?: number, end?: number): void;
+    /**
+     * Reads and tokenizes a number from the text.
+     */
+    readNumber(): void;
+    /**
+     * Reads and tokenizes an identifier from the text.
+     */
+    readIdent(): void;
+    /**
+     * Reads and tokenizes a string from the text.
+     * @param {string} quote Quote character used for the string.
+     */
+    readString(quote: string): void;
+    handleUnicodeEscape(): string;
+}
+export type LexerOptions = {
+    /**
+     * - Custom function to determine if a character is a valid identifier start.
+     */
+    isIdentifierStart?: (ch: string, codePoint: number) => boolean;
+    /**
+     * - Custom function to determine if a character is a valid identifier continuation.
+     */
+    isIdentifierContinue?: (ch: string, codePoint: number) => boolean;
+};
+/**
+ * Represents a token produced by the lexer.
+ */
+export type Token = {
+    /**
+     * - Index of the token.
+     */
+    index: number;
+    /**
+     * - Text of the token.
+     */
+    text: string;
+    /**
+     * - Indicates if token is an identifier.
+     */
+    identifier?: boolean;
+    /**
+     * - Indicates if token is a constant.
+     */
+    constant?: boolean;
+    /**
+     * - Value of the token if it's a constant.
+     */
+    value?: string | number;
+    /**
+     * - Indicates if token is an operator.
+     */
+    operator?: boolean;
+};

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

@@ -1,12 +1,3 @@
-/**
- * @ngdoc provider
- * @name $parseProvider
- *
- *
- * @description
- * `$parseProvider` can be used for configuring the default behavior of the {@link ng.$parse $parse}
- *  service.
- */
 export function $ParseProvider(): void;
 export class $ParseProvider {
     /**
@@ -22,11 +13,6 @@ export class $ParseProvider {
      **/
     addLiteral: (literalName: string, literalValue: any) => void;
     /**
-     * @ngdoc method
-     * @name $parseProvider#setIdentifierFns
-     *
-     * @description
-     *
      * Allows defining the set of characters that are allowed in AngularJS expressions. The function
      * `identifierStart` will get called to know if a given character is a valid character to be the
      * first character for an identifier. The function `identifierContinue` will get called to know if
@@ -40,32 +26,34 @@ export class $ParseProvider {
      * Since this function will be called extensively, keep the implementation of these functions fast,
      * as the performance of these functions have a direct impact on the expressions parsing speed.
      *
-     * @param {function=} identifierStart The function that will decide whether the given character is
+     * @param {function(any):boolean} [identifierStart] The function that will decide whether the given character is
      *   a valid identifier start character.
-     * @param {function=} identifierContinue The function that will decide whether the given character is
+     * @param {function(any):boolean} [identifierContinue] The function that will decide whether the given character is
      *   a valid identifier continue character.
+     * @returns {$ParseProvider}
      */
-    setIdentifierFns: (identifierStart?: Function | undefined, identifierContinue?: Function | undefined) => this;
+    setIdentifierFns: (identifierStart?: (arg0: any) => boolean, identifierContinue?: (arg0: any) => boolean) => $ParseProvider;
     $get: (string | (($filter: any) => {
         (exp: any, interceptorFn: any): any;
-        $$getAst: (exp: any) => {
-            type: string;
-            body: {
-                type: string;
-                expression: any;
-            }[];
-        };
+        $$getAst: (exp: string) => import("./ast").ASTNode;
     }))[];
 }
-export function inputsWatchDelegate(scope: any, listener: any, objectEquality: any, parsedExpression: any): any;
-export function oneTimeWatchDelegate(scope: any, listener: any, objectEquality: any, parsedExpression: any): any;
-export function chainInterceptors(first: any, second: any): {
-    (value: any): any;
-    $stateful: any;
-    $$pure: any;
-};
-export function expressionInputDirtyCheck(newValue: any, oldValueOfValue: any, compareObjectIdentity: any): boolean;
-export function isAllDefined(value: any): boolean;
+export function constantWatchDelegate(scope: any, listener: any, objectEquality: any, parsedExpression: any): any;
+/**
+ * @typedef {function} CompiledExpression
+ * @param {import('../scope/scope').Scope} context - An object against which any expressions embedded in the strings are evaluated against (typically a scope object).
+ * @param {object} [locals] - local variables context object, useful for overriding values in `context`.
+ * @returns {any}
+ * @property {boolean} literal - Indicates if the expression is a literal.
+ * @property {boolean} constant - Indicates if the expression is constant.
+ * @property {function(any, any): any} assign - Assigns a value to a context. If value is not provided,
+ * undefined is gonna be used since the implementation
+ * does not check the parameter. Let's force a value for consistency. If consumer
+ * wants to undefine it, pass the undefined value explicitly.
+ */
+/**
+ * @typedef {function(string|function(import('../scope/scope').Scope):any, function(any, import('../scope/scope').Scope, any):any=, boolean=): CompiledExpression} ParseService
+ */
 export const $parseMinErr: (arg0: string, ...arg1: any[]) => Error;
 export namespace literals {
     let _true: boolean;
@@ -76,4 +64,5 @@ export namespace literals {
     export { _null as null };
     export let undefined: any;
 }
-export type ParseService = (arg0: string | ((arg0: import("../scope/scope").Scope) => any), arg1: ((arg0: any, arg1: Scope, arg2: any) => any) | undefined, arg2: boolean | undefined) => import("../../types").CompiledExpression;
+export type CompiledExpression = Function;
+export type ParseService = (arg0: string | ((arg0: import("../scope/scope").Scope) => any), arg1: ((arg0: any, arg1: import("../scope/scope").Scope, arg2: any) => any) | undefined, arg2: boolean | undefined) => CompiledExpression;

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

@@ -1,22 +1,51 @@
+/**
+ * @typedef {Object} ParsedAST
+ * @property {import("./ast").ASTNode} ast - AST representation of expression
+ * @property {boolean} oneTime - True if expression should be evaluated only once
+ */
+/**
+ * @typedef {Object} ParserOptions
+ * @property {function(string):any} literals
+ */
 /**
  * @constructor
  */
 export class Parser {
-    constructor(lexer: any, $filter: any, options: any);
+    /**
+     *
+     * @param {import('./lexer').Lexer} lexer
+     * @param {function(any):any} $filter
+     * @param {ParserOptions} options
+     */
+    constructor(lexer: import("./lexer").Lexer, $filter: (arg0: any) => any, options: ParserOptions);
+    /** @type {AST} */
     ast: AST;
-    astCompiler: ASTInterpreter | ASTCompiler;
-    parse(text: any): any;
-    getAst(exp: any): {
-        ast: {
-            type: string;
-            body: {
-                type: string;
-                expression: any;
-            }[];
-        };
-        oneTime: boolean;
-    };
+    /** @type {ASTInterpreter} */
+    astCompiler: ASTInterpreter;
+    /**
+     *
+     * @param {string} exp - Expression to be parsed
+     * @returns
+     */
+    parse(exp: string): any;
+    /**
+     * @param {string} exp - Expression to be parsed
+     * @returns {ParsedAST}
+     */
+    getAst(exp: string): ParsedAST;
 }
+export type ParsedAST = {
+    /**
+     * - AST representation of expression
+     */
+    ast: import("./ast").ASTNode;
+    /**
+     * - True if expression should be evaluated only once
+     */
+    oneTime: boolean;
+};
+export type ParserOptions = {
+    literals: (arg0: string) => any;
+};
 import { AST } from "./ast";
 import { ASTInterpreter } from "./interpreter";
-import { ASTCompiler } from "./compiler";

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

@@ -11,7 +11,13 @@ export function ifDefined(v: any, d: any): any;
 export function plusFn(l: any, r: any): any;
 export function isStateless($filter: any, filterName: any): boolean;
 export function isPure(node: any, parentIsPure: any): any;
-export function findConstantAndWatchExpressions(ast: any, $filter: any, parentIsPure: any): void;
+/**
+ * Decorates ast with constant, toWatch, and isPure properties
+ * @param {import("./ast").ASTNode} ast
+ * @param {function(any):any} $filter
+ * @param {*} parentIsPure
+ */
+export function findConstantAndWatchExpressions(ast: import("./ast").ASTNode, $filter: (arg0: any) => any, parentIsPure: any): void;
 export function getInputs(body: any): any;
 export function isAssignable(ast: any): boolean;
 export function assignableAST(ast: any): {

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

@@ -61,7 +61,7 @@ export const $$applyAsyncQueue: Function[];
  *
  */
 export class $RootScopeProvider {
-    $get: (string | ((exceptionHandler: import("../exception-handler").ErrorHandler, parse: angular.IParseService, browser: import("../../services/browser").Browser) => Scope))[];
+    $get: (string | ((exceptionHandler: import("../exception-handler").ErrorHandler, parse: import("../parser/parse").ParseService, browser: import("../../services/browser").Browser) => Scope))[];
 }
 /**
  * DESIGN NOTES
@@ -103,9 +103,9 @@ export class Scope {
      */
     $root: Scope | null;
     /**
-     * @type {[]}
+     * @type {Array<any>}
      */
-    $$watchers: [];
+    $$watchers: Array<any>;
     /**
      * @type {number}
      */
@@ -296,10 +296,10 @@ export class Scope {
      *   values are examined for changes on every call to `$digest`.
      * - The `listener` is called whenever any expression in the `watchExpressions` array changes.
      *
-     * @param {Array.<string|Function(scope)>} watchExpressions Array of expressions that will be individually
+     * @param {Array.<string|((Scope)=>any)>} watchExpressions Array of expressions that will be individually
      * watched using {@link ng.$rootScope.Scope#$watch $watch()}
      *
-     * @param {function(newValues, oldValues, scope)} listener Callback called whenever the return value of any
+     * @param {function(any, any, Scope): any} listener Callback called whenever the return value of any
      *    expression in `watchExpressions` changes
      *    The `newValues` array contains the current values of the `watchExpressions`, with the indexes matching
      *    those of `watchExpression`
@@ -308,7 +308,7 @@ export class Scope {
      *    The `scope` refers to the current scope.
      * @returns {function()} Returns a de-registration function for all listeners.
      */
-    $watchGroup(watchExpressions: any, listener: (arg0: any[], arg1: any[], arg2: scope) => any): () => any;
+    $watchGroup(watchExpressions: Array<string | ((Scope: any) => any)>, listener: (arg0: any, arg1: any, arg2: Scope) => any): () => any;
     /**
      * @ngdoc method
      * @name $rootScope.Scope#$watchCollection
@@ -327,12 +327,12 @@ export class Scope {
      *
      *
      *
-     * @param {string|function(scope)} obj Evaluated as {@link guide/expression expression}. The
+     * @param {string|function(Scope):any} obj Evaluated as {@link guide/expression expression}. The
      *    expression value should evaluate to an object or an array which is observed on each
      *    {@link ng.$rootScope.Scope#$digest $digest} cycle. Any shallow change within the
      *    collection will trigger a call to the `listener`.
      *
-     * @param {function(newCollection, oldCollection, scope)} listener a callback function called
+     * @param {function(any[], any[], Scope):any} listener a callback function called
      *    when a change is detected.
      *    - The `newCollection` object is the newly modified data obtained from the `obj` expression
      *    - The `oldCollection` object is a copy of the former collection data.
@@ -343,7 +343,7 @@ export class Scope {
      * @returns {function()} Returns a de-registration function for this listener. When the
      *    de-registration function is executed, the internal watch operation is terminated.
      */
-    $watchCollection(obj: string | ((arg0: scope) => any), listener: (arg0: newCollection, arg1: oldCollection, arg2: scope) => any): () => any;
+    $watchCollection(obj: string | ((arg0: Scope) => any), listener: (arg0: any[], arg1: any[], arg2: Scope) => any): () => any;
     /**
    * @ngdoc method
    * @name $rootScope.Scope#$digest
@@ -630,10 +630,10 @@ export class Scope {
      *   - `defaultPrevented` - `{boolean}`: true if `preventDefault` was called.
      *
      * @param {string} name Event name to listen on.
-     * @param {function(angular.IAngularEvent): any} listener Function to call when the event is emitted.
+     * @param {function(any): any} listener Function to call when the event is emitted witn angular.IAngularEvent
      * @returns {function()} Returns a deregistration function for this listener.
      */
-    $on(name: string, listener: (arg0: angular.IAngularEvent) => any): () => any;
+    $on(name: string, listener: (arg0: any) => any): () => any;
     /**
    * @ngdoc method
    * @name $rootScope.Scope#$eval

package/types/shared/jqlite/jqlite.d.ts

@@ -66,16 +66,16 @@ export class JQLite {
     /**
      * Gets or sets data on a parent element
      * @param {string} name
-     * @param {any} value
+     * @param {any} [value]
      * @returns {JQLite|any}
      */
-    inheritedData(name: string, value: any): JQLite | any;
+    inheritedData(name: string, value?: any): JQLite | any;
     /**
      * Gets or sets innerHTML on the first element in JQLite collection
-     * @param {string} value
+     * @param {string} [value]
      * @returns {JQLite|any|undefined}
      */
-    html(value: string): JQLite | any | undefined;
+    html(value?: string): JQLite | any | undefined;
     /**
      * Get the combined text contents of each element in the JQLite collection
      * or set the text contents of all elements.

package/types/types.d.ts

@@ -1,6 +1,6 @@
 export type BootstrapConfig = any;
 export type Injectable<T_1> = Function | Array<string | Function>;
-export type CompiledExpression = (arg0: any, arg1: any | undefined) => any;
+export type CompiledExpression = Function;
 export type ComponentOptions = any;
 export type ControllerConstructor = Function;
 export type OnChangesObject = any;