@dereekb/util 13.11.3 → 13.11.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -12,6 +12,7 @@ export interface UtilPreferNoSideEffectsInJsdocRuleDefinition {
12
12
  };
13
13
  readonly messages: {
14
14
  readonly preferJsdocPlacement: string;
15
+ readonly missingImplAnnotationOverloaded: string;
15
16
  };
16
17
  readonly schema: readonly object[];
17
18
  };
@@ -37,6 +38,13 @@ export interface UtilPreferNoSideEffectsInJsdocRuleDefinition {
37
38
  * be tagged as a factory — it triggers purely on the presence of an existing
38
39
  * line-comment annotation alongside a JSDoc, so it can sweep all 688 historical
39
40
  * annotations through `eslint --fix`.
41
+ *
42
+ * Overloaded functions are a special case: TypeScript erases overload signatures
43
+ * during emit, so a JSDoc tag on the first overload doesn't reach the bundled JS.
44
+ * The `// @__NO_SIDE_EFFECTS__` line comment immediately above the implementation
45
+ * is the only annotation that survives compilation, so this rule preserves it
46
+ * (and treats line comments between overloads — but not directly above the impl —
47
+ * as ordinary orphans to migrate).
40
48
  */
41
49
  export declare const utilPreferNoSideEffectsInJsdocRule: UtilPreferNoSideEffectsInJsdocRuleDefinition;
42
50
  export {};
@@ -27,6 +27,7 @@ export interface UtilRequireNoSideEffectsRuleDefinition {
27
27
  readonly messages: {
28
28
  readonly missingNoSideEffectsJsdoc: string;
29
29
  readonly missingJsdocForFactory: string;
30
+ readonly missingImplAnnotationOverloaded: string;
30
31
  };
31
32
  readonly schema: readonly object[];
32
33
  };
@@ -42,13 +43,25 @@ export interface UtilRequireNoSideEffectsRuleDefinition {
42
43
  }): Record<string, (node: AstNode) => void>;
43
44
  }
44
45
  /**
45
- * ESLint rule requiring the side-effect-free annotation inside the JSDoc of every
46
- * factory function — that is, declarations carrying the dbxUtilKind factory JSDoc tag,
47
- * and optionally functions matching factory name patterns.
46
+ * ESLint rule requiring the side-effect-free annotation on every factory function — that is,
47
+ * declarations carrying the `@dbxUtilKind factory` JSDoc tag (and optionally functions matching
48
+ * factory name patterns). The rule guarantees the marker reaches the bundled JavaScript so
49
+ * esbuild/rollup can drop unused calls during tree-shaking.
48
50
  *
49
- * Auto-fix inserts the annotation as the last line of the JSDoc, removes any
50
- * redundant standalone-comment annotation between the JSDoc and the declaration,
51
- * and (when matched by name with no JSDoc) creates a minimal JSDoc carrying both tags.
51
+ * Behavior:
52
+ *
53
+ * - **Single-signature functions:** the JSDoc above the declaration is preserved during emit, so
54
+ * the rule simply requires `@__NO_SIDE_EFFECTS__` inside that JSDoc.
55
+ *
56
+ * - **Overloaded functions:** TypeScript erases overload signatures during emit, so a JSDoc tag
57
+ * placed only on the first overload is dropped from the bundled JS. The rule additionally requires
58
+ * either (a) a `// @__NO_SIDE_EFFECTS__` line comment immediately above the implementation, or
59
+ * (b) a JSDoc with the tag attached directly to the implementation. Auto-fix inserts the line
60
+ * comment alongside the JSDoc tag so consumer-facing docs and the bundler annotation stay in sync.
61
+ *
62
+ * Auto-fix also removes any redundant standalone-comment annotations between the JSDoc and the
63
+ * declaration (other than the required impl-leading line comment on overloaded functions), and
64
+ * when no JSDoc is present, creates a minimal one carrying both tags.
52
65
  */
53
66
  export declare const utilRequireNoSideEffectsRule: UtilRequireNoSideEffectsRuleDefinition;
54
67
  export {};
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "@dereekb/util/fetch",
3
- "version": "13.11.3",
3
+ "version": "13.11.5",
4
4
  "peerDependencies": {
5
- "@dereekb/util": "13.11.3",
5
+ "@dereekb/util": "13.11.5",
6
6
  "make-error": "^1.3.6",
7
7
  "fast-content-type-parse": "^3.0.0"
8
8
  },
package/index.cjs.js CHANGED
@@ -2081,6 +2081,7 @@ function _type_of$l(obj) {
2081
2081
  }
2082
2082
  return fn;
2083
2083
  }
2084
+ // @__NO_SIDE_EFFECTS__
2084
2085
  function chainMapFunction(a, b) {
2085
2086
  var apply = arguments.length > 2 && arguments[2] !== void 0 ? arguments[2] : true;
2086
2087
  return apply && b != null ? function(x) {
@@ -2267,6 +2268,7 @@ function _unsupported_iterable_to_array$x(o, minLen) {
2267
2268
  return findResult === -1;
2268
2269
  };
2269
2270
  }
2271
+ // @__NO_SIDE_EFFECTS__
2270
2272
  function allowValueOnceFilter(inputReadKey) {
2271
2273
  var visitedKeys = new Set();
2272
2274
  var readKey = inputReadKey !== null && inputReadKey !== void 0 ? inputReadKey : MAP_IDENTITY;
@@ -2359,6 +2361,7 @@ function removeModelsWithKey(input, key) {
2359
2361
  return read(x) !== key;
2360
2362
  });
2361
2363
  }
2364
+ // @__NO_SIDE_EFFECTS__
2362
2365
  function makeModelMap(input, read) {
2363
2366
  var map = new Map();
2364
2367
  input.forEach(function(x) {
@@ -3436,6 +3439,7 @@ function groupValues(values, groupKeyFn) {
3436
3439
  var map = makeValuesGroupMap(values, groupKeyFn);
3437
3440
  return mapToObject(map);
3438
3441
  }
3442
+ // @__NO_SIDE_EFFECTS__
3439
3443
  function makeValuesGroupMap(values, groupKeyFn) {
3440
3444
  var map = new Map();
3441
3445
  if (values != null) {
@@ -4006,6 +4010,7 @@ function getValueFromGetter(input, args) {
4006
4010
  }
4007
4011
  return results;
4008
4012
  }
4013
+ // @__NO_SIDE_EFFECTS__
4009
4014
  function makeWithFactoryInput(factory, input) {
4010
4015
  return input.map(function(x) {
4011
4016
  return factory(x);
@@ -5339,6 +5344,7 @@ function reduceNumbersFn(reduceFn, emptyArrayValue) {
5339
5344
  fencePosts: fencePosts
5340
5345
  });
5341
5346
  }
5347
+ // @__NO_SIDE_EFFECTS__
5342
5348
  function indexRangeCheckReaderFunction(input) {
5343
5349
  var read = arguments.length > 1 && arguments[1] !== void 0 ? arguments[1] : function(x) {
5344
5350
  return x.i;
@@ -7638,6 +7644,7 @@ function _unsupported_iterable_to_array$r(o, minLen) {
7638
7644
  };
7639
7645
  }
7640
7646
 
7647
+ // @__NO_SIDE_EFFECTS__
7641
7648
  function cachedGetter(factory) {
7642
7649
  var loaded;
7643
7650
  var init = function init(input) {
@@ -8590,6 +8597,7 @@ function _unsupported_iterable_to_array$q(o, minLen) {
8590
8597
  return isAllowed;
8591
8598
  }
8592
8599
 
8600
+ // @__NO_SIDE_EFFECTS__
8593
8601
  function isInSetDecisionFunction(set, inputReadValue) {
8594
8602
  var readValue = inputReadValue !== null && inputReadValue !== void 0 ? inputReadValue : function(x) {
8595
8603
  return x;
@@ -11168,6 +11176,7 @@ function _unsupported_iterable_to_array$n(o, minLen) {
11168
11176
  var input = valueOrFunction !== null && valueOrFunction !== void 0 ? valueOrFunction : defaultIfUndefined;
11169
11177
  return typeof input === 'boolean' ? decisionFunction(input) : input;
11170
11178
  }
11179
+ // @__NO_SIDE_EFFECTS__
11171
11180
  function isEqualToValueDecisionFunction(equalityValue) {
11172
11181
  var equalityValueCheckFunction;
11173
11182
  if (typeof equalityValue === 'function') {
@@ -15790,10 +15799,21 @@ function _unsupported_iterable_to_array$d(o, minLen) {
15790
15799
  * Regular expression for validating ISO8601 date strings.
15791
15800
  *
15792
15801
  * TODO(FUTURE): Need to improve to support negative years.
15802
+ *
15803
+ * @dbxUtil
15804
+ * @dbxUtilCategory date
15805
+ * @dbxUtilKind const
15806
+ * @dbxUtilTags date, iso8601, regex, string, validate
15807
+ * @dbxUtilRelated is-iso8601-date-string, iso8601-day-string-regex
15793
15808
  */ var ISO_8601_DATE_STRING_REGEX = /(\d{4,})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2})(Z|[+-](\d{2}):(\d{2}))?/;
15794
15809
  /**
15795
15810
  * Determines if a string is a valid ISO8601 date string.
15796
15811
  *
15812
+ * @dbxUtil
15813
+ * @dbxUtilCategory date
15814
+ * @dbxUtilTags date, iso8601, string, predicate, validate
15815
+ * @dbxUtilRelated is-iso8601-day-string, is-utc-date-string, iso-8601-date-string-regex
15816
+ *
15797
15817
  * @param input - The string to test
15798
15818
  * @returns True if the input is a valid ISO8601 date string
15799
15819
  */ function isISO8601DateString(input) {
@@ -15805,10 +15825,21 @@ function _unsupported_iterable_to_array$d(o, minLen) {
15805
15825
  * Sat, 03 Feb 2001 04:05:06 GMT
15806
15826
  * Tue, 14 Mar 2023 12:34:56 UTC
15807
15827
  * Wed, 25 May 2024 20:45:07 EST
15828
+ *
15829
+ * @dbxUtil
15830
+ * @dbxUtilCategory date
15831
+ * @dbxUtilKind const
15832
+ * @dbxUtilTags date, utc, regex, string, validate
15833
+ * @dbxUtilRelated is-utc-date-string
15808
15834
  */ var UTC_DATE_STRING_REGEX = /^([a-zA-Z]{3}, \d{2} [a-zA-Z]{3} \d{4} \d{2}:\d{2}:\d{2} [A-Z]{3})$/;
15809
15835
  /**
15810
15836
  * Determines if a string is a valid UTC date string.
15811
15837
  *
15838
+ * @dbxUtil
15839
+ * @dbxUtilCategory date
15840
+ * @dbxUtilTags date, utc, string, predicate, validate
15841
+ * @dbxUtilRelated is-iso8601-date-string, utc-date-string-regex
15842
+ *
15812
15843
  * @param input - The string to test
15813
15844
  * @returns True if the input is a valid UTC date string
15814
15845
  */ function isUTCDateString(input) {
@@ -15817,6 +15848,11 @@ function _unsupported_iterable_to_array$d(o, minLen) {
15817
15848
  /**
15818
15849
  * Returns true only if the inputs have the same timezone, or both do not have a timezone set.
15819
15850
  *
15851
+ * @dbxUtil
15852
+ * @dbxUtilCategory date
15853
+ * @dbxUtilTags date, timezone, compare, equal, predicate
15854
+ * @dbxUtilRelated is-considered-utc-timezone-string
15855
+ *
15820
15856
  * @param a - First object that may contain a timezone reference
15821
15857
  * @param b - Second object that may contain a timezone reference
15822
15858
  * @returns True if both objects have the same timezone or neither has a timezone set
@@ -15827,21 +15863,44 @@ function _unsupported_iterable_to_array$d(o, minLen) {
15827
15863
  }
15828
15864
  /**
15829
15865
  * Constant for the UTC timezone string, "UTC".
15866
+ *
15867
+ * @dbxUtil
15868
+ * @dbxUtilCategory date
15869
+ * @dbxUtilKind const
15870
+ * @dbxUtilTags date, timezone, utc, string, constant
15871
+ * @dbxUtilRelated is-considered-utc-timezone-string
15830
15872
  */ var UTC_TIMEZONE_STRING = 'UTC';
15831
15873
  function isConsideredUtcTimezoneString(timezone) {
15832
15874
  return timezone == null || timezone === UTC_TIMEZONE_STRING;
15833
15875
  }
15834
15876
  /**
15835
15877
  * Regex for an ISO8601DayString.
15878
+ *
15879
+ * @dbxUtil
15880
+ * @dbxUtilCategory date
15881
+ * @dbxUtilKind const
15882
+ * @dbxUtilTags date, iso8601, day, regex, string, validate
15883
+ * @dbxUtilRelated is-iso8601-day-string, iso8601-day-string-start-regex
15836
15884
  */ var ISO8601_DAY_STRING_REGEX = /^\d{4,}-\d{2}-\d{2}$/;
15837
15885
  /**
15838
15886
  * Regex for a string that starts as an ISO8601DayString.
15887
+ *
15888
+ * @dbxUtil
15889
+ * @dbxUtilCategory date
15890
+ * @dbxUtilKind const
15891
+ * @dbxUtilTags date, iso8601, day, regex, prefix
15892
+ * @dbxUtilRelated is-iso8601-day-string-start, iso8601-day-string-regex
15839
15893
  */ var ISO8601_DAY_STRING_START_REGEX = /^\d{4,}-\d{2}-\d{2}/;
15840
15894
  /**
15841
15895
  * Returns the start of the input date's UTC time in UTC.
15842
15896
  *
15843
15897
  * I.E. 2022-01-02T04:00:00.000Z in GMT-6 returns 2022-01-02
15844
15898
  *
15899
+ * @dbxUtil
15900
+ * @dbxUtilCategory date
15901
+ * @dbxUtilTags date, utc, start-of-day, day, normalize
15902
+ * @dbxUtilRelated start-of-day-for-system-date-in-utc, parse-iso8601-day-string-to-utc-date
15903
+ *
15845
15904
  * @param date - The date to get the start of day for
15846
15905
  * @returns A new Date set to midnight UTC of the input date's UTC day
15847
15906
  */ function startOfDayForUTCDateInUTC(date) {
@@ -15852,6 +15911,11 @@ function isConsideredUtcTimezoneString(timezone) {
15852
15911
  *
15853
15912
  * I.E. 2022-01-02T04:00:00.000Z in GMT-6 (10PM Jan 1st CST) returns 2022-01-01
15854
15913
  *
15914
+ * @dbxUtil
15915
+ * @dbxUtilCategory date
15916
+ * @dbxUtilTags date, utc, start-of-day, system, local
15917
+ * @dbxUtilRelated start-of-day-for-utc-date-in-utc
15918
+ *
15855
15919
  * @param date - The date to get the start of local day for
15856
15920
  * @returns A new Date set to midnight UTC of the input date's local day
15857
15921
  */ function startOfDayForSystemDateInUTC(date) {
@@ -15860,6 +15924,11 @@ function isConsideredUtcTimezoneString(timezone) {
15860
15924
  /**
15861
15925
  * Parses an ISO8601DayString (YYYY-MM-DD) to a UTC Date at midnight.
15862
15926
  *
15927
+ * @dbxUtil
15928
+ * @dbxUtilCategory date
15929
+ * @dbxUtilTags date, iso8601, day, parse, utc, convert
15930
+ * @dbxUtilRelated is-iso8601-day-string, start-of-day-for-utc-date-in-utc
15931
+ *
15863
15932
  * @param inputDateString - The ISO8601 day string to parse (e.g., '2022-01-15')
15864
15933
  * @returns A Date object set to midnight UTC on the specified day
15865
15934
  */ function parseISO8601DayStringToUTCDate(inputDateString) {
@@ -15869,6 +15938,11 @@ function isConsideredUtcTimezoneString(timezone) {
15869
15938
  /**
15870
15939
  * Determines if a string is a valid ISO8601 day string (YYYY-MM-DD format).
15871
15940
  *
15941
+ * @dbxUtil
15942
+ * @dbxUtilCategory date
15943
+ * @dbxUtilTags date, iso8601, day, string, predicate, validate
15944
+ * @dbxUtilRelated is-iso8601-day-string-start, parse-iso8601-day-string-to-utc-date, iso8601-day-string-regex
15945
+ *
15872
15946
  * @param input - The string to test
15873
15947
  * @returns True if the input is a valid ISO8601 day string
15874
15948
  */ function isISO8601DayString(input) {
@@ -15877,6 +15951,11 @@ function isConsideredUtcTimezoneString(timezone) {
15877
15951
  /**
15878
15952
  * Determines if a string starts with a valid ISO8601 day string pattern (YYYY-MM-DD).
15879
15953
  *
15954
+ * @dbxUtil
15955
+ * @dbxUtilCategory date
15956
+ * @dbxUtilTags date, iso8601, day, string, predicate, prefix
15957
+ * @dbxUtilRelated is-iso8601-day-string, iso8601-day-string-start-regex
15958
+ *
15880
15959
  * @param input - The string to test
15881
15960
  * @returns True if the input starts with a valid ISO8601 day string pattern
15882
15961
  */ function isISO8601DayStringStart(input) {
@@ -15884,10 +15963,21 @@ function isConsideredUtcTimezoneString(timezone) {
15884
15963
  }
15885
15964
  /**
15886
15965
  * Regex for a MonthDaySlashDate.
15966
+ *
15967
+ * @dbxUtil
15968
+ * @dbxUtilCategory date
15969
+ * @dbxUtilKind const
15970
+ * @dbxUtilTags date, slash, month, day, regex, string, validate
15971
+ * @dbxUtilRelated is-month-day-slash-date
15887
15972
  */ var MONTH_DAY_SLASH_DATE_STRING_REGEX = /^\d{1,2}\/\d{1,2}\/\d+$/;
15888
15973
  /**
15889
15974
  * Determines if a string is a valid Month/Day/Year slash date format.
15890
15975
  *
15976
+ * @dbxUtil
15977
+ * @dbxUtilCategory date
15978
+ * @dbxUtilTags date, slash, month, day, string, predicate, validate
15979
+ * @dbxUtilRelated month-day-slash-date-to-date-string, month-day-slash-date-string-regex
15980
+ *
15891
15981
  * @param input - The string to test
15892
15982
  * @returns True if the input is a valid Month/Day/Year slash date
15893
15983
  */ function isMonthDaySlashDate(input) {
@@ -15898,6 +15988,11 @@ function isConsideredUtcTimezoneString(timezone) {
15898
15988
  * Handles single digit months and days by adding leading zeros.
15899
15989
  * If year is only 2 digits, prepends '20' to make a 4-digit year.
15900
15990
  *
15991
+ * @dbxUtil
15992
+ * @dbxUtilCategory date
15993
+ * @dbxUtilTags date, slash, day, string, convert, parse
15994
+ * @dbxUtilRelated is-month-day-slash-date
15995
+ *
15901
15996
  * @param slashDate - The slash date string to convert (e.g., '1/1/20' or '11/15/2022')
15902
15997
  * @returns An ISO8601 formatted day string (YYYY-MM-DD)
15903
15998
  */ function monthDaySlashDateToDateString(slashDate) {
@@ -15927,6 +16022,11 @@ function dateFromDateOrTimeMillisecondsNumber(input) {
15927
16022
  /**
15928
16023
  * Converts a unix timestamp number to a Date object.
15929
16024
  *
16025
+ * @dbxUtil
16026
+ * @dbxUtilCategory date
16027
+ * @dbxUtilTags date, milliseconds, unix, convert, parse
16028
+ * @dbxUtilRelated date-from-date-or-time-milliseconds-number, unix-date-time-seconds-number-to-date
16029
+ *
15930
16030
  * @param dateTimeNumber - Unix timestamp number to convert
15931
16031
  * @returns Date object if timestamp is valid, null/undefined if timestamp is null/undefined
15932
16032
  */ function unixMillisecondsNumberToDate(dateTimeNumber) {
@@ -15939,6 +16039,11 @@ function dateFromDateOrTimeMillisecondsNumber(input) {
15939
16039
  *
15940
16040
  * If the input is a number of milliseconds, it is added to the current date.
15941
16041
  *
16042
+ * @dbxUtil
16043
+ * @dbxUtilCategory date
16044
+ * @dbxUtilTags date, milliseconds, convert, normalize, offset
16045
+ * @dbxUtilRelated add-milliseconds, date-from-date-or-time-milliseconds-number
16046
+ *
15942
16047
  * @param dateOrMilliseconds - The date or milliseconds to convert to a Date.
15943
16048
  * @param now - The current date to use when adding milliseconds. Defaults to the current time.
15944
16049
  * @returns The Date representation of the input.
@@ -15947,45 +16052,131 @@ function dateFromDateOrTimeMillisecondsNumber(input) {
15947
16052
  }
15948
16053
  /**
15949
16054
  * Number of days in a year (ignoring leap years, which are 366 days).
16055
+ *
16056
+ * @dbxUtil
16057
+ * @dbxUtilCategory date
16058
+ * @dbxUtilKind const
16059
+ * @dbxUtilTags date, day, year, duration, constant
16060
+ * @dbxUtilRelated days-in-week
15950
16061
  */ var DAYS_IN_YEAR = 365;
15951
16062
  /**
15952
16063
  * Number of hours in a day.
16064
+ *
16065
+ * @dbxUtil
16066
+ * @dbxUtilCategory date
16067
+ * @dbxUtilKind const
16068
+ * @dbxUtilTags date, hour, day, duration, constant
16069
+ * @dbxUtilRelated minutes-in-day, ms-in-day
15953
16070
  */ var HOURS_IN_DAY = 24;
15954
16071
  /**
15955
16072
  * Number of seconds in a minute.
16073
+ *
16074
+ * @dbxUtil
16075
+ * @dbxUtilCategory date
16076
+ * @dbxUtilKind const
16077
+ * @dbxUtilTags date, second, minute, duration, constant
16078
+ * @dbxUtilRelated seconds-in-hour, ms-in-second
15956
16079
  */ var SECONDS_IN_MINUTE = 60;
15957
16080
  /**
15958
16081
  * Number of minutes in a day.
16082
+ *
16083
+ * @dbxUtil
16084
+ * @dbxUtilCategory date
16085
+ * @dbxUtilKind const
16086
+ * @dbxUtilTags date, minute, day, duration, constant
16087
+ * @dbxUtilRelated hours-in-day, minutes-in-hour
15959
16088
  */ var MINUTES_IN_DAY = 1440;
15960
16089
  /**
15961
16090
  * Number of minutes in an hour.
16091
+ *
16092
+ * @dbxUtil
16093
+ * @dbxUtilCategory date
16094
+ * @dbxUtilKind const
16095
+ * @dbxUtilTags date, minute, hour, duration, constant
16096
+ * @dbxUtilRelated minutes-in-day, seconds-in-minute
15962
16097
  */ var MINUTES_IN_HOUR = 60;
15963
16098
  /**
15964
16099
  * Number of seconds in an hour.
16100
+ *
16101
+ * @dbxUtil
16102
+ * @dbxUtilCategory date
16103
+ * @dbxUtilKind const
16104
+ * @dbxUtilTags date, second, hour, duration, constant
16105
+ * @dbxUtilRelated seconds-in-minute, minutes-in-hour
15965
16106
  */ var SECONDS_IN_HOUR = MINUTES_IN_HOUR * SECONDS_IN_MINUTE;
15966
16107
  /**
15967
16108
  * Number of milliseconds in a second.
16109
+ *
16110
+ * @dbxUtil
16111
+ * @dbxUtilCategory date
16112
+ * @dbxUtilKind const
16113
+ * @dbxUtilTags date, milliseconds, second, duration, constant
16114
+ * @dbxUtilRelated ms-in-minute, seconds-in-minute
15968
16115
  */ var MS_IN_SECOND = 1000;
15969
16116
  /**
15970
16117
  * Number of milliseconds in a minute.
16118
+ *
16119
+ * @dbxUtil
16120
+ * @dbxUtilCategory date
16121
+ * @dbxUtilKind const
16122
+ * @dbxUtilTags date, milliseconds, minute, duration, constant
16123
+ * @dbxUtilRelated ms-in-second, ms-in-hour
15971
16124
  */ var MS_IN_MINUTE = MS_IN_SECOND * 60;
15972
16125
  /**
15973
16126
  * Number of milliseconds in an hour.
16127
+ *
16128
+ * @dbxUtil
16129
+ * @dbxUtilCategory date
16130
+ * @dbxUtilKind const
16131
+ * @dbxUtilTags date, milliseconds, hour, duration, constant
16132
+ * @dbxUtilRelated ms-in-minute, ms-in-day
15974
16133
  */ var MS_IN_HOUR = MS_IN_MINUTE * 60;
15975
16134
  /**
15976
16135
  * Number of milliseconds in a day.
16136
+ *
16137
+ * @dbxUtil
16138
+ * @dbxUtilCategory date
16139
+ * @dbxUtilKind const
16140
+ * @dbxUtilTags date, milliseconds, day, duration, constant
16141
+ * @dbxUtilRelated ms-in-hour, ms-in-week, hours-in-day
15977
16142
  */ var MS_IN_DAY = MS_IN_HOUR * HOURS_IN_DAY;
16143
+ /**
16144
+ * Number of seconds in a day.
16145
+ *
16146
+ * @dbxUtil
16147
+ * @dbxUtilCategory date
16148
+ * @dbxUtilKind const
16149
+ * @dbxUtilTags date, seconds, day, duration, constant
16150
+ * @dbxUtilRelated seconds-in-hour, seconds-in-week
16151
+ */ var SECONDS_IN_DAY = SECONDS_IN_HOUR * HOURS_IN_DAY;
15978
16152
  /**
15979
16153
  * Number of days in a week.
16154
+ *
16155
+ * @dbxUtil
16156
+ * @dbxUtilCategory date
16157
+ * @dbxUtilKind const
16158
+ * @dbxUtilTags date, day, week, duration, constant
16159
+ * @dbxUtilRelated ms-in-week, days-in-year
15980
16160
  */ var DAYS_IN_WEEK = 7;
15981
16161
  /**
15982
16162
  * Number of milliseconds in a week.
16163
+ *
16164
+ * @dbxUtil
16165
+ * @dbxUtilCategory date
16166
+ * @dbxUtilKind const
16167
+ * @dbxUtilTags date, milliseconds, week, duration, constant
16168
+ * @dbxUtilRelated ms-in-day, days-in-week
15983
16169
  */ var MS_IN_WEEK = MS_IN_DAY * DAYS_IN_WEEK;
15984
16170
  /**
15985
16171
  * Retrieves the MonthOfYear value (1-12) from the input Date in the current system timezone.
15986
16172
  *
15987
16173
  * Converts JavaScript's 0-based month (0-11) to a 1-based month (1-12).
15988
16174
  *
16175
+ * @dbxUtil
16176
+ * @dbxUtilCategory date
16177
+ * @dbxUtilTags date, month, year, accessor, system, local
16178
+ * @dbxUtilRelated month-of-year-from-date-month, month-of-year-from-utc-date
16179
+ *
15989
16180
  * @param date - The date to extract the month from
15990
16181
  * @returns The month of year as a number from 1-12
15991
16182
  */ function monthOfYearFromDate(date) {
@@ -15996,6 +16187,11 @@ function dateFromDateOrTimeMillisecondsNumber(input) {
15996
16187
  *
15997
16188
  * Converts JavaScript's 0-based month (0-11) to a 1-based month (1-12).
15998
16189
  *
16190
+ * @dbxUtil
16191
+ * @dbxUtilCategory date
16192
+ * @dbxUtilTags date, month, year, accessor, utc
16193
+ * @dbxUtilRelated month-of-year-from-date, month-of-year-from-date-month
16194
+ *
15999
16195
  * @param date - The date to extract the month from
16000
16196
  * @returns The month of year as a number from 1-12
16001
16197
  */ function monthOfYearFromUTCDate(date) {
@@ -16004,6 +16200,11 @@ function dateFromDateOrTimeMillisecondsNumber(input) {
16004
16200
  /**
16005
16201
  * Converts a JavaScript Date month (0-11) to a MonthOfYear (1-12).
16006
16202
  *
16203
+ * @dbxUtil
16204
+ * @dbxUtilCategory date
16205
+ * @dbxUtilTags date, month, year, convert, javascript
16206
+ * @dbxUtilRelated make-date-month-for-month-of-year, month-of-year-from-date
16207
+ *
16007
16208
  * @param dateMonth - JavaScript Date month (0-11)
16008
16209
  * @returns The month of year as a number from 1-12
16009
16210
  */ function monthOfYearFromDateMonth(dateMonth) {
@@ -16015,7 +16216,7 @@ function dateFromDateOrTimeMillisecondsNumber(input) {
16015
16216
  * @dbxUtil
16016
16217
  * @dbxUtilCategory date
16017
16218
  * @dbxUtilTags date, month, convert, javascript
16018
- * @dbxUtilRelated month-of-year-from-date-month
16219
+ * @dbxUtilRelated month-of-year-from-date-month, month-of-year-from-date
16019
16220
  *
16020
16221
  * @param monthOfYear - Month of year (1-12)
16021
16222
  * @returns JavaScript Date month (0-11)
@@ -16027,6 +16228,11 @@ function dateFromDateOrTimeMillisecondsNumber(input) {
16027
16228
  * Returns true if the value is a Date object.
16028
16229
  * Uses both instanceof and Object.prototype.toString for reliable type checking.
16029
16230
  *
16231
+ * @dbxUtil
16232
+ * @dbxUtilCategory date
16233
+ * @dbxUtilTags date, predicate, type-guard, validate
16234
+ * @dbxUtilRelated is-equal-date, is-past
16235
+ *
16030
16236
  * @param value - The value to check
16031
16237
  * @returns True if the value is a Date object
16032
16238
  */ function isDate(value) {
@@ -16036,6 +16242,11 @@ function dateFromDateOrTimeMillisecondsNumber(input) {
16036
16242
  * Returns true if the two input dates represent the same point in time.
16037
16243
  * Compares the timestamp values rather than the object references.
16038
16244
  *
16245
+ * @dbxUtil
16246
+ * @dbxUtilCategory date
16247
+ * @dbxUtilTags date, equal, compare, predicate
16248
+ * @dbxUtilRelated is-date, is-past
16249
+ *
16039
16250
  * @param a - First date to compare
16040
16251
  * @param b - Second date to compare
16041
16252
  * @returns True if the dates represent the same point in time
@@ -16045,6 +16256,11 @@ function dateFromDateOrTimeMillisecondsNumber(input) {
16045
16256
  /**
16046
16257
  * Returns true if the input date is in the past relative to the current time.
16047
16258
  *
16259
+ * @dbxUtil
16260
+ * @dbxUtilCategory date
16261
+ * @dbxUtilTags date, past, compare, predicate, time
16262
+ * @dbxUtilRelated is-equal-date, is-date
16263
+ *
16048
16264
  * @param input - The date to check
16049
16265
  * @returns True if the date is in the past
16050
16266
  */ function isPast(input) {
@@ -21753,6 +21969,7 @@ function _unsupported_iterable_to_array$5(o, minLen) {
21753
21969
  /**
21754
21970
  * Special key used to register a catch-all handler that matches any unhandled key.
21755
21971
  */ var CATCH_ALL_HANDLE_RESULT_KEY = '__CATCH_ALL_HANDLE_RESULT_KEY__';
21972
+ // @__NO_SIDE_EFFECTS__
21756
21973
  function handlerFactory(readKey, options) {
21757
21974
  var _ref, _ref1;
21758
21975
  var defaultResultValue = (_ref = options === null || options === void 0 ? void 0 : options.defaultResult) !== null && _ref !== void 0 ? _ref : true;
@@ -24764,6 +24981,7 @@ exports.RAW_MIME_TYPE = RAW_MIME_TYPE;
24764
24981
  exports.REGEX_SPECIAL_CHARACTERS = REGEX_SPECIAL_CHARACTERS;
24765
24982
  exports.REGEX_SPECIAL_CHARACTERS_SET = REGEX_SPECIAL_CHARACTERS_SET;
24766
24983
  exports.RelationChange = RelationChange;
24984
+ exports.SECONDS_IN_DAY = SECONDS_IN_DAY;
24767
24985
  exports.SECONDS_IN_HOUR = SECONDS_IN_HOUR;
24768
24986
  exports.SECONDS_IN_MINUTE = SECONDS_IN_MINUTE;
24769
24987
  exports.SHARED_MEMORY_STORAGE = SHARED_MEMORY_STORAGE;