@league-of-foundry-developers/foundry-vtt-types 12.331.3-beta → 13.340.0

package/src/foundry/client-esm/applications/apps/file-picker.d.mts

@@ -0,0 +1,410 @@
+import type { AnyObject, DeepPartial } from "../../../../utils/index.d.mts";
+import type ApplicationV2 from "../api/application.d.mts";
+import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts";
+import type { FormSelectOption } from "../forms/fields.d.mts";
+
+declare namespace FilePicker {
+  interface RenderContext extends ApplicationV2.RenderContext {
+    bucket: string | null;
+    buckets: FormSelectOption[] | null;
+    canGoBack: boolean;
+    canUpload: boolean;
+    canSelect: boolean;
+    dirs: FolderContext[];
+    displayMode: DisplayMode;
+    extensions: string[];
+    files: FileContext[];
+    isS3: boolean;
+    noResults: boolean;
+    selected: string;
+    source: SourceInfo | S3SourceInfo;
+    sources: Sources;
+    target: string;
+    tileSize: number | null;
+    user: User.ConfiguredInstance;
+    favorites: Record<string, FilePicker.FavoriteFolder>;
+    buttons: ApplicationV2.FormFooterButton[];
+  }
+
+  interface FolderContext {
+    name: string;
+    path: string;
+    private: boolean;
+  }
+
+  interface FileContext {
+    name: string;
+    url: string;
+    img: string;
+  }
+
+  interface Configuration extends ApplicationV2.Configuration {
+    /**
+     * A type of file to target.
+     * @defaultValue `"any"`
+     */
+    type?: Type;
+
+    /** The current file path being modified, if any. */
+    current?: string;
+
+    /**
+     * A current file source in "data", "public", or "s3".
+     * @defaultValue `"data"`
+     */
+    activeSource?: SourceType;
+
+    /** A callback function to trigger once a file has been selected. */
+    callback?: Callback;
+
+    /**
+     * A flag which permits explicitly disallowing upload, true by default.
+     * @defaultValue `true`
+     */
+    allowUpload?: boolean;
+
+    /** An HTML form field that the result of this selection is applied to. */
+    field?: HTMLElement;
+
+    /** An HTML button element which triggers the display of this picker. */
+    button?: HTMLButtonElement;
+
+    /** The picker display mode in FilePicker.DISPLAY_MODES. */
+    displayMode?: string;
+
+    /** The picker display mode in FilePicker.DISPLAY_MODES. */
+    favorites?: Record<string, FavoriteFolder>;
+
+    /**
+     * Display the tile size configuration.
+     * @defaultValue `false`
+     */
+    tileSize?: boolean;
+
+    /** Redirect to the root directory rather than starting in the source directory of one of these files. */
+    redirectToRoot?: string[] | null | undefined;
+  }
+
+  interface FavoriteFolder {
+    /** The source of the folder (e.g. "data", "public") */
+    source: string;
+
+    /** The full path to the folder */
+    path: string;
+
+    /** The label for the path */
+    label: string;
+  }
+
+  type Type = "image" | "audio" | "video" | "text" | "imagevideo" | "font" | "folder" | "any";
+
+  type SourceType = keyof Sources;
+
+  interface SourceInfo {
+    target: string;
+  }
+
+  interface S3SourceInfo extends SourceInfo {
+    bucket: string;
+    buckets: string[];
+  }
+
+  interface Sources {
+    data: SourceInfo;
+    public: SourceInfo;
+    s3?: S3SourceInfo;
+  }
+
+  type Callback = (path: string, picker: FilePicker) => void;
+
+  type DisplayMode = "list" | "thumbs" | "tiles" | "images";
+
+  interface BrowseOptions {
+    /** A bucket within which to search if using the S3 source */
+    bucket?: string;
+
+    /** An Array of file extensions to filter on */
+    extensions?: string[];
+
+    /** The requested dir represents a wildcard path */
+    wildcard?: boolean;
+  }
+
+  interface UploadOptions {
+    /**
+     * Display a UI notification when the upload is processed
+     * @defaultValue `true`
+     * @remarks `null` equivalent to `false`
+     */
+    notify?: boolean | undefined | null;
+  }
+
+  // Unknown if these are all possible properties
+  interface BrowseReturn {
+    dirs: string[];
+    extensions: string[];
+    files: string[];
+    gridSize: number | null;
+    private: boolean;
+    privateDirs: string[];
+    target: string;
+  }
+
+  // Unknown if these are all possible properties
+  interface ConfigurePathReturn {
+    private?: boolean;
+  }
+
+  interface UploadBody extends AnyObject {}
+}
+
+/**
+ * The FilePicker application renders contents of the server-side public directory.
+ * This app allows for navigating and uploading files to the public path.
+ */
+declare class FilePicker<
+  RenderContext extends FilePicker.RenderContext = FilePicker.RenderContext,
+  Configuration extends FilePicker.Configuration = FilePicker.Configuration,
+  RenderOptions extends
+    HandlebarsApplicationMixin.ApplicationV2RenderOptions = HandlebarsApplicationMixin.ApplicationV2RenderOptions,
+> extends HandlebarsApplicationMixin(ApplicationV2)<RenderContext, Configuration, RenderOptions> {
+  /**
+   * The full requested path given by the user
+   * @defaultValue `""`
+   */
+  request: string;
+
+  /**
+   * A callback function to trigger once a file has been selected
+   * @defaultValue `null`
+   */
+  callback: FilePicker.Callback | null;
+
+  type: FilePicker.Type;
+
+  /**
+   * The target HTML element this file picker is bound to
+   * @defaultValue `null`
+   */
+  field: HTMLElement | null;
+
+  /**
+   * A button controlling the display of the picker UI
+   * @defaultValue `null`
+   */
+  button: HTMLElement | null;
+
+  /**
+   * The display mode of the FilePicker UI
+   * @defaultValue `FilePicker.LAST_DISPLAY_MODE`
+   */
+  displayMode: string;
+
+  /**
+   * The file sources available for browsing
+   */
+  sources: FilePicker.Sources;
+
+  /**
+   * Track the active source tab which is being browsed
+   */
+  activeSource: FilePicker.SourceType;
+
+  static override PARTS: Record<string, HandlebarsApplicationMixin.HandlebarsTemplatePart>;
+
+  static override TABS: Record<string, ApplicationV2.TabsConfiguration>;
+
+  /**
+   * The allowed values for the type of this FilePicker instance.
+   * @defaultValue `["image", "audio", "video", "text", "imagevideo", "font", "folder", "any"]`
+   */
+  static FILE_TYPES: FilePicker.Type[];
+
+  /**
+   * Record the last-browsed directory path so that re-opening a different FilePicker instance uses the same target
+   */
+  static LAST_BROWSED_DIRECTORY: FilePicker.SourceType;
+
+  /**
+   * Record the last-configured display mode so that re-opening a different FilePicker instance uses the same mode.
+   * @defaultValue `"list"`
+   */
+  static LAST_DISPLAY_MODE: FilePicker.DisplayMode;
+
+  /**
+   * Enumerate the allowed FilePicker display modes
+   * @defaultValue `["list", "thumbs", "tiles", "images"]`
+   */
+  static DISPLAY_MODES: FilePicker.DisplayMode[];
+
+  /**
+   * Cache the names of S3 buckets which can be used
+   * @defaultValue `null`
+   */
+  static S3_BUCKETS: string[] | null;
+
+  /**
+   * Return the upload URL to which the FilePicker should post uploaded files
+   */
+  static get uploadURL(): string;
+
+  /**
+   * The latest set of results browsed from the server
+   */
+  results: AnyObject;
+
+  /**
+   * The current set of file extensions which are being filtered upon
+   */
+  extensions: FilePicker.Type[];
+
+  /**
+   * Get favorite folders for quick access
+   */
+  get favorites(): Record<string, FilePicker.FavoriteFolder>;
+
+  override get title(): string;
+
+  /**
+   * Return the source object for the currently active source
+   */
+  get source(): FilePicker.SourceType | FilePicker.S3SourceInfo;
+
+  /**
+   * Return the target directory for the currently active source
+   */
+  get target(): string;
+
+  /**
+   * Return a flag for whether the current user is able to upload file content
+   */
+  get canUpload(): boolean;
+
+  /**
+   * Test a URL to see if it matches a well known s3 key pattern
+   * @param url - An input URL to test
+   * @returns A regular expression match
+   */
+  static matchS3URL(url: string): RegExpMatchArray | null;
+
+  /**
+   * Browse files for a certain directory location
+   * @param source  - The source location in which to browse: see FilePicker#sources for details.
+   * @param target  - The target within the source location
+   * @param options - Optional arguments
+   *                  (default: `{}`)
+   */
+  // not: null
+  static browse(source: string, target: string, options?: FilePicker.BrowseOptions): Promise<FilePicker.BrowseReturn>;
+
+  /**
+   * Configure metadata settings regarding a certain file system path
+   * @param source  - The source location in which to browse: see FilePicker#sources for details.
+   * @param target  - The target within the source location
+   * @param options - Optional arguments modifying the request
+   *                  (default: `{}`)
+   */
+  // not: null
+  static configurePath(
+    source: string,
+    target: string,
+    options?: FilePicker.BrowseOptions,
+  ): Promise<FilePicker.ConfigurePathReturn>;
+
+  /**
+   * Create a subdirectory within a given source. The requested subdirectory path must not already exist.
+   * @param source  - The source location in which to browse: see FilePicker#sources for details.
+   * @param target  - The target within the source location
+   * @param options - Optional arguments which modify the request
+   *                  (default: `{}`)
+   * @returns The full file path of the created directory
+   */
+  // not: null
+  static createDirectory(source: string, target: string, options?: FilePicker.BrowseOptions): Promise<string>;
+
+  /**
+   * Dispatch a POST request to the server containing a directory path and a file to upload
+   * @param source  - The data source to which the file should be uploaded
+   * @param path    - The destination path
+   * @param file    - The File object to upload
+   * @param body    - Additional file upload options sent in the POST body
+   *                  (default: `{}`)
+   * @param options - Additional options to configure how the method behaves
+   *                  (default: `{}`)
+   * @returns The response object
+   */
+  // not: null
+  static upload(
+    source: string,
+    path: string,
+    file: File,
+    body?: FilePicker.UploadBody,
+    options?: FilePicker.UploadOptions,
+  ): Promise<Response>;
+
+  /**
+   * A convenience function that uploads a file to a given package's persistent /storage/ directory
+   * @param packageId - The id of the package to which the file should be uploaded. Only supports Systems and Modules.
+   * @param path      - The relative destination path in the package's storage directory
+   * @param file      - The File object to upload
+   * @param body      - Additional file upload options sent in the POST body
+   *                    (default: `{}`)
+   * @param options   - Additional options to configure how the method behaves
+   *                    (default: `{}`)
+   * @returns The response object
+   */
+  // not: null
+  static uploadPersistent(
+    packageId: string,
+    path: string,
+    file: File,
+    body?: FilePicker.UploadBody,
+    options?: FilePicker.UploadOptions,
+  ): Promise<Response>;
+
+  /**
+   * Browse to a specific location for this FilePicker instance
+   * @param target  - The target within the currently active source location.
+   * @param options - Browsing options
+   *                  (default: `{}`)
+   */
+  // not: null
+  browse(target?: string, options?: FilePicker.BrowseOptions): Promise<this>;
+
+  // Render is overridden for no signature change but omitted here to simplify the deprecation
+
+  protected override _prepareContext(
+    options: DeepPartial<RenderOptions> & { isFirstRender: boolean },
+  ): Promise<RenderContext>;
+
+  protected override _prepareTabs(group: string): Record<string, ApplicationV2.Tab>;
+
+  override changeTab(tab: string, group: string, options?: ApplicationV2.ChangeTabOptions): void;
+
+  protected override _onRender(context: DeepPartial<RenderContext>, options: DeepPartial<RenderOptions>): Promise<void>;
+
+  /**
+   * Handle changes to the tile size.
+   * @param event - The triggering event.
+   */
+  protected _onChangeTileSize(event: Event): void;
+
+  /**
+   * Search among shown directories and files.
+   * @param event - The triggering event
+   * @param query - The search input value
+   */
+  protected _onSearchFilter(event: KeyboardEvent, query: string, rgx: RegExp, html: HTMLElement): void;
+
+  /**
+   * Bind the file picker to a new target field.
+   * Assumes the user will provide a HTMLButtonElement which has the data-target and data-type attributes
+   * The data-target attribute should provide the name of the input field which should receive the selected file
+   * The data-type attribute is a string in ["image", "audio"] which sets the file extensions which will be accepted
+   *
+   * @param button - The button element
+   */
+  static fromButton(button: HTMLButtonElement): FilePicker;
+}
+
+export default FilePicker;

package/src/foundry/client-esm/applications/apps/grid-config.d.mts

@@ -0,0 +1,25 @@
+import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts";
+import type DocumentSheetV2 from "../api/document-sheet.d.mts";
+
+/**
+ * A tool for fine-tuning the grid in a Scene
+ * @remarks TODO: Stub
+ */
+declare class GridConfig<
+  RenderContext extends GridConfig.RenderContext = GridConfig.RenderContext,
+  Configuration extends
+    DocumentSheetV2.Configuration<Scene.ConfiguredInstance> = DocumentSheetV2.Configuration<Scene.ConfiguredInstance>,
+  RenderOptions extends
+    HandlebarsApplicationMixin.DocumentSheetV2RenderOptions = HandlebarsApplicationMixin.DocumentSheetV2RenderOptions,
+> extends HandlebarsApplicationMixin(DocumentSheetV2)<
+  Scene.ConfiguredInstance,
+  RenderContext,
+  Configuration,
+  RenderOptions
+> {}
+
+declare namespace GridConfig {
+  interface RenderContext extends DocumentSheetV2.RenderContext<Scene.ConfiguredInstance> {}
+}
+
+export default GridConfig;

package/src/foundry/client-esm/applications/apps/image-popout.d.mts

@@ -0,0 +1,56 @@
+import type { DeepPartial } from "../../../../utils/index.d.mts";
+import type ApplicationV2 from "../api/application.d.mts";
+import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts";
+
+/**
+ * An Image Popout Application which features a single image in a lightbox style frame.
+ * Furthermore, this application allows for sharing the display of an image with other connected players.
+ *
+ * @example Creating an Image Popout
+ * ```js
+ * // Construct the Application instance
+ * const ip = new ImagePopout({
+ *   src: "path/to/image.jpg",
+ *   uuid: game.actors.getName("My Hero").uuid
+ *   window: {title: "My Featured Image"}
+ * });
+ *
+ * // Display the image popout
+ * ip.render(true);
+ *
+ * // Share the image with other connected players
+ * ip.shareImage();
+ * ```
+ * @remarks TODO: Stub
+ */
+declare class ImagePopout<
+  RenderContext extends ImagePopout.RenderContext = ImagePopout.RenderContext,
+  Configuration extends ImagePopout.Configuration = ImagePopout.Configuration,
+  RenderOptions extends
+    HandlebarsApplicationMixin.ApplicationV2RenderOptions = HandlebarsApplicationMixin.ApplicationV2RenderOptions,
+> extends HandlebarsApplicationMixin(ApplicationV2)<RenderContext, Configuration, RenderOptions> {
+  constructor(options: DeepPartial<Configuration> & { src: string });
+}
+
+declare namespace ImagePopout {
+  interface RenderContext extends ApplicationV2.RenderContext {}
+
+  interface Configuration extends ApplicationV2.Configuration {
+    /** The URL to the image or video file */
+    src: string;
+
+    /** Caption text to display below the image. */
+    caption: string;
+
+    /**
+     * The UUID of some related {@link foundry.abstract.Document|`Document`}.
+     * @defaultValue `null`
+     */
+    uuid: string | null | undefined;
+
+    /** Force showing or hiding the title */
+    showTitle?: boolean | null | undefined;
+  }
+}
+
+export default ImagePopout;

package/src/foundry/client-esm/applications/apps/permission-config.d.mts

@@ -1,6 +1,5 @@
-import type { ConformRecord, InterfaceToObject, MustConform } from "../../../../types/helperTypes.d.mts";
-import type { DeepPartial } from "../../../../types/utils.d.mts";
-import type { UserPermission } from "../../../common/constants.d.mts";
+import type { ConformRecord, InterfaceToObject, MustConform, DeepPartial } from "fvtt-types/utils";
+import type { UserPermission } from "@common/constants.d.mts";
 import type { CONST } from "../../client.d.mts";
 import type ApplicationV2 from "../api/application.d.mts";
 import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts";
@@ -15,7 +14,8 @@ type PermissionConfigParts = ConformRecord<PermissionConfig.Parts, HandlebarsApp
 declare class PermissionConfig<
   RenderContext extends PermissionConfigRenderContext = PermissionConfigRenderContext,
   Configuration extends ApplicationV2.Configuration = ApplicationV2.Configuration,
-  RenderOptions extends ApplicationV2.RenderOptions = ApplicationV2.RenderOptions,
+  RenderOptions extends
+    HandlebarsApplicationMixin.ApplicationV2RenderOptions = HandlebarsApplicationMixin.ApplicationV2RenderOptions,
 > extends HandlebarsApplicationMixin(ApplicationV2)<RenderContext, Configuration, RenderOptions> {
   // placeholder private member to help subclassing
   #permissionConfig: true;

package/src/foundry/client-esm/applications/dice/_module.d.mts

@@ -1,6 +1,6 @@
 // In Foundry itself this file contains re-exports of these other modules.
 // Therefore it has a runtime effect and uses `.mjs` instead of `.d.mts`.
-// While `.mts` could work, to avoid `import/no-unresolved` from erroring `.mjs` is used.
-/* eslint-disable import/extensions */
+// While `.mts` could work, to avoid `import-x/no-unresolved` from erroring `.mjs` is used.
+/* eslint-disable import-x/extensions */
 
 export { default as RollResolver } from "./roll-resolver.mjs";

package/src/foundry/client-esm/applications/dice/roll-resolver.d.mts

@@ -1,4 +1,4 @@
-import type { AnyObject, DeepPartial, EmptyObject, InexactPartial } from "../../../../types/utils.d.mts";
+import type { AnyObject, DeepPartial, EmptyObject, InexactPartial } from "fvtt-types/utils";
 import type ApplicationV2 from "../api/application.d.mts";
 import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts";
 
@@ -9,7 +9,8 @@ import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts
 declare class RollResolver<
   RenderContext extends AnyObject = EmptyObject,
   Configuration extends ApplicationV2.Configuration = ApplicationV2.Configuration,
-  RenderOptions extends ApplicationV2.RenderOptions = ApplicationV2.RenderOptions,
+  RenderOptions extends
+    HandlebarsApplicationMixin.ApplicationV2RenderOptions = HandlebarsApplicationMixin.ApplicationV2RenderOptions,
 > extends HandlebarsApplicationMixin(ApplicationV2)<RenderContext, Configuration, RenderOptions> {
   constructor(roll: Roll, options?: DeepPartial<Configuration>);
 
@@ -87,6 +88,9 @@ declare class RollResolver<
 }
 
 declare namespace RollResolver {
+  type Any = AnyRollResolver;
+  type AnyConstructor = typeof AnyRollResolver;
+
   interface DiceTermFulfillmentDescriptor {
     id: string;
     term: foundry.dice.terms.DiceTerm;
@@ -95,4 +99,12 @@ declare namespace RollResolver {
   }
 }
 
+declare abstract class AnyRollResolver extends RollResolver<
+  AnyObject,
+  ApplicationV2.Configuration,
+  ApplicationV2.RenderOptions
+> {
+  constructor(arg0: never, ...args: never[]);
+}
+
 export default RollResolver;

package/src/foundry/client-esm/applications/elements/_module.d.mts

@@ -1,11 +1,14 @@
 // In Foundry itself this file contains re-exports of these other modules.
 // Therefore it has a runtime effect and uses `.mjs` instead of `.d.mts`.
-// While `.mts` could work, to avoid `import/no-unresolved` from erroring `.mjs` is used.
-/* eslint-disable import/extensions */
+// While `.mts` could work, to avoid `import-x/no-unresolved` from erroring `.mjs` is used.
+/* eslint-disable import-x/extensions */
 
 export { default as AbstractFormInputElement } from "./form-element.mjs";
+export { default as HTMLCodeMirrorElement } from "./codemirror/element.mjs";
 export { default as HTMLColorPickerElement } from "./color-picker.mjs";
+export { default as HTMLDocumentEmbedElement } from "./document-embed.mjs";
 export { default as HTMLDocumentTagsElement } from "./document-tags.mjs";
+export { default as HTMLEnrichedContentElement } from "./enriched-content.mjs";
 export { default as HTMLFilePickerElement } from "./file-picker.mjs";
 export { default as HTMLHueSelectorSlider } from "./hue-slider.mjs";
 export { default as HTMLRangePickerElement } from "./range-picker.mjs";

package/src/foundry/client-esm/applications/elements/codemirror/element.d.mts

@@ -0,0 +1,16 @@
+import type AbstractFormInputElement from "../form-element.d.mts";
+
+declare namespace HTMLCodeMirrorElement {
+  interface Options {
+    /** The initial editor contents. */
+    value?: string | null | undefined;
+  }
+}
+
+/**
+ * A custom HTML element responsible for displaying a CodeMirror rich text editor.
+ * @remarks TODO: Stub
+ */
+declare class HTMLCodeMirrorElement extends AbstractFormInputElement<string> {}
+
+export default HTMLCodeMirrorElement;

package/src/foundry/client-esm/applications/elements/codemirror/extensions.d.mts

@@ -0,0 +1,20 @@
+import type { Extension } from "@codemirror/state";
+
+/**
+ * CodeMirror language extensions
+ * @remarks TODO: Stub
+ */
+export const LANGUAGES: Record<string, Extension[]>;
+
+/**
+ * CodeMirror HTML tag classes for parsed language tokens
+ * @remarks TODO: Stub
+ */
+export const HIGHLIGHT_STYLE: Extension;
+
+/**
+ * Configure extensions for managing indentation via keypress.
+ * @param spaces - The number of spaces added/removed per press of TAB/SHIFT-TAB
+ * @remarks TODO: Stub
+ */
+export function configureIndentExtensions(spaces: number): Extension[];

package/src/foundry/client-esm/applications/elements/codemirror/view.d.mts

@@ -0,0 +1,8 @@
+import type { EditorView } from "codemirror";
+
+/** A CodeMirror EditorView that doesn't mount styles */
+// @ts-expect-error EditorViewFVTT is not ever publicly exposed; it's only used in the hard-private `#view` property on HTMLCodeMirrorElement
+// The error comes from `mountStyles` being marked private in EditorView, but since it's not hard private Foundry is nevertheless able to override
+export default class EditorViewFVTT extends EditorView {
+  override mountStyles(): void;
+}

package/src/foundry/client-esm/applications/elements/document-embed.d.mts

@@ -0,0 +1,14 @@
+/**
+ * A custom HTMLElement that is used to wrap enriched content that requires additional interactivity.
+ */
+export default class HTMLDocumentEmbedElement extends HTMLElement {
+  /**
+   * The HTML tag named used by this element.
+   */
+  static tagName: "document-embed";
+
+  /**
+   * Invoke the Document#onEmbed callback when it is added to the DOM.
+   */
+  connectedCallback(): void;
+}

package/src/foundry/client-esm/applications/elements/document-tags.d.mts

@@ -7,6 +7,8 @@ import type AbstractFormInputElement from "./form-element.d.mts";
 declare class HTMLDocumentTagsElement extends AbstractFormInputElement<Record<string, string> | string | string[]> {
   constructor();
 
+  static override tagName: "document-tags";
+
   protected _value: Record<string, string>;
 
   set type(value: string);

package/src/foundry/client-esm/applications/elements/enriched-content.d.mts

@@ -0,0 +1,29 @@
+/**
+ * A custom HTMLElement that is used to wrap enriched content that requires additional interactivity.
+ */
+export default class HTMLEnrichedContentElement extends HTMLElement {
+  /**
+   * The HTML tag named used by this element.
+   */
+  static tagName: "enriched-content";
+
+  /**
+   * Attributes requiring change notifications
+   */
+  static observedAttributes: string[];
+
+  #private: true;
+
+  /**
+   * Invoke the enricher onRender callback when it is added to the DOM.
+   */
+  connectedCallback(): void;
+
+  /**
+   * Fire a callback on change to an observed attribute.
+   * @param attrName - The name of the attribute
+   * @param oldValue - The old value: null indicates the attribute was not present.
+   * @param newValue - The new value: null indicates the attribute is removed.
+   */
+  attributeChangedCallback(attrName: string, oldValue: string | null, newValue: string | null): void;
+}