@angular-wave/angular.ts 0.18.0 → 0.19.0

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

@@ -15,12 +15,15 @@ export class UrlService {
     globals: import("../router.js").RouterProvider,
     urlConfigProvider: import("../../router/url/url-config.js").UrlConfigProvider,
   );
-  /** @type {ng.LocationService} */
-  $location: ng.LocationService;
+  /** @type {ng.LocationService | undefined} */
+  $location: ng.LocationService | undefined;
   /** @private */
   private _locationProvider;
   stateService: import("../../router/state/state-service.js").StateProvider;
-  /** @type {UrlRuleFactory} Provides services related to the URL */
+  /**
+   * @type {UrlRuleFactory} Provides services related to the URL
+   * @ignore
+   */
   _urlRuleFactory: UrlRuleFactory;
   /**
    * The nested [[UrlRules]] API for managing URL rules and rewrites
@@ -30,12 +33,20 @@ export class UrlService {
   _rules: UrlRules;
   /**
    * The nested [[UrlConfig]] API to configure the URL and retrieve URL information
+   * @ignore
    * @type {import("./url-config.js").UrlConfigProvider}
    */
   _config: import("./url-config.js").UrlConfigProvider;
-  /** @type {ParamFactory} Creates a new [[Param]] for a given location (DefType) */
+  /**
+   * @type {ParamFactory} Creates a new [[Param]] for a given location (DefType)
+   * @ignore
+   */
   _paramFactory: ParamFactory;
-  _urlListeners: any[];
+  /**
+   * @type {((evt: ng.ScopeEvent) => void)[]}
+   * @ignore
+   */
+  _urlListeners: ((evt: ng.ScopeEvent) => void)[];
   /**
    * Gets the path part of the current url
    *
@@ -136,8 +147,8 @@ export class UrlService {
    * let deregisterFn = locationServices.onChange((evt) => console.log("url change", evt));
    * ```
    *
-   * @param {Function} callback a function that will be called when the url is changing
-   * @return {Function} a function that de-registers the callback
+   * @param {(evt: ng.ScopeEvent) => void} callback a function that will be called when the url is changing
+   * @return {() => void} a function that de-registers the callback
    */
   private onChange;
   /**
@@ -167,8 +178,11 @@ export class UrlService {
    *   urlService.sync();
    * });
    * ```
+   * @param {import("../../core/scope/interface.ts").ScopeEvent | undefined} [evt]
    */
-  sync(evt: any): void;
+  sync(
+    evt?: import("../../core/scope/interface.ts").ScopeEvent | undefined,
+  ): void;
   /**
    * Starts or stops listening for URL changes
    *
@@ -193,62 +207,75 @@ export class UrlService {
   listen(enabled: boolean): any;
   _stopListeningFn: any;
   /**
-   * Matches a URL
-   *
    * Given a URL (as a [[UrlParts]] object), check all rules and determine the best matching rule.
    * Return the result as a [[MatchResult]].
+   * @param {import("../../docs.ts").UrlParts} url
    * @returns {any}
    */
-  match(url: any): any;
-  update(read: any): void;
+  match(url: import("../../docs.ts").UrlParts): any;
+  /**
+   * @param {boolean | undefined} [read]
+   */
+  update(read?: boolean | undefined): void;
   location: string;
   /**
    * Internal API.
    *
    * Pushes a new location to the browser history.
-   *
    * @internal
-   * @param urlMatcher
-   * @param params
-   * @param options
+   * @param {{ format: (arg0: any) => string | undefined; }} urlMatcher
+   * @param {import("../params/state-params.js").StateParams} params
+   * @param {string} options
    */
-  push(urlMatcher: any, params: any, options: any): void;
+  push(
+    urlMatcher: {
+      format: (arg0: any) => string | undefined;
+    },
+    params: import("../params/state-params.js").StateParams,
+    options: string,
+  ): void;
   /**
-   * Builds and returns a URL with interpolated parameters
-   *
-   * #### Example:
-   * ```js
-   * matcher = $umf.compile("/about/:person");
-   * params = { person: "bob" };
-   * $bob = $url.href(matcher, params);
-   * // $bob == "/about/bob";
-   * ```
-   *
-   * @param urlMatcher The [[UrlMatcher]] object which is used as the template of the URL to generate.
-   * @param params An object of parameter values to fill the matcher's required parameters.
-   * @param options Options object. The options are:
-   *
-   * - **`absolute`** - {boolean=false},  If true will generate an absolute url, e.g. "http://www.example.com/fullurl".
-   *
-   * @returns Returns the fully compiled URL, or `null` if `params` fail validation against `urlMatcher`
-   */
-  href(urlMatcher: any, params: any, options: any): any;
+       * Builds and returns a URL with interpolated parameters
+       *
+       * #### Example:
+       * ```js
+       * matcher = $umf.compile("/about/:person");
+       * params = { person: "bob" };
+       * $bob = $url.href(matcher, params);
+       * // $bob == "/about/bob";
+       * ```
+       * @param {{ format: (arg0: any) => any; }} urlMatcher The [[UrlMatcher]] object which is used as the template of the URL to generate.
+       * @param {Object} params An object of parameter values to fill the matcher's required parameters.
+       * @param {{ absolute: any; }} options Options object. The options are:
+  
+      - **`absolute`** - {boolean=false},  If true will generate an absolute url, e.g. "http://www.example.com/fullurl".
+       * @returns Returns the fully compiled URL, or `null` if `params` fail validation against `urlMatcher`
+       */
+  href(
+    urlMatcher: {
+      format: (arg0: any) => any;
+    },
+    params: any,
+    options: {
+      absolute: any;
+    },
+  ): any;
   /**
    * Creates a [[UrlMatcher]] for the specified pattern.
    *
-   * @param urlPattern  The URL pattern.
-   * @param config  The config object hash.
+   * @param {string} urlPattern  The URL pattern.
+   * @param {*} [config]  The config object hash.
    * @returns The UrlMatcher.
    */
-  compile(urlPattern: any, config: any): UrlMatcher;
+  compile(urlPattern: string, config?: any): UrlMatcher;
   /**
    * Returns true if the specified object is a [[UrlMatcher]], or false otherwise.
    *
-   * @param object  The object to perform the type check against.
+   * @param {UrlMatcher & Record<string, any>} object  The object to perform the type check against.
    * @returns `true` if the object matches the `UrlMatcher` interface, by
    *          implementing all the same methods.
    */
-  isMatcher(object: any): boolean;
+  isMatcher(object: UrlMatcher & Record<string, any>): boolean;
 }
 import { UrlRuleFactory } from "./url-rule.js";
 import { UrlRules } from "./url-rules.js";

package/@types/router/view/interface.d.ts

@@ -1,5 +1,4 @@
-import { ViewDeclaration } from "../state/interface.ts";
-import { PathNode } from "../path/path-node.js";
+import { ViewConfig } from "../state/views.js";
 /** The context ref can be anything that has a `name` and a `parent` reference to another IContextRef */
 export interface ViewContext {
   name: string;
@@ -8,37 +7,18 @@ export interface ViewContext {
 export interface ActiveUIView {
   /** An auto-incremented id */
   id: number;
-  /** The ui-view short name */
+  /** The ng-view short name */
   name: string;
-  /** The ui-view's fully qualified name */
+  /** The ng-view's fully qualified name */
   fqn: string;
-  /** The ViewConfig that is currently loaded into the ui-view */
-  config: ViewConfig;
-  /** The state context in which the ui-view tag was created. */
+  /** The ViewConfig that is currently loaded into the ng-view */
+  config: ViewConfig | null;
+  /** The state context in which the ng-view tag was created. */
   creationContext: ViewContext;
-  /** A callback that should apply a ViewConfig (or clear the ui-view, if config is undefined) */
+  /** A callback that should apply a ViewConfig (or clear the ng-view, if config is undefined) */
   configUpdated: (config: ViewConfig) => void;
 }
-/**
- * This interface represents a [[_ViewDeclaration]] that is bound to a [[PathNode]].
- *
- * A `ViewConfig` is the runtime definition of a single view.
- *
- * During a transition, `ViewConfig`s are created for each [[_ViewDeclaration]] defined on each "entering" [[StateObject]].
- * Then, the [[ViewService]] finds any matching `ui-view`(s) in the DOM, and supplies the ui-view
- * with the `ViewConfig`.  The `ui-view` then loads itself using the information found in the `ViewConfig`.
- *
- * A `ViewConfig` if matched with a `ui-view` by finding all `ui-view`s which were created in the
- * context named by the `uiViewContextAnchor`, and finding the `ui-view` or child `ui-view` that matches
- * the `uiViewName` address.
- */
-export interface ViewConfig {
-  $id: number;
-  /** The normalized view declaration from [[State.views]] */
-  viewDecl: ViewDeclaration;
-  /** The node the ViewConfig is bound to */
-  path: PathNode[];
-  loaded: boolean;
-  /** Fetches templates, runs dynamic (controller|template)Provider code, lazy loads Components, etc */
-  load(): Promise<ViewConfig>;
+export interface ViewTuple {
+  ngView: ActiveUIView | undefined;
+  viewConfig: ViewConfig;
 }

package/@types/router/view/view.d.ts

@@ -1,7 +1,20 @@
 export class ViewService {
+  /**
+   * @type {any[]}
+   */
   _ngViews: any[];
+  /**
+   * @type {any[]}
+   */
   _viewConfigs: any[];
+  /**
+   * @type {any[]}
+   */
   _listeners: any[];
+  _viewConfigFactory: (
+    path: import("../path/path-node.js").PathNode[],
+    view: import("../state/interface.ts").ViewDeclaration,
+  ) => import("../state/views.js").ViewConfig;
   $get: () => this;
   /**
    * @param {?import('../state/state-object.js').StateObject} [context]
@@ -11,15 +24,14 @@ export class ViewService {
     context?: import("../state/state-object.js").StateObject | null,
   ): import("../state/state-object.js").StateObject | null;
   _rootContext: any;
-  _viewConfigFactory(factory: any): void;
   /**
-   * @param path
-   * @param decl
+   * @param {import("../path/path-node.js").PathNode[]} path
+   * @param {import("../state/interface.ts").ViewDeclaration} decl
    * @return {import("../state/views.js").ViewConfig}
    */
   _createViewConfig(
-    path: any,
-    decl: any,
+    path: import("../path/path-node.js").PathNode[],
+    decl: import("../state/interface.ts").ViewDeclaration,
   ): import("../state/views.js").ViewConfig;
   /**
    * Deactivates a ViewConfig.
@@ -27,10 +39,13 @@ export class ViewService {
    * This function deactivates a `ViewConfig`.
    * After calling [[sync]], it will un-pair from any `ng-view` with which it is currently paired.
    *
-   * @param viewConfig The ViewConfig view to deregister.
+   * @param {ViewConfig} viewConfig The ViewConfig view to deregister.
+   */
+  deactivateViewConfig(viewConfig: ViewConfig): void;
+  /**
+   * @param {ViewConfig} viewConfig
    */
-  deactivateViewConfig(viewConfig: any): void;
-  activateViewConfig(viewConfig: any): void;
+  activateViewConfig(viewConfig: ViewConfig): void;
   sync(): void;
   /**
    * Registers a `ng-view` component
@@ -43,23 +58,22 @@ export class ViewService {
    *
    * Note: There is no corresponding `deregisterUIView`.
    *       A `ng-view` should hang on to the return value of `registerUIView` and invoke it to deregister itself.
-   *
-   * @param ngView The metadata for a UIView
-   * @return a de-registration function used when the view is destroyed.
+   * @param {import("./interface.ts").ActiveUIView} ngView The metadata for a UIView
+   * @return {() => void} a de-registration function used when the view is destroyed.
    */
-  registerUIView(ngView: any): () => void;
+  registerUIView(ngView: import("./interface.ts").ActiveUIView): () => void;
   /**
    * Returns the list of views currently available on the page, by fully-qualified name.
    *
-   * @return {Array<any>} Returns an array of fully-qualified view names.
+   * @return {Array<string>} Returns an array of fully-qualified view names.
    */
-  available(): Array<any>;
+  available(): Array<string>;
   /**
    * Returns the list of views on the page containing loaded content.
    *
-   * @return {Array<any>} Returns an array of fully-qualified view names.
+   * @return {Array<string>} Returns an array of fully-qualified view names.
    */
-  active(): Array<any>;
+  active(): Array<string>;
 }
 export namespace ViewService {
   /**
@@ -71,8 +85,6 @@ export namespace ViewService {
    * A ViewConfig has a target ng-view name and a context anchor.  The ng-view name can be a simple name, or
    * can be a segmented ng-view path, describing a portion of a ng-view fqn.
    *
-   * In order for a ng-view to match ViewConfig, ng-view's $type must match the ViewConfig's $type
-   *
    * If the ViewConfig's target ng-view name is a simple name (no dots), then a ng-view matches if:
    * - the ng-view's name matches the ViewConfig's target name
    * - the ng-view's context matches the ViewConfig's anchor
@@ -120,7 +132,9 @@ export namespace ViewService {
    * @internal
    */
   function matches(
-    ngViewsByFqn: any,
-    ngView: any,
-  ): (viewConfig: any) => boolean;
+    ngViewsByFqn: import("../../shared/interface.ts").Dict<ActiveUIView>,
+    ngView: ActiveUIView,
+  ): (/** @type {ViewConfig} */ viewConfig: ViewConfig) => boolean;
 }
+export type ActiveUIView = import("./interface.ts").ActiveUIView;
+export type ViewConfig = import("../state/views.js").ViewConfig;

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

@@ -2,7 +2,7 @@ export interface AnchorScrollService {
   /**
    * Invoke anchor scrolling.
    */
-  (hash?: string | number): void;
+  (hashOrElement?: string | number | HTMLElement): void;
   /**
    * Vertical scroll offset.
    * Can be a number, a function returning a number,

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

@@ -17,7 +17,14 @@ export class HttpParamSerializerProvider {
    */
   $get: () => import("./interface.ts").HttpParamSerializer;
 }
-export function defaultHttpResponseTransform(data: any, headers: any): any;
+/**
+ * @param {unknown} data
+ * @param {(arg0: string) => any} headers
+ */
+export function defaultHttpResponseTransform(
+  data: unknown,
+  headers: (arg0: string) => any,
+): unknown;
 /**
  * Use `$httpProvider` to change the default behavior of the {@link ng.$http $http} service.
  */
@@ -98,17 +105,7 @@ export class HttpProvider {
         $injector: ng.InjectorService,
         $sce: ng.SceService,
         $cookie: ng.CookieService,
-      ) => {
-        (requestConfig: any): Promise<any>;
-        pendingRequests: any[];
-        /**
-         * Runtime equivalent of the `$httpProvider.defaults` property. Allows configuration of
-         * default headers, withCredentials as well as request and response transformations.
-         *
-         * See "Setting HTTP Headers" and "Transforming Requests and Responses" sections above.
-         */
-        defaults: import("./interface.ts").HttpProviderDefaults;
-      })
+      ) => ng.HttpService)
   )[];
 }
 /**
@@ -117,13 +114,13 @@ export class HttpProvider {
  * @param {string} method - The HTTP method (e.g., "GET", "POST").
  * @param {string} [url] - The URL to send the request to. Defaults to the current page URL.
  * @param {*} [post] - The body to send with the request, if any.
- * @param {function(number, any, string|null, string, string): void} [callback] - Callback invoked when the request completes.
+ * @param {(status: number, response: any, headersString: string|null, statusText: string, xhrStatus: import("./interface.ts").HttpResponseStatus) => void} [callback] - Callback invoked when the request completes.
  * @param {Object<string, string|undefined>} [headers] - Headers to set on the request.
  * @param {number|Promise<any>} [timeout] - Timeout in ms or a cancellable promise.
  * @param {boolean} [withCredentials] - Whether to send credentials with the request.
  * @param {XMLHttpRequestResponseType} [responseType] - The type of data expected in the response.
- * @param {Record<string, EventListener>} [eventHandlers] - Event listeners for the XMLHttpRequest object.
- * @param {Record<string, EventListener>} [uploadEventHandlers] - Event listeners for the XMLHttpRequest.upload object.
+ * @param {ng.RequestConfig["eventHandlers"]} [eventHandlers] - Event listeners for the XMLHttpRequest object.
+ * @param {ng.RequestConfig["uploadEventHandlers"]} [uploadEventHandlers] - Event listeners for the XMLHttpRequest.upload object.
  * @returns {void}
  */
 export function http(
@@ -131,11 +128,11 @@ export function http(
   url?: string,
   post?: any,
   callback?: (
-    arg0: number,
-    arg1: any,
-    arg2: string | null,
-    arg3: string,
-    arg4: string,
+    status: number,
+    response: any,
+    headersString: string | null,
+    statusText: string,
+    xhrStatus: import("./interface.ts").HttpResponseStatus,
   ) => void,
   headers?: {
     [x: string]: string;
@@ -143,8 +140,8 @@ export function http(
   timeout?: number | Promise<any>,
   withCredentials?: boolean,
   responseType?: XMLHttpRequestResponseType,
-  eventHandlers?: Record<string, EventListener>,
-  uploadEventHandlers?: Record<string, EventListener>,
+  eventHandlers?: ng.RequestConfig["eventHandlers"],
+  uploadEventHandlers?: ng.RequestConfig["uploadEventHandlers"],
 ): void;
 export type Http = number;
 export namespace Http {

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

@@ -1,17 +1,10 @@
+import { Dict } from "../../shared/interface.ts";
 export interface HttpHeadersGetter {
   (): {
     [name: string]: string;
   };
   (headerName: string): string;
 }
-export interface HttpPromiseCallback<T> {
-  (
-    data: T,
-    status: number,
-    headers: HttpHeadersGetter,
-    config: RequestConfig,
-  ): void;
-}
 export interface HttpRequestConfigHeaders {
   [requestType: string]: any;
   common?: any;
@@ -71,7 +64,8 @@ export interface HttpProviderDefaults {
   /** 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.
+   * whether to to set the withCredentials flag on the XHR object.
+   * See [requests with credentials](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CORS#requests_with_credentials) for more information.
    */
   withCredentials?: boolean | undefined;
   /**
@@ -88,7 +82,8 @@ export interface HttpProviderDefaults {
 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.
+   * 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;
   /**
@@ -101,7 +96,7 @@ export interface RequestShortcutConfig extends HttpProviderDefaults {
    */
   timeout?: number | Promise<any> | undefined;
   /**
-   * See [XMLHttpRequest.responseType]https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest#xmlhttprequest-responsetype
+   * See [XMLHttpRequest.responseType](https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest#xmlhttprequest-responsetype)
    */
   responseType?: string | undefined;
 }
@@ -113,7 +108,7 @@ export interface RequestConfig extends RequestShortcutConfig {
   /**
    * HTTP method (e.g. 'GET', 'POST', etc)
    */
-  method: string;
+  method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "HEAD" | "OPTIONS";
   /**
    * Absolute or relative URL of the resource that is being requested.
    */
@@ -122,20 +117,12 @@ export interface RequestConfig extends RequestShortcutConfig {
    * 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;
+  eventHandlers?: Dict<EventListenerOrEventListenerObject>;
   /**
    * 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;
+  uploadEventHandlers?: Dict<EventListenerOrEventListenerObject>;
 }
 export type HttpResponseStatus = "complete" | "error" | "timeout" | "abort";
 export interface HttpResponse<T> {
@@ -148,7 +135,7 @@ export interface HttpResponse<T> {
 }
 export type HttpPromise<T> = Promise<HttpResponse<T>>;
 /**
- * HttpService
+ * $http service interface
  */
 export interface HttpService {
   /**
@@ -243,3 +230,4 @@ export interface HttpInterceptor {
 export interface HttpInterceptorFactory {
   (...args: any[]): HttpInterceptor;
 }
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD";

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

@@ -52,10 +52,7 @@ export interface UrlParts {
    * The parsed query string as an object.
    * Mirrors AngularJS’s `$location.setSearch()` format.
    */
-  search: Record<
-    string,
-    string | number | boolean | (string | number | boolean)[]
-  >;
+  search: Object;
   /**
    * The fragment identifier (everything after `#`, not including the `#` itself).
    */

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

@@ -161,6 +161,18 @@ export class Location {
     html5?: boolean,
     prefix?: string,
   );
+  /**
+   * @ignore
+   * Current url
+   * @type {string | undefined}
+   */
+  _url: string | undefined;
+  /**
+   * @ignore
+   * Callback to update browser url
+   * @type {Function | undefined}
+   */
+  _updateBrowser: Function | undefined;
   /** @type {string} */
   appBase: string;
   /** @type {string} */
@@ -177,18 +189,6 @@ export class Location {
    * @type {string}
    */
   absUrl: string;
-  /**
-   * @ignore
-   * Current url
-   * @type {string}
-   */
-  _url: string;
-  /**
-   * @ignore
-   * Callback to update browser url
-   * @type {Function | undefined}
-   */
-  _updateBrowser: Function | undefined;
   /**
    * Change path, search and hash, when called with parameter and return `$location`.
    *
@@ -324,7 +324,7 @@ export class LocationProvider {
     | string
     | ((
         $rootScope: ng.Scope,
-        $rootElement: Element,
+        $rootElement: HTMLElement,
         $exceptionHandler: ng.ExceptionHandlerService,
       ) => Location)
   )[];

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.
  *
@@ -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
     | ((