@astryxdesign/core 0.7.9-canary.45a4865 → 0.7.9-canary.4d7dca6

package/dist/i18n/InternationalizationProvider.d.ts

@@ -66,14 +66,15 @@ export interface InternationalizationProviderProps {
     dir?: 'ltr' | 'rtl';
     /**
      * The calendar system of this subtree, such as `'persian'` or `'hebrew'`.
-     * `Calendar` shows it, and Timestamp and PowerSearch write their dates in it.
-     * The date inputs show Gregorian dates. Values stay Gregorian ISO dates. When
-     * omitted, the calendar is Gregorian: a locale never selects it, neither by
-     * its default calendar nor by a `-u-ca-` keyword. A component's own
-     * `calendar` prop takes precedence. Calendars other than `gregory`,
-     * `iso8601`, `buddhist`, `roc`, and `japanese` need `Temporal`. The context
-     * keeps the requested calendar; where `Temporal` is missing, these components
-     * show Gregorian dates and warn once in development.
+     * `Calendar` shows it, and Timestamp, PowerSearch, and Lab's Schedule write
+     * their dates in it. The date inputs show Gregorian dates. Values stay
+     * Gregorian ISO dates. When omitted, the calendar is Gregorian: a locale
+     * never selects it, neither by its default calendar nor by a `-u-ca-`
+     * keyword. A component's own `calendar` prop takes precedence. Calendars
+     * other than `gregory`, `iso8601`, `buddhist`, `roc`, and `japanese` need
+     * `Temporal`. The context keeps the requested calendar; where `Temporal` is
+     * missing, these components show Gregorian dates and warn once in
+     * development.
      *
      * @example
      * ```

package/dist/i18n/InternationalizationProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InternationalizationProvider.d.ts","sourceRoot":"","sources":["../../src/i18n/InternationalizationProvider.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAU,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAI9C,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EACV,MAAM,EAEN,SAAS,EACT,wBAAwB,EACzB,MAAM,SAAS,CAAC;AA4BjB,MAAM,WAAW,iCAAiC;IAChD;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,MAAM,EACN,QAAQ,EACR,SAAS,EACT,GAAG,EACH,QAAQ,EAAE,YAAY,EACtB,QAAQ,GACT,EAAE,iCAAiC,+BAyBnC;yBAhCe,4BAA4B"}
+{"version":3,"file":"InternationalizationProvider.d.ts","sourceRoot":"","sources":["../../src/i18n/InternationalizationProvider.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAU,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAI9C,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EACV,MAAM,EAEN,SAAS,EACT,wBAAwB,EACzB,MAAM,SAAS,CAAC;AA4BjB,MAAM,WAAW,iCAAiC;IAChD;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;;;;;;;;;OAWG;IACH,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,MAAM,EACN,QAAQ,EACR,SAAS,EACT,GAAG,EACH,QAAQ,EAAE,YAAY,EACtB,QAAQ,GACT,EAAE,iCAAiC,+BAyBnC;yBAhCe,4BAA4B"}

package/dist/internal/calendar-system.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file calendar-system.ts
+ * @input The i18n calendar resolution
+ * @output `@astryxdesign/core/internal/calendar-system`: the hook that
+ *   resolves the calendar a date component shows, and the helpers that name
+ *   its months and days as Core's Calendar does, for Lab components
+ * @position An internal entry reserved for Astryx's own packages:
+ *   undocumented, outside the public API and its compatibility promise,
+ *   versioned in lockstep with Core, and allowed only in Core and Lab by the
+ *   `@astryx/no-core-internal-import` lint rule. Named re-exports only.
+ *
+ * SYNC: When modified, update calendar-system.test.ts and
+ * scripts/sync-exports.js.
+ */
+export { useCalendarSystem } from '../i18n/useCalendarSystem.js';
+export { calendarMonthLabelDay, calendarMonthOf, formatCalendarDate, formatCalendarDateToParts, formatCalendarInstantRange, } from '../utils/calendarSystem.js';
+export type { CalendarSystem } from '../utils/calendarSystem.js';
+//# sourceMappingURL=calendar-system.d.ts.map

package/dist/internal/calendar-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-system.d.ts","sourceRoot":"","sources":["../../src/internal/calendar-system.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAC,iBAAiB,EAAC,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAC"}

package/dist/internal/calendar-system.js

@@ -0,0 +1,19 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file calendar-system.ts
+ * @input The i18n calendar resolution
+ * @output `@astryxdesign/core/internal/calendar-system`: the hook that
+ *   resolves the calendar a date component shows, and the helpers that name
+ *   its months and days as Core's Calendar does, for Lab components
+ * @position An internal entry reserved for Astryx's own packages:
+ *   undocumented, outside the public API and its compatibility promise,
+ *   versioned in lockstep with Core, and allowed only in Core and Lab by the
+ *   `@astryx/no-core-internal-import` lint rule. Named re-exports only.
+ *
+ * SYNC: When modified, update calendar-system.test.ts and
+ * scripts/sync-exports.js.
+ */
+
+export { useCalendarSystem } from "../i18n/useCalendarSystem.js";
+export { calendarMonthLabelDay, calendarMonthOf, formatCalendarDate, formatCalendarDateToParts, formatCalendarInstantRange } from "../utils/calendarSystem.js";

package/dist/utils/calendarSystem.d.ts

@@ -67,11 +67,15 @@ export declare function calendarShiftMonths(calendar: CalendarSystem, pd: PlainD
 export declare function calendarShiftYears(calendar: CalendarSystem, pd: PlainDate, n: number): PlainDate;
 /** Whether a Gregorian date falls inside a calendar month. */
 export declare function isInCalendarMonth(pd: PlainDate, month: CalendarMonth): boolean;
+/**
+ * The day that names a calendar month: its middle day. In the Japanese
+ * calendar an era can start inside a month, and most days of that month then
+ * belong to the era of its middle day.
+ */
+export declare function calendarMonthLabelDay(month: CalendarMonth): PlainDate;
 /**
  * The stand-alone month and year label of a calendar month, such as
- * "Aban 1405 AP". It formats a day in the middle of the month: in the
- * Japanese calendar an era can start inside a month, and most days of that
- * month then belong to the era of its middle day.
+ * "Aban 1405 AP", named by `calendarMonthLabelDay`.
  */
 export declare function formatCalendarMonthLabel(calendar: CalendarSystem, month: CalendarMonth, locale: Locale): string;
 /**
@@ -96,6 +100,12 @@ export declare function formatCalendarDateToParts(calendar: CalendarSystem, pd:
  * `options` asks for.
  */
 export declare function formatCalendarInstant(calendar: CalendarSystem, instant: Date, options: Intl.DateTimeFormatOptions, locale: Locale, timeZone?: string): string;
+/**
+ * Formats the range between two instants. Intl writes the fields that both
+ * ends share once. Where Intl names another month or day than Temporal at
+ * either end, the range writes each end in full.
+ */
+export declare function formatCalendarInstantRange(calendar: CalendarSystem, start: Date, end: Date, options: Intl.DateTimeFormatOptions, locale: Locale, timeZone?: string): string;
 /**
  * The fields of a date written in a calendar. A field gives either `year` or
  * `era` with `eraYear`, and either `monthCode` (such as `M05L` for a leap

package/dist/utils/calendarSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calendarSystem.d.ts","sourceRoot":"","sources":["../../src/utils/calendarSystem.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"calendarSystem.d.ts","sourceRoot":"","sources":["../../src/utils/calendarSystem.ts"],"names":[],"mappings":"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"}

package/dist/utils/calendarSystem.js

@@ -245,14 +245,21 @@ export function isInCalendarMonth(pd, month) {
   return plainDateIsInRange(pd, [month.start, month.end]);
 }
 
+/**
+ * The day that names a calendar month: its middle day. In the Japanese
+ * calendar an era can start inside a month, and most days of that month then
+ * belong to the era of its middle day.
+ */
+export function calendarMonthLabelDay(month) {
+  return plainDateAddDays(month.start, Math.floor(month.length / 2));
+}
+
 /**
  * The stand-alone month and year label of a calendar month, such as
- * "Aban 1405 AP". It formats a day in the middle of the month: in the
- * Japanese calendar an era can start inside a month, and most days of that
- * month then belong to the era of its middle day.
+ * "Aban 1405 AP", named by `calendarMonthLabelDay`.
  */
 export function formatCalendarMonthLabel(calendar, month, locale) {
-  return plainDateFormatStandaloneMonthYear(plainDateAddDays(month.start, Math.floor(month.length / 2)), locale, labelCalendar(calendar));
+  return plainDateFormatStandaloneMonthYear(calendarMonthLabelDay(month), locale, labelCalendar(calendar));
 }
 
 // Intl has no month names for `iso8601`. Labels use `gregory`, which has the
@@ -352,6 +359,33 @@ function withTemporalDay(calendar, pd, parts, options, locale) {
 export function formatCalendarInstant(calendar, instant, options, locale, timeZone) {
   return instantLabel(calendar, instant, options, locale, timeZone).text;
 }
+
+/**
+ * Formats the range between two instants. Intl writes the fields that both
+ * ends share once. Where Intl names another month or day than Temporal at
+ * either end, the range writes each end in full.
+ */
+export function formatCalendarInstantRange(calendar, start, end, options, locale, timeZone) {
+  const ends = [start, end].map(instant => instantLabel(calendar, instant, options, locale, timeZone));
+  const {
+    format
+  } = ends[0];
+  if (ends.every(({
+    isIntl
+  }) => isIntl)) {
+    return format.formatRange(start, end);
+  }
+  // Intl writes a range of different years as two full dates around its
+  // separator, which gives the separator to put between the two full ends.
+  const far = new Date(start.getTime() + 400 * 86_400_000);
+  const both = format.formatRange(start, far);
+  const [from, to] = [format.format(start), format.format(far)];
+  const separator = both.startsWith(from) && both.endsWith(to) ? both.slice(from.length, both.length - to.length) : ' – ';
+  const [first, last] = ends.map(({
+    text
+  }) => text);
+  return first === last ? first : `${first}${separator}${last}`;
+}
 function instantLabel(calendar, instant, options, locale, timeZone) {
   const format = dateTimeFormatAtCall(locale, {
     ...options,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astryxdesign/core",
-  "version": "0.7.9-canary.45a4865",
+  "version": "0.7.9-canary.4d7dca6",
   "displayName": "Astryx Core",
   "description": "The component library. Accessible, themeable React components with built-in spacing, dark mode, and StyleX styling.",
   "author": "Meta Open Source",
@@ -843,6 +843,11 @@
       "source": "./src/internal/spinner-rotor.ts",
       "types": "./dist/internal/spinner-rotor.d.ts",
       "default": "./dist/internal/spinner-rotor.js"
+    },
+    "./internal/calendar-system": {
+      "source": "./src/internal/calendar-system.ts",
+      "types": "./dist/internal/calendar-system.d.ts",
+      "default": "./dist/internal/calendar-system.js"
     }
   },
   "files": [
@@ -875,9 +880,9 @@
     "react-dom": ">=19.0.0"
   },
   "devDependencies": {
-    "@astryxdesign/a11y-spec": "0.7.9-canary.45a4865",
-    "@astryxdesign/cli": "0.7.9-canary.45a4865",
-    "@astryxdesign/interaction-harness": "0.7.9-canary.45a4865",
+    "@astryxdesign/a11y-spec": "0.7.9-canary.4d7dca6",
+    "@astryxdesign/cli": "0.7.9-canary.4d7dca6",
+    "@astryxdesign/interaction-harness": "0.7.9-canary.4d7dca6",
     "@babel/cli": "^7.29.7",
     "@babel/core": "^7.29.7",
     "@babel/preset-react": "^7.29.7",

package/src/i18n/InternationalizationProvider.doc.mjs

@@ -53,7 +53,7 @@ export const docs = {
       {
         guidance: true,
         description:
-          'Set `calendar` to show `Calendar` in another calendar system and write Timestamp and PowerSearch dates in it; `DateInput`, `DateRangeInput`, and `DateTimeInput` show Gregorian dates. A locale never selects the calendar: `fa-IR` shows Gregorian dates until you set `calendar="persian"`, and a `-u-ca-` keyword in `locale`, as in `th-TH-u-ca-buddhist`, keeps Gregorian dates too. Date values stay Gregorian ISO strings.',
+          'Set `calendar` to show `Calendar` in another calendar system and write Timestamp, PowerSearch, and Schedule dates in it; `DateInput`, `DateRangeInput`, and `DateTimeInput` show Gregorian dates. A locale never selects the calendar: `fa-IR` shows Gregorian dates until you set `calendar="persian"`, and a `-u-ca-` keyword in `locale`, as in `th-TH-u-ca-buddhist`, keeps Gregorian dates too. Date values stay Gregorian ISO strings.',
       },
       {
         guidance: false,
@@ -96,7 +96,7 @@ export const docs = {
       type: "'gregory' | 'iso8601' | 'buddhist' | 'roc' | 'japanese' | 'persian' | 'indian' | 'hebrew' | 'chinese' | 'dangi' | 'coptic' | 'ethiopic' | 'ethioaa' | 'islamic-civil' | 'islamic-tbla' | 'islamic-umalqura'",
       required: false,
       description:
-        "Calendar system of the subtree, such as 'persian', 'hebrew', or 'buddhist'. `Calendar` shows it, and Timestamp and PowerSearch write their dates in it. `DateInput`, `DateRangeInput`, and `DateTimeInput` show Gregorian dates. When omitted, the calendar is Gregorian: a locale never selects it, neither by its default calendar nor by a `-u-ca-` keyword. A component's own `calendar` prop takes precedence. Values stay Gregorian ISO dates. Calendars other than gregory, iso8601, buddhist, roc, and japanese need `Temporal`; the context keeps the requested calendar, and where the runtime lacks `Temporal`, these components show Gregorian dates and warn in development. Load a polyfill such as `temporal-polyfill/full/global` on the server and in the browser.",
+        "Calendar system of the subtree, such as 'persian', 'hebrew', or 'buddhist'. `Calendar` shows it, and Timestamp, PowerSearch, and Lab's Schedule write their dates in it. `DateInput`, `DateRangeInput`, and `DateTimeInput` show Gregorian dates. When omitted, the calendar is Gregorian: a locale never selects it, neither by its default calendar nor by a `-u-ca-` keyword. A component's own `calendar` prop takes precedence. Values stay Gregorian ISO dates. Calendars other than gregory, iso8601, buddhist, roc, and japanese need `Temporal`; the context keeps the requested calendar, and where the runtime lacks `Temporal`, these components show Gregorian dates and warn in development. Load a polyfill such as `temporal-polyfill/full/global` on the server and in the browser.",
     },
     {
       name: 'children',
@@ -217,6 +217,6 @@ export const docsDense = {
     overrides:
       'sparse per-locale key overrides applied on top of shipped defaults',
     calendar:
-      'calendar system for Calendar, Timestamp, and PowerSearch dates; date inputs stay Gregorian (default: gregory; a -u-ca- keyword in locale does not select it); values stay Gregorian ISO; non-Gregorian-aligned calendars need Temporal',
+      'calendar system for Calendar, Timestamp, PowerSearch, and Schedule dates; date inputs stay Gregorian (default: gregory; a -u-ca- keyword in locale does not select it); values stay Gregorian ISO; non-Gregorian-aligned calendars need Temporal',
   },
 };

package/src/i18n/InternationalizationProvider.tsx

@@ -106,14 +106,15 @@ export interface InternationalizationProviderProps {
   dir?: 'ltr' | 'rtl';
   /**
    * The calendar system of this subtree, such as `'persian'` or `'hebrew'`.
-   * `Calendar` shows it, and Timestamp and PowerSearch write their dates in it.
-   * The date inputs show Gregorian dates. Values stay Gregorian ISO dates. When
-   * omitted, the calendar is Gregorian: a locale never selects it, neither by
-   * its default calendar nor by a `-u-ca-` keyword. A component's own
-   * `calendar` prop takes precedence. Calendars other than `gregory`,
-   * `iso8601`, `buddhist`, `roc`, and `japanese` need `Temporal`. The context
-   * keeps the requested calendar; where `Temporal` is missing, these components
-   * show Gregorian dates and warn once in development.
+   * `Calendar` shows it, and Timestamp, PowerSearch, and Lab's Schedule write
+   * their dates in it. The date inputs show Gregorian dates. Values stay
+   * Gregorian ISO dates. When omitted, the calendar is Gregorian: a locale
+   * never selects it, neither by its default calendar nor by a `-u-ca-`
+   * keyword. A component's own `calendar` prop takes precedence. Calendars
+   * other than `gregory`, `iso8601`, `buddhist`, `roc`, and `japanese` need
+   * `Temporal`. The context keeps the requested calendar; where `Temporal` is
+   * missing, these components show Gregorian dates and warn once in
+   * development.
    *
    * @example
    * ```

package/src/internal/calendar-system.ts

@@ -0,0 +1,26 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file calendar-system.ts
+ * @input The i18n calendar resolution
+ * @output `@astryxdesign/core/internal/calendar-system`: the hook that
+ *   resolves the calendar a date component shows, and the helpers that name
+ *   its months and days as Core's Calendar does, for Lab components
+ * @position An internal entry reserved for Astryx's own packages:
+ *   undocumented, outside the public API and its compatibility promise,
+ *   versioned in lockstep with Core, and allowed only in Core and Lab by the
+ *   `@astryx/no-core-internal-import` lint rule. Named re-exports only.
+ *
+ * SYNC: When modified, update calendar-system.test.ts and
+ * scripts/sync-exports.js.
+ */
+
+export {useCalendarSystem} from '../i18n/useCalendarSystem';
+export {
+  calendarMonthLabelDay,
+  calendarMonthOf,
+  formatCalendarDate,
+  formatCalendarDateToParts,
+  formatCalendarInstantRange,
+} from '../utils/calendarSystem';
+export type {CalendarSystem} from '../utils/calendarSystem';

package/src/utils/calendarSystem.ts

@@ -329,11 +329,18 @@ export function isInCalendarMonth(
   return plainDateIsInRange(pd, [month.start, month.end]);
 }
 
+/**
+ * The day that names a calendar month: its middle day. In the Japanese
+ * calendar an era can start inside a month, and most days of that month then
+ * belong to the era of its middle day.
+ */
+export function calendarMonthLabelDay(month: CalendarMonth): PlainDate {
+  return plainDateAddDays(month.start, Math.floor(month.length / 2));
+}
+
 /**
  * The stand-alone month and year label of a calendar month, such as
- * "Aban 1405 AP". It formats a day in the middle of the month: in the
- * Japanese calendar an era can start inside a month, and most days of that
- * month then belong to the era of its middle day.
+ * "Aban 1405 AP", named by `calendarMonthLabelDay`.
  */
 export function formatCalendarMonthLabel(
   calendar: CalendarSystem,
@@ -341,7 +348,7 @@ export function formatCalendarMonthLabel(
   locale: Locale,
 ): string {
   return plainDateFormatStandaloneMonthYear(
-    plainDateAddDays(month.start, Math.floor(month.length / 2)),
+    calendarMonthLabelDay(month),
     locale,
     labelCalendar(calendar),
   );
@@ -503,6 +510,39 @@ export function formatCalendarInstant(
   return instantLabel(calendar, instant, options, locale, timeZone).text;
 }
 
+/**
+ * Formats the range between two instants. Intl writes the fields that both
+ * ends share once. Where Intl names another month or day than Temporal at
+ * either end, the range writes each end in full.
+ */
+export function formatCalendarInstantRange(
+  calendar: CalendarSystem,
+  start: Date,
+  end: Date,
+  options: Intl.DateTimeFormatOptions,
+  locale: Locale,
+  timeZone?: string,
+): string {
+  const ends = [start, end].map(instant =>
+    instantLabel(calendar, instant, options, locale, timeZone),
+  );
+  const {format} = ends[0];
+  if (ends.every(({isIntl}) => isIntl)) {
+    return format.formatRange(start, end);
+  }
+  // Intl writes a range of different years as two full dates around its
+  // separator, which gives the separator to put between the two full ends.
+  const far = new Date(start.getTime() + 400 * 86_400_000);
+  const both = format.formatRange(start, far);
+  const [from, to] = [format.format(start), format.format(far)];
+  const separator =
+    both.startsWith(from) && both.endsWith(to)
+      ? both.slice(from.length, both.length - to.length)
+      : ' – ';
+  const [first, last] = ends.map(({text}) => text);
+  return first === last ? first : `${first}${separator}${last}`;
+}
+
 function instantLabel(
   calendar: CalendarSystem,
   instant: Date,