@xaui/native 0.9.1-alpha.4 → 0.9.1-alpha.40

package/dist/chunk-2EGR4LWD.js

@@ -0,0 +1,145 @@
+import {
+  PortalContext
+} from "./chunk-2PMXMKS5.js";
+
+// src/hooks/use-anchored-position.ts
+import { useCallback, useContext, useState } from "react";
+import { useWindowDimensions } from "react-native";
+
+// src/utils/placement.ts
+var OPPOSITE = {
+  top: "bottom",
+  bottom: "top",
+  start: "end",
+  end: "start"
+};
+function axisOf(placement) {
+  return placement === "top" || placement === "bottom" ? "vertical" : "horizontal";
+}
+function resolvePlacement(input) {
+  const { anchor, content, window, offset, alignOffset, insets } = input;
+  const available = window.width - insets.start - insets.end;
+  const width = Math.min(resolveWidth(input), Math.max(available, 0));
+  const placement = choosePlacement(input);
+  const room = Math.max(roomFor(placement, input), 0);
+  const vertical = axisOf(placement) === "vertical";
+  const maxHeight = vertical ? room : Math.max(window.height - insets.top - insets.bottom, 0);
+  const height = Math.min(content.height, maxHeight);
+  const top = clamp(
+    vertical ? placement === "bottom" ? anchor.y + anchor.height + offset : anchor.y - offset - height : alignedCross(input, height) + alignOffset,
+    insets.top,
+    Math.max(window.height - insets.bottom - height, insets.top)
+  );
+  const start = clamp(
+    vertical ? alignedCross(input, width) + alignOffset : placement === "end" ? anchor.x + anchor.width + offset : anchor.x - offset - width,
+    insets.start,
+    Math.max(window.width - insets.end - width, insets.start)
+  );
+  return { top, start, width, maxHeight, placement };
+}
+function resolveWidth(input) {
+  const { width, anchor, content, placement, window, insets } = input;
+  if (width === "trigger") {
+    return axisOf(placement) === "vertical" ? anchor.width : content.width;
+  }
+  if (width === "full") return Math.max(window.width - insets.start - insets.end, 0);
+  if (width === "content-fit") return content.width;
+  return width;
+}
+function choosePlacement(input) {
+  const { placement, avoidCollisions, content } = input;
+  if (!avoidCollisions) return placement;
+  const wanted = axisOf(placement) === "vertical" ? content.height : content.width;
+  if (roomFor(placement, input) >= wanted) return placement;
+  const other = OPPOSITE[placement];
+  return roomFor(other, input) > roomFor(placement, input) ? other : placement;
+}
+function roomFor(placement, input) {
+  const { anchor, window, offset, insets } = input;
+  switch (placement) {
+    case "bottom":
+      return window.height - insets.bottom - (anchor.y + anchor.height) - offset;
+    case "top":
+      return anchor.y - insets.top - offset;
+    case "end":
+      return window.width - insets.end - (anchor.x + anchor.width) - offset;
+    case "start":
+      return anchor.x - insets.start - offset;
+  }
+}
+function alignedCross({ align, anchor, placement }, size) {
+  const vertical = axisOf(placement) === "vertical";
+  const origin = vertical ? anchor.x : anchor.y;
+  const extent = vertical ? anchor.width : anchor.height;
+  if (align === "start") return origin;
+  if (align === "end") return origin + extent - size;
+  return origin + (extent - size) / 2;
+}
+function clamp(value, min, max) {
+  return Math.min(Math.max(value, min), max);
+}
+
+// src/hooks/use-anchored-position.ts
+function useAnchoredPosition({
+  anchor,
+  isOpen,
+  onLayout,
+  ...options
+}) {
+  const window = useWindowDimensions();
+  const origin = useContext(PortalContext)?.origin ?? ZERO;
+  const [measured, setMeasured] = useState(null);
+  const onContentLayout = useCallback(
+    (event) => {
+      onLayout?.(event);
+      const { width, height } = event.nativeEvent.layout;
+      setMeasured(
+        (current) => current !== null && current.width === width && current.height === height ? current : { width, height }
+      );
+    },
+    [onLayout]
+  );
+  if (!isOpen && measured !== null) setMeasured(null);
+  const local = anchor && {
+    ...anchor,
+    x: anchor.x - origin.x,
+    y: anchor.y - origin.y
+  };
+  const position = local && measured ? resolvePlacement({
+    anchor: local,
+    content: measured,
+    window: {
+      width: window.width - origin.x,
+      height: window.height - origin.y
+    },
+    ...options
+  }) : null;
+  return {
+    position,
+    onContentLayout,
+    measuringStyle: {
+      // Invisible, and at the start of the host, so the reader never sees the panel at
+      // the wrong place during the frame it is being measured in.
+      opacity: 0,
+      top: 0,
+      start: 0,
+      ...measuringWidth(options, local?.width, window)
+    }
+  };
+}
+function measuringWidth({
+  width,
+  maxWidth,
+  insets
+}, anchorWidth, window) {
+  const screen = Math.max(window.width - insets.start - insets.end, 0);
+  if (width === "trigger") return { width: anchorWidth };
+  if (width === "full") return { width: screen };
+  if (typeof width === "number") return { width };
+  return { maxWidth: Math.min(maxWidth ?? Number.POSITIVE_INFINITY, screen) };
+}
+var ZERO = { x: 0, y: 0 };
+
+export {
+  useAnchoredPosition
+};

package/dist/chunk-2NRZKJG7.js

@@ -0,0 +1,531 @@
+import {
+  createRecipe,
+  radiusAxis
+} from "./chunk-4GTAZM2C.js";
+import {
+  useXAUITheme
+} from "./chunk-A3EGFI6T.js";
+import {
+  Slot,
+  createSlotContext
+} from "./chunk-K72UDPVN.js";
+import {
+  useStyleProps
+} from "./chunk-M63GFNKV.js";
+
+// src/components/text-field/text-field-description.tsx
+import { forwardRef } from "react";
+import { Text } from "react-native";
+
+// src/components/text-field/text-field.context.ts
+var [TextFieldProvider, useTextField] = createSlotContext("TextField");
+
+// src/components/text-field/text-field-description.tsx
+import { jsx } from "react/jsx-runtime";
+var TextFieldDescription = forwardRef(
+  function TextFieldDescription2({ children, style, nativeID, ...props }, ref) {
+    const { descriptionStyle, descriptionId } = useTextField();
+    const [styleProps, rest] = useStyleProps(props);
+    return /* @__PURE__ */ jsx(
+      Text,
+      {
+        ref,
+        nativeID: nativeID ?? descriptionId,
+        style: [descriptionStyle, styleProps, style],
+        ...rest,
+        children
+      }
+    );
+  }
+);
+TextFieldDescription.displayName = "XAUI.TextField.Description";
+
+// src/components/text-field/text-field-error.tsx
+import { forwardRef as forwardRef2 } from "react";
+import { Text as Text2 } from "react-native";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var TextFieldError = forwardRef2(
+  function TextFieldError2({ children, style, ...props }, ref) {
+    const { errorStyle } = useTextField();
+    const [styleProps, rest] = useStyleProps(props);
+    return /* @__PURE__ */ jsx2(Text2, { ref, style: [errorStyle, styleProps, style], ...rest, children });
+  }
+);
+TextFieldError.displayName = "XAUI.TextField.Error";
+
+// src/components/text-field/text-field-field.tsx
+import { forwardRef as forwardRef3, useCallback } from "react";
+import { TextInput } from "react-native";
+import { jsx as jsx3 } from "react/jsx-runtime";
+var TextFieldField = forwardRef3(
+  function TextFieldField2({ style, onFocus, onBlur, placeholderTextColor, ...props }, ref) {
+    const {
+      fieldStyle,
+      placeholderTextColor: resolvedPlaceholder,
+      onFieldFocus,
+      onFieldBlur,
+      labelId,
+      descriptionId,
+      isDisabled,
+      isInvalid
+    } = useTextField();
+    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
+      }
+    );
+  }
+);
+TextFieldField.displayName = "XAUI.TextField.Field";
+
+// src/components/text-field/text-field-label.tsx
+import { forwardRef as forwardRef4 } from "react";
+import { Text as Text3 } from "react-native";
+import { jsx as jsx4 } from "react/jsx-runtime";
+var TextFieldLabel = forwardRef4(
+  function TextFieldLabel2({ children, style, nativeID, ...props }, ref) {
+    const { labelStyle, labelId } = useTextField();
+    const [styleProps, rest] = useStyleProps(props);
+    return /* @__PURE__ */ jsx4(
+      Text3,
+      {
+        ref,
+        nativeID: nativeID ?? labelId,
+        style: [labelStyle, styleProps, style],
+        ...rest,
+        children
+      }
+    );
+  }
+);
+TextFieldLabel.displayName = "XAUI.TextField.Label";
+
+// src/components/text-field/text-field.tsx
+import { forwardRef as forwardRef5, useCallback as useCallback2, useId, useMemo, useState } from "react";
+import { StyleSheet, View } from "react-native";
+
+// src/components/text-field/text-field.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* — `TextField.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 `TextField.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 textFieldRecipe = 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/text-field/text-field.tsx
+import { jsx as jsx5 } from "react/jsx-runtime";
+var TextFieldRoot = forwardRef5(function TextField({
+  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 = textFieldRecipe.resolve({ theme, selection, states });
+  const tint = color ? textFieldRecipe.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(TextFieldProvider, { value: context, children: surface });
+});
+TextFieldRoot.displayName = "XAUI.TextField.Root";
+
+// src/components/text-field/index.ts
+var TextField2 = Object.assign(TextFieldRoot, {
+  Label: TextFieldLabel,
+  Field: TextFieldField,
+  Description: TextFieldDescription,
+  Error: TextFieldError
+});
+
+export {
+  useTextField,
+  TextFieldDescription,
+  TextFieldError,
+  TextFieldField,
+  TextFieldLabel,
+  textFieldRecipe,
+  TextFieldRoot,
+  TextField2 as TextField
+};