@angular-wave/angular.ts 0.18.0 → 0.19.0

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[];