@xaui/native 0.9.1-beta.95 → 0.9.1-beta.97

package/dist/components/slide-button/slide-button-icon.d.cts

@@ -0,0 +1,10 @@
+import type { SlideButtonIconProps } from './slide-button.type';
+/**
+ * The mark in the thumb. Written inside `SlideButton.Thumb`, it inherits the handle's glyph
+ * size and — because the handle is the surface colour whatever the pill does — the theme's
+ * foreground. `size` and `color` override both.
+ */
+export declare function SlideButtonIcon({ size, color, ...rest }: SlideButtonIconProps): import("react").JSX.Element;
+export declare namespace SlideButtonIcon {
+    var displayName: string;
+}

package/dist/components/slide-button/slide-button-icon.d.ts

@@ -0,0 +1,10 @@
+import type { SlideButtonIconProps } from './slide-button.type';
+/**
+ * The mark in the thumb. Written inside `SlideButton.Thumb`, it inherits the handle's glyph
+ * size and — because the handle is the surface colour whatever the pill does — the theme's
+ * foreground. `size` and `color` override both.
+ */
+export declare function SlideButtonIcon({ size, color, ...rest }: SlideButtonIconProps): import("react").JSX.Element;
+export declare namespace SlideButtonIcon {
+    var displayName: string;
+}

package/dist/components/slide-button/slide-button-label.d.cts

@@ -0,0 +1,20 @@
+import { Text } from 'react-native';
+/**
+ * The instruction, centred across the whole pill. The thumb slides over it rather than
+ * beside it — there is no gap to keep, because they are not laid out together.
+ *
+ * **It is drawn twice.** On the four intent variants the pill sweeps from its soft slice
+ * to the vivid one, and no single text colour survives that: painted for the soft pill a
+ * label reads about 1.3:1 against the vivid trail, painted for the trail it is invisible
+ * at rest. So the second copy is painted for the swept ground and clipped to exactly the
+ * trail's width — a word the trail is halfway through is dark on the half that is still
+ * soft and light on the half that is not. Where a variant names no `fgSelected` both
+ * copies resolve to the same colour and the second one costs a `Text` that changes
+ * nothing.
+ *
+ * The clip's width is driven on the UI thread off the same shared offset the trail reads,
+ * so the two edges are the same edge and never separate under the finger.
+ */
+export declare const SlideButtonLabel: import("react").ForwardRefExoticComponent<import("react-native").TextProps & Omit<import("../..").TextStyleProps, keyof import("react-native").TextProps> & {
+    children?: import("react").ReactNode;
+} & import("react").RefAttributes<Text>>;

package/dist/components/slide-button/slide-button-label.d.ts

@@ -0,0 +1,20 @@
+import { Text } from 'react-native';
+/**
+ * The instruction, centred across the whole pill. The thumb slides over it rather than
+ * beside it — there is no gap to keep, because they are not laid out together.
+ *
+ * **It is drawn twice.** On the four intent variants the pill sweeps from its soft slice
+ * to the vivid one, and no single text colour survives that: painted for the soft pill a
+ * label reads about 1.3:1 against the vivid trail, painted for the trail it is invisible
+ * at rest. So the second copy is painted for the swept ground and clipped to exactly the
+ * trail's width — a word the trail is halfway through is dark on the half that is still
+ * soft and light on the half that is not. Where a variant names no `fgSelected` both
+ * copies resolve to the same colour and the second one costs a `Text` that changes
+ * nothing.
+ *
+ * The clip's width is driven on the UI thread off the same shared offset the trail reads,
+ * so the two edges are the same edge and never separate under the finger.
+ */
+export declare const SlideButtonLabel: import("react").ForwardRefExoticComponent<import("react-native").TextProps & Omit<import("../..").TextStyleProps, keyof import("react-native").TextProps> & {
+    children?: import("react").ReactNode;
+} & import("react").RefAttributes<Text>>;

package/dist/components/slide-button/slide-button-thumb.d.cts

@@ -0,0 +1,20 @@
+import type { SlideButtonThumbProps } from './slide-button.type';
+/**
+ * The handle the finger drags.
+ *
+ * The pan runs on `react-native-gesture-handler`, the same **optional** peer the `Slider`
+ * reaches for and imported here and nowhere else — an app that never touches
+ * `@xaui/native/slide-button` does not pay for it.
+ *
+ * Everything the finger does stays on the UI thread: the offset is a shared value the pan
+ * writes and the fill and the handle both read. The one hop to JS is `runOnJS` on release,
+ * once, when the slide has reached the threshold — the confirm is React state and a
+ * callback, and neither belongs on the worklet.
+ *
+ * With no children it draws the built-in chevron, mirrored under RTL so it always points
+ * the way the handle travels. Pass an `Icon` — or anything — to replace it.
+ */
+export declare function SlideButtonThumb({ children, style, ...props }: SlideButtonThumbProps): import("react").JSX.Element;
+export declare namespace SlideButtonThumb {
+    var displayName: string;
+}

package/dist/components/slide-button/slide-button-thumb.d.ts

@@ -0,0 +1,20 @@
+import type { SlideButtonThumbProps } from './slide-button.type';
+/**
+ * The handle the finger drags.
+ *
+ * The pan runs on `react-native-gesture-handler`, the same **optional** peer the `Slider`
+ * reaches for and imported here and nowhere else — an app that never touches
+ * `@xaui/native/slide-button` does not pay for it.
+ *
+ * Everything the finger does stays on the UI thread: the offset is a shared value the pan
+ * writes and the fill and the handle both read. The one hop to JS is `runOnJS` on release,
+ * once, when the slide has reached the threshold — the confirm is React state and a
+ * callback, and neither belongs on the worklet.
+ *
+ * With no children it draws the built-in chevron, mirrored under RTL so it always points
+ * the way the handle travels. Pass an `Icon` — or anything — to replace it.
+ */
+export declare function SlideButtonThumb({ children, style, ...props }: SlideButtonThumbProps): import("react").JSX.Element;
+export declare namespace SlideButtonThumb {
+    var displayName: string;
+}

package/dist/components/slide-button/slide-button.animation.d.cts

@@ -0,0 +1,33 @@
+/**
+ * The thumb's motion.
+ *
+ * It grows a little under the finger, the only confirmation the control can give that the
+ * drag has taken — the finger is already over the handle, so the scale is what shows in the
+ * ring of pill around it. The `Slider`'s knob does the same.
+ */
+export declare const THUMB_PRESSED_SCALE = 1.06;
+/**
+ * How the thumb settles when the finger lifts — springing home if the slide fell short,
+ * or on to the end if it did not. Stiff and well damped: a confirmation arrives, it does
+ * not wobble.
+ */
+export declare const THUMB_SPRING: {
+    readonly damping: 20;
+    readonly stiffness: 260;
+    readonly mass: 0.7;
+};
+/** How far along the track the thumb must reach for the slide to count, from 0 to 1. */
+export declare const DEFAULT_THRESHOLD = 0.9;
+/**
+ * How much of the pill the slide has swept, in points — the trail's width, and the width
+ * of the clip the swept label is read through.
+ *
+ * It is the fraction of the travel laid over the **whole** pill rather than the handle's
+ * raw offset, because the handle stops a handle's width short of the trailing cap and a
+ * trail that stopped with it would leave a confirmed slide showing unswept pill.
+ *
+ * The two callers have to agree to the point: the trail paints the swept ground and the
+ * clip decides which half of a straddling word is painted for it. Two expressions of the
+ * same edge would eventually drift, so there is one.
+ */
+export declare function sweptWidth(offset: number, travel: number, trackLength: number): number;

package/dist/components/slide-button/slide-button.animation.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The thumb's motion.
+ *
+ * It grows a little under the finger, the only confirmation the control can give that the
+ * drag has taken — the finger is already over the handle, so the scale is what shows in the
+ * ring of pill around it. The `Slider`'s knob does the same.
+ */
+export declare const THUMB_PRESSED_SCALE = 1.06;
+/**
+ * How the thumb settles when the finger lifts — springing home if the slide fell short,
+ * or on to the end if it did not. Stiff and well damped: a confirmation arrives, it does
+ * not wobble.
+ */
+export declare const THUMB_SPRING: {
+    readonly damping: 20;
+    readonly stiffness: 260;
+    readonly mass: 0.7;
+};
+/** How far along the track the thumb must reach for the slide to count, from 0 to 1. */
+export declare const DEFAULT_THRESHOLD = 0.9;
+/**
+ * How much of the pill the slide has swept, in points — the trail's width, and the width
+ * of the clip the swept label is read through.
+ *
+ * It is the fraction of the travel laid over the **whole** pill rather than the handle's
+ * raw offset, because the handle stops a handle's width short of the trailing cap and a
+ * trail that stopped with it would leave a confirmed slide showing unswept pill.
+ *
+ * The two callers have to agree to the point: the trail paints the swept ground and the
+ * clip decides which half of a straddling word is painted for it. Two expressions of the
+ * same edge would eventually drift, so there is one.
+ */
+export declare function sweptWidth(offset: number, travel: number, trackLength: number): number;

package/dist/components/slide-button/slide-button.context.d.cts

@@ -0,0 +1,7 @@
+import type { SlideButtonContextValue } from './slide-button.type';
+/**
+ * R10 — `useSlideButton` is exported so a third party can write its own slot (a second
+ * mark, a progress readout) against the same resolved styles and the same shared offset
+ * the built-in ones read. Outside a `<SlideButton>` it throws by name.
+ */
+export declare const SlideButtonProvider: import("react").Provider<SlideButtonContextValue | null>, useSlideButton: () => SlideButtonContextValue;

package/dist/components/slide-button/slide-button.context.d.ts

@@ -0,0 +1,7 @@
+import type { SlideButtonContextValue } from './slide-button.type';
+/**
+ * R10 — `useSlideButton` is exported so a third party can write its own slot (a second
+ * mark, a progress readout) against the same resolved styles and the same shared offset
+ * the built-in ones read. Outside a `<SlideButton>` it throws by name.
+ */
+export declare const SlideButtonProvider: import("react").Provider<SlideButtonContextValue | null>, useSlideButton: () => SlideButtonContextValue;

package/dist/components/slide-button/slide-button.d.cts

@@ -0,0 +1,56 @@
+import { View } from 'react-native';
+import type { ViewStyle } from 'react-native';
+/**
+ * A button you drag rather than tap, for the action that should not happen by accident:
+ * slide the thumb to the far end and it fires once. Below the threshold it springs home.
+ *
+ * ```tsx
+ * <SlideButton onConfirm={unlock}>Slide to confirm</SlideButton>
+ *
+ * <SlideButton variant="danger" onConfirm={wipe}>
+ *   <SlideButton.Fill />
+ *   <SlideButton.Label>Slide to delete</SlideButton.Label>
+ *   <SlideButton.Thumb>
+ *     <SlideButton.Icon as={TrashIcon} />
+ *   </SlideButton.Thumb>
+ * </SlideButton>
+ * ```
+ *
+ * **It is the `Slider`'s gesture without the value.** The thumb runs the same pan on the
+ * same optional `react-native-gesture-handler` peer, the track measures its own length
+ * the same way, and the travel is inset by the thumb at each end for the same reason —
+ * but there is no `min`, `max` or `step`, because the only positions that mean anything
+ * are "not yet" and "done".
+ *
+ * **Once confirmed it stays confirmed.** Uncontrolled, a slide is a one-shot. Pass
+ * `isConfirmed` to drive it — set it back to `false` and the thumb springs home, re-armed.
+ *
+ * **A bare string is the whole component.** `<SlideButton>Slide</SlideButton>` composes
+ * the fill, the label and the thumb for you; write the slots out to put a mark in the
+ * thumb or leave the fill off.
+ */
+export declare const SlideButtonRoot: import("react").ForwardRefExoticComponent<{
+    children?: import("react").ReactNode;
+    variant?: import("./slide-button.type").SlideButtonVariant;
+    size?: import("./slide-button.type").SlideButtonSize;
+    radius?: import("../..").RadiusKey;
+    color?: string;
+    threshold?: number;
+    isConfirmed?: boolean;
+    defaultConfirmed?: boolean;
+    onConfirm?: () => void;
+    isDisabled?: boolean;
+    style?: import("react-native").StyleProp<ViewStyle>;
+} & Omit<import("react-native").ViewProps, keyof {
+    children?: import("react").ReactNode;
+    variant?: import("./slide-button.type").SlideButtonVariant;
+    size?: import("./slide-button.type").SlideButtonSize;
+    radius?: import("../..").RadiusKey;
+    color?: string;
+    threshold?: number;
+    isConfirmed?: boolean;
+    defaultConfirmed?: boolean;
+    onConfirm?: () => void;
+    isDisabled?: boolean;
+    style?: import("react-native").StyleProp<ViewStyle>;
+}> & Omit<import("../..").ViewStyleProps, "color" | "pointerEvents" | "style" | "children" | "hitSlop" | "id" | "needsOffscreenAlphaCompositing" | "onLayout" | "removeClippedSubviews" | "testID" | "nativeID" | "collapsable" | "collapsableChildren" | "onBlur" | "onFocus" | "renderToHardwareTextureAndroid" | "focusable" | "tabIndex" | "shouldRasterizeIOS" | "isTVSelectable" | "hasTVPreferredFocus" | "tvParallaxShiftDistanceX" | "tvParallaxShiftDistanceY" | "tvParallaxTiltAngle" | "tvParallaxMagnification" | "onStartShouldSetResponder" | "onMoveShouldSetResponder" | "onResponderEnd" | "onResponderGrant" | "onResponderReject" | "onResponderMove" | "onResponderRelease" | "onResponderStart" | "onResponderTerminationRequest" | "onResponderTerminate" | "onStartShouldSetResponderCapture" | "onMoveShouldSetResponderCapture" | "onTouchStart" | "onTouchMove" | "onTouchEnd" | "onTouchCancel" | "onTouchEndCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerUp" | "onPointerUpCapture" | "accessible" | "accessibilityActions" | "accessibilityLabel" | "aria-label" | "accessibilityRole" | "accessibilityState" | "aria-busy" | "aria-checked" | "aria-disabled" | "aria-expanded" | "aria-selected" | "accessibilityHint" | "accessibilityValue" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "onAccessibilityAction" | "importantForAccessibility" | "aria-hidden" | "aria-modal" | "role" | "accessibilityLabelledBy" | "aria-labelledby" | "accessibilityLiveRegion" | "aria-live" | "screenReaderFocusable" | "accessibilityElementsHidden" | "accessibilityViewIsModal" | "onAccessibilityEscape" | "onAccessibilityTap" | "onMagicTap" | "accessibilityIgnoresInvertColors" | "accessibilityLanguage" | "accessibilityShowsLargeContentViewer" | "accessibilityLargeContentTitle" | "accessibilityRespondsToUserInteraction" | "isDisabled" | "radius" | "size" | "variant" | "threshold" | "isConfirmed" | "defaultConfirmed" | "onConfirm"> & import("react").RefAttributes<View>>;

package/dist/components/slide-button/slide-button.d.ts

@@ -0,0 +1,56 @@
+import { View } from 'react-native';
+import type { ViewStyle } from 'react-native';
+/**
+ * A button you drag rather than tap, for the action that should not happen by accident:
+ * slide the thumb to the far end and it fires once. Below the threshold it springs home.
+ *
+ * ```tsx
+ * <SlideButton onConfirm={unlock}>Slide to confirm</SlideButton>
+ *
+ * <SlideButton variant="danger" onConfirm={wipe}>
+ *   <SlideButton.Fill />
+ *   <SlideButton.Label>Slide to delete</SlideButton.Label>
+ *   <SlideButton.Thumb>
+ *     <SlideButton.Icon as={TrashIcon} />
+ *   </SlideButton.Thumb>
+ * </SlideButton>
+ * ```
+ *
+ * **It is the `Slider`'s gesture without the value.** The thumb runs the same pan on the
+ * same optional `react-native-gesture-handler` peer, the track measures its own length
+ * the same way, and the travel is inset by the thumb at each end for the same reason —
+ * but there is no `min`, `max` or `step`, because the only positions that mean anything
+ * are "not yet" and "done".
+ *
+ * **Once confirmed it stays confirmed.** Uncontrolled, a slide is a one-shot. Pass
+ * `isConfirmed` to drive it — set it back to `false` and the thumb springs home, re-armed.
+ *
+ * **A bare string is the whole component.** `<SlideButton>Slide</SlideButton>` composes
+ * the fill, the label and the thumb for you; write the slots out to put a mark in the
+ * thumb or leave the fill off.
+ */
+export declare const SlideButtonRoot: import("react").ForwardRefExoticComponent<{
+    children?: import("react").ReactNode;
+    variant?: import("./slide-button.type").SlideButtonVariant;
+    size?: import("./slide-button.type").SlideButtonSize;
+    radius?: import("../..").RadiusKey;
+    color?: string;
+    threshold?: number;
+    isConfirmed?: boolean;
+    defaultConfirmed?: boolean;
+    onConfirm?: () => void;
+    isDisabled?: boolean;
+    style?: import("react-native").StyleProp<ViewStyle>;
+} & Omit<import("react-native").ViewProps, keyof {
+    children?: import("react").ReactNode;
+    variant?: import("./slide-button.type").SlideButtonVariant;
+    size?: import("./slide-button.type").SlideButtonSize;
+    radius?: import("../..").RadiusKey;
+    color?: string;
+    threshold?: number;
+    isConfirmed?: boolean;
+    defaultConfirmed?: boolean;
+    onConfirm?: () => void;
+    isDisabled?: boolean;
+    style?: import("react-native").StyleProp<ViewStyle>;
+}> & Omit<import("../..").ViewStyleProps, "color" | "pointerEvents" | "style" | "children" | "hitSlop" | "id" | "needsOffscreenAlphaCompositing" | "onLayout" | "removeClippedSubviews" | "testID" | "nativeID" | "collapsable" | "collapsableChildren" | "onBlur" | "onFocus" | "renderToHardwareTextureAndroid" | "focusable" | "tabIndex" | "shouldRasterizeIOS" | "isTVSelectable" | "hasTVPreferredFocus" | "tvParallaxShiftDistanceX" | "tvParallaxShiftDistanceY" | "tvParallaxTiltAngle" | "tvParallaxMagnification" | "onStartShouldSetResponder" | "onMoveShouldSetResponder" | "onResponderEnd" | "onResponderGrant" | "onResponderReject" | "onResponderMove" | "onResponderRelease" | "onResponderStart" | "onResponderTerminationRequest" | "onResponderTerminate" | "onStartShouldSetResponderCapture" | "onMoveShouldSetResponderCapture" | "onTouchStart" | "onTouchMove" | "onTouchEnd" | "onTouchCancel" | "onTouchEndCapture" | "onPointerEnter" | "onPointerEnterCapture" | "onPointerLeave" | "onPointerLeaveCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerUp" | "onPointerUpCapture" | "accessible" | "accessibilityActions" | "accessibilityLabel" | "aria-label" | "accessibilityRole" | "accessibilityState" | "aria-busy" | "aria-checked" | "aria-disabled" | "aria-expanded" | "aria-selected" | "accessibilityHint" | "accessibilityValue" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "onAccessibilityAction" | "importantForAccessibility" | "aria-hidden" | "aria-modal" | "role" | "accessibilityLabelledBy" | "aria-labelledby" | "accessibilityLiveRegion" | "aria-live" | "screenReaderFocusable" | "accessibilityElementsHidden" | "accessibilityViewIsModal" | "onAccessibilityEscape" | "onAccessibilityTap" | "onMagicTap" | "accessibilityIgnoresInvertColors" | "accessibilityLanguage" | "accessibilityShowsLargeContentViewer" | "accessibilityLargeContentTitle" | "accessibilityRespondsToUserInteraction" | "isDisabled" | "radius" | "size" | "variant" | "threshold" | "isConfirmed" | "defaultConfirmed" | "onConfirm"> & import("react").RefAttributes<View>>;

package/dist/components/slide-button/slide-button.recipe.d.cts

@@ -0,0 +1,31 @@
+import type { SlotStyles } from '../../system/recipe';
+import type { XAUITheme } from '../../theme/theme.type';
+import type { SlideButtonSize, SlideButtonSlot, SlideButtonVariant } from './slide-button.type';
+type SizeStep = {
+    /** The control-height key. The handle's height is that less twice the inset. */
+    height: SlideButtonSize;
+    /** How far the handle sits in from the pill's edge, in points. The air around it. */
+    inset: number;
+    /**
+     * The mark's box, in points — the side of the built-in chevron, and the size an `Icon`
+     * in the handle inherits. Off the spacing grid: it is a drawn mark, not a gap.
+     */
+    glyph: number;
+    /** The label's type key. */
+    label: SlideButtonSize;
+};
+/**
+ * The three sizes, measured rather than scaled off one number: a slide button is a target
+ * before it is type, so the height leads and the rest follows it.
+ */
+declare const SIZES: Record<SlideButtonSize, SizeStep>;
+export declare const slideButtonRecipe: import("../..").Recipe<"label" | "fill" | "root" | "glyph" | "thumb" | "fillClip" | "labelSwept", SlideButtonVariant, {
+    readonly size: {
+        readonly sm: (theme: XAUITheme) => SlotStyles<SlideButtonSlot>;
+        readonly md: (theme: XAUITheme) => SlotStyles<SlideButtonSlot>;
+        readonly lg: (theme: XAUITheme) => SlotStyles<SlideButtonSlot>;
+    };
+    /** After `size`, so a caller's `radius` wins over the pill's `full`. */
+    readonly radius: Record<import("../..").RadiusKey, import("../..").StyleFn<"fill" | "root" | "fillClip">>;
+}>;
+export { SIZES as slideButtonSizes };

package/dist/components/slide-button/slide-button.recipe.d.ts

@@ -0,0 +1,31 @@
+import type { SlotStyles } from '../../system/recipe';
+import type { XAUITheme } from '../../theme/theme.type';
+import type { SlideButtonSize, SlideButtonSlot, SlideButtonVariant } from './slide-button.type';
+type SizeStep = {
+    /** The control-height key. The handle's height is that less twice the inset. */
+    height: SlideButtonSize;
+    /** How far the handle sits in from the pill's edge, in points. The air around it. */
+    inset: number;
+    /**
+     * The mark's box, in points — the side of the built-in chevron, and the size an `Icon`
+     * in the handle inherits. Off the spacing grid: it is a drawn mark, not a gap.
+     */
+    glyph: number;
+    /** The label's type key. */
+    label: SlideButtonSize;
+};
+/**
+ * The three sizes, measured rather than scaled off one number: a slide button is a target
+ * before it is type, so the height leads and the rest follows it.
+ */
+declare const SIZES: Record<SlideButtonSize, SizeStep>;
+export declare const slideButtonRecipe: import("../..").Recipe<"label" | "fill" | "root" | "glyph" | "thumb" | "fillClip" | "labelSwept", SlideButtonVariant, {
+    readonly size: {
+        readonly sm: (theme: XAUITheme) => SlotStyles<SlideButtonSlot>;
+        readonly md: (theme: XAUITheme) => SlotStyles<SlideButtonSlot>;
+        readonly lg: (theme: XAUITheme) => SlotStyles<SlideButtonSlot>;
+    };
+    /** After `size`, so a caller's `radius` wins over the pill's `full`. */
+    readonly radius: Record<import("../..").RadiusKey, import("../..").StyleFn<"fill" | "root" | "fillClip">>;
+}>;
+export { SIZES as slideButtonSizes };

package/dist/components/slide-button/slide-button.type.d.cts

@@ -0,0 +1,79 @@
+import type { ReactNode } from 'react';
+import type { SharedValue } from 'react-native-reanimated';
+import type { StyleProp, TextProps, TextStyle, ViewProps, ViewStyle } from 'react-native';
+import type { IconContextValue, IconProps } from '../../system/icon';
+import type { TextStyleProps, ViewStyleProps } from '../../system/style-props';
+import type { RadiusKey } from '../../theme/theme.type';
+export type SlideButtonSlot = 'root' | 'fillClip' | 'fill' | 'label' | 'labelSwept' | 'thumb' | 'glyph';
+/**
+ * The flat variant union, the same ten values every control in the library takes. A
+ * slide-to-confirm is still a button — a slide-to-delete is a real `danger` use — so the
+ * intents stay.
+ */
+export type SlideButtonVariant = 'primary' | 'secondary' | 'tertiary' | 'ghost' | 'success' | 'success-soft' | 'warning' | 'warning-soft' | 'danger' | 'danger-soft';
+export type SlideButtonSize = 'sm' | 'md' | 'lg';
+type SlideButtonOwnProps = {
+    children?: ReactNode;
+    variant?: SlideButtonVariant;
+    /** Height, horizontal padding and the label's type. Never a width. */
+    size?: SlideButtonSize;
+    /** Overrides the pill's corner. `full` unless you say otherwise. */
+    radius?: RadiusKey;
+    /** A raw tint (R7). Lands on the pill, or on the label for `ghost` — never on the thumb. */
+    color?: string;
+    /**
+     * How far along the track the thumb has to reach for the slide to count, from 0 to 1.
+     * Below it the thumb springs home on release.
+     * @default 0.9
+     */
+    threshold?: number;
+    /** Controlled: `true` pins the thumb at the end, `false` springs it home. */
+    isConfirmed?: boolean;
+    /** The starting state when uncontrolled. Once confirmed it stays confirmed. @default false */
+    defaultConfirmed?: boolean;
+    /** Fires once, when the thumb reaches `threshold` — the action the slide guards. */
+    onConfirm?: () => void;
+    isDisabled?: boolean;
+    style?: StyleProp<ViewStyle>;
+};
+export type SlideButtonProps = SlideButtonOwnProps & Omit<ViewProps, keyof SlideButtonOwnProps> & Omit<ViewStyleProps, keyof SlideButtonOwnProps | keyof ViewProps>;
+type SlideButtonFillOwnProps = {
+    children?: never;
+};
+export type SlideButtonFillProps = SlideButtonFillOwnProps & Omit<ViewProps, 'children'> & Omit<ViewStyleProps, keyof ViewProps>;
+export type SlideButtonLabelProps = TextProps & Omit<TextStyleProps, keyof TextProps> & {
+    children?: ReactNode;
+};
+type SlideButtonThumbOwnProps = {
+    /** Replaces the built-in chevron — an `Icon`, or anything else. */
+    children?: ReactNode;
+};
+export type SlideButtonThumbProps = SlideButtonThumbOwnProps & Omit<ViewProps, keyof SlideButtonThumbOwnProps> & Omit<ViewStyleProps, keyof SlideButtonThumbOwnProps | keyof ViewProps>;
+export type SlideButtonIconProps = IconProps;
+/** R5 — resolved style ids and the shared progress the animated slots read. */
+export type SlideButtonContextValue = {
+    /** The window the trail is cut to — the pill's shape, so the cut stays off the handle. */
+    fillClipStyle: StyleProp<ViewStyle>;
+    fillStyle: StyleProp<ViewStyle>;
+    labelStyle: StyleProp<TextStyle>;
+    /** The label's swept copy, already carrying the width the clip must not re-centre it in. */
+    labelSweptStyle: StyleProp<TextStyle>;
+    thumbStyle: StyleProp<ViewStyle>;
+    glyphStyle: StyleProp<ViewStyle>;
+    icon: IconContextValue;
+    /** The handle's offset from the leading edge, in points, driven on the UI thread. */
+    offset: SharedValue<number>;
+    /** How far the handle can travel — the track's length less the handle and its insets. */
+    travel: number;
+    /** The handle's width, the amount the travel is shortened by. */
+    thumbSize: number;
+    /** The fraction of `travel` the thumb must reach for the slide to count, from 0 to 1. */
+    threshold: number;
+    isDisabled: boolean;
+    isConfirmed: boolean;
+    /** Called from the pan on release once the thumb has reached `threshold`. */
+    confirm: () => void;
+    /** The pill's measured width. Zero until it has been laid out. */
+    trackLength: number;
+};
+export {};

package/dist/components/slide-button/slide-button.type.d.ts

@@ -0,0 +1,79 @@
+import type { ReactNode } from 'react';
+import type { SharedValue } from 'react-native-reanimated';
+import type { StyleProp, TextProps, TextStyle, ViewProps, ViewStyle } from 'react-native';
+import type { IconContextValue, IconProps } from '../../system/icon';
+import type { TextStyleProps, ViewStyleProps } from '../../system/style-props';
+import type { RadiusKey } from '../../theme/theme.type';
+export type SlideButtonSlot = 'root' | 'fillClip' | 'fill' | 'label' | 'labelSwept' | 'thumb' | 'glyph';
+/**
+ * The flat variant union, the same ten values every control in the library takes. A
+ * slide-to-confirm is still a button — a slide-to-delete is a real `danger` use — so the
+ * intents stay.
+ */
+export type SlideButtonVariant = 'primary' | 'secondary' | 'tertiary' | 'ghost' | 'success' | 'success-soft' | 'warning' | 'warning-soft' | 'danger' | 'danger-soft';
+export type SlideButtonSize = 'sm' | 'md' | 'lg';
+type SlideButtonOwnProps = {
+    children?: ReactNode;
+    variant?: SlideButtonVariant;
+    /** Height, horizontal padding and the label's type. Never a width. */
+    size?: SlideButtonSize;
+    /** Overrides the pill's corner. `full` unless you say otherwise. */
+    radius?: RadiusKey;
+    /** A raw tint (R7). Lands on the pill, or on the label for `ghost` — never on the thumb. */
+    color?: string;
+    /**
+     * How far along the track the thumb has to reach for the slide to count, from 0 to 1.
+     * Below it the thumb springs home on release.
+     * @default 0.9
+     */
+    threshold?: number;
+    /** Controlled: `true` pins the thumb at the end, `false` springs it home. */
+    isConfirmed?: boolean;
+    /** The starting state when uncontrolled. Once confirmed it stays confirmed. @default false */
+    defaultConfirmed?: boolean;
+    /** Fires once, when the thumb reaches `threshold` — the action the slide guards. */
+    onConfirm?: () => void;
+    isDisabled?: boolean;
+    style?: StyleProp<ViewStyle>;
+};
+export type SlideButtonProps = SlideButtonOwnProps & Omit<ViewProps, keyof SlideButtonOwnProps> & Omit<ViewStyleProps, keyof SlideButtonOwnProps | keyof ViewProps>;
+type SlideButtonFillOwnProps = {
+    children?: never;
+};
+export type SlideButtonFillProps = SlideButtonFillOwnProps & Omit<ViewProps, 'children'> & Omit<ViewStyleProps, keyof ViewProps>;
+export type SlideButtonLabelProps = TextProps & Omit<TextStyleProps, keyof TextProps> & {
+    children?: ReactNode;
+};
+type SlideButtonThumbOwnProps = {
+    /** Replaces the built-in chevron — an `Icon`, or anything else. */
+    children?: ReactNode;
+};
+export type SlideButtonThumbProps = SlideButtonThumbOwnProps & Omit<ViewProps, keyof SlideButtonThumbOwnProps> & Omit<ViewStyleProps, keyof SlideButtonThumbOwnProps | keyof ViewProps>;
+export type SlideButtonIconProps = IconProps;
+/** R5 — resolved style ids and the shared progress the animated slots read. */
+export type SlideButtonContextValue = {
+    /** The window the trail is cut to — the pill's shape, so the cut stays off the handle. */
+    fillClipStyle: StyleProp<ViewStyle>;
+    fillStyle: StyleProp<ViewStyle>;
+    labelStyle: StyleProp<TextStyle>;
+    /** The label's swept copy, already carrying the width the clip must not re-centre it in. */
+    labelSweptStyle: StyleProp<TextStyle>;
+    thumbStyle: StyleProp<ViewStyle>;
+    glyphStyle: StyleProp<ViewStyle>;
+    icon: IconContextValue;
+    /** The handle's offset from the leading edge, in points, driven on the UI thread. */
+    offset: SharedValue<number>;
+    /** How far the handle can travel — the track's length less the handle and its insets. */
+    travel: number;
+    /** The handle's width, the amount the travel is shortened by. */
+    thumbSize: number;
+    /** The fraction of `travel` the thumb must reach for the slide to count, from 0 to 1. */
+    threshold: number;
+    isDisabled: boolean;
+    isConfirmed: boolean;
+    /** Called from the pan on release once the thumb has reached `threshold`. */
+    confirm: () => void;
+    /** The pill's measured width. Zero until it has been laid out. */
+    trackLength: number;
+};
+export {};

package/dist/components/slider/slider-thumb.d.cts

@@ -12,7 +12,7 @@ import type { SliderThumbProps } from './slider.type';
  * the scale can stay on the other thread.
  *
  * It is a **disc of the page's own colour inside a ring of the fill's**, which is the
- * legacy component's shape rather than HeroUI's capsule-with-a-core. A solid accent knob
+ * legacy component's shape rather than the reference implementation's capsule-with-a-core. A solid accent knob
  * on an accent fill disappears the moment the value reaches the top; a ring never does.
  */
 export declare function SliderThumb({ index, accessibilityValueText, style, ...props }: SliderThumbProps): import("react").JSX.Element;

package/dist/components/slider/slider-thumb.d.ts

@@ -12,7 +12,7 @@ import type { SliderThumbProps } from './slider.type';
  * the scale can stay on the other thread.
  *
  * It is a **disc of the page's own colour inside a ring of the fill's**, which is the
- * legacy component's shape rather than HeroUI's capsule-with-a-core. A solid accent knob
+ * legacy component's shape rather than the reference implementation's capsule-with-a-core. A solid accent knob
  * on an accent fill disappears the moment the value reaches the top; a ring never does.
  */
 export declare function SliderThumb({ index, accessibilityValueText, style, ...props }: SliderThumbProps): import("react").JSX.Element;

package/dist/components/slider/slider.recipe.d.cts

@@ -11,7 +11,7 @@ type SizeStep = {
  * The legacy slider's proportions, point for point.
  *
  * A **thin rail with a round knob on it**, not a capsule with a core inside — which is what
- * this component shipped as, borrowed from HeroUI's. The rail is 6 to 10 points and the
+ * this component shipped as, borrowed from the reference implementation's. The rail is 6 to 10 points and the
  * knob 16 to 24, so the knob overhangs the rail by half their difference on each side. That
  * overhang is the shape: it is what makes the knob read as sitting *on* a line rather than
  * as a segment *of* one.

package/dist/components/slider/slider.recipe.d.ts

@@ -11,7 +11,7 @@ type SizeStep = {
  * The legacy slider's proportions, point for point.
  *
  * A **thin rail with a round knob on it**, not a capsule with a core inside — which is what
- * this component shipped as, borrowed from HeroUI's. The rail is 6 to 10 points and the
+ * this component shipped as, borrowed from the reference implementation's. The rail is 6 to 10 points and the
  * knob 16 to 24, so the knob overhangs the rail by half their difference on each side. That
  * overhang is the shape: it is what makes the knob read as sitting *on* a line rather than
  * as a segment *of* one.

package/dist/components/spinner/spinner.d.cts

@@ -14,7 +14,7 @@ import type { StyleProp, ViewStyle } from 'react-native';
  * the same circle with a quarter missing. There is nothing between them for a slot to
  * name, and the two are one figure rather than two parts.
  *
- * It is HeroUI's spinner drawn with borders instead of a gradient stroke. Theirs fades a
+ * It is the reference implementation's spinner drawn with borders instead of a gradient stroke. Theirs fades a
  * single arc from opaque to 55%, which needs an SVG `linearGradient` and therefore
  * `react-native-svg` — an optional peer, which a component in the fifteen-component core
  * cannot require. Two circles of one ink at two opacities read as the same figure and

package/dist/components/spinner/spinner.d.ts

@@ -14,7 +14,7 @@ import type { StyleProp, ViewStyle } from 'react-native';
  * the same circle with a quarter missing. There is nothing between them for a slot to
  * name, and the two are one figure rather than two parts.
  *
- * It is HeroUI's spinner drawn with borders instead of a gradient stroke. Theirs fades a
+ * It is the reference implementation's spinner drawn with borders instead of a gradient stroke. Theirs fades a
  * single arc from opaque to 55%, which needs an SVG `linearGradient` and therefore
  * `react-native-svg` — an optional peer, which a component in the fifteen-component core
  * cannot require. Two circles of one ink at two opacities read as the same figure and

package/dist/components/switch/switch.style.d.cts

@@ -3,6 +3,6 @@
  * on two nodes, and they have to arrive together — which they only do if neither owns the
  * number.
  *
- * 175ms is HeroUI's, and it is the length of the platform's own switch.
+ * 175ms is the reference implementation's, and it is the length of the platform's own switch.
  */
 export declare const SWITCH_DURATION = 175;

package/dist/components/switch/switch.style.d.ts

@@ -3,6 +3,6 @@
  * on two nodes, and they have to arrive together — which they only do if neither owns the
  * number.
  *
- * 175ms is HeroUI's, and it is the length of the platform's own switch.
+ * 175ms is the reference implementation's, and it is the length of the platform's own switch.
  */
 export declare const SWITCH_DURATION = 175;