@xaui/native 0.9.1-alpha.9 → 0.9.1-alpha.90

package/dist/components/tag-group/tag-group-list.d.cts

@@ -0,0 +1,11 @@
+import { View } from 'react-native';
+/**
+ * The wrapping row.
+ *
+ * Wrapping is the point. A tag group is a set of the same kind of thing, and a set that
+ * scrolls sideways hides how many of it there are — which is the one fact a reader wants
+ * from a row of tags.
+ */
+export declare const TagGroupList: import("react").ForwardRefExoticComponent<{
+    children?: import("react").ReactNode;
+} & Omit<import("react-native").ViewProps, "children"> & Omit<import("../..").ViewStyleProps, keyof import("react-native").ViewProps> & import("react").RefAttributes<View>>;

package/dist/components/tag-group/tag-group-list.d.ts

@@ -0,0 +1,11 @@
+import { View } from 'react-native';
+/**
+ * The wrapping row.
+ *
+ * Wrapping is the point. A tag group is a set of the same kind of thing, and a set that
+ * scrolls sideways hides how many of it there are — which is the one fact a reader wants
+ * from a row of tags.
+ */
+export declare const TagGroupList: import("react").ForwardRefExoticComponent<{
+    children?: import("react").ReactNode;
+} & Omit<import("react-native").ViewProps, "children"> & Omit<import("../..").ViewStyleProps, keyof import("react-native").ViewProps> & import("react").RefAttributes<View>>;

package/dist/components/tag-group/tag-group.context.d.cts

@@ -0,0 +1,8 @@
+import type { TagGroupContextValue, TagGroupItemContextValue } from './tag-group.type';
+/**
+ * R10 — `useTagGroup` is exported so a third party can write its own slot against the same
+ * resolved values the built-in ones read. Outside a `<TagGroup>` it throws by name.
+ */
+export declare const TagGroupProvider: import("react").Provider<TagGroupContextValue | null>, useTagGroup: () => TagGroupContextValue;
+/** One tag's own state. Everything visual still comes from `useTagGroup()`. */
+export declare const TagGroupItemProvider: import("react").Provider<TagGroupItemContextValue | null>, useTagGroupItem: () => TagGroupItemContextValue;

package/dist/components/tag-group/tag-group.context.d.ts

@@ -0,0 +1,8 @@
+import type { TagGroupContextValue, TagGroupItemContextValue } from './tag-group.type';
+/**
+ * R10 — `useTagGroup` is exported so a third party can write its own slot against the same
+ * resolved values the built-in ones read. Outside a `<TagGroup>` it throws by name.
+ */
+export declare const TagGroupProvider: import("react").Provider<TagGroupContextValue | null>, useTagGroup: () => TagGroupContextValue;
+/** One tag's own state. Everything visual still comes from `useTagGroup()`. */
+export declare const TagGroupItemProvider: import("react").Provider<TagGroupItemContextValue | null>, useTagGroupItem: () => TagGroupItemContextValue;

package/dist/components/tag-group/tag-group.d.cts

@@ -0,0 +1,48 @@
+import { View } from 'react-native';
+/**
+ * A wrapping set of tags you can turn on, and take off.
+ *
+ * ```tsx
+ * <TagGroup selectionMode="multiple" onRemove={forget}>
+ *   <TagGroup.List>
+ *     <TagGroup.Item id="fr">
+ *       Français
+ *       <TagGroup.ItemRemoveButton />
+ *     </TagGroup.Item>
+ *   </TagGroup.List>
+ * </TagGroup>
+ * ```
+ *
+ * **This is not a row of `Chip`s.** A chip is a piece of metadata that is always the same;
+ * a tag is a piece of metadata you can turn on, take off, or both. The selection state and
+ * the removal are the component — the pill around them is the least of it.
+ */
+export declare const TagGroupRoot: import("react").ForwardRefExoticComponent<{
+    children?: import("react").ReactNode;
+    variant?: import("./tag-group.type").TagGroupVariant;
+    size?: import("./tag-group.type").TagGroupSize;
+    radius?: import("../..").RadiusKey;
+    color?: string;
+    selectionMode?: import("./tag-group.utils").TagSelectionMode;
+    selectedKeys?: readonly string[];
+    defaultSelectedKeys?: readonly string[];
+    onSelectionChange?: (keys: readonly string[]) => void;
+    onRemove?: (id: string) => void;
+    disabledKeys?: readonly string[];
+    isDisabled?: boolean;
+    isDeselectable?: boolean;
+} & Omit<import("react-native").ViewProps, keyof {
+    children?: import("react").ReactNode;
+    variant?: import("./tag-group.type").TagGroupVariant;
+    size?: import("./tag-group.type").TagGroupSize;
+    radius?: import("../..").RadiusKey;
+    color?: string;
+    selectionMode?: import("./tag-group.utils").TagSelectionMode;
+    selectedKeys?: readonly string[];
+    defaultSelectedKeys?: readonly string[];
+    onSelectionChange?: (keys: readonly string[]) => void;
+    onRemove?: (id: string) => void;
+    disabledKeys?: readonly string[];
+    isDisabled?: boolean;
+    isDeselectable?: boolean;
+}> & 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" | "selectionMode" | "onSelectionChange" | "selectedKeys" | "defaultSelectedKeys" | "disabledKeys" | "onRemove" | "isDeselectable"> & import("react").RefAttributes<View>>;

package/dist/components/tag-group/tag-group.d.ts

@@ -0,0 +1,48 @@
+import { View } from 'react-native';
+/**
+ * A wrapping set of tags you can turn on, and take off.
+ *
+ * ```tsx
+ * <TagGroup selectionMode="multiple" onRemove={forget}>
+ *   <TagGroup.List>
+ *     <TagGroup.Item id="fr">
+ *       Français
+ *       <TagGroup.ItemRemoveButton />
+ *     </TagGroup.Item>
+ *   </TagGroup.List>
+ * </TagGroup>
+ * ```
+ *
+ * **This is not a row of `Chip`s.** A chip is a piece of metadata that is always the same;
+ * a tag is a piece of metadata you can turn on, take off, or both. The selection state and
+ * the removal are the component — the pill around them is the least of it.
+ */
+export declare const TagGroupRoot: import("react").ForwardRefExoticComponent<{
+    children?: import("react").ReactNode;
+    variant?: import("./tag-group.type").TagGroupVariant;
+    size?: import("./tag-group.type").TagGroupSize;
+    radius?: import("../..").RadiusKey;
+    color?: string;
+    selectionMode?: import("./tag-group.utils").TagSelectionMode;
+    selectedKeys?: readonly string[];
+    defaultSelectedKeys?: readonly string[];
+    onSelectionChange?: (keys: readonly string[]) => void;
+    onRemove?: (id: string) => void;
+    disabledKeys?: readonly string[];
+    isDisabled?: boolean;
+    isDeselectable?: boolean;
+} & Omit<import("react-native").ViewProps, keyof {
+    children?: import("react").ReactNode;
+    variant?: import("./tag-group.type").TagGroupVariant;
+    size?: import("./tag-group.type").TagGroupSize;
+    radius?: import("../..").RadiusKey;
+    color?: string;
+    selectionMode?: import("./tag-group.utils").TagSelectionMode;
+    selectedKeys?: readonly string[];
+    defaultSelectedKeys?: readonly string[];
+    onSelectionChange?: (keys: readonly string[]) => void;
+    onRemove?: (id: string) => void;
+    disabledKeys?: readonly string[];
+    isDisabled?: boolean;
+    isDeselectable?: boolean;
+}> & 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" | "selectionMode" | "onSelectionChange" | "selectedKeys" | "defaultSelectedKeys" | "disabledKeys" | "onRemove" | "isDeselectable"> & import("react").RefAttributes<View>>;

package/dist/components/tag-group/tag-group.recipe.d.cts

@@ -0,0 +1,18 @@
+import type { SlotStyles } from '../../system/recipe';
+import type { RadiusKey, XAUITheme } from '../../theme/theme.type';
+import type { TagGroupSlot, TagGroupVariant } from './tag-group.type';
+export declare const tagGroupRecipe: import("../..").Recipe<"list" | "root" | "item" | "close" | "closeGlyph" | "itemLabel", TagGroupVariant, {
+    readonly size: {
+        readonly sm: (theme: XAUITheme) => SlotStyles<TagGroupSlot>;
+        readonly md: (theme: XAUITheme) => SlotStyles<TagGroupSlot>;
+        readonly lg: (theme: XAUITheme) => SlotStyles<TagGroupSlot>;
+    };
+    /**
+     * The selected face, resolved on the root beside the resting one so a group of forty
+     * tags costs what a group of two costs and no slot touches the recipe (R5).
+     */
+    readonly isSelected: {
+        readonly true: (theme: XAUITheme) => SlotStyles<TagGroupSlot>;
+    };
+    readonly radius: Record<RadiusKey, import("../..").StyleFn<"item">>;
+}>;

package/dist/components/tag-group/tag-group.recipe.d.ts

@@ -0,0 +1,18 @@
+import type { SlotStyles } from '../../system/recipe';
+import type { RadiusKey, XAUITheme } from '../../theme/theme.type';
+import type { TagGroupSlot, TagGroupVariant } from './tag-group.type';
+export declare const tagGroupRecipe: import("../..").Recipe<"list" | "root" | "item" | "close" | "closeGlyph" | "itemLabel", TagGroupVariant, {
+    readonly size: {
+        readonly sm: (theme: XAUITheme) => SlotStyles<TagGroupSlot>;
+        readonly md: (theme: XAUITheme) => SlotStyles<TagGroupSlot>;
+        readonly lg: (theme: XAUITheme) => SlotStyles<TagGroupSlot>;
+    };
+    /**
+     * The selected face, resolved on the root beside the resting one so a group of forty
+     * tags costs what a group of two costs and no slot touches the recipe (R5).
+     */
+    readonly isSelected: {
+        readonly true: (theme: XAUITheme) => SlotStyles<TagGroupSlot>;
+    };
+    readonly radius: Record<RadiusKey, import("../..").StyleFn<"item">>;
+}>;

package/dist/components/tag-group/tag-group.type.d.cts

@@ -0,0 +1,90 @@
+import type { ReactNode } from 'react';
+import type { PressableProps, StyleProp, TextProps, TextStyle, ViewProps, ViewStyle } from 'react-native';
+import type { TextStyleProps, ViewStyleProps } from '../../system/style-props';
+import type { RadiusKey } from '../../theme/theme.type';
+import type { TagSelectionMode } from './tag-group.utils';
+export type { TagSelectionMode } from './tag-group.utils';
+export type TagGroupSlot = 'root' | 'list' | 'item' | 'itemLabel' | 'close' | 'closeGlyph';
+/**
+ * Two grounds, not two emphases. `default` is the theme's neutral fill; `surface` is the
+ * card colour, for a group sitting **on** the page rather than on a card — the two swap
+ * so a tag never disappears into whatever is behind it.
+ */
+export type TagGroupVariant = 'default' | 'surface';
+export type TagGroupSize = 'sm' | 'md' | 'lg';
+type TagGroupOwnProps = {
+    children?: ReactNode;
+    variant?: TagGroupVariant;
+    size?: TagGroupSize;
+    radius?: RadiusKey;
+    /** The tint (R7) — a raw value, never a token. Paints a selected tag. */
+    color?: string;
+    selectionMode?: TagSelectionMode;
+    selectedKeys?: readonly string[];
+    defaultSelectedKeys?: readonly string[];
+    onSelectionChange?: (keys: readonly string[]) => void;
+    /** Present is what makes a `TagGroup.ItemRemoveButton` do anything. */
+    onRemove?: (id: string) => void;
+    /** Ids that take no press. The group's own `isDisabled` covers all of them. */
+    disabledKeys?: readonly string[];
+    isDisabled?: boolean;
+    /**
+     * Whether pressing the selected tag clears it. Off, a `single` group always has one.
+     *
+     * @default true
+     */
+    isDeselectable?: boolean;
+};
+export type TagGroupProps = TagGroupOwnProps & Omit<ViewProps, keyof TagGroupOwnProps> & Omit<ViewStyleProps, keyof TagGroupOwnProps | keyof ViewProps>;
+type ListOwnProps = {
+    children?: ReactNode;
+};
+export type TagGroupListProps = ListOwnProps & Omit<ViewProps, keyof ListOwnProps> & Omit<ViewStyleProps, keyof ListOwnProps | keyof ViewProps>;
+/** What an item's render function is handed. */
+export type TagItemRenderState = {
+    isSelected: boolean;
+    isPressed: boolean;
+    isDisabled: boolean;
+};
+type ItemOwnProps = {
+    id: string;
+    isDisabled?: boolean;
+    children?: ReactNode | ((state: TagItemRenderState) => ReactNode);
+    asChild?: boolean;
+};
+export type TagGroupItemProps = ItemOwnProps & Omit<PressableProps, keyof ItemOwnProps> & Omit<ViewStyleProps, keyof ItemOwnProps | keyof PressableProps>;
+type ItemLabelOwnProps = {
+    children?: ReactNode;
+};
+export type TagGroupItemLabelProps = ItemLabelOwnProps & Omit<TextProps, keyof ItemLabelOwnProps> & Omit<TextStyleProps, keyof ItemLabelOwnProps | keyof TextProps>;
+type RemoveOwnProps = {
+    children?: ReactNode;
+    asChild?: boolean;
+    /** An explicit value wins over the tag's own. */
+    isDisabled?: boolean;
+};
+export type TagGroupItemRemoveButtonProps = RemoveOwnProps & Omit<PressableProps, keyof RemoveOwnProps> & Omit<ViewStyleProps, keyof RemoveOwnProps | keyof PressableProps>;
+/** R5 — resolved style ids and the state the slots read. */
+export type TagGroupContextValue = {
+    listStyle: StyleProp<ViewStyle>;
+    itemStyle: StyleProp<ViewStyle>;
+    itemSelectedStyle: StyleProp<ViewStyle>;
+    itemLabelStyle: StyleProp<TextStyle>;
+    itemLabelSelectedStyle: StyleProp<TextStyle>;
+    closeStyle: StyleProp<ViewStyle>;
+    closeGlyphStyle: StyleProp<ViewStyle>;
+    closeGlyphSelectedStyle: StyleProp<ViewStyle>;
+    glyph: {
+        size?: number;
+        color?: string;
+    };
+    isDisabled: boolean;
+    isSelected: (id: string) => boolean;
+    isKeyDisabled: (id: string) => boolean;
+    select: (id: string) => void;
+    remove: ((id: string) => void) | undefined;
+};
+/** One tag's own state, for the slots inside it. */
+export type TagGroupItemContextValue = TagItemRenderState & {
+    id: string;
+};

package/dist/components/tag-group/tag-group.type.d.ts

@@ -0,0 +1,90 @@
+import type { ReactNode } from 'react';
+import type { PressableProps, StyleProp, TextProps, TextStyle, ViewProps, ViewStyle } from 'react-native';
+import type { TextStyleProps, ViewStyleProps } from '../../system/style-props';
+import type { RadiusKey } from '../../theme/theme.type';
+import type { TagSelectionMode } from './tag-group.utils';
+export type { TagSelectionMode } from './tag-group.utils';
+export type TagGroupSlot = 'root' | 'list' | 'item' | 'itemLabel' | 'close' | 'closeGlyph';
+/**
+ * Two grounds, not two emphases. `default` is the theme's neutral fill; `surface` is the
+ * card colour, for a group sitting **on** the page rather than on a card — the two swap
+ * so a tag never disappears into whatever is behind it.
+ */
+export type TagGroupVariant = 'default' | 'surface';
+export type TagGroupSize = 'sm' | 'md' | 'lg';
+type TagGroupOwnProps = {
+    children?: ReactNode;
+    variant?: TagGroupVariant;
+    size?: TagGroupSize;
+    radius?: RadiusKey;
+    /** The tint (R7) — a raw value, never a token. Paints a selected tag. */
+    color?: string;
+    selectionMode?: TagSelectionMode;
+    selectedKeys?: readonly string[];
+    defaultSelectedKeys?: readonly string[];
+    onSelectionChange?: (keys: readonly string[]) => void;
+    /** Present is what makes a `TagGroup.ItemRemoveButton` do anything. */
+    onRemove?: (id: string) => void;
+    /** Ids that take no press. The group's own `isDisabled` covers all of them. */
+    disabledKeys?: readonly string[];
+    isDisabled?: boolean;
+    /**
+     * Whether pressing the selected tag clears it. Off, a `single` group always has one.
+     *
+     * @default true
+     */
+    isDeselectable?: boolean;
+};
+export type TagGroupProps = TagGroupOwnProps & Omit<ViewProps, keyof TagGroupOwnProps> & Omit<ViewStyleProps, keyof TagGroupOwnProps | keyof ViewProps>;
+type ListOwnProps = {
+    children?: ReactNode;
+};
+export type TagGroupListProps = ListOwnProps & Omit<ViewProps, keyof ListOwnProps> & Omit<ViewStyleProps, keyof ListOwnProps | keyof ViewProps>;
+/** What an item's render function is handed. */
+export type TagItemRenderState = {
+    isSelected: boolean;
+    isPressed: boolean;
+    isDisabled: boolean;
+};
+type ItemOwnProps = {
+    id: string;
+    isDisabled?: boolean;
+    children?: ReactNode | ((state: TagItemRenderState) => ReactNode);
+    asChild?: boolean;
+};
+export type TagGroupItemProps = ItemOwnProps & Omit<PressableProps, keyof ItemOwnProps> & Omit<ViewStyleProps, keyof ItemOwnProps | keyof PressableProps>;
+type ItemLabelOwnProps = {
+    children?: ReactNode;
+};
+export type TagGroupItemLabelProps = ItemLabelOwnProps & Omit<TextProps, keyof ItemLabelOwnProps> & Omit<TextStyleProps, keyof ItemLabelOwnProps | keyof TextProps>;
+type RemoveOwnProps = {
+    children?: ReactNode;
+    asChild?: boolean;
+    /** An explicit value wins over the tag's own. */
+    isDisabled?: boolean;
+};
+export type TagGroupItemRemoveButtonProps = RemoveOwnProps & Omit<PressableProps, keyof RemoveOwnProps> & Omit<ViewStyleProps, keyof RemoveOwnProps | keyof PressableProps>;
+/** R5 — resolved style ids and the state the slots read. */
+export type TagGroupContextValue = {
+    listStyle: StyleProp<ViewStyle>;
+    itemStyle: StyleProp<ViewStyle>;
+    itemSelectedStyle: StyleProp<ViewStyle>;
+    itemLabelStyle: StyleProp<TextStyle>;
+    itemLabelSelectedStyle: StyleProp<TextStyle>;
+    closeStyle: StyleProp<ViewStyle>;
+    closeGlyphStyle: StyleProp<ViewStyle>;
+    closeGlyphSelectedStyle: StyleProp<ViewStyle>;
+    glyph: {
+        size?: number;
+        color?: string;
+    };
+    isDisabled: boolean;
+    isSelected: (id: string) => boolean;
+    isKeyDisabled: (id: string) => boolean;
+    select: (id: string) => void;
+    remove: ((id: string) => void) | undefined;
+};
+/** One tag's own state, for the slots inside it. */
+export type TagGroupItemContextValue = TagItemRenderState & {
+    id: string;
+};

package/dist/components/tag-group/tag-group.utils.d.cts

@@ -0,0 +1,11 @@
+/** The selection rule, and the whole of it. */
+export type TagSelectionMode = 'none' | 'single' | 'multiple';
+/**
+ * What is selected after one tag is pressed.
+ *
+ * Returns the list **unchanged** when the press changes nothing, which is how a caller's
+ * `onSelectionChange` never fires for a change that did not happen: `none` refuses every
+ * press, and `single` on the already-selected tag deselects it unless that would leave the
+ * group empty and the caller asked it not to.
+ */
+export declare function nextSelection(selected: readonly string[], id: string, mode: TagSelectionMode, isDeselectable: boolean): readonly string[];

package/dist/components/tag-group/tag-group.utils.d.ts

@@ -0,0 +1,11 @@
+/** The selection rule, and the whole of it. */
+export type TagSelectionMode = 'none' | 'single' | 'multiple';
+/**
+ * What is selected after one tag is pressed.
+ *
+ * Returns the list **unchanged** when the press changes nothing, which is how a caller's
+ * `onSelectionChange` never fires for a change that did not happen: `none` refuses every
+ * press, and `single` on the already-selected tag deselects it unless that would leave the
+ * group empty and the caller asked it not to.
+ */
+export declare function nextSelection(selected: readonly string[], id: string, mode: TagSelectionMode, isDeselectable: boolean): readonly string[];

package/dist/components/text-area/index.cjs

@@ -0,0 +1,18 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkYCQEX25Bcjs = require('../../chunk-YCQEX25B.cjs');
+require('../../chunk-AXKDHX5V.cjs');
+require('../../chunk-WLWZG2PA.cjs');
+require('../../chunk-FHNIGHN5.cjs');
+require('../../chunk-SL3V7R2Y.cjs');
+require('../../chunk-TVJXC4HY.cjs');
+require('../../chunk-CDRGTUYF.cjs');
+require('../../chunk-H4E4HDEP.cjs');
+require('../../chunk-EJQCQPET.cjs');
+require('../../chunk-IIAQISBG.cjs');
+require('../../chunk-TK44VBIE.cjs');
+
+
+
+exports.TextArea = _chunkYCQEX25Bcjs.TextArea; exports.useTextArea = _chunkYCQEX25Bcjs.useTextArea;

package/dist/components/text-area/index.d.cts

@@ -0,0 +1,26 @@
+/**
+ * Three of the four slots **are** the `TextField`'s, re-exported rather than wrapped.
+ *
+ * A wrapper would add three components to the tree to change a `displayName` string, and
+ * the string it would change is the one that tells you the truth: a `XAUI.TextField.Label`
+ * showing up inside a `XAUI.TextArea.Root` is exactly what is happening. Only the field
+ * differs, and it is the only one written here.
+ */
+export declare const TextArea: import("react").ForwardRefExoticComponent<Omit<import("..").TextFieldProps, "children"> & {
+    rows?: number;
+    maxRows?: number;
+    children?: import("react").ReactNode;
+} & import("react").RefAttributes<import("react-native").View>> & {
+    Label: import("react").ForwardRefExoticComponent<import("react-native").TextProps & Omit<import("../..").TextStyleProps, keyof import("react-native").TextProps> & {
+        children?: import("react").ReactNode;
+    } & import("react").RefAttributes<import("react-native").Text>>;
+    Field: import("react").ForwardRefExoticComponent<import("./text-area.type").TextAreaFieldProps & import("react").RefAttributes<import("react-native").TextInput>>;
+    Description: import("react").ForwardRefExoticComponent<import("react-native").TextProps & Omit<import("../..").TextStyleProps, keyof import("react-native").TextProps> & {
+        children?: import("react").ReactNode;
+    } & import("react").RefAttributes<import("react-native").Text>>;
+    Error: import("react").ForwardRefExoticComponent<import("react-native").TextProps & Omit<import("../..").TextStyleProps, keyof import("react-native").TextProps> & {
+        children?: import("react").ReactNode;
+    } & import("react").RefAttributes<import("react-native").Text>>;
+};
+export { useTextArea } from './text-area.context';
+export type { TextAreaContextValue, TextAreaFieldProps, TextAreaProps, } from './text-area.type';

package/dist/components/text-area/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Three of the four slots **are** the `TextField`'s, re-exported rather than wrapped.
+ *
+ * A wrapper would add three components to the tree to change a `displayName` string, and
+ * the string it would change is the one that tells you the truth: a `XAUI.TextField.Label`
+ * showing up inside a `XAUI.TextArea.Root` is exactly what is happening. Only the field
+ * differs, and it is the only one written here.
+ */
+export declare const TextArea: import("react").ForwardRefExoticComponent<Omit<import("..").TextFieldProps, "children"> & {
+    rows?: number;
+    maxRows?: number;
+    children?: import("react").ReactNode;
+} & import("react").RefAttributes<import("react-native").View>> & {
+    Label: import("react").ForwardRefExoticComponent<import("react-native").TextProps & Omit<import("../..").TextStyleProps, keyof import("react-native").TextProps> & {
+        children?: import("react").ReactNode;
+    } & import("react").RefAttributes<import("react-native").Text>>;
+    Field: import("react").ForwardRefExoticComponent<import("./text-area.type").TextAreaFieldProps & import("react").RefAttributes<import("react-native").TextInput>>;
+    Description: import("react").ForwardRefExoticComponent<import("react-native").TextProps & Omit<import("../..").TextStyleProps, keyof import("react-native").TextProps> & {
+        children?: import("react").ReactNode;
+    } & import("react").RefAttributes<import("react-native").Text>>;
+    Error: import("react").ForwardRefExoticComponent<import("react-native").TextProps & Omit<import("../..").TextStyleProps, keyof import("react-native").TextProps> & {
+        children?: import("react").ReactNode;
+    } & import("react").RefAttributes<import("react-native").Text>>;
+};
+export { useTextArea } from './text-area.context';
+export type { TextAreaContextValue, TextAreaFieldProps, TextAreaProps, } from './text-area.type';

package/dist/components/text-area/index.js

@@ -0,0 +1,18 @@
+import {
+  TextArea,
+  useTextArea
+} from "../../chunk-DN3X5WIB.js";
+import "../../chunk-5YZUYSV7.js";
+import "../../chunk-43S673KF.js";
+import "../../chunk-WFZDAXDI.js";
+import "../../chunk-DKVXTMIJ.js";
+import "../../chunk-3Q42X6EQ.js";
+import "../../chunk-TTZOIXKE.js";
+import "../../chunk-36PRYGAM.js";
+import "../../chunk-EGLLDKN6.js";
+import "../../chunk-Z6JBWRPL.js";
+import "../../chunk-M63GFNKV.js";
+export {
+  TextArea,
+  useTextArea
+};

package/dist/components/text-area/text-area-field.d.cts

@@ -0,0 +1,16 @@
+import { TextInput } from 'react-native';
+import type { TextAreaFieldProps } from './text-area.type';
+/**
+ * The `TextInput` itself — `TextField.Field` with the three things several lines need:
+ * `multiline`, the text pinned to the top, and a height counted in lines.
+ *
+ * It renders the `TextField`'s field rather than a second `TextInput`, so the focus plumbing,
+ * the placeholder colour, the label association and `isDisabled` are the ones already
+ * written. What it adds is layered **over** the field's own style: the recipe resolved the
+ * colours, the border and the radius once for both.
+ *
+ * The height is arithmetic rather than a token, because `rows` is a raw value (R6): the
+ * root published the line height and the vertical padding its `size` chose, and this
+ * multiplies. That is what lets `rows={7}` exist without seven entries in the style cache.
+ */
+export declare const TextAreaField: import("react").ForwardRefExoticComponent<TextAreaFieldProps & import("react").RefAttributes<TextInput>>;

package/dist/components/text-area/text-area-field.d.ts

@@ -0,0 +1,16 @@
+import { TextInput } from 'react-native';
+import type { TextAreaFieldProps } from './text-area.type';
+/**
+ * The `TextInput` itself — `TextField.Field` with the three things several lines need:
+ * `multiline`, the text pinned to the top, and a height counted in lines.
+ *
+ * It renders the `TextField`'s field rather than a second `TextInput`, so the focus plumbing,
+ * the placeholder colour, the label association and `isDisabled` are the ones already
+ * written. What it adds is layered **over** the field's own style: the recipe resolved the
+ * colours, the border and the radius once for both.
+ *
+ * The height is arithmetic rather than a token, because `rows` is a raw value (R6): the
+ * root published the line height and the vertical padding its `size` chose, and this
+ * multiplies. That is what lets `rows={7}` exist without seven entries in the style cache.
+ */
+export declare const TextAreaField: import("react").ForwardRefExoticComponent<TextAreaFieldProps & import("react").RefAttributes<TextInput>>;

package/dist/components/text-area/text-area.context.d.cts

@@ -0,0 +1,8 @@
+import type { TextAreaContextValue } from './text-area.type';
+/**
+ * R10 — `useTextArea` is exported so a third party can write their own field against the
+ * same values the built-in one reads. It carries **only** what the `TextField`'s own context
+ * cannot: the two row counts. Everything visual comes from `useTextField()`, because a text
+ * area is a `TextField` and its styles were resolved there.
+ */
+export declare const TextAreaProvider: import("react").Provider<TextAreaContextValue | null>, useTextArea: () => TextAreaContextValue;

package/dist/components/text-area/text-area.context.d.ts

@@ -0,0 +1,8 @@
+import type { TextAreaContextValue } from './text-area.type';
+/**
+ * R10 — `useTextArea` is exported so a third party can write their own field against the
+ * same values the built-in one reads. It carries **only** what the `TextField`'s own context
+ * cannot: the two row counts. Everything visual comes from `useTextField()`, because a text
+ * area is a `TextField` and its styles were resolved there.
+ */
+export declare const TextAreaProvider: import("react").Provider<TextAreaContextValue | null>, useTextArea: () => TextAreaContextValue;

package/dist/components/text-area/text-area.d.cts

@@ -0,0 +1,30 @@
+import type { View } from 'react-native';
+/**
+ * A multiline field, with the label, the hint and the error that make it usable.
+ *
+ * ```tsx
+ * <TextArea rows={4} maxRows={8}>
+ *   <TextArea.Label>Message</TextArea.Label>
+ *   <TextArea.Field placeholder="Racontez-nous." />
+ *   <TextArea.Description>Trois lignes suffisent.</TextArea.Description>
+ * </TextArea>
+ * ```
+ *
+ * **It is a `TextField`.** The root below is the `TextField`'s root, unchanged: the same recipe,
+ * the same resolved context, the same four variants, the same `size`, `radius`, `color`,
+ * `labelPlacement`, `isInvalid` and `isDisabled`. `TextArea.Label`, `.Description` and
+ * `.Error` **are** the `TextField`'s slots — not wrappers around them, the same components —
+ * and only `TextArea.Field` differs, by being multiline and by taking its height in lines.
+ *
+ * That is also HeroUI's answer: their `TextArea` renders their `TextField` with three defaults.
+ * A component of its own is what a caller looks for; sharing every line of it is what
+ * keeps the two from drifting.
+ *
+ * `rows` and `maxRows` are the only props this adds, and they are here rather than on the
+ * field for the reason `size` is: the root is where the field's shape is decided.
+ */
+export declare const TextAreaRoot: import("react").ForwardRefExoticComponent<Omit<import("..").TextFieldProps, "children"> & {
+    rows?: number;
+    maxRows?: number;
+    children?: import("react").ReactNode;
+} & import("react").RefAttributes<View>>;

package/dist/components/text-area/text-area.d.ts

@@ -0,0 +1,30 @@
+import type { View } from 'react-native';
+/**
+ * A multiline field, with the label, the hint and the error that make it usable.
+ *
+ * ```tsx
+ * <TextArea rows={4} maxRows={8}>
+ *   <TextArea.Label>Message</TextArea.Label>
+ *   <TextArea.Field placeholder="Racontez-nous." />
+ *   <TextArea.Description>Trois lignes suffisent.</TextArea.Description>
+ * </TextArea>
+ * ```
+ *
+ * **It is a `TextField`.** The root below is the `TextField`'s root, unchanged: the same recipe,
+ * the same resolved context, the same four variants, the same `size`, `radius`, `color`,
+ * `labelPlacement`, `isInvalid` and `isDisabled`. `TextArea.Label`, `.Description` and
+ * `.Error` **are** the `TextField`'s slots — not wrappers around them, the same components —
+ * and only `TextArea.Field` differs, by being multiline and by taking its height in lines.
+ *
+ * That is also HeroUI's answer: their `TextArea` renders their `TextField` with three defaults.
+ * A component of its own is what a caller looks for; sharing every line of it is what
+ * keeps the two from drifting.
+ *
+ * `rows` and `maxRows` are the only props this adds, and they are here rather than on the
+ * field for the reason `size` is: the root is where the field's shape is decided.
+ */
+export declare const TextAreaRoot: import("react").ForwardRefExoticComponent<Omit<import("..").TextFieldProps, "children"> & {
+    rows?: number;
+    maxRows?: number;
+    children?: import("react").ReactNode;
+} & import("react").RefAttributes<View>>;