unite-lib 1.4.0 → 1.4.1

package/dist/index.d.cts

@@ -145,6 +145,21 @@ declare function getMapImageUrl(map: Map, resolution?: MapResolution, options?:
  * Returns spawns for a given map id (e.g. "map-groudon", "map-kyogre", "map-rayquaza").
  */
 declare function getSpawnsByMap(mapId: string): MapSpawn[];
+/**
+ * Parses game clock "MM:SS" to seconds remaining (e.g. "10:00" → 600, "02:00" → 120).
+ */
+declare function parseGameClockToSeconds(clock: string): number;
+/**
+ * Returns whether a spawn is visible at the given game clock (seconds remaining).
+ * Considers both spawnTime (spawn appears when clock ≤ spawnTime) and despawnTime
+ * (spawn disappears when clock ≤ despawnTime, e.g. center Natu/Altaria when boss spawns at 02:00).
+ */
+declare function isSpawnVisibleAtGameClock(spawn: MapSpawn, gameClockSeconds: number): boolean;
+/**
+ * Returns spawns for a map that are visible at the given game clock (seconds remaining).
+ * Use this when you need to show only spawns that have already appeared and not yet despawned.
+ */
+declare function getSpawnsByMapVisibleAt(mapId: string, gameClockSeconds: number): MapSpawn[];
 /**
  * Returns the neutral by id, or undefined if not found.
  */
@@ -165,4 +180,4 @@ declare function getPokemonsByBattleType(battleType: BattleType): Pokemon[];
 declare function getPokemonsByTag(tag: Tag): Pokemon[];
 declare function getActivePokemons(): Pokemon[];
 
-export { BattleType, type GetImageUrlOptions, type Map, type MapResolution, type MapSpawn, type Move, type MoveSlotId, type Neutral, type Pokemon, type PokemonImages, type PokemonStats, Tag, getActivePokemons, getImageUrl, getMapImageUrl, getNeutralById, getNeutralImageUrl, getPokemonByDex, getPokemonByName, getPokemonBySlug, getPokemonSlug, getPokemonsByBattleType, getPokemonsByTag, getSpawnsByMap, maps, moves, neutrals, pokemons, spawns };
+export { BattleType, type GetImageUrlOptions, type Map, type MapResolution, type MapSpawn, type Move, type MoveSlotId, type Neutral, type Pokemon, type PokemonImages, type PokemonStats, Tag, getActivePokemons, getImageUrl, getMapImageUrl, getNeutralById, getNeutralImageUrl, getPokemonByDex, getPokemonByName, getPokemonBySlug, getPokemonSlug, getPokemonsByBattleType, getPokemonsByTag, getSpawnsByMap, getSpawnsByMapVisibleAt, isSpawnVisibleAtGameClock, maps, moves, neutrals, parseGameClockToSeconds, pokemons, spawns };

package/dist/index.d.ts

@@ -145,6 +145,21 @@ declare function getMapImageUrl(map: Map, resolution?: MapResolution, options?:
  * Returns spawns for a given map id (e.g. "map-groudon", "map-kyogre", "map-rayquaza").
  */
 declare function getSpawnsByMap(mapId: string): MapSpawn[];
+/**
+ * Parses game clock "MM:SS" to seconds remaining (e.g. "10:00" → 600, "02:00" → 120).
+ */
+declare function parseGameClockToSeconds(clock: string): number;
+/**
+ * Returns whether a spawn is visible at the given game clock (seconds remaining).
+ * Considers both spawnTime (spawn appears when clock ≤ spawnTime) and despawnTime
+ * (spawn disappears when clock ≤ despawnTime, e.g. center Natu/Altaria when boss spawns at 02:00).
+ */
+declare function isSpawnVisibleAtGameClock(spawn: MapSpawn, gameClockSeconds: number): boolean;
+/**
+ * Returns spawns for a map that are visible at the given game clock (seconds remaining).
+ * Use this when you need to show only spawns that have already appeared and not yet despawned.
+ */
+declare function getSpawnsByMapVisibleAt(mapId: string, gameClockSeconds: number): MapSpawn[];
 /**
  * Returns the neutral by id, or undefined if not found.
  */
@@ -165,4 +180,4 @@ declare function getPokemonsByBattleType(battleType: BattleType): Pokemon[];
 declare function getPokemonsByTag(tag: Tag): Pokemon[];
 declare function getActivePokemons(): Pokemon[];
 
-export { BattleType, type GetImageUrlOptions, type Map, type MapResolution, type MapSpawn, type Move, type MoveSlotId, type Neutral, type Pokemon, type PokemonImages, type PokemonStats, Tag, getActivePokemons, getImageUrl, getMapImageUrl, getNeutralById, getNeutralImageUrl, getPokemonByDex, getPokemonByName, getPokemonBySlug, getPokemonSlug, getPokemonsByBattleType, getPokemonsByTag, getSpawnsByMap, maps, moves, neutrals, pokemons, spawns };
+export { BattleType, type GetImageUrlOptions, type Map, type MapResolution, type MapSpawn, type Move, type MoveSlotId, type Neutral, type Pokemon, type PokemonImages, type PokemonStats, Tag, getActivePokemons, getImageUrl, getMapImageUrl, getNeutralById, getNeutralImageUrl, getPokemonByDex, getPokemonByName, getPokemonBySlug, getPokemonSlug, getPokemonsByBattleType, getPokemonsByTag, getSpawnsByMap, getSpawnsByMapVisibleAt, isSpawnVisibleAtGameClock, maps, moves, neutrals, parseGameClockToSeconds, pokemons, spawns };

package/dist/index.global.js

@@ -41,9 +41,12 @@ var UniteLib = (() => {
     getSpawnInfo: () => getSpawnInfo,
     getSpawnInfoForSpawn: () => getSpawnInfoForSpawn,
     getSpawnsByMap: () => getSpawnsByMap,
+    getSpawnsByMapVisibleAt: () => getSpawnsByMapVisibleAt,
+    isSpawnVisibleAtGameClock: () => isSpawnVisibleAtGameClock,
     maps: () => maps_default,
     moves: () => moves_default,
     neutrals: () => neutrals_default,
+    parseGameClockToSeconds: () => parseGameClockToSeconds,
     pokemons: () => pokemons_default,
     spawns: () => spawns_default
   });
@@ -4924,6 +4927,26 @@ var UniteLib = (() => {
   function getSpawnsByMap(mapId) {
     return spawns_default.filter((s) => s.mapId === mapId);
   }
+  function parseGameClockToSeconds(clock) {
+    const parts = String(clock).trim().split(":");
+    const m = parseInt(parts[0], 10) || 0;
+    const s = parseInt(parts[1], 10) || 0;
+    return m * 60 + s;
+  }
+  function isSpawnVisibleAtGameClock(spawn, gameClockSeconds) {
+    const spawnSec = parseGameClockToSeconds(spawn.spawnTime);
+    if (gameClockSeconds > spawnSec) return false;
+    if (spawn.despawnTime != null && spawn.despawnTime !== "") {
+      const despawnSec = parseGameClockToSeconds(spawn.despawnTime);
+      if (gameClockSeconds <= despawnSec) return false;
+    }
+    return true;
+  }
+  function getSpawnsByMapVisibleAt(mapId, gameClockSeconds) {
+    return getSpawnsByMap(mapId).filter(
+      (s) => isSpawnVisibleAtGameClock(s, gameClockSeconds)
+    );
+  }
   function getNeutralById(id) {
     return neutrals_default.find((n) => n.id === id);
   }