@northguild/gmt 1.18.0 → 1.20.0

package/dist/plain/calculate/getLocaleStartOfWeek.d.ts

@@ -1,6 +1,6 @@
 /**
  * Return the start of the week containing `value`, using `locale`'s
- * first day of week (e.g. en-US: Sunday, fr-FR: Monday).
+ * first day of week (e.g. fr-FR: Monday, ja-JP: Sunday).
  *
  * - Resolves the locale's first day of week via
  *   `Intl.Locale.prototype.weekInfo`.
@@ -15,13 +15,13 @@
  *   default locale, as ECMA-402 `ResolveLocale` requires.
  *
  * @param value ISO 8601 date string
- * @param locale BCP 47 locale tag (e.g. "en-US", "fr-FR"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns ""
+ * @param locale BCP 47 locale tag (e.g. "fr-FR", "ja-JP", "en-US"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns ""
  * @returns ISO 8601 date string for the start of `value`'s locale-relative week, or "" on invalid input
  *
- * @example getLocaleStartOfWeek("2024-02-29", "en-US") // "2024-02-25" (Sunday)
+ * @example getLocaleStartOfWeek("2024-02-29", "ja-JP") // "2024-02-25" (Sunday)
  * @example getLocaleStartOfWeek("2024-02-29", "fr-FR") // "2024-02-26" (Monday)
- * @example getLocaleStartOfWeek("invalid-date", "en-US") // ""
+ * @example getLocaleStartOfWeek("invalid-date", "hi-IN") // ""
  * @example getLocaleStartOfWeek("2024-02-29", "not-a-locale-!!") // ""
- * @example getLocaleStartOfWeek("2024-05-15", ["en-US", "fr-FR"]) // "2024-05-12" (en-US, the first listed locale, starts weeks on Sunday)
+ * @example getLocaleStartOfWeek("2024-05-15", ["pt-BR", "fr-FR"]) // "2024-05-12" (pt-BR, the first listed locale, starts weeks on Sunday)
  */
 export declare function getLocaleStartOfWeek(value: string, locale: string | string[]): string;

package/dist/plain/calculate/getLocaleStartOfWeek.js

@@ -1,10 +1,10 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { getLocaleFirstDayOfWeek } from "../../internal/index.js";
 import { isValidDate } from "../validate/index.js";
 /**
  * Return the start of the week containing `value`, using `locale`'s
- * first day of week (e.g. en-US: Sunday, fr-FR: Monday).
+ * first day of week (e.g. fr-FR: Monday, ja-JP: Sunday).
  *
  * - Resolves the locale's first day of week via
  *   `Intl.Locale.prototype.weekInfo`.
@@ -19,14 +19,14 @@ import { isValidDate } from "../validate/index.js";
  *   default locale, as ECMA-402 `ResolveLocale` requires.
  *
  * @param value ISO 8601 date string
- * @param locale BCP 47 locale tag (e.g. "en-US", "fr-FR"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns ""
+ * @param locale BCP 47 locale tag (e.g. "fr-FR", "ja-JP", "en-US"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns ""
  * @returns ISO 8601 date string for the start of `value`'s locale-relative week, or "" on invalid input
  *
- * @example getLocaleStartOfWeek("2024-02-29", "en-US") // "2024-02-25" (Sunday)
+ * @example getLocaleStartOfWeek("2024-02-29", "ja-JP") // "2024-02-25" (Sunday)
  * @example getLocaleStartOfWeek("2024-02-29", "fr-FR") // "2024-02-26" (Monday)
- * @example getLocaleStartOfWeek("invalid-date", "en-US") // ""
+ * @example getLocaleStartOfWeek("invalid-date", "hi-IN") // ""
  * @example getLocaleStartOfWeek("2024-02-29", "not-a-locale-!!") // ""
- * @example getLocaleStartOfWeek("2024-05-15", ["en-US", "fr-FR"]) // "2024-05-12" (en-US, the first listed locale, starts weeks on Sunday)
+ * @example getLocaleStartOfWeek("2024-05-15", ["pt-BR", "fr-FR"]) // "2024-05-12" (pt-BR, the first listed locale, starts weeks on Sunday)
  */
 export function getLocaleStartOfWeek(value, locale) {
     if (!isValidDate(value))

package/dist/plain/calculate/getLocaleWeekYear.d.ts

@@ -11,8 +11,8 @@
  *   everywhere. ECMA-402 does not expose a locale's minimal days: Intl Locale Info returns only
  *   `firstDay` and `weekend` (tc39/proposal-intl-locale-info#86), so older runtimes that still
  *   reported it disagreed with newer ones about the same date. Pass CLDR's value when you need a
- *   locale's own rule: in CLDR 48 `weekData`, the world default (`001`) is `1`, as in `US`, `CA`,
- *   `MX`, `JP` and `CN`, and `4` is set for a list of mostly European regions such as `GB`, `DE`
+ *   locale's own rule: in CLDR 48 `weekData`, the world default (`001`) is `1`, as in `JP`, `CN`,
+ *   `MX`, `CA` and `US`, and `4` is set for a list of mostly European regions such as `GB`, `DE`
  *   and `FR`.
  * - Returns null if `value` or `locale` is invalid.
  * - **Compatibility:** before 1.16.0 the default read the runtime's `minimalDays` where one was
@@ -20,18 +20,18 @@
  *   `{ minimalDays: 1 }` to keep the Node 22 result for such a locale on every runtime.
  *
  * @param value ISO PlainDate string
- * @param locale BCP 47 locale tag (e.g. "en-US", "fr-FR"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
+ * @param locale BCP 47 locale tag (e.g. "fr-FR", "ja-JP", "en-US"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
  * @param options The minimal-days-in-first-week rule
  * @returns locale-relative week-numbering year, or null on invalid input
  *
- * @example getLocaleWeekYear("2024-06-15", "en-US") // 2024
- * @example getLocaleWeekYear("2022-01-01", "en-US", { minimalDays: 1 }) // 2022 — Jan 1 is always in week 1
- * @example getLocaleWeekYear("2022-01-01", "en-US") // 2021 — ISO default: the week of Dec 26 holds 1 day of 2022
+ * @example getLocaleWeekYear("2024-06-15", "pt-BR") // 2024
+ * @example getLocaleWeekYear("2022-01-01", "ja-JP", { minimalDays: 1 }) // 2022 — Jan 1 is always in week 1
+ * @example getLocaleWeekYear("2022-01-01", "ja-JP") // 2021 — ISO default: the week of Dec 26 holds 1 day of 2022
  * @example getLocaleWeekYear("2022-01-01", "de-DE") // 2021 — Jan 1, 2022 is a Saturday, in week 52 of 2021
- * @example getLocaleWeekYear("2022-01-01", "en-US", { minimalDays: 0 }) // null
- * @example getLocaleWeekYear("+275760-09-13", "en-US") // 275760 (the last PlainDate; the next week 1 lies past the range)
- * @example getLocaleWeekYear("invalid", "en-US") // null
- * @example getLocaleWeekYear("2024-12-29", ["en-US", "fr-FR"]) // 2025
+ * @example getLocaleWeekYear("2022-01-01", "hi-IN", { minimalDays: 0 }) // null
+ * @example getLocaleWeekYear("+275760-09-13", "ja-JP") // 275760 (the last PlainDate; the next week 1 lies past the range)
+ * @example getLocaleWeekYear("invalid", "ar-EG") // null
+ * @example getLocaleWeekYear("2024-12-29", ["ja-JP", "fr-FR"]) // 2025
  */
 export declare function getLocaleWeekYear(value: string, locale: string | string[], options?: {
     /**

package/dist/plain/calculate/getLocaleWeekYear.js

@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { getLocaleFirstDayOfWeek, getLocaleWeekYearBounds, resolveMinimalDaysInFirstWeek, } from "../../internal/index.js";
 import { isValidDate } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
@@ -16,8 +16,8 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  *   everywhere. ECMA-402 does not expose a locale's minimal days: Intl Locale Info returns only
  *   `firstDay` and `weekend` (tc39/proposal-intl-locale-info#86), so older runtimes that still
  *   reported it disagreed with newer ones about the same date. Pass CLDR's value when you need a
- *   locale's own rule: in CLDR 48 `weekData`, the world default (`001`) is `1`, as in `US`, `CA`,
- *   `MX`, `JP` and `CN`, and `4` is set for a list of mostly European regions such as `GB`, `DE`
+ *   locale's own rule: in CLDR 48 `weekData`, the world default (`001`) is `1`, as in `JP`, `CN`,
+ *   `MX`, `CA` and `US`, and `4` is set for a list of mostly European regions such as `GB`, `DE`
  *   and `FR`.
  * - Returns null if `value` or `locale` is invalid.
  * - **Compatibility:** before 1.16.0 the default read the runtime's `minimalDays` where one was
@@ -25,18 +25,18 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  *   `{ minimalDays: 1 }` to keep the Node 22 result for such a locale on every runtime.
  *
  * @param value ISO PlainDate string
- * @param locale BCP 47 locale tag (e.g. "en-US", "fr-FR"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
+ * @param locale BCP 47 locale tag (e.g. "fr-FR", "ja-JP", "en-US"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
  * @param options The minimal-days-in-first-week rule
  * @returns locale-relative week-numbering year, or null on invalid input
  *
- * @example getLocaleWeekYear("2024-06-15", "en-US") // 2024
- * @example getLocaleWeekYear("2022-01-01", "en-US", { minimalDays: 1 }) // 2022 — Jan 1 is always in week 1
- * @example getLocaleWeekYear("2022-01-01", "en-US") // 2021 — ISO default: the week of Dec 26 holds 1 day of 2022
+ * @example getLocaleWeekYear("2024-06-15", "pt-BR") // 2024
+ * @example getLocaleWeekYear("2022-01-01", "ja-JP", { minimalDays: 1 }) // 2022 — Jan 1 is always in week 1
+ * @example getLocaleWeekYear("2022-01-01", "ja-JP") // 2021 — ISO default: the week of Dec 26 holds 1 day of 2022
  * @example getLocaleWeekYear("2022-01-01", "de-DE") // 2021 — Jan 1, 2022 is a Saturday, in week 52 of 2021
- * @example getLocaleWeekYear("2022-01-01", "en-US", { minimalDays: 0 }) // null
- * @example getLocaleWeekYear("+275760-09-13", "en-US") // 275760 (the last PlainDate; the next week 1 lies past the range)
- * @example getLocaleWeekYear("invalid", "en-US") // null
- * @example getLocaleWeekYear("2024-12-29", ["en-US", "fr-FR"]) // 2025
+ * @example getLocaleWeekYear("2022-01-01", "hi-IN", { minimalDays: 0 }) // null
+ * @example getLocaleWeekYear("+275760-09-13", "ja-JP") // 275760 (the last PlainDate; the next week 1 lies past the range)
+ * @example getLocaleWeekYear("invalid", "ar-EG") // null
+ * @example getLocaleWeekYear("2024-12-29", ["ja-JP", "fr-FR"]) // 2025
  */
 export function getLocaleWeekYear(value, locale, options) {
     try {

package/dist/plain/calculate/getQuarterForDate.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDate } from "../validate/index.js";
 /**
  * Return the quarter of the year (1-4) for a given ISO date.

package/dist/plain/calculate/getQuarterForDateTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTime } from "../validate/index.js";
 /**
  * Return the quarter of the year (1-4) for a given ISO datetime.

package/dist/plain/calculate/getWeekNumber.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDate } from "../validate/index.js";
 /**
  * Calculate the week number based on configurable week start day.

package/dist/plain/calculate/getWeekOfMonth.d.ts

@@ -2,14 +2,10 @@
  * Return the 1-based row `value` falls on within its month's calendar
  * grid, using `locale`'s first day of week.
  *
- * - Week 1 is the row containing the 1st of the month, even when that row
- *   is a partial week. This is GMT's own rule, not a standard's: a month
- *   grid draws every day of the month, so its first row always holds the 1st.
- * - Not CLDR's week-of-month field (`W`, UTS #35): that count applies the
- *   locale's `minDays`, so a short leading week may not count as part of
- *   the month.
- * - Comparison: date-fns's `getWeekOfMonth` returns the same number for the
- *   same first day of week.
+ * - Week 1 is the row containing the 1st of the month: UTS #35's week of month (`W`, Part 4 Dates
+ *   § Week Data) with the locale's first day of week and minimal days fixed at 1. The locale's own
+ *   minDays (4 in much of Europe) is not applied, so a short leading week still counts: a month
+ *   grid draws every day of the month.
  * - Distinct from ISO `weekOfYear`: this counts rows within a single
  *   month's grid, reset every month, rather than weeks since Jan 1.
  * - Resolves the locale's first day of week via
@@ -17,15 +13,15 @@
  * - Returns null if `value` or `locale` is invalid.
  *
  * @param value ISO PlainDate string
- * @param locale BCP 47 locale tag (e.g. "en-US", "fr-FR"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
+ * @param locale BCP 47 locale tag (e.g. "fr-FR", "ja-JP", "en-US"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
  * @returns 1-based week-of-month row, or null on invalid input
  *
- * @example getWeekOfMonth("2024-02-01", "en-US") // 1
- * @example getWeekOfMonth("2024-02-29", "en-US") // 5
- * @example getWeekOfMonth("2026-02-01", "en-US") // 1
+ * @example getWeekOfMonth("2024-02-01", "ja-JP") // 1
+ * @example getWeekOfMonth("2024-02-29", "ja-JP") // 5
+ * @example getWeekOfMonth("2026-02-01", "pt-BR") // 1
  * @example getWeekOfMonth("2026-02-01", "en-GB") // 1
- * @example getWeekOfMonth("-271821-04-30", "en-US") // 5 (the first representable month; its 1st lies before the range)
- * @example getWeekOfMonth("invalid", "en-US") // null
+ * @example getWeekOfMonth("-271821-04-30", "ja-JP") // 5 (the first representable month; its 1st lies before the range)
+ * @example getWeekOfMonth("invalid", "hi-IN") // null
  * @example getWeekOfMonth("2024-05-12", ["fr-FR", "en-US"]) // 2
  */
 export declare function getWeekOfMonth(value: string, locale: string | string[]): number | null;

package/dist/plain/calculate/getWeekOfMonth.js

@@ -1,19 +1,15 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { getLocaleFirstDayOfWeek, monthGridWeekRow } from "../../internal/index.js";
 import { isValidDate } from "../validate/index.js";
 /**
  * Return the 1-based row `value` falls on within its month's calendar
  * grid, using `locale`'s first day of week.
  *
- * - Week 1 is the row containing the 1st of the month, even when that row
- *   is a partial week. This is GMT's own rule, not a standard's: a month
- *   grid draws every day of the month, so its first row always holds the 1st.
- * - Not CLDR's week-of-month field (`W`, UTS #35): that count applies the
- *   locale's `minDays`, so a short leading week may not count as part of
- *   the month.
- * - Comparison: date-fns's `getWeekOfMonth` returns the same number for the
- *   same first day of week.
+ * - Week 1 is the row containing the 1st of the month: UTS #35's week of month (`W`, Part 4 Dates
+ *   § Week Data) with the locale's first day of week and minimal days fixed at 1. The locale's own
+ *   minDays (4 in much of Europe) is not applied, so a short leading week still counts: a month
+ *   grid draws every day of the month.
  * - Distinct from ISO `weekOfYear`: this counts rows within a single
  *   month's grid, reset every month, rather than weeks since Jan 1.
  * - Resolves the locale's first day of week via
@@ -21,15 +17,15 @@ import { isValidDate } from "../validate/index.js";
  * - Returns null if `value` or `locale` is invalid.
  *
  * @param value ISO PlainDate string
- * @param locale BCP 47 locale tag (e.g. "en-US", "fr-FR"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
+ * @param locale BCP 47 locale tag (e.g. "fr-FR", "ja-JP", "en-US"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
  * @returns 1-based week-of-month row, or null on invalid input
  *
- * @example getWeekOfMonth("2024-02-01", "en-US") // 1
- * @example getWeekOfMonth("2024-02-29", "en-US") // 5
- * @example getWeekOfMonth("2026-02-01", "en-US") // 1
+ * @example getWeekOfMonth("2024-02-01", "ja-JP") // 1
+ * @example getWeekOfMonth("2024-02-29", "ja-JP") // 5
+ * @example getWeekOfMonth("2026-02-01", "pt-BR") // 1
  * @example getWeekOfMonth("2026-02-01", "en-GB") // 1
- * @example getWeekOfMonth("-271821-04-30", "en-US") // 5 (the first representable month; its 1st lies before the range)
- * @example getWeekOfMonth("invalid", "en-US") // null
+ * @example getWeekOfMonth("-271821-04-30", "ja-JP") // 5 (the first representable month; its 1st lies before the range)
+ * @example getWeekOfMonth("invalid", "hi-IN") // null
  * @example getWeekOfMonth("2024-05-12", ["fr-FR", "en-US"]) // 2
  */
 export function getWeekOfMonth(value, locale) {

package/dist/plain/calculate/getWeekYear.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDate } from "../validate/index.js";
 /**
  * Return the ISO 8601 week-numbering year `value` belongs to.

package/dist/plain/calculate/getWeeksInLocaleWeekYear.d.ts

@@ -17,17 +17,17 @@
  *   `{ minimalDays: 1 }` to keep the Node 22 result for such a locale on every runtime.
  *
  * @param value ISO PlainDate string
- * @param locale BCP 47 locale tag (e.g. "en-US", "fr-FR"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
+ * @param locale BCP 47 locale tag (e.g. "fr-FR", "ja-JP", "en-US"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
  * @param options The minimal-days-in-first-week rule
  * @returns 52 or 53, or null on invalid input
  *
- * @example getWeeksInLocaleWeekYear("2024-06-15", "en-US") // 52
- * @example getWeeksInLocaleWeekYear("2022-06-15", "en-US", { minimalDays: 1 }) // 53 — Dec 26, 2021 to Jan 1, 2023
- * @example getWeeksInLocaleWeekYear("2022-06-15", "en-US") // 52 — ISO default: Jan 2, 2022 to Jan 1, 2023
+ * @example getWeeksInLocaleWeekYear("2024-06-15", "pt-BR") // 52
+ * @example getWeeksInLocaleWeekYear("2022-06-15", "ja-JP", { minimalDays: 1 }) // 53 — Dec 26, 2021 to Jan 1, 2023
+ * @example getWeeksInLocaleWeekYear("2022-06-15", "ja-JP") // 52 — ISO default: Jan 2, 2022 to Jan 1, 2023
  * @example getWeeksInLocaleWeekYear("2020-06-15", "de-DE") // 53
- * @example getWeeksInLocaleWeekYear("2024-06-15", "en-US", { minimalDays: 8 }) // null
- * @example getWeeksInLocaleWeekYear("+275760-09-13", "en-US") // 53 (its end, the week 1 of +275761, lies past the range)
- * @example getWeeksInLocaleWeekYear("invalid", "en-US") // null
+ * @example getWeeksInLocaleWeekYear("2024-06-15", "hi-IN", { minimalDays: 8 }) // null
+ * @example getWeeksInLocaleWeekYear("+275760-09-13", "pt-BR") // 53 (its end, the week 1 of +275761, lies past the range)
+ * @example getWeeksInLocaleWeekYear("invalid", "ar-EG") // null
  * @example getWeeksInLocaleWeekYear("2024-12-29", ["fr-FR", "en-US"]) // 52
  */
 export declare function getWeeksInLocaleWeekYear(value: string, locale: string | string[], options?: {

package/dist/plain/calculate/getWeeksInLocaleWeekYear.js

@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { getLocaleFirstDayOfWeek, getLocaleWeekYearBounds, resolveMinimalDaysInFirstWeek, } from "../../internal/index.js";
 import { isValidDate } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
@@ -22,17 +22,17 @@ import { isOptionsArgument } from "../../internal/isObject.js";
  *   `{ minimalDays: 1 }` to keep the Node 22 result for such a locale on every runtime.
  *
  * @param value ISO PlainDate string
- * @param locale BCP 47 locale tag (e.g. "en-US", "fr-FR"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
+ * @param locale BCP 47 locale tag (e.g. "fr-FR", "ja-JP", "en-US"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
  * @param options The minimal-days-in-first-week rule
  * @returns 52 or 53, or null on invalid input
  *
- * @example getWeeksInLocaleWeekYear("2024-06-15", "en-US") // 52
- * @example getWeeksInLocaleWeekYear("2022-06-15", "en-US", { minimalDays: 1 }) // 53 — Dec 26, 2021 to Jan 1, 2023
- * @example getWeeksInLocaleWeekYear("2022-06-15", "en-US") // 52 — ISO default: Jan 2, 2022 to Jan 1, 2023
+ * @example getWeeksInLocaleWeekYear("2024-06-15", "pt-BR") // 52
+ * @example getWeeksInLocaleWeekYear("2022-06-15", "ja-JP", { minimalDays: 1 }) // 53 — Dec 26, 2021 to Jan 1, 2023
+ * @example getWeeksInLocaleWeekYear("2022-06-15", "ja-JP") // 52 — ISO default: Jan 2, 2022 to Jan 1, 2023
  * @example getWeeksInLocaleWeekYear("2020-06-15", "de-DE") // 53
- * @example getWeeksInLocaleWeekYear("2024-06-15", "en-US", { minimalDays: 8 }) // null
- * @example getWeeksInLocaleWeekYear("+275760-09-13", "en-US") // 53 (its end, the week 1 of +275761, lies past the range)
- * @example getWeeksInLocaleWeekYear("invalid", "en-US") // null
+ * @example getWeeksInLocaleWeekYear("2024-06-15", "hi-IN", { minimalDays: 8 }) // null
+ * @example getWeeksInLocaleWeekYear("+275760-09-13", "pt-BR") // 53 (its end, the week 1 of +275761, lies past the range)
+ * @example getWeeksInLocaleWeekYear("invalid", "ar-EG") // null
  * @example getWeeksInLocaleWeekYear("2024-12-29", ["fr-FR", "en-US"]) // 52
  */
 export function getWeeksInLocaleWeekYear(value, locale, options) {

package/dist/plain/calculate/getWeeksInMonth.d.ts

@@ -5,24 +5,21 @@
  * - The count depends on which day the week starts — the same month can
  *   span 4, 5, or 6 rows depending on locale (e.g. February 2026 is 4
  *   rows starting Sunday but 5 rows starting Monday).
- * - The count is the row the month's last day falls on, where row 1 holds
- *   the 1st (see `getWeekOfMonth`). This is GMT's own rule for sizing a
- *   month grid, not a standard's; CLDR's `minDays` plays no part.
- * - Comparison: `@internationalized/date`'s `getWeeksInMonth` returns the
- *   same number for the same first day of week.
+ * - The count is the UTS #35 week of month (`W`) of the month's last day, with the locale's first
+ *   day of week and minimal days fixed at 1 (see `getWeekOfMonth`).
  * - Resolves the locale's first day of week via
  *   `Intl.Locale.prototype.weekInfo`.
  * - Returns null if `value` or `locale` is invalid.
  *
  * @param value ISO PlainDate string
- * @param locale BCP 47 locale tag (e.g. "en-US", "fr-FR"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
+ * @param locale BCP 47 locale tag (e.g. "fr-FR", "ja-JP", "en-US"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
  * @returns number of week-rows the month spans (4-6), or null on invalid input
  *
- * @example getWeeksInMonth("2024-02-15", "en-US") // 5
- * @example getWeeksInMonth("2026-02-15", "en-US") // 4
+ * @example getWeeksInMonth("2024-02-15", "pt-BR") // 5
+ * @example getWeeksInMonth("2026-02-15", "ja-JP") // 4
  * @example getWeeksInMonth("2026-02-15", "en-GB") // 5
- * @example getWeeksInMonth("-271821-04-19", "en-US") // 5 (the first representable month; its 1st lies before the range)
- * @example getWeeksInMonth("invalid", "en-US") // null
- * @example getWeeksInMonth("2024-06-15", ["en-US", "fr-FR"]) // 6
+ * @example getWeeksInMonth("-271821-04-19", "ja-JP") // 5 (the first representable month; its 1st lies before the range)
+ * @example getWeeksInMonth("invalid", "hi-IN") // null
+ * @example getWeeksInMonth("2024-06-15", ["ja-JP", "fr-FR"]) // 6
  */
 export declare function getWeeksInMonth(value: string, locale: string | string[]): number | null;

package/dist/plain/calculate/getWeeksInMonth.js

@@ -1,5 +1,5 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { getLocaleFirstDayOfWeek, monthGridWeekRow } from "../../internal/index.js";
 import { isValidDate } from "../validate/index.js";
 /**
@@ -9,25 +9,22 @@ import { isValidDate } from "../validate/index.js";
  * - The count depends on which day the week starts — the same month can
  *   span 4, 5, or 6 rows depending on locale (e.g. February 2026 is 4
  *   rows starting Sunday but 5 rows starting Monday).
- * - The count is the row the month's last day falls on, where row 1 holds
- *   the 1st (see `getWeekOfMonth`). This is GMT's own rule for sizing a
- *   month grid, not a standard's; CLDR's `minDays` plays no part.
- * - Comparison: `@internationalized/date`'s `getWeeksInMonth` returns the
- *   same number for the same first day of week.
+ * - The count is the UTS #35 week of month (`W`) of the month's last day, with the locale's first
+ *   day of week and minimal days fixed at 1 (see `getWeekOfMonth`).
  * - Resolves the locale's first day of week via
  *   `Intl.Locale.prototype.weekInfo`.
  * - Returns null if `value` or `locale` is invalid.
  *
  * @param value ISO PlainDate string
- * @param locale BCP 47 locale tag (e.g. "en-US", "fr-FR"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
+ * @param locale BCP 47 locale tag (e.g. "fr-FR", "ja-JP", "en-US"), or a preference list of tags (ECMA-402; the first with locale data is read). Required: omitted, or an empty list (which ECMA-402 would resolve to the host default), returns null
  * @returns number of week-rows the month spans (4-6), or null on invalid input
  *
- * @example getWeeksInMonth("2024-02-15", "en-US") // 5
- * @example getWeeksInMonth("2026-02-15", "en-US") // 4
+ * @example getWeeksInMonth("2024-02-15", "pt-BR") // 5
+ * @example getWeeksInMonth("2026-02-15", "ja-JP") // 4
  * @example getWeeksInMonth("2026-02-15", "en-GB") // 5
- * @example getWeeksInMonth("-271821-04-19", "en-US") // 5 (the first representable month; its 1st lies before the range)
- * @example getWeeksInMonth("invalid", "en-US") // null
- * @example getWeeksInMonth("2024-06-15", ["en-US", "fr-FR"]) // 6
+ * @example getWeeksInMonth("-271821-04-19", "ja-JP") // 5 (the first representable month; its 1st lies before the range)
+ * @example getWeeksInMonth("invalid", "hi-IN") // null
+ * @example getWeeksInMonth("2024-06-15", ["ja-JP", "fr-FR"]) // 6
  */
 export function getWeeksInMonth(value, locale) {
     if (!isValidDate(value))

package/dist/plain/calculate/getWeeksInYear.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { getLocaleWeekYearBounds } from "../../internal/index.js";
 import { isValidDate } from "../validate/index.js";
 /**

package/dist/plain/calculate/maxDate.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDate } from "../validate/index.js";
 /**
  * Return the latest (maximum) of the given PlainDate values.

package/dist/plain/calculate/maxDateTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTime } from "../validate/index.js";
 /**
  * Return the latest (maximum) of the given PlainDateTime values.

package/dist/plain/calculate/maxTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidTime } from "../validate/index.js";
 /**
  * Return the latest (maximum) of the given PlainTime values.

package/dist/plain/calculate/minDate.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDate } from "../validate/index.js";
 /**
  * Return the earliest (minimum) of the given PlainDate values.

package/dist/plain/calculate/minDateTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidDateTime } from "../validate/index.js";
 /**
  * Return the earliest (minimum) of the given PlainDateTime values.

package/dist/plain/calculate/minTime.js

@@ -1,4 +1,4 @@
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { isValidTime } from "../validate/index.js";
 /**
  * Return the earliest (minimum) of the given PlainTime values.

package/dist/plain/calculate/nextWeekday.d.ts

@@ -1,22 +1,24 @@
 /**
- * Return a PlainDate ISO string for the next occurrence of `dayOfWeek` on or after `value`.
+ * Return a PlainDate ISO string for the next occurrence of `dayOfWeek` after `value` (or on it,
+ * with `inclusive: true`).
  *
  * - `dayOfWeek` uses Temporal's ISO numbering: 1 (Monday) through 7 (Sunday), consistent with
  *   `getDayOfWeek`/`parseDayOfWeekFromDate`.
  * - Returns "" on invalid input.
  *
- * Replaces date-fns's sixteen `next*` functions with one parameterized call:
+ * Migrating from date-fns: its eight `next*` functions map to one parameterized call. date-fns
+ * numbers days 0 (Sunday) to 6 (Saturday), so `nextDay`'s 0 becomes 7.
  *
- * | date-fns          | gmt                          |
- * | ----------------- | ----------------------------- |
- * | `nextMonday`      | `nextWeekday(value, 1)`      |
- * | `nextTuesday`     | `nextWeekday(value, 2)`      |
- * | `nextWednesday`   | `nextWeekday(value, 3)`      |
- * | `nextThursday`    | `nextWeekday(value, 4)`      |
- * | `nextFriday`      | `nextWeekday(value, 5)`      |
- * | `nextSaturday`    | `nextWeekday(value, 6)`      |
- * | `nextSunday`      | `nextWeekday(value, 7)`      |
- * | `nextDay(v, n)`   | `nextWeekday(value, n)`      |
+ * | date-fns        | gmt                                   |
+ * | --------------- | ------------------------------------- |
+ * | `nextMonday`    | `nextWeekday(value, 1)`               |
+ * | `nextTuesday`   | `nextWeekday(value, 2)`               |
+ * | `nextWednesday` | `nextWeekday(value, 3)`               |
+ * | `nextThursday`  | `nextWeekday(value, 4)`               |
+ * | `nextFriday`    | `nextWeekday(value, 5)`               |
+ * | `nextSaturday`  | `nextWeekday(value, 6)`               |
+ * | `nextSunday`    | `nextWeekday(value, 7)`               |
+ * | `nextDay(v, n)` | `nextWeekday(value, n === 0 ? 7 : n)` |
  *
  * @param value ISO PlainDate string
  * @param dayOfWeek target ISO day of week (1-7, Monday-Sunday)

package/dist/plain/calculate/nextWeekday.js

@@ -1,27 +1,29 @@
 // fallow-ignore-file code-duplication -- sibling variant keeps its own guard, parse and try/catch, by design
-import { Temporal } from "@js-temporal/polyfill";
+import { Temporal } from "../../internal/temporal.js";
 import { advanceToWeekday, isValidDayOfWeek } from "../../internal/index.js";
 import { isValidDate } from "../validate/index.js";
 import { isOptionsArgument } from "../../internal/isObject.js";
 /**
- * Return a PlainDate ISO string for the next occurrence of `dayOfWeek` on or after `value`.
+ * Return a PlainDate ISO string for the next occurrence of `dayOfWeek` after `value` (or on it,
+ * with `inclusive: true`).
  *
  * - `dayOfWeek` uses Temporal's ISO numbering: 1 (Monday) through 7 (Sunday), consistent with
  *   `getDayOfWeek`/`parseDayOfWeekFromDate`.
  * - Returns "" on invalid input.
  *
- * Replaces date-fns's sixteen `next*` functions with one parameterized call:
+ * Migrating from date-fns: its eight `next*` functions map to one parameterized call. date-fns
+ * numbers days 0 (Sunday) to 6 (Saturday), so `nextDay`'s 0 becomes 7.
  *
- * | date-fns          | gmt                          |
- * | ----------------- | ----------------------------- |
- * | `nextMonday`      | `nextWeekday(value, 1)`      |
- * | `nextTuesday`     | `nextWeekday(value, 2)`      |
- * | `nextWednesday`   | `nextWeekday(value, 3)`      |
- * | `nextThursday`    | `nextWeekday(value, 4)`      |
- * | `nextFriday`      | `nextWeekday(value, 5)`      |
- * | `nextSaturday`    | `nextWeekday(value, 6)`      |
- * | `nextSunday`      | `nextWeekday(value, 7)`      |
- * | `nextDay(v, n)`   | `nextWeekday(value, n)`      |
+ * | date-fns        | gmt                                   |
+ * | --------------- | ------------------------------------- |
+ * | `nextMonday`    | `nextWeekday(value, 1)`               |
+ * | `nextTuesday`   | `nextWeekday(value, 2)`               |
+ * | `nextWednesday` | `nextWeekday(value, 3)`               |
+ * | `nextThursday`  | `nextWeekday(value, 4)`               |
+ * | `nextFriday`    | `nextWeekday(value, 5)`               |
+ * | `nextSaturday`  | `nextWeekday(value, 6)`               |
+ * | `nextSunday`    | `nextWeekday(value, 7)`               |
+ * | `nextDay(v, n)` | `nextWeekday(value, n === 0 ? 7 : n)` |
  *
  * @param value ISO PlainDate string
  * @param dayOfWeek target ISO day of week (1-7, Monday-Sunday)

package/dist/plain/calculate/previousWeekday.d.ts

@@ -1,22 +1,24 @@
 /**
- * Return a PlainDate ISO string for the previous occurrence of `dayOfWeek` on or before `value`.
+ * Return a PlainDate ISO string for the previous occurrence of `dayOfWeek` before `value` (or on
+ * it, with `inclusive: true`).
  *
  * - `dayOfWeek` uses Temporal's ISO numbering: 1 (Monday) through 7 (Sunday), consistent with
  *   `getDayOfWeek`/`parseDayOfWeekFromDate`.
  * - Returns "" on invalid input.
  *
- * Replaces date-fns's sixteen `previous*` functions with one parameterized call:
+ * Migrating from date-fns: its eight `previous*` functions map to one parameterized call.
+ * date-fns numbers days 0 (Sunday) to 6 (Saturday), so `previousDay`'s 0 becomes 7.
  *
- * | date-fns              | gmt                              |
- * | ---------------------- | --------------------------------- |
- * | `previousMonday`      | `previousWeekday(value, 1)`      |
- * | `previousTuesday`     | `previousWeekday(value, 2)`      |
- * | `previousWednesday`   | `previousWeekday(value, 3)`      |
- * | `previousThursday`    | `previousWeekday(value, 4)`      |
- * | `previousFriday`      | `previousWeekday(value, 5)`      |
- * | `previousSaturday`    | `previousWeekday(value, 6)`      |
- * | `previousSunday`      | `previousWeekday(value, 7)`      |
- * | `previousDay(v, n)`   | `previousWeekday(value, n)`      |
+ * | date-fns            | gmt                                       |
+ * | ------------------- | ----------------------------------------- |
+ * | `previousMonday`    | `previousWeekday(value, 1)`               |
+ * | `previousTuesday`   | `previousWeekday(value, 2)`               |
+ * | `previousWednesday` | `previousWeekday(value, 3)`               |
+ * | `previousThursday`  | `previousWeekday(value, 4)`               |
+ * | `previousFriday`    | `previousWeekday(value, 5)`               |
+ * | `previousSaturday`  | `previousWeekday(value, 6)`               |
+ * | `previousSunday`    | `previousWeekday(value, 7)`               |
+ * | `previousDay(v, n)` | `previousWeekday(value, n === 0 ? 7 : n)` |
  *
  * @param value ISO PlainDate string
  * @param dayOfWeek target ISO day of week (1-7, Monday-Sunday)