@xaui/native 0.9.1-alpha.38 → 0.9.1-alpha.39

package/dist/placement-DHa0Rrh1.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Where a floating panel lands against the thing that opened it, as four numbers.
+ *
+ * Pure on purpose, and shared: positioning an overlay is the one part of a `Select`, a
+ * `Popover` or a `Menu` that is arithmetic rather than rendering, and arithmetic that runs
+ * once per open is arithmetic worth a test rather than a screenshot.
+ *
+ * Everything here is in the coordinate space of whatever the panel is laid out in — the
+ * caller subtracts the portal host's own origin before calling, because the trigger
+ * reports itself against the window and the panel is not laid out in the window.
+ */
+/** `start` and `end` rather than `left` and `right` (R13): the sides mirror in RTL. */
+type Placement = 'top' | 'bottom' | 'start' | 'end';
+/** Where the panel lines up along the edge it is pinned to. */
+type Align = 'start' | 'center' | 'end';
+/** The trigger's rectangle. */
+type Anchor = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/**
+ * `trigger` matches the anchor exactly. `content-fit` hugs what the panel measured at,
+ * which the component bounds with a measure of its own. `full` is the screen less its
+ * insets — the way to say "yes, actually, all of it", which nothing else in the union can
+ * express: a number is a guess at the screen's width, and `content-fit` refuses on purpose.
+ */
+type AnchoredWidth = number | 'trigger' | 'content-fit' | 'full';
+/** Screen edges the panel refuses to cross, in points. */
+type Insets = {
+    top?: number;
+    bottom?: number;
+    start?: number;
+    end?: number;
+};
+
+export type { Align as A, Insets as I, Placement as P, AnchoredWidth as a, Anchor as b };

package/dist/system/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-OJCCV65P.cjs');
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('../chunk-GGW43Q37.cjs');
 
 
 
@@ -7,6 +7,14 @@ var _chunkWDDXU3OHcjs = require('../chunk-WDDXU3OH.cjs');
 
 
 
+
+
+
+
+var _chunkEKS3W46Mcjs = require('../chunk-EKS3W46M.cjs');
+
+
+
 var _chunkAAVCMCJ3cjs = require('../chunk-AAVCMCJ3.cjs');
 
 
@@ -97,4 +105,10 @@ var _chunkTK44VBIEcjs = require('../chunk-TK44VBIE.cjs');
 
 
 
-exports.ChevronDownIcon = _chunk4KFKWBN5cjs.ChevronDownIcon; exports.CloseButton = _chunkAAVCMCJ3cjs.CloseButton; exports.FEEDBACK_OVERLAY = _chunkTGMVEHV7cjs.FEEDBACK_OVERLAY; exports.HIGHLIGHT_DURATION = _chunkTGMVEHV7cjs.HIGHLIGHT_DURATION; exports.HIGHLIGHT_OPACITY = _chunkTGMVEHV7cjs.HIGHLIGHT_OPACITY; exports.Icon = _chunk4KFKWBN5cjs.Icon; exports.IconContext = _chunk4KFKWBN5cjs.IconContext; exports.PRESS_DURATION = _chunkTGMVEHV7cjs.PRESS_DURATION; exports.PRESS_SCALE = _chunkTGMVEHV7cjs.PRESS_SCALE; exports.Portal = _chunkWDDXU3OHcjs.Portal; exports.PortalContext = _chunkWDDXU3OHcjs.PortalContext; exports.PortalHost = _chunkWDDXU3OHcjs.PortalHost; exports.PressableFeedback = _chunkTGMVEHV7cjs.PressableFeedback; exports.RIPPLE_CONFIRM_DURATION = _chunkTGMVEHV7cjs.RIPPLE_CONFIRM_DURATION; exports.RIPPLE_EXPAND_DURATION = _chunkTGMVEHV7cjs.RIPPLE_EXPAND_DURATION; exports.RIPPLE_FADE_IN = _chunkTGMVEHV7cjs.RIPPLE_FADE_IN; exports.RIPPLE_FADE_OUT = _chunkTGMVEHV7cjs.RIPPLE_FADE_OUT; exports.RIPPLE_FADE_OUT_DELAY = _chunkTGMVEHV7cjs.RIPPLE_FADE_OUT_DELAY; exports.RIPPLE_OPACITY = _chunkTGMVEHV7cjs.RIPPLE_OPACITY; exports.RIPPLE_START_SCALE = _chunkTGMVEHV7cjs.RIPPLE_START_SCALE; exports.SCALE_REFERENCE_WIDTH = _chunkTGMVEHV7cjs.SCALE_REFERENCE_WIDTH; exports.SelectionFill = _chunkF6CQ6CBIcjs.SelectionFill; exports.Slot = _chunk7GHM4GKLcjs.Slot; exports.childrenToString = _chunk7GHM4GKLcjs.childrenToString; exports.closeButtonBase = _chunkAAVCMCJ3cjs.closeButtonBase; exports.createRecipe = _chunkFNEUOBCVcjs.createRecipe; exports.createSlotContext = _chunk7GHM4GKLcjs.createSlotContext; exports.markOverlay = _chunkTGMVEHV7cjs.markOverlay; exports.mergeProps = _chunk7GHM4GKLcjs.mergeProps; exports.mergeRefs = _chunkH4E4HDEPcjs.mergeRefs; exports.pressScaleFor = _chunkTGMVEHV7cjs.pressScaleFor; exports.radiusAxis = _chunkFNEUOBCVcjs.radiusAxis; exports.resolveAnimation = _chunkTGMVEHV7cjs.resolveAnimation; exports.resolveSlotAnimation = _chunkTGMVEHV7cjs.resolveSlotAnimation; exports.rippleRadiusFor = _chunkTGMVEHV7cjs.rippleRadiusFor; exports.useFeedback = _chunkTGMVEHV7cjs.useFeedback; exports.useIconContext = _chunk4KFKWBN5cjs.useIconContext; exports.useStyleProps = _chunkTK44VBIEcjs.useStyleProps;
+
+
+
+
+
+
+exports.ChevronDownIcon = _chunk4KFKWBN5cjs.ChevronDownIcon; exports.CloseButton = _chunkAAVCMCJ3cjs.CloseButton; exports.FEEDBACK_OVERLAY = _chunkTGMVEHV7cjs.FEEDBACK_OVERLAY; exports.HIGHLIGHT_DURATION = _chunkTGMVEHV7cjs.HIGHLIGHT_DURATION; exports.HIGHLIGHT_OPACITY = _chunkTGMVEHV7cjs.HIGHLIGHT_OPACITY; exports.INDICATOR_ROTATION = _chunkEKS3W46Mcjs.INDICATOR_ROTATION; exports.INDICATOR_SPRING = _chunkEKS3W46Mcjs.INDICATOR_SPRING; exports.Icon = _chunk4KFKWBN5cjs.Icon; exports.IconContext = _chunk4KFKWBN5cjs.IconContext; exports.PRESS_DURATION = _chunkTGMVEHV7cjs.PRESS_DURATION; exports.PRESS_SCALE = _chunkTGMVEHV7cjs.PRESS_SCALE; exports.Portal = _chunkWDDXU3OHcjs.Portal; exports.PortalContext = _chunkWDDXU3OHcjs.PortalContext; exports.PortalHost = _chunkWDDXU3OHcjs.PortalHost; exports.PressableFeedback = _chunkTGMVEHV7cjs.PressableFeedback; exports.RIPPLE_CONFIRM_DURATION = _chunkTGMVEHV7cjs.RIPPLE_CONFIRM_DURATION; exports.RIPPLE_EXPAND_DURATION = _chunkTGMVEHV7cjs.RIPPLE_EXPAND_DURATION; exports.RIPPLE_FADE_IN = _chunkTGMVEHV7cjs.RIPPLE_FADE_IN; exports.RIPPLE_FADE_OUT = _chunkTGMVEHV7cjs.RIPPLE_FADE_OUT; exports.RIPPLE_FADE_OUT_DELAY = _chunkTGMVEHV7cjs.RIPPLE_FADE_OUT_DELAY; exports.RIPPLE_OPACITY = _chunkTGMVEHV7cjs.RIPPLE_OPACITY; exports.RIPPLE_START_SCALE = _chunkTGMVEHV7cjs.RIPPLE_START_SCALE; exports.SCALE_REFERENCE_WIDTH = _chunkTGMVEHV7cjs.SCALE_REFERENCE_WIDTH; exports.SelectionFill = _chunkF6CQ6CBIcjs.SelectionFill; exports.Slot = _chunk7GHM4GKLcjs.Slot; exports.anchoredEntering = _chunkEKS3W46Mcjs.anchoredEntering; exports.anchoredExiting = _chunkEKS3W46Mcjs.anchoredExiting; exports.childrenToString = _chunk7GHM4GKLcjs.childrenToString; exports.closeButtonBase = _chunkAAVCMCJ3cjs.closeButtonBase; exports.createRecipe = _chunkFNEUOBCVcjs.createRecipe; exports.createSlotContext = _chunk7GHM4GKLcjs.createSlotContext; exports.markOverlay = _chunkTGMVEHV7cjs.markOverlay; exports.mergeProps = _chunk7GHM4GKLcjs.mergeProps; exports.mergeRefs = _chunkH4E4HDEPcjs.mergeRefs; exports.overlayEntering = _chunkEKS3W46Mcjs.overlayEntering; exports.overlayExiting = _chunkEKS3W46Mcjs.overlayExiting; exports.pressScaleFor = _chunkTGMVEHV7cjs.pressScaleFor; exports.radiusAxis = _chunkFNEUOBCVcjs.radiusAxis; exports.resolveAnimation = _chunkTGMVEHV7cjs.resolveAnimation; exports.resolveSlotAnimation = _chunkTGMVEHV7cjs.resolveSlotAnimation; exports.rippleRadiusFor = _chunkTGMVEHV7cjs.rippleRadiusFor; exports.useFeedback = _chunkTGMVEHV7cjs.useFeedback; exports.useIconContext = _chunk4KFKWBN5cjs.useIconContext; exports.useStyleProps = _chunkTK44VBIEcjs.useStyleProps;

package/dist/system/index.d.cts

@@ -11,7 +11,8 @@ export { C as CloseButtonProps } from '../close-button.type-CHsgZ3wO.cjs';
 import { b as IconComponentProps, a as IconProps, I as IconContextValue } from '../icon.type-d_i9ma-i.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 * as react_native_reanimated from 'react-native-reanimated';
+import { P as Placement } from '../placement-DHa0Rrh1.cjs';
 
 /**
  * The runtime half of R14. The type half lives in `system/style-props/`, and the two are
@@ -488,6 +489,41 @@ type SlotProps = MergeableProps & {
  */
 declare const Slot: react.ForwardRefExoticComponent<Omit<SlotProps, "ref"> & react.RefAttributes<unknown>>;
 
+/**
+ * A panel that grows out of the thing that opened it.
+ *
+ * It starts slightly small and offset **towards** the trigger, so the motion points back
+ * at what opened it: a panel below enters upwards, one above enters downwards, one beside
+ * enters sideways. That is the only reason placement reaches the animation at all.
+ *
+ * Shared by the `Select` and the `Popover`, which is the second use §2 bis waits for. It
+ * lives in `system/` rather than in `utils/` because a `Keyframe` is Reanimated's, and
+ * `utils/` has to stay importable by a test that never mounts anything.
+ */
+declare function anchoredEntering(placement: Placement): react_native_reanimated.ReanimatedKeyframe;
+/**
+ * The mirror, shorter. Closing is an acknowledgement rather than an arrival, and a
+ * dismissal that takes as long as the opening feels like the control is arguing.
+ */
+declare function anchoredExiting(placement: Placement): react_native_reanimated.ReanimatedKeyframe;
+declare const overlayEntering: react_native_reanimated.ReanimatedKeyframe;
+declare const overlayExiting: react_native_reanimated.ReanimatedKeyframe;
+
+/**
+ * The chevron's turn, shared by the `Select` and the `Accordion`.
+ *
+ * HeroUI's numbers. Heavily damped against a very high stiffness: it arrives in about a
+ * fifth of a second and does not overshoot, which is what a turn of 180 degrees needs —
+ * an oscillating chevron reads as a bug rather than as motion.
+ */
+declare const INDICATOR_SPRING: {
+    readonly damping: 140;
+    readonly stiffness: 1000;
+    readonly mass: 4;
+};
+/** Degrees. Down when closed, up when open, turning anticlockwise as HeroUI's does. */
+declare const INDICATOR_ROTATION: readonly [0, -180];
+
 /**
  * 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
@@ -542,4 +578,4 @@ type CloseButtonSlots = {
  */
 declare function closeButtonBase(theme: XAUITheme): CloseButtonSlots;
 
-export { AnimationProp, type AsChildProps, ChevronDownIcon, CloseButton, type CloseButtonSlots, FEEDBACK_OVERLAY, FeedbackContext, HIGHLIGHT_DURATION, HIGHLIGHT_OPACITY, Icon, IconComponentProps, 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, SelectionFill, type SelectionFillProps, Slot, SlotAnimation, type SlotProps, SlotStyle, StyleFn, ViewStyleProps, childrenToString, closeButtonBase, createSlotContext, markOverlay, mergeProps, mergeRefs, pressScaleFor, radiusAxis, resolveAnimation, resolveSlotAnimation, rippleRadiusFor, useFeedback, useIconContext, useStyleProps };
+export { AnimationProp, type AsChildProps, ChevronDownIcon, CloseButton, type CloseButtonSlots, FEEDBACK_OVERLAY, FeedbackContext, HIGHLIGHT_DURATION, HIGHLIGHT_OPACITY, INDICATOR_ROTATION, INDICATOR_SPRING, Icon, IconComponentProps, 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, SelectionFill, type SelectionFillProps, Slot, SlotAnimation, type SlotProps, SlotStyle, StyleFn, ViewStyleProps, anchoredEntering, anchoredExiting, childrenToString, closeButtonBase, createSlotContext, markOverlay, mergeProps, mergeRefs, overlayEntering, overlayExiting, pressScaleFor, radiusAxis, resolveAnimation, resolveSlotAnimation, rippleRadiusFor, useFeedback, useIconContext, useStyleProps };

package/dist/system/index.d.ts

@@ -11,7 +11,8 @@ export { C as CloseButtonProps } from '../close-button.type-BUYuoSt2.js';
 import { b as IconComponentProps, a as IconProps, I as IconContextValue } from '../icon.type-Kml72iSz.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 * as react_native_reanimated from 'react-native-reanimated';
+import { P as Placement } from '../placement-DHa0Rrh1.js';
 
 /**
  * The runtime half of R14. The type half lives in `system/style-props/`, and the two are
@@ -488,6 +489,41 @@ type SlotProps = MergeableProps & {
  */
 declare const Slot: react.ForwardRefExoticComponent<Omit<SlotProps, "ref"> & react.RefAttributes<unknown>>;
 
+/**
+ * A panel that grows out of the thing that opened it.
+ *
+ * It starts slightly small and offset **towards** the trigger, so the motion points back
+ * at what opened it: a panel below enters upwards, one above enters downwards, one beside
+ * enters sideways. That is the only reason placement reaches the animation at all.
+ *
+ * Shared by the `Select` and the `Popover`, which is the second use §2 bis waits for. It
+ * lives in `system/` rather than in `utils/` because a `Keyframe` is Reanimated's, and
+ * `utils/` has to stay importable by a test that never mounts anything.
+ */
+declare function anchoredEntering(placement: Placement): react_native_reanimated.ReanimatedKeyframe;
+/**
+ * The mirror, shorter. Closing is an acknowledgement rather than an arrival, and a
+ * dismissal that takes as long as the opening feels like the control is arguing.
+ */
+declare function anchoredExiting(placement: Placement): react_native_reanimated.ReanimatedKeyframe;
+declare const overlayEntering: react_native_reanimated.ReanimatedKeyframe;
+declare const overlayExiting: react_native_reanimated.ReanimatedKeyframe;
+
+/**
+ * The chevron's turn, shared by the `Select` and the `Accordion`.
+ *
+ * HeroUI's numbers. Heavily damped against a very high stiffness: it arrives in about a
+ * fifth of a second and does not overshoot, which is what a turn of 180 degrees needs —
+ * an oscillating chevron reads as a bug rather than as motion.
+ */
+declare const INDICATOR_SPRING: {
+    readonly damping: 140;
+    readonly stiffness: 1000;
+    readonly mass: 4;
+};
+/** Degrees. Down when closed, up when open, turning anticlockwise as HeroUI's does. */
+declare const INDICATOR_ROTATION: readonly [0, -180];
+
 /**
  * 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
@@ -542,4 +578,4 @@ type CloseButtonSlots = {
  */
 declare function closeButtonBase(theme: XAUITheme): CloseButtonSlots;
 
-export { AnimationProp, type AsChildProps, ChevronDownIcon, CloseButton, type CloseButtonSlots, FEEDBACK_OVERLAY, FeedbackContext, HIGHLIGHT_DURATION, HIGHLIGHT_OPACITY, Icon, IconComponentProps, 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, SelectionFill, type SelectionFillProps, Slot, SlotAnimation, type SlotProps, SlotStyle, StyleFn, ViewStyleProps, childrenToString, closeButtonBase, createSlotContext, markOverlay, mergeProps, mergeRefs, pressScaleFor, radiusAxis, resolveAnimation, resolveSlotAnimation, rippleRadiusFor, useFeedback, useIconContext, useStyleProps };
+export { AnimationProp, type AsChildProps, ChevronDownIcon, CloseButton, type CloseButtonSlots, FEEDBACK_OVERLAY, FeedbackContext, HIGHLIGHT_DURATION, HIGHLIGHT_OPACITY, INDICATOR_ROTATION, INDICATOR_SPRING, Icon, IconComponentProps, 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, SelectionFill, type SelectionFillProps, Slot, SlotAnimation, type SlotProps, SlotStyle, StyleFn, ViewStyleProps, anchoredEntering, anchoredExiting, childrenToString, closeButtonBase, createSlotContext, markOverlay, mergeProps, mergeRefs, overlayEntering, overlayExiting, pressScaleFor, radiusAxis, resolveAnimation, resolveSlotAnimation, rippleRadiusFor, useFeedback, useIconContext, useStyleProps };

package/dist/system/index.js

@@ -1,9 +1,17 @@
-import "../chunk-MESKS6AI.js";
+import "../chunk-WHJTBTYM.js";
 import {
   Portal,
   PortalContext,
   PortalHost
 } from "../chunk-2PMXMKS5.js";
+import {
+  INDICATOR_ROTATION,
+  INDICATOR_SPRING,
+  anchoredEntering,
+  anchoredExiting,
+  overlayEntering,
+  overlayExiting
+} from "../chunk-64MXEVT3.js";
 import {
   CloseButton,
   closeButtonBase
@@ -64,6 +72,8 @@ export {
   FEEDBACK_OVERLAY,
   HIGHLIGHT_DURATION,
   HIGHLIGHT_OPACITY,
+  INDICATOR_ROTATION,
+  INDICATOR_SPRING,
   Icon,
   IconContext,
   PRESS_DURATION,
@@ -82,6 +92,8 @@ export {
   SCALE_REFERENCE_WIDTH,
   SelectionFill,
   Slot,
+  anchoredEntering,
+  anchoredExiting,
   childrenToString,
   closeButtonBase,
   createRecipe,
@@ -89,6 +101,8 @@ export {
   markOverlay,
   mergeProps,
   mergeRefs,
+  overlayEntering,
+  overlayExiting,
   pressScaleFor,
   radiusAxis,
   resolveAnimation,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xaui/native",
-  "version": "0.9.1-alpha.38",
+  "version": "0.9.1-alpha.39",
   "description": "Composition-first React Native UI components with native animations powered by Reanimated",
   "keywords": [
     "react-native",
@@ -137,6 +137,16 @@
         "default": "./dist/components/input-otp/index.cjs"
       }
     },
+    "./popover": {
+      "import": {
+        "types": "./dist/components/popover/index.d.ts",
+        "default": "./dist/components/popover/index.js"
+      },
+      "require": {
+        "types": "./dist/components/popover/index.d.cts",
+        "default": "./dist/components/popover/index.cjs"
+      }
+    },
     "./radio": {
       "import": {
         "types": "./dist/components/radio/index.d.ts",