@angelrove/forecast-utils 1.1.4 → 1.1.6

package/README.md

@@ -1,8 +1,6 @@
 ## Modules
 
 <dl>
-<dt><a href="#module_Astronomy">Astronomy</a></dt>
-<dd></dd>
 <dt><a href="#module_Astronomy/MoonCalc">Astronomy/MoonCalc</a></dt>
 <dd><p>MoonCalc for calculating moon times, positions, and phases.</p>
 <p>  import { MoonCalc } from ...</p>
@@ -22,139 +20,11 @@ Con excepción de &#39;getSolarTime()&#39;: recibe la hora local correspondiente
 <dd></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>
 </dl>
 
-<a name="module_Astronomy"></a>
-
-## Astronomy
-
-* [Astronomy](#module_Astronomy)
-    * [.exports.timeString([date], [sec])](#module_Astronomy.exports.timeString) ⇒ <code>string</code>
-    * [.exports.nowString(sec)](#module_Astronomy.exports.nowString) ⇒ <code>String</code>
-    * [.exports.dateFormat([date])](#module_Astronomy.exports.dateFormat) ⇒ <code>string</code>
-    * [.exports.getLocalTimeFromTz(timeZone, [date])](#module_Astronomy.exports.getLocalTimeFromTz) ⇒ <code>string</code>
-    * [.exports.getLocalTimeInfo(apiKey, lat, lng)](#module_Astronomy.exports.getLocalTimeInfo) ⇒ <code>Promise.&lt;(any\|LocalTimeData)&gt;</code>
-    * [.AstroPosition](#module_Astronomy.AstroPosition) : <code>Object</code>
-    * [.LocalTimeData](#module_Astronomy.LocalTimeData) : <code>Object</code>
-
-
-* * *
-
-<a name="module_Astronomy.exports.timeString"></a>
-
-### Astronomy.exports.timeString([date], [sec]) ⇒ <code>string</code>
-Formatea una fecha a un string legible.
-
-**Kind**: static method of [<code>Astronomy</code>](#module_Astronomy)  
-**Returns**: <code>string</code> - La fecha formateada.  
-
-| Param | Type | Default |
-| --- | --- | --- |
-| [date] | <code>Date</code> |  | 
-| [sec] | <code>boolean</code> | <code>false</code> | 
-
-
-* * *
-
-<a name="module_Astronomy.exports.nowString"></a>
-
-### Astronomy.exports.nowString(sec) ⇒ <code>String</code>
-**Kind**: static method of [<code>Astronomy</code>](#module_Astronomy)  
-
-| Param | Type |
-| --- | --- |
-| sec | <code>boolean</code> | 
-
-
-* * *
-
-<a name="module_Astronomy.exports.dateFormat"></a>
-
-### Astronomy.exports.dateFormat([date]) ⇒ <code>string</code>
-Formatea una fecha a un string legible.
-
-**Kind**: static method of [<code>Astronomy</code>](#module_Astronomy)  
-**Returns**: <code>string</code> - La fecha formateada.  
-
-| Param | Type | Default | Description |
-| --- | --- | --- | --- |
-| [date] | <code>Date</code> | <code>new Date()</code> | La fecha a formatear. |
-
-
-* * *
-
-<a name="module_Astronomy.exports.getLocalTimeFromTz"></a>
-
-### Astronomy.exports.getLocalTimeFromTz(timeZone, [date]) ⇒ <code>string</code>
-Get local time from timezone
-
-**Kind**: static method of [<code>Astronomy</code>](#module_Astronomy)  
-**Returns**: <code>string</code> - - The formatted local time string.  
-
-| Param | Type | Default | Description |
-| --- | --- | --- | --- |
-| timeZone | <code>string</code> |  | The timezone string (e.g., 'America/New_York'). |
-| [date] | <code>Date</code> \| <code>number</code> | <code>new Date()</code> | The date object to format. Defaults to the current date. |
-
-
-* * *
-
-<a name="module_Astronomy.exports.getLocalTimeInfo"></a>
-
-### Astronomy.exports.getLocalTimeInfo(apiKey, lat, lng) ⇒ <code>Promise.&lt;(any\|LocalTimeData)&gt;</code>
-Get local time from any location using Google Maps TimeZone API.
-
-**Kind**: static method of [<code>Astronomy</code>](#module_Astronomy)  
-**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_Astronomy.AstroPosition"></a>
-
-### Astronomy.AstroPosition : <code>Object</code>
-**Kind**: static typedef of [<code>Astronomy</code>](#module_Astronomy)  
-**Properties**
-
-| Name | Type |
-| --- | --- |
-| altitude | <code>number</code> | 
-| azimuth | <code>number</code> | 
-| direction | <code>string</code> | 
-| direction_full | <code>string</code> | 
-
-
-* * *
-
-<a name="module_Astronomy.LocalTimeData"></a>
-
-### Astronomy.LocalTimeData : <code>Object</code>
-**Kind**: static typedef of [<code>Astronomy</code>](#module_Astronomy)  
-**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_Astronomy/MoonCalc"></a>
 
 ## Astronomy/MoonCalc
@@ -398,6 +268,11 @@ Con excepción de 'getSolarTime()': recibe la hora local correspondiente a la lo
 
 ## Geolocation
 
+* [Geolocation](#module_Geolocation)
+    * [.exports.getGeolocation()](#module_Geolocation.exports.getGeolocation) ⇒ <code>Promise.&lt;{latitude: number, longitude: number, formatted\_address: string}&gt;</code>
+    * [.exports.timeFromLocation(apiKey, lat, lng)](#module_Geolocation.exports.timeFromLocation) ⇒ <code>Promise.&lt;(any\|LocalTimeData)&gt;</code>
+
+
 * * *
 
 <a name="module_Geolocation.exports.getGeolocation"></a>
@@ -411,6 +286,27 @@ Get the current geolocation of the device and reverse geocode it to get the addr
 - <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_OpenMeteo"></a>
@@ -503,6 +399,7 @@ Get weather symbol and description based on the weather 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)
     * [.exports.getWindLevel(speed)](#module_Utils.exports.getWindLevel) ⇒ <code>WindLevel</code> \| <code>null</code>
     * [.Compass](#module_Utils.Compass) : <code>Object</code>
@@ -607,6 +504,30 @@ Get warning by precipitation and showers
 | 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. |
+
+**Properties**
+
+| Name | Type | Description |
+| --- | --- | --- |
+| 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>
@@ -685,3 +606,79 @@ Return the wind level based on the speed.
 
 * * *
 
+<a name="module_Utils/TimeDateStr"></a>
+
+## Utils/TimeDateStr
+Helpers for get date and time formeted strings
+
+
+* [Utils/TimeDateStr](#module_Utils/TimeDateStr)
+    * [.dateFormat([date])](#module_Utils/TimeDateStr.dateFormat) ⇒ <code>string</code>
+    * [.timeString([date], [sec])](#module_Utils/TimeDateStr.timeString) ⇒ <code>string</code>
+    * [.nowString(sec)](#module_Utils/TimeDateStr.nowString) ⇒ <code>String</code>
+    * [.getLocalTimeFromTz(timeZone, [date])](#module_Utils/TimeDateStr.getLocalTimeFromTz) ⇒ <code>string</code>
+
+
+* * *
+
+<a name="module_Utils/TimeDateStr.dateFormat"></a>
+
+### Utils/TimeDateStr.dateFormat([date]) ⇒ <code>string</code>
+Returns a date as a formated string.
+
+**Kind**: static method of [<code>Utils/TimeDateStr</code>](#module_Utils/TimeDateStr)  
+**Returns**: <code>string</code> - La fecha formateada.  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| [date] | <code>Date</code> | <code>new Date()</code> | La fecha a formatear. |
+
+
+* * *
+
+<a name="module_Utils/TimeDateStr.timeString"></a>
+
+### Utils/TimeDateStr.timeString([date], [sec]) ⇒ <code>string</code>
+Returns a time as a formated string.
+
+**Kind**: static method of [<code>Utils/TimeDateStr</code>](#module_Utils/TimeDateStr)  
+**Returns**: <code>string</code> - La fecha formateada.  
+
+| Param | Type | Default |
+| --- | --- | --- |
+| [date] | <code>Date</code> |  | 
+| [sec] | <code>boolean</code> | <code>false</code> | 
+
+
+* * *
+
+<a name="module_Utils/TimeDateStr.nowString"></a>
+
+### Utils/TimeDateStr.nowString(sec) ⇒ <code>String</code>
+Returns a now time as a formated string.
+
+**Kind**: static method of [<code>Utils/TimeDateStr</code>](#module_Utils/TimeDateStr)  
+
+| Param | Type | Default |
+| --- | --- | --- |
+| sec | <code>boolean</code> | <code>false</code> | 
+
+
+* * *
+
+<a name="module_Utils/TimeDateStr.getLocalTimeFromTz"></a>
+
+### Utils/TimeDateStr.getLocalTimeFromTz(timeZone, [date]) ⇒ <code>string</code>
+Return the local time string from a given timezone.
+
+**Kind**: static method of [<code>Utils/TimeDateStr</code>](#module_Utils/TimeDateStr)  
+**Returns**: <code>string</code> - - The formatted local time string.  
+
+| Param | Type | Default | Description |
+| --- | --- | --- | --- |
+| timeZone | <code>string</code> |  | The timezone string (e.g., 'America/New_York'). |
+| [date] | <code>Date</code> \| <code>number</code> | <code>new Date()</code> | The date object to format. Defaults to the current date. |
+
+
+* * *
+

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

@@ -1,4 +1,2 @@
 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/geolocation/index.d.ts

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

package/dist/types/{astronomy/timeZoneInfo.d.ts → geolocation/timeFromLocation.d.ts}

@@ -1,11 +1,11 @@
 /**
- * Get local time from any location using Google Maps TimeZone API.
+ * Get local time from a given location (lat, lng) using 'GoogleMaps 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
+ * @memberof module:Geolocation
  */
-export function getLocalTimeInfo(apiKey: string, lat: number, lng: number): Promise<any | LocalTimeData>;
+export function timeFromLocation(apiKey: string, lat: number, lng: number): Promise<any | LocalTimeData>;

package/dist/types/index.d.ts

@@ -1,6 +1,7 @@
 export { default as MoonCalc } from "./astronomy/moon/MoonCalc.js";
 export { default as SunCalc } from "./astronomy/sun/SunCalc.js";
-export { getLocalTimeInfo as getLocalTime } from "./astronomy/timeZoneInfo.js";
+export { timeFromLocation } from "./geolocation/timeFromLocation.js";
+export { default as TimeDateStr } from "./utils/timehelpers.js";
 export { getGeolocation } from "./geolocation/getGeolocation.js";
 export { useForecastCurrent } from "./OpenMeteo/current/useForecastCurrent.js";
 export { useForecastDaily } from "./OpenMeteo/daily/useForecastDaily.js";
@@ -10,5 +11,4 @@ export { degreesToCompass } from "./utils/degreesToCompass.js";
 export { WindArrow } from "./utils/wind/WindArrow.jsx";
 export { windArrowTx } from "./utils/wind/windArrowTx.js";
 export { getWindLevel } from "./utils/wind/windLevel.js";
-export { dateFormat, getLocalTimeFromTz, nowString, timeString } from "./astronomy/timehelpers.js";
 export { getWarning, getWarningByDays } from "./utils/warning.js";

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

@@ -1,4 +1,5 @@
 export { degreesToCompass } from "./degreesToCompass.js";
+export { default as TimeDateStr } from "./timehelpers.js";
 export { WindArrow } from "./wind/WindArrow.jsx";
 export { windArrowTx } from "./wind/windArrowTx.js";
 export { getWindLevel } from "./wind/windLevel.js";

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

@@ -0,0 +1,41 @@
+export default TimeDateStr;
+declare namespace TimeDateStr {
+    export { dateFormat };
+    export { nowString };
+    export { timeString };
+    export { getLocalTimeFromTz };
+}
+/**
+ * Returns a date as a formated string.
+ *
+ * @param {Date} [date=new Date()] La fecha a formatear.
+ * @returns {string} La fecha formateada.
+ * @memberof module:Utils/TimeDateStr
+ */
+declare function dateFormat(date?: Date | undefined): string;
+/**
+ * Returns a now time as a formated string.
+ *
+ * @param {boolean} sec
+ * @returns {String}
+ * @memberof module:Utils/TimeDateStr
+ */
+declare function nowString(sec?: boolean): string;
+/**
+ * Returns a time as a formated string.
+ *
+ * @param {Date} [date]
+ * @param {boolean} [sec=false]
+ * @returns {string} La fecha formateada.
+ * @memberof module:Utils/TimeDateStr
+ */
+declare function timeString(date?: Date | undefined, sec?: boolean | undefined): string;
+/**
+ * Return the local time string from a given timezone.
+ *
+ * @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:Utils/TimeDateStr
+ */
+declare function getLocalTimeFromTz(timeZone: string, date?: number | Date | undefined): string;

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

@@ -2,32 +2,14 @@
  * Wind direction arrow component (svg image).
  */
 /**
- * @typedef {Object} WindArrowProps
- * @property {number} props.deg - Wind direction in degrees
- * @property {string} [props.size] - Size of the arrow (Tailwind CSS size: 'size-10')
- * @property {number} [props.strokeWidth] - Stroke width of the arrow (1 to 6)
- * @property {string} [props.className]
- */
-/**
- * Wind direction arrow component (svg image).
+ * SVG arrow indicating wind direction.
  *
- * @component
- * @param {WindArrowProps} props
+ * @component JSX
+ * @param {Object} props - Component props.
+ * @prop {number} props.deg - Wind direction in degrees (0 = North, 90 = East, etc.).
+ * @prop {string} [props.size] - Tailwind CSS size class (e.g., 'size-10')
+ * @prop {number} [props.strokeWidth] - Stroke width of the arrow (range: 1–6).
+ * @prop {string} [props.className] - Additional CSS classes.
  * @memberof module:Utils
  */
-export function WindArrow({ deg, size, strokeWidth, className, }: WindArrowProps): any;
-export type WindArrowProps = {
-    /**
-     * - Wind direction in degrees
-     */
-    deg: number;
-    /**
-     * - Size of the arrow (Tailwind CSS size: 'size-10')
-     */
-    size?: string;
-    /**
-     * - Stroke width of the arrow (1 to 6)
-     */
-    strokeWidth?: number;
-    className?: string;
-};
+export function WindArrow({ deg, size, strokeWidth, className, }: Object): any;

package/package.json

@@ -1,9 +1,12 @@
 {
-  "name": "@angelrove/forecast-utils",
-  "version": "1.1.4",
   "author": "Jose Angel Romero Vegas",
-  "license": "MIT",
+  "name": "@angelrove/forecast-utils",
+  "version": "1.1.6",
   "description": "Utilities for obtaining weather and astronomy forecast data.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
   "homepage": "https://github.com/angelrove/forecast-utils",
   "type": "module",
   "scripts": {
@@ -12,8 +15,7 @@
   "types": "dist/types/index.d.ts",
   "exports": {
     ".": {
-      "import": "./src/index.js",
-      "require": "./src/index.js"
+      "import": "./src/index.js"
     }
   },
   "files": [

package/src/astronomy/index.js

@@ -1,13 +1,2 @@
-/**
- * @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

@@ -12,7 +12,7 @@
 
 // @ts-ignore
 import SunCalc from "suncalc3";
-import { dateFormat, getLocalTimeFromTz, timeString } from "../timehelpers.js";
+import TimeDateStr from "../../utils/timehelpers.js";
 import { parseBasicData } from "./parseBasicData.js";
 
 /**
@@ -105,8 +105,8 @@ function dataExt(latitude, longitude, date = new Date(), language = "es-ES") {
 
   // Return ---
   return {
-    date: dateFormat(date),
-    time: timeString(date),
+    date: TimeDateStr.dateFormat(date),
+    time: TimeDateStr.timeString(date),
     illumination: illumination,
     phase: phase,
     phaseId: phaseId,
@@ -160,9 +160,9 @@ function times(latitude, longitude, timezoneId, date = new Date()) {
     return ret;
   }
 
-  ret.rise = getLocalTimeFromTz(timezoneId, times.rise);
-  ret.set = getLocalTimeFromTz(timezoneId, times.set);
-  ret.highest = getLocalTimeFromTz(timezoneId, times.highest);
+  ret.rise = TimeDateStr.getLocalTimeFromTz(timezoneId, times.rise);
+  ret.set = TimeDateStr.getLocalTimeFromTz(timezoneId, times.set);
+  ret.highest = TimeDateStr.getLocalTimeFromTz(timezoneId, times.highest);
   return ret;
 }
 //--------------------------------------------------------------------

package/src/astronomy/moon/parseBasicData.js

@@ -1,6 +1,6 @@
 // @ts-nocheck
 import { degreesToCompass } from "../../utils/degreesToCompass.js";
-import { dateFormat } from "../timehelpers.js";
+import TimeDateStr from "../../utils/timehelpers.js";
 
 /**
  * Parse basic data from SunCalc
@@ -17,10 +17,10 @@ export function parseBasicData(data, language) {
   const direction = degreesToCompass(data.azimuthDegrees, language);
 
   // Next moon ---
-  const nextNewMoon = dateFormat(
+  const nextNewMoon = TimeDateStr.dateFormat(
     new Date(data.illumination.next.newMoon.value),
   );
-  const nextFullMoon = dateFormat(
+  const nextFullMoon = TimeDateStr.dateFormat(
     new Date(data.illumination.next.fullMoon.value),
   );
 

package/src/astronomy/sun/SunCalc.js

@@ -13,12 +13,7 @@
 // @ts-ignore
 import { default as SunCalc3 } from "suncalc3";
 import { degreesToCompass } from "../../utils/degreesToCompass.js";
-import {
-  dateFormat,
-  getLocalTimeFromTz,
-  nowString,
-  timeString,
-} from "../timehelpers.js";
+import TimeDateStr from "../../utils/timehelpers.js";
 
 /**
  * SunCalc.
@@ -69,11 +64,14 @@ function times(date, latitude, longitude, timezoneId) {
 
   const sunTimes = {
     date: date,
-    sunrise: getLocalTimeFromTz(timezoneId, times.sunriseStart.value),
-    sunset: getLocalTimeFromTz(timezoneId, times.sunsetStart.value),
-    noon: getLocalTimeFromTz(timezoneId, times.solarNoon.value),
-    dawn: getLocalTimeFromTz(timezoneId, times.civilDawn.value),
-    dusk: getLocalTimeFromTz(timezoneId, times.civilDusk.value),
+    sunrise: TimeDateStr.getLocalTimeFromTz(
+      timezoneId,
+      times.sunriseStart.value,
+    ),
+    sunset: TimeDateStr.getLocalTimeFromTz(timezoneId, times.sunsetStart.value),
+    noon: TimeDateStr.getLocalTimeFromTz(timezoneId, times.solarNoon.value),
+    dawn: TimeDateStr.getLocalTimeFromTz(timezoneId, times.civilDawn.value),
+    dusk: TimeDateStr.getLocalTimeFromTz(timezoneId, times.civilDusk.value),
   };
 
   // console.log(sunTimes);
@@ -92,7 +90,7 @@ function getSolarTime(date, lng, offsetSign, offset) {
   // Convert offsetSign and offset to a numeric UTC offset (e.g., -3, +2)
   const utcOffset = (offsetSign === "-" ? -1 : 1) * Math.abs(Number(offset));
   const solarTime = SunCalc3.getSolarTime(date, lng, utcOffset);
-  return timeString(solarTime);
+  return TimeDateStr.timeString(solarTime);
 }
 //-------------------------------------------------------
 /**
@@ -108,7 +106,7 @@ function position(latitude, longitude, date = new Date(), language = "es-ES") {
   const direction = degreesToCompass(position.azimuthDegrees, language);
 
   return {
-    date: dateFormat(date),
+    date: TimeDateStr.dateFormat(date),
     azimuth: position.azimuthDegrees,
     direction: direction.short,
     direction_full: direction.full,
@@ -134,8 +132,11 @@ function getIsNight(lat, lon, timezoneId, date, dateStr) {
 
   // se pueden comparar horas(hh:mm) estando en formato texto
   // y así no tenemos que tener en cuenta el día, mes.
-  const timeUp = getLocalTimeFromTz(timezoneId, times.sunriseEnd.value);
-  const timeDown = getLocalTimeFromTz(
+  const timeUp = TimeDateStr.getLocalTimeFromTz(
+    timezoneId,
+    times.sunriseEnd.value,
+  );
+  const timeDown = TimeDateStr.getLocalTimeFromTz(
     timezoneId,
     times.goldenHourDuskStart.value,
   );
@@ -150,7 +151,7 @@ function getIsNight(lat, lon, timezoneId, date, dateStr) {
  * @memberof module:Astronomy/SunCalc
  */
 function getPhase(altitude, noon) {
-  const nowTime = nowString();
+  const nowTime = TimeDateStr.nowString();
 
   let phase = "day";
   if (altitude < 4) {

package/src/geolocation/getGeolocation.js

@@ -1,7 +1,3 @@
-/**
- * Get the current geolocation of the device and reverse geocode it to get the address.
- */
-
 import geolocationCapacitor from "./lib/geolocation.js";
 import reverseGeocoding from "./lib/reversegeocoding.js";
 

package/src/geolocation/index.js

@@ -3,3 +3,4 @@
  */
 
 export { getGeolocation } from "./getGeolocation.js";
+export { timeFromLocation } from "./timeFromLocation.js";

package/src/geolocation/lib/geolocation.js

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

package/src/{astronomy/timeZoneInfo.js → geolocation/timeFromLocation.js}

@@ -1,24 +1,18 @@
 // @ts-nocheck
-/**
- * Get local time from any location using Google Maps TimeZone API.
- * - import { getLocalTimeInfo } from '@angelrov/forecast';
- *
- */
-
-import { timeString } from "./timehelpers.js";
+import TimeDateStr from "../utils/timehelpers.js";
 
 //------------------------------------------------------
 /**
- * Get local time from any location using Google Maps TimeZone API.
+ * Get local time from a given location (lat, lng) using 'GoogleMaps 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
+ * @memberof module:Geolocation
  */
-export async function getLocalTimeInfo(apiKey, lat, lng) {
+export async function timeFromLocation(apiKey, lat, lng) {
   const timestamp = Math.floor(Date.now() / 1000);
   const url =
     "https://maps.googleapis.com/maps/api/timezone/json?" +
@@ -45,6 +39,8 @@ export async function getLocalTimeInfo(apiKey, lat, lng) {
     });
 }
 //------------------------------------------------------
+// Private
+//------------------------------------------------------
 /**
  * @private
  * @param {Object} timezoneInfo - The timezone Google API information.
@@ -64,7 +60,7 @@ function getLocalTimeData(timezoneInfo) {
 
   return {
     time: time,
-    timeStr: timeString(time),
+    timeStr: TimeDateStr.timeString(time),
     timezone: timezoneInfo.timeZoneName,
     timezoneId: timezoneInfo.timeZoneId,
     offset: timezoneInfo.rawOffset / 3600,
@@ -81,7 +77,7 @@ function getLocalTimeDataErr() {
   const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
   return {
     time: new Date(),
-    timeStr: timeString(new Date()),
+    timeStr: TimeDateStr.timeString(new Date()),
     timezone: timezone,
     timezoneId: timezone,
     offset: 0,

package/src/index.js

@@ -12,13 +12,8 @@
 // Astronomy
 export { default as MoonCalc } from "./astronomy/moon/MoonCalc.js";
 export { default as SunCalc } from "./astronomy/sun/SunCalc.js";
-export {
-  dateFormat,
-  getLocalTimeFromTz,
-  nowString,
-  timeString,
-} from "./astronomy/timehelpers.js";
-export { getLocalTimeInfo as getLocalTime } from "./astronomy/timeZoneInfo.js";
+export { timeFromLocation } from "./geolocation/timeFromLocation.js";
+export { default as TimeDateStr } from "./utils/timehelpers.js";
 
 // Geolocation
 export { getGeolocation } from "./geolocation/getGeolocation.js";

package/src/utils/index.js

@@ -3,6 +3,7 @@
  */
 
 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";

package/src/{astronomy → utils}/timehelpers.js

@@ -1,13 +1,48 @@
+/**
+ * Helpers for get date and time formeted strings
+ *
+ * @module Utils/TimeDateStr
+ */
+
+/**
+ * TimeDateStr.
+ * @ignore
+ */
+const TimeDateStr = {
+  dateFormat,
+  nowString,
+  timeString,
+  getLocalTimeFromTz,
+};
+export default TimeDateStr;
+
 //------------------------------------------------------
 /**
- * Formatea una fecha a un string legible.
+ * Returns a date as a formated string.
+ *
+ * @param {Date} [date=new Date()] La fecha a formatear.
+ * @returns {string} La fecha formateada.
+ * @memberof module:Utils/TimeDateStr
+ */
+function dateFormat(date = new Date()) {
+  const options = {
+    weekday: "long",
+    day: "numeric",
+    month: "short",
+  };
+  // @ts-ignore
+  return date.toLocaleDateString([], options);
+}
+//------------------------------------------------------
+/**
+ * Returns a time as a formated string.
  *
  * @param {Date} [date]
  * @param {boolean} [sec=false]
  * @returns {string} La fecha formateada.
- * @memberof module:Astronomy
+ * @memberof module:Utils/TimeDateStr
  */
-export function timeString(date = new Date(), sec = false) {
+function timeString(date = new Date(), sec = false) {
   if (sec) {
     return date.toLocaleTimeString([], {
       hour: "2-digit",
@@ -25,41 +60,25 @@ export function timeString(date = new Date(), sec = false) {
 }
 //------------------------------------------------------
 /**
+ * Returns a now time as a formated string.
  *
  * @param {boolean} sec
  * @returns {String}
- * @memberof module:Astronomy
+ * @memberof module:Utils/TimeDateStr
  */
-export function nowString(sec = false) {
+function nowString(sec = false) {
   return timeString(new Date(), sec);
 }
 //------------------------------------------------------
 /**
- * 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 = new Date()) {
-  const options = {
-    weekday: "long",
-    day: "numeric",
-    month: "short",
-  };
-  // @ts-ignore
-  return date.toLocaleDateString([], options);
-}
-//------------------------------------------------------
-/**
- * Get local time from timezone
+ * Return the local time string from a given timezone.
  *
  * @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
+ * @memberof module:Utils/TimeDateStr
  */
-export function getLocalTimeFromTz(timeZone, date = new Date()) {
+function getLocalTimeFromTz(timeZone, date = new Date()) {
   // Timezone example
   // timeZone = 'America/New_York';
 

package/src/utils/wind/WindArrow.jsx

@@ -1,20 +1,26 @@
+// @ts-nocheck
 /**
  * Wind direction arrow component (svg image).
  */
 
-/**
- * @typedef {Object} WindArrowProps
- * @property {number} props.deg - Wind direction in degrees
- * @property {string} [props.size] - Size of the arrow (Tailwind CSS size: 'size-10')
- * @property {number} [props.strokeWidth] - Stroke width of the arrow (1 to 6)
- * @property {string} [props.className]
- */
+// /**
+//  * @typedef {Object} WindArrowProps
+//  * @property {number} props.deg - Wind direction in degrees
+//  * @property {string} [props.size] - Size of the arrow (Tailwind CSS size: 'size-10')
+//  * @property {number} [props.strokeWidth] - Stroke width of the arrow (1 to 6)
+//  * @property {string} [props.className]
+//  * @memberof module:Utils
+//  */
 
 /**
- * Wind direction arrow component (svg image).
+ * SVG arrow indicating wind direction.
  *
- * @component
- * @param {WindArrowProps} props
+ * @component JSX
+ * @param {Object} props - Component props.
+ * @prop {number} props.deg - Wind direction in degrees (0 = North, 90 = East, etc.).
+ * @prop {string} [props.size] - Tailwind CSS size class (e.g., 'size-10')
+ * @prop {number} [props.strokeWidth] - Stroke width of the arrow (range: 1–6).
+ * @prop {string} [props.className] - Additional CSS classes.
  * @memberof module:Utils
  */
 export function WindArrow({

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

@@ -1,33 +0,0 @@
-/**
- * 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;
-/**
- * Get local time from timezone
- *
- * @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;