@astryxdesign/core 0.7.8 → 0.7.9-canary.07992bb

package/dist/hooks/useMenuPress.js

@@ -6,7 +6,8 @@
  * @file useMenuPress.ts
  * @input The menu root, its trigger, the enabled-row selector, and callbacks
  *   for opening, highlighting, activating and dismissing
- * @output useMenuPress, the marker attributes, and the activation mark
+ * @output useMenuPress, the marker attributes, the activation mark, and the
+ *   internal useDropdownMenuPress entry with its touch model
  * @position Core hook for DropdownMenu, ContextMenu, DropdownMenuSubMenu,
  *   Selector and MenuBottomSheetActionList. The transition table lives in
  *   menuPressGesture.ts.
@@ -19,13 +20,14 @@
  */
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { currentGesture } from "../Layer/gestureCounter.js";
-import { IDLE_MENU_PRESS, menuPressStep } from "./menuPressGesture.js";
+import { IDLE_MENU_PRESS, menuPressTransition } from "./menuPressGesture.js";
 import { MENU_PRESS_MARKER } from "./menuPressMarker.js";
 import { useLongPressDetector } from "./useLongPress.js";
 import { edgeAutoscroll } from "../utils/edgeAutoscroll.js";
 import { focusForLastInput } from "../utils/focusReturn.js";
 import { useInteractionModalityTrackingFor } from "../utils/interactionModality.js";
 import { LONG_PRESS_DURATION_MS } from "../motion/uikit/longPress.js";
+import { clearMenuPressLit, holdMenuPressPaint, markMenuPressLit, releaseMenuPressPaint } from "../privateAttributes/menuPressLit.stylex.js";
 import { __resetClickGuardForTest, armClickGuard, CLICK_GUARD_WINDOW_MS, withoutClickGuard } from "../utils/clickGuard.js";
 export { MENU_PRESS_MARKER };
 const MENU_PRESS_ROOT_SELECTOR = `[${MENU_PRESS_MARKER}]`;
@@ -124,6 +126,34 @@ function isInMenuTree(element, root) {
   const owner = element.closest(MENU_PRESS_ROOT_SELECTOR);
   return owner != null && getOutermostRoot(owner) === root;
 }
+
+/**
+ * DropdownMenu's options for the press model: everything the public hook
+ * takes, plus its touch model. DropdownMenu reaches the touch model through
+ * its `presentation`, so the public hook has no such option.
+ *
+ * @internal
+ */
+
+/**
+ * What core's own menus get from {@link useDropdownMenuPress}: the public
+ * return. Not exported from the hooks entry point.
+ *
+ * @internal
+ */
+
+/**
+ * Where a pointer is, for a finger's handoff distance. Positions reach the
+ * machine only under `touchModel: 'uikit'`. Without them, it keeps the settle
+ * rule.
+ */
+function handoffPosition(event, hasHandoff) {
+  return hasHandoff ? {
+    x: event.clientX,
+    y: event.clientY
+  } : {};
+}
+
 /**
  * The press model for a menu: the row under the release acts, the highlight
  * follows a held pointer, and a mouse opens the menu on press.
@@ -160,6 +190,26 @@ function isInMenuTree(element, root) {
  * ```
  */
 export function useMenuPress(options) {
+  // The touch model is DropdownMenu's alone; an untyped caller's
+  // `touchModel` does not reach the model.
+  const {
+    touchModel: _touchModel,
+    ...publicOptions
+  } = options;
+  return useDropdownMenuPress({
+    ...publicOptions,
+    touchModel: 'pointer'
+  });
+}
+
+/**
+ * The press model with DropdownMenu's touch model
+ * ({@link DropdownMenuPressOptions.touchModel}). Not exported from the hooks
+ * entry point.
+ *
+ * @internal
+ */
+export function useDropdownMenuPress(options) {
   const optionsRef = useRef(options);
   optionsRef.current = options;
   // The highlight, and the hover focus of the rows in this menu, follow the
@@ -247,8 +297,18 @@ export function useMenuPress(options) {
     autoscroll.stop();
     autoscrollRef.current = null;
   }, [autoscroll]);
+  const litRowRef = useRef(null);
+  const heldMenuRef = useRef(null);
   const endGesture = useCallback(() => {
     longPressApiRef.current?.cancel();
+    if (litRowRef.current != null) {
+      clearMenuPressLit(litRowRef.current);
+      litRowRef.current = null;
+    }
+    if (heldMenuRef.current != null) {
+      releaseMenuPressPaint(heldMenuRef.current);
+      heldMenuRef.current = null;
+    }
     touchMovePreventerRef.current?.();
     touchMovePreventerRef.current = null;
     stopAutoscroll();
@@ -259,10 +319,36 @@ export function useMenuPress(options) {
     gestureRef.current = IDLE_MENU_PRESS;
   }, [stopAutoscroll]);
   const highlight = useCallback(row => {
+    // A held finger or pen marks the row it lights, for the row's pressed
+    // paint. A held mouse keeps the hover tint, as on a desktop.
+    const gesture = gestureRef.current;
+    const isHeld = gesture.phase !== 'idle' && gesture.pointerType !== 'mouse';
+    const lit = isHeld ? row : null;
+    if (litRowRef.current !== lit) {
+      if (litRowRef.current != null) {
+        clearMenuPressLit(litRowRef.current);
+      }
+      litRowRef.current = lit;
+      if (lit != null) {
+        markMenuPressLit(lit);
+      }
+    }
     const {
       onHighlight,
       menuRef
     } = optionsRef.current;
+    // The row the press began on stays :active where a pointer hovers, so
+    // the menu holds every row but the lit one off that paint.
+    const held = isHeld ? menuRef.current : null;
+    if (heldMenuRef.current !== held) {
+      if (heldMenuRef.current != null) {
+        releaseMenuPressPaint(heldMenuRef.current);
+      }
+      heldMenuRef.current = held;
+      if (held != null) {
+        holdMenuPressPaint(held);
+      }
+    }
     if (onHighlight != null) {
       onHighlight(row);
       return;
@@ -369,7 +455,7 @@ export function useMenuPress(options) {
     }
   }, [activate, endGesture, getDocument, highlight]);
   const step = useCallback((event, native) => {
-    const result = menuPressStep(gestureRef.current, event);
+    const result = menuPressTransition(gestureRef.current, event);
     gestureRef.current = result.gesture;
     applyEffect(result.effect, result.gesture, native);
   }, [applyEffect]);
@@ -466,7 +552,8 @@ export function useMenuPress(options) {
         type: 'move',
         row: point.row,
         isInMenu: point.isInMenu,
-        time: Date.now()
+        time: Date.now(),
+        ...handoffPosition(event, optionsRef.current.touchModel === 'uikit')
       }, event);
       updateAutoscroll(event);
     };
@@ -480,7 +567,8 @@ export function useMenuPress(options) {
         row: point.row,
         isInMenu: point.isInMenu,
         isOnTrigger: point.isOnTrigger,
-        time: Date.now()
+        time: Date.now(),
+        ...handoffPosition(event, optionsRef.current.touchModel === 'uikit')
       }, event);
     };
     const onCancel = event => {

package/dist/hooks/usePressFeedback.d.ts

@@ -7,11 +7,11 @@ import { pressableProps } from '../utils/pressFeedback.js';
  * `interactionOverlayStyles` (from `@astryxdesign/core/utils`) on the same
  * element: `backgroundColor` or `backgroundImage` for a surface whose hover
  * and press are the system's overlays, `pressedBackgroundColor` for one
- * whose hover is its own. The controller writes its attribute on the element
- * while a touch press is believed (after the onset delay, cancelled by travel
- * or by a scroll) and for the release, and the composed style paints the
- * pressed token at the press's strength on the first frame and fades it over
- * the release, keeping `:active` for a mouse on a desktop. On a phone or
+ * whose hover is its own. Under a finger the controller tracks the press the
+ * way UIKit tracks a control and writes its
+ * attribute on the element while the press is held and for the release; the
+ * composed style paints the pressed token on the first frame and fades it
+ * over the release, keeping `:active` for a mouse on a desktop. On a phone or
  * tablet the stylesheet drops `:active` for every press, so the controller
  * also paints a mouse, trackpad or Space-key press there, at once. A press is
  * themed through `--color-overlay-pressed`, which the hold, the flash and the
@@ -27,7 +27,7 @@ import { pressableProps } from '../utils/pressFeedback.js';
  * @example
  * ```
  * const pressable = usePressFeedback();
- * return <div role="button" {...pressable} {...stylex.props(styles.row)} />;
+ * return <button {...pressable} {...stylex.props(styles.button)} />;
  * ```
  */
 export declare function usePressFeedback(): typeof pressableProps;

package/dist/hooks/usePressFeedback.js

@@ -25,11 +25,11 @@ import { installPressFeedback, pressableProps } from "../utils/pressFeedback.js"
  * `interactionOverlayStyles` (from `@astryxdesign/core/utils`) on the same
  * element: `backgroundColor` or `backgroundImage` for a surface whose hover
  * and press are the system's overlays, `pressedBackgroundColor` for one
- * whose hover is its own. The controller writes its attribute on the element
- * while a touch press is believed (after the onset delay, cancelled by travel
- * or by a scroll) and for the release, and the composed style paints the
- * pressed token at the press's strength on the first frame and fades it over
- * the release, keeping `:active` for a mouse on a desktop. On a phone or
+ * whose hover is its own. Under a finger the controller tracks the press the
+ * way UIKit tracks a control and writes its
+ * attribute on the element while the press is held and for the release; the
+ * composed style paints the pressed token on the first frame and fades it
+ * over the release, keeping `:active` for a mouse on a desktop. On a phone or
  * tablet the stylesheet drops `:active` for every press, so the controller
  * also paints a mouse, trackpad or Space-key press there, at once. A press is
  * themed through `--color-overlay-pressed`, which the hold, the flash and the
@@ -45,7 +45,7 @@ import { installPressFeedback, pressableProps } from "../utils/pressFeedback.js"
  * @example
  * ```
  * const pressable = usePressFeedback();
- * return <div role="button" {...pressable} {...stylex.props(styles.row)} />;
+ * return <button {...pressable} {...stylex.props(styles.button)} />;
  * ```
  */
 export function usePressFeedback() {

package/dist/hooks/useScrollRegionProps.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @file useScrollRegionProps.ts
+ * @input Whether a region may scroll, and the caller's role and label
+ * @output useScrollRegionProps: a ref for the region, and the role and
+ *   accessible name that the region carries while its content overflows
+ * @position Internal hook for LayoutContent, LayoutPanel and StackItem.
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/hooks/useScrollRegionProps.test.tsx
+ * - /packages/core/src/AppShell/observeMainOverflow.ts
+ */
+import { type AriaRole, type RefCallback } from 'react';
+export interface ScrollRegionOptions {
+    /** Whether the region may scroll at all (`overflow: auto`). */
+    isScrollable: boolean;
+    /** The caller's role. It always wins, and takes no default name. */
+    role?: AriaRole;
+    /** The caller's accessible name. It always wins. */
+    label?: string;
+}
+export interface ScrollRegionProps {
+    ref: RefCallback<HTMLElement>;
+    role: AriaRole | undefined;
+    'aria-label': string | undefined;
+}
+/**
+ * The region's ref, role and accessible name. While the region may scroll
+ * and its content overflows, it is a group named by the caller's `label`, or
+ * by the translated "Content". A caller's `role` is kept with only the
+ * caller's `label`: a single main landmark relies on its role alone. When
+ * the region does not scroll, the caller's own `role` and `label` pass
+ * through unchanged.
+ */
+export declare function useScrollRegionProps({ isScrollable, role, label, }: ScrollRegionOptions): ScrollRegionProps;
+//# sourceMappingURL=useScrollRegionProps.d.ts.map

package/dist/hooks/useScrollRegionProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollRegionProps.d.ts","sourceRoot":"","sources":["../../src/hooks/useScrollRegionProps.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,OAAO,EAAwB,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAC,MAAM,OAAO,CAAC;AAU7E,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,YAAY,EAAE,OAAO,CAAC;IACtB,oEAAoE;IACpE,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IAC9B,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,YAAY,EACZ,IAAI,EACJ,KAAK,GACN,EAAE,mBAAmB,GAAG,iBAAiB,CAsBzC"}

package/dist/hooks/useScrollRegionProps.js

@@ -0,0 +1,51 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file useScrollRegionProps.ts
+ * @input Whether a region may scroll, and the caller's role and label
+ * @output useScrollRegionProps: a ref for the region, and the role and
+ *   accessible name that the region carries while its content overflows
+ * @position Internal hook for LayoutContent, LayoutPanel and StackItem.
+ *
+ * SYNC: When modified, update:
+ * - /packages/core/src/hooks/useScrollRegionProps.test.tsx
+ * - /packages/core/src/AppShell/observeMainOverflow.ts
+ */
+import { useCallback, useState } from 'react';
+import { registerEnglishFallback, useComponentTranslator } from "../i18n/useComponentTranslator.js";
+import english from "../i18n/generated-english/hooks/useScrollRegionProps.generated.js";
+import { observeMainOverflow } from "../AppShell/observeMainOverflow.js";
+registerEnglishFallback(english);
+/**
+ * The region's ref, role and accessible name. While the region may scroll
+ * and its content overflows, it is a group named by the caller's `label`, or
+ * by the translated "Content". A caller's `role` is kept with only the
+ * caller's `label`: a single main landmark relies on its role alone. When
+ * the region does not scroll, the caller's own `role` and `label` pass
+ * through unchanged.
+ */
+export function useScrollRegionProps({
+  isScrollable,
+  role,
+  label
+}) {
+  const t = useComponentTranslator();
+  const [overflows, setOverflows] = useState(false);
+  // A caller's role takes no default name, so its region is not observed.
+  const hasRole = role != null;
+  const ref = useCallback(element => {
+    if (element == null || !isScrollable || hasRole) {
+      setOverflows(false);
+      return undefined;
+    }
+    return observeMainOverflow(element, setOverflows);
+  }, [hasRole, isScrollable]);
+  const isGroup = !hasRole && isScrollable && overflows;
+  return {
+    ref,
+    role: role ?? (isGroup ? 'group' : undefined),
+    'aria-label': label ?? (isGroup ? t('@astryx.scrollRegion.label') : undefined)
+  };
+}

package/dist/i18n/InternationalizationContext.d.ts

@@ -1,8 +1,14 @@
 import { getResolve } from './resolve.js';
 import type { Locale, MessagesByLocale, Overrides } from './types.js';
+import type { CalendarSystem } from '../utils/calendarSystem.js';
 export interface InternationalizationContextValue {
     locale: Locale;
     direction: 'ltr' | 'rtl';
+    /**
+     * The provider's requested calendar system. A context without it means
+     * Gregorian dates.
+     */
+    calendar?: CalendarSystem;
     messages: MessagesByLocale;
     overrides?: Overrides;
     translate: ReturnType<typeof getResolve>;

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

@@ -1 +1 @@
-{"version":3,"file":"InternationalizationContext.d.ts","sourceRoot":"","sources":["../../src/i18n/InternationalizationContext.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAC,UAAU,EAAC,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAC,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAC,MAAM,SAAS,CAAC;AAEjE,MAAM,WAAW,gCAAgC;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,2DAMpC,CAAC"}
+{"version":3,"file":"InternationalizationContext.d.ts","sourceRoot":"","sources":["../../src/i18n/InternationalizationContext.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAC,UAAU,EAAC,MAAM,WAAW,CAAC;AACrC,OAAO,KAAK,EAAC,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAC,MAAM,SAAS,CAAC;AACjE,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAE5D,MAAM,WAAW,gCAAgC;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,2DAMpC,CAAC"}

package/dist/i18n/InternationalizationProvider.d.ts

@@ -1,8 +1,8 @@
 /**
  * @file InternationalizationProvider.tsx
- * @input React, InternationalizationContext, i18n types
+ * @input React, InternationalizationContext, i18n types, calendar resolution
  * @output Exports InternationalizationProvider component and props type
- * @position Provider component for astryx i18n locale + messages
+ * @position Provider component for astryx i18n locale, messages, and calendar
  *
  * Wraps a subtree with a locale and (optional) additional message catalogs +
  * overrides. Astryx components inside the subtree resolve their strings via
@@ -15,6 +15,7 @@
  * - /packages/core/src/i18n/InternationalizationProvider.doc.mjs
  */
 import { type ReactNode } from 'react';
+import type { CalendarSystem } from '../utils/calendarSystem.js';
 import type { Locale, Overrides, ProviderMessagesByLocale } from './types.js';
 export interface InternationalizationProviderProps {
     /**
@@ -63,13 +64,30 @@ export interface InternationalizationProviderProps {
      * in sync (e.g. `dir={getLocaleDirection(locale)}` on both).
      */
     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.
+     *
+     * @example
+     * ```
+     * <InternationalizationProvider locale="fa-IR" calendar="persian">
+     * ```
+     */
+    calendar?: CalendarSystem;
     children: ReactNode;
 }
 /**
  * Provides locale + additional messages + overrides to all astryx
  * components in the subtree.
  */
-export declare function InternationalizationProvider({ locale, messages, overrides, dir, children, }: InternationalizationProviderProps): import("react").JSX.Element;
+export declare function InternationalizationProvider({ locale, messages, overrides, dir, calendar: calendarProp, children, }: InternationalizationProviderProps): import("react").JSX.Element;
 export declare namespace InternationalizationProvider {
     var displayName: string;
 }

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;AAG9C,OAAO,KAAK,EACV,MAAM,EAEN,SAAS,EACT,wBAAwB,EACzB,MAAM,SAAS,CAAC;AA0BjB,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,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,EAC3C,MAAM,EACN,QAAQ,EACR,SAAS,EACT,GAAG,EACH,QAAQ,GACT,EAAE,iCAAiC,+BAiBnC;yBAvBe,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;;;;;;;;;;;;;;;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"}

package/dist/i18n/InternationalizationProvider.js

@@ -4,9 +4,9 @@
 
 /**
  * @file InternationalizationProvider.tsx
- * @input React, InternationalizationContext, i18n types
+ * @input React, InternationalizationContext, i18n types, calendar resolution
  * @output Exports InternationalizationProvider component and props type
- * @position Provider component for astryx i18n locale + messages
+ * @position Provider component for astryx i18n locale, messages, and calendar
  *
  * Wraps a subtree with a locale and (optional) additional message catalogs +
  * overrides. Astryx components inside the subtree resolve their strings via
@@ -21,8 +21,10 @@
 import { useMemo } from 'react';
 import { InternationalizationContext } from "./InternationalizationContext.js";
 import { getLocaleDirection } from "./getLocaleDirection.js";
+import { resolveCalendarSystem } from "./useCalendarSystem.js";
 import { getResolve } from "./resolve.js";
 import { jsx as _jsx } from "react/jsx-runtime";
+const PROVIDER_NAME = 'InternationalizationProvider';
 function normalizeMessages(messages) {
   const hasRuntimeCatalog = Object.values(messages).some(catalog => Object.values(catalog).some(entry => typeof entry === 'string'));
   if (!hasRuntimeCatalog) {
@@ -41,19 +43,22 @@ export function InternationalizationProvider({
   messages,
   overrides,
   dir,
+  calendar: calendarProp,
   children
 }) {
   const direction = dir ?? getLocaleDirection(locale);
+  const calendar = useMemo(() => calendarProp != null ? resolveCalendarSystem(calendarProp, PROVIDER_NAME) : 'gregory', [calendarProp]);
   const value = useMemo(() => {
     const providedMessages = messages ?? {};
     return {
       locale,
       direction,
+      calendar,
       messages: normalizeMessages(providedMessages),
       overrides,
       translate: getResolve(locale, providedMessages, overrides)
     };
-  }, [locale, direction, messages, overrides]);
+  }, [locale, direction, calendar, messages, overrides]);
   return /*#__PURE__*/_jsx(InternationalizationContext, {
     value: value,
     children: children

package/dist/i18n/generated-english/hooks/useScrollRegionProps.generated.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @generated by scripts/generate-i18n-runtime.mjs from packages/core/locales/en.json,
+ * holding the English for the catalog keys named in packages/core/src/hooks/useScrollRegionProps.ts.
+ * Do not edit by hand. Run `pnpm generate:i18n-runtime` instead.
+ */
+declare const english: Readonly<Record<string, string>>;
+export default english;
+//# sourceMappingURL=useScrollRegionProps.generated.d.ts.map

package/dist/i18n/generated-english/hooks/useScrollRegionProps.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollRegionProps.generated.d.ts","sourceRoot":"","sources":["../../../../src/i18n/generated-english/hooks/useScrollRegionProps.generated.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,QAAA,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE7C,CAAC;AAEF,eAAe,OAAO,CAAC"}

package/dist/i18n/generated-english/hooks/useScrollRegionProps.generated.js

@@ -0,0 +1,12 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @generated by scripts/generate-i18n-runtime.mjs from packages/core/locales/en.json,
+ * holding the English for the catalog keys named in packages/core/src/hooks/useScrollRegionProps.ts.
+ * Do not edit by hand. Run `pnpm generate:i18n-runtime` instead.
+ */
+
+const english = {
+  "@astryx.scrollRegion.label": "Content"
+};
+export default english;

package/dist/i18n/generated-locales/en.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"en.generated.d.ts","sourceRoot":"","sources":["../../../src/i18n/generated-locales/en.generated.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,QAAA,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAmqBpD,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"en.generated.d.ts","sourceRoot":"","sources":["../../../src/i18n/generated-locales/en.generated.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,QAAA,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoqBpD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/i18n/generated-locales/en.generated.js

@@ -338,6 +338,7 @@ const runtimeCatalog = {
   '@astryx.banner.expand': 'Expand',
   '@astryx.button.loading': 'Loading',
   '@astryx.spinner.loading': 'Loading',
+  '@astryx.scrollRegion.label': 'Content',
   '@astryx.chatComposerDrawer.expand': 'Expand {label}',
   '@astryx.chatComposerDrawer.collapse': 'Collapse {label}',
   '@astryx.chatDictationButton.startDictation': 'Start dictation',

package/dist/i18n/generated-locales/pseudo.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pseudo.generated.d.ts","sourceRoot":"","sources":["../../../src/i18n/generated-locales/pseudo.generated.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,QAAA,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA+qBpD,CAAC;AAEF,eAAe,cAAc,CAAC"}
+{"version":3,"file":"pseudo.generated.d.ts","sourceRoot":"","sources":["../../../src/i18n/generated-locales/pseudo.generated.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,QAAA,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgrBpD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/i18n/generated-locales/pseudo.generated.js

@@ -338,6 +338,7 @@ const runtimeCatalog = {
   '@astryx.banner.expand': '⟦Éẋþàñð⟧',
   '@astryx.button.loading': '⟦Łóàðíñĝ⟧',
   '@astryx.spinner.loading': '⟦Łóàðíñĝ⟧',
+  '@astryx.scrollRegion.label': '⟦Çóñţéñţ⟧',
   '@astryx.chatComposerDrawer.expand': '⟦Éẋþàñð {label}⟧',
   '@astryx.chatComposerDrawer.collapse': '⟦Çółłàþšé {label}⟧',
   '@astryx.chatDictationButton.startDictation': '⟦Šţàřţ ðíçţàţíóñ⟧',

package/dist/i18n/index.d.ts

@@ -13,6 +13,7 @@
  *   - useDirection                — hook returning the ambient text direction
  *   - getLocaleDirection          — server-safe locale → direction helper
  *   - Translator                  — interface for consumer-injected runtimes
+ *   - CalendarSystem              — the calendars date components can show
  *
  * `useTranslator` and `InternationalizationContext` are the public paths
  * that resolve any Astryx key, so they register the whole English catalog.
@@ -36,6 +37,7 @@ export { useLocale } from './useLocale.js';
 export { useCollator } from './useCollator.js';
 export { useDirection } from './useDirection.js';
 export { getLocaleDirection } from './getLocaleDirection.js';
+export type { CalendarSystem } from '../utils/calendarSystem.js';
 export type { Translator } from './translator.js';
 export type { Locale, Catalog, MessageEntry, RuntimeCatalog, MessagesByLocale, ProviderMessagesByLocale, Overrides, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAC;AAC5E,YAAY,EAAC,iCAAiC,EAAC,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAC,2BAA2B,EAAC,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAC,gCAAgC,EAAC,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AACtC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAC7C,YAAY,EACV,MAAM,EACN,OAAO,EACP,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,GACV,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAC,4BAA4B,EAAC,MAAM,gCAAgC,CAAC;AAC5E,YAAY,EAAC,iCAAiC,EAAC,MAAM,gCAAgC,CAAC;AACtF,OAAO,EAAC,2BAA2B,EAAC,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAC,gCAAgC,EAAC,MAAM,+BAA+B,CAAC;AACpF,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAC,SAAS,EAAC,MAAM,aAAa,CAAC;AACtC,OAAO,EAAC,WAAW,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAC,cAAc,EAAC,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AAC7C,YAAY,EACV,MAAM,EACN,OAAO,EACP,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,SAAS,GACV,MAAM,SAAS,CAAC"}

package/dist/i18n/index.js

@@ -15,6 +15,7 @@
  *   - useDirection                — hook returning the ambient text direction
  *   - getLocaleDirection          — server-safe locale → direction helper
  *   - Translator                  — interface for consumer-injected runtimes
+ *   - CalendarSystem              — the calendars date components can show
  *
  * `useTranslator` and `InternationalizationContext` are the public paths
  * that resolve any Astryx key, so they register the whole English catalog.

package/dist/i18n/useCalendarSystem.d.ts

@@ -0,0 +1,19 @@
+import { type CalendarSystem } from '../utils/calendarSystem.js';
+/**
+ * Normalizes a calendar identifier. An identifier outside `CalendarSystem`
+ * resolves to `gregory` and warns once in development.
+ */
+export declare function resolveCalendarSystem(id: string, source: string): CalendarSystem;
+/**
+ * The calendar that a caller names, without the provider: an unknown
+ * identifier, or one this runtime cannot show, becomes `gregory` and warns
+ * once in development.
+ */
+export declare function resolveShownCalendar(calendar: string, source: string): CalendarSystem;
+/**
+ * The calendar a date component shows: its own `calendar`, else the
+ * provider's resolved calendar, else `gregory`. It resolves during render, so
+ * the server and the browser agree when both have `Temporal` or both lack it.
+ */
+export declare function useCalendarSystem(calendar: CalendarSystem | undefined, source: string): CalendarSystem;
+//# sourceMappingURL=useCalendarSystem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCalendarSystem.d.ts","sourceRoot":"","sources":["../../src/i18n/useCalendarSystem.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,KAAK,cAAc,EAGpB,MAAM,yBAAyB,CAAC;AAGjC;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GACb,cAAc,CAUhB;AAyBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,GACb,cAAc,CAKhB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,MAAM,EAAE,MAAM,GACb,cAAc,CAMhB"}

package/dist/i18n/useCalendarSystem.js

@@ -0,0 +1,61 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file useCalendarSystem.ts
+ * @input InternationalizationContext, an optional component `calendar`
+ * @output The calendar system a date component shows, and the helpers that
+ *   normalize a calendar identifier
+ * @position Internal i18n hook; read by InternationalizationProvider, date
+ *   components, and the public calendar hooks. Not re-exported from the i18n
+ *   barrel.
+ */
+import { use } from 'react';
+import { InternationalizationContext } from "./InternationalizationContext.js";
+import { isCalendarSystem, isCalendarSystemAvailable } from "../utils/calendarSystem.js";
+import { warnOnce } from "../utils/devWarning.js";
+
+/**
+ * Normalizes a calendar identifier. An identifier outside `CalendarSystem`
+ * resolves to `gregory` and warns once in development.
+ */
+export function resolveCalendarSystem(id, source) {
+  if (isCalendarSystem(id)) {
+    return id;
+  }
+  warnOnce(`calendar-unsupported:${id}`, source, `The calendar "${id}" is not supported; showing Gregorian dates.`);
+  return 'gregory';
+}
+
+/**
+ * A calendar this runtime can show, else `gregory`. Calendars outside the
+ * Gregorian-aligned set need a `Temporal` that supports them. The fallback
+ * warns once for each calendar, on the server and in the browser.
+ */
+function availableCalendarOrGregorian(calendar, source) {
+  if (isCalendarSystemAvailable(calendar)) {
+    return calendar;
+  }
+  warnOnce(`calendar-unavailable:${calendar}`, source, `The "${calendar}" calendar needs a Temporal that supports it, and this ` + 'runtime has none; showing Gregorian dates. Load a Temporal polyfill ' + "with every calendar, such as 'temporal-polyfill/full/global', on the " + 'server and in the browser.');
+  return 'gregory';
+}
+
+/**
+ * The calendar that a caller names, without the provider: an unknown
+ * identifier, or one this runtime cannot show, becomes `gregory` and warns
+ * once in development.
+ */
+export function resolveShownCalendar(calendar, source) {
+  return availableCalendarOrGregorian(resolveCalendarSystem(calendar, source), source);
+}
+
+/**
+ * The calendar a date component shows: its own `calendar`, else the
+ * provider's resolved calendar, else `gregory`. It resolves during render, so
+ * the server and the browser agree when both have `Temporal` or both lack it.
+ */
+export function useCalendarSystem(calendar, source) {
+  const context = use(InternationalizationContext);
+  return resolveShownCalendar(calendar ?? context.calendar ?? 'gregory', source);
+}

package/dist/internal/spinner-rotor.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file spinner-rotor.ts
+ * @input Spinner's shared rotor
+ * @output `@astryxdesign/core/internal/spinner-rotor`: SPINNER_ARC_FRACTION,
+ *   spinnerRotorStyles and syncRotationPhase, re-exported by name for Lab's
+ *   indeterminate CircularProgress
+ * @position An internal entry reserved for Astryx's own packages. It is
+ *   undocumented, outside the public API and its compatibility promise, and
+ *   versioned in lockstep with Core. The `@astryx/no-core-internal-import`
+ *   lint rule allows it only in Core and Lab. Core components import the
+ *   same modules by relative path. Named re-exports only.
+ *
+ * SYNC: When modified, update scripts/sync-exports.js.
+ */
+export { SPINNER_ARC_FRACTION, spinnerRotorStyles, syncRotationPhase, } from '../Spinner/spinnerRotor.js';
+//# sourceMappingURL=spinner-rotor.d.ts.map

package/dist/internal/spinner-rotor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner-rotor.d.ts","sourceRoot":"","sources":["../../src/internal/spinner-rotor.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AACH,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC"}