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

package/src/foundry/client-esm/canvas/edges/collision.d.mts

@@ -1,144 +0,0 @@
-import type { Identity, NullishProps } from "fvtt-types/utils";
-import type Edge from "./edge.d.mts";
-import type PolygonVertex from "./vertex.d.mts";
-
-/**
- * A specialized object that contains the result of a collision in the context of the ClockwiseSweepPolygon.
- * This class is not designed or intended for use outside of that context.
- */
-declare class CollisionResult {
-  constructor({
-    target,
-    collisions,
-    cwEdges,
-    ccwEdges,
-    isBehind,
-    isLimited,
-    wasLimited,
-  }?: CollisionResult.ConstructorValues);
-
-  /**
-   * The vertex that was the target of this result
-   */
-  target: PolygonVertex;
-
-  /**
-   * The array of collision points which apply to this result
-   * @defaultValue `[]`
-   */
-  collisions: PolygonVertex[];
-
-  /**
-   * The set of edges connected to the target vertex that continue clockwise
-   * @defaultValue `new Set()`
-   */
-  cwEdges: Set<Edge>;
-
-  /**
-   * The set of edges connected to the target vertex that continue counter-clockwise
-   * @defaultValue `new Set()`
-   */
-  ccwEdges: Set<Edge>;
-
-  /**
-   * Is the target vertex for this result behind some closer active edge?
-   * @remarks Set directly from the constructor, so possibly was passed nullish
-   */
-  isBehind: boolean | undefined | null;
-
-  /**
-   * Does the target vertex for this result impose a limited collision?
-   * @remarks Set directly from the constructor, so possibly was passed nullish
-   */
-  isLimited: boolean | undefined | null;
-
-  /**
-   * Has the set of collisions for this result encountered a limited edge?
-   * @remarks Set directly from the constructor, so possibly was passed nullish
-   */
-  wasLimited: boolean | undefined | null;
-
-  /**
-   * Is this result limited in the clockwise direction?
-   * @defaultValue `false`
-   */
-  limitedCW: boolean;
-
-  /**
-   * Is this result limited in the counter-clockwise direction?
-   * @defaultValue `false`
-   */
-  limitedCCW: boolean;
-
-  /**
-   * Is this result blocking in the clockwise direction?
-   * @defaultValue `false`
-   */
-  blockedCW: boolean;
-
-  /**
-   * Is this result blocking in the counter-clockwise direction?
-   * @defaultValue `false`
-   */
-  blockedCCW: boolean;
-
-  /**
-   * Previously blocking in the clockwise direction?
-   * @defaultValue `false`
-   */
-  blockedCWPrev: boolean;
-
-  /**
-   * Previously blocking in the counter-clockwise direction?
-   * @defaultValue `false`
-   */
-  blockedCCWPrev: boolean;
-}
-
-declare namespace CollisionResult {
-  interface Any extends AnyCollisionResult {}
-  interface AnyConstructor extends Identity<typeof AnyCollisionResult> {}
-
-  type _ConstructorValues = NullishProps<{
-    /**
-     * The set of edges connected to the target vertex that continue clockwise
-     * @defaultValue `new Set()`
-     */
-    cwEdges: Set<Edge>;
-
-    /**
-     * The set of edges connected to the target vertex that continue counter-clockwise
-     * @defaultValue `new Set()`
-     */
-    ccwEdges: Set<Edge>;
-
-    /** Is the target vertex for this result behind some closer active edge? */
-    isBehind: boolean;
-
-    /** Does the target vertex for this result impose a limited collision? */
-    isLimited: boolean;
-
-    /** Has the set of collisions for this result encountered a limited edge? */
-    wasLimited: boolean;
-  }>;
-
-  interface ConstructorValues extends _ConstructorValues {
-    /**
-     * The vertex that was the target of this result
-     */
-    target: PolygonVertex;
-
-    /**
-     * The array of collision points which apply to this result
-     * @defaultValue `[]`
-     * @remarks Can't be `null` as it only has a parameter default
-     */
-    collisions?: PolygonVertex[] | undefined;
-  }
-}
-
-declare abstract class AnyCollisionResult extends CollisionResult {
-  constructor(...args: never);
-}
-
-export default CollisionResult;

package/src/foundry/client-esm/canvas/edges/edge.d.mts

@@ -1,253 +0,0 @@
-import type PolygonVertex from "./vertex.d.mts";
-import type { LineIntersection } from "#common/utils/geometry.d.mts";
-import type { Identity, NullishProps } from "fvtt-types/utils";
-import type { WallThresholdData } from "#common/documents/_types.d.mts";
-
-/**
- * A data structure used to represent potential edges used by the ClockwiseSweepPolygon.
- * Edges are not polygon-specific, meaning they can be reused across many polygon instances.
- */
-declare class Edge {
-  /**
-   * Construct an Edge by providing the following information.
-   * @param a - The first endpoint of the edge
-   * @param b - The second endpoint of the edge
-   * @param options - Additional options which describe the edge
-   */
-  // options: not null (destructured)
-  constructor(a: Canvas.Point, b: Canvas.Point, options?: Edge.ConstructorOptions);
-
-  /**
-   * The first endpoint of the edge.
-   */
-  a: PIXI.Point;
-
-  /**
-   * The second endpoint of the edge.
-   */
-  b: PIXI.Point;
-
-  /**
-   * A string used to uniquely identify this edge.
-   * @defaultValue `object?.id ?? undefined`
-   */
-  id: string | undefined;
-
-  /**
-   * A PlaceableObject that is responsible for this edge, if any
-   * @remarks This property is never read by Foundry, so it being nullish won't break anything as of 12.331
-   */
-  object: PlaceableObject.Any | undefined | null;
-
-  /**
-   * The type of edge
-   * @defaultValue `"wall"`
-   */
-  type: Edge.EdgeTypes;
-
-  /**
-   * The direction of effect for the edge.
-   */
-  direction: foundry.CONST.WALL_DIRECTIONS;
-
-  /**
-   * How this edge restricts light.
-   * @defaultValue `CONST.WALL_SENSE_TYPES.NONE`
-   */
-  light: foundry.CONST.WALL_SENSE_TYPES;
-
-  /**
-   * How this edge restricts movement.
-   * @defaultValue `CONST.WALL_SENSE_TYPES.NONE`
-   */
-  move: foundry.CONST.WALL_SENSE_TYPES;
-
-  /**
-   * How this edge restricts sight.
-   * @defaultValue `CONST.WALL_SENSE_TYPES.NONE`
-   */
-  sight: foundry.CONST.WALL_SENSE_TYPES;
-
-  /**
-   * How this edge restricts sound.
-   * @defaultValue `CONST.WALL_SENSE_TYPES.NONE`
-   */
-  sound: foundry.CONST.WALL_SENSE_TYPES;
-
-  /**
-   * Specialized threshold data for this edge.
-   * @remarks Foundry only accesses this in nullish-safe ways as of 12.331
-   */
-  threshold: WallThresholdData | undefined | null;
-
-  /**
-   * The endpoint of the edge which is oriented towards the top-left.
-   */
-  nw: Canvas.Point;
-
-  /**
-   * The endpoint of the edge which is oriented towards the bottom-right.
-   */
-  se: Canvas.Point;
-
-  /**
-   * The rectangular bounds of the edge. Used by the quadtree.
-   */
-  bounds: PIXI.Rectangle;
-
-  /**
-   * Record other edges which this one intersects with.
-   */
-  intersections: Edge.IntersectionEntry[];
-
-  /**
-   * A PolygonVertex instance.
-   * Used as part of ClockwiseSweepPolygon computation.
-   * @defaultValue `undefined`
-   * @remarks Only set in {@link ClockwiseSweepPolygon._identifyVertices | `ClockwiseSweepPolygon#_identifyVertices`} (part of CSP initialization)
-   */
-  vertexA: PolygonVertex | undefined;
-
-  /**
-   * A PolygonVertex instance.
-   * Used as part of ClockwiseSweepPolygon computation.
-   * @defaultValue `undefined`
-   * @remarks Only set in {@link ClockwiseSweepPolygon._identifyVertices | `ClockwiseSweepPolygon#_identifyVertices`} (part of CSP initialization)
-   */
-  vertexB: PolygonVertex | undefined;
-
-  /**
-   * Is this edge limited for a particular type?
-   */
-  isLimited(type: foundry.CONST.WALL_RESTRICTION_TYPES): boolean;
-
-  /**
-   * Create a copy of the Edge which can be safely mutated.
-   */
-  clone(): this;
-
-  /**
-   * Get an intersection point between this Edge and another.
-   */
-  getIntersection(other: Edge): LineIntersection | void;
-
-  /**
-   * Test whether to apply a proximity threshold to this edge.
-   * If the proximity threshold is met, this edge excluded from perception calculations.
-   * @param sourceType     - Sense type for the source
-   * @param sourceOrigin   - The origin or position of the source on the canvas
-   * @param externalRadius - The external radius of the source
-   *                         (default: `0`)
-   * @returns True if the edge has a threshold greater than 0 for the source type,
-   *          and the source type is within that distance.
-   */
-  applyThreshold(
-    sourceType: Edge.AttenuationTypes,
-    sourceOrigin: Canvas.Point,
-    externalRadius?: number | null,
-  ): boolean;
-
-  /**
-   * Determine the orientation of this Edge with respect to a reference point.
-   * @param point - Some reference point, relative to which orientation is determined
-   * @returns An orientation in CONST.WALL_DIRECTIONS which indicates whether the Point is left,
-   *          right, or collinear (both) with the Edge
-   */
-  orientPoint(point: Canvas.Point): foundry.CONST.WALL_DIRECTIONS;
-
-  /**
-   * Identify intersections between a provided iterable of edges.
-   * @param edges - An iterable of edges
-   */
-  static identifyEdgeIntersections(edges: Iterable<Edge>): void;
-
-  /**
-   * Record the intersections between two edges.
-   * @param other - Another edge to test and record
-   */
-  recordIntersections(other: Edge): void;
-
-  /**
-   * Remove intersections of this edge with all other edges.
-   */
-  removeIntersections(): void;
-}
-
-declare namespace Edge {
-  interface Any extends AnyEdge {}
-  interface AnyConstructor extends Identity<typeof AnyEdge> {}
-
-  /** @internal */
-  type _ConstructorOptions = NullishProps<{
-    /**
-     * A string used to uniquely identify this edge
-     *
-     */
-    id: string | null;
-
-    /**
-     * A PlaceableObject that is responsible for this edge, if any
-     * @remarks `Edge#object` is never read by Foundry, so this being nullish won't break anything as of 12.331
-     */
-    object: PlaceableObject.Any;
-
-    /**
-     * The type of edge
-     * @defaultValue `"wall"`
-     */
-    type: Edge.EdgeTypes;
-
-    /**
-     * How this edge restricts light
-     * @defaultValue `CONST.WALL_SENSE_TYPES.NONE`
-     */
-    light: foundry.CONST.WALL_SENSE_TYPES;
-
-    /**
-     * How this edge restricts movement
-     * @defaultValue `CONST.WALL_SENSE_TYPES.NONE`
-     */
-    move: foundry.CONST.WALL_SENSE_TYPES;
-
-    /**
-     * How this edge restricts sight
-     * @defaultValue `CONST.WALL_SENSE_TYPES.NONE`
-     */
-    sight: foundry.CONST.WALL_SENSE_TYPES;
-
-    /**
-     * How this edge restricts sound
-     * @defaultValue `CONST.WALL_SENSE_TYPES.NONE`
-     */
-    sound: foundry.CONST.WALL_SENSE_TYPES;
-
-    /**
-     * A direction of effect for the edge
-     * @defaultValue `CONST.WALL_DIRECTIONS.BOTH`
-     */
-    direction: foundry.CONST.WALL_DIRECTIONS;
-
-    /**
-     * Configuration of threshold data for this edge
-     * @remarks Foundry only accesses this in nullish-safe ways as of 12.331
-     */
-    threshold: WallThresholdData;
-  }>;
-
-  interface ConstructorOptions extends _ConstructorOptions {}
-
-  type EdgeTypes = "wall" | "darkness" | "innerBounds" | "outerBounds";
-
-  type AttenuationTypes = Exclude<foundry.CONST.WALL_RESTRICTION_TYPES, "move">;
-
-  interface IntersectionEntry {
-    edge: Edge;
-    intersection: LineIntersection;
-  }
-}
-
-declare abstract class AnyEdge extends Edge {
-  constructor(...args: never);
-}
-
-export default Edge;

package/src/foundry/client-esm/canvas/edges/edges.d.mts

@@ -1,33 +0,0 @@
-import type { Identity } from "fvtt-types/utils";
-import type Edge from "./edge.d.mts";
-
-/**
- * A special class of Map which defines all the edges used to restrict perception in a Scene.
- */
-declare class CanvasEdges extends Map<string, Edge> {
-  /**
-   * Initialize all active edges for the Scene. This workflow occurs once only when the Canvas is first initialized.
-   * Edges are created from the following sources:
-   * 1. Wall documents
-   * 2. Canvas boundaries (inner and outer bounds)
-   * 3. Darkness sources
-   * 4. Programmatically defined in the "initializeEdges" hook
-   */
-  initialize(): void;
-
-  /**
-   * Incrementally refresh Edges by computing intersections between all registered edges.
-   */
-  refresh(): void;
-}
-
-declare namespace CanvasEdges {
-  interface Any extends AnyCanvasEdges {}
-  interface AnyConstructor extends Identity<typeof AnyCanvasEdges> {}
-}
-
-declare abstract class AnyCanvasEdges extends CanvasEdges {
-  constructor(...args: never);
-}
-
-export default CanvasEdges;

package/src/foundry/client-esm/canvas/edges/vertex.d.mts

@@ -1,166 +0,0 @@
-import type { Identity, NullishProps } from "fvtt-types/utils";
-import type Edge from "./edge.d.mts";
-
-/**
- * A specialized point data structure used to represent vertices in the context of the ClockwiseSweepPolygon.
- * This class is not designed or intended for use outside of that context.
- */
-declare class PolygonVertex {
-  constructor(x: number, y: number, { distance, index }?: PolygonVertex.ConstructorOptions);
-
-  x: number;
-
-  y: number;
-
-  /** @defaultValue `PolygonVertex.getKey(this.x, this.y)` */
-  key: number;
-
-  /**
-   * @defaultValue `undefined`
-   * @remarks Accessed externally in {@link ClockwiseSweepPolygon._testCollision | `ClockwiseSweepPolygon#_testCollision`}
-   */
-  _distance: number | undefined | null;
-
-  /**
-   * @defaultValue `undefined`
-   * @remarks Set to `undefined` in the constructor, otherwise only set externally in `ClockwiseSweepPolygon` methods
-   */
-  _d2: number | undefined;
-
-  /**
-   * @defaultValue `undefined`
-   * @remarks Accessed externally in `ClockwiseSweepPolygon` methods
-   */
-  _index: number | undefined | null;
-
-  /**
-   * Determine the sort key to use for this vertex, arranging points from north-west to south-east.
-   * @param x - The x-coordinate
-   * @param y - The y-coordinate
-   * @returns The key used to identify the vertex
-   */
-  static getKey(x: number, y: number): number;
-
-  /**
-   * The set of edges which connect to this vertex.
-   * This set is initially empty and populated later after vertices are de-duplicated.
-   * @defaultValue `new Set()`
-   */
-  edges: Set<Edge>;
-
-  /**
-   * The subset of edges which continue clockwise from this vertex.
-   * @defaultValue `new Set()`
-   */
-  cwEdges: Set<Edge>;
-
-  /**
-   * The subset of edges which continue counter-clockwise from this vertex.
-   * @defaultValue `new Set()`
-   */
-  ccwEdges: Set<Edge>;
-
-  /**
-   * The set of vertices collinear to this vertex
-   * @defaultValue `new Set()`
-   */
-  collinearVertices: Set<PolygonVertex>;
-
-  /**
-   * Is this vertex an endpoint of one or more edges?
-   */
-  isEndpoint: boolean | undefined;
-
-  /**
-   * Does this vertex have a single counterclockwise limiting edge?
-   */
-  isLimitingCCW: boolean | undefined;
-
-  /**
-   * Does this vertex have a single clockwise limiting edge?
-   */
-  isLimitingCW: boolean | undefined;
-
-  /**
-   * Does this vertex have non-limited edges or 2+ limited edges counterclockwise?
-   */
-  isBlockingCCW: boolean | undefined;
-
-  /**
-   * Does this vertex have non-limited edges or 2+ limited edges clockwise?
-   */
-  isBlockingCW: boolean | undefined;
-
-  /**
-   * Does this vertex result from an internal collision?
-   * @defaultValue `false`
-   */
-  isInternal: boolean;
-
-  /**
-   * The maximum restriction imposed by this vertex.
-   * @defaultValue `CONST.WALL_SENSE_TYPES.NONE`
-   * @remarks Actually initialized to `0` literal, but is meant as a `WALL_SENSE_TYPES`
-   */
-  restriction: foundry.CONST.WALL_SENSE_TYPES;
-
-  /**
-   * Record whether this PolygonVertex has been visited in the sweep
-   * @defaultValue `false`
-   * @remarks Foundry marked `@internal`, set externally during `ClockwiseSweepPolygon` initialization
-   */
-  protected _visited: boolean;
-
-  /**
-   * Is this vertex limited in type?
-   */
-  get isLimited(): boolean;
-
-  /**
-   * Associate an edge with this vertex.
-   * @param edge        - The edge being attached
-   * @param orientation - The orientation of the edge with respect to the origin
-   * @param type        - The restriction type of the polygon being created
-   */
-  attachEdge(edge: Edge, orientation: number, type: foundry.CONST.WALL_RESTRICTION_TYPES): void;
-
-  /**
-   * Is this vertex terminal (at the maximum radius)
-   */
-  get isTerminal(): boolean;
-
-  /**
-   * Is this vertex the same point as some other vertex?
-   * @param other - Some other vertex
-   * @returns Are they the same point?
-   */
-  equals(other: PolygonVertex): boolean;
-
-  /**
-   * Construct a PolygonVertex instance from some other Point structure.
-   * @param point   - The point
-   * @param options - Additional options that apply to this vertex
-   * @returns The constructed vertex
-   */
-  // options: not null (destructured when passed to `new this()`)
-  static fromPoint(point: Canvas.Point, options?: PolygonVertex.ConstructorOptions): PolygonVertex;
-}
-
-declare namespace PolygonVertex {
-  interface Any extends AnyPolygonVertex {}
-  interface AnyConstructor extends Identity<typeof AnyPolygonVertex> {}
-
-  /** @internal */
-  type _ConstructorOptions = NullishProps<{
-    distance: number;
-    index: number;
-  }>;
-
-  interface ConstructorOptions extends _ConstructorOptions {}
-}
-
-declare abstract class AnyPolygonVertex extends PolygonVertex {
-  constructor(...args: never);
-}
-
-export default PolygonVertex;

package/src/foundry/client-esm/canvas/regions/_module.d.mts

@@ -1,9 +0,0 @@
-// 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-x/no-unresolved` from erroring `.mjs` is used.
-/* eslint-disable import-x/extensions */
-
-export { default as RegionGeometry } from "./geometry.mjs";
-export { default as RegionMesh } from "./mesh.mjs";
-export { default as RegionPolygonTree } from "./polygon-tree.mjs";
-export { default as RegionShape } from "./shape.mjs";

package/src/foundry/client-esm/canvas/regions/geometry.d.mts

@@ -1,38 +0,0 @@
-/**
- * The geometry of a {@link Region | `Region`}.
- * - Vertex Attribute: `aVertexPosition` (`vec2`)
- * - Draw Mode: `PIXI.DRAW_MODES.TRIANGLES`
- */
-declare class RegionGeometry extends PIXI.Geometry {
-  /**
-   * Create a RegionGeometry
-   * @remarks Foundry marked `@internal`
-   */
-  constructor(region: Region.Implementation);
-
-  /** The Region this geometry belongs to */
-  get region(): Region.Implementation;
-
-  /**
-   * Update the buffers
-   * @remarks Foundry marked `@internal`, is exclusively called externally in `Region##updateShapes`
-   */
-  protected _clearBuffers(): void;
-
-  /**
-   * Update the buffers
-   * @remarks Foundry marked `@internal`, is exclusively called externally in `Region##updateShapes`
-   */
-  protected _updateBuffers(): void;
-}
-
-declare namespace RegionGeometry {
-  interface Any extends AnyRegionGeometry {}
-  type AnyConstructor = typeof AnyRegionGeometry;
-}
-
-declare abstract class AnyRegionGeometry extends RegionGeometry {
-  constructor(...args: never);
-}
-
-export default RegionGeometry;