@angelrove/forecast-utils 1.1.18 → 1.1.19

package/README.md

@@ -24,13 +24,6 @@ I use private libraries for the following:
 ¡Solo proporcionar HORA LOCAL DEL SISTEMA!: 'new Date()'
 Con excepción de &#39;getSolarTime()&#39;: recibe la hora local correspondiente a la localización dada.</p>
 </dd>
-<dt><a href="#module_Geolocation">Geolocation</a></dt>
-<dd></dd>
-<dt><a href="#module_OpenMeteo">OpenMeteo</a></dt>
-<dd><p>Use the OpenWeather forecast API</p>
-</dd>
-<dt><a href="#module_Utils">Utils</a></dt>
-<dd></dd>
 <dt><a href="#module_Utils/TimeDateStr">Utils/TimeDateStr</a></dt>
 <dd><p>Helpers for get date and time formeted strings</p>
 </dd>
@@ -54,8 +47,8 @@ Importante!:
     * [.emoji(latitude, longitude, [date])](#module_Astronomy/MoonCalc.emoji) ⇒ <code>string</code>
     * [.times(latitude, longitude, timezoneId, date)](#module_Astronomy/MoonCalc.times) ⇒ <code>Object</code>
     * [.getUpOrDown(altitude, highest)](#module_Astronomy/MoonCalc.getUpOrDown) ⇒ <code>string</code>
-    * [.MoonDataExt](#module_Astronomy/MoonCalc.MoonDataExt) : <code>Object</code>
-    * [.MoonData](#module_Astronomy/MoonCalc.MoonData) : <code>Object</code>
+    * [.MoonDataExt](#module_Astronomy/MoonCalc.MoonDataExt) : <code>object</code>
+    * [.MoonData](#module_Astronomy/MoonCalc.MoonData) : <code>object</code>
 
 
 * * *
@@ -152,7 +145,7 @@ La fecha y hora se devolverán en la zona horaria local.
 
 <a name="module_Astronomy/MoonCalc.MoonDataExt"></a>
 
-### Astronomy/MoonCalc.MoonDataExt : <code>Object</code>
+### Astronomy/MoonCalc.MoonDataExt : <code>object</code>
 **Kind**: static typedef of [<code>Astronomy/MoonCalc</code>](#module_Astronomy/MoonCalc)  
 **Properties**
 
@@ -167,21 +160,21 @@ La fecha y hora se devolverán en la zona horaria local.
 | parallacticAngle | <code>number</code> | 
 | angle | <code>number</code> | 
 | position | <code>AstroPosition</code> | 
-| next | <code>Object</code> | 
+| next | <code>object</code> | 
 
 
 * * *
 
 <a name="module_Astronomy/MoonCalc.MoonData"></a>
 
-### Astronomy/MoonCalc.MoonData : <code>Object</code>
+### Astronomy/MoonCalc.MoonData : <code>object</code>
 **Kind**: static typedef of [<code>Astronomy/MoonCalc</code>](#module_Astronomy/MoonCalc)  
 **Properties**
 
 | Name | Type | Description |
 | --- | --- | --- |
 | position | <code>AstroPosition</code> |  |
-| next | <code>Object</code> |  |
+| next | <code>object</code> |  |
 | next.newMoon | <code>string</code> | Date of the next new moon. |
 | next.fullMoon | <code>string</code> | Date of the next full moon. |
 
@@ -215,7 +208,7 @@ Con excepción de 'getSolarTime()': recibe la hora local correspondiente a la lo
 
 ### Astronomy/SunCalc.all(date, latitude, longitude, timezoneId) ⇒ <code>Object</code>
 **Kind**: static method of [<code>Astronomy/SunCalc</code>](#module_Astronomy/SunCalc)  
-**Returns**: <code>Object</code> - { sunTimes: Object, sunPosition: Object, sunPhase: string }  
+**Returns**: <code>Object</code> - { sunTimes: object, sunPosition: object, sunPhase: string }  
 
 | Param | Type |
 | --- | --- |
@@ -302,412 +295,6 @@ Con excepción de 'getSolarTime()': recibe la hora local correspondiente a la lo
 | noon | <code>string</code> | 
 
 
-* * *
-
-<a name="module_Geolocation"></a>
-
-## Geolocation
-
-* [Geolocation](#module_Geolocation)
-    * [.exports.getGeolocation()](#module_Geolocation.exports.getGeolocation) ⇒ <code>Promise.&lt;ResolvedLocation&gt;</code>
-    * [.exports.timeFromLocation(apiKey, lat, lng)](#module_Geolocation.exports.timeFromLocation) ⇒ <code>Promise.&lt;(any\|LocalTimeData)&gt;</code>
-    * [.ResolvedLocation](#module_Geolocation.ResolvedLocation) : <code>Object</code>
-    * [.LocalTimeData](#module_Geolocation.LocalTimeData) : <code>Object</code>
-
-
-* * *
-
-<a name="module_Geolocation.exports.getGeolocation"></a>
-
-### Geolocation.exports.getGeolocation() ⇒ <code>Promise.&lt;ResolvedLocation&gt;</code>
-Get the current geolocation of the device and reverse geocode it to get the address.
-
-**Kind**: static method of [<code>Geolocation</code>](#module_Geolocation)  
-**Returns**: <code>Promise.&lt;ResolvedLocation&gt;</code> - Promise  
-**Throws**:
-
-- <code>Error</code> If geolocation is not supported or permission is denied.
-
-
-* * *
-
-<a name="module_Geolocation.exports.timeFromLocation"></a>
-
-### Geolocation.exports.timeFromLocation(apiKey, lat, lng) ⇒ <code>Promise.&lt;(any\|LocalTimeData)&gt;</code>
-Get local time from a given location (lat, lng) using 'GoogleMaps TimeZone' API.
-
-**Kind**: static method of [<code>Geolocation</code>](#module_Geolocation)  
-**Returns**: <code>Promise.&lt;(any\|LocalTimeData)&gt;</code> - An object containing the local time and timezone information:  
-**Throws**:
-
-- <code>Error</code> If the API request fails or returns an error status.
-
-
-| Param | Type | Description |
-| --- | --- | --- |
-| apiKey | <code>string</code> | GoogleMaps API key. |
-| lat | <code>number</code> |  |
-| lng | <code>number</code> |  |
-
-
-* * *
-
-<a name="module_Geolocation.ResolvedLocation"></a>
-
-### Geolocation.ResolvedLocation : <code>Object</code>
-**Kind**: static typedef of [<code>Geolocation</code>](#module_Geolocation)  
-**Properties**
-
-| Name | Type | Description |
-| --- | --- | --- |
-| latitude | <code>number</code> |  |
-| longitude | <code>number</code> | // Address |
-| sublocality | <code>string</code> |  |
-| locality | <code>string</code> |  |
-| country | <code>string</code> |  |
-| country_short | <code>string</code> |  |
-| formatted_address | <code>string</code> |  |
-
-
-* * *
-
-<a name="module_Geolocation.LocalTimeData"></a>
-
-### Geolocation.LocalTimeData : <code>Object</code>
-**Kind**: static typedef of [<code>Geolocation</code>](#module_Geolocation)  
-**Properties**
-
-| Name | Type | Description |
-| --- | --- | --- |
-| time | <code>Date</code> | The local time. |
-| timeStr | <code>string</code> | The formatted local time string. |
-| timezone | <code>string</code> | The timezone name. |
-| timezoneId | <code>string</code> | The timezone ID. |
-| offset | <code>number</code> | The UTC offset in hours. |
-| offsetSign | <code>string</code> | The sign of the offset ('+' or '-'). |
-| dstOffset | <code>number</code> | The DST offset in hours. |
-
-
-* * *
-
-<a name="module_OpenMeteo"></a>
-
-## OpenMeteo
-Use the OpenWeather forecast API
-
-
-* [OpenMeteo](#module_OpenMeteo)
-    * [.exports.useForecastCurrent(lat, lon, refreshIntervalMin)](#module_OpenMeteo.exports.useForecastCurrent) ⇒ <code>ForecastData</code>
-    * [.exports.useForecastDaily(lat, lon, refreshIntervalMin)](#module_OpenMeteo.exports.useForecastDaily) ⇒ <code>ForecastData</code>
-    * [.exports.useForecastHourly(location, dayNum)](#module_OpenMeteo.exports.useForecastHourly) ⇒ <code>ForecastData</code>
-    * [.exports.weatherSymbol(code, [precipitation], night, dark)](#module_OpenMeteo.exports.weatherSymbol) ⇒ <code>Object</code>
-    * [.ForecastData](#module_OpenMeteo.ForecastData) : <code>Object</code>
-
-
-* * *
-
-<a name="module_OpenMeteo.exports.useForecastCurrent"></a>
-
-### OpenMeteo.exports.useForecastCurrent(lat, lon, refreshIntervalMin) ⇒ <code>ForecastData</code>
-Custom hook to fetch current weather data from OpenMeteo API.
-
-**Kind**: static method of [<code>OpenMeteo</code>](#module_OpenMeteo)  
-**Returns**: <code>ForecastData</code> - {data, isLoading, isError, apiUrl}  
-
-| Param | Type |
-| --- | --- |
-| lat | <code>number</code> | 
-| lon | <code>number</code> | 
-| refreshIntervalMin | <code>number</code> | 
-
-
-* * *
-
-<a name="module_OpenMeteo.exports.useForecastDaily"></a>
-
-### OpenMeteo.exports.useForecastDaily(lat, lon, refreshIntervalMin) ⇒ <code>ForecastData</code>
-Custom hook to fetch daily forecast (10 days) data from OpenMeteo API.
-
-https://api.open-meteo.com/v1/forecast?timezone=auto&latitude=36.6644363&longitude=-4.5108962&forecast_days=10&daily=weathercode
-
-**Kind**: static method of [<code>OpenMeteo</code>](#module_OpenMeteo)  
-**Returns**: <code>ForecastData</code> - {data, isLoading, isError, apiUrl}  
-
-| Param | Type |
-| --- | --- |
-| lat | <code>number</code> | 
-| lon | <code>number</code> | 
-| refreshIntervalMin | <code>number</code> | 
-
-
-* * *
-
-<a name="module_OpenMeteo.exports.useForecastHourly"></a>
-
-### OpenMeteo.exports.useForecastHourly(location, dayNum) ⇒ <code>ForecastData</code>
-Custom hook to fetch hourly forecast data for a given location and number of days from OpenMeteo API.
-
-**Kind**: static method of [<code>OpenMeteo</code>](#module_OpenMeteo)  
-**Returns**: <code>ForecastData</code> - {data, isLoading, isError, apiUrl}  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| location | <code>Object</code> |  |
-| dayNum | <code>number</code> | Number of days from today: -1 = 24 hours, 0 = today, 1 = tomorrow, ... |
-
-
-* * *
-
-<a name="module_OpenMeteo.exports.weatherSymbol"></a>
-
-### OpenMeteo.exports.weatherSymbol(code, [precipitation], night, dark) ⇒ <code>Object</code>
-Get weather symbol and description based on the weather code.
-
-**Kind**: static method of [<code>OpenMeteo</code>](#module_OpenMeteo)  
-**Returns**: <code>Object</code> - { icon: string, description: string }  
-
-| Param | Type |
-| --- | --- |
-| code | <code>any</code> | 
-| [precipitation] | <code>number</code> | 
-| night | <code>boolean</code> | 
-| dark | <code>boolean</code> | 
-
-
-* * *
-
-<a name="module_OpenMeteo.ForecastData"></a>
-
-### OpenMeteo.ForecastData : <code>Object</code>
-**Kind**: static typedef of [<code>OpenMeteo</code>](#module_OpenMeteo)  
-**Properties**
-
-| Name | Type | Description |
-| --- | --- | --- |
-| data | <code>any</code> | Forecast data |
-| isLoading | <code>boolean</code> | Loading state |
-| isError | <code>any</code> | Error state |
-| apiUrl | <code>string</code> | API URL |
-
-
-* * *
-
-<a name="module_Utils"></a>
-
-## Utils
-
-* [Utils](#module_Utils)
-    * [.directions](#module_Utils.directions) : <code>Array.&lt;Compass&gt;</code>
-    * [.directionsEs](#module_Utils.directionsEs) : <code>Array.&lt;Compass&gt;</code>
-    * [.ALERT_LEVEL](#module_Utils.ALERT_LEVEL) : <code>Array.&lt;AlertLevel&gt;</code>
-    * [.WIND_LEVELS](#module_Utils.WIND_LEVELS) : <code>Array.&lt;WindLevel&gt;</code>
-    * [.exports.degreesToCompass(degrees, language)](#module_Utils.exports.degreesToCompass) ⇒ <code>Object</code>
-    * [.exports.getWarningByDays(precipitationSumToday, precipitationSumTomorrow, showersSumToday, showersSumTomorrow)](#module_Utils.exports.getWarningByDays) ⇒ <code>Object</code> \| <code>null</code>
-    * [.exports.getWarning(precipitation, showers)](#module_Utils.exports.getWarning) ⇒ <code>Object</code> \| <code>null</code>
-    * [.exports.WindArrow(props)](#module_Utils.exports.WindArrow)
-    * [.exports.windArrowTx(deg)](#module_Utils.exports.windArrowTx) ⇒ <code>string</code>
-    * [.exports.getWindLevel(speed)](#module_Utils.exports.getWindLevel) ⇒ <code>WindLevel</code> \| <code>null</code>
-    * [.Compass](#module_Utils.Compass) : <code>Object</code>
-    * [.AlertLevel](#module_Utils.AlertLevel) : <code>Object</code>
-    * [.WindLevel](#module_Utils.WindLevel) : <code>Object</code>
-
-
-* * *
-
-<a name="module_Utils.directions"></a>
-
-### Utils.directions : <code>Array.&lt;Compass&gt;</code>
-English compass designations
-
-**Kind**: static constant of [<code>Utils</code>](#module_Utils)  
-**Properties**
-
-| Name | Type | Description |
-| --- | --- | --- |
-| short | <code>string</code> | Short compass designation |
-| full | <code>string</code> | Full compass designation |
-
-
-* * *
-
-<a name="module_Utils.directionsEs"></a>
-
-### Utils.directionsEs : <code>Array.&lt;Compass&gt;</code>
-Spanish compass designations
-
-**Kind**: static constant of [<code>Utils</code>](#module_Utils)  
-**Properties**
-
-| Name | Type | Description |
-| --- | --- | --- |
-| short | <code>string</code> | Short compass designation |
-| full | <code>string</code> | Full compass designation |
-
-
-* * *
-
-<a name="module_Utils.ALERT_LEVEL"></a>
-
-### Utils.ALERT\_LEVEL : <code>Array.&lt;AlertLevel&gt;</code>
-Alert levels for rain and showers
-
-**Kind**: static constant of [<code>Utils</code>](#module_Utils)  
-
-* * *
-
-<a name="module_Utils.WIND_LEVELS"></a>
-
-### Utils.WIND\_LEVELS : <code>Array.&lt;WindLevel&gt;</code>
-Ordered list of wind levels.
-
-**Kind**: static constant of [<code>Utils</code>](#module_Utils)  
-
-* * *
-
-<a name="module_Utils.exports.degreesToCompass"></a>
-
-### Utils.exports.degreesToCompass(degrees, language) ⇒ <code>Object</code>
-Convert degrees to compass designation
-
-**Kind**: static method of [<code>Utils</code>](#module_Utils)  
-**Returns**: <code>Object</code> - {short: string, full: string}  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| degrees | <code>number</code> |  |
-| language | <code>string</code> | Language code ("en-US", "es-ES", "auto") |
-
-
-* * *
-
-<a name="module_Utils.exports.getWarningByDays"></a>
-
-### Utils.exports.getWarningByDays(precipitationSumToday, precipitationSumTomorrow, showersSumToday, showersSumTomorrow) ⇒ <code>Object</code> \| <code>null</code>
-Get warning by today and tomorrow
-
-**Kind**: static method of [<code>Utils</code>](#module_Utils)  
-**Returns**: <code>Object</code> \| <code>null</code> - {{ levelNum: number, level: string, message: string, day: number } | null}  
-
-| Param | Type |
-| --- | --- |
-| precipitationSumToday | <code>number</code> | 
-| precipitationSumTomorrow | <code>number</code> | 
-| showersSumToday | <code>number</code> | 
-| showersSumTomorrow | <code>number</code> | 
-
-
-* * *
-
-<a name="module_Utils.exports.getWarning"></a>
-
-### Utils.exports.getWarning(precipitation, showers) ⇒ <code>Object</code> \| <code>null</code>
-Get warning by precipitation and showers
-
-**Kind**: static method of [<code>Utils</code>](#module_Utils)  
-**Returns**: <code>Object</code> \| <code>null</code> - {{ levelNum: number, level: string, message: string } | null}  
-
-| Param | Type |
-| --- | --- |
-| precipitation | <code>number</code> | 
-| showers | <code>number</code> | 
-
-
-* * *
-
-<a name="module_Utils.exports.WindArrow"></a>
-
-### Utils.exports.WindArrow(props)
-SVG arrow indicating wind direction.
-
-**Kind**: static method of [<code>Utils</code>](#module_Utils)  
-**Component**: JSX  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| props | <code>Object</code> | Component props. |
-| props.deg | <code>number</code> | Wind direction in degrees (0 = North, 90 = East, etc.). |
-| [props.size] | <code>string</code> | Tailwind CSS size class (e.g., 'size-10') |
-| [props.strokeWidth] | <code>number</code> | Stroke width of the arrow (range: 1–6). |
-| [props.className] | <code>string</code> | Additional CSS classes. |
-
-
-* * *
-
-<a name="module_Utils.exports.windArrowTx"></a>
-
-### Utils.exports.windArrowTx(deg) ⇒ <code>string</code>
-Convert wind direction in degrees to an arrow representation.
-
-**Kind**: static method of [<code>Utils</code>](#module_Utils)  
-**Returns**: <code>string</code> - Arrow representation of the wind direction.  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| deg | <code>number</code> | Wind direction in degrees. |
-
-
-* * *
-
-<a name="module_Utils.exports.getWindLevel"></a>
-
-### Utils.exports.getWindLevel(speed) ⇒ <code>WindLevel</code> \| <code>null</code>
-Return the wind level based on the speed.
-
-**Kind**: static method of [<code>Utils</code>](#module_Utils)  
-**Returns**: <code>WindLevel</code> \| <code>null</code> - Wind level object or null if speed is null  
-
-| Param | Type | Description |
-| --- | --- | --- |
-| speed | <code>number</code> | Wind speed in km/h |
-
-
-* * *
-
-<a name="module_Utils.Compass"></a>
-
-### Utils.Compass : <code>Object</code>
-**Kind**: static typedef of [<code>Utils</code>](#module_Utils)  
-**Properties**
-
-| Name | Type | Description |
-| --- | --- | --- |
-| short | <code>string</code> | Short compass designation |
-| full | <code>string</code> | Full compass designation |
-
-
-* * *
-
-<a name="module_Utils.AlertLevel"></a>
-
-### Utils.AlertLevel : <code>Object</code>
-**Kind**: static typedef of [<code>Utils</code>](#module_Utils)  
-**Properties**
-
-| Name | Type | Description |
-| --- | --- | --- |
-| levelNum | <code>number</code> | The alert level number. |
-| level | <code>string</code> | The alert level string (e.g., "red", "orange", "yellow"). |
-| precipitation | <code>number</code> | The precipitation threshold for the alert level. |
-| showers | <code>number</code> | The showers threshold for the alert level. |
-
-
-* * *
-
-<a name="module_Utils.WindLevel"></a>
-
-### Utils.WindLevel : <code>Object</code>
-**Kind**: static typedef of [<code>Utils</code>](#module_Utils)  
-**Properties**
-
-| Name | Type | Description |
-| --- | --- | --- |
-| id | <code>number</code> | Level ID |
-| speed | <code>number</code> | Minimum wind speed for this level |
-| color | <code>string</code> | Color representing this level |
-| tx | <code>string</code> | Text representing this level |
-| txEn | <code>string</code> | Text representing this level |
-
-
 * * *
 
 <a name="module_Utils/TimeDateStr"></a>

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

@@ -2,7 +2,7 @@
  * Transforms the OpenMeteo API data into a more usable format.
  *
  * @param {{current: any, daily: any, hourly: any, latitude: number, longitude: number}} data - The data object to transform.
- * @returns {Object|null} - The transformed data object or null if the input is invalid.
+ * @returns {object|null} - The transformed data object or null if the input is invalid.
  */
 export default function transformer(data: {
     current: any;
@@ -10,4 +10,4 @@ export default function transformer(data: {
     hourly: any;
     latitude: number;
     longitude: number;
-}): Object | null;
+}): object | null;

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

@@ -1,10 +1,5 @@
+import type { ForecastData } from "../types";
 /**
  * Custom hook to fetch current weather data from OpenMeteo API.
- *
- * @param {number} lat
- * @param {number} lon
- * @param {number} refreshIntervalMin
- * @returns {ForecastData} {data, isLoading, isError, apiUrl}
- * @memberof module:OpenMeteo
  */
-export function useForecastCurrent(lat: number, lon: number, refreshIntervalMin?: number): ForecastData;
+export declare function useForecastCurrent(lat: number | undefined, lon: number | undefined, refreshIntervalMin?: number): ForecastData;

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

@@ -2,8 +2,8 @@
  * Transforms the OpenMeteo API data into a more usable format.
  *
  * @param {{daily: any}} data - The data object to transform.
- * @returns {Object|null} - The transformed data object or null if the input is invalid.
+ * @returns {object|null} - The transformed data object or null if the input is invalid.
  */
 export default function transformer(data: {
     daily: any;
-}): Object | null;
+}): object | null;

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

@@ -1,12 +1,6 @@
+import type { ForecastData } from "../types";
 /**
  * Custom hook to fetch daily forecast (10 days) data from OpenMeteo API.
- *
  * https://api.open-meteo.com/v1/forecast?timezone=auto&latitude=36.6644363&longitude=-4.5108962&forecast_days=10&daily=weathercode
- *
- * @param {number} lat
- * @param {number} lon
- * @param {number} refreshIntervalMin
- * @returns {ForecastData} {data, isLoading, isError, apiUrl}
- * @memberof module:OpenMeteo
  */
-export function useForecastDaily(lat: number, lon: number, refreshIntervalMin?: number): ForecastData;
+export declare function useForecastDaily(lat: number | undefined, lon: number | undefined, refreshIntervalMin?: number): ForecastData;

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

@@ -1,12 +1,5 @@
+import type { ForecastData } from "../types";
 /**
  * Custom hook to fetch hourly forecast data for a given location and number of days from OpenMeteo API.
- *
- * @param {{ latitude: number, longitude: number }} location
- * @param {number} dayNum Number of days from today: -1 = 24 hours, 0 = today, 1 = tomorrow, ...
- * @returns {ForecastData} {data, isLoading, isError, apiUrl}
- * @memberof module:OpenMeteo
  */
-export function useForecastHourly(location: {
-    latitude: number;
-    longitude: number;
-}, dayNum: number): ForecastData;
+export declare function useForecastHourly(lat: number, lon: number, dayNum: number): ForecastData;

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

@@ -1,4 +1,9 @@
-export { useForecastCurrent } from "./current/useForecastCurrent.js";
-export { useForecastDaily } from "./daily/useForecastDaily.js";
-export { useForecastHourly } from "./hourly/useForecastHourly.js";
-export { weatherSymbol } from "./weatherSymbol/weatherSymbol.js";
+/**
+ * Use the OpenWeather forecast API
+ * @package OpenMeteo
+ *
+ */
+export { useForecastCurrent } from "./current/useForecastCurrent";
+export { useForecastDaily } from "./daily/useForecastDaily";
+export { useForecastHourly } from "./hourly/useForecastHourly";
+export { weatherSymbol } from "./weatherSymbol/weatherSymbol";

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

@@ -1,18 +1,13 @@
-type ForecastData = {
-    /**
-     * - Forecast data
-     */
+/**
+ * @memberof module:OpenMeteo
+ */
+export type ForecastData = {
     data: any;
-    /**
-     * - Loading state
-     */
-    isLoading: boolean;
-    /**
-     * - Error state
-     */
-    isError: any;
-    /**
-     * - API URL
-     */
     apiUrl: string;
+    isLoading: boolean;
+    isError: unknown;
+};
+export type WeatherSymbol = {
+    icon: string;
+    description: string;
 };

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

@@ -20,7 +20,7 @@
  * 96, 99 *	  Thunderstorm with slight and heavy hail
  */
 /**
- * @typedef {Object} WeatherCodeEntry
+ * @typedef {object} WeatherCodeEntry
  * @property {number} code - WMO Weather interpretation codes (WW).
  * @property {string} icon - Icon name.
  * @property {string} description - Description.

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

@@ -20,7 +20,7 @@
  * 96, 99 *	  Thunderstorm with slight and heavy hail
  */
 /**
- * @typedef {Object} WeatherCodeEntry
+ * @typedef {object} WeatherCodeEntry
  * @property {number} code - WMO Weather interpretation codes (WW).
  * @property {string} icon - Icon name.
  * @property {string} description - Description.

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

@@ -1,15 +1,6 @@
+import type { WeatherSymbol } from "../types";
 /**
  * Get weather symbol and description based on the weather code.
- *
- * @param {any} code
- * @param {number} [precipitation]
- * @param {boolean} night
- * @param {boolean} dark
- * @returns {{ icon: string, description: string }}
- * { icon: string, description: string }
  * @memberof module:OpenMeteo
  */
-export function weatherSymbol(code: any, precipitation?: number, night?: boolean, dark?: boolean): {
-    icon: string;
-    description: string;
-};
+export declare function weatherSymbol(code: any, precipitation?: number | undefined, night?: boolean, dark?: boolean): WeatherSymbol;

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

@@ -18,7 +18,7 @@ export type MoonDataExt = {
     parallacticAngle: number;
     angle: number;
     position: AstroPosition;
-    next: Object;
+    next: object;
 };
 export type MoonData = {
     position: AstroPosition;

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

@@ -12,13 +12,13 @@ declare namespace SunCalc {
  * @param {number} latitude
  * @param {number} longitude
  * @param {string} timezoneId
- * @returns {{ sunTimes: Object, sunPosition: Object, sunPhase: string }}
- * { sunTimes: Object, sunPosition: Object, sunPhase: string }
+ * @returns {{ sunTimes: object, sunPosition: object, sunPhase: string }}
+ * { sunTimes: object, sunPosition: object, sunPhase: string }
  * @memberof module:Astronomy/SunCalc
  */
 declare function all(date: Date, latitude: number, longitude: number, timezoneId: string): {
-    sunTimes: Object;
-    sunPosition: Object;
+    sunTimes: object;
+    sunPosition: object;
     sunPhase: string;
 };
 /**

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

@@ -1,6 +1,6 @@
 /**
  * @memberof module:Geolocation
- * @typedef {Object} ResolvedLocation
+ * @typedef {object} ResolvedLocation
  * @property {number} latitude
  * @property {number} longitude
  * // Address

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

@@ -1,2 +1,5 @@
+/**
+ * @module Geolocation
+ */
 export { getGeolocation } from "./getGeolocation.js";
 export { timeFromLocation } from "./timeFromLocation.js";

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

@@ -1,6 +1,6 @@
 /**
  * @memberof module:Geolocation
- * @typedef {Object} LocalTimeData
+ * @typedef {object} LocalTimeData
  * @property {Date} time - The local time.
  * @property {string} timeStr - The formatted local time string.
  * @property {string} timezone - The timezone name.

package/dist/types/index.d.ts

@@ -8,7 +8,7 @@ export { useForecastDaily } from "./OpenMeteo/daily/useForecastDaily";
 export { useForecastHourly } from "./OpenMeteo/hourly/useForecastHourly";
 export { weatherSymbol } from "./OpenMeteo/weatherSymbol/weatherSymbol";
 export { degreesToCompass } from "./utils/degreesToCompass";
+export { getWarning, getWarningByDays } from "./utils/warning";
 export { WindArrow } from "./utils/wind/WindArrow";
 export { windArrowTx } from "./utils/wind/windArrowTx";
 export { getWindLevel } from "./utils/wind/windLevel";
-export { getWarning, getWarningByDays } from "./utils/warning";

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

@@ -1,6 +1,9 @@
+/**
+ * @module Utils
+ */
 export { degreesToCompass } from "./degreesToCompass.js";
 export { default as TimeDateStr } from "./timehelpers.js";
+export { getWarning, getWarningByDays } from "./warning.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/wind/WindArrow.d.ts

@@ -2,7 +2,7 @@
  * SVG arrow indicating wind direction.
  *
  * @component JSX
- * @param {Object} props - Component props.
+ * @param {object} props - Component props.
  * @param {number} props.deg - Wind direction in degrees (0 = North, 90 = East, etc.).
  * @param {string} [props.size] - Tailwind CSS size class (e.g., 'size-10')
  * @param {number} [props.strokeWidth] - Stroke width of the arrow (range: 1–6).

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "Jose Angel Romero Vegas",
   "name": "@angelrove/forecast-utils",
-  "version": "1.1.18",
+  "version": "1.1.19",
   "description": "Utilities for obtaining weather and astronomy forecast data.",
   "license": "MIT",
   "publishConfig": {
@@ -32,10 +32,10 @@
     "JavaScript"
   ],
   "peerDependencies": {
+    "@capacitor/geolocation": "^7.1.2",
     "react": "^19.1.0",
     "suncalc3": "^2.0.5",
-    "swr": "^2.3.3",
-    "@capacitor/geolocation": "^7.1.2"
+    "swr": "^2.3.3"
   },
   "devDependencies": {
     "@biomejs/biome": "2.2.4",
@@ -43,6 +43,5 @@
     "@types/react-dom": "^19.1.9",
     "jsdoc-to-markdown": "^9.1.2",
     "typescript": "^5.9.2"
-  },
-  "dependencies": {}
+  }
 }

package/src/OpenMeteo/conf.js

@@ -39,7 +39,7 @@ export function getPath(lat, lon, path) {
  * @param {string} url
  */
 function devLog(title, url) {
-  // @ts-ignore
+  /* @ts-expect-error */
   if (import.meta.env.MODE === "development") {
     // console.log('%c> fetch [' + title + ']:', 'color:#9e9', url);
     console.log("> fetch [" + title + "]:", url);

package/src/OpenMeteo/current/transformer.js

@@ -2,7 +2,7 @@
  * Transforms the OpenMeteo API data into a more usable format.
  *
  * @param {{current: any, daily: any, hourly: any, latitude: number, longitude: number}} data - The data object to transform.
- * @returns {Object|null} - The transformed data object or null if the input is invalid.
+ * @returns {object|null} - The transformed data object or null if the input is invalid.
  */
 export default function transformer(data) {
   if (!data) return null;

package/src/OpenMeteo/current/{useForecastCurrent.js → useForecastCurrent.ts}

@@ -1,23 +1,23 @@
-// @ts-nocheck
 import useSWR from "swr";
 import { fetcher, getPath } from "../conf.js";
+import type { ForecastData } from "../types";
 import { fetchParams } from "./fetchParams.js";
 import transformer from "./transformer.js";
 
 /**
  * Custom hook to fetch current weather data from OpenMeteo API.
- *
- * @param {number} lat
- * @param {number} lon
- * @param {number} refreshIntervalMin
- * @returns {ForecastData} {data, isLoading, isError, apiUrl}
- * @memberof module:OpenMeteo
  */
-export function useForecastCurrent(lat, lon, refreshIntervalMin = 0) {
-  if (!lat || !lon) {
+export function useForecastCurrent(
+  lat: number | undefined,
+  lon: number | undefined,
+  refreshIntervalMin: number = 0): ForecastData
+  {
+  // Validate --
+  if (lat == null || lon == null) {
     throw new Error("useForecastCurrent: invalid coordinates");
   }
 
+  // Fetch ---
   const apiUrl = getPath(lat, lon, fetchParams);
   const { data, error, isLoading } = useSWR(apiUrl, fetcher, {
     refreshInterval: refreshIntervalMin * 60 * 1000,

package/src/OpenMeteo/daily/transformer.js

@@ -2,7 +2,7 @@
  * Transforms the OpenMeteo API data into a more usable format.
  *
  * @param {{daily: any}} data - The data object to transform.
- * @returns {Object|null} - The transformed data object or null if the input is invalid.
+ * @returns {object|null} - The transformed data object or null if the input is invalid.
  */
 export default function transformer(data) {
   if (!data) return null;

package/src/OpenMeteo/daily/{useForecastDaily.js → useForecastDaily.ts}

@@ -1,23 +1,20 @@
-// @ts-nocheck
 import useSWR from "swr";
 import { fetcher, getPath } from "../conf.js";
+import type { ForecastData } from "../types";
 import { fetchParams } from "./fetchParams.js";
 import transformer from "./transformer.js";
 
 /**
  * Custom hook to fetch daily forecast (10 days) data from OpenMeteo API.
- *
  * https://api.open-meteo.com/v1/forecast?timezone=auto&latitude=36.6644363&longitude=-4.5108962&forecast_days=10&daily=weathercode
- *
- * @param {number} lat
- * @param {number} lon
- * @param {number} refreshIntervalMin
- * @returns {ForecastData} {data, isLoading, isError, apiUrl}
- * @memberof module:OpenMeteo
  */
-export function useForecastDaily(lat, lon, refreshIntervalMin = 0) {
+export function useForecastDaily(
+  lat: number | undefined,
+  lon: number | undefined,
+  refreshIntervalMin: number = 0): ForecastData
+  {
   // Validate --
-  if (!lat || !lon) {
+  if (lat == null || lon == null) {
     throw new Error("useForecastDaily: invalid coordinates");
   }
 

package/src/OpenMeteo/hourly/{useForecastHourly.js → useForecastHourly.ts}

@@ -1,20 +1,21 @@
-// @ts-nocheck
 import useSWR from "swr";
 import { fetcher, getPath } from "../conf.js";
 import { getDatesFromNumDays } from "../helpers.js";
+import type { ForecastData } from "../types";
 import { fetchParams } from "./fetchParams.js";
 
 /**
  * Custom hook to fetch hourly forecast data for a given location and number of days from OpenMeteo API.
- *
- * @param {{ latitude: number, longitude: number }} location
- * @param {number} dayNum Number of days from today: -1 = 24 hours, 0 = today, 1 = tomorrow, ...
- * @returns {ForecastData} {data, isLoading, isError, apiUrl}
- * @memberof module:OpenMeteo
  */
-export function useForecastHourly(location, dayNum) {
-  if (!location.latitude || !location.longitude) {
-    throw new Error("useForecastHourly: invalid coordinates");
+export function useForecastHourly(
+  lat: number,
+  lon: number,
+  dayNum: number): ForecastData
+  {
+
+  // Validate --
+  if (lat == null || lon == null) {
+    throw new Error("useForecastHourly: invalid coordinates: ["+lon+"]["+lat+"]");
   }
 
   // Fetch ---
@@ -28,7 +29,7 @@ export function useForecastHourly(location, dayNum) {
     dates.endDate +
     "&" +
     fetchParams;
-  apiUrl = getPath(location.latitude, location.longitude, apiUrl);
+  apiUrl = getPath(lat, lon, apiUrl);
 
   const { data, error, isLoading } = useSWR(apiUrl, fetcher);
 

package/src/OpenMeteo/index.ts

@@ -0,0 +1,11 @@
+/**
+ * Use the OpenWeather forecast API
+ * @package OpenMeteo
+ *
+ */
+
+export { useForecastCurrent } from "./current/useForecastCurrent";
+export { useForecastDaily } from "./daily/useForecastDaily";
+export { useForecastHourly } from "./hourly/useForecastHourly";
+export { weatherSymbol } from "./weatherSymbol/weatherSymbol";
+

package/src/OpenMeteo/types.ts

@@ -0,0 +1,15 @@
+/**
+ * @memberof module:OpenMeteo
+ */
+
+export type ForecastData = {
+  data: any; // 👈 Cambiar al tipo real que devuelve `transformer`
+  apiUrl: string;
+  isLoading: boolean;
+  isError: unknown;
+};
+
+export type WeatherSymbol = {
+  icon: string;
+  description: string;
+};

package/src/OpenMeteo/weatherSymbol/lib/WeatherCodesEn.js

@@ -21,7 +21,7 @@
  */
 
 /**
- * @typedef {Object} WeatherCodeEntry
+ * @typedef {object} WeatherCodeEntry
  * @property {number} code - WMO Weather interpretation codes (WW).
  * @property {string} icon - Icon name.
  * @property {string} description - Description.

package/src/OpenMeteo/weatherSymbol/lib/WeatherCodesEs.js

@@ -21,7 +21,7 @@
  */
 
 /**
- * @typedef {Object} WeatherCodeEntry
+ * @typedef {object} WeatherCodeEntry
  * @property {number} code - WMO Weather interpretation codes (WW).
  * @property {string} icon - Icon name.
  * @property {string} description - Description.

package/src/OpenMeteo/weatherSymbol/{weatherSymbol.js → weatherSymbol.ts}

@@ -1,22 +1,17 @@
+import type { WeatherSymbol } from "../types";
 import { getWeatherCodeEntry } from "./lib/getWeatherCodeEntry.js";
 
 /**
  * Get weather symbol and description based on the weather code.
- *
- * @param {any} code
- * @param {number} [precipitation]
- * @param {boolean} night
- * @param {boolean} dark
- * @returns {{ icon: string, description: string }}
- * { icon: string, description: string }
  * @memberof module:OpenMeteo
  */
 export function weatherSymbol(
-  code,
-  precipitation = undefined,
-  night = false,
-  dark = false,
-) {
+  code: any,
+  precipitation: number | undefined = undefined,
+  night: boolean = false,
+  dark: boolean = false,
+): WeatherSymbol
+{
   // Parse code ---
   let msgPlus = "";
   let theCode = code;

package/src/astronomy/moon/MoonCalc.js

@@ -9,7 +9,7 @@
  * @module Astronomy/MoonCalc
  */
 
-// @ts-ignore
+/* @ts-expect-error */
 import SunCalc from "suncalc3";
 import TimeDateStr from "../../utils/timehelpers.js";
 import { parseBasicData } from "./parseBasicData.js";
@@ -29,7 +29,7 @@ export default MoonCalc;
 
 /**
  * @memberof module:Astronomy
- * @typedef {Object} AstroPosition
+ * @typedef {object} AstroPosition
  * @property {number} altitude
  * @property {number} azimuth
  * @property {string} direction
@@ -38,7 +38,7 @@ export default MoonCalc;
 
 /**
  * @memberof module:Astronomy/MoonCalc
- * @typedef {Object} MoonDataExt
+ * @typedef {object} MoonDataExt
  * @property {string} date
  * @property {string} time
  * @property {string} illumination
@@ -48,14 +48,14 @@ export default MoonCalc;
  * @property {number} parallacticAngle
  * @property {number} angle
  * @property {AstroPosition} position
- * @property {Object} next
+ * @property {object} next
  */
 
 /**
  * @memberof module:Astronomy/MoonCalc
- * @typedef {Object} MoonData
+ * @typedef {object} MoonData
  * @property {AstroPosition} position
- * @property {Object} next
+ * @property {object} next
  * @property {string} next.newMoon - Date of the next new moon.
  * @property {string} next.fullMoon - Date of the next full moon.
  */

package/src/astronomy/sun/SunCalc.js

@@ -10,7 +10,7 @@
  * @module Astronomy/SunCalc
  */
 
-// @ts-ignore
+/* @ts-expect-error */
 import { default as SunCalc3 } from "suncalc3";
 import { degreesToCompass } from "../../utils/degreesToCompass.js";
 import TimeDateStr from "../../utils/timehelpers.js";
@@ -35,8 +35,8 @@ export default SunCalc;
  * @param {number} latitude
  * @param {number} longitude
  * @param {string} timezoneId
- * @returns {{ sunTimes: Object, sunPosition: Object, sunPhase: string }}
- * { sunTimes: Object, sunPosition: Object, sunPhase: string }
+ * @returns {{ sunTimes: object, sunPosition: object, sunPhase: string }}
+ * { sunTimes: object, sunPosition: object, sunPhase: string }
  * @memberof module:Astronomy/SunCalc
  */
 function all(date, latitude, longitude, timezoneId) {

package/src/geolocation/getGeolocation.js

@@ -3,7 +3,7 @@ import reverseGeocoding from "./lib/reversegeocoding.js";
 
 /**
  * @memberof module:Geolocation
- * @typedef {Object} ResolvedLocation
+ * @typedef {object} ResolvedLocation
  * @property {number} latitude
  * @property {number} longitude
  * // Address
@@ -39,7 +39,7 @@ export async function getGeolocation() {
     address = await reverseGeocoding(
       location.latitude,
       location.longitude,
-      // @ts-ignore
+      /* @ts-expect-error */
       import.meta.env.VITE_googlemaps_api_key,
     );
   } catch (error) {

package/src/geolocation/lib/geolocation.js

@@ -31,15 +31,15 @@ export default async function geolocation() {
   } catch (error) {
     console.error(error);
 
-    // @ts-ignore
+    /* @ts-expect-error */
     if (error.code === error.PERMISSION_DENIED) {
       throw new Error("Geolocation: permission denied");
     }
-    // @ts-ignore
+    /* @ts-expect-error */
     if (error.code === error.POSITION_UNAVAILABLE) {
       throw new Error("Geolocation: position unavailable");
     }
-    // @ts-ignore
+    /* @ts-expect-error */
     if (error.code === error.TIMEOUT) {
       throw new Error("Geolocation: timeout");
     }

package/src/geolocation/lib/reversegeocoding.js

@@ -102,7 +102,7 @@ export default async function reverseGeocoding(latitude, longitude, api_key) {
  * @param {any} url
  */
 function devLog(title, url) {
-  // @ts-ignore
+  /* @ts-expect-error */
   if (import.meta.env.MODE === "development") {
     console.log(`> fetch [${title}]:`, url);
   }

package/src/geolocation/timeFromLocation.js

@@ -3,7 +3,7 @@ import TimeDateStr from "../utils/timehelpers.js";
 
 /**
  * @memberof module:Geolocation
- * @typedef {Object} LocalTimeData
+ * @typedef {object} LocalTimeData
  * @property {Date} time - The local time.
  * @property {string} timeStr - The formatted local time string.
  * @property {string} timezone - The timezone name.
@@ -55,7 +55,7 @@ export async function timeFromLocation(apiKey, lat, lng) {
 //------------------------------------------------------
 /**
  * @private
- * @param {Object} timezoneInfo - The timezone Google API information.
+ * @param {object} timezoneInfo - The timezone Google API information.
  * @param {number} timezoneInfo.rawOffset - The raw offset in seconds.
  * @param {number} timezoneInfo.dstOffset - The DST offset in seconds.
  * @param {string} timezoneInfo.timeZoneName - The name of the timezone.

package/src/utils/degreesToCompass.js

@@ -3,7 +3,7 @@
  */
 
 /**
- * @typedef {Object} Compass
+ * @typedef {object} Compass
  * @property {string} short - Short compass designation
  * @property {string} full - Full compass designation
  * @memberof module:Utils

package/src/utils/timehelpers.js

@@ -30,7 +30,7 @@ function dateFormat(date = new Date()) {
     day: "numeric",
     month: "short",
   };
-  // @ts-ignore
+  /* @ts-expect-error */
   return date.toLocaleDateString([], options);
 }
 //------------------------------------------------------

package/src/utils/warning.js

@@ -1,5 +1,5 @@
 /**
- * @typedef {Object} AlertLevel
+ * @typedef {object} AlertLevel
  * @property {number} levelNum - The alert level number.
  * @property {string} level - The alert level string (e.g., "red", "orange", "yellow").
  * @property {number} precipitation - The precipitation threshold for the alert level.

package/src/utils/wind/WindArrow.jsx

@@ -2,7 +2,7 @@
  * SVG arrow indicating wind direction.
  *
  * @component JSX
- * @param {Object} props - Component props.
+ * @param {object} props - Component props.
  * @param {number} props.deg - Wind direction in degrees (0 = North, 90 = East, etc.).
  * @param {string} [props.size] - Tailwind CSS size class (e.g., 'size-10')
  * @param {number} [props.strokeWidth] - Stroke width of the arrow (range: 1–6).
@@ -17,13 +17,12 @@ export function WindArrow({
 }) {
   if (deg == null) {
     // console.warn("WindArrow: deg is undefined");
-    /* @ts-ignore */
     return <div>deg?</div>;
   }
 
   // Render arrow ---
   return (
-    /* @ts-ignore */
+    /*·@ts-expect-error·*/
     <svg
       className={`${size} ${className}`}
       style={{ transform: `rotate(${deg}deg)` }}

package/src/utils/wind/windLevel.js

@@ -1,5 +1,5 @@
 /**
- * @typedef {Object} WindLevel
+ * @typedef {object} WindLevel
  * @property {number} id - Level ID
  * @property {number} speed - Minimum wind speed for this level
  * @property {string} color - Color representing this level

package/src/OpenMeteo/index.js

@@ -1,10 +0,0 @@
-/**
- * Use the OpenWeather forecast API
- * @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/types.js

@@ -1,8 +0,0 @@
-/**
- * @memberof module:OpenMeteo
- * @typedef {Object} ForecastData
- * @property {any} data - Forecast data
- * @property {boolean} isLoading - Loading state
- * @property {any} isError - Error state
- * @property {string} apiUrl - API URL
- */