@angelrove/forecast-utils 1.1.2 → 1.1.3

package/dist/types/OpenMeteo/current/useForecastCurrent.d.ts

@@ -5,6 +5,7 @@
  * @param {number} lon
  * @param {number} refreshIntervalMin
  * @returns {{ data: any, apiUrl: string, isLoading: boolean, isError: any }}
+ * @memberof module:OpenMeteo
  */
 export function useForecastCurrent(lat: number, lon: number, refreshIntervalMin?: number): {
     data: any;

package/dist/types/OpenMeteo/daily/useForecastDaily.d.ts

@@ -6,6 +6,7 @@
  * @param {number} lon
  * @param {number} refreshIntervalMin
  * @returns {{ data: any, isLoading: boolean, isError: any }}
+ * @memberof module:OpenMeteo
  */
 export function useForecastDaily(lat: number, lon: number, refreshIntervalMin?: number): {
     data: any;

package/dist/types/OpenMeteo/hourly/useForecastHourly.d.ts

@@ -4,6 +4,7 @@
  * @param {{ latitude: number, longitude: number }} location
  * @param {number} dayNum - Number of days from today: -1 = 24 hours, 0 = today, 1 = tomorrow, ...
  * @returns {{ data: any, isLoading: boolean, isError: any }}
+ * @memberof module:OpenMeteo
  */
 export function useForecastHourly(location: {
     latitude: number;

package/dist/types/OpenMeteo/index.d.ts

@@ -0,0 +1,4 @@
+export { useForecastCurrent } from "./current/useForecastCurrent.js";
+export { useForecastDaily } from "./daily/useForecastDaily.js";
+export { useForecastHourly } from "./hourly/useForecastHourly.js";
+export { weatherSymbol } from "./weatherSymbol/weatherSymbol.js";

package/dist/types/OpenMeteo/weatherSymbol/weatherSymbol.d.ts

@@ -6,6 +6,7 @@
  * @param {boolean} night
  * @param {boolean} dark
  * @returns {{ icon: string, description: string }}
+ * @memberof module:OpenMeteo
  */
 export function weatherSymbol(code: any, precipitation?: number | undefined, night?: boolean, dark?: boolean): {
     icon: string;

package/dist/types/astronomy/index.d.ts

@@ -0,0 +1,4 @@
+export { default as MoonCalc } from "./moon/MoonCalc.js";
+export { default as SunCalc } from "./sun/SunCalc.js";
+export { getLocalTimeInfo as getLocalTime } from "./timeZoneInfo.js";
+export { dateFormat, getLocalTimeFromTz, nowString, timeString } from "./timehelpers.js";

package/dist/types/astronomy/moon/MoonCalc.d.ts

@@ -1,4 +1,11 @@
 export default MoonCalc;
+export type MoonData = {
+    position: AstroPosition;
+    next: {
+        newMoon: string;
+        fullMoon: string;
+    };
+};
 declare namespace MoonCalc {
     export { data };
     export { dataExt };
@@ -12,6 +19,7 @@ declare namespace MoonCalc {
  * @param {Date} [date=new Date()]
  * @param {string} [language=es-ES]
  * @returns {MoonData}
+ * @memberof module:Astronomy/MoonCalc
  */
 declare function data(latitude: number, longitude: number, date?: Date | undefined, language?: string | undefined): MoonData;
 /**
@@ -23,6 +31,7 @@ declare function data(latitude: number, longitude: number, date?: Date | undefin
  * @param {Date} [date=new Date()]
  * @param {string} [language=es-ES]
  * @returns {{ date: string, time: string, illumination: string, phase: string, phaseId: string, emoji: string, parallacticAngle: number, angle: number, position: AstroPosition, next: object }}
+ * @memberof module:Astronomy/MoonCalc
  */
 declare function dataExt(latitude: number, longitude: number, date?: Date | undefined, language?: string | undefined): {
     date: string;
@@ -42,6 +51,7 @@ declare function dataExt(latitude: number, longitude: number, date?: Date | unde
  * @param {string} timezoneId
  * @param {Date} date
  * @returns {{rise: string, set: string, highest: string}}
+ * @memberof module:Astronomy/MoonCalc
  */
 declare function times(latitude: number, longitude: number, timezoneId: string, date?: Date): {
     rise: string;
@@ -53,11 +63,13 @@ declare function times(latitude: number, longitude: number, timezoneId: string,
  * @param {number} longitude
  * @param {Date} [date=new Date()]
  * @returns {string} - Emoji of the moon phase
+ * @memberof module:Astronomy/MoonCalc
  */
 declare function emoji(latitude: number, longitude: number, date?: Date | undefined): string;
 /**
  * @param {number} altitude
  * @param {Date} highest
  * @returns {string} - Up or down emoji
+ * @memberof module:Astronomy/MoonCalc
  */
 declare function getUpOrDown(altitude: number, highest: Date): string;

package/dist/types/astronomy/moon/parseBasicData.d.ts

@@ -1,8 +1,9 @@
 /**
  * Parse basic data from SunCalc
  *
+ * @private
  * @param {any} data
  * @param {string} language
  * @returns {MoonData}
  */
-export function parseBasicData(data: any, language: string): MoonData;
+export function parseBasicData(data: any, language: string): any;

package/dist/types/astronomy/sun/SunCalc.d.ts

@@ -13,6 +13,7 @@ declare namespace SunCalc {
  * @param {number} longitude
  * @param {string} timezoneId
  * @returns {{ sunTimes: object, sunPosition: object, sunPhase: string }}
+ * @memberof module:Astronomy/SunCalc
  */
 declare function all(date: Date, latitude: number, longitude: number, timezoneId: string): {
     sunTimes: object;
@@ -25,6 +26,7 @@ declare function all(date: Date, latitude: number, longitude: number, timezoneId
  * @param {number} longitude
  * @param {string} timezoneId
  * @returns {{ date: Date, sunrise: string, sunset: string, noon: string, dawn: string, dusk: string }}
+ * @memberof module:Astronomy/SunCalc
  */
 declare function times(date: Date, latitude: number, longitude: number, timezoneId: string): {
     date: Date;
@@ -40,12 +42,14 @@ declare function times(date: Date, latitude: number, longitude: number, timezone
  * @param {string} offsetSign - "+" or "-"
  * @param {number} offset - UTC offset in hours
  * @returns {string} - Local time in "HH:mm" format
+ * @memberof module:Astronomy/SunCalc
  */
 declare function getSolarTime(date: Date, lng: number, offsetSign: string, offset: number): string;
 /**
  * @param {number} latitude
  * @param {number} longitude
  * @returns {{date: string, azimuth: number, direction: string, direction_full: string, altitude: number, zenith: number, declination: number}}
+ * @memberof module:Astronomy/SunCalc
  */
 declare function position(latitude: number, longitude: number, date?: Date, language?: string): {
     date: string;
@@ -63,11 +67,13 @@ declare function position(latitude: number, longitude: number, date?: Date, lang
  * @param {number | Date} date
  * @param {string} dateStr
  * @returns {boolean} - true if it's night, false otherwise
+ * @memberof module:Astronomy/SunCalc
  */
 declare function getIsNight(lat: number, lon: number, timezoneId: string, date: number | Date, dateStr: string): boolean;
 /**
  * @param {number} altitude
  * @param {string} noon
  * @returns {string} - The phase of the sun based on its altitude
+ * @memberof module:Astronomy/SunCalc
  */
 declare function getPhase(altitude: number, noon: string): string;

package/dist/types/astronomy/timeZoneInfo.d.ts

@@ -1,10 +1,11 @@
 /**
- * Google API: Get local time from any location
+ * Get local time from any location using Google Maps TimeZone API.
  *
  * @param {string} apiKey - GoogleMaps API key.
  * @param {number} lat
  * @param {number} lng
  * @returns {Promise<any | LocalTimeData>} - An object containing the local time and timezone information:
  * @throws {Error} - If the API request fails or returns an error status.
+ * @memberof module:Astronomy
  */
 export function getLocalTimeInfo(apiKey: string, lat: number, lng: number): Promise<any | LocalTimeData>;

package/dist/types/astronomy/timehelpers.d.ts

@@ -1,20 +1,25 @@
-/**
- * @module astronomy/time-date
- */
 /**
  * Formatea una fecha a un string legible.
  *
  * @param {Date} [date]
  * @param {boolean} [sec=false]
  * @returns {string} La fecha formateada.
+ * @memberof module:Astronomy
  */
 export function timeString(date?: Date | undefined, sec?: boolean | undefined): string;
+/**
+ *
+ * @param {boolean} sec
+ * @returns {String}
+ * @memberof module:Astronomy
+ */
 export function nowString(sec?: boolean): string;
 /**
  * Formatea una fecha a un string legible.
  *
  * @param {Date} [date=new Date()] La fecha a formatear.
  * @returns {string} La fecha formateada.
+ * @memberof module:Astronomy
  */
 export function dateFormat(date?: Date | undefined): string;
 /**
@@ -23,5 +28,6 @@ export function dateFormat(date?: Date | undefined): string;
  * @param {string} timeZone - The timezone string (e.g., 'America/New_York').
  * @param {Date | number} [date=new Date()] - The date object to format. Defaults to the current date.
  * @returns {string} - The formatted local time string.
+ * @memberof module:Astronomy
  */
 export function getLocalTimeFromTz(timeZone: string, date?: number | Date | undefined): string;

package/dist/types/astronomy/types.d.ts

@@ -4,13 +4,6 @@ type AstroPosition = {
     direction: string;
     direction_full: string;
 };
-type MoonData = {
-    position: AstroPosition;
-    next: {
-        newMoon: string;
-        fullMoon: string;
-    };
-};
 type LocalTimeData = {
     /**
      * - The local time.

package/dist/types/geolocation/getGeolocation.d.ts

@@ -1,9 +1,9 @@
 /**
- * Get the current geolocation of the device and reverse
- * geocode it to get the address.
+ * Get the current geolocation of the device and reverse geocode it to get the address.
  *
  * @returns {Promise<{latitude: number, longitude: number, formatted_address: string}>}
  * @throws {Error} If geolocation is not supported or permission is denied.
+ * @memberof module:Geolocation
  */
 export function getGeolocation(): Promise<{
     latitude: number;

package/dist/types/geolocation/index.d.ts

@@ -0,0 +1 @@
+export { getGeolocation } from "./getGeolocation.js";

package/dist/types/utils/degreesToCompass.d.ts

@@ -4,8 +4,19 @@
  * @param {number} degrees
  * @param {string} language - Language code ("en-US", "es-ES", "auto")
  * @returns {{short: string, full: string}}
+ * @memberof module:Utils
  */
 export function degreesToCompass(degrees: number, language?: string): {
     short: string;
     full: string;
 };
+export type Compass = {
+    /**
+     * - Short compass designation
+     */
+    short: string;
+    /**
+     * - Full compass designation
+     */
+    full: string;
+};

package/dist/types/utils/index.d.ts

@@ -0,0 +1,5 @@
+export { degreesToCompass } from "./degreesToCompass.js";
+export { WindArrow } from "./wind/WindArrow.jsx";
+export { windArrowTx } from "./wind/windArrowTx.js";
+export { getWindLevel } from "./wind/windLevel.js";
+export { getWarning, getWarningByDays } from "./warning.js";

package/dist/types/utils/warning.d.ts

@@ -6,6 +6,7 @@
  * @param {number} showersSumToday
  * @param {number} showersSumTomorrow
  * @returns {{ levelNum: number, level: string, message: string, day: number } | null}
+ * @memberof module:Utils
  */
 export function getWarningByDays(precipitationSumToday: number, precipitationSumTomorrow: number, showersSumToday: number, showersSumTomorrow: number): {
     levelNum: number;
@@ -20,6 +21,7 @@ export function getWarningByDays(precipitationSumToday: number, precipitationSum
  * @param {number} precipitation
  * @param {number} showers
  * @returns {{ levelNum: number, level: string, message: string } | null}
+ * @memberof module:Utils
  */
 export function getWarning(precipitation: number, showers: number): {
     levelNum: number;

package/dist/types/utils/wind/WindArrow.d.ts

@@ -1,5 +1,5 @@
 /**
- * @module utils:WindArrow
+ * Wind direction arrow component (svg image).
  */
 /**
  * @typedef {Object} WindArrowProps
@@ -13,6 +13,7 @@
  *
  * @component
  * @param {WindArrowProps} props
+ * @memberof module:Utils
  */
 export function WindArrow({ deg, size, strokeWidth, className, }: WindArrowProps): any;
 export type WindArrowProps = {

package/dist/types/utils/wind/windArrowTx.d.ts

@@ -1,9 +1,10 @@
 /**
- * @module utils
+ * Convert wind direction in degrees to an arrow representation.
  */
 /**
  * Convert wind direction in degrees to an arrow representation.
  *
  * @param {number} deg - Wind direction in degrees.
+ * @memberof module:Utils
  */
 export function windArrowTx(deg: number): "deg?" | "↓" | "↙" | "←" | "↖" | "↑" | "↗" | "→" | "↘" | undefined;

package/dist/types/utils/wind/windLevel.d.ts

@@ -3,6 +3,7 @@
  *
  * @param {number} speed Wind speed in km/h
  * @return {WindLevel | null} Wind level object or null if speed is null
+ * @memberof module:Utils
  */
 export function getWindLevel(speed: number): WindLevel | null;
 export type WindLevel = {

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@angelrove/forecast-utils",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "author": "Jose Angel Romero Vegas",
   "license": "MIT",
   "description": "Utilities for obtaining weather and astronomy forecast data.",
   "homepage": "https://github.com/angelrove/forecast-utils",
   "type": "module",
   "scripts": {
-    "docs:md": "bunx jsdoc2md $(cat doc-files.txt) > README.md"
+    "docs:md": "bunx jsdoc2md --separators $(cat jsdoc-files.txt) > README.md"
   },
   "types": "dist/types/index.d.ts",
   "exports": {

package/src/OpenMeteo/current/useForecastCurrent.js

@@ -1,5 +1,5 @@
 /**
- * @module OpenMeteo:current
+ * Custom hook to fetch current weather data from OpenMeteo API.
  */
 
 import useSWR from "swr";
@@ -14,6 +14,7 @@ import transformer from "./transformer.js";
  * @param {number} lon
  * @param {number} refreshIntervalMin
  * @returns {{ data: any, apiUrl: string, isLoading: boolean, isError: any }}
+ * @memberof module:OpenMeteo
  */
 export function useForecastCurrent(lat, lon, refreshIntervalMin = 0) {
   if (!lat || !lon) {

package/src/OpenMeteo/daily/useForecastDaily.js

@@ -1,5 +1,5 @@
 /**
- * @module OpenMeteo:daily
+ * Custom hook to fetch daily forecast (10 days) data from OpenMeteo API.
  */
 
 import useSWR from "swr";
@@ -15,6 +15,7 @@ import transformer from "./transformer.js";
  * @param {number} lon
  * @param {number} refreshIntervalMin
  * @returns {{ data: any, isLoading: boolean, isError: any }}
+ * @memberof module:OpenMeteo
  */
 export function useForecastDaily(lat, lon, refreshIntervalMin = 0) {
   // Validate --

package/src/OpenMeteo/hourly/useForecastHourly.js

@@ -1,5 +1,5 @@
 /**
- * @module OpenMeteo:hourly
+ * Custom hook to fetch hourly forecast data for a given location and number of days from OpenMeteo API.
  */
 
 import useSWR from "swr";
@@ -13,6 +13,7 @@ import { fetchParams } from "./fetchParams.js";
  * @param {{ latitude: number, longitude: number }} location
  * @param {number} dayNum - Number of days from today: -1 = 24 hours, 0 = today, 1 = tomorrow, ...
  * @returns {{ data: any, isLoading: boolean, isError: any }}
+ * @memberof module:OpenMeteo
  */
 export function useForecastHourly(location, dayNum) {
   if (!location.latitude || !location.longitude) {

package/src/OpenMeteo/index.js

@@ -0,0 +1,9 @@
+/**
+ * @module OpenMeteo
+ *
+ */
+
+export { useForecastCurrent } from "./current/useForecastCurrent.js";
+export { useForecastDaily } from "./daily/useForecastDaily.js";
+export { useForecastHourly } from "./hourly/useForecastHourly.js";
+export { weatherSymbol } from "./weatherSymbol/weatherSymbol.js";

package/src/OpenMeteo/weatherSymbol/weatherSymbol.js

@@ -1,5 +1,5 @@
 /**
- * @module OpenMeteo:weatherSymbol
+ * Get weather symbol and description based on the weather code.
  */
 
 import { getWeatherCodeEntry } from "./lib/getWeatherCodeEntry.js";
@@ -12,6 +12,7 @@ import { getWeatherCodeEntry } from "./lib/getWeatherCodeEntry.js";
  * @param {boolean} night
  * @param {boolean} dark
  * @returns {{ icon: string, description: string }}
+ * @memberof module:OpenMeteo
  */
 export function weatherSymbol(
   code,

package/src/astronomy/index.js

@@ -0,0 +1,13 @@
+/**
+ * @module Astronomy
+ */
+
+export { default as MoonCalc } from "./moon/MoonCalc.js";
+export { default as SunCalc } from "./sun/SunCalc.js";
+export {
+  dateFormat,
+  getLocalTimeFromTz,
+  nowString,
+  timeString,
+} from "./timehelpers.js";
+export { getLocalTimeInfo as getLocalTime } from "./timeZoneInfo.js";

package/src/astronomy/moon/MoonCalc.js

@@ -1,9 +1,13 @@
 // @ts-nocheck
 /**
- * @module MoonCalc
- * @description
  * MoonCalc for calculating moon times, positions, and phases.
- * - import { MoonCalc } from '@angelrov/forecast';
+ *
+ *   import { MoonCalc } from ...
+ *
+ * Importante!:
+ * ¡Solo proporcionar HORA LOCAL DEL SISTEMA!: 'new Date()'
+ *
+ * @module Astronomy/MoonCalc
  */
 
 // @ts-ignore
@@ -12,14 +16,33 @@ import { dateFormat, getLocalTimeFromTz, timeString } from "../timehelpers.js";
 import { parseBasicData } from "./parseBasicData.js";
 
 /**
- * IMPORTANTE!!:
- * ¡Solo proporcionar HORA LOCAL DEL SISTEMA!: 'new Date()'
+ * @memberof module:Astronomy/MoonCalc
+ * @typedef {Object} MoonData
+ * @property {AstroPosition} position
+ * @property {Object} next
+ * @property {string} next.newMoon - Date of the next new moon.
+ * @property {string} next.fullMoon - Date of the next full moon.
  */
 
+/**
+ * Export
+ * @ignore
+ */
+const MoonCalc = {
+  data,
+  dataExt,
+  times,
+  emoji,
+  getUpOrDown,
+};
+export default MoonCalc;
+
 /**
  * Mapa de fases lunares.
+ * { phaseId, phaseName }
  *
  * @type {Object.<string, string>}
+ * @memberof module:Astronomy/MoonCalc
  */
 const phasesES = {
   newMoon: "Luna Nueva",
@@ -32,15 +55,6 @@ const phasesES = {
   waningCrescentMoon: "Luna Menguante",
 };
 
-const MoonCalc = {
-  data,
-  dataExt,
-  times,
-  emoji,
-  getUpOrDown,
-};
-export default MoonCalc;
-
 //--------------------------------------------------------------------
 /**
  * @param {number} latitude
@@ -48,6 +62,7 @@ export default MoonCalc;
  * @param {Date} [date=new Date()]
  * @param {string} [language=es-ES]
  * @returns {MoonData}
+ * @memberof module:Astronomy/MoonCalc
  */
 function data(latitude, longitude, date = new Date(), language = "es-ES") {
   // date.setHours(date.getHours() + 0); // debug
@@ -66,6 +81,7 @@ function data(latitude, longitude, date = new Date(), language = "es-ES") {
  * @param {Date} [date=new Date()]
  * @param {string} [language=es-ES]
  * @returns {{ date: string, time: string, illumination: string, phase: string, phaseId: string, emoji: string, parallacticAngle: number, angle: number, position: AstroPosition, next: object }}
+ * @memberof module:Astronomy/MoonCalc
  */
 function dataExt(latitude, longitude, date = new Date(), language = "es-ES") {
   const data = SunCalc.getMoonData(date, latitude, longitude);
@@ -107,6 +123,7 @@ function dataExt(latitude, longitude, date = new Date(), language = "es-ES") {
  * @param {number} longitude
  * @param {Date} [date=new Date()]
  * @returns {string} - Emoji of the moon phase
+ * @memberof module:Astronomy/MoonCalc
  */
 function emoji(latitude, longitude, date = new Date()) {
   const data = SunCalc.getMoonData(date, latitude, longitude);
@@ -119,6 +136,7 @@ function emoji(latitude, longitude, date = new Date()) {
  * @param {string} timezoneId
  * @param {Date} date
  * @returns {{rise: string, set: string, highest: string}}
+ * @memberof module:Astronomy/MoonCalc
  */
 function times(latitude, longitude, timezoneId, date = new Date()) {
   const ret = {
@@ -152,6 +170,7 @@ function times(latitude, longitude, timezoneId, date = new Date()) {
  * @param {number} altitude
  * @param {Date} highest
  * @returns {string} - Up or down emoji
+ * @memberof module:Astronomy/MoonCalc
  */
 function getUpOrDown(altitude, highest) {
   const now = new Date();

package/src/astronomy/moon/parseBasicData.js

@@ -1,9 +1,11 @@
+// @ts-nocheck
 import { degreesToCompass } from "../../utils/degreesToCompass.js";
 import { dateFormat } from "../timehelpers.js";
 
 /**
  * Parse basic data from SunCalc
  *
+ * @private
  * @param {any} data
  * @param {string} language
  * @returns {MoonData}

package/src/astronomy/sun/SunCalc.js

@@ -1,8 +1,13 @@
 /**
- * @module SunCalc
- * @description
- * SunCalc for calculating solar times, positions, and phases.  
- * - import { SunCalc } from '@angelrov/forecast';
+ * SunCalc for calculating solar times, positions, and phases.
+ *
+ *   import { SunCalc } from ...
+ *
+ * Importante:
+ * ¡Solo proporcionar HORA LOCAL DEL SISTEMA!: 'new Date()'
+ * Con excepción de 'getSolarTime()': recibe la hora local correspondiente a la localización dada.
+ *
+ * @module Astronomy/SunCalc
  */
 
 // @ts-ignore
@@ -16,12 +21,9 @@ import {
 } from "../timehelpers.js";
 
 /**
- * IMPORTANTE!!:
- * ¡Solo proporcionar HORA LOCAL DEL SISTEMA!: 'new Date()'
- * La única excepción es 'getSolarTime()': hay que darle la hora local correspondiente a la localización dada.
+ * Export
+ * @ignore
  */
-
-// Export ----
 const SunCalc = {
   all,
   times,
@@ -30,7 +32,6 @@ const SunCalc = {
   getIsNight,
   getPhase,
 };
-
 export default SunCalc;
 
 //-------------------------------------------------------
@@ -40,6 +41,7 @@ export default SunCalc;
  * @param {number} longitude
  * @param {string} timezoneId
  * @returns {{ sunTimes: object, sunPosition: object, sunPhase: string }}
+ * @memberof module:Astronomy/SunCalc
  */
 function all(date, latitude, longitude, timezoneId) {
   const sunTimes = SunCalc.times(date, latitude, longitude, timezoneId);
@@ -60,6 +62,7 @@ function all(date, latitude, longitude, timezoneId) {
  * @param {number} longitude
  * @param {string} timezoneId
  * @returns {{ date: Date, sunrise: string, sunset: string, noon: string, dawn: string, dusk: string }}
+ * @memberof module:Astronomy/SunCalc
  */
 function times(date, latitude, longitude, timezoneId) {
   const times = SunCalc3.getSunTimes(date, latitude, longitude);
@@ -83,6 +86,7 @@ function times(date, latitude, longitude, timezoneId) {
  * @param {string} offsetSign - "+" or "-"
  * @param {number} offset - UTC offset in hours
  * @returns {string} - Local time in "HH:mm" format
+ * @memberof module:Astronomy/SunCalc
  */
 function getSolarTime(date, lng, offsetSign, offset) {
   // Convert offsetSign and offset to a numeric UTC offset (e.g., -3, +2)
@@ -95,6 +99,7 @@ function getSolarTime(date, lng, offsetSign, offset) {
  * @param {number} latitude
  * @param {number} longitude
  * @returns {{date: string, azimuth: number, direction: string, direction_full: string, altitude: number, zenith: number, declination: number}}
+ * @memberof module:Astronomy/SunCalc
  */
 function position(latitude, longitude, date = new Date(), language = "es-ES") {
   const position = SunCalc3.getPosition(date, latitude, longitude);
@@ -122,6 +127,7 @@ function position(latitude, longitude, date = new Date(), language = "es-ES") {
  * @param {number | Date} date
  * @param {string} dateStr
  * @returns {boolean} - true if it's night, false otherwise
+ * @memberof module:Astronomy/SunCalc
  */
 function getIsNight(lat, lon, timezoneId, date, dateStr) {
   const times = SunCalc3.getSunTimes(date, lat, lon);
@@ -141,6 +147,7 @@ function getIsNight(lat, lon, timezoneId, date, dateStr) {
  * @param {number} altitude
  * @param {string} noon
  * @returns {string} - The phase of the sun based on its altitude
+ * @memberof module:Astronomy/SunCalc
  */
 function getPhase(altitude, noon) {
   const nowTime = nowString();

package/src/astronomy/timeZoneInfo.js

@@ -1,19 +1,22 @@
 // @ts-nocheck
 /**
- * @module astronomy/time-date
+ * Get local time from any location using Google Maps TimeZone API.
+ * - import { getLocalTimeInfo } from '@angelrov/forecast';
+ *
  */
 
 import { timeString } from "./timehelpers.js";
 
 //------------------------------------------------------
 /**
- * Google API: Get local time from any location
+ * Get local time from any location using Google Maps TimeZone API.
  *
  * @param {string} apiKey - GoogleMaps API key.
  * @param {number} lat
  * @param {number} lng
  * @returns {Promise<any | LocalTimeData>} - An object containing the local time and timezone information:
  * @throws {Error} - If the API request fails or returns an error status.
+ * @memberof module:Astronomy
  */
 export async function getLocalTimeInfo(apiKey, lat, lng) {
   const timestamp = Math.floor(Date.now() / 1000);