@xaui/native 0.9.1-alpha.3 → 0.9.1-alpha.31

package/dist/chunk-7XKQJQF2.cjs

@@ -0,0 +1,70 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _chunkGLGU2WFLcjs = require('./chunk-GLGU2WFL.cjs');
+
+// src/hooks/use-merged-ref.ts
+var _react = require('react');
+function useMergedRef(...refs) {
+  return _react.useMemo.call(void 0, () => _chunkGLGU2WFLcjs.mergeRefs.call(void 0, ...refs), refs);
+}
+
+// src/hooks/use-previous.ts
+
+function usePrevious(value) {
+  const previous = _react.useRef.call(void 0, void 0);
+  _react.useEffect.call(void 0, () => {
+    previous.current = value;
+  }, [value]);
+  return previous.current;
+}
+
+// src/hooks/use-rotation.ts
+
+var _reactnativereanimated = require('react-native-reanimated');
+var ROTATION_DURATION = 900;
+const _worklet_4260628533630_init_data = {
+  code: "function chunk7XKQJQF2Cjs1(){const{angle}=this.__closure;return{transform:[{rotate:angle.value+\"deg\"}]};}",
+  location: "/home/runner/work/xaui/xaui/packages/native/dist/chunk-7XKQJQF2.cjs",
+  sourceMap: "{\"version\":3,\"names\":[\"chunk7XKQJQF2Cjs1\",\"angle\",\"__closure\",\"transform\",\"rotate\",\"value\"],\"sources\":[\"/home/runner/work/xaui/xaui/packages/native/dist/chunk-7XKQJQF2.cjs\"],\"mappings\":\"AAyC8D,SAAAA,iBAAMA,CAAA,QAAAC,KAAA,OAAAC,SAAA,CAEhE,MAAO,CAAEC,SAAS,CAAE,CAAC,CAAEC,MAAM,CAAKH,KAAK,CAACI,KAAK,MAAM,CAAC,CAAE,CAAC,CACzD\",\"ignoreList\":[]}"
+};
+function useRotation() {
+  const angle = _reactnativereanimated.useSharedValue.call(void 0, 0);
+  _react.useEffect.call(void 0, () => {
+    angle.value = _reactnativereanimated.withRepeat.call(void 0, _reactnativereanimated.withTiming.call(void 0, 360, {
+      duration: ROTATION_DURATION,
+      easing: _reactnativereanimated.Easing.linear
+    }), -1, false);
+    return () => _reactnativereanimated.cancelAnimation.call(void 0, angle);
+  }, [angle]);
+  return _reactnativereanimated.useAnimatedStyle.call(void 0, function chunk7XKQJQF2Cjs1Factory({
+    _worklet_4260628533630_init_data,
+    angle
+  }) {
+    const _e = [new global.Error(), -2, -27];
+    const chunk7XKQJQF2Cjs1 = function () {
+      return {
+        transform: [{
+          rotate: `${angle.value}deg`
+        }]
+      };
+    };
+    chunk7XKQJQF2Cjs1.__closure = {
+      angle
+    };
+    chunk7XKQJQF2Cjs1.__workletHash = 4260628533630;
+    chunk7XKQJQF2Cjs1.__pluginVersion = "0.7.4";
+    chunk7XKQJQF2Cjs1.__initData = _worklet_4260628533630_init_data;
+    chunk7XKQJQF2Cjs1.__stackDetails = _e;
+    return chunk7XKQJQF2Cjs1;
+  }({
+    _worklet_4260628533630_init_data,
+    angle
+  }), [angle]);
+}
+exports.useMergedRef = useMergedRef;
+exports.usePrevious = usePrevious;
+exports.ROTATION_DURATION = ROTATION_DURATION;
+exports.useRotation = useRotation;

package/dist/{chunk-X2K2FX3W.js → chunk-A3EGFI6T.js}

@@ -107,7 +107,10 @@ function deriveTint(tint, theme) {
     foreground,
     soft: alpha(tint, 0.15),
     softForeground: mix(tint, theme.colors.foreground, 0.2),
-    pressed: mix(tint, foreground, 0.1),
+    // Towards the mode's ink, not the tint's own foreground — the same single direction
+    // the token layer takes (P2-API-REVIEW §E). A raw tint has to behave like `accent`
+    // under the finger as much as it does at rest.
+    pressed: mix(tint, theme.colors.foreground, 0.1),
     softPressed: alpha(tint, 0.2)
   };
   cache.set(key, derived);
@@ -119,7 +122,9 @@ export {
   useXAUITheme,
   useColorMode,
   useThemeColor,
+  isHex,
   mix,
   alpha,
+  contrastOn,
   deriveTint
 };

package/dist/chunk-A5OCK3C2.js

@@ -0,0 +1,525 @@
+import {
+  createRecipe,
+  radiusAxis
+} from "./chunk-4GTAZM2C.js";
+import {
+  useXAUITheme
+} from "./chunk-A3EGFI6T.js";
+import {
+  Slot,
+  createSlotContext
+} from "./chunk-E2CWBQTV.js";
+import {
+  useStyleProps
+} from "./chunk-URSKA2VR.js";
+
+// src/components/input/input-description.tsx
+import { forwardRef } from "react";
+import { Text } from "react-native";
+
+// src/components/input/input.context.ts
+var [InputProvider, useInput] = createSlotContext("Input");
+
+// src/components/input/input-description.tsx
+import { jsx } from "react/jsx-runtime";
+var InputDescription = forwardRef(
+  function InputDescription2({ children, style, nativeID, ...props }, ref) {
+    const { descriptionStyle, descriptionId } = useInput();
+    const [styleProps, rest] = useStyleProps(props);
+    return /* @__PURE__ */ jsx(
+      Text,
+      {
+        ref,
+        nativeID: nativeID ?? descriptionId,
+        style: [descriptionStyle, styleProps, style],
+        ...rest,
+        children
+      }
+    );
+  }
+);
+InputDescription.displayName = "XAUI.Input.Description";
+
+// src/components/input/input-error.tsx
+import { forwardRef as forwardRef2 } from "react";
+import { Text as Text2 } from "react-native";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var InputError = forwardRef2(function InputError2({ children, style, ...props }, ref) {
+  const { errorStyle } = useInput();
+  const [styleProps, rest] = useStyleProps(props);
+  return /* @__PURE__ */ jsx2(Text2, { ref, style: [errorStyle, styleProps, style], ...rest, children });
+});
+InputError.displayName = "XAUI.Input.Error";
+
+// src/components/input/input-field.tsx
+import { forwardRef as forwardRef3, useCallback } from "react";
+import { TextInput } from "react-native";
+import { jsx as jsx3 } from "react/jsx-runtime";
+var InputField = forwardRef3(function InputField2({ style, onFocus, onBlur, placeholderTextColor, ...props }, ref) {
+  const {
+    fieldStyle,
+    placeholderTextColor: resolvedPlaceholder,
+    onFieldFocus,
+    onFieldBlur,
+    labelId,
+    descriptionId,
+    isDisabled,
+    isInvalid
+  } = useInput();
+  const [styleProps, rest] = useStyleProps(props);
+  const handleFocus = useCallback(
+    (event) => {
+      onFieldFocus(event);
+      onFocus?.(event);
+    },
+    [onFieldFocus, onFocus]
+  );
+  const handleBlur = useCallback(
+    (event) => {
+      onFieldBlur(event);
+      onBlur?.(event);
+    },
+    [onFieldBlur, onBlur]
+  );
+  return /* @__PURE__ */ jsx3(
+    TextInput,
+    {
+      ref,
+      "aria-labelledby": labelId,
+      "aria-describedby": descriptionId,
+      "aria-invalid": isInvalid,
+      editable: !isDisabled,
+      accessibilityState: { disabled: isDisabled },
+      placeholderTextColor: placeholderTextColor ?? resolvedPlaceholder,
+      ...rest,
+      style: [fieldStyle, styleProps, style],
+      onFocus: handleFocus,
+      onBlur: handleBlur
+    }
+  );
+});
+InputField.displayName = "XAUI.Input.Field";
+
+// src/components/input/input-label.tsx
+import { forwardRef as forwardRef4 } from "react";
+import { Text as Text3 } from "react-native";
+import { jsx as jsx4 } from "react/jsx-runtime";
+var InputLabel = forwardRef4(function InputLabel2({ children, style, nativeID, ...props }, ref) {
+  const { labelStyle, labelId } = useInput();
+  const [styleProps, rest] = useStyleProps(props);
+  return /* @__PURE__ */ jsx4(
+    Text3,
+    {
+      ref,
+      nativeID: nativeID ?? labelId,
+      style: [labelStyle, styleProps, style],
+      ...rest,
+      children
+    }
+  );
+});
+InputLabel.displayName = "XAUI.Input.Label";
+
+// src/components/input/input.tsx
+import { forwardRef as forwardRef5, useCallback as useCallback2, useId, useMemo, useState } from "react";
+import { StyleSheet, View } from "react-native";
+
+// src/components/input/input.recipe.ts
+var SLOTS = [
+  "root",
+  "label",
+  "field",
+  "textArea",
+  "placeholder",
+  "description",
+  "error",
+  "prefix",
+  "suffix",
+  "icon"
+];
+var VARIANT_TOKENS = {
+  primary: {
+    bg: "fieldBackground",
+    border: "fieldBorder",
+    borderFocus: "fieldBorderFocus",
+    fg: "fieldForeground"
+  },
+  // `bg: 'default'` is the neutral *token*, not this variant's name — the two namespaces
+  // meet here and nowhere else. It is also what keeps a field visible on a card, where
+  // `fieldBackground` is the card's own colour.
+  secondary: {
+    bg: "default",
+    border: "fieldBorder",
+    borderFocus: "fieldBorderFocus",
+    fg: "fieldForeground"
+  },
+  tertiary: {
+    border: "fieldBorder",
+    borderFocus: "fieldBorderFocus",
+    fg: "fieldForeground"
+  },
+  ghost: { borderFocus: "fieldBorderFocus", fg: "fieldForeground" }
+};
+function sizeAxis(step) {
+  const { control, padding, gap, field, label, help, glyph, textAreaPadding } = step;
+  return (theme) => {
+    const inset = { paddingHorizontal: theme.spacing(LABEL_INSET) };
+    const helpType = {
+      fontSize: theme.fontSizes[help],
+      lineHeight: theme.lineHeights[help]
+    };
+    const decorator = {
+      paddingHorizontal: theme.spacing(padding),
+      gap: theme.spacing(padding)
+    };
+    return {
+      root: { gap: theme.spacing(gap) },
+      label: {
+        ...inset,
+        fontSize: theme.fontSizes[label],
+        lineHeight: theme.lineHeights[label]
+      },
+      field: {
+        minHeight: theme.controlHeights[control],
+        paddingHorizontal: theme.spacing(padding),
+        fontSize: theme.fontSizes[field]
+      },
+      // Only what a multiline field *adds* — `Input.TextArea` layers this over the field's
+      // own style rather than restating it, so the colours, the border and the radius are
+      // resolved once for both. The height is not here: `rows` is a raw value, and the
+      // slot computes it from the two numbers below.
+      textArea: {
+        lineHeight: theme.lineHeights[field],
+        paddingTop: theme.spacing(textAreaPadding),
+        paddingBottom: theme.spacing(textAreaPadding)
+      },
+      description: { ...inset, ...helpType },
+      error: { ...inset, ...helpType },
+      prefix: decorator,
+      suffix: decorator,
+      icon: { fontSize: theme.fontSizes[glyph] }
+    };
+  };
+}
+var LABEL_INSET = 1.5;
+var DECORATOR = {
+  position: "absolute",
+  top: 0,
+  bottom: 0,
+  flexDirection: "row",
+  alignItems: "center",
+  justifyContent: "center",
+  zIndex: 10
+};
+var SIZES = {
+  xs: {
+    control: "xs",
+    padding: 2.5,
+    gap: 0.75,
+    field: "sm",
+    label: "sm",
+    help: "xs",
+    glyph: "md",
+    labelInside: "xs",
+    textAreaPadding: 1.5
+  },
+  sm: {
+    control: "sm",
+    padding: 3,
+    gap: 0.75,
+    field: "md",
+    label: "sm",
+    help: "xs",
+    glyph: "lg",
+    labelInside: "xs",
+    textAreaPadding: 2
+  },
+  md: {
+    control: "md",
+    padding: 3,
+    gap: 1.25,
+    field: "md",
+    label: "md",
+    help: "sm",
+    glyph: "lg",
+    labelInside: "xs",
+    textAreaPadding: 2
+  },
+  lg: {
+    control: "lg",
+    padding: 4,
+    gap: 1.75,
+    field: "lg",
+    label: "lg",
+    help: "md",
+    glyph: "xl",
+    labelInside: "sm",
+    textAreaPadding: 2.5
+  }
+};
+function insideLabel(step) {
+  const { control, padding, field, labelInside } = step;
+  return (theme) => {
+    const top = theme.spacing(LABEL_INSIDE_TOP);
+    const block = top + theme.lineHeights[labelInside];
+    return {
+      label: {
+        position: "absolute",
+        top,
+        // `start`, never `left` (R13): RTL mirrors the logical property and only it.
+        start: theme.spacing(padding),
+        paddingHorizontal: 0,
+        fontSize: theme.fontSizes[labelInside],
+        lineHeight: theme.lineHeights[labelInside]
+      },
+      // The height is built from the two lines it now holds rather than added to the
+      // control height: `controlHeights` already pays for centring one line, so adding
+      // the label's block to it would pay for that room twice. It is floored at the
+      // control height all the same, so a theme that raises `controlHeights` does not end
+      // up with an inside field shorter than the outside one beside it.
+      field: {
+        minHeight: Math.max(
+          block + theme.lineHeights[field] + top,
+          theme.controlHeights[control]
+        ),
+        paddingTop: block,
+        paddingBottom: top
+      },
+      // The same room, because `Input.TextArea` layers its own padding over the field's
+      // and would otherwise put the first line back under the label.
+      textArea: { paddingTop: block, paddingBottom: top }
+    };
+  };
+}
+var LABEL_INSIDE_TOP = 1.5;
+var inputRecipe = createRecipe({
+  slots: SLOTS,
+  base: (theme) => ({
+    root: { flexDirection: "column" },
+    label: {
+      fontFamily: theme.fontFamilies.body,
+      fontWeight: theme.fontWeights.medium
+    },
+    field: {
+      fontFamily: theme.fontFamilies.body,
+      // `regular`, not `medium`: what the user typed is content, not a control's label,
+      // and a heavier weight makes a filled field read as a button.
+      fontWeight: theme.fontWeights.regular,
+      borderWidth: theme.borderWidth.field,
+      // The theme has a radius named for this component, so every size uses it and the
+      // `radius` axis is what overrides it — the same shape a `Chip` takes from `full`.
+      // It is HeroUI's twelve points since the scale was aligned on theirs; it was 21,
+      // which put a 48-tall field at 87% of its geometric maximum.
+      borderRadius: theme.radius.field,
+      borderCurve: "continuous",
+      // RN centres a single line inside `minHeight` on iOS and pins it to the top on
+      // Android. Saying it removes a difference nobody chose.
+      textAlignVertical: "center"
+    },
+    // Several lines start at the top; only a single line is centred in its box.
+    textArea: { textAlignVertical: "top" },
+    // Not a node — the root flattens this one into `placeholderTextColor`, which is a
+    // `TextInput` prop rather than a style.
+    placeholder: { color: theme.colors.fieldPlaceholder },
+    description: {
+      fontFamily: theme.fontFamilies.body,
+      color: theme.colors.muted
+    },
+    error: {
+      fontFamily: theme.fontFamilies.body,
+      color: theme.colors.danger
+    },
+    prefix: { ...DECORATOR, start: 0 },
+    suffix: { ...DECORATOR, end: 0 },
+    // The glyph sits with the placeholder rather than with the value: a search mark or a
+    // lock is decoration for the text, not text. `paint` leaves it alone, so a tinted
+    // filled field is the one case where the caller names a colour on the icon itself.
+    icon: { color: theme.colors.fieldPlaceholder }
+  }),
+  variantTokens: VARIANT_TOKENS,
+  /**
+   * Where the variant's colours land. The border width follows the *presence* of the
+   * border role, so `ghost` needs no rule of its own to say it has no edge.
+   *
+   * The label is **not** painted from the variant: it sits outside the box, on the screen
+   * behind it, so it takes `foreground` and not the field's own text colour. That is also
+   * why a tinted input does not tint its label — the tint is the field's, not the form's.
+   */
+  paint: (theme, colors) => ({
+    field: {
+      backgroundColor: colors.bg,
+      borderColor: colors.border,
+      borderWidth: colors.border ? theme.borderWidth.field : 0,
+      color: colors.fg
+    },
+    label: { color: theme.colors.foreground }
+  }),
+  /**
+   * Declaration order is application order, and it is load-bearing here: `isInvalid`
+   * comes after `size` so its border wins, and it must also outrank focus — which is why
+   * the root passes `focused` only when the field is *not* invalid, rather than relying
+   * on an order that states cannot express.
+   */
+  variants: {
+    size: {
+      xs: sizeAxis(SIZES.xs),
+      sm: sizeAxis(SIZES.sm),
+      md: sizeAxis(SIZES.md),
+      lg: sizeAxis(SIZES.lg)
+    },
+    radius: radiusAxis("field"),
+    /**
+     * `outside` is the base behaviour, so it adds nothing — it is declared because an
+     * axis needs both of its values for the selection to be typed, and because a reader
+     * looking for "what does outside do" should find the answer here rather than infer it
+     * from an absence. The size-dependent half of `inside` is in `compoundVariants`.
+     */
+    labelPlacement: {
+      outside: () => ({}),
+      inside: () => ({})
+    },
+    isInvalid: {
+      true: (theme) => ({
+        field: { borderColor: theme.colors.danger },
+        // The label and the description turn with it: on a long form the field that is
+        // wrong has to be findable without reading every message.
+        label: { color: theme.colors.danger },
+        description: { color: theme.colors.danger }
+      })
+    }
+  },
+  /**
+   * The focus treatment is the border darkening towards the mode's ink — the theme's
+   * `fieldBorderFocus`, which is `fieldBorder` mixed 26% towards `fieldForeground`. No
+   * ring and no accent: a form where every focused field flashes the brand colour is a
+   * form where the accent has stopped meaning "the action".
+   *
+   * `borderFocus` is a role rather than a token named here, so a raw `color` follows the
+   * field into focus the same way it follows a `Button` into its pressed state.
+   */
+  /**
+   * What `primary` adds to a filled field, and the four halves of the inside label that
+   * need to know the size — a compound is how the engine expresses a rule that depends on
+   * two axes at once.
+   */
+  compoundVariants: [
+    {
+      when: { variant: "primary" },
+      style: (theme) => ({ field: theme.shadows.field })
+    },
+    { when: { size: "xs", labelPlacement: "inside" }, style: insideLabel(SIZES.xs) },
+    { when: { size: "sm", labelPlacement: "inside" }, style: insideLabel(SIZES.sm) },
+    { when: { size: "md", labelPlacement: "inside" }, style: insideLabel(SIZES.md) },
+    { when: { size: "lg", labelPlacement: "inside" }, style: insideLabel(SIZES.lg) }
+  ],
+  states: {
+    focused: (_theme, colors) => ({ field: { borderColor: colors.borderFocus } }),
+    disabled: (theme) => ({ root: { opacity: theme.opacity.disabled } })
+  },
+  defaultVariants: { variant: "secondary", size: "md", labelPlacement: "outside" }
+});
+
+// src/components/input/input.tsx
+import { jsx as jsx5 } from "react/jsx-runtime";
+var InputRoot = forwardRef5(function Input({
+  children,
+  variant,
+  size,
+  radius,
+  labelPlacement,
+  color,
+  isInvalid = false,
+  isDisabled = false,
+  asChild = false,
+  style,
+  ...props
+}, ref) {
+  const theme = useXAUITheme();
+  const [styleProps, rest] = useStyleProps(props);
+  const [isFocused, setIsFocused] = useState(false);
+  const onFieldFocus = useCallback2(() => setIsFocused(true), []);
+  const onFieldBlur = useCallback2(() => setIsFocused(false), []);
+  const id = useId();
+  const labelId = `${id}-label`;
+  const descriptionId = `${id}-description`;
+  const selection = {
+    variant,
+    size,
+    radius,
+    labelPlacement,
+    isInvalid: isInvalid ? "true" : void 0
+  };
+  const states = { focused: isFocused && !isInvalid, disabled: isDisabled };
+  const styles = inputRecipe.resolve({ theme, selection, states });
+  const tint = color ? inputRecipe.tint({ theme, color, selection, states }) : void 0;
+  const context = useMemo(() => {
+    const placeholder = StyleSheet.flatten(styles.placeholder);
+    const icon = StyleSheet.flatten(styles.icon);
+    const textArea = StyleSheet.flatten(styles.textArea);
+    return {
+      labelStyle: tint ? [styles.label, tint.label] : styles.label,
+      fieldStyle: tint ? [styles.field, tint.field] : styles.field,
+      textAreaStyle: styles.textArea,
+      textArea: {
+        lineHeight: textArea.lineHeight ?? 0,
+        // `DimensionValue` also covers a percentage and `auto`, neither of which can be
+        // multiplied by a number of rows. The recipe only ever writes points here.
+        paddingVertical: typeof textArea.paddingBottom === "number" ? textArea.paddingBottom : 0
+      },
+      descriptionStyle: styles.description,
+      errorStyle: styles.error,
+      prefixStyle: styles.prefix,
+      suffixStyle: styles.suffix,
+      icon: {
+        size: icon.fontSize,
+        // `ColorValue` also covers the platform's opaque colours, which an icon component
+        // takes as a `string` and nothing else.
+        color: typeof icon.color === "string" ? icon.color : void 0
+      },
+      // `ColorValue` also covers the platform's opaque colours, which `TextInput` cannot
+      // take for a placeholder.
+      placeholderTextColor: typeof placeholder.color === "string" ? placeholder.color : void 0,
+      onFieldFocus,
+      onFieldBlur,
+      labelId,
+      descriptionId,
+      isDisabled,
+      isInvalid
+    };
+  }, [
+    styles,
+    tint,
+    onFieldFocus,
+    onFieldBlur,
+    labelId,
+    descriptionId,
+    isDisabled,
+    isInvalid
+  ]);
+  const rootStyle = [styles.root, tint?.root, styleProps, style];
+  const surface = asChild ? (
+    // R12 — the caller's element *is* the column.
+    /* @__PURE__ */ jsx5(Slot, { ref, ...rest, style: rootStyle, children })
+  ) : /* @__PURE__ */ jsx5(View, { ref, ...rest, style: rootStyle, children });
+  return /* @__PURE__ */ jsx5(InputProvider, { value: context, children: surface });
+});
+InputRoot.displayName = "XAUI.Input.Root";
+
+// src/components/input/index.ts
+var Input2 = Object.assign(InputRoot, {
+  Label: InputLabel,
+  Field: InputField,
+  Description: InputDescription,
+  Error: InputError
+});
+
+export {
+  useInput,
+  InputDescription,
+  InputError,
+  InputField,
+  InputLabel,
+  inputRecipe,
+  InputRoot,
+  Input2 as Input
+};