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

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

@@ -6,7 +6,7 @@ import type AbstractFormInputElement from "./form-element.d.mts";
  * Multi-select components return an array of values as part of form submission.
  * Different implementations may provide different experiences around how inputs are presented to the user.
  */
-export class AbstractMultiSelectElement extends AbstractFormInputElement<Set<string> | string[]> {
+export abstract class AbstractMultiSelectElement extends AbstractFormInputElement<Set<string> | string[]> {
   constructor();
 
   protected _value: Set<string>;
@@ -61,14 +61,18 @@ export class AbstractMultiSelectElement extends AbstractFormInputElement<Set<str
  * ```
  */
 export class HTMLMultiSelectElement extends AbstractMultiSelectElement {
-  /**
-   * Create a HTMLMultiSelectElement using provided configuration data.
-   */
-  static create(config: FormInputConfig<string[]> & Omit<SelectInputConfig, "blank">): HTMLMultiSelectElement;
+  static override tagName: "multi-select";
 
   protected override _buildElements(): (HTMLDivElement | HTMLSelectElement)[];
 
+  protected override _refresh(): void;
+
   protected override _toggleDisabled(disabled: boolean): void;
+
+  /**
+   * Create a HTMLMultiSelectElement using provided configuration data.
+   */
+  static create(config: FormInputConfig<string[]> & Omit<SelectInputConfig, "blank">): HTMLMultiSelectElement;
 }
 /**
  * Provide a multi-select workflow as a grid of input checkbox elements.
@@ -89,7 +93,13 @@ export class HTMLMultiSelectElement extends AbstractMultiSelectElement {
  * ```
  */
 export class HTMLMultiCheckboxElement extends AbstractMultiSelectElement {
+  static override tagName: "multi-checkbox";
+
   protected override _buildElements(): (HTMLFieldSetElement | HTMLLabelElement)[];
 
+  protected override _refresh(): void;
+
+  protected override _activateListeners(): void;
+
   protected override _toggleDisabled(disabled: boolean): void;
 }

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

@@ -60,7 +60,7 @@ declare class HTMLStringTagsElement extends AbstractFormInputElement<Set<string>
   /**
    * Create a HTMLStringTagsElement using provided configuration data.
    */
-  static create(config: HTMLStringTagsElement.StringTagsInputConfig): HTMLElement;
+  static create(config: HTMLStringTagsElement.StringTagsInputConfig): HTMLStringTagsElement;
 }
 
 declare namespace HTMLStringTagsElement {

package/src/foundry/client-esm/applications/forms/fields.d.mts

@@ -1,4 +1,4 @@
-import type { NullishProps } from "../../../../types/utils.d.mts";
+import type { NullishProps } from "fvtt-types/utils";
 
 export type CustomFormGroup = (
   field: foundry.data.fields.DataField,

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

@@ -1,7 +1,7 @@
 // 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 ActorSheetV2 } from "./actor-sheet.mjs";
 export { default as AmbientSoundConfig } from "./ambient-sound-config.mjs";

package/src/foundry/client-esm/applications/sheets/actor-sheet.d.mts

@@ -1,4 +1,4 @@
-import type { AnyObject, EmptyObject } from "../../../../types/utils.d.mts";
+import type { AnyObject, EmptyObject } from "fvtt-types/utils";
 import type ApplicationV2 from "../api/application.d.mts";
 import type DocumentSheetV2 from "../api/document-sheet.d.mts";
 
@@ -8,9 +8,9 @@ import type DocumentSheetV2 from "../api/document-sheet.d.mts";
 export default class ActorSheetV2<
   RenderContext extends AnyObject = EmptyObject,
   Configuration extends
-    DocumentSheetV2.Configuration<Actor.ConfiguredInstance> = DocumentSheetV2.Configuration<Actor.ConfiguredInstance>,
+    DocumentSheetV2.Configuration<Actor.Implementation> = DocumentSheetV2.Configuration<Actor.Implementation>,
   RenderOptions extends DocumentSheetV2.RenderOptions = DocumentSheetV2.RenderOptions,
-> extends DocumentSheetV2<Actor.ConfiguredInstance, RenderContext, Configuration, RenderOptions> {
+> extends DocumentSheetV2<Actor.Implementation, RenderContext, Configuration, RenderOptions> {
   /**
    * The Actor document managed by this sheet.
    */

package/src/foundry/client-esm/applications/sheets/ambient-light-config.d.mts

@@ -1,5 +1,4 @@
-import type { InterfaceToObject } from "../../../../types/helperTypes.d.mts";
-import type { AnyObject, DeepPartial } from "../../../../types/utils.d.mts";
+import type { InterfaceToObject, AnyObject, DeepPartial } from "fvtt-types/utils";
 import type ApplicationV2 from "../api/application.d.mts";
 import type DocumentSheetV2 from "../api/document-sheet.d.mts";
 import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts";
@@ -10,22 +9,24 @@ import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts
 declare class AmbientLightConfig<
   RenderContext extends AnyObject = InterfaceToObject<AmbientLightConfig.RenderContext>,
   Configuration extends
-    DocumentSheetV2.Configuration<AmbientLightDocument.ConfiguredInstance> = DocumentSheetV2.Configuration<AmbientLightDocument.ConfiguredInstance>,
-  RenderOptions extends DocumentSheetV2.RenderOptions = DocumentSheetV2.RenderOptions,
+    DocumentSheetV2.Configuration<AmbientLightDocument.Implementation> = DocumentSheetV2.Configuration<AmbientLightDocument.Implementation>,
+  RenderOptions extends
+    HandlebarsApplicationMixin.DocumentSheetV2RenderOptions = HandlebarsApplicationMixin.DocumentSheetV2RenderOptions,
 > extends HandlebarsApplicationMixin(DocumentSheetV2)<
-  AmbientLightDocument.ConfiguredInstance,
+  AmbientLightDocument.Implementation,
   RenderContext,
   Configuration,
   RenderOptions
 > {
-  static override DEFAULT_OPTIONS: DeepPartial<DocumentSheetV2.Configuration<AmbientLightDocument.ConfiguredInstance>>;
+  static override DEFAULT_OPTIONS: object &
+    DocumentSheetV2.PartialConfiguration<DocumentSheetV2.Configuration<AmbientLightDocument.Implementation>>;
 
   static override PARTS: Record<string, HandlebarsApplicationMixin.HandlebarsTemplatePart>;
 
   /**
    * Maintain a copy of the original to show a real-time preview of changes.
    */
-  preview: AmbientLightDocument.ConfiguredInstance | undefined;
+  preview: AmbientLightDocument.Implementation | undefined;
 
   override tabGroups: {
     sheet: string;
@@ -36,6 +37,7 @@ declare class AmbientLightConfig<
     options: DeepPartial<RenderOptions>,
   ): Promise<void>;
 
+  // eslint-disable-next-line @typescript-eslint/no-misused-promises
   protected override _onRender(context: DeepPartial<RenderContext>, options: DeepPartial<RenderOptions>): Promise<void>;
 
   protected override _onClose(options: DeepPartial<RenderOptions>): void;
@@ -65,7 +67,7 @@ declare class AmbientLightConfig<
 
 declare namespace AmbientLightConfig {
   interface RenderContext {
-    light: AmbientLightDocument.ConfiguredInstance;
+    light: AmbientLightDocument.Implementation;
     source: foundry.documents.BaseAmbientLight.Source;
     fields: foundry.documents.BaseAmbientLight.Schema;
     colorationTechniques: (typeof AdaptiveLightingShader)["SHADER_TECHNIQUES"];

package/src/foundry/client-esm/applications/sheets/ambient-sound-config.d.mts

@@ -1,5 +1,4 @@
-import type { InterfaceToObject } from "../../../../types/helperTypes.d.mts";
-import type { AnyObject, DeepPartial } from "../../../../types/utils.d.mts";
+import type { InterfaceToObject, AnyObject, DeepPartial } from "fvtt-types/utils";
 import type ApplicationV2 from "../api/application.d.mts";
 import type DocumentSheetV2 from "../api/document-sheet.d.mts";
 import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts";
@@ -10,15 +9,17 @@ import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts
 declare class AmbientSoundConfig<
   RenderContext extends AnyObject = InterfaceToObject<AmbientSoundConfig.RenderContext>,
   Configuration extends
-    DocumentSheetV2.Configuration<AmbientSoundDocument.ConfiguredInstance> = DocumentSheetV2.Configuration<AmbientSoundDocument.ConfiguredInstance>,
-  RenderOptions extends DocumentSheetV2.RenderOptions = DocumentSheetV2.RenderOptions,
+    DocumentSheetV2.Configuration<AmbientSoundDocument.Implementation> = DocumentSheetV2.Configuration<AmbientSoundDocument.Implementation>,
+  RenderOptions extends
+    HandlebarsApplicationMixin.DocumentSheetV2RenderOptions = HandlebarsApplicationMixin.DocumentSheetV2RenderOptions,
 > extends HandlebarsApplicationMixin(DocumentSheetV2)<
-  AmbientSoundDocument.ConfiguredInstance,
+  AmbientSoundDocument.Implementation,
   RenderContext,
   Configuration,
   RenderOptions
 > {
-  static override DEFAULT_OPTIONS: DeepPartial<DocumentSheetV2.Configuration<AmbientSoundDocument.ConfiguredInstance>>;
+  static override DEFAULT_OPTIONS: object &
+    DocumentSheetV2.PartialConfiguration<DocumentSheetV2.Configuration<AmbientSoundDocument.Implementation>>;
 
   static override PARTS: Record<string, HandlebarsApplicationMixin.HandlebarsTemplatePart>;
 
@@ -26,6 +27,7 @@ declare class AmbientSoundConfig<
 
   protected override _prepareContext(options: DeepPartial<RenderOptions>): Promise<RenderContext>;
 
+  // eslint-disable-next-line @typescript-eslint/no-misused-promises
   protected override _onRender(context: DeepPartial<RenderContext>, options: DeepPartial<RenderOptions>): Promise<void>;
 
   protected override _onClose(options: DeepPartial<RenderOptions>): void;
@@ -40,7 +42,7 @@ declare class AmbientSoundConfig<
 
 declare namespace AmbientSoundConfig {
   interface RenderContext {
-    sound: AmbientSoundDocument.ConfiguredInstance;
+    sound: AmbientSoundDocument.Implementation;
     source: foundry.documents.BaseAmbientSound.Source;
     fields: foundry.documents.BaseAmbientSound.Schema;
     gridUnits: string;

package/src/foundry/client-esm/applications/sheets/item-sheet.d.mts

@@ -1,4 +1,4 @@
-import type { AnyObject, EmptyObject } from "../../../../types/utils.d.mts";
+import type { AnyObject, EmptyObject } from "fvtt-types/utils";
 import type DocumentSheetV2 from "../api/document-sheet.d.mts";
 
 /**
@@ -7,9 +7,9 @@ import type DocumentSheetV2 from "../api/document-sheet.d.mts";
 export default class ItemSheetV2<
   RenderContext extends AnyObject = EmptyObject,
   Configuration extends
-    DocumentSheetV2.Configuration<Item.ConfiguredInstance> = DocumentSheetV2.Configuration<Item.ConfiguredInstance>,
+    DocumentSheetV2.Configuration<Item.Implementation> = DocumentSheetV2.Configuration<Item.Implementation>,
   RenderOptions extends DocumentSheetV2.RenderOptions = DocumentSheetV2.RenderOptions,
-> extends DocumentSheetV2<Item.ConfiguredInstance, RenderContext, Configuration, RenderOptions> {
+> extends DocumentSheetV2<Item.Implementation, RenderContext, Configuration, RenderOptions> {
   /**
    * The Item document managed by this sheet.
    */

package/src/foundry/client-esm/applications/sheets/region-behavior-config.d.mts

@@ -1,4 +1,5 @@
-import type { AnyObject, EmptyObject } from "../../../../types/utils.d.mts";
+import type { AnyObject, DeepPartial, EmptyObject } from "fvtt-types/utils";
+import type { FormFooterButton, FormNode } from "../_types.d.mts";
 import type DocumentSheetV2 from "../api/document-sheet.d.mts";
 import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts";
 
@@ -6,8 +7,32 @@ import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts
  * The Scene Region configuration application.
  */
 export default class RegionBehaviorConfig<
-  Document extends foundry.abstract.Document.Any,
   RenderContext extends AnyObject = EmptyObject,
-  Configuration extends DocumentSheetV2.Configuration<Document> = DocumentSheetV2.Configuration<Document>,
-  RenderOptions extends DocumentSheetV2.RenderOptions = DocumentSheetV2.RenderOptions,
-> extends HandlebarsApplicationMixin(DocumentSheetV2)<Document, RenderContext, Configuration, RenderOptions> {}
+  Configuration extends
+    DocumentSheetV2.Configuration<RegionBehavior.Implementation> = DocumentSheetV2.Configuration<RegionBehavior.Implementation>,
+  RenderOptions extends
+    HandlebarsApplicationMixin.DocumentSheetV2RenderOptions = HandlebarsApplicationMixin.DocumentSheetV2RenderOptions,
+> extends HandlebarsApplicationMixin(DocumentSheetV2)<
+  RegionBehavior.Implementation,
+  RenderContext,
+  Configuration,
+  RenderOptions
+> {
+  constructor(options: DeepPartial<Configuration> & { document: Document });
+
+  static override DEFAULT_OPTIONS: object &
+    DocumentSheetV2.PartialConfiguration<DocumentSheetV2.Configuration<RegionBehavior.Implementation>>;
+  static override PARTS: Record<string, HandlebarsApplicationMixin.HandlebarsTemplatePart>;
+
+  protected override _prepareContext(
+    options: DeepPartial<RenderOptions> & { isFirstRender: boolean },
+  ): Promise<RenderContext>;
+
+  /** Prepare form field structure for rendering. */
+  protected _getFields(): FormNode[];
+
+  /** Get footer buttons for this behavior config sheet. */
+  _getButtons(): FormFooterButton[];
+
+  #regionBehaviorConfig: true;
+}

package/src/foundry/client-esm/applications/sheets/region-config.d.mts

@@ -1,4 +1,4 @@
-import type { AnyObject, EmptyObject } from "../../../../types/utils.d.mts";
+import type { AnyObject, DeepPartial, EmptyObject } from "fvtt-types/utils";
 import type DocumentSheetV2 from "../api/document-sheet.d.mts";
 import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts";
 
@@ -6,8 +6,39 @@ import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts
  * The Scene Region configuration application.
  */
 export default class RegionConfig<
-  Document extends foundry.abstract.Document.Any,
   RenderContext extends AnyObject = EmptyObject,
-  Configuration extends DocumentSheetV2.Configuration<Document> = DocumentSheetV2.Configuration<Document>,
-  RenderOptions extends DocumentSheetV2.RenderOptions = DocumentSheetV2.RenderOptions,
-> extends HandlebarsApplicationMixin(DocumentSheetV2)<Document, RenderContext, Configuration, RenderOptions> {}
+  Configuration extends
+    DocumentSheetV2.Configuration<RegionDocument.Implementation> = DocumentSheetV2.Configuration<RegionDocument.Implementation>,
+  RenderOptions extends
+    HandlebarsApplicationMixin.DocumentSheetV2RenderOptions = HandlebarsApplicationMixin.DocumentSheetV2RenderOptions,
+> extends HandlebarsApplicationMixin(DocumentSheetV2)<
+  RegionDocument.Implementation,
+  RenderContext,
+  Configuration,
+  RenderOptions
+> {
+  static override DEFAULT_OPTIONS: object &
+    DocumentSheetV2.PartialConfiguration<DocumentSheetV2.Configuration<RegionDocument.Implementation>>;
+  static override PARTS: Record<string, HandlebarsApplicationMixin.HandlebarsTemplatePart>;
+
+  override tabGroups: {
+    /** @defaultValue `"identity"` */
+    sheet: string;
+  };
+
+  protected override _prepareContext(
+    options: DeepPartial<RenderOptions> & { isFirstRender: boolean },
+  ): Promise<RenderContext>;
+
+  protected override _preparePartContext(
+    partId: string,
+    context: HandlebarsApplicationMixin.HandlebarsApplication.RenderContextFor<this>,
+    options: DeepPartial<RenderOptions>,
+  ): Promise<HandlebarsApplicationMixin.HandlebarsApplication.RenderContextFor<this>>;
+
+  protected override _onRender(context: DeepPartial<RenderContext>, options: DeepPartial<RenderOptions>): void;
+
+  protected override _onClose(options: DeepPartial<RenderOptions>): void;
+
+  #regionConfig: true;
+}

package/src/foundry/client-esm/applications/sheets/user-config.d.mts

@@ -1,5 +1,4 @@
-import type { InterfaceToObject } from "../../../../types/helperTypes.d.mts";
-import type { AnyObject, DeepPartial } from "../../../../types/utils.d.mts";
+import type { InterfaceToObject, AnyObject, DeepPartial } from "fvtt-types/utils";
 import type DocumentSheetV2 from "../api/document-sheet.d.mts";
 import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts";
 import type { CustomFormGroup } from "../forms/fields.d.mts";
@@ -10,15 +9,17 @@ import type { CustomFormGroup } from "../forms/fields.d.mts";
 declare class UserConfig<
   RenderContext extends AnyObject = InterfaceToObject<UserConfig.RenderContext>,
   Configuration extends
-    DocumentSheetV2.Configuration<User.ConfiguredInstance> = DocumentSheetV2.Configuration<User.ConfiguredInstance>,
-  RenderOptions extends DocumentSheetV2.RenderOptions = DocumentSheetV2.RenderOptions,
+    DocumentSheetV2.Configuration<User.Implementation> = DocumentSheetV2.Configuration<User.Implementation>,
+  RenderOptions extends
+    HandlebarsApplicationMixin.DocumentSheetV2RenderOptions = HandlebarsApplicationMixin.DocumentSheetV2RenderOptions,
 > extends HandlebarsApplicationMixin(DocumentSheetV2)<
-  User.ConfiguredInstance,
+  User.Implementation,
   RenderContext,
   Configuration,
   RenderOptions
 > {
-  static override DEFAULT_OPTIONS: DocumentSheetV2.Configuration<User.ConfiguredInstance>;
+  static override DEFAULT_OPTIONS: object &
+    DocumentSheetV2.PartialConfiguration<DocumentSheetV2.Configuration<User.Implementation>>;
 
   static override PARTS: Record<string, HandlebarsApplicationMixin.HandlebarsTemplatePart>;
 
@@ -34,7 +35,7 @@ declare class UserConfig<
 
 declare namespace UserConfig {
   interface RenderContext {
-    user: User.ConfiguredInstance;
+    user: User.Implementation;
     source: foundry.documents.BaseUser.Source;
     fields: foundry.documents.BaseUser.Schema;
     characterWidget: CustomFormGroup;

package/src/foundry/client-esm/applications/ui/_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 RegionLegend } from "./region-legend.mjs";

package/src/foundry/client-esm/applications/ui/region-legend.d.mts

@@ -1,4 +1,4 @@
-import type { AnyObject, EmptyObject } from "../../../../types/utils.d.mts";
+import type { AnyObject, DeepPartial, EmptyObject } from "fvtt-types/utils";
 import type ApplicationV2 from "../api/application.d.mts";
 import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts";
 
@@ -8,5 +8,47 @@ import type HandlebarsApplicationMixin from "../api/handlebars-application.d.mts
 export default class RegionLegend<
   RenderContext extends AnyObject = EmptyObject,
   Configuration extends ApplicationV2.Configuration = ApplicationV2.Configuration,
-  RenderOptions extends ApplicationV2.RenderOptions = ApplicationV2.RenderOptions,
-> extends HandlebarsApplicationMixin(ApplicationV2)<RenderContext, Configuration, RenderOptions> {}
+  RenderOptions extends
+    HandlebarsApplicationMixin.ApplicationV2RenderOptions = HandlebarsApplicationMixin.ApplicationV2RenderOptions,
+> extends HandlebarsApplicationMixin(ApplicationV2)<RenderContext, Configuration, RenderOptions> {
+  #RegionLegend: true;
+
+  static override DEFAULT_OPTIONS: DeepPartial<ApplicationV2.Configuration> & object;
+  static override PARTS: Record<string, HandlebarsApplicationMixin.HandlebarsTemplatePart>;
+
+  /** The currently viewed elevation range. */
+  elevation: { bottom: number; top: number };
+
+  protected override _configureRenderOptions(options: DeepPartial<RenderOptions>): void;
+
+  protected override _canRender(options: DeepPartial<RenderOptions>): false | void;
+
+  protected override _renderFrame(options: DeepPartial<RenderOptions>): Promise<HTMLElement>;
+
+  override close(options?: DeepPartial<ApplicationV2.ClosingOptions>): Promise<this>;
+
+  protected override _onFirstRender(context: DeepPartial<RenderContext>, options: DeepPartial<RenderOptions>): void;
+
+  protected override _onRender(context: DeepPartial<RenderContext>, options: DeepPartial<RenderOptions>): void;
+
+  protected override _onClose(options: DeepPartial<RenderOptions>): void;
+
+  protected override _prepareContext(
+    options: DeepPartial<RenderOptions> & { isFirstRender: boolean },
+  ): Promise<RenderContext>;
+
+  /**
+   * Is this Region visible in this RegionLegend?
+   * @param region - The Region
+   * @internal
+   */
+  _isRegionVisible(region: RegionDocument.Implementation): boolean;
+
+  /**
+   * Highlight a hovered region in the legend.
+   * @param region  - The Region
+   * @param hover   - Whether they are being hovered in or out
+   * @internal
+   */
+  _hoverRegion(region: RegionDocument.Implementation, hover: boolean): void;
+}

package/src/foundry/client-esm/audio/_module.d.mts

@@ -1,8 +1,7 @@
 // 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 */
-/* eslint-disable import/no-unresolved */ // TODO: Remove when the files are instantiated
+// While `.mts` could work, to avoid `import-x/no-unresolved` from erroring `.mjs` is used.
+/* eslint-disable import-x/extensions */
 
 export * as types from "./_types.mjs";
 export { default as AudioBufferCache } from "./cache.mjs";

package/src/foundry/client-esm/audio/_types.d.mts

@@ -1,3 +1,5 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+
 export {};
 
 // After seeing that none of these types add anything or are even exported a

package/src/foundry/client-esm/audio/biquad.d.mts

@@ -1,4 +1,4 @@
-import type { InexactPartial } from "../../../types/utils.d.mts";
+import type { Identity, InexactPartial, NullishProps } from "fvtt-types/utils";
 
 /**
  * A sound effect which applies a biquad filter.
@@ -9,22 +9,8 @@ declare class BiquadFilterEffect extends BiquadFilterNode {
    * @param context - The audio context required by the BiquadFilterNode
    * @param options - Additional options which modify the BiquadFilterEffect behavior
    */
-  constructor(
-    context: AudioContext,
-    options?: InexactPartial<{
-      /**
-       * The filter type to apply
-       * @defaultValue `"lowpass"`
-       */
-      type: BiquadFilterType;
-
-      /**
-       * The initial intensity of the effect
-       * @defaultValue `5`
-       */
-      intensity: number;
-    }>,
-  );
+  // options: not null (destructured)
+  constructor(context: AudioContext, options?: BiquadFilterEffect.ConstructorOptions);
 
   /**
    * Adjust the intensity of the effect on a scale of 0 to 10
@@ -36,16 +22,80 @@ declare class BiquadFilterEffect extends BiquadFilterNode {
   /**
    * Update the state of the effect node given the active flag and numeric intensity.
    * @param options - Options which are updated
+   * @throws If `type` is set to any value in {@link BiquadFilterEffect.AllowedFilterType} other than `"highpass"` or `"lowpass"`
    */
-  update(
-    options?: InexactPartial<{
-      /** A new effect intensity */
-      intensity: number;
-
-      /** A new filter type */
-      type: BiquadFilterType;
-    }>,
-  ): void;
+  // options: not null (destructured)
+  update(options?: BiquadFilterEffect.UpdateOptions): void;
+}
+
+declare namespace BiquadFilterEffect {
+  interface Any extends AnyBiquadFilterEffect {}
+  interface AnyConstructor extends Identity<typeof AnyBiquadFilterEffect> {}
+
+  /**
+   * @internal
+   * Foundry keeps this specific list in a private static property of {@link BiquadFilterEffect | `BiquadFilterEffect`}.
+   * It is typed as it is to make obvious where it comes from.
+   *
+   * @privateRemarks An `Exclude` would have been shorter but for all we know the lib type might change, this is reliable
+   */
+  type AspirationalAllowedFilterType = Extract<
+    "lowpass" | "highpass" | "bandpass" | "lowshelf" | "highshelf" | "peaking" | "notch",
+    BiquadFilterType
+  >;
+
+  /**
+   * @remarks Despite `BiquadFilterEffect.#ALLOWED_TYPES` containing everything in the Aspirational
+   * type, the runtime logic will throw on anything but these two values
+   */
+  type AllowedFilterType = Extract<"highpass" | "lowpass", AspirationalAllowedFilterType>;
+
+  /** @internal */
+  type _ConstructorOptions = InexactPartial<{
+    /**
+     * The initial intensity of the effect
+     * @defaultValue `5`
+     * @remarks Can't be `null` as it only has a parameter default
+     */
+    intensity: number;
+
+    /**
+     * The filter type to apply
+     * @defaultValue `"lowpass"`
+     * @remarks Can't be `null` as it only has a parameter default.
+     *
+     * Only allows a subset of {@link BiquadFilterType | `BiquadFilterType`}s
+     */
+    type: AllowedFilterType;
+  }>;
+
+  /**
+   * @privateRemarks The {@link BiquadFilterEffect | `BiquadFilterEffect`} constructor only adds the one
+   * new property (`intensity`) to the parent interface. `type` is omitted and reimplemented to allow
+   * explicit `undefined`, as there's a parameter default available, and limit to Foundry's allowed values
+   */
+  interface ConstructorOptions extends _ConstructorOptions, Omit<BiquadFilterOptions, "type"> {}
+
+  type _UpdateOptions = NullishProps<{
+    /**
+     * A new effect intensity
+     * @remarks This is ignored if it fails a `Number.isFinite` check
+     */
+    intensity: number;
+
+    /**
+     * A new filter type
+     * @see {@link BiquadFilterEffect.AllowedFilterType | `BiquadFilterEffect.AllowedFilterType`}
+     * @see {@link BiquadFilterEffect.AspirationalAllowedFilterType | `BiquadFilterEffect.AspirationalAllowedFilterType`}
+     */
+    type: AllowedFilterType;
+  }>;
+
+  interface UpdateOptions extends _UpdateOptions {}
 }
 
 export default BiquadFilterEffect;
+
+declare abstract class AnyBiquadFilterEffect extends BiquadFilterEffect {
+  constructor(...args: never);
+}

package/src/foundry/client-esm/audio/cache.d.mts

@@ -1,22 +1,4 @@
-declare namespace AudioBufferCache {
-  interface Entry {
-    src: string;
-    buffer: AudioBuffer;
-    size: number;
-    locked?: boolean;
-    next?: Entry;
-    previous?: Entry;
-  }
-
-  interface Usage {
-    current: number;
-    max: number;
-    pct: number;
-    currentString: string;
-    maxString: string;
-    pctString: string;
-  }
-}
+import type { Identity } from "../../../utils/index.d.mts";
 
 /**
  * A specialized cache used for audio buffers.
@@ -39,7 +21,7 @@ declare class AudioBufferCache extends Map {
    * @param src - The audio buffer source path
    * @returns The cached audio buffer, or undefined
    */
-  getBuffer(src: string): AudioBuffer;
+  getBuffer(src: string): AudioBuffer | undefined;
 
   /**
    * Insert an AudioBuffer into the buffers cache.
@@ -60,9 +42,38 @@ declare class AudioBufferCache extends Map {
    * @param src    - The audio buffer source path
    * @param locked - Lock the buffer, preventing its expiration?
    */
+  // locked: not null (put directly into an Entry)
   lock(src: string, locked?: boolean): void;
 
   override toString(): string;
 }
 
+declare namespace AudioBufferCache {
+  interface Any extends AnyAudioBufferCache {}
+  interface AnyConstructor extends Identity<typeof AnyAudioBufferCache> {}
+
+  interface Entry {
+    src: string;
+    buffer: AudioBuffer;
+    size: number;
+    locked?: boolean;
+    next?: Entry;
+    previous?: Entry;
+  }
+
+  /** Return type of {@link AudioBufferCache.usage | `AudioBufferCache#usage`} */
+  interface Usage {
+    current: number;
+    max: number;
+    pct: number;
+    currentString: string;
+    maxString: string;
+    pctString: string;
+  }
+}
+
 export default AudioBufferCache;
+
+declare abstract class AnyAudioBufferCache extends AudioBufferCache {
+  constructor(...args: never);
+}