@cdx-ui/primitives 0.1.6 → 0.1.7

package/src/progress-bar/types.ts

@@ -5,17 +5,22 @@ export type ProgressDataState = 'complete' | 'indeterminate' | 'loading';
 
 export interface InterfaceProgressProps extends Omit<ViewProps, 'children'> {
   /**
-   * Current value in the range [0, max], or `null` for indeterminate progress.
-   * Omit or use a number for determinate progress; default is `0`.
+   * Current value in the range `[0, max]`, or `null` for indeterminate progress.
+   * Values below `0` clamp to `0`; values above `max` clamp to `max`.
+   * Non-finite values (such as `NaN`) are treated as `0`.
+   * @default 0
    */
   readonly value?: number | null;
   /**
-   * Maximum value (minimum is always 0).
+   * Maximum value. The minimum is always `0`.
+   * A `max` of `0` or less is treated as complete.
    * @default 100
    */
   readonly max?: number;
   /**
-   * Optional label for `accessibilityValue.text` when determinate.
+   * Screen-reader text for determinate progress (`accessibilityValue.text`).
+   * Defaults to a rounded percentage of `max`, such as `"45%"`.
+   * No effect when `value` is `null`, or when `accessibilityValue` is set.
    */
   readonly getValueLabel?: (value: number, max: number) => string;
   readonly children?: ReactNode;

package/src/radio/types.ts

@@ -3,8 +3,10 @@ import type { PressableProps } from 'react-native';
 export interface IRadioProps extends PressableProps {
   /** Required — identifies this item's value within a Radio.Group. */
   value: string;
+  /** Disables this item without disabling the rest of the group. */
   isDisabled?: boolean;
   isInvalid?: boolean;
+  /** Focusable, but the selection cannot be changed. */
   isReadOnly?: boolean;
   isHovered?: boolean;
   isFocused?: boolean;

package/src/select/SelectContent.tsx

@@ -2,7 +2,7 @@ import React, { forwardRef, useCallback, useRef, type ComponentRef } from 'react
 import { Platform, View } from 'react-native';
 import { FadeIn, FadeOut } from 'react-native-reanimated';
 import { composeEventHandlers, mergeRefs } from '@cdx-ui/utils';
-import { OverlayContainer, useAnchoredOverlay, useDismissOverlay } from '../overlay';
+import { OverlayContainer, useAnchoredOverlay, useDismissOverlay, useEscapeKey } from '../overlay';
 import { Slot } from '../slot';
 import { dataAttributes, mergeDataAttributes } from '../utils/dataAttributes';
 import { useSelectContext } from './context';
@@ -76,6 +76,7 @@ export const SelectContent = forwardRef<ComponentRef<typeof View>, SelectContent
     const mergedRef = mergeRefs(ref, focusOnMount as unknown as React.Ref<View>, floatingRef);
 
     useDismissOverlay(overlayOpen, contentRef, [triggerRef], dismiss);
+    useEscapeKey(overlayOpen, dismiss);
 
     const { handleKeyDown } = useListboxNavigation({
       items,

package/src/switch/types.ts

@@ -7,11 +7,11 @@ export interface IInterfaceSwitchProps {
    */
   onValueChange?: (value: boolean) => void;
   /**
-   * If true, set the Switch to the checked state.
+   * Alias for `value`. `value` takes precedence when both are set.
    */
   isChecked?: boolean;
   /**
-   * The current value of the switch.
+   * Controlled on/off state. Takes precedence over `isChecked`.
    */
   value?: boolean;
   /**
@@ -19,11 +19,11 @@ export interface IInterfaceSwitchProps {
    */
   isDisabled?: boolean;
   /**
-   * If true, the switch will be disabled.
+   * Alias for `isDisabled`. Either prop disables the switch.
    */
   disabled?: boolean;
   /**
-   * If true, the switch will be initially checked.
+   * Initial state when uncontrolled. No effect when `value` or `isChecked` is set.
    */
   defaultValue?: boolean;
   /**

package/src/tabs/types.ts

@@ -13,7 +13,8 @@ export interface ITabsProps {
   onValueChange?: (value: string) => void;
   /**
    * `automatic` (default) selects a tab as soon as it receives focus via arrow keys.
-   * `manual` only moves focus on arrow keys — the consumer must press Enter/Space to select.
+   * `manual` only moves focus — press Enter or Space to select. Web only; native
+   * selection follows press. Use `manual` when rendering the next panel is expensive.
    */
   activationMode?: TabsActivationMode;
   /**
@@ -21,6 +22,7 @@ export interface ITabsProps {
    * `vertical` uses ArrowUp/ArrowDown, per the ARIA APG tabs pattern.
    */
   orientation?: TabsOrientation;
+  /** Disables every tab. Disable a single tab with `disabled` on that `Tabs.Tab`. */
   disabled?: boolean;
   children?: ReactNode;
 }
@@ -63,7 +65,10 @@ export interface ITabProps extends PressableProps {
 export interface ITabPanelProps extends ViewProps {
   /** Required — correlates this panel with its `Tabs.Tab` counterpart. */
   value: string;
-  /** Unmount when inactive instead of keeping the panel hidden in the DOM. */
+  /**
+   * Unmount when inactive instead of keeping the panel mounted and hidden.
+   * The default keeps it mounted so the tab's `aria-controls` target stays in the tree.
+   */
   unmountWhenInactive?: boolean;
   children?: ReactNode;
 }