@angular-wave/angular.ts 0.17.0 → 0.19.0

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

@@ -1,4 +1,7 @@
-export function escapeForRegexp(str: any): any;
+/**
+ * @param {string} str
+ */
+export function escapeForRegexp(str: string): string;
 /**
  * Adjusts a matcher string or RegExp into a proper RegExp.
  *
@@ -22,8 +25,8 @@ export class SceProvider {
     | string
     | ((
         $parse: ng.ParseService,
-        $sceDelegate: ng.SCEDelegateService,
-      ) => ng.SCEService)
+        $sceDelegate: ng.SceDelegateService,
+      ) => ng.SceService)
   )[];
 }
 export namespace SCE_CONTEXTS {
@@ -114,13 +117,13 @@ export namespace SCE_CONTEXTS {
 export class SceDelegateProvider {
   /**
    *
-   * @param {Array=} value When provided, replaces the trustedResourceUrlList with
+   * @param {(Array<RegExp | "self"> | null)=} value When provided, replaces the trustedResourceUrlList with
    *     the value provided.  This must be an array or null.  A snapshot of this array is used so
    *     further changes to the array are ignored.
    *     Follow {@link ng.$sce#resourceUrlPatternItem this link} for a description of the items
    *     allowed in this array.
    *
-   * @return {Array<any>} The currently set trusted resource URL array.
+   * @return {Array<RegExp | "self">} The currently set trusted resource URL array.
    *
    *
    * Sets/Gets the list trusted of resource URLs.
@@ -134,12 +137,12 @@ export class SceDelegateProvider {
    * </div>
    */
   trustedResourceUrlList: (
-    value?: any[] | undefined,
+    value?: (Array<RegExp | "self"> | null) | undefined,
     ...args: any[]
-  ) => Array<any>;
+  ) => Array<RegExp | "self">;
   /**
    *
-   * @param {Array=} bannedResourceUrlList When provided, replaces the `bannedResourceUrlList` with
+   * @param {(Array<RegExp | "self"> | null)=} value When provided, replaces the `bannedResourceUrlList` with
    *     the value provided. This must be an array or null. A snapshot of this array is used so
    *     further changes to the array are ignored.</p><p>
    *     Follow {@link ng.$sce#resourceUrlPatternItem this link} for a description of the items
@@ -151,7 +154,7 @@ export class SceDelegateProvider {
    *     Finally, **the banned resource URL list overrides the trusted resource URL list** and has
    *     the final say.
    *
-   * @return {Array<any>} The currently set `bannedResourceUrlList` array.
+   * @return {Array<RegExp | "self">} The currently set `bannedResourceUrlList` array.
    *
    *
    * Sets/Gets the `bannedResourceUrlList` of trusted resource URLs.
@@ -159,7 +162,10 @@ export class SceDelegateProvider {
    * The **default value** when no trusted resource URL list has been explicitly set is the empty
    * array (i.e. there is no `bannedResourceUrlList`.)
    */
-  bannedResourceUrlList: (value: any, ...args: any[]) => Array<any>;
+  bannedResourceUrlList: (
+    value?: (Array<RegExp | "self"> | null) | undefined,
+    ...args: any[]
+  ) => Array<RegExp | "self">;
   $get: (
     | string
     | ((

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

@@ -2,12 +2,29 @@
  * Provider for the `$templateRequest` service.
  *
  * Fetches templates via HTTP and caches them in `$templateCache`.
- * Templates are assumed trusted. This provider allows configuring
- * per-request `$http` options such as headers, timeout, or transform functions.
+ * Templates are assumed trusted.
+ *
+ * This provider allows configuring per-request `$http` options such as headers,
+ * timeout, or transform functions via `httpOptions`.
+ *
+ * Option A:
+ * - Provide a sensible default for template fetching (e.g. `Accept: text/html`)
+ * - Keep `httpOptions` overridable during config phase
  */
 export class TemplateRequestProvider {
-  /** @type {ng.RequestShortcutConfig|undefined} */
-  httpOptions: ng.RequestShortcutConfig | undefined;
+  /**
+   * Optional `$http.get()` config applied to every template request.
+   *
+   * This is merged on top of the default template request config:
+   * - `cache: $templateCache`
+   * - `transformResponse`: with `defaultHttpResponseTransform` removed
+   *
+   * Use this to set template-specific defaults such as custom headers,
+   * timeouts, credentials, etc.
+   *
+   * @type {ng.RequestShortcutConfig}
+   */
+  httpOptions: ng.RequestShortcutConfig;
   $get: (
     | string
     | ((

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

@@ -28,37 +28,10 @@ export function removeFrom(array: Array<any>, obj: any): Array<any>;
  * Applies a set of defaults to an options object.  The options object is filtered
  * to only those properties of the objects in the defaultsList.
  * Earlier objects in the defaultsList take precedence when applying defaults.
- * @param {{}} opts
- * @param {{ current?: (() => void) | (() => null); transition?: null; traceData?: {}; bind?: null; inherit?: boolean; matchingKeys?: null; state?: { params: {}; }; strict?: boolean; caseInsensitive?: boolean; relative?: import("../router/state/state-object.js").StateObject | null | undefined; location?: boolean; notify?: boolean; reload?: boolean; supercede?: boolean; custom?: {}; source?: string; lossy?: boolean; absolute?: boolean; }[]} defaultsList
- */
-export function defaults(
-  opts: {},
-  ...defaultsList: {
-    current?: (() => void) | (() => null);
-    transition?: null;
-    traceData?: {};
-    bind?: null;
-    inherit?: boolean;
-    matchingKeys?: null;
-    state?: {
-      params: {};
-    };
-    strict?: boolean;
-    caseInsensitive?: boolean;
-    relative?:
-      | import("../router/state/state-object.js").StateObject
-      | null
-      | undefined;
-    location?: boolean;
-    notify?: boolean;
-    reload?: boolean;
-    supercede?: boolean;
-    custom?: {};
-    source?: string;
-    lossy?: boolean;
-    absolute?: boolean;
-  }[]
-): any;
+ * @param {any} opts
+ * @param {any} defaultsList
+ */
+export function defaults(opts: any, ...defaultsList: any): any;
 /**
  * Return a copy of the object only containing the whitelisted properties.
  *
@@ -203,7 +176,7 @@ export function tail<T>(arr: any[] | string): T | undefined;
 export function copy(src: any, dest: any): any;
 export function allTrueR(memo: any, elem: any): any;
 export function anyTrueR(memo: any, elem: any): any;
-export function unnestR<T>(memo: T[], elem: T | T[]): T[];
+export function unnestR(memo: any, elem: any): any;
 export function flattenR<T>(memo: T[], elem: any): T[];
 export function uniqR(acc: any[], token: any): any[];
 export function unnest(arr: any[]): any;

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

@@ -187,16 +187,21 @@ export function cleanElementData(nodes: NodeListOf<Element> | Element[]): void;
 export function getInjector(element: Element): ng.InjectorService;
 /**
  * Creates a DOM element from an HTML string.
- * @param {string} htmlString - A string representing the HTML to parse. Must have only one root element.
- * @returns {Element} - The parsed DOM element.
+ * Must have exactly one root node.
+ *
+ * @param {string} htmlString - A string representing the HTML to parse.
+ * @returns {Element}
  */
 export function createElementFromHTML(htmlString: string): Element;
 /**
- * Creates a DOM element from an HTML string.
+ * Creates a NodeList from an HTML string.
+ *
  * @param {string} htmlString - A string representing the HTML to parse.
- * @returns {NodeList} - The parsed DOM element.
+ * @returns {NodeListOf<ChildNode>}
  */
-export function createNodelistFromHTML(htmlString: string): NodeList;
+export function createNodelistFromHTML(
+  htmlString: string,
+): NodeListOf<ChildNode>;
 /**
  * Remove element from the DOM and clear Cache data, associated with the node.
  * @param {Element} element

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

@@ -18,3 +18,7 @@ export interface ErrorHandlingConfig {
   urlErrorParamsEnabled?: boolean;
 }
 export type Validator = (value: unknown) => boolean;
+/**
+ * A dictionary of string keys and values of type T.
+ */
+export type Dict<T> = Record<string, T>;

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

@@ -256,8 +256,8 @@ export function extend(dst: any, ...src: any[]): any;
  */
 export function isNumberNaN(num: any): boolean;
 /**
- * @param {Object} parent
- * @param {Object} extra
+ * @param {any} parent
+ * @param {any} extra
  * @returns {Object}
  */
 export function inherit(parent: any, extra: any): any;
@@ -277,9 +277,9 @@ export function hasCustomToString(obj: { toString: () => string }): boolean;
 export function getNodeName(element: Element): string;
 /**
  * @param {any} array
- * @param {string} obj
+ * @param {any} obj
  */
-export function includes(array: any, obj: string): boolean;
+export function includes(array: any, obj: any): boolean;
 /**
  * Removes the first occurrence of a specified value from an array.
  *
@@ -427,10 +427,10 @@ export function fromJson(json: string): any | Array<any> | string | number;
 export function addDateMinutes(date: Date, minutes: number): Date;
 /**
  * Parses an escaped url query string into key-value pairs.
- * @param {string} keyValue
+ * @param {string} value
  * @returns {Object.<string,boolean|Array<any>>}
  */
-export function parseKeyValue(keyValue: string): {
+export function parseKeyValue(value: string): {
   [x: string]: boolean | any[];
 };
 /**
@@ -724,5 +724,16 @@ export function instantiateWasm(
  * @returns {boolean}
  */
 export function isArrowFunction(fn: any): boolean;
+/**
+ * Creates an object with no prototype.
+ *
+ * This is useful for use as a dictionary or map, since the returned object
+ * does not inherit from `Object.prototype` and therefore has no built-in
+ * properties such as `toString` or `hasOwnProperty`.
+ *
+ * @template T
+ * @returns {Record<string, T>} An object with a null prototype.
+ */
+export function nullObject<T>(): Record<string, T>;
 export const isProxySymbol: unique symbol;
 export const ngAttrPrefixes: string[];