@react-aria/toast 3.0.11 → 3.1.0

package/dist/zh-TW.main.js.map

@@ -1 +0,0 @@
-{"mappings":"AAAA,iBAAiB;IAAG,SAAS,CAAC,gBAAE,CAAC;IAC/B,iBAAiB,CAAC,MAAM,YAAc,GAAG,UAAU,MAAM,CAAC,KAAK,KAAK,EAAE;YAAC,KAAK,IAAM,GAAG,UAAU,MAAM,CAAC,KAAK,KAAK,EAAE,yBAAI,CAAC;YAAE,OAAO,IAAM,GAAG,UAAU,MAAM,CAAC,KAAK,KAAK,EAAE,yBAAI,CAAC;QAAA,GAAG,QAAC,CAAC;AAClL","sources":["packages/@react-aria/toast/intl/zh-TW.json"],"sourcesContent":["{\n  \"close\": \"關閉\",\n  \"notifications\": \"{count, plural, one {# 個通知} other {# 個通知}}。\"\n}\n"],"names":[],"version":3,"file":"zh-TW.main.js.map"}

package/dist/zh-TW.mjs

@@ -1,12 +0,0 @@
-var $52e8b1b00094e5a3$exports = {};
-$52e8b1b00094e5a3$exports = {
-    "close": `\u{95DC}\u{9589}`,
-    "notifications": (args, formatter)=>`${formatter.plural(args.count, {
-            one: ()=>`${formatter.number(args.count)} \u{500B}\u{901A}\u{77E5}`,
-            other: ()=>`${formatter.number(args.count)} \u{500B}\u{901A}\u{77E5}`
-        })}\u{3002}`
-};
-
-
-export {$52e8b1b00094e5a3$exports as default};
-//# sourceMappingURL=zh-TW.module.js.map

package/dist/zh-TW.module.js

@@ -1,12 +0,0 @@
-var $52e8b1b00094e5a3$exports = {};
-$52e8b1b00094e5a3$exports = {
-    "close": `\u{95DC}\u{9589}`,
-    "notifications": (args, formatter)=>`${formatter.plural(args.count, {
-            one: ()=>`${formatter.number(args.count)} \u{500B}\u{901A}\u{77E5}`,
-            other: ()=>`${formatter.number(args.count)} \u{500B}\u{901A}\u{77E5}`
-        })}\u{3002}`
-};
-
-
-export {$52e8b1b00094e5a3$exports as default};
-//# sourceMappingURL=zh-TW.module.js.map

package/dist/zh-TW.module.js.map

@@ -1 +0,0 @@
-{"mappings":";AAAA,4BAAiB;IAAG,SAAS,CAAC,gBAAE,CAAC;IAC/B,iBAAiB,CAAC,MAAM,YAAc,GAAG,UAAU,MAAM,CAAC,KAAK,KAAK,EAAE;YAAC,KAAK,IAAM,GAAG,UAAU,MAAM,CAAC,KAAK,KAAK,EAAE,yBAAI,CAAC;YAAE,OAAO,IAAM,GAAG,UAAU,MAAM,CAAC,KAAK,KAAK,EAAE,yBAAI,CAAC;QAAA,GAAG,QAAC,CAAC;AAClL","sources":["packages/@react-aria/toast/intl/zh-TW.json"],"sourcesContent":["{\n  \"close\": \"關閉\",\n  \"notifications\": \"{count, plural, one {# 個通知} other {# 個通知}}。\"\n}\n"],"names":[],"version":3,"file":"zh-TW.module.js.map"}

package/src/useToast.ts

@@ -1,102 +0,0 @@
-/*
- * Copyright 2020 Adobe. All rights reserved.
- * This file is licensed to you under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License. You may obtain a copy
- * of the License at http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software distributed under
- * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
- * OF ANY KIND, either express or implied. See the License for the specific language
- * governing permissions and limitations under the License.
- */
-
-import {AriaButtonProps} from '@react-types/button';
-import {AriaLabelingProps, DOMAttributes, FocusableElement, RefObject} from '@react-types/shared';
-import {filterDOMProps, useId, useLayoutEffect, useSlotId} from '@react-aria/utils';
-// @ts-ignore
-import intlMessages from '../intl/*.json';
-import {QueuedToast, ToastState} from '@react-stately/toast';
-import {useEffect, useState} from 'react';
-import {useLocalizedStringFormatter} from '@react-aria/i18n';
-
-export interface AriaToastProps<T> extends AriaLabelingProps {
-  /** The toast object. */
-  toast: QueuedToast<T>
-}
-
-export interface ToastAria {
-  /** Props for the toast container, non-modal dialog element. */
-  toastProps: DOMAttributes,
-  /** Props for the toast content alert message. */
-  contentProps: DOMAttributes,
-  /** Props for the toast title element. */
-  titleProps: DOMAttributes,
-  /** Props for the toast description element, if any. */
-  descriptionProps: DOMAttributes,
-  /** Props for the toast close button. */
-  closeButtonProps: AriaButtonProps
-}
-
-/**
- * Provides the behavior and accessibility implementation for a toast component.
- * Toasts display brief, temporary notifications of actions, errors, or other events in an application.
- */
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-export function useToast<T>(props: AriaToastProps<T>, state: ToastState<T>, ref: RefObject<FocusableElement | null>): ToastAria {
-  let {
-    key,
-    timer,
-    timeout
-  } = props.toast;
-
-  useEffect(() => {
-    if (timer == null || timeout == null) {
-      return;
-    }
-
-    timer.reset(timeout);
-    return () => {
-      timer.pause();
-    };
-  }, [timer, timeout]);
-
-  let titleId = useId();
-  let descriptionId = useSlotId();
-  let stringFormatter = useLocalizedStringFormatter(intlMessages, '@react-aria/toast');
-
-  // This is required for NVDA announcements, without it NVDA will NOT announce the toast when it appears.
-  // Originally was tied to animationStart/End via https://github.com/adobe/react-spectrum/pull/6223/commits/e22e319df64958e822ab7cd9685e96818cae9ba5
-  // but toasts don't always have animations.
-  let [isVisible, setIsVisible] = useState(false);
-  useLayoutEffect(() => {
-    setIsVisible(true);
-  }, []);
-
-  let toastProps = filterDOMProps(props, {labelable: true});
-
-  return {
-    toastProps: {
-      ...toastProps,
-      role: 'alertdialog',
-      'aria-modal': 'false',
-      'aria-labelledby': props['aria-labelledby'] || titleId,
-      'aria-describedby': props['aria-describedby'] || descriptionId,
-      tabIndex: 0
-    },
-    contentProps: {
-      role: 'alert',
-      'aria-atomic': 'true',
-      'aria-hidden': isVisible ? undefined : 'true'
-    },
-    titleProps: {
-      id: titleId
-    },
-    descriptionProps: {
-      id: descriptionId
-    },
-    closeButtonProps: {
-      'aria-label': stringFormatter.format('close'),
-      onPress: () => state.close(key)
-    }
-  };
-}

package/src/useToastRegion.ts

@@ -1,201 +0,0 @@
-/*
- * Copyright 2025 Adobe. All rights reserved.
- * This file is licensed to you under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License. You may obtain a copy
- * of the License at http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software distributed under
- * the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR REPRESENTATIONS
- * OF ANY KIND, either express or implied. See the License for the specific language
- * governing permissions and limitations under the License.
- */
-
-import {AriaLabelingProps, DOMAttributes, FocusableElement, RefObject} from '@react-types/shared';
-import {focusWithoutScrolling, getEventTarget, mergeProps, useLayoutEffect} from '@react-aria/utils';
-import {getInteractionModality, useFocusWithin, useHover} from '@react-aria/interactions';
-// @ts-ignore
-import intlMessages from '../intl/*.json';
-import {ToastState} from '@react-stately/toast';
-import {useCallback, useEffect, useRef} from 'react';
-import {useLandmark} from '@react-aria/landmark';
-import {useLocalizedStringFormatter} from '@react-aria/i18n';
-
-export interface AriaToastRegionProps extends AriaLabelingProps {
-  /**
-   * An accessibility label for the toast region.
-   * @default "Notifications"
-   */
-  'aria-label'?: string
-}
-
-export interface ToastRegionAria {
-  /** Props for the landmark region element. */
-  regionProps: DOMAttributes
-}
-
-/**
- * Provides the behavior and accessibility implementation for a toast region containing one or more toasts.
- * Toasts display brief, temporary notifications of actions, errors, or other events in an application.
- */
-export function useToastRegion<T>(props: AriaToastRegionProps, state: ToastState<T>, ref: RefObject<HTMLElement | null>): ToastRegionAria {
-  let stringFormatter = useLocalizedStringFormatter(intlMessages, '@react-aria/toast');
-  let {landmarkProps} = useLandmark({
-    role: 'region',
-    'aria-label': props['aria-label'] || stringFormatter.format('notifications', {count: state.visibleToasts.length})
-  }, ref);
-
-  let isHovered = useRef(false);
-  let isFocused = useRef(false);
-  let updateTimers = useCallback(() => {
-    if (isHovered.current || isFocused.current) {
-      state.pauseAll();
-    } else {
-      state.resumeAll();
-    }
-  }, [state]);
-
-  let {hoverProps} = useHover({
-    onHoverStart: () => {
-      isHovered.current = true;
-      updateTimers();
-    },
-    onHoverEnd: () => {
-      isHovered.current = false;
-      updateTimers();
-    }
-  });
-
-  // Manage focus within the toast region.
-  // If a focused containing toast is removed, move focus to the next toast, or the previous toast if there is no next toast.
-  let toasts = useRef<FocusableElement[]>([]);
-  let prevVisibleToasts = useRef(state.visibleToasts);
-  let focusedToast = useRef<number | null>(null);
-  useLayoutEffect(() => {
-    // If no toast has focus, then don't do anything.
-    if (focusedToast.current === -1 || state.visibleToasts.length === 0 || !ref.current) {
-      toasts.current = [];
-      prevVisibleToasts.current = state.visibleToasts;
-      return;
-    }
-    toasts.current = [...ref.current.querySelectorAll('[role="alertdialog"]')] as FocusableElement[];
-    // If the visible toasts haven't changed, we don't need to do anything.
-    if (prevVisibleToasts.current.length === state.visibleToasts.length
-      && state.visibleToasts.every((t, i) => t.key === prevVisibleToasts.current[i].key)) {
-      prevVisibleToasts.current = state.visibleToasts;
-      return;
-    }
-    // Get a list of all toasts by index and add info if they are removed.
-    let allToasts = prevVisibleToasts.current
-      .map((t, i) => ({
-        ...t,
-        i,
-        isRemoved: !state.visibleToasts.some(t2 => t.key === t2.key)
-      }));
-
-    let removedFocusedToastIndex = allToasts.findIndex(t => t.i === focusedToast.current && t.isRemoved);
-
-    // If the focused toast was removed, focus the next or previous toast.
-    if (removedFocusedToastIndex > -1) {
-      // In pointer modality, move focus out of the toast region.
-      // Otherwise auto-dismiss timers will appear "stuck".
-      if (getInteractionModality() === 'pointer' && lastFocused.current?.isConnected) {
-        focusWithoutScrolling(lastFocused.current);
-      } else {
-        let i = 0;
-        let nextToast;
-        let prevToast;
-        while (i <= removedFocusedToastIndex) {
-          if (!allToasts[i].isRemoved) {
-            prevToast = Math.max(0, i - 1);
-          }
-          i++;
-        }
-        while (i < allToasts.length) {
-          if (!allToasts[i].isRemoved) {
-            nextToast = i - 1;
-            break;
-          }
-          i++;
-        }
-
-        // in the case where it's one toast at a time, both will be undefined, but we know the index must be 0
-        if (prevToast === undefined && nextToast === undefined) {
-          prevToast = 0;
-        }
-
-        // prioritize going to newer toasts
-        if (prevToast >= 0 && prevToast < toasts.current.length) {
-          focusWithoutScrolling(toasts.current[prevToast]);
-        } else if (nextToast >= 0 && nextToast < toasts.current.length) {
-          focusWithoutScrolling(toasts.current[nextToast]);
-        }
-      }
-    }
-
-    prevVisibleToasts.current = state.visibleToasts;
-  }, [state.visibleToasts, ref]);
-
-  let lastFocused = useRef<FocusableElement | null>(null);
-  let {focusWithinProps} = useFocusWithin({
-    onFocusWithin: (e) => {
-      isFocused.current = true;
-      lastFocused.current = e.relatedTarget as FocusableElement;
-      updateTimers();
-    },
-    onBlurWithin: () => {
-      isFocused.current = false;
-      lastFocused.current = null;
-      updateTimers();
-    }
-  });
-
-  // When the number of visible toasts becomes 0 or the region unmounts,
-  // restore focus to the last element that had focus before the user moved focus
-  // into the region. FocusScope restore focus doesn't update whenever the focus
-  // moves in, it only happens once, so we correct it.
-  // Because we're in a hook, we can't control if the user unmounts or not.
-  useEffect(() => {
-    if (state.visibleToasts.length === 0 && lastFocused.current?.isConnected) {
-      if (getInteractionModality() === 'pointer') {
-        focusWithoutScrolling(lastFocused.current);
-      } else {
-        lastFocused.current.focus();
-      }
-      lastFocused.current = null;
-    }
-  }, [ref, state.visibleToasts.length]);
-
-  useEffect(() => {
-    return () => {
-      if (lastFocused.current?.isConnected) {
-        if (getInteractionModality() === 'pointer') {
-          focusWithoutScrolling(lastFocused.current);
-        } else {
-          lastFocused.current.focus();
-        }
-        lastFocused.current = null;
-      }
-    };
-  }, [ref]);
-
-  return {
-    regionProps: mergeProps(landmarkProps, hoverProps, focusWithinProps, {
-      tabIndex: -1,
-      // Mark the toast region as a "top layer", so that it:
-      //   - is not aria-hidden when opening an overlay
-      //   - allows focus even outside a containing focus scope
-      //   - doesn’t dismiss overlays when clicking on it, even though it is outside
-      // @ts-ignore
-      'data-react-aria-top-layer': true,
-      // listen to focus events separate from focuswithin because that will only fire once
-      // and we need to follow all focus changes
-      onFocus: (e) => {
-        let target = (getEventTarget(e) as Element).closest('[role="alertdialog"]');
-        focusedToast.current = toasts.current.findIndex(t => t === target);
-      },
-      onBlur: () => {
-        focusedToast.current = -1;
-      }
-    })
-  };
-}