@xaui/native 0.9.1-alpha.17 → 0.9.1-alpha.18

package/dist/{pressable-feedback.type-KcPvFf6f.d.ts → pressable-feedback.type-UwqIG6ES.d.ts}

@@ -12,31 +12,59 @@ type IconComponentProps = {
     size?: number;
     color?: string;
 };
-/**
- * R14 reaches the **`source` form only**, exactly like `style` below and for the same
- * reason: it is the one of the three forms where we render the node. On the other two,
- * `size` and `color` are what shapes the icon.
- */
-type IconProps = ImageStyleProps & {
-    /** An icon component. `size` and `color` are injected into it. */
-    as?: ComponentType<IconComponentProps>;
-    /** A raw `react-native-svg` element, cloned with the resolved size and colour. */
-    children?: ReactNode;
-    /** An image, tinted with the resolved colour. */
-    source?: ImageSourcePropType;
+/** What every form takes, and the only lever the two non-rendering ones have. */
+type IconBase = {
     /** Overrides what the surrounding slot asked for. */
     size?: number;
     /** A raw value (R7), never a token. Overrides the slot's. */
     color?: string;
-    /**
-     * The **`source` form only** — it is the one of the three where we render the view.
-     * `as` hands its props to a third-party component and the children form clones an
-     * element the caller made; neither is a view this can style, and wrapping them would
-     * add a level of depth to every icon in the library. `size` and `color` are the
-     * escape hatch there.
-     */
+};
+/**
+ * An icon component — `size` and `color` are injected into it.
+ *
+ * No style props and no `style`: we do not render this node, the third party does, and
+ * there is no published interface that says it would accept either. Wrapping it in a view
+ * to make them work would add a level of depth to every icon in the library.
+ */
+type IconAsProps = IconBase & {
+    as: ComponentType<IconComponentProps>;
+    children?: never;
+    source?: never;
+};
+/**
+ * A raw `react-native-svg` element, cloned with the resolved size and colour.
+ *
+ * No style props and no `style` either: the node is the caller's own element, and they can
+ * style it where they wrote it.
+ */
+type IconChildrenProps = IconBase & {
+    as?: never;
+    children: ReactNode;
+    source?: never;
+};
+/**
+ * An image, tinted with the resolved colour — **the one form that carries R14**, because
+ * it is the one where we render the node.
+ */
+type IconSourceProps = IconBase & ImageStyleProps & {
+    as?: never;
+    children?: never;
+    source: ImageSourcePropType;
     style?: StyleProp<ImageStyle>;
 };
+/**
+ * Three forms, and the type says which one you are in.
+ *
+ * The union is what makes R14's boundary checkable rather than merely documented. When
+ * every form declared the style props, `<Icon as={Trash2} marginEnd={8} />` compiled and
+ * did nothing at all — the prop was dropped on the two forms that do not render the node,
+ * silently, and only a comment said so. Now it is a compile error that points at `size`
+ * and `color`, which are the levers those forms actually have.
+ *
+ * It also makes the three mutually exclusive, which they always were at runtime: `as`
+ * wins over children, and children over `source`.
+ */
+type IconProps = IconAsProps | IconChildrenProps | IconSourceProps;
 /** What a component root publishes so the icons inside it need no props at all. */
 type IconContextValue = {
     size?: number;

package/dist/{pressable-feedback.type-C9kjAuVQ.d.cts → pressable-feedback.type-lgW5wQx5.d.cts}

@@ -12,31 +12,59 @@ type IconComponentProps = {
     size?: number;
     color?: string;
 };
-/**
- * R14 reaches the **`source` form only**, exactly like `style` below and for the same
- * reason: it is the one of the three forms where we render the node. On the other two,
- * `size` and `color` are what shapes the icon.
- */
-type IconProps = ImageStyleProps & {
-    /** An icon component. `size` and `color` are injected into it. */
-    as?: ComponentType<IconComponentProps>;
-    /** A raw `react-native-svg` element, cloned with the resolved size and colour. */
-    children?: ReactNode;
-    /** An image, tinted with the resolved colour. */
-    source?: ImageSourcePropType;
+/** What every form takes, and the only lever the two non-rendering ones have. */
+type IconBase = {
     /** Overrides what the surrounding slot asked for. */
     size?: number;
     /** A raw value (R7), never a token. Overrides the slot's. */
     color?: string;
-    /**
-     * The **`source` form only** — it is the one of the three where we render the view.
-     * `as` hands its props to a third-party component and the children form clones an
-     * element the caller made; neither is a view this can style, and wrapping them would
-     * add a level of depth to every icon in the library. `size` and `color` are the
-     * escape hatch there.
-     */
+};
+/**
+ * An icon component — `size` and `color` are injected into it.
+ *
+ * No style props and no `style`: we do not render this node, the third party does, and
+ * there is no published interface that says it would accept either. Wrapping it in a view
+ * to make them work would add a level of depth to every icon in the library.
+ */
+type IconAsProps = IconBase & {
+    as: ComponentType<IconComponentProps>;
+    children?: never;
+    source?: never;
+};
+/**
+ * A raw `react-native-svg` element, cloned with the resolved size and colour.
+ *
+ * No style props and no `style` either: the node is the caller's own element, and they can
+ * style it where they wrote it.
+ */
+type IconChildrenProps = IconBase & {
+    as?: never;
+    children: ReactNode;
+    source?: never;
+};
+/**
+ * An image, tinted with the resolved colour — **the one form that carries R14**, because
+ * it is the one where we render the node.
+ */
+type IconSourceProps = IconBase & ImageStyleProps & {
+    as?: never;
+    children?: never;
+    source: ImageSourcePropType;
     style?: StyleProp<ImageStyle>;
 };
+/**
+ * Three forms, and the type says which one you are in.
+ *
+ * The union is what makes R14's boundary checkable rather than merely documented. When
+ * every form declared the style props, `<Icon as={Trash2} marginEnd={8} />` compiled and
+ * did nothing at all — the prop was dropped on the two forms that do not render the node,
+ * silently, and only a comment said so. Now it is a compile error that points at `size`
+ * and `color`, which are the levers those forms actually have.
+ *
+ * It also makes the three mutually exclusive, which they always were at runtime: `as`
+ * wins over children, and children over `source`.
+ */
+type IconProps = IconAsProps | IconChildrenProps | IconSourceProps;
 /** What a component root publishes so the icons inside it need no props at all. */
 type IconContextValue = {
     size?: number;

package/dist/system/index.cjs

@@ -27,7 +27,7 @@ var _chunkM2VYRHVScjs = require('../chunk-M2VYRHVS.cjs');
 
 
 
-var _chunk2UICXD3Qcjs = require('../chunk-2UICXD3Q.cjs');
+var _chunkP5MKOLIWcjs = require('../chunk-P5MKOLIW.cjs');
 
 
 
@@ -72,4 +72,4 @@ require('../chunk-6N5JXRUZ.cjs');
 
 
 
-exports.FEEDBACK_OVERLAY = _chunk2UICXD3Qcjs.FEEDBACK_OVERLAY; exports.HIGHLIGHT_DURATION = _chunk2UICXD3Qcjs.HIGHLIGHT_DURATION; exports.HIGHLIGHT_OPACITY = _chunk2UICXD3Qcjs.HIGHLIGHT_OPACITY; exports.Icon = _chunk2UICXD3Qcjs.Icon; exports.IconContext = _chunk2UICXD3Qcjs.IconContext; exports.PRESS_DURATION = _chunk2UICXD3Qcjs.PRESS_DURATION; exports.PRESS_SCALE = _chunk2UICXD3Qcjs.PRESS_SCALE; exports.Portal = _chunkM2VYRHVScjs.Portal; exports.PortalContext = _chunkM2VYRHVScjs.PortalContext; exports.PortalHost = _chunkM2VYRHVScjs.PortalHost; exports.PressableFeedback = _chunk2UICXD3Qcjs.PressableFeedback; exports.RIPPLE_CONFIRM_DURATION = _chunk2UICXD3Qcjs.RIPPLE_CONFIRM_DURATION; exports.RIPPLE_EXPAND_DURATION = _chunk2UICXD3Qcjs.RIPPLE_EXPAND_DURATION; exports.RIPPLE_FADE_IN = _chunk2UICXD3Qcjs.RIPPLE_FADE_IN; exports.RIPPLE_FADE_OUT = _chunk2UICXD3Qcjs.RIPPLE_FADE_OUT; exports.RIPPLE_FADE_OUT_DELAY = _chunk2UICXD3Qcjs.RIPPLE_FADE_OUT_DELAY; exports.RIPPLE_OPACITY = _chunk2UICXD3Qcjs.RIPPLE_OPACITY; exports.RIPPLE_START_SCALE = _chunk2UICXD3Qcjs.RIPPLE_START_SCALE; exports.SCALE_REFERENCE_WIDTH = _chunk2UICXD3Qcjs.SCALE_REFERENCE_WIDTH; exports.Slot = _chunk5SU7FXWHcjs.Slot; exports.childrenToString = _chunk5SU7FXWHcjs.childrenToString; exports.createRecipe = _chunk5SU7FXWHcjs.createRecipe; exports.createSlotContext = _chunk5SU7FXWHcjs.createSlotContext; exports.markOverlay = _chunk2UICXD3Qcjs.markOverlay; exports.mergeProps = _chunk5SU7FXWHcjs.mergeProps; exports.mergeRefs = _chunk5SU7FXWHcjs.mergeRefs; exports.pressScaleFor = _chunk2UICXD3Qcjs.pressScaleFor; exports.resolveAnimation = _chunk2UICXD3Qcjs.resolveAnimation; exports.resolveSlotAnimation = _chunk2UICXD3Qcjs.resolveSlotAnimation; exports.rippleRadiusFor = _chunk2UICXD3Qcjs.rippleRadiusFor; exports.useFeedback = _chunk2UICXD3Qcjs.useFeedback; exports.useIconContext = _chunk2UICXD3Qcjs.useIconContext; exports.useStyleProps = _chunk5SU7FXWHcjs.useStyleProps;
+exports.FEEDBACK_OVERLAY = _chunkP5MKOLIWcjs.FEEDBACK_OVERLAY; exports.HIGHLIGHT_DURATION = _chunkP5MKOLIWcjs.HIGHLIGHT_DURATION; exports.HIGHLIGHT_OPACITY = _chunkP5MKOLIWcjs.HIGHLIGHT_OPACITY; exports.Icon = _chunkP5MKOLIWcjs.Icon; exports.IconContext = _chunkP5MKOLIWcjs.IconContext; exports.PRESS_DURATION = _chunkP5MKOLIWcjs.PRESS_DURATION; exports.PRESS_SCALE = _chunkP5MKOLIWcjs.PRESS_SCALE; exports.Portal = _chunkM2VYRHVScjs.Portal; exports.PortalContext = _chunkM2VYRHVScjs.PortalContext; exports.PortalHost = _chunkM2VYRHVScjs.PortalHost; exports.PressableFeedback = _chunkP5MKOLIWcjs.PressableFeedback; exports.RIPPLE_CONFIRM_DURATION = _chunkP5MKOLIWcjs.RIPPLE_CONFIRM_DURATION; exports.RIPPLE_EXPAND_DURATION = _chunkP5MKOLIWcjs.RIPPLE_EXPAND_DURATION; exports.RIPPLE_FADE_IN = _chunkP5MKOLIWcjs.RIPPLE_FADE_IN; exports.RIPPLE_FADE_OUT = _chunkP5MKOLIWcjs.RIPPLE_FADE_OUT; exports.RIPPLE_FADE_OUT_DELAY = _chunkP5MKOLIWcjs.RIPPLE_FADE_OUT_DELAY; exports.RIPPLE_OPACITY = _chunkP5MKOLIWcjs.RIPPLE_OPACITY; exports.RIPPLE_START_SCALE = _chunkP5MKOLIWcjs.RIPPLE_START_SCALE; exports.SCALE_REFERENCE_WIDTH = _chunkP5MKOLIWcjs.SCALE_REFERENCE_WIDTH; exports.Slot = _chunk5SU7FXWHcjs.Slot; exports.childrenToString = _chunk5SU7FXWHcjs.childrenToString; exports.createRecipe = _chunk5SU7FXWHcjs.createRecipe; exports.createSlotContext = _chunk5SU7FXWHcjs.createSlotContext; exports.markOverlay = _chunkP5MKOLIWcjs.markOverlay; exports.mergeProps = _chunk5SU7FXWHcjs.mergeProps; exports.mergeRefs = _chunk5SU7FXWHcjs.mergeRefs; exports.pressScaleFor = _chunkP5MKOLIWcjs.pressScaleFor; exports.resolveAnimation = _chunkP5MKOLIWcjs.resolveAnimation; exports.resolveSlotAnimation = _chunkP5MKOLIWcjs.resolveSlotAnimation; exports.rippleRadiusFor = _chunkP5MKOLIWcjs.rippleRadiusFor; exports.useFeedback = _chunkP5MKOLIWcjs.useFeedback; exports.useIconContext = _chunkP5MKOLIWcjs.useIconContext; exports.useStyleProps = _chunk5SU7FXWHcjs.useStyleProps;

package/dist/system/index.d.cts

@@ -1,7 +1,7 @@
 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-C9kjAuVQ.cjs';
-export { A as AnimationConfig, I as IconComponentProps, P as PressableFeedbackProps, R as RadiusStyle, e as RippleWave } from '../pressable-feedback.type-C9kjAuVQ.cjs';
+import { b as IconProps, a as IconContextValue, S as SlotAnimation, F as FeedbackContext, c as AnimationProp, d as ResolvedAnimation } from '../pressable-feedback.type-lgW5wQx5.cjs';
+export { A as AnimationConfig, I as IconComponentProps, P as PressableFeedbackProps, R as RadiusStyle, e as RippleWave } from '../pressable-feedback.type-lgW5wQx5.cjs';
 import { V as ViewStyleProps } from '../create-recipe-3_ElpCYt.cjs';
 export { A as Axes, C as CompoundVariant, D as DirectionalStyleKey, I as ImageStyleProps, 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, n as StyleProps, o as TextStyleProps, T as TintArgs, k as VariantColors, l as VariantRole, m as VariantTokens, c as createRecipe } from '../create-recipe-3_ElpCYt.cjs';
 import * as react_native from 'react-native';
@@ -55,8 +55,12 @@ declare function useStyleProps<P extends object>(props: P): [StylePropsOf<P>, Re
  * Three accepted forms — a component through `as`, a raw SVG as children, or an image
  * through `source` — and the resolution is the same for all three: an explicit prop, else
  * what the surrounding slot published, else the theme.
+ *
+ * The props are taken whole rather than destructured, because they are a union: which
+ * keys exist depends on the form, and narrowing is what lets `style` be reachable in the
+ * one branch that renders a node and unwritable in the two that do not.
  */
-declare function Icon({ as: Component, children, source, size, color, style, ...props }: IconProps): react.JSX.Element;
+declare function Icon(props: IconProps): react.JSX.Element;
 declare namespace Icon {
     var displayName: string;
 }
@@ -378,7 +382,7 @@ declare function resolveSlotAnimation(override: SlotAnimation | undefined, enabl
  * off — and it is the only shape that survives `asChild`, where the caller's own element
  * is the pressable and there is no sibling for the primitive to inject.
  */
-declare const PressableFeedback: react.ForwardRefExoticComponent<Omit<react_native.PressableProps, "children" | "style" | "disabled"> & ViewStyleProps & {
+declare const PressableFeedback: react.ForwardRefExoticComponent<Omit<react_native.PressableProps, "style" | "children" | "disabled"> & ViewStyleProps & {
     isPressed?: boolean;
     isDisabled?: boolean;
     asChild?: boolean;

package/dist/system/index.d.ts

@@ -1,7 +1,7 @@
 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-KcPvFf6f.js';
-export { A as AnimationConfig, I as IconComponentProps, P as PressableFeedbackProps, R as RadiusStyle, e as RippleWave } from '../pressable-feedback.type-KcPvFf6f.js';
+import { b as IconProps, a as IconContextValue, S as SlotAnimation, F as FeedbackContext, c as AnimationProp, d as ResolvedAnimation } from '../pressable-feedback.type-UwqIG6ES.js';
+export { A as AnimationConfig, I as IconComponentProps, P as PressableFeedbackProps, R as RadiusStyle, e as RippleWave } from '../pressable-feedback.type-UwqIG6ES.js';
 import { V as ViewStyleProps } from '../create-recipe-DImq1AZA.js';
 export { A as Axes, C as CompoundVariant, D as DirectionalStyleKey, I as ImageStyleProps, 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, n as StyleProps, o as TextStyleProps, T as TintArgs, k as VariantColors, l as VariantRole, m as VariantTokens, c as createRecipe } from '../create-recipe-DImq1AZA.js';
 import * as react_native from 'react-native';
@@ -55,8 +55,12 @@ declare function useStyleProps<P extends object>(props: P): [StylePropsOf<P>, Re
  * Three accepted forms — a component through `as`, a raw SVG as children, or an image
  * through `source` — and the resolution is the same for all three: an explicit prop, else
  * what the surrounding slot published, else the theme.
+ *
+ * The props are taken whole rather than destructured, because they are a union: which
+ * keys exist depends on the form, and narrowing is what lets `style` be reachable in the
+ * one branch that renders a node and unwritable in the two that do not.
  */
-declare function Icon({ as: Component, children, source, size, color, style, ...props }: IconProps): react.JSX.Element;
+declare function Icon(props: IconProps): react.JSX.Element;
 declare namespace Icon {
     var displayName: string;
 }
@@ -378,7 +382,7 @@ declare function resolveSlotAnimation(override: SlotAnimation | undefined, enabl
  * off — and it is the only shape that survives `asChild`, where the caller's own element
  * is the pressable and there is no sibling for the primitive to inject.
  */
-declare const PressableFeedback: react.ForwardRefExoticComponent<Omit<react_native.PressableProps, "children" | "style" | "disabled"> & ViewStyleProps & {
+declare const PressableFeedback: react.ForwardRefExoticComponent<Omit<react_native.PressableProps, "style" | "children" | "disabled"> & ViewStyleProps & {
     isPressed?: boolean;
     isDisabled?: boolean;
     asChild?: boolean;

package/dist/system/index.js

@@ -27,7 +27,7 @@ import {
   rippleRadiusFor,
   useFeedback,
   useIconContext
-} from "../chunk-F432IDIW.js";
+} from "../chunk-VQPP6FCB.js";
 import {
   Slot,
   childrenToString,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xaui/native",
-  "version": "0.9.1-alpha.17",
+  "version": "0.9.1-alpha.18",
   "description": "Composition-first React Native UI components with native animations powered by Reanimated",
   "keywords": [
     "react-native",