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

package/dist/chunk-J3MB4PI5.cjs

@@ -0,0 +1,531 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+var _chunkFNEUOBCVcjs = require('./chunk-FNEUOBCV.cjs');
+
+
+var _chunk57SJ4LJFcjs = require('./chunk-57SJ4LJF.cjs');
+
+
+
+var _chunk7GHM4GKLcjs = require('./chunk-7GHM4GKL.cjs');
+
+
+var _chunkTK44VBIEcjs = require('./chunk-TK44VBIE.cjs');
+
+// src/components/text-field/text-field-description.tsx
+var _react = require('react');
+var _reactnative = require('react-native');
+
+// src/components/text-field/text-field.context.ts
+var [TextFieldProvider, useTextField] = _chunk7GHM4GKLcjs.createSlotContext.call(void 0, "TextField");
+
+// src/components/text-field/text-field-description.tsx
+var _jsxruntime = require('react/jsx-runtime');
+var TextFieldDescription = _react.forwardRef.call(void 0, 
+  function TextFieldDescription2({ children, style, nativeID, ...props }, ref) {
+    const { descriptionStyle, descriptionId } = useTextField();
+    const [styleProps, rest] = _chunkTK44VBIEcjs.useStyleProps.call(void 0, props);
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _reactnative.Text,
+      {
+        ref,
+        nativeID: _nullishCoalesce(nativeID, () => ( descriptionId)),
+        style: [descriptionStyle, styleProps, style],
+        ...rest,
+        children
+      }
+    );
+  }
+);
+TextFieldDescription.displayName = "XAUI.TextField.Description";
+
+// src/components/text-field/text-field-error.tsx
+
+
+
+var TextFieldError = _react.forwardRef.call(void 0, 
+  function TextFieldError2({ children, style, ...props }, ref) {
+    const { errorStyle } = useTextField();
+    const [styleProps, rest] = _chunkTK44VBIEcjs.useStyleProps.call(void 0, props);
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _reactnative.Text, { ref, style: [errorStyle, styleProps, style], ...rest, children });
+  }
+);
+TextFieldError.displayName = "XAUI.TextField.Error";
+
+// src/components/text-field/text-field-field.tsx
+
+
+
+var TextFieldField = _react.forwardRef.call(void 0, 
+  function TextFieldField2({ style, onFocus, onBlur, placeholderTextColor, ...props }, ref) {
+    const {
+      fieldStyle,
+      placeholderTextColor: resolvedPlaceholder,
+      onFieldFocus,
+      onFieldBlur,
+      labelId,
+      descriptionId,
+      isDisabled,
+      isInvalid
+    } = useTextField();
+    const [styleProps, rest] = _chunkTK44VBIEcjs.useStyleProps.call(void 0, props);
+    const handleFocus = _react.useCallback.call(void 0, 
+      (event) => {
+        onFieldFocus(event);
+        _optionalChain([onFocus, 'optionalCall', _ => _(event)]);
+      },
+      [onFieldFocus, onFocus]
+    );
+    const handleBlur = _react.useCallback.call(void 0, 
+      (event) => {
+        onFieldBlur(event);
+        _optionalChain([onBlur, 'optionalCall', _2 => _2(event)]);
+      },
+      [onFieldBlur, onBlur]
+    );
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _reactnative.TextInput,
+      {
+        ref,
+        "aria-labelledby": labelId,
+        "aria-describedby": descriptionId,
+        "aria-invalid": isInvalid,
+        editable: !isDisabled,
+        accessibilityState: { disabled: isDisabled },
+        placeholderTextColor: _nullishCoalesce(placeholderTextColor, () => ( resolvedPlaceholder)),
+        ...rest,
+        style: [fieldStyle, styleProps, style],
+        onFocus: handleFocus,
+        onBlur: handleBlur
+      }
+    );
+  }
+);
+TextFieldField.displayName = "XAUI.TextField.Field";
+
+// src/components/text-field/text-field-label.tsx
+
+
+
+var TextFieldLabel = _react.forwardRef.call(void 0, 
+  function TextFieldLabel2({ children, style, nativeID, ...props }, ref) {
+    const { labelStyle, labelId } = useTextField();
+    const [styleProps, rest] = _chunkTK44VBIEcjs.useStyleProps.call(void 0, props);
+    return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _reactnative.Text,
+      {
+        ref,
+        nativeID: _nullishCoalesce(nativeID, () => ( labelId)),
+        style: [labelStyle, styleProps, style],
+        ...rest,
+        children
+      }
+    );
+  }
+);
+TextFieldLabel.displayName = "XAUI.TextField.Label";
+
+// src/components/text-field/text-field.tsx
+
+
+
+// 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 = _chunkFNEUOBCVcjs.createRecipe.call(void 0, {
+  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: _chunkFNEUOBCVcjs.radiusAxis.call(void 0, "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
+
+var TextFieldRoot = _react.forwardRef.call(void 0, function TextField({
+  children,
+  variant,
+  size,
+  radius,
+  labelPlacement,
+  color,
+  isInvalid = false,
+  isDisabled = false,
+  asChild = false,
+  style,
+  ...props
+}, ref) {
+  const theme = _chunk57SJ4LJFcjs.useXAUITheme.call(void 0, );
+  const [styleProps, rest] = _chunkTK44VBIEcjs.useStyleProps.call(void 0, props);
+  const [isFocused, setIsFocused] = _react.useState.call(void 0, false);
+  const onFieldFocus = _react.useCallback.call(void 0, () => setIsFocused(true), []);
+  const onFieldBlur = _react.useCallback.call(void 0, () => setIsFocused(false), []);
+  const id = _react.useId.call(void 0, );
+  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 = _react.useMemo.call(void 0, () => {
+    const placeholder = _reactnative.StyleSheet.flatten(styles.placeholder);
+    const icon = _reactnative.StyleSheet.flatten(styles.icon);
+    const textArea = _reactnative.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: _nullishCoalesce(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, _optionalChain([tint, 'optionalAccess', _3 => _3.root]), styleProps, style];
+  const surface = asChild ? (
+    // R12 — the caller's element *is* the column.
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _chunk7GHM4GKLcjs.Slot, { ref, ...rest, style: rootStyle, children })
+  ) : /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _reactnative.View, { ref, ...rest, style: rootStyle, children });
+  return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 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
+});
+
+
+
+
+
+
+
+
+
+
+exports.useTextField = useTextField; exports.TextFieldDescription = TextFieldDescription; exports.TextFieldError = TextFieldError; exports.TextFieldField = TextFieldField; exports.TextFieldLabel = TextFieldLabel; exports.textFieldRecipe = textFieldRecipe; exports.TextFieldRoot = TextFieldRoot; exports.TextField = TextField2;

package/dist/chunk-K72UDPVN.js

@@ -0,0 +1,119 @@
+import {
+  mergeRefs
+} from "./chunk-36PRYGAM.js";
+
+// src/system/slot/children-to-string.ts
+import { isValidElement } from "react";
+function childrenToString(children) {
+  const text = stringify(children);
+  return text === null || text === "" ? null : text;
+}
+function stringify(node) {
+  if (node === null || node === void 0 || typeof node === "boolean") return "";
+  if (typeof node === "string") return node;
+  if (typeof node === "number") return String(node);
+  if (isValidElement(node)) return null;
+  if (Array.isArray(node)) {
+    let text = "";
+    for (const child of node) {
+      const part = stringify(child);
+      if (part === null) return null;
+      text += part;
+    }
+    return text;
+  }
+  return null;
+}
+
+// src/system/slot/create-slot-context.ts
+import { createContext, useContext } from "react";
+function createSlotContext(name) {
+  const Context = createContext(null);
+  Context.displayName = `XAUI.${name}.Context`;
+  function useSlotContext() {
+    const value = useContext(Context);
+    if (value === null) {
+      const error = new Error(
+        `XAUI: use${name} must be called inside <${name}>. A slot reads the values its root resolved, so it can only be rendered as a child of one.`
+      );
+      Error.captureStackTrace?.(
+        error,
+        useSlotContext
+      );
+      throw error;
+    }
+    return value;
+  }
+  return [Context.Provider, useSlotContext];
+}
+
+// src/system/slot/merge-props.ts
+var EVENT_HANDLER = /^on[A-Z]/;
+function mergeProps(ours, theirs) {
+  const merged = { ...ours };
+  for (const key of Object.keys(theirs)) {
+    const ourValue = ours[key];
+    const theirValue = theirs[key];
+    if (EVENT_HANDLER.test(key)) {
+      merged[key] = composeHandlers(ourValue, theirValue);
+    } else if (key === "style") {
+      merged[key] = mergeStyles(ourValue, theirValue);
+    } else if (key === "ref") {
+      merged[key] = mergeRefs(
+        ourValue,
+        theirValue
+      );
+    } else {
+      merged[key] = theirValue;
+    }
+  }
+  return merged;
+}
+function composeHandlers(ours, theirs) {
+  if (typeof ours !== "function") return theirs;
+  if (typeof theirs !== "function") return ours;
+  return (...args) => {
+    ;
+    ours(...args);
+    return theirs(...args);
+  };
+}
+function mergeStyles(ours, theirs) {
+  if (typeof ours === "function" || typeof theirs === "function") {
+    return (state) => [
+      resolveStyle(ours, state),
+      resolveStyle(theirs, state)
+    ];
+  }
+  return [ours, theirs];
+}
+function resolveStyle(style, state) {
+  return typeof style === "function" ? style(state) : style;
+}
+
+// src/system/slot/slot.tsx
+import { cloneElement, forwardRef, isValidElement as isValidElement2 } from "react";
+var Slot = forwardRef(function Slot2({ children, ...ours }, ref) {
+  if (!isValidElement2(children)) {
+    throw new Error(
+      "XAUI: asChild expects exactly one React element as its child, and merges the component's props into it. Text, a fragment, several children or none give it nothing to merge into \u2014 drop `asChild` to render the component itself."
+    );
+  }
+  const child = children;
+  const merged = mergeProps(ours, child.props);
+  merged.ref = mergeRefs(ref, refOf(child));
+  return cloneElement(child, merged);
+});
+Slot.displayName = "XAUI.Slot";
+function refOf(element) {
+  const fromProps = element.props.ref;
+  const fromElement = element.ref;
+  return fromProps ?? fromElement;
+}
+
+export {
+  childrenToString,
+  createSlotContext,
+  mergeProps,
+  Slot
+};