@angular-wave/angular.ts 0.7.3 → 0.7.5

package/docs/content/docs/directive/mousedown.md

@@ -0,0 +1,38 @@
+---
+title: ng-mousedown
+description: >
+  Handler for mousedown event
+---
+
+### Description
+
+The `ng-mousedown` directive allows you to specify custom behavior when a mouse
+is pressed over an element.
+
+### Directive parameters
+
+---
+
+#### `ng-mousedown`
+
+- **Type:** [Expression](../../../typedoc/types/Expression.html)
+- **Description:** Expression to evaluate upon
+  [mousedown](https://developer.mozilla.org/en-US/docs/Web/API/Element/mousedown_event)
+  event.
+  [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent)
+  object is available as `$event`.
+- **Example:**
+
+  ```html
+  <div ng-mousedown="$ctrl.greet($event)"></div>
+  ```
+
+---
+
+#### Demo
+
+{{< showhtml src="examples/ng-mousedown/ng-mousedown.html" >}}
+
+{{< showraw src="examples/ng-mousedown/ng-mousedown.html" >}}
+
+---

package/docs/content/docs/directive/mouseenter.md

@@ -0,0 +1,38 @@
+---
+title: ng-mouseenter
+description: >
+  Handler for mouseenter event
+---
+
+### Description
+
+The `ng-mouseenter` directive allows you to specify custom behavior when a mouse
+enters an element.
+
+### Directive parameters
+
+---
+
+#### `ng-mouseenter`
+
+- **Type:** [Expression](../../../typedoc/types/Expression.html)
+- **Description:** Expression to evaluate upon
+  [mouseenter](https://developer.mozilla.org/en-US/docs/Web/API/Element/mouseenter_event)
+  event.
+  [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent)
+  object is available as `$event`.
+- **Example:**
+
+  ```html
+  <div ng-mouseenter="$ctrl.greet($event)"></div>
+  ```
+
+---
+
+#### Demo
+
+{{< showhtml src="examples/ng-mouseenter/ng-mouseenter.html" >}}
+
+{{< showraw src="examples/ng-mouseenter/ng-mouseenter.html" >}}
+
+---

package/docs/content/docs/directive/mouseleave.md

@@ -0,0 +1,38 @@
+---
+title: ng-mouseleave
+description: >
+  Handler for mouseleave event
+---
+
+### Description
+
+The `ng-mouseleave` directive allows you to specify custom behavior when an
+element a mouse leaves entire element.
+
+### Directive parameters
+
+---
+
+#### `ng-mouseleave`
+
+- **Type:** [Expression](../../../typedoc/types/Expression.html)
+- **Description:** Expression to evaluate upon
+  [mouseleave](https://developer.mozilla.org/en-US/docs/Web/API/Element/mouseleave_event)
+  event.
+  [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent)
+  object is available as `$event`.
+- **Example:**
+
+  ```html
+  <div ng-mouseleave="$ctrl.greet($event)"></div>
+  ```
+
+---
+
+#### Demo
+
+{{< showhtml src="examples/ng-mouseleave/ng-mouseleave.html" >}}
+
+{{< showraw src="examples/ng-mouseleave/ng-mouseleave.html" >}}
+
+---

package/docs/content/docs/directive/mousemove.md

@@ -0,0 +1,38 @@
+---
+title: ng-mousemove
+description: >
+  Handler for mousemove event
+---
+
+### Description
+
+The `ng-mousemove` directive allows you to specify custom custom behavior when a
+mouse is moved over an element.
+
+### Directive parameters
+
+---
+
+#### `ng-mousemove`
+
+- **Type:** [Expression](../../../typedoc/types/Expression.html)
+- **Description:** Expression to evaluate upon
+  [mousemove](https://developer.mozilla.org/en-US/docs/Web/API/Element/mousemove_event)
+  event.
+  [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent)
+  object is available as `$event`.
+- **Example:**
+
+  ```html
+  <div ng-mousemove="$ctrl.greet($event)"></div>
+  ```
+
+---
+
+#### Demo
+
+{{< showhtml src="examples/ng-mousemove/ng-mousemove.html" >}}
+
+{{< showraw src="examples/ng-mousemove/ng-mousemove.html" >}}
+
+---

package/docs/content/docs/directive/mouseout.md

@@ -0,0 +1,38 @@
+---
+title: ng-mouseout
+description: >
+  Handler for mouseout event
+---
+
+### Description
+
+The `ng-mouseout` directive allows you to specify custom behavior when a mouse
+leaves any part of the element or its children.
+
+### Directive parameters
+
+---
+
+#### `ng-mouseout`
+
+- **Type:** [Expression](../../../typedoc/types/Expression.html)
+- **Description:** Expression to evaluate upon
+  [mouseout](https://developer.mozilla.org/en-US/docs/Web/API/Element/mouseout_event)
+  event.
+  [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent)
+  object is available as `$event`.
+- **Example:**
+
+  ```html
+  <div ng-mouseout="$ctrl.greet($event)"></div>
+  ```
+
+---
+
+#### Demo
+
+{{< showhtml src="examples/ng-mouseout/ng-mouseout.html" >}}
+
+{{< showraw src="examples/ng-mouseout/ng-mouseout.html" >}}
+
+---

package/docs/content/docs/directive/mouseover.md

@@ -0,0 +1,38 @@
+---
+title: ng-mouseover
+description: >
+  Handler for mouseover event
+---
+
+### Description
+
+The `ng-mouseover` directive allows you to specify custom behavior when a mouse
+is placed over an element.
+
+### Directive parameters
+
+---
+
+#### `ng-mouseover`
+
+- **Type:** [Expression](../../../typedoc/types/Expression.html)
+- **Description:** Expression to evaluate upon
+  [mouseover](https://developer.mozilla.org/en-US/docs/Web/API/Element/mouseover_event)
+  event.
+  [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent)
+  object is available as `$event`.
+- **Example:**
+
+  ```html
+  <div ng-mouseover="$ctrl.greet($event)"></div>
+  ```
+
+---
+
+#### Demo
+
+{{< showhtml src="examples/ng-mouseover/ng-mouseover.html" >}}
+
+{{< showraw src="examples/ng-mouseover/ng-mouseover.html" >}}
+
+---

package/docs/content/docs/directive/mouseup.md

@@ -0,0 +1,38 @@
+---
+title: ng-mouseup
+description: >
+  Handler for mouseup event
+---
+
+### Description
+
+The `ng-mouseup` directive allows you to specify custom behavior when a pressed
+mouse is released over an element.
+
+### Directive parameters
+
+---
+
+#### `ng-mouseup`
+
+- **Type:** [Expression](../../../typedoc/types/Expression.html)
+- **Description:** Expression to evaluate upon
+  [mouseup](https://developer.mozilla.org/en-US/docs/Web/API/Element/mouseup_event)
+  event.
+  [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent)
+  object is available as `$event`.
+- **Example:**
+
+  ```html
+  <div ng-mouseup="$ctrl.greet($event)"></div>
+  ```
+
+---
+
+#### Demo
+
+{{< showhtml src="examples/ng-mouseup/ng-mouseup.html" >}}
+
+{{< showraw src="examples/ng-mouseup/ng-mouseup.html" >}}
+
+---

package/docs/content/docs/filter/_index.md

@@ -0,0 +1,4 @@
+---
+title: Filters
+weight: 60
+---

package/docs/content/docs/provider/_index.md

@@ -0,0 +1,4 @@
+---
+title: Providers
+weight: 30
+---

package/docs/content/docs/provider/eventBusProvider.md

@@ -0,0 +1,35 @@
+---
+title: $eventBusProvider
+description: >
+  Configuration provider for `$eventBus` service.
+---
+
+### Description
+
+Instance of [PubSubProvider](../../../typedoc/classes/PubSubProvider.html) for
+configuring the `$eventBus` service. The default implementation returns the
+global `angular.EventBus` instance, which is an async instance of
+[PubSub](../../../typedoc/classes/PubSub.html) class.
+
+### Properties
+
+---
+
+#### $eventBusProvider.eventBus
+
+Customize event bus instance.
+
+- **Type:** [PubSub](../../../typedoc/classes/PubSub.html)
+- **Default:** `angular.EventBus`
+
+- **Example:**
+
+  ```js
+  angular.module('demo', []).config(($eventBusProvider) => {
+    eventBusProvider.eventBus = new MyCustomPubsub();
+  });
+  ```
+
+---
+
+For service description, see [$eventBus](../../../docs/service/eventbus).

package/docs/content/docs/provider/logProvider.md

@@ -0,0 +1,59 @@
+---
+title: $logProvider
+description: >
+  Configuration provider for `$log` service.
+---
+
+### Description
+
+Instance of [LogProvider](../../../typedoc/classes/LogProvider.html) for
+configuring how the application logs messages.
+
+### Properties
+
+---
+
+#### $logProvider.debug
+
+Enable or disable debug-level logging. Also see
+[debug property](../../../typedoc/classes/LogProvider.html#debug).
+
+- **Type:** boolean
+- **Default:** `false`
+- **Example:**
+
+  ```js
+  angular.module('demo', []).config(($logProvider) => {
+    $logProvider.debug = true;
+  });
+  ```
+
+### Methods
+
+---
+
+#### $logProvider.setLogger()
+
+Override the default logger with a custom implementation of the
+[LogService](../../../typedoc/interfaces/LogService.html) interface.
+
+- **Parameter:**
+  [LogServiceFactory](../../../typedoc/types/LogServiceFactory.html)
+
+- **Example:**
+
+  ```js
+  angular.module('demo', []).config(($logProvider) => {
+    $logProvider.setLogger(() => ({
+      log: () => {},
+      info: () => {},
+      warn: () => {},
+      error: () => {},
+      debug: () => {},
+    }));
+  });
+  ```
+
+---
+
+For service description, see [$log](../../../docs/service/log).

package/docs/content/docs/provider/templateCacheProvider.md

@@ -0,0 +1,35 @@
+---
+title: $templateCacheProvider
+description: >
+  Cache provider for `$templateCache` service.
+---
+
+### Description
+
+Initializes cache instancce for `$templateCache` service as an empty
+[Map](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map)
+object.
+
+### Properties
+
+---
+
+#### $templateCacheProvider.cache
+
+Customize cache instance.
+
+- **Type:** [TemplateCache](../../../typedoc/types/TemplateCache.html)
+- **Default:** `Map`
+
+- **Example:**
+
+  ```js
+  angular.module('demo', []).config(($templateCacheProvider) => {
+    templateCacheProvider.cache.set('test.html', 'hello');
+  });
+  ```
+
+---
+
+For service description, see
+[$templateCache](../../../docs/service/templatecache).

package/docs/content/docs/service/_index.md

@@ -0,0 +1,4 @@
+---
+title: Services
+weight: 40
+---

package/docs/content/docs/service/eventBus.md

@@ -0,0 +1,56 @@
+---
+title: $eventBus
+description: >
+  Pubsub messaging service
+---
+
+### Description
+
+A messaging service, backed by an instance of
+[PubSub](../../../typedoc/classes/PubSub.html). This implementation is based on
+the original
+[Google Closure PubSub](https://google.github.io/closure-library/api/goog.pubsub.PubSub.html)
+but uses
+[`Promise.resolve()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/resolve)
+instead of
+[`Window.setTimeout()`](https://developer.mozilla.org/en-US/docs/Web/API/Window/setTimeout)
+for its async implementation. `$eventBus` allows communication between an
+Angular application instance and the outside context, which can be a different
+module, a non-Angular application, a third-party party library, or even a WASM
+application. Additionally, `$eventBus` can be used to communicate directly with
+a template, using [`ng-channel`](../../../docs/directive/channel) directive.
+
+`$eventBus` should not be used for communicating between Angular's own
+primitives.
+
+- **For sharing application state**: use custom Services and Factories that
+  encapsulate your business logic and manage your model.
+- **For intercomponent communication**: use `$scope.$on()`, `$scope.$emit()`,
+  and `$scope.$broadcast()` methods.
+
+The example below demonstrates communication between the global `window` context
+and a controller. **Note**: Ensure topic clean-up after the `$scope` is
+destroyed
+
+#### Example
+
+{{< showhtml src="examples/eventbus/eventbus.html" >}}
+
+{{< showjs src="examples/eventbus/eventbus.js" >}}
+
+---
+
+#### Demo
+
+{{< showraw src="examples/eventbus/eventbus.html" >}}
+
+<script>
+{{< showraw src="examples/eventbus/eventbus.js" >}}
+</script>
+
+---
+
+For detailed method description, see
+[PubSub](../../../typedoc/classes/PubSub.html)
+
+---

package/docs/content/docs/service/log.md

@@ -0,0 +1,113 @@
+---
+title: $log
+description: >
+  A simple service for logging
+---
+
+### Using `$log`
+
+Default implementation of
+[LogService](../../../typedoc/interfaces/LogService.html) safely writes the
+message into the browser's
+[console](https://developer.mozilla.org/en-US/docs/Web/API/console) (if
+present). The main purpose of this service is to simplify debugging and
+troubleshooting, while allowing the developer to modify the defaults for live
+environments.
+
+##### **Example\***
+
+```js
+angular.module('demo').controller('MyController', ($log) => {
+  $log.log('log');
+  $log.info('info');
+  $log.warn('warn!');
+  $log.error('error');
+  $log.debug('debug');
+});
+```
+
+To reveal the location of the calls to `$log` in the JavaScript console, you can
+"blackbox" the AngularTS source in your browser:
+
+- [Mozilla description of blackboxing](https://developer.mozilla.org/en-US/docs/Tools/Debugger/How_to/Black_box_a_source).
+- [Chrome description of blackboxing](https://developer.chrome.com/devtools/docs/blackboxing).
+
+> Note: Not all browsers support blackboxing.  
+> The default is to log `debug` messages. You can use
+> [`$logProvider.debug`](../../../docs/provider/logprovider/#logprovidersetlogger)
+> to change this.
+
+For configuration and custom implementations, see
+[$logProvider](../../../docs/provider/logprovider).
+
+### Decorating `$log`
+
+You can also optionally override any of the `$log` service methods with
+`$provide` decorator. Below is a simple example that overrides default
+`$log.error` to log errors to both console and a backend endpoint.
+
+##### **Example\***
+
+```js
+angular.module('demo').config(($provide) => {
+  $provide.decorator('$log', ($delegate, $http, $exceptionHandler) => {
+    const originalError = $delegate.error;
+    $delegate.error = () => {
+      originalError.apply($delegate, arguments);
+      const errorMessage = Array.prototype.slice.call(arguments).join(' ');
+      $http.post('/api/log/error', { message: errorMessage });
+    };
+    return $delegate;
+  });
+});
+```
+
+### Overriding `console`
+
+If your application is already heavily reliant on default
+[console](https://developer.mozilla.org/en-US/docs/Web/API/console) logging or
+you are using a third-party library where logging cannot be overriden, you can
+still take advantage of Angular's services by modifying the globals at runtime.
+Below is an example that overrides default `console.error` to logs errors to
+both console and a backend endpoint.
+
+##### **Example\***
+
+```js
+angular.module('demo').run(($http) => {
+  /**
+   * Decorate console.error to log error messages to the server.
+   */
+  const $delegate = window.console.error;
+  window.console.error = (...args) => {
+    try {
+      const errorMessage = args
+        .map((arg) => (arg instanceof Error ? arg.stack : JSON.stringify(arg)))
+        .join(' ');
+      $delegate.apply(console, args);
+      $http.post('/api/log/error', { message: errorMessage });
+    } catch (e) {
+      console.warn(e);
+    }
+  };
+
+  /**
+   * Detect errors thrown outside Angular and report them to the server.
+   */
+  window.addEventListener('error', (e) => {
+    window.console.error(e.error || e.message, e);
+  });
+
+  /**
+   * Optionally: Capture unhandled promise rejections
+   */
+  window.addEventListener('unhandledrejection', (e) => {
+    window.console.error(e.reason || e);
+  });
+});
+```
+
+Combining both `$log` decoration and `console.log` overriding provides a robust
+and flexible error reporting strategy that can adapt to your use-case.
+
+\* array notation and HTTP error handling omitted for brevity

package/docs/content/docs/service/templateCache.md

@@ -0,0 +1,64 @@
+---
+title: $templateCache
+description: >
+  Map object for storing templates
+---
+
+`$templateCache` is a
+[Map](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map)
+object created by `$templateCacheProvider`.
+
+The first time a template is used, it is loaded in the template cache for quick
+retrieval. You can load templates directly into the cache in a script tag, by
+using $templateRequest, or by consuming the $templateCache service directly.
+
+Adding via the script tag:
+
+#### Example
+
+```html
+<script type="text/ng-template" id="templateId.html">
+  <p>This is the content of the template</p>
+</script>
+```
+
+Note: the script tag containing the template does not need to be included in the
+head of the document, but it must be a descendent of the $rootElement (e.g.
+element with `ng-app` attribute), otherwise the template will be ignored.
+
+Adding via the `$templateCache` service:
+
+#### Example
+
+```js
+const myApp = angular.module('myApp', []).run(($templateCache) => {
+  $templateCache.set('templateId.html', 'This is the content of the template');
+});
+```
+
+To retrieve the template, simply use it in your component:
+
+```js
+myApp.component('myComponent', {
+  templateUrl: 'templateId.html',
+});
+```
+
+or include it with `ng-include`:
+
+```html
+<div ng-include="'templateId.html`"></div>
+```
+
+or get it via the `$templateCache` service:
+
+```js
+myApp.controller(
+  'Test',
+  class {
+    constructor($templateCache) {
+      const tmp = $templateCache.get('templateId.html');
+    }
+  },
+);
+```

package/docs/hugo.yaml

@@ -33,7 +33,7 @@ permalinks:
 imaging:
   resampleFilter: CatmullRom
   quality: 75
-  anchor: smart
+  anchor: Smart
 
 markup:
   goldmark:
@@ -115,7 +115,7 @@ params:
   #   from_year: 2018
 
   customCSS:
-    - "css/index.css"
+    - 'css/index.css'
 
   # User interface configuration
   ui:
@@ -197,4 +197,4 @@ menu:
   main:
     - name: 'API'
       url: '/typedoc/index.html'
-      weight: 10
+      weight: 50

package/docs/layouts/404.html

@@ -6,7 +6,7 @@
     <a href='{{ "" | relURL }}'>home page</a>.
   </p>
   <p>
-    You can learn how to make a 404 page like this in
+    You can learn how to make a 404-page like this in
     <a href="https://gohugo.io/templates/404/">Custom 404 Pages</a>.
   </p>
 </div>

package/docs/layouts/partials/hooks/head-end.html

@@ -0,0 +1,3 @@
+<script src="
+    https://cdn.jsdelivr.net/npm/@angular-wave/angular.ts/dist/angular-ts.umd.min.js
+"></script>