@angular-wave/angular.ts 0.7.7 → 0.7.8

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

@@ -4,7 +4,7 @@
 export class UrlService {
   static $inject: string[];
   /**
-   * @param {import("../../core/location/location").LocationProvider} $locationProvider
+   * @param {import("../../services/location/location").LocationProvider} $locationProvider
    * @param {import("../../router/state/state-service.js").StateProvider} stateService
    * @param globals
    * @param {import("../../router/url/url-config.js").UrlConfigProvider} urlConfigProvider
@@ -17,8 +17,7 @@ export class UrlService {
   );
   stateService: import("../../router/state/state-service.js").StateProvider;
   $locationProvider: any;
-  $location: import("../../core/location/location.js").Location;
-  $browser: import("../../services/browser.js").Browser;
+  $location: import("../../services/location/location.js").Location;
   /** Provides services related to the URL */
   urlRuleFactory: UrlRuleFactory;
   /**
@@ -60,13 +59,12 @@ export class UrlService {
    *
    * @return the hash (anchor) portion of the url
    */
-  hash: () => string | import("../../core/location/location.js").Location;
+  hash: () => string | import("../../services/location/location.js").Location;
   _urlListeners: any[];
   $get: (
     | string
     | ((
-        $location: import("../../core/location/location.js").Location,
-        $browser: import("../../services/browser.js").Browser,
+        $location: import("../../services/location/location.js").Location,
         $rootScope: import("../../core/scope/scope.js").Scope,
       ) => UrlService)
   )[];
@@ -132,7 +130,7 @@ export class UrlService {
     newUrl?: string,
     replace?: boolean,
     state?: any,
-  ): string | import("../../core/location/location.js").Location;
+  ): string | import("../../services/location/location.js").Location;
   /**
    * @internal
    *
@@ -157,7 +155,7 @@ export class UrlService {
   parts(): {
     path: any;
     search: any;
-    hash: string | import("../../core/location/location.js").Location;
+    hash: string | import("../../services/location/location.js").Location;
   };
   /**
    * Activates the best rule for the current URL
@@ -211,7 +209,7 @@ export class UrlService {
    */
   match(url: any): any;
   update(read: any): void;
-  location: string | import("../../core/location/location.js").Location;
+  location: string | import("../../services/location/location.js").Location;
   /**
    * Internal API.
    *

package/@types/services/anchor-scroll.d.ts

@@ -13,7 +13,7 @@ export class AnchorScrollProvider {
   $get: (
     | string
     | ((
-        $location: import("../core/location/location.js").Location,
+        $location: import("../services/location/location.js").Location,
         $rootScope: import("../core/scope/scope.js").Scope,
       ) => AnchorScrollFunction)
   )[];

package/@types/{core → services/exception}/exception-handler.d.ts

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

package/@types/{core/error-handler.d.ts → services/exception/interface.d.ts}

@@ -4,4 +4,4 @@
  * @param exception - The exception associated with the error.
  * @param [cause] - Optional information about the context in which the error was thrown.
  */
-export type ErrorHandler = (exception: Error, cause?: string) => void;
+export type Interface = (exception: Error, cause?: string) => void;

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

@@ -55,9 +55,7 @@ export class HttpProvider {
   $get: (
     | string
     | ((
-        $browser: any,
         $httpBackend: any,
-        $rootScope: import("../../core/scope/scope.js").Scope,
         $injector: import("../../core/di/internal-injector.js").InjectorService,
         $sce: any,
       ) => {

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

@@ -126,14 +126,14 @@ export interface RequestConfig extends RequestShortcutConfig {
       }
     | undefined;
 }
+export type HttpResponseStatus = "complete" | "error" | "timeout" | "abort";
 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";
+  xhrStatus: HttpResponseStatus;
 }
 export type HttpPromise<T> = Promise<HttpResponse<T>>;
 /**

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

@@ -1,10 +1,7 @@
 /**
- * @param {import('../browser.js').Browser} $browser
  * @returns
  */
-export function createHttpBackend(
-  $browser: import("../browser.js").Browser,
-): (
+export function createHttpBackend(): (
   method: any,
   url: any,
   post: any,
@@ -33,21 +30,16 @@ export function createHttpBackend(
  *
  */
 export class HttpBackendProvider {
-  $get: (
-    | string
-    | ((
-        $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)
-  )[];
+  $get: (() => (
+    method: any,
+    url: any,
+    post: any,
+    callback: any,
+    headers: any,
+    timeout: any,
+    withCredentials: any,
+    responseType: any,
+    eventHandlers: any,
+    uploadEventHandlers: any,
+  ) => void)[];
 }

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

@@ -0,0 +1,8 @@
+/**
+ * A callback function that gets called when the browser URL or state changes.
+ *
+ * @param url - The new URL after the change (with trailing `#` removed).
+ * @param state - The new history state associated with the URL (`history.state`).
+ * @returns void
+ */
+export type UrlChangeListener = (url: string, state: History["state"]) => void;

package/@types/{core → services}/location/location.d.ts

@@ -37,8 +37,8 @@ export class Location {
    * @type {boolean}
    */
   $$replace: boolean;
-  /** @type {import('../url-utils/url-utils').HttpProtocol} */
-  $$protocol: any;
+  /** @type {string} */
+  $$protocol: string;
   /** @type {string} */
   $$host: string;
   /**
@@ -81,9 +81,9 @@ export class Location {
   /**
    *
    * Return protocol of current URL.
-   * @return {import("../url-utils/url-utils").HttpProtocol} protocol of current URL
+   * @return {string} protocol of current URL
    */
-  protocol(): any;
+  protocol(): string;
   /**
    * This method is getter only.
    *
@@ -227,14 +227,15 @@ export class LocationHtml5Url extends Location {
  * This object is exposed as $location service when developer doesn't opt into html5 mode.
  * It also serves as the base class for html5 mode fallback on legacy browsers.
  *
- * @constructor
- * @param {string} appBase application base URL
- * @param {string} appBaseNoFile application base URL stripped of any filename
- * @param {string} hashPrefix hashbang prefix
  */
 export class LocationHashbangUrl extends Location {
-  constructor(appBase: any, appBaseNoFile: any, hashPrefix: any);
-  hashPrefix: any;
+  /**
+   * @param {string} appBase application base URL
+   * @param {string} appBaseNoFile application base URL stripped of any filename
+   * @param {string} hashPrefix hashbang prefix
+   */
+  constructor(appBase: string, appBaseNoFile: string, hashPrefix: string);
+  hashPrefix: string;
   /**
    * Parse given hashbang URL into properties
    * @param {string} url Hashbang URL
@@ -252,6 +253,46 @@ export class LocationProvider {
   hashPrefixConf: string;
   /** @type {Html5Mode} */
   html5ModeConf: Html5Mode;
+  /** @type {Array<import("./interface.js").UrlChangeListener>} */
+  urlChangeListeners: Array<import("./interface.js").UrlChangeListener>;
+  urlChangeInit: boolean;
+  /** @type {History['state']} */
+  cachedState: History["state"];
+  /** @typeof {History.state} */
+  lastHistoryState: any;
+  /** @type {string} */
+  lastBrowserUrl: string;
+  setUrl(url: any, state: any): this;
+  /**
+   * Returns the current URL with any empty hash (`#`) removed.
+   * @return {string}
+   */
+  getUrl(): string;
+  /**
+   * Returns the cached state.
+   * @returns {History['state']} The cached state.
+   */
+  state(): History["state"];
+  /**
+   * Caches the current state.
+   *
+   * @private
+   */
+  private cacheState;
+  lastCachedState: any;
+  /**
+   * Fires the state or URL change event.
+   *
+   * @private
+   */
+  private fireStateOrUrlChange;
+  /**
+   * Registers a callback to be called when the URL changes.
+   *
+   * @param {import("./interface.js").UrlChangeListener} callback - The callback function to register.
+   * @returns void
+   */
+  onUrlChange(callback: import("./interface.js").UrlChangeListener): void;
   /**
    * The default value for the prefix is `'!'`.
    * @param {string=} prefix Prefix for hash part (containing path and search)
@@ -278,8 +319,7 @@ export class LocationProvider {
   $get: (
     | string
     | ((
-        $rootScope: import("../scope/scope.js").Scope,
-        $browser: any,
+        $rootScope: import("../../core/scope/scope.js").Scope,
         $rootElement: Element,
       ) => Location)
   )[];

package/@types/{core → services}/sce/sce.d.ts

@@ -243,4 +243,4 @@ export class SceDelegateProvider {
       })
   )[];
 }
-export type ErrorHandler = import("../error-handler.ts").ErrorHandler;
+export type ErrorHandler = import("../exception/interface.ts").Interface;

package/@types/services/template-cache/interface.d.ts

@@ -1,4 +1,10 @@
 /**
- * A cache for mapping template names to their respective content.
+ * A cache interface for mapping template urls to their XHR responses.
  */
-export type TemplateCache = Map<string, string>;
+export interface TemplateCache {
+  get(key: string): any | undefined;
+  set(key: string, value: any): this;
+  has(key: string): boolean;
+  delete(key: string): boolean;
+  clear(): void;
+}

package/@types/services/template-cache/template-cache.d.ts

@@ -7,5 +7,5 @@ export class TemplateCacheProvider {
   /**
    * @returns {import('./interface.ts').TemplateCache}
    */
-  $get: () => import("./interface.ts").TemplateCache;
+  $get(): import("./interface.ts").TemplateCache;
 }

package/@types/services/template-request.d.ts

@@ -43,7 +43,7 @@ export class TemplateRequestProvider {
   $get: (
     | string
     | ((
-        $exceptionHandler: import("../core/exception-handler.js").ErrorHandler,
+        $exceptionHandler: import("./exception/exception-handler.js").ErrorHandler,
         $templateCache: import("../services/template-cache/interface.ts").TemplateCache,
         $http: any,
         $sce: any,

package/@types/shared/cache.d.ts

@@ -1,8 +1,6 @@
 /**
  * Expando cache for adding properties to DOM nodes with JavaScript.
  * This used to be an Object in JQLite decorator, but swapped out for a Map
- * for performance reasons and convenience methods. A proxy is available for
- * additional logic handling.
  *
  * @type {Map<number, import('../interface.ts').ExpandoStore>}
  */

package/@types/shared/dom.d.ts

@@ -240,6 +240,12 @@ export function domInsert(
   parentElement: any,
   afterElement: any,
 ): void;
+/**
+ * Returns the base href of the document.
+ *
+ * @returns {string} The base href.
+ */
+export function getBaseHref(): string;
 /**
  * A list of boolean attributes in HTML.
  * @type {string[]}

package/@types/shared/test-utils.d.ts

@@ -6,6 +6,7 @@
 export function browserTrigger(element: HTMLElement, options: any): void;
 /**
  * Delays execution for a specified number of milliseconds.
+ * TODO remove
  *
  * @param {number} [t=0] - The number of milliseconds to wait. Defaults to 0.
  * @returns {Promise<void>} A promise that resolves after the delay.

package/@types/shared/url-utils/interface.d.ts

@@ -0,0 +1,47 @@
+export type HttpProtocol = "http" | "https";
+/**
+ * A normalized representation of a parsed URL.
+ */
+export interface ParsedUrl {
+  /**
+   * The full URL string, including protocol, host, path, query, and hash.
+   * Example: "https://example.com:8080/path?query=1#section"
+   */
+  href: string;
+  /**
+   * The protocol scheme of the URL, without the trailing colon.
+   * Example: "http" or "https"
+   */
+  protocol: string;
+  /**
+   * The host part of the URL, including hostname and port (if specified).
+   * Example: "example.com:8080"
+   */
+  host: string;
+  /**
+   * The query string portion of the URL, without the leading "?".
+   * Example: "query=1&sort=asc"
+   */
+  search: string;
+  /**
+   * The fragment identifier (hash) of the URL, without the leading "#".
+   * Example: "section2"
+   */
+  hash: string;
+  /**
+   * The domain or IP address (including IPv6 in brackets) of the URL.
+   * Example: "example.com" or "[::1]"
+   */
+  hostname: string;
+  /**
+   * The port number of the URL as a string, or an empty string if not specified.
+   * Example: "8080" or ""
+   */
+  port: string;
+  /**
+   * The path of the URL, always beginning with a leading slash.
+   * Example: "/path/to/resource"
+   */
+  pathname: string;
+}
+export type ResolvableUrl = string | ParsedUrl;

package/@types/{core → shared}/url-utils/url-utils.d.ts

@@ -1,49 +1,59 @@
-export function urlResolve(url: any): any;
+/**
+ * @param {import("./interface.js").ResolvableUrl} url
+ * @return {import("./interface.js").ParsedUrl}
+ */
+export function urlResolve(
+  url: import("./interface.js").ResolvableUrl,
+): import("./interface.js").ParsedUrl;
 /**
  * Parse a request URL and determine whether this is a same-origin request as the application
  * document.
  *
- * @param {string|object} requestUrl The url of the request as a string that will be resolved
+ * @param {import("./interface.js").ResolvableUrl} requestUrl The url of the request as a string that will be resolved
  * or a parsed URL object.
  * @returns {boolean} Whether the request is for the same origin as the application document.
  */
-export function urlIsSameOrigin(requestUrl: string | object): boolean;
+export function urlIsSameOrigin(
+  requestUrl: import("./interface.js").ResolvableUrl,
+): boolean;
 /**
  * Parse a request URL and determine whether it is same-origin as the current document base URL.
  *
  * Note: The base URL is usually the same as the document location (`location.href`) but can
  * be overriden by using the `<base>` tag.
  *
- * @param {string|object} requestUrl The url of the request as a string that will be resolved
+ * @param {import("./interface.js").ResolvableUrl} requestUrl The url of the request as a string that will be resolved
  * or a parsed URL object.
  * @returns {boolean} Whether the URL is same-origin as the document base URL.
  */
-export function urlIsSameOriginAsBaseUrl(requestUrl: string | object): boolean;
+export function urlIsSameOriginAsBaseUrl(
+  requestUrl: import("./interface.js").ResolvableUrl,
+): boolean;
 /**
  * Create a function that can check a URL's origin against a list of allowed/trusted origins.
  * The current location's origin is implicitly trusted.
  *
  * @param {string[]} trustedOriginUrls - A list of URLs (strings), whose origins are trusted.
  *
- * @returns {Function} - A function that receives a URL (string or parsed URL object) and returns
+ * @returns {(url: import("./interface.js").ResolvableUrl) => boolean } - A function that receives a URL (string or parsed URL object) and returns
  *     whether it is of an allowed origin.
  */
 export function urlIsAllowedOriginFactory(
   trustedOriginUrls: string[],
-): Function;
+): (url: import("./interface.js").ResolvableUrl) => boolean;
 /**
  * Determine if two URLs share the same origin.
  *
- * @param {string|Object} url1 - First URL to compare as a string or a normalized URL in the form of
+ * @param {import("./interface.js").ResolvableUrl} url1 - First URL to compare as a string or a normalized URL in the form of
  *     a dictionary object returned by `urlResolve()`.
- * @param {string|object} url2 - Second URL to compare as a string or a normalized URL in the form
+ * @param {import("./interface.js").ResolvableUrl} url2 - Second URL to compare as a string or a normalized URL in the form
  *     of a dictionary object returned by `urlResolve()`.
  *
  * @returns {boolean} - True if both URLs have the same origin, and false otherwise.
  */
 export function urlsAreSameOrigin(
-  url1: string | any,
-  url2: string | object,
+  url1: import("./interface.js").ResolvableUrl,
+  url2: import("./interface.js").ResolvableUrl,
 ): boolean;
 /**
  * Returns the current document base URL.
@@ -51,6 +61,9 @@ export function urlsAreSameOrigin(
  */
 export function getBaseUrl(): string;
 /**
- * HTTP protocol
+ * Removes a trailing hash ('#') from the given URL if it exists.
+ *
+ * @param {string} url
+ * @returns {string}
  */
-export type HttpProtocol = "http" | "https";
+export function trimEmptyHash(url: string): string;

package/@types/shared/utils.d.ts

@@ -533,6 +533,21 @@ export function hasOwn(obj: object, key: string | number | symbol): boolean;
  * @returns {Function} A new function that will call `fn` only once.
  */
 export function callBackOnce(fn: Function): Function;
+/**
+ * Wraps a function so it will only be called starting from the second invocation.
+ * The first call does nothing and returns undefined.
+ *
+ * @param {Function} fn - The function to wrap.
+ * @returns {Function} A new function that will skip the first call.
+ */
+export function callBackAfterFirst(fn: Function): Function;
+/**
+ * Delays execution for a specified number of milliseconds.
+ *
+ * @param {number} [t=0] - The number of milliseconds to wait. Defaults to 0.
+ * @returns {Promise<void>} A promise that resolves after the delay.
+ */
+export function wait(t?: number): Promise<void>;
 export const isProxySymbol: unique symbol;
 export const ngAttrPrefixes: string[];
 /**

package/Makefile

@@ -28,10 +28,11 @@ types:
 	@rm -rf @types
 	@echo "Generating *.d.ts"
 	@npx -p typescript tsc --project tsconfig.types.json
+	$(MAKE) pretty
 
 
 TYPEDOC_DIR = docs/static/typedoc
-typedoc: types pretty
+doc: types
 	@rm -rf $(TYPEDOC_DIR)
 	@npm run generate-docs
 	@npx prettier ./typedoc --write
@@ -40,7 +41,7 @@ typedoc: types pretty
 serve:
 	@npm run serve
 
-prepare-release: test check types typedoc pretty build
+prepare-release: test check types doc pretty build
 
 PLAYWRIGHT_TEST := npx playwright test