@naturalcycles/js-lib 14.211.0 → 14.213.0

package/dist/array/array.util.d.ts

@@ -176,6 +176,11 @@ export declare function _last<T>(array: T[]): T;
  * Returns last item of the array (or undefined if array is empty).
  */
 export declare function _lastOrUndefined<T>(array: T[]): T | undefined;
+/**
+ * Returns the first item of non-empty array.
+ * Throws if array is empty.
+ */
+export declare function _first<T>(array: T[]): T;
 export declare function _minOrUndefined<T>(array: T[]): NonNullable<T> | undefined;
 /**
  * Filters out nullish values (undefined and null).

package/dist/array/array.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._zip = exports._minByOrUndefined = exports._maxByOrUndefined = exports._minBy = exports._maxBy = exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersectsWith = exports._intersection = exports._countBy = exports._count = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortDescBy = exports._sortBy = exports._groupBy = exports._mapBy = exports._by = exports._uniqBy = exports._pushUniqBy = exports._pushUniq = exports._uniq = exports._chunk = void 0;
+exports._zip = exports._minByOrUndefined = exports._maxByOrUndefined = exports._minBy = exports._maxBy = exports._max = exports._maxOrUndefined = exports._min = exports._minOrUndefined = exports._first = exports._lastOrUndefined = exports._last = exports._shuffle = exports._mapToObject = exports._sumBy = exports._sum = exports._difference = exports._intersectsWith = exports._intersection = exports._countBy = exports._count = exports._dropRightWhile = exports._dropWhile = exports._takeRightWhile = exports._takeWhile = exports._findLast = exports._sortDescBy = exports._sortBy = exports._groupBy = exports._mapBy = exports._by = exports._uniqBy = exports._pushUniqBy = exports._pushUniq = exports._uniq = exports._chunk = void 0;
 const is_util_1 = require("../is.util");
 const types_1 = require("../types");
 /**
@@ -333,6 +333,16 @@ function _lastOrUndefined(array) {
     return array[array.length - 1];
 }
 exports._lastOrUndefined = _lastOrUndefined;
+/**
+ * Returns the first item of non-empty array.
+ * Throws if array is empty.
+ */
+function _first(array) {
+    if (!array.length)
+        throw new Error('_first called on empty array');
+    return array[0];
+}
+exports._first = _first;
 function _minOrUndefined(array) {
     const a = array.filter(is_util_1._isNotNullish);
     if (!a.length)

package/dist/datetime/localDate.d.ts

@@ -1,6 +1,6 @@
 import { Iterable2 } from '../iter/iterable2';
 import type { Inclusiveness, IsoDateString, IsoDateTimeString, MonthId, SortDirection, UnixTimestampMillisNumber, UnixTimestampNumber } from '../types';
-import { LocalTime } from './localTime';
+import { ISODayOfWeek, LocalTime } from './localTime';
 export type LocalDateUnit = LocalDateUnitStrict | 'week';
 export type LocalDateUnitStrict = 'year' | 'month' | 'day';
 export type LocalDateInput = LocalDate | Date | IsoDateString;
@@ -42,6 +42,7 @@ export declare class LocalDate {
     month(v: number): LocalDate;
     day(): number;
     day(v: number): LocalDate;
+    dayOfWeek(): ISODayOfWeek;
     isSame(d: LocalDateInput): boolean;
     isBefore(d: LocalDateInput, inclusive?: boolean): boolean;
     isSameOrBefore(d: LocalDateInput): boolean;

package/dist/datetime/localDate.js

@@ -129,6 +129,9 @@ class LocalDate {
     day(v) {
         return v === undefined ? this.$day : this.set('day', v);
     }
+    dayOfWeek() {
+        return (this.toDate().getDay() || 7);
+    }
     isSame(d) {
         d = LocalDate.of(d);
         return this.$day === d.$day && this.$month === d.$month && this.$year === d.$year;

package/dist-esm/array/array.util.js

@@ -304,6 +304,15 @@ export function _last(array) {
 export function _lastOrUndefined(array) {
     return array[array.length - 1];
 }
+/**
+ * Returns the first item of non-empty array.
+ * Throws if array is empty.
+ */
+export function _first(array) {
+    if (!array.length)
+        throw new Error('_first called on empty array');
+    return array[0];
+}
 export function _minOrUndefined(array) {
     const a = array.filter(_isNotNullish);
     if (!a.length)

package/dist-esm/datetime/localDate.js

@@ -126,6 +126,9 @@ export class LocalDate {
     day(v) {
         return v === undefined ? this.$day : this.set('day', v);
     }
+    dayOfWeek() {
+        return (this.toDate().getDay() || 7);
+    }
     isSame(d) {
         d = LocalDate.of(d);
         return this.$day === d.$day && this.$month === d.$month && this.$year === d.$year;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/js-lib",
-  "version": "14.211.0",
+  "version": "14.213.0",
   "scripts": {
     "prepare": "husky",
     "build-prod": "build-prod-esm-cjs",
@@ -22,7 +22,7 @@
     "crypto-js": "^4.1.1",
     "jest": "^29.0.0",
     "prettier": "^3.0.0",
-    "vitepress": "^1.0.0-rc.22",
+    "vitepress": "^1.0.0",
     "vue": "^3.2.45"
   },
   "resolutions": {

package/src/array/array.util.ts

@@ -365,6 +365,15 @@ export function _lastOrUndefined<T>(array: T[]): T | undefined {
   return array[array.length - 1]
 }
 
+/**
+ * Returns the first item of non-empty array.
+ * Throws if array is empty.
+ */
+export function _first<T>(array: T[]): T {
+  if (!array.length) throw new Error('_first called on empty array')
+  return array[0]!
+}
+
 export function _minOrUndefined<T>(array: T[]): NonNullable<T> | undefined {
   const a = array.filter(_isNotNullish)
   if (!a.length) return

package/src/datetime/localDate.ts

@@ -9,7 +9,7 @@ import type {
   UnixTimestampMillisNumber,
   UnixTimestampNumber,
 } from '../types'
-import { LocalTime } from './localTime'
+import { ISODayOfWeek, LocalTime } from './localTime'
 
 export type LocalDateUnit = LocalDateUnitStrict | 'week'
 export type LocalDateUnitStrict = 'year' | 'month' | 'day'
@@ -177,6 +177,10 @@ export class LocalDate {
     return v === undefined ? this.$day : this.set('day', v)
   }
 
+  dayOfWeek(): ISODayOfWeek {
+    return (this.toDate().getDay() || 7) as ISODayOfWeek
+  }
+
   isSame(d: LocalDateInput): boolean {
     d = LocalDate.of(d)
     return this.$day === d.$day && this.$month === d.$month && this.$year === d.$year