@league-of-foundry-developers/foundry-vtt-types 13.340.0 → 13.345.1-beta.20250704.94554

package/src/foundry/client/pixi/layers/controls/ruler.d.mts

@@ -1,475 +0,0 @@
-import type { NullishProps, ValueOf } from "fvtt-types/utils";
-
-declare global {
-  /**
-   * The Ruler - used to measure distances and trigger movements
-   */
-  class Ruler extends PIXI.Container {
-    /**
-     * @param user    - The User for whom to construct the Ruler instance
-     *                  (default: `game.user`)
-     * @param options - Additional options
-     */
-    constructor(
-      user?: User.ConfiguredInstance,
-      options?: NullishProps<{
-        /**
-         * The color of the ruler (defaults to the color of the User)
-         */
-        color?: number;
-      }>,
-    );
-
-    /**
-     * Record the User which this Ruler references
-     * @defaultValue `game.user`
-     */
-    user: User.ConfiguredInstance;
-
-    /**
-     * The ruler name - used to differentiate between players
-     * @defaultValue `"Ruler." + user.id`
-     */
-    name: string;
-
-    /**
-     * The ruler color - by default the color of the active user
-     * @defaultValue `foundry.utils.colorStringToHex(this.user.data.color) || 0x42F4E2`
-     */
-    color: Color;
-
-    /**
-     * The Ruler element is a Graphics instance which draws the line and points of the measured path
-     */
-    ruler: PIXI.Graphics;
-
-    /**
-     * The Labels element is a Container of Text elements which label the measured path
-     */
-    labels: PIXI.Container;
-
-    /**
-     * The possible Ruler measurement states.
-     */
-    static get STATES(): Ruler.STATES;
-
-    /**
-     * Is the ruler ready for measure?
-     */
-    static get canMeasure(): boolean;
-
-    /**
-     * The current destination point at the end of the measurement
-     * @defaultValue `null`
-     */
-    destination: Canvas.Point | null;
-
-    /**
-     * The origin point of the measurement, which is the first waypoint.
-     * @defaultValue `null`
-     */
-    get origin(): Canvas.Point | null;
-
-    /**
-     * This Array tracks individual waypoints along the ruler's measured path.
-     * The first waypoint is always the origin of the route.
-     * @defaultValue `[]`
-     */
-    waypoints: Canvas.Point[];
-
-    /**
-     * The array of most recently computed ruler measurement segments
-     * @defaultValue `[]`
-     */
-    segments: Ruler.MeasurementSegment[];
-
-    /**
-     * The measurement history.
-     */
-    get history(): Ruler.MeasurementHistory;
-
-    /**
-     * The computed total distance of the Ruler.
-     * @defaultValue `0`
-     */
-    totalDistance: number;
-
-    /**
-     * The computed total cost of the Ruler.
-     * @defaultValue `0`
-     */
-    totalCost: number;
-
-    /**
-     * The current state of the Ruler (one of {@link Ruler.STATES}).
-     */
-    get state(): ValueOf<Ruler.STATES>;
-
-    /**
-     * The current state of the Ruler (one of {@link Ruler.STATES}).
-     * @defaultValue `Ruler.STATES.INACTIVE`
-     */
-    protected _state: ValueOf<Ruler.STATES>;
-
-    /**
-     * Is the Ruler being actively used to measure distance?
-     */
-    get active(): boolean;
-
-    /**
-     * Get a GridHighlight layer for this Ruler
-     */
-    get highlightLayer(): GridHighlight;
-
-    /**
-     * The Token that is moved by the Ruler.
-     */
-    get token(): Token.ConfiguredInstance | null;
-
-    /**
-     * Clear display of the current Ruler
-     */
-    clear(): void;
-
-    /**
-     * Measure the distance between two points and render the ruler UI to illustrate it
-     * @param destination - The destination point to which to measure
-     * @param options     - Additional options
-     * @returns The array of measured segments if measured
-     */
-    measure(
-      destination: Canvas.Point,
-      options?: NullishProps<{
-        /**
-         * Snap the destination?
-         * @defaultValue `true`
-         */
-        snap: boolean;
-
-        /**
-         * If not forced and the destination matches the current destination of this ruler, no measuring is done and nothing is returned
-         * @defaultValue `false`
-         */
-        force: boolean;
-      }>,
-    ): Ruler.MeasurementSegment[] | void;
-
-    /**
-     * Get the measurement origin.
-     * @param point   - The waypoint
-     * @param options - Additional options
-     */
-    protected _getMeasurementOrigin(
-      point: Canvas.Point,
-      options?: NullishProps<{
-        /**
-         * Snap the waypoint?
-         * @defaultValue `true`
-         */
-        snap: boolean;
-      }>,
-    ): Canvas.Point;
-
-    /**
-     * While measurement is in progress, update the destination to be the central point of the target grid space.
-     * @param point   - The point coordinates
-     * @param options - Additional options
-     * @returns The snapped destination point
-     */
-    protected _getMeasurementDestination(
-      point: Canvas.Point,
-      options?: NullishProps<{
-        /**
-         * Snap the point?
-         * @defaultValue `true`
-         */
-        snap: boolean;
-      }>,
-    ): Canvas.Point;
-
-    /**
-     * Translate the waypoints and destination point of the Ruler into an array of Ray segments.
-     * @returns The segments of the measured path
-     */
-    protected _getMeasurementSegments(): Ruler.MeasurementSegment[];
-
-    /**
-     * Handle the start of a Ruler measurement workflow
-     * @param origin  - The origin
-     * @param options - Additional options
-     */
-    protected _startMeasurement(
-      origin: Canvas.Point,
-      options?: NullishProps<{
-        /**
-         * Snap the origin?
-         * @defaultValue `true`
-         */
-        snap: boolean;
-
-        /**
-         * The token that is moved (defaults to {@link Ruler#_getMovementToken})
-         */
-        token: Token.ConfiguredInstance | null;
-      }>,
-    ): void;
-
-    /**
-     * Handle the conclusion of a Ruler measurement workflow
-     */
-    protected _endMeasurement(): void;
-
-    /**
-     * Handle the addition of a new waypoint in the Ruler measurement path
-     * @param point   - The waypoint
-     * @param options - Additional options
-     */
-    protected _addWaypoint(
-      point: Canvas.Point,
-      options?: NullishProps<{
-        /**
-         * Snap the waypoint?
-         * @defaultValue `true`
-         */
-        snap: boolean;
-      }>,
-    ): void;
-
-    /**
-     * Handle the removal of a waypoint in the Ruler measurement path
-     */
-    protected _removeWaypoint(): void;
-
-    /**
-     * Get the cost function to be used for Ruler measurements.
-     */
-    protected _getCostFunction(): foundry.grid.BaseGrid.MeasurePathCostFunction | void;
-
-    /**
-     * Compute the distance of each segment and the total distance of the measured path.
-     */
-    protected _computeDistance(): void;
-
-    /**
-     * Get the text label for a segment of the measured path
-     */
-    protected _getSegmentLabel(segment: Ruler.MeasurementSegment): string;
-
-    /**
-     * Draw each segment of the measured path.
-     */
-    protected _drawMeasuredPath(): void;
-
-    /**
-     * Highlight the measurement required to complete the move in the minimum number of discrete spaces
-     */
-    protected _highlightMeasurementSegment(segment: Ruler.MeasurementSegment): void;
-
-    /**
-     * Determine whether a SPACE keypress event entails a legal token movement along a measured ruler
-     *
-     * @returns An indicator for whether a token was successfully moved or not. If True the event should be
-     *          prevented from propagating further, if False it should move on to other handlers.
-     */
-    moveToken(): Promise<boolean>;
-
-    /**
-     * Acquire a Token, if any, which is eligible to perform a movement based on the starting point of the Ruler
-     * @param origin - The origin of the Ruler
-     * @returns The Token that is to be moved, if any
-     *
-     */
-    protected _getMovementToken(origin: Canvas.Point): Token.ConfiguredInstance | null;
-
-    /**
-     * Get the current measurement history.
-     * @returns The current measurement history, if any
-     */
-    protected _getMeasurementHistory(): Ruler.MeasurementHistory | void;
-
-    /**
-     * Create the next measurement history from the current history and current Ruler state.
-     * @returns The next measurement history
-     */
-    protected _createMeasurementHistory(): Ruler.MeasurementHistory;
-
-    /**
-     * Test whether a Token is allowed to execute a measured movement path.
-     * @param token - The Token being tested
-     * @returns Whether the movement is allowed
-     * @throws  A specific Error message used instead of returning false
-     */
-    protected _canMove(token: Token.ConfiguredInstance): boolean;
-
-    /**
-     * Animate piecewise Token movement along the measured segment path.
-     * @param token - The Token being animated
-     * @returns A Promise which resolves once all animation is completed
-     */
-    protected _animateMovement(token: Token.ConfiguredInstance): Promise<void>;
-
-    /**
-     * Update Token position and configure its animation properties for the next leg of its animation.
-     * @param token         - The Token being updated
-     * @param segment       - The measured segment being moved
-     * @param destination   - The adjusted destination coordinate
-     * @param updateOptions - Additional options to configure the `TokenDocument` update
-     * @returns A Promise that resolves once the animation for this segment is done
-     */
-    protected _animateSegment(
-      token: Token.ConfiguredInstance,
-      segment: Ruler.MeasurementSegment,
-      destination: Canvas.Point,
-      updateOptions: TokenDocument.DatabaseOperations["update"],
-    ): Promise<void>;
-
-    /**
-     * An method which can be extended by a subclass of Ruler to define custom behaviors before a confirmed movement.
-     * @param token - The Token that will be moving
-     */
-    protected _preMove(token: Token): Promise<void>;
-
-    /**
-     * An event which can be extended by a subclass of Ruler to define custom behaviors before a confirmed movement.
-     * @param token - The Token that finished moving
-     */
-    protected _postMove(token: Token): Promise<void>;
-
-    /**
-     * Broadcast Ruler measurement if its User is the connected client.
-     * The broadcast is throttled to 100ms.
-     */
-    protected _broadcastMeasurement(): void;
-
-    /**
-     * Package Ruler data to an object which can be serialized to a string.
-     */
-    protected _getMeasurementData(): Ruler.MeasurementData;
-
-    /**
-     * Update a Ruler instance using data provided through the cursor activity socket
-     * @param data - Ruler data with which to update the display
-     */
-    update(data: Ruler.MeasurementData | null): void;
-
-    /**
-     * Handle the beginning of a new Ruler measurement workflow
-     * @param event - The drag start event
-     * @see Canvas.#onDragLeftStart
-     */
-    protected _onDragStart(event: PIXI.FederatedEvent): void;
-
-    /**
-     * Handle left-click events on the Canvas during Ruler measurement.
-     * @param event - The pointer-down event
-     * @see Canvas._onClickLeft
-     */
-    protected _onClickLeft(event: PIXI.FederatedEvent): void;
-
-    /**
-     * Handle right-click events on the Canvas during Ruler measurement.
-     * @param event - The pointer-down event
-     * @see Canvas._onClickRight
-     */
-    protected _onClickRight(event: PIXI.FederatedEvent): void;
-
-    /**
-     * Continue a Ruler measurement workflow for left-mouse movements on the Canvas.
-     * @param event - The mouse move event
-     * @see Canvas.#onDragLeftMove
-     */
-    protected _onMouseMove(event: PIXI.FederatedEvent): void;
-
-    /**
-     * Conclude a Ruler measurement workflow by releasing the left-mouse button.
-     * @param event - The pointer-up event
-     * @see Canvas.#onDragLeftDrop
-     */
-    protected _onMouseUp(event: PIXI.FederatedEvent): void;
-
-    /**
-     * Move the Token along the measured path when the move key is pressed.
-     */
-    protected _onMoveKeyDown(context: KeyboardManager.KeyboardEventContext): void;
-  }
-
-  namespace Ruler {
-    type AnyConstructor = typeof AnyRuler;
-
-    interface STATES {
-      readonly INACTIVE: 0;
-      readonly STARTING: 1;
-      readonly MEASURING: 2;
-      readonly MOVING: 3;
-    }
-
-    interface MeasurementSegment {
-      /** The Ray which represents the point-to-point line segment */
-      ray: Ray;
-
-      /** The text object used to display a label for this segment */
-      label: PreciseText;
-
-      /** The measured distance of the segment */
-      distance: number;
-
-      /** The measured cost of the segment */
-      cost: number;
-
-      /** The cumulative measured distance of this segment and the segments before it */
-      cumulativeDistance: number;
-
-      /** The cumulative measured cost of this segment and the segments before it */
-      cumulativeCost: number;
-
-      /** Is this segment part of the measurement history? */
-      history: boolean;
-
-      /** Is this segment the first one after the measurement history? */
-      first: boolean;
-
-      /** Is this segment the last one? */
-      last: boolean;
-
-      /** Animation options passed to {@link TokenDocument#update} */
-      animation: object;
-    }
-
-    interface MeasurementHistoryWaypoint {
-      /** The x-coordinate of the waypoint */
-      x: number;
-
-      /** The y-coordinate of the waypoint */
-      y: number;
-
-      /** Teleported to from the previous waypoint this waypoint? */
-      teleport: boolean;
-
-      /** The cost of having moved from the previous waypoint to this waypoint */
-      cost: number;
-    }
-
-    type MeasurementHistory = MeasurementHistoryWaypoint[];
-
-    interface MeasurementData {
-      /** The state ({@link Ruler#state}) */
-      state: ValueOf<Ruler.STATES>;
-
-      /** The token ID ({@link Ruler#token}) */
-      token: string | null;
-
-      /** The measurement history ({@link Ruler#history}) */
-      history: MeasurementHistory;
-
-      /** The waypoints ({@link Ruler#waypoints}) */
-      waypoints: Canvas.Point[];
-
-      /** The destination ({@link Ruler#destination}) */
-      destination: Canvas.Point | null;
-    }
-  }
-}
-
-declare abstract class AnyRuler extends Ruler {
-  constructor(arg0: never, ...args: never[]);
-}

package/src/foundry/client/pixi/layers/effects/background-effects.d.mts

@@ -1,48 +0,0 @@
-import type { HandleEmptyObject } from "../../../../../utils/index.d.mts";
-
-declare global {
-  /**
-   * A layer of background alteration effects which change the appearance of the primary group render texture.
-   */
-  class CanvasBackgroundAlterationEffects extends CanvasLayer {
-    /**
-     * A collection of effects which provide background vision alterations.
-     * @defaultValue `vision.sortableChildren = true`
-     */
-    vision: PIXI.Container;
-
-    /**
-     * A collection of effects which provide background preferred vision alterations.
-     * @defaultValue `visionPreferred.sortableChildren = true`
-     */
-    visionPreferred: PIXI.Container;
-
-    /**
-     * A collection of effects which provide other background alterations.
-     */
-    lighting: PIXI.Container;
-
-    protected override _draw(options: HandleEmptyObject<CanvasBackgroundAlterationEffects.DrawOptions>): Promise<void>;
-
-    protected override _tearDown(
-      options: HandleEmptyObject<CanvasBackgroundAlterationEffects.TearDownOptions>,
-    ): Promise<void>;
-
-    /**
-     * Clear background alteration effects vision and lighting containers
-     */
-    clear(): void;
-  }
-
-  namespace CanvasBackgroundAlterationEffects {
-    type AnyConstructor = typeof AnyCanvasBackgroundAlterationEffects;
-
-    interface DrawOptions extends CanvasLayer.DrawOptions {}
-
-    interface TearDownOptions extends CanvasLayer.DrawOptions {}
-  }
-}
-
-declare abstract class AnyCanvasBackgroundAlterationEffects extends CanvasBackgroundAlterationEffects {
-  constructor(arg0: never, ...args: never[]);
-}

package/src/foundry/client/pixi/layers/effects/coloration-effects.d.mts

@@ -1,39 +0,0 @@
-import type { HandleEmptyObject } from "../../../../../utils/index.d.mts";
-
-declare global {
-  /**
-   * A CanvasLayer for displaying coloration visual effects
-   */
-  class CanvasColorationEffects extends CanvasLayer {
-    /**
-     * @defaultValue `true`
-     */
-    override sortableChildren: boolean;
-
-    /**
-     * The filter used to mask visual effects on this layer
-     */
-    filter: VisualEffectsMaskingFilter;
-
-    /**
-     * Clear coloration effects container
-     */
-    clear(): void;
-
-    protected override _draw(options: HandleEmptyObject<CanvasColorationEffects.DrawOptions>): Promise<void>;
-
-    protected override _tearDown(options: HandleEmptyObject<CanvasColorationEffects.TearDownOptions>): Promise<void>;
-  }
-
-  namespace CanvasColorationEffects {
-    type AnyConstructor = typeof AnyCanvasColorationEffects;
-
-    interface DrawOptions extends CanvasLayer.DrawOptions {}
-
-    interface TearDownOptions extends CanvasLayer.TearDownOptions {}
-  }
-}
-
-declare abstract class AnyCanvasColorationEffects extends CanvasColorationEffects {
-  constructor(arg0: never, ...args: never[]);
-}

package/src/foundry/client/pixi/layers/effects/darkness-effects.d.mts

@@ -1,30 +0,0 @@
-import type { HandleEmptyObject } from "../../../../../utils/index.d.mts";
-
-declare global {
-  /**
-   * A layer of background alteration effects which change the appearance of the primary group render texture.
-   */
-  class CanvasDarknessEffects extends CanvasLayer {
-    /**
-     * @defaultValue `true`
-     */
-    override sortableChildren: boolean;
-
-    /**
-     * Clear coloration effects container
-     */
-    clear(): void;
-
-    override _draw(options: HandleEmptyObject<CanvasDarknessEffects.DrawOptions>): Promise<void>;
-  }
-
-  namespace CanvasDarknessEffects {
-    type AnyConstructor = typeof AnyCanvasDarknessEffects;
-
-    interface DrawOptions extends CanvasLayer.DrawOptions {}
-  }
-}
-
-declare abstract class AnyCanvasDarknessEffects extends CanvasDarknessEffects {
-  constructor(arg0: never, ...args: never[]);
-}