@naturalcycles/js-lib 15.101.0 → 15.102.0

package/dist/abort.d.ts

@@ -28,14 +28,6 @@ export declare function createAbortableSignal(): AbortableSignal;
  * Otherwise returns undefined.
  */
 export declare function abortSignalTimeoutOrUndefined(ms: NumberOfMilliseconds | undefined): AbortSignal | undefined;
-/**
- * Returns an AbortSignal that aborts after the given number of milliseconds.
- * Uses native `AbortSignal.timeout()` when available, falls back to a polyfill.
- *
- * The abort reason is a DOMException with name "TimeoutError".
- */
-export declare function abortSignalTimeout(ms: NumberOfMilliseconds): AbortSignal;
-export declare function polyfilledAbortSignalTimeout(ms: NumberOfMilliseconds): AbortSignal;
 /**
  * Returns AbortSignal.any(signals) is the array (after filtering undefined inputs) is not empty,
  * otherwise undefined.

package/dist/abort.js

@@ -16,25 +16,7 @@ export function createAbortableSignal() {
  * Otherwise returns undefined.
  */
 export function abortSignalTimeoutOrUndefined(ms) {
-    return ms ? abortSignalTimeout(ms) : undefined;
-}
-/**
- * Returns an AbortSignal that aborts after the given number of milliseconds.
- * Uses native `AbortSignal.timeout()` when available, falls back to a polyfill.
- *
- * The abort reason is a DOMException with name "TimeoutError".
- */
-export function abortSignalTimeout(ms) {
-    return typeof AbortSignal.timeout === 'function'
-        ? AbortSignal.timeout(ms)
-        : polyfilledAbortSignalTimeout(ms);
-}
-export function polyfilledAbortSignalTimeout(ms) {
-    const ac = new AbortController();
-    setTimeout(() => {
-        ac.abort(new DOMException('The operation was aborted due to timeout', 'TimeoutError'));
-    }, ms);
-    return ac.signal;
+    return ms ? AbortSignal.timeout(ms) : undefined;
 }
 /**
  * Returns AbortSignal.any(signals) is the array (after filtering undefined inputs) is not empty,
@@ -57,6 +39,7 @@ export function abortSignalAny(signals) {
     if (signals.length === 1) {
         return signals[0];
     }
+    // AbortSignal.any needs Chrome 116+ / Safari 17.4+, above our browser floor (Chrome 110, iOS 16.7)
     return typeof AbortSignal.any === 'function'
         ? AbortSignal.any(signals) // lib.dom types require a mutable array, but it is only read
         : polyfilledAbortSignalAny(signals);

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

@@ -99,9 +99,7 @@ export declare function _find<T>(items: readonly T[], predicate: AbortablePredic
 /**
  * Similar to `Array.findLast`, but the `predicate` may return `END` to stop the iteration early.
  *
- * Use `Array.findLast` if you don't need to stop the iteration early, which is supported:
- * - in Node since 18+
- * - in iOS Safari since 15.4
+ * Use `Array.findLast` if you don't need to stop the iteration early.
  */
 export declare function _findLast<T>(items: readonly T[], predicate: AbortablePredicate<T>): T | undefined;
 export declare function _takeWhile<T>(items: readonly T[], predicate: Predicate<T>): T[];

package/dist/array/array.util.js

@@ -174,9 +174,7 @@ export function _find(items, predicate) {
 /**
  * Similar to `Array.findLast`, but the `predicate` may return `END` to stop the iteration early.
  *
- * Use `Array.findLast` if you don't need to stop the iteration early, which is supported:
- * - in Node since 18+
- * - in iOS Safari since 15.4
+ * Use `Array.findLast` if you don't need to stop the iteration early.
  */
 export function _findLast(items, predicate) {
     return _find(items.toReversed(), predicate);

package/dist/array/sort.js

@@ -42,7 +42,7 @@ class Comparators {
         return b.created - a.created;
     }
 }
-export const comparators = new Comparators();
+export const comparators = /* @__PURE__ */ new Comparators();
 /**
  * _sortBy([{age: 20}, {age: 10}], 'age')
  * // => [{age: 10}, {age: 20}]

package/dist/array/sortedSet.d.ts

@@ -1,4 +1,4 @@
-import { Set2 } from '../object/index.js';
+import { Set2 } from '../object/set2.js';
 import type { Comparator } from '../types.js';
 export interface SortedSetOptions<T> {
     /**

package/dist/array/sortedSet.js

@@ -1,4 +1,4 @@
-import { Set2 } from '../object/index.js';
+import { Set2 } from '../object/set2.js';
 /**
  * Like Set, but keeps members sorted after every insertion.
  */

package/dist/asyncManager.js

@@ -1,4 +1,4 @@
-import { nowUnixMillis } from './datetime/localTime.js';
+import { nowUnixMillis } from './datetime/time.util.js';
 import { consoleLogger } from './log/commonLogger.js';
 class AsyncManagerImpl {
     logger = consoleLogger;
@@ -82,6 +82,6 @@ class AsyncManagerImpl {
  *
  * @experimental
  */
-export const AsyncManager = new AsyncManagerImpl();
+export const AsyncManager = /* @__PURE__ */ new AsyncManagerImpl();
 // Shorthand alias
-export const runInBackground = AsyncManager.runInBackground.bind(AsyncManager);
+export const runInBackground = /* @__PURE__ */ AsyncManager.runInBackground.bind(AsyncManager);

package/dist/browser/analytics.util.js

@@ -1,4 +1,4 @@
-import { newDate, nowUnixMillis } from '../datetime/localTime.js';
+import { newDate, nowUnixMillis } from '../datetime/time.util.js';
 import { isServerSide } from '../env.js';
 import { loadScript } from './script.util.js';
 /**

package/dist/browser/topbar.js

@@ -60,7 +60,7 @@ const createCanvas = () => {
 export const topbar = {
     config(opts) {
         for (const key in opts) {
-            if (options.hasOwnProperty(key)) {
+            if (Object.hasOwn(options, key)) {
                 // @ts-expect-error
                 options[key] = opts[key];
             }

package/dist/datetime/localDate.js

@@ -719,8 +719,13 @@ class LocalDateFactory {
         return year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
     }
 }
-const localDateFactory = new LocalDateFactory();
-export const localDate = localDateFactory.fromInput.bind(localDateFactory);
-// The line below is the blackest of black magic I have ever written in 2024.
-// And probably 2023 as well.
-Object.setPrototypeOf(localDate, localDateFactory);
+// Built inside a function, so the whole construct can be marked pure and tree-shaken (see treeshake.test.ts)
+export const localDate = /* @__PURE__ */ createLocalDateFn();
+function createLocalDateFn() {
+    const localDateFactory = new LocalDateFactory();
+    const fn = localDateFactory.fromInput.bind(localDateFactory);
+    // The line below is the blackest of black magic I have ever written in 2024.
+    // And probably 2023 as well.
+    Object.setPrototypeOf(fn, localDateFactory);
+    return fn;
+}

package/dist/datetime/localTime.d.ts

@@ -258,13 +258,13 @@ declare class LocalTimeFactory {
      Convenience function to return current Unix timestamp in seconds.
      Like Date.now(), but in seconds.
   
-     Import nowUnix function individually in places where importing localTime is too heavy.
+     Import nowUnix from time.util.js in places where importing localTime is too heavy.
      */
     nowUnix(): UnixTimestamp;
     /**
      Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
   
-     Import nowUnixMillis function individually in places where importing localTime is too heavy.
+     Import nowUnixMillis from time.util.js in places where importing localTime is too heavy.
      */
     nowUnixMillis(): UnixTimestampMillis;
     /**
@@ -335,21 +335,4 @@ interface LocalTimeFn extends LocalTimeFactory {
     (d: LocalTimeInput): LocalTime;
 }
 export declare const localTime: LocalTimeFn;
-/**
- * Can be used instead of `oxlint-disable ...` in places where Date is intentionally needed
- */
-export declare function newDate(): Date;
-/**
- Convenience function to return current Unix timestamp in seconds.
- Like Date.now(), but in seconds.
-
- Import nowUnix function individually in places where importing localTime is too heavy.
- */
-export declare function nowUnix(): UnixTimestamp;
-/**
- Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
-
- Import nowUnixMillis function individually in places where importing localTime is too heavy.
- */
-export declare function nowUnixMillis(): UnixTimestampMillis;
 export {};

package/dist/datetime/localTime.js

@@ -2,7 +2,7 @@ import { comparators } from '../array/sort.js';
 import { _assert } from '../error/assert.js';
 import { Intl2 } from '../intl/intl.js';
 import { localDate } from './localDate.js';
-import { _ms } from './time.util.js';
+import { _ms, nowUnix, nowUnixMillis } from './time.util.js';
 // oxlint-disable-next-line import/no-cycle -- intentional cycle
 import { WallTime } from './wallTime.js';
 export var ISODayOfWeek;
@@ -677,7 +677,7 @@ class LocalTimeFactory {
      Convenience function to return current Unix timestamp in seconds.
      Like Date.now(), but in seconds.
   
-     Import nowUnix function individually in places where importing localTime is too heavy.
+     Import nowUnix from time.util.js in places where importing localTime is too heavy.
      */
     nowUnix() {
         return nowUnix();
@@ -685,7 +685,7 @@ class LocalTimeFactory {
     /**
      Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
   
-     Import nowUnixMillis function individually in places where importing localTime is too heavy.
+     Import nowUnixMillis from time.util.js in places where importing localTime is too heavy.
      */
     nowUnixMillis() {
         return nowUnixMillis();
@@ -1031,31 +1031,13 @@ function getWallComponentsInTimezone(date, tz) {
     }
     return dto;
 }
-const localTimeFactory = new LocalTimeFactory();
-export const localTime = localTimeFactory.fromInput.bind(localTimeFactory);
-// The line below is the blackest of black magic I have ever written in 2024.
-// And probably 2023 as well.
-Object.setPrototypeOf(localTime, localTimeFactory);
-/**
- * Can be used instead of `oxlint-disable ...` in places where Date is intentionally needed
- */
-export function newDate() {
-    return new Date();
-}
-/**
- Convenience function to return current Unix timestamp in seconds.
- Like Date.now(), but in seconds.
-
- Import nowUnix function individually in places where importing localTime is too heavy.
- */
-export function nowUnix() {
-    return Math.floor(Date.now() / 1000);
-}
-/**
- Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
-
- Import nowUnixMillis function individually in places where importing localTime is too heavy.
- */
-export function nowUnixMillis() {
-    return Date.now();
+// Built inside a function, so the whole construct can be marked pure and tree-shaken (see treeshake.test.ts)
+export const localTime = /* @__PURE__ */ createLocalTimeFn();
+function createLocalTimeFn() {
+    const localTimeFactory = new LocalTimeFactory();
+    const fn = localTimeFactory.fromInput.bind(localTimeFactory);
+    // The line below is the blackest of black magic I have ever written in 2024.
+    // And probably 2023 as well.
+    Object.setPrototypeOf(fn, localTimeFactory);
+    return fn;
 }

package/dist/datetime/time.util.d.ts

@@ -1,4 +1,4 @@
-import type { NumberOfMilliseconds, UnixTimestampMillis } from '../types.js';
+import type { NumberOfMilliseconds, UnixTimestamp, UnixTimestampMillis } from '../types.js';
 /**
  * using _ = blockTimer()
  * // will log "took 1.234 sec" on dispose
@@ -23,3 +23,20 @@ export declare function _since(from: UnixTimestampMillis, until?: UnixTimestampM
  * 1h3m12s
  */
 export declare function _ms(millis: NumberOfMilliseconds): string;
+/**
+ * Can be used instead of `oxlint-disable ...` in places where Date is intentionally needed
+ */
+export declare function newDate(): Date;
+/**
+ Convenience function to return current Unix timestamp in seconds.
+ Like Date.now(), but in seconds.
+
+ Lives here rather than in localTime.ts, so importing it doesn't pull LocalTime into browser bundles.
+ */
+export declare function nowUnix(): UnixTimestamp;
+/**
+ Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
+
+ Lives here rather than in localTime.ts, so importing it doesn't pull LocalTime into browser bundles.
+ */
+export declare function nowUnixMillis(): UnixTimestampMillis;

package/dist/datetime/time.util.js

@@ -8,8 +8,7 @@
  * @experimental
  */
 export function _blockTimer(name) {
-    // oxlint-disable-next-line no-restricted-globals -- localTime imports this module, so it can't import localTime back
-    const started = Date.now();
+    const started = nowUnixMillis();
     return {
         [Symbol.dispose]() {
             console.log(`${name ? name + ' ' : ''}took ${_since(started)}`);
@@ -19,9 +18,7 @@ export function _blockTimer(name) {
 /**
  * Returns time passed since `from` until `until` (default to Date.now())
  */
-export function _since(from, 
-// oxlint-disable-next-line no-restricted-globals -- localTime imports this module, so it can't import localTime back
-until = Date.now()) {
+export function _since(from, until = nowUnixMillis()) {
     return _ms(until - from);
 }
 /**
@@ -62,3 +59,29 @@ export function _ms(millis) {
     const days = Math.floor(hrs / 24);
     return `${days} days`;
 }
+/**
+ * Can be used instead of `oxlint-disable ...` in places where Date is intentionally needed
+ */
+export function newDate() {
+    // oxlint-disable-next-line no-restricted-globals -- the one sanctioned way to get a native Date
+    return new Date();
+}
+/**
+ Convenience function to return current Unix timestamp in seconds.
+ Like Date.now(), but in seconds.
+
+ Lives here rather than in localTime.ts, so importing it doesn't pull LocalTime into browser bundles.
+ */
+export function nowUnix() {
+    // oxlint-disable-next-line no-restricted-globals -- the one sanctioned way to read the clock
+    return Math.floor(Date.now() / 1000);
+}
+/**
+ Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
+
+ Lives here rather than in localTime.ts, so importing it doesn't pull LocalTime into browser bundles.
+ */
+export function nowUnixMillis() {
+    // oxlint-disable-next-line no-restricted-globals -- the one sanctioned way to read the clock
+    return Date.now();
+}

package/dist/decorators/createPromiseDecorator.js

@@ -1,4 +1,4 @@
-import { nowUnixMillis } from '../datetime/localTime.js';
+import { nowUnixMillis } from '../datetime/time.util.js';
 import { _getTargetMethodSignature } from './decorator.util.js';
 /**
  * @example

package/dist/decorators/debounce.js

@@ -1,4 +1,4 @@
-import { nowUnixMillis } from '../datetime/localTime.js';
+import { nowUnixMillis } from '../datetime/time.util.js';
 import { _anyToError } from '../error/error.util.js';
 import { pDefer } from '../promise/pDefer.js';
 export function _debounce(func, wait, opt = {}) {

package/dist/decorators/logMethod.decorator.js

@@ -1,5 +1,4 @@
-import { nowUnixMillis } from '../datetime/localTime.js';
-import { _ms } from '../datetime/time.util.js';
+import { _ms, nowUnixMillis } from '../datetime/time.util.js';
 import { _assert } from '../error/assert.js';
 import { consoleLogger } from '../log/commonLogger.js';
 import { SimpleMovingAverage } from '../math/sma.js';

package/dist/error/tryCatch.js

@@ -1,5 +1,4 @@
-import { nowUnixMillis } from '../datetime/localTime.js';
-import { _since } from '../datetime/time.util.js';
+import { _since, nowUnixMillis } from '../datetime/time.util.js';
 import { consoleLogger } from '../log/commonLogger.js';
 import { _anyToError } from './error.util.js';
 /**

package/dist/http/fetcher.js

@@ -2,8 +2,7 @@
 /// <reference lib="dom" preserve="true" />
 /// <reference lib="dom.iterable" preserve="true" />
 import { abortSignalAnyOrUndefined, abortSignalTimeoutOrUndefined } from '../abort.js';
-import { nowUnixMillis } from '../datetime/localTime.js';
-import { _ms, _since } from '../datetime/time.util.js';
+import { _ms, _since, nowUnixMillis } from '../datetime/time.util.js';
 import { isServerSide } from '../env.js';
 import { _assert, _assertErrorClassOrRethrow, _assertIsError } from '../error/assert.js';
 import { _anyToError, _anyToErrorObject, _errorDataAppend, _errorLikeToErrorObject, HttpRequestError, UnexpectedPassError, } from '../error/error.util.js';
@@ -12,9 +11,10 @@ import { _clamp } from '../number/number.util.js';
 import { _filterFalsyValues, _filterNullishValues, _filterUndefinedValues, _mapKeys, _merge, _omit, _pick, } from '../object/object.util.js';
 import { pDelaySignal } from '../promise/pDelay.js';
 import { pTimeout } from '../promise/pTimeout.js';
-import { _toUrlOrNull } from '../string/index.js';
 import { _jsonParse, _jsonParseIfPossible } from '../string/json.util.js';
+import { _toUrlOrNull } from '../string/url.util.js';
 import { HTTP_METHODS } from './http.model.js';
+const FETCHER_VERSION = 5;
 /**
  * Experimental wrapper around Fetch.
  * Works in both Browser and Node, using `globalThis.fetch`.
@@ -26,16 +26,14 @@ export class Fetcher {
      *
      * Version is to be incremented every time a difference in behaviour (or a bugfix) is done.
      */
-    static VERSION = 5;
+    static VERSION = FETCHER_VERSION;
     /**
      * userAgent is statically exposed as Fetcher.userAgent.
      * It can be modified globally, and will be used (read) at the start of every request.
      */
-    static userAgent = isServerSide() ? `fetcher/${this.VERSION}` : undefined;
+    // Pure, and not reading `this.VERSION`, so bundlers can drop Fetcher when unused (see treeshake.test.ts)
+    static userAgent = /* @__PURE__ */ isServerSide() ? `fetcher/${FETCHER_VERSION}` : undefined;
     constructor(cfg = {}) {
-        if (typeof globalThis.fetch !== 'function') {
-            throw new TypeError('globalThis.fetch is not available');
-        }
         this.cfg = this.normalizeCfg(cfg);
         // Dynamically create all helper methods
         for (const method of HTTP_METHODS) {

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export * from './bot.model.js';
 export * from './define.js';
 export * from './enum.util.js';
 export * from './env.js';
-export * from './env/buildInfo.js';
+export type * from './env/buildInfo.js';
 export * from './form.util.js';
 export * from './is.util.js';
 export * from './iter/asyncIterable2.js';

package/dist/index.js

@@ -4,7 +4,6 @@ export * from './bot.model.js';
 export * from './define.js';
 export * from './enum.util.js';
 export * from './env.js';
-export * from './env/buildInfo.js';
 export * from './form.util.js';
 export * from './is.util.js';
 export * from './iter/asyncIterable2.js';

package/dist/object/keySortedMap.js

@@ -1,4 +1,4 @@
-import { _assert } from '../error/index.js';
+import { _assert } from '../error/assert.js';
 export class KeySortedMap {
     map;
     #sortedKeys;

package/dist/object/lazyKeySortedMap.js

@@ -1,4 +1,4 @@
-import { _assert } from '../error/index.js';
+import { _assert } from '../error/assert.js';
 export class LazyKeySortedMap {
     map;
     maybeSortedKeys;

package/dist/object/object.util.js

@@ -387,7 +387,7 @@ export function _unset(obj, prop) {
     if (!_isObject(obj)) {
         return;
     }
-    if (obj.hasOwnProperty(prop)) {
+    if (Object.hasOwn(obj, prop)) {
         delete obj[prop];
         return;
     }
@@ -512,7 +512,7 @@ export function _deepFreeze(o) {
     // Object.freeze — never assigns properties from one object to another.
     Object.freeze(o);
     Object.getOwnPropertyNames(o).forEach(prop => {
-        if (o.hasOwnProperty(prop) &&
+        if (Object.hasOwn(o, prop) &&
             o[prop] !== null &&
             (typeof o[prop] === 'object' || typeof o[prop] === 'function') &&
             !Object.isFrozen(o[prop])) {

package/dist/promise/pGradualQueue.js

@@ -1,4 +1,4 @@
-import { nowUnixMillis } from '../datetime/localTime.js';
+import { nowUnixMillis } from '../datetime/time.util.js';
 import { ErrorMode } from '../error/errorMode.js';
 import { createCommonLoggerAtLevel } from '../log/commonLogger.js';
 import { pDefer } from './pDefer.js';

package/dist/promise/pRetry.js

@@ -1,5 +1,4 @@
-import { nowUnixMillis } from '../datetime/localTime.js';
-import { _since } from '../datetime/time.util.js';
+import { _since, nowUnixMillis } from '../datetime/time.util.js';
 import { _errorDataAppend } from '../error/error.util.js';
 import { consoleLogger } from '../log/commonLogger.js';
 import { pDelay } from './pDelay.js';

package/dist/semver.js

@@ -126,11 +126,16 @@ class SemverFactory {
         return opt.mutate ? items.sort(cmp) : items.toSorted(cmp);
     }
 }
-const semverFactory = new SemverFactory();
-export const semver2 = semverFactory.fromInput.bind(semverFactory);
-// The line below is the blackest of black magic I have ever written in 2024.
-// And probably 2023 as well.
-Object.setPrototypeOf(semver2, semverFactory);
+// Built inside a function, so the whole construct can be marked pure and tree-shaken (see treeshake.test.ts)
+export const semver2 = /* @__PURE__ */ createSemverFn();
+function createSemverFn() {
+    const semverFactory = new SemverFactory();
+    const fn = semverFactory.fromInput.bind(semverFactory);
+    // The line below is the blackest of black magic I have ever written in 2024.
+    // And probably 2023 as well.
+    Object.setPrototypeOf(fn, semverFactory);
+    return fn;
+}
 /**
  * Returns 1 if a > b
  * returns 0 if they are equal

package/dist/string/stringify.js

@@ -4,7 +4,6 @@ import { _isBackendErrorResponseObject, _isErrorLike, _isErrorObject } from '../
 import { _jsonParseIfPossible } from './json.util.js';
 import { _safeJsonStringify } from './safeJsonStringify.js';
 import { _truncateMiddle } from './string.util.js';
-const supportsAggregateError = typeof globalThis.AggregateError === 'function';
 let globalStringifyFunction = _safeJsonStringify;
 /**
  * Allows to set Global "stringifyFunction" that will be used to "pretty-print" objects
@@ -127,7 +126,7 @@ function stringifyErrorLike(obj, opt) {
         const sLines = s.split('\n').length;
         s = [s, ...obj.stack.split('\n').slice(sLines)].join('\n');
     }
-    if (supportsAggregateError && obj instanceof AggregateError && obj.errors.length) {
+    if (obj instanceof AggregateError && obj.errors.length) {
         s = [
             s,
             `${obj.errors.length} error(s):`,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.101.0",
+  "version": "15.102.0",
   "dependencies": {
     "tslib": "^2"
   },
@@ -14,9 +14,10 @@
     }
   },
   "devDependencies": {
-    "@naturalcycles/dev-lib": "20.71.0",
+    "@naturalcycles/dev-lib": "20.72.0",
     "@types/node": "^26",
     "@types/semver": "^7",
+    "rolldown": "^1",
     "typescript": "^7",
     "dayjs": "^1"
   },
@@ -35,6 +36,7 @@
     "./decorators": "./dist/decorators/index.js",
     "./decorators/*.js": "./dist/decorators/*.js",
     "./deviceIdService": "./dist/deviceIdService.js",
+    "./env/*.js": "./dist/env/*.js",
     "./error": "./dist/error/index.js",
     "./error/*.js": "./dist/error/*.js",
     "./http": "./dist/http/index.js",

package/src/abort.ts

@@ -39,27 +39,7 @@ export function createAbortableSignal(): AbortableSignal {
 export function abortSignalTimeoutOrUndefined(
   ms: NumberOfMilliseconds | undefined,
 ): AbortSignal | undefined {
-  return ms ? abortSignalTimeout(ms) : undefined
-}
-
-/**
- * Returns an AbortSignal that aborts after the given number of milliseconds.
- * Uses native `AbortSignal.timeout()` when available, falls back to a polyfill.
- *
- * The abort reason is a DOMException with name "TimeoutError".
- */
-export function abortSignalTimeout(ms: NumberOfMilliseconds): AbortSignal {
-  return typeof AbortSignal.timeout === 'function'
-    ? AbortSignal.timeout(ms)
-    : polyfilledAbortSignalTimeout(ms)
-}
-
-export function polyfilledAbortSignalTimeout(ms: NumberOfMilliseconds): AbortSignal {
-  const ac = new AbortController()
-  setTimeout(() => {
-    ac.abort(new DOMException('The operation was aborted due to timeout', 'TimeoutError'))
-  }, ms)
-  return ac.signal
+  return ms ? AbortSignal.timeout(ms) : undefined
 }
 
 /**
@@ -87,6 +67,7 @@ export function abortSignalAny(signals: readonly AbortSignal[]): AbortSignal {
     return signals[0]!
   }
 
+  // AbortSignal.any needs Chrome 116+ / Safari 17.4+, above our browser floor (Chrome 110, iOS 16.7)
   return typeof AbortSignal.any === 'function'
     ? AbortSignal.any(signals as AbortSignal[]) // lib.dom types require a mutable array, but it is only read
     : polyfilledAbortSignalAny(signals)

package/src/array/array.util.ts

@@ -195,9 +195,7 @@ export function _find<T>(items: readonly T[], predicate: AbortablePredicate<T>):
 /**
  * Similar to `Array.findLast`, but the `predicate` may return `END` to stop the iteration early.
  *
- * Use `Array.findLast` if you don't need to stop the iteration early, which is supported:
- * - in Node since 18+
- * - in iOS Safari since 15.4
+ * Use `Array.findLast` if you don't need to stop the iteration early.
  */
 export function _findLast<T>(items: readonly T[], predicate: AbortablePredicate<T>): T | undefined {
   return _find(items.toReversed(), predicate)

package/src/array/sort.ts

@@ -55,7 +55,7 @@ class Comparators {
   }
 }
 
-export const comparators = new Comparators()
+export const comparators = /* @__PURE__ */ new Comparators()
 
 interface ComparatorByOptions {
   /**

package/src/array/sortedSet.ts

@@ -1,4 +1,4 @@
-import { Set2 } from '../object/index.js'
+import { Set2 } from '../object/set2.js'
 import type { Comparator } from '../types.js'
 
 export interface SortedSetOptions<T> {

package/src/asyncManager.ts

@@ -1,4 +1,4 @@
-import { nowUnixMillis } from './datetime/localTime.js'
+import { nowUnixMillis } from './datetime/time.util.js'
 import { consoleLogger } from './log/commonLogger.js'
 import type { CommonLogger } from './log/commonLogger.js'
 import type { NumberOfMilliseconds } from './types.js'
@@ -93,9 +93,9 @@ class AsyncManagerImpl {
  *
  * @experimental
  */
-export const AsyncManager = new AsyncManagerImpl()
+export const AsyncManager = /* @__PURE__ */ new AsyncManagerImpl()
 
 // Shorthand alias
-export const runInBackground = AsyncManager.runInBackground.bind(AsyncManager)
+export const runInBackground = /* @__PURE__ */ AsyncManager.runInBackground.bind(AsyncManager)
 
 export type OnErrorHook = (err: Error) => any

package/src/browser/analytics.util.ts

@@ -1,4 +1,4 @@
-import { newDate, nowUnixMillis } from '../datetime/localTime.js'
+import { newDate, nowUnixMillis } from '../datetime/time.util.js'
 import { isServerSide } from '../env.js'
 import { loadScript } from './script.util.js'
 

package/src/browser/topbar.ts

@@ -82,7 +82,7 @@ const createCanvas = () => {
 export const topbar = {
   config(opts: TopBarOptions) {
     for (const key in opts) {
-      if (options.hasOwnProperty(key)) {
+      if (Object.hasOwn(options, key)) {
         // @ts-expect-error
         options[key] = opts[key]
       }

package/src/datetime/localDate.ts

@@ -853,10 +853,14 @@ interface LocalDateFn extends LocalDateFactory {
   (d: LocalDateInput): LocalDate
 }
 
-const localDateFactory = new LocalDateFactory()
-
-export const localDate = localDateFactory.fromInput.bind(localDateFactory) as LocalDateFn
-
-// The line below is the blackest of black magic I have ever written in 2024.
-// And probably 2023 as well.
-Object.setPrototypeOf(localDate, localDateFactory)
+// Built inside a function, so the whole construct can be marked pure and tree-shaken (see treeshake.test.ts)
+export const localDate = /* @__PURE__ */ createLocalDateFn()
+
+function createLocalDateFn(): LocalDateFn {
+  const localDateFactory = new LocalDateFactory()
+  const fn = localDateFactory.fromInput.bind(localDateFactory) as LocalDateFn
+  // The line below is the blackest of black magic I have ever written in 2024.
+  // And probably 2023 as well.
+  Object.setPrototypeOf(fn, localDateFactory)
+  return fn
+}

package/src/datetime/localTime.ts

@@ -17,7 +17,7 @@ import type {
 // oxlint-disable-next-line import/no-cycle -- intentional cycle
 import type { LocalDate } from './localDate.js'
 import { localDate } from './localDate.js'
-import { _ms } from './time.util.js'
+import { _ms, nowUnix, nowUnixMillis } from './time.util.js'
 // oxlint-disable-next-line import/no-cycle -- intentional cycle
 import { WallTime } from './wallTime.js'
 
@@ -817,7 +817,7 @@ class LocalTimeFactory {
    Convenience function to return current Unix timestamp in seconds.
    Like Date.now(), but in seconds.
 
-   Import nowUnix function individually in places where importing localTime is too heavy.
+   Import nowUnix from time.util.js in places where importing localTime is too heavy.
    */
   nowUnix(): UnixTimestamp {
     return nowUnix()
@@ -826,7 +826,7 @@ class LocalTimeFactory {
   /**
    Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
 
-   Import nowUnixMillis function individually in places where importing localTime is too heavy.
+   Import nowUnixMillis from time.util.js in places where importing localTime is too heavy.
    */
   nowUnixMillis(): UnixTimestampMillis {
     return nowUnixMillis()
@@ -1212,36 +1212,14 @@ interface LocalTimeFn extends LocalTimeFactory {
   (d: LocalTimeInput): LocalTime
 }
 
-const localTimeFactory = new LocalTimeFactory()
+// Built inside a function, so the whole construct can be marked pure and tree-shaken (see treeshake.test.ts)
+export const localTime = /* @__PURE__ */ createLocalTimeFn()
 
-export const localTime = localTimeFactory.fromInput.bind(localTimeFactory) as LocalTimeFn
-
-// The line below is the blackest of black magic I have ever written in 2024.
-// And probably 2023 as well.
-Object.setPrototypeOf(localTime, localTimeFactory)
-
-/**
- * Can be used instead of `oxlint-disable ...` in places where Date is intentionally needed
- */
-export function newDate(): Date {
-  return new Date()
-}
-
-/**
- Convenience function to return current Unix timestamp in seconds.
- Like Date.now(), but in seconds.
-
- Import nowUnix function individually in places where importing localTime is too heavy.
- */
-export function nowUnix(): UnixTimestamp {
-  return Math.floor(Date.now() / 1000) as UnixTimestamp
-}
-
-/**
- Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
-
- Import nowUnixMillis function individually in places where importing localTime is too heavy.
- */
-export function nowUnixMillis(): UnixTimestampMillis {
-  return Date.now() as UnixTimestampMillis
+function createLocalTimeFn(): LocalTimeFn {
+  const localTimeFactory = new LocalTimeFactory()
+  const fn = localTimeFactory.fromInput.bind(localTimeFactory) as LocalTimeFn
+  // The line below is the blackest of black magic I have ever written in 2024.
+  // And probably 2023 as well.
+  Object.setPrototypeOf(fn, localTimeFactory)
+  return fn
 }

package/src/datetime/time.util.ts

@@ -1,4 +1,4 @@
-import type { NumberOfMilliseconds, UnixTimestampMillis } from '../types.js'
+import type { NumberOfMilliseconds, UnixTimestamp, UnixTimestampMillis } from '../types.js'
 
 /**
  * using _ = blockTimer()
@@ -10,8 +10,7 @@ import type { NumberOfMilliseconds, UnixTimestampMillis } from '../types.js'
  * @experimental
  */
 export function _blockTimer(name?: string): Disposable {
-  // oxlint-disable-next-line no-restricted-globals -- localTime imports this module, so it can't import localTime back
-  const started = Date.now() as UnixTimestampMillis
+  const started = nowUnixMillis()
   return {
     [Symbol.dispose](): void {
       console.log(`${name ? name + ' ' : ''}took ${_since(started)}`)
@@ -24,8 +23,7 @@ export function _blockTimer(name?: string): Disposable {
  */
 export function _since(
   from: UnixTimestampMillis,
-  // oxlint-disable-next-line no-restricted-globals -- localTime imports this module, so it can't import localTime back
-  until: UnixTimestampMillis = Date.now() as UnixTimestampMillis,
+  until: UnixTimestampMillis = nowUnixMillis(),
 ): string {
   return _ms(until - from)
 }
@@ -74,3 +72,32 @@ export function _ms(millis: NumberOfMilliseconds): string {
   const days = Math.floor(hrs / 24)
   return `${days} days`
 }
+
+/**
+ * Can be used instead of `oxlint-disable ...` in places where Date is intentionally needed
+ */
+export function newDate(): Date {
+  // oxlint-disable-next-line no-restricted-globals -- the one sanctioned way to get a native Date
+  return new Date()
+}
+
+/**
+ Convenience function to return current Unix timestamp in seconds.
+ Like Date.now(), but in seconds.
+
+ Lives here rather than in localTime.ts, so importing it doesn't pull LocalTime into browser bundles.
+ */
+export function nowUnix(): UnixTimestamp {
+  // oxlint-disable-next-line no-restricted-globals -- the one sanctioned way to read the clock
+  return Math.floor(Date.now() / 1000) as UnixTimestamp
+}
+
+/**
+ Convenience function that retuns the same as Date.now(), but with proper type of UnixTimestampMillis.
+
+ Lives here rather than in localTime.ts, so importing it doesn't pull LocalTime into browser bundles.
+ */
+export function nowUnixMillis(): UnixTimestampMillis {
+  // oxlint-disable-next-line no-restricted-globals -- the one sanctioned way to read the clock
+  return Date.now() as UnixTimestampMillis
+}

package/src/decorators/createPromiseDecorator.ts

@@ -1,4 +1,4 @@
-import { nowUnixMillis } from '../datetime/localTime.js'
+import { nowUnixMillis } from '../datetime/time.util.js'
 import { _getTargetMethodSignature } from './decorator.util.js'
 
 export interface PromiseDecoratorCfg<RES = any, PARAMS = any> {

package/src/decorators/debounce.ts

@@ -1,4 +1,4 @@
-import { nowUnixMillis } from '../datetime/localTime.js'
+import { nowUnixMillis } from '../datetime/time.util.js'
 import { _anyToError } from '../error/error.util.js'
 import { pDefer } from '../promise/pDefer.js'
 import type { DeferredPromise } from '../promise/pDefer.js'

package/src/decorators/logMethod.decorator.ts

@@ -1,5 +1,4 @@
-import { nowUnixMillis } from '../datetime/localTime.js'
-import { _ms } from '../datetime/time.util.js'
+import { _ms, nowUnixMillis } from '../datetime/time.util.js'
 import { _assert } from '../error/assert.js'
 import { consoleLogger } from '../log/commonLogger.js'
 import type { CommonLogger } from '../log/commonLogger.js'

package/src/error/tryCatch.ts

@@ -1,5 +1,4 @@
-import { nowUnixMillis } from '../datetime/localTime.js'
-import { _since } from '../datetime/time.util.js'
+import { _since, nowUnixMillis } from '../datetime/time.util.js'
 import { consoleLogger } from '../log/commonLogger.js'
 import type { CommonLogger } from '../log/commonLogger.js'
 import type { AnyFunction } from '../types.js'

package/src/http/fetcher.ts

@@ -4,8 +4,7 @@
 
 import type { ReadableStream as WebReadableStream } from 'node:stream/web'
 import { abortSignalAnyOrUndefined, abortSignalTimeoutOrUndefined } from '../abort.js'
-import { nowUnixMillis } from '../datetime/localTime.js'
-import { _ms, _since } from '../datetime/time.util.js'
+import { _ms, _since, nowUnixMillis } from '../datetime/time.util.js'
 import { isServerSide } from '../env.js'
 import { _assert, _assertErrorClassOrRethrow, _assertIsError } from '../error/assert.js'
 import type { ErrorLike, ErrorObject } from '../error/error.model.js'
@@ -30,8 +29,8 @@ import {
 } from '../object/object.util.js'
 import { pDelaySignal } from '../promise/pDelay.js'
 import { pTimeout } from '../promise/pTimeout.js'
-import { _toUrlOrNull } from '../string/index.js'
 import { _jsonParse, _jsonParseIfPossible } from '../string/json.util.js'
+import { _toUrlOrNull } from '../string/url.util.js'
 import type { AnyObject, ErrorDataTuple, NumberOfMilliseconds } from '../types.js'
 import type {
   FetcherAfterResponseHook,
@@ -56,6 +55,8 @@ import type {
 import type { HttpStatusFamily } from './http.model.js'
 import { HTTP_METHODS } from './http.model.js'
 
+const FETCHER_VERSION = 5
+
 /**
  * Experimental wrapper around Fetch.
  * Works in both Browser and Node, using `globalThis.fetch`.
@@ -67,18 +68,15 @@ export class Fetcher {
    *
    * Version is to be incremented every time a difference in behaviour (or a bugfix) is done.
    */
-  static readonly VERSION = 5
+  static readonly VERSION = FETCHER_VERSION
   /**
    * userAgent is statically exposed as Fetcher.userAgent.
    * It can be modified globally, and will be used (read) at the start of every request.
    */
-  static userAgent = isServerSide() ? `fetcher/${this.VERSION}` : undefined
+  // Pure, and not reading `this.VERSION`, so bundlers can drop Fetcher when unused (see treeshake.test.ts)
+  static userAgent = /* @__PURE__ */ isServerSide() ? `fetcher/${FETCHER_VERSION}` : undefined
 
   private constructor(cfg: FetcherCfg & FetcherOptions = {}) {
-    if (typeof globalThis.fetch !== 'function') {
-      throw new TypeError('globalThis.fetch is not available')
-    }
-
     this.cfg = this.normalizeCfg(cfg)
 
     // Dynamically create all helper methods

package/src/index.ts

@@ -4,7 +4,7 @@ export * from './bot.model.js'
 export * from './define.js'
 export * from './enum.util.js'
 export * from './env.js'
-export * from './env/buildInfo.js'
+export type * from './env/buildInfo.js'
 export * from './form.util.js'
 export * from './is.util.js'
 export * from './iter/asyncIterable2.js'

package/src/object/keySortedMap.ts

@@ -1,4 +1,4 @@
-import { _assert } from '../error/index.js'
+import { _assert } from '../error/assert.js'
 import type { Comparator } from '../types.js'
 
 export interface KeySortedMapOptions<K> {

package/src/object/lazyKeySortedMap.ts

@@ -1,4 +1,4 @@
-import { _assert } from '../error/index.js'
+import { _assert } from '../error/assert.js'
 import type { Comparator } from '../types.js'
 
 export interface LazyKeySortedMapOptions<K> {

package/src/object/object.util.ts

@@ -452,7 +452,7 @@ export function _unset<T extends AnyObject>(obj: T, prop: string): void {
     return
   }
 
-  if (obj.hasOwnProperty(prop)) {
+  if (Object.hasOwn(obj, prop)) {
     delete obj[prop]
     return
   }
@@ -599,7 +599,7 @@ export function _deepFreeze(o: any): void {
 
   Object.getOwnPropertyNames(o).forEach(prop => {
     if (
-      o.hasOwnProperty(prop) &&
+      Object.hasOwn(o, prop) &&
       o[prop] !== null &&
       (typeof o[prop] === 'object' || typeof o[prop] === 'function') &&
       !Object.isFrozen(o[prop])

package/src/promise/pGradualQueue.ts

@@ -1,4 +1,4 @@
-import { nowUnixMillis } from '../datetime/localTime.js'
+import { nowUnixMillis } from '../datetime/time.util.js'
 import { ErrorMode } from '../error/errorMode.js'
 import { createCommonLoggerAtLevel } from '../log/commonLogger.js'
 import type { CommonLogger, CommonLogLevel } from '../log/commonLogger.js'

package/src/promise/pRetry.ts

@@ -1,5 +1,4 @@
-import { nowUnixMillis } from '../datetime/localTime.js'
-import { _since } from '../datetime/time.util.js'
+import { _since, nowUnixMillis } from '../datetime/time.util.js'
 import type { ErrorData } from '../error/error.model.js'
 import { _errorDataAppend } from '../error/error.util.js'
 import { consoleLogger } from '../log/commonLogger.js'

package/src/semver.ts

@@ -147,13 +147,17 @@ interface SemverFn extends SemverFactory {
   (input: SemverInput): Semver
 }
 
-const semverFactory = new SemverFactory()
-
-export const semver2 = semverFactory.fromInput.bind(semverFactory) as SemverFn
-
-// The line below is the blackest of black magic I have ever written in 2024.
-// And probably 2023 as well.
-Object.setPrototypeOf(semver2, semverFactory)
+// Built inside a function, so the whole construct can be marked pure and tree-shaken (see treeshake.test.ts)
+export const semver2 = /* @__PURE__ */ createSemverFn()
+
+function createSemverFn(): SemverFn {
+  const semverFactory = new SemverFactory()
+  const fn = semverFactory.fromInput.bind(semverFactory) as SemverFn
+  // The line below is the blackest of black magic I have ever written in 2024.
+  // And probably 2023 as well.
+  Object.setPrototypeOf(fn, semverFactory)
+  return fn
+}
 
 /**
  * Returns 1 if a > b

package/src/string/stringify.ts

@@ -1,14 +1,12 @@
+import type { ErrorLike } from '../error/error.model.js'
 // oxlint-disable-next-line import/no-cycle -- intentional cycle
 import { _isBackendErrorResponseObject, _isErrorLike, _isErrorObject } from '../error/error.util.js'
-import type { ErrorLike } from '../error/index.js'
 import type { Reviver } from '../types.js'
 // oxlint-disable-next-line import/no-cycle -- intentional cycle
 import { _jsonParseIfPossible } from './json.util.js'
 import { _safeJsonStringify } from './safeJsonStringify.js'
 import { _truncateMiddle } from './string.util.js'
 
-const supportsAggregateError = typeof globalThis.AggregateError === 'function'
-
 let globalStringifyFunction: JsonStringifyFunction = _safeJsonStringify
 
 /**
@@ -184,7 +182,7 @@ function stringifyErrorLike(obj: Error | ErrorLike, opt: StringifyOptions): stri
     s = [s, ...obj.stack.split('\n').slice(sLines)].join('\n')
   }
 
-  if (supportsAggregateError && obj instanceof AggregateError && obj.errors.length) {
+  if (obj instanceof AggregateError && obj.errors.length) {
     s = [
       s,
       `${obj.errors.length} error(s):`,