@xaui/native 0.9.1-alpha.20 → 0.9.1-alpha.22

package/dist/system/index.cjs

@@ -2,14 +2,16 @@
 
 
 
-var _chunk2WMVDMFVcjs = require('../chunk-2WMVDMFV.cjs');
+var _chunk6HXWQ5AUcjs = require('../chunk-6HXWQ5AU.cjs');
 
 
 
+var _chunk6WW4CSPYcjs = require('../chunk-6WW4CSPY.cjs');
 
 
 
 
+var _chunkDXGQ43IVcjs = require('../chunk-DXGQ43IV.cjs');
 
 
 
@@ -27,19 +29,24 @@ var _chunk2WMVDMFVcjs = require('../chunk-2WMVDMFV.cjs');
 
 
 
-var _chunkA4VD4MHKcjs = require('../chunk-A4VD4MHK.cjs');
 
 
-var _chunkUVO4GFSWcjs = require('../chunk-UVO4GFSW.cjs');
 
 
+var _chunkBH5DSJVXcjs = require('../chunk-BH5DSJVX.cjs');
 
 
 
+var _chunkYXVKQMCKcjs = require('../chunk-YXVKQMCK.cjs');
+require('../chunk-57SJ4LJF.cjs');
 
 
-var _chunkEVXZGNPAcjs = require('../chunk-EVXZGNPA.cjs');
-require('../chunk-57SJ4LJF.cjs');
+
+
+
+
+
+var _chunkHUZ4AUM2cjs = require('../chunk-HUZ4AUM2.cjs');
 require('../chunk-MC7SY2QH.cjs');
 
 
@@ -75,4 +82,7 @@ require('../chunk-MC7SY2QH.cjs');
 
 
 
-exports.FEEDBACK_OVERLAY = _chunkA4VD4MHKcjs.FEEDBACK_OVERLAY; exports.HIGHLIGHT_DURATION = _chunkA4VD4MHKcjs.HIGHLIGHT_DURATION; exports.HIGHLIGHT_OPACITY = _chunkA4VD4MHKcjs.HIGHLIGHT_OPACITY; exports.Icon = _chunkA4VD4MHKcjs.Icon; exports.IconContext = _chunkA4VD4MHKcjs.IconContext; exports.PRESS_DURATION = _chunkA4VD4MHKcjs.PRESS_DURATION; exports.PRESS_SCALE = _chunkA4VD4MHKcjs.PRESS_SCALE; exports.Portal = _chunk2WMVDMFVcjs.Portal; exports.PortalContext = _chunk2WMVDMFVcjs.PortalContext; exports.PortalHost = _chunk2WMVDMFVcjs.PortalHost; exports.PressableFeedback = _chunkA4VD4MHKcjs.PressableFeedback; exports.RIPPLE_CONFIRM_DURATION = _chunkA4VD4MHKcjs.RIPPLE_CONFIRM_DURATION; exports.RIPPLE_EXPAND_DURATION = _chunkA4VD4MHKcjs.RIPPLE_EXPAND_DURATION; exports.RIPPLE_FADE_IN = _chunkA4VD4MHKcjs.RIPPLE_FADE_IN; exports.RIPPLE_FADE_OUT = _chunkA4VD4MHKcjs.RIPPLE_FADE_OUT; exports.RIPPLE_FADE_OUT_DELAY = _chunkA4VD4MHKcjs.RIPPLE_FADE_OUT_DELAY; exports.RIPPLE_OPACITY = _chunkA4VD4MHKcjs.RIPPLE_OPACITY; exports.RIPPLE_START_SCALE = _chunkA4VD4MHKcjs.RIPPLE_START_SCALE; exports.SCALE_REFERENCE_WIDTH = _chunkA4VD4MHKcjs.SCALE_REFERENCE_WIDTH; exports.Slot = _chunkEVXZGNPAcjs.Slot; exports.childrenToString = _chunkEVXZGNPAcjs.childrenToString; exports.createRecipe = _chunkUVO4GFSWcjs.createRecipe; exports.createSlotContext = _chunkEVXZGNPAcjs.createSlotContext; exports.markOverlay = _chunkA4VD4MHKcjs.markOverlay; exports.mergeProps = _chunkEVXZGNPAcjs.mergeProps; exports.mergeRefs = _chunkEVXZGNPAcjs.mergeRefs; exports.pressScaleFor = _chunkA4VD4MHKcjs.pressScaleFor; exports.resolveAnimation = _chunkA4VD4MHKcjs.resolveAnimation; exports.resolveSlotAnimation = _chunkA4VD4MHKcjs.resolveSlotAnimation; exports.rippleRadiusFor = _chunkA4VD4MHKcjs.rippleRadiusFor; exports.useFeedback = _chunkA4VD4MHKcjs.useFeedback; exports.useIconContext = _chunkA4VD4MHKcjs.useIconContext; exports.useStyleProps = _chunkEVXZGNPAcjs.useStyleProps;
+
+
+
+exports.CloseButton = _chunk6WW4CSPYcjs.CloseButton; exports.FEEDBACK_OVERLAY = _chunkBH5DSJVXcjs.FEEDBACK_OVERLAY; exports.HIGHLIGHT_DURATION = _chunkBH5DSJVXcjs.HIGHLIGHT_DURATION; exports.HIGHLIGHT_OPACITY = _chunkBH5DSJVXcjs.HIGHLIGHT_OPACITY; exports.Icon = _chunkDXGQ43IVcjs.Icon; exports.IconContext = _chunkDXGQ43IVcjs.IconContext; exports.PRESS_DURATION = _chunkBH5DSJVXcjs.PRESS_DURATION; exports.PRESS_SCALE = _chunkBH5DSJVXcjs.PRESS_SCALE; exports.Portal = _chunk6HXWQ5AUcjs.Portal; exports.PortalContext = _chunk6HXWQ5AUcjs.PortalContext; exports.PortalHost = _chunk6HXWQ5AUcjs.PortalHost; exports.PressableFeedback = _chunkBH5DSJVXcjs.PressableFeedback; exports.RIPPLE_CONFIRM_DURATION = _chunkBH5DSJVXcjs.RIPPLE_CONFIRM_DURATION; exports.RIPPLE_EXPAND_DURATION = _chunkBH5DSJVXcjs.RIPPLE_EXPAND_DURATION; exports.RIPPLE_FADE_IN = _chunkBH5DSJVXcjs.RIPPLE_FADE_IN; exports.RIPPLE_FADE_OUT = _chunkBH5DSJVXcjs.RIPPLE_FADE_OUT; exports.RIPPLE_FADE_OUT_DELAY = _chunkBH5DSJVXcjs.RIPPLE_FADE_OUT_DELAY; exports.RIPPLE_OPACITY = _chunkBH5DSJVXcjs.RIPPLE_OPACITY; exports.RIPPLE_START_SCALE = _chunkBH5DSJVXcjs.RIPPLE_START_SCALE; exports.SCALE_REFERENCE_WIDTH = _chunkBH5DSJVXcjs.SCALE_REFERENCE_WIDTH; exports.Slot = _chunkHUZ4AUM2cjs.Slot; exports.childrenToString = _chunkHUZ4AUM2cjs.childrenToString; exports.closeButtonBase = _chunk6WW4CSPYcjs.closeButtonBase; exports.createRecipe = _chunkYXVKQMCKcjs.createRecipe; exports.createSlotContext = _chunkHUZ4AUM2cjs.createSlotContext; exports.markOverlay = _chunkBH5DSJVXcjs.markOverlay; exports.mergeProps = _chunkHUZ4AUM2cjs.mergeProps; exports.mergeRefs = _chunkHUZ4AUM2cjs.mergeRefs; exports.pressScaleFor = _chunkBH5DSJVXcjs.pressScaleFor; exports.radiusAxis = _chunkYXVKQMCKcjs.radiusAxis; exports.resolveAnimation = _chunkBH5DSJVXcjs.resolveAnimation; exports.resolveSlotAnimation = _chunkBH5DSJVXcjs.resolveSlotAnimation; exports.rippleRadiusFor = _chunkBH5DSJVXcjs.rippleRadiusFor; exports.useFeedback = _chunkBH5DSJVXcjs.useFeedback; exports.useIconContext = _chunkDXGQ43IVcjs.useIconContext; exports.useStyleProps = _chunkHUZ4AUM2cjs.useStyleProps;

package/dist/system/index.d.cts

@@ -1,14 +1,18 @@
+import * as react_native from 'react-native';
+import { StyleProp, ViewStyle, View } from 'react-native';
 import * as react from 'react';
 import { ReactNode, Provider, Ref, RefCallback } from 'react';
-import { b as IconProps, a as IconContextValue, S as SlotAnimation, F as FeedbackContext, c as AnimationProp, d as ResolvedAnimation } from '../pressable-feedback.type-1K8YEOb8.cjs';
-export { A as AnimationConfig, I as IconComponentProps, P as PressableFeedbackProps, R as RadiusStyle, e as RippleWave } from '../pressable-feedback.type-1K8YEOb8.cjs';
-import { V as ViewStyleProps } from '../style-props.type-B1BG5TCm.cjs';
-export { D as DirectionalStyleKey, I as ImageStyleProps, S as StyleProps, T as TextStyleProps } from '../style-props.type-B1BG5TCm.cjs';
-import * as react_native from 'react-native';
-import { StyleProp, ViewStyle } from 'react-native';
-export { A as Axes, C as CompoundVariant, R as Recipe, b as RecipeConfig, a as ResolveArgs, d as ResolvedSelection, e as ResolvedStyles, S as Selection, f as SlotStyle, g as SlotStyles, h as StateName, i as States, j as StyleFn, T as TintArgs, V as VariantColors, k as VariantRole, l as VariantTokens, c as createRecipe } from '../create-recipe-C0XXjuow.cjs';
+import { S as SlotAnimation, F as FeedbackContext, a as AnimationProp, b as ResolvedAnimation, P as PressableFeedbackProps } from '../pressable-feedback.type-BA2C9sSz.cjs';
+export { A as AnimationConfig, R as RadiusStyle, c as RippleWave } from '../pressable-feedback.type-BA2C9sSz.cjs';
+import { R as RadiusKey, X as XAUITheme } from '../theme.type-C2gNHpEx.cjs';
+import { j as StyleFn, f as SlotStyle } from '../create-recipe-jHlk434p.cjs';
+export { A as Axes, C as CompoundVariant, R as Recipe, b as RecipeConfig, a as ResolveArgs, d as ResolvedSelection, e as ResolvedStyles, S as Selection, g as SlotStyles, h as StateName, i as States, T as TintArgs, V as VariantColors, k as VariantRole, l as VariantTokens, c as createRecipe } from '../create-recipe-jHlk434p.cjs';
+export { C as CloseButtonProps } from '../close-button.type-CHsgZ3wO.cjs';
+import { b as IconProps, a as IconContextValue } from '../icon.type-CF4KiMKl.cjs';
+export { I as IconComponentProps } from '../icon.type-CF4KiMKl.cjs';
+import { V as ViewStyleProps } from '../style-props.type-CfnoGEP7.cjs';
+export { D as DirectionalStyleKey, I as ImageStyleProps, S as StyleProps, T as TextStyleProps } from '../style-props.type-CfnoGEP7.cjs';
 import 'react-native-reanimated';
-import '../theme.type-C2gNHpEx.cjs';
 
 /**
  * The runtime half of R14. The type half lives in `system/style-props/`, and the two are
@@ -117,95 +121,6 @@ declare namespace PortalHost {
     var displayName: string;
 }
 
-/**
- * R3: the string a root should wrap in its default text slot, or `null` when it should
- * render its children as they are.
- *
- * The whole tree is stringified recursively rather than the first child inspected. That
- * is what makes `<Button>{count} items</Button>` work — children there are the array
- * `[3, ' items']`, and an `isValidElement` check on the first entry would call it an
- * element-free tree only by accident, while a check for "is the first child a string"
- * would miss it outright.
- *
- * `null` for an empty result as much as for a tree containing an element: in both cases
- * there is nothing to wrap, and a root's fallback — render the children — is right for
- * both. It also keeps `<Button>{false}</Button>` from mounting an empty text node.
- */
-declare function childrenToString(children: ReactNode): string | null;
-
-/**
- * A context a slot cannot read by accident. Every compound gets one, and it carries
- * **resolved** values — style references the root already computed, not tokens for the
- * slot to resolve again (R5).
- *
- * ```ts
- * const [ButtonProvider, useButton] = createSlotContext<ButtonContext>('Button')
- * ```
- *
- * The tuple is what lets each compound name its own hook, which R10 requires it to
- * export. `name` gives both halves of the error, so there is one place to spell it.
- */
-declare function createSlotContext<T>(name: string): readonly [Provider<T | null>, () => T];
-
-/** Anything React accepts as a ref, plus the absence of one. */
-type PossibleRef<T> = Ref<T> | undefined;
-/**
- * The props `mergeProps` knows how to combine. Deliberately loose: it merges whatever a
- * root hands to whatever child it was given, and neither side is knowable from here.
- */
-type MergeableProps = Record<string, unknown>;
-type AsChildProps = {
-    /**
-     * Merge this component's props into its single child instead of rendering an element
-     * of its own — a navigation `Link` as a `Button`, a bespoke trigger as a `Select`.
-     */
-    asChild?: boolean;
-};
-
-/**
- * Merges a root's own props into the child it renders through `asChild` (R12). Four
- * rules, and the child wins wherever they do not apply — it is the more specific intent:
- *
- * - **Event handlers compose.** Both run, ours first: the component's own behaviour (the
- *   press state that drives its styles) happens before the child's side effect (the
- *   navigation). Replacing one with the other is the bug this exists to prevent.
- * - **Styles stack**, ours under the child's, so the child can override.
- * - **`ref`s merge** through `mergeRefs`. React 19 passes `ref` as an ordinary prop, so
- *   it arrives here rather than beside the props, and dropping it would sever the root's
- *   handle on the node.
- * - **Everything else: the child's value wins**, and ours fills in what it left unset.
- */
-declare function mergeProps(ours: MergeableProps, theirs: MergeableProps): MergeableProps;
-
-/**
- * One callback that feeds several refs — what lets a root keep its own handle on a node
- * while still honouring the ref its caller passed (R9), and what `asChild` needs to
- * forward a ref into the child it merges into (R12).
- *
- * It returns nothing on purpose. React 19 reads a ref callback's return value as a
- * cleanup function while React 18 ignores it, and this package supports both; letting
- * a merged cleanup through would behave differently on each. React calls every ref with
- * `null` on unmount anyway, which this forwards.
- */
-declare function mergeRefs<T>(...refs: Array<PossibleRef<T>>): RefCallback<T>;
-
-type SlotProps = MergeableProps & {
-    children?: ReactNode;
-};
-/**
- * The render branch behind `asChild` (R12). A root picks it instead of its own element:
- *
- * ```tsx
- * const Root = asChild ? Slot : Pressable
- * return <Root ref={ref} {...rootProps}>{children}</Root>
- * ```
- *
- * One line per root, which is the point — forty-seven roots each hand-rolling a
- * `cloneElement` and a ref merge would drift, and R12 has to hold uniformly from the
- * first component or the ref signature of the whole core changes later.
- */
-declare const Slot: react.ForwardRefExoticComponent<Omit<SlotProps, "ref"> & react.RefAttributes<unknown>>;
-
 type PressableFeedbackHighlightProps = ViewStyleProps & {
     style?: StyleProp<ViewStyle>;
     animation?: SlotAnimation;
@@ -395,4 +310,165 @@ declare const PressableFeedback: react.ForwardRefExoticComponent<Omit<react_nati
     Ripple: typeof PressableFeedbackRipple;
 };
 
-export { AnimationProp, type AsChildProps, FEEDBACK_OVERLAY, FeedbackContext, HIGHLIGHT_DURATION, HIGHLIGHT_OPACITY, Icon, IconContext, IconContextValue, IconProps, type MergeableProps, PRESS_DURATION, PRESS_SCALE, Portal, PortalContext, PortalHost, type PortalHostProps, type PortalMethods, type PortalProps, type PossibleRef, PressableFeedback, type PressableFeedbackHighlightProps, type PressableFeedbackRippleProps, RIPPLE_CONFIRM_DURATION, RIPPLE_EXPAND_DURATION, RIPPLE_FADE_IN, RIPPLE_FADE_OUT, RIPPLE_FADE_OUT_DELAY, RIPPLE_OPACITY, RIPPLE_START_SCALE, ResolvedAnimation, SCALE_REFERENCE_WIDTH, Slot, SlotAnimation, type SlotProps, ViewStyleProps, childrenToString, createSlotContext, markOverlay, mergeProps, mergeRefs, pressScaleFor, resolveAnimation, resolveSlotAnimation, rippleRadiusFor, useFeedback, useIconContext, useStyleProps };
+/**
+ * The `radius` axis, which is the same ten lines in every component that has one — a key
+ * of the radius scale, applied to one slot, overriding whatever `size` chose.
+ *
+ * It is written here rather than a third time in a recipe because that is the rule §2 bis
+ * states: extract at the second use, and by the end of P3 this axis exists in a dozen
+ * components. Nothing about it is component-specific except which slot carries the corner.
+ *
+ * ```ts
+ * variants: { size: { … }, radius: radiusAxis('root') }
+ * ```
+ *
+ * The return type is a full `Record<RadiusKey, …>` rather than a partial one, so
+ * `createRecipe` still infers `radius="3xl"` as the axis's value union and a typo in a
+ * caller's `radius` is a type error rather than a silently ignored key.
+ */
+declare function radiusAxis<Slot extends string>(slot: Slot): Record<RadiusKey, StyleFn<Slot>>;
+
+/**
+ * R3: the string a root should wrap in its default text slot, or `null` when it should
+ * render its children as they are.
+ *
+ * The whole tree is stringified recursively rather than the first child inspected. That
+ * is what makes `<Button>{count} items</Button>` work — children there are the array
+ * `[3, ' items']`, and an `isValidElement` check on the first entry would call it an
+ * element-free tree only by accident, while a check for "is the first child a string"
+ * would miss it outright.
+ *
+ * `null` for an empty result as much as for a tree containing an element: in both cases
+ * there is nothing to wrap, and a root's fallback — render the children — is right for
+ * both. It also keeps `<Button>{false}</Button>` from mounting an empty text node.
+ */
+declare function childrenToString(children: ReactNode): string | null;
+
+/**
+ * A context a slot cannot read by accident. Every compound gets one, and it carries
+ * **resolved** values — style references the root already computed, not tokens for the
+ * slot to resolve again (R5).
+ *
+ * ```ts
+ * const [ButtonProvider, useButton] = createSlotContext<ButtonContext>('Button')
+ * ```
+ *
+ * The tuple is what lets each compound name its own hook, which R10 requires it to
+ * export. `name` gives both halves of the error, so there is one place to spell it.
+ */
+declare function createSlotContext<T>(name: string): readonly [Provider<T | null>, () => T];
+
+/** Anything React accepts as a ref, plus the absence of one. */
+type PossibleRef<T> = Ref<T> | undefined;
+/**
+ * The props `mergeProps` knows how to combine. Deliberately loose: it merges whatever a
+ * root hands to whatever child it was given, and neither side is knowable from here.
+ */
+type MergeableProps = Record<string, unknown>;
+type AsChildProps = {
+    /**
+     * Merge this component's props into its single child instead of rendering an element
+     * of its own — a navigation `Link` as a `Button`, a bespoke trigger as a `Select`.
+     */
+    asChild?: boolean;
+};
+
+/**
+ * Merges a root's own props into the child it renders through `asChild` (R12). Four
+ * rules, and the child wins wherever they do not apply — it is the more specific intent:
+ *
+ * - **Event handlers compose.** Both run, ours first: the component's own behaviour (the
+ *   press state that drives its styles) happens before the child's side effect (the
+ *   navigation). Replacing one with the other is the bug this exists to prevent.
+ * - **Styles stack**, ours under the child's, so the child can override.
+ * - **`ref`s merge** through `mergeRefs`. React 19 passes `ref` as an ordinary prop, so
+ *   it arrives here rather than beside the props, and dropping it would sever the root's
+ *   handle on the node.
+ * - **Everything else: the child's value wins**, and ours fills in what it left unset.
+ */
+declare function mergeProps(ours: MergeableProps, theirs: MergeableProps): MergeableProps;
+
+/**
+ * One callback that feeds several refs — what lets a root keep its own handle on a node
+ * while still honouring the ref its caller passed (R9), and what `asChild` needs to
+ * forward a ref into the child it merges into (R12).
+ *
+ * It returns nothing on purpose. React 19 reads a ref callback's return value as a
+ * cleanup function while React 18 ignores it, and this package supports both; letting
+ * a merged cleanup through would behave differently on each. React calls every ref with
+ * `null` on unmount anyway, which this forwards.
+ */
+declare function mergeRefs<T>(...refs: Array<PossibleRef<T>>): RefCallback<T>;
+
+type SlotProps = MergeableProps & {
+    children?: ReactNode;
+};
+/**
+ * The render branch behind `asChild` (R12). A root picks it instead of its own element:
+ *
+ * ```tsx
+ * const Root = asChild ? Slot : Pressable
+ * return <Root ref={ref} {...rootProps}>{children}</Root>
+ * ```
+ *
+ * One line per root, which is the point — forty-seven roots each hand-rolling a
+ * `cloneElement` and a ref merge would drift, and R12 has to hold uniformly from the
+ * first component or the ref signature of the whole core changes later.
+ */
+declare const Slot: react.ForwardRefExoticComponent<Omit<SlotProps, "ref"> & react.RefAttributes<unknown>>;
+
+/**
+ * The dismiss affordance shared by everything that can be dismissed — `Chip.Close`,
+ * `Alert.Close`, and the `Dialog`, `Snackbar` and `Sheet` of P5. Each of those is a
+ * five-line call site handing it the styles its own recipe resolved:
+ *
+ * ```tsx
+ * const { closeStyle, closeGlyphStyle, isDisabled } = useChip()
+ *
+ * <CloseButton
+ *   name="Chip.Close"
+ *   baseStyle={closeStyle}
+ *   glyphStyle={closeGlyphStyle}
+ *   isDisabled={isDisabled}
+ * />
+ * ```
+ *
+ * **It owns its press state**, unlike every other pressable in the library, where the
+ * component root owns it because its recipe resolves on it. Here the surrounding
+ * component is usually not a control at all, and where it is, the two are different
+ * targets: pressing the cross must not read as pressing the chip around it.
+ *
+ * With no children it draws its own cross from two bars a quarter turn apart, so a
+ * dismissible component works in a project that has installed no icon set.
+ */
+declare const CloseButton: react.ForwardRefExoticComponent<{
+    name: string;
+    children?: react.ReactNode;
+    baseStyle?: react_native.StyleProp<react_native.ViewStyle>;
+    glyphStyle?: react_native.StyleProp<react_native.ViewStyle>;
+    style?: react_native.StyleProp<react_native.ViewStyle> | ((state: react_native.PressableStateCallbackType) => react_native.StyleProp<react_native.ViewStyle>);
+} & Omit<PressableFeedbackProps, "style" | "children" | "isPressed"> & react.RefAttributes<View>>;
+
+/** The two slots a component publishes for a `CloseButton`: its box and one cross bar. */
+type CloseButtonSlots = {
+    close: SlotStyle;
+    closeGlyph: SlotStyle;
+};
+/**
+ * The cross's own geometry, for the `base` of any recipe that hosts a `CloseButton`:
+ *
+ * ```ts
+ * base: theme => ({ ...closeButtonBase(theme), root: { … } })
+ * ```
+ *
+ * The bar's thickness and the box's centring belong to the button rather than to the
+ * component around it, so they are written once here. What stays in the recipe is what is
+ * genuinely the component's: the size of the box and the length of the bar, both of which
+ * follow that component's own scale.
+ *
+ * Two bars are rendered, rotated a quarter turn apart, which is why only one is described
+ * and why it is positioned absolutely — they overlap at the centre of the box.
+ */
+declare function closeButtonBase(theme: XAUITheme): CloseButtonSlots;
+
+export { AnimationProp, type AsChildProps, CloseButton, type CloseButtonSlots, FEEDBACK_OVERLAY, FeedbackContext, HIGHLIGHT_DURATION, HIGHLIGHT_OPACITY, Icon, IconContext, IconContextValue, IconProps, type MergeableProps, PRESS_DURATION, PRESS_SCALE, Portal, PortalContext, PortalHost, type PortalHostProps, type PortalMethods, type PortalProps, type PossibleRef, PressableFeedback, type PressableFeedbackHighlightProps, PressableFeedbackProps, type PressableFeedbackRippleProps, RIPPLE_CONFIRM_DURATION, RIPPLE_EXPAND_DURATION, RIPPLE_FADE_IN, RIPPLE_FADE_OUT, RIPPLE_FADE_OUT_DELAY, RIPPLE_OPACITY, RIPPLE_START_SCALE, ResolvedAnimation, SCALE_REFERENCE_WIDTH, Slot, SlotAnimation, type SlotProps, SlotStyle, StyleFn, ViewStyleProps, childrenToString, closeButtonBase, createSlotContext, markOverlay, mergeProps, mergeRefs, pressScaleFor, radiusAxis, resolveAnimation, resolveSlotAnimation, rippleRadiusFor, useFeedback, useIconContext, useStyleProps };

package/dist/system/index.d.ts

@@ -1,14 +1,18 @@
+import * as react_native from 'react-native';
+import { StyleProp, ViewStyle, View } from 'react-native';
 import * as react from 'react';
 import { ReactNode, Provider, Ref, RefCallback } from 'react';
-import { b as IconProps, a as IconContextValue, S as SlotAnimation, F as FeedbackContext, c as AnimationProp, d as ResolvedAnimation } from '../pressable-feedback.type-BwkKLQlX.js';
-export { A as AnimationConfig, I as IconComponentProps, P as PressableFeedbackProps, R as RadiusStyle, e as RippleWave } from '../pressable-feedback.type-BwkKLQlX.js';
-import { V as ViewStyleProps } from '../style-props.type-B1BG5TCm.js';
-export { D as DirectionalStyleKey, I as ImageStyleProps, S as StyleProps, T as TextStyleProps } from '../style-props.type-B1BG5TCm.js';
-import * as react_native from 'react-native';
-import { StyleProp, ViewStyle } from 'react-native';
-export { A as Axes, C as CompoundVariant, R as Recipe, b as RecipeConfig, a as ResolveArgs, d as ResolvedSelection, e as ResolvedStyles, S as Selection, f as SlotStyle, g as SlotStyles, h as StateName, i as States, j as StyleFn, T as TintArgs, V as VariantColors, k as VariantRole, l as VariantTokens, c as createRecipe } from '../create-recipe-CPXFo2rk.js';
+import { S as SlotAnimation, F as FeedbackContext, a as AnimationProp, b as ResolvedAnimation, P as PressableFeedbackProps } from '../pressable-feedback.type-Bs4dQlGj.js';
+export { A as AnimationConfig, R as RadiusStyle, c as RippleWave } from '../pressable-feedback.type-Bs4dQlGj.js';
+import { R as RadiusKey, X as XAUITheme } from '../theme.type-C2gNHpEx.js';
+import { j as StyleFn, f as SlotStyle } from '../create-recipe-CbXika57.js';
+export { A as Axes, C as CompoundVariant, R as Recipe, b as RecipeConfig, a as ResolveArgs, d as ResolvedSelection, e as ResolvedStyles, S as Selection, g as SlotStyles, h as StateName, i as States, T as TintArgs, V as VariantColors, k as VariantRole, l as VariantTokens, c as createRecipe } from '../create-recipe-CbXika57.js';
+export { C as CloseButtonProps } from '../close-button.type-BUYuoSt2.js';
+import { b as IconProps, a as IconContextValue } from '../icon.type-Dq4_qePa.js';
+export { I as IconComponentProps } from '../icon.type-Dq4_qePa.js';
+import { V as ViewStyleProps } from '../style-props.type-CfnoGEP7.js';
+export { D as DirectionalStyleKey, I as ImageStyleProps, S as StyleProps, T as TextStyleProps } from '../style-props.type-CfnoGEP7.js';
 import 'react-native-reanimated';
-import '../theme.type-C2gNHpEx.js';
 
 /**
  * The runtime half of R14. The type half lives in `system/style-props/`, and the two are
@@ -117,95 +121,6 @@ declare namespace PortalHost {
     var displayName: string;
 }
 
-/**
- * R3: the string a root should wrap in its default text slot, or `null` when it should
- * render its children as they are.
- *
- * The whole tree is stringified recursively rather than the first child inspected. That
- * is what makes `<Button>{count} items</Button>` work — children there are the array
- * `[3, ' items']`, and an `isValidElement` check on the first entry would call it an
- * element-free tree only by accident, while a check for "is the first child a string"
- * would miss it outright.
- *
- * `null` for an empty result as much as for a tree containing an element: in both cases
- * there is nothing to wrap, and a root's fallback — render the children — is right for
- * both. It also keeps `<Button>{false}</Button>` from mounting an empty text node.
- */
-declare function childrenToString(children: ReactNode): string | null;
-
-/**
- * A context a slot cannot read by accident. Every compound gets one, and it carries
- * **resolved** values — style references the root already computed, not tokens for the
- * slot to resolve again (R5).
- *
- * ```ts
- * const [ButtonProvider, useButton] = createSlotContext<ButtonContext>('Button')
- * ```
- *
- * The tuple is what lets each compound name its own hook, which R10 requires it to
- * export. `name` gives both halves of the error, so there is one place to spell it.
- */
-declare function createSlotContext<T>(name: string): readonly [Provider<T | null>, () => T];
-
-/** Anything React accepts as a ref, plus the absence of one. */
-type PossibleRef<T> = Ref<T> | undefined;
-/**
- * The props `mergeProps` knows how to combine. Deliberately loose: it merges whatever a
- * root hands to whatever child it was given, and neither side is knowable from here.
- */
-type MergeableProps = Record<string, unknown>;
-type AsChildProps = {
-    /**
-     * Merge this component's props into its single child instead of rendering an element
-     * of its own — a navigation `Link` as a `Button`, a bespoke trigger as a `Select`.
-     */
-    asChild?: boolean;
-};
-
-/**
- * Merges a root's own props into the child it renders through `asChild` (R12). Four
- * rules, and the child wins wherever they do not apply — it is the more specific intent:
- *
- * - **Event handlers compose.** Both run, ours first: the component's own behaviour (the
- *   press state that drives its styles) happens before the child's side effect (the
- *   navigation). Replacing one with the other is the bug this exists to prevent.
- * - **Styles stack**, ours under the child's, so the child can override.
- * - **`ref`s merge** through `mergeRefs`. React 19 passes `ref` as an ordinary prop, so
- *   it arrives here rather than beside the props, and dropping it would sever the root's
- *   handle on the node.
- * - **Everything else: the child's value wins**, and ours fills in what it left unset.
- */
-declare function mergeProps(ours: MergeableProps, theirs: MergeableProps): MergeableProps;
-
-/**
- * One callback that feeds several refs — what lets a root keep its own handle on a node
- * while still honouring the ref its caller passed (R9), and what `asChild` needs to
- * forward a ref into the child it merges into (R12).
- *
- * It returns nothing on purpose. React 19 reads a ref callback's return value as a
- * cleanup function while React 18 ignores it, and this package supports both; letting
- * a merged cleanup through would behave differently on each. React calls every ref with
- * `null` on unmount anyway, which this forwards.
- */
-declare function mergeRefs<T>(...refs: Array<PossibleRef<T>>): RefCallback<T>;
-
-type SlotProps = MergeableProps & {
-    children?: ReactNode;
-};
-/**
- * The render branch behind `asChild` (R12). A root picks it instead of its own element:
- *
- * ```tsx
- * const Root = asChild ? Slot : Pressable
- * return <Root ref={ref} {...rootProps}>{children}</Root>
- * ```
- *
- * One line per root, which is the point — forty-seven roots each hand-rolling a
- * `cloneElement` and a ref merge would drift, and R12 has to hold uniformly from the
- * first component or the ref signature of the whole core changes later.
- */
-declare const Slot: react.ForwardRefExoticComponent<Omit<SlotProps, "ref"> & react.RefAttributes<unknown>>;
-
 type PressableFeedbackHighlightProps = ViewStyleProps & {
     style?: StyleProp<ViewStyle>;
     animation?: SlotAnimation;
@@ -395,4 +310,165 @@ declare const PressableFeedback: react.ForwardRefExoticComponent<Omit<react_nati
     Ripple: typeof PressableFeedbackRipple;
 };
 
-export { AnimationProp, type AsChildProps, FEEDBACK_OVERLAY, FeedbackContext, HIGHLIGHT_DURATION, HIGHLIGHT_OPACITY, Icon, IconContext, IconContextValue, IconProps, type MergeableProps, PRESS_DURATION, PRESS_SCALE, Portal, PortalContext, PortalHost, type PortalHostProps, type PortalMethods, type PortalProps, type PossibleRef, PressableFeedback, type PressableFeedbackHighlightProps, type PressableFeedbackRippleProps, RIPPLE_CONFIRM_DURATION, RIPPLE_EXPAND_DURATION, RIPPLE_FADE_IN, RIPPLE_FADE_OUT, RIPPLE_FADE_OUT_DELAY, RIPPLE_OPACITY, RIPPLE_START_SCALE, ResolvedAnimation, SCALE_REFERENCE_WIDTH, Slot, SlotAnimation, type SlotProps, ViewStyleProps, childrenToString, createSlotContext, markOverlay, mergeProps, mergeRefs, pressScaleFor, resolveAnimation, resolveSlotAnimation, rippleRadiusFor, useFeedback, useIconContext, useStyleProps };
+/**
+ * The `radius` axis, which is the same ten lines in every component that has one — a key
+ * of the radius scale, applied to one slot, overriding whatever `size` chose.
+ *
+ * It is written here rather than a third time in a recipe because that is the rule §2 bis
+ * states: extract at the second use, and by the end of P3 this axis exists in a dozen
+ * components. Nothing about it is component-specific except which slot carries the corner.
+ *
+ * ```ts
+ * variants: { size: { … }, radius: radiusAxis('root') }
+ * ```
+ *
+ * The return type is a full `Record<RadiusKey, …>` rather than a partial one, so
+ * `createRecipe` still infers `radius="3xl"` as the axis's value union and a typo in a
+ * caller's `radius` is a type error rather than a silently ignored key.
+ */
+declare function radiusAxis<Slot extends string>(slot: Slot): Record<RadiusKey, StyleFn<Slot>>;
+
+/**
+ * R3: the string a root should wrap in its default text slot, or `null` when it should
+ * render its children as they are.
+ *
+ * The whole tree is stringified recursively rather than the first child inspected. That
+ * is what makes `<Button>{count} items</Button>` work — children there are the array
+ * `[3, ' items']`, and an `isValidElement` check on the first entry would call it an
+ * element-free tree only by accident, while a check for "is the first child a string"
+ * would miss it outright.
+ *
+ * `null` for an empty result as much as for a tree containing an element: in both cases
+ * there is nothing to wrap, and a root's fallback — render the children — is right for
+ * both. It also keeps `<Button>{false}</Button>` from mounting an empty text node.
+ */
+declare function childrenToString(children: ReactNode): string | null;
+
+/**
+ * A context a slot cannot read by accident. Every compound gets one, and it carries
+ * **resolved** values — style references the root already computed, not tokens for the
+ * slot to resolve again (R5).
+ *
+ * ```ts
+ * const [ButtonProvider, useButton] = createSlotContext<ButtonContext>('Button')
+ * ```
+ *
+ * The tuple is what lets each compound name its own hook, which R10 requires it to
+ * export. `name` gives both halves of the error, so there is one place to spell it.
+ */
+declare function createSlotContext<T>(name: string): readonly [Provider<T | null>, () => T];
+
+/** Anything React accepts as a ref, plus the absence of one. */
+type PossibleRef<T> = Ref<T> | undefined;
+/**
+ * The props `mergeProps` knows how to combine. Deliberately loose: it merges whatever a
+ * root hands to whatever child it was given, and neither side is knowable from here.
+ */
+type MergeableProps = Record<string, unknown>;
+type AsChildProps = {
+    /**
+     * Merge this component's props into its single child instead of rendering an element
+     * of its own — a navigation `Link` as a `Button`, a bespoke trigger as a `Select`.
+     */
+    asChild?: boolean;
+};
+
+/**
+ * Merges a root's own props into the child it renders through `asChild` (R12). Four
+ * rules, and the child wins wherever they do not apply — it is the more specific intent:
+ *
+ * - **Event handlers compose.** Both run, ours first: the component's own behaviour (the
+ *   press state that drives its styles) happens before the child's side effect (the
+ *   navigation). Replacing one with the other is the bug this exists to prevent.
+ * - **Styles stack**, ours under the child's, so the child can override.
+ * - **`ref`s merge** through `mergeRefs`. React 19 passes `ref` as an ordinary prop, so
+ *   it arrives here rather than beside the props, and dropping it would sever the root's
+ *   handle on the node.
+ * - **Everything else: the child's value wins**, and ours fills in what it left unset.
+ */
+declare function mergeProps(ours: MergeableProps, theirs: MergeableProps): MergeableProps;
+
+/**
+ * One callback that feeds several refs — what lets a root keep its own handle on a node
+ * while still honouring the ref its caller passed (R9), and what `asChild` needs to
+ * forward a ref into the child it merges into (R12).
+ *
+ * It returns nothing on purpose. React 19 reads a ref callback's return value as a
+ * cleanup function while React 18 ignores it, and this package supports both; letting
+ * a merged cleanup through would behave differently on each. React calls every ref with
+ * `null` on unmount anyway, which this forwards.
+ */
+declare function mergeRefs<T>(...refs: Array<PossibleRef<T>>): RefCallback<T>;
+
+type SlotProps = MergeableProps & {
+    children?: ReactNode;
+};
+/**
+ * The render branch behind `asChild` (R12). A root picks it instead of its own element:
+ *
+ * ```tsx
+ * const Root = asChild ? Slot : Pressable
+ * return <Root ref={ref} {...rootProps}>{children}</Root>
+ * ```
+ *
+ * One line per root, which is the point — forty-seven roots each hand-rolling a
+ * `cloneElement` and a ref merge would drift, and R12 has to hold uniformly from the
+ * first component or the ref signature of the whole core changes later.
+ */
+declare const Slot: react.ForwardRefExoticComponent<Omit<SlotProps, "ref"> & react.RefAttributes<unknown>>;
+
+/**
+ * The dismiss affordance shared by everything that can be dismissed — `Chip.Close`,
+ * `Alert.Close`, and the `Dialog`, `Snackbar` and `Sheet` of P5. Each of those is a
+ * five-line call site handing it the styles its own recipe resolved:
+ *
+ * ```tsx
+ * const { closeStyle, closeGlyphStyle, isDisabled } = useChip()
+ *
+ * <CloseButton
+ *   name="Chip.Close"
+ *   baseStyle={closeStyle}
+ *   glyphStyle={closeGlyphStyle}
+ *   isDisabled={isDisabled}
+ * />
+ * ```
+ *
+ * **It owns its press state**, unlike every other pressable in the library, where the
+ * component root owns it because its recipe resolves on it. Here the surrounding
+ * component is usually not a control at all, and where it is, the two are different
+ * targets: pressing the cross must not read as pressing the chip around it.
+ *
+ * With no children it draws its own cross from two bars a quarter turn apart, so a
+ * dismissible component works in a project that has installed no icon set.
+ */
+declare const CloseButton: react.ForwardRefExoticComponent<{
+    name: string;
+    children?: react.ReactNode;
+    baseStyle?: react_native.StyleProp<react_native.ViewStyle>;
+    glyphStyle?: react_native.StyleProp<react_native.ViewStyle>;
+    style?: react_native.StyleProp<react_native.ViewStyle> | ((state: react_native.PressableStateCallbackType) => react_native.StyleProp<react_native.ViewStyle>);
+} & Omit<PressableFeedbackProps, "style" | "children" | "isPressed"> & react.RefAttributes<View>>;
+
+/** The two slots a component publishes for a `CloseButton`: its box and one cross bar. */
+type CloseButtonSlots = {
+    close: SlotStyle;
+    closeGlyph: SlotStyle;
+};
+/**
+ * The cross's own geometry, for the `base` of any recipe that hosts a `CloseButton`:
+ *
+ * ```ts
+ * base: theme => ({ ...closeButtonBase(theme), root: { … } })
+ * ```
+ *
+ * The bar's thickness and the box's centring belong to the button rather than to the
+ * component around it, so they are written once here. What stays in the recipe is what is
+ * genuinely the component's: the size of the box and the length of the bar, both of which
+ * follow that component's own scale.
+ *
+ * Two bars are rendered, rotated a quarter turn apart, which is why only one is described
+ * and why it is positioned absolutely — they overlap at the centre of the box.
+ */
+declare function closeButtonBase(theme: XAUITheme): CloseButtonSlots;
+
+export { AnimationProp, type AsChildProps, CloseButton, type CloseButtonSlots, FEEDBACK_OVERLAY, FeedbackContext, HIGHLIGHT_DURATION, HIGHLIGHT_OPACITY, Icon, IconContext, IconContextValue, IconProps, type MergeableProps, PRESS_DURATION, PRESS_SCALE, Portal, PortalContext, PortalHost, type PortalHostProps, type PortalMethods, type PortalProps, type PossibleRef, PressableFeedback, type PressableFeedbackHighlightProps, PressableFeedbackProps, type PressableFeedbackRippleProps, RIPPLE_CONFIRM_DURATION, RIPPLE_EXPAND_DURATION, RIPPLE_FADE_IN, RIPPLE_FADE_OUT, RIPPLE_FADE_OUT_DELAY, RIPPLE_OPACITY, RIPPLE_START_SCALE, ResolvedAnimation, SCALE_REFERENCE_WIDTH, Slot, SlotAnimation, type SlotProps, SlotStyle, StyleFn, ViewStyleProps, childrenToString, closeButtonBase, createSlotContext, markOverlay, mergeProps, mergeRefs, pressScaleFor, radiusAxis, resolveAnimation, resolveSlotAnimation, rippleRadiusFor, useFeedback, useIconContext, useStyleProps };