@angular-wave/angular.ts 0.7.2 → 0.7.4

package/.github/workflows/ci.yml

@@ -101,4 +101,4 @@ jobs:
         with:
           name: playwright-report
           path: playwright-report/
-          retention-days: 30
+          retention-days: 3

package/.prettierignore

@@ -4,4 +4,6 @@
 dist
 node_modules
 playwright-report
-docs
+docs/public
+docs/resources
+typedoc

package/@types/core/di/internal-injector.d.ts

@@ -1,6 +1,5 @@
 /**
  * Injector for providers
- * @extends {AbstractInjector}
  */
 export class ProviderInjector extends AbstractInjector {
   /**
@@ -17,15 +16,13 @@ export class ProviderInjector extends AbstractInjector {
 }
 /**
  * Injector for factories and services
- * @extends {AbstractInjector}
  */
 export class InjectorService extends AbstractInjector {
   /**
-   *
-   * @param {boolean} strictDi - Indicates if strict dependency injection is enforced.
    * @param {ProviderInjector} providerInjector
+   * @param {boolean} strictDi - Indicates if strict dependency injection is enforced.
    */
-  constructor(strictDi: boolean, providerInjector: ProviderInjector);
+  constructor(providerInjector: ProviderInjector, strictDi: boolean);
   providerInjector: ProviderInjector;
   /**
    *

package/@types/core/di/ng-module.d.ts

@@ -39,13 +39,6 @@ export class NgModule {
   configBlocks: Array<Array<any>>;
   /** @type {!Array.<Function>} */
   runBlocks: Array<Function>;
-  /** @type {Object} */
-  infoState: any;
-  /**
-   * @param {Object} value
-   * @returns
-   */
-  info(value: any): any;
   /**
    * @param {string} name
    * @param {any} object

package/@types/core/exception-handler.d.ts

@@ -41,7 +41,7 @@
  *
  * @see {@link angular.ErrorHandler AngularTS ErrorHandler}
  */
-/** @typedef {import('../services/log').LogService} LogService */
+/** @typedef {import('../services/log/interface.ts').LogService} LogService */
 /** @typedef {import("./error-handler.ts").ErrorHandler}  ErrorHandler */
 /**
  * Provider for `$exceptionHandler` service. Delegates uncaught exceptions to `$log.error()` by default.
@@ -54,5 +54,5 @@ export class ExceptionHandlerProvider {
   errorHandler: ErrorHandler;
   $get: (string | (($log: LogService) => ErrorHandler))[];
 }
-export type LogService = any;
+export type LogService = import("../services/log/interface.ts").LogService;
 export type ErrorHandler = import("./error-handler.ts").ErrorHandler;

package/@types/core/task-tracker-factory.d.ts

@@ -15,9 +15,9 @@ export class TaskTrackerFactoryProvider implements ServiceProvider {
  */
 export class TaskTracker {
   /**
-   * @param {import('../services/log.js').LogService} log - The logging service.
+   * @param {import('../services/log/interface.ts').LogService} log - The logging service.
    */
-  constructor(log: import("../services/log.js").LogService);
+  constructor(log: import("../services/log/interface.ts").LogService);
   /** @private */
   private log;
   /** @private */

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

@@ -1,20 +1,10 @@
 /**
- * Dynamically updates an element's content based on events published on a specified channel.
- * If data is sent via `EventBus` on the specified `ngChannel`, the directive attempts to update the element's content accordingly,
- * either by directly setting the inner HTML or merging the scope's data if the element contains a template.
- *
- * If the element has a template and incoming data is an object, the directive will merge all key/value pairs onto the scope,
- * allowing Angular expressions (`{{ yourModel }}`) to be evaluated and rendered.
- *
- * When the scope is destroyed, the directive automatically unsubscribes from the channel.
- * Example:
- *
- * HTML:
- * <div ng-channel="userChannel">Hello {{ user.firstName }} {{ user.lastName }}</div>
- *
- * JavaScript:
- * angular.EventBus.publish('userChannel', { user: { firstName: 'John', lastName: 'Smith' } });
- *
+ * @param {import("../../services/pubsub/pubsub.js").PubSub} $eventBus
  * @returns {import("../../interface.ts").Directive}
  */
-export function ngChannelDirective(): import("../../interface.ts").Directive;
+export function ngChannelDirective(
+  $eventBus: import("../../services/pubsub/pubsub.js").PubSub,
+): import("../../interface.ts").Directive;
+export namespace ngChannelDirective {
+  let $inject: string[];
+}

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

@@ -0,0 +1,42 @@
+/**
+ * @typedef {"click" | "change" | "submit"} EventType
+ */
+/**
+ * Selects DOM event to listen for based on the element type.
+ *
+ * @param {Element} element - The DOM element to inspect.
+ * @returns {EventType} The name of the event to listen for.
+ */
+export function getEventNameForElement(element: Element): EventType;
+/**
+ * Handles DOM manipulation based on a swap strategy and server-rendered HTML.
+ *
+ * @param {string} html - The HTML string returned from the server.
+ * @param {import("../../interface.ts").SwapInsertPosition} swap
+ * @param {Element} target - The target DOM element to apply the swap to.
+ * @param {import('../../core/scope/scope.js').Scope} scope
+ * @param {import('../../core/compile/compile.js').CompileFn} $compile
+ */
+export function handleSwapResponse(
+  html: string,
+  swap: import("../../interface.ts").SwapInsertPosition,
+  target: Element,
+  scope: import("../../core/scope/scope.js").Scope,
+  $compile: import("../../core/compile/compile.js").CompileFn,
+): void;
+/**
+ * Creates an HTTP directive factory that supports GET, DELETE, POST, PUT.
+ *
+ * @param {"get" | "delete" | "post" | "put"} method - HTTP method to use.
+ * @param {string} attrName - Attribute name containing the URL.
+ * @returns {import('../../interface.ts').DirectiveFactory}
+ */
+export function createHttpDirective(
+  method: "get" | "delete" | "post" | "put",
+  attrName: string,
+): import("../../interface.ts").DirectiveFactory;
+export const ngGetDirective: import("../../interface.ts").DirectiveFactory;
+export const ngDeleteDirective: import("../../interface.ts").DirectiveFactory;
+export const ngPostDirective: import("../../interface.ts").DirectiveFactory;
+export const ngPutDirective: import("../../interface.ts").DirectiveFactory;
+export type EventType = "click" | "change" | "submit";

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

@@ -1,6 +1,4 @@
 /**
- *
- * TODO // Add type for animate service
  * @param {*}  $animate
  * @returns {import("../../interface.ts").Directive}
  */

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

@@ -1,9 +1,9 @@
 /**
- * @param {import('../../core/cache/cache-factory').TemplateCache} $templateCache
+ * @param {import('../../services/template-cache/interface.ts').TemplateCache} $templateCache
  * @returns {import('../../interface.ts').Directive}
  */
 export function scriptDirective(
-  $templateCache: any,
+  $templateCache: import("../../services/template-cache/interface.ts").TemplateCache,
 ): import("../../interface.ts").Directive;
 export namespace scriptDirective {
   let $inject: string[];

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

@@ -1,11 +1,11 @@
 /**
  * @param {import('../../core/parse/interface.ts').ParseService} $parse
- * @param {import('../../services/log.js').LogService} $log
+ * @param {import('../../services/log/interface.ts').LogService} $log
  * @returns {import('../../interface.ts').Directive}
  */
 export function ngSetterDirective(
   $parse: import("../../core/parse/interface.ts").ParseService,
-  $log: import("../../services/log.js").LogService,
+  $log: import("../../services/log/interface.ts").LogService,
 ): import("../../interface.ts").Directive;
 export namespace ngSetterDirective {
   let $inject: string[];

package/@types/injection-tokens.d.ts

@@ -14,6 +14,9 @@ export function provider(services: string[]): string[];
  *   angular.$injectTokens.$animate,
  *   angular.$injectTokens.$templateRequest,
  * ];
+ *
+ * function myDirective($animate, $templateRequest) { ... }
+ *
  * ```
  * @type Readonly<Record<string, string>>
  */

package/@types/interface.d.ts

@@ -1,13 +1,26 @@
 import { Attributes } from "./core/compile/attributes.js";
 import { Scope } from "./core/scope/scope.js";
+export * from "./services/http/interface.ts";
+export * from "./services/log/interface.ts";
+export * from "./services/log/log.js";
+export * from "./services/pubsub/pubsub.js";
+export * from "./services/template-cache/interface.ts";
+export * from "./services/template-cache/template-cache.js";
 /**
- * A JavaScript expression represented as a string.
+ * A JavaScript expression represented as a string, typically used in interpolation bindings.
+ *
+ * Example:
+ * ```html
+ * <span title="{{ attrBinding }}">{{ textBinding }}</span>
+ * ```
  *
- * Often used in interpolation bindings such as:
- * `<span title="{{ attrBinding }}">{{ textBinding }}</span>`.
- * Evaluated in the context of a {@link import('./core/scope/scope.js').Scope `scope`} object.
  */
 export type Expression = string;
+export type ExpandoStore = {
+  data: {
+    [key: string]: any;
+  };
+};
 /**
  * A dependency-annotated factory array used by AngularTS DI system.
  *
@@ -300,3 +313,13 @@ export interface NgModelController {
   /** Current value shown in the view */
   $viewValue: any;
 }
+/**
+ * Possible values for `data-swap` attribute
+ */
+export type SwapInsertPosition =
+  | InsertPosition
+  | "textContent"
+  | "innerHTML"
+  | "outerHTML"
+  | "delete"
+  | "none";

package/@types/loader.d.ts

@@ -5,10 +5,9 @@
  * @property {boolean} [strictDi] - Disable automatic function annotation for the application. This is meant to assist in finding bugs which break minified code. Defaults to `false`.
  */
 export class Angular {
-  /** @type {Map<number, import("./core/cache/cache").ExpandoStore>} */
-  Cache: Map<number, any>;
-  /** @type {import('./core/pubsub/pubsub.js').PubSub} */
-  EventBus: import("./core/pubsub/pubsub.js").PubSub;
+  $cache: Map<number, import("./interface.ts").ExpandoStore>;
+  /** @type {import('./services/pubsub/pubsub.js').PubSub} */
+  $eventBus: import("./services/pubsub/pubsub.js").PubSub;
   /**
    * @type {string} `version` from `package.json`
    */

package/@types/public.d.ts

@@ -3,7 +3,6 @@
  * @param {import('./loader.js').Angular} angular
  * @returns {import('./core/di/ng-module.js').NgModule} `ng` module
  */
-export function publishExternalAPI(
+export function registerNgModule(
   angular: import("./loader.js").Angular,
 ): import("./core/di/ng-module.js").NgModule;
-export const VERSION: "[VI]{version}[/VI]";

package/@types/router/params/param-factory.d.ts

@@ -1,6 +1,14 @@
 export class ParamFactory {
-  constructor(urlServiceConfig: any);
-  urlServiceConfig: any;
+  /**
+   * @param {import("../url/url-config.js").UrlConfigProvider} urlServiceConfig
+   */
+  constructor(
+    urlServiceConfig: import("../url/url-config.js").UrlConfigProvider,
+  );
+  /**
+   * @type {import("../url/url-config.js").UrlConfigProvider}
+   */
+  urlServiceConfig: import("../url/url-config.js").UrlConfigProvider;
   fromConfig(id: any, type: any, state: any): Param;
   fromPath(id: any, type: any, state: any): Param;
   fromSearch(id: any, type: any, state: any): Param;

package/@types/router/params/param.d.ts

@@ -1,3 +1,9 @@
+export type DefType = number;
+export namespace DefType {
+  let PATH: number;
+  let SEARCH: number;
+  let CONFIG: number;
+}
 export class Param {
   static values(params: any, values?: {}): {};
   /**
@@ -24,10 +30,24 @@ export class Param {
   static equals(params: any, values1?: {}, values2?: {}): boolean;
   /** Returns true if a the parameter values are valid, according to the Param definitions */
   static validates(params: any, values?: {}): any;
-  constructor(id: any, type: any, location: any, urlConfig: any, state: any);
+  /**
+   *
+   * @param {*} id
+   * @param {*} type
+   * @param {DefType} location
+   * @param {import("../url/url-config.js").UrlConfigProvider} urlConfig
+   * @param {*} state
+   */
+  constructor(
+    id: any,
+    type: any,
+    location: DefType,
+    urlConfig: import("../url/url-config.js").UrlConfigProvider,
+    state: any,
+  );
   isOptional: boolean;
   type: any;
-  location: any;
+  location: number;
   id: any;
   dynamic: boolean;
   raw: boolean;
@@ -49,4 +69,3 @@ export class Param {
   validates(value: any): boolean;
   toString(): string;
 }
-export let DefType: any;

package/@types/router/template-factory.d.ts

@@ -13,14 +13,14 @@ export class TemplateFactoryProvider {
     | string
     | ((
         $http: any,
-        $templateCache: import("../core/cache/cache-factory.js").TemplateCache,
+        $templateCache: import("../services/template-cache/interface.ts").TemplateCache,
         $templateRequest: any,
         $injector: import("../core/di/internal-injector.js").InjectorService,
       ) => this)
   )[];
   $templateRequest: any;
   $http: any;
-  $templateCache: import("../core/cache/cache-factory.js").TemplateCache;
+  $templateCache: import("../interface.ts").TemplateCache;
   $injector: import("../core/di/internal-injector.js").InjectorService;
   /**
    * Forces the provider to use $http service directly

package/@types/router/url/url-service.d.ts

@@ -32,9 +32,9 @@ export class UrlService {
    * The nested [[UrlConfig]] API to configure the URL and retrieve URL information
    *
    * See: [[UrlConfig]] for details
-   * @type {import("./url-config").UrlConfigProvider}
+   * @type {import("./url-config.js").UrlConfigProvider}
    */
-  config: any;
+  config: import("./url-config.js").UrlConfigProvider;
   /** Creates a new [[Param]] for a given location (DefType) */
   paramFactory: ParamFactory;
   /**

package/@types/services/http/http.d.ts

@@ -57,8 +57,8 @@ export class HttpProvider {
     | ((
         $browser: any,
         $httpBackend: any,
-        $rootScope: any,
-        $injector: any,
+        $rootScope: import("../../core/scope/scope.js").Scope,
+        $injector: import("../../core/di/internal-injector.js").InjectorService,
         $sce: any,
       ) => {
         (requestConfig: any): Promise<any>;

package/@types/services/http/interface.d.ts

@@ -0,0 +1,219 @@
+export interface HttpHeadersGetter {
+  (): {
+    [name: string]: string;
+  };
+  (headerName: string): string;
+}
+export interface HttpRequestConfigHeaders {
+  [requestType: string]: any;
+  common?: any;
+  get?: any;
+  post?: any;
+  put?: any;
+  patch?: any;
+}
+export interface HttpRequestTransformer {
+  (data: any, headersGetter: HttpHeadersGetter): any;
+}
+export interface HttpResponseTransformer {
+  (data: any, headersGetter: HttpHeadersGetter, status: number): any;
+}
+/**
+ * Object that controls the defaults for $http provider. Not all fields of RequestShortcutConfig can be configured
+ * via defaults and the docs do not say which. The following is based on the inspection of the source code.
+ * https://docs.angularjs.org/api/ng/service/$http#defaults
+ * https://docs.angularjs.org/api/ng/service/$http#usage
+ * https://docs.angularjs.org/api/ng/provider/$httpProvider The properties section
+ */
+export interface HttpProviderDefaults {
+  /**
+   * {boolean|Cache}
+   * If true, a default $http cache will be used to cache the GET request, otherwise if a cache instance built with $cacheFactory, this cache will be used for caching.
+   */
+  cache?: any;
+  /**
+   * Transform function or an array of such functions. The transform function takes the http request body and
+   * headers and returns its transformed (typically serialized) version.
+   * @see {@link https://docs.angularjs.org/api/ng/service/$http#transforming-requests-and-responses}
+   */
+  transformRequest?:
+    | HttpRequestTransformer
+    | HttpRequestTransformer[]
+    | undefined;
+  /**
+   * Transform function or an array of such functions. The transform function takes the http response body and
+   * headers and returns its transformed (typically deserialized) version.
+   */
+  transformResponse?:
+    | HttpResponseTransformer
+    | HttpResponseTransformer[]
+    | undefined;
+  /**
+   * Map of strings or functions which return strings representing HTTP headers to send to the server. If the
+   * return value of a function is null, the header will not be sent.
+   * The key of the map is the request verb in lower case. The "common" key applies to all requests.
+   * @see {@link https://docs.angularjs.org/api/ng/service/$http#setting-http-headers}
+   */
+  headers?: HttpRequestConfigHeaders | undefined;
+  /** Name of HTTP header to populate with the XSRF token. */
+  xsrfHeaderName?: string | undefined;
+  /** Name of cookie containing the XSRF token. */
+  xsrfCookieName?: string | undefined;
+  /**
+   * whether to to set the withCredentials flag on the XHR object. See [requests with credentials]https://developer.mozilla.org/en/http_access_control#section_5 for more information.
+   */
+  withCredentials?: boolean | undefined;
+  /**
+   * A function used to the prepare string representation of request parameters (specified as an object). If
+   * specified as string, it is interpreted as a function registered with the $injector. Defaults to
+   * $httpParamSerializer.
+   */
+  paramSerializer?: string | ((obj: any) => string) | undefined;
+}
+/**
+ * Object describing the request to be made and how it should be processed.
+ * see http://docs.angularjs.org/api/ng/service/$http#usage
+ */
+export interface RequestShortcutConfig extends HttpProviderDefaults {
+  /**
+   * {Object.<string|Object>}
+   * Map of strings or objects which will be turned to ?key1=value1&key2=value2 after the url. If the value is not a string, it will be JSONified.
+   */
+  params?: any;
+  /**
+   * {string|Object}
+   * Data to be sent as the request message data.
+   */
+  data?: any;
+  /**
+   * Timeout in milliseconds, or promise that should abort the request when resolved.
+   */
+  timeout?: number | Promise<any> | undefined;
+  /**
+   * See [XMLHttpRequest.responseType]https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest#xmlhttprequest-responsetype
+   */
+  responseType?: string | undefined;
+}
+/**
+ * Object describing the request to be made and how it should be processed.
+ * see http://docs.angularjs.org/api/ng/service/$http#usage
+ */
+export interface RequestConfig extends RequestShortcutConfig {
+  /**
+   * HTTP method (e.g. 'GET', 'POST', etc)
+   */
+  method: string;
+  /**
+   * Absolute or relative URL of the resource that is being requested.
+   */
+  url: string;
+  /**
+   * Event listeners to be bound to the XMLHttpRequest object.
+   * To bind events to the XMLHttpRequest upload object, use uploadEventHandlers. The handler will be called in the context of a $apply block.
+   */
+  eventHandlers?:
+    | {
+        [type: string]: EventListenerOrEventListenerObject;
+      }
+    | undefined;
+  /**
+   * Event listeners to be bound to the XMLHttpRequest upload object.
+   * To bind events to the XMLHttpRequest object, use eventHandlers. The handler will be called in the context of a $apply block.
+   */
+  uploadEventHandlers?:
+    | {
+        [type: string]: EventListenerOrEventListenerObject;
+      }
+    | undefined;
+}
+export interface HttpResponse<T> {
+  data: T;
+  status: number;
+  headers: HttpHeadersGetter;
+  config: RequestConfig;
+  statusText: string;
+  /** Added in AngularJS 1.6.6 */
+  xhrStatus: "complete" | "error" | "timeout" | "abort";
+}
+export type HttpPromise<T> = Promise<HttpResponse<T>>;
+/**
+ * HttpService
+ */
+export interface HttpService {
+  /**
+   * Object describing the request to be made and how it should be processed.
+   */
+  <T>(config: RequestConfig): HttpPromise<T>;
+  /**
+   * Shortcut method to perform GET request.
+   *
+   * @param url Relative or absolute URL specifying the destination of the request
+   * @param config Optional configuration object
+   */
+  get<T>(url: string, config?: RequestShortcutConfig): HttpPromise<T>;
+  /**
+   * Shortcut method to perform DELETE request.
+   *
+   * @param url Relative or absolute URL specifying the destination of the request
+   * @param config Optional configuration object
+   */
+  delete<T>(url: string, config?: RequestShortcutConfig): HttpPromise<T>;
+  /**
+   * Shortcut method to perform HEAD request.
+   *
+   * @param url Relative or absolute URL specifying the destination of the request
+   * @param config Optional configuration object
+   */
+  head<T>(url: string, config?: RequestShortcutConfig): HttpPromise<T>;
+  /**
+   * Shortcut method to perform JSONP request.
+   *
+   * @param url Relative or absolute URL specifying the destination of the request
+   * @param config Optional configuration object
+   */
+  jsonp<T>(url: string, config?: RequestShortcutConfig): HttpPromise<T>;
+  /**
+   * Shortcut method to perform POST request.
+   *
+   * @param url Relative or absolute URL specifying the destination of the request
+   * @param data Request content
+   * @param config Optional configuration object
+   */
+  post<T>(
+    url: string,
+    data: any,
+    config?: RequestShortcutConfig,
+  ): HttpPromise<T>;
+  /**
+   * Shortcut method to perform PUT request.
+   *
+   * @param url Relative or absolute URL specifying the destination of the request
+   * @param data Request content
+   * @param config Optional configuration object
+   */
+  put<T>(
+    url: string,
+    data: any,
+    config?: RequestShortcutConfig,
+  ): HttpPromise<T>;
+  /**
+   * Shortcut method to perform PATCH request.
+   *
+   * @param url Relative or absolute URL specifying the destination of the request
+   * @param data Request content
+   * @param config Optional configuration object
+   */
+  patch<T>(
+    url: string,
+    data: any,
+    config?: RequestShortcutConfig,
+  ): HttpPromise<T>;
+  /**
+   * Runtime equivalent of the $httpProvider.defaults property. Allows configuration of default headers, withCredentials as well as request and response transformations.
+   */
+  defaults: HttpProviderDefaults;
+  /**
+   * Array of config objects for currently pending requests. This is primarily meant to be used for debugging purposes.
+   */
+  pendingRequests: RequestConfig[];
+}

package/@types/services/http-backend/http-backend.d.ts

@@ -1,3 +1,29 @@
+/**
+ * @param {import('../browser.js').Browser} $browser
+ * @returns
+ */
+export function createHttpBackend(
+  $browser: import("../browser.js").Browser,
+): (
+  method: any,
+  url: any,
+  post: any,
+  callback: any,
+  headers: any,
+  timeout: any,
+  withCredentials: any,
+  responseType: any,
+  eventHandlers: any,
+  uploadEventHandlers: any,
+) => void;
+/**
+ * HTTP backend used by the {@link ng.$http service} that delegates to
+ * XMLHttpRequest object and deals with browser incompatibilities.
+ *
+ * You should never need to use this service directly, instead use the higher-level abstractions:
+ * {@link ng.$http $http}.
+ *
+ */
 /**
  * HTTP backend used by the {@link ng.$http service} that delegates to
  * XMLHttpRequest object and deals with browser incompatibilities.
@@ -6,7 +32,6 @@
  * {@link ng.$http $http}.
  *
  */
-export function HttpBackendProvider(): void;
 export class HttpBackendProvider {
   $get: (
     | string
@@ -26,21 +51,3 @@ export class HttpBackendProvider {
       ) => void)
   )[];
 }
-/**
- * @param {import('../browser.js').Browser} $browser
- * @returns
- */
-export function createHttpBackend(
-  $browser: import("../browser.js").Browser,
-): (
-  method: any,
-  url: any,
-  post: any,
-  callback: any,
-  headers: any,
-  timeout: any,
-  withCredentials: any,
-  responseType: any,
-  eventHandlers: any,
-  uploadEventHandlers: any,
-) => void;