@angular-wave/angular.ts 0.3.0 → 0.3.1

package/package.json

@@ -2,7 +2,7 @@
   "name": "@angular-wave/angular.ts",
   "description": "A modern, optimized and typesafe version of AngularJS",
   "license": "MIT",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "type": "module",
   "main": "dist/angular-ts.esm.js",
   "browser": "dist/angular-ts.umd.js",

package/src/animations/animate-cache.js

@@ -75,6 +75,6 @@ export function animateCache() {
   };
 }
 
-export function $$AnimateCacheProvider() {
+export function AnimateCacheProvider() {
   this.$get = [animateCache];
 }

package/src/animations/animate-css-driver.js

@@ -8,8 +8,8 @@ const NG_ANIMATE_ANCHOR_CLASS_NAME = "ng-anchor";
 const NG_OUT_ANCHOR_CLASS_NAME = "ng-anchor-out";
 const NG_IN_ANCHOR_CLASS_NAME = "ng-anchor-in";
 
-$$AnimateCssDriverProvider.$inject = ["$$animationProvider"];
-export function $$AnimateCssDriverProvider($$animationProvider) {
+AnimateCssDriverProvider.$inject = ["$$animationProvider"];
+export function AnimateCssDriverProvider($$animationProvider) {
   $$animationProvider.drivers.push("$$animateCssDriver");
 
   function isDocumentFragment(node) {

package/src/animations/animate-css.js

@@ -137,7 +137,7 @@ function registerRestorableStyles(backup, node, properties) {
   });
 }
 
-export function $AnimateCssProvider() {
+export function AnimateCssProvider() {
   this.$get = [
     "$$AnimateRunner",
     "$timeout",

package/src/animations/animate-js-driver.js

@@ -1,7 +1,7 @@
 import { forEach } from "../shared/utils";
 
-$$AnimateJsDriverProvider.$inject = ["$$animationProvider"];
-export function $$AnimateJsDriverProvider($$animationProvider) {
+AnimateJsDriverProvider.$inject = ["$$animationProvider"];
+export function AnimateJsDriverProvider($$animationProvider) {
   $$animationProvider.drivers.push("$$animateJsDriver");
   this.$get = [
     "$$animateJs",

package/src/animations/animate-js.js

@@ -8,8 +8,8 @@ import {
 // TODO: use caching here to speed things up for detection
 // TODO: add documentation
 
-$$AnimateJsProvider.$inject = ["$animateProvider"];
-export function $$AnimateJsProvider($animateProvider) {
+AnimateJsProvider.$inject = ["$animateProvider"];
+export function AnimateJsProvider($animateProvider) {
   this.$get = [
     "$injector",
     "$$AnimateRunner",

package/src/animations/animate-queue.js

@@ -24,8 +24,8 @@ import {
 
 const NG_ANIMATE_ATTR_NAME = "data-ng-animate";
 const NG_ANIMATE_PIN_DATA = "$ngAnimatePin";
-$$AnimateQueueProvider.$inject = ["$animateProvider"];
-export function $$AnimateQueueProvider($animateProvider) {
+AnimateQueueProvider.$inject = ["$animateProvider"];
+export function AnimateQueueProvider($animateProvider) {
   const PRE_DIGEST_STATE = 1;
   const RUNNING_STATE = 2;
   const ONE_SPACE = " ";

package/src/animations/animation.js

@@ -12,7 +12,7 @@ import {
 const RUNNER_STORAGE_KEY = "$$animationRunner";
 const PREPARE_CLASSES_KEY = "$$animatePrepareClasses";
 
-export function $$AnimationProvider() {
+export function AnimationProvider() {
   const NG_ANIMATE_REF_ATTR = "ng-animate-ref";
 
   const drivers = (this.drivers = []);

package/src/core/cache/cache-factory.js

@@ -1,3 +1,19 @@
-export function TemplateCacheProvider() {
-  this.$get = () => new Map();
+/**
+ * A cache for maping template names to their respective content.
+ *
+ * @typedef {Map<string, string>} TemplateCache
+ */
+
+/**
+ * Service responsible for providing a cache for templates.
+ *
+ * @class TemplateCacheProvider
+ * @description Provides an instance of a template cache that can be used to store and retrieve template content.
+ */
+export class TemplateCacheProvider {
+  /**
+   * @description Returns a new instance of a `TemplateCache`, which is a Map used to store templates.
+   * @returns {TemplateCache} A new instance of the template cache (Map object).
+   */
+  $get = () => new Map();
 }

package/src/core/compile/compile.js

@@ -51,8 +51,8 @@ const $compileMinErr = minErr("$compile");
 const UNINITALIZED_VALIED = new Object();
 const EXCLUDED_DIRECTIVES = ["ngIf", "ngRepeat"];
 
-$CompileProvider.$inject = ["$provide", "$$sanitizeUriProvider"];
-export function $CompileProvider($provide, $$sanitizeUriProvider) {
+CompileProvider.$inject = ["$provide", "$$sanitizeUriProvider"];
+export function CompileProvider($provide, $$sanitizeUriProvider) {
   const hasDirectives = {};
   const Suffix = "Directive";
   const ALL_OR_NOTHING_ATTRS = {
@@ -186,7 +186,7 @@ export function $CompileProvider($provide, $$sanitizeUriProvider) {
    *    are the factories.
    * @param {Function|Array} directiveFactory An injectable directive factory function. See the
    *    {@link guide/directive directive guide} and the {@link $compile compile API} for more info.
-   * @returns {$CompileProvider} Self for chaining.
+   * @returns {CompileProvider} Self for chaining.
    */
   this.directive = function registerDirective(name, directiveFactory) {
     assertArg(name, "name");
@@ -282,7 +282,7 @@ export function $CompileProvider($provide, $$sanitizeUriProvider) {
    *    - `$...` – additional properties to attach to the directive factory function and the controller
    *      constructor function. (This is used by the component router to annotate)
    *
-   * @returns {$CompileProvider} the compile provider itself, for chaining of function calls.
+   * @returns {CompileProvider} the compile provider itself, for chaining of function calls.
    */
   this.component = function (name, options) {
     if (!isString(name)) {
@@ -362,7 +362,7 @@ export function $CompileProvider($provide, $$sanitizeUriProvider) {
    * the absolute url is prefixed with `'unsafe:'` string and only then is it written into the DOM.
    *
    * @param {RegExp=} regexp New regexp to trust urls with.
-   * @returns {RegExp|$CompileProvider} Current RegExp if called without value or self for
+   * @returns {RegExp|CompileProvider} Current RegExp if called without value or self for
    *    chaining otherwise.
    */
   this.aHrefSanitizationTrustedUrlList = function (regexp) {
@@ -385,7 +385,7 @@ export function $CompileProvider($provide, $$sanitizeUriProvider) {
    * the absolute url is prefixed with `'unsafe:'` string and only then is it written into the DOM.
    *
    * @param {RegExp=} regexp New regexp to trust urls with.
-   * @returns {RegExp|$CompileProvider} Current RegExp if called without value or self for
+   * @returns {RegExp|CompileProvider} Current RegExp if called without value or self for
    *    chaining otherwise.
    */
   this.imgSrcSanitizationTrustedUrlList = function (regexp) {
@@ -581,14 +581,12 @@ export function $CompileProvider($provide, $$sanitizeUriProvider) {
 
       const startSymbol = $interpolate.startSymbol();
       const endSymbol = $interpolate.endSymbol();
+      /** @type {(string) => string} */
       const denormalizeTemplate =
         startSymbol === "{{" && endSymbol === "}}"
           ? (x) => x
-          : function denormalizeTemplate(template) {
-              return template
-                .replace(/\{\{/g, startSymbol)
-                .replace(/}}/g, endSymbol);
-            };
+          : (x) => x.replace(/\{\{/g, startSymbol).replace(/}}/g, endSymbol);
+
       const NG_PREFIX_BINDING = /^ng(Attr|Prop|On)([A-Z].*)$/;
       const MULTI_ELEMENT_DIR_RE = /^(.+)Start$/;
       return compile;

package/src/core/compile/compile.spec.js

@@ -15166,7 +15166,6 @@ describe("$compile", () => {
           );
         initInjector("test1");
         $templateCache.set("baz.html", "<div>Baz</div>");
-        debugger;
         element = $compile("<trans><inner></inner></trans>")($rootScope);
         $rootScope.$digest();
 

package/src/core/controller/controller.js

@@ -25,7 +25,7 @@ export function identifierForController(controller, ident) {
  * This provider allows controller registration via the
  * {@link ng.$controllerProvider#register register} method.
  */
-export class $ControllerProvider {
+export class ControllerProvider {
   constructor() {
     /**
      * @type {Map<string, Function|Object>}

package/src/core/exception-handler.js

@@ -52,7 +52,7 @@ export const errorHandler = (exception, cause) => {
  * @constructor
  * @this {ExceptionHandlerProvider}
  */
-export function $ExceptionHandlerProvider() {
+export function ExceptionHandlerProvider() {
   this.$get = [
     "$log",
     /**

package/src/core/filter/filter.js

@@ -8,8 +8,8 @@ import {
   $IsStateFilter,
 } from "../../router/state-filters";
 
-$FilterProvider.$inject = ["$provide"];
-export function $FilterProvider($provide) {
+FilterProvider.$inject = ["$provide"];
+export function FilterProvider($provide) {
   const suffix = "Filter";
 
   function register(name, factory) {

package/src/core/interpolate/interpolate.js

@@ -40,7 +40,7 @@ function interr(text, err) {
  * security bugs!
  * </div>
  */
-export function $InterpolateProvider() {
+export function InterpolateProvider() {
   let startSymbol = "{{";
   let endSymbol = "}}";
 
@@ -48,7 +48,7 @@ export function $InterpolateProvider() {
    * Symbol to denote start of expression in the interpolated string. Defaults to `{{`.
    *
    * @param {string=} value new value to set the starting symbol to.
-   * @returns {string|$InterpolateProvider} Returns the symbol when used as getter and self if used as setter.
+   * @returns {string|InterpolateProvider} Returns the symbol when used as getter and self if used as setter.
    */
   this.startSymbol = function (value) {
     if (value) {
@@ -62,7 +62,7 @@ export function $InterpolateProvider() {
    * Symbol to denote the end of expression in the interpolated string. Defaults to `}}`.
    *
    * @param {string=} value new value to set the ending symbol to.
-   * @returns {string|$InterpolateProvider} Returns the symbol when used as getter and self if used as setter.
+   * @returns {string|InterpolateProvider} Returns the symbol when used as getter and self if used as setter.
    */
   this.endSymbol = function (value) {
     if (value) {

package/src/core/interval/interval-factory.js

@@ -1,6 +1,6 @@
 import { isDefined, sliceArgs } from "../../shared/utils";
 
-export function $$IntervalFactoryProvider() {
+export function $IntervalFactoryProvider() {
   this.$get = [
     "$browser",
     "$q",

package/src/core/interval/interval.js

@@ -13,7 +13,7 @@ const $intervalMinErr = minErr("$interval");
  */
 const intervals = new Map();
 
-export function $IntervalProvider() {
+export function IntervalProvider() {
   this.$get = [
     "$$intervalFactory",
     // TODO Add type

package/src/core/location/location.js

@@ -544,7 +544,7 @@ export class LocationHashbangUrl extends Location {
   }
 }
 
-export function $LocationProvider() {
+export function LocationProvider() {
   let hashPrefix = "!";
   const html5Mode = {
     enabled: false,

package/src/core/location/location.spec.js

@@ -1,7 +1,7 @@
 import {
   LocationHtml5Url,
   LocationHashbangUrl,
-  $LocationProvider,
+  LocationProvider,
 } from "./location";
 import { Angular } from "../../loader";
 import { createInjector } from "../di/injector";
@@ -23,12 +23,12 @@ describe("$location", () => {
 
   describe("defaults", () => {
     it('should have hashPrefix of "!"', () => {
-      let provider = new $LocationProvider();
+      let provider = new LocationProvider();
       expect(provider.hashPrefix()).toBe("!");
     });
 
     it("should not be html5 mode", () => {
-      let provider = new $LocationProvider();
+      let provider = new LocationProvider();
       expect(provider.html5Mode().enabled).toBeFalse();
     });
   });

package/src/core/parser/parse.js

@@ -33,7 +33,7 @@ import { Parser } from "./parser";
  * @typedef {function(CompiledExpression|string|function(import('../scope/scope').Scope):any, function(any, import('../scope/scope').Scope, any):any=, boolean=): CompiledExpression} ParseService
  */
 
-export function $ParseProvider() {
+export function ParseProvider() {
   const cache = Object.create(null);
 
   /** @type {function(any):boolean?} */
@@ -60,7 +60,7 @@ export function $ParseProvider() {
    *   a valid identifier start character.
    * @param {function(any):boolean} [identifierContinue] The function that will decide whether the given character is
    *   a valid identifier continue character.
-   * @returns {$ParseProvider}
+   * @returns {ParseProvider}
    */
   this.setIdentifierFns = function (identifierStart, identifierContinue) {
     identStart = identifierStart;

package/src/core/sce/sce.js

@@ -162,7 +162,7 @@ export function adjustMatcher(matcher) {
  * of issues, like for instance attacker-controlled `ng-includes`.
  */
 
-export function $SceDelegateProvider() {
+export function SceDelegateProvider() {
   this.SCE_CONTEXTS = SCE_CONTEXTS;
 
   // Resource URLs can also be trusted by policy.
@@ -473,7 +473,7 @@ export function $SceDelegateProvider() {
   ];
 }
 
-export function $SceProvider() {
+export function SceProvider() {
   let enabled = true;
 
   /**

package/src/core/scope/scope.js

@@ -92,7 +92,7 @@ let rootScope;
  * The provider also injects runtime services to make them available to all scopes.
  *
  */
-export class $RootScopeProvider {
+export class RootScopeProvider {
   constructor() {
     rootScope = new Scope();
   }

package/src/core/task-tracker-factory.js

@@ -1,4 +1,4 @@
-export class $$TaskTrackerFactoryProvider {
+export class TaskTrackerFactoryProvider {
   $get = [
     "$log",
     /**

package/src/core/timeout/timeout.js

@@ -3,8 +3,8 @@ import { isDefined, minErr, sliceArgs } from "../../shared/utils";
 
 const $timeoutMinErr = minErr("$timeout");
 
-export function $TimeoutProvider() {
-  this.$get = [
+export class TimeoutProvider {
+  $get = [
     "$rootScope",
     "$browser",
     "$q",
@@ -19,7 +19,7 @@ export function $TimeoutProvider() {
      * @param {import('../exception-handler').ErrorHandler} $exceptionHandler
      * @returns
      */
-    function ($rootScope, $browser, $q, $$q, $exceptionHandler) {
+    ($rootScope, $browser, $q, $$q, $exceptionHandler) => {
       const deferreds = {};
 
       /**

package/src/directive/if/if.js

@@ -18,10 +18,10 @@ export function ngIfDirective($animate) {
     restrict: "A",
     /**
      *
-     * @param {*} $scope
-     * @param {*} $element
-     * @param {*} $attr
-     * @param {*} _ctrl
+     * @param {import("../../core/scope/scope").Scope} $scope
+     * @param {import("../../shared/jqlite/jqlite").JQLite} $element
+     * @param {import("../../core/compile/attributes").Attributes} $attr
+     * @param {Object} _ctrl
      * @param {*} $transclude
      */
     link($scope, $element, $attr, _ctrl, $transclude) {
@@ -32,7 +32,7 @@ export function ngIfDirective($animate) {
       let childScope;
       /** @type {import("../../shared/jqlite/jqlite").JQLite} */
       let previousElements;
-      $scope.$watch($attr.ngIf, (value) => {
+      $scope.$watch($attr["ngIf"], (value) => {
         if (value) {
           if (!childScope) {
             $transclude((clone, newScope) => {

package/src/directive/script/script.js

@@ -1,15 +1,17 @@
-export const scriptDirective = [
-  "$templateCache",
-  ($templateCache) => ({
+scriptDirective.$inject = ["$templateCache"];
+
+/**
+ * @param {import('../../core/cache/cache-factory').TemplateCache} $templateCache
+ * @returns {import('../../types').Directive}
+ */
+export function scriptDirective($templateCache) {
+  return {
     restrict: "E",
     terminal: true,
     compile(element, attr) {
       if (attr.type === "text/ng-template") {
-        const templateUrl = attr.id;
-        const { text } = element[0];
-
-        $templateCache.set(templateUrl, text);
+        $templateCache.set(attr.id, element[0].text);
       }
     },
-  }),
-];
+  };
+}

package/src/directive/validators/validators.js

@@ -33,33 +33,45 @@ import { startingTag } from "../../shared/jqlite/jqlite";
  */
 export const requiredDirective = [
   "$parse",
+  /**
+   * @param {import("../../core/parser/parse.js").ParseService} $parse
+   * @returns {import("../../types.js").Directive}
+   */
   ($parse) => ({
     restrict: "A",
     require: "?ngModel",
-    link(scope, elm, attr, ctrl) {
-      if (!ctrl) return;
-      // For boolean attributes like required, presence means true
-      let value =
-        Object.prototype.hasOwnProperty.call(attr, "required") ||
-        $parse(attr.ngRequired)(scope);
+    link:
+      /**
+       * @param {import("../../core/scope/scope.js").Scope} scope
+       * @param {*} _elm
+       * @param {import("../../types.js").Attributes} attr
+       * @param {import("../../types.js").NgModelController} ctrl
+       * @returns
+       */
+      (scope, _elm, attr, ctrl) => {
+        if (!ctrl) return;
+        // For boolean attributes like required, presence means true
+        let value =
+          Object.prototype.hasOwnProperty.call(attr, "required") ||
+          $parse(attr.ngRequired)(scope);
 
-      if (!attr.ngRequired) {
-        // force truthy in case we are on non input element
-        // (input elements do this automatically for boolean attributes like required)
-        attr.required = true;
-      }
+        if (!attr.ngRequired) {
+          // force truthy in case we are on non input element
+          // (input elements do this automatically for boolean attributes like required)
+          attr.required = true;
+        }
 
-      ctrl.$validators.required = function (modelValue, viewValue) {
-        return !value || !ctrl.$isEmpty(viewValue);
-      };
+        ctrl.$validators.required = (_modelValue, viewValue) => {
+          return !value || !ctrl.$isEmpty(viewValue);
+        };
 
-      attr.$observe("required", (newVal) => {
-        if (value !== newVal) {
-          value = newVal;
-          ctrl.$validate();
-        }
-      });
-    },
+        attr.$observe("required", (newVal) => {
+          if (value !== newVal) {
+            value = newVal;
+            ctrl.$validate();
+          }
+        });
+      },
   }),
 ];
 
@@ -104,11 +116,15 @@ export const requiredDirective = [
  */
 export const patternDirective = [
   "$parse",
-  function ($parse) {
+  /**
+   * @param {import("../../core/parser/parse.js").ParseService} $parse
+   * @returns {import("../../types.js").Directive}
+   */
+  ($parse) => {
     return {
       restrict: "A",
       require: "?ngModel",
-      compile: function (tElm, tAttr) {
+      compile: (_Elm, tAttr) => {
         var patternExp;
         var parseFn;
 
@@ -201,30 +217,42 @@ export const patternDirective = [
  */
 export const maxlengthDirective = [
   "$parse",
+  /**
+   * @param {import("../../core/parser/parse.js").ParseService} $parse
+   * @returns {import("../../types.js").Directive}
+   */
   ($parse) => ({
     restrict: "A",
     require: "?ngModel",
-    link(scope, elm, attr, ctrl) {
-      if (!ctrl) return;
+    link:
+      /**
+       * @param {import("../../core/scope/scope.js").Scope} scope
+       * @param {*} _elm
+       * @param {import("../../types.js").Attributes} attr
+       * @param {import("../../types.js").NgModelController} ctrl
+       * @returns
+       */
+      (scope, _elm, attr, ctrl) => {
+        if (!ctrl) return;
 
-      let maxlength = attr.maxlength || $parse(attr.ngMaxlength)(scope);
-      let maxlengthParsed = parseLength(maxlength);
+        let maxlength = attr.maxlength || $parse(attr.ngMaxlength)(scope);
+        let maxlengthParsed = parseLength(maxlength);
 
-      attr.$observe("maxlength", (value) => {
-        if (maxlength !== value) {
-          maxlengthParsed = parseLength(value);
-          maxlength = value;
-          ctrl.$validate();
-        }
-      });
-      ctrl.$validators.maxlength = function (modelValue, viewValue) {
-        return (
-          maxlengthParsed < 0 ||
-          ctrl.$isEmpty(viewValue) ||
-          viewValue.length <= maxlengthParsed
-        );
-      };
-    },
+        attr.$observe("maxlength", (value) => {
+          if (maxlength !== value) {
+            maxlengthParsed = parseLength(value);
+            maxlength = value;
+            ctrl.$validate();
+          }
+        });
+        ctrl.$validators.maxlength = function (modelValue, viewValue) {
+          return (
+            maxlengthParsed < 0 ||
+            ctrl.$isEmpty(viewValue) ||
+            viewValue.length <= maxlengthParsed
+          );
+        };
+      },
   }),
 ];