@thi.ng/date 2.7.17 → 2.7.19

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-04-26T13:32:20Z
+- **Last updated**: 2024-06-21T19:34:38Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,13 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+### [2.7.19](https://github.com/thi-ng/umbrella/tree/@thi.ng/date@2.7.19) (2024-06-21)
+
+#### ♻️ Refactoring
+
+- rename various rest args to be more semantically meaningful ([8088a56](https://github.com/thi-ng/umbrella/commit/8088a56))
+- enforce uniform naming convention of internal functions ([56992b2](https://github.com/thi-ng/umbrella/commit/56992b2))
+
 ### [2.7.9](https://github.com/thi-ng/umbrella/tree/@thi.ng/date@2.7.9) (2024-03-18)
 
 #### ♻️ Refactoring

package/README.md

@@ -7,7 +7,7 @@
 [![Mastodon Follow](https://img.shields.io/mastodon/follow/109331703950160316?domain=https%3A%2F%2Fmastodon.thi.ng&style=social)](https://mastodon.thi.ng/@toxi)
 
 > [!NOTE]
-> This is one of 192 standalone projects, maintained as part
+> This is one of 193 standalone projects, maintained as part
 > of the [@thi.ng/umbrella](https://github.com/thi-ng/umbrella/) monorepo
 > and anti-framework.
 >
@@ -68,7 +68,7 @@ For Node.js REPL:
 const date = await import("@thi.ng/date");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 5.43 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 5.42 KB
 
 ## Dependencies
 

package/datetime.d.ts

@@ -118,5 +118,5 @@ export declare const ensureDateTime: (x: MaybeDate, prec?: Precision) => DateTim
  *
  * @param x -
  */
-export declare const maybeIsDate: (x: any) => boolean;
+export declare const maybeIsDate: (x: any) => x is string | number | DateTime | Date;
 //# sourceMappingURL=datetime.d.ts.map

package/datetime.js

@@ -262,10 +262,8 @@ class DateTime {
    * @param prec -
    */
   add(x, prec) {
-    if (prec === "w")
-      return this.add(x * 7, "d");
-    if (prec === "q")
-      return this.add(x * 3, "M");
+    if (prec === "w") return this.add(x * 7, "d");
+    if (prec === "q") return this.add(x * 3, "M");
     const res = this.copy();
     const precID = __precisionToID(prec);
     if (precID >= 2) {
@@ -280,8 +278,7 @@ class DateTime {
       m > 11 && res.y++;
       m < 0 && res.y--;
       res.M = m % 12;
-      if (res.M < 0)
-        res.M += 12;
+      if (res.M < 0) res.M += 12;
       res.d = Math.min(res.d, res.daysInMonth());
     } else if (prec === "y") {
       res.y += x;

package/format.js

@@ -187,8 +187,7 @@ const FMT_mm = defFormat(["mm"]);
 const FMT_ss = defFormat(["ss"]);
 const formatRelative = (date, base = /* @__PURE__ */ new Date(), prec = 0, eps = 100) => {
   const delta = difference(date, base);
-  if (Math.abs(delta) < eps)
-    return LOCALE.now;
+  if (Math.abs(delta) < eps) return LOCALE.now;
   let abs = Math.abs(delta);
   let unit;
   if (abs < SECOND) {
@@ -219,8 +218,7 @@ const formatRelative = (date, base = /* @__PURE__ */ new Date(), prec = 0, eps =
 const formatRelativeParts = (date, base = Date.now(), prec = "s", eps = 1e3) => {
   date = ensureEpoch(date);
   base = ensureEpoch(base);
-  if (Math.abs(date - base) < eps)
-    return LOCALE.now;
+  if (Math.abs(date - base) < eps) return LOCALE.now;
   const [sign, ...parts] = decomposeDifference(date, base);
   return tense(sign, formatDurationParts(parts, prec));
 };
@@ -228,8 +226,7 @@ const formatDuration = (dur, prec = "s") => formatDurationParts(decomposeDuratio
 const formatDurationParts = (parts, prec = "s") => {
   const precID = __precisionToID(prec);
   let maxID = precID;
-  while (!parts[maxID] && maxID > 0)
-    maxID--;
+  while (!parts[maxID] && maxID > 0) maxID--;
   let minID = parts.findIndex((x) => x > 0);
   minID < 0 && (minID = maxID);
   maxID = Math.min(Math.max(maxID, minID), precID);

package/i18n.js

@@ -1,6 +1,6 @@
 import { isString } from "@thi.ng/checks/is-string";
 import { EN_SHORT } from "./i18n/en.js";
-const prepLocale = (spec) => {
+const __prepLocale = (spec) => {
   const locale = {
     sepED: " ",
     sepDM: "/",
@@ -13,7 +13,7 @@ const prepLocale = (spec) => {
   !locale.dateTime && (locale.dateTime = [...locale.date, ", ", ...locale.time]);
   return locale;
 };
-const setLocale = (locale) => LOCALE = prepLocale(locale);
+const setLocale = (locale) => LOCALE = __prepLocale(locale);
 const withLocale = (locale, fn) => {
   const old = LOCALE;
   setLocale(locale);
@@ -26,7 +26,7 @@ const withLocale = (locale, fn) => {
     throw e;
   }
 };
-let LOCALE = prepLocale(EN_SHORT);
+let LOCALE = __prepLocale(EN_SHORT);
 const weekdayNames = () => LOCALE.days.slice();
 const monthNames = () => LOCALE.months.slice();
 const units = (x, unit, isDativ = false, unitsOnly = false) => {

package/iterators.js

@@ -2,16 +2,15 @@ import { isString } from "@thi.ng/checks/is-string";
 import { DateTime } from "./datetime.js";
 import { floorQuarter, floorWeek } from "./round.js";
 const defIterator = (prec, tick) => {
-  return function* (...xs) {
-    let [from, to] = (xs.length > 1 ? xs : xs[0]).map(
+  return function* (...args) {
+    let [from, to] = (args.length > 1 ? args : args[0]).map(
       (x) => new DateTime(x).getTime()
     );
     let state = isString(prec) ? new DateTime(from, prec) : prec(from);
     let epoch = from;
     while (epoch < to) {
       epoch = state.getTime();
-      if (epoch >= from && epoch < to)
-        yield epoch;
+      if (epoch >= from && epoch < to) yield epoch;
       tick(state);
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/date",
-  "version": "2.7.17",
+  "version": "2.7.19",
   "description": "Datetime types, relative dates, math, iterators, composable formatters, locales",
   "type": "module",
   "module": "./index.js",
@@ -10,7 +10,7 @@
     "type": "git",
     "url": "https://github.com/thi-ng/umbrella.git"
   },
-  "homepage": "https://github.com/thi-ng/umbrella/tree/develop/packages/date#readme",
+  "homepage": "https://thi.ng/date",
   "funding": [
     {
       "type": "github",
@@ -36,15 +36,15 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.11.1",
-    "@thi.ng/checks": "^3.6.3",
-    "@thi.ng/strings": "^3.7.32"
+    "@thi.ng/api": "^8.11.3",
+    "@thi.ng/checks": "^3.6.5",
+    "@thi.ng/strings": "^3.7.34"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.43.0",
-    "esbuild": "^0.20.2",
-    "typedoc": "^0.25.12",
-    "typescript": "^5.4.3"
+    "@microsoft/api-extractor": "^7.47.0",
+    "esbuild": "^0.21.5",
+    "typedoc": "^0.25.13",
+    "typescript": "^5.5.2"
   },
   "keywords": [
     "datastructure",
@@ -132,5 +132,5 @@
   "thi.ng": {
     "year": 2020
   },
-  "gitHead": "0bec55821066c18eb977a7eabd42c0bb2b096d98\n"
+  "gitHead": "154c95cf9d6bab32174498ec3b5b5d87e42be7f9\n"
 }

package/relative.js

@@ -20,9 +20,9 @@ const parseRelative = (offset, base) => {
       epoch.decDay();
       return epoch;
     default: {
-      let idx = findIndex(EN_SHORT.days, offset);
+      let idx = __findIndex(EN_SHORT.days, offset);
       if (idx < 0) {
-        idx = findIndex(EN_LONG.days, offset);
+        idx = __findIndex(EN_LONG.days, offset);
       }
       if (idx >= 0) {
         do {
@@ -34,16 +34,16 @@ const parseRelative = (offset, base) => {
         offset
       );
       return match ? relative(
-        parseNum(match[1], !!match[7]),
-        parsePeriod(match[2]),
+        __parseNum(match[1], !!match[7]),
+        __parsePeriod(match[2]),
         base
       ) : void 0;
     }
   }
 };
-const findIndex = (items, x) => items.findIndex((y) => y.toLowerCase() === x);
-const parseNum = (x, past) => (x === "next " || x === "a " || x === "an " ? 1 : Number(x)) * (past ? -1 : 1);
-const parsePeriod = (x) => {
+const __findIndex = (items, x) => items.findIndex((y) => y.toLowerCase() === x);
+const __parseNum = (x, past) => (x === "next " || x === "a " || x === "an " ? 1 : Number(x)) * (past ? -1 : 1);
+const __parsePeriod = (x) => {
   x = x !== "s" && x !== "ms" && x.endsWith("s") ? x.substring(0, x.length - 1) : x;
   return {
     ms: "t",
@@ -89,8 +89,7 @@ const decomposeDifference = (a, b = /* @__PURE__ */ new Date()) => {
     sec / SECOND,
     milli
   ];
-  if (!abs)
-    return parts;
+  if (!abs) return parts;
   const diff = (a2, b2) => {
     const months2 = (b2.y - a2.y) * 12 + (b2.M - a2.M);
     const bstart = +a2.add(months2, "M");

package/units.js

@@ -8,12 +8,9 @@ const dayInYear = (y, m, d) => DAYS_IN_MONTH_OFFSET[m] + d + ~~(m > 1 && isLeapY
 const weekInYear = (y, m, d) => {
   const start = new Date(Date.UTC(y, 0, 1)).getDay() || 7;
   if (!m) {
-    if (start === 5 && d < 4)
-      return 53;
-    if (start === 6 && d < 3)
-      return 52 + ~~isLeapYear(y - 1);
-    if (start === 7 && d < 2)
-      return 52;
+    if (start === 5 && d < 4) return 53;
+    if (start === 6 && d < 3) return 52 + ~~isLeapYear(y - 1);
+    if (start === 7 && d < 2) return 52;
   }
   const offset = (start < 5 ? 8 : 15) - start;
   return Math.ceil((dayInYear(y, m, d) - offset) / 7 + 1);