@angular-wave/angular.ts 0.9.4 → 0.9.5

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

@@ -1,100 +0,0 @@
----
-title: $templateCacheProvider
-description: >
-  Cache provider for `$templateCache` service.
----
-
-### Description
-
-Initializes cache instance for `$templateCache` service as an empty
-[Map](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map)
-object.
-
-An alternative caching implementation can be provided by implementing
-[TemplateCache](../../../typedoc/types/TemplateCache.html) interface for web
-standard storage options like `localStorage`, `sessionStorage`, `IndexedDB`, or
-`Cache API`. You can also use third-party storage engines like
-[pouch](https://github.com/pouchdb/pouchdb) or
-[SQLite](https://sqlite.org/wasm/doc/trunk/index.md). With WebAssembly (WASM),
-even more powerful and flexible storage backends become possible.
-
-Below is an example implementation using `localStorage`:
-
-```js
-class LocalStorageMap {
-  constructor(prefix = '') {
-    this.prefix = prefix;
-  }
-
-  _key(key) {
-    return `${this.prefix}${key}`;
-  }
-
-  get(key) {
-    const raw = localStorage.getItem(this._key(key));
-    if (raw === null) return undefined;
-    try {
-      return JSON.parse(raw);
-    } catch {
-      return raw;
-    }
-  }
-
-  set(key, value) {
-    localStorage.setItem(this._key(key), value);
-    return this;
-  }
-
-  has(key) {
-    return localStorage.getItem(this._key(key)) !== null;
-  }
-
-  delete(key) {
-    localStorage.removeItem(this._key(key));
-    return true;
-  }
-
-  clear() {
-    const toRemove = [];
-    for (let i = 0; i < localStorage.length; i++) {
-      const k = localStorage.key(i);
-      if (k && k.startsWith(this.prefix)) {
-        toRemove.push(k);
-      }
-    }
-    toRemove.forEach((k) => localStorage.removeItem(k));
-  }
-}
-```
-
-Override during configuration phase:
-
-```js
-angular.module('demo', []).config(($templateCacheProvider) => {
-  templateCacheProvider.cache = new LocalStorageMap();
-});
-```
-
-### 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/provider/templateRequestProvider.md

@@ -1,5 +0,0 @@
----
-title: $templateRequestProvider
-description: >
-  Template request service
----

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

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

package/docs/content/docs/service/compile.md

@@ -1,5 +0,0 @@
----
-title: $compile
-description: >
-  Template compilation service
----

package/docs/content/docs/service/controller.md

@@ -1,5 +0,0 @@
----
-title: $controller
-description: >
-  Controller service
----

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

@@ -1,56 +0,0 @@
----
-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/http.md

@@ -1,161 +0,0 @@
----
-title: $http
-description: >
-  HTTP service
----
-
-# `$http` Service (AngularTS)
-
-The `$http` service is a core AngularTS service that facilitates communication
-with remote HTTP servers via the browser's
-[XMLHttpRequest](https://developer.mozilla.org/en/xmlhttprequest) object or via
-[JSONP](http://en.wikipedia.org/wiki/JSONP).
-
-For unit testing applications that use the `$http` service, see
-[`$httpBackend` mock](https://docs.angularjs.org/api/ngMock/service/$httpBackend).
-
-For a higher-level abstraction, see the
-[`$resource`](https://docs.angularjs.org/api/ngResource/service/$resource)
-service.
-
-The `$http` API is based on the
-[`$q` deferred/promise APIs](https://docs.angularjs.org/api/ng/service/$q).
-Familiarity with these APIs is important for advanced usage.
-
----
-
-## General Usage
-
-The `$http` service is a function that takes a single argument — a
-**configuration object** — used to generate an HTTP request. It returns a
-**promise** that resolves on success or rejects on failure with a **response
-object**.
-
-```js
-$http({
-  method: 'GET',
-  url: '/someUrl'
-}).then(function successCallback(response) {
-  // Called asynchronously when the response is available
-}, function errorCallback(response) {
-  // Called asynchronously if an error occurs or the server returns an error
-});
-
-Shortcut Methods
-
-Shortcut methods are available for all common HTTP methods. All require a URL; POST/PUT requests require data. An optional config object can be passed as the last argument.
-
-$http.get('/someUrl', config).then(successCallback, errorCallback);
-$http.post('/someUrl', data, config).then(successCallback, errorCallback);
-
-
-Shortcut methods list:
-
-$http.get
-$http.head
-$http.post
-$http.put
-$http.delete
-$http.patch
-
-$http.get(...);
-
-Setting HTTP Headers
-
-The $http service automatically adds certain HTTP headers to all requests. These defaults can be configured using $httpProvider.defaults.headers.
-
-Default headers:
-
-Common headers: Accept: application/json, text/plain, */*
-
-POST headers: Content-Type: application/json
-
-PUT headers: Content-Type: application/json
-
-You can modify defaults:
-
-$httpProvider.defaults.headers.get = { 'My-Header': 'value' };
-
-
-Or modify headers globally at runtime:
-
-module.run(function($http) {
-  $http.defaults.headers.common.Authorization = 'Basic YmVlcDpib29w';
-});
-
-
-Per-request overrides:
-
-let req = {
-  method: 'POST',
-  url: 'http://example.com',
-  headers: {
-    'Content-Type': undefined
-  },
-  data: { test: 'test' }
-};
-
-$http(req).then(success, error);
-
-Transforming Requests and Responses
-
-Requests and responses can be transformed using transformRequest and transformResponse. Each can be a single function or an array of functions. Functions take (data, headersGetter[, status]) and return the transformed value.
-
-Note: AngularTS does not make a copy of data before passing it to transformRequest. Avoid side effects.
-
-Default transformations:
-
-Requests: objects are serialized to JSON
-
-Responses: XSRF prefix removed; JSON responses are parsed
-
-Per-request override example:
-
-function appendTransform(defaults, transform) {
-  defaults = angular.isArray(defaults) ? defaults : [defaults];
-  return defaults.concat(transform);
-}
-
-$http({
-  url: '...',
-  method: 'GET',
-  transformResponse: appendTransform($http.defaults.transformResponse, function(value) {
-    return doTransform(value);
-  })
-});
-
-Caching
-
-By default, $http responses are not cached. Enable caching with:
-
-config.cache = true or a cache object
-
-Global default cache: $http.defaults.cache = true
-
-Only GET and JSONP requests are cached.
-
-Interceptors
-
-Interceptors allow modification of requests/responses globally. Add factories to $httpProvider.interceptors.
-
-Interceptor types:
-
-request(config)
-
-requestError(rejection)
-
-response(response)
-
-responseError(rejection)
-
-Example:
-
-$provide.factory('myHttpInterceptor', function($q) {
-  return {
-    request: function(config) { return config; },
-    responseError: function(rejection) { return $q.reject(rejection); }
-  };
-});
-
-$httpProvider.interceptors.push('myHttpInterceptor');
-```

package/docs/content/docs/service/interpolation.md

@@ -1,5 +0,0 @@
----
-title: $interpolate
-description: >
-  HTTP service
----

package/docs/content/docs/service/location.md

@@ -1,57 +0,0 @@
----
-title: $location
-description: >
-  URL normalization for HTML5/hashbang modes
----
-
-### Description
-
-The `$location` service parses the URL in the browser address bar (based on the
-[window.location](https://developer.mozilla.org/en/window.location)) and makes
-the URL available to your application in a uniform manner. Changes to the URL in
-the address bar are reflected into `$location` service and changes to
-`$location` are reflected into the browser address bar. Using `$location` you
-can:
-
-- Watch and observe the URL
-- Change the URL
-- Detect users changes to address bar by clicking on links or using back or
-  forward buttons in browser
-
-To configure the HTML5 mode and link behavior for the service, use the
-`$locationProvider`.
-
-### Events
-
----
-
-#### $location#$locationChangeStart
-
-- **Description:** Broadcast on root scope before a URL will change. This change
-  can be prevented by calling `preventDefault` method of the event. See
-  [Scope#$ons](TODO) for more details about event object. Upon successful change
-  `$location#$locationChangeSuccess` is fired.
-
-The `newState` and `oldState` parameters may be defined only in HTML5 mode and
-when the browser supports the HTML5 History API.
-
-- **Parameters:** | `angularEvent` | `Object` | No | Synthetic event object. | |
-  `newUrl` | `string` | No | The new URL being navigated to. | | `oldUrl` |
-  `string` | Yes | The URL prior to the change. | | `newState` | `string` | Yes
-  | New history state object (HTML5 mode only). | | `oldState` | `string` | Yes
-  | Previ
-
-## `$location#$locationChangeSuccess`
-
-**Description:**  
- Broadcasted on the root scope **after** a URL was changed. The `newState` and
-`oldState` parameters may be defined only in HTML5 mode and when the browser
-supports the HTML5 History API.
-
-### Parameters
-
-| `angularEvent` | `Object` | No | Synthetic event object. | | `newUrl` |
-`string` | No | The new URL after change. | | `oldUrl` | `string` | Yes | The
-previous URL before the change. | | `newState` | `string` | Yes | New history
-state object (HTML5 mode only). | | `oldState` | `string` | Yes | Previous
-history state object (HTML5 mode only). |

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

@@ -1,113 +0,0 @@
----
-title: $log
-description: >
-  Logging service
----
-
-### 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/parse.md

@@ -1,5 +0,0 @@
----
-title: $parse
-description: >
-  URL normalization for HTML5/hashbang modes
----

package/docs/content/docs/service/rootElement.md

@@ -1,5 +0,0 @@
----
-title: $rootElement
-description: >
-  URL normalization for HTML5/hashbang modes
----

package/docs/content/docs/service/rootScope.md

@@ -1,5 +0,0 @@
----
-title: $rootScope
-description: >
-  Root scope service
----