@capra/core 1.5.0 → 1.5.2

package/dist/index.d.cts

@@ -2,6 +2,7 @@ import * as React$2 from "react";
 import React$1, { HTMLAttributeAnchorTarget, HTMLAttributeReferrerPolicy } from "react";
 import { BreadcrumbProps as BreadcrumbProps$1, BreadcrumbsProps as BreadcrumbsProps$1, ButtonProps as ButtonProps$1, ComboBoxRenderProps, DatePickerProps, DateRangePickerProps, DateValue, DisclosureProps, Focusable, LinkProps as LinkProps$1, ListBoxItemProps, PopoverProps as PopoverProps$1, RouterProvider } from "react-aria-components";
 import { SvgIcon } from "@capra/icons";
+import { SvgLogo } from "@capra/icons/logos";
 
 //#region src/utils/stylingOverride.d.ts
 interface StylingOverrideProps {
@@ -124,7 +125,7 @@ declare const TextInput: React$2.ForwardRefExoticComponent<{
    */
   size?: Size$3; /** Content after the input (e.g. icon or clear button). */
   trailingSlot?: React$2.ReactNode;
-} & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "style" | "className" | "size"> & React$2.RefAttributes<HTMLInputElement>>;
+} & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "style" | "size" | "className"> & React$2.RefAttributes<HTMLInputElement>>;
 //#endregion
 //#region src/components/input-helpers/fieldLayout.d.ts
 type FieldLayoutProps = {
@@ -171,7 +172,7 @@ declare const AutocompleteField: ((props: {
   leadingSlot?: React$1.ReactNode;
   size?: Size$3;
   trailingSlot?: React$1.ReactNode;
-} & StylingOverrideProps & Omit<Omit<React$1.DetailedHTMLProps<React$1.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "style" | "className" | "size"> & React$1.RefAttributes<HTMLInputElement>, "ref">, "onChange" | "value"> & React$1.RefAttributes<HTMLInputElement>) => React$1.ReactElement) & {
+} & StylingOverrideProps & Omit<Omit<React$1.DetailedHTMLProps<React$1.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "style" | "size" | "className"> & React$1.RefAttributes<HTMLInputElement>, "ref">, "value" | "onChange"> & React$1.RefAttributes<HTMLInputElement>) => React$1.ReactElement) & {
   Item: typeof AutocompleteItem;
 };
 //#endregion
@@ -428,7 +429,7 @@ type RadioGroupProps = RadioGroupContextValue & StylingOverrideProps & Omit<Reac
 /**
  * A control wrapper for a group of radio buttons.
  */
-declare const RadioGroup: (props: RadioGroupContextValue & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement>, "ref">, "className" | "onChange"> & React$2.RefAttributes<HTMLFieldSetElement>) => React$2.ReactElement;
+declare const RadioGroup: (props: RadioGroupContextValue & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement>, "ref">, "onChange" | "className"> & React$2.RefAttributes<HTMLFieldSetElement>) => React$2.ReactElement;
 //#endregion
 //#region src/components/Radio/Radio.d.ts
 type ChildrenLabel = {
@@ -510,9 +511,9 @@ type TagProps = DraggableProps & {
    */
   color?: TagColor;
   /**
-   * The icon to display in the tag.
+   * The icon or logo to display in the tag.
    */
-  icon?: SvgIcon;
+  icon?: SvgIcon | SvgLogo;
   /**
    * The label text to display in the tag.
    */
@@ -561,7 +562,7 @@ declare const Checkbox: React$2.ForwardRefExoticComponent<{
   checked?: boolean; /** Default checked state for uncontrolled component. */
   defaultChecked?: boolean; /** The label for the checkbox. */
   children?: string | React$2.ReactNode;
-} & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "className" | "type"> & React$2.RefAttributes<HTMLInputElement>>;
+} & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "type" | "className"> & React$2.RefAttributes<HTMLInputElement>>;
 //#endregion
 //#region src/components/Collapse/Collapse.d.ts
 /** Props forwarded to React Aria `Disclosure`; see https://reactaria.adobe.com/Disclosure */
@@ -635,7 +636,7 @@ declare const TextField: React$2.ForwardRefExoticComponent<{
   /** Called with the new string value when the input changes. */onChange?: (value: string) => void; /** When true, shows a character count. */
   showCount?: boolean;
   value?: string | number | undefined;
-} & FieldLayoutProps & Omit<TextInputProps, "onChange" | "value"> & React$2.RefAttributes<HTMLInputElement>>;
+} & FieldLayoutProps & Omit<TextInputProps, "value" | "onChange"> & React$2.RefAttributes<HTMLInputElement>>;
 //#endregion
 //#region src/components/PasswordField/PasswordField.d.ts
 type PasswordFieldProps = Omit<TextFieldProps, 'trailingSlot' | 'type'>;
@@ -659,7 +660,7 @@ type NumberFieldProps = Omit<TextInputProps, 'type' | 'onChange' | 'min' | 'max'
 /**
  * Number field built on React Aria `NumberField`, with custom increment/decrement controls (native spinners hidden).
  */
-declare const NumberField: React$2.ForwardRefExoticComponent<Omit<TextInputProps, "onChange" | "max" | "min" | "type" | "step"> & {
+declare const NumberField: React$2.ForwardRefExoticComponent<Omit<TextInputProps, "max" | "min" | "step" | "type" | "onChange"> & {
   /** Called with the unformatted number value when the number changes. */onChange?: (value: number) => void; /** Locale-aware display and parsing for the displayed value (see https://react-aria.adobe.com/NumberField#format-options) */
   formatOptions?: Intl.NumberFormatOptions; /** Minimum value */
   min?: number; /** Maximum value */
@@ -681,7 +682,7 @@ type DatePickerFieldProps<T extends DateValue = DateValue> = FieldLayoutProps &
   required?: boolean; /** Invalid value; `appearance="danger"` also forces an invalid state for display. */
   isInvalid?: boolean;
 };
-declare const DatePickerField: React$2.ForwardRefExoticComponent<FieldLayoutProps & Pick<TextInputProps, "placeholder" | "size" | "appearance" | "leadingSlot"> & Pick<DatePickerProps<DateValue>, "defaultValue" | "onChange" | "value"> & {
+declare const DatePickerField: React$2.ForwardRefExoticComponent<FieldLayoutProps & Pick<TextInputProps, "placeholder" | "size" | "appearance" | "leadingSlot"> & Pick<DatePickerProps<DateValue>, "value" | "onChange" | "defaultValue"> & {
   /** Smallest date/time unit shown in the field. Only `day` and `second` are supported. */granularity?: "day" | "second";
 } & StylingOverrideProps & {
   /** When true, shows a clear control to the left of the calendar button while the field has a value. */canClear?: boolean; /** Disables the field. */
@@ -709,7 +710,7 @@ type DateRangePickerFieldProps<T extends DateValue = DateValue> = FieldLayoutPro
 };
 declare const DateRangePickerField: React$2.ForwardRefExoticComponent<FieldLayoutProps & Pick<TextInputProps, "size" | "appearance" | "leadingSlot"> & {
   /** Placeholders for empty start and end, shown with a swap icon between them when the group is not focus-within. */placeholder?: DateRangePickerFieldPlaceholder;
-} & Pick<DateRangePickerProps<DateValue>, "defaultValue" | "onChange" | "value" | "shouldCloseOnSelect"> & {
+} & Pick<DateRangePickerProps<DateValue>, "value" | "onChange" | "defaultValue" | "shouldCloseOnSelect"> & {
   /** Smallest date/time unit shown in the fields. Only `day` and `second` are supported. */granularity?: "day" | "second";
 } & StylingOverrideProps & {
   /** When true, shows a clear control to the left of the calendar button while the field has a value. */canClear?: boolean; /** Disables the field. */
@@ -769,7 +770,7 @@ declare const TextArea: React$2.ForwardRefExoticComponent<{
   autoSize?: TextAreaAutoSize; /** When true, shows a character count. */
   showCount?: boolean; /** Called with the new string value when the input changes. */
   onChange?: (value: string) => void;
-} & FieldLayoutProps & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.TextareaHTMLAttributes<HTMLTextAreaElement>, HTMLTextAreaElement>, "ref">, "style" | "className" | "onChange" | "size"> & React$2.RefAttributes<HTMLTextAreaElement>>;
+} & FieldLayoutProps & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.TextareaHTMLAttributes<HTMLTextAreaElement>, HTMLTextAreaElement>, "ref">, "style" | "size" | "onChange" | "className"> & React$2.RefAttributes<HTMLTextAreaElement>>;
 //#endregion
 //#region src/components/Modal/Modal.d.ts
 type ModalSize = 'sm' | 'md' | 'lg';
@@ -867,7 +868,7 @@ type DrawerProps = {
   isOpen?: boolean;
   /**
    * Called when the drawer should close: header dismiss, footer actions you wire up, scrim click (when a scrim is
-   * shown), Escape, or browser Back.
+   * shown), or Escape.
    */
   onClose?: (event?: React$2.MouseEvent | React$2.KeyboardEvent) => void; /** Called when the drawer open state changes (after render). */
   onOpenChange?: (isOpen: boolean) => void;
@@ -1878,6 +1879,12 @@ interface MenuProps extends StylingOverrideProps {
    * @default 0
    */
   popoverOffset?: number;
+  /**
+   * When `true`, focus is contained in the menu panel while it is open (Tab cycles within the panel; focus restores on close).
+   * The popover stays non-modal so outside pointer dismiss still works. Use for patterns that must not move focus to sibling controls until the menu closes (e.g. horizontal TabNav flyouts).
+   * @default false
+   */
+  trapFocus?: boolean;
 }
 /** Inset of the menu panel relative to the popover shell. */
 type MenuPanelPadding = NonNullable<MenuProps['panelPadding']>;
@@ -1893,6 +1900,7 @@ declare const Menu: {
     itemActiveLabelSemibold,
     panelPadding,
     popoverOffset,
+    trapFocus,
     FORCE__className: classNameOverride
   }: MenuProps): React$2.JSX.Element;
   displayName: string;

package/dist/index.d.mts

@@ -2,6 +2,7 @@ import * as React$2 from "react";
 import React$1, { HTMLAttributeAnchorTarget, HTMLAttributeReferrerPolicy } from "react";
 import { SvgIcon } from "@capra/icons";
 import { BreadcrumbProps as BreadcrumbProps$1, BreadcrumbsProps as BreadcrumbsProps$1, ButtonProps as ButtonProps$1, ComboBoxRenderProps, DatePickerProps, DateRangePickerProps, DateValue, DisclosureProps, Focusable, LinkProps as LinkProps$1, ListBoxItemProps, PopoverProps as PopoverProps$1, RouterProvider } from "react-aria-components";
+import { SvgLogo } from "@capra/icons/logos";
 
 //#region src/utils/stylingOverride.d.ts
 interface StylingOverrideProps {
@@ -124,7 +125,7 @@ declare const TextInput: React$2.ForwardRefExoticComponent<{
    */
   size?: Size$3; /** Content after the input (e.g. icon or clear button). */
   trailingSlot?: React$2.ReactNode;
-} & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "style" | "className" | "size"> & React$2.RefAttributes<HTMLInputElement>>;
+} & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "style" | "size" | "className"> & React$2.RefAttributes<HTMLInputElement>>;
 //#endregion
 //#region src/components/input-helpers/fieldLayout.d.ts
 type FieldLayoutProps = {
@@ -171,7 +172,7 @@ declare const AutocompleteField: ((props: {
   leadingSlot?: React$1.ReactNode;
   size?: Size$3;
   trailingSlot?: React$1.ReactNode;
-} & StylingOverrideProps & Omit<Omit<React$1.DetailedHTMLProps<React$1.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "style" | "className" | "size"> & React$1.RefAttributes<HTMLInputElement>, "ref">, "onChange" | "value"> & React$1.RefAttributes<HTMLInputElement>) => React$1.ReactElement) & {
+} & StylingOverrideProps & Omit<Omit<React$1.DetailedHTMLProps<React$1.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "style" | "size" | "className"> & React$1.RefAttributes<HTMLInputElement>, "ref">, "value" | "onChange"> & React$1.RefAttributes<HTMLInputElement>) => React$1.ReactElement) & {
   Item: typeof AutocompleteItem;
 };
 //#endregion
@@ -428,7 +429,7 @@ type RadioGroupProps = RadioGroupContextValue & StylingOverrideProps & Omit<Reac
 /**
  * A control wrapper for a group of radio buttons.
  */
-declare const RadioGroup: (props: RadioGroupContextValue & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement>, "ref">, "className" | "onChange"> & React$2.RefAttributes<HTMLFieldSetElement>) => React$2.ReactElement;
+declare const RadioGroup: (props: RadioGroupContextValue & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.FieldsetHTMLAttributes<HTMLFieldSetElement>, HTMLFieldSetElement>, "ref">, "onChange" | "className"> & React$2.RefAttributes<HTMLFieldSetElement>) => React$2.ReactElement;
 //#endregion
 //#region src/components/Radio/Radio.d.ts
 type ChildrenLabel = {
@@ -510,9 +511,9 @@ type TagProps = DraggableProps & {
    */
   color?: TagColor;
   /**
-   * The icon to display in the tag.
+   * The icon or logo to display in the tag.
    */
-  icon?: SvgIcon;
+  icon?: SvgIcon | SvgLogo;
   /**
    * The label text to display in the tag.
    */
@@ -561,7 +562,7 @@ declare const Checkbox: React$2.ForwardRefExoticComponent<{
   checked?: boolean; /** Default checked state for uncontrolled component. */
   defaultChecked?: boolean; /** The label for the checkbox. */
   children?: string | React$2.ReactNode;
-} & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "className" | "type"> & React$2.RefAttributes<HTMLInputElement>>;
+} & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "type" | "className"> & React$2.RefAttributes<HTMLInputElement>>;
 //#endregion
 //#region src/components/Collapse/Collapse.d.ts
 /** Props forwarded to React Aria `Disclosure`; see https://reactaria.adobe.com/Disclosure */
@@ -635,7 +636,7 @@ declare const TextField: React$2.ForwardRefExoticComponent<{
   /** Called with the new string value when the input changes. */onChange?: (value: string) => void; /** When true, shows a character count. */
   showCount?: boolean;
   value?: string | number | undefined;
-} & FieldLayoutProps & Omit<TextInputProps, "onChange" | "value"> & React$2.RefAttributes<HTMLInputElement>>;
+} & FieldLayoutProps & Omit<TextInputProps, "value" | "onChange"> & React$2.RefAttributes<HTMLInputElement>>;
 //#endregion
 //#region src/components/PasswordField/PasswordField.d.ts
 type PasswordFieldProps = Omit<TextFieldProps, 'trailingSlot' | 'type'>;
@@ -659,7 +660,7 @@ type NumberFieldProps = Omit<TextInputProps, 'type' | 'onChange' | 'min' | 'max'
 /**
  * Number field built on React Aria `NumberField`, with custom increment/decrement controls (native spinners hidden).
  */
-declare const NumberField: React$2.ForwardRefExoticComponent<Omit<TextInputProps, "onChange" | "max" | "min" | "type" | "step"> & {
+declare const NumberField: React$2.ForwardRefExoticComponent<Omit<TextInputProps, "max" | "min" | "step" | "type" | "onChange"> & {
   /** Called with the unformatted number value when the number changes. */onChange?: (value: number) => void; /** Locale-aware display and parsing for the displayed value (see https://react-aria.adobe.com/NumberField#format-options) */
   formatOptions?: Intl.NumberFormatOptions; /** Minimum value */
   min?: number; /** Maximum value */
@@ -681,7 +682,7 @@ type DatePickerFieldProps<T extends DateValue = DateValue> = FieldLayoutProps &
   required?: boolean; /** Invalid value; `appearance="danger"` also forces an invalid state for display. */
   isInvalid?: boolean;
 };
-declare const DatePickerField: React$2.ForwardRefExoticComponent<FieldLayoutProps & Pick<TextInputProps, "placeholder" | "size" | "appearance" | "leadingSlot"> & Pick<DatePickerProps<DateValue>, "defaultValue" | "onChange" | "value"> & {
+declare const DatePickerField: React$2.ForwardRefExoticComponent<FieldLayoutProps & Pick<TextInputProps, "placeholder" | "size" | "appearance" | "leadingSlot"> & Pick<DatePickerProps<DateValue>, "value" | "onChange" | "defaultValue"> & {
   /** Smallest date/time unit shown in the field. Only `day` and `second` are supported. */granularity?: "day" | "second";
 } & StylingOverrideProps & {
   /** When true, shows a clear control to the left of the calendar button while the field has a value. */canClear?: boolean; /** Disables the field. */
@@ -709,7 +710,7 @@ type DateRangePickerFieldProps<T extends DateValue = DateValue> = FieldLayoutPro
 };
 declare const DateRangePickerField: React$2.ForwardRefExoticComponent<FieldLayoutProps & Pick<TextInputProps, "size" | "appearance" | "leadingSlot"> & {
   /** Placeholders for empty start and end, shown with a swap icon between them when the group is not focus-within. */placeholder?: DateRangePickerFieldPlaceholder;
-} & Pick<DateRangePickerProps<DateValue>, "defaultValue" | "onChange" | "value" | "shouldCloseOnSelect"> & {
+} & Pick<DateRangePickerProps<DateValue>, "value" | "onChange" | "defaultValue" | "shouldCloseOnSelect"> & {
   /** Smallest date/time unit shown in the fields. Only `day` and `second` are supported. */granularity?: "day" | "second";
 } & StylingOverrideProps & {
   /** When true, shows a clear control to the left of the calendar button while the field has a value. */canClear?: boolean; /** Disables the field. */
@@ -769,7 +770,7 @@ declare const TextArea: React$2.ForwardRefExoticComponent<{
   autoSize?: TextAreaAutoSize; /** When true, shows a character count. */
   showCount?: boolean; /** Called with the new string value when the input changes. */
   onChange?: (value: string) => void;
-} & FieldLayoutProps & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.TextareaHTMLAttributes<HTMLTextAreaElement>, HTMLTextAreaElement>, "ref">, "style" | "className" | "onChange" | "size"> & React$2.RefAttributes<HTMLTextAreaElement>>;
+} & FieldLayoutProps & StylingOverrideProps & Omit<Omit<React$2.DetailedHTMLProps<React$2.TextareaHTMLAttributes<HTMLTextAreaElement>, HTMLTextAreaElement>, "ref">, "style" | "size" | "onChange" | "className"> & React$2.RefAttributes<HTMLTextAreaElement>>;
 //#endregion
 //#region src/components/Modal/Modal.d.ts
 type ModalSize = 'sm' | 'md' | 'lg';
@@ -867,7 +868,7 @@ type DrawerProps = {
   isOpen?: boolean;
   /**
    * Called when the drawer should close: header dismiss, footer actions you wire up, scrim click (when a scrim is
-   * shown), Escape, or browser Back.
+   * shown), or Escape.
    */
   onClose?: (event?: React$2.MouseEvent | React$2.KeyboardEvent) => void; /** Called when the drawer open state changes (after render). */
   onOpenChange?: (isOpen: boolean) => void;
@@ -1878,6 +1879,12 @@ interface MenuProps extends StylingOverrideProps {
    * @default 0
    */
   popoverOffset?: number;
+  /**
+   * When `true`, focus is contained in the menu panel while it is open (Tab cycles within the panel; focus restores on close).
+   * The popover stays non-modal so outside pointer dismiss still works. Use for patterns that must not move focus to sibling controls until the menu closes (e.g. horizontal TabNav flyouts).
+   * @default false
+   */
+  trapFocus?: boolean;
 }
 /** Inset of the menu panel relative to the popover shell. */
 type MenuPanelPadding = NonNullable<MenuProps['panelPadding']>;
@@ -1893,6 +1900,7 @@ declare const Menu: {
     itemActiveLabelSemibold,
     panelPadding,
     popoverOffset,
+    trapFocus,
     FORCE__className: classNameOverride
   }: MenuProps): React$2.JSX.Element;
   displayName: string;