@naturalcycles/js-lib 15.48.0 → 15.49.0

package/dist/datetime/localDate.d.ts

@@ -1,5 +1,5 @@
 import { Iterable2 } from '../iter/iterable2.js';
-import type { Inclusiveness, IsoDate, IsoDateTime, IsoMonth, MonthId, MutateOptions, SortOptions, UnixTimestamp, UnixTimestampMillis } from '../types.js';
+import type { Inclusiveness, IsoDate, IsoDateTime, IsoMonth, MutateOptions, SortOptions, UnixTimestamp, UnixTimestampMillis } from '../types.js';
 import type { DateObject, ISODayOfWeek, LocalTime } from './localTime.js';
 export type LocalDateUnit = LocalDateUnitStrict | 'week';
 export type LocalDateUnitStrict = 'year' | 'month' | 'day';
@@ -151,10 +151,6 @@ export declare class LocalDate {
      * Returns e.g: `19840621`
      */
     toStringCompact(): string;
-    /**
-     * @deprecated Use toIsoMonth
-     */
-    toMonthId(): MonthId;
     /**
      * Returns unix timestamp of 00:00:00 of that date (in UTC, because unix timestamp always reflects UTC).
      */

package/dist/datetime/localDate.js

@@ -434,12 +434,6 @@ export class LocalDate {
             String(this.day).padStart(2, '0'),
         ].join('');
     }
-    /**
-     * @deprecated Use toIsoMonth
-     */
-    toMonthId() {
-        return this.toISOMonth();
-    }
     /**
      * Returns unix timestamp of 00:00:00 of that date (in UTC, because unix timestamp always reflects UTC).
      */

package/dist/datetime/localTime.d.ts

@@ -1,4 +1,4 @@
-import type { IANATimezone, Inclusiveness, IsoDate, IsoDateTime, IsoMonth, MonthId, MutateOptions, NumberOfHours, NumberOfMinutes, SortDirection, UnixTimestamp, UnixTimestampMillis } from '../types.js';
+import type { IANATimezone, Inclusiveness, IsoDate, IsoDateTime, IsoMonth, MutateOptions, NumberOfHours, NumberOfMinutes, SortDirection, UnixTimestamp, UnixTimestampMillis } from '../types.js';
 import type { LocalDate } from './localDate.js';
 import { WallTime } from './wallTime.js';
 export type LocalTimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second';
@@ -231,10 +231,6 @@ export declare class LocalTime {
     toStringCompact(seconds?: boolean): string;
     toString(): IsoDateTime;
     toJSON(): UnixTimestamp;
-    /**
-     * @deprecated Use toIsoMonth
-     */
-    toMonthId(): MonthId;
     format(fmt: Intl.DateTimeFormat | LocalTimeFormatter): string;
 }
 declare class LocalTimeFactory {

package/dist/datetime/localTime.js

@@ -634,12 +634,6 @@ export class LocalTime {
     toJSON() {
         return this.unix;
     }
-    /**
-     * @deprecated Use toIsoMonth
-     */
-    toMonthId() {
-        return this.toISOMonth();
-    }
     format(fmt) {
         if (fmt instanceof Intl.DateTimeFormat) {
             return fmt.format(this.$date);

package/dist/types.d.ts

@@ -197,11 +197,6 @@ export type IsoDateTime = Branded<string, 'IsoDateTime'>;
  * @example '2019-06'
  */
 export type IsoMonth = Branded<string, 'IsoMonth'>;
-/**
- * Identifies the Month.
- * @deprecated Use IsoMonth
- */
-export type MonthId = string;
 /**
  * Identifies IANA timezone name.
  * Branded type.
@@ -293,17 +288,23 @@ export declare const _stringMapValues: <T>(map: StringMap<T>) => T[];
  */
 export declare const _stringMapEntries: <T>(map: StringMap<T>) => [k: string, v: T][];
 /**
- * Alias of `Object.keys`, but returns keys typed as `keyof T`, not as just `string`.
+ * Resolves to a string literal union of the keys of T, meaning they are
+ * always keys of T and always strings (never numbers or symbols).
+ */
+export type ObjectKey<T> = `${Extract<keyof T, string | number>}`;
+/**
+ * Alias of `Object.keys`, but returns keys with a string type that's as
+ * narrow as possible.
  * This is how TypeScript should work, actually.
  */
-export declare const _objectKeys: <T extends AnyObject>(obj: T) => (keyof T)[];
+export declare const _objectKeys: <T extends AnyObject>(obj: T) => ObjectKey<T>[];
 /**
  * Alias of `Object.entries`, but returns better-typed output.
  *
  * So e.g you can use _objectEntries(obj).map([k, v] => {})
  * and `k` will be `keyof obj` instead of generic `string`.
  */
-export declare const _objectEntries: <T extends AnyObject>(obj: T) => [k: keyof T, v: T[keyof T]][];
+export declare const _objectEntries: <T extends AnyObject>(obj: T) => [k: ObjectKey<T>, v: T[ObjectKey<T>]][];
 export type NullishValue = null | undefined;
 export type FalsyValue = false | '' | 0 | null | undefined;
 /**

package/dist/types.js

@@ -31,7 +31,8 @@ export const _stringMapValues = Object.values;
  */
 export const _stringMapEntries = Object.entries;
 /**
- * Alias of `Object.keys`, but returns keys typed as `keyof T`, not as just `string`.
+ * Alias of `Object.keys`, but returns keys with a string type that's as
+ * narrow as possible.
  * This is how TypeScript should work, actually.
  */
 export const _objectKeys = Object.keys;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.48.0",
+  "version": "15.49.0",
   "dependencies": {
     "tslib": "^2",
     "undici": "^7",

package/src/datetime/localDate.ts

@@ -5,7 +5,6 @@ import type {
   IsoDate,
   IsoDateTime,
   IsoMonth,
-  MonthId,
   MutateOptions,
   SortOptions,
   UnixTimestamp,
@@ -513,13 +512,6 @@ export class LocalDate {
     ].join('')
   }
 
-  /**
-   * @deprecated Use toIsoMonth
-   */
-  toMonthId(): MonthId {
-    return this.toISOMonth()
-  }
-
   /**
    * Returns unix timestamp of 00:00:00 of that date (in UTC, because unix timestamp always reflects UTC).
    */

package/src/datetime/localTime.ts

@@ -5,7 +5,6 @@ import type {
   IsoDate,
   IsoDateTime,
   IsoMonth,
-  MonthId,
   MutateOptions,
   NumberOfHours,
   NumberOfMinutes,
@@ -765,13 +764,6 @@ export class LocalTime {
     return this.unix
   }
 
-  /**
-   * @deprecated Use toIsoMonth
-   */
-  toMonthId(): MonthId {
-    return this.toISOMonth()
-  }
-
   format(fmt: Intl.DateTimeFormat | LocalTimeFormatter): string {
     if (fmt instanceof Intl.DateTimeFormat) {
       return fmt.format(this.$date)

package/src/types.ts

@@ -254,12 +254,6 @@ export type IsoDateTime = Branded<string, 'IsoDateTime'>
  */
 export type IsoMonth = Branded<string, 'IsoMonth'>
 
-/**
- * Identifies the Month.
- * @deprecated Use IsoMonth
- */
-export type MonthId = string
-
 /**
  * Identifies IANA timezone name.
  * Branded type.
@@ -367,10 +361,17 @@ export const _stringMapValues = Object.values as <T>(map: StringMap<T>) => T[]
 export const _stringMapEntries = Object.entries as <T>(map: StringMap<T>) => [k: string, v: T][]
 
 /**
- * Alias of `Object.keys`, but returns keys typed as `keyof T`, not as just `string`.
+ * Resolves to a string literal union of the keys of T, meaning they are
+ * always keys of T and always strings (never numbers or symbols).
+ */
+export type ObjectKey<T> = `${Extract<keyof T, string | number>}`
+
+/**
+ * Alias of `Object.keys`, but returns keys with a string type that's as
+ * narrow as possible.
  * This is how TypeScript should work, actually.
  */
-export const _objectKeys = Object.keys as <T extends AnyObject>(obj: T) => (keyof T)[]
+export const _objectKeys = Object.keys as <T extends AnyObject>(obj: T) => ObjectKey<T>[]
 
 /**
  * Alias of `Object.entries`, but returns better-typed output.
@@ -380,7 +381,7 @@ export const _objectKeys = Object.keys as <T extends AnyObject>(obj: T) => (keyo
  */
 export const _objectEntries = Object.entries as <T extends AnyObject>(
   obj: T,
-) => [k: keyof T, v: T[keyof T]][]
+) => [k: ObjectKey<T>, v: T[ObjectKey<T>]][]
 
 export type NullishValue = null | undefined
 export type FalsyValue = false | '' | 0 | null | undefined