@checkdigit/time 3.0.0-PR.17-58cd → 4.0.0-PR.18-9134

package/src/date-fns/CHANGELOG.md

@@ -8,7 +8,245 @@ This change log follows the format documented in [Keep a CHANGELOG].
 [semantic versioning]: http://semver.org/
 [keep a changelog]: http://keepachangelog.com/
 
-## v2.29.1 - 2022-07-22
+## v3.6.0 - 2024-03-18
+
+On this release worked @kossnocorp and @world1dan. Also, thanks to [@seated](https://github.com/seated) [for sponsoring me](https://github.com/sponsors/kossnocorp).
+
+### Fixed
+
+- [Fixed weeks in the Belarisuan locale's `formatDistance`.](https://github.com/date-fns/date-fns/pull/3720)
+
+### Added
+
+- [Added CDN versions of modules compatible with older browsers.](https://github.com/date-fns/date-fns/pull/3737) [See the CDN guide.](https://date-fns.org/docs/CDN)
+
+## v3.5.0 - 2024-03-15
+
+Kudos to @fturmel, @kossnocorp, @makstyle119, @tan75, @marcreichel, @tareknatsheh and @audunru for working on the release. Also, thanks to [@seated](https://github.com/seated) [for sponsoring me](https://github.com/sponsors/kossnocorp).
+
+### Fixed
+
+- [Fixed functions that use current date internally and made them work with date extensions like `UTCDate`.](https://github.com/date-fns/date-fns/issues/3730)
+
+- [Fixed `daysToWeeks` returning negative 0.](https://github.com/date-fns/date-fns/commit/882ced61c692c7c4a79eaaec6eb07cb9c8c9195b)
+
+- [Fixed German grammar for the "half a minute" string.](https://github.com/date-fns/date-fns/pull/3715)
+
+### Added
+
+- [Added the Northern Sámi (`se`) locale.](https://github.com/date-fns/date-fns/pull/3724)
+
+- Added the `constructNow` function that creates the current date using the passed reference date's constructor.
+
+## v3.4.0 - 2024-03-11
+
+Kudos to @kossnocorp, @sakamossan and @Revan99 for working on the release. Also, thanks to [@seated](https://github.com/seated) [for sponsoring me](https://github.com/sponsors/kossnocorp).
+
+### Added
+
+- [Added `roundToNearestHours` function.](https://github.com/date-fns/date-fns/pull/2752)
+
+- [Added Central Kurdish (`ckb`) locale.](https://github.com/date-fns/date-fns/pull/3421)
+
+## v3.3.1 - 2024-01-22
+
+Kudos to @kossnocorp and @fturmel for working on the release.
+
+### Fixed
+
+- Fixed DST issue in `getOverlappingDaysInIntervals`, resulting in an inconsistent number of days returned for intervals starting and ending in different DST periods.
+
+- Fixed functions incorrectly using `trunc` instead of `round`. The bug was introduced in v3.3.0. The affected functions: `differenceInCalendarDays`, `differenceInCalendarISOWeeks`, `differenceInCalendarWeeks`, `getISOWeek`, `getWeek`, and `getISOWeeksInYear`.
+
+## v3.3.0 - 2024-01-20
+
+On this release worked @kossnocorp, @TheKvikk, @fturmel and @ckcherry23.
+
+### Fixed
+
+- Fixed the bug in `getOverlappingDaysInIntervals` caused by incorrect sorting of interval components that led to 0 for timestamps of different lengths.
+
+- Fixed bugs when working with negative numbers caused by using `Math.floor` (`-1.1` → `-2`) instead of `Math.trunc` (`-1.1` → `-1`). Most of the conversion functions (i.e., `hoursToMinutes`) were affected when passing some negative fractional input. Also, some other functions that could be possibly affected by unfortunate timezone/date combinations were fixed.
+
+  The functions that were affected: `format`, `parse`, `getUnixTime`, `daysToWeeks`, `hoursToMilliseconds`, `hoursToMinutes`, `hoursToSeconds`, `milliseconds`, `minutesToMilliseconds`, `millisecondsToMinutes`, `monthsToYears`, `millisecondsToHours`, `millisecondsToSeconds`, `minutesToHours`, `minutesToSeconds`, `yearsToQuarters`, `yearsToMonths`, `yearsToDays`, `weeksToDays`, `secondsToMinutes`, `secondsToHours`, `quartersToYears`, `quartersToMonths` and `monthsToQuarters`.
+
+- [Fixed the Czech locale's `formatDistance` to include `1` in `formatDistance`.](https://github.com/date-fns/date-fns/pull/3269)
+
+- Fixed `differenceInSeconds` and other functions relying on rounding options that can produce a negative 0.
+
+- [Added a preprocessor to the locales API, enabling fixing a long-standing bug in the French locale.](https://github.com/date-fns/date-fns/pull/3662) ([#1391](https://github.com/date-fns/date-fns/issues/1391))
+
+- Added missing `yearsToDays` to the FP submodule.
+
+- Made functions using rounding methods always return `0` instead of `-0`.
+
+### Added
+
+- [Added `format` alias `formatDate` with corresponding `FormatDateOptions` interface](https://github.com/date-fns/date-fns/pull/3653).
+
+## v3.2.0 - 2024-01-09
+
+This release is brought to you by @kossnocorp, @fturmel, @grossbart, @MelvinVermeer, and @jcarstairs-scottlogic.
+
+### Fixed
+
+- Fixed types compatability with Lodash's `flow` and fp-ts's `pipe`. ([#3641](https://github.com/date-fns/date-fns/issues/3641))
+
+- [Fixed inconsistent behavior of `roundToNearestMinutes`.](https://github.com/date-fns/date-fns/pull/3132)
+
+### Added
+
+- Added exports of `format`, `lightFormat`, and `parse` internals that enable 3rd-parties to consume those.
+
+## v3.1.0 - 2024-01-05
+
+This release is brought to you by @kossnocorp, @makstyle119 and @dmgawel.
+
+### Fixed
+
+- [Fixed the plural form of weeks in Swedish](https://github.com/date-fns/date-fns/pull/3448).
+
+### Added
+
+- [Added `yearsToDays` function](https://github.com/date-fns/date-fns/pull/3540).
+
+- Added warning about using protected tokens like `Y` or `D` without passing a corresponding option. [See #2950](https://github.com/date-fns/date-fns/issues/2950).
+
+## v3.0.6 - 2023-12-22
+
+On this release worked @imwh0im, @jamcry and @tyrw.
+
+### Fixed
+
+- [Fixed bug in `areIntervalsOverlapping` caused by incorrect sorting](https://github.com/date-fns/date-fns/pull/3628) ([#3614](https://github.com/date-fns/date-fns/issues/3614))
+
+## v3.0.5 - 2023-12-21
+
+This release is brought to you by @goku4199.
+
+### Fixed
+
+- [Fixed internal `toDate` not processing string arguments properly](https://github.com/date-fns/date-fns/pull/3626)
+
+## v3.0.4 - 2023-12-21
+
+This release is brought to you by @kossnocorp.
+
+### Fixed
+
+- Fixed isWithinInterval bug caused by incorrectly sorting dates ([#3623](https://github.com/date-fns/date-fns/issues/3623)).
+
+## v3.0.3 - 2023-12-21
+
+### Fixed
+
+- Rolled back pointing ESM types to the same `d.ts` files. Instead now it copies the content to avoid [the Masquerading as CJS problem](https://github.com/arethetypeswrong/arethetypeswrong.github.io/blob/main/docs/problems/FalseCJS.md) reported by "Are the types wrong?".
+
+## v3.0.2 - 2023-12-21
+
+### Fixed
+
+- Fixed [yet another issue caused by ESM types](https://github.com/date-fns/date-fns/issues/3620) by pointing to the same `d.ts` files.
+
+- [Added `package.json` to exports](https://github.com/date-fns/date-fns/pull/3601) to provide access to tooling.
+
+- [Fixed TypeScript 5.4 build break](https://github.com/date-fns/date-fns/pull/3598) by using the latest type names.
+
+## v3.0.1 - 2023-12-20
+
+### Fixed
+
+- [Fixed an error](https://github.com/date-fns/date-fns/pull/3618) in certain environments caused by `d.mts` files exporting only types.
+
+## v3.0.0 - 2023-12-18
+
+### Changed
+
+- **BREAKING**: date-fns is now a dual-package with the support of both ESM and CommonJS. The files exports are now explicitly in the `package.json`. The ESM files now have `.mjs` extension.
+
+- **BREAKING**: The package now has a flat structure, meaning functions are now named `node_modules/date-fns/add.mjs`, locales are `node_modules/date-fns/locale/enUS.mjs`, etc.
+
+- **BREAKING**: Now all file content’s exported via named exports instead of `export default`, which will require change direct imports i.e. `const addDays = require(‘date-fns/addDays’)` to `const { addDays } = require(‘date-fns/addDays’)`.
+
+- **BREAKING**: TypeScript types are now completely rewritten, check out the `d.ts` files for more information.
+
+- **BREAKING**: `constants` now is not exported via the index, so to import one use `import { daysInYear } from "date-fns/constants";`. It improves compatibility with setups that modularize imports [like Next.js](https://twitter.com/kossnocorp/status/1731181274579325260).
+
+- **BREAKING**: Functions now don’t check the number of passed arguments, delegating this task to type checkers. The functions are now slimmer because of this.
+
+- **BREAKING** The arguments are not explicitly converted to the target types. Instead, they are passed as is, delegating this task to type checkers.
+
+- **BREAKING**: Functions that accept `Interval` arguments now do not throw an error if the start is before the end and handle it as a negative interval. If one of the properties in an `Invalid Date`, these functions also do not throw and handle them as invalid intervals.
+
+  - `areIntervalsOverlapping` normalize intervals before comparison, so `{ start: a, end: b }` is practically equivalent to `{ start: b, end: a }`. When comparing intervals with one of the properties being `Invalid Date`, the function will return false unless the others are valid and equal, given the `inclusive` option is passed. Otherwise, and when even one of the intervals has both properties invalid, the function will always return `false`.
+
+  - `getOverlappingDaysInIntervals` now normalizes intervals before comparison, so `{ start: a, end: b }` is practically equivalent to `{ start: b, end: a }`. If any of the intervals’ properties is an `Invalid Date`, the function will always return 0.
+
+  - `isWithinInterval` now normalizes intervals before comparison, so `{ start: a, end: b }` is practically equivalent to `{ start: b, end: a }`. If any of the intervals’ properties is an `Invalid Date`, the function will always return false.
+
+  - `intervalToDuration` now returns negative durations for negative intervals. If one or both of the interval properties are invalid, the function will return an empty object.
+
+  - The eachXOfInterval functions (`eachDayOfInterval`, `eachHourOfInterval`, `eachMinuteOfInterval`, `eachMonthOfInterval`, `eachWeekendOfInterval`, `eachWeekendOfMonth`, `eachWeekendOfYear`, `eachWeekOfInterval`, `eachYearOfInterval`) now return a reversed array if the passed interval’s start is after the end. Invalid properties will result in an empty array. Functions that accept the `step` option now also allow negative, 0, and NaN values and return reversed results if the step is negative and an empty array otherwise.
+
+- **BREAKING**: `intervalToDuration` now skips 0 values in the resulting duration, resulting in more compact objects with only relevant properties.
+
+- **BREAKING**: `roundToNearestMinutes` now returns `Invalid Date` instead of throwing an error when `nearestTo` option is less than 1 or more than 30.
+
+- **BREAKING**: IE is no longer supported.
+
+- **BREAKING**: Now all functions use `Math.trunc` rounding method where rounding is required. The behavior is configurable on a per-function basis.
+
+- **BREAKING**: Undocumented `onlyNumeric` option was removed from `nn` and `sv` locales. If you relied on it, [please contact me](mailto:koss@nocorp.me).
+
+- **BREAKING**: Flow is not supported anymore. If you relied on it, [please contact me](mailto:koss@nocorp.me).
+
+- **BREAKING**: The locales now use regular functions instead of the UTC version, which should not break any code unless you used locales directly.
+
+### Added
+
+- All functions that accept date arguments now also accept strings.
+
+- All functions now export options interfaces.
+
+- Now functions allow passing custom Date extensions like [UTCDate](https://github.com/date-fns/utc). They will detect and use the arguments constructor to generate the result of the same class.
+
+- `eachMonthOfInterval`, `eachQuarterOfInterval`, `eachWeekOfInterval`, and `eachYearOfInterval` now accept the `step` option like most of the eachXOfInterval functions.
+
+- A new `interval` function that validates interval, emulating the v2 interval functions behavior.
+
+- `differenceInX` functions now accept options and allow setting up `roundingMethod` that configures how the result is rounded. `Math.trunc` is the default method.
+
+## v2.30.0
+
+Kudos to @kossnocorp and @Andarist for working on the release.
+
+### Changes
+
+- Fixed increased build size after enabling compatibility with older browsers in the previous release. This was done by adding @babel/runtime as a dependency. [See more details](https://github.com/date-fns/date-fns/issues/3208#issuecomment-1528592465).
+
+## v2.29.3 - 2022-09-13
+
+This release is prepared by our own @leshakoss.
+
+### Fixed
+
+- [Fixed Ukrainian (`uk`) locale grammar for `formatDistance`.](https://github.com/date-fns/date-fns/pull/3175)
+
+- [Improved browser compatibility by transforming the code with `@babel/preset-env`.](https://github.com/date-fns/date-fns/pull/3167)
+
+## v2.29.2 - 2022-08-18
+
+This release is brought to you by @nopears, @vadimpopa and @leshakoss.
+
+### Fixed
+
+- [Fixed `sv` locale abbreviated months matcher.](https://github.com/date-fns/date-fns/pull/3160)
+
+- [Fixed `uk` locale abbreviated months matcher.](https://github.com/date-fns/date-fns/pull/3139)
+
+- [Fixed a breaking change in `intervalToDuration` by removing a recently introduced RangeError.](https://github.com/date-fns/date-fns/pull/3153)
+
+## v2.29.1 - 2022-08-18
 
 Thanks to @fturmel for working on the release.
 
@@ -760,10 +998,10 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
 
   ```javascript
   // Before v2.0.0
-  addDays('2016-01-01', 1);
+  addDays("2016-01-01", 1);
 
   // v2.0.0 onward
-  addDays(parseISO('2016-01-01'), 1);
+  addDays(parseISO("2016-01-01"), 1);
   ```
 
 - **BREAKING**: new format string API for `format` function
@@ -930,7 +1168,7 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
   you should set `useAdditionalWeekYearTokens` option:
 
   ```javascript
-  format(Date.now(), 'YY', { useAdditionalWeekYearTokens: true });
+  format(Date.now(), "YY", { useAdditionalWeekYearTokens: true });
   //=> '86'
   ```
 
@@ -938,7 +1176,7 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
   set `useAdditionalDayOfYearTokens` option:
 
   ```javascript
-  format(Date.now(), 'D', { useAdditionalDayOfYearTokens: true });
+  format(Date.now(), "D", { useAdditionalDayOfYearTokens: true });
   //=> '364'
   ```
 
@@ -946,10 +1184,10 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
 
   ```javascript
   // Before v2.0.0
-  import differenceInCalendarISOYears from 'date-fns/difference_in_calendar_iso_years';
+  import differenceInCalendarISOYears from "date-fns/difference_in_calendar_iso_years";
 
   // v2.0.0 onward
-  import differenceInCalendarISOYears from 'date-fns/differenceInCalendarISOYears';
+  import differenceInCalendarISOYears from "date-fns/differenceInCalendarISOYears";
   ```
 
 - **BREAKING**: min and max functions now accept an array of dates
@@ -964,7 +1202,10 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
   var maxDate = max(date1, date2);
 
   // v2.0.0 onward:
-  var dates = [new Date(1989, 6 /* Jul */, 10), new Date(1987, 1 /* Feb */, 11)];
+  var dates = [
+    new Date(1989, 6 /* Jul */, 10),
+    new Date(1987, 1 /* Feb */, 11),
+  ];
 
   var minDate = min(dates);
   var maxDate = max(dates);
@@ -1020,7 +1261,12 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
   ```javascript
   // Before v2.0.0
 
-  areRangesOverlapping(new Date(2014, 0, 10), new Date(2014, 0, 20), new Date(2014, 0, 17), new Date(2014, 0, 21));
+  areRangesOverlapping(
+    new Date(2014, 0, 10),
+    new Date(2014, 0, 20),
+    new Date(2014, 0, 17),
+    new Date(2014, 0, 21),
+  );
 
   eachDay(new Date(2014, 0, 10), new Date(2014, 0, 20));
 
@@ -1031,7 +1277,11 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
     new Date(2014, 0, 21),
   );
 
-  isWithinRange(new Date(2014, 0, 3), new Date(2014, 0, 1), new Date(2014, 0, 7));
+  isWithinRange(
+    new Date(2014, 0, 3),
+    new Date(2014, 0, 1),
+    new Date(2014, 0, 7),
+  );
 
   // v2.0.0 onward
 
@@ -1070,11 +1320,19 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
   ```javascript
   // Before v2.0.0
 
-  distanceInWords(new Date(1986, 3, 4, 10, 32, 0), new Date(1986, 3, 4, 11, 32, 0), { addSuffix: true }); //=> 'in about 1 hour'
+  distanceInWords(
+    new Date(1986, 3, 4, 10, 32, 0),
+    new Date(1986, 3, 4, 11, 32, 0),
+    { addSuffix: true },
+  ); //=> 'in about 1 hour'
 
   // v2.0.0 onward
 
-  formatDistance(new Date(1986, 3, 4, 11, 32, 0), new Date(1986, 3, 4, 10, 32, 0), { addSuffix: true }); //=> 'in about 1 hour'
+  formatDistance(
+    new Date(1986, 3, 4, 11, 32, 0),
+    new Date(1986, 3, 4, 10, 32, 0),
+    { addSuffix: true },
+  ); //=> 'in about 1 hour'
   ```
 
 - **BREAKING**: `partialMethod` option in `formatDistanceStrict` is renamed to `roundingMethod`.
@@ -1082,11 +1340,19 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
   ```javascript
   // Before v2.0.0
 
-  distanceInWordsStrict(new Date(1986, 3, 4, 10, 32, 0), new Date(1986, 3, 4, 10, 33, 1), { partialMethod: 'ceil' }); //=> '2 minutes'
+  distanceInWordsStrict(
+    new Date(1986, 3, 4, 10, 32, 0),
+    new Date(1986, 3, 4, 10, 33, 1),
+    { partialMethod: "ceil" },
+  ); //=> '2 minutes'
 
   // v2.0.0 onward
 
-  formatDistanceStrict(new Date(1986, 3, 4, 10, 33, 1), new Date(1986, 3, 4, 10, 32, 0), { roundingMethod: 'ceil' }); //=> '2 minutes'
+  formatDistanceStrict(
+    new Date(1986, 3, 4, 10, 33, 1),
+    new Date(1986, 3, 4, 10, 32, 0),
+    { roundingMethod: "ceil" },
+  ); //=> '2 minutes'
   ```
 
 - **BREAKING**: in `formatDistanceStrict`, if `roundingMethod` is not specified,
@@ -1098,11 +1364,19 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
   ```javascript
   // Before v2.0.0
 
-  distanceInWordsStrict(new Date(1986, 3, 4, 10, 32, 0), new Date(1986, 3, 4, 10, 33, 1), { unit: 'm' });
+  distanceInWordsStrict(
+    new Date(1986, 3, 4, 10, 32, 0),
+    new Date(1986, 3, 4, 10, 33, 1),
+    { unit: "m" },
+  );
 
   // v2.0.0 onward
 
-  formatDistanceStrict(new Date(1986, 3, 4, 10, 33, 1), new Date(1986, 3, 4, 10, 32, 0), { unit: 'minute' });
+  formatDistanceStrict(
+    new Date(1986, 3, 4, 10, 33, 1),
+    new Date(1986, 3, 4, 10, 32, 0),
+    { unit: "minute" },
+  );
   ```
 
 - **BREAKING**: `parse` that previously used to convert strings and
@@ -1112,13 +1386,13 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
 
   ```javascript
   // Before v2.0.0
-  parse('2016-01-01');
+  parse("2016-01-01");
   parse(1547005581366);
   parse(new Date()); // Clone the date
 
   // v2.0.0 onward
-  parse('2016-01-01', 'yyyy-MM-dd', new Date());
-  parseISO('2016-01-01');
+  parse("2016-01-01", "yyyy-MM-dd", new Date());
+  parseISO("2016-01-01");
   toDate(1547005581366);
   toDate(new Date()); // Clone the date
   ```
@@ -1137,10 +1411,10 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
 
   ```javascript
   // Before v2.0.0
-  import locale from 'date-fns/locale/zh_cn';
+  import locale from "date-fns/locale/zh_cn";
 
   // v2.0.0 onward
-  import locale from 'date-fns/locale/zh-CN';
+  import locale from "date-fns/locale/zh-CN";
   ```
 
 - **BREAKING**: now `closestTo` and `closestIndexTo` don't throw an exception
@@ -1247,17 +1521,21 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
   See [FP Guide](https://date-fns.org/docs/FP-Guide) for more information.
 
   ```javascript
-  import addYears from 'date-fns/fp/addYears';
-  import formatWithOptions from 'date-fns/fp/formatWithOptions';
-  import eo from 'date-fns/locale/eo';
+  import addYears from "date-fns/fp/addYears";
+  import formatWithOptions from "date-fns/fp/formatWithOptions";
+  import eo from "date-fns/locale/eo";
 
   // If FP function has not received enough arguments, it returns another function
   const addFiveYears = addYears(5);
 
   // Several arguments can be curried at once
-  const dateToString = formatWithOptions({ locale: eo }, 'd MMMM yyyy');
+  const dateToString = formatWithOptions({ locale: eo }, "d MMMM yyyy");
 
-  const dates = [new Date(2017, 0 /* Jan */, 1), new Date(2017, 1 /* Feb */, 11), new Date(2017, 6 /* Jul */, 2)];
+  const dates = [
+    new Date(2017, 0 /* Jan */, 1),
+    new Date(2017, 1 /* Feb */, 11),
+    new Date(2017, 6 /* Jul */, 2),
+  ];
 
   const formattedDates = dates.map((date) => dateToString(addFiveYears(date)));
   //=> ['1 januaro 2022', '11 februaro 2022', '2 julio 2022']
@@ -1270,11 +1548,11 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
 
   ```javascript
   // Without tree-shaking:
-  import format from 'date-fns/format';
-  import parse from 'date-fns/parse';
+  import format from "date-fns/format";
+  import parse from "date-fns/parse";
 
   // With tree-shaking:
-  import { format, parse } from 'date-fns';
+  import { format, parse } from "date-fns";
   ```
 
   Also, ESM functions provide default export, they can be used with TypeScript
@@ -1282,10 +1560,10 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
 
   ```typescript
   // Before
-  import * as format from 'date-fns/format';
+  import * as format from "date-fns/format";
 
   // Now
-  import format from 'date-fns/format';
+  import format from "date-fns/format";
   ```
 
 - `formatRelative` function. See [formatRelative](https://date-fns.org/docs/formatRelative)
@@ -1771,7 +2049,7 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
 - `parse` now can parse dates that are ISO 8601 centuries (e.g., `19` and `+0019`).
 
   ```javascript
-  var result = parse('19');
+  var result = parse("19");
   //=> Mon Jan 01 1900 00:00:00
   ```
 
@@ -1779,9 +2057,9 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
   for extended year or century format (possible values are 0, 1 or 2; default is 2).
 
   ```javascript
-  parse('+002016-11-01');
-  parse('+02016-11-01', { additionalDigits: 1 });
-  parse('+2016-11-01', { additionalDigits: 0 });
+  parse("+002016-11-01");
+  parse("+02016-11-01", { additionalDigits: 1 });
+  parse("+2016-11-01", { additionalDigits: 0 });
   ```
 
 ## [1.9.0] - 2016-10-25
@@ -1906,10 +2184,10 @@ If you're upgrading from v2 alpha or beta, [see the pre-release changelog](https
 
   ```javascript
   // Before v1.0.0
-  var addMonths = require('date-fns/src/add_months');
+  var addMonths = require("date-fns/src/add_months");
 
   // v1.0.0 onward
-  var addMonths = require('date-fns/add_months');
+  var addMonths = require("date-fns/add_months");
   ```
 
 - **BREAKING**: functions that had the last optional argument `weekStartsAt`

package/src/date-fns/_lib/addLeadingZeros/index.ts

@@ -1,8 +1,5 @@
-export default function addLeadingZeros(number: number, targetLength: number): string {
-  const sign = number < 0 ? '-' : '';
-  let output = Math.abs(number).toString();
-  while (output.length < targetLength) {
-    output = '0' + output;
-  }
+export function addLeadingZeros(number: number, targetLength: number): string {
+  const sign = number < 0 ? "-" : "";
+  const output = Math.abs(number).toString().padStart(targetLength, "0");
   return sign + output;
 }

package/src/date-fns/_lib/addLeadingZeros/test.mts

@@ -0,0 +1,12 @@
+import { describe, expect, it } from "vitest";
+import { addLeadingZeros } from "./index";
+
+describe("addLeadingZeros", () => {
+  it("adds leading zeros when number has fewer digits than target length", () => {
+    expect(addLeadingZeros(7, 3)).toBe("007");
+    expect(addLeadingZeros(7, 2)).toBe("07");
+    expect(addLeadingZeros(7, 1)).toBe("7");
+    expect(addLeadingZeros(7, 0)).toBe("7");
+    expect(addLeadingZeros(7, -1)).toBe("7");
+  });
+});

package/src/date-fns/_lib/defaultLocale/index.ts

@@ -1,2 +1 @@
-import defaultLocale from '../../locale/en-US/index';
-export default defaultLocale;
+export { enUS as defaultLocale } from "../../locale/en-US/index";

package/src/date-fns/_lib/defaultOptions/index.ts

@@ -1,6 +1,13 @@
-import type { FirstWeekContainsDateOptions, LocaleOptions, WeekStartOptions } from '../../types';
+import type {
+  FirstWeekContainsDateOptions,
+  Locale,
+  LocalizedOptions,
+  WeekOptions,
+} from "../../types";
 
-export type DefaultOptions = LocaleOptions & WeekStartOptions & FirstWeekContainsDateOptions;
+export type DefaultOptions = LocalizedOptions<keyof Locale> &
+  WeekOptions &
+  FirstWeekContainsDateOptions;
 
 let defaultOptions: DefaultOptions = {};