@cdx-ui/primitives 0.1.5 → 0.1.7

package/lib/typescript/portal/portal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../../src/portal/portal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAY,KAAK,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAwHnE,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAAC,2CAMnF;AAID,wBAAgB,UAAU,CAAC,EAAE,IAA0B,EAAE,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,kDAyC3E;AAID,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,QAA8B,EAC9B,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,QAcA;AAQD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB;;;;;EAiBjC"}
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../../src/portal/portal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAY,KAAK,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAwHnE,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAAC,2CAMnF;AAID,MAAM,WAAW,eAAe;IAC9B,2FAA2F;IAC3F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5B;AAED,wBAAgB,UAAU,CAAC,EAAE,IAA0B,EAAE,SAAS,EAAE,EAAE,eAAe,kDA0CpF;AAID,wBAAgB,MAAM,CAAC,EACrB,IAAI,EACJ,QAA8B,EAC9B,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,QAcA;AAQD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB;;;;;EAiBjC"}

package/lib/typescript/progress-bar/types.d.ts

@@ -3,17 +3,22 @@ import type { ViewProps } from 'react-native';
 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/lib/typescript/progress-bar/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/progress-bar/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,eAAe,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IACzE;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/progress-bar/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,eAAe,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,sBAAuB,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IACzE;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC"}

package/lib/typescript/radio/types.d.ts

@@ -2,8 +2,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/lib/typescript/radio/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/radio/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,2CAA2C;IAC3C,SAAS,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC7B,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/radio/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,WAAY,SAAQ,cAAc;IACjD,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,2CAA2C;IAC3C,SAAS,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC7B,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACrC"}

package/lib/typescript/select/SelectContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SelectContent.d.ts","sourceRoot":"","sources":["../../../src/select/SelectContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6D,MAAM,OAAO,CAAC;AAClF,OAAO,EAAY,IAAI,EAAE,MAAM,cAAc,CAAC;AAO9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAInD,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,iFA+HzB,CAAC"}
+{"version":3,"file":"SelectContent.d.ts","sourceRoot":"","sources":["../../../src/select/SelectContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6D,MAAM,OAAO,CAAC;AAClF,OAAO,EAAY,IAAI,EAAE,MAAM,cAAc,CAAC;AAO9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAInD,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,aAAa,iFAgIzB,CAAC"}

package/lib/typescript/switch/types.d.ts

@@ -6,11 +6,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;
     /**
@@ -18,11 +18,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/lib/typescript/tabs/types.d.ts

@@ -11,7 +11,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;
     /**
@@ -19,6 +20,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;
 }
@@ -58,7 +60,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;
 }

package/lib/typescript/tabs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tabs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,QAAQ,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,UAAU,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC;;;OAGG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,kBAAkB,CAAC;IACnC,WAAW,EAAE,eAAe,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3D,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC;IACzC,iGAAiG;IACjG,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CACtD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tabs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,QAAQ,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,UAAU,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC;;;OAGG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,SAAU,SAAQ,cAAc;IAC/C,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,cAAe,SAAQ,SAAS;IAC/C,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,mBAAoB,SAAQ,gBAAgB;IAC3D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,kBAAkB,CAAC;IACnC,WAAW,EAAE,eAAe,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3D,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,CAAC;IACzC,iGAAiG;IACjG,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CACtD"}

package/lib/typescript/toggle-button/ToggleButtonGroup.d.ts

@@ -0,0 +1,5 @@
+import { View } from 'react-native';
+import type { IToggleButtonGroupProps } from './types';
+export type ToggleButtonGroupProps = IToggleButtonGroupProps;
+export declare const ToggleButtonGroup: import("react").ForwardRefExoticComponent<IToggleButtonGroupProps & import("react").RefAttributes<View>>;
+//# sourceMappingURL=ToggleButtonGroup.d.ts.map

package/lib/typescript/toggle-button/ToggleButtonGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleButtonGroup.d.ts","sourceRoot":"","sources":["../../../src/toggle-button/ToggleButtonGroup.tsx"],"names":[],"mappings":"AASA,OAAO,EAAY,IAAI,EAAkB,MAAM,cAAc,CAAC;AAK9D,OAAO,KAAK,EACV,uBAAuB,EAGxB,MAAM,SAAS,CAAC;AAejB,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AA2C7D,eAAO,MAAM,iBAAiB,0GAqL7B,CAAC"}

package/lib/typescript/toggle-button/ToggleButtonRoot.d.ts

@@ -0,0 +1,5 @@
+import type { IToggleButtonProps } from './types';
+export interface ToggleButtonRootProps extends IToggleButtonProps {
+}
+export declare const ToggleButtonRoot: import("react").ForwardRefExoticComponent<ToggleButtonRootProps & import("react").RefAttributes<import("react-native").View>>;
+//# sourceMappingURL=ToggleButtonRoot.d.ts.map

package/lib/typescript/toggle-button/ToggleButtonRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleButtonRoot.d.ts","sourceRoot":"","sources":["../../../src/toggle-button/ToggleButtonRoot.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;CAAG;AAEpE,eAAO,MAAM,gBAAgB,+HAuI5B,CAAC"}

package/lib/typescript/toggle-button/ToggleButtonRoot.web.d.ts

@@ -0,0 +1,5 @@
+import type { IToggleButtonProps } from './types';
+export interface ToggleButtonRootProps extends IToggleButtonProps {
+}
+export declare const ToggleButtonRoot: import("react").ForwardRefExoticComponent<ToggleButtonRootProps & import("react").RefAttributes<import("react-native").View>>;
+//# sourceMappingURL=ToggleButtonRoot.web.d.ts.map

package/lib/typescript/toggle-button/ToggleButtonRoot.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToggleButtonRoot.web.d.ts","sourceRoot":"","sources":["../../../src/toggle-button/ToggleButtonRoot.web.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGlD,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;CAAG;AAEpE,eAAO,MAAM,gBAAgB,+HAgN5B,CAAC"}

package/lib/typescript/toggle-button/context.d.ts

@@ -0,0 +1,27 @@
+import type { IToggleButtonGroupContextValue } from './types';
+export declare const ToggleButtonProvider: import("react").FunctionComponent<{
+    children: import("react").ReactNode;
+    value: {
+        value: string;
+        isSelected: boolean;
+        isDisabled: boolean;
+        selectionType: "single" | "multiple" | "standalone";
+        hover: boolean;
+        active: boolean;
+        focus: boolean;
+        focusVisible: boolean;
+    };
+}>, useToggleButtonContext: () => {
+    value: string;
+    isSelected: boolean;
+    isDisabled: boolean;
+    selectionType: "single" | "multiple" | "standalone";
+    hover: boolean;
+    active: boolean;
+    focus: boolean;
+    focusVisible: boolean;
+};
+export declare const ToggleButtonGroupContextProvider: import("react").Provider<IToggleButtonGroupContextValue | null>;
+export declare function useToggleButtonGroupContext(): IToggleButtonGroupContextValue;
+export declare function useOptionalToggleButtonGroupContext(): IToggleButtonGroupContextValue | null;
+//# sourceMappingURL=context.d.ts.map

package/lib/typescript/toggle-button/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/toggle-button/context.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,SAAS,CAAC;AAE9D,eAAO,MAAO,oBAAoB;;;eACzB,MAAM;oBACD,OAAO;oBACP,OAAO;uBACJ,QAAQ,GAAG,UAAU,GAAG,YAAY;eAC5C,OAAO;gBACN,OAAO;eACR,OAAO;sBACA,OAAO;;IARa,sBAAsB;WACjD,MAAM;gBACD,OAAO;gBACP,OAAO;mBACJ,QAAQ,GAAG,UAAU,GAAG,YAAY;WAC5C,OAAO;YACN,OAAO;WACR,OAAO;kBACA,OAAO;CACE,CAAC;AAI1B,eAAO,MAAM,gCAAgC,iEAAoC,CAAC;AAElF,wBAAgB,2BAA2B,IAAI,8BAA8B,CAM5E;AAED,wBAAgB,mCAAmC,IAAI,8BAA8B,GAAG,IAAI,CAE3F"}

package/lib/typescript/toggle-button/index.d.ts

@@ -0,0 +1,5 @@
+export { ToggleButtonRoot, type ToggleButtonRootProps } from './ToggleButtonRoot';
+export { ToggleButtonGroup, type ToggleButtonGroupProps } from './ToggleButtonGroup';
+export { ToggleButtonProvider, useToggleButtonContext, useToggleButtonGroupContext, useOptionalToggleButtonGroupContext, } from './context';
+export type { IToggleButtonProps, IToggleButtonGroupProps, IToggleButtonGroupSingleProps, IToggleButtonGroupMultipleProps, IToggleButtonGroupContextValue, ToggleButtonGroupType, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/toggle-button/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/toggle-button/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,2BAA2B,EAC3B,mCAAmC,GACpC,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,kBAAkB,EAClB,uBAAuB,EACvB,6BAA6B,EAC7B,+BAA+B,EAC/B,8BAA8B,EAC9B,qBAAqB,GACtB,MAAM,SAAS,CAAC"}

package/lib/typescript/toggle-button/toggleState.d.ts

@@ -0,0 +1,14 @@
+declare const TOGGLE_STATES: {
+    readonly 'false:false:false': "idle";
+    readonly 'false:false:true': "hover";
+    readonly 'false:true:false': "active";
+    readonly 'false:true:true': "active";
+    readonly 'true:false:false': "selected";
+    readonly 'true:false:true': "selected-hover";
+    readonly 'true:true:false': "selected-active";
+    readonly 'true:true:true': "selected-active";
+};
+export type ToggleState = (typeof TOGGLE_STATES)[keyof typeof TOGGLE_STATES];
+export declare function getToggleState(selected: boolean, active: boolean, hover: boolean): ToggleState;
+export {};
+//# sourceMappingURL=toggleState.d.ts.map

package/lib/typescript/toggle-button/toggleState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggleState.d.ts","sourceRoot":"","sources":["../../../src/toggle-button/toggleState.ts"],"names":[],"mappings":"AAEA,QAAA,MAAM,aAAa;;;;;;;;;CAST,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE7E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAG9F"}

package/lib/typescript/toggle-button/types.d.ts

@@ -0,0 +1,87 @@
+import type { PressableProps, ViewProps } from 'react-native';
+export type ToggleButtonGroupType = 'single' | 'multiple';
+export type ToggleButtonGroupValue = string | string[] | undefined;
+interface IToggleButtonGroupBaseProps extends ViewProps {
+    /** Merge group props onto a single child instead of rendering the default View. */
+    asChild?: boolean;
+    /** Disables every item in the group. */
+    isDisabled?: boolean;
+    /**
+     * Layout direction and arrow-key axis.
+     * @default 'horizontal'
+     */
+    orientation?: 'horizontal' | 'vertical';
+    /** Accessible name for the group (required when no visible label). */
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+}
+export interface IToggleButtonGroupSingleProps extends IToggleButtonGroupBaseProps {
+    /**
+     * Single-select (radio semantics). `value` is the selected item's `value`.
+     * @default 'single'
+     */
+    type?: 'single';
+    /** Currently selected item `value` (controlled). */
+    value?: string;
+    /** Initially selected item `value` (uncontrolled). */
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+}
+export interface IToggleButtonGroupMultipleProps extends IToggleButtonGroupBaseProps {
+    /**
+     * Multi-select (pressed-button semantics). `value` is an array of selected item `value`s.
+     */
+    type: 'multiple';
+    /** Currently selected item `value`s (controlled). */
+    value?: string[];
+    /** Initially selected item `value`s (uncontrolled). */
+    defaultValue?: string[];
+    onValueChange?: (value: string[]) => void;
+}
+/**
+ * Discriminated union: `type` narrows `value` / `defaultValue` / `onValueChange`.
+ */
+export type IToggleButtonGroupProps = IToggleButtonGroupSingleProps | IToggleButtonGroupMultipleProps;
+export interface RegisteredToggleButton {
+    disabled: boolean;
+    node: {
+        focus?: () => void;
+    } | null;
+}
+export interface IToggleButtonGroupContextValue {
+    type: ToggleButtonGroupType;
+    orientation: 'horizontal' | 'vertical';
+    value: ToggleButtonGroupValue;
+    toggleValue: (buttonValue: string) => void;
+    isSelected: (buttonValue: string) => boolean;
+    isGroupDisabled: boolean;
+    focusedValue?: string | undefined;
+    setFocusedValue?: (value: string | undefined) => void;
+    registerItem?: (value: string, entry: RegisteredToggleButton) => void;
+    unregisterItem?: (value: string) => void;
+    getItems?: () => [string, RegisteredToggleButton][];
+}
+export interface IToggleButtonProps extends PressableProps {
+    /** Render the consumer's child in place of the default `Pressable` host. */
+    asChild?: boolean;
+    /**
+     * Identifies this button within a `ToggleButtonGroup`. Must be unique within the group.
+     * Standalone buttons still require a value.
+     */
+    value: string;
+    /**
+     * Controlled selected state (standalone only; ignored inside `ToggleButtonGroup`).
+     */
+    isSelected?: boolean;
+    /**
+     * Uncontrolled initial selected state (standalone only).
+     * @default false
+     */
+    defaultSelected?: boolean;
+    /** Called when standalone selected state changes. */
+    onSelectedChange?: (isSelected: boolean) => void;
+    /** @default false */
+    isDisabled?: boolean;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/toggle-button/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/toggle-button/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9D,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE1D,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;AAEnE,UAAU,2BAA4B,SAAQ,SAAS;IACrD,mFAAmF;IACnF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,6BAA8B,SAAQ,2BAA2B;IAChF;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,+BAAgC,SAAQ,2BAA2B;IAClF;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IACjB,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,6BAA6B,GAC7B,+BAA+B,CAAC;AAEpC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,qBAAqB,CAAC;IAC5B,WAAW,EAAE,YAAY,GAAG,UAAU,CAAC;IACvC,KAAK,EAAE,sBAAsB,CAAC;IAC9B,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7C,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACtD,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;IACtE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAAE,CAAC;CACrD;AAED,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IACxD,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,qBAAqB;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/lib/typescript/toggle-button/useToggleButtonGroupNavigation.d.ts

@@ -0,0 +1,19 @@
+import type { RegisteredToggleButton, ToggleButtonGroupType } from './types';
+/** Resolves which item value should hold the roving tab stop / keyboard focus anchor. */
+export declare function getRovingFocusValue(focusedValue: string | undefined, anchorValue: string | null | undefined, enabledItems: [string, RegisteredToggleButton][]): string | undefined;
+export interface UseToggleButtonGroupNavigationOptions {
+    type: ToggleButtonGroupType;
+    orientation: 'horizontal' | 'vertical';
+    getItems: () => [string, RegisteredToggleButton][];
+    focusedValue: string | undefined;
+    setFocusedValue: (value: string | undefined) => void;
+    anchorValue: string | null | undefined;
+    selectOnFocus?: (value: string) => void;
+}
+export declare function useToggleButtonGroupNavigation({ type, orientation, getItems, focusedValue, setFocusedValue, anchorValue, selectOnFocus, }: UseToggleButtonGroupNavigationOptions): {
+    handleKeyDown: (e: {
+        key: string;
+        preventDefault: () => void;
+    }) => void;
+};
+//# sourceMappingURL=useToggleButtonGroupNavigation.d.ts.map

package/lib/typescript/toggle-button/useToggleButtonGroupNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useToggleButtonGroupNavigation.d.ts","sourceRoot":"","sources":["../../../src/toggle-button/useToggleButtonGroupNavigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAS7E,yFAAyF;AACzF,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,YAAY,EAAE,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAAE,GAC/C,MAAM,GAAG,SAAS,CAUpB;AAED,MAAM,WAAW,qCAAqC;IACpD,IAAI,EAAE,qBAAqB,CAAC;IAC5B,WAAW,EAAE,YAAY,GAAG,UAAU,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,EAAE,CAAC;IACnD,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IACrD,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAED,wBAAgB,8BAA8B,CAAC,EAC7C,IAAI,EACJ,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,WAAW,EACX,aAAa,GACd,EAAE,qCAAqC;uBAqBhC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,IAAI,CAAA;KAAE;EA6ClD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cdx-ui/primitives",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -68,8 +68,8 @@
     "@react-stately/disclosure": "3.1.1",
     "@react-stately/radio": "3.12.0",
     "@react-stately/toggle": "3.9.4",
-    "@cdx-ui/utils": "0.1.5",
-    "@cdx-ui/formatters": "0.1.5"
+    "@cdx-ui/formatters": "0.1.7",
+    "@cdx-ui/utils": "0.1.7"
   },
   "devDependencies": {
     "@types/react": "19.1.17",

package/src/breadcrumbs/types.ts

@@ -13,8 +13,21 @@ export const breadcrumbColorOptions = [
 export type BreadcrumbColor = (typeof breadcrumbColorOptions)[number];
 
 export interface IBreadcrumbsProps extends ViewProps {
+  /**
+   * When `true`, ancestor items are not interactive and use muted text.
+   * The current page keeps its color.
+   * @default false
+   */
   readonly isDisabled?: boolean;
+  /**
+   * When `true`, interactive ancestor items are underlined.
+   * @default false
+   */
   readonly isUnderlined?: boolean;
+  /**
+   * Semantic color for ancestor items. `neutral` uses the standard text hierarchy.
+   * @default 'neutral'
+   */
   readonly color?: BreadcrumbColor;
   /**
    * Accessible name for the breadcrumb navigation landmark.

package/src/checkbox/types.ts

@@ -1,13 +1,17 @@
 import type { PressableProps } from 'react-native';
 
 export interface InterfaceCheckbox extends PressableProps {
+  /** Identifies this checkbox. Must be unique among siblings in a `Checkbox.Group`. */
   value: string;
   onChange?: (isSelected: boolean) => void;
   children?: React.ReactNode;
+  /** Initial checked state when uncontrolled. No effect when `isChecked` is set. */
   defaultIsChecked?: boolean;
+  /** Controlled checked state. When set, `defaultIsChecked` has no effect. */
   isChecked?: boolean;
   isDisabled?: boolean;
   isInvalid?: boolean;
+  /** Focusable, but the checked state cannot be changed. */
   isReadOnly?: boolean;
   isHovered?: boolean;
   isFocused?: boolean;

package/src/dialog/DialogContent.tsx

@@ -14,20 +14,26 @@ export interface DialogContentProps extends IDialogContentProps {}
  * - ARIA role, aria-modal, aria-labelledby/describedby
  * - FocusScope (focus trap + restore + auto-focus)
  * - Escape key dismissal (web)
- * - Android hardware back button dismissal (native)
+ * - Android hardware back button: calls the context `backHandlerRef` when set, otherwise dismisses (native)
  * - data-state attribute for CSS transition targeting
  *
  * Unstyled — the styled layer applies centering, background, border-radius, etc.
  */
 export const DialogContent = forwardRef<ComponentRef<typeof View>, DialogContentProps>(
   ({ asChild = false, forceMount = false, children, ...props }, ref) => {
-    const { open, onOpenChange, closeOnEscKey, nativeID, role } = useDialog();
+    const { open, onOpenChange, closeOnEscKey, nativeID, role, backHandlerRef } = useDialog();
 
     const handleClose = useCallback(() => {
       onOpenChange(false);
     }, [onOpenChange]);
 
-    useEscapeKey(open && closeOnEscKey, handleClose, {
+    const handleEscape = useCallback(() => {
+      if (closeOnEscKey) onOpenChange(false);
+    }, [closeOnEscKey, onOpenChange]);
+
+    // Registered regardless of `closeOnEscKey` so a non-dismissible dialog still
+    // owns Escape while topmost instead of letting it reach the overlay beneath.
+    useEscapeKey(open, handleEscape, {
       id: nativeID,
       groupId: nativeID,
       layer: 'modal',
@@ -46,14 +52,16 @@ export const DialogContent = forwardRef<ComponentRef<typeof View>, DialogContent
 
       const backHandler = BackHandler.addEventListener('hardwareBackPress', () => {
         if (!isTopmost('back')) return false;
-        handleClose();
+        const onBack = backHandlerRef.current;
+        if (onBack) onBack();
+        else handleClose();
         return true;
       });
 
       return () => {
         backHandler.remove();
       };
-    }, [handleClose, isTopmost, open]);
+    }, [backHandlerRef, handleClose, isTopmost, open]);
 
     if (!forceMount && !open) {
       return null;

package/src/dialog/DialogPopup.tsx

@@ -47,7 +47,13 @@ export const DialogPopup = forwardRef<ComponentRef<typeof View>, DialogPopupProp
       onOpenChange(false);
     }, [onOpenChange]);
 
-    useEscapeKey(open && closeOnEscKey, handleClose, {
+    const handleEscape = useCallback(() => {
+      if (closeOnEscKey) onOpenChange(false);
+    }, [closeOnEscKey, onOpenChange]);
+
+    // Registered regardless of `closeOnEscKey` so a non-dismissible dialog still
+    // owns Escape while topmost instead of letting it reach the overlay beneath.
+    useEscapeKey(open, handleEscape, {
       id: nativeID,
       groupId: nativeID,
       layer: 'modal',

package/src/dialog/DialogRoot.tsx

@@ -1,4 +1,4 @@
-import { forwardRef, useCallback, useId, useMemo, type ComponentRef } from 'react';
+import { forwardRef, useCallback, useId, useMemo, useRef, type ComponentRef } from 'react';
 import { View, type ViewProps } from 'react-native';
 import { useControllableState } from '@cdx-ui/utils';
 import { Slot } from '../slot';
@@ -40,6 +40,7 @@ export const DialogRoot = forwardRef<ComponentRef<typeof View>, DialogRootProps>
 
     const id = useId();
     const nativeID = `dialog-${id}`;
+    const backHandlerRef = useRef<(() => void) | undefined>(undefined);
 
     const contextValue = useMemo(
       () => ({
@@ -49,6 +50,7 @@ export const DialogRoot = forwardRef<ComponentRef<typeof View>, DialogRootProps>
         closeOnEscKey,
         nativeID,
         role,
+        backHandlerRef,
       }),
       [open, setOpen, closeOnBackdropPress, closeOnEscKey, nativeID, role],
     );

package/src/dialog/types.ts

@@ -8,6 +8,11 @@ export interface IDialogContextType {
   readonly closeOnEscKey: boolean;
   readonly nativeID: string;
   readonly role: 'dialog' | 'alertdialog';
+  /**
+   * @internal Set by a header that owns step navigation. When set, Android back
+   * calls it instead of closing the dialog. Escape always closes.
+   */
+  readonly backHandlerRef: React.RefObject<(() => void) | undefined>;
 }
 
 export interface IDialogRootProps {
@@ -16,6 +21,12 @@ export interface IDialogRootProps {
   readonly onOpenChange?: (open: boolean) => void;
   readonly defaultOpen?: boolean;
   readonly closeOnBackdropPress?: boolean;
+  /**
+   * Close when Escape is pressed. Web only. When `false`, an open dialog still
+   * consumes Escape while topmost, so overlays beneath it stay open. Android's
+   * hardware back button dismisses independently of this prop.
+   * @default true
+   */
   readonly closeOnEscKey?: boolean;
   readonly role?: 'dialog' | 'alertdialog';
   readonly children: React.ReactNode;
@@ -38,6 +49,7 @@ export interface IDialogOverlayProps extends PressableProps {
 
 export interface IDialogContentProps extends ViewProps {
   readonly asChild?: boolean;
+  /** Keep the popup mounted while the dialog is closed. @default false */
   readonly forceMount?: boolean;
   /**
    * Whether the content shifts up to clear the on-screen keyboard (native only).

package/src/field/types.tsx

@@ -23,7 +23,7 @@ export interface IFieldRootProps extends ViewProps {
   readonly isInvalid?: boolean;
   /** If true, the field is marked as required. Shows asterisk on label. */
   readonly isRequired?: boolean;
-  /** If true, the field is disabled. */
+  /** If true, the field is disabled. Nested controls that read field context are disabled as well. */
   readonly isDisabled?: boolean;
   /** If true, the field is read-only. */
   readonly isReadOnly?: boolean;

package/src/form/types.tsx

@@ -6,8 +6,14 @@ import type React from 'react';
  * for API compatibility but silently ignored.
  */
 export interface InterfaceFormRootProps {
+  /** Called when the form is submitted. Web only; ignored on native. */
   onSubmit?: (e: React.SyntheticEvent) => void;
+  /**
+   * HTML `action` URL, or a function that receives the submitted `FormData`.
+   * Web only; ignored on native.
+   */
   action?: string | ((formData: FormData) => void | Promise<void>);
+  /** HTTP method. Web only; ignored on native. */
   method?: string;
 }
 

package/src/index.ts

@@ -61,6 +61,7 @@ export * from './select';
 export * from './switch';
 export * from './tabs';
 export * from './tile';
+export * from './toggle-button';
 export * from './toast';
 export * from './tooltip';
 export * from './portal';

package/src/input/types.ts

@@ -60,6 +60,7 @@ interface IInputBaseProps extends TextInputProps {
 }
 
 interface IInputTextProps extends IInputBaseProps {
+  /** @default 'text' */
   type?: 'text' | 'password';
 }
 

package/src/link/types.ts

@@ -16,11 +16,11 @@ export type LinkAction = 'navigate' | 'push' | 'replace';
 
 export interface ILinkProps extends PressableProps {
   /**
-   * URL that should be opened on Link press
+   * URL or route path opened on press. Omit when the link only runs `onPress`.
    */
   href?: string | undefined;
   /**
-   * Callback that will be invoked on Link press
+   * Invoked on press before navigation. Does not replace navigation.
    */
   onPress?: ((event?: GestureResponderEvent) => void) | null | undefined;
   /**

package/src/list-item/types.ts

@@ -29,8 +29,9 @@ export interface InterfaceListItemProps extends ViewProps, IListItemPressablePas
    */
   crossAlign?: ListItemCrossAlign;
   /**
-   * Merge interaction props onto a single child instead of rendering the default pressable root.
-   * Intended for use with `onPress`.
+   * Merge props onto a single child (for example `Link`) instead of rendering `View` or `Pressable`.
+   * The child's `onPress` is kept unless this component also passes `onPress`.
+   * `isDisabled` suppresses press on the child.
    */
   asChild?: boolean;
 }