@league-of-foundry-developers/foundry-vtt-types 0.8.9-6 → 9.238.0

package/src/foundry/common/data/data.mjs/noteData.d.ts

@@ -1,58 +1,58 @@
-import { ConfiguredFlags, FieldReturnType, PropertiesToSource } from '../../../../types/helperTypes';
+import {
+  ConfiguredDocumentClass,
+  ConfiguredFlags,
+  FieldReturnType,
+  PropertiesToSource
+} from '../../../../types/helperTypes';
 import DocumentData from '../../abstract/data.mjs';
 import * as documents from '../../documents.mjs';
 import * as fields from '../fields.mjs';
 
 interface NoteDataSchema extends DocumentSchema {
-  _id: typeof fields.DOCUMENT_ID;
+  _id: fields.DocumentId;
   entryId: fields.ForeignDocumentField<{ type: typeof documents.BaseJournalEntry; required: false }>;
-  x: typeof fields.REQUIRED_NUMBER;
-  y: typeof fields.REQUIRED_NUMBER;
-  icon: FieldReturnType<
-    typeof fields.IMAGE_FIELD,
-    {
-      required: true;
-      default: typeof CONST.DEFAULT_NOTE_ICON;
-    }
-  >;
+  x: fields.RequiredNumber;
+  y: fields.RequiredNumber;
+  icon: FieldReturnType<fields.ImageField, { required: true; default: typeof NoteData.DEFAULT_ICON }>;
   iconSize: FieldReturnType<
-    typeof fields.REQUIRED_NUMBER,
+    fields.RequiredNumber,
     {
       default: 40;
       validate: (n: unknown) => n is number;
       validationError: 'Invalid {name} {field} which must be an integer greater than 32';
     }
   >;
-  iconTint: typeof fields.COLOR_FIELD;
-  text: typeof fields.STRING_FIELD;
+  iconTint: fields.ColorField;
+  text: fields.StringField;
   fontFamily: FieldReturnType<
-    typeof fields.REQUIRED_STRING,
+    fields.RequiredString,
     {
       default: () => typeof CONFIG['defaultFontFamily'];
     }
   >;
   fontSize: FieldReturnType<
-    typeof fields.REQUIRED_NUMBER,
+    fields.RequiredNumber,
     {
       default: 48;
       validate: (n: unknown) => n is number;
       validationError: 'Invalid {name} {field} which must be an integer between 8 and 128';
     }
   >;
-  textAnchor: DocumentField<number> & {
+  textAnchor: DocumentField<typeof foundry.CONST.TEXT_ANCHOR_POINTS> & {
     type: typeof Number;
     required: true;
-    default: typeof CONST.TEXT_ANCHOR_POINTS.BOTTOM;
-    validate: (p: unknown) => p is foundry.CONST.TextAnchorPoint;
+    default: typeof foundry.CONST.TEXT_ANCHOR_POINTS.BOTTOM;
+    validate: (p: unknown) => p is foundry.CONST.TEXT_ANCHOR_POINTS;
     validationError: 'Invalid {name} {field} which must be a value in CONST.TEXT_ANCHOR_POINTS';
   };
-  textColor: FieldReturnType<typeof fields.COLOR_FIELD, { default: '#FFFFFF' }>;
-  flags: typeof fields.OBJECT_FIELD;
+  textColor: FieldReturnType<fields.ColorField, { default: '#FFFFFF' }>;
+  flags: fields.ObjectField;
 }
 
 interface NoteDataProperties {
   /**
    * The _id which uniquely identifies this BaseNote embedded document
+   * @defaultValue `null`
    */
   _id: string | null;
 
@@ -76,6 +76,7 @@ interface NoteDataProperties {
 
   /**
    * An image icon path used to represent this note
+   * @defaultValue `CONST.DEFAULT_NOTE_ICON`
    */
   icon: string | null;
 
@@ -112,7 +113,7 @@ interface NoteDataProperties {
    * to the note icon.
    * @defaultValue `CONST.TEXT_ANCHOR_POINTS.BOTTOM`
    */
-  textAnchor: foundry.CONST.TextAnchorPoint;
+  textAnchor: foundry.CONST.TEXT_ANCHOR_POINTS;
 
   /**
    * The string that defines the color with which the note text is rendered
@@ -130,93 +131,102 @@ interface NoteDataProperties {
 interface NoteDataConstructorData {
   /**
    * The _id which uniquely identifies this BaseNote embedded document
+   * @defaultValue `null`
    */
-  _id?: string | null;
+  _id?: string | null | undefined;
 
   /**
    * The _id of a JournalEntry document which this Note represents
    * @defaultValue `null`
    */
-  entryId?: string | null;
+  entryId?: InstanceType<ConfiguredDocumentClass<typeof documents.BaseJournalEntry>> | string | null | undefined;
 
   /**
    * The x-coordinate position of the center of the note icon
    * @defaultValue `0`
    */
-  x?: number | null;
+  x?: number | null | undefined;
 
   /**
    * The y-coordinate position of the center of the note icon
    * @defaultValue `0`
    */
-  y?: number | null;
+  y?: number | null | undefined;
 
   /**
    * An image icon path used to represent this note
+   * @defaultValue `CONST.DEFAULT_NOTE_ICON`
    */
-  icon?: string | null;
+  icon?: string | null | undefined;
 
   /**
    * The pixel size of the map note icon
    * @defaultValue `40`
    */
-  iconSize?: number | null;
+  iconSize?: number | null | undefined;
 
   /**
    * An optional color string used to tint the map note icon
    */
-  iconTint?: string | null;
+  iconTint?: string | null | undefined;
 
   /**
    * Optional text which overrides the title of the linked Journal Entry
    */
-  text?: string | null;
+  text?: string | null | undefined;
 
   /**
    * The font family used to display the text label on this note
    * @defaultValue `CONFIG?.defaultFontFamily || "Signika"`
    */
-  fontFamily?: string | null;
+  fontFamily?: string | null | undefined;
 
   /**
    * The font size used to display the text label on this note
    * @defaultValue `48`
    */
-  fontSize?: number | null;
+  fontSize?: number | null | undefined;
 
   /**
    * A value in CONST.TEXT_ANCHOR_POINTS which defines where the text label anchors
    * to the note icon.
    * @defaultValue `CONST.TEXT_ANCHOR_POINTS.BOTTOM`
    */
-  textAnchor?: foundry.CONST.TextAnchorPoint | null;
+  textAnchor?: foundry.CONST.TEXT_ANCHOR_POINTS | null | undefined;
 
   /**
    * The string that defines the color with which the note text is rendered
    * @defaultValue `#FFFFFF`
    */
-  textColor?: string | null;
+  textColor?: string | null | undefined;
 
   /**
    * An object of optional key/value flags
    * @defaultValue `{}`
    */
-  flags?: ConfiguredFlags<'Note'> | null;
+  flags?: ConfiguredFlags<'Note'> | null | undefined;
 }
 
 /**
  * The data schema for a Note embedded document.
  * @see BaseNote
  */
-export declare class NoteData extends DocumentData<
+export class NoteData extends DocumentData<
   NoteDataSchema,
   NoteDataProperties,
   PropertiesToSource<NoteDataProperties>,
   NoteDataConstructorData,
   documents.BaseNote
 > {
+  /** @override */
   static defineSchema(): NoteDataSchema;
+
+  /**
+   * The default icon used for newly created Note documents.
+   * @defaultValue `"icons/svg/book.svg"`
+   */
+  static DEFAULT_ICON: string;
 }
 
 // eslint-disable-next-line @typescript-eslint/no-empty-interface
-export declare interface NoteData extends NoteDataProperties {}
+export interface NoteData extends NoteDataProperties {}

package/src/foundry/common/data/data.mjs/playlistData.d.ts

@@ -1,34 +1,41 @@
-import * as documents from '../../documents.mjs';
-import * as fields from '../fields.mjs';
-
 import type { ConfiguredDocumentClass, ConfiguredFlags, PropertiesToSource } from '../../../../types/helperTypes';
-import type EmbeddedCollection from '../../abstract/embedded-collection.mjs';
 import type DocumentData from '../../abstract/data.mjs';
+import type EmbeddedCollection from '../../abstract/embedded-collection.mjs';
+import * as documents from '../../documents.mjs';
+import * as fields from '../fields.mjs';
 
 interface PlaylistDataSchema extends DocumentSchema {
-  _id: typeof fields.DOCUMENT_ID;
-  name: typeof fields.REQUIRED_STRING;
-  description: typeof fields.BLANK_STRING;
+  _id: fields.DocumentId;
+  name: fields.RequiredString;
+  description: fields.BlankString;
   sounds: fields.EmbeddedCollectionField<typeof documents.BasePlaylistSound>;
-  mode: DocumentField<foundry.CONST.PlaylistMode> & {
+  mode: DocumentField<foundry.CONST.PLAYLIST_MODES> & {
     type: typeof Number;
     required: true;
-    default: typeof CONST.PLAYLIST_MODES.SEQUENTIAL;
-    validate: (m: unknown) => m is foundry.CONST.PlaylistMode;
+    default: typeof foundry.CONST.PLAYLIST_MODES.SEQUENTIAL;
+    validate: (m: unknown) => m is foundry.CONST.PLAYLIST_MODES;
     validationError: 'Invalid {name} {field} provided which must be a value from CONST.PLAYLIST_MODES';
   };
-  playing: typeof fields.BOOLEAN_FIELD;
-  fade: typeof fields.INTEGER_FIELD;
+  playing: fields.BooleanField;
+  fade: fields.IntegerField;
   folder: fields.ForeignDocumentField<{ type: typeof documents.BaseFolder }>;
-  sort: typeof fields.INTEGER_SORT_FIELD;
-  seed: typeof fields.NONNEGATIVE_INTEGER_FIELD;
-  permission: typeof fields.DOCUMENT_PERMISSIONS;
-  flags: typeof fields.OBJECT_FIELD;
+  sorting: DocumentField<foundry.CONST.PLAYLIST_SORT_MODES> & {
+    type: foundry.CONST.PLAYLIST_SORT_MODES;
+    required: true;
+    default: typeof foundry.CONST.PLAYLIST_SORT_MODES.ALPHABETICAL;
+    validate: (m: unknown) => m is foundry.CONST.PLAYLIST_SORT_MODES;
+    validationError: 'Invalid Playlist sorting mode';
+  };
+  sort: fields.IntegerSortField;
+  seed: fields.NonnegativeIntegerField;
+  permission: fields.DocumentPermissions;
+  flags: fields.ObjectField;
 }
 
 interface PlaylistDataProperties {
   /**
    * The _id which uniquely identifies this Playlist document
+   * @defaultValue `null`
    */
   _id: string | null;
 
@@ -38,12 +45,14 @@ interface PlaylistDataProperties {
   name: string;
 
   /**
-   * @defaultValue `''`
+   * The description of this playlist
+   * @defaultValue `""`
    */
   description: string;
 
   /**
    * A Collection of PlaylistSounds embedded documents which belong to this playlist
+   * @defaultValue `new EmbeddedCollection(PlaylistSoundData, [], BasePlaylistSound.implementation)`
    */
   sounds: EmbeddedCollection<ConfiguredDocumentClass<typeof documents.BasePlaylistSound>, PlaylistData>;
 
@@ -51,7 +60,7 @@ interface PlaylistDataProperties {
    * The playback mode for sounds in this playlist
    * @defaultValue `CONST.PLAYLIST_MODES.SEQUENTIAL`
    */
-  mode: foundry.CONST.PlaylistMode;
+  mode: foundry.CONST.PLAYLIST_MODES;
 
   /**
    * Is this playlist currently playing?
@@ -59,6 +68,7 @@ interface PlaylistDataProperties {
    */
   playing: boolean;
 
+  /** A duration in milliseconds to fade volume transition */
   fade: number | undefined;
 
   /**
@@ -67,19 +77,26 @@ interface PlaylistDataProperties {
    */
   folder: string | null;
 
+  /**
+   * The sorting mode used for this playlist.
+   * @defaultValue `CONST.PLAYLIST_SORT_MODES.ALPHABETICAL`
+   */
+  sorting: foundry.CONST.PLAYLIST_SORT_MODES;
+
   /**
    * The numeric sort value which orders this playlist relative to its siblings
    * @defaultValue `0`
    */
   sort: number;
 
+  /** A seed used for playlist randomization to guarantee that all clients generate the same random order. */
   seed: number | undefined;
 
   /**
    * An object which configures user permissions to this playlist
    * @defaultValue `{ default: CONST.ENTITY_PERMISSIONS.NONE }`
    */
-  permission: Record<string, foundry.CONST.EntityPermission>;
+  permission: Record<string, foundry.CONST.DOCUMENT_PERMISSION_LEVELS>;
 
   /**
    * An object of optional key/value flags
@@ -91,6 +108,7 @@ interface PlaylistDataProperties {
 interface PlaylistDataConstructorData {
   /**
    * The _id which uniquely identifies this Playlist document
+   * @defaultValue `null`
    */
   _id?: string | null | undefined;
 
@@ -100,12 +118,14 @@ interface PlaylistDataConstructorData {
   name: string;
 
   /**
-   * @defaultValue `''`
+   * The description of this playlist
+   * @defaultValue `""`
    */
   description?: string | null | undefined;
 
   /**
    * A Collection of PlaylistSounds embedded documents which belong to this playlist
+   * @defaultValue `new EmbeddedCollection(PlaylistSoundData, [], BasePlaylistSound.implementation)`
    */
   sounds?:
     | EmbeddedCollection<ConfiguredDocumentClass<typeof documents.BasePlaylistSound>, PlaylistData>
@@ -116,7 +136,7 @@ interface PlaylistDataConstructorData {
    * The playback mode for sounds in this playlist
    * @defaultValue `CONST.PLAYLIST_MODES.SEQUENTIAL`
    */
-  mode?: foundry.CONST.PlaylistMode | null | undefined;
+  mode?: foundry.CONST.PLAYLIST_MODES | null | undefined;
 
   /**
    * Is this playlist currently playing?
@@ -124,13 +144,20 @@ interface PlaylistDataConstructorData {
    */
   playing?: boolean | null | undefined;
 
-  fade?: number | undefined | null;
+  /** A duration in milliseconds to fade volume transition */
+  fade?: number | null | undefined;
 
   /**
    * The _id of a Folder which contains this playlist
    * @defaultValue `null`
    */
-  folder?: string | null | undefined;
+  folder?: InstanceType<ConfiguredDocumentClass<typeof documents.BaseFolder>> | string | null | undefined;
+
+  /**
+   * The sorting mode used for this playlist.
+   * @defaultValue `CONST.PLAYLIST_SORT_MODES.ALPHABETICAL`
+   */
+  sorting?: foundry.CONST.PLAYLIST_SORT_MODES | null | undefined;
 
   /**
    * The numeric sort value which orders this playlist relative to its siblings
@@ -138,13 +165,14 @@ interface PlaylistDataConstructorData {
    */
   sort?: number | null | undefined;
 
-  seed?: number | undefined | null;
+  /** A seed used for playlist randomization to guarantee that all clients generate the same random order. */
+  seed?: number | null | undefined;
 
   /**
    * An object which configures user permissions to this playlist
    * @defaultValue `{ default: CONST.ENTITY_PERMISSIONS.NONE }`
    */
-  permission?: Record<string, foundry.CONST.EntityPermission> | undefined | null;
+  permission?: Record<string, foundry.CONST.DOCUMENT_PERMISSION_LEVELS> | null | undefined;
 
   /**
    * An object of optional key/value flags
@@ -157,13 +185,14 @@ interface PlaylistDataConstructorData {
  * The data schema for a Playlist document.
  * @see BasePlaylist
  */
-export declare class PlaylistData extends DocumentData<
+export class PlaylistData extends DocumentData<
   PlaylistDataSchema,
   PlaylistDataProperties,
   PropertiesToSource<PlaylistDataProperties>,
   PlaylistDataConstructorData,
   documents.BasePlaylist
 > {
+  /** @override */
   static defineSchema(): PlaylistDataSchema;
 }
 

package/src/foundry/common/data/data.mjs/playlistSoundData.d.ts

@@ -1,24 +1,26 @@
-import * as fields from '../fields.mjs';
 import type { ConfiguredFlags, FieldReturnType, PropertiesToSource } from '../../../../types/helperTypes';
 import type DocumentData from '../../abstract/data.mjs';
 import type { documents } from '../../module.mjs';
+import * as fields from '../fields.mjs';
 
 interface PlaylistSoundDataSchema extends DocumentSchema {
-  _id: typeof fields.DOCUMENT_ID;
-  name: typeof fields.REQUIRED_STRING;
-  description: typeof fields.BLANK_STRING;
-  path: typeof fields.AUDIO_FIELD;
-  playing: typeof fields.BOOLEAN_FIELD;
-  pausedTime: FieldReturnType<typeof fields.NUMERIC_FIELD, { default: null }>;
-  repeat: typeof fields.BOOLEAN_FIELD;
-  volume: FieldReturnType<typeof fields.ALPHA_FIELD, { default: 0.5 }>;
-  fade: typeof fields.INTEGER_FIELD;
-  flags: typeof fields.OBJECT_FIELD;
+  _id: fields.DocumentId;
+  name: fields.RequiredString;
+  description: fields.BlankString;
+  path: fields.AudioField;
+  playing: fields.BooleanField;
+  pausedTime: FieldReturnType<fields.NumericField, { default: null }>;
+  repeat: fields.BooleanField;
+  volume: FieldReturnType<fields.AlphaField, { default: 0.5 }>;
+  fade: fields.IntegerField;
+  sort: fields.IntegerSortField;
+  flags: fields.ObjectField;
 }
 
 interface PlaylistSoundDataProperties {
   /**
    * The _id which uniquely identifies this PlaylistSound document
+   * @defaultValue `null`
    */
   _id: string | null;
 
@@ -28,14 +30,15 @@ interface PlaylistSoundDataProperties {
   name: string;
 
   /**
-   * @defaultValue `''`
+   * The description of this sound track
+   * @defaultValue `""`
    */
   description: string;
 
   /**
    * The audio file path that is played by this sound
    */
-  path: string | undefined | null;
+  path: string | null | undefined;
 
   /**
    * Is this sound currently playing?
@@ -44,6 +47,7 @@ interface PlaylistSoundDataProperties {
   playing: boolean;
 
   /**
+   * The time in seconds at which playback was paused
    * @defaultValue `null`
    */
   pausedTime: number | null;
@@ -60,8 +64,12 @@ interface PlaylistSoundDataProperties {
    */
   volume: number;
 
+  /** A duration in milliseconds to fade volume transition */
   fade: number | undefined;
 
+  /** @defaultValue `0` */
+  sort: number;
+
   /**
    * An object of optional key/value flags
    * @defaultValue `{}`
@@ -72,6 +80,7 @@ interface PlaylistSoundDataProperties {
 interface PlaylistSoundDataConstructorData {
   /**
    * The _id which uniquely identifies this PlaylistSound document
+   * @defaultValue `null`
    */
   _id?: string | null | undefined;
 
@@ -81,14 +90,15 @@ interface PlaylistSoundDataConstructorData {
   name: string;
 
   /**
-   * @defaultValue `''`
+   * The description of this sound track
+   * @defaultValue `""`
    */
   description?: string | null | undefined;
 
   /**
    * The audio file path that is played by this sound
    */
-  path?: string | undefined | null;
+  path?: string | null | undefined;
 
   /**
    * Is this sound currently playing?
@@ -97,6 +107,7 @@ interface PlaylistSoundDataConstructorData {
   playing?: boolean | null | undefined;
 
   /**
+   * The time in seconds at which playback was paused
    * @defaultValue `null`
    */
   pausedTime?: number | null | undefined;
@@ -113,8 +124,12 @@ interface PlaylistSoundDataConstructorData {
    */
   volume?: number | null | undefined;
 
+  /** A duration in milliseconds to fade volume transition */
   fade?: number | null | undefined;
 
+  /** @defaultValue `0` */
+  sort: number | null | undefined;
+
   /**
    * An object of optional key/value flags
    * @defaultValue `{}`
@@ -126,13 +141,14 @@ interface PlaylistSoundDataConstructorData {
  * The data schema for a PlaylistSound embedded document.
  * @see BasePlaylistSound
  */
-export declare class PlaylistSoundData extends DocumentData<
+export class PlaylistSoundData extends DocumentData<
   PlaylistSoundDataSchema,
   PlaylistSoundDataProperties,
   PropertiesToSource<PlaylistSoundDataProperties>,
   PlaylistSoundDataConstructorData,
   documents.BasePlaylistSound
 > {
+  /** @override */
   static defineSchema(): PlaylistSoundDataSchema;
 
   /** @override */

package/src/foundry/common/data/data.mjs/prototypeTokenData.d.ts

@@ -17,9 +17,9 @@ type FieldExclusions =
   | 'hidden';
 
 interface PrototypeTokenDataSchema extends Omit<TokenDataSchema, FieldExclusions> {
-  randomImg: typeof fields.BOOLEAN_FIELD;
+  randomImg: fields.BooleanField;
   img: FieldReturnType<
-    typeof fields.VIDEO_FIELD,
+    fields.VideoField,
     { default: typeof foundry.CONST.DEFAULT_TOKEN; validate: (src: unknown) => boolean }
   >;
 }
@@ -38,18 +38,18 @@ interface PrototypeTokenDataProperties extends Omit<TokenDataProperties, FieldEx
   img: string | null;
 }
 
-export interface PrototypeTokenDataConstructorData extends Omit<TokenDataConstructorData, FieldExclusions> {
+interface PrototypeTokenDataConstructorData extends Omit<TokenDataConstructorData, FieldExclusions> {
   /**
    * Uses a random "wildcard" image path which is resolved with a Token is created
    * @defaultValue `false`
    */
-  randomImg?: boolean | null;
+  randomImg?: boolean | null | undefined;
 
   /**
    * A file path to an image or video file used to depict the Token
    * @defaultValue `CONST.DEFAULT_TOKEN`
    */
-  img?: string | null;
+  img?: string | null | undefined;
 }
 
 export class PrototypeTokenData extends DocumentData<
@@ -59,14 +59,10 @@ export class PrototypeTokenData extends DocumentData<
   PrototypeTokenDataConstructorData,
   documents.BaseActor
 > {
-  /**
-   * @override
-   */
+  /** @override */
   _initialize(): void;
 
-  /**
-   * @override
-   */
+  /** @override */
   toObject(source?: true): ReturnType<this['toJSON']> & { actorId: documents.BaseActor['id'] };
   toObject(source: false): {
     [Key in keyof PrototypeTokenDataSchema as string extends Key ? never : Key]: Key extends keyof this