@aotearoan/neon 16.0.3 → 16.0.4

package/dist/common/utils/NeonDateUtils.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"NeonDateUtils.cjs.js","sources":["../../../src/common/utils/NeonDateUtils.ts"],"sourcesContent":["import type { NeonCalendarConfig } from '@/common/models/NeonCalendarConfig';\nimport type { NeonDate } from '@/common/models/NeonDate';\n\nexport class NeonDateUtils {\n  /**\n   * Convert an ISO 8601 formatted string to a locale formatted date with a three letter month, a 2 digit day and a locale formatted time.\n   * @param date The date/time as an <a href=\"https://en.wikipedia.org/wiki/ISO_8601\">ISO 8601</a> string.\n   * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.\n   * @param strict Do not add time component to localise the date.\n   */\n  public static stringToNeonDate(date: string, locale?: string, strict = false): NeonDate {\n    const loc = locale || navigator.language;\n    const now = new Date();\n    const dateObj = new Date(!strict && date.length === 10 ? `${date}T${now.toISOString().split('T')[1]}` : date);\n    let time;\n    if (date.length > 10) {\n      time = dateObj.toLocaleString(\n        loc,\n        date.length <= 16\n          ? { hour12: false, hour: '2-digit', minute: '2-digit' }\n          : { hour12: false, hour: '2-digit', minute: '2-digit', second: '2-digit' },\n      );\n    }\n\n    const result: NeonDate = {\n      year: +dateObj.toLocaleString('en-US', { year: 'numeric' }),\n      yearFormatted: dateObj.toLocaleString(loc, { year: 'numeric' }),\n      month: +dateObj.toLocaleString('en-US', { month: 'numeric' }),\n      monthShortName: dateObj.toLocaleString(loc, { month: 'short' }),\n      monthLongName: dateObj.toLocaleString(loc, { month: 'long' }),\n      day: +dateObj.toLocaleString('en-US', { day: 'numeric' }),\n      dayFormatted: dateObj.toLocaleString(loc, { day: '2-digit' }),\n    };\n\n    if (time) {\n      result.time = time;\n    }\n\n    return result;\n  }\n\n  public static dateToIso(date: Date, time = false): string {\n    const dateString = date.toISOString();\n    return time ? dateString : dateString.split('T')[0];\n  }\n\n  public static dmyToIso(day: number, month: number, year: number): string {\n    return `${year}-${month < 10 ? '0' + month : month}-${day < 10 ? '0' + day : day}`;\n  }\n\n  public static dowNames(locale?: string): Array<string> {\n    const loc = locale || navigator.language;\n    const date = new Date();\n\n    const weekdays = [];\n    while (!weekdays[date.getDay()]) {\n      weekdays[date.getDay()] = date.toLocaleString(loc, { weekday: 'short' });\n      date.setDate(date.getDate() + 1);\n    }\n\n    const sunday = weekdays.shift();\n    if (sunday) {\n      weekdays.push(sunday);\n    }\n\n    return weekdays;\n  }\n\n  public static monthNames(locale?: string): Array<string> {\n    const loc = locale || navigator.language;\n\n    return Array.from(Array(12).keys()).map((key) => {\n      const date = new Date(2023, key, 15);\n      return date.toLocaleString(loc, { month: 'short' });\n    });\n  }\n\n  public static toCalendarConfiguration(\n    selectedDate?: string,\n    currentPageMonth?: number,\n    currentPageYear?: number,\n    currentPageDecadeStart?: number,\n    locale?: string,\n  ): NeonCalendarConfig {\n    const loc = locale || navigator.language;\n    const today = NeonDateUtils.stringToNeonDate(NeonDateUtils.dateToIso(new Date()), loc);\n    const selected = selectedDate ? NeonDateUtils.stringToNeonDate(selectedDate, loc, true) : undefined;\n    // month indexed from 1-12\n    const pageMonth = currentPageMonth || today.month;\n\n    // month indexed from 0-11\n    const pageDate = currentPageMonth && currentPageYear ? new Date(currentPageYear, currentPageMonth - 1, 15) : null;\n    const pageMonthName = pageDate?.toLocaleString(loc, { month: 'long' }) || today.monthLongName;\n    const pageYear = currentPageYear || today.year;\n    const pageDecadeStart = currentPageDecadeStart || Math.floor(pageYear / 10) * 10;\n\n    // determine dow of first day of month. Months are indexed from 0 here\n    const date = new Date(pageYear, (pageMonth + 11) % 12, 1);\n    const offsetDate = new Date(pageYear, (pageMonth + 11) % 12, 1);\n    offsetDate.setDate(offsetDate.getDate() - 1);\n\n    const dates: Array<Array<number | null>> = [];\n\n    let lastDayOfMonth = 1;\n    let done = false;\n\n    for (let row = 0; row < 6; row++) {\n      dates[row] = [];\n\n      for (let col = 0; col < 7; col++) {\n        if (row === 0 && col < offsetDate.getDay()) {\n          dates[row][col] = null;\n        } else {\n          dates[row][col] = date.getDate();\n          lastDayOfMonth = date.getDate();\n          date.setDate(date.getDate() + 1);\n\n          if (date.getDate() === 1) {\n            for (let i = col + 1; i < 7; i++) {\n              dates[row][i] = null;\n            }\n            done = true;\n            break;\n          }\n        }\n      }\n\n      if (done) {\n        break;\n      }\n    }\n\n    return {\n      today,\n      selected,\n      pageMonth,\n      pageMonthName,\n      pageYear,\n      pageDecadeStart,\n      dowNames: NeonDateUtils.dowNames(loc),\n      dates,\n      lastDayOfMonth,\n      months: NeonDateUtils.monthNames(loc),\n    };\n  }\n}\n"],"names":["NeonDateUtils","date","locale","strict","loc","now","dateObj","time","result","dateString","day","month","year","weekdays","sunday","key","selectedDate","currentPageMonth","currentPageYear","currentPageDecadeStart","today","selected","pageMonth","pageDate","pageMonthName","pageYear","pageDecadeStart","offsetDate","dates","lastDayOfMonth","done","row","col","i"],"mappings":"gFAGO,MAAMA,CAAc,CAOzB,OAAc,iBAAiBC,EAAcC,EAAiBC,EAAS,GAAiB,CAChF,MAAAC,EAAMF,GAAU,UAAU,SAC1BG,MAAU,KACVC,EAAU,IAAI,KAAK,CAACH,GAAUF,EAAK,SAAW,GAAK,GAAGA,CAAI,IAAII,EAAI,cAAc,MAAM,GAAG,EAAE,CAAC,CAAC,GAAKJ,CAAI,EACxG,IAAAM,EACAN,EAAK,OAAS,KAChBM,EAAOD,EAAQ,eACbF,EACAH,EAAK,QAAU,GACX,CAAE,OAAQ,GAAO,KAAM,UAAW,OAAQ,SAC1C,EAAA,CAAE,OAAQ,GAAO,KAAM,UAAW,OAAQ,UAAW,OAAQ,SAAU,CAAA,GAI/E,MAAMO,EAAmB,CACvB,KAAM,CAACF,EAAQ,eAAe,QAAS,CAAE,KAAM,UAAW,EAC1D,cAAeA,EAAQ,eAAeF,EAAK,CAAE,KAAM,UAAW,EAC9D,MAAO,CAACE,EAAQ,eAAe,QAAS,CAAE,MAAO,UAAW,EAC5D,eAAgBA,EAAQ,eAAeF,EAAK,CAAE,MAAO,QAAS,EAC9D,cAAeE,EAAQ,eAAeF,EAAK,CAAE,MAAO,OAAQ,EAC5D,IAAK,CAACE,EAAQ,eAAe,QAAS,CAAE,IAAK,UAAW,EACxD,aAAcA,EAAQ,eAAeF,EAAK,CAAE,IAAK,UAAW,CAAA,EAG9D,OAAIG,IACFC,EAAO,KAAOD,GAGTC,CACT,CAEA,OAAc,UAAUP,EAAYM,EAAO,GAAe,CAClD,MAAAE,EAAaR,EAAK,cACxB,OAAOM,EAAOE,EAAaA,EAAW,MAAM,GAAG,EAAE,CAAC,CACpD,CAEA,OAAc,SAASC,EAAaC,EAAeC,EAAsB,CACvE,MAAO,GAAGA,CAAI,IAAID,EAAQ,GAAK,IAAMA,EAAQA,CAAK,IAAID,EAAM,GAAK,IAAMA,EAAMA,CAAG,EAClF,CAEA,OAAc,SAASR,EAAgC,CAC/C,MAAAE,EAAMF,GAAU,UAAU,SAC1BD,MAAW,KAEXY,EAAW,CAAA,EACjB,KAAO,CAACA,EAASZ,EAAK,OAAQ,CAAA,GACnBY,EAAAZ,EAAK,OAAQ,CAAA,EAAIA,EAAK,eAAeG,EAAK,CAAE,QAAS,OAAA,CAAS,EACvEH,EAAK,QAAQA,EAAK,QAAQ,EAAI,CAAC,EAG3B,MAAAa,EAASD,EAAS,QACxB,OAAIC,GACFD,EAAS,KAAKC,CAAM,EAGfD,CACT,CAEA,OAAc,WAAWX,EAAgC,CACjD,MAAAE,EAAMF,GAAU,UAAU,SAEzB,OAAA,MAAM,KAAK,MAAM,EAAE,EAAE,MAAM,EAAE,IAAKa,GAC1B,IAAI,KAAK,KAAMA,EAAK,EAAE,EACvB,eAAeX,EAAK,CAAE,MAAO,QAAS,CACnD,CACH,CAEA,OAAc,wBACZY,EACAC,EACAC,EACAC,EACAjB,EACoB,CACd,MAAAE,EAAMF,GAAU,UAAU,SAC1BkB,EAAQpB,EAAc,iBAAiBA,EAAc,UAAc,IAAA,IAAM,EAAGI,CAAG,EAC/EiB,EAAWL,EAAehB,EAAc,iBAAiBgB,EAAcZ,EAAK,EAAI,EAAI,OAEpFkB,EAAYL,GAAoBG,EAAM,MAGtCG,EAAWN,GAAoBC,EAAkB,IAAI,KAAKA,EAAiBD,EAAmB,EAAG,EAAE,EAAI,KACvGO,GAAgBD,GAAA,YAAAA,EAAU,eAAenB,EAAK,CAAE,MAAO,MAAQ,KAAKgB,EAAM,cAC1EK,EAAWP,GAAmBE,EAAM,KACpCM,EAAkBP,GAA0B,KAAK,MAAMM,EAAW,EAAE,EAAI,GAGxExB,EAAO,IAAI,KAAKwB,GAAWH,EAAY,IAAM,GAAI,CAAC,EAClDK,EAAa,IAAI,KAAKF,GAAWH,EAAY,IAAM,GAAI,CAAC,EAC9DK,EAAW,QAAQA,EAAW,QAAQ,EAAI,CAAC,EAE3C,MAAMC,EAAqC,CAAA,EAE3C,IAAIC,EAAiB,EACjBC,EAAO,GAEX,QAASC,EAAM,EAAGA,EAAM,EAAGA,IAAO,CAC1BH,EAAAG,CAAG,EAAI,GAEb,QAASC,EAAM,EAAGA,EAAM,EAAGA,IACzB,GAAID,IAAQ,GAAKC,EAAML,EAAW,SAC1BC,EAAAG,CAAG,EAAEC,CAAG,EAAI,aAElBJ,EAAMG,CAAG,EAAEC,CAAG,EAAI/B,EAAK,QAAQ,EAC/B4B,EAAiB5B,EAAK,UACtBA,EAAK,QAAQA,EAAK,QAAQ,EAAI,CAAC,EAE3BA,EAAK,QAAQ,IAAM,EAAG,CACxB,QAASgC,EAAID,EAAM,EAAGC,EAAI,EAAGA,IACrBL,EAAAG,CAAG,EAAEE,CAAC,EAAI,KAEXH,EAAA,GACP,KACF,CAIJ,GAAIA,EACF,KAEJ,CAEO,MAAA,CACL,MAAAV,EACA,SAAAC,EACA,UAAAC,EACA,cAAAE,EACA,SAAAC,EACA,gBAAAC,EACA,SAAU1B,EAAc,SAASI,CAAG,EACpC,MAAAwB,EACA,eAAAC,EACA,OAAQ7B,EAAc,WAAWI,CAAG,CAAA,CAExC,CACF"}
+{"version":3,"file":"NeonDateUtils.cjs.js","sources":["../../../src/common/utils/NeonDateUtils.ts"],"sourcesContent":["import type { NeonCalendarConfig } from '@/common/models/NeonCalendarConfig';\nimport type { NeonDate } from '@/common/models/NeonDate';\n\nexport class NeonDateUtils {\n  /**\n   * Convert an ISO 8601 formatted string to a locale formatted date with a three letter month, a 2 digit day and a locale formatted time.\n   *\n   * @param date The date/time as an <a href=\"https://en.wikipedia.org/wiki/ISO_8601\">ISO 8601</a> string.\n   * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.\n   * @param strict Do not add time component to localise the date.\n   *\n   * @returns a NeonDate object representing the provided date.\n   */\n  public static stringToNeonDate(date: string, locale?: string, strict = false): NeonDate {\n    const loc = locale || navigator.language;\n    const now = new Date();\n    const dateObj = new Date(!strict && date.length === 10 ? `${date}T${now.toISOString().split('T')[1]}` : date);\n    let time;\n    if (date.length > 10) {\n      time = dateObj.toLocaleString(\n        loc,\n        date.length <= 16\n          ? { hour12: false, hour: '2-digit', minute: '2-digit' }\n          : { hour12: false, hour: '2-digit', minute: '2-digit', second: '2-digit' },\n      );\n    }\n\n    const result: NeonDate = {\n      year: +dateObj.toLocaleString('en-US', { year: 'numeric' }),\n      yearFormatted: dateObj.toLocaleString(loc, { year: 'numeric' }),\n      month: +dateObj.toLocaleString('en-US', { month: 'numeric' }),\n      monthShortName: dateObj.toLocaleString(loc, { month: 'short' }),\n      monthLongName: dateObj.toLocaleString(loc, { month: 'long' }),\n      day: +dateObj.toLocaleString('en-US', { day: 'numeric' }),\n      dayFormatted: dateObj.toLocaleString(loc, { day: '2-digit' }),\n    };\n\n    if (time) {\n      result.time = time;\n    }\n\n    return result;\n  }\n\n  /**\n   * Convert a date object to an ISO 8601 formatted string. By default, the time is not considered.\n   *\n   * @param date Javascript date object\n   * @param time {boolean} Whether to consider the time as part of the conversion to the ISO string.\n   *\n   * @returns an ISO 8601 formatted date string, optionally with the time as well\n   */\n  public static dateToIso(date: Date, time = false): string {\n    const dateString = date.toISOString();\n    return time ? dateString : dateString.split('T')[0];\n  }\n\n  /**\n   * Convert the params received into an ISO 8601 formatted string with only date in it.\n   *\n   * @param day The number of the day to be used.\n   * @param month The number of the month to be used.\n   * @param year The number of the year to be used.\n   *\n   * @returns an ISO 8601 formatted date string for the given parameters\n   */\n  public static dmyToIso(day: number, month: number, year: number): string {\n    return `${year}-${month < 10 ? '0' + month : month}-${day < 10 ? '0' + day : day}`;\n  }\n\n  /**\n   * Returns the days of the week starting at Monday day name translated using the locale received as a first element.\n   *\n   * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.\n   *\n   * @returns an array with the days of the week named according to the locale received.\n   */\n  public static dowNames(locale?: string): Array<string> {\n    const loc = locale || navigator.language;\n    const date = new Date();\n\n    const weekdays = [];\n    while (!weekdays[date.getDay()]) {\n      weekdays[date.getDay()] = date.toLocaleString(loc, { weekday: 'short' });\n      date.setDate(date.getDate() + 1);\n    }\n\n    const sunday = weekdays.shift();\n    if (sunday) {\n      weekdays.push(sunday);\n    }\n\n    return weekdays;\n  }\n\n  /**\n   * Returns the months of the year starting at January month name translated using the locale received as a first element.\n   *\n   * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.\n   * @returns an array with the month names of the year, all named according to the locale received.\n   */\n  public static monthNames(locale?: string): Array<string> {\n    const loc = locale || navigator.language;\n\n    return Array.from(Array(12).keys()).map((key) => {\n      const date = new Date(2023, key, 15);\n      return date.toLocaleString(loc, { month: 'short' });\n    });\n  }\n\n  public static toCalendarConfiguration(\n    selectedDate?: string,\n    currentPageMonth?: number,\n    currentPageYear?: number,\n    currentPageDecadeStart?: number,\n    locale?: string,\n  ): NeonCalendarConfig {\n    const loc = locale || navigator.language;\n    const today = NeonDateUtils.stringToNeonDate(NeonDateUtils.dateToIso(new Date()), loc);\n    const selected = selectedDate ? NeonDateUtils.stringToNeonDate(selectedDate, loc, true) : undefined;\n    // month indexed from 1-12\n    const pageMonth = currentPageMonth || today.month;\n\n    // month indexed from 0-11\n    const pageDate = currentPageMonth && currentPageYear ? new Date(currentPageYear, currentPageMonth - 1, 15) : null;\n    const pageMonthName = pageDate?.toLocaleString(loc, { month: 'long' }) || today.monthLongName;\n    const pageYear = currentPageYear || today.year;\n    const pageDecadeStart = currentPageDecadeStart || Math.floor(pageYear / 10) * 10;\n\n    // determine dow of first day of month. Months are indexed from 0 here\n    const date = new Date(pageYear, (pageMonth + 11) % 12, 1);\n    const offsetDate = new Date(pageYear, (pageMonth + 11) % 12, 1);\n    offsetDate.setDate(offsetDate.getDate() - 1);\n\n    const dates: Array<Array<number | null>> = [];\n\n    let lastDayOfMonth = 1;\n    let done = false;\n\n    for (let row = 0; row < 6; row++) {\n      dates[row] = [];\n\n      for (let col = 0; col < 7; col++) {\n        if (row === 0 && col < offsetDate.getDay()) {\n          dates[row][col] = null;\n        } else {\n          dates[row][col] = date.getDate();\n          lastDayOfMonth = date.getDate();\n          date.setDate(date.getDate() + 1);\n\n          if (date.getDate() === 1) {\n            for (let i = col + 1; i < 7; i++) {\n              dates[row][i] = null;\n            }\n            done = true;\n            break;\n          }\n        }\n      }\n\n      if (done) {\n        break;\n      }\n    }\n\n    return {\n      today,\n      selected,\n      pageMonth,\n      pageMonthName,\n      pageYear,\n      pageDecadeStart,\n      dowNames: NeonDateUtils.dowNames(loc),\n      dates,\n      lastDayOfMonth,\n      months: NeonDateUtils.monthNames(loc),\n    };\n  }\n}\n"],"names":["NeonDateUtils","date","locale","strict","loc","now","dateObj","time","result","dateString","day","month","year","weekdays","sunday","key","selectedDate","currentPageMonth","currentPageYear","currentPageDecadeStart","today","selected","pageMonth","pageDate","pageMonthName","pageYear","pageDecadeStart","offsetDate","dates","lastDayOfMonth","done","row","col","i"],"mappings":"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"}

package/dist/common/utils/NeonDateUtils.es.js

@@ -1,9 +1,12 @@
 class c {
   /**
    * Convert an ISO 8601 formatted string to a locale formatted date with a three letter month, a 2 digit day and a locale formatted time.
+   *
    * @param date The date/time as an <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO 8601</a> string.
    * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.
    * @param strict Do not add time component to localise the date.
+   *
+   * @returns a NeonDate object representing the provided date.
    */
   static stringToNeonDate(t, o, e = !1) {
     const a = o || navigator.language, i = /* @__PURE__ */ new Date(), n = new Date(!e && t.length === 10 ? `${t}T${i.toISOString().split("T")[1]}` : t);
@@ -23,13 +26,37 @@ class c {
     };
     return r && (d.time = r), d;
   }
+  /**
+   * Convert a date object to an ISO 8601 formatted string. By default, the time is not considered.
+   *
+   * @param date Javascript date object
+   * @param time {boolean} Whether to consider the time as part of the conversion to the ISO string.
+   *
+   * @returns an ISO 8601 formatted date string, optionally with the time as well
+   */
   static dateToIso(t, o = !1) {
     const e = t.toISOString();
     return o ? e : e.split("T")[0];
   }
+  /**
+   * Convert the params received into an ISO 8601 formatted string with only date in it.
+   *
+   * @param day The number of the day to be used.
+   * @param month The number of the month to be used.
+   * @param year The number of the year to be used.
+   *
+   * @returns an ISO 8601 formatted date string for the given parameters
+   */
   static dmyToIso(t, o, e) {
     return `${e}-${o < 10 ? "0" + o : o}-${t < 10 ? "0" + t : t}`;
   }
+  /**
+   * Returns the days of the week starting at Monday day name translated using the locale received as a first element.
+   *
+   * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.
+   *
+   * @returns an array with the days of the week named according to the locale received.
+   */
   static dowNames(t) {
     const o = t || navigator.language, e = /* @__PURE__ */ new Date(), a = [];
     for (; !a[e.getDay()]; )
@@ -37,6 +64,12 @@ class c {
     const i = a.shift();
     return i && a.push(i), a;
   }
+  /**
+   * Returns the months of the year starting at January month name translated using the locale received as a first element.
+   *
+   * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.
+   * @returns an array with the month names of the year, all named according to the locale received.
+   */
   static monthNames(t) {
     const o = t || navigator.language;
     return Array.from(Array(12).keys()).map((e) => new Date(2023, e, 15).toLocaleString(o, { month: "short" }));

package/dist/common/utils/NeonDateUtils.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"NeonDateUtils.es.js","sources":["../../../src/common/utils/NeonDateUtils.ts"],"sourcesContent":["import type { NeonCalendarConfig } from '@/common/models/NeonCalendarConfig';\nimport type { NeonDate } from '@/common/models/NeonDate';\n\nexport class NeonDateUtils {\n  /**\n   * Convert an ISO 8601 formatted string to a locale formatted date with a three letter month, a 2 digit day and a locale formatted time.\n   * @param date The date/time as an <a href=\"https://en.wikipedia.org/wiki/ISO_8601\">ISO 8601</a> string.\n   * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.\n   * @param strict Do not add time component to localise the date.\n   */\n  public static stringToNeonDate(date: string, locale?: string, strict = false): NeonDate {\n    const loc = locale || navigator.language;\n    const now = new Date();\n    const dateObj = new Date(!strict && date.length === 10 ? `${date}T${now.toISOString().split('T')[1]}` : date);\n    let time;\n    if (date.length > 10) {\n      time = dateObj.toLocaleString(\n        loc,\n        date.length <= 16\n          ? { hour12: false, hour: '2-digit', minute: '2-digit' }\n          : { hour12: false, hour: '2-digit', minute: '2-digit', second: '2-digit' },\n      );\n    }\n\n    const result: NeonDate = {\n      year: +dateObj.toLocaleString('en-US', { year: 'numeric' }),\n      yearFormatted: dateObj.toLocaleString(loc, { year: 'numeric' }),\n      month: +dateObj.toLocaleString('en-US', { month: 'numeric' }),\n      monthShortName: dateObj.toLocaleString(loc, { month: 'short' }),\n      monthLongName: dateObj.toLocaleString(loc, { month: 'long' }),\n      day: +dateObj.toLocaleString('en-US', { day: 'numeric' }),\n      dayFormatted: dateObj.toLocaleString(loc, { day: '2-digit' }),\n    };\n\n    if (time) {\n      result.time = time;\n    }\n\n    return result;\n  }\n\n  public static dateToIso(date: Date, time = false): string {\n    const dateString = date.toISOString();\n    return time ? dateString : dateString.split('T')[0];\n  }\n\n  public static dmyToIso(day: number, month: number, year: number): string {\n    return `${year}-${month < 10 ? '0' + month : month}-${day < 10 ? '0' + day : day}`;\n  }\n\n  public static dowNames(locale?: string): Array<string> {\n    const loc = locale || navigator.language;\n    const date = new Date();\n\n    const weekdays = [];\n    while (!weekdays[date.getDay()]) {\n      weekdays[date.getDay()] = date.toLocaleString(loc, { weekday: 'short' });\n      date.setDate(date.getDate() + 1);\n    }\n\n    const sunday = weekdays.shift();\n    if (sunday) {\n      weekdays.push(sunday);\n    }\n\n    return weekdays;\n  }\n\n  public static monthNames(locale?: string): Array<string> {\n    const loc = locale || navigator.language;\n\n    return Array.from(Array(12).keys()).map((key) => {\n      const date = new Date(2023, key, 15);\n      return date.toLocaleString(loc, { month: 'short' });\n    });\n  }\n\n  public static toCalendarConfiguration(\n    selectedDate?: string,\n    currentPageMonth?: number,\n    currentPageYear?: number,\n    currentPageDecadeStart?: number,\n    locale?: string,\n  ): NeonCalendarConfig {\n    const loc = locale || navigator.language;\n    const today = NeonDateUtils.stringToNeonDate(NeonDateUtils.dateToIso(new Date()), loc);\n    const selected = selectedDate ? NeonDateUtils.stringToNeonDate(selectedDate, loc, true) : undefined;\n    // month indexed from 1-12\n    const pageMonth = currentPageMonth || today.month;\n\n    // month indexed from 0-11\n    const pageDate = currentPageMonth && currentPageYear ? new Date(currentPageYear, currentPageMonth - 1, 15) : null;\n    const pageMonthName = pageDate?.toLocaleString(loc, { month: 'long' }) || today.monthLongName;\n    const pageYear = currentPageYear || today.year;\n    const pageDecadeStart = currentPageDecadeStart || Math.floor(pageYear / 10) * 10;\n\n    // determine dow of first day of month. Months are indexed from 0 here\n    const date = new Date(pageYear, (pageMonth + 11) % 12, 1);\n    const offsetDate = new Date(pageYear, (pageMonth + 11) % 12, 1);\n    offsetDate.setDate(offsetDate.getDate() - 1);\n\n    const dates: Array<Array<number | null>> = [];\n\n    let lastDayOfMonth = 1;\n    let done = false;\n\n    for (let row = 0; row < 6; row++) {\n      dates[row] = [];\n\n      for (let col = 0; col < 7; col++) {\n        if (row === 0 && col < offsetDate.getDay()) {\n          dates[row][col] = null;\n        } else {\n          dates[row][col] = date.getDate();\n          lastDayOfMonth = date.getDate();\n          date.setDate(date.getDate() + 1);\n\n          if (date.getDate() === 1) {\n            for (let i = col + 1; i < 7; i++) {\n              dates[row][i] = null;\n            }\n            done = true;\n            break;\n          }\n        }\n      }\n\n      if (done) {\n        break;\n      }\n    }\n\n    return {\n      today,\n      selected,\n      pageMonth,\n      pageMonthName,\n      pageYear,\n      pageDecadeStart,\n      dowNames: NeonDateUtils.dowNames(loc),\n      dates,\n      lastDayOfMonth,\n      months: NeonDateUtils.monthNames(loc),\n    };\n  }\n}\n"],"names":["NeonDateUtils","date","locale","strict","loc","now","dateObj","time","result","dateString","day","month","year","weekdays","sunday","key","selectedDate","currentPageMonth","currentPageYear","currentPageDecadeStart","today","selected","pageMonth","pageDate","pageMonthName","pageYear","pageDecadeStart","offsetDate","dates","lastDayOfMonth","done","row","col","i"],"mappings":"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"}
+{"version":3,"file":"NeonDateUtils.es.js","sources":["../../../src/common/utils/NeonDateUtils.ts"],"sourcesContent":["import type { NeonCalendarConfig } from '@/common/models/NeonCalendarConfig';\nimport type { NeonDate } from '@/common/models/NeonDate';\n\nexport class NeonDateUtils {\n  /**\n   * Convert an ISO 8601 formatted string to a locale formatted date with a three letter month, a 2 digit day and a locale formatted time.\n   *\n   * @param date The date/time as an <a href=\"https://en.wikipedia.org/wiki/ISO_8601\">ISO 8601</a> string.\n   * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.\n   * @param strict Do not add time component to localise the date.\n   *\n   * @returns a NeonDate object representing the provided date.\n   */\n  public static stringToNeonDate(date: string, locale?: string, strict = false): NeonDate {\n    const loc = locale || navigator.language;\n    const now = new Date();\n    const dateObj = new Date(!strict && date.length === 10 ? `${date}T${now.toISOString().split('T')[1]}` : date);\n    let time;\n    if (date.length > 10) {\n      time = dateObj.toLocaleString(\n        loc,\n        date.length <= 16\n          ? { hour12: false, hour: '2-digit', minute: '2-digit' }\n          : { hour12: false, hour: '2-digit', minute: '2-digit', second: '2-digit' },\n      );\n    }\n\n    const result: NeonDate = {\n      year: +dateObj.toLocaleString('en-US', { year: 'numeric' }),\n      yearFormatted: dateObj.toLocaleString(loc, { year: 'numeric' }),\n      month: +dateObj.toLocaleString('en-US', { month: 'numeric' }),\n      monthShortName: dateObj.toLocaleString(loc, { month: 'short' }),\n      monthLongName: dateObj.toLocaleString(loc, { month: 'long' }),\n      day: +dateObj.toLocaleString('en-US', { day: 'numeric' }),\n      dayFormatted: dateObj.toLocaleString(loc, { day: '2-digit' }),\n    };\n\n    if (time) {\n      result.time = time;\n    }\n\n    return result;\n  }\n\n  /**\n   * Convert a date object to an ISO 8601 formatted string. By default, the time is not considered.\n   *\n   * @param date Javascript date object\n   * @param time {boolean} Whether to consider the time as part of the conversion to the ISO string.\n   *\n   * @returns an ISO 8601 formatted date string, optionally with the time as well\n   */\n  public static dateToIso(date: Date, time = false): string {\n    const dateString = date.toISOString();\n    return time ? dateString : dateString.split('T')[0];\n  }\n\n  /**\n   * Convert the params received into an ISO 8601 formatted string with only date in it.\n   *\n   * @param day The number of the day to be used.\n   * @param month The number of the month to be used.\n   * @param year The number of the year to be used.\n   *\n   * @returns an ISO 8601 formatted date string for the given parameters\n   */\n  public static dmyToIso(day: number, month: number, year: number): string {\n    return `${year}-${month < 10 ? '0' + month : month}-${day < 10 ? '0' + day : day}`;\n  }\n\n  /**\n   * Returns the days of the week starting at Monday day name translated using the locale received as a first element.\n   *\n   * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.\n   *\n   * @returns an array with the days of the week named according to the locale received.\n   */\n  public static dowNames(locale?: string): Array<string> {\n    const loc = locale || navigator.language;\n    const date = new Date();\n\n    const weekdays = [];\n    while (!weekdays[date.getDay()]) {\n      weekdays[date.getDay()] = date.toLocaleString(loc, { weekday: 'short' });\n      date.setDate(date.getDate() + 1);\n    }\n\n    const sunday = weekdays.shift();\n    if (sunday) {\n      weekdays.push(sunday);\n    }\n\n    return weekdays;\n  }\n\n  /**\n   * Returns the months of the year starting at January month name translated using the locale received as a first element.\n   *\n   * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.\n   * @returns an array with the month names of the year, all named according to the locale received.\n   */\n  public static monthNames(locale?: string): Array<string> {\n    const loc = locale || navigator.language;\n\n    return Array.from(Array(12).keys()).map((key) => {\n      const date = new Date(2023, key, 15);\n      return date.toLocaleString(loc, { month: 'short' });\n    });\n  }\n\n  public static toCalendarConfiguration(\n    selectedDate?: string,\n    currentPageMonth?: number,\n    currentPageYear?: number,\n    currentPageDecadeStart?: number,\n    locale?: string,\n  ): NeonCalendarConfig {\n    const loc = locale || navigator.language;\n    const today = NeonDateUtils.stringToNeonDate(NeonDateUtils.dateToIso(new Date()), loc);\n    const selected = selectedDate ? NeonDateUtils.stringToNeonDate(selectedDate, loc, true) : undefined;\n    // month indexed from 1-12\n    const pageMonth = currentPageMonth || today.month;\n\n    // month indexed from 0-11\n    const pageDate = currentPageMonth && currentPageYear ? new Date(currentPageYear, currentPageMonth - 1, 15) : null;\n    const pageMonthName = pageDate?.toLocaleString(loc, { month: 'long' }) || today.monthLongName;\n    const pageYear = currentPageYear || today.year;\n    const pageDecadeStart = currentPageDecadeStart || Math.floor(pageYear / 10) * 10;\n\n    // determine dow of first day of month. Months are indexed from 0 here\n    const date = new Date(pageYear, (pageMonth + 11) % 12, 1);\n    const offsetDate = new Date(pageYear, (pageMonth + 11) % 12, 1);\n    offsetDate.setDate(offsetDate.getDate() - 1);\n\n    const dates: Array<Array<number | null>> = [];\n\n    let lastDayOfMonth = 1;\n    let done = false;\n\n    for (let row = 0; row < 6; row++) {\n      dates[row] = [];\n\n      for (let col = 0; col < 7; col++) {\n        if (row === 0 && col < offsetDate.getDay()) {\n          dates[row][col] = null;\n        } else {\n          dates[row][col] = date.getDate();\n          lastDayOfMonth = date.getDate();\n          date.setDate(date.getDate() + 1);\n\n          if (date.getDate() === 1) {\n            for (let i = col + 1; i < 7; i++) {\n              dates[row][i] = null;\n            }\n            done = true;\n            break;\n          }\n        }\n      }\n\n      if (done) {\n        break;\n      }\n    }\n\n    return {\n      today,\n      selected,\n      pageMonth,\n      pageMonthName,\n      pageYear,\n      pageDecadeStart,\n      dowNames: NeonDateUtils.dowNames(loc),\n      dates,\n      lastDayOfMonth,\n      months: NeonDateUtils.monthNames(loc),\n    };\n  }\n}\n"],"names":["NeonDateUtils","date","locale","strict","loc","now","dateObj","time","result","dateString","day","month","year","weekdays","sunday","key","selectedDate","currentPageMonth","currentPageYear","currentPageDecadeStart","today","selected","pageMonth","pageDate","pageMonthName","pageYear","pageDecadeStart","offsetDate","dates","lastDayOfMonth","done","row","col","i"],"mappings":"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"}

package/dist/src/common/utils/NeonDateUtils.d.ts

@@ -3,14 +3,47 @@ import type { NeonDate } from '@/common/models/NeonDate';
 export declare class NeonDateUtils {
     /**
      * Convert an ISO 8601 formatted string to a locale formatted date with a three letter month, a 2 digit day and a locale formatted time.
+     *
      * @param date The date/time as an <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO 8601</a> string.
      * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.
      * @param strict Do not add time component to localise the date.
+     *
+     * @returns a NeonDate object representing the provided date.
      */
     static stringToNeonDate(date: string, locale?: string, strict?: boolean): NeonDate;
+    /**
+     * Convert a date object to an ISO 8601 formatted string. By default, the time is not considered.
+     *
+     * @param date Javascript date object
+     * @param time {boolean} Whether to consider the time as part of the conversion to the ISO string.
+     *
+     * @returns an ISO 8601 formatted date string, optionally with the time as well
+     */
     static dateToIso(date: Date, time?: boolean): string;
+    /**
+     * Convert the params received into an ISO 8601 formatted string with only date in it.
+     *
+     * @param day The number of the day to be used.
+     * @param month The number of the month to be used.
+     * @param year The number of the year to be used.
+     *
+     * @returns an ISO 8601 formatted date string for the given parameters
+     */
     static dmyToIso(day: number, month: number, year: number): string;
+    /**
+     * Returns the days of the week starting at Monday day name translated using the locale received as a first element.
+     *
+     * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.
+     *
+     * @returns an array with the days of the week named according to the locale received.
+     */
     static dowNames(locale?: string): Array<string>;
+    /**
+     * Returns the months of the year starting at January month name translated using the locale received as a first element.
+     *
+     * @param locale The locale for which to convert the date for display purposes, defaults to browser locale.
+     * @returns an array with the month names of the year, all named according to the locale received.
+     */
     static monthNames(locale?: string): Array<string>;
     static toCalendarConfiguration(selectedDate?: string, currentPageMonth?: number, currentPageYear?: number, currentPageDecadeStart?: number, locale?: string): NeonCalendarConfig;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aotearoan/neon",
   "description": "Neon is a lightweight design library of Vue 3 components with minimal dependencies.",
-  "version": "16.0.3",
+  "version": "16.0.4",
   "main": "./dist/neon.cjs.js",
   "module": "./dist/neon.es.js",
   "types": "./dist/src/neon.d.ts",
@@ -18,7 +18,7 @@
     "dev": "node doc-gen.js && npm run gen:version && vite",
     "build": "npm run gen:version && vite build && vue-tsc --emitDeclarationOnly",
     "build:app": "npm run gen:version && vite --config vite.config.app.ts build",
-    "test": "npm run gen:version && cross-env TZ=UTC jest --no-cache --maxWorkers=2",
+    "test": "npm run gen:version && jest --no-cache --maxWorkers=2",
     "preview": "npm run build:app && vite preview --port 4173",
     "build-only": "vite build",
     "type-check": "vue-tsc --noEmit",
@@ -87,7 +87,6 @@
     "@vue/test-utils": "^2.3.2",
     "@vue/tsconfig": "^0.4.0",
     "@vue/vue3-jest": "^29.2.4",
-    "cross-env": "^7.0.3",
     "eslint": "^8.40.0",
     "eslint-config-prettier": "^8.8.0",
     "eslint-import-resolver-typescript": "^3.5.5",

package/src/sass/components/_card.scss

@@ -51,7 +51,8 @@
       & > .neon-card-header,
       & > .neon-card-body,
       & > .neon-card-footer {
-        @include layout.padding(0.5);
+        @include layout.padding-horizontal(0.5, 0.5);
+        @include layout.padding-vertical(0.25, 0.25);
       }
     }
 

package/src/sass/components/_tree-menu.scss

@@ -54,9 +54,15 @@
     .neon-tree-menu__section-link {
       font-size: var(--neon-font-size-l);
       font-weight: var(--neon-font-weight-bold);
+
+      &:visited {
+        color: var(--neon-color-text);
+      }
     }
 
     .neon-tree-menu__section {
+      color: var(--neon-color-text);
+
       & > .neon-tree-menu__link {
         font-size: var(--neon-font-size-m);
       }